create-ailk 0.13.0 → 0.15.0

package/templates/apps/web/app/[locale]/whitepapers/__tests__/page-renderer-migration.test.tsx

@@ -62,9 +62,9 @@ describe("whitepapers/[slug] — snapshot regression", () => {
     });
     const { container } = render(element);
     expect(container.innerHTML).toMatchInlineSnapshot(`
-     "<script type="application/ld+json" data-testid="json-ld">{"@context":"https://schema.org","@graph":[{"@context":"https://schema.org","@type":"WebPage","inLanguage":"en","name":"AILK AEO Strategy 2026","description":"In-depth research on answer engine optimization for AILK products.","mainEntity":{"@context":"https://schema.org","@type":"Article","headline":"AILK AEO Strategy 2026","description":"In-depth research on answer engine optimization for AILK products."}},{"@context":"https://schema.org","@type":"BreadcrumbList","inLanguage":"en","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"http://localhost:3000/en/"},{"@type":"ListItem","position":2,"name":"Whitepapers","item":"http://localhost:3000/en/whitepapers"},{"@type":"ListItem","position":3,"name":"AILK AEO Strategy 2026","item":"http://localhost:3000/en/whitepapers/ailk-aeo-strategy-2026"}]}]}</script><main id="main"><h1>AILK AEO Strategy 2026</h1><p data-testid="whitepaper-description">In-depth research on answer engine optimization for AILK products.</p><div data-testid="markdown-view-toggle" class="ailk-markdown-view-toggle"><div class="flex justify-end mb-3"><div role="radiogroup" aria-label="Page view" data-testid="markdown-view-toggle" class="inline-flex items-center gap-0.5 rounded-lg p-1 bg-(--color-surface-secondary)"><button class="inline-flex items-center justify-center gap-2 font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 disabled:cursor-not-allowed disabled:opacity-50 [&amp;>svg]:shrink-0 text-(--color-fg) hover:bg-(--color-surface-secondary) active:bg-gray-200 rounded-control px-control-x h-(--control-height-thin) text-caption leading-none rounded-md px-3 text-body-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 min-w-(--control-height-thin) min-h-(--control-height-big) bg-(--color-bg) text-(--color-fg) shadow-sm" type="button" role="radio" aria-checked="true" aria-label="Rendered" tabindex="0" data-testid="markdown-view-toggle-rendered">Rendered</button><button class="inline-flex items-center justify-center gap-2 font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 disabled:cursor-not-allowed disabled:opacity-50 [&amp;>svg]:shrink-0 text-(--color-fg) hover:bg-(--color-surface-secondary) active:bg-gray-200 rounded-control px-control-x h-(--control-height-thin) text-caption leading-none rounded-md px-3 text-body-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 min-w-(--control-height-thin) min-h-(--control-height-big) text-(--color-text-muted) hover:text-(--color-fg)" type="button" role="radio" aria-checked="false" aria-label="Markdown" tabindex="-1" data-testid="markdown-view-toggle-markdown">Markdown</button></div></div><div role="status" aria-live="polite" aria-atomic="true" class="sr-only" data-testid="markdown-view-toggle-status">Showing Rendered view</div><div data-testid="markdown-view-rendered"><article data-testid="mdx-body"><div data-testid="mdx-rendered">## Executive Summary
+     "<script type="application/ld+json" data-testid="json-ld">{"@context":"https://schema.org","@graph":[{"@context":"https://schema.org","@type":"WebPage","inLanguage":"en","name":"AILK AEO Strategy 2026","description":"In-depth research on answer engine optimization for AILK products.","mainEntity":{"@context":"https://schema.org","@type":"Article","headline":"AILK AEO Strategy 2026","description":"In-depth research on answer engine optimization for AILK products."}},{"@context":"https://schema.org","@type":"BreadcrumbList","inLanguage":"en","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"http://localhost:3000/en/"},{"@type":"ListItem","position":2,"name":"Whitepapers","item":"http://localhost:3000/en/whitepapers"},{"@type":"ListItem","position":3,"name":"AILK AEO Strategy 2026","item":"http://localhost:3000/en/whitepapers/ailk-aeo-strategy-2026"}]}]}</script><main id="main"><div class="mx-auto w-full max-w-container-xl px-4 md:px-6 lg:px-8 py-section"><h1 class="text-heading-1 lg:text-display-sm font-display text-fg hero-type-display">AILK AEO Strategy 2026</h1><p data-testid="whitepaper-description" class="mt-block-tight text-lead">In-depth research on answer engine optimization for AILK products.</p><div data-testid="markdown-view-toggle" class="ailk-markdown-view-toggle mt-block-loose"><div class="flex justify-end mb-3"><div role="radiogroup" aria-label="Page view" data-testid="markdown-view-toggle" class="inline-flex items-center gap-0.5 rounded-lg p-1 bg-(--color-surface-secondary)"><button class="inline-flex items-center justify-center gap-2 font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 disabled:cursor-not-allowed disabled:opacity-50 [&amp;>svg]:shrink-0 text-(--color-fg) hover:bg-(--color-surface-secondary) active:bg-gray-200 rounded-control px-control-x h-(--control-height-thin) text-caption leading-none rounded-md px-3 text-body-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 min-w-(--control-height-thin) min-h-(--control-height-big) bg-(--color-bg) text-(--color-fg) shadow-sm" type="button" role="radio" aria-checked="true" aria-label="Rendered" tabindex="0" data-testid="markdown-view-toggle-rendered">Rendered</button><button class="inline-flex items-center justify-center gap-2 font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 disabled:cursor-not-allowed disabled:opacity-50 [&amp;>svg]:shrink-0 text-(--color-fg) hover:bg-(--color-surface-secondary) active:bg-gray-200 rounded-control px-control-x h-(--control-height-thin) text-caption leading-none rounded-md px-3 text-body-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 min-w-(--control-height-thin) min-h-(--control-height-big) text-(--color-text-muted) hover:text-(--color-fg)" type="button" role="radio" aria-checked="false" aria-label="Markdown" tabindex="-1" data-testid="markdown-view-toggle-markdown">Markdown</button></div></div><div role="status" aria-live="polite" aria-atomic="true" class="sr-only" data-testid="markdown-view-toggle-status">Showing Rendered view</div><div data-testid="markdown-view-rendered"><article data-testid="mdx-body"><div class="ailk-prose max-w-none text-(--color-fg) text-body-sm leading-relaxed [&amp;>*:first-child]:mt-0 [&amp;_h2]:mt-block-loose [&amp;_h2]:scroll-mt-24 [&amp;_h2]:text-heading-3 [&amp;_h2]:font-display [&amp;_h2]:text-(--color-fg) [&amp;_h3]:mt-block-loose [&amp;_h3]:scroll-mt-24 [&amp;_h3]:text-heading-4 [&amp;_h3]:font-display [&amp;_h3]:text-(--color-fg) [&amp;_h4]:mt-block-tight [&amp;_h4]:scroll-mt-24 [&amp;_h4]:text-heading-4 [&amp;_h4]:font-display [&amp;_h4]:text-(--color-fg) [&amp;_h5]:mt-block-tight [&amp;_h5]:scroll-mt-24 [&amp;_h5]:text-heading-4 [&amp;_h5]:font-display [&amp;_h5]:text-(--color-fg) [&amp;_h6]:mt-block-tight [&amp;_h6]:scroll-mt-24 [&amp;_h6]:text-heading-4 [&amp;_h6]:font-display [&amp;_h6]:text-(--color-fg) [&amp;_p]:mt-paragraph [&amp;_strong]:font-semibold [&amp;_strong]:text-(--color-fg) [&amp;_em]:italic [&amp;_ul]:mt-paragraph [&amp;_ul]:list-disc [&amp;_ul]:ps-6 [&amp;_ol]:mt-paragraph [&amp;_ol]:list-decimal [&amp;_ol]:ps-6 [&amp;_li]:mt-1 [&amp;_li]:ps-1 [&amp;_li]:marker:text-(--color-text-muted) [&amp;_li>ul]:mt-1 [&amp;_li>ol]:mt-1 [&amp;_blockquote]:mt-paragraph [&amp;_blockquote]:border-s-4 [&amp;_blockquote]:border-(--color-border-strong) [&amp;_blockquote]:ps-4 [&amp;_blockquote]:italic [&amp;_blockquote]:text-(--color-text-muted) [&amp;_hr]:my-block-loose [&amp;_hr]:border-(--color-border) [&amp;_a]:text-(--color-accent) [&amp;_a]:underline [&amp;_a]:underline-offset-4 [&amp;_:not(pre)>code]:rounded [&amp;_:not(pre)>code]:bg-(--color-surface-secondary) [&amp;_:not(pre)>code]:px-1.5 [&amp;_:not(pre)>code]:py-0.5 [&amp;_:not(pre)>code]:text-code [&amp;_:not(pre)>code]:font-mono [&amp;_:not(pre)>code]:text-(--color-fg) [&amp;_pre]:mt-paragraph [&amp;_pre]:overflow-auto [&amp;_pre]:rounded-md [&amp;_pre]:border-hairline [&amp;_pre]:border-(--color-border) [&amp;_pre]:bg-(--color-bg) [&amp;_pre]:p-4 [&amp;_pre]:font-mono [&amp;_pre]:text-body-sm [&amp;_img]:mt-paragraph [&amp;_img]:h-auto [&amp;_img]:max-w-full [&amp;_img]:rounded-lg [&amp;_table]:mt-paragraph [&amp;_table]:w-full [&amp;_table]:border-collapse [&amp;_table]:text-body-sm [&amp;_th]:border-b [&amp;_th]:border-(--color-border) [&amp;_th]:bg-(--color-surface-secondary) [&amp;_th]:px-3 [&amp;_th]:py-2 [&amp;_th]:text-start [&amp;_th]:font-semibold [&amp;_th]:text-(--color-fg) [&amp;_td]:border-b [&amp;_td]:border-(--color-border) [&amp;_td]:px-3 [&amp;_td]:py-2 [&amp;_kbd]:rounded [&amp;_kbd]:border-hairline [&amp;_kbd]:border-(--color-border) [&amp;_kbd]:bg-(--color-surface-secondary) [&amp;_kbd]:px-1.5 [&amp;_kbd]:py-0.5 [&amp;_kbd]:text-caption [&amp;_kbd]:font-mono" data-testid="mdx-content"><div data-testid="mdx-rendered">## Executive Summary
 
-     Body content.</div></article></div></div></main>"
+     Body content.</div></div></article></div></div></div></main>"
     `);
   });
 

