create-ailk 0.20.0 → 0.22.0

package/dist/site-chrome.js

@@ -64,6 +64,7 @@ const NAV_VALUES = ["full", "mark-only"];
 const FOOTER_VALUES = ["columns", "centered"];
 const HOME_VALUES = ["default", "deck"];
 const INNER_PAGES_VALUES = ["default", "bare"];
+const DECK_ANCHORS_VALUES = ["prefixed", "bare"];
 const COLOR_MODE_VALUES = ["user", "light"];
 const CHROME_STYLE_VALUES = ["default", "minimal"];
 /**
@@ -140,6 +141,12 @@ export function validateTemplateLayout(value, subject) {
         }
         result.deckPresentation = raw.deckPresentation;
     }
+    if ("deckAnchors" in raw && raw.deckAnchors !== undefined) {
+        if (!DECK_ANCHORS_VALUES.includes(raw.deckAnchors)) {
+            throw new TemplateLayoutError(`${subject}: layout.deckAnchors must be one of ${DECK_ANCHORS_VALUES.join(", ")} — got ${JSON.stringify(raw.deckAnchors)}`);
+        }
+        result.deckAnchors = raw.deckAnchors;
+    }
     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)}`);
@@ -206,6 +213,11 @@ export function resolveSiteChrome(layout, designLayout) {
     if ((layout?.deckPresentation ?? fromDesign.deckPresentation) === true && resolved.home === "deck") {
         resolved.deckPresentation = true;
     }
+    // #8773 — only "bare" is ever a key, and only where the deck presents: the
+    // slide anchors it names exist only under the presentation dial.
+    if ((layout?.deckAnchors ?? fromDesign.deckAnchors) === "bare" && resolved.deckPresentation === true) {
+        resolved.deckAnchors = "bare";
+    }
     // #7742 D1 — as with `innerPages`, only the opt-in value is ever a key.
     if ((layout?.colorMode ?? fromDesign.colorMode) === "light") {
         resolved.colorMode = "light";
@@ -245,6 +257,8 @@ export function renderSiteChrome(resolved) {
     // #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," : "";
+    // #8773 — the same form: member and bullet always, the value line only for "bare".
+    const deckAnchorsValue = resolved.deckAnchors === "bare" ? '\n  deckAnchors: "bare",' : "";
     // #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",' : "";
@@ -271,6 +285,7 @@ export function renderSiteChrome(resolved) {
 //   - 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
+//   - deckAnchors: "bare" → the presenting deck names its slides #<id> instead of #slide-<id>
 //   - 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,
@@ -286,6 +301,7 @@ export interface SiteChrome {
   home: "default" | "deck";
   innerPages?: "bare";
   deckPresentation?: true;
+  deckAnchors?: "bare";
   colorMode?: "light";
   chromeStyle?: "minimal";
   closingFooterPaths?: readonly string[];${groundsMember}
@@ -295,7 +311,7 @@ export const siteChrome: SiteChrome = {
   nav: ${JSON.stringify(resolved.nav)},
   footer: ${JSON.stringify(resolved.footer)},
   announcementBanner: ${JSON.stringify(resolved.announcementBanner)},
-  home: ${JSON.stringify(resolved.home)},${groundsValue}${innerPagesValue}${presentationValue}${colorModeValue}${chromeStyleValue}${closingFooterPathsValue}
+  home: ${JSON.stringify(resolved.home)},${groundsValue}${innerPagesValue}${presentationValue}${deckAnchorsValue}${colorModeValue}${chromeStyleValue}${closingFooterPathsValue}
 };
 `;
 }

package/dist/site-roster.d.ts

@@ -1,4 +1,5 @@
 import type { CompiledDesignTheme } from "./design-compile.js";
+import { type DesignSeedPage } from "./design-home.js";
 import { type SectionLookCatalog } from "./design-presets.js";
 import { type PageRosterRow } from "./module-architecture.js";
 import type { ModuleName } from "./parse-args.js";
@@ -102,9 +103,10 @@ export declare const MANIFEST_OPTION_KEYS: readonly ["itemStyle", "actionsPositi
  * `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.
+ * byte moves. `page: "contact"` records the `/contact` row from the contact
+ * page instead (#8661 D11).
  */
-export declare function planHomeRecord(manifestText: string, homeText: string, catalog: SectionLookCatalog): string | undefined;
+export declare function planHomeRecord(manifestText: string, homeText: string, catalog: SectionLookCatalog, page?: DesignSeedPage): 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

