@forumone/create-throughline 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @forumone/create-throughline
 
+## 0.3.0
+
+### Minor Changes
+
+- e994176: Scaffold a real Storybook authoring environment for the design system.
+
+  When you scaffold with the reference design system, the generator now creates a top-level `design-system/` workspace (a sibling of `apps/`, matching the Forum One `forumone.com-2026` layout) that vendors the reference DS's **editable source** — 12 components with `.stories.tsx`, `.contract.ts`, tokens, and a Storybook instance — instead of re-exporting the compiled npm package. New projects can run `pnpm storybook` immediately, author components, and `pnpm validate` to cross-check every contract `storyId` against the built Storybook.
+
+  Also:
+  - The web app now imports the workspace design system's built manifest (`<scope>/design-system/manifest`) instead of the npm reference-ds manifest, and the root `pnpm dev` builds the design system first so the manifest exists.
+  - Root scripts `storybook`, `build-storybook`, and `validate`; turbo tasks to match; `design-system` added to the workspace globs.
+  - Fix: template `.gitignore` files are now authored as `gitignore` and restored on output, so they survive npm publish (previously the generated project shipped without a root `.gitignore`).
+  - Fix: the generated web app now typechecks clean. Adds the `@payload-config` tsconfig path; corrects drifted plugin APIs in `route.ts` (`publishingApiKey`, `createPayloadReachableCheck()`) and `payload.config.ts` (`auditQueryPlugin({})`, `buildActionUrl` async `{ approvalId, action, approverId }`, manifest typed as `Manifest`).
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/generator.d.ts