package/templates/apps/web/app/not-found.tsx

@@ -6,12 +6,59 @@
 // app/[locale]/layout.tsx — the only other importer of globals.css — so it
 // imports the stylesheet itself; without it the primitives' token classes
 // would render unstyled here (#6514).
+//
+// Under `chromeStyle: minimal` (#7742 D6) every 404 renders in the site's
+// theme instead: its own <html> and <body> (the documented pattern for a root
+// not-found under a pass-through root layout), the theme variables and font
+// class the locale layout emits (`siteThemeHead`), the site's mark, one
+// statement and a back link. `data-theme` is fixed at light — the one mode a
+// `colorMode: light` site has. Without the knob it renders today's markup.
 import "./globals.css";
 
+import { BrandLogo } from "@working-theory/ui/blocks";
 import { Heading, Link, Text } from "@working-theory/ui/primitives";
 import type { ReactElement } from "react";
 
+import { SITE_NAME } from "../lib/site-brand";
+import { siteChrome, type SiteChrome } from "../lib/site-chrome";
+import { siteLogo } from "../lib/site-logo";
+import { siteThemeHead } from "../lib/site-theme-head";
+
+/** Widened as the locale layout reads it: an older generated file has no `chromeStyle`. */
+const chrome: SiteChrome & { chromeStyle?: "minimal" } = siteChrome;
+
+function ThemedNotFound(): ReactElement {
+  const head = siteThemeHead();
+  return (
+    <html lang="en" data-theme="light" className={head.fontClassName}>
+      <head>
+        <style data-ailk="theme-vars" dangerouslySetInnerHTML={{ __html: head.css }} />
+      </head>
+      <body>
+        <main
+          data-testid="not-found"
+          className="flex min-h-screen flex-col items-center justify-center gap-block-loose bg-(--color-bg) p-card text-(--color-fg)"
+        >
+          <BrandLogo
+            locale="en"
+            siteName={SITE_NAME}
+            name={SITE_NAME}
+            href="/"
+            composition="logomark"
+            mark={siteLogo()}
+          />
+          <Heading level={1}>Page not found</Heading>
+          <Link href="/" data-testid="not-found-back">
+            Back to home
+          </Link>
+        </main>
+      </body>
+    </html>
+  );
+}
+
 export default function NotFound(): ReactElement {
+  if (chrome.chromeStyle === "minimal") return <ThemedNotFound />;
   return (
     <main className="flex min-h-screen flex-col items-center justify-center gap-4 bg-(--color-bg) p-card text-(--color-fg)">
       <Heading level={1} visual={3}>

package/templates/apps/web/app/openapi.json/__tests__/route.test.ts

@@ -15,13 +15,29 @@
 
 import { GET } from "../route";
 
+// The generated topology seam (#7426 D5), mocked so each case picks its
+// topology: the hub cases below run against `"hub"`, exactly as before; the
+// spoke cases (D12) flip it. Mocked rather than imported because the hub
+// render imports `../auth`, which this route never touches.
+const mockTopology: { value: "hub" | "spoke" } = { value: "hub" };
+// eslint-disable-next-line no-restricted-syntax -- #507: the topology is a generated constant (#7426 D5), not a runtime input; the seam IS the boundary between a hub and a spoke build, and there is no env or HTTP surface that selects it.
+jest.mock("../../../lib/topology.generated", () => ({
+  get TOPOLOGY() {
+    return mockTopology.value;
+  },
+}));
+
 const SPEC = {
   openapi: "3.1.0",
   info: { title: "Example API", version: "1.0.0" },
   paths: { "/v1/content/search": {} },
 };
 
-const API_ENV = ["AILK_API_URL", "NEXT_PUBLIC_AILK_API_URL"] as const;
+const API_ENV = [
+  "AILK_API_URL",
+  "NEXT_PUBLIC_AILK_API_URL",
+  "NEXT_PUBLIC_BASE_URL",
+] as const;
 const saved: Record<string, string | undefined> = {};
 let fetchSpy: jest.SpyInstance;
 
@@ -34,6 +50,7 @@ beforeEach(() => {
 });
 
 afterEach(() => {
+  mockTopology.value = "hub";
   for (const name of API_ENV) {
     if (saved[name] === undefined) delete process.env[name];
     else process.env[name] = saved[name];
@@ -174,3 +191,74 @@ describe("GET /openapi.json", () => {
     expect(await response.text()).not.toContain("api.internal");
   });
 });
+
+describe("GET /openapi.json on a spoke (#7426 D12)", () => {
+  const HUB_SPEC = {
+    openapi: "3.1.0",
+    info: { title: "Hub API", version: "1.0.0" },
+    servers: [{ url: "https://hub.example.com", description: "The hub" }],
+    paths: {
+      "/v1/leads/submit": {
+        post: { summary: "Submit a lead" },
+        get: { summary: "Not relayed" },
+      },
+      "/v1/schedule/availability": {
+        get: {
+          summary: "Availability",
+          servers: [{ url: "https://hub.example.com/schedule" }],
+        },
+      },
+      "/v1/content/search": { get: { summary: "Hub-only search" } },
+      "/v1/admin/sites": { post: { summary: "Hub-only admin" } },
+    },
+  };
+
+  beforeEach(() => {
+    mockTopology.value = "spoke";
+    process.env["AILK_API_URL"] = "https://hub.example.com";
+    process.env["NEXT_PUBLIC_BASE_URL"] = "https://spoke.example.com";
+  });
+
+  it("names only this spoke's own origin in servers[]", async () => {
+    apiAnswers(200, JSON.stringify(HUB_SPEC));
+
+    const response = await GET();
+    const body = (await response.json()) as { servers: unknown };
+
+    expect(response.status).toBe(200);
+    expect(body.servers).toEqual([{ url: "https://spoke.example.com" }]);
+    expect(JSON.stringify(body)).not.toContain("hub.example.com");
+  });
+
+  it("keeps only the paths and methods the relay forwards", async () => {
+    apiAnswers(200, JSON.stringify(HUB_SPEC));
+
+    const body = (await (await GET()).json()) as {
+      paths: Record<string, Record<string, unknown>>;
+    };
+
+    expect(body.paths).toEqual({
+      "/v1/leads/submit": { post: { summary: "Submit a lead" } },
+      "/v1/schedule/availability": { get: { summary: "Availability" } },
+    });
+  });
+
+  it("still reads the hub's document at AILK_API_URL", async () => {
+    apiAnswers(200, JSON.stringify(HUB_SPEC));
+
+    await GET();
+
+    expect(requestedUrl()).toBe("https://hub.example.com/v1/openapi.json");
+  });
+
+  it("on a hub, leaves servers[] and paths as the API declared them", async () => {
+    mockTopology.value = "hub";
+    apiAnswers(200, JSON.stringify(HUB_SPEC));
+
+    const body = (await (await GET()).json()) as typeof HUB_SPEC;
+
+    expect(body.servers).toEqual(HUB_SPEC.servers);
+    expect(body.paths).toEqual(HUB_SPEC.paths);
+    expect(JSON.stringify(body)).toContain("hub.example.com");
+  });
+});

package/templates/apps/web/app/openapi.json/route.ts

@@ -15,8 +15,18 @@
  * When the API cannot be reached, or answers anything but an OpenAPI
  * document with a 200, this route answers 502 with a JSON error that names no
  * upstream origin, and is never cached.
+ *
+ * On a spoke (#7426 D12) the API is the hub's, so the document is rewritten
+ * to describe THIS host only: `servers[]` becomes this site's own origin, and
+ * `paths` keeps only the (path, method) pairs the same-origin relay forwards
+ * (`RELAY_ROUTES`, lib/relay.ts) — an agent reading it never learns the hub's
+ * host, and never calls a path this site would answer 404.
  */
 
+import { RELAY_ROUTES } from "../../lib/relay";
+import { TOPOLOGY } from "../../lib/topology.generated";
+import { resolveBaseUrl } from "../../src/lib/routes";
+
 // Read per request: the document is the running API's, and `next build` has
 // no API to read it from.
 export const dynamic = "force-dynamic";
@@ -58,6 +68,7 @@ function stripSlash(url: string): string {
 interface OpenApiDocument {
   openapi: string;
   servers?: Array<{ url?: unknown; description?: unknown }>;
+  paths?: Record<string, unknown>;
 }
 
 function isOpenApiDocument(value: unknown): value is OpenApiDocument {
@@ -86,6 +97,61 @@ function withAbsoluteServers(spec: OpenApiDocument): OpenApiDocument {
   };
 }
 
+/** The operation keys an OpenAPI path item may carry (OpenAPI 3.1 § 4.8.9). */
+const OPERATION_KEYS = new Set([
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace",
+]);
+
+/**
+ * The document as a spoke serves it (#7426 D12): this host's own origin as
+ * the only server, and only the relayed (path, method) pairs. A path item's
+ * non-operation keys (`summary`, `parameters`, ...) ride along with a kept
+ * operation; a `servers` list — on the path item or on a kept operation —
+ * never does: it would name the hub.
+ */
+function withoutServers(operation: unknown): unknown {
+  if (typeof operation !== "object" || operation === null) return operation;
+  const { servers: _servers, ...rest } = operation as Record<string, unknown>;
+  return rest;
+}
+
+function asSpokeDocument(spec: OpenApiDocument): OpenApiDocument {
+  const relayed = new Map<string, Set<string>>();
+  for (const { method, path } of RELAY_ROUTES) {
+    const methods = relayed.get(path) ?? new Set<string>();
+    methods.add(method.toLowerCase());
+    relayed.set(path, methods);
+  }
+  const paths: Record<string, unknown> = {};
+  for (const [path, item] of Object.entries(spec.paths ?? {})) {
+    const methods = relayed.get(path);
+    if (methods === undefined || typeof item !== "object" || item === null) {
+      continue;
+    }
+    const kept = Object.fromEntries(
+      Object.entries(item)
+        .filter(([key]) =>
+          OPERATION_KEYS.has(key) ? methods.has(key) : key !== "servers",
+        )
+        .map(([key, value]) => [
+          key,
+          OPERATION_KEYS.has(key) ? withoutServers(value) : value,
+        ]),
+    );
+    if (Object.keys(kept).some((key) => OPERATION_KEYS.has(key))) {
+      paths[path] = kept;
+    }
+  }
+  return { ...spec, servers: [{ url: stripSlash(resolveBaseUrl()) }], paths };
+}
+
 function badGateway(message: string): Response {
   return Response.json(
     { error: { code: "upstream_unavailable", message } },
@@ -120,7 +186,9 @@ export async function GET(): Promise<Response> {
     return badGateway("The API answered JSON that is not an OpenAPI document.");
   }
 
-  return Response.json(withAbsoluteServers(spec), {
+  const served =
+    TOPOLOGY === "spoke" ? asSpokeDocument(spec) : withAbsoluteServers(spec);
+  return Response.json(served, {
     status: 200,
     headers: { "cache-control": "public, max-age=3600" },
   });

package/templates/apps/web/instrumentation.ts

@@ -2,13 +2,16 @@
  * Next.js instrumentation hook — runs once per server instance at boot.
  *
  * Registers the durable home of a renewed licence key (#6677 DD-6) before any
- * request resolves the licence. Node runtime only: the store reaches the
- * database through Prisma, which the Edge runtime cannot load.
+ * request resolves the licence, through the generated topology seam (#7426
+ * D5): a hub registers the database-backed store; a spoke has no database,
+ * so its render registers nothing. Node runtime only: the store reaches the
+ * database through Prisma, which the Edge runtime cannot load — the import
+ * stays inside the runtime check so the Edge bundle never carries it.
  */
 
 export async function register(): Promise<void> {
   if (process.env.NEXT_RUNTIME === "nodejs") {
-    const { registerLicenseKeyStore } = await import("./lib/license-key-store");
-    await registerLicenseKeyStore();
+    const { registerSiteStores } = await import("./lib/topology.generated");
+    await registerSiteStores();
   }
 }

package/templates/apps/web/lib/__tests__/closing-footer-path.test.ts

@@ -0,0 +1,96 @@
+import {
+  isClosingFooterPath,
+  normalizeRoutePath,
+} from "../closing-footer-path";
+
+const LOCALES = ["en", "es"];
+
+describe("normalizeRoutePath (#7797)", () => {
+  it.each([
+    ["/about", "/about"],
+    ["/about/", "/about"],
+    ["/about//", "/about"],
+    ["/es/about", "/about"],
+    ["/es/about/", "/about"],
+    ["/about?x=1", "/about"],
+    ["/about#team", "/about"],
+    ["/services/first-engagement/", "/services/first-engagement"],
+    ["/", "/"],
+    ["", "/"],
+    ["/es", "/"],
+    ["/es/", "/"],
+  ])("%s → %s", (input, expected) => {
+    expect(normalizeRoutePath(input, LOCALES)).toBe(expected);
+  });
+
+  it("strips only a whole leading locale segment", () => {
+    expect(normalizeRoutePath("/espresso", LOCALES)).toBe("/espresso");
+    expect(normalizeRoutePath("/about/es", LOCALES)).toBe("/about/es");
+  });
+
+  it("strips no prefix when no locale is enabled", () => {
+    expect(normalizeRoutePath("/es/about", [])).toBe("/es/about");
+  });
+});
+
+describe("isClosingFooterPath (#7797)", () => {
+  const paths = ["/about", "/services/first-engagement/"];
+
+  it.each([
+    "/about",
+    "/about/",
+    "/es/about",
+    "/es/about/",
+    "/services/first-engagement",
+  ])("%s is a listed page", (pathname) => {
+    expect(isClosingFooterPath({ pathname, paths, locales: LOCALES })).toBe(
+      true,
+    );
+  });
+
+  it.each(["/services", "/about/team", "/aboutus", "/privacy", "/es/contact"])(
+    "%s is not a listed page",
+    (pathname) => {
+      expect(isClosingFooterPath({ pathname, paths, locales: LOCALES })).toBe(
+        false,
+      );
+    },
+  );
+
+  it("matches a listed path spelled with a locale prefix or a trailing slash", () => {
+    expect(
+      isClosingFooterPath({
+        pathname: "/about",
+        paths: ["/es/about/"],
+        locales: LOCALES,
+      }),
+    ).toBe(true);
+  });
+
+  it("is false with no list, an empty list, or no pathname", () => {
+    expect(
+      isClosingFooterPath({
+        pathname: "/about",
+        paths: undefined,
+        locales: LOCALES,
+      }),
+    ).toBe(false);
+    expect(
+      isClosingFooterPath({ pathname: "/about", paths: [], locales: LOCALES }),
+    ).toBe(false);
+    expect(
+      isClosingFooterPath({ pathname: null, paths, locales: LOCALES }),
+    ).toBe(false);
+    expect(isClosingFooterPath({ pathname: "", paths, locales: LOCALES })).toBe(
+      false,
+    );
+  });
+
+  it("never selects the home, even when it is listed", () => {
+    for (const pathname of ["/", "/es", "/es/"]) {
+      expect(
+        isClosingFooterPath({ pathname, paths: ["/"], locales: LOCALES }),
+      ).toBe(false);
+    }
+  });
+});

package/templates/apps/web/lib/__tests__/profile-back-link.test.ts

@@ -0,0 +1,95 @@
+/**
+ * Tests for the profile back-link rule (#7744 D7).
+ *
+ * On a deck home, a team profile's back arrow returns to the home's people
+ * slide (`#slide-people`, #7740's anchor for the section id `people`);
+ * everywhere else it goes home. Covers bare and locale-prefixed profiles, the
+ * `/team` index, near misses, a non-deck home and the absent-header fail-safe.
+ */
+
+import {
+  backLinkHref,
+  isTeamProfilePath,
+  PEOPLE_SLIDE_ANCHOR,
+} from "../profile-back-link";
+
+const LOCALES = ["en", "fr"];
+
+describe("isTeamProfilePath", () => {
+  it.each(["/team/first-member", "/fr/team/first-member", "/en/team/a"])(
+    "is true for the profile path %s",
+    (pathname) => {
+      expect(isTeamProfilePath(pathname, LOCALES)).toBe(true);
+    },
+  );
+
+  it.each([
+    "/team",
+    "/team/",
+    "/fr/team",
+    "/team/a/b",
+    "/teams/x",
+    "/about",
+    "/",
+    "",
+  ])("is false for %s", (pathname) => {
+    expect(isTeamProfilePath(pathname, LOCALES)).toBe(false);
+  });
+
+  it("treats a prefix that is not an enabled locale as the first segment", () => {
+    expect(isTeamProfilePath("/xx/team/a", ["en"])).toBe(false);
+  });
+
+  it("answers false for an absent pathname", () => {
+    expect(isTeamProfilePath(null, LOCALES)).toBe(false);
+    expect(isTeamProfilePath(undefined, LOCALES)).toBe(false);
+  });
+});
+
+describe("backLinkHref", () => {
+  it("names the people-slide anchor", () => {
+    expect(PEOPLE_SLIDE_ANCHOR).toBe("slide-people");
+  });
+
+  it("returns /#slide-people for a profile on a deck home", () => {
+    expect(
+      backLinkHref({
+        pathname: "/team/first-member",
+        homePath: "/",
+        home: "deck",
+        locales: LOCALES,
+      }),
+    ).toBe("/#slide-people");
+  });
+
+  it("keeps the /fr prefix on a non-default locale", () => {
+    expect(
+      backLinkHref({
+        pathname: "/fr/team/first-member",
+        homePath: "/fr",
+        home: "deck",
+        locales: LOCALES,
+      }),
+    ).toBe("/fr#slide-people");
+  });
+
+  it.each(["/team", "/team/a/b", "/about", "/teams/x", null, undefined])(
+    "returns the home for %s on a deck home",
+    (pathname) => {
+      expect(
+        backLinkHref({ pathname, homePath: "/", home: "deck", locales: LOCALES }),
+      ).toBe("/");
+    },
+  );
+
+  it("returns the home for a profile when the home is not a deck", () => {
+    expect(
+      backLinkHref({
+        pathname: "/team/first-member",
+        homePath: "/",
+        home: "default",
+        locales: LOCALES,
+      }),
+    ).toBe("/");
+  });
+});