create-ailk 0.13.0 → 0.14.0

package/README.md

@@ -118,10 +118,18 @@ It changes how the site **looks**, never what it **is**. It writes only:
 - the `design`, `layout` and `theme` record in `.ailk-site-manifest.json`.
 
 It never adds, removes or renames a route or page, never touches a content
-field, and leaves every page's structured data unchanged. It prints the files
-it changed; running it again changes nothing. A site whose roster is the older
-root `TEMPLATE-MANIFEST.json` gets the look but no record, and the report says
-so.
+field (except a placeholder home's sections, below), and leaves every other
+page's structured data unchanged. It prints the files it changed; running it
+again changes nothing. A site whose roster is the older root
+`TEMPLATE-MANIFEST.json` gets the look but no record, and the report says so.
+
+A design may also seed the home's sections — its home arc, one placeholder
+home per shape (minimalism ships them) — while they are still a placeholder
+home: the shape's own sections, or a design's arc of them. It never changes a
+home whose sections were edited; it reports the home as kept and leaves it
+byte-for-byte. A seeded home takes the design's looks; look values on the
+sections it replaced are not kept. A design with no arc restores the shape's
+own sections on a home that still wears another design's untouched arc.
 
 A design other than `standard` needs a Pro or Pro Plus key. The key is read
 from the site's own `ailk.key` (put one there with

package/component-catalog.json

@@ -17,7 +17,7 @@
       "importPath": "@working-theory/ui/blocks",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/blocks",
-      "count": 99
+      "count": 101
     },
     {
       "name": "chrome",
@@ -49,7 +49,7 @@
       "importPath": "@working-theory/templates/shells",
       "rootBarrel": "@working-theory/templates",
       "sourceRoot": "packages/templates/src/shells",
-      "count": 6
+      "count": 8
     },
     {
       "name": "docs-blog-blocks",
@@ -1068,6 +1068,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "DisplayList",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/DisplayList.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "Centred display-size rows of short labels, each optionally a link, with no rules, cards or dividers between them — the bondcap.com \"what we offer\" list and its report archive grid.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "DistributionList",
       "tier": "blocks",
@@ -1618,6 +1629,17 @@
       "descriptionGrade": "weak",
       "sectionType": null
     },
+    {
+      "name": "SlideAdvance",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/SlideAdvance.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "The deck's slide-advance control. One ghost Button holding a hairline chevron: a down chevron moves to the next slide, an up chevron to the first. A native button, so a click, Enter and Space all fire the same move, and nothing else listens: no wheel, touch, scroll or key handler is added, so native scroll-snap still settles every user scroll (the argument against a scroll-hijacking deck).",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "SocialIcons",
       "tier": "blocks",
@@ -3004,6 +3026,28 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "DeckPresentation",
+      "tier": "shells",
+      "sourcePath": "packages/templates/src/shells/DeckPresentation.tsx",
+      "importPath": "@working-theory/templates/shells",
+      "exported": false,
+      "description": "Internal client island for MarketingShell's `presentation` option. Not exported from the shells barrel (`./index.ts`) — MarketingShell renders it internally under `snap=\"mandatory\"` with `presentation`, beside DeckHeroObserver, whose idiom it follows: a zero-size anchor, no React state, and every write made through the DOM after hydration.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
+    {
+      "name": "DeckSlideAdvance",
+      "tier": "shells",
+      "sourcePath": "packages/templates/src/shells/DeckSlideAdvance.tsx",
+      "importPath": "@working-theory/templates/shells",
+      "exported": false,
+      "description": "Internal client island that puts one working slide-advance button at the foot of every slide of MarketingShell's scroll-snap deck: down to the next slide, and up from the last slide back to the first.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "MarketingShell",
       "tier": "shells",
@@ -3571,7 +3615,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "quickSearch": {
@@ -4641,6 +4686,9 @@
               },
               "blurDataURL": {
                 "type": "string"
+              },
+              "darkSrc": {
+                "type": "string"
               }
             },
             "required": [
@@ -4908,7 +4956,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "headlineSize": {
@@ -4975,6 +5024,25 @@
                 "href"
               ]
             }
+          },
+          "align": {
+            "type": "string",
+            "enum": [
+              "start",
+              "center"
+            ]
+          },
+          "phoneColumns": {
+            "anyOf": [
+              {
+                "type": "number",
+                "const": 1
+              },
+              {
+                "type": "number",
+                "const": 2
+              }
+            ]
           }
         },
         "required": [
@@ -4992,7 +5060,9 @@
         "headlineSize",
         "numbered",
         "numberTone",
-        "itemTitleSize"
+        "itemTitleSize",
+        "align",
+        "phoneColumns"
       ]
     },
     {
@@ -5010,7 +5080,8 @@
               "branded",
               "minimal",
               "tile",
-              "tiles"
+              "tiles",
+              "list"
             ]
           },
           "tileHover": {
@@ -5177,7 +5248,15 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
+            ]
+          },
+          "itemStyle": {
+            "type": "string",
+            "enum": [
+              "card",
+              "plain"
             ]
           }
         },