@@ -37,9 +37,11 @@ interface RenderArgs {
  */
 declare function renderDirectory({ source, target, data }: RenderArgs): Promise<void>;
 declare function isBinary(filename: string): boolean;
+declare function applyDotfileRename(name: string): string;
 export declare const __testing: {
     renderDirectory: typeof renderDirectory;
     isBinary: typeof isBinary;
+    applyDotfileRename: typeof applyDotfileRename;
     rename: typeof rename;
     rm: typeof rm;
     stat: typeof stat;

package/dist/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAa,MAAM,kBAAkB,CAAA;AAI5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7F;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;;;;;;;;GASG;AACH,iBAAe,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmClF;AAiBD,iBAAS,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI3C;AA6BD,eAAO,MAAM,SAAS;;;;;;CAAkD,CAAA"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAa,MAAM,kBAAkB,CAAA;AAI5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC7F;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;;;;;;;;GASG;AACH,iBAAe,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmClF;AAiBD,iBAAS,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI3C;AAUD,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AA6BD,eAAO,MAAM,SAAS;;;;;;;CAAsE,CAAA"}

package/dist/generator.js

@@ -19,19 +19,26 @@ const DEFAULT_TEMPLATES_DIR = resolve(__dirname, 'templates');
 export async function generate(answers, options = {}) {
     const templatesDir = options.templatesDir ?? DEFAULT_TEMPLATES_DIR;
     const onProgress = options.onProgress ?? (() => { });
+    // Precompute the design-system package name. The renderer has no nesting, so
+    // we can't put `{{#if packageScope}}...{{/if}}` inside another `{{#if}}`
+    // block (e.g. inside `{{#if useReferenceDs}}` in payload.config).
+    const designSystemName = answers.packageScope
+        ? `@${answers.packageScope}/design-system`
+        : `${answers.projectName}-design-system`;
+    const data = { ...answers, designSystemName };
     onProgress('Creating project structure');
     await mkdir(answers.targetDir, { recursive: true });
     await renderDirectory({
         source: join(templatesDir, 'base'),
         target: answers.targetDir,
-        data: answers,
+        data,
     });
     onProgress(answers.useReferenceDs ? 'Wiring reference design system' : 'Preparing design system placeholder');
     const overlay = answers.useReferenceDs ? 'with-reference-ds' : 'without-reference-ds';
     await renderDirectory({
         source: join(templatesDir, overlay),
         target: answers.targetDir,
-        data: answers,
+        data,
     });
     if (answers.initializeGit && !options.skipSideEffects) {
         onProgress('Initializing git');
@@ -64,7 +71,7 @@ async function renderDirectory({ source, target, data }) {
     }
     await mkdir(target, { recursive: true });
     for (const entry of entries) {
-        const renderedName = renderTemplate(entry.name, data);
+        const renderedName = applyDotfileRename(renderTemplate(entry.name, data));
         const sourcePath = join(source, entry.name);
         const targetPath = join(target, renderedName);
         if (entry.isDirectory()) {
@@ -105,6 +112,16 @@ function isBinary(filename) {
         return false;
     return BINARY_EXTENSIONS.has(filename.slice(dot).toLowerCase());
 }
+/**
+ * npm strips files literally named `.gitignore` from a published tarball, so
+ * we author them as `gitignore` in templates and restore the dot on output.
+ */
+const DOTFILE_RENAMES = {
+    gitignore: '.gitignore',
+};
+function applyDotfileRename(name) {
+    return DOTFILE_RENAMES[name] ?? name;
+}
 async function initGit(dir) {
     await runCommand('git', ['init'], dir);
     await runCommand('git', ['add', '.'], dir);
@@ -127,5 +144,5 @@ function runCommand(cmd, args, cwd) {
 }
 // Re-exports kept around so tests in adjacent packages can stub these without
 // reaching into the implementation. Not part of the public API surface.
-export const __testing = { renderDirectory, isBinary, rename, rm, stat };
+export const __testing = { renderDirectory, isBinary, applyDotfileRename, rename, rm, stat };
 //# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}

package/dist/templates/base/apps/web/package.json.template

@@ -21,7 +21,8 @@
     "@forumone/throughline-integrations": "^0.2.0",
     "@forumone/throughline-publishing": "^0.2.0",
     "@forumone/throughline-workflows": "^0.2.0",
-    {{#if useReferenceDs}}"@forumone/throughline-reference-ds": "^0.2.0",
+    {{#if useReferenceDs}}"@forumone/throughline-design-contract": "^0.2.0",
+    "{{designSystemName}}": "workspace:*",
     {{/if}}"@payloadcms/db-postgres": "^3.83.0",
     "@payloadcms/next": "^3.83.0",
     "@payloadcms/plugin-form-builder": "3.83.0",

package/dist/templates/base/apps/web/src/app/api/inngest/route.ts.template

@@ -40,14 +40,14 @@ export const { GET, POST, PUT } = serve({
       payload,
       collections: [{ slug: 'pages' }],
       publishingServerUrl: process.env.NEXT_PUBLIC_SERVER_URL!,
-      systemApiKey: process.env.PUBLISHING_SYSTEM_API_KEY!,
+      publishingApiKey: process.env.PUBLISHING_SYSTEM_API_KEY!,
     }),
     createExpireStaleApprovalsFunction({ inngest, payload }),
     createAuditEventEchoFunction({ inngest }),
     createHealthcheckFunction({
       inngest,
       payload,
-      checks: [createPayloadReachableCheck({ payload })],
+      checks: [createPayloadReachableCheck()],
     }),
     ...emailFunctions,
     ...formsFunctions,

package/dist/templates/base/apps/web/src/payload.config.ts.template

@@ -16,7 +16,8 @@ import { auditQueryPlugin } from '@forumone/throughline-audit'
 import { integrationsPlugin } from '@forumone/throughline-integrations'
 import { emailPlugin } from '@forumone/throughline-email'
 import { formsPlugin } from '@forumone/throughline-forms'
-{{#if useReferenceDs}}import referenceManifest from '@forumone/throughline-reference-ds/manifest' with { type: 'json' }
+{{#if useReferenceDs}}import type { Manifest } from '@forumone/throughline-design-contract'
+import designSystemManifest from '{{designSystemName}}/manifest' with { type: 'json' }
 {{/if}}
 
 const __filename = fileURLToPath(import.meta.url)
@@ -101,7 +102,7 @@ export default buildConfig({
     auditPlugin({ inngest }),
 
     componentsPlugin({
-      {{#if useReferenceDs}}manifest: { type: 'object', manifest: referenceManifest },
+      {{#if useReferenceDs}}manifest: { type: 'object', manifest: designSystemManifest as unknown as Manifest },
       {{else}}// TODO: point at your design system manifest
       manifest: { type: 'url', url: 'https://your-design-system.example.com/manifest.json' },
       {{/if}}matching: { strategy: 'tfidf' },
@@ -132,15 +133,16 @@ export default buildConfig({
       },
     }),
 
-    auditQueryPlugin(),
+    auditQueryPlugin({}),
 
     emailPlugin({
       inngest,
       // TODO: replace with your real user lookups
       resolveApprover: async (_userId) => null,
       resolveRequester: async (_userId) => null,
-      buildActionUrl: ({ token, action }) =>
-        `${process.env.NEXT_PUBLIC_SERVER_URL}/api/approvals/decision?token=${token}&action=${action}`,
+      // TODO: sign these URLs (HMAC) so an approval decision can't be forged.
+      buildActionUrl: async ({ approvalId, action, approverId }) =>
+        `${process.env.NEXT_PUBLIC_SERVER_URL}/api/approvals/decision?approval=${approvalId}&action=${action}&approver=${approverId}`,
       tokens: { brandName: '{{projectName}}' },
     }),
 

package/dist/templates/base/apps/web/tsconfig.json

@@ -11,7 +11,8 @@
     "isolatedModules": true,
     "plugins": [{ "name": "next" }],
     "paths": {
-      "@/*": ["./src/*"]
+      "@/*": ["./src/*"],
+      "@payload-config": ["./src/payload.config.ts"]
     }
   },
   "include": [

package/dist/templates/base/gitignore

@@ -0,0 +1,15 @@
+node_modules/
+.next/
+.turbo/
+dist/
+*.tsbuildinfo
+
+.env
+.env.local
+.env.*.local
+
+.DS_Store
+.idea/
+.vscode/
+
+coverage/

package/dist/templates/base/package.json.template

@@ -4,7 +4,10 @@
   "type": "module",
   "scripts": {
     "build": "turbo run build",
-    "dev": "turbo run dev",
+    "dev": "{{#if useReferenceDs}}pnpm --filter \"./design-system\" build && {{/if}}turbo run dev",
+    "storybook": "turbo run storybook",
+    "build-storybook": "turbo run build-storybook",
+    "validate": "turbo run validate",
     "lint": "turbo run lint",
     "typecheck": "turbo run typecheck",
     "test": "turbo run test",

package/dist/templates/base/pnpm-workspace.yaml

@@ -1,3 +1,4 @@
 packages:
   - apps/*
+  - design-system
   - packages/*

package/dist/templates/base/turbo.json

@@ -7,6 +7,17 @@
       "outputs": ["dist/**", ".next/**", "!.next/cache/**"],
       "env": ["NODE_ENV"]
     },
+    "build-storybook": {
+      "dependsOn": ["^build"],
+      "outputs": ["storybook-static/**"]
+    },
+    "storybook": {
+      "cache": false,
+      "persistent": true
+    },
+    "validate": {
+      "dependsOn": ["build"]
+    },
     "dev": {
       "cache": false,
       "persistent": true

package/dist/templates/with-reference-ds/design-system/.storybook/main.ts

@@ -0,0 +1,21 @@
+import type { StorybookConfig } from '@storybook/react-vite'
+
+const config: StorybookConfig = {
+  stories: [
+    '../src/foundations/**/*.stories.@(ts|tsx)',
+    '../src/components/**/*.stories.@(ts|tsx)',
+  ],
+  addons: ['@storybook/addon-a11y'],
+  framework: {
+    name: '@storybook/react-vite',
+    options: {},
+  },
+  typescript: {
+    reactDocgen: 'react-docgen-typescript',
+  },
+  docs: {
+    autodocs: true,
+  },
+}
+
+export default config

package/dist/templates/with-reference-ds/design-system/.storybook/preview.ts

@@ -0,0 +1,19 @@
+import type { Preview } from '@storybook/react-vite'
+import '../src/styles/reset.css'
+import '../src/styles/tokens.css'
+import '../src/styles/base.css'
+
+const preview: Preview = {
+  parameters: {
+    controls: {
+      matchers: { color: /(background|color)$/i, date: /Date$/i },
+    },
+    a11y: {
+      config: {},
+      options: {},
+      manual: false,
+    },
+  },
+}
+
+export default preview

package/dist/templates/with-reference-ds/design-system/README.md

@@ -0,0 +1,33 @@
+# Design system
+
+Your project's design system and its Storybook authoring environment. It started as a vendored copy of the Throughline reference DS — a working, brand-neutral set of 12 components with contracts — so you can edit it directly and make it your own.
+
+```
+src/
+  tokens/        Design tokens (colors, typography, spacing, radii, layout) → CSS custom properties
+  styles/        reset.css, generated tokens.css, base.css
+  foundations/   Storybook "Foundations" pages (Colors, Typography, Spacing, Radii, Elevation, Layout & Containers)
+  components/    One folder per component: .tsx, .module.css, .stories.tsx, .test.tsx, .contract.ts
+scripts/         build-tokens-css, build-styles, build-manifest, validate
+.storybook/      Storybook (react-vite) config
+```
+
+## Commands
+
+```bash
+pnpm --filter "./design-system" storybook         # author components at http://localhost:6006
+pnpm --filter "./design-system" build             # tokens → tsc → styles → dist/manifest.json
+pnpm --filter "./design-system" build-storybook   # static Storybook (produces storybook-static/index.json)
+pnpm --filter "./design-system" validate          # lint contracts + cross-check every storyId against the built Storybook
+pnpm --filter "./design-system" test              # component tests (vitest + testing-library)
+```
+
+The web app imports `./manifest` (the built `dist/manifest.json`) and feeds it to the Components MCP server. The root `pnpm dev` builds the design system first so the manifest exists.
+
+## Branding
+
+1. Edit `src/tokens/*` — components read tokens as CSS variables, so re-theming doesn't touch component code.
+2. Edit or add components under `src/components/`. Keep each component's `.contract.ts` and `.stories.tsx` in sync; `storyId` must point at a real story (the `validate` script enforces this).
+3. Update the **Foundations** pages in `src/foundations/` as your tokens change.
+
+See the Throughline docs: `concepts/design-system-contracts.md` and `guides/authoring-component-contracts.md`.

package/dist/templates/with-reference-ds/design-system/gitignore

@@ -0,0 +1,5 @@
+dist
+storybook-static
+node_modules
+*.tsbuildinfo
+.turbo

package/dist/templates/with-reference-ds/design-system/package.json.template

@@ -0,0 +1,62 @@
+{
+  "name": "{{designSystemName}}",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./styles.css": "./dist/styles/index.css",
+    "./styles/tokens.css": "./dist/styles/tokens.css",
+    "./styles/reset.css": "./dist/styles/reset.css",
+    "./styles/base.css": "./dist/styles/base.css",
+    "./tokens": {
+      "types": "./dist/tokens/index.d.ts",
+      "default": "./dist/tokens/index.js"
+    }
+  },
+  "scripts": {
+    "build": "pnpm build:tokens-css && tsc -b && pnpm build:styles && pnpm build:manifest",
+    "build:tokens-css": "tsx scripts/build-tokens-css.ts",
+    "build:styles": "tsx scripts/build-styles.ts",
+    "build:manifest": "tsx scripts/build-manifest.ts",
+    "build-storybook": "storybook build",
+    "storybook": "storybook dev -p 6006",
+    "dev": "tsc -b -w",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "validate": "tsx scripts/validate.ts",
+    "clean": "rm -rf dist .turbo storybook-static *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@forumone/throughline-design-contract": "^0.2.0",
+    "clsx": "^2.1.1"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@storybook/addon-a11y": "^10.3.5",
+    "@storybook/react-vite": "^10.3.5",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^20.17.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^6.0.1",
+    "jsdom": "^29.0.2",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "storybook": "^10.3.5",
+    "tsx": "^4.21.0",
+    "typescript": "^5.6.0",
+    "vite": "^8.0.9",
+    "vitest": "^2.1.0"
+  }
+}

package/dist/templates/with-reference-ds/design-system/scripts/build-manifest.ts

@@ -0,0 +1,89 @@
+import { readFile, readdir, stat, writeFile, mkdir } from 'node:fs/promises'
+import { dirname, join, resolve } from 'node:path'
+import { pathToFileURL, fileURLToPath } from 'node:url'
+import {
+  CONTRACT_VERSION,
+  ManifestSchema,
+  type ComponentContract,
+} from '@forumone/throughline-design-contract'
+import { getTokenList } from '../src/tokens/index.ts'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const packageRoot = resolve(__dirname, '..')
+const componentsDir = resolve(packageRoot, 'src/components')
+const outputDir = resolve(packageRoot, 'dist')
+const outputFile = resolve(outputDir, 'manifest.json')
+
+async function readPackageVersion(): Promise<string> {
+  const raw = await readFile(resolve(packageRoot, 'package.json'), 'utf8')
+  const parsed = JSON.parse(raw) as { version?: string }
+  return parsed.version ?? '0.0.0'
+}
+
+async function collectContracts(): Promise<Record<string, ComponentContract>> {
+  const components: Record<string, ComponentContract> = {}
+
+  let entries: string[]
+  try {
+    entries = await readdir(componentsDir)
+  } catch {
+    return components
+  }
+
+  for (const name of entries) {
+    const dir = resolve(componentsDir, name)
+    const dirStat = await stat(dir).catch(() => null)
+    if (!dirStat?.isDirectory()) continue
+
+    const contractPath = join(dir, `${name}.contract.ts`)
+    const contractStat = await stat(contractPath).catch(() => null)
+    if (!contractStat?.isFile()) continue
+
+    const module = (await import(pathToFileURL(contractPath).href)) as {
+      contract?: ComponentContract
+    }
+    if (!module.contract) {
+      throw new Error(`${name}.contract.ts does not export "contract"`)
+    }
+    components[name] = module.contract
+  }
+
+  return components
+}
+
+async function main() {
+  const components = await collectContracts()
+
+  const manifest = {
+    contractVersion: CONTRACT_VERSION,
+    designSystem: {
+      name: '@forumone/throughline-reference-ds',
+      version: await readPackageVersion(),
+      description:
+        'A brand-neutral reference design system demonstrating contract compliance for Throughline.',
+    },
+    tokens: getTokenList(),
+    components,
+    build: {
+      timestamp: new Date().toISOString(),
+      source: 'scripts/build-manifest.ts',
+    },
+  }
+
+  const result = ManifestSchema.safeParse(manifest)
+  if (!result.success) {
+    console.error('Generated manifest failed validation:')
+    for (const issue of result.error.issues) {
+      console.error(`  - ${issue.path.join('.') || '(root)'}: ${issue.message}`)
+    }
+    process.exit(1)
+  }
+
+  await mkdir(outputDir, { recursive: true })
+  await writeFile(outputFile, JSON.stringify(result.data, null, 2), 'utf8')
+
+  const componentCount = Object.keys(components).length
+  console.log(`Wrote ${outputFile} (${componentCount} components)`)
+}
+
+await main()

package/dist/templates/with-reference-ds/design-system/scripts/build-styles.ts

@@ -0,0 +1,28 @@
+import { copyFile, mkdir, readdir, readFile, writeFile } from 'node:fs/promises'
+import { basename, dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const stylesSrc = resolve(__dirname, '../src/styles')
+const stylesDist = resolve(__dirname, '../dist/styles')
+
+await mkdir(stylesDist, { recursive: true })
+
+const entries = await readdir(stylesSrc)
+const cssFiles = entries.filter((f) => f.endsWith('.css'))
+
+for (const file of cssFiles) {
+  await copyFile(resolve(stylesSrc, file), resolve(stylesDist, file))
+}
+
+// Also emit a combined bundle so consumers can import `@forumone/throughline-reference-ds/styles.css`.
+const bundleParts: string[] = []
+for (const file of ['reset.css', 'tokens.css', 'base.css']) {
+  if (cssFiles.includes(file)) {
+    const content = await readFile(resolve(stylesSrc, file), 'utf8')
+    bundleParts.push(`/* ${basename(file)} */\n${content.trim()}\n`)
+  }
+}
+await writeFile(resolve(stylesDist, 'index.css'), bundleParts.join('\n'), 'utf8')
+
+console.log(`Copied ${cssFiles.length} CSS files to dist/styles`)

package/dist/templates/with-reference-ds/design-system/scripts/build-tokens-css.ts

@@ -0,0 +1,43 @@
+import { mkdir, writeFile } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { colors, darkOverrides } from '../src/tokens/colors.ts'
+import { layout } from '../src/tokens/layout.ts'
+import { radii } from '../src/tokens/radii.ts'
+import { spacing } from '../src/tokens/spacing.ts'
+import { typography } from '../src/tokens/typography.ts'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const outputPath = resolve(__dirname, '../src/styles/tokens.css')
+
+/** Turns `color.brand.primaryHover` into `--color-brand-primary-hover`. */
+function tokenToVariable(name: string): string {
+  const kebab = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()
+  return `--${kebab.replace(/\./g, '-')}`
+}
+
+function section(title: string, entries: Array<readonly [string, string]>): string {
+  const rules = entries.map(([name, value]) => `  ${tokenToVariable(name)}: ${value};`).join('\n')
+  return `  /* ${title} */\n${rules}`
+}
+
+const light = [
+  section('Colors', Object.entries(colors)),
+  section('Typography', Object.entries(typography)),
+  section('Spacing', Object.entries(spacing)),
+  section('Radii', Object.entries(radii)),
+  section('Layout & Containers', Object.entries(layout)),
+].join('\n\n')
+
+const dark = Object.entries(darkOverrides)
+  .map(([name, value]) => `    ${tokenToVariable(name)}: ${value};`)
+  .join('\n')
+
+const banner = '/* Auto-generated by scripts/build-tokens-css.ts. Do not edit by hand. */'
+
+const output = `${banner}\n\n:root {\n${light}\n}\n\n@media (prefers-color-scheme: dark) {\n  :root {\n${dark}\n  }\n}\n`
+
+await mkdir(dirname(outputPath), { recursive: true })
+await writeFile(outputPath, output, 'utf8')
+
+console.log(`Wrote ${outputPath}`)

package/dist/templates/with-reference-ds/design-system/scripts/validate.ts

@@ -0,0 +1,58 @@
+import { readFile, stat } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { loadManifest } from '@forumone/throughline-design-contract'
+import { formatLintIssues, lintManifest } from '@forumone/throughline-design-contract/lint'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const packageRoot = resolve(__dirname, '..')
+const manifestPath = resolve(packageRoot, 'dist/manifest.json')
+const storybookIndexPath = resolve(packageRoot, 'storybook-static/index.json')
+
+async function readJson<T>(path: string): Promise<T> {
+  const raw = await readFile(path, 'utf8')
+  return JSON.parse(raw) as T
+}
+
+async function collectStoryIds(): Promise<Set<string> | undefined> {
+  const exists = await stat(storybookIndexPath).catch(() => null)
+  if (!exists) {
+    console.warn(
+      `No storybook-static/index.json found; skipping storyId lint. Run \`pnpm build-storybook\` first to enable it.`,
+    )
+    return undefined
+  }
+  const index = await readJson<{ entries: Record<string, { id: string; type: string }> }>(
+    storybookIndexPath,
+  )
+  const ids = new Set<string>()
+  for (const entry of Object.values(index.entries)) {
+    if (entry.type === 'story') ids.add(entry.id)
+  }
+  return ids
+}
+
+async function main() {
+  const raw = await readJson<unknown>(manifestPath)
+  const loaded = loadManifest(raw)
+
+  const availableStoryIds = await collectStoryIds()
+  const lintOptions = availableStoryIds ? { availableStoryIds } : {}
+
+  const issues = lintManifest(loaded.raw, lintOptions)
+  const errors = issues.filter((i) => i.severity === 'error')
+  const warnings = issues.filter((i) => i.severity === 'warning')
+
+  if (errors.length > 0) {
+    console.error(formatLintIssues(errors))
+    process.exit(1)
+  }
+
+  if (warnings.length > 0) {
+    console.warn(formatLintIssues(warnings))
+  } else {
+    console.log(`Manifest is clean (${loaded.listComponents().length} components).`)
+  }
+}
+
+await main()