@forumone/create-throughline 0.2.1 → 0.3.1

package/dist/templates/without-reference-ds/design-system/src/foundations/Welcome.stories.tsx

@@ -0,0 +1,24 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+
+const meta: Meta = {
+  title: 'Foundations/Welcome',
+}
+export default meta
+
+export const Welcome: StoryObj = {
+  render: () => (
+    <div style={{ fontFamily: 'system-ui, sans-serif', padding: '2rem', maxWidth: '40rem', lineHeight: 1.6 }}>
+      <h1>Your design system</h1>
+      <p>
+        This is an empty Storybook authoring environment. Add components under{' '}
+        <code>src/components/</code> with a <code>.stories.tsx</code> story and a{' '}
+        <code>.contract.ts</code> contract, and document your tokens in{' '}
+        <code>src/foundations/</code> (Colors, Typography, Spacing, Radii, Layout &amp; Containers).
+      </p>
+      <p>
+        Tip: <code>pnpm create @forumone/throughline</code> with the reference design system gives
+        you 12 worked examples to start from.
+      </p>
+    </div>
+  ),
+}

package/dist/templates/without-reference-ds/design-system/src/index.ts

@@ -0,0 +1,9 @@
+// Your design system's public surface. Export your components from here as you
+// build them under `./components/`, then write a contract (`.contract.ts`) and
+// a Storybook story (`.stories.tsx`) for each so the Components MCP server can
+// reason about them.
+//
+// The web app's Components MCP server reads a manifest. Point it at your
+// manifest in `apps/web/src/payload.config.ts` (`componentsPlugin({ manifest })`)
+// once you generate one.
+export {}

package/dist/templates/without-reference-ds/design-system/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "noEmit": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "storybook-static", "node_modules"]
+}

package/dist/utils/versions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The version of every Throughline package the scaffold depends on, keyed for
+ * the template renderer: `@forumone/throughline-design-contract` becomes
+ * `version_design_contract`, rendered as `"^{{version_design_contract}}"`.
+ *
+ * The ranges used to be typed into the templates by hand, and nothing moved
+ * them: they sat at `^0.2.0` — which for a 0.x version admits patches only —
+ * while the packages reached 0.9 and 0.10. A scaffolded site installed the
+ * earliest releases, against a `payload.config.ts` written for today's APIs.
+ *
+ * So the versions are read, never typed. A published scaffolder reads
+ * `versions.json`, which `copy-templates` writes beside `templates/` at build
+ * time; `publish-packages` builds after `changeset version`, so that file names
+ * exactly the set being published. Running from source (tests, `tsx`), there is
+ * no such file and the workspace's own `package.json` files are the answer.
+ */
+export declare function loadPackageVersions(templatesDir: string): Promise<Record<string, string>>;
+/** `{ '@forumone/throughline-core': '0.9.1', … }` from a `packages/` directory. */
+export declare function readWorkspaceVersions(packagesDir: string): Promise<Record<string, string>>;
+//# sourceMappingURL=versions.d.ts.map

package/dist/utils/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/utils/versions.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAO/F;AAED,mFAAmF;AACnF,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA0BhG"}

package/dist/utils/versions.js

