create-ailk 0.5.0 → 0.6.0

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: **286 component files** across 16 tiers — 54 sections, 86 blocks, 17 chrome, 79 primitives, 6 panels, 3 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 5 scheduling-blocks, 3 signal-collectors-sections, 8 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 283 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: **298 component files** across 16 tiers — 54 sections, 95 blocks, 18 chrome, 79 primitives, 6 panels, 5 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 5 scheduling-blocks, 3 signal-collectors-sections, 8 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 295 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: **282/286** components carry a capability description derived from source — 43 from the section registry's hand-authored when-to-use text, 213 from the component's own doc-comment header, 26 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: **294/298** components carry a capability description derived from source — 43 from the section registry's hand-authored when-to-use text, 220 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, **253** are *strong* — a capability sentence you could match a requirement against — and **29** 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 88%**.
+Of those, **264** are *strong* — a capability sentence you could match a requirement against — and **30** 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** 53/54 · **Blocks** 81/86 · **Chrome** 10/17 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 2/3 · **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** 3/3 · **Signal-Collectors Blocks** 7/8 · **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** 53/54 · **Blocks** 90/95 · **Chrome** 10/18 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 4/5 · **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** 3/3 · **Signal-Collectors Blocks** 7/8 · **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.
 
@@ -86,7 +86,7 @@ Import: `import { X } from "@working-theory/ui/sections";` (or from the `@workin
 | `FormLightbox` | The VideoLightbox dialog shell hosting a StepFlow instead of a video: a trigger (e.g. a "Let's Start" Button — any focusable element the caller supplies) opens the SAME StepFlow inside a Radix Dialog on the dimmed/blurred backdrop shared with VideoLightbox/SpotlightPanel. | `import { FormLightbox } from "@working-theory/ui/sections"` |
 | `Gallery` | An image gallery — use to showcase product screenshots or visual work. | MDX `type: gallery` · `import { Gallery } from "@working-theory/ui/sections"` |
 | `GlossaryIndex` | An A-Z glossary index — use for a browsable list of defined terms. | MDX `type: glossary-index` · `import { GlossaryIndex } from "@working-theory/ui/sections"` |
-| `Hero` | Top-of-page introduction — headline, optional subhead and CTAs; use once per page as the first section. | MDX `type: hero` · `import { Hero } from "@working-theory/ui/sections"` |
+| `Hero` | Top-of-page introduction — headline, optional subhead and CTAs; use once per page as the first section. On `variant: 'centered'` the optional `lockup` image renders in the headline's place (the headline string becomes its accessible name), centered over an optional full-bleed `backdrop` at every width — the landing-slide treatment. | MDX `type: hero` · `import { Hero } from "@working-theory/ui/sections"` |
 | `HeroFormSlot` | The panel hero's right-column gate card: a `FormCard` wrapping either the consumer's conversational intake (when eligible and a `HeroIntakeProvider` is mounted) or the embedded multi-step `StepFlow`, which is also where `controls.showForm` hands the surface over. /. | `import { HeroFormSlot } from "@working-theory/ui/sections"` |
 | `HeroIntakeContext` | The bounded seam through which a consumer page mounts its own conversational intake as the FIRST surface INSIDE one of Hero's existing gate surfaces (the `lightboxCta` FormLightbox, or the panel variant's form-slot card), with the existing multi-step StepFlow as the in-gate fallback (correcting 's whole-page swap). | `import { HeroIntakeContext } from "@working-theory/ui/sections"` |
 | `HeroPromptCapture` | The Hero `promptCapture` opt-in's wiring. Composes the two new blocks — `PromptCaptureCard` (the chat-style card) and `SuggestionChipCarousel` (the one-expanded-slot chip row) — and owns the ONE piece of state they share: the typed text. A chip click writes into it; the card renders and edits it; submit carries it onward. | `import { HeroPromptCapture } from "@working-theory/ui/sections"` |
@@ -118,7 +118,7 @@ Import: `import { X } from "@working-theory/ui/sections";` (or from the `@workin
 
 ---
 
-## Blocks (86)
+## Blocks (95)
 
 Intermediate composition tiles — the pieces sections are built from. Compose primitives and panels; never import a section.
 
@@ -133,7 +133,8 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `ArticlePager` | The footer prev/next pager. Given the previous and next destinations — docs pages in tree order, or blog posts in date order — renders two link tiles (a directional label + the destination title). Either side may be absent (first / last item) — the present side still anchors to its edge. Renders nothing when both sides are absent. | `import { ArticlePager } from "@working-theory/ui/blocks"` |
 | `AskAiCommandGroup` | The ⌘K palette's composable "Ask AI" group; one CommandItem per provider seeding "About <entity>: <query>" (or the entity promptText when the query is empty); composed by the consumer's own CommandDialog. | `import { AskAiCommandGroup } from "@working-theory/ui/blocks"` |
 | `AskAiProviderRow` | The ONE shared provider-link row every ask-AI placement composes — the AskAi section (band + ticker variant) and the Hero `askAi` opt-in all render THIS block, never a per-placement fork. Renders a bounded set of five measured providers, each a deep link seeded with an AUTHORED `promptText` — the prompt is always consumer-supplied data, never derived from page context (headline, entity name, etc.). | `import { AskAiProviderRow } from "@working-theory/ui/blocks"` |
-| `AuthCard` | Logo (top-center, inside). Axes: intent: "sign-in" \| "sign-up" — drives heading / subhead / footer copy. method: "password" \| "magic-link" \| "sso" — drives the body + primary action. | `import { AuthCard } from "@working-theory/ui/blocks"` |
+| `AssetLightbox` | The asset detail lightbox: the image with zoom on the stage, a Details rail with in-place pencil-edit Title and Description, then Filename/Type/Size/Dimensions/Created, then Tags (from the seeded set the caller passes), then Copy URL/Replace/Delete. Renders inside a ResponsiveSheet — the SAME field sequence in both its dialog and sheet forms (: one field array, walked once, shared by both forms). | `import { AssetLightbox } from "@working-theory/ui/blocks"` |
+| `AuthCard` | Multi-flow auth card: sign-in, sign-up, invitation, forgot, reset and sent, from one skeleton. One self-contained card renders every auth surface a site needs: signing in, signing up, a closed sign-up that requires an invitation, requesting a password reset, choosing a new password, and the check-your-email state that follows a magic link or a reset request. | `import { AuthCard } from "@working-theory/ui/blocks"` |
 | `AwardBadgePlaceholder` | The labeled placeholder an Awards badge slot renders when no image has been supplied — mirrors MediaPlaceholder's role but in an award-chevron/ laurel badge silhouette rather than a generic photo frame, since an unfilled award slot should read as "an award badge goes here," not "a photo goes here." The shape (a laurel-flanked medallion over a chevron ribbon) is a hand-drawn SVG outline — never a copied G2/Capterra/Apollo asset. | internal — compose from `packages/ui/src/blocks/AwardBadgePlaceholder.tsx` |
 | `BackgroundPattern` | Decorative SVG dot-grid / line pattern for ContactForm section. Decorative block (generalized beyond its original single consumer). Renders an absolutely-positioned decoration behind a section's content. Originally the pattern anchored behind ContactForm's form column; SpotlightPanel composes it as a full-bleed section backdrop (dimmed + blurred, behind a centered card) — same block, a second placement. | `import { BackgroundPattern } from "@working-theory/ui/blocks"` |
 | `BadgeRow` | Horizontal cluster of static badge labels used by Hero and Feature section families for `data.badge` and tag-list patterns. | `import { BadgeRow } from "@working-theory/ui/blocks"` |
@@ -151,7 +152,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `ContactFormFields` | Renders the form field grid (Input / Textarea / Select primitives) + submit Button + optional consent text footer. | `import { ContactFormFields } from "@working-theory/ui/blocks"` |
 | `ContactInfoAside` | For ContactForm 'split-with-pattern' variant. Renders address / phone / email contact info rows. Each row: sr-only <dt> label + visible <dd> with Icon + Text. Phone and email render as tel:/mailto: links (click-to-call / click-to-email). | `import { ContactInfoAside } from "@working-theory/ui/blocks"` |
 | `ConversationalIntake` | The UI half of the conversational-intake feature: renders the transcript, closed-question answer pills, a free-text form, a thinking indicator, and Skip — driven entirely through the `NextTurn` interface exported by `./engine` (merged). | `import { ConversationalIntake } from "@working-theory/ui/blocks"` |
-| `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, min-width-aligned 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"` |
+| `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"` |
 | `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"` |
@@ -167,12 +168,14 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `KeyPointsPanel` | ONE shared block composed by two consumers: Hero's `panel` variant (text-left / panel-right) and Pricing's `band-hero` arrangement (header-left / panel-right, tiers below). | internal — compose from `packages/ui/src/blocks/KeyPointsPanel.tsx` |
 | `LinkCard` | A whole-tile link card: the entire tile IS the anchor (Claude-docs link-card anatomy). Optional leading icon, a title heading, and an optional description paragraph. Hover fill + chrome are intrinsic to the block — never props. | `import { LinkCard } from "@working-theory/ui/blocks"` |
 | `LinkListItem` | Hub-page spoke list row: prose Link + optional description, enlarged to the 44px touch-target floor. Fix: the enlarged-hit-area pattern (same idiom as ShortcutTrigger, SegmentedControl's touchTargetFloor) — `min-h-(control-height-big)` clamps the anchor's clickable box to 44px while `inline-flex items-center` keeps the visible text at its normal prose size. | `import { LinkListItem } from "@working-theory/ui/blocks"` |
+| `ListRow` | The PHONE form of one admin list item. The reference is `apps-paid/admin/design/demos/first-steps/demo.html:475` (`rowDoc`), which lays the row out as: a leading type glyph, a two-line text column with the MUTED META LINE FIRST and the item's name second (every phone screen in the demo agrees), an optional trailing control, and a chevron. | `import { ListRow } from "@working-theory/ui/blocks"` |
+| `ListTable` | The desktop form: a fixed-layout list table that never wraps, with the shared Tags and Live cells. The reference is `apps-paid/admin/design/demos/first-steps/demo.html`'s `.tbl`: `table-layout:fixed` on the table and `white-space:nowrap;overflow:hidden;text-overflow:ellipsis` on every cell. BOTH are load-bearing — `table-fixed` alone lets the cell wrap, `truncate` alone lets the browser widen the column to fit. | `import { ListTable } from "@working-theory/ui/blocks"` |
 | `LocaleSwitcher` | Compact globe + locale dropdown. Extracts the "🌐 English ▾" affordance that lived as an inline node in the chrome Footer story into a reusable block. Composes the `Select` primitive (NOT a raw <select>): a leading globe icon, the current locale label (via SelectValue), and the trigger's built-in chevron. | `import { LocaleSwitcher } from "@working-theory/ui/blocks"` |
 | `LocaleSwitcherNav` | Composes the controlled `LocaleSwitcher` block and owns the navigation side-effect that block deliberately leaves to its consumer: on a locale change it writes the `NEXT_LOCALE` cookie and navigates to the as-needed prefixed path (default locale unprefixed, every other locale `/<code>` + path — mirroring `apps/web/middleware.ts`'s `localePrefix: "as-needed"`). | `import { LocaleSwitcherNav } from "@working-theory/ui/blocks"` |
 | `LogoRow` | The ONE logo-strip implementation; bounded layout/treatment/logoSize plus an opt-in motion-safe marquee; composed by the LogoCloud section and the Hero logoStrip opt-in. | `import { LogoRow } from "@working-theory/ui/blocks"` |
 | `MarkdownViewToggle` | 2-state rendered ↔ markdown view toggle for content pages. The human complement to the agent-facing /llms.txt surface. Mirrors the Claude-docs "view/copy as markdown" affordance. Ships at Tier 3 (Block) because it is an interactive view-toggle control composing the SegmentedControl primitive with the CodeBlock block — not a page-level layout shell. | `import { MarkdownViewToggle } from "@working-theory/ui/blocks"` |
 | `MediaFigure` | The reusable *frame* for the visual half of a split section: an `Image` constrained by an optional `AspectRatio`, with consistent rounding, an optional caption, an optional decorative frame, and an optional overlay slot + scrim for text/badges/play-buttons over media. | `import { MediaFigure } from "@working-theory/ui/blocks"` |
-| `MediaPlaceholder` | The single shared labeled placeholder a declared IMAGERY SLOT renders when no asset has been supplied yet — a chassis never silently ships an empty slot, and never renders an accidental image. Composed by `Hero`/`Feature`/`Gallery` (sections tier) whenever their `imagerySlot` data flag is `true` and the corresponding asset is absent. | internal — compose from `packages/ui/src/blocks/MediaPlaceholder.tsx` |
+| `MediaPlaceholder` | The single shared labeled placeholder a declared IMAGERY SLOT renders when no asset has been supplied yet — a chassis never silently ships an empty slot, and never renders an accidental image. Composed by `Hero`/`Feature`/`Gallery` (sections tier) whenever their `imagerySlot` data flag is `true` and the corresponding asset is absent. | `import { MediaPlaceholder } from "@working-theory/ui/blocks"` |
 | `MemberList` | Settings "People" member rows — reimplements the ploy.ai Team Members list capture (avatar + email + "(you)" + role Badge). Purely presentational and props-driven: no session/permission logic; the caller supplies the member list, role labels, and an optional per-row actions slot (e.g. a "Remove" menu). | `import { MemberList } from "@working-theory/ui/blocks"` |
 | `MetricComparisonTable` | A numeric comparison table over the Table primitive. The operator-dashboard comparison view's core surface: one column per waitlist (plus a "total" column) and one row per metric (raw, qualified, qualification rate, one row per tier). | `import { MetricComparisonTable } from "@working-theory/ui/blocks"` |
 | `NavActionList` | CTA action cluster block (one shared button chrome; variant = paint, size = box). Extracts the action-cluster variant routing that was duplicated verbatim between Nav (ActionCluster, Nav.tsx:240–342) and NavMobileMenu (action map, NavMobileMenu.tsx:344–435). This block is the vehicle for the later Nav + NavMobileMenu refactors — both will compose it. | `import { NavActionList } from "@working-theory/ui/blocks"` |
@@ -193,18 +196,24 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `PromptCaptureCard` | The chat-style prompt card: a multiline field carrying the authored placeholder, with a circular arrow submit control pinned bottom-right that stays muted (disabled) until the visitor has typed something. Enter submits; Shift+Enter inserts a newline — the chat-composer convention. | `import { PromptCaptureCard } from "@working-theory/ui/blocks"` |
 | `Prose` | The single typography wrapper both the docs route and blog render their compiled-MDX body inside. It styles every RAW markdown element a compiled document emits — h2–h6, p, ul/ol/li, blockquote, table parts, hr, a, inline code, pre, img, kbd, strong/em — via `@working-theory/theme` semantic tokens and type roles. No raw color or spacing literals; dark mode rides the semantic tokens (no `dark:` variants needed). | `import { Prose } from "@working-theory/ui/blocks"` |
 | `RecommendationCard` | "For you" proactive-recommendation tile: status + title + description + "Why this?" disclosure + context chip + action + dismiss (ploy-capture recomposition). The "For you" proactive-recommendation card captured off ploy.ai's Overview page (behavior spec: -2, — `overview-page` "For you" feed / rebuild-triage row "For you" recommendation card"). | `import { RecommendationCard } from "@working-theory/ui/blocks"` |
+| `ResponsiveSheet` | ONE component, TWO forms, ONE open pair. Renders its `children` as a Radix Dialog at `md` (768px, --breakpoint-md) and up, and as a full-screen Radix Sheet below it — never both at once. | `import { ResponsiveSheet } from "@working-theory/ui/blocks"` |
+| `RowGroup` | The bordered box that groups ListRows with hairline dividers. The reference is `apps-paid/admin/design/demos/first-steps/demo.html`'s `.box` (`background:var(--bg);border:1px solid var(--border); border-radius:6px;overflow:hidden`) with `.row{border-top:…}` and `.row:first-child{border-top:0}` — i.e. hairlines BETWEEN rows, none above the first. | `import { RowGroup } from "@working-theory/ui/blocks"` |
 | `SchedulerEmbed` | A declarative third-party booking iframe. Renders a full-width, border-0, lazy-loaded <iframe> at `src` with a graceful loading skeleton (shown until the iframe's own `load` event fires) and a timeout-gated plain-link fallback beneath it — for environments that block third-party frames (ad blockers, a strict CSP `frame-src`) where the iframe may load blank or never load at all. | `import { SchedulerEmbed } from "@working-theory/ui/blocks"` · `packages/ui/src/blocks/SchedulerEmbed.tsx` |
+| `SectionActionRow` | The bottom-anchored, centered action row a section places BENEATH its own content, at the 44×44px target-size floor. It is the block form of the placement established for `stair-steps`: a bounded 1-2 action list rendered after the section body rather than inside the section header. | `import { SectionActionRow } from "@working-theory/ui/blocks"` |
 | `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"` |
 | `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"` |
 | `Steps` | The numbered install/guide walkthrough: an ordered list of `Step` items, each a zero-padded number marker + an optional per-step heading + body, joined top-to-bottom by a connecting vertical rule. The classic docs "follow these steps" surface, rendered from `@working-theory/ui` so docs pages stay design-system citizens. | `import { Steps } from "@working-theory/ui/blocks"` |
 | `StreamingMessage` | One chat turn's message rendering, per the ploy.ai capture contract. | `import { StreamingMessage } from "@working-theory/ui/blocks"` |
+| `SubscriptionStatusBanner` | The account page's update-your-card banner: tells a subscriber whose payment needs attention, with one call to action to open the Stripe billing portal and fix it. Presentational only — the block owns no app wiring (the FormCard `ReactNode` action-slot convention); the page decides whether to render it and supplies pre-translated copy. | `import { SubscriptionStatusBanner } from "@working-theory/ui/blocks"` |
 | `SuggestionChipCarousel` | A 3-6 icon-chip row with exactly one chip expanded (muted category + bold prompt), auto-rotating motion-safe with hover/focus pause; a click hands the chip's prompt to the host. A row of 3-6 icon chips in which exactly ONE is expanded at a time. | `import { SuggestionChipCarousel } from "@working-theory/ui/blocks"` |
 | `TableOfContents` | The shared "On this page" rail consumed by the docs shell and the blog post layout (do not couple it to docs-only context). Renders a flat list of heading anchors and scroll-spies the heading currently in view, highlighting the matching item. | `import { TableOfContents } from "@working-theory/ui/blocks"` |
 | `TeamMemberCard` | Renders one team member in either of two layout modes: 'inline' — small circular avatar left + name/role right (with-small-images variant) 'stacked' — large circular avatar top + name/role/social-links below (with-large-images variant). | `import { TeamMemberCard } from "@working-theory/ui/blocks"` |
 | `TestimonialAside` | For ContactForm 'with-testimonial' variant. Rating (optional 0–5): rendered via Rating primitive with accessible label. avatar (optional): composed via Avatar + AvatarFallback + AvatarImage (initials fallback). | `import { TestimonialAside } from "@working-theory/ui/blocks"` |
+| `UpgradeDialog` | A plan-comparison dialog a consumer opens when an entitlement gates an action — controlled by default (open/onOpenChange are the primary interface; `trigger` is optional, since both known consumers open it from a menu row rather than an inline trigger). | `import { UpgradeDialog } from "@working-theory/ui/blocks"` |
 | `UserBlock` | Position-agnostic identity/account trigger block: avatar + primary label + optional secondary line, with density/affordance/collapsed/truncation variants. A single focusable button-rooted element that forwardRef's + spreads props so DropdownMenuTrigger asChild (AccountMenu) can clone it as its trigger anchor. | `import { UserBlock } from "@working-theory/ui/blocks"` |
 | `VerifyCodeField` | Presentational code-entry unit for StepFlow's `verify` step type: a status line ("We sent a code to…"), a 6-digit numeric code Field, and a resend link. Composes existing Field/Input/Button/Text primitives — no bespoke markup, no new primitive. | `import { VerifyCodeField } from "@working-theory/ui/blocks"` |
 | `VersionHistory` | Day-grouped auto-saved version list with a "Current" marker — reimplements the ploy.ai artifact-editor Versions capture ("10 auto-saved versions", grouped by day, `Current` on one entry). Purely presentational and props-driven: renders the grouped list only. Designed to be embedded inside a popover by a higher tier — this block does NOT render the popover/trigger itself. | `import { VersionHistory } from "@working-theory/ui/blocks"` |
@@ -215,7 +224,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 
 ---
 
-## Chrome (17)
+## Chrome (18)
 
 Persistent framing UI that wraps page content — navigation, footers, sidebars, banners. Not MDX-driven.
 
@@ -228,6 +237,7 @@ Import: `import { X } from "@working-theory/ui/chrome";` (or from the `@working-
 | `Banner` | Site-wide announcement and consent banner chrome. *(weak)* | `import { Banner } from "@working-theory/ui/chrome"` |
 | `BannerConsentIsland` | Accept / Reject action cluster for the consent Banner. Isolated to "use client" so Banner stays RSC. The onAccept / onReject callbacks must be Server Actions when used inside an RSC tree; they may be regular functions in client contexts (Storybook, testing). *(weak)* | internal — compose from `packages/ui/src/chrome/BannerConsentIsland.tsx` |
 | `BannerDismissIsland` | Isolated to "use client" so Banner (Server Component) stays RSC. Mirrors the Nav / NavMobileMenu split: interactivity is contained here. Rendering: wraps its children in a relative-positioned div and absolutely places the × dismiss button at the end (RTL-safe: `end-4`) of the bar. *(weak)* | internal — compose from `packages/ui/src/chrome/BannerDismissIsland.tsx` |
+| `BottomTabBar` | Fixed, safe-area-aware phone bottom tab bar chrome. Server Component (RSC) — presentational, no interaction state of its own; the leading avatar/account trigger is supplied as a node by the consumer (AppFrame composes AccountMenu around it). *(weak)* | `import { BottomTabBar } from "@working-theory/ui/chrome"` |
 | `FacetNav` | Chrome-tier faceted secondary navigation (ploy-capture recomposition). One reusable component servicing THREE captured consumers: Settings' grouped Org/Workspace nav, Assets' All + tag-facet counts, and Docs' All + folder tree + tag facets. | `import { FacetNav } from "@working-theory/ui/chrome"` |
 | `FloatingCta` | Persistent fixed corner action pill. *(weak)* | `import { FloatingCta } from "@working-theory/ui/chrome"` |
 | `Footer` | Site footer server component with secondary nav links. Label resolution order for navItems labels. Resolved labels are passed into FooterNav as pre-resolved strings — no duplicated resolution logic across variants. | `import { Footer } from "@working-theory/ui/chrome"` |
@@ -350,7 +360,7 @@ Import: `import { X } from "@working-theory/ui/panels";` (or from the `@working-
 
 ---
 
-## Shells (3)
+## Shells (5)
 
 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`.
 
@@ -358,7 +368,9 @@ Import: `import { X } from "@working-theory/templates/shells";` (or from the `@w
 
 | Component | What it does | How to use it |
 | --- | --- | --- |
+| `AccountShell` | Route-level layout for a signed-in person's own Account area. Composed exactly as the deleted shell was — a thin AppShell + SidebarNav. Auth is not wired here; the consuming layout guards the route. | `import { AccountShell } from "@working-theory/templates/shells"` |
 | `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` |
 | `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"` |
 
@@ -517,7 +529,7 @@ Import: `import { X } from "@working-theory/ui-commerce";` (or from the `@workin
 
 ## Weak descriptions
 
-These 29 components have a description that is accurate but does not do the job well: too short to match against, or long but spent on implementation. A capability search reaches them only if the searcher's word happens to be in it, so they are the most likely place for this catalog to repeat the failure it was built to fix. Read the source before concluding the capability is absent — and if you own one of these components, its header is the fix.
+These 30 components have a description that is accurate but does not do the job well: too short to match against, or long but spent on implementation. A capability search reaches them only if the searcher's word happens to be in it, so they are the most likely place for this catalog to repeat the failure it was built to fix. Read the source before concluding the capability is absent — and if you own one of these components, its header is the fix.
 
 | Component | Tier | What the source gives us |
 | --- | --- | --- |
@@ -530,6 +542,7 @@ These 29 components have a description that is accurate but does not do the job
 | `Banner` | chrome | Site-wide announcement and consent banner chrome. |
 | `BannerConsentIsland` | chrome | Accept / Reject action cluster for the consent Banner. Isolated to "use client" so Banner stays RSC. The onAccept / onReject callbacks must be Server Actions when used inside an RSC tree; they may be regular functions in client contexts (Storybook, testing). |
 | `BannerDismissIsland` | chrome | Isolated to "use client" so Banner (Server Component) stays RSC. Mirrors the Nav / NavMobileMenu split: interactivity is contained here. Rendering: wraps its children in a relative-positioned div and absolutely places the × dismiss button at the end (RTL-safe: `end-4`) of the bar. |
+| `BottomTabBar` | chrome | Fixed, safe-area-aware phone bottom tab bar chrome. Server Component (RSC) — presentational, no interaction state of its own; the leading avatar/account trigger is supplied as a node by the consumer (AppFrame composes AccountMenu around it). |
 | `FloatingCta` | chrome | Persistent fixed corner action pill. |
 | `NavMobileMenu` | chrome | Client subcomponent for mobile hamburger state. Isolates "use client" to this narrow component so Nav (Server Component) stays clean. Renders a hamburger button + collapsible link list. Closes the menu automatically when the pathname changes (route navigation). |
 | `SidebarNav` | chrome | Application sidebar rail (nav + teams + user) for dashboard shells. Server Component (RSC). Renders the vertical sidebar rail for application-shell layouts. Used as the `sidebar` prop of AdminShell. Wrap in a FixedPanel (panels tier) to get the expanded ↔ rail ↔ hidden state machinery. Independently reusable in future shells (settings, analytics, etc.). |

package/dist/lib/api-boot-assertion.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The verdict on a scaffold `apps/api` boot attempt (#5824).
+ *
+ * `scripts/verify-scaffold.mjs` builds and boots the scaffold's `apps/api`
+ * because the #5799 measurement run found a keyless scaffold's api dying at
+ * boot on `AILK slice module './lib/stripe.js' could not be resolved at
+ * runtime` — a base-tree regression (#5823) that no gate in this repo could
+ * see, because the driver built `apps/web` and `database` and never touched
+ * `apps/api`.
+ *
+ * The verdict lives here, apart from the driver, for one reason: it is the
+ * assertion the whole gate exists for, and proving it still catches the #5823
+ * class must not cost a templates build, an install and a `next build`. It is
+ * a pure function of what the child process printed plus how it ended, so
+ * `__tests__/verify-scaffold-api-boot.test.ts` drives it directly. The driver
+ * loads it from `dist/` exactly as it already loads `paid-paths.js`.
+ */
+/** The line `apps/api` logs once `server.listen()` has resolved. */
+export declare const API_LISTENING_MARKER = "AI Launch Kit API listening";
+/** What the driver observed of the boot attempt. */
+export interface ApiBootObservation {
+    /** The child's stdout and stderr, interleaved as captured. */
+    output: string;
+    /** Whether the child exited before the driver stopped waiting. */
+    exited: boolean;
+    /** Its exit code, when it exited. */
+    exitCode: number | null;
+    /** Whether the wait ended on the driver's own deadline instead. */
+    timedOut: boolean;
+    /** That deadline, in milliseconds, for the failure message. */
+    timeoutMs: number;
+}
+export interface ApiBootVerdict {
+    ok: boolean;
+    reason: string;
+}
+/**
+ * Decide whether a scaffold `apps/api` booted.
+ *
+ * An unresolved slice module is checked BEFORE the listening line: that
+ * ordering is the #5823 assertion itself — a `could not be resolved` line is a
+ * failure that names the module, even in the hypothetical transcript that also
+ * reached a listen. Every other way of not reaching the listening line — an
+ * early exit, or a deadline with neither signal — fails with what was seen.
+ */
+export declare function assessApiBoot(observation: ApiBootObservation): ApiBootVerdict;

package/dist/lib/api-boot-assertion.js

@@ -0,0 +1,70 @@
+/**
+ * The verdict on a scaffold `apps/api` boot attempt (#5824).
+ *
+ * `scripts/verify-scaffold.mjs` builds and boots the scaffold's `apps/api`
+ * because the #5799 measurement run found a keyless scaffold's api dying at
+ * boot on `AILK slice module './lib/stripe.js' could not be resolved at
+ * runtime` — a base-tree regression (#5823) that no gate in this repo could
+ * see, because the driver built `apps/web` and `database` and never touched
+ * `apps/api`.
+ *
+ * The verdict lives here, apart from the driver, for one reason: it is the
+ * assertion the whole gate exists for, and proving it still catches the #5823
+ * class must not cost a templates build, an install and a `next build`. It is
+ * a pure function of what the child process printed plus how it ended, so
+ * `__tests__/verify-scaffold-api-boot.test.ts` drives it directly. The driver
+ * loads it from `dist/` exactly as it already loads `paid-paths.js`.
+ */
+/** The line `apps/api` logs once `server.listen()` has resolved. */
+export const API_LISTENING_MARKER = 'AI Launch Kit API listening';
+/**
+ * A slice module the api could not resolve at runtime — the #5823 shape. The
+ * module specifier is captured so the failure names it rather than leaving the
+ * next reader to re-derive it from a bare non-zero exit.
+ */
+const UNRESOLVED_SLICE_MODULE = /AILK slice module ['"`]?([^'"`\s]+?)['"`]? could not be resolved/;
+/**
+ * Decide whether a scaffold `apps/api` booted.
+ *
+ * An unresolved slice module is checked BEFORE the listening line: that
+ * ordering is the #5823 assertion itself — a `could not be resolved` line is a
+ * failure that names the module, even in the hypothetical transcript that also
+ * reached a listen. Every other way of not reaching the listening line — an
+ * early exit, or a deadline with neither signal — fails with what was seen.
+ */
+export function assessApiBoot(observation) {
+    const { output, exited, exitCode, timedOut, timeoutMs } = observation;
+    const unresolved = UNRESOLVED_SLICE_MODULE.exec(output);
+    if (unresolved) {
+        return {
+            ok: false,
+            reason: `the scaffold's apps/api could not resolve the slice module ${unresolved[1]} ` +
+                `at boot — the #5823 class, invisible to every other gate in this repo` +
+                (exited ? ` (exit ${String(exitCode)})` : ''),
+        };
+    }
+    if (output.includes(API_LISTENING_MARKER)) {
+        return {
+            ok: true,
+            reason: `the scaffold's apps/api logged \`${API_LISTENING_MARKER}\``,
+        };
+    }
+    if (exited) {
+        return {
+            ok: false,
+            reason: `the scaffold's apps/api exited with code ${String(exitCode)} before logging ` +
+                `\`${API_LISTENING_MARKER}\``,
+        };
+    }
+    if (timedOut) {
+        return {
+            ok: false,
+            reason: `the scaffold's apps/api neither logged \`${API_LISTENING_MARKER}\` nor exited ` +
+                `within ${timeoutMs}ms`,
+        };
+    }
+    return {
+        ok: false,
+        reason: `the scaffold's apps/api boot ended with no observable outcome`,
+    };
+}

package/dist/lib/import-graph.d.ts

@@ -0,0 +1,29 @@
+export declare const SOURCE_EXTS: string[];
+/** Every source file under the given repo-relative roots, as "/"-joined paths. */
+export declare function listFilesUnder(repoRoot: string, roots: string[]): Set<string>;
+/** The relative import specifiers a source file names (static imports + re-exports). */
+export declare function relativeImportsOf(absPath: string): string[];
+/**
+ * Resolve a relative specifier against the candidate set. TypeScript ESM writes
+ * `./x.js` for `./x.ts`, so the `.js` → `.ts`/`.tsx` rewrite is the common case.
+ */
+export declare function resolveRelativeImport(fromFile: string, spec: string, candidates: Set<string>): string | undefined;
+/**
+ * The companion closure of `seeds` under `roots`: the seeds themselves plus
+ * every source file under `roots` that reaches one transitively through a
+ * relative import, to a fixed point.
+ *
+ * This is the shape both consumers need, and the reason the walk is shared
+ * rather than copied. `paidModuleTemplateExclusions()` seeds it with every
+ * paid module's `ownedFiles` to get the files a keyless starter must not
+ * carry; `tools/lint-slice-registration.ts` seeds it with the same set to
+ * derive, by subtraction, the files a scaffold ships UNCONDITIONALLY.
+ *
+ * Never a filename-stem rule (#5182 D7), which misses eleven files and
+ * over-marks three.
+ *
+ * @param repoRoot absolute path to the tree being walked.
+ * @param roots repo-relative roots the walk is confined to.
+ * @param seeds repo-relative, "/"-separated files the closure starts from.
+ */
+export declare function importClosure(repoRoot: string, roots: readonly string[], seeds: Iterable<string>): Set<string>;

package/dist/lib/import-graph.js

@@ -0,0 +1,140 @@
+/**
+ * The relative-import graph walker over a repo-relative source tree.
+ *
+ * Extracted from `module-architecture.ts` (#5701) so the two consumers that
+ * need this resolution share ONE implementation rather than two that can
+ * disagree:
+ *
+ * - `paidModuleTemplateExclusions()` (module-architecture.ts) walks it to take
+ *   the companion closure of every paid module's `ownedFiles` — the files that
+ *   would ship dangling into a keyless starter.
+ * - `tools/lint-slice-registration.ts` walks it to close over the specifiers an
+ *   `isModuleEnabled("X")` branch in `apps/api/src/server.ts` loads, and to
+ *   check every reached file against what module X's slice delivers.
+ *
+ * Both questions are "which files does this one reach through relative
+ * imports", and the answer must be the same function in both mouths: a lint
+ * that resolved specifiers differently from the exclusion set it checks
+ * against would pass on a tree the scaffold cannot boot.
+ *
+ * The resolution is deliberately TEXTUAL — a regex over import/export
+ * specifiers plus a candidate-set lookup, no type-checker and no bundler — so
+ * it runs inside `pnpm preflight`'s memory budget.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { dirname, join, sep } from "node:path";
+export const SOURCE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+/** Every source file under the given repo-relative roots, as "/"-joined paths. */
+export function listFilesUnder(repoRoot, roots) {
+    const out = new Set();
+    const skip = new Set(["node_modules", ".next", "dist", ".turbo", ".source"]);
+    const stack = roots.map((r) => r);
+    while (stack.length > 0) {
+        const rel = stack.pop();
+        const abs = join(repoRoot, rel);
+        let entries;
+        try {
+            entries = readdirSync(abs, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (skip.has(entry.name))
+                continue;
+            const childRel = `${rel}/${entry.name}`;
+            if (entry.isDirectory())
+                stack.push(childRel);
+            else if (SOURCE_EXTS.some((e) => entry.name.endsWith(e)))
+                out.add(childRel);
+        }
+    }
+    return out;
+}
+/** The relative import specifiers a source file names (static imports + re-exports). */
+export function relativeImportsOf(absPath) {
+    let src;
+    try {
+        src = readFileSync(absPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const m of src.matchAll(/(?:^|\n)\s*(?:import|export)[\s\S]{0,400}?from\s*["'](\.[^"']*)["']/g))
+        out.push(m[1]);
+    for (const m of src.matchAll(/\bimport\s*\(\s*["'](\.[^"']*)["']\s*\)/g))
+        out.push(m[1]);
+    return out;
+}
+/**
+ * Resolve a relative specifier against the candidate set. TypeScript ESM writes
+ * `./x.js` for `./x.ts`, so the `.js` → `.ts`/`.tsx` rewrite is the common case.
+ */
+export function resolveRelativeImport(fromFile, spec, candidates) {
+    const base = posixJoin(dirname(fromFile.split("/").join(sep)), spec);
+    const stem = base.replace(/\.(js|jsx|mjs|cjs)$/, "");
+    for (const cand of [
+        base,
+        ...SOURCE_EXTS.map((e) => stem + e),
+        ...SOURCE_EXTS.map((e) => `${stem}/index${e}`),
+    ])
+        if (candidates.has(cand))
+            return cand;
+    return undefined;
+}
+/** Join and normalize a "/"-separated path, resolving `.` and `..` segments. */
+function posixJoin(dir, spec) {
+    const parts = `${dir.split(sep).join("/")}/${spec}`.split("/");
+    const out = [];
+    for (const part of parts) {
+        if (part === "" || part === ".")
+            continue;
+        if (part === "..")
+            out.pop();
+        else
+            out.push(part);
+    }
+    return out.join("/");
+}
+/**
+ * The companion closure of `seeds` under `roots`: the seeds themselves plus
+ * every source file under `roots` that reaches one transitively through a
+ * relative import, to a fixed point.
+ *
+ * This is the shape both consumers need, and the reason the walk is shared
+ * rather than copied. `paidModuleTemplateExclusions()` seeds it with every
+ * paid module's `ownedFiles` to get the files a keyless starter must not
+ * carry; `tools/lint-slice-registration.ts` seeds it with the same set to
+ * derive, by subtraction, the files a scaffold ships UNCONDITIONALLY.
+ *
+ * Never a filename-stem rule (#5182 D7), which misses eleven files and
+ * over-marks three.
+ *
+ * @param repoRoot absolute path to the tree being walked.
+ * @param roots repo-relative roots the walk is confined to.
+ * @param seeds repo-relative, "/"-separated files the closure starts from.
+ */
+export function importClosure(repoRoot, roots, seeds) {
+    const closed = new Set(seeds);
+    const candidates = listFilesUnder(repoRoot, [...roots]);
+    for (;;) {
+        let grew = false;
+        for (const file of candidates) {
+            if (closed.has(file))
+                continue;
+            const imports = relativeImportsOf(join(repoRoot, file));
+            for (const spec of imports) {
+                const target = resolveRelativeImport(file, spec, candidates);
+                if (target !== undefined && closed.has(target)) {
+                    closed.add(file);
+                    grew = true;
+                    break;
+                }
+            }
+        }
+        if (!grew)
+            break;
+    }
+    return closed;
+}

package/dist/module-architecture.d.ts

@@ -397,4 +397,5 @@ export declare function normalizeModules(modules: string[]): ModuleName[];
  * whole invariant.
  */
 export declare function coOwnedModuleDestinations(): ReadonlySet<string>;
+export declare const EXCLUDE_TEMPLATE_DIRS: readonly string[];
 export declare function paidModuleTemplateExclusions(snapshotRoots: readonly string[], repoRoot: string): string[];