@@ -5193,7 +5272,8 @@
         "columns",
         "separation",
         "gap",
-        "surface"
+        "surface",
+        "itemStyle"
       ]
     },
     {
@@ -5214,7 +5294,9 @@
               "wide",
               "narrow",
               "media-left",
-              "media-right"
+              "media-right",
+              "statement",
+              "profile"
             ]
           },
           "headline": {
@@ -5381,7 +5463,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "align": {
@@ -5391,12 +5474,27 @@
               "center"
             ]
           },
+          "alignMobile": {
+            "type": "string",
+            "enum": [
+              "start",
+              "center"
+            ]
+          },
           "fill": {
             "type": "string",
             "enum": [
               "natural",
               "viewport"
             ]
+          },
+          "actionStyle": {
+            "type": "string",
+            "enum": [
+              "buttons",
+              "one-button",
+              "links"
+            ]
           }
         }
       },
@@ -5408,7 +5506,9 @@
         "glow",
         "surface",
         "align",
-        "fill"
+        "alignMobile",
+        "fill",
+        "actionStyle"
       ]
     },
     {
@@ -5541,7 +5641,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "headlineSize": {
@@ -5741,7 +5842,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "headlineSize": {
@@ -5752,6 +5854,13 @@
               "display",
               "heading-3"
             ]
+          },
+          "align": {
+            "type": "string",
+            "enum": [
+              "start",
+              "center"
+            ]
           }
         }
       },
@@ -5766,7 +5875,8 @@
         "answerSize",
         "dividerTone",
         "surface",
-        "headlineSize"
+        "headlineSize",
+        "align"
       ]
     },
     {
@@ -6100,7 +6210,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "headlineSize": {
@@ -6111,6 +6222,13 @@
               "display",
               "heading-3"
             ]
+          },
+          "align": {
+            "type": "string",
+            "enum": [
+              "start",
+              "center"
+            ]
           }
         },
         "required": [
@@ -6126,7 +6244,8 @@
         "separation",
         "gap",
         "surface",
-        "headlineSize"
+        "headlineSize",
+        "align"
       ]
     },
     {
@@ -6244,7 +6363,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           }
         },
@@ -6902,7 +7022,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "keyPointsPanel": {
@@ -7135,7 +7256,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "chips": {
@@ -7157,6 +7279,21 @@
           },
           "imagerySlot": {
             "type": "boolean"
+          },
+          "align": {
+            "type": "string",
+            "enum": [
+              "start",
+              "center"
+            ]
+          },
+          "actionStyle": {
+            "type": "string",
+            "enum": [
+              "buttons",
+              "one-button",
+              "links"
+            ]
           }
         },
         "required": [
@@ -7167,7 +7304,9 @@
       "schemaError": null,
       "look": [
         "variant",
-        "surface"
+        "surface",
+        "align",
+        "actionStyle"
       ]
     },
     {
@@ -7231,7 +7370,8 @@
             "type": "string",
             "enum": [
               "color",
-              "monochrome"
+              "monochrome",
+              "silhouette"
             ]
           },
           "logoSize": {
@@ -7249,7 +7389,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "actions": {
@@ -7292,6 +7433,57 @@
                 "href"
               ]
             }
+          },
+          "columns": {
+            "anyOf": [
+              {
+                "type": "number",
+                "const": 3
+              },
+              {
+                "type": "number",
+                "const": 4
+              },
+              {
+                "type": "number",
+                "const": 5
+              },
+              {
+                "type": "number",
+                "const": 6
+              }
+            ]
+          },
+          "phoneColumns": {
+            "anyOf": [
+              {
+                "type": "number",
+                "const": 1
+              },
+              {
+                "type": "number",
+                "const": 2
+              },
+              {
+                "type": "number",
+                "const": 3
+              }
+            ]
+          },
+          "motion": {
+            "type": "string",
+            "enum": [
+              "static",
+              "scroll"
+            ]
+          },
+          "actionStyle": {
+            "type": "string",
+            "enum": [
+              "buttons",
+              "one-button",
+              "links"
+            ]
           }
         },
         "required": [
@@ -7304,7 +7496,11 @@
         "layout",
         "treatment",
         "logoSize",
-        "surface"
+        "surface",
+        "columns",
+        "phoneColumns",
+        "motion",
+        "actionStyle"
       ]
     },
     {
@@ -7593,7 +7789,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           }
         },