@@ -0,0 +1,59 @@
+import { existsSync } from 'node:fs';
+import { readFile, readdir } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+const SCOPE_PREFIX = '@forumone/throughline-';
+/**
+ * The version of every Throughline package the scaffold depends on, keyed for
+ * the template renderer: `@forumone/throughline-design-contract` becomes
+ * `version_design_contract`, rendered as `"^{{version_design_contract}}"`.
+ *
+ * The ranges used to be typed into the templates by hand, and nothing moved
+ * them: they sat at `^0.2.0` — which for a 0.x version admits patches only —
+ * while the packages reached 0.9 and 0.10. A scaffolded site installed the
+ * earliest releases, against a `payload.config.ts` written for today's APIs.
+ *
+ * So the versions are read, never typed. A published scaffolder reads
+ * `versions.json`, which `copy-templates` writes beside `templates/` at build
+ * time; `publish-packages` builds after `changeset version`, so that file names
+ * exactly the set being published. Running from source (tests, `tsx`), there is
+ * no such file and the workspace's own `package.json` files are the answer.
+ */
+export async function loadPackageVersions(templatesDir) {
+    const baked = resolve(templatesDir, '..', 'versions.json');
+    if (existsSync(baked)) {
+        return templateKeys(JSON.parse(await readFile(baked, 'utf-8')));
+    }
+    // src/templates or dist/templates -> the package -> packages/
+    return templateKeys(await readWorkspaceVersions(resolve(templatesDir, '..', '..', '..')));
+}
+/** `{ '@forumone/throughline-core': '0.9.1', … }` from a `packages/` directory. */
+export async function readWorkspaceVersions(packagesDir) {
+    const versions = {};
+    const entries = await readdir(packagesDir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const manifest = join(packagesDir, entry.name, 'package.json');
+        if (!existsSync(manifest))
+            continue;
+        const { name, version, private: isPrivate, } = JSON.parse(await readFile(manifest, 'utf-8'));
+        if (!name?.startsWith(SCOPE_PREFIX) || !version || isPrivate)
+            continue;
+        versions[name] = version;
+    }
+    if (Object.keys(versions).length === 0) {
+        throw new Error(`create-throughline: no package versions found. Expected versions.json beside the ` +
+            `templates, or @forumone/throughline-* packages in ${packagesDir}.`);
+    }
+    return versions;
+}
+function templateKeys(versions) {
+    const keys = {};
+    for (const [name, version] of Object.entries(versions)) {
+        if (!name.startsWith(SCOPE_PREFIX))
+            continue;
+        keys[`version_${name.slice(SCOPE_PREFIX.length).replace(/-/g, '_')}`] = version;
+    }
+    return keys;
+}
+//# sourceMappingURL=versions.js.map

package/dist/utils/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/utils/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,YAAY,GAAG,wBAAwB,CAAA;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,YAAoB;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC,CAAA;IAC1D,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAA2B,CAAC,CAAA;IAC3F,CAAC;IACD,8DAA8D;IAC9D,OAAO,YAAY,CAAC,MAAM,qBAAqB,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAC3F,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB;IAC7D,MAAM,QAAQ,GAA2B,EAAE,CAAA;IAC3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IACnF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAQ;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;QAC9D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAQ;QACnC,MAAM,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EAAE,SAAS,GACnB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAI/C,CAAA;QACD,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS;YAAE,SAAQ;QACtE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,qDAAqD,WAAW,GAAG,CACtE,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,QAAgC;IACpD,MAAM,IAAI,GAA2B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,SAAQ;QAC5C,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;IACjF,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/versions.json

