themelia-react-ui 1.0.1 → 1.0.2

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

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "stylesheets": [
     "themelia-react-ui/style.css",
     "themelia-react-ui/theme.css",
@@ -240,7 +240,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/action-presentation",
@@ -257,7 +258,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/accordion",
@@ -349,7 +351,8 @@
             "themelia-react-ui/base/display"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/action-menu",
@@ -524,7 +527,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/attachment",
@@ -588,6 +592,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "Attachment"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -807,7 +826,8 @@
             "themelia-react-ui/base/avatar"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/badge",
@@ -876,6 +896,21 @@
             "themelia-react-ui/base/display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -1097,6 +1132,142 @@
             "themelia-react-ui/typography"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "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/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "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": []
+        }
       ]
     },
     {
@@ -1144,7 +1315,10 @@
         "foundations"
       ],
       "aliases": [
-        "base/content-block"
+        "base/content-block",
+        "card header footer",
+        "card padding",
+        "card separators"
       ],
       "sections": [
         "Base components"
@@ -1174,7 +1348,10 @@
             "cards"
           ],
           "aliases": [
-            "base/content-block"
+            "base/content-block",
+            "card padding",
+            "card header footer",
+            "card separators"
           ],
           "section": "Base components",
           "browse": {
@@ -1210,7 +1387,10 @@
             },
             {
               "title": "Card actions",
-              "symbols": []
+              "symbols": [
+                "CardPrimaryAction",
+                "CardActionStrip"
+              ]
             },
             {
               "title": "Alerts",
@@ -1245,6 +1425,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 +1673,8 @@
             "themelia-react-ui/base/structure"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/cascader",
@@ -1402,6 +1730,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 +1833,8 @@
             "themelia-react-ui/blocks/analytics"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/choice-inputs",
@@ -1939,7 +2283,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/code-block",
@@ -1994,6 +2339,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "CodeBlock"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -2087,7 +2447,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/command",
@@ -2173,7 +2534,8 @@
             "themelia-react-ui/features/global-search"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/copyable",
@@ -2257,7 +2619,8 @@
             "themelia-react-ui/primitives"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/date-pickers",
@@ -2501,7 +2864,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/display",
@@ -2979,6 +3343,21 @@
             "themelia-react-ui/base/display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Separator"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -3332,6 +3711,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 +4201,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 +4666,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/inline-edit",
@@ -4336,6 +4751,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 +4874,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 +4958,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/navigation",
@@ -4834,7 +5282,8 @@
             {
               "title": "API",
               "symbols": [
-                "NavigationTabs"
+                "NavigationTabs",
+                "TabsList"
               ]
             }
           ],
@@ -4968,7 +5417,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/popover",
@@ -5056,7 +5506,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/popover-menu",
@@ -5147,7 +5598,8 @@
             "themelia-react-ui/base/popover"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/qr-code",
@@ -5220,7 +5672,8 @@
             "themelia-react-ui/primitives"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/repeaters",
@@ -5601,7 +6054,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/sheet",
@@ -5684,7 +6138,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/sidebar",
@@ -5800,6 +6255,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 +6336,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 +6633,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/spinner",
@@ -6232,7 +6721,8 @@
             "themelia-react-ui/base/skeleton"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/structure",
@@ -6265,7 +6755,15 @@
         "foundations",
         "structure"
       ],
-      "aliases": [],
+      "aliases": [
+        "copy gaps",
+        "copy-gap",
+        "title description spacing"
+      ],
+      "references": [
+        "references/design-contract.md",
+        "references/theming.md#copy-rhythm"
+      ],
       "sections": [
         "Foundations"
       ],
@@ -6335,43 +6833,204 @@
             "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"