@@ -8616,7 +8813,8 @@
             "enum": [
               "with-small-images",
               "with-large-images",
-              "with-side-images"
+              "with-side-images",
+              "with-portraits"
             ]
           },
           "avatarSize": {
@@ -8681,7 +8879,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "actions": {
@@ -8724,6 +8923,14 @@
                 "href"
               ]
             }
+          },
+          "actionStyle": {
+            "type": "string",
+            "enum": [
+              "buttons",
+              "one-button",
+              "links"
+            ]
           }
         },
         "required": [
@@ -8741,7 +8948,8 @@
         "separation",
         "gap",
         "phoneColumns",
-        "surface"
+        "surface",
+        "actionStyle"
       ]
     },
     {
@@ -9313,7 +9521,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "successRedirect": {
@@ -10288,7 +10497,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           },
           "provider": {
@@ -10711,7 +10921,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           }
         },
@@ -11148,7 +11359,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           }
         },
@@ -11224,7 +11436,8 @@
             "type": "string",
             "enum": [
               "cards",
-              "list"
+              "list",
+              "archive"
             ]
           },
           "tone": {
@@ -11293,7 +11506,8 @@
               "wash",
               "wash-secondary",
               "gradient-brand",
-              "gradient-dark"
+              "gradient-dark",
+              "solid-dark"
             ]
           }
         },

package/component-catalog.md

@@ -15,13 +15,13 @@ The component inventory of `@working-theory/ui` and the shells of `@working-theo
 3. Check the Primitives, Panels and Shells tables too — a low-level control, a collapsible layout container, or a route-level frame lives there, not under Sections or Blocks.
 4. Only then build. If you do build, you are declaring the capability is genuinely absent.
 
-Inventory: **307 component files** across 16 tiers — 55 sections, 99 blocks, 18 chrome, 79 primitives, 6 panels, 6 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 5 scheduling-blocks, 5 signal-collectors-sections, 9 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 304 distinct names: `SchedulerEmbed`, `Separator`, `Tabs` exist in more than one tier as genuinely different components, listed once per tier with its own source path.
+Inventory: **311 component files** across 16 tiers — 55 sections, 101 blocks, 18 chrome, 79 primitives, 6 panels, 8 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 5 scheduling-blocks, 5 signal-collectors-sections, 9 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 308 distinct names: `SchedulerEmbed`, `Separator`, `Tabs` exist in more than one tier as genuinely different components, listed once per tier with its own source path.
 
-Description coverage: **303/307** components carry a capability description derived from source — 44 from the section registry's hand-authored when-to-use text, 228 from the component's own doc-comment header, 31 from its tier barrel's roster line. **4** have none; they are listed under [Undescribed components](#undescribed-components) rather than given a sentence invented from their name.
+Description coverage: **307/311** components carry a capability description derived from source — 44 from the section registry's hand-authored when-to-use text, 232 from the component's own doc-comment header, 31 from its tier barrel's roster line. **4** have none; they are listed under [Undescribed components](#undescribed-components) rather than given a sentence invented from their name.
 
-Of those, **272** are *strong* — a capability sentence you could match a requirement against — and **31** are *weak*: either one short clause, or a long one that spends itself on wiring (client boundaries, class names, which primitives it composes) instead of on what the thing is for. Weak rows are marked `(weak)` and listed in full under [Weak descriptions](#weak-descriptions). Coverage is 99%, but **findable-without-luck coverage is 89%**.
+Of those, **276** are *strong* — a capability sentence you could match a requirement against — and **31** are *weak*: either one short clause, or a long one that spends itself on wiring (client boundaries, class names, which primitives it composes) instead of on what the thing is for. Weak rows are marked `(weak)` and listed in full under [Weak descriptions](#weak-descriptions). Coverage is 99%, but **findable-without-luck coverage is 89%**.
 
-Per tier, strong out of total: **Sections** 54/55 · **Blocks** 93/99 · **Chrome** 10/18 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 5/6 · **Docs + Blog Blocks** 5/5 · **Docs + Blog Chrome** 1/1 · **Docs + Blog Shells** 0/2 · **Scheduling Sections** 2/2 · **Scheduling Blocks** 5/5 · **Signal-Collectors Sections** 5/5 · **Signal-Collectors Blocks** 8/9 · **Commerce Sections** 2/2 · **Commerce Blocks** 12/12 · **Commerce Panels** 1/1. A tier low on this line is a tier where a capability search is most likely to come up empty on something that exists.
+Per tier, strong out of total: **Sections** 54/55 · **Blocks** 95/101 · **Chrome** 10/18 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 7/8 · **Docs + Blog Blocks** 5/5 · **Docs + Blog Chrome** 1/1 · **Docs + Blog Shells** 0/2 · **Scheduling Sections** 2/2 · **Scheduling Blocks** 5/5 · **Signal-Collectors Sections** 5/5 · **Signal-Collectors Blocks** 8/9 · **Commerce Sections** 2/2 · **Commerce Blocks** 12/12 · **Commerce Panels** 1/1. A tier low on this line is a tier where a capability search is most likely to come up empty on something that exists.
 
 That grade is **mechanical**. It counts what it can measure — how much a description adds beyond the component's own name, how much of it is spent on wiring, whether the extraction came out damaged — and it cannot tell a fluent paragraph about the wrong subject from a useful one. A person reading these tables will find more rows unusable than the weak count admits. Treat it as a floor on the problem, not a measurement of it, and read the source before concluding a capability is absent.
 
@@ -119,7 +119,7 @@ Import: `import { X } from "@working-theory/ui/sections";` (or from the `@workin
 
 ---
 
