Files
twenty/packages/twenty-ui/scripts/generateThemeConstants.ts
T
Charles BochetandGitHub c4140f85df chore(twenty-front): migrate small modules from Emotion to Linaria (PR 1/10) (#18314)
## Emotion → Linaria migration — PR 1 of 10

First batch of the `twenty-front` migration from Emotion (runtime
CSS-in-JS) to Linaria (zero-runtime, build-time extraction via
wyw-in-js). Covers **100 files** across 10 small standalone modules —
chosen as the lowest-risk starting point.

### Modules migrated

spreadsheet-import (28) · navigation-menu-item (17) · views (14) ·
billing (10) · blocknote-editor (7) · advanced-text-editor (7) ·
favorites (7) · navigation (4) · information-banner (3) ·
sign-in-background-mock (3)

### Migration pattern

Every file follows the same mechanical transformation:

| Emotion | Linaria |
|---|---|
| `import styled from '@emotion/styled'` | `import { styled } from
'@linaria/react'` |
| `${({ theme }) => theme.font.color.primary}` |
`${themeCssVariables.font.color.primary}` |
| `${({ theme }) => theme.spacing(4)}` |
`${themeCssVariables.spacing[4]}` |
| `const theme = useTheme()` | `const { theme } =
useContext(ThemeContext)` |
| `import { type Theme } from '@emotion/react'` | `import { type
ThemeType } from 'twenty-ui/theme'` |

`themeCssVariables` is a build-time object where every leaf is a
`var(--t-xxx)` CSS custom property reference, evaluated statically by
wyw-in-js. Runtime theme access (icon sizes, colors passed as props)
uses `useContext(ThemeContext)`.

### Gotchas encountered & fixed

- **Interpolation return types** — wyw-in-js requires `string | number`,
never `false`/`undefined`. Replaced `condition && 'css'` with `condition
? 'css' : ''`.
- **`css` tag inside `styled` templates** — Linaria `css` returns a
class name, not CSS text. Replaced with plain template strings.
- **`styled(Component)` needs `className`** — added `className` prop to
`NavigationDrawerSection`, `DropdownMenuItemsContainer`, and `Heading`.
- **`shouldForwardProp` not supported** — Linaria filters invalid DOM
props automatically for HTML elements. For custom components, used
wrapper divs where needed.
- **`FormFieldPlaceholderStyles`** — converted from Emotion `css`
function to a static string using `themeCssVariables`.
2026-03-02 16:33:40 +01:00

130 lines
3.9 KiB
TypeScript

// Generates static TypeScript files with pre-computed theme constants.
// These values are string literals with no runtime imports, so wyw-in-js
// can evaluate them in its restricted sandbox without triggering the
// twenty-ui dist bundle's dependency chain (safe-regex-test / get-intrinsic).
//
// Usage (from workspace root):
// npx tsx packages/twenty-ui/scripts/generateThemeConstants.ts
//
// Prerequisites: twenty-ui must be built first (npx nx build twenty-ui).
import { createRequire } from 'node:module';
import { writeFileSync, mkdirSync } from 'node:fs';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
const scriptDir = dirname(fileURLToPath(import.meta.url));
const require = createRequire(import.meta.url);
const {
MOBILE_VIEWPORT,
THEME_LIGHT,
THEME_DARK,
prepareThemeForRootCssVariableInjection,
} = require('../dist/theme.cjs');
const { themeCssVariables: existingThemeCssVariables } =
require('../dist/theme-constants.cjs');
const themeCssVariables =
existingThemeCssVariables ??
(() => {
const { buildThemeReferencingRootCssVariables } =
require('../dist/theme.cjs');
return buildThemeReferencingRootCssVariables({
themeNode: THEME_LIGHT,
prefix: 't',
});
})();
const HEADER = `\
// Auto-generated by scripts/generateThemeConstants.ts — do not edit manually.
// Regenerate: npx tsx packages/twenty-ui/scripts/generateThemeConstants.ts
`;
const serializeObject = (
obj: Record<string, unknown>,
indent = 2,
): string => {
const spaces = ' '.repeat(indent);
const entries = Object.entries(obj).map(([key, value]) => {
const safeKey = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)
? key
: JSON.stringify(key);
if (typeof value === 'object' && value !== null) {
return `${spaces}${safeKey}: ${serializeObject(value as Record<string, unknown>, indent + 2)},`;
}
return `${spaces}${safeKey}: ${JSON.stringify(value)},`;
});
return `{\n${entries.join('\n')}\n${' '.repeat(indent - 2)}}`;
};
const serializeTupleArray = (entries: [string, string][]): string => {
const lines = entries.map(
([name, value]) => ` [${JSON.stringify(name)}, ${JSON.stringify(value)}],`,
);
return `[\n${lines.join('\n')}\n]`;
};
const outputDir = resolve(scriptDir, '../src/theme-constants/generated');
mkdirSync(outputDir, { recursive: true });
// --- themeCssVariables.ts ---
writeFileSync(
resolve(outputDir, 'themeCssVariables.ts'),
`${HEADER}
import type { ThemeType } from '@ui/theme/types/ThemeType';
type DeepCSSVariableRefs<T> = {
[K in keyof T]: T[K] extends (...args: never[]) => unknown
? Record<string | number, string>
: T[K] extends Record<string, unknown>
? DeepCSSVariableRefs<T[K]>
: string;
};
export const themeCssVariables = ${serializeObject(themeCssVariables)} as DeepCSSVariableRefs<ThemeType>;
`,
'utf-8',
);
console.log('Generated themeCssVariables.ts');
// --- themeLightCssVariableEntries.ts ---
const lightEntries = prepareThemeForRootCssVariableInjection({
themeNode: THEME_LIGHT,
prefix: 't',
}) as [string, string][];
writeFileSync(
resolve(outputDir, 'themeLightCssVariableEntries.ts'),
`${HEADER}
// CSS custom properties don't work in media queries, so MOBILE_VIEWPORT
// must be a static number rather than a var(--...) reference.
export const MOBILE_VIEWPORT = ${MOBILE_VIEWPORT};
export const THEME_LIGHT_CSS_VARIABLE_ENTRIES: [string, string][] = ${serializeTupleArray(lightEntries)};
`,
'utf-8',
);
console.log('Generated themeLightCssVariableEntries.ts');
// --- themeDarkCssVariableEntries.ts ---
const darkEntries = prepareThemeForRootCssVariableInjection({
themeNode: THEME_DARK,
prefix: 't',
}) as [string, string][];
writeFileSync(
resolve(outputDir, 'themeDarkCssVariableEntries.ts'),
`${HEADER}
export const THEME_DARK_CSS_VARIABLE_ENTRIES: [string, string][] = ${serializeTupleArray(darkEntries)};
`,
'utf-8',
);
console.log('Generated themeDarkCssVariableEntries.ts');