+      ],
+      "recipes": [
+        {
+          "file": "examples/app-layout.tsx",
+          "exports": [
+            "WorkspaceLayout"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#application-layouts",
+            "references/integration.md",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "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/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": [
         {
@@ -6417,7 +7076,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/text-inputs",
@@ -6664,6 +7324,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 +7430,8 @@
             "themelia-react-ui/base/forms"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/tree",
@@ -6794,6 +7485,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 +7782,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/upload-queue",
@@ -7201,7 +7909,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/value-inputs",
@@ -7495,7 +8204,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/admin",
@@ -7727,7 +8437,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/ai",
@@ -8826,7 +9537,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/analytics",
@@ -8900,14 +9612,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 +9637,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 +9670,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 +9707,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 +9759,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",
@@ -9267,19 +10022,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 +10079,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/data-display"
+          ]
         },
         {
           "title": "Time distribution",
@@ -9345,6 +10124,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 +10179,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 +10190,12 @@
         "resources",
         "usage"
       ],
-      "aliases": [],
+      "aliases": [
+        "quota dashboard",
+        "resource limits",
+        "usage statistics",
+        "usage summary"
+      ],
       "sections": [
         "Blocks"
       ],
@@ -9388,18 +10204,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 +10226,12 @@
             "resources",
             "billing summary"
           ],
-          "aliases": [],
+          "aliases": [
+            "usage statistics",
+            "usage summary",
+            "quota dashboard",
+            "resource limits"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -9427,10 +10248,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 +10293,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 +10341,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 +11664,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/commerce/receipt",
@@ -10885,6 +11766,23 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Receipt",
+            "ReceiptItems",
+            "ReceiptLineItem"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -10969,8 +11867,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 +12045,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 +12059,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 +12121,9 @@
             "blocks/metadata-list",
             "fact list",
             "read-only facts",
-            "contact details"
+            "contact details",
+            "key value",
+            "details"
           ],
           "section": "Blocks",
           "browse": {
@@ -11319,23 +12232,100 @@
             "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",
-        "OnboardingChecklistVariant",
-        "OnboardingStepStatus",
-        "StepStatusIndicator",
-        "StepStatusIndicatorProps",
-        "defaultOnboardingChecklistStrings"
       ],
-      "optionalPeers": [],
+      "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",
+        "StepStatusIndicatorProps",
+        "defaultOnboardingChecklistStrings"
+      ],
+      "optionalPeers": [],
       "layer": "blocks",
       "responsibility": "Blocks family: Onboarding checklist.",
       "jobs": [
@@ -11387,7 +12377,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/planning",
@@ -11469,6 +12460,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": []
+        }
       ]
     },
     {
@@ -11731,7 +12740,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/component-vocabulary",
@@ -11753,7 +12763,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/activities",
@@ -11953,7 +12964,8 @@
             "themelia-react-ui/features/comments"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/ai-chat",
@@ -12071,7 +13083,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/async-preview",
@@ -12197,7 +13210,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/combobox",
@@ -12395,7 +13409,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/comments",
@@ -12515,7 +13530,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/data-view",
@@ -12690,7 +13706,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/email-composer",
@@ -12806,6 +13823,44 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/email-composer.tsx",
+          "exports": [
+            "CustomerEmail"
+          ],
+          "symbols": [
+            "ComposerDraft",
+            "EmailComposer",
+            "PreparedEmail"
+          ],
+          "references": [
+            "references/integration.md"
+          ],
+          "optionalPeers": [
+            "@tiptap/react",
+            "@tiptap/starter-kit"
+          ]
+        },
+        {
+          "file": "examples/email-composer.tsx",
+          "exports": [
+            "TemplateEmail"
+          ],
+          "symbols": [
+            "EmailComposer",
+            "EmailComposerProps",
+            "PreparedEmail"
+          ],
+          "references": [
+            "references/integration.md"
+          ],
+          "optionalPeers": [
+            "@tiptap/react",
+            "@tiptap/starter-kit"
+          ]
+        }
       ]
     },
     {
@@ -12840,7 +13895,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/event-calendar",
@@ -13074,7 +14130,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/filters",
@@ -13241,6 +14298,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 +14417,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/kanban",
@@ -13432,7 +14513,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/map",
@@ -13606,7 +14688,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/media-library",
@@ -13799,7 +14882,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/mentions",
@@ -13892,7 +14976,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/overlays",
@@ -13986,6 +15071,35 @@
             "themelia-react-ui/base/sheet"
           ]
         }
+      ],
+      "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 +15538,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/questionnaire",
@@ -14489,6 +15604,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 +15711,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/resource-assignment",
@@ -14661,7 +15794,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/rich-text-editor",
@@ -14736,7 +15870,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/schema-form",
@@ -14840,7 +15975,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/suggestions",
@@ -14909,7 +16045,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/sync",
@@ -14980,7 +16117,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/table",
@@ -15162,6 +16300,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 +16523,8 @@
             "themelia-react-ui/base/repeaters"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout",
@@ -15590,7 +16766,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/app-shell",
@@ -15623,7 +16800,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 +16811,13 @@
         "shell",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "admin workspace",
+        "application shell",
+        "dark header",
+        "dark header layout",
+        "light header"
+      ],
       "sections": [
         "Layouts",
         "Recipes"
@@ -15689,19 +16872,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 +16916,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 +17070,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/containers",
@@ -15871,37 +17092,58 @@
       "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": [
+        "public website",
+        "service overview",
+        "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"
           ],
-          "aliases": [],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -15942,6 +17184,23 @@
             "themelia-react-ui/layout/page"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "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 +17237,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 +17303,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 +17392,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/navigation",
@@ -16304,7 +17603,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/page",
@@ -16341,9 +17641,15 @@
         "shells"
       ],
       "aliases": [
+        "centered detail page",
+        "narrow resource page",
+        "page gutters",
         "page header",
+        "page padding",
         "route heading",
-        "scope navigation"
+        "scope navigation",
+        "single record page",
+        "single resource page"
       ],
       "sections": [
         "Layouts",
@@ -16421,8 +17727,14 @@
           ],
           "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"
           ],
           "section": "Layouts",
           "browse": {
@@ -16454,6 +17766,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 +17888,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/sidebar",
@@ -16578,33 +17941,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 +18010,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 +18073,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 +18165,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/lib/utils",
@@ -16706,7 +18181,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/primitives",
@@ -17294,6 +18770,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 +19043,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/typography",
@@ -17476,6 +19054,7 @@
         "DisplayLabelProps",
         "Heading",
         "HeadingProps",
+        "HeadingSize",
         "HeadingTag",
         "Label",
         "LabelProps",
@@ -17586,6 +19165,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 +19322,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 +19458,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 +19534,21 @@
             "themelia-react-ui/features/theme-tweaker"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "ThemeScope"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     }
   ]