create-ailk 0.5.0 → 0.6.1

package/component-catalog.json

@@ -17,7 +17,7 @@
       "importPath": "@working-theory/ui/blocks",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/blocks",
-      "count": 86
+      "count": 95
     },
     {
       "name": "chrome",
@@ -25,7 +25,7 @@
       "importPath": "@working-theory/ui/chrome",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/chrome",
-      "count": 17
+      "count": 18
     },
     {
       "name": "primitives",
@@ -49,7 +49,7 @@
       "importPath": "@working-theory/templates/shells",
       "rootBarrel": "@working-theory/templates",
       "sourceRoot": "packages/templates/src/shells",
-      "count": 3
+      "count": 5
     },
     {
       "name": "docs-blog-blocks",
@@ -414,7 +414,7 @@
       "sourcePath": "packages/ui/src/sections/Hero.tsx",
       "importPath": "@working-theory/ui/sections",
       "exported": true,
-      "description": "Top-of-page introduction — headline, optional subhead and CTAs; use once per page as the first section.",
+      "description": "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.",
       "descriptionSource": "registry",
       "descriptionGrade": "strong",
       "sectionType": "hero"
@@ -804,14 +804,25 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "AssetLightbox",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/AssetLightbox.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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).",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "AuthCard",
       "tier": "blocks",
       "sourcePath": "packages/ui/src/blocks/AuthCard.tsx",
       "importPath": "@working-theory/ui/blocks",
       "exported": true,
-      "description": "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.",
-      "descriptionSource": "doc-comment",
+      "description": "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.",
+      "descriptionSource": "barrel",
       "descriptionGrade": "strong",
       "sectionType": null
     },
@@ -997,7 +1008,7 @@
       "sourcePath": "packages/ui/src/blocks/DescriptionList.tsx",
       "importPath": "@working-theory/ui/blocks",
       "exported": true,
-      "description": "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.",
+      "description": "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.",
       "descriptionSource": "barrel",
       "descriptionGrade": "strong",
       "sectionType": null
@@ -1167,6 +1178,28 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "ListRow",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/ListRow.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
+    {
+      "name": "ListTable",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/ListTable.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "LocaleSwitcher",
       "tier": "blocks",
@@ -1227,7 +1260,7 @@
       "tier": "blocks",
       "sourcePath": "packages/ui/src/blocks/MediaPlaceholder.tsx",
       "importPath": "@working-theory/ui/blocks",
-      "exported": false,
+      "exported": true,
       "description": "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.",
       "descriptionSource": "doc-comment",
       "descriptionGrade": "strong",
@@ -1453,6 +1486,28 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "ResponsiveSheet",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/ResponsiveSheet.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
+    {
+      "name": "RowGroup",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/RowGroup.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "SchedulerEmbed",
       "tier": "blocks",
@@ -1464,6 +1519,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "SectionActionRow",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/SectionActionRow.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "SectionHeader",
       "tier": "blocks",
@@ -1508,6 +1574,17 @@
       "descriptionGrade": "weak",
       "sectionType": null
     },
+    {
+      "name": "SortableList",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/SortableList.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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).",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "StatTicker",
       "tier": "blocks",
@@ -1541,6 +1618,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "SubscriptionStatusBanner",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/SubscriptionStatusBanner.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "SuggestionChipCarousel",
       "tier": "blocks",
@@ -1585,6 +1673,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "UpgradeDialog",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/UpgradeDialog.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "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).",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "UserBlock",
       "tier": "blocks",
@@ -1728,6 +1827,17 @@
       "descriptionGrade": "weak",
       "sectionType": null
     },