@@ -0,0 +1,14 @@
+{
+  "@forumone/throughline-approvals": "0.8.8",
+  "@forumone/throughline-audit": "0.5.4",
+  "@forumone/throughline-components": "0.5.7",
+  "@forumone/throughline-core": "0.9.1",
+  "@forumone/throughline-design-contract": "0.6.0",
+  "@forumone/throughline-email": "0.2.12",
+  "@forumone/throughline-forms": "0.6.4",
+  "@forumone/throughline-integrations": "0.8.5",
+  "@forumone/throughline-plugin-contract": "0.4.1",
+  "@forumone/throughline-publishing": "0.10.0",
+  "@forumone/throughline-reference-ds": "0.3.5",
+  "@forumone/throughline-workflows": "0.4.0"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forumone/create-throughline",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Scaffolder for new Throughline projects (Payload CMS + MCP servers + Inngest workflows).",
   "type": "module",
   "bin": {
@@ -45,11 +45,12 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.0",
-    "eslint": "^9.15.0",
+    "eslint": "^10.11.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.1.0",
-    "@forumone/throughline-eslint-config": "0.0.0",
-    "@forumone/throughline-tsconfig": "0.0.0"
+    "vitest": "^4.1.10",
+    "@forumone/throughline-tsconfig": "0.0.0",
+    "@forumone/throughline-eslint-config": "0.0.0"
   },
   "engines": {
     "node": ">=20.9.0"
@@ -58,6 +59,7 @@
     "build": "tsc -b && pnpm copy-templates && pnpm chmod-bin",
     "copy-templates": "node ./scripts/copy-templates.mjs",
     "chmod-bin": "node ./scripts/chmod-bin.mjs",
+    "sync-reference-ds": "tsx scripts/sync-reference-ds.ts",
     "dev": "tsc -b -w",
     "clean": "rm -rf dist .turbo *.tsbuildinfo",
     "typecheck": "tsc --noEmit",

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

@@ -1,18 +0,0 @@
-{
-  "name": "{{#if packageScope}}@{{packageScope}}/design-system{{else}}{{projectName}}-design-system{{/if}}",
-  "version": "0.0.0",
-  "private": true,
-  "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./manifest": "./src/manifest.ts"
-  },
-  "dependencies": {
-    "@forumone/throughline-reference-ds": "^0.2.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.6.0"
-  }
-}

package/dist/templates/with-reference-ds/packages/design-system/src/index.ts

@@ -1,6 +0,0 @@
-// Re-export the Throughline reference design system. Wrap or override
-// individual components here when you start building your own brand layer
-// (e.g. swap colors, replace Hero, add new components). When you have
-// enough custom work to stand alone, drop the reference DS dependency
-// and replace this file with your own component exports.
-export * from '@forumone/throughline-reference-ds'

package/dist/templates/with-reference-ds/packages/design-system/src/manifest.ts

@@ -1,6 +0,0 @@
-// Re-export the reference DS manifest so payload.config.ts can import
-// it from a single workspace path. Replace this with your own manifest
-// import when you stop using the reference DS.
-import manifest from '@forumone/throughline-reference-ds/manifest' with { type: 'json' }
-
-export default manifest

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

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "lib": ["ES2022", "DOM"],
-    "jsx": "preserve"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"]
-}

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

@@ -1,19 +0,0 @@
-# {{projectName}} design system
-
-This is a placeholder for your design system. The Components MCP server in `apps/web/src/payload.config.ts` is configured to read a manifest URL — replace the `https://your-design-system.example.com/manifest.json` value with your real DS's manifest endpoint.
-
-## What the manifest needs to contain
-
-A list of components, each with:
-
-- `name`, `description`, `categories`
-- `props` schema (Zod-compatible JSON description)
-- `slots` (named regions)
-- `tokens` (CSS variables / brand tokens consumed)
-- `examples` (sample inputs Claude can learn from)
-
-See `@forumone/throughline-design-contract` for the full schema.
-
-## Quickest path
-
-If you just want to start moving, `pnpm create @forumone/throughline` again and answer "yes" to the reference design system. You'll get a working setup you can study, swap components in, and slowly replace.

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

@@ -1,14 +0,0 @@
-{
-  "name": "{{#if packageScope}}@{{packageScope}}/design-system{{else}}{{projectName}}-design-system{{/if}}",
-  "version": "0.0.0",
-  "private": true,
-  "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "devDependencies": {
-    "typescript": "^5.6.0"
-  }
-}

package/dist/templates/without-reference-ds/packages/design-system/src/index.ts

@@ -1,8 +0,0 @@
-// This file is a placeholder. Bring your own design system here:
-// - Vendor your component source under `./components/` and re-export from here
-// - Or publish the DS separately and replace this package with the consumer
-//
-// The Components MCP server reads a manifest URL from your payload.config.ts
-// (see `componentsPlugin({ manifest })`). Update that URL to point at your
-// design system's manifest endpoint once you have one.
-export {}