create-ailk 0.20.0 → 0.21.0

package/dist/apply-design.js

@@ -19,7 +19,7 @@ import { dirname, join, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
 import { planDesignMd } from "./apply-design-md.js";
 import { compileDesignFonts, compileDesignTheme } from "./design-compile.js";
-import { HOME_PAGE_PATH, designHomeSeeds, planDesignHome, shapeHomePath, shippedHomeSeeds, } from "./design-home.js";
+import { CONTACT_PAGE_PATH, DESIGN_SEED_PAGES, HOME_PAGE_PATH, 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 { chromeKnobReaders, unreadChromeKnobs } from "./lib/chrome-readers.js";
@@ -194,6 +194,9 @@ export async function applyDesign(opts) {
     // #7743 D7 — the home seeds (the design's and every shipped design's), validated beside the presets.
     const designSeeds = designHomeSeeds(resolved, { designsDir: opts.designsDir, catalog });
     const shippedSeeds = shippedHomeSeeds({ designsDir: opts.designsDir, catalog });
+    // #8661 D11 — and the contact seeds, the same way.
+    const contactSeeds = designHomeSeeds(resolved, { designsDir: opts.designsDir, catalog, page: "contact" });
+    const shippedContactSeeds = shippedHomeSeeds({ designsDir: opts.designsDir, catalog, page: "contact" });
     // C5 — the design gate, fed the site's own key (D6). A Free design reads no key.
     if (!resolved.free) {
         const key = readSiteKey(targetAbs, env);
@@ -243,28 +246,44 @@ export async function applyDesign(opts) {
     const designMdNext = planDesignMd(resolved.dir, targetAbs);
     // #7743 D7 — the home is planned before the presets, so a seeded home is
     // written once, carrying both. The one `planDesignHome` call site here.
+    // #8661 D11 — the contact page is planned right after it, its heading named
+    // from the site's `siteIdentity.name`.
     const shape = roster?.template.shape;
-    const target = designSeeds.find((seed) => seed.shape === shape);
-    // The arc this site would take: the shape's seed, or (with no shape to pick one) any seed at all.
-    const homeArc = target !== undefined || (shape === undefined && designSeeds.length > 0);
-    const homePath = join(targetAbs, ...HOME_PAGE_PATH.split("/"));
-    const current = existsSync(homePath) ? readFileSync(homePath, "utf8") : undefined;
-    const homePlan = planDesignHome({
-        current,
-        shape,
-        target,
-        shapeHome: shape === undefined || current === undefined
-            ? ""
-            : readFileSync(shapeHomePath(shape, {
-                siteTemplatesDir: opts.siteTemplatesDir,
-                templatesDir,
-            }), "utf8"),
-        shippedSeeds,
-        catalog: catalog(),
+    const siteName = siteIdentityName(siteMdxCurrent);
+    const plans = [
+        ["home", designSeeds, shippedSeeds],
+        ["contact", contactSeeds, shippedContactSeeds],
+    ].map(([page, pageSeeds, shippedPageSeeds]) => {
+        const target = pageSeeds.find((seed) => seed.shape === shape);
+        const path = join(targetAbs, ...DESIGN_SEED_PAGES[page].path.split("/"));
+        const current = existsSync(path) ? readFileSync(path, "utf8") : undefined;
+        const plan = planDesignHome({
+            page,
+            siteName,
+            current,
+            shape,
+            target,
+            shapeHome: shape === undefined || current === undefined
+                ? ""
+                : readFileSync(shapeHomePath(shape, { siteTemplatesDir: opts.siteTemplatesDir, templatesDir, page }), "utf8"),
+            shippedSeeds: shippedPageSeeds,
+            catalog: catalog(),
+        });
+        // The page this site would take: the shape's seed, or (with no shape to pick one) any seed at all.
+        const offered = target !== undefined || (shape === undefined && pageSeeds.length > 0);
+        const action = plan.outcome === "seeded" || plan.outcome === "restored" ? plan.outcome : undefined;
+        return { path, plan, offered, action };
     });
-    const homeAction = homePlan.outcome === "seeded" || homePlan.outcome === "restored" ? homePlan.outcome : undefined;
+    const [homeSeeding, contactSeeding] = plans;
+    const homePlan = homeSeeding.plan;
+    const homeArc = homeSeeding.offered;
+    const homePath = homeSeeding.path;
+    const homeAction = homeSeeding.action;
+    const contactPlan = contactSeeding.plan;
+    const contactPath = contactSeeding.path;
+    const contactAction = contactSeeding.action;
     const pageWrites = [];
-    if (roster !== undefined && (hasPresets || homeAction !== undefined)) {
+    if (roster !== undefined && (hasPresets || homeAction !== undefined || contactAction !== undefined)) {
         const pageTypes = new Set();
         for (const row of roster.rows) {
             const pageType = row.value["pageType"];
@@ -274,11 +293,17 @@ export async function applyDesign(opts) {
         const contentDir = join(targetAbs, "content");
         // An authored home kept from a design's arc is reported as kept, so no preset dresses it either (D3, F4).
         const homeKept = homePlan.outcome === "authored" && homeArc;
+        // #8661 D11 — likewise an authored contact page kept from the design's own.
+        const contactKept = contactPlan.outcome === "authored" && contactSeeding.offered;
         const pages = listMdxFiles(contentDir)
-            .filter((path) => path !== siteMdxPath && !(homeKept && path === homePath))
+            .filter((path) => path !== siteMdxPath && !(homeKept && path === homePath) && !(contactKept && path === contactPath))
             .map((path) => ({
             path,
-            text: path === homePath && homePlan.text !== undefined ? homePlan.text : readFileSync(path, "utf8"),
+            text: path === homePath && homePlan.text !== undefined
+                ? homePlan.text
+                : path === contactPath && contactPlan.text !== undefined
+                    ? contactPlan.text
+                    : readFileSync(path, "utf8"),
         }));
         const presetResult = hasPresets
             ? applyDesignPresets(pages, pkg.sections, { pageTypes })
@@ -286,14 +311,21 @@ export async function applyDesign(opts) {
         for (const page of pages) {
             const preset = presetResult.pages.find((p) => p.path === page.path);
             const home = page.path === homePath ? homeAction : undefined;
-            if (preset === undefined && home === undefined)
+            const contact = page.path === contactPath ? contactAction : undefined;
+            if (preset === undefined && home === undefined && contact === undefined)
                 continue;
             const fields = [
                 ...new Set(presetResult.applied
                     .filter((a) => a.path === page.path)
                     .map((a) => `${a.sectionType}.${a.field}`)),
             ].sort();
-            pageWrites.push({ path: page.path, text: preset?.text ?? page.text, fields, ...(home !== undefined ? { home } : {}) });
+            pageWrites.push({
+                path: page.path,
+                text: preset?.text ?? page.text,
+                fields,
+                ...(home !== undefined ? { home } : {}),
+                ...(contact !== undefined ? { contact } : {}),
+            });
         }
     }
     let manifest = "no-roster";
@@ -303,10 +335,14 @@ export async function applyDesign(opts) {
         if (roster.path === SITE_ROSTER_PATH) {
             manifestNext = planSiteManifestDesign(readFileSync(rosterAbs, "utf8"), { design: resolved.recorded, layout: chrome, theme }, rosterAbs);
             // #7743 D6 — the `/` row records the home as written, in the same single write.
-            const home = pageWrites.find((page) => page.home !== undefined);
-            if (home !== undefined) {
+            // #8661 — and the `/contact` row the contact page.
+            for (const page of ["home", "contact"]) {
+                const written = pageWrites.find((write) => write[page] !== undefined);
+                if (written === undefined)
+                    continue;
                 manifestNext =
-                    planHomeRecord(manifestNext ?? readFileSync(rosterAbs, "utf8"), home.text, catalog()) ?? manifestNext;
+                    planHomeRecord(manifestNext ?? readFileSync(rosterAbs, "utf8"), written.text, catalog(), page) ??
+                        manifestNext;
             }
             manifest = manifestNext === undefined ? "unchanged" : "recorded";
         }
@@ -321,7 +357,9 @@ export async function applyDesign(opts) {
         const path = siteRelative(targetAbs, page.path);
         changes.push(page.home !== undefined
             ? { path, kind: "home", action: page.home, fields: page.fields }
-            : { path, kind: "preset", fields: page.fields });
+            : page.contact !== undefined
+                ? { path, kind: "contact", action: page.contact, fields: page.fields }
+                : { path, kind: "preset", fields: page.fields });
     }
     if (chromeNext !== chromeCurrent) {
         mkdirSync(dirname(chromePath), { recursive: true });
@@ -353,6 +391,8 @@ export async function applyDesign(opts) {
         manifest,
         home: homePlan.outcome,
         ...(homeArc ? { homeArc: true } : {}),
+        contact: contactPlan.outcome,
+        ...(contactSeeding.offered ? { contactSeed: true } : {}),
         ...(roster !== undefined ? { rosterPath: roster.path } : {}),
         ...(fontFamilies !== undefined ? { fonts: fontFamilies } : {}),
         ...(fontsUnwired ? { fontsUnwired: true } : {}),
@@ -370,16 +410,20 @@ export function formatApplyDesignReport(result) {
         for (const change of result.changes) {
             const suffix = change.kind === "preset"
                 ? ` (${change.fields.join(", ")})`
-                : change.kind === "home"
+                : change.kind === "home" || change.kind === "contact"
                     ? ` (${[change.action, change.fields.join(", ")].filter((part) => part !== "").join("; ")})`
                     : "";
             lines.push(`  ${change.kind.padEnd(8)}  ${change.path}${suffix}`);
         }
         const n = result.changes.length;
         const homeWritten = result.changes.some((change) => change.kind === "home");
+        const contactWritten = result.changes.some((change) => change.kind === "contact");
+        const contactNote = "the contact page's sections and title were replaced.";
         lines.push(`${n} file${n === 1 ? "" : "s"} changed. ${homeWritten
-            ? "Routes are unchanged; the home page's sections were replaced."
-            : "Routes and structured data are unchanged."}`);
+            ? `Routes are unchanged; the home page's sections were replaced.${contactWritten ? ` And ${contactNote}` : ""}`
+            : contactWritten
+                ? `Routes are unchanged; ${contactNote}`
+                : "Routes and structured data are unchanged."}`);
     }
     if (result.home === "authored" && result.homeArc === true) {
         lines.push(`home kept: ${HOME_PAGE_PATH} has authored sections — the ${result.design} home arc was not applied`);
@@ -387,6 +431,9 @@ export function formatApplyDesignReport(result) {
     else if (result.home === "no-shape" && result.homeArc === true) {
         lines.push("home not seeded: the site records no shape");
     }
+    if (result.contact === "authored" && result.contactSeed === true) {
+        lines.push(`contact kept: ${CONTACT_PAGE_PATH} has an authored title or sections — the ${result.design} contact page was not applied`);
+    }
     if (result.fonts !== undefined) {
         lines.push(`fonts: ${result.fonts.join(", ")} load at next build through next/font/google — a family that is not a variable Google font fails there`);
     }

package/dist/design-home.d.ts

@@ -2,7 +2,26 @@ import { type SectionLookCatalog } from "./design-presets.js";
 import type { ResolvedDesign } from "./design-scaffold.js";
 /** Where a site's home page lives, site-relative. */
 export declare const HOME_PAGE_PATH = "content/en/HomePage/home.mdx";
-/** One `home/<shape>.mdx` file of a design package (D1). */
+/** Where a site's contact page lives, site-relative (#8661 D11). */
+export declare 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 declare const DESIGN_SEED_PAGES: {
+    readonly home: {
+        readonly pageType: "HomePage";
+        readonly path: "content/en/HomePage/home.mdx";
+        readonly route: "/";
+    };
+    readonly contact: {
+        readonly pageType: "ContactPage";
+        readonly path: "content/en/ContactPage/contact.mdx";
+        readonly route: "/contact";
+    };
+};
+export type DesignSeedPage = keyof typeof DESIGN_SEED_PAGES;
+/** One `home/<shape>.mdx` (or `contact/<shape>.mdx`, #8661 D11) file of a design package (D1). */
 export interface HomeSeed {
     readonly shape: string;
     /** Absolute path, for refusals. */
@@ -11,34 +30,46 @@ export interface HomeSeed {
 }
 export type HomeSeedOutcome = "seeded" | "restored" | "unchanged" | "authored" | "no-shape" | "no-home";
 /**
- * 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 declare function readDesignHomeSeeds(dir: string, opts: {
     catalog: () => SectionLookCatalog;
+    page?: DesignSeedPage;
 }): HomeSeed[];
 /**
- * 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 declare function designHomeSeeds(resolved: ResolvedDesign, opts: {
     designsDir: string;
     catalog: () => SectionLookCatalog;
+    page?: DesignSeedPage;
 }): HomeSeed[];
 /** Every shipped design's seeds (D3's placeholder set reads them all). */
 export declare function shippedHomeSeeds(opts: {
     designsDir: string;
     catalog: () => SectionLookCatalog;
+    page?: DesignSeedPage;
 }): HomeSeed[];
-/** 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 declare function shapeHomePath(shape: string, opts: {
     siteTemplatesDir: string;
     templatesDir: string;
+    page?: DesignSeedPage;
 }): string;
+/**
+ * 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 declare function siteIdentityName(siteMdx: string | undefined): string | undefined;
 /**
  * A home's content fingerprint (D3): per section in order, its type and its
  * non-look `data` entries as `[key, normalized raw value]`, sorted by key.
@@ -55,9 +86,21 @@ export declare function applySeed(home: string, seed: HomeSeed, file?: string):
 /**
  * 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 declare function planDesignHome(opts: {
-    /** The site's content/en/HomePage/home.mdx, if any. */
+    /** The page planned (#8661 D11). Default `"home"`. */
+    page?: DesignSeedPage;
+    /** The site's name, for a contact seed's `{{SITE_NAME}}` (#8661 D11). */
+    siteName?: string | undefined;
+    /** The site's content/en/HomePage/home.mdx (or ContactPage/contact.mdx), if any. */
     current: string | undefined;
     /** The roster's template shape. */
     shape: string | undefined;

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/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