+    {
+      "name": "BottomTabBar",
+      "tier": "chrome",
+      "sourcePath": "packages/ui/src/chrome/BottomTabBar.tsx",
+      "importPath": "@working-theory/ui/chrome",
+      "exported": true,
+      "description": "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).",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "weak",
+      "sectionType": null
+    },
     {
       "name": "FacetNav",
       "tier": "chrome",
@@ -2795,6 +2905,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "AccountShell",
+      "tier": "shells",
+      "sourcePath": "packages/templates/src/shells/AccountShell.tsx",
+      "importPath": "@working-theory/templates/shells",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "AppShell",
       "tier": "shells",
@@ -2806,6 +2927,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "AuthShell",
+      "tier": "shells",
+      "sourcePath": "packages/templates/src/shells/AuthShell.tsx",
+      "importPath": "@working-theory/templates/shells",
+      "exported": true,
+      "description": "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.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "DeckHeroObserver",
       "tier": "shells",
@@ -3284,7 +3416,7 @@
     {
       "type": "hero",
       "component": "Hero",
-      "whenToUse": "Top-of-page introduction — headline, optional subhead and CTAs; use once per page as the first section.",
+      "whenToUse": "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.",
       "schema": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "type": "object",
@@ -3339,7 +3471,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "quickSearch": {
@@ -3498,6 +3631,9 @@
           "imagerySlot": {
             "type": "boolean"
           },
+          "imagerySlotLabel": {
+            "type": "string"
+          },
           "subtitleSize": {
             "type": "string",
             "enum": [
@@ -4358,6 +4494,54 @@
               "viewport"
             ]
           },
+          "backdrop": {
+            "type": "object",
+            "properties": {
+              "src": {
+                "type": "string"
+              },
+              "alt": {
+                "type": "string"
+              },
+              "width": {
+                "type": "number"
+              },
+              "height": {
+                "type": "number"
+              },
+              "blurDataURL": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "src",
+              "alt"
+            ]
+          },
+          "lockup": {
+            "type": "object",
+            "properties": {
+              "src": {
+                "type": "string"
+              },
+              "alt": {
+                "type": "string"
+              },
+              "width": {
+                "type": "number"
+              },
+              "height": {
+                "type": "number"
+              },
+              "blurDataURL": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "src",
+              "alt"
+            ]
+          },
           "logoStrip": {
             "type": "object",
             "properties": {
@@ -4590,7 +4774,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "headlineSize": {
@@ -4839,7 +5024,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           }
         },
@@ -5030,7 +5216,22 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
+            ]
+          },
+          "align": {
+            "type": "string",
+            "enum": [
+              "start",
+              "center"
+            ]
+          },
+          "fill": {
+            "type": "string",
+            "enum": [
+              "natural",
+              "viewport"
             ]
           }
         }
@@ -5166,7 +5367,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "headlineSize": {
@@ -5359,7 +5561,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "headlineSize": {
@@ -5699,7 +5902,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "headlineSize": {
@@ -5831,7 +6035,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           }
         },
@@ -6453,7 +6658,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "keyPointsPanel": {
@@ -6671,7 +6877,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "chips": {
@@ -6762,8 +6969,50 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
+          },
+          "actions": {
+            "minItems": 1,
+            "maxItems": 2,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "link",
+                    "button"
+                  ]
+                },
+                "label": {
+                  "type": "string"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "external": {
+                  "type": "boolean"
+                },
+                "variant": {
+                  "type": "string",
+                  "enum": [
+                    "default",
+                    "outline",
+                    "ghost",
+                    "link",
+                    "destructive"
+                  ]
+                }
+              },
+              "required": [
+                "kind",
+                "label",
+                "href"
+              ]
+            }
           }
         },
         "required": [
@@ -7050,7 +7299,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           }
         },
@@ -7632,6 +7882,18 @@
               "loose"
             ]
           },
+          "phoneColumns": {
+            "anyOf": [
+              {
+                "type": "number",
+                "const": 1
+              },
+              {
+                "type": "number",
+                "const": 2
+              }
+            ]
+          },
           "surface": {
             "type": "string",
             "enum": [
@@ -7639,8 +7901,50 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
+          },
+          "actions": {
+            "minItems": 1,
+            "maxItems": 2,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "link",
+                    "button"
+                  ]
+                },
+                "label": {
+                  "type": "string"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "external": {
+                  "type": "boolean"
+                },
+                "variant": {
+                  "type": "string",
+                  "enum": [
+                    "default",
+                    "outline",
+                    "ghost",
+                    "link",
+                    "destructive"
+                  ]
+                }
+              },
+              "required": [
+                "kind",
+                "label",
+                "href"
+              ]
+            }
           }
         },
         "required": [
@@ -8208,7 +8512,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "successRedirect": {
@@ -9137,7 +9442,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           },
           "provider": {
@@ -9542,7 +9848,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           }
         },
@@ -9955,7 +10262,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           }
         },
@@ -10093,7 +10401,8 @@
               "gray-100",
               "wash",
               "wash-secondary",
-              "gradient-brand"
+              "gradient-brand",
+              "gradient-dark"
             ]
           }
         },