create-ailk 0.1.0 → 0.2.0

package/templates/apps/web/jest.config.cjs

@@ -15,7 +15,7 @@ module.exports = {
   // Mirrors the canonical jose carve-out used in apps/api, apps/mcp, and apps-paid/license-issuer.
   // Added: issue #1077
   transformIgnorePatterns: [
-    "/node_modules/(?!(\\.pnpm/)?fumadocs-[^/]*?@?[^/]*?(/|$))",
+    "/node_modules/(?!(\\.pnpm/)?(fumadocs-[^/]*?@?[^/]*?|@working-theory(?:\\+[^/]*?@?[^/]*?|/[^/]+))(/|$))",
   ],
   moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json"],
   // Workspace packages publish ESM in dist/, but ts-jest runs in CommonJS.
@@ -23,7 +23,10 @@ module.exports = {
   moduleNameMapper: {
     // Mock server-only in Jest environments — the package throws by design
     // outside Next.js. The real guard runs in production Next.js builds.
-    "^server-only$": "<rootDir>/../../__mocks__/server-only.ts",
+    "^server-only$": "<rootDir>/__tests__/__mocks__/server-only.ts",
+    // Map all *.css to an empty stub — layout.tsx imports ./globals.css (#4090 item 1)
+    // and CSS is not parseable by ts-jest's CommonJS transform (apps-paid/marketing-web precedent, #1531).
+    "\\.css$": "<rootDir>/__tests__/__mocks__/style-mock.js",
     // Fumadocs codegen output — produced by `pnpm --filter @working-theory/web build` into .source/
     // The server entry uses top-level await + ESM-only fumadocs-mdx/runtime/server;
     // map to a CJS stub so ts-jest can load modules that import lib/source.ts. (#1077)
@@ -31,40 +34,85 @@ module.exports = {
     "^@/\\.source/server$": "<rootDir>/lib/__mocks__/source-server.js",
     "^@/\\.source$": "<rootDir>/.source/index.ts",
     "^@working-theory/page-renderer/testing$":
-      "<rootDir>/../../packages/page-renderer/src/testing.ts",
+      "<rootDir>/node_modules/@working-theory/page-renderer/dist/testing.js",
     "^@working-theory/page-renderer$":
-      "<rootDir>/../../packages/page-renderer/src/index.tsx",
+      "<rootDir>/node_modules/@working-theory/page-renderer/dist/index.js",
     "^@working-theory/page-renderer/edge$":
-      "<rootDir>/../../packages/page-renderer/src/edge.ts",
-    "^@working-theory/analytics$": "<rootDir>/../../packages/analytics/src/index.ts",
-    "^@working-theory/api-client$": "<rootDir>/../../packages/api-client/src/index.ts",
+      "<rootDir>/node_modules/@working-theory/page-renderer/dist/edge.js",
+    "^@working-theory/analytics$": "<rootDir>/node_modules/@working-theory/analytics/dist/index.js",
+    // #4534: intake-analytics.ts is apps/web's first `/server` subpath
+    // consumer — mirrors apps/api/jest.config.cjs's existing mapping (that
+    // subpath's dist/ isn't built in this workspace pre-`pnpm build`, so
+    // ts-jest needs the source path directly, same as the root package).
+    "^@working-theory/analytics/server$":
+      "<rootDir>/node_modules/@working-theory/analytics/dist/server/index.js",
+    "^@vercel/analytics/server$":
+      "<rootDir>/__tests__/__mocks__/vercel-analytics-server.ts",
+    "^@working-theory/api-client$": "<rootDir>/node_modules/@working-theory/api-client/dist/index.js",
     "^@working-theory/content-adapters$":
-      "<rootDir>/../../packages/content-adapters/src/index.ts",
+      "<rootDir>/node_modules/@working-theory/content-adapters/dist/index.js",
     "^@working-theory/fumadocs-schema$":
-      "<rootDir>/../../packages/fumadocs-schema/src/index.ts",
-    "^@working-theory/license$": "<rootDir>/../../packages/license/src/index.ts",
-    "^@working-theory/metadata$": "<rootDir>/../../packages/metadata/src/index.ts",
+      "<rootDir>/node_modules/@working-theory/fumadocs-schema/dist/index.js",
+    "^@working-theory/license$": "<rootDir>/node_modules/@working-theory/license/dist/index.js",
+    "^@working-theory/jsonld$": "<rootDir>/node_modules/@working-theory/jsonld/dist/index.js",
+    "^@working-theory/metadata$": "<rootDir>/node_modules/@working-theory/metadata/dist/index.js",
     // Dependency-free fragment subpaths (faq/person/review/…) → source, so CJS
     // jest transforms them instead of choking on the dist ESM re-exports.
-    "^@working-theory/schema/(.*)$": "<rootDir>/../../packages/schema/src/$1.ts",
-    "^@working-theory/schema$": "<rootDir>/../../packages/schema/src/index.ts",
+    "^@working-theory/schema/(.*)$": "<rootDir>/node_modules/@working-theory/schema/dist/$1.js",
+    "^@working-theory/schema$": "<rootDir>/node_modules/@working-theory/schema/dist/index.js",
     "^@working-theory/schema-pack-registry$":
-      "<rootDir>/../../packages/schema-pack-registry/src/index.ts",
+      "<rootDir>/node_modules/@working-theory/schema-pack-registry/dist/index.js",
+    "^@working-theory/schema-validator$":
+      "<rootDir>/node_modules/@working-theory/schema-validator/dist/index.js",
     "^@working-theory/sections-registry$":
-      "<rootDir>/../../packages/sections-registry/src/index.ts",
+      "<rootDir>/node_modules/@working-theory/sections-registry/dist/index.js",
     "^@working-theory/templates/shells$":
-      "<rootDir>/../../packages/templates/src/shells/index.ts",
-    "^@working-theory/templates$": "<rootDir>/../../packages/templates/src/index.ts",
-    "^@working-theory/ui$": "<rootDir>/../../packages/ui/src/index.ts",
-    "^@working-theory/ui/blocks$": "<rootDir>/../../packages/ui/src/blocks/index.ts",
-    "^@working-theory/ui/chrome$": "<rootDir>/../../packages/ui/src/chrome/index.ts",
+      "<rootDir>/node_modules/@working-theory/templates/dist/shells/index.js",
+    "^@working-theory/templates$": "<rootDir>/node_modules/@working-theory/templates/dist/index.js",
+    "^@working-theory/ui$": "<rootDir>/node_modules/@working-theory/ui/dist/index.js",
+    "^@working-theory/ui/blocks$": "<rootDir>/node_modules/@working-theory/ui/dist/blocks/index.js",
+    "^@working-theory/ui/chrome$": "<rootDir>/node_modules/@working-theory/ui/dist/chrome/index.js",
     "^@working-theory/ui/primitives$":
-      "<rootDir>/../../packages/ui/src/primitives/index.ts",
-    "^@working-theory/ui/panels$": "<rootDir>/../../packages/ui/src/panels/index.ts",
-    "^@working-theory/ui/sections$": "<rootDir>/../../packages/ui/src/sections/index.ts",
-    "^@working-theory/theme$": "<rootDir>/../../packages/theme/src/index.ts",
-    "^@working-theory/validation$": "<rootDir>/../../packages/validation/src/index.ts",
-    "^@working-theory/web-i18n$": "<rootDir>/../../packages/web-i18n/src/index.ts",
+      "<rootDir>/node_modules/@working-theory/ui/dist/primitives/index.js",
+    "^@working-theory/ui/panels$": "<rootDir>/node_modules/@working-theory/ui/dist/panels/index.js",
+    "^@working-theory/ui/sections$": "<rootDir>/node_modules/@working-theory/ui/dist/sections/index.js",
+    // #5214: the scheduling slice's renderer-registration subpath. Mapped to
+    // source like every sibling above — packages/ui/dist isn't built in this
+    // workspace pre-`pnpm build`. The target strips with the slice on the public
+    // tree, where nothing imports it, so the unused mapping is inert there.
+    "^@working-theory/ui/slices/scheduling$":
+      "<rootDir>/node_modules/@working-theory/ui/dist/sections/slices/scheduling.js",
+    "^@working-theory/theme$": "<rootDir>/node_modules/@working-theory/theme/dist/index.js",
+    // site-config publishes ESM in dist/; map to source so ts-jest compiles it
+    // through the same transformer as every sibling above. Only the
+    // client-safe /schema entry is mapped — architecture.yaml forbids apps/web
+    // from importing /server at all (#1567).
+    "^@working-theory/site-config/schema$":
+      "<rootDir>/node_modules/@working-theory/site-config/dist/schema/index.js",
+    "^@working-theory/validation$": "<rootDir>/node_modules/@working-theory/validation/dist/index.js",
+    "^@working-theory/web-i18n$": "<rootDir>/node_modules/@working-theory/web-i18n/dist/index.js",
+    // #5025: pnpm keys next-intl's virtual-store path on its resolved peers,
+    // so apps/web and packages/page-renderer can link two PHYSICALLY DISTINCT
+    // copies of the same version — and a `jest.mock("next-intl/server")` in
+    // setup.ts covers only one of them. The unmocked copy resolves `./server`
+    // to the react-client build (no `react-server` condition in jsdom), which
+    // throws "`getTranslations` is not supported in Client Components" when
+    // page-renderer calls it. Mapping is path-independent, so every copy lands
+    // on one module; per-test jest.mock() overrides still win, because jest
+    // resolves the specifier through this mapper first.
+    // Canonicalize next/navigation to a single physical module — the same
+    // remedy the sibling marketing app has carried since #2354, now needed
+    // here too (#5025). `next` itself is peer-keyed, so
+    // apps/web and packages/page-renderer link different next@16.3.3 copies.
+    // A test's `jest.mock("next/navigation")` then binds to one copy while
+    // page-renderer calls the other's REAL notFound(), whose thrown digest
+    // changed in 16.3 (`NEXT_NOT_FOUND` -> `NEXT_HTTP_ERROR_FALLBACK;404`).
+    // Collapse every copy onto the one this workspace resolves, so the
+    // existing per-test mocks cover page-renderer's call too. Resolved at
+    // config load — no hard-coded virtual-store path.
+    "^next/navigation$": require.resolve("next/navigation"),
+    "^next-intl/server$": "<rootDir>/__tests__/__mocks__/next-intl-server.ts",
+    "^next-intl$": "<rootDir>/__tests__/__mocks__/next-intl.ts",
     // next-mdx-remote/rsc is ESM-only; map to a CJS stub so ts-jest can load
     // @working-theory/page-renderer source (which unconditionally imports MDXRemote).
     // Per-test jest.mock() calls still override this mapper as expected.
@@ -73,11 +121,26 @@ module.exports = {
     // tests transitively import CodeBlock but never highlight — stub to the
     // plain-mono fallback. Must precede the generic `.js` mapper below.
     "(^|/)code-highlight\\.js$":
-      "<rootDir>/../../packages/ui/src/blocks/code-highlight.jest-stub.ts",
+      "<rootDir>/__tests__/__mocks__/code-highlight.jest-stub.ts",
     "^(\\.{1,2}/.*)\\.js$": "$1",
   },
   setupFilesAfterEnv: ["<rootDir>/__tests__/setup.ts"],
   transform: {
+    // fumadocs-core (16.10.6+) ships `import.meta.env` in its dist JS
+    // (e.g. dist/url-*.js), which the transformIgnorePatterns carve-out
+    // above lets reach a transformer instead of being required raw.
+    // `import.meta` has no CJS form, so it must run through the shared
+    // import.meta -> {} rewrite BEFORE ts-jest — ts-jest's own
+    // astTransformers hook never fires for a node_modules JS file (see the
+    // transformer's own header comment for why). This entry must stay
+    // ordered ahead of the ts-jest entry below so it wins for node_modules
+    // JS files; ts-jest still handles every other matched file. The
+    // extension class (.js/.jsx/.mjs/.cjs) mirrors ts-jest's own
+    // JS_JSX_REGEX so no sibling extension silently falls through to
+    // ts-jest's unfixed fast path. See #3266.
+    "/node_modules/.*\\.[cm]?jsx?$": require.resolve(
+      "./__tests__/jest-support/import-meta-transformer.cjs",
+    ),
     "^.+\\.(tsx?|jsx?|mjs)$": [
       "ts-jest",
       {

package/templates/apps/web/lib/__tests__/site-brand.test.ts

@@ -0,0 +1,119 @@
+/**
+ * @jest-environment node
+ */
+
+/**
+ * `lib/site-brand.tsx` — SITE_NAME / SITE_BASE_URL resolution (#4157).
+ *
+ * Before this fix, `SITE_NAME` was `process.env.NEXT_PUBLIC_SITE_NAME ??
+ * "AI Launch Kit"` — a hardcoded vendor-brand literal as the default (not
+ * merely a placeholder — the actual vendor's own name). These tests pin a
+ * temp `_site.mdx` fixture (via `AILK_CONTENT_ROOT`) whose `siteName` /
+ * `baseUrl` are neither the old vendor literal nor the new neutral fallback,
+ * so a regression to either constant would fail these assertions — not just
+ * a "not AI Launch Kit" check, which a different wrong hardcode could dodge.
+ *
+ * Each test resets the module registry and re-imports so the module-init
+ * frontmatter read re-runs against that test's env/fixture (mirrors the
+ * `jest.resetModules()` + dynamic `import()` pattern already used by
+ * `__tests__/routes/robots-txt.test.ts`).
+ */
+
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const ENV_KEYS = [
+  "NEXT_PUBLIC_SITE_NAME",
+  "NEXT_PUBLIC_BASE_URL",
+  "AILK_CONTENT_ROOT",
+] as const;
+const savedEnv: Record<string, string | undefined> = {};
+
+let tmpRoot: string;
+
+beforeEach(() => {
+  for (const key of ENV_KEYS) savedEnv[key] = process.env[key];
+  tmpRoot = mkdtempSync(join(tmpdir(), "ailk-site-brand-test-"));
+});
+
+afterEach(() => {
+  for (const key of ENV_KEYS) {
+    if (savedEnv[key] === undefined) delete process.env[key];
+    else process.env[key] = savedEnv[key];
+  }
+  rmSync(tmpRoot, { recursive: true, force: true });
+  jest.resetModules();
+});
+
+function writeSiteMdx(
+  dir: string,
+  frontmatter: Record<string, string>,
+): void {
+  const lines = ["---", ...Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`), "---", ""];
+  writeFileSync(join(dir, "_site.mdx"), lines.join("\n"));
+}
+
+async function loadSiteBrand(): Promise<typeof import("../site-brand")> {
+  jest.resetModules();
+  return import("../site-brand");
+}
+
+describe("SITE_NAME / SITE_BASE_URL (#4157)", () => {
+  it("resolves from _site.mdx frontmatter when no env override is set", async () => {
+    delete process.env["NEXT_PUBLIC_SITE_NAME"];
+    delete process.env["NEXT_PUBLIC_BASE_URL"];
+    writeSiteMdx(tmpRoot, {
+      siteName: "Fixture Co",
+      baseUrl: "https://fixture-co.example",
+    });
+    process.env["AILK_CONTENT_ROOT"] = tmpRoot;
+
+    const { SITE_NAME, SITE_BASE_URL } = await loadSiteBrand();
+
+    expect(SITE_NAME).toBe("Fixture Co");
+    expect(SITE_BASE_URL).toBe("https://fixture-co.example");
+    // The regression this guards against: the pre-#4157 default ignored
+    // _site.mdx entirely and was always the vendor's own name.
+    expect(SITE_NAME).not.toBe("AI Launch Kit");
+  });
+
+  it("prefers the env override over _site.mdx when both are set", async () => {
+    writeSiteMdx(tmpRoot, {
+      siteName: "Fixture Co",
+      baseUrl: "https://fixture-co.example",
+    });
+    process.env["AILK_CONTENT_ROOT"] = tmpRoot;
+    process.env["NEXT_PUBLIC_SITE_NAME"] = "Env Override Co";
+    process.env["NEXT_PUBLIC_BASE_URL"] = "https://env-override.example";
+
+    const { SITE_NAME, SITE_BASE_URL } = await loadSiteBrand();
+
+    expect(SITE_NAME).toBe("Env Override Co");
+    expect(SITE_BASE_URL).toBe("https://env-override.example");
+  });
+
+  it("falls back to a neutral, non-vendor default when _site.mdx is absent", async () => {
+    delete process.env["NEXT_PUBLIC_SITE_NAME"];
+    delete process.env["NEXT_PUBLIC_BASE_URL"];
+    // tmpRoot deliberately has no _site.mdx written into it.
+    process.env["AILK_CONTENT_ROOT"] = tmpRoot;
+
+    const { SITE_NAME, SITE_BASE_URL, FALLBACK_SITE_NAME, FALLBACK_BASE_URL } =
+      await loadSiteBrand();
+
+    expect(SITE_NAME).toBe(FALLBACK_SITE_NAME);
+    expect(SITE_BASE_URL).toBe(FALLBACK_BASE_URL);
+    expect(SITE_NAME).not.toBe("AI Launch Kit");
+  });
+
+  it("falls back to a neutral default when _site.mdx frontmatter doesn't parse", async () => {
+    delete process.env["NEXT_PUBLIC_SITE_NAME"];
+    writeFileSync(join(tmpRoot, "_site.mdx"), "not frontmatter at all\n");
+    process.env["AILK_CONTENT_ROOT"] = tmpRoot;
+
+    const { SITE_NAME, FALLBACK_SITE_NAME } = await loadSiteBrand();
+
+    expect(SITE_NAME).toBe(FALLBACK_SITE_NAME);
+  });
+});

package/templates/apps/web/lib/__tests__/site-theme.test.ts

@@ -0,0 +1,112 @@
+/**
+ * Round trip: the real `content/_site.mdx` → the emitted CSS custom properties.
+ *
+ * This is the end-to-end claim the wiring makes — a site declares a theme and
+ * the built page renders in those colours — asserted on the actual repo file
+ * rather than a fixture, so deleting the `theme:` block would fail here.
+ */
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { PartialColorPaletteSchema } from "@working-theory/site-config/schema";
+import { siteColorTokenMap, themeToCssVarsBothModes } from "@working-theory/theme";
+
+import { loadSiteBrandTokens } from "../site-theme";
+
+const REPO_CONTENT_ROOT = join(__dirname, "..", "..", "..", "..", "content");
+
+/** The light-mode `:root { … }` block, without the dark one. */
+function lightBlock(css: string): string {
+  return css.slice(0, css.indexOf(':root[data-theme="dark"]'));
+}
+
+/** The dark-mode `:root[data-theme="dark"] { … }` block. */
+function darkBlock(css: string): string {
+  return css.slice(css.indexOf(':root[data-theme="dark"]'));
+}
+
+describe("loadSiteBrandTokens — the real content/_site.mdx", () => {
+  const originalRoot = process.env.AILK_CONTENT_ROOT;
+
+  beforeEach(() => {
+    process.env.AILK_CONTENT_ROOT = REPO_CONTENT_ROOT;
+  });
+
+  afterEach(() => {
+    if (originalRoot === undefined) delete process.env.AILK_CONTENT_ROOT;
+    else process.env.AILK_CONTENT_ROOT = originalRoot;
+  });
+
+  it("translates the declared theme into the token overlay", () => {
+    expect(loadSiteBrandTokens()).toEqual({
+      colors: {
+        light: { bg: "#fdfcfa", fg: "#1c1917" },
+        dark: { bg: "#0c0a09" },
+      },
+    });
+  });
+
+  it("reaches the emitted CSS custom properties", () => {
+    const brand = loadSiteBrandTokens();
+    const css = themeToCssVarsBothModes(brand ? { brand } : {});
+
+    expect(lightBlock(css)).toContain("--color-bg: #fdfcfa;");
+    expect(lightBlock(css)).toContain("--color-fg: #1c1917;");
+    expect(darkBlock(css)).toContain("--color-bg: #0c0a09;");
+  });
+
+  it("changes exactly the declared variables and nothing else", () => {
+    const brand = loadSiteBrandTokens();
+    const themed = themeToCssVarsBothModes(brand ? { brand } : {});
+    const expected = themeToCssVarsBothModes()
+      // light block — the two declared light colours
+      .replace("--color-bg: #ffffff;", "--color-bg: #fdfcfa;")
+      .replace("--color-fg: #030712;", "--color-fg: #1c1917;")
+      // dark block — the one declared dark colour
+      .replace("--color-bg: #0a0a0a;", "--color-bg: #0c0a09;");
+
+    expect(themed).toBe(expected);
+  });
+
+  it("treats a bare `theme:` key as no theme, rather than throwing", () => {
+    // YAML parses a dangling `theme:` to null. It is what commenting out the
+    // block's children leaves behind, it means the same as an absent key, and
+    // it must not escape as a ZodError out of an async Server Component.
+    const root = mkdtempSync(join(tmpdir(), "ailk-site-theme-"));
+    writeFileSync(
+      join(root, "_site.mdx"),
+      ["---", "siteName: Test", "theme:", "---", ""].join("\n"),
+      "utf8",
+    );
+    process.env.AILK_CONTENT_ROOT = root;
+
+    expect(loadSiteBrandTokens()).toBeUndefined();
+  });
+
+  it("returns undefined — and so emits the default CSS — when no config is readable", () => {
+    process.env.AILK_CONTENT_ROOT = join(__dirname, "no-such-content-root");
+
+    const brand = loadSiteBrandTokens();
+    expect(brand).toBeUndefined();
+    expect(themeToCssVarsBothModes(brand ? { brand } : {})).toBe(
+      themeToCssVarsBothModes(),
+    );
+  });
+});
+
+/**
+ * The twelve customer-facing colour slots live in `@working-theory/site-config`
+ * and the map from them to token names lives in `@working-theory/theme`;
+ * neither package may import the other, so nothing inside either can notice
+ * the two lists drifting. `apps/web` imports both, so the cross-check lives
+ * here — without it, a slot added to the palette schema would parse cleanly
+ * and then throw "is not a theme colour" at render.
+ */
+describe("the two vocabularies agree on which slots exist", () => {
+  it("siteColorTokenMap covers exactly the schema's colour slots", () => {
+    expect(Object.keys(siteColorTokenMap).sort()).toEqual(
+      Object.keys(PartialColorPaletteSchema.shape).sort(),
+    );
+  });
+});