-## Blocks (99)
+## Blocks (101)
 
 Intermediate composition tiles — the pieces sections are built from. Compose primitives and panels; never import a section.
 
@@ -158,6 +158,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `DescriptionList` | Semantic <dl> of aligned term/definition rows (rows + inline layouts). A semantic <dl> rendering label/value rows from an `items` prop. Each item is a <dt> (muted term) paired with a <dd> (value). The value is a ReactNode, so callers compose richer values (spans, lists, mono text) inside it. | `import { DescriptionList } from "@working-theory/ui/blocks"` |
 | `DetailCard` | The collapsible console / data-panel card: a composable card with a header (title + optional actions + collapse toggle), an optional tab bar, a body slot, and an optional footer. The "deferred SidePanel DetailCard" from, built as a general content card any console / detail view can compose without inventing its own card structure. | `import { DetailCard } from "@working-theory/ui/blocks"` |
 | `DetailHeader` | The entity-bearing sibling of PageHeader: a Breadcrumb wayfinding trail above an EntityHeader identity row, plus a forwarded actions slot. | `import { DetailHeader } from "@working-theory/ui/blocks"` |
+| `DisplayList` | Centred display-size rows of short labels, each optionally a link, with no rules, cards or dividers between them — the bondcap.com "what we offer" list and its report archive grid. | `import { DisplayList } from "@working-theory/ui/blocks"` |
 | `DistributionList` | Per-option answer-share list over the Progress primitive. One question's answer distribution: a title, an "answered" count line, and one row per declared option (a label, a pre-formatted share `display` string, and a `Progress` bar). `display` is pre-formatted by the caller (Rule 10 — this block never formats numbers itself); `share` drives the `Progress` fill, scaled to the primitive's 0–100 range. | `import { DistributionList } from "@working-theory/ui/blocks"` |
 | `EntityHeader` | The single identity-row source: an optional leading avatar, a title/name (Heading), an optional subtitle/meta line (Text), an optional type-badge slot above the title, and an optional trailing actions slot. | `import { EntityHeader } from "@working-theory/ui/blocks"` |
 | `FaqItem` | Q&A pair block for FAQ section families (expanded + accordion). Defaults reproduce the current render except the deliberate item-spacing-asymmetry fix. | `import { FaqItem } from "@working-theory/ui/blocks"` |
@@ -208,6 +209,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `SectionHeader` | Alignment-parameterized section header (eyebrow/subtitle/description/supportLink). The same component serves two ranks (headingLevel="section" \| "subsection") and three alignments (align="start" \| "center" \| "end"). It knows nothing about columns/splits/carousels — it is width-flexible and fills whatever container the section places it in. | `import { SectionHeader } from "@working-theory/ui/blocks"` |
 | `ShareBar` | The reader-facing counterpart to DocsActionBar. Both surfaces share the same SplitButton *affordance + slot* (outline variant, right-justified on the post title row) but fill it with different actions: DocsActionBar carries the AI-ingestion set (Copy page + Open in …), ShareBar carries the social-share set (X · LinkedIn · Bluesky · Copy link). One primitive, two configs. | `import { ShareBar } from "@working-theory/ui/blocks"` |
 | `SinglePriceCard` | 2-column split card for the Pricing 'single-price-with-details' variant. *(weak)* | `import { SinglePriceCard } from "@working-theory/ui/blocks"` |
