create-ailk 0.20.0 → 0.22.0

package/dist/design-home.js

@@ -10,17 +10,41 @@
  * fingerprint is a known placeholder (the shape's own home, or a shipped
  * design's arc of it); any authored home is left alone.
  *
+ * #8661 D11 — a design may also carry `contact/<shape>.mdx`, a complete
+ * `ContactPage` seeded the same way, with two differences: its
+ * `{{SITE_NAME}}` is filled from the site's `siteIdentity.name`, and it
+ * replaces the page's `title:` line as well as its `sections:` value (and a
+ * placeholder `description:` line), so the page is a placeholder only while
+ * its title is one too. Every reader and
+ * planner below takes the seeded page as `page` (default `"home"`).
+ *
  * Pure apart from `readDesignHomeSeeds`/`designHomeSeeds`: every directory it
  * reads is passed in (no `import.meta.url` — Jest's CJS transform).
  */
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { buildScaffoldMarkers } from "./copy.js";
 import { DesignPackageError } from "./design-package.js";
 import { locatePageSections, pageTypeOf, } from "./design-presets.js";
 import { RECOGNIZED_SHAPES } from "./parse-args.js";
+import { substituteMarkers } from "./substitute.js";
 import { STARTER_DESIGNS, TemplateError } from "./template-manifest.js";
 /** Where a site's home page lives, site-relative. */
 export const HOME_PAGE_PATH = "content/en/HomePage/home.mdx";
+/** Where a site's contact page lives, site-relative (#8661 D11). */
+export const CONTACT_PAGE_PATH = "content/en/ContactPage/contact.mdx";
+/**
+ * The pages a design may seed (#8661 D11), keyed by the design-package
+ * directory that holds their seeds (`home/<shape>.mdx`, `contact/<shape>.mdx`).
+ */
+export const DESIGN_SEED_PAGES = {
+    home: { pageType: "HomePage", path: HOME_PAGE_PATH, route: "/" },
+    contact: { pageType: "ContactPage", path: CONTACT_PAGE_PATH, route: "/contact" },
+};
+/** The marker a contact seed's heading and title carry for the site's name (#8661 D11, C8). */
+const SITE_NAME_MARKER = "{{SITE_NAME}}";
+/** The name a contact seed takes when the site records none (#8661 D11). */
+const NO_SITE_NAME = "{Your Name}";
 // ── D1: reading a design's seeds ───────────────────────────────────────────
 /** Flow punctuation: whitespace beside it is layout, never content. */
 const FLOW_PUNCTUATION = new Set(["{", "}", "[", "]", ",", ":"]);
@@ -72,14 +96,18 @@ function rawEntry(text, sections, index, key) {
     return entry === undefined ? undefined : text.slice(entry.valueStart, entry.valueEnd);
 }
 /**
- * Read and validate `<dir>/home/*` (D1). Refuses with a `DesignPackageError`
- * naming the file, before any write: a basename that is not a recognized
- * shape, a page whose `type` is not `HomePage`, `sections` that cannot be
- * located (or are not in the flow form a carry can splice), a section type
- * the catalog does not carry, or a `logoCloud` whose `logos` is not `[]`.
+ * Read and validate `<dir>/home/*` (D1), or `<dir>/contact/*` for
+ * `page: "contact"` (#8661 D11). Refuses with a `DesignPackageError` naming
+ * the file, before any write: a basename that is not a recognized shape, a
+ * page whose `type` is not the page's (`HomePage`, `ContactPage`), `sections`
+ * that cannot be located (or are not in the flow form a carry can splice), a
+ * section type the catalog does not carry, or a `logoCloud` whose `logos` is
+ * not `[]`.
  */
 export function readDesignHomeSeeds(dir, opts) {
-    const homeDir = join(dir, "home");
+    const page = opts.page ?? "home";
+    const expectedType = DESIGN_SEED_PAGES[page].pageType;
+    const homeDir = join(dir, page);
     if (!existsSync(homeDir))
         return [];
     const seeds = [];
@@ -87,7 +115,7 @@ export function readDesignHomeSeeds(dir, opts) {
         const file = join(homeDir, name);
         const shape = name.replace(/\.mdx$/, "");
         if (!name.endsWith(".mdx") || !RECOGNIZED_SHAPES.includes(shape)) {
-            throw new DesignPackageError(file, "home", `is not named after a recognized shape (expected <shape>.mdx, one of ${RECOGNIZED_SHAPES.join(", ")})`);
+            throw new DesignPackageError(file, page, `is not named after a recognized shape (expected <shape>.mdx, one of ${RECOGNIZED_SHAPES.join(", ")})`);
         }
         const text = readFileSync(file, "utf8");
         let pageType;
@@ -101,8 +129,8 @@ export function readDesignHomeSeeds(dir, opts) {
                 throw err;
             throw new DesignPackageError(file, "sections", `cannot be located (${err.message})`);
         }
-        if (pageType !== "HomePage") {
-            throw new DesignPackageError(file, "type", `must be "HomePage" (got ${JSON.stringify(pageType ?? null)})`);
+        if (pageType !== expectedType) {
+            throw new DesignPackageError(file, "type", `must be "${expectedType}" (got ${JSON.stringify(pageType ?? null)})`);
         }
         if (sections === undefined || sections.some((s) => s.form !== "flow")) {
             throw new DesignPackageError(file, "sections", "must be a flow sequence of sections");
@@ -127,12 +155,12 @@ export function readDesignHomeSeeds(dir, opts) {
     return seeds;
 }
 /**
- * The seeds a resolved design uses (D1): its own `home/`, else — a
- * byte-identical copy of a shipped design IS that design — the shipped
- * design's, else none.
+ * The seeds a resolved design uses (D1): its own `home/` (or `contact/`),
+ * else — a byte-identical copy of a shipped design IS that design — the
+ * shipped design's, else none.
  */
 export function designHomeSeeds(resolved, opts) {
-    if (existsSync(join(resolved.dir, "home")))
+    if (existsSync(join(resolved.dir, opts.page ?? "home")))
         return readDesignHomeSeeds(resolved.dir, opts);
     if (STARTER_DESIGNS.includes(resolved.recorded)) {
         return readDesignHomeSeeds(join(opts.designsDir, resolved.recorded), opts);
@@ -143,10 +171,87 @@ export function designHomeSeeds(resolved, opts) {
 export function shippedHomeSeeds(opts) {
     return STARTER_DESIGNS.flatMap((name) => readDesignHomeSeeds(join(opts.designsDir, name), opts));
 }
-/** The shape's own home: its shape tree's, else the overlay's (spec § 1.4). */
+/** The shape's own home (or contact page): its shape tree's, else the overlay's (spec § 1.4). */
 export function shapeHomePath(shape, opts) {
-    const own = join(opts.siteTemplatesDir, "shapes", shape, ...HOME_PAGE_PATH.split("/"));
-    return existsSync(own) ? own : join(opts.templatesDir, ...HOME_PAGE_PATH.split("/"));
+    const path = DESIGN_SEED_PAGES[opts.page ?? "home"].path.split("/");
+    const own = join(opts.siteTemplatesDir, "shapes", shape, ...path);
+    return existsSync(own) ? own : join(opts.templatesDir, ...path);
+}
+// ── #8661 D11: the contact page's name and title ───────────────────────────
+/** The front matter's body, or undefined when the text opens with none. */
+function frontMatterOf(text) {
+    const fm = /^---\r?\n([\s\S]*?)\r?\n---[ \t]*\r?$/m.exec(text);
+    return fm && fm.index === 0 ? fm[1] : undefined;
+}
+/** A one-line YAML scalar's string value: a double-quoted value is JSON-read, a single-quoted one unescaped. */
+function unquote(raw) {
+    const value = raw.trim();
+    if (value.startsWith('"') && value.endsWith('"') && value.length >= 2) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value.slice(1, -1);
+        }
+    }
+    if (value.startsWith("'") && value.endsWith("'") && value.length >= 2)
+        return value.slice(1, -1).replace(/''/g, "'");
+    return value;
+}
+/**
+ * A site's `siteIdentity.name` (#8661 D11, C8): the first `name:` line
+ * indented directly under `siteIdentity:` in `content/_site.mdx`'s front
+ * matter, quotes stripped. Undefined when there is no such line.
+ */
+export function siteIdentityName(siteMdx) {
+    const fm = siteMdx === undefined ? undefined : frontMatterOf(siteMdx);
+    if (fm === undefined)
+        return undefined;
+    const lines = fm.split(/\r?\n/);
+    const start = lines.findIndex((line) => /^siteIdentity:[ \t]*$/.test(line));
+    if (start < 0)
+        return undefined;
+    let indent;
+    for (const line of lines.slice(start + 1)) {
+        if (line.trim() === "" || line.trimStart().startsWith("#"))
+            continue;
+        const lead = line.length - line.trimStart().length;
+        if (lead === 0)
+            return undefined;
+        indent ??= lead;
+        if (lead !== indent)
+            continue;
+        const m = /^[ \t]+name:[ \t]*(.+?)[ \t]*$/.exec(line);
+        if (m) {
+            const name = unquote(m[1]);
+            return name === "" ? undefined : name;
+        }
+    }
+    return undefined;
+}
+/** `seed` with its `{{SITE_NAME}}` filled, escaped for the double-quoted strings it sits in. */
+function fillSiteName(seed, name) {
+    const escaped = JSON.stringify(name).slice(1, -1);
+    return { ...seed, text: seed.text.split(SITE_NAME_MARKER).join(escaped) };
+}
+/** The `<key>:` line's span in the front matter, or undefined. */
+function metaLine(text, key) {
+    const fm = frontMatterOf(text);
+    if (fm === undefined)
+        return undefined;
+    const m = new RegExp(`^${key}:[ \\t]*(.*?)[ \\t]*$`, "m").exec(fm);
+    if (!m)
+        return undefined;
+    const offset = text.indexOf(fm);
+    return { start: offset + m.index, end: offset + m.index + m[0].length, value: unquote(m[1]) };
+}
+/** `page` with its `<key>:` line replaced by `from`'s (or left as it is when either has none). */
+function spliceMeta(page, from, key) {
+    const at = metaLine(page, key);
+    const source = metaLine(from, key);
+    if (at === undefined || source === undefined)
+        return page;
+    return page.slice(0, at.start) + from.slice(source.start, source.end) + page.slice(at.end);
 }
 // ── D3: the content fingerprint ────────────────────────────────────────────
 function locate(text, file) {
@@ -219,16 +324,32 @@ export function applySeed(home, seed, file = "home.mdx") {
 /**
  * Plan a site home under a design (D3). Writes nothing: `text` is the new
  * home when the outcome is `seeded` or `restored`, and absent otherwise.
+ *
+ * `page: "contact"` (#8661 D11) plans the contact page instead. The seeds'
+ * `{{SITE_NAME}}` is filled with `siteName` (absent: `{Your Name}`) before
+ * anything is compared; the shape's own page is read with the scaffold
+ * markers substituted, as a scaffold installed it; the page is a placeholder
+ * only while its title is one too (the shape's own, or a seed's); and a write
+ * replaces the `title:` line as well as the sections, and the `description:`
+ * line while it is still a placeholder (the shape's own, or a seed's).
  */
 export function planDesignHome(opts) {
-    const { current, shape, target, shapeHome, catalog } = opts;
+    const page = opts.page ?? "home";
+    const contact = page === "contact";
+    const pagePath = DESIGN_SEED_PAGES[page].path;
+    const { current, shape, catalog } = opts;
     if (current === undefined)
         return { outcome: "no-home" };
     if (shape === undefined)
         return { outcome: "no-shape" };
+    const name = opts.siteName ?? NO_SITE_NAME;
+    const fill = (seed) => (contact ? fillSiteName(seed, name) : seed);
+    const target = opts.target === undefined ? undefined : fill(opts.target);
+    // The scaffold's own markers carry no project-specific value a contact page uses.
+    const shapeHome = contact ? substituteMarkers(opts.shapeHome, buildScaffoldMarkers("")) : opts.shapeHome;
     let currentPrint;
     try {
-        currentPrint = fingerprint(current, catalog, HOME_PAGE_PATH);
+        currentPrint = fingerprint(current, catalog, pagePath);
     }
     catch (err) {
         // A home whose sections cannot be read is not a placeholder: never write it.
@@ -236,21 +357,38 @@ export function planDesignHome(opts) {
             return { outcome: "authored" };
         throw err;
     }
-    const seeds = [...opts.shippedSeeds.filter((s) => s.shape === shape), ...(target !== undefined ? [target] : [])];
+    const seeds = [
+        ...opts.shippedSeeds.filter((s) => s.shape === shape).map(fill),
+        ...(target !== undefined ? [target] : []),
+    ];
     const placeholders = new Set([
         fingerprint(shapeHome, catalog),
         ...seeds.map((seed) => fingerprint(spliceSections(shapeHome, applySeed(shapeHome, seed), "shape home"), catalog)),
     ]);
     if (!placeholders.has(currentPrint))
         return { outcome: "authored" };
+    // #8661 D11 — a contact page whose title was retitled is authored, whatever its sections.
+    const placeholderTexts = [shapeHome, ...seeds.map((seed) => seed.text)];
+    const placeholderMeta = (key) => new Set(placeholderTexts.map((text) => metaLine(text, key)?.value));
+    if (contact && !placeholderMeta("title").has(metaLine(current, "title")?.value))
+        return { outcome: "authored" };
     const wanted = target !== undefined
-        ? applySeed(current, target, HOME_PAGE_PATH)
+        ? applySeed(current, target, pagePath)
         : (() => {
             const own = locate(shapeHome, "shape home");
             return shapeHome.slice(own.valueStart, own.valueEnd);
         })();
-    const text = spliceSections(current, wanted, HOME_PAGE_PATH);
-    if (fingerprint(text, catalog) === currentPrint)
+    let text = spliceSections(current, wanted, pagePath);
+    if (contact) {
+        const from = target?.text ?? shapeHome;
+        text = spliceMeta(text, from, "title");
+        // An edited description is the customer's: only a placeholder one is replaced.
+        if (placeholderMeta("description").has(metaLine(current, "description")?.value)) {
+            text = spliceMeta(text, from, "description");
+        }
+    }
+    const sameMeta = ["title", "description"].every((key) => metaLine(text, key)?.value === metaLine(current, key)?.value);
+    if (fingerprint(text, catalog) === currentPrint && sameMeta)
         return { outcome: "unchanged" };
     return { outcome: target !== undefined ? "seeded" : "restored", text };
 }

package/dist/design-package.js

@@ -486,13 +486,14 @@ function validateStringMap(raw, file, field) {
 }
 const LAYOUT_KEYS = ["nav", "footer", "announcementBanner", "home"];
 /** Every key a package's `layout` may carry — #7719 D3 adds the optional `deckGrounds` (a deck home only),
- *  #7721 D1 the optional `innerPages`, #7740 D1 the optional `deckPresentation` (a deck home only),
+ *  #7721 D1 the optional `innerPages`, #7740 D1 the optional `deckPresentation` (a deck home only), #8773 the optional `deckAnchors` (a presenting deck only),
  *  #7742 D1 the optional `colorMode` and `chromeStyle`, #7797 D1 the optional `closingFooterPaths`. */
 const ALLOWED_LAYOUT_KEYS = new Set([
     ...LAYOUT_KEYS,
     "deckGrounds",
     "innerPages",
     "deckPresentation",
+    "deckAnchors",
     "colorMode",
     "chromeStyle",
     "closingFooterPaths",
@@ -524,11 +525,12 @@ function validateLayout(raw, file) {
     // `ResolvedSiteChrome` shape; an explicit "default" is the absent key.
     // #7740 D1 — and `deckPresentation` only as `true`.
     // #7742 D1 — and `colorMode` only as "light", `chromeStyle` only as "minimal".
-    const { innerPages, deckPresentation, colorMode, chromeStyle, ...rest } = validated;
+    const { innerPages, deckPresentation, deckAnchors, colorMode, chromeStyle, ...rest } = validated;
     const layout = {
         ...rest,
         ...(innerPages === "bare" ? { innerPages } : {}),
         ...(deckPresentation === true ? { deckPresentation } : {}),
+        ...(deckAnchors === "bare" ? { deckAnchors } : {}),
         ...(colorMode === "light" ? { colorMode } : {}),
         ...(chromeStyle === "minimal" ? { chromeStyle } : {}),
     };
@@ -538,6 +540,9 @@ function validateLayout(raw, file) {
     if (deckPresentation === true && layout.home !== "deck") {
         refuse(file, "layout.deckPresentation", "applies only to home: deck");
     }
+    if (deckAnchors === "bare" && deckPresentation !== true) {
+        refuse(file, "layout.deckAnchors", "applies only with deckPresentation: true");
+    }
     return layout;
 }
 const TREATMENTS_ENUMS = {

package/dist/lib/design-checks.d.ts

@@ -54,9 +54,14 @@ export type JsonLdDriftVerdict = {
  * returned as it is.
  */
 export declare function admitSeededPeopleSlide(before: ComposedPages, after: ComposedPages): ComposedPages;
+/**
+ * `after` with the standard contact page put back when the seeded one differs
+ * only in `name` and `description` (#8661 D11).
+ */
+export declare function admitSeededContactPage(before: ComposedPages, after: ComposedPages): ComposedPages;
 /**
  * Decide whether `apply-design <design>` left every page's JSON-LD unchanged
- * (logo excluded), the seeded people slide's Persons admitted.
+ * (logo excluded), the seeded people slide's Persons and contact page admitted.
  */
 export declare function assessJsonLdDrift(design: string, before: ComposedPages, after: ComposedPages): JsonLdDriftVerdict;
 export interface MeasureApplyDesignDriftOptions {

package/dist/lib/design-checks.js

@@ -21,11 +21,14 @@
  * organization home's people slide adds one `Person` per seeded team member to
  * the home's graph. `admitSeededPeopleSlide` puts the standard home back only
  * when the seeded home is exactly that, so any other change still counts.
+ * Likewise a design that seeds the contact page renames and re-describes it
+ * (#8661 D11); `admitSeededContactPage` admits only those two fields.
  */
 import { execFileSync } from "node:child_process";
 import { writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { isDeepStrictEqual } from "node:util";
+import { CONTACT_PAGE_PATH } from "../design-home.js";
 import { TEAM_SEED_MEMBERS } from "../team-profiles.js";
 function describePair(row) {
     const measured = row.status === "unmeasurable" || row.ratio === null
@@ -140,18 +143,36 @@ export function admitSeededPeopleSlide(before, after) {
     const isPeopleSlide = isDeepStrictEqual(page, JSON.parse(standard.jsonld)) && isDeepStrictEqual(people, expected);
     return isPeopleSlide ? { ...after, [HOME_PAGE]: standard } : after;
 }
+/**
+ * `after` with the standard contact page put back when the seeded one differs
+ * only in `name` and `description` (#8661 D11).
+ */
+export function admitSeededContactPage(before, after) {
+    const standard = before[CONTACT_PAGE_PATH];
+    const seeded = after[CONTACT_PAGE_PATH];
+    if (standard === undefined || seeded === undefined || !seeded.sectionsValid)
+        return after;
+    const strip = (jsonld) => ({
+        ...JSON.parse(jsonld),
+        name: undefined,
+        description: undefined,
+    });
+    return isDeepStrictEqual(strip(seeded.jsonld), strip(standard.jsonld))
+        ? { ...after, [CONTACT_PAGE_PATH]: standard }
+        : after;
+}
 /** How many changed nodes a drift reason lists before it stops. */
 const REASON_NODE_LIMIT = 10;
 /**
  * Decide whether `apply-design <design>` left every page's JSON-LD unchanged
- * (logo excluded), the seeded people slide's Persons admitted.
+ * (logo excluded), the seeded people slide's Persons and contact page admitted.
  */
 export function assessJsonLdDrift(design, before, after) {
     const pages = Object.keys(before).length;
     if (pages === 0) {
         return { ok: false, pages, changed: [], reason: `design ${design}: no page was composed` };
     }
-    const changed = jsonLdDrift(before, admitSeededPeopleSlide(before, after));
+    const changed = jsonLdDrift(before, admitSeededContactPage(before, admitSeededPeopleSlide(before, after)));
     if (changed.length === 0)
         return { ok: true, pages };
     const listed = changed

package/dist/lib/env-catalog.js

@@ -52,7 +52,7 @@ export const ENV_CATALOG = {
         secret: false,
     },
     AILK_LEAD_SITE: {
-        description: "Marks which site of a hub and its spokes captured an MCP lead; unset leaves the lead unmarked.",
+        description: "This site's slug, written as payload.site on every lead its /contact form and MCP server capture, so a hub can tell its sites apart; unset leaves the lead unmarked.",
         secret: false,
     },
     AILK_LICENSE_STORAGE_PATH: {
@@ -71,6 +71,10 @@ export const ENV_CATALOG = {
         description: "The scope captured leads are stamped with; on a single-tenant install, the default workspace id.",
         secret: false,
     },
+    AILK_SPOKE_KEY: {
+        description: "The hub-issued key this site sends as x-ailk-spoke-key; the checkout fulfilment refuses to run without it. Never committed.",
+        secret: true,
+    },
     AILK_VISITOR_FORWARD_KEY: {
         description: "This spoke's key for forwarding each visitor's IP to the hub, so the hub rate-limits per visitor. Server-only.",
         secret: true,

package/dist/module-architecture.js

@@ -1813,8 +1813,10 @@ export const MODULE_SLICES = {
         // the flow results pages, dev/purchase — spoke-intake Rule 3). What lands
         // is the scaffold-commerce skill, the commerce-boundary rule and the
         // @working-theory/ui-commerce dependency (`patches` below); the spoke's own
-        // checkout — two routes, checkout-config.ts and two return pages — is
-        // rendered by create-ailk (`spoke-checkout.ts`), not carried here.
+        // checkout — the standard spoke checkout, `apps/web` template source
+        // (two routes, lib/checkout.ts, checkout-config.ts, two return pages and
+        // their tests) — is copied by `writeSpokeCheckoutSlice`
+        // (`spoke-checkout.ts`, #8748), not carried here.
         spoke: true,
         paidSectionsPackage: "@working-theory/ui-commerce",
         apps: {

package/dist/programmatic.js

@@ -25,7 +25,7 @@ import { CATALOG_TARGET_PATH, writeComponentCatalog, } from "./component-catalog
 import { buildScaffoldMarkers, copyTemplate } from "./copy.js";
 import { deriveArchitecture } from "./derive-architecture.js";
 import { compileDesignFonts, compileDesignTheme } from "./design-compile.js";
-import { HOME_PAGE_PATH, designHomeSeeds, planDesignHome, shapeHomePath, shippedHomeSeeds, } from "./design-home.js";
+import { DESIGN_SEED_PAGES, designHomeSeeds, planDesignHome, shapeHomePath, shippedHomeSeeds, siteIdentityName, } from "./design-home.js";
 import { applyDesignPresets, readSectionLookCatalog, shippedPageTypes, validateDesignPresets, } from "./design-presets.js";
 import { resolveDesign, spliceThemeBlock, } from "./design-scaffold.js";
 import { writeAuthSecretFile } from "./lib/auth-secret-file.js";
@@ -44,7 +44,7 @@ import { SITE_CHROME_PATH, renderSiteChrome, resolveSiteChrome, } from "./site-c
 import { SITE_FONTS_PATH, renderSiteFonts } from "./site-fonts.js";
 import { planSiteManifest } from "./site-manifest.js";
 import { SITE_ROSTER_PATH, planHomeRecord, planSiteManifestDesign, readSiteRoster, withMeetPlaceholderSeeds, } from "./site-roster.js";
-import { spokeCheckoutSite, spokeEnvRowOptions, writeSpokeCheckoutSlice, } from "./spoke-checkout.js";
+import { SPOKE_CHECKOUT_TEMPLATE_PATHS, dropSpokeCheckoutDependency, spokeCheckoutSite, spokeEnvRowOptions, writeSpokeCheckoutSlice, } from "./spoke-checkout.js";
 import { GATEABLE_SURFACES, MODULE_SURFACES, NAV_CONFIG_PATH, excludedRoutePaths, isUnservedSurfaceContent, 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";
@@ -182,6 +182,9 @@ export function scaffoldSync(opts, copied) {
             ...(spoke !== undefined
                 ? spokeExclusions(TEMPLATES_DIR, spoke)
                 : SPOKE_ONLY_FILES),
+            // #8748 D3 — the standard spoke checkout lands only through
+            // `writeSpokeCheckoutSlice`, on a spoke carrying commerce.
+            ...SPOKE_CHECKOUT_TEMPLATE_PATHS,
         ],
         markers: buildScaffoldMarkers(projectName),
         ...(copied !== undefined
@@ -193,6 +196,9 @@ export function scaffoldSync(opts, copied) {
             }
             : {}),
     });
+    // #8748 D3 — the copied apps/web depends on the checkout package; only a
+    // commerce spoke keeps it, re-added by `writeSpokeCheckoutSlice` in scaffold().
+    dropSpokeCheckoutDependency(targetAbs);
     // #7426 D5/D6 — the root files a spoke rewrites, and the spoke seams.
     if (spoke !== undefined)
         applySpokeTransforms(targetAbs, spoke);
@@ -330,6 +336,10 @@ export async function scaffold(opts) {
     const designSeeds = resolvedDesign !== undefined
         ? designHomeSeeds(resolvedDesign, { designsDir: DESIGNS_DIR, catalog })
         : [];
+    // #8661 D11 — and its contact seeds, read and validated the same way.
+    const designContactSeeds = resolvedDesign !== undefined
+        ? designHomeSeeds(resolvedDesign, { designsDir: DESIGNS_DIR, catalog, page: "contact" })
+        : [];
     // #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;
@@ -719,21 +729,35 @@ export async function scaffold(opts) {
         // 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;
+        // `planDesignHome` call site in scaffold(). #8661 D11 — the contact page
+        // is planned right after the home, its heading named from the scaffold's
+        // `siteIdentity.name`.
+        const seededPages = [];
         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;
+            const siteName = siteIdentityName(existsSync(siteMdxPath) ? readFileSync(siteMdxPath, "utf8") : undefined);
+            for (const [page, pageSeeds] of [
+                ["home", designSeeds],
+                ["contact", designContactSeeds],
+            ]) {
+                const pagePath = join(result.targetDir, ...DESIGN_SEED_PAGES[page].path.split("/"));
+                const plan = planDesignHome({
+                    page,
+                    siteName,
+                    current: existsSync(pagePath) ? readFileSync(pagePath, "utf8") : undefined,
+                    shape: template.shape,
+                    target: pageSeeds.find((seed) => seed.shape === template.shape),
+                    shapeHome: readFileSync(shapeHomePath(template.shape, {
+                        siteTemplatesDir: SITE_TEMPLATES_DIR,
+                        templatesDir: TEMPLATES_DIR,
+                        page,
+                    }), "utf8"),
+                    shippedSeeds: shippedHomeSeeds({ designsDir: DESIGNS_DIR, catalog, page }),
+                    catalog: catalog(),
+                });
+                if (plan.outcome === "seeded" && plan.text !== undefined) {
+                    writeFileSync(pagePath, plan.text);
+                    seededPages.push(page);
+                }
             }
         }
         // #6816 D6 step 10b — the design's section presets, written onto the
@@ -761,26 +785,40 @@ export async function scaffold(opts) {
             }
         }
         // #7743 D6 — the manifest's `/` row records the seeded home's sections,
-        // as the presets left them.
+        // as the presets left them. #8661 — and the `/contact` row the seeded
+        // contact page's.
         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);
+        if (seededPages.length > 0 && existsSync(rosterPath)) {
+            const recorded = readFileSync(rosterPath, "utf8");
+            let manifestText = recorded;
+            for (const page of seededPages) {
+                const pagePath = join(result.targetDir, ...DESIGN_SEED_PAGES[page].path.split("/"));
+                manifestText = planHomeRecord(manifestText, readFileSync(pagePath, "utf8"), catalog(), page) ?? manifestText;
+            }
+            if (manifestText !== recorded)
+                writeFileSync(rosterPath, manifestText);
         }
     }
-    // #7838 D8 — a commerce spoke's own checkout: two routes, its config and
-    // two return pages, once every layer has landed (so the spoke filter has
-    // already dropped the hub-checkout files) and before the manifest, whose
-    // code-route rows then record /checkout/thank-you and /checkout/unavailable.
+    // #7838 D8 — a commerce spoke's own checkout: the standard spoke checkout
+    // copied from the template (#8748 D3), its config stamped, once every layer
+    // has landed (so the spoke filter has already dropped the hub-checkout
+    // files) and before the manifest, whose code-route rows then record
+    // /checkout/thank-you and /checkout/unavailable. Each copied file is
+    // recorded like the base copy's, so `update` keeps it current.
     // #8217 D8 — a spoke that signs in through its hub also gets the billing
     // action and the web seam render that reaches it.
     const spokeCommerce = spoke !== undefined && result.modules.includes("commerce");
     if (spokeCommerce) {
         writeSpokeCheckoutSlice(result.targetDir, {
             site: spokeCheckoutSite(projectName),
+            projectName,
             versions,
+            templatesDir: TEMPLATES_DIR,
             signIn: spoke.signIn,
+            onWrite: (relPath, bytes) => {
+                if (isRecordable(relPath))
+                    copied.set(relPath, sha256Hex(bytes));
+            },
         });
     }
     // #6944 — the manifest records what this scaffold IS, once every layer has

package/dist/site-chrome.d.ts

@@ -41,6 +41,10 @@ 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 `deckAnchors` knob's vocabulary (#8773). `bare` → the deck home names
+ *  its slides `#<id>` instead of `#slide-<id>`, keeping the `slide-` name only
+ *  where the bare id would collide (the page renderer's `deckSlideAnchors`). */
+export type SiteChromeDeckAnchors = "prefixed" | "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";
@@ -72,6 +76,8 @@ export interface TemplateLayout {
     innerPages?: SiteChromeInnerPages;
     /** #7740 D1 — `true`: the deck home presents slide by slide (a deck home only). */
     deckPresentation?: boolean;
+    /** #8773 — `bare`: a presenting deck names its slides `#<id>` (a presenting deck home only). */
+    deckAnchors?: SiteChromeDeckAnchors;
     /** #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. */
@@ -91,6 +97,8 @@ export interface ResolvedSiteChrome {
     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 "bare" on a presenting deck home (#8773) — never "prefixed". */
+    deckAnchors?: "bare";
     /** Present only when it resolves to "light" — never "user" (#7742 D1). */
     colorMode?: "light";
     /** Present only when it resolves to "minimal" — never "default" (#7742 D1). */