create-ailk 0.12.1 → 0.14.0

package/dist/programmatic.js

@@ -15,7 +15,7 @@
  *   import { scaffoldSync } from './programmatic.js';
  *   const result = scaffoldSync({ targetDir: '/tmp/my-site', projectName: 'my-site' });
  */
-import { existsSync, readdirSync, readFileSync, rmdirSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmdirSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { AddModuleRefusedError, applyModuleToScaffold, } from "./add-module.js";
@@ -24,21 +24,23 @@ import { renderClaudeMd, syncClaudeMd, } from "./claude-md.js";
 import { CATALOG_TARGET_PATH, writeComponentCatalog, } from "./component-catalog.js";
 import { buildScaffoldMarkers, copyTemplate } from "./copy.js";
 import { deriveArchitecture } from "./derive-architecture.js";
-import { compileDesignTheme } from "./design-compile.js";
+import { compileDesignFonts, compileDesignTheme } from "./design-compile.js";
+import { HOME_PAGE_PATH, designHomeSeeds, planDesignHome, shapeHomePath, shippedHomeSeeds, } from "./design-home.js";
 import { applyDesignPresets, readSectionLookCatalog, shippedPageTypes, validateDesignPresets, } from "./design-presets.js";
-import { installDesignSample, resolveDesign, spliceThemeBlock, } from "./design-scaffold.js";
+import { resolveDesign, spliceThemeBlock, } from "./design-scaffold.js";
 import { writeAuthSecretFile } from "./lib/auth-secret-file.js";
 import { extractModuleBundle, installBundleTree, } from "./lib/extract-module-bundle.js";
 import { fetchTemplate } from "./lib/fetch-template.js";
 import { assertLicenseKeyShape, writeLicenseKeyFiles, } from "./lib/license-key-files.js";
-import { assertDesignAllowed, assertReleased, deriveLevel, resolveModuleSet, resolvePaidModules, } from "./lib/module-license-gate.js";
+import { assertDesignAllowed, assertReleased, deriveDesignLevel, deriveLevel, resolveModuleSet, resolvePaidModules, } from "./lib/module-license-gate.js";
 import { classifyModules } from "./lib/module-tier.js";
 import { normalizeModules } from "./module-architecture.js";
 import { writePaidSections } from "./paid-sections.js";
 import { RECOGNIZED_SHAPES, RESERVED_SHAPES, } from "./parse-args.js";
 import { SITE_CHROME_PATH, renderSiteChrome, resolveSiteChrome, } from "./site-chrome.js";
+import { SITE_FONTS_PATH, renderSiteFonts } from "./site-fonts.js";
 import { planSiteManifest } from "./site-manifest.js";
-import { SITE_ROSTER_PATH, planSiteManifestDesign, readSiteRoster, withMeetPlaceholderSeeds, } from "./site-roster.js";
+import { SITE_ROSTER_PATH, planHomeRecord, planSiteManifestDesign, readSiteRoster, withMeetPlaceholderSeeds, } from "./site-roster.js";
 import { GATEABLE_SURFACES, MODULE_SURFACES, NAV_CONFIG_PATH, excludedRoutePaths, renderNavConfig, resolveSurfaces, } from "./surfaces.js";
 import { syncRoutes } from "./sync-routes.js";
 import { BASE_LAYER_DIR, SHAPE_STARTERS, TEMPLATE_MANIFESTS, TemplateError, mergeRoster, resolveTemplate, resolveTemplateLineage, rosterDeclares, templateDelivery, templateTreeDir, } from "./template-manifest.js";
@@ -267,14 +269,22 @@ export async function scaffold(opts) {
     // (D2): a non-look field or unknown variant throws `DesignPackageError`
     // naming page type, section type and field, and the target is never
     // created. A design with no `sections` block executes no new read (D8).
+    let lookCatalog;
+    const catalog = () => (lookCatalog ??= readSectionLookCatalog(join(PKG_ROOT, "component-catalog.json")));
     if (resolvedDesign !== undefined &&
         Object.keys(resolvedDesign.pkg.sections).length > 0) {
         validateDesignPresets(resolvedDesign.pkg.sections, {
-            catalog: readSectionLookCatalog(join(PKG_ROOT, "component-catalog.json")),
+            catalog: catalog(),
             pageTypes: shippedPageTypes(SITE_TEMPLATES_DIR),
             file: join(resolvedDesign.dir, "DESIGN.md"),
         });
     }
+    // #7743 D5 — the design's home seeds are read and validated beside its
+    // presets: a malformed seed throws `DesignPackageError`, naming the file,
+    // before the target is created.
+    const designSeeds = resolvedDesign !== undefined
+        ? designHomeSeeds(resolvedDesign, { designsDir: DESIGNS_DIR, catalog })
+        : [];
     // #6813 D7 — the resolved design only when the CALLER chose one (`opts.design`);
     // a template's own declared design is never gated (#6778 option (c)).
     const chosenDesign = opts.design !== undefined ? resolvedDesign : undefined;
@@ -301,7 +311,7 @@ export async function scaffold(opts) {
     // The run's derived level (#6759), for `assertDesignAllowed` below.
     // Undefined on the alias branch and on a `--modules`-keep run (D2/D4 in
     // module-license-gate.ts — the level plays no part in composing either),
-    // so a non-`standard` design on either path derives it separately, below.
+    // so a non-`standard` design on either path derives it separately.
     let level;
     if (opts.template !== undefined) {
         // Alias run — untouched (NFR-4): the union line and its
@@ -350,6 +360,18 @@ export async function scaffold(opts) {
         });
         bundles = chosen.bundles;
         level = chosen.level;
+        // #7010 — a `--modules`-keep run composes no level (NFR-2), so a chosen
+        // non-Free design derives one from the key here, as the addition branch
+        // does; a plain keep run makes no extra network call.
+        if (level === undefined && chosenDesign !== undefined && !chosenDesign.free) {
+            level = await deriveDesignLevel({
+                licenseKey,
+                ...(opts.moduleRegistryUrl !== undefined
+                    ? { registryUrl: opts.moduleRegistryUrl }
+                    : {}),
+                ...(opts.fetchImpl !== undefined ? { fetchImpl: opts.fetchImpl } : {}),
+            });
+        }
         modules =
             template !== undefined
                 ? normalizeModules([...template.requires, ...chosen.modules])
@@ -378,9 +400,9 @@ export async function scaffold(opts) {
     }
     // #6760 D4 — after the level is resolved, before any fetch or write below.
     // Only the caller's chosen design is gated (#6778 option (c)); a template's
-    // own declared design is not. `level ?? "free"` fails closed: a
-    // `--modules`-keep run under-reports its level by design (NFR-2), so a
-    // chosen non-Free design on that path is refused rather than trusted. The
+    // own declared design is not. `level ?? "free"` fails closed: a level left
+    // underived (a plain alias or `--modules`-keep run with no chosen non-Free
+    // design) is never trusted. The
     // refusal names `chosen.display` — the name, or the absolute directory
     // (#6813 D7) — and `chosen.free` decides Free-ness by identity (D2), never
     // by `FREE_DESIGNS.includes(name)` alone (a path is never in that list).
@@ -568,22 +590,6 @@ export async function scaffold(opts) {
             : [];
         writeFileSync(join(result.targetDir, NAV_CONFIG_PATH), renderNavConfig(result.surfaces, { serviceSlugs }));
         pruneUnrosteredSeeds(result.targetDir, mergeRoster(template, template.requires), result.surfaces, ownership);
-        // spec 6892 D4 — the resolved design's own sample (the minimalism design's
-        // nine-slide deck home + its SVGs; no template declares `minimalism`
-        // since #6976, so none installs it today), installed AFTER the template
-        // layer so it wins over the shape's `HomePage/home.mdx`, and ONLY when
-        // the resolved design is the template's OWN declared design: a caller
-        // combination like `--shape organization-product --design minimalism`
-        // installs no sample (its roster carries neither the deck's link targets
-        // nor, in its generated record, the deck's sections).
-        if (resolvedDesign !== undefined &&
-            resolvedDesign.recorded === template.design) {
-            installDesignSample({
-                designDir: resolvedDesign.dir,
-                targetDir: result.targetDir,
-                ownership,
-            });
-        }
     }
     // #6813 D5/D8 steps 9-10 — whenever a design is resolved (the caller's,
     // else the template's): the design's DESIGN.md (#6939); the compiled theme,
@@ -595,6 +601,15 @@ export async function scaffold(opts) {
         // #6939 — the scaffold's DESIGN.md is the design it wears, not the one
         // its template layer shipped; the site's own header lines are kept.
         writeFileSync(join(result.targetDir, "DESIGN.md"), planDesignMd(resolvedDesign.dir, result.targetDir));
+        // #7720 D4.1 — the faces the design sources, beside site-chrome.ts. A
+        // design that sources none renders the overlay's committed default, so
+        // the file is left as the template tree wrote it.
+        const siteFontsPath = join(result.targetDir, SITE_FONTS_PATH);
+        const siteFonts = renderSiteFonts(compileDesignFonts(resolvedDesign.pkg));
+        if (!existsSync(siteFontsPath) || readFileSync(siteFontsPath, "utf8") !== siteFonts) {
+            mkdirSync(dirname(siteFontsPath), { recursive: true });
+            writeFileSync(siteFontsPath, siteFonts);
+        }
         const compiledTheme = compileDesignTheme(resolvedDesign.pkg);
         const siteMdxPath = join(result.targetDir, "content", "_site.mdx");
         if (existsSync(siteMdxPath)) {
@@ -613,6 +628,27 @@ export async function scaffold(opts) {
                     writeFileSync(rosterPath, nextManifest);
             }
         }
+        // #7743 D5 — the design's home arc, seeded over a placeholder home once
+        // every layer has landed, before the presets dress it. A home that is not
+        // the shape's placeholder is never written; `--design standard` (no
+        // seeds) leaves the shape's home byte-identical. The one
+        // `planDesignHome` call site in scaffold().
+        const homePath = join(result.targetDir, ...HOME_PAGE_PATH.split("/"));
+        let homeSeeded = false;
+        if (template !== undefined) {
+            const homePlan = planDesignHome({
+                current: existsSync(homePath) ? readFileSync(homePath, "utf8") : undefined,
+                shape: template.shape,
+                target: designSeeds.find((seed) => seed.shape === template.shape),
+                shapeHome: readFileSync(shapeHomePath(template.shape, { siteTemplatesDir: SITE_TEMPLATES_DIR, templatesDir: TEMPLATES_DIR }), "utf8"),
+                shippedSeeds: shippedHomeSeeds({ designsDir: DESIGNS_DIR, catalog }),
+                catalog: catalog(),
+            });
+            if (homePlan.outcome === "seeded" && homePlan.text !== undefined) {
+                writeFileSync(homePath, homePlan.text);
+                homeSeeded = true;
+            }
+        }
         // #6816 D6 step 10b — the design's section presets, written onto the
         // pages of the page types the roster of record places, once every layer
         // has landed. The one `applyDesignPresets` call site. A scaffold with no
@@ -637,6 +673,14 @@ export async function scaffold(opts) {
                     writeFileSync(page.path, page.text);
             }
         }
+        // #7743 D6 — the manifest's `/` row records the seeded home's sections,
+        // as the presets left them.
+        const rosterPath = join(result.targetDir, SITE_ROSTER_PATH);
+        if (homeSeeded && existsSync(rosterPath)) {
+            const nextManifest = planHomeRecord(readFileSync(rosterPath, "utf8"), readFileSync(homePath, "utf8"), catalog());
+            if (nextManifest !== undefined)
+                writeFileSync(rosterPath, nextManifest);
+        }
     }
     // #6944 — the manifest records what this scaffold IS, once every layer has
     // landed: the effective module set, a row for every route on disk, and the

package/dist/site-chrome.d.ts

@@ -38,6 +38,24 @@ export type SiteChromeFooter = "columns" | "centered";
 /** The `home` knob's vocabulary. `deck` → the locale-root route mounts
  *  MarketingShell with `snap="mandatory"` + `deckHero` (spec 5426 D7). */
 export type SiteChromeHome = "default" | "deck";
+/** The `innerPages` knob's vocabulary (#7721). `bare` → every non-home page
+ *  gets the bare header and the one-bar footer. */
+export type SiteChromeInnerPages = "default" | "bare";
+/** The `colorMode` knob's vocabulary (#7742). `light` pins the site to light
+ *  and removes every theme switch; dark then appears only as a deck ground. */
+export type SiteChromeColorMode = "user" | "light";
+/** The `chromeStyle` knob's vocabulary (#7742). `minimal` → the deck's closing
+ *  slide is the wordmark + contact lines + one legal line, and the consent bar
+ *  is a ground-coloured hairline bar that never covers the down cue. */
+export type SiteChromeChromeStyle = "default" | "minimal";
+/**
+ * The `deckGrounds` knob's vocabulary (#7719 D3) — the shared section surface
+ * enum, duplicated from `@working-theory/validation`'s `SectionSurfaceSchema`
+ * because `create-ailk` cannot import it (one runtime dependency, § 1.5);
+ * `site-chrome.test.ts` proves the two lists equal.
+ */
+export declare const DECK_GROUND_VALUES: readonly ["none", "gray-100", "wash", "wash-secondary", "gradient-brand", "gradient-dark", "solid-dark"];
+export type DeckGround = (typeof DECK_GROUND_VALUES)[number];
 /**
  * A template's declared layout block — every field optional. Lives on
  * `TemplateManifest.layout` (the code registry, `template-manifest.ts`) and
@@ -48,6 +66,16 @@ export interface TemplateLayout {
     footer?: SiteChromeFooter;
     announcementBanner?: boolean;
     home?: SiteChromeHome;
+    /** #7719 D3 — the surfaces a deck home cycles, slide by slide, onto slides that author none. */
+    deckGrounds?: readonly DeckGround[];
+    /** #7721 D1 — `bare`: every non-home page wears the bare header and the one-bar footer. */
+    innerPages?: SiteChromeInnerPages;
+    /** #7740 D1 — `true`: the deck home presents slide by slide (a deck home only). */
+    deckPresentation?: boolean;
+    /** #7742 D1 — `light`: the site is pinned to light, with no theme switch. */
+    colorMode?: SiteChromeColorMode;
+    /** #7742 D1 — `minimal`: the minimal closing slide, consent bar and themed 404. */
+    chromeStyle?: SiteChromeChromeStyle;
 }
 /** `TemplateLayout` with every field resolved — what `site-chrome.ts` exports. */
 export interface ResolvedSiteChrome {
@@ -55,6 +83,16 @@ export interface ResolvedSiteChrome {
     footer: SiteChromeFooter;
     announcementBanner: boolean;
     home: SiteChromeHome;
+    /** Present only when a list resolves AND `home` is `deck` (#7719 D3) — never an `undefined` key. */
+    deckGrounds?: readonly DeckGround[];
+    /** Present only when it resolves to "bare" — never "default" (#7721 D1). */
+    innerPages?: "bare";
+    /** Present only when it resolves to `true` AND `home` is `deck` (#7740 D1) — never `false`. */
+    deckPresentation?: true;
+    /** Present only when it resolves to "light" — never "user" (#7742 D1). */
+    colorMode?: "light";
+    /** Present only when it resolves to "minimal" — never "default" (#7742 D1). */
+    chromeStyle?: "minimal";
 }
 /** Defaults (#5612 D1; banner off since #6469). */
 export declare const DEFAULT_SITE_CHROME: ResolvedSiteChrome;

package/dist/site-chrome.js

@@ -29,6 +29,21 @@
  * close): an unrecognized design NAME now fails in `resolveDesign`, before
  * this function ever sees one.
  */
+/**
+ * The `deckGrounds` knob's vocabulary (#7719 D3) — the shared section surface
+ * enum, duplicated from `@working-theory/validation`'s `SectionSurfaceSchema`
+ * because `create-ailk` cannot import it (one runtime dependency, § 1.5);
+ * `site-chrome.test.ts` proves the two lists equal.
+ */
+export const DECK_GROUND_VALUES = [
+    "none",
+    "gray-100",
+    "wash",
+    "wash-secondary",
+    "gradient-brand",
+    "gradient-dark",
+    "solid-dark",
+];
 /** Defaults (#5612 D1; banner off since #6469). */
 export const DEFAULT_SITE_CHROME = {
     nav: "full",
@@ -48,6 +63,9 @@ export class TemplateLayoutError extends Error {
 const NAV_VALUES = ["full", "mark-only"];
 const FOOTER_VALUES = ["columns", "centered"];
 const HOME_VALUES = ["default", "deck"];
+const INNER_PAGES_VALUES = ["default", "bare"];
+const COLOR_MODE_VALUES = ["user", "light"];
+const CHROME_STYLE_VALUES = ["default", "minimal"];
 /**
  * Validate an UNTRUSTED `layout` value (a bundle's `ailk-template.json`
  * `layout` field — arbitrary JSON, never compile-time checked the way the
@@ -92,6 +110,40 @@ export function validateTemplateLayout(value, subject) {
         }
         result.home = raw.home;
     }
+    if ("deckGrounds" in raw && raw.deckGrounds !== undefined) {
+        const grounds = raw.deckGrounds;
+        const badIndex = Array.isArray(grounds)
+            ? grounds.findIndex((g) => !DECK_GROUND_VALUES.includes(g))
+            : -1;
+        if (!Array.isArray(grounds) || grounds.length === 0 || badIndex !== -1) {
+            throw new TemplateLayoutError(`${subject}: layout.deckGrounds must be a non-empty list of ${DECK_GROUND_VALUES.join(", ")} — got ${JSON.stringify(badIndex !== -1 ? grounds[badIndex] : grounds)}`);
+        }
+        result.deckGrounds = grounds;
+    }
+    if ("innerPages" in raw && raw.innerPages !== undefined) {
+        if (!INNER_PAGES_VALUES.includes(raw.innerPages)) {
+            throw new TemplateLayoutError(`${subject}: layout.innerPages must be one of ${INNER_PAGES_VALUES.join(", ")} — got ${JSON.stringify(raw.innerPages)}`);
+        }
+        result.innerPages = raw.innerPages;
+    }
+    if ("deckPresentation" in raw && raw.deckPresentation !== undefined) {
+        if (typeof raw.deckPresentation !== "boolean") {
+            throw new TemplateLayoutError(`${subject}: layout.deckPresentation must be a boolean — got ${JSON.stringify(raw.deckPresentation)}`);
+        }
+        result.deckPresentation = raw.deckPresentation;
+    }
+    if ("colorMode" in raw && raw.colorMode !== undefined) {
+        if (!COLOR_MODE_VALUES.includes(raw.colorMode)) {
+            throw new TemplateLayoutError(`${subject}: layout.colorMode must be one of ${COLOR_MODE_VALUES.join(", ")} — got ${JSON.stringify(raw.colorMode)}`);
+        }
+        result.colorMode = raw.colorMode;
+    }
+    if ("chromeStyle" in raw && raw.chromeStyle !== undefined) {
+        if (!CHROME_STYLE_VALUES.includes(raw.chromeStyle)) {
+            throw new TemplateLayoutError(`${subject}: layout.chromeStyle must be one of ${CHROME_STYLE_VALUES.join(", ")} — got ${JSON.stringify(raw.chromeStyle)}`);
+        }
+        result.chromeStyle = raw.chromeStyle;
+    }
     return result;
 }
 /**
@@ -113,7 +165,7 @@ export function resolveSiteChrome(layout, designLayout) {
         throw new TypeError(`resolveSiteChrome: designLayout must be a layout object, got ${JSON.stringify(designLayout)}`);
     }
     const fromDesign = designLayout ?? {};
-    return {
+    const resolved = {
         nav: layout?.nav ?? fromDesign.nav ?? DEFAULT_SITE_CHROME.nav,
         footer: layout?.footer ?? fromDesign.footer ?? DEFAULT_SITE_CHROME.footer,
         announcementBanner: layout?.announcementBanner ??
@@ -121,6 +173,29 @@ export function resolveSiteChrome(layout, designLayout) {
             DEFAULT_SITE_CHROME.announcementBanner,
         home: layout?.home ?? fromDesign.home ?? DEFAULT_SITE_CHROME.home,
     };
+    // #7719 D3 — the grounds resolve as a whole list, and only a deck keeps them.
+    const deckGrounds = layout?.deckGrounds ?? fromDesign.deckGrounds;
+    if (deckGrounds !== undefined && resolved.home === "deck") {
+        resolved.deckGrounds = deckGrounds;
+    }
+    // #7721 D1 — only "bare" is ever a key, so a chrome that does not opt in
+    // (unset, or an explicit "default") resolves exactly as before.
+    if ((layout?.innerPages ?? fromDesign.innerPages) === "bare") {
+        resolved.innerPages = "bare";
+    }
+    // #7740 D1 — only `true` on a deck is ever a key: an explicit layout
+    // `false` wins over the design's `true`, and a non-deck home drops it.
+    if ((layout?.deckPresentation ?? fromDesign.deckPresentation) === true && resolved.home === "deck") {
+        resolved.deckPresentation = true;
+    }
+    // #7742 D1 — as with `innerPages`, only the opt-in value is ever a key.
+    if ((layout?.colorMode ?? fromDesign.colorMode) === "light") {
+        resolved.colorMode = "light";
+    }
+    if ((layout?.chromeStyle ?? fromDesign.chromeStyle) === "minimal") {
+        resolved.chromeStyle = "minimal";
+    }
+    return resolved;
 }
 /**
  * Render `apps/web/lib/site-chrome.ts` for a resolved layout — the same
@@ -130,6 +205,26 @@ export function resolveSiteChrome(layout, designLayout) {
  * `snap="mandatory"` + `deckHero` to MarketingShell.
  */
 export function renderSiteChrome(resolved) {
+    // #7719 D3 — each `deckGrounds` line is emitted only when the chrome has one,
+    // so a chrome without it renders today's text exactly.
+    const grounds = resolved.deckGrounds;
+    const groundsComment = grounds === undefined
+        ? ""
+        : "\n//   - deckGrounds → the deck home cycles these surfaces, slide by slide, onto slides that author none";
+    const groundsMember = grounds === undefined
+        ? ""
+        : `\n  deckGrounds?: readonly (${DECK_GROUND_VALUES.map((g) => JSON.stringify(g)).join(" | ")})[];`;
+    const groundsValue = grounds === undefined ? "" : `\n  deckGrounds: [${grounds.map((g) => JSON.stringify(g)).join(", ")}],`;
+    // #7721 D1 — the value line only for a bare chrome; the interface member
+    // and comment bullet always, so the layout reads `siteChrome.innerPages`.
+    const innerPagesValue = resolved.innerPages === "bare" ? '\n  innerPages: "bare",' : "";
+    // #7740 D1 — `innerPages`' form: the member and bullet always, the value
+    // line only when the chrome presents.
+    const presentationValue = resolved.deckPresentation === true ? "\n  deckPresentation: true," : "";
+    // #7742 D1 — the same form again: member and bullet always, value lines
+    // only for the opt-in values.
+    const colorModeValue = resolved.colorMode === "light" ? '\n  colorMode: "light",' : "";
+    const chromeStyleValue = resolved.chromeStyle === "minimal" ? '\n  chromeStyle: "minimal",' : "";
     return `// site-chrome.ts — resolved template layout knobs.
 //
 // GENERATED by create-ailk from the declared template's \`layout\` block
@@ -145,19 +240,31 @@ export function renderSiteChrome(resolved) {
 //   - home: "deck" → the locale-root route mounts MarketingShell with
 //     snap="mandatory" + deckHero (spec 5426 D7); every other route is
 //     unaffected.
+//   - innerPages: "bare" → every non-home page renders the bare header and
+//     the one-bar footer.
+//   - deckPresentation → the deck home presents slide by slide: fitted slides, slide anchors, the mark follows the ground
+//   - colorMode: "light" → the site is pinned to light and shows no theme
+//     switch; dark appears only as a deck ground.
+//   - chromeStyle: "minimal" → the deck's closing slide is the wordmark,
+//     contact lines and one legal line; the consent bar is a hairline bar on
+//     the page ground; the 404 renders in the site's theme.${groundsComment}
 
 export interface SiteChrome {
   nav: "full" | "mark-only";
   footer: "columns" | "centered";
   announcementBanner: boolean;
   home: "default" | "deck";
+  innerPages?: "bare";
+  deckPresentation?: true;
+  colorMode?: "light";
+  chromeStyle?: "minimal";${groundsMember}
 }
 
 export const siteChrome: SiteChrome = {
   nav: ${JSON.stringify(resolved.nav)},
   footer: ${JSON.stringify(resolved.footer)},
   announcementBanner: ${JSON.stringify(resolved.announcementBanner)},
-  home: ${JSON.stringify(resolved.home)},
+  home: ${JSON.stringify(resolved.home)},${groundsValue}${innerPagesValue}${presentationValue}${colorModeValue}${chromeStyleValue}
 };
 `;
 }

package/dist/site-fonts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The web faces a design's typography sources (#7720, spec
+ * docs/specs/7720-a-web-font-source-and-spec.md D3.2) — rendered into the
+ * generated `apps/web/lib/site-fonts.ts` every scaffold gets, beside
+ * `site-chrome.ts` and in the same GENERATED-header idiom.
+ *
+ * next/font/google picks a face by the imported function's name and needs
+ * literal options at a module-scope call site, so a face cannot be chosen
+ * from the request-time `theme:` block — it is chosen here, at scaffold and
+ * apply-design time, as source text. The faces download at the site's
+ * `next build` and are served from its own origin, which the CSP's
+ * `font-src 'self'` already allows.
+ *
+ * With no sourced face the render is the empty default, byte-identical to the
+ * monorepo's own committed `apps/web/lib/site-fonts.ts`.
+ */
+import type { CompiledDesignFonts } from "./design-compile.js";
+/** Template-relative path of the generated site-fonts module — beside `SITE_CHROME_PATH`. */
+export declare const SITE_FONTS_PATH = "apps/web/lib/site-fonts.ts";
+/** Render `apps/web/lib/site-fonts.ts` for `fonts` (D3.2). Ends with a trailing newline. */
+export declare function renderSiteFonts(fonts: CompiledDesignFonts | undefined): string;

package/dist/site-fonts.js

@@ -0,0 +1,54 @@
+/** Template-relative path of the generated site-fonts module — beside `SITE_CHROME_PATH`. */
+export const SITE_FONTS_PATH = "apps/web/lib/site-fonts.ts";
+const HEADER = `// site-fonts.ts — the web faces the site's design sources.
+//
+// GENERATED by create-ailk from the design's \`typography.<role>.fontSource\`
+// (#7720). A design that sources no face gets the empty default.
+// \`apps/web/app/[locale]/layout.tsx\` passes this to \`applyDesignFonts\`
+// (@working-theory/theme): \`families\` fills --font-display / --font-body
+// unless the site's own \`brand.fonts\` sets them, and \`className\` (the
+// next/font variable classes) goes on <html>.
+`;
+const INTERFACE = `export interface SiteFonts {
+  className: string;
+  families: { display?: string | undefined; body?: string | undefined };
+}
+`;
+/** Render `apps/web/lib/site-fonts.ts` for `fonts` (D3.2). Ends with a trailing newline. */
+export function renderSiteFonts(fonts) {
+    const faces = ["display", "body"].flatMap((role) => {
+        const face = fonts?.[role];
+        return face !== undefined ? [{ role, face }] : [];
+    });
+    if (faces.length === 0) {
+        return `${HEADER}\n${INTERFACE}\nexport const siteFonts: SiteFonts = { className: "", families: {} };\n`;
+    }
+    // One loader per distinct family, named for the first role using it (display before body).
+    const slotOf = new Map();
+    for (const { role, face } of faces) {
+        if (!slotOf.has(face.family))
+            slotOf.set(face.family, role);
+    }
+    const exportName = (family) => family.replace(/ /g, "_");
+    const imports = [...slotOf.keys()].map(exportName).sort();
+    const loaders = [...slotOf].map(([family, slot]) => `const ${slot}Face = ${exportName(family)}({ subsets: ${JSON.stringify(["latin"])}, variable: ${JSON.stringify(`--font-design-${slot}`)} });`);
+    const className = [...slotOf.values()].map((slot) => `${slot}Face.variable`).join(", ");
+    const families = faces.map(({ role, face }) => {
+        const slot = slotOf.get(face.family) ?? role;
+        const value = `var(--font-design-${slot})${face.fallback === "" ? "" : `, ${face.fallback}`}`;
+        return `    ${role}: ${JSON.stringify(value)},`;
+    });
+    return `${HEADER}
+import { ${imports.join(", ")} } from "next/font/google";
+
+${INTERFACE}
+${loaders.join("\n")}
+
+export const siteFonts: SiteFonts = {
+  className: [${className}].join(" "),
+  families: {
+${families.join("\n")}
+  },
+};
+`;
+}

package/dist/site-roster.d.ts

@@ -1,4 +1,5 @@
 import type { CompiledDesignTheme } from "./design-compile.js";
+import { type SectionLookCatalog } from "./design-presets.js";
 import { type PageRosterRow } from "./module-architecture.js";
 import type { ModuleName } from "./parse-args.js";
 import type { ResolvedSiteChrome } from "./site-chrome.js";
@@ -76,6 +77,21 @@ export interface SiteManifestDesignNext {
  *   never reaches this function (`scaffold()` guards on the file's presence).
  */
 export declare function planSiteManifestDesign(text: string, next: SiteManifestDesignNext, label: string): string | undefined;
+/**
+ * `build-template-manifest.mjs`'s `OPTION_KEYS` — the section `data` keys
+ * whose scalar values a manifest row's `sections[].options` records. A
+ * duplicate (the script is not importable here); a test pins the two equal.
+ */
+export declare const MANIFEST_OPTION_KEYS: readonly ["itemStyle", "actionsPosition", "gapBelow", "measure", "cardLayout", "layout", "size", "surface", "imagerySlot", "headingLevel", "align", "tone", "columns", "density", "fill", "accentStyle"];
+/**
+ * Plan the manifest's `/` row `sections` as the home's sections (#7743 D6):
+ * `[{ type, component, options? }]`, `options` being the section's scalar
+ * `MANIFEST_OPTION_KEYS` values, as the generator writes them. `undefined`
+ * when the record already says so, or the manifest has no `/` row with a
+ * `sections` key. The value is spliced in place at its own depth; no other
+ * byte moves.
+ */
+export declare function planHomeRecord(manifestText: string, homeText: string, catalog: SectionLookCatalog): string | undefined;
 /**
  * The generator's row for each of a module's `pageContributions`, in
  * declaration order — read from the committed manifest of the first

package/dist/site-roster.js

@@ -27,6 +27,8 @@ import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { AddModuleRefusedError, readArchitectureHeader, } from "./add-module-core.js";
+import { HOME_PAGE_PATH } from "./design-home.js";
+import { locatePageSections } from "./design-presets.js";
 import { diffTwoStrings } from "./lib/extract-module-bundle.js";
 import { MODULE_SLICES, normalizeModules, } from "./module-architecture.js";
 import { substituteMarkers } from "./substitute.js";
@@ -234,6 +236,85 @@ export function planSiteManifestDesign(text, next, label) {
     }
     return result;
 }
+// ── #7743 D6: the `/` row records the home's sections ─────────────────────
+/**
+ * `build-template-manifest.mjs`'s `OPTION_KEYS` — the section `data` keys
+ * whose scalar values a manifest row's `sections[].options` records. A
+ * duplicate (the script is not importable here); a test pins the two equal.
+ */
+export const MANIFEST_OPTION_KEYS = [
+    "itemStyle",
+    "actionsPosition",
+    "gapBelow",
+    "measure",
+    "cardLayout",
+    "layout",
+    "size",
+    "surface",
+    "imagerySlot",
+    "headingLevel",
+    "align",
+    "tone",
+    "columns",
+    "density",
+    "fill",
+    "accentStyle",
+];
+/** A raw YAML scalar's value — a JSON scalar, a single-quoted string or a plain one — or undefined for a collection or null. */
+function scalarValue(raw) {
+    const text = raw.trim();
+    if (text.startsWith("{") || text.startsWith("["))
+        return undefined;
+    if (text.startsWith("'"))
+        return text.slice(1, -1).replace(/''/g, "'");
+    try {
+        const value = JSON.parse(text);
+        return value === null || typeof value === "object" ? undefined : value;
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * Plan the manifest's `/` row `sections` as the home's sections (#7743 D6):
+ * `[{ type, component, options? }]`, `options` being the section's scalar
+ * `MANIFEST_OPTION_KEYS` values, as the generator writes them. `undefined`
+ * when the record already says so, or the manifest has no `/` row with a
+ * `sections` key. The value is spliced in place at its own depth; no other
+ * byte moves.
+ */
+export function planHomeRecord(manifestText, homeText, catalog) {
+    const file = parseRosterFile(manifestText, SITE_ROSTER_PATH);
+    const row = file.rows.find((r) => r.value["route"] === "/");
+    if (row === undefined || !("sections" in row.value))
+        return undefined;
+    const sections = (locatePageSections(homeText, HOME_PAGE_PATH) ?? []).map((section) => {
+        const options = {};
+        for (const key of MANIFEST_OPTION_KEYS) {
+            const entry = section.entries.find((e) => e.key === key);
+            const value = entry === undefined ? undefined : scalarValue(homeText.slice(entry.valueStart, entry.valueEnd));
+            if (value !== undefined)
+                options[key] = value;
+        }
+        return {
+            type: section.type,
+            component: catalog[section.type]?.component ?? section.type,
+            ...(Object.keys(options).length > 0 ? { options } : {}),
+        };
+    });
+    if (isDeepStrictEqual(row.value["sections"], sections))
+        return undefined;
+    const rowStart = manifestText.indexOf(row.text, file.open);
+    const at = findKey(row.text, 0, "sections");
+    const end = endOfValue(row.text, at.valueStart);
+    const column = at.keyStart - (row.text.lastIndexOf("\n", at.keyStart) + 1);
+    const rendered = JSON.stringify(sections, null, 2)
+        .split("\n")
+        .map((line, i) => (i === 0 ? line : `${" ".repeat(column)}${line}`))
+        .join("\n");
+    const rowText = row.text.slice(0, at.valueStart) + rendered + row.text.slice(end);
+    return manifestText.slice(0, rowStart) + rowText + manifestText.slice(rowStart + row.text.length);
+}
 // ── D2: a module's rows, from the shipped manifests ───────────────────────
 /** A template's shipped manifest, or undefined when its tree ships none. */
 function readShippedManifest(siteTemplatesDir, templateName) {

package/dist/starter-grid.js

@@ -170,6 +170,18 @@ const PORTFOLIO_ROWS = [
     { route: "/portfolio", content: ["content/en/PortfolioList/portfolio.mdx"] },
     { route: "/portfolio/[slug]", contentDir: "content/en/PortfolioItem" },
 ];
+/**
+ * The team pages (#7744, checklist D1) — a TeamList hub at `/team` and one
+ * TeamMember profile per person at `/team/<slug>`, each emitting a
+ * `ProfilePage` whose main entity is that `Person`. They belong to the three
+ * ORGANIZATION shapes; person-service is one person and carries none. The
+ * seeds live in the `_base` layer under `content/en/TeamMember/`; the detail
+ * row's `contentDir` installs them, exactly as `PORTFOLIO_ROWS` does.
+ */
+const TEAM_ROWS = [
+    { route: "/team", content: ["content/en/TeamList/team.mdx"] },
+    { route: "/team/[slug]", contentDir: "content/en/TeamMember" },
+];
 /**
  * The two report/referral sample rows. Neither carries a `GATEABLE_SURFACES`
  * entry: `/referral` is a single-segment `LandingPage` slug served by the
@@ -308,18 +320,21 @@ export const SHAPE_ROSTERS = Object.freeze({
         FREE_BLOG_TEASER_ROW,
         ...FREE_MEET_PLACEHOLDER_ROWS,
         ...PORTFOLIO_ROWS,
+        ...TEAM_ROWS,
     ],
     "organization-service": [
         ...ORGANIZATION_SERVICE_ROWS,
         FREE_BLOG_TEASER_ROW,
         ...FREE_MEET_PLACEHOLDER_ROWS,
         ...PORTFOLIO_ROWS,
+        ...TEAM_ROWS,
     ],
     "local-business-service": [
         ...LOCAL_BUSINESS_SERVICE_ROWS,
         FREE_BLOG_TEASER_ROW,
         ...FREE_MEET_PLACEHOLDER_ROWS,
         ...PORTFOLIO_ROWS,
+        ...TEAM_ROWS,
     ],
     "person-service": [
         ...PERSON_SERVICE_ROWS,