+| `SlideAdvance` | The deck's slide-advance control. One ghost Button holding a hairline chevron: a down chevron moves to the next slide, an up chevron to the first. A native button, so a click, Enter and Space all fire the same move, and nothing else listens: no wheel, touch, scroll or key handler is added, so native scroll-snap still settles every user scroll (the argument against a scroll-hijacking deck). | `import { SlideAdvance } from "@working-theory/ui/blocks"` |
 | `SocialIcons` | Horizontal row of social icon links. Renders brand icons (via Icon primitive + simple-icons paths) inside accessible Link primitives. Each platform link gets an aria-label. Shared by company-mission, simple-centered, and newsletter-below footer variants, and composed by TeamMemberCard for member social links. *(weak)* | `import { SocialIcons } from "@working-theory/ui/blocks"` |
 | `SortableList` | The one @dnd-kit/sortable reorder block: mouse, touch and keyboard drag behind a six-dot grip, announced, controlled. `@dnd-kit/sortable` wrapped ONCE behind our six-dot grip. The ONLY file in the monorepo that imports `@dnd-kit/*` — enforced by tests/architecture/no-dnd-kit-outside-sortablelist.test.ts (SD-2). | `import { SortableList } from "@working-theory/ui/blocks"` |
 | `StatTicker` | Static, horizontally overflow-scrollable workspace stat strip with an optional trailing CTA; no auto-scroll marquee (ploy-capture recomposition). The Overview stat strip captured off ploy.ai (behavior spec: -2, — `overview-ticker` "-viewport"/"-track"/"-segment"/"-value"/"-cta"). | `import { StatTicker } from "@working-theory/ui/blocks"` |
@@ -365,7 +367,7 @@ Import: `import { X } from "@working-theory/ui/panels";` (or from the `@working-
 
 ---
 
-## Shells (6)
+## Shells (8)
 
 Route-level slot-frames — the outermost layout a page is placed into. They supply geometry and slots (nav / sidebar / main / footer), not content: you inject the real Nav, Footer and sidebar. A different package from every tier above: `@working-theory/templates`.
 
@@ -377,6 +379,8 @@ Import: `import { X } from "@working-theory/templates/shells";` (or from the `@w
 | `AppShell` | Shared authed-app base frame. Layout ownership: AppShell is the SINGLE owner of the authed sidebar frame layout. The `sidebar` prop is CONTENT (e.g. a <SidebarNav>), never a layout component. Do NOT pass SidebarShell or FixedPanel as the sidebar — that nests two incompatible layout systems (a fixed-width shell vs a variable-width panel). | `import { AppShell } from "@working-theory/templates/shells"` |
 | `AuthShell` | The frame the five auth pages (/sign-in, /sign-up, /forgot-password, /reset-password, /verify-email) share: a brand mark top-start, one centered content column, and a slim footer. No nav — an auth page has nothing to navigate to, and the marketing Nav is exactly what this shell exists to replace on those routes. | `import { AuthShell } from "@working-theory/templates/shells"` |
 | `DeckHeroObserver` | Internal client island for MarketingShell's `deckHero` option. | internal — compose from `packages/templates/src/shells/DeckHeroObserver.tsx` |
+| `DeckPresentation` | Internal client island for MarketingShell's `presentation` option. Not exported from the shells barrel (`./index.ts`) — MarketingShell renders it internally under `snap="mandatory"` with `presentation`, beside DeckHeroObserver, whose idiom it follows: a zero-size anchor, no React state, and every write made through the DOM after hydration. | internal — compose from `packages/templates/src/shells/DeckPresentation.tsx` |
+| `DeckSlideAdvance` | Internal client island that puts one working slide-advance button at the foot of every slide of MarketingShell's scroll-snap deck: down to the next slide, and up from the last slide back to the first. | internal — compose from `packages/templates/src/shells/DeckSlideAdvance.tsx` |
 | `MarketingShell` | Public-facing marketing site **slot-frame**. Server Component (RSC default). A shell is a slot-defining frame: it carves out *where chrome goes* (top + bottom) and *where sections go* (the body), owning **geometry only**. Chrome (Nav/Footer) and sections **fill** the slots — nothing is baked into the component. See (first instance). *(weak)* | `import { MarketingShell } from "@working-theory/templates/shells"` |
 | `SignedInShell` | Every AILK signed-in area runs on this frame: the admin app's workspace (AppFrame supplies its switcher, Library and gating as content) and a site's own /account area. | `import { SignedInShell } from "@working-theory/templates/shells"` |