themelia-react-ui 1.0.1 → 2.0.0

package/docs/consumer-skill/references/public-api.json

@@ -2,10 +2,11 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "stylesheets": [
     "themelia-react-ui/style.css",
     "themelia-react-ui/theme.css",
+    "themelia-react-ui/themes/green.css",
     "themelia-react-ui/features/map/style.css"
   ],
   "peers": [
@@ -240,7 +241,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/action-presentation",
@@ -257,7 +259,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/accordion",
@@ -349,7 +352,8 @@
             "themelia-react-ui/base/display"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/action-menu",
@@ -524,7 +528,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/attachment",
@@ -588,6 +593,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "Attachment"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -807,7 +827,8 @@
             "themelia-react-ui/base/avatar"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/badge",
@@ -876,6 +897,21 @@
             "themelia-react-ui/base/display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -1097,6 +1133,111 @@
             "themelia-react-ui/typography"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/destructive-confirm.tsx",
+          "exports": [
+            "DeleteAccount"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetail"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/edit.tsx",
+          "exports": [
+            "AccountEdit"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/workflows.md#validated-editing"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        },
+        {
+          "file": "examples/website.tsx",
+          "exports": [
+            "WebsiteLandingPage"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/composition.md#public-websites-and-service-overviews",
+            "references/composition.md#visual-heading-emphasis"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -1131,6 +1272,15 @@
         "defaultSmartCardStrings",
         "hasRenderableContent"
       ],
+      "deprecated": {
+        "SmartCard": "Use Card.",
+        "SmartCardAction": "Use CardAction.",
+        "SmartCardProps": "Use CardProps.",
+        "SmartCardSkeleton": "Use CardSkeleton.",
+        "SmartCardSkeletonProps": "Use CardSkeletonProps.",
+        "SmartCardStrings": "Use CardStrings.",
+        "SmartCardSurface": "Use CardSurface."
+      },
       "optionalPeers": [],
       "layer": "base",
       "responsibility": "Base family: Card.",
@@ -1144,7 +1294,10 @@
         "foundations"
       ],
       "aliases": [
-        "base/content-block"
+        "base/content-block",
+        "card header footer",
+        "card padding",
+        "card separators"
       ],
       "sections": [
         "Base components"
@@ -1174,7 +1327,10 @@
             "cards"
           ],
           "aliases": [
-            "base/content-block"
+            "base/content-block",
+            "card padding",
+            "card header footer",
+            "card separators"
           ],
           "section": "Base components",
           "browse": {
@@ -1210,7 +1366,10 @@
             },
             {
               "title": "Card actions",
-              "symbols": []
+              "symbols": [
+                "CardPrimaryAction",
+                "CardActionStrip"
+              ]
             },
             {
               "title": "Alerts",
@@ -1245,6 +1404,153 @@
             "themelia-react-ui/base/structure"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetail"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/edit.tsx",
+          "exports": [
+            "AccountEdit"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/workflows.md#validated-editing"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "HierarchyCapture"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "GuidedRequest"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
+        {
+          "file": "examples/planning-usage-edit.tsx",
+          "exports": [
+            "WorkspaceSummary"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#task-and-usage-summaries-editable-fields",
+            "references/workflows.md#task-summaries-usage-and-inline-editing"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/website.tsx",
+          "exports": [
+            "WebsiteLandingPage"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/composition.md#public-websites-and-service-overviews",
+            "references/composition.md#visual-heading-emphasis"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -1346,7 +1652,8 @@
             "themelia-react-ui/base/structure"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/cascader",
@@ -1402,6 +1709,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "HierarchyCapture"
+          ],
+          "symbols": [
+            "Cascader"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -1490,7 +1812,8 @@
             "themelia-react-ui/blocks/analytics"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/choice-inputs",
@@ -1939,7 +2262,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/code-block",
@@ -1994,6 +2318,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "CodeBlock"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -2087,7 +2426,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/command",
@@ -2173,7 +2513,8 @@
             "themelia-react-ui/features/global-search"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/copyable",
@@ -2257,7 +2598,8 @@
             "themelia-react-ui/primitives"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/date-pickers",
@@ -2501,7 +2843,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/display",
@@ -2554,6 +2897,14 @@
         "defaultContentBlockStrings",
         "defaultDateBlockStrings"
       ],
+      "deprecated": {
+        "ContentBlock": "Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockPadding": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockProps": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockStrings": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockSurface": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockTitleSize": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content."
+      },
       "optionalPeers": [],
       "layer": "base",
       "responsibility": "Base family: Boolean indicator; Collapsible; Date block; Icon badge; Placeholder pattern; Scroll area; Separator; Tooltip; Visually hidden.",
@@ -2979,6 +3330,21 @@
             "themelia-react-ui/base/display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Separator"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -3332,6 +3698,24 @@
             "themelia-react-ui/base/spinner"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/analytics.tsx",
+          "exports": [
+            "RevenueOverview"
+          ],
+          "symbols": [
+            "ErrorState",
+            "LoadingState"
+          ],
+          "references": [
+            "references/analytics.md#dashboard-and-revenue-data"
+          ],
+          "optionalPeers": [
+            "recharts"
+          ]
+        }
       ]
     },
     {
@@ -3804,6 +4188,23 @@
             "themelia-react-ui/features/schema-form"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/edit.tsx",
+          "exports": [
+            "AccountEdit"
+          ],
+          "symbols": [
+            "FormField"
+          ],
+          "references": [
+            "references/workflows.md#validated-editing"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        }
       ]
     },
     {
@@ -4252,7 +4653,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/inline-edit",
@@ -4336,6 +4738,23 @@
             "themelia-react-ui/features/resource-assignment"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/planning-usage-edit.tsx",
+          "exports": [
+            "WorkspaceSummary"
+          ],
+          "symbols": [
+            "InlineEdit"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#task-and-usage-summaries-editable-fields",
+            "references/workflows.md#task-summaries-usage-and-inline-editing"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -4442,6 +4861,21 @@
             "themelia-react-ui/blocks/data-display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Item"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -4511,7 +4945,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/navigation",
@@ -4834,7 +5269,8 @@
             {
               "title": "API",
               "symbols": [
-                "NavigationTabs"
+                "NavigationTabs",
+                "TabsList"
               ]
             }
           ],
@@ -4968,7 +5404,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/popover",
@@ -5056,7 +5493,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/popover-menu",
@@ -5147,7 +5585,8 @@
             "themelia-react-ui/base/popover"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/qr-code",
@@ -5220,7 +5659,8 @@
             "themelia-react-ui/primitives"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/repeaters",
@@ -5601,7 +6041,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/sheet",
@@ -5617,11 +6058,22 @@
         "SheetTitle",
         "SheetTrigger"
       ],
+      "deprecated": {
+        "Sheet": "Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetBody": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetClose": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetContent": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetDescription": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetFooter": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetHeader": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetTitle": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetTrigger": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`."
+      },
       "optionalPeers": [],
       "layer": "base",
       "responsibility": "Base family: Sheet.",
       "jobs": [
-        "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
+        "Maintaining code that still imports the deprecated Sheet parts."
       ],
       "tags": [
         "base",
@@ -5635,16 +6087,16 @@
       "guidance": [
         {
           "title": "Sheet",
-          "description": "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy.",
+          "description": "Maintaining code that still imports the deprecated Sheet parts.",
           "chooseWhen": [
-            "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
+            "Maintaining code that still imports the deprecated Sheet parts."
           ],
           "avoidWhen": [
-            "The workflow fits a centered dialog or the standard callback-driven drawer recipe."
+            "Any new dialog, drawer or side panel: use ActionDialog, ConfirmDialog or ActionDrawer from features/overlays."
           ],
           "appOwned": [],
           "jobs": [
-            "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
+            "Maintaining code that still imports the deprecated Sheet parts."
           ],
           "tags": [
             "base",
@@ -5684,7 +6136,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/sidebar",
@@ -5800,6 +6253,23 @@
             "themelia-react-ui/layout/sidebar"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "SidebarTrigger"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -5864,6 +6334,22 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "HierarchyCapture"
+          ],
+          "symbols": [
+            "SignaturePad",
+            "SignaturePadValue"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -6145,7 +6631,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/spinner",
@@ -6232,7 +6719,8 @@
             "themelia-react-ui/base/skeleton"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/structure",
@@ -6258,21 +6746,32 @@
       "layer": "base",
       "responsibility": "Base family: Structural composition.",
       "jobs": [
-        "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
+        "Compose layout blocks, vertical siblings, a horizontal row, wrapping actions, responsive grids and peer card gaps."
       ],
       "tags": [
         "base",
         "foundations",
         "structure"
       ],
-      "aliases": [],
+      "aliases": [
+        "copy gaps",
+        "copy-gap",
+        "horizontal row",
+        "layout blocks",
+        "peer card gaps",
+        "title description spacing"
+      ],
+      "references": [
+        "references/design-contract.md",
+        "references/theming.md#copy-rhythm"
+      ],
       "sections": [
         "Foundations"
       ],
       "guidance": [
         {
           "title": "Structural composition",
-          "description": "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks.",
+          "description": "Compose passive layout blocks with Stack rows, responsive Grid tracks, GridCell spans and available-width AdaptiveGrid.",
           "chooseWhen": [
             "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
           ],
@@ -6281,14 +6780,18 @@
           ],
           "appOwned": [],
           "jobs": [
-            "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
+            "Compose layout blocks, vertical siblings, a horizontal row, wrapping actions, responsive grids and peer card gaps."
           ],
           "tags": [
             "base",
             "foundations",
             "structure"
           ],
-          "aliases": [],
+          "aliases": [
+            "layout blocks",
+            "horizontal row",
+            "peer card gaps"
+          ],
           "section": "Foundations",
           "browse": {
             "category": "foundations",
@@ -6335,52 +6838,213 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
-    },
-    {
-      "import": "themelia-react-ui/base/table",
-      "declaration": "dist/components/base/table/index.d.ts",
-      "symbols": [
-        "Table",
-        "TableBody",
-        "TableBodyProps",
-        "TableCaption",
-        "TableCaptionProps",
-        "TableCell",
-        "TableCellProps",
-        "TableFooter",
-        "TableFooterProps",
-        "TableHead",
-        "TableHeadProps",
-        "TableHeader",
-        "TableHeaderProps",
-        "TableProps",
-        "TableRow",
-        "TableRowProps"
-      ],
-      "optionalPeers": [],
-      "layer": "base",
-      "responsibility": "Base family: Table primitives.",
-      "jobs": [
-        "Custom semantic table markup only needs package-styled HTML table parts."
-      ],
-      "tags": [
-        "base",
-        "navigation & data",
-        "table"
-      ],
-      "aliases": [],
-      "sections": [
-        "Base components"
       ],
-      "guidance": [
+      "recipes": [
         {
-          "title": "Table primitives",
-          "description": "Custom semantic table markup only needs package-styled HTML table parts.",
-          "chooseWhen": [
-            "Custom semantic table markup only needs package-styled HTML table parts."
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
           ],
-          "avoidWhen": [
+          "symbols": [
+            "Grid",
+            "Stack"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/destructive-confirm.tsx",
+          "exports": [
+            "DeleteAccount"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/edit.tsx",
+          "exports": [
+            "AccountEdit"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/workflows.md#validated-editing"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "HierarchyCapture"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
+        {
+          "file": "examples/layout-blocks.tsx",
+          "exports": [
+            "LayoutBlocks"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#horizontal-rows",
+            "references/composition.md#main-and-aside-card-gaps",
+            "references/composition.md#structure-and-spacing"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/planning-usage-edit.tsx",
+          "exports": [
+            "WorkspaceSummary"
+          ],
+          "symbols": [
+            "AdaptiveGrid",
+            "Stack"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#task-and-usage-summaries-editable-fields",
+            "references/workflows.md#task-summaries-usage-and-inline-editing"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        },
+        {
+          "file": "examples/website.tsx",
+          "exports": [
+            "WebsiteLandingPage"
+          ],
+          "symbols": [
+            "Grid",
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#public-websites-and-service-overviews",
+            "references/composition.md#visual-heading-emphasis"
+          ],
+          "optionalPeers": []
+        }
+      ]
+    },
+    {
+      "import": "themelia-react-ui/base/table",
+      "declaration": "dist/components/base/table/index.d.ts",
+      "symbols": [
+        "Table",
+        "TableBody",
+        "TableBodyProps",
+        "TableCaption",
+        "TableCaptionProps",
+        "TableCell",
+        "TableCellProps",
+        "TableFooter",
+        "TableFooterProps",
+        "TableHead",
+        "TableHeadProps",
+        "TableHeader",
+        "TableHeaderProps",
+        "TableProps",
+        "TableRow",
+        "TableRowProps"
+      ],
+      "optionalPeers": [],
+      "layer": "base",
+      "responsibility": "Base family: Table primitives.",
+      "jobs": [
+        "Custom semantic table markup only needs package-styled HTML table parts."
+      ],
+      "tags": [
+        "base",
+        "navigation & data",
+        "table"
+      ],
+      "aliases": [],
+      "sections": [
+        "Base components"
+      ],
+      "guidance": [
+        {
+          "title": "Table primitives",
+          "description": "Custom semantic table markup only needs package-styled HTML table parts.",
+          "chooseWhen": [
+            "Custom semantic table markup only needs package-styled HTML table parts."
+          ],
+          "avoidWhen": [
             "Sorting, selection, density, sticky headers, row actions, or column behavior is required."
           ],
           "appOwned": [],
@@ -6417,7 +7081,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/text-inputs",
@@ -6664,6 +7329,36 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Input"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/edit.tsx",
+          "exports": [
+            "AccountEdit"
+          ],
+          "symbols": [
+            "Input"
+          ],
+          "references": [
+            "references/workflows.md#validated-editing"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        }
       ]
     },
     {
@@ -6740,7 +7435,8 @@
             "themelia-react-ui/base/forms"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/tree",
@@ -6794,6 +7490,22 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "HierarchyCapture"
+          ],
+          "symbols": [
+            "Tree",
+            "TreeNode"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -7075,7 +7787,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/upload-queue",
@@ -7201,7 +7914,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/value-inputs",
@@ -7495,7 +8209,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/admin",
@@ -7727,7 +8442,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/ai",
@@ -8826,7 +9542,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/analytics",
@@ -8840,6 +9557,7 @@
         "AnalyticsStrings",
         "ChartCard",
         "ChartCardProps",
+        "FormatMetricValueOptions",
         "Metric",
         "MetricBar",
         "MetricBarProps",
@@ -8900,14 +9618,14 @@
       "responsibility": "Blocks family: Activity heatmap; Analytics bar; Analytics overview; Chart card; Comparison; Gradient cards; Metric parts; Micro chart grid; Stat cards; Time distribution.",
       "jobs": [
         "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics.",
+        "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface.",
+        "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer.",
         "Use Activity heatmap in an admin interface.",
-        "Use Analytics bar in an admin interface.",
         "Use Chart card in an admin interface.",
         "Use Comparison in an admin interface.",
         "Use Gradient cards in an admin interface.",
         "Use Metric parts in an admin interface.",
         "Use Micro chart grid in an admin interface.",
-        "Use Stat cards in an admin interface.",
         "Use Time distribution in an admin interface."
       ],
       "tags": [
@@ -8925,7 +9643,26 @@
         "stat-cards",
         "time-ruler"
       ],
-      "aliases": [],
+      "aliases": [
+        "KPI grid",
+        "KPI strip",
+        "dashboard KPIs",
+        "dashboard metrics",
+        "kpi",
+        "kpi card",
+        "metric card",
+        "metric grid",
+        "number card",
+        "revenue card",
+        "revenue overview",
+        "single KPI",
+        "single metric",
+        "stat",
+        "stat cards",
+        "statistic cards",
+        "statistics",
+        "statistics cards"
+      ],
       "sections": [
         "Blocks"
       ],
@@ -8939,7 +9676,11 @@
           "avoidWhen": [
             "The content is one simple label/value pair or factual metadata about an entity."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "metric meaning, accepted values and comparison baselines",
+            "transport, refresh and period changes",
+            "choice of one tile, peer cards or a shared strip"
+          ],
           "jobs": [
             "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics."
           ],
@@ -8972,19 +9713,34 @@
         },
         {
           "title": "Analytics bar",
-          "description": "`MetricBar` — horizontal KPI strip with hairline-divided cells. Pair with `MetricGrid` for card-style layouts.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer.",
+          "chooseWhen": [
+            "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer."
+          ],
+          "avoidWhen": [
+            "Only one metric, quota usage, factual metadata or a bespoke chart is required."
+          ],
+          "appOwned": [
+            "metric meaning, accepted values and comparison baselines",
+            "requests, refresh and period changes",
+            "error/empty/retry regions around the collection"
+          ],
           "jobs": [
-            "Use Analytics bar in an admin interface."
+            "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer."
           ],
           "tags": [
             "blocks",
             "analytics",
             "bar"
           ],
-          "aliases": [],
+          "aliases": [
+            "dashboard KPIs",
+            "dashboard metrics",
+            "revenue overview",
+            "KPI grid",
+            "metric grid",
+            "KPI strip"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -9009,7 +9765,12 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/chart",
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/analytics/usage-card",
+            "themelia-react-ui/blocks/data-display"
+          ]
         },
         {
           "title": "Chart card",
@@ -9057,7 +9818,7 @@
         },
         {
           "title": "Comparison",
-          "description": "`MetricComparison` — side-by-side current vs previous with a tone-tinted delta box. Reuses the unified `MetricData` shape so currency/percent formatting carries through.",
+          "description": "`MetricComparison` — side-by-side current vs previous with a signed delta badge. Reuses the unified `MetricData` shape so currency/percent formatting carries through.",
           "chooseWhen": [],
           "avoidWhen": [],
           "appOwned": [],
@@ -9267,19 +10028,40 @@
         },
         {
           "title": "Stat cards",
-          "description": "Two stat tile flavors built from the unified `Metric` component — `accent` (dark surface + sparkline) and `colored` (segmented progress bar).",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface.",
+          "chooseWhen": [
+            "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface."
+          ],
+          "avoidWhen": [
+            "Several KPI cards need parent-responsive layout, or the value is a simple factual label/value pair."
+          ],
+          "appOwned": [
+            "metric meaning, accepted value and comparison baseline",
+            "requests, refresh and retry actions",
+            "semantic trend override when falling values are good"
+          ],
           "jobs": [
-            "Use Stat cards in an admin interface."
+            "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface."
           ],
           "tags": [
             "blocks",
             "analytics",
             "stat-cards"
           ],
-          "aliases": [],
+          "aliases": [
+            "statistic cards",
+            "statistics cards",
+            "stat cards",
+            "single KPI",
+            "single metric",
+            "revenue card",
+            "kpi",
+            "metric card",
+            "kpi card",
+            "number card",
+            "statistics",
+            "stat"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -9303,7 +10085,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/data-display"
+          ]
         },
         {
           "title": "Time distribution",
@@ -9345,6 +10130,40 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/analytics.tsx",
+          "exports": [
+            "RevenueOverview"
+          ],
+          "symbols": [
+            "MetricData",
+            "MetricGrid"
+          ],
+          "references": [
+            "references/analytics.md#dashboard-and-revenue-data"
+          ],
+          "optionalPeers": [
+            "recharts"
+          ]
+        },
+        {
+          "file": "examples/analytics.tsx",
+          "exports": [
+            "RevenueMetric"
+          ],
+          "symbols": [
+            "Metric",
+            "MetricData"
+          ],
+          "references": [
+            "references/analytics.md#dashboard-and-revenue-data"
+          ],
+          "optionalPeers": [
+            "recharts"
+          ]
+        }
       ]
     },
     {
@@ -9366,9 +10185,7 @@
       "layer": "blocks",
       "responsibility": "Blocks family: Usage card.",
       "jobs": [
-        "Daily usage",
-        "Period selection",
-        "Quota summary"
+        "UsageCard needs used/limit quotas, category shares, daily usage and controlled period/loading/error/retry states in one owned Card."
       ],
       "tags": [
         "billing summary",
@@ -9379,7 +10196,12 @@
         "resources",
         "usage"
       ],
-      "aliases": [],
+      "aliases": [
+        "quota dashboard",
+        "resource limits",
+        "usage statistics",
+        "usage summary"
+      ],
       "sections": [
         "Blocks"
       ],
@@ -9388,18 +10210,18 @@
           "title": "Usage card",
           "description": "Quota summaries, category shares, daily analytics and resource limits with app-owned period data.",
           "chooseWhen": [
-            "Application-supplied usage needs a composed quota and analytics summary."
+            "UsageCard needs used/limit quotas, category shares, daily usage and controlled period/loading/error/retry states in one owned Card."
           ],
           "avoidWhen": [
-            "The component needs to fetch billing data or execute subscription changes itself."
+            "The subject is a general revenue KPI or an arbitrary chart series."
           ],
           "appOwned": [
-            "Persistence, permissions, data requests and navigation."
+            "usage values, limits and chronological daily data",
+            "period selection, requests and stale-result handling",
+            "billing or navigation footer actions"
           ],
           "jobs": [
-            "Quota summary",
-            "Daily usage",
-            "Period selection"
+            "UsageCard needs used/limit quotas, category shares, daily usage and controlled period/loading/error/retry states in one owned Card."
           ],
           "tags": [
             "blocks",
@@ -9410,7 +10232,12 @@
             "resources",
             "billing summary"
           ],
-          "aliases": [],
+          "aliases": [
+            "usage statistics",
+            "usage summary",
+            "quota dashboard",
+            "resource limits"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -9427,10 +10254,28 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/base/feedback",
-            "themelia-react-ui/blocks/analytics"
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/data-display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/planning-usage-edit.tsx",
+          "exports": [
+            "WorkspaceSummary"
+          ],
+          "symbols": [
+            "UsageCard",
+            "UsageCardData"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#task-and-usage-summaries-editable-fields",
+            "references/workflows.md#task-summaries-usage-and-inline-editing"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -9454,35 +10299,47 @@
       "layer": "blocks",
       "responsibility": "Blocks family: Message.",
       "jobs": [
-        "Conversation message composition without service, routing or transport assumptions."
+        "Message and MessageBubble present chat messages, author, delivery state, rich content and actions."
       ],
       "tags": [
         "blocks",
         "collaboration"
       ],
-      "aliases": [],
+      "aliases": [
+        "chat",
+        "chat message",
+        "conversation transcript",
+        "message bubble"
+      ],
       "sections": [
         "Blocks"
       ],
       "guidance": [
         {
           "title": "Message",
-          "description": "Conversation message composition without service, routing or transport assumptions.",
+          "description": "Message and MessageBubble present chat messages, author, delivery state, rich content and actions.",
           "chooseWhen": [
-            "Conversation message composition without service, routing or transport assumptions."
+            "Message and MessageBubble present chat messages, author, delivery state, rich content and actions."
+          ],
+          "avoidWhen": [
+            "A complete AI conversation workflow with prompt submission is required."
           ],
-          "avoidWhen": [],
           "appOwned": [
-            "Application data, persistence and business effects."
+            "message data, transport, delivery state and action callbacks"
           ],
           "jobs": [
-            "Conversation message composition without service, routing or transport assumptions."
+            "Message and MessageBubble present chat messages, author, delivery state, rich content and actions."
           ],
           "tags": [
             "blocks",
             "collaboration"
           ],
-          "aliases": [],
+          "aliases": [
+            "chat",
+            "chat message",
+            "message bubble",
+            "conversation transcript"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -9490,8 +10347,37 @@
             "domain": "",
             "collection": ""
           },
-          "sections": [],
-          "alternatives": []
+          "sections": [
+            {
+              "title": "Message anatomy",
+              "symbols": [
+                "Message",
+                "MessageBubble",
+                "MessageContent",
+                "MessageHeader",
+                "MessageActions",
+                "MessageStatus"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/features/ai-chat"
+          ]
+        }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "Message"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -10784,7 +11670,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/commerce/receipt",
@@ -10885,6 +11772,23 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Receipt",
+            "ReceiptItems",
+            "ReceiptLineItem"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -10969,8 +11873,13 @@
         "blocks/metadata-list",
         "blocks/relationship-card-frame",
         "contact details",
+        "details",
         "fact list",
-        "read-only facts"
+        "inline fact",
+        "key value",
+        "plain label value",
+        "read-only facts",
+        "simple statistic"
       ],
       "sections": [
         "Blocks"
@@ -11142,7 +12051,10 @@
           "avoidWhen": [
             "Several entity facts or KPI trend/chart behavior are required."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "label, value and formatting policy",
+            "subject framing at the composition boundary"
+          ],
           "jobs": [
             "One compact label/value pair needs inline emphasis without trend or chart semantics."
           ],
@@ -11153,7 +12065,12 @@
             "inline-stat"
           ],
           "aliases": [
-            "blocks/inline-stat"
+            "blocks/inline-stat",
+            "simple statistic",
+            "plain label value",
+            "inline fact",
+            "key value",
+            "details"
           ],
           "section": "Blocks",
           "browse": {
@@ -11210,7 +12127,9 @@
             "blocks/metadata-list",
             "fact list",
             "read-only facts",
-            "contact details"
+            "contact details",
+            "key value",
+            "details"
           ],
           "section": "Blocks",
           "browse": {
@@ -11319,16 +12238,93 @@
             "themelia-react-ui/features/resource-assignment"
           ]
         }
-      ]
-    },
-    {
-      "import": "themelia-react-ui/blocks/onboarding",
-      "declaration": "dist/components/blocks/onboarding/index.d.ts",
-      "symbols": [
-        "OnboardingChecklist",
-        "OnboardingChecklistProps",
-        "OnboardingChecklistStep",
-        "OnboardingChecklistStrings",
+      ],
+      "recipes": [
+        {
+          "file": "examples/analytics.tsx",
+          "exports": [
+            "RevenueOverview"
+          ],
+          "symbols": [
+            "EmptyState"
+          ],
+          "references": [
+            "references/analytics.md#dashboard-and-revenue-data"
+          ],
+          "optionalPeers": [
+            "recharts"
+          ]
+        },
+        {
+          "file": "examples/analytics.tsx",
+          "exports": [
+            "PlainStatistic"
+          ],
+          "symbols": [
+            "InlineStat"
+          ],
+          "references": [
+            "references/analytics.md#dashboard-and-revenue-data"
+          ],
+          "optionalPeers": [
+            "recharts"
+          ]
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetail"
+          ],
+          "symbols": [
+            "MetadataList"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "MetadataList"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "MetadataList"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
+      ]
+    },
+    {
+      "import": "themelia-react-ui/blocks/onboarding",
+      "declaration": "dist/components/blocks/onboarding/index.d.ts",
+      "symbols": [
+        "OnboardingChecklist",
+        "OnboardingChecklistProps",
+        "OnboardingChecklistStep",
+        "OnboardingChecklistStrings",
         "OnboardingChecklistVariant",
         "OnboardingStepStatus",
         "StepStatusIndicator",
@@ -11387,7 +12383,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/planning",
@@ -11469,6 +12466,24 @@
             "themelia-react-ui/features/kanban"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/planning-usage-edit.tsx",
+          "exports": [
+            "WorkspaceSummary"
+          ],
+          "symbols": [
+            "TaskCard",
+            "TaskCardItem"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#task-and-usage-summaries-editable-fields",
+            "references/workflows.md#task-summaries-usage-and-inline-editing"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -11568,7 +12583,7 @@
         },
         {
           "title": "Changelog",
-          "description": "ChangelogTimeline renders release history as a marker rail, mapping added, removed, modified, and fixed to colour-coded chips with version, author, and timestamp.",
+          "description": "ChangelogTimeline renders release history as a marker rail, mapping added, removed, modified, and fixed to neutral kind chips and marker icons with version, author, and timestamp.",
           "chooseWhen": [],
           "avoidWhen": [],
           "appOwned": [],
@@ -11731,7 +12746,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/component-vocabulary",
@@ -11753,7 +12769,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/activities",
@@ -11953,7 +12970,8 @@
             "themelia-react-ui/features/comments"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/ai-chat",
@@ -12071,7 +13089,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/async-preview",
@@ -12197,7 +13216,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/combobox",
@@ -12395,7 +13415,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/comments",
@@ -12515,7 +13536,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/data-view",
@@ -12690,7 +13712,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/email-composer",
@@ -12806,6 +13829,44 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/email-composer.tsx",
+          "exports": [
+            "CustomerEmail"
+          ],
+          "symbols": [
+            "ComposerDraft",
+            "EmailComposer",
+            "PreparedEmail"
+          ],
+          "references": [
+            "references/integration.md#dialogs-confirmations-and-drawers"
+          ],
+          "optionalPeers": [
+            "@tiptap/react",
+            "@tiptap/starter-kit"
+          ]
+        },
+        {
+          "file": "examples/email-composer.tsx",
+          "exports": [
+            "TemplateEmail"
+          ],
+          "symbols": [
+            "EmailComposer",
+            "EmailComposerProps",
+            "PreparedEmail"
+          ],
+          "references": [
+            "references/integration.md#dialogs-confirmations-and-drawers"
+          ],
+          "optionalPeers": [
+            "@tiptap/react",
+            "@tiptap/starter-kit"
+          ]
+        }
       ]
     },
     {
@@ -12840,7 +13901,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/event-calendar",
@@ -13074,7 +14136,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/filters",
@@ -13241,6 +14304,29 @@
             "themelia-react-ui/features/data-view"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "ActiveFilter",
+            "FilterConfig",
+            "FilterLayout",
+            "FilterProvider",
+            "FilterType"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        }
       ]
     },
     {
@@ -13337,7 +14423,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/kanban",
@@ -13432,7 +14519,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/map",
@@ -13606,7 +14694,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/media-library",
@@ -13799,7 +14888,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/mentions",
@@ -13892,7 +14982,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/overlays",
@@ -13950,7 +15041,7 @@
             "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior."
           ],
           "avoidWhen": [
-            "The caller needs custom compound anatomy without the shared action lifecycle."
+            "The surface is anchored to a trigger (a popover, menu, select or tooltip) rather than a dialog."
           ],
           "appOwned": [],
           "jobs": [
@@ -13983,9 +15074,39 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/base/sheet"
+            "themelia-react-ui/base/popover",
+            "themelia-react-ui/layout/sidebar"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "ActionDialog",
+            "useOverlayVisibility"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/destructive-confirm.tsx",
+          "exports": [
+            "DeleteAccount"
+          ],
+          "symbols": [
+            "ConfirmDialog"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -14424,7 +15545,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/questionnaire",
@@ -14489,6 +15611,23 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "GuidedRequest"
+          ],
+          "symbols": [
+            "Questionnaire",
+            "QuestionnaireAnswers",
+            "QuestionnaireQuestion"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -14579,7 +15718,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/resource-assignment",
@@ -14661,7 +15801,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/rich-text-editor",
@@ -14736,7 +15877,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/schema-form",
@@ -14840,7 +15982,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/suggestions",
@@ -14909,7 +16052,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/sync",
@@ -14980,7 +16124,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/table",
@@ -15162,6 +16307,43 @@
             "themelia-react-ui/features/data-view"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "DataTable",
+            "DataTableProps"
+          ],
+          "references": [
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "DataTable",
+            "DataTableProps",
+            "ResourceCell"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        }
       ]
     },
     {
@@ -15348,7 +16530,8 @@
             "themelia-react-ui/base/repeaters"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout",
@@ -15460,6 +16643,7 @@
         "PageActionsProps",
         "PageActionsStrings",
         "PageHeader",
+        "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderSlots",
         "PageProps",
@@ -15590,7 +16774,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/app-shell",
@@ -15623,7 +16808,7 @@
       "responsibility": "Layout family: App shell; Application shell.",
       "jobs": [
         "Build a responsive admin application shell with header, sidebar, navigation, and one page viewport.",
-        "Use App shell in an admin interface."
+        "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport."
       ],
       "tags": [
         "app-shell",
@@ -15634,7 +16819,13 @@
         "shell",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "admin workspace",
+        "application shell",
+        "dark header",
+        "dark header layout",
+        "light header"
+      ],
       "sections": [
         "Layouts",
         "Recipes"
@@ -15689,19 +16880,33 @@
         },
         {
           "title": "App shell",
-          "description": "Standalone header-first shell with a 70px+ topbar and a sidebar/content body grid.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport.",
+          "chooseWhen": [
+            "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport."
+          ],
+          "avoidWhen": [
+            "Only a route heading or content gutter is needed."
+          ],
+          "appOwned": [
+            "viewport height and routing",
+            "workspace and signed-in user data",
+            "header commands and responsive composition"
+          ],
           "jobs": [
-            "Use App shell in an admin interface."
+            "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport."
           ],
           "tags": [
             "layout",
             "shells",
             "app-shell"
           ],
-          "aliases": [],
+          "aliases": [
+            "application shell",
+            "admin workspace",
+            "dark header layout",
+            "dark header",
+            "light header"
+          ],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -15719,11 +16924,34 @@
               "symbols": [
                 "TopbarSidebarLayout",
                 "SidebarInsetLayout",
-                "StackedLayout"
+                "StackedLayout",
+                "AppLayout"
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/layout/header",
+            "themelia-react-ui/layout/page",
+            "themelia-react-ui/layout/sidebar"
+          ]
+        }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "AppLayout",
+            "AppLayoutVariant"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -15850,7 +17078,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/containers",
@@ -15871,37 +17100,64 @@
       "layer": "layout",
       "responsibility": "Layout family: Containers.",
       "jobs": [
-        "Page composition needs one explicit owner for content width, page scrolling, semantic section rhythm, or a main/aside split."
+        "Compose a public website landing page or service overview from Container, Section and lower public components.",
+        "Own page content width, inline gutters, semantic section rhythm, scrolling or a main/aside split."
       ],
       "tags": [
-        "building blocks",
         "containers",
-        "layout"
+        "content composition",
+        "landing page",
+        "layout",
+        "services",
+        "website"
+      ],
+      "aliases": [
+        "main aside card gaps",
+        "main aside layout",
+        "public website",
+        "service overview",
+        "two column layout",
+        "website landing page"
       ],
-      "aliases": [],
       "sections": [
         "Layouts"
       ],
       "guidance": [
         {
           "title": "Containers",
-          "description": "Page composition needs one explicit owner for content width, page scrolling, semantic section rhythm, or a main/aside split.",
+          "description": "Compose content-led pages and public websites with explicit width, gutters, semantic section rhythm, scrolling and main/aside owners.",
           "chooseWhen": [
-            "Page composition needs one explicit owner for content width, page scrolling, semantic section rhythm, or a main/aside split."
+            "A public website, landing page, service overview or other content-led page needs Container width/gutters and semantic Section rhythm.",
+            "Page composition needs one explicit owner for scrolling or a main/aside split."
           ],
           "avoidWhen": [
             "A local reusable component only needs passive sibling arrangement."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "page content and section order",
+            "link destinations and site navigation",
+            "responsive placement and brand theming"
+          ],
           "jobs": [
-            "Page composition needs one explicit owner for content width, page scrolling, semantic section rhythm, or a main/aside split."
+            "Compose a public website landing page or service overview from Container, Section and lower public components.",
+            "Own page content width, inline gutters, semantic section rhythm, scrolling or a main/aside split."
           ],
           "tags": [
             "layout",
-            "building blocks",
-            "containers"
+            "containers",
+            "website",
+            "landing page",
+            "services",
+            "content composition"
+          ],
+          "aliases": [
+            "website landing page",
+            "public website",
+            "service overview",
+            "main aside card gaps",
+            "main aside layout",
+            "two column layout"
           ],
-          "aliases": [],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -15942,6 +17198,38 @@
             "themelia-react-ui/layout/page"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/layout-blocks.tsx",
+          "exports": [
+            "LayoutBlocks"
+          ],
+          "symbols": [
+            "TwoColumnLayout"
+          ],
+          "references": [
+            "references/composition.md#horizontal-rows",
+            "references/composition.md#main-and-aside-card-gaps",
+            "references/composition.md#structure-and-spacing"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/website.tsx",
+          "exports": [
+            "WebsiteLandingPage"
+          ],
+          "symbols": [
+            "Container",
+            "Section"
+          ],
+          "references": [
+            "references/composition.md#public-websites-and-service-overviews",
+            "references/composition.md#visual-heading-emphasis"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -15978,33 +17266,50 @@
       "layer": "layout",
       "responsibility": "Layout family: Header.",
       "jobs": [
-        "Use Header in an admin interface."
+        "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome."
       ],
       "tags": [
         "header",
         "layout",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "header account menu",
+        "header tools",
+        "signed-in user",
+        "user avatar menu"
+      ],
       "sections": [
         "Layouts"
       ],
       "guidance": [
         {
           "title": "Header",
-          "description": "Topbar, breadcrumbs, command search, notifications, and action slots in a realistic app-shell canvas.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome.",
+          "chooseWhen": [
+            "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome."
+          ],
+          "avoidWhen": [
+            "Only an avatar image or route title is needed."
+          ],
+          "appOwned": [
+            "signed-in user and permissioned account callbacks",
+            "search/dialog state and notification data"
+          ],
           "jobs": [
-            "Use Header in an admin interface."
+            "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome."
           ],
           "tags": [
             "layout",
             "shells",
             "header"
           ],
-          "aliases": [],
+          "aliases": [
+            "header account menu",
+            "user avatar menu",
+            "signed-in user",
+            "header tools"
+          ],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -16027,7 +17332,29 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/avatar",
+            "themelia-react-ui/layout/page",
+            "themelia-react-ui/layout/sidebar"
+          ]
+        }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "HeaderUserMenu",
+            "HeaderUserMenuProps"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -16094,7 +17421,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/navigation",
@@ -16304,7 +17632,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/page",
@@ -16318,6 +17647,7 @@
         "PageActionsProps",
         "PageActionsStrings",
         "PageHeader",
+        "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderSlots",
         "PageProps",
@@ -16328,7 +17658,7 @@
       "layer": "layout",
       "responsibility": "Layout family: Page shell; Resource detail.",
       "jobs": [
-        "A page needs shell-level title, back/link rendering, actions, content, and page composition slots.",
+        "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots.",
         "Build a responsive resource detail page with primary facts, related context, and actions."
       ],
       "tags": [
@@ -16341,9 +17671,19 @@
         "shells"
       ],
       "aliases": [
+        "centered detail page",
+        "more actions menu",
+        "narrow resource page",
+        "page commands",
+        "page gutters",
         "page header",
+        "page padding",
+        "primary action",
         "route heading",
-        "scope navigation"
+        "scope navigation",
+        "secondary actions",
+        "single record page",
+        "single resource page"
       ],
       "sections": [
         "Layouts",
@@ -16399,20 +17739,20 @@
         },
         {
           "title": "Page shell",
-          "description": "A page needs shell-level title, back/link rendering, actions, content, and page composition slots.",
+          "description": "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots.",
           "chooseWhen": [
-            "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
+            "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots."
           ],
           "avoidWhen": [
             "An existing shell needs only a visual title/description/badge block."
           ],
           "appOwned": [
             "route title and contextual lead",
-            "primary command importance",
+            "which command is primary and which are destructive",
             "navigation callbacks and permissioned actions"
           ],
           "jobs": [
-            "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
+            "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots."
           ],
           "tags": [
             "layout",
@@ -16421,8 +17761,18 @@
           ],
           "aliases": [
             "page header",
+            "page padding",
+            "page gutters",
             "route heading",
-            "scope navigation"
+            "scope navigation",
+            "narrow resource page",
+            "centered detail page",
+            "single resource page",
+            "single record page",
+            "primary action",
+            "secondary actions",
+            "page commands",
+            "more actions menu"
           ],
           "section": "Layouts",
           "browse": {
@@ -16454,6 +17804,56 @@
             "themelia-react-ui/features/resource"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "Page"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "Page"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "Page"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        }
       ]
     },
     {
@@ -16526,7 +17926,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/sidebar",
@@ -16578,33 +17979,51 @@
       "layer": "layout",
       "responsibility": "Layout family: Sidebar.",
       "jobs": [
-        "Use Sidebar in an admin interface."
+        "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition."
       ],
       "tags": [
         "layout",
         "shells",
         "sidebar"
       ],
-      "aliases": [],
+      "aliases": [
+        "application navigation",
+        "pinned sidebar header",
+        "sidebar account menu",
+        "workspace switcher"
+      ],
       "sections": [
         "Layouts"
       ],
       "guidance": [
         {
           "title": "Sidebar",
-          "description": "Full app sidebar assembly plus reusable navigation, workspace, and footer item partials.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition.",
+          "chooseWhen": [
+            "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition."
+          ],
+          "avoidWhen": [
+            "Only an inline hierarchy picker is needed."
+          ],
+          "appOwned": [
+            "workspace links and active route",
+            "router rendering and accepted expansion state",
+            "user callbacks and custom pinned header content"
+          ],
           "jobs": [
-            "Use Sidebar in an admin interface."
+            "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition."
           ],
           "tags": [
             "layout",
             "shells",
             "sidebar"
           ],
-          "aliases": [],
+          "aliases": [
+            "workspace switcher",
+            "sidebar account menu",
+            "pinned sidebar header",
+            "application navigation"
+          ],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -16629,11 +18048,36 @@
                 "SidebarGroupedNavigation",
                 "SidebarWorkspaceDropdown",
                 "SidebarNavigationFooter",
-                "SidebarNavigationUser"
+                "SidebarNavigationUser",
+                "LayoutSidebarProvider"
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/cascader",
+            "themelia-react-ui/base/tree",
+            "themelia-react-ui/layout/header"
+          ]
+        }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "AppSidebar",
+            "AppSidebarProps",
+            "LayoutSidebarProvider",
+            "SidebarNavigationUser"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -16667,11 +18111,79 @@
       "optionalPeers": [],
       "layer": "layout",
       "responsibility": "Workspace layout, record header, navigation and locale strip with application-owned record data and callbacks.",
-      "jobs": [],
-      "tags": [],
-      "aliases": [],
-      "sections": [],
-      "guidance": []
+      "jobs": [
+        "A bounded record workspace needs independently composed header, sidebar, main and rail regions."
+      ],
+      "tags": [
+        "building blocks",
+        "layout",
+        "workspace"
+      ],
+      "aliases": [
+        "record header and rail",
+        "resource workspace regions",
+        "workspace locale strip"
+      ],
+      "sections": [
+        "Layouts"
+      ],
+      "guidance": [
+        {
+          "title": "Workspace regions",
+          "description": "A bounded record workspace needs independently composed header, sidebar, main and rail regions.",
+          "chooseWhen": [
+            "A bounded record workspace needs independently composed header, sidebar, main and rail regions."
+          ],
+          "avoidWhen": [
+            "A complete editing/data workflow or global app chrome is required."
+          ],
+          "appOwned": [
+            "record content, navigation and locale callbacks",
+            "header actions and supporting rails"
+          ],
+          "jobs": [
+            "A bounded record workspace needs independently composed header, sidebar, main and rail regions."
+          ],
+          "tags": [
+            "layout",
+            "building blocks",
+            "workspace"
+          ],
+          "aliases": [
+            "resource workspace regions",
+            "record header and rail",
+            "workspace locale strip"
+          ],
+          "section": "Layouts",
+          "browse": {
+            "category": "layout-shells",
+            "group": "Workspace",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "WorkspaceLayout",
+                "WorkspaceRecordHeader",
+                "WorkspaceNav",
+                "WorkspaceLocaleStrip"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/features/resource",
+            "themelia-react-ui/layout/app-shell",
+            "themelia-react-ui/layout/page"
+          ]
+        }
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/lib/strings",
@@ -16691,7 +18203,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/lib/utils",
@@ -16706,7 +18219,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/primitives",
@@ -16745,6 +18259,8 @@
         "Link",
         "LinkProps",
         "Money",
+        "MoneyFormatter",
+        "MoneyFormatterOptions",
         "MoneyLayout",
         "MoneyProps",
         "MoneySecondaryEmphasis",
@@ -16777,7 +18293,8 @@
         "formatFileSize",
         "formatInitials",
         "formatName",
-        "parseDateInput"
+        "parseDateInput",
+        "useMoneyFormatter"
       ],
       "optionalPeers": [],
       "layer": "foundations",
@@ -17294,6 +18811,107 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetail"
+          ],
+          "symbols": [
+            "Date",
+            "Email",
+            "Money",
+            "Value"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "Date",
+            "Email",
+            "Money",
+            "Value"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "Email",
+            "Name"
+          ],
+          "references": [
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Money"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "Email"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        },
+        {
+          "file": "examples/website.tsx",
+          "exports": [
+            "WebsiteLandingPage"
+          ],
+          "symbols": [
+            "Money",
+            "MoneyValue"
+          ],
+          "references": [
+            "references/composition.md#public-websites-and-service-overviews",
+            "references/composition.md#visual-heading-emphasis"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -17466,7 +19084,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/typography",
@@ -17476,6 +19095,7 @@
         "DisplayLabelProps",
         "Heading",
         "HeadingProps",
+        "HeadingSize",
         "HeadingTag",
         "Label",
         "LabelProps",
@@ -17586,6 +19206,151 @@
             "themelia-react-ui/primitives"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/destructive-confirm.tsx",
+          "exports": [
+            "DeleteAccount"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/edit.tsx",
+          "exports": [
+            "AccountEdit"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/workflows.md#validated-editing"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/hierarchy-capture.tsx",
+          "exports": [
+            "HierarchyCapture"
+          ],
+          "symbols": [
+            "Label"
+          ],
+          "references": [
+            "references/composition.md#hierarchies-capture-and-guided-forms"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Heading",
+            "Text"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/scoped-directory.tsx",
+          "exports": [
+            "ScopedDirectory"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/composition.md#compose-from-the-task",
+            "references/workflows.md#scoped-directory"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-day-picker"
+          ]
+        },
+        {
+          "file": "examples/website.tsx",
+          "exports": [
+            "WebsiteLandingPage"
+          ],
+          "symbols": [
+            "Heading",
+            "Text"
+          ],
+          "references": [
+            "references/composition.md#public-websites-and-service-overviews",
+            "references/composition.md#visual-heading-emphasis"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -17598,11 +19363,66 @@
       "optionalPeers": [],
       "layer": "foundations",
       "responsibility": "Sanitized rich HTML display with scoped reading rhythm; editing belongs to the rich-text-editor feature.",
-      "jobs": [],
-      "tags": [],
-      "aliases": [],
-      "sections": [],
-      "guidance": []
+      "jobs": [
+        "Display rich HTML and converted Markdown content"
+      ],
+      "tags": [
+        "HTML",
+        "rich text"
+      ],
+      "aliases": [
+        "markdown",
+        "rendered markdown"
+      ],
+      "references": [
+        "references/composition.md#typography-and-rich-content"
+      ],
+      "sections": [
+        "Foundations"
+      ],
+      "guidance": [
+        {
+          "title": "Rich HTML display",
+          "description": "Sanitized rich HTML display with scoped reading rhythm; editing belongs to the rich-text-editor feature.",
+          "section": "Foundations",
+          "chooseWhen": [
+            "Display sanitized HTML, including application-converted Markdown."
+          ],
+          "avoidWhen": [
+            "Raw Markdown parsing or an editable document is required."
+          ],
+          "appOwned": [
+            "Markdown-to-HTML conversion, content loading and persistence"
+          ],
+          "jobs": [
+            "Display rich HTML and converted Markdown content"
+          ],
+          "tags": [
+            "rich text",
+            "HTML"
+          ],
+          "aliases": [
+            "markdown",
+            "rendered markdown"
+          ],
+          "browse": {
+            "category": "typography",
+            "group": "Typography",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "RichText"
+              ]
+            }
+          ],
+          "alternatives": []
+        }
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/ui-provider",
@@ -17679,9 +19499,20 @@
         "runtime"
       ],
       "aliases": [
+        "border radius",
+        "control corners",
+        "control heights",
+        "control-height",
+        "global corners",
+        "matching control heights",
+        "radius",
         "theme boundary",
         "theming"
       ],
+      "references": [
+        "references/design-contract.md",
+        "references/theming.md"
+      ],
       "sections": [
         "Foundations"
       ],
@@ -17744,6 +19575,21 @@
             "themelia-react-ui/features/theme-tweaker"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "ThemeScope"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     }
   ]