@marktiderman/genesis-cli 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,7 +9,6 @@
9
9
  * - `packages/<consumer>-brand/package.json`
10
10
  * - `tailwind.config.ts` (genesis preset import)
11
11
  * - `app/global.css` (genesis tokens import)
12
- * - `.genesis/cli.yml` (design-system rules + version pin)
13
12
  * - `CLAUDE.md` (cross-link + workflow)
14
13
  *
15
14
  * Idempotent: existing files are NOT overwritten. The scaffolder reads
@@ -38,6 +37,8 @@ interface ScaffoldOptions {
38
37
  genesisVersion?: string;
39
38
  /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */
40
39
  emitConflicts?: boolean;
40
+ /** An Expo app: the Tailwind config adds NativeWind's preset and scans genesis-ui-native. */
41
+ native?: boolean;
41
42
  /**
42
43
  * Logger. Defaults to a no-op when running in tests; CLI passes
43
44
  * `console.log` etc.
@@ -68,7 +69,7 @@ declare function validateConsumerName(name: string): void;
68
69
  * Compute which files the scaffolder would write for a given plan.
69
70
  * Pure function — no I/O. Tests use this directly.
70
71
  */
71
- declare function planScaffold(opts: Pick<ScaffoldOptions, "consumerName" | "genesisVersion">): {
72
+ declare function planScaffold(opts: Pick<ScaffoldOptions, "consumerName" | "genesisVersion" | "native">): {
72
73
  path: string;
73
74
  content: string;
74
75
  }[];
@@ -39,16 +39,12 @@ export type { Brand } from "./brand";
39
39
  },
40
40
  {
41
41
  path: `tailwind.config.ts`,
42
- content: tailwindConfig(consumer)
42
+ content: tailwindConfig(consumer, opts.native ?? false)
43
43
  },
44
44
  {
45
45
  path: `app/global.css`,
46
46
  content: globalCss()
47
47
  },
48
- {
49
- path: `.genesis/cli.yml`,
50
- content: genesisConfig(consumer)
51
- },
52
48
  {
53
49
  path: `CLAUDE.md`,
54
50
  content: claudeMd(consumer)
@@ -230,8 +226,11 @@ export const brand: Brand = {
230
226
  };
231
227
  `;
232
228
  }
233
- function tailwindConfig(consumer) {
229
+ function tailwindConfig(consumer, native) {
234
230
  return `import type { Config } from "tailwindcss";
231
+ import { genesisPreset } from "@marktiderman/genesis-design-system/presets/tailwind";${native ? `
232
+ // NativeWind v4 needs its preset; Genesis's goes after it.
233
+ import nativewindPreset from "nativewind/preset";` : ""}
235
234
  import { brand } from "@${consumer}/brand";
236
235
 
237
236
  /**
@@ -247,9 +246,9 @@ const config: Config = {
247
246
  content: [
248
247
  "./app/**/*.{ts,tsx}",
249
248
  "./components/**/*.{ts,tsx}",
250
- "./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}",
251
- ],
252
- presets: [require("@marktiderman/genesis-design-system/tailwind-preset")],
249
+ ${native ? ` "./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}",
250
+ ` : ""} ],
251
+ presets: [${native ? "nativewindPreset, " : ""}genesisPreset],
253
252
  theme: {
254
253
  extend: {
255
254
  colors: {
@@ -271,47 +270,16 @@ export default config;
271
270
  }
272
271
  function globalCss() {
273
272
  return `/**
274
- * Genesis global stylesheet entry. Imports the canonical token sheet
275
- * + the consumer's tailwind layers. The token sheet wires CSS variables
276
- * (--color-primary, --color-foreground, etc.) used by every Genesis
277
- * primitive's tailwind classes.
273
+ * Genesis global stylesheet entry. Imports the Genesis theme (the CSS
274
+ * variables every Genesis primitive's classes read: --background,
275
+ * --foreground, --primary, \u2026) and the consumer's tailwind layers.
278
276
  */
279
- @import "@marktiderman/genesis-design-system/tokens.css";
277
+ @import "@marktiderman/genesis-design-system/themes/genesis.css";
280
278
  @tailwind base;
281
279
  @tailwind components;
282
280
  @tailwind utilities;
283
281
  `;
284
282
  }
285
- function genesisConfig(consumer) {
286
- return `# Genesis DESIGN-SYSTEM consumer pin \u2014 read by the genesis CLI + .claude/hooks/*
287
- # NOT the harness config: the schema-validated harness/root config lives at
288
- # genesis.config.yml (see genesis.config.example.yml). This file only pins the
289
- # @marktiderman/genesis-* version + design-system rules for this consumer.
290
- #
291
- # version pin: which @marktiderman/genesis-* major are we on. The genesis CLI
292
- # uses this to validate that an upgrade hasn't drifted past breaking-change
293
- # boundaries.
294
- version: "1"
295
- consumer: "${consumer}"
296
-
297
- rules:
298
- # Block raw hex in consumer code \u2014 must use brand tokens.
299
- no-raw-hex: error
300
- # Block StyleSheet.create() in NativeWind-first projects.
301
- no-stylesheet-create: error
302
- # Block fork-and-modify of Genesis primitives.
303
- no-genesis-fork: error
304
- # Layouts must compose Genesis primitives, not rebuild them.
305
- prefer-genesis-layout: warn
306
-
307
- # Path map \u2014 where consumer composites + brand live. Default values match
308
- # the scaffolder's output; adjust if your layout differs.
309
- paths:
310
- brand: "packages/${consumer}-brand"
311
- composites: "components"
312
- app: "app"
313
- `;
314
- }
315
283
  function claudeMd(consumer) {
316
284
  return `# CLAUDE.md \u2014 ${consumer}
317
285
 
@@ -319,8 +287,9 @@ This consumer was bootstrapped with \`@marktiderman/genesis-cli init ${consumer}
319
287
 
320
288
  ## Workflow
321
289
 
322
- - **Reuse before extend, extend before create.** See the Genesis usage
323
- doctrine: \`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\`
290
+ - **Reuse before extend, extend before create.** Before building anything,
291
+ run \`npx @marktiderman/genesis-cli features find <term>\` and read
292
+ https://github.com/marktiderman/genesis/blob/main/docs/FRAMEWORK.md
324
293
  - **Brand changes live in \`packages/${consumer}-brand\`.** Don't fork Genesis
325
294
  primitives \u2014 edit your brand schema instead (Layer 1).
326
295
  - **Layout customization has 4 layers.** Default \u2192 named props \u2192
@@ -328,9 +297,9 @@ This consumer was bootstrapped with \`@marktiderman/genesis-cli init ${consumer}
328
297
 
329
298
  ## Critical rules
330
299
 
331
- - \`.genesis/cli.yml\` design-system rules are enforced via Claude Code hooks. Don't
332
- bypass with \`StyleSheet.create()\` or raw hex; use brand tokens.
333
- - Run \`pnpm test\` before every commit.
300
+ - \`genesis doctor\` enforces the design-system rules. Don't bypass them with
301
+ \`StyleSheet.create()\` or raw hex; use brand tokens and theme roles.
302
+ - Run your test script before every commit.
334
303
  - Open RFCs in the genesis repo for missing primitives \u2014 don't fork
335
304
  locally and forget.
336
305
 
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/scaffolder.ts"],"names":[],"mappings":"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","file":"scaffolder.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/cli.yml` (design-system rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"acme\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/cli.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Acme, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis DESIGN-SYSTEM consumer pin — read by the genesis CLI + .claude/hooks/*\n# NOT the harness config: the schema-validated harness/root config lives at\n# genesis.config.yml (see genesis.config.example.yml). This file only pins the\n# @marktiderman/genesis-* version + design-system rules for this consumer.\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/cli.yml\\` design-system rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n"]}
1
+ {"version":3,"sources":["../src/scaffolder.ts"],"names":[],"mappings":"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","file":"scaffolder.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /** An Expo app: the Tailwind config adds NativeWind's preset and scans genesis-ui-native. */\n native?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"acme\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\" | \"native\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer, opts.native ?? false),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Acme, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string, native: boolean): string {\n return `import type { Config } from \"tailwindcss\";\nimport { genesisPreset } from \"@marktiderman/genesis-design-system/presets/tailwind\";${native ? `\n// NativeWind v4 needs its preset; Genesis's goes after it.\nimport nativewindPreset from \"nativewind/preset\";` : \"\"}\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n${native ? ` \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\\n` : \"\"} ],\n presets: [${native ? \"nativewindPreset, \" : \"\"}genesisPreset],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the Genesis theme (the CSS\n * variables every Genesis primitive's classes read: --background,\n * --foreground, --primary, …) and the consumer's tailwind layers.\n */\n@import \"@marktiderman/genesis-design-system/themes/genesis.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** Before building anything,\n run \\`npx @marktiderman/genesis-cli features find <term>\\` and read\n https://github.com/marktiderman/genesis/blob/main/docs/FRAMEWORK.md\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`genesis doctor\\` enforces the design-system rules. Don't bypass them with\n \\`StyleSheet.create()\\` or raw hex; use brand tokens and theme roles.\n- Run your test script before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n"]}
package/dist/vite.js CHANGED
@@ -45,7 +45,10 @@ ${String(r.stderr ?? "").trim().split("\n").slice(-20).join("\n")}` : "";
45
45
  }
46
46
  return null;
47
47
  }
48
- var DoctorConfigError = class extends Error {
48
+ var GenesisConfigError = class extends Error {
49
+ name = "GenesisConfigError";
50
+ };
51
+ var DoctorConfigError = class extends GenesisConfigError {
49
52
  name = "DoctorConfigError";
50
53
  };
51
54
  var STRING_LISTS = ["src", "extensions", "ignore", "tokenFiles", "ignoreTokenPrefixes", "localPrimitiveDirs", "build"];
@@ -75,7 +78,8 @@ function loadConfig(root, configPath) {
75
78
  }
76
79
  const own = path3.join(root, "genesis.config.json");
77
80
  if (existsSync(own)) {
78
- return { config: validateConfig(readJson(own)?.doctor ?? {}, own), file: own, dir: root };
81
+ const block = readGenesisConfig(root)?.raw.doctor;
82
+ return { config: validateConfig(block ?? {}, own), file: own, dir: root };
79
83
  }
80
84
  const pkg = path3.join(root, "package.json");
81
85
  if (existsSync(pkg)) {
@@ -91,6 +95,43 @@ function readJson(file) {
91
95
  throw new DoctorConfigError(`${file} is not valid JSON: ${err.message}`);
92
96
  }
93
97
  }
98
+ function readGenesisConfig(root) {
99
+ const file = path3.join(root, "genesis.config.json");
100
+ if (!existsSync(file)) return null;
101
+ const raw = readJson(file);
102
+ if (!isObject(raw)) throw new GenesisConfigError(`${file}: the config must be a JSON object`);
103
+ const links = raw.links === void 0 ? void 0 : validateLinks(raw.links, file);
104
+ return links ? { raw, links } : { raw };
105
+ }
106
+ var LINK_KEYS = /* @__PURE__ */ new Set(["hosts", "paths", "webcredentials"]);
107
+ var HOST = /^(?=.{1,253}$)(\*\.)?([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/;
108
+ function validateLinks(raw, source = "config") {
109
+ const fail = (msg) => {
110
+ throw new GenesisConfigError(`${source}: ${msg}`);
111
+ };
112
+ if (!isObject(raw)) fail(`"links" must be an object`);
113
+ const c = raw;
114
+ for (const key of Object.keys(c)) if (!LINK_KEYS.has(key)) fail(`links: unknown setting "${key}"`);
115
+ if (!isStringList(c.hosts) || c.hosts.length === 0) fail(`links.hosts must be a non-empty list of host names`);
116
+ for (const host of c.hosts) {
117
+ if (!HOST.test(host)) {
118
+ fail(`links.hosts: "${host}" is not a bare lower-case host name (no scheme, path or port), e.g. "example.com"`);
119
+ }
120
+ }
121
+ if (c.paths !== void 0) {
122
+ if (!isStringList(c.paths)) fail(`links.paths must be a list of path prefixes`);
123
+ for (const p of c.paths) {
124
+ if (!p.startsWith("/") || /[\s?#*]/.test(p)) {
125
+ fail(`links.paths: "${p}" must start with "/" and hold no spaces, "?", "#" or "*"`);
126
+ }
127
+ }
128
+ }
129
+ if (c.webcredentials !== void 0 && typeof c.webcredentials !== "boolean") fail(`links.webcredentials must be true or false`);
130
+ const links = { hosts: [...new Set(c.hosts)] };
131
+ if (c.paths !== void 0) links.paths = [...new Set(c.paths)];
132
+ if (c.webcredentials !== void 0) links.webcredentials = c.webcredentials;
133
+ return links;
134
+ }
94
135
  function validateConfig(raw, source = "config") {
95
136
  const fail = (msg) => {
96
137
  throw new DoctorConfigError(`${source}: ${msg}`);
@@ -195,7 +236,7 @@ function globToRegExp(glob) {
195
236
  }
196
237
  function globMatcher(globs) {
197
238
  const res = (globs ?? []).filter((g) => g.trim()).map(globToRegExp);
198
- return (path10) => res.some((re) => re.test(path10));
239
+ return (path11) => res.some((re) => re.test(path11));
199
240
  }
200
241
  var DEFAULT_UI_PACKAGE = "@marktiderman/genesis-ui";
201
242
  var DESIGN_SYSTEM_PACKAGE = "@marktiderman/genesis-design-system";
@@ -748,7 +789,8 @@ var BUILTIN_RULES = [
748
789
  "arbitrary-color",
749
790
  "raw-color",
750
791
  "undefined-token",
751
- "shadowed-export"
792
+ "shadowed-export",
793
+ "version-skew"
752
794
  ];
753
795
  var DEFAULT_LOCAL_PRIMITIVE_DIRS = ["src/components/ui"];
754
796
  var STARTER_LEFTOVERS = ["components.json", "src/lib/utils.ts"];
@@ -894,6 +936,30 @@ function unusedComponents(ctx) {
894
936
  }
895
937
  return ctx.genesis.components.filter((c) => !used.has(c));
896
938
  }
939
+ var UMBRELLA_PACKAGE = "@marktiderman/genesis";
940
+ function readReleaseManifest(root) {
941
+ const dir = findPackageDir(root, UMBRELLA_PACKAGE);
942
+ const file = dir && path3.join(dir, "dist", "versions.json");
943
+ if (!file || !existsSync(file)) return null;
944
+ return JSON.parse(readFileSync(file, "utf8"));
945
+ }
946
+ function checkVersionSkew(ctx) {
947
+ const manifest = readReleaseManifest(ctx.root);
948
+ if (!manifest) return;
949
+ for (const [name, want] of Object.entries(manifest.packages)) {
950
+ const dir = findPackageDir(ctx.root, name);
951
+ if (!dir) continue;
952
+ const have = JSON.parse(readFileSync(path3.join(dir, "package.json"), "utf8")).version;
953
+ if (have === want) continue;
954
+ ctx.report({
955
+ rule: "version-skew",
956
+ level: "warn",
957
+ file: "package.json",
958
+ subject: name,
959
+ message: `${name} is ${have}, but ${UMBRELLA_PACKAGE} ${manifest.version} was released with ${want}. Install ${name}@${want}, or move every Genesis package to one release.`
960
+ });
961
+ }
962
+ }
897
963
 
898
964
  // src/doctor/index.ts
899
965
  async function runDoctor(options = {}) {
@@ -916,7 +982,8 @@ async function runDoctor(options = {}) {
916
982
  { name: "raw-tags", check: checkRawTags },
917
983
  { name: "colors", check: checkColors },
918
984
  { name: "tokens", check: checkTokens },
919
- { name: "shadowed-exports", check: checkShadowedExports }
985
+ { name: "shadowed-exports", check: checkShadowedExports },
986
+ { name: "version-skew", check: checkVersionSkew }
920
987
  ];
921
988
  for (const plugin of [...builtins, ...patterns ? [patterns.plugin] : [], ...plugins]) {
922
989
  try {