codz-cli 0.0.0-stage → 0.1.2

package/dist/skills/theme.js

@@ -0,0 +1,388 @@
+// theme set <token> <value>: one place for colors, sizes and the font.
+//
+// The kind comes from the value: #hex → color, a number → size, anything else
+// (or the token "font") → font family.
+//
+// Flutter: AppColors / AppSizes classes and an AppTheme built from the seed
+// color (lib/app/theme for GetX, lib/core/theme otherwise, or wherever the
+// project already keeps AppColors), wired into MaterialApp / GetMaterialApp.
+// Next.js: Tailwind v4 @theme variables, Tailwind v3 theme.extend, or plain
+// CSS variables in globals.css.
+import { importPath } from "../adapters/nextjs.js";
+import { join, posix } from 'node:path';
+import { addDartImport, importUri } from "../adapters/flutter.js";
+import { matchBrace } from "../adapters/source.js";
+import { loadMap } from "../core/cache.js";
+import { buildChangeSet } from "../core/changeset.js";
+import { loadConfig } from "../core/config.js";
+import { detectEol, exists, readText, walk, withEol } from "../core/fsutil.js";
+import { ToolError } from "../core/types.js";
+import { camel, kebab } from "../input/naming.js";
+/** CSS hex is RRGGBB or RRGGBBAA; Flutter's Color(0x...) is AARRGGBB. */
+export function dartArgb(hex) {
+    return hex.length === 8 ? `${hex.slice(6)}${hex.slice(0, 6)}` : `FF${hex}`;
+}
+export function parseToken(name, value) {
+    const v = value.trim();
+    if (/^#?([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(v) && (v.startsWith('#') || /color|primary|secondary|accent|background|surface|error|text/i.test(name))) {
+        let hex = v.replace('#', '').toUpperCase();
+        if (hex.length === 3 || hex.length === 4)
+            hex = hex.split('').map((c) => c + c).join('');
+        return { name, kind: 'color', value: hex };
+    }
+    if (/^\d+(\.\d+)?(px)?$/.test(v))
+        return { name, kind: 'size', value: v.replace(/px$/, '') };
+    if (/^(font|fontFamily|font-family|font-sans)$/i.test(name) || /^[A-Za-z][\w '-]*$/.test(v))
+        return { name, kind: 'font', value: v.replace(/^['"]|['"]$/g, '') };
+    throw new ToolError('bad_value', `Cannot tell what "${value}" is.`, 'Use a hex color (#6750A4), a number (12) or a font name (Inter).');
+}
+// ---------------- Flutter ----------------
+function dartReplaceOrAdd(text, cls, decl, line) {
+    const head = new RegExp(`class\\s+${cls}\\b[^{]*\\{`).exec(text);
+    const open = head.index + head[0].length - 1;
+    const close = matchBrace(text, open, 'dart');
+    const body = text.slice(open, close);
+    const m = decl.exec(body);
+    if (m)
+        return text.slice(0, open + m.index) + line.trim() + text.slice(open + m.index + m[0].length);
+    const before = text.slice(0, close).replace(/\s*$/, '');
+    return `${before}\n  ${line.trim()}\n${text.slice(close)}`;
+}
+function findClassFile(root, files, cls) {
+    for (const [f, t] of files)
+        if (new RegExp(`class\\s+${cls}\\b`).test(t))
+            return f;
+    return walk(root, 'lib', { exts: ['.dart'] }).find((f) => new RegExp(`class\\s+${cls}\\b`).test(readText(join(root, f)) ?? ''));
+}
+function planFlutterTheme(root, map, token, files, summary, warnings) {
+    const c = map.conventions;
+    const read = (p) => files.get(p) ?? readText(join(root, p));
+    const existingColors = findClassFile(root, files, 'AppColors');
+    const folder = existingColors
+        ? posix.dirname(existingColors)
+        : c.modulesFolder || c.di === 'getx' || c.stateManagement === 'getx'
+            ? `${(c.modulesFolder || 'lib/app/modules').replace(/\/modules$/, '')}/theme`
+            : 'lib/core/theme';
+    const colorsFile = existingColors ?? `${folder}/app_colors.dart`;
+    const sizesFile = findClassFile(root, files, 'AppSizes') ?? `${folder}/app_sizes.dart`;
+    const themeFile = findClassFile(root, files, 'AppTheme') ?? `${folder}/app_theme.dart`;
+    const name = camel(token.name);
+    const ensure = (file, cls, doc) => {
+        const t = read(file);
+        if (t !== null)
+            return t.replace(/\r\n/g, '\n');
+        summary.push(`Create ${file}: ${cls}`);
+        return `${cls === 'AppColors' ? "import 'package:flutter/material.dart';\n\n" : ''}/// ${doc}\nclass ${cls} {\n  ${cls}._();\n}\n`;
+    };
+    const save = (file, text) => {
+        const orig = readText(join(root, file));
+        files.set(file, orig ? withEol(text, detectEol(orig)) : text);
+    };
+    if (token.kind === 'color') {
+        const t = ensure(colorsFile, 'AppColors', 'App colors. Change them with: codz theme set <name> <#hex>');
+        const had = new RegExp(`\\bstatic\\s+const\\s+(?:Color\\s+)?${name}\\s*=`).test(t);
+        save(colorsFile, dartReplaceOrAdd(t, 'AppColors', new RegExp(`static\\s+const\\s+(?:Color\\s+)?${name}\\s*=[^;]*;`), `static const Color ${name} = Color(0x${dartArgb(token.value)});`));
+        summary.push(`${had ? 'Update' : 'Add'} AppColors.${name} = #${token.value} in ${colorsFile}`);
+    }
+    else if (token.kind === 'size') {
+        const t = ensure(sizesFile, 'AppSizes', 'Spacing, radius and other sizes. Change them with: codz theme set <name> <number>');
+        const had = new RegExp(`\\bstatic\\s+const\\s+(?:double\\s+)?${name}\\s*=`).test(t);
+        const v = token.value.includes('.') ? token.value : `${token.value}.0`;
+        save(sizesFile, dartReplaceOrAdd(t, 'AppSizes', new RegExp(`static\\s+const\\s+(?:double\\s+)?${name}\\s*=[^;]*;`), `static const double ${name} = ${v};`));
+        summary.push(`${had ? 'Update' : 'Add'} AppSizes.${name} = ${v} in ${sizesFile}`);
+    }
+    // AppTheme: seed color from AppColors.primary (or the first color), and the font.
+    const themeExists = read(themeFile) !== null;
+    if (token.kind === 'font' || !themeExists) {
+        let t = read(themeFile)?.replace(/\r\n/g, '\n');
+        if (t === undefined || t === null) {
+            const colorsText = files.get(colorsFile) ?? read(colorsFile) ?? '';
+            const seed = /static\s+const\s+(?:Color\s+)?primary\b/.test(colorsText) ? 'primary' : colorsText.match(/static\s+const\s+(?:Color\s+)?(\w+)\s*=/)?.[1];
+            t = [
+                "import 'package:flutter/material.dart';",
+                '',
+                '/// The app theme. Colors come from AppColors; change them with codz theme set.',
+                'class AppTheme {',
+                '  AppTheme._();',
+                '',
+                '  static ThemeData get light => ThemeData(',
+                `        colorScheme: ColorScheme.fromSeed(seedColor: ${seed ? `AppColors.${seed}` : 'Colors.deepPurple'}),`,
+                '        useMaterial3: true,',
+                '      );',
+                '',
+                '  static ThemeData get dark => ThemeData(',
+                `        colorScheme: ColorScheme.fromSeed(seedColor: ${seed ? `AppColors.${seed}` : 'Colors.deepPurple'}, brightness: Brightness.dark),`,
+                '        useMaterial3: true,',
+                '      );',
+                '}',
+                '',
+            ].join('\n');
+            if (seed)
+                t = addDartImport(t, importUri(themeFile, colorsFile, c));
+            summary.push(`Create ${themeFile}: AppTheme.light / AppTheme.dark${seed ? ` seeded from AppColors.${seed}` : ''}`);
+            if (!seed)
+                warnings.push('AppTheme uses Colors.deepPurple until you set a color: codz theme set primary #6750A4');
+        }
+        if (token.kind === 'font') {
+            const font = `fontFamily: '${token.value.replace(/'/g, "\\'")}',`;
+            if (/fontFamily:\s*'[^']*',/.test(t))
+                t = t.replace(/fontFamily:\s*'[^']*',/g, font);
+            else
+                t = t.replace(/(ThemeData\(\n)([ \t]*)/g, (_m, a, ind) => `${a}${ind}${font}\n${ind}`);
+            summary.push(`Use the font ${token.value} in ${themeFile}`);
+            warnings.push(`Add the ${token.value} font files under fonts: in pubspec.yaml (or use the google_fonts package), or Flutter falls back to the default font.`);
+        }
+        save(themeFile, t);
+    }
+    else if (token.kind === 'color') {
+        // An AppTheme that seeds from a literal color switches to this one when it is the primary.
+        const t = read(themeFile);
+        if (name === 'primary' && /seedColor:\s*Colors\.\w+/.test(t)) {
+            let next = t.replace(/seedColor:\s*Colors\.\w+/g, 'seedColor: AppColors.primary');
+            next = addDartImport(next.replace(/\r\n/g, '\n'), importUri(themeFile, colorsFile, c));
+            save(themeFile, next);
+            summary.push(`Seed ${themeFile} from AppColors.primary`);
+        }
+    }
+    // Wire AppTheme into the app.
+    const mainFile = 'lib/main.dart';
+    const main = read(mainFile);
+    if (main === null)
+        return;
+    if (/\bAppTheme\.light\b/.test(main))
+        return;
+    const app = /\b(?:GetMaterialApp|MaterialApp)(?:\.router)?\s*\(/.exec(main);
+    if (!app) {
+        warnings.push(`No MaterialApp in ${mainFile}; pass theme: AppTheme.light to it yourself.`);
+        return;
+    }
+    const open = app.index + app[0].length - 1;
+    const close = matchBrace(main, open, 'dart');
+    const args = main.slice(open, close);
+    const indent = main.slice(main.lastIndexOf('\n', app.index) + 1).match(/^[ \t]*/)[0];
+    let next = main.replace(/\r\n/g, '\n');
+    const themeArg = /\n?([ \t]*)theme:\s*/.exec(args);
+    if (themeArg) {
+        // Only the template theme (fromSeed + useMaterial3) is replaced; a hand-built one stays.
+        const vStart = open + themeArg.index + themeArg[0].length;
+        const vEnd = /^ThemeData\s*\(/.test(main.slice(vStart)) ? matchBrace(main, main.indexOf('(', vStart), 'dart') + 1 : -1;
+        const value = vEnd > 0 ? main.slice(vStart, vEnd) : '';
+        const stripped = value.replace(/\s+/g, '');
+        if (/^ThemeData\(colorScheme:ColorScheme\.fromSeed\(seedColor:[\w.]+\),(useMaterial3:true,?)?\)$/.test(stripped)) {
+            next = main.slice(0, vStart) + 'AppTheme.light' + main.slice(vEnd);
+            next = next.replace(/\r\n/g, '\n');
+            summary.push(`Update ${mainFile}: theme: AppTheme.light (replaces the template theme)`);
+        }
+        else {
+            warnings.push(`${mainFile} already builds its own theme; switch it to theme: AppTheme.light to use these tokens.`);
+            return;
+        }
+    }
+    else {
+        const inner = main.slice(open + 1, close);
+        const add = `\n${indent}  theme: AppTheme.light,\n${indent}  darkTheme: AppTheme.dark,`;
+        next = inner.includes('\n')
+            ? main.slice(0, open + 1) + add + main.slice(open + 1)
+            : `${main.slice(0, open + 1)}${add}${inner.trim() ? `\n${indent}  ${inner.trim().replace(/,$/, '')},` : ''}\n${indent}${main.slice(close)}`;
+        next = next.replace(/\r\n/g, '\n');
+        summary.push(`Update ${mainFile}: theme: AppTheme.light, darkTheme: AppTheme.dark`);
+    }
+    next = addDartImport(next, importUri(mainFile, themeFile, c));
+    files.set(mainFile, withEol(next, detectEol(main)));
+}
+// ---------------- Next.js ----------------
+const CSS_CANDIDATES = ['app/globals.css', 'src/app/globals.css', 'styles/globals.css', 'src/styles/globals.css'];
+function tailwindConfig(root) {
+    return ['tailwind.config.ts', 'tailwind.config.js', 'tailwind.config.mjs', 'tailwind.config.cjs'].find((f) => exists(join(root, f)));
+}
+function cssVarName(token, v4) {
+    const k = kebab(token.name).replace(/^(color|font|radius|spacing)-/, '');
+    if (token.kind === 'color')
+        return `--color-${k}`;
+    if (token.kind === 'font')
+        return v4 ? `--font-${/^(font|font-family|fontfamily)$/i.test(token.name) ? 'sans' : k}` : `--font-${/^(font|font-family|fontfamily)$/i.test(token.name) ? 'sans' : k}`;
+    if (/radius/i.test(token.name))
+        return `--radius-${k === 'radius' ? 'DEFAULT' : k}`.replace('--radius-DEFAULT', '--radius');
+    return `--spacing-${k}`;
+}
+function cssValue(token) {
+    if (token.kind === 'color')
+        return `#${token.value.toLowerCase()}`;
+    if (token.kind === 'size')
+        return `${token.value}px`;
+    return `"${token.value}", ui-sans-serif, system-ui, sans-serif`;
+}
+/** Sets a custom property inside the block that starts at `open`. */
+function setCssVar(css, open, name, value) {
+    const close = css.indexOf('}', open);
+    const body = css.slice(open, close);
+    const re = new RegExp(`(^|\\n)([ \\t]*)${name.replace(/[-]/g, '\\-')}\\s*:[^;]*;`);
+    const m = re.exec(body);
+    if (m)
+        return { text: css.slice(0, open + m.index) + `${m[1]}${m[2]}${name}: ${value};` + css.slice(open + m.index + m[0].length), updated: true };
+    const indent = /\n([ \t]+)\S/.exec(body)?.[1] ?? '  ';
+    const before = css.slice(0, close).replace(/[ \t]*$/, '');
+    return { text: `${before}${before.endsWith('\n') ? '' : '\n'}${indent}${name}: ${value};\n${css.slice(close)}`, updated: false };
+}
+function planNextTheme(root, map, token, files, summary, warnings) {
+    const cssFile = CSS_CANDIDATES.find((f) => exists(join(root, f))) ?? (exists(join(root, 'src/app')) ? 'src/app/globals.css' : 'app/globals.css');
+    const orig = readText(join(root, cssFile));
+    const created = orig === null && !files.has(cssFile);
+    let css = (files.get(cssFile) ?? orig ?? '').replace(/\r\n/g, '\n');
+    const v4 = /@import\s+["']tailwindcss["']/.test(css);
+    const twConfig = !v4 ? tailwindConfig(root) : undefined;
+    if (twConfig) {
+        // Tailwind v3: theme.extend.<group>.<name>
+        const group = token.kind === 'color' ? 'colors' : token.kind === 'font' ? 'fontFamily' : /radius/i.test(token.name) ? 'borderRadius' : 'spacing';
+        const key = token.kind === 'font' && /^(font|font-family|fontfamily)$/i.test(token.name) ? 'sans' : camel(token.name).replace(/Radius$|^radius$/, (m) => (m === 'radius' ? 'DEFAULT' : ''));
+        const value = token.kind === 'color' ? `'#${token.value.toLowerCase()}'` : token.kind === 'size' ? `'${token.value}px'` : `['${token.value}', 'ui-sans-serif', 'system-ui', 'sans-serif']`;
+        const t = (files.get(twConfig) ?? readText(join(root, twConfig))).replace(/\r\n/g, '\n');
+        const theme = /\btheme\s*:\s*\{/.exec(t);
+        if (!theme)
+            throw new ToolError('no_theme', `${twConfig} has no theme: {} section.`, 'Add theme: { extend: {} } to it, then run this again.');
+        let next = t;
+        const ensureObj = (text, open, prop) => {
+            const close = matchBrace(text, open, 'ts');
+            const inner = text.slice(open, close);
+            const m = new RegExp(`\\b${prop}\\s*:\\s*\\{`).exec(inner);
+            if (m)
+                return [text, open + m.index + m[0].length - 1];
+            const indent = text.slice(text.lastIndexOf('\n', open) + 1).match(/^[ \t]*/)[0] + '  ';
+            const ins = `\n${indent}${prop}: {\n${indent}},`;
+            const n = text.slice(0, open + 1) + ins + text.slice(open + 1);
+            return [n, open + 1 + ins.indexOf('{')];
+        };
+        let pos;
+        [next, pos] = ensureObj(next, theme.index + theme[0].length - 1, 'extend');
+        [next, pos] = ensureObj(next, pos, group);
+        const close = matchBrace(next, pos, 'ts');
+        const inner = next.slice(pos, close);
+        const keyRe = new RegExp(`(\\n[ \\t]*)['"]?${key}['"]?\\s*:\\s*(\\[[^\\]]*\\]|'[^']*'|"[^"]*"|[^,\\n]+),?`);
+        const m = keyRe.exec(inner);
+        const prop = /^[A-Za-z_]\w*$/.test(key) ? key : `'${key}'`;
+        if (m)
+            next = next.slice(0, pos + m.index) + `${m[1]}${prop}: ${value},` + next.slice(pos + m.index + m[0].length);
+        else {
+            const indent = next.slice(next.lastIndexOf('\n', pos) + 1).match(/^[ \t]*/)[0];
+            const before = next.slice(0, close).replace(/\s*$/, '');
+            next = `${before}${before.endsWith('{') || before.endsWith(',') ? '' : ','}\n${indent}  ${prop}: ${value},\n${indent}${next.slice(close)}`;
+        }
+        files.set(twConfig, withEol(next, detectEol(readText(join(root, twConfig)))));
+        summary.push(`${m ? 'Update' : 'Add'} theme.extend.${group}.${key} = ${value} in ${twConfig}`);
+        summary.push(`Use it as a class: ${token.kind === 'color' ? `bg-${kebab(token.name)} text-${kebab(token.name)}` : token.kind === 'font' ? `font-${key === 'sans' ? 'sans' : kebab(key)}` : group === 'borderRadius' ? (key === 'DEFAULT' ? 'rounded' : `rounded-${kebab(key)}`) : `p-${kebab(key)} gap-${kebab(key)}`}`);
+        return;
+    }
+    const name = cssVarName(token, v4);
+    const value = cssValue(token);
+    let updated = false;
+    if (v4) {
+        // Tailwind v4: @theme { --color-primary: ... } makes bg-primary, text-primary, etc.
+        let theme = /@theme(?:\s+inline)?\s*\{/.exec(css);
+        if (!theme) {
+            const imp = /@import\s+["']tailwindcss["'];?\n?/.exec(css);
+            const at = imp.index + imp[0].length;
+            css = `${css.slice(0, at)}${imp[0].endsWith('\n') ? '' : '\n'}\n@theme {\n}\n${css.slice(at)}`;
+            theme = /@theme\s*\{/.exec(css);
+        }
+        ({ text: css, updated } = setCssVar(css, theme.index + theme[0].length - 1, name, value));
+        summary.push(`${updated ? 'Update' : 'Add'} ${name}: ${value} in the @theme block of ${cssFile}`);
+        const util = name.replace(/^--color-/, 'bg-').replace(/^--font-/, 'font-').replace(/^--radius-?/, 'rounded-').replace(/^--spacing-/, 'p-').replace(/-$/, '');
+        summary.push(`Use it as a class: ${util}`);
+    }
+    else {
+        let rootSel = /:root\s*\{/.exec(css);
+        if (!rootSel) {
+            css = `:root {\n}\n${css ? `\n${css}` : ''}`;
+            rootSel = /:root\s*\{/.exec(css);
+        }
+        ({ text: css, updated } = setCssVar(css, rootSel.index + rootSel[0].length - 1, name, value));
+        summary.push(`${created ? `Create ${cssFile}: ` : `${updated ? 'Update' : 'Add'} `}${name}: ${value} in :root`);
+        summary.push(`Use it in CSS: var(${name})`);
+        if (created) {
+            const layout = ['app/layout.tsx', 'src/app/layout.tsx', 'app/layout.jsx', 'src/app/layout.jsx'].find((f) => exists(join(root, f)));
+            if (layout) {
+                const lt = files.get(layout) ?? readText(join(root, layout));
+                if (!/globals\.css/.test(lt)) {
+                    const rel = posix.relative(posix.dirname(layout), cssFile);
+                    const imp = `import '${rel.startsWith('.') ? rel : `./${rel}`}';\n`;
+                    const lastImport = [...lt.matchAll(/^import[^\n]*\n/gm)].pop();
+                    const at = lastImport ? lastImport.index + lastImport[0].length : 0;
+                    files.set(layout, lt.slice(0, at) + imp + lt.slice(at));
+                    summary.push(`Update ${layout}: import the global styles`);
+                }
+            }
+        }
+    }
+    if (token.kind === 'font')
+        warnings.push(`Load ${token.value} too (next/font/google or a <link>), or the browser uses the fallback font.`);
+    files.set(cssFile, orig ? withEol(css, detectEol(orig)) : css);
+    void map;
+}
+// ---------------- React Native ----------------
+/** src/theme/index.ts: colors, sizes and fonts objects that screens import. */
+function planRnTheme(root, map, token, files, summary) {
+    const src = map.conventions.screensFolder?.startsWith('src/') || exists(join(root, 'src')) ? 'src/' : '';
+    const file = `${src}theme/index.ts`;
+    const semi = map.conventions.semicolons === 'false' ? '' : ';';
+    let t = files.get(file) ?? readText(join(root, file)) ?? `export const colors = {\n}${semi}\n\nexport const sizes = {\n}${semi}\n\nexport const fonts = {\n}${semi}\n`;
+    const obj = token.kind === 'color' ? 'colors' : token.kind === 'size' ? 'sizes' : 'fonts';
+    const key = token.kind === 'font' && /^(font|fontFamily|font-family|font-sans)$/i.test(token.name) ? 'body' : token.name.replace(/[-_](\w)/g, (_m, ch) => ch.toUpperCase());
+    const value = token.kind === 'color' ? `'#${token.value}'` : token.kind === 'size' ? token.value : `'${token.value}'`;
+    const block = new RegExp(`(export const ${obj}\\s*=\\s*\\{)([\\s\\S]*?)(\\n\\}\\s*(?:as const)?;?)`).exec(t);
+    if (!block)
+        t = `${t.replace(/\s*$/, '\n')}\nexport const ${obj} = {\n  ${key}: ${value},\n}${semi}\n`;
+    else {
+        const line = new RegExp(`^(\\s*)${key}\\s*:.*$`, 'm');
+        const inner = line.test(block[2]) ? block[2].replace(line, `$1${key}: ${value},`) : `${block[2]}\n  ${key}: ${value},`;
+        t = t.replace(block[0], `${block[1]}${inner}${block[3]}`);
+    }
+    files.set(file, t);
+    summary.push(`${readText(join(root, file)) === null ? 'Create' : 'Update'} ${file}: ${obj}.${key} = ${value}`);
+    summary.push(`Use it in a screen: import { ${obj} } from '${importPath(`${map.conventions.screensFolder || `${src}screens`}/X.tsx`, file, { ...map.conventions, importStyle: 'relative' }).replace(/\.ts$/, '')}'`);
+}
+/** Android: Color.kt / Dimens.kt values in ui/theme; primary also feeds the color scheme when Theme.kt uses Primary. */
+function planAndroidTheme(root, map, token, files, summary, warnings) {
+    const c = map.conventions;
+    if (token.kind === 'font')
+        return void warnings.push(`Fonts are not set by codz on Android yet; add a FontFamily for ${token.value} to ui/theme/Type.kt.`);
+    const srcDir = c.srcDir || 'app/src/main/java';
+    const dir = `${srcDir}/${(c.namespace || 'app').replace(/\./g, '/')}/ui/theme`;
+    const pkg = `${c.namespace}.ui.theme`;
+    const file = `${dir}/${token.kind === 'color' ? 'Color' : 'Dimens'}.kt`;
+    const before = files.get(file) ?? readText(join(root, file));
+    let t = before ?? (token.kind === 'color' ? `package ${pkg}\n\nimport androidx.compose.ui.graphics.Color\n` : `package ${pkg}\n\nimport androidx.compose.ui.unit.dp\n`);
+    const name = token.name.replace(/[-_](\w)/g, (_m, ch) => ch.toUpperCase()).replace(/^\w/, (ch) => ch.toUpperCase());
+    const value = token.kind === 'color' ? `Color(0xFF${token.value.toUpperCase()})` : `${token.value}.dp`;
+    const line = new RegExp(`^val\\s+${name}\\s*=.*$`, 'm');
+    t = line.test(t) ? t.replace(line, `val ${name} = ${value}`) : `${t.replace(/\s*$/, '\n')}\nval ${name} = ${value}\n`;
+    if (token.kind === 'size' && !/import androidx\.compose\.ui\.unit\.dp/.test(t))
+        t = t.replace(/^(package [^\n]+\n)/, '$1\nimport androidx.compose.ui.unit.dp\n');
+    files.set(file, t);
+    summary.push(`${before === null ? 'Create' : 'Update'} ${file}: ${name} = ${value}`);
+    const themeKt = readText(join(root, dir, 'Theme.kt'));
+    if (token.kind === 'color' && name === 'Primary' && themeKt !== null && !/\bprimary\s*=\s*Primary\b/.test(themeKt))
+        warnings.push(`${dir}/Theme.kt does not use Primary in its color scheme; pass primary = Primary to lightColorScheme(...).`);
+}
+export async function planThemeSet(root, adapter, tokens) {
+    if (!tokens.length)
+        throw new ToolError('bad_args', 'Usage: codz theme set <name> <value> [<name> <value> ...]');
+    const { map } = await loadMap(root, adapter, loadConfig(root).conventions);
+    const files = new Map();
+    const summary = [];
+    const warnings = [];
+    // Colors first so a new AppTheme seeds from them.
+    const parsed = tokens.map((t) => parseToken(t.name, t.value)).sort((a, b) => (a.kind === 'color' ? -1 : 0) - (b.kind === 'color' ? -1 : 0));
+    for (const token of parsed) {
+        if (adapter.id === 'flutter')
+            planFlutterTheme(root, map, token, files, summary, warnings);
+        else if (adapter.id === 'nextjs')
+            planNextTheme(root, map, token, files, summary, warnings);
+        else if (adapter.id === 'react-native')
+            planRnTheme(root, map, token, files, summary);
+        else if (adapter.id === 'android')
+            planAndroidTheme(root, map, token, files, summary, warnings);
+        else
+            throw new ToolError('not_supported', `theme set needs the Next.js, Flutter, React Native or Android adapter; this project uses the ${adapter.id} adapter.`, adapter.id === 'react' ? 'For React web apps, set the color in your CSS (a :root variable) or your Tailwind config; theme set does not edit them yet.' : adapter.id === 'ios' ? 'For iOS, set the color in Assets.xcassets (AccentColor); theme set does not edit it yet.' : undefined);
+    }
+    return buildChangeSet(root, 'theme set', { files, summary: [...new Set(summary)], warnings: [...new Set(warnings)], generated: [] });
+}

package/dist/starters/auth.js

@@ -0,0 +1,144 @@
+// Login for paid starters: the OAuth device-code flow (codz prints a short
+// code, you approve it in the browser), a short-lived access token and a
+// rotating refresh token in ~/.codz/auth.json (owner-only). CI uses
+// CODZ_TOKEN instead. Tokens never appear in output, history or plans.
+import { spawn } from 'node:child_process';
+import { ToolError } from "../core/types.js";
+import { readHomeFile, removeHome, writeHomeFile } from "./home.js";
+import { apiError, checkUrl, request } from "./http.js";
+import { registryConfig } from "./registry.js";
+import { parseStrictJson, printable } from "./strictJson.js";
+const api = (path) => new URL(path, `${registryConfig().api.href.replace(/\/?$/, '/')}`);
+const json = (b, what) => parseStrictJson(b.toString('utf8'), what, { maxBytes: 64 * 1024 });
+function load() {
+    const b = readHomeFile('auth.json');
+    if (!b)
+        return null;
+    try {
+        const a = JSON.parse(b.toString('utf8'));
+        return a.registry === registryConfig().api.href ? a : null;
+    }
+    catch {
+        return null;
+    }
+}
+function save(a) {
+    writeHomeFile(JSON.stringify(a), { secret: true }, 'auth.json');
+}
+function tokens(body, account) {
+    const access = body.access_token;
+    const refresh = body.refresh_token;
+    const ttl = Number(body.expires_in ?? 900);
+    if (typeof access !== 'string' || typeof refresh !== 'string' || !access || !refresh)
+        throw new ToolError('login_failed', 'The login server did not return tokens.', 'Try codz login again.');
+    return { accessToken: access, refreshToken: refresh, expiresAt: Date.now() + Math.max(30, ttl) * 1000, account: typeof body.account === 'string' ? printable(body.account).slice(0, 200) : account, registry: registryConfig().api.href };
+}
+export const auth = {
+    /** A usable access token, refreshed when it is about to expire; null when not logged in. */
+    async accessToken() {
+        if (process.env.CODZ_TOKEN)
+            return process.env.CODZ_TOKEN;
+        const a = load();
+        if (!a)
+            return undefined;
+        if (a.expiresAt - 60_000 > Date.now())
+            return a.accessToken;
+        const r = await request(api('v1/token/refresh'), { method: 'POST', json: { refresh_token: a.refreshToken }, maxBytes: 64 * 1024 });
+        if (r.status === 400 || r.status === 401) {
+            removeHome('auth.json');
+            throw new ToolError('token_expired', 'Your session has expired.', 'Run codz login again.');
+        }
+        if (r.status !== 200)
+            throw apiError(r, { hadToken: true, what: 'refreshing the login' });
+        const next = tokens(json(r.body, 'the refresh answer'), a.account);
+        save(next);
+        return next.accessToken;
+    },
+    account() {
+        if (process.env.CODZ_TOKEN)
+            return 'CODZ_TOKEN';
+        return load()?.account ?? null;
+    },
+    async login(opts) {
+        const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+        const r = await request(api('v1/device/code'), { method: 'POST', json: { client: 'codz-cli' }, maxBytes: 64 * 1024 });
+        if (r.status !== 200)
+            throw apiError(r, { hadToken: false, what: 'login' });
+        const d = json(r.body, 'the login answer');
+        const deviceCode = String(d.device_code ?? '');
+        const userCode = printable(String(d.user_code ?? '')).slice(0, 20);
+        const verify = checkUrl(String(d.verification_uri ?? ''), 'the login page');
+        let interval = Math.max(0, Number(d.interval ?? 5));
+        const deadline = Date.now() + Math.min(Number(d.expires_in ?? 900), 1800) * 1000;
+        if (!deviceCode || !userCode)
+            throw new ToolError('login_failed', 'The login server did not return a code.', 'Try codz login again.');
+        // The page must be on the catalog's own hosts; codz never opens a link a server made up elsewhere.
+        const cfg = registryConfig();
+        if (verify.host !== cfg.api.host && verify.host !== cfg.base.host && !verify.host.endsWith(`.${cfg.base.host}`))
+            throw new ToolError('login_failed', `The login page ${verify.host} is not on the catalog's site.`, 'Do not continue; report it.');
+        opts.print(`Open ${verify.href} and enter code: ${userCode}`);
+        if (opts.browser)
+            openBrowser(verify.href);
+        opts.print('Waiting for approval...');
+        for (;;) {
+            if (Date.now() > deadline)
+                throw new ToolError('login_expired', 'The login code expired before it was approved.', 'Run codz login again.');
+            await sleep(interval * 1000);
+            const p = await request(api('v1/device/token'), { method: 'POST', json: { device_code: deviceCode }, maxBytes: 64 * 1024 });
+            const body = p.body.length ? json(p.body, 'the login answer') : {};
+            if (p.status === 200) {
+                const a = tokens(body, 'your account');
+                save(a);
+                return { account: a.account };
+            }
+            const err = String(body.error ?? '');
+            if (err === 'authorization_pending')
+                continue;
+            if (err === 'slow_down') {
+                interval += 5;
+                continue;
+            }
+            if (err === 'access_denied')
+                throw new ToolError('login_denied', 'The login was declined in the browser.', 'Run codz login again to retry.');
+            if (err === 'expired_token')
+                throw new ToolError('login_expired', 'The login code expired before it was approved.', 'Run codz login again.');
+            throw apiError(p, { hadToken: false, what: 'login' });
+        }
+    },
+    async logout() {
+        const a = load();
+        let revoked = false;
+        if (a) {
+            try {
+                const r = await request(api('v1/token/revoke'), { method: 'POST', json: { refresh_token: a.refreshToken }, maxBytes: 64 * 1024 });
+                revoked = r.status === 200 || r.status === 204;
+            }
+            catch {
+                // Offline: the local copy is still deleted; the token can be revoked from the web account.
+            }
+        }
+        return { revoked, removed: removeHome('auth.json') };
+    },
+    async whoami() {
+        const token = await auth.accessToken();
+        if (!token)
+            throw new ToolError('not_logged_in', 'You are not logged in.', 'Run codz login.');
+        const r = await request(api('v1/me'), { token, maxBytes: 256 * 1024 });
+        if (r.status !== 200)
+            throw apiError(r, { hadToken: true, what: 'your account' });
+        const b = json(r.body, 'the account answer');
+        const owned = Array.isArray(b.owned) ? b.owned.filter((o) => typeof o?.id === 'string').map((o) => ({ id: printable(String(o.id)).slice(0, 64), updatesUntil: typeof o.updatesUntil === 'string' ? printable(o.updatesUntil).slice(0, 10) : undefined })) : [];
+        return { account: printable(String(b.account ?? auth.account() ?? '')).slice(0, 200), owned };
+    },
+};
+function openBrowser(url) {
+    if (process.env.CI || (!process.env.DISPLAY && !process.env.WAYLAND_DISPLAY && process.platform === 'linux'))
+        return;
+    const [cmd, args] = process.platform === 'darwin' ? ['open', [url]] : process.platform === 'win32' ? ['rundll32', ['url.dll,FileProtocolHandler', url]] : ['xdg-open', [url]];
+    try {
+        spawn(cmd, args, { stdio: 'ignore', detached: true }).unref();
+    }
+    catch {
+        // The URL is printed; the user can open it.
+    }
+}