@@ -28,7 +28,7 @@ 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 { DESIGN_SEED_PAGES } 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";
@@ -296,14 +296,16 @@ function scalarValue(raw) {
  * `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.
+ * byte moves. `page: "contact"` records the `/contact` row from the contact
+ * page instead (#8661 D11).
  */
-export function planHomeRecord(manifestText, homeText, catalog) {
+export function planHomeRecord(manifestText, homeText, catalog, page = "home") {
+    const { route, path } = DESIGN_SEED_PAGES[page];
     const file = parseRosterFile(manifestText, SITE_ROSTER_PATH);
-    const row = file.rows.find((r) => r.value["route"] === "/");
+    const row = file.rows.find((r) => r.value["route"] === route);
     if (row === undefined || !("sections" in row.value))
         return undefined;
-    const sections = (locatePageSections(homeText, HOME_PAGE_PATH) ?? []).map((section) => {
+    const sections = (locatePageSections(homeText, path) ?? []).map((section) => {
         const options = {};
         for (const key of MANIFEST_OPTION_KEYS) {
             const entry = section.entries.find((e) => e.key === key);

package/dist/spoke-checkout.d.ts

@@ -4,17 +4,17 @@ import { type WorkspaceVersionMap } from "./substitute.js";
 import { type SignInMode } from "./topology.js";
 /** The checkout package a spoke's two route files import. */
 export declare const SPOKE_CHECKOUT_PACKAGE = "@working-theory/spoke-checkout";
-/** The site's checkout data — written once, the site's from then on. */
+/** The site's checkout data — written once, the site's from then on (#8748 D2). */
 export declare const SPOKE_CHECKOUT_CONFIG_PATH = "apps/web/lib/checkout-config.ts";
 /** The two return pages: Stripe's success URL and every refused buy's target. */
 export declare const SPOKE_CHECKOUT_PAGE_FILES: readonly string[];
 /**
- * The marker `renderPage()` stamps into both generated return pages' header
- * comment (D3). `apps/web`'s structured-data test cannot import create-ailk
- * (the import boundary), so it carries this text as a literal, kept in sync
- * by `packages/create-ailk/__tests__/spoke-checkout.test.ts` (#8513 AC-5).
+ * The standard spoke checkout's template paths, scaffold-relative (#8748 D3).
+ * A directory entry covers every file under it, so the tests that sit beside
+ * the routes and pages travel with them. `copyTemplate` skips all of them for
+ * every scaffold; `writeSpokeCheckoutSlice` copies them into a commerce spoke.
  */
-export declare const SPOKE_CHECKOUT_PAGE_MARKER = "GENERATED by create-ailk (#7838)";
+export declare const SPOKE_CHECKOUT_TEMPLATE_PATHS: readonly string[];
 /** The variables a commerce spoke depends on (D9). The package reads three of them. */
 export declare const SPOKE_CHECKOUT_ENV_CATALOG: Readonly<Record<string, EnvCatalogEntry>>;
 /** The names a commerce spoke declares although only the package reads them (D9). */
@@ -54,29 +54,50 @@ export declare const E2E_ACTION_PINS: Readonly<Record<string, string>>;
  */
 export declare const CHECKOUT_E2E_WORKFLOW: string;
 /**
- * The slice for `site`, in order: the two route files, the config, the two
- * pages (D3), then the checkout e2e workflow (#7839 D8), which does not
- * depend on `site`. With `signIn: "hub"` the billing action is the third
- * pair, so the first three paths are `SPOKE_CHECKOUT_ROUTE_FILES` (#8217 D8).
- * Throws `TopologyError` for an invalid stamp (SEC-7838-10).
+ * The rendered part of the slice for `site` (#8748 D3): with `signIn: "hub"`
+ * the billing action (#8217 D8), then the checkout e2e workflow (#7839 D8).
+ * Neither depends on `site`. The rest of the slice is template source,
+ * copied by `writeSpokeCheckoutSlice`. Throws `TopologyError` for an invalid
+ * stamp (SEC-7838-10).
  */
 export declare function renderSpokeCheckoutFiles(site: string, opts?: {
     signIn?: SignInMode | undefined;
 }): [string, string][];
 /**
- * Write the slice into `targetDir` (D3). A file that already exists is left
- * byte-for-byte and reported `skipped` — the config is the site's once
+ * Write the slice into `targetDir` (#7838 D3, #8748 D3). The standard's
+ * template files (`SPOKE_CHECKOUT_TEMPLATE_PATHS`) are copied from
+ * `templatesDir`, each rendered with `copyTemplate`'s own renderer and
+ * markers, so a recorded hash equals what `create-ailk update` renders; the
+ * config's one `const SITE` line is stamped with `site`. `onWrite` is called
+ * once per template file written, as `copyTemplate` calls it. Then come the
+ * rendered files (`renderSpokeCheckoutFiles`). A file that already exists is
+ * left byte-for-byte and reported `skipped` — the config is the site's once
  * written. With `signIn: "hub"` (#8217 D8) the slice carries the billing
  * action, and the web seam — generated, so always rewritten — becomes the
- * billing render: reported `patched` when it changed, not at all when equal. Adds the package to `apps/web/package.json` when absent, and
- * raises a plain pin older than the one it writes (#7839): the generated
- * checkout e2e workflow runs a command a `^0.2.0` pin never reaches. Any
- * other range — newer, `workspace:`, a tag — is the site's and is kept.
+ * billing render: reported `patched` when it changed, not at all when equal.
+ * Adds the package to `apps/web/package.json` when absent, and raises a plain
+ * pin older than the one it writes (#7839): the generated checkout e2e
+ * workflow runs a command a `^0.2.0` pin never reaches. Any other range —
+ * newer, `workspace:`, a tag — is the site's and is kept.
  * Every refusal (an invalid stamp, a version map without the package, a
- * missing or malformed `apps/web/package.json`) throws before the first write.
+ * missing or malformed `apps/web/package.json`, a template missing any
+ * `SPOKE_CHECKOUT_TEMPLATE_PATHS` entry, a template config without exactly
+ * one `const SITE` line, a destination to write that resolves outside
+ * `targetDir`) throws before the first write.
  */
 export declare function writeSpokeCheckoutSlice(targetDir: string, opts: {
     site: string;
+    projectName: string;
     versions: WorkspaceVersionMap;
+    templatesDir: string;
     signIn?: SignInMode | undefined;
+    onWrite?: (relPath: string, bytes: Uint8Array) => void;
 }): InstallReportRow[];
+/**
+ * Drop the checkout package from a scaffold that does not get the slice — a
+ * hub, or a spoke without `commerce` (#8748 D3). The template's
+ * `apps/web/package.json` depends on it because the monorepo's `apps/web`
+ * carries the standard. Every other key is kept in place; a site without the
+ * dependency, or without `apps/web/package.json`, is left as it is.
+ */
+export declare function dropSpokeCheckoutDependency(targetDir: string): void;