themelia-react-ui 1.0.0 → 1.0.2

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

@@ -2,7 +2,12 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "1.0.0",
+  "version": "1.0.2",
+  "stylesheets": [
+    "themelia-react-ui/style.css",
+    "themelia-react-ui/theme.css",
+    "themelia-react-ui/features/map/style.css"
+  ],
   "peers": [
     {
       "name": "@base-ui/react",
@@ -235,7 +240,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/action-presentation",
@@ -252,7 +258,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/accordion",
@@ -292,7 +299,7 @@
       "guidance": [
         {
           "title": "Accordion",
-          "description": "Disclosure groups for settings, policy, and review workflows. Use SmartAccordion for data-driven rows; use the compound parts when the trigger or body needs custom structure.",
+          "description": "One or more labeled disclosure items need coordinated accordion behavior.",
           "chooseWhen": [
             "One or more labeled disclosure items need coordinated accordion behavior."
           ],
@@ -344,7 +351,8 @@
             "themelia-react-ui/base/display"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/action-menu",
@@ -372,11 +380,9 @@
         "action-buttons",
         "action-menu",
         "actions",
-        "actions-overlays",
         "base",
         "build",
         "confirmation",
-        "docs",
         "drawer",
         "navigation & data"
       ],
@@ -388,7 +394,7 @@
       "guidance": [
         {
           "title": "Action menu",
-          "description": "The canonical overflow action shell driven by reusable action definitions, groups, visibility, links, and semantic variants.",
+          "description": "Edit, archive, delete, and other repeated action definitions need an overflow action menu.",
           "chooseWhen": [
             "Edit, archive, delete, and other repeated action definitions need an overflow action menu."
           ],
@@ -492,9 +498,7 @@
             "Build permission-aware record actions with package-owned overlay lifecycle and focus return."
           ],
           "tags": [
-            "docs",
             "build",
-            "actions-overlays",
             "actions",
             "drawer",
             "confirmation"
@@ -523,7 +527,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/attachment",
@@ -587,6 +592,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "Attachment"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -635,7 +655,7 @@
       "guidance": [
         {
           "title": "Avatar overview",
-          "description": "Avatar, fallback initials, and stacked avatars for compact identity surfaces.",
+          "description": "A person or entity needs image, initials fallback, status, badge, or grouped identity media.",
           "chooseWhen": [
             "A person or entity needs image, initials fallback, status, badge, or grouped identity media."
           ],
@@ -720,7 +740,7 @@
         },
         {
           "title": "Avatar group",
-          "description": "Low-level avatar grouping with explicit members, presence badges, and an overflow count.",
+          "description": "Manual compound control over each Avatar, badge, and overflow node is required.",
           "chooseWhen": [
             "Manual compound control over each Avatar, badge, and overflow node is required."
           ],
@@ -765,7 +785,7 @@
         },
         {
           "title": "Stacked avatars",
-          "description": "Compact overlapping identity groups with image fallbacks, maximum counts, and provider-aligned sizing.",
+          "description": "A data array needs the standard overlapping avatar recipe, initials fallback, and overflow count.",
           "chooseWhen": [
             "A data array needs the standard overlapping avatar recipe, initials fallback, and overflow count."
           ],
@@ -806,7 +826,8 @@
             "themelia-react-ui/base/avatar"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/badge",
@@ -834,7 +855,7 @@
       "guidance": [
         {
           "title": "Badge",
-          "description": "Status pills and chips for tags, counts, and inline state.",
+          "description": "A compact semantic status, category, count, or resource chip is needed, including replacement of a local display-only status pill.",
           "chooseWhen": [
             "A compact semantic status, category, count, or resource chip is needed, including replacement of a local display-only status pill."
           ],
@@ -875,6 +896,21 @@
             "themelia-react-ui/base/display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/composition.tsx",
+          "exports": [
+            "AccountComposition"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/workflows.md#destructive-confirmation"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -926,7 +962,7 @@
       "guidance": [
         {
           "title": "Buttons overview",
-          "description": "One canonical Button for actions and links, including loading and tooltip behavior, plus a deliberately prose-like text action.",
+          "description": "An action needs a canonical button or a prose-like text action.",
           "chooseWhen": [
             "An action needs a canonical button or a prose-like text action."
           ],
@@ -1010,7 +1046,7 @@
         },
         {
           "title": "Button",
-          "description": "The canonical action and link control with semantic variants, loading, tooltip, icon, and native-anchor behavior.",
+          "description": "An action or native navigation link needs the canonical provider-aware button, with optional loading and tooltip behavior.",
           "chooseWhen": [
             "An action or native navigation link needs the canonical provider-aware button, with optional loading and tooltip behavior."
           ],
@@ -1054,7 +1090,7 @@
         },
         {
           "title": "Text button",
-          "description": "A lightweight text-shaped action for low-emphasis controls.",
+          "description": "A low-emphasis action should read like inline text while retaining button semantics.",
           "chooseWhen": [
             "A low-emphasis action should read like inline text while retaining button semantics."
           ],
@@ -1096,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": []
+        }
       ]
     },
     {
@@ -1143,7 +1315,10 @@
         "foundations"
       ],
       "aliases": [
-        "base/content-block"
+        "base/content-block",
+        "card header footer",
+        "card padding",
+        "card separators"
       ],
       "sections": [
         "Base components"
@@ -1151,7 +1326,7 @@
       "guidance": [
         {
           "title": "Card",
-          "description": "Card, its loading state, flat content composition, body and footer actions, and low-level anatomy in one complete card-family reference.",
+          "description": "A call site owns visible card chrome, card actions, or a card loading state.",
           "chooseWhen": [
             "A call site owns visible card chrome, card actions, or a card loading state."
           ],
@@ -1173,7 +1348,10 @@
             "cards"
           ],
           "aliases": [
-            "base/content-block"
+            "base/content-block",
+            "card padding",
+            "card header footer",
+            "card separators"
           ],
           "section": "Base components",
           "browse": {
@@ -1209,7 +1387,10 @@
             },
             {
               "title": "Card actions",
-              "symbols": []
+              "symbols": [
+                "CardPrimaryAction",
+                "CardActionStrip"
+              ]
             },
             {
               "title": "Alerts",
@@ -1244,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": []
+        }
       ]
     },
     {
@@ -1283,10 +1611,7 @@
         "A bounded ordered set genuinely needs horizontal/vertical slide navigation."
       ],
       "tags": [
-        "base",
-        "carousel",
         "embla-carousel-react",
-        "navigation & data",
         "optional-peer"
       ],
       "aliases": [],
@@ -1296,7 +1621,7 @@
       "guidance": [
         {
           "title": "Carousel",
-          "description": "Embla-backed carousel with keyboard navigation, orientation support, plugins, and base Button controls.",
+          "description": "A bounded ordered set genuinely needs horizontal/vertical slide navigation.",
           "chooseWhen": [
             "A bounded ordered set genuinely needs horizontal/vertical slide navigation."
           ],
@@ -1308,9 +1633,6 @@
             "A bounded ordered set genuinely needs horizontal/vertical slide navigation."
           ],
           "tags": [
-            "base",
-            "navigation & data",
-            "carousel",
             "optional-peer",
             "embla-carousel-react"
           ],
@@ -1351,7 +1673,8 @@
             "themelia-react-ui/base/structure"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/cascader",
@@ -1407,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": []
+        }
       ]
     },
     {
@@ -1435,9 +1773,6 @@
         "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
       ],
       "tags": [
-        "base",
-        "chart",
-        "display",
         "optional-peer",
         "recharts"
       ],
@@ -1448,7 +1783,7 @@
       "guidance": [
         {
           "title": "Chart",
-          "description": "Token-aware Recharts helpers plus a blocks ChartCard for admin analytics surfaces.",
+          "description": "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding.",
           "chooseWhen": [
             "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
           ],
@@ -1460,9 +1795,6 @@
             "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
           ],
           "tags": [
-            "base",
-            "display",
-            "chart",
             "optional-peer",
             "recharts"
           ],
@@ -1501,7 +1833,8 @@
             "themelia-react-ui/blocks/analytics"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/choice-inputs",
@@ -1577,7 +1910,7 @@
       "guidance": [
         {
           "title": "Choice inputs overview",
-          "description": "Controls for picking from a known set: select, checkbox and switch, the card and list choice groups, and the shared select popup anatomy.",
+          "description": "The user picks from a known set of options, including a binary on/off.",
           "chooseWhen": [
             "The user picks from a known set of options, including a binary on/off."
           ],
@@ -1950,7 +2283,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/code-block",
@@ -2005,6 +2339,21 @@
           "sections": [],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/content-workflow.tsx",
+          "exports": [
+            "ReviewMessage"
+          ],
+          "symbols": [
+            "CodeBlock"
+          ],
+          "references": [
+            "references/composition.md#files-code-and-messages"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -2098,7 +2447,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/command",
@@ -2133,7 +2483,7 @@
       "guidance": [
         {
           "title": "Command",
-          "description": "Density-aware command lists with filtering, groups, shortcuts, disabled rows, and controlled selection callbacks.",
+          "description": "A custom keyboard-searchable command list needs low-level compound anatomy.",
           "chooseWhen": [
             "A custom keyboard-searchable command list needs low-level compound anatomy."
           ],
@@ -2184,7 +2534,8 @@
             "themelia-react-ui/features/global-search"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/copyable",
@@ -2215,7 +2566,7 @@
       "guidance": [
         {
           "title": "Copyable",
-          "description": "Inline value plus a dedicated copy action, localizable feedback, and rich-display composition.",
+          "description": "A displayed scalar or semantic value needs an explicit adjacent clipboard action.",
           "chooseWhen": [
             "A displayed scalar or semantic value needs an explicit adjacent clipboard action."
           ],
@@ -2268,7 +2619,8 @@
             "themelia-react-ui/primitives"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/date-pickers",
@@ -2332,7 +2684,7 @@
       "guidance": [
         {
           "title": "Date pickers overview",
-          "description": "DatePicker (single / range / multiple) and MonthYearPicker — popover-based, locale-aware, with optional year dropdown and time input.",
+          "description": "A form needs single, multiple, range, month/year, or segmented-time date selection.",
           "chooseWhen": [
             "A form needs single, multiple, range, month/year, or segmented-time date selection."
           ],
@@ -2344,9 +2696,6 @@
             "A form needs single, multiple, range, month/year, or segmented-time date selection."
           ],
           "tags": [
-            "base",
-            "forms & inputs",
-            "date-pickers",
             "optional-peer",
             "react-day-picker"
           ],
@@ -2515,7 +2864,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/display",
@@ -2603,7 +2953,7 @@
       "guidance": [
         {
           "title": "Boolean indicator",
-          "description": "Compact yes/no status treatment for boolean fields in admin surfaces.",
+          "description": "A read-only boolean field needs a compact icon and localized yes/no label.",
           "chooseWhen": [
             "A read-only boolean field needs a compact icon and localized yes/no label."
           ],
@@ -2646,7 +2996,7 @@
         },
         {
           "title": "Collapsible",
-          "description": "Base wrapper for inline disclosure and expand/collapse content.",
+          "description": "One custom trigger/content region needs low-level controlled or uncontrolled disclosure.",
           "chooseWhen": [
             "One custom trigger/content region needs low-level controlled or uncontrolled disclosure."
           ],
@@ -2690,7 +3040,7 @@
         },
         {
           "title": "Date block",
-          "description": "Semantic calendar tiles and timeline stamps for event, schedule, booking, and deadline rows.",
+          "description": "A date needs a calendar-like month/day visual block rather than inline formatting.",
           "chooseWhen": [
             "A date needs a calendar-like month/day visual block rather than inline formatting."
           ],
@@ -2737,7 +3087,7 @@
         },
         {
           "title": "Icon badge",
-          "description": "Tokenized icon container for status, resource, and row media affordances.",
+          "description": "An icon needs a consistent framed circular or rounded visual container.",
           "chooseWhen": [
             "An icon needs a consistent framed circular or rounded visual container."
           ],
@@ -2780,7 +3130,7 @@
         },
         {
           "title": "Placeholder pattern",
-          "description": "Subtle diagonal SVG placeholder fill for empty media, maps, and generated previews.",
+          "description": "An empty media, map, or generated-preview region needs a quiet decorative fill.",
           "chooseWhen": [
             "An empty media, map, or generated-preview region needs a quiet decorative fill."
           ],
@@ -2823,7 +3173,7 @@
         },
         {
           "title": "Scroll area",
-          "description": "Styled vertical and horizontal overflow with package-owned scrollbar chrome.",
+          "description": "A bounded region needs styled horizontal or vertical overflow and package scrollbar chrome.",
           "chooseWhen": [
             "A bounded region needs styled horizontal or vertical overflow and package scrollbar chrome."
           ],
@@ -2865,7 +3215,7 @@
         },
         {
           "title": "Separator",
-          "description": "Horizontal and vertical separator wrapper for grouping dense admin content.",
+          "description": "Adjacent groups need a semantic visual divider in horizontal or vertical orientation.",
           "chooseWhen": [
             "Adjacent groups need a semantic visual divider in horizontal or vertical orientation."
           ],
@@ -2908,7 +3258,7 @@
         },
         {
           "title": "Tooltip",
-          "description": "Tooltip provider, trigger, and content wrappers for short contextual help.",
+          "description": "Brief supplementary text should appear on hover and keyboard focus.",
           "chooseWhen": [
             "Brief supplementary text should appear on hover and keyboard focus."
           ],
@@ -2953,7 +3303,7 @@
         },
         {
           "title": "Visually hidden",
-          "description": "Accessible hidden text helper for icon-only controls and nonvisual labels.",
+          "description": "Meaningful text must remain available to assistive technology without visual layout.",
           "chooseWhen": [
             "Meaningful text must remain available to assistive technology without visual layout."
           ],
@@ -2993,6 +3343,21 @@
             "themelia-react-ui/base/display"
           ]
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Separator"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -3071,7 +3436,7 @@
       "guidance": [
         {
           "title": "Alert",
-          "description": "Semantic notice primitive with icon, title, description, structured metadata, and responsive actions.",
+          "description": "Contextual feedback needs alert semantics plus optional title, description, metadata, or action regions.",
           "chooseWhen": [
             "Contextual feedback needs alert semantics plus optional title, description, metadata, or action regions."
           ],
@@ -3127,7 +3492,7 @@
         },
         {
           "title": "Empty state",
-          "description": "Low-level empty-state composition parts for media, title, description, and actions.",
+          "description": "Custom empty-state anatomy must be assembled from low-level media, header, title, description, and content parts.",
           "chooseWhen": [
             "Custom empty-state anatomy must be assembled from low-level media, header, title, description, and content parts."
           ],
@@ -3169,7 +3534,7 @@
         },
         {
           "title": "Feedback overview",
-          "description": "What a region reports about itself: inline notices, task progress, empty anatomy, and a shared loading and recovery grammar.",
+          "description": "A region must report its own status: an inline notice, task progress, or a standard loading or recoverable-error presentation.",
           "chooseWhen": [
             "A region must report its own status: an inline notice, task progress, or a standard loading or recoverable-error presentation."
           ],
@@ -3288,7 +3653,7 @@
         },
         {
           "title": "Progress",
-          "description": "Accessible, token-driven progress for completion, quota, migration, and indeterminate task states.",
+          "description": "Known completion progress must be represented as a determinate bar.",
           "chooseWhen": [
             "Known completion progress must be represented as a determinate bar."
           ],
@@ -3346,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"
+          ]
+        }
       ]
     },
     {
@@ -3395,7 +3778,6 @@
         "build",
         "controlled-form-field",
         "dirty-state-banner",
-        "docs",
         "error-summary",
         "form",
         "form-actions-bar",
@@ -3406,7 +3788,6 @@
         "operation-password-form",
         "submit",
         "submit-state-button",
-        "validated-form",
         "validation"
       ],
       "aliases": [],
@@ -3417,7 +3798,7 @@
       "guidance": [
         {
           "title": "Forms overview",
-          "description": "The form-row wrapper, workflow chrome, and the plain field controls — text inputs, selects, toggles, choice groups, date/time, sliders, tags, and phone.",
+          "description": "Editable values need canonical field controls, field chrome, grouped choices, uploads, or form-state recipes.",
           "chooseWhen": [
             "Editable values need canonical field controls, field chrome, grouped choices, uploads, or form-state recipes."
           ],
@@ -3620,7 +4001,7 @@
         },
         {
           "title": "Form field",
-          "description": "Canonical label, control, hint, helper, and error presentation.",
+          "description": "A label, editable control, and hint or error form one accessible field row.",
           "chooseWhen": [
             "A label, editable control, and hint or error form one accessible field row."
           ],
@@ -3791,9 +4172,7 @@
             "Build an application-owned validated form with consistent field and action presentation."
           ],
           "tags": [
-            "docs",
             "build",
-            "validated-form",
             "form",
             "validation",
             "submit"
@@ -3822,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"
+          ]
+        }
       ]
     },
     {
@@ -3894,7 +4290,7 @@
       "guidance": [
         {
           "title": "Numeric fields overview",
-          "description": "Form controls whose value is a number plus a unit, currency, or rounding policy — decimal, percentage, money, currency, weight, dimensions, coordinates, and rounding mode.",
+          "description": "An editable value is a number carrying a unit, a currency, or a rounding policy.",
           "chooseWhen": [
             "An editable value is a number carrying a unit, a currency, or a rounding policy."
           ],
@@ -4270,6 +4666,108 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": []
+    },
+    {
+      "import": "themelia-react-ui/base/inline-edit",
+      "declaration": "dist/components/base/inline-edit/index.d.ts",
+      "symbols": [
+        "InlineEdit",
+        "InlineEditProps",
+        "InlineEditSaveContext",
+        "InlineEditStrings",
+        "defaultInlineEditStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "base",
+      "responsibility": "Base family: Inline edit.",
+      "jobs": [
+        "Inline editing",
+        "Multiline editing",
+        "Save and cancel",
+        "Single-line editing"
+      ],
+      "tags": [
+        "base",
+        "cancel",
+        "draft",
+        "editable text",
+        "field editing",
+        "rename",
+        "save"
+      ],
+      "aliases": [],
+      "sections": [
+        "Base components"
+      ],
+      "guidance": [
+        {
+          "title": "Inline edit",
+          "description": "Readable fields with keyboard editing, validation, async save and cancellation.",
+          "chooseWhen": [
+            "A readable string field needs a reusable view/edit/save/cancel control."
+          ],
+          "avoidWhen": [
+            "Several fields need a complete form workflow or remote resource-assignment selection."
+          ],
+          "appOwned": [
+            "Persistence, permissions, data requests and navigation."
+          ],
+          "jobs": [
+            "Inline editing",
+            "Single-line editing",
+            "Multiline editing",
+            "Save and cancel"
+          ],
+          "tags": [
+            "base",
+            "field editing",
+            "rename",
+            "editable text",
+            "draft",
+            "save",
+            "cancel"
+          ],
+          "aliases": [],
+          "section": "Base components",
+          "browse": {
+            "category": "forms-inputs",
+            "group": "Inline edit",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "InlineEdit"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/base/forms",
+            "themelia-react-ui/base/text-inputs",
+            "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": []
+        }
       ]
     },
     {
@@ -4308,7 +4806,7 @@
       "layer": "base",
       "responsibility": "Base family: Item.",
       "jobs": [
-        "Each row has its own identity, media/title stack, target, trailing value, or actions."
+        "Present independent record list entries with identity, supporting copy and actions."
       ],
       "tags": [
         "base",
@@ -4322,16 +4820,20 @@
       "guidance": [
         {
           "title": "Item",
-          "description": "Canonical row primitive — icon/avatar/image media, title + description content, optional actions. Use ItemGroup to compose lists.",
+          "description": "Each row has its own identity, media/title stack, target, trailing value, or actions.",
           "chooseWhen": [
             "Each row has its own identity, media/title stack, target, trailing value, or actions."
           ],
           "avoidWhen": [
             "The rows are label/value facts about one entity or merely passive sibling layout."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "record priority",
+            "navigation and actions",
+            "selection state"
+          ],
           "jobs": [
-            "Each row has its own identity, media/title stack, target, trailing value, or actions."
+            "Present independent record list entries with identity, supporting copy and actions."
           ],
           "tags": [
             "base",
@@ -4372,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": []
+        }
       ]
     },
     {
@@ -4441,7 +4958,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/navigation",
@@ -4541,7 +5059,7 @@
       "guidance": [
         {
           "title": "Navigation overview",
-          "description": "The navigation controls — PageHeading, Breadcrumbs, LanguageSwitcher, NavigationTabs, OverflowTabBar, and the dropdown-menu parts.",
+          "description": "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy.",
           "chooseWhen": [
             "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy."
           ],
@@ -4727,7 +5245,7 @@
         },
         {
           "title": "Navigation tabs",
-          "description": "Canonical route-tab navigation with a compact default, a prominent variant, optional icons and badges, and consumer-owned current path.",
+          "description": "A small, always-visible set of sibling application routes needs compact or prominent tab navigation.",
           "chooseWhen": [
             "A small, always-visible set of sibling application routes needs compact or prominent tab navigation."
           ],
@@ -4764,7 +5282,8 @@
             {
               "title": "API",
               "symbols": [
-                "NavigationTabs"
+                "NavigationTabs",
+                "TabsList"
               ]
             }
           ],
@@ -4812,7 +5331,7 @@
         },
         {
           "title": "Page heading",
-          "description": "A framework-agnostic visual heading block with eyebrow, description, badge, and action composition. Use layout PageHeader when the page shell owns navigation and page-level chrome.",
+          "description": "An existing shell needs only a visual title, description, badges, and actions block.",
           "chooseWhen": [
             "An existing shell needs only a visual title, description, badges, and actions block."
           ],
@@ -4898,7 +5417,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/popover",
@@ -4934,7 +5454,7 @@
       "guidance": [
         {
           "title": "Popover",
-          "description": "A tokenized popover surface with compound trigger, header, title, description, anchor, and positioning parts.",
+          "description": "A trigger needs a small anchored custom content surface with explicit compound control.",
           "chooseWhen": [
             "A trigger needs a small anchored custom content surface with explicit compound control."
           ],
@@ -4986,7 +5506,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/popover-menu",
@@ -5021,7 +5542,7 @@
       "guidance": [
         {
           "title": "Popover menu",
-          "description": "A reusable trigger, search, command-list, and selection shell with typed items, slots, strings, and controlled state seams.",
+          "description": "A trigger opens the recurring optional-header, search, list, and footer menu pattern.",
           "chooseWhen": [
             "A trigger opens the recurring optional-header, search, list, and footer menu pattern."
           ],
@@ -5077,7 +5598,8 @@
             "themelia-react-ui/base/popover"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/qr-code",
@@ -5098,11 +5620,8 @@
         "A string must be rendered as a QR code with an accessible label and optional logo."
       ],
       "tags": [
-        "base",
         "culori",
-        "display",
         "optional-peer",
-        "qr-code",
         "qrcode"
       ],
       "aliases": [],
@@ -5112,7 +5631,7 @@
       "guidance": [
         {
           "title": "QR code",
-          "description": "QR code display wrapper for share links, check-in codes, and payment references.",
+          "description": "A string must be rendered as a QR code with an accessible label and optional logo.",
           "chooseWhen": [
             "A string must be rendered as a QR code with an accessible label and optional logo."
           ],
@@ -5124,9 +5643,6 @@
             "A string must be rendered as a QR code with an accessible label and optional logo."
           ],
           "tags": [
-            "base",
-            "display",
-            "qr-code",
             "optional-peer",
             "qrcode",
             "culori"
@@ -5156,7 +5672,8 @@
             "themelia-react-ui/primitives"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/repeaters",
@@ -5234,7 +5751,7 @@
       "guidance": [
         {
           "title": "Repeaters overview",
-          "description": "Repeating and locale-keyed field collections — the repeater engine, string and object repeaters, the key-value editor, and the localized field set.",
+          "description": "A field edits a list of rows the person adds, removes, and reorders, or a value keyed by locale.",
           "chooseWhen": [
             "A field edits a list of rows the person adds, removes, and reorders, or a value keyed by locale."
           ],
@@ -5537,7 +6054,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/sheet",
@@ -5571,7 +6089,7 @@
       "guidance": [
         {
           "title": "Sheet",
-          "description": "A public compound surface for controlled or trigger-driven slide-in panels from any viewport edge.",
+          "description": "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy.",
           "chooseWhen": [
             "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
           ],
@@ -5620,7 +6138,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/sidebar",
@@ -5680,7 +6199,7 @@
       "guidance": [
         {
           "title": "Sidebar primitives",
-          "description": "Tokenized low-level provider, shell, groups, menus, nested links, badges, inputs, actions, and loading parts behind app sidebars.",
+          "description": "A shell implementation needs the low-level responsive/collapsible sidebar compound.",
           "chooseWhen": [
             "A shell implementation needs the low-level responsive/collapsible sidebar compound."
           ],
@@ -5736,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": []
+        }
       ]
     },
     {
@@ -5800,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": []
+        }
       ]
     },
     {
@@ -5845,7 +6397,7 @@
       "guidance": [
         {
           "title": "Skeleton overview",
-          "description": "Reusable loading skeletons for content rows, pages, two-column detail views, and tables.",
+          "description": "Loading should preserve the approximate geometry of content, cards, tables, or pages.",
           "chooseWhen": [
             "Loading should preserve the approximate geometry of content, cards, tables, or pages."
           ],
@@ -6081,7 +6633,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/spinner",
@@ -6111,7 +6664,7 @@
       "guidance": [
         {
           "title": "Spinner",
-          "description": "Loading indicator with three visual variants. Pairs with content placeholders, route transitions, and Suspense fallbacks.",
+          "description": "A compact control or bounded area needs an indeterminate activity indicator.",
           "chooseWhen": [
             "A compact control or bounded area needs an indeterminate activity indicator."
           ],
@@ -6168,7 +6721,8 @@
             "themelia-react-ui/base/skeleton"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/structure",
@@ -6201,14 +6755,22 @@
         "foundations",
         "structure"
       ],
-      "aliases": [],
+      "aliases": [
+        "copy gaps",
+        "copy-gap",
+        "title description spacing"
+      ],
+      "references": [
+        "references/design-contract.md",
+        "references/theming.md#copy-rhythm"
+      ],
       "sections": [
         "Foundations"
       ],
       "guidance": [
         {
           "title": "Structural composition",
-          "description": "Stack, Grid, GridCell, and AdaptiveGrid provide one truthful grammar for passive sibling arrangement.",
+          "description": "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks.",
           "chooseWhen": [
             "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
           ],
@@ -6271,6 +6833,167 @@
             "themelia-react-ui/features/table"
           ]
         }
+      ],
+      "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": []
+        }
       ]
     },
     {
@@ -6312,7 +7035,7 @@
       "guidance": [
         {
           "title": "Table primitives",
-          "description": "Styled table elements that wrap shadcn table parts with package density, spacing, and stable DOM hooks.",
+          "description": "Custom semantic table markup only needs package-styled HTML table parts.",
           "chooseWhen": [
             "Custom semantic table markup only needs package-styled HTML table parts."
           ],
@@ -6353,7 +7076,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/text-inputs",
@@ -6412,7 +7136,7 @@
       "guidance": [
         {
           "title": "Text inputs overview",
-          "description": "Controls for free-form text entry: the input itself, its multi-line and grouped forms, and the password and slug variants.",
+          "description": "The value is free-form text the user types.",
           "chooseWhen": [
             "The value is free-form text the user types."
           ],
@@ -6600,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"
+          ]
+        }
       ]
     },
     {
@@ -6618,11 +7372,8 @@
         "Application-level transient feedback should be rendered through the package Sonner host."
       ],
       "tags": [
-        "base",
-        "feedback",
         "optional-peer",
-        "sonner",
-        "toaster"
+        "sonner"
       ],
       "aliases": [],
       "sections": [
@@ -6631,7 +7382,7 @@
       "guidance": [
         {
           "title": "Toaster",
-          "description": "Provider-backed Sonner wrapper with refined admin notification chrome and bottom-center defaults.",
+          "description": "Application-level transient feedback should be rendered through the package Sonner host.",
           "chooseWhen": [
             "Application-level transient feedback should be rendered through the package Sonner host."
           ],
@@ -6643,9 +7394,6 @@
             "Application-level transient feedback should be rendered through the package Sonner host."
           ],
           "tags": [
-            "base",
-            "feedback",
-            "toaster",
             "optional-peer",
             "sonner"
           ],
@@ -6682,7 +7430,8 @@
             "themelia-react-ui/base/forms"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/tree",
@@ -6736,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": []
+        }
       ]
     },
     {
@@ -6813,7 +7578,7 @@
       "guidance": [
         {
           "title": "Upload overview",
-          "description": "File and media surfaces — dropzone, file/image/avatar upload, progress list, upload tray, and media gallery. The consumer always owns the transfer.",
+          "description": "A surface selects, validates, previews, or reports progress for files the consumer will transfer.",
           "chooseWhen": [
             "A surface selects, validates, previews, or reports progress for files the consumer will transfer."
           ],
@@ -7017,7 +7782,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/upload-queue",
@@ -7143,7 +7909,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/base/value-inputs",
@@ -7201,7 +7968,7 @@
       "guidance": [
         {
           "title": "Value inputs overview",
-          "description": "Controls that edit one structured value through a bespoke affordance: tags, phone numbers, colours, ranges, and date-time.",
+          "description": "One structured value needs its own editing affordance — tags, phone, colour, range, date-time.",
           "chooseWhen": [
             "One structured value needs its own editing affordance — tags, phone, colour, range, date-time."
           ],
@@ -7243,7 +8010,7 @@
         },
         {
           "title": "Color input",
-          "description": "Exact CSS-color entry paired with an accessible visual color picker and live swatch.",
+          "description": "A form needs exact CSS-color entry and an accessible visual color picker on one value channel.",
           "chooseWhen": [
             "A form needs exact CSS-color entry and an accessible visual color picker on one value channel."
           ],
@@ -7437,7 +8204,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/admin",
@@ -7494,7 +8262,7 @@
       "guidance": [
         {
           "title": "Admin overview",
-          "description": "Role permissions, credential lists, and security action surfaces for admin settings pages — the parts of an admin screen that are worth standardizing.",
+          "description": "Console screens need permission matrices, API-key and token management, or confirmation-gated destructive actions.",
           "chooseWhen": [
             "Console screens need permission matrices, API-key and token management, or confirmation-gated destructive actions."
           ],
@@ -7669,7 +8437,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/ai",
@@ -7844,7 +8613,7 @@
       "guidance": [
         {
           "title": "AI overview",
-          "description": "Card-free AI presentation blocks — summaries, reasoning traces, tool calls, citations, artifacts — that the consumer frames, fills, and wires.",
+          "description": "Model output needs a presentation block — summary, reasoning, citation, tool call, artifact — inside a surface the app already owns.",
           "chooseWhen": [
             "Model output needs a presentation block — summary, reasoning, citation, tool call, artifact — inside a surface the app already owns."
           ],
@@ -8768,7 +9537,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/analytics",
@@ -8819,9 +9589,19 @@
         "TimeDistributionRuler",
         "TimeDistributionRulerProps",
         "TimeDistributionRulerStrings",
+        "UsageCard",
+        "UsageCardCategory",
+        "UsageCardData",
+        "UsageCardDay",
+        "UsageCardPeriod",
+        "UsageCardProps",
+        "UsageCardQuota",
+        "UsageCardResource",
+        "UsageCardStrings",
         "defaultAnalyticsStrings",
         "defaultMetricComparisonStrings",
         "defaultTimeDistributionRulerStrings",
+        "defaultUsageCardStrings",
         "formatMetricValue",
         "resolveTrend"
       ],
@@ -8832,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": [
@@ -8857,27 +9637,48 @@
         "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"
       ],
       "guidance": [
         {
           "title": "Analytics overview",
-          "description": "One Metric data contract for KPI variants, bars, grids, trends, and sparklines, plus ChartCard for caller-owned chart series.",
+          "description": "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics.",
           "chooseWhen": [
             "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics."
           ],
           "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."
           ],
           "tags": [
-            "blocks",
-            "analytics",
             "optional-peer",
             "recharts"
           ],
@@ -8906,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",
@@ -8943,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",
@@ -9201,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",
@@ -9237,7 +10079,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/data-display"
+          ]
         },
         {
           "title": "Time distribution",
@@ -9279,6 +10124,152 @@
           ],
           "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"
+          ]
+        }
+      ]
+    },
+    {
+      "import": "themelia-react-ui/blocks/analytics/usage-card",
+      "declaration": "dist/components/blocks/analytics/usage-card/index.d.ts",
+      "symbols": [
+        "UsageCard",
+        "UsageCardCategory",
+        "UsageCardData",
+        "UsageCardDay",
+        "UsageCardPeriod",
+        "UsageCardProps",
+        "UsageCardQuota",
+        "UsageCardResource",
+        "UsageCardStrings",
+        "defaultUsageCardStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "blocks",
+      "responsibility": "Blocks family: Usage card.",
+      "jobs": [
+        "UsageCard needs used/limit quotas, category shares, daily usage and controlled period/loading/error/retry states in one owned Card."
+      ],
+      "tags": [
+        "billing summary",
+        "blocks",
+        "credits",
+        "daily analytics",
+        "quota",
+        "resources",
+        "usage"
+      ],
+      "aliases": [
+        "quota dashboard",
+        "resource limits",
+        "usage statistics",
+        "usage summary"
+      ],
+      "sections": [
+        "Blocks"
+      ],
+      "guidance": [
+        {
+          "title": "Usage card",
+          "description": "Quota summaries, category shares, daily analytics and resource limits with app-owned period data.",
+          "chooseWhen": [
+            "UsageCard needs used/limit quotas, category shares, daily usage and controlled period/loading/error/retry states in one owned Card."
+          ],
+          "avoidWhen": [
+            "The subject is a general revenue KPI or an arbitrary chart series."
+          ],
+          "appOwned": [
+            "usage values, limits and chronological daily data",
+            "period selection, requests and stale-result handling",
+            "billing or navigation footer actions"
+          ],
+          "jobs": [
+            "UsageCard needs used/limit quotas, category shares, daily usage and controlled period/loading/error/retry states in one owned Card."
+          ],
+          "tags": [
+            "blocks",
+            "usage",
+            "quota",
+            "credits",
+            "daily analytics",
+            "resources",
+            "billing summary"
+          ],
+          "aliases": [
+            "usage statistics",
+            "usage summary",
+            "quota dashboard",
+            "resource limits"
+          ],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Analytics",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "UsageCard"
+              ]
+            }
+          ],
+          "alternatives": [
+            "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": []
+        }
       ]
     },
     {
@@ -9302,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",
@@ -9338,10 +10341,39 @@
             "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": []
+        }
+      ]
     },
     {
       "import": "themelia-react-ui/blocks/commerce",
@@ -9576,7 +10608,7 @@
       "guidance": [
         {
           "title": "Commerce overview",
-          "description": "Read-mostly display blocks for recognisable commerce subjects — orders, invoices, carts, shipments, bookings, giftcards, and vendors.",
+          "description": "A screen renders a recognisable commerce subject — order, invoice, cart, shipment, giftcard, booking, vendor — as read-mostly display.",
           "chooseWhen": [
             "A screen renders a recognisable commerce subject — order, invoice, cart, shipment, giftcard, booking, vendor — as read-mostly display."
           ],
@@ -10632,7 +11664,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/blocks/commerce/receipt",
@@ -10733,6 +11766,23 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": [
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "Receipt",
+            "ReceiptItems",
+            "ReceiptLineItem"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
       ]
     },
     {
@@ -10815,7 +11865,15 @@
         "blocks/empty-state",
         "blocks/inline-stat",
         "blocks/metadata-list",
-        "blocks/relationship-card-frame"
+        "blocks/relationship-card-frame",
+        "contact details",
+        "details",
+        "fact list",
+        "inline fact",
+        "key value",
+        "plain label value",
+        "read-only facts",
+        "simple statistic"
       ],
       "sections": [
         "Blocks"
@@ -10823,7 +11881,7 @@
       "guidance": [
         {
           "title": "Data display overview",
-          "description": "Generic, domain-free readouts: entity facts, single stats, dense info cards, relationship frames, and the standard empty state.",
+          "description": "Entity facts, relationships, dense readouts, or empty regions need the package recipe instead of an app-local one.",
           "chooseWhen": [
             "Entity facts, relationships, dense readouts, or empty regions need the package recipe instead of an app-local one."
           ],
@@ -10865,7 +11923,7 @@
         },
         {
           "title": "Dense info",
-          "description": "Five layout variants — dashboard, classification, financial, project, score.",
+          "description": "A dashboard, classification, financial, project, or score readout needs many facts in one tight card.",
           "chooseWhen": [
             "A dashboard, classification, financial, project, or score readout needs many facts in one tight card."
           ],
@@ -10919,7 +11977,7 @@
         },
         {
           "title": "Empty state",
-          "description": "Adaptive zero-data surface. Wrap with the right illustration per resource — products, users, search results, inbox. Slots for media / actions / footer; consumer overrides every string.",
+          "description": "No-data, no-results, or first-run content needs the standard media, title, description, and actions recipe.",
           "chooseWhen": [
             "No-data, no-results, or first-run content needs the standard media, title, description, and actions recipe."
           ],
@@ -10980,14 +12038,17 @@
         },
         {
           "title": "Inline stat",
-          "description": "Inline label/value pairs for counters, totals, and compact card rows. Use MetadataList for entity detail fields.",
+          "description": "One compact label/value pair needs inline emphasis without trend or chart semantics.",
           "chooseWhen": [
             "One compact label/value pair needs inline emphasis without trend or chart semantics."
           ],
           "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."
           ],
@@ -10998,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": {
@@ -11030,14 +12096,18 @@
         },
         {
           "title": "Metadata list",
-          "description": "Flexible label/value facts with strong grid, rows, and inline defaults; responsive columns; typed value descriptors; and first-class empty handling.",
+          "description": "Customer, order, account, or record label/value facts need a grid, rows, or inline summary.",
           "chooseWhen": [
             "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
           ],
           "avoidWhen": [
             "Each row has independent identity/actions or the relationship needs title, alerts, and action regions."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "fact labels and priority",
+            "loaded subject data",
+            "formatting defaults"
+          ],
           "jobs": [
             "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
           ],
@@ -11048,7 +12118,12 @@
             "metadata-list"
           ],
           "aliases": [
-            "blocks/metadata-list"
+            "blocks/metadata-list",
+            "fact list",
+            "read-only facts",
+            "contact details",
+            "key value",
+            "details"
           ],
           "section": "Blocks",
           "browse": {
@@ -11100,7 +12175,7 @@
         },
         {
           "title": "Relationship card frame",
-          "description": "Card-free title, badge, alert, selector, metadata, action, and details regions for app-owned relationship content.",
+          "description": "App-owned relationship content needs title, badge, alert, selector, metadata, actions, and details regions.",
           "chooseWhen": [
             "App-owned relationship content needs title, badge, alert, selector, metadata, actions, and details regions."
           ],
@@ -11157,6 +12232,83 @@
             "themelia-react-ui/features/resource-assignment"
           ]
         }
+      ],
+      "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": []
+        }
       ]
     },
     {
@@ -11225,6 +12377,107 @@
           ],
           "alternatives": []
         }
+      ],
+      "recipes": []
+    },
+    {
+      "import": "themelia-react-ui/blocks/planning",
+      "declaration": "dist/components/blocks/planning/index.d.ts",
+      "symbols": [
+        "TaskCard",
+        "TaskCardDueDate",
+        "TaskCardItem",
+        "TaskCardProps",
+        "TaskCardStatus",
+        "TaskCardStrings",
+        "defaultTaskCardStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "blocks",
+      "responsibility": "Blocks family: Task card.",
+      "jobs": [
+        "Assignment",
+        "Controlled checklist",
+        "Task summary"
+      ],
+      "tags": [
+        "assignee",
+        "blocks",
+        "checklist",
+        "progress",
+        "subtasks",
+        "task"
+      ],
+      "aliases": [],
+      "sections": [
+        "Blocks"
+      ],
+      "guidance": [
+        {
+          "title": "Task card",
+          "description": "Compact task summaries with accessible expansion, controlled subtasks and assignment.",
+          "chooseWhen": [
+            "A task needs a compact summary with optional expanded controlled subtasks."
+          ],
+          "avoidWhen": [
+            "A complete task board or task-persistence workflow is required."
+          ],
+          "appOwned": [
+            "Persistence, permissions, data requests and navigation."
+          ],
+          "jobs": [
+            "Task summary",
+            "Controlled checklist",
+            "Assignment"
+          ],
+          "tags": [
+            "blocks",
+            "task",
+            "checklist",
+            "subtasks",
+            "assignee",
+            "progress"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Planning",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "TaskCard"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/blocks/ai",
+            "themelia-react-ui/blocks/onboarding",
+            "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": []
+        }
       ]
     },
     {
@@ -11280,7 +12533,7 @@
       "guidance": [
         {
           "title": "Timelines overview",
-          "description": "The shared marker-rail engine plus its domain-neutral readings: finite steps, release changelogs, and project milestones. Mixed audit, domain, system, and comment activity belongs to the Features activity log instead.",
+          "description": "Read-only milestones, steps, or changelogs need marker-rail presentation, or a new rail needs the shared Timeline engine.",
           "chooseWhen": [
             "Read-only milestones, steps, or changelogs need marker-rail presentation, or a new rail needs the shared Timeline engine."
           ],
@@ -11487,7 +12740,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/component-vocabulary",
@@ -11509,7 +12763,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/activities",
@@ -11595,11 +12850,9 @@
       "tags": [
         "activities",
         "activity",
-        "activity-timeline",
         "audit",
         "build",
         "collaboration",
-        "docs",
         "features",
         "timeline"
       ],
@@ -11627,9 +12880,7 @@
             "Build an auditable resource history with mixed events, comments, and milestones."
           ],
           "tags": [
-            "docs",
             "build",
-            "activity-timeline",
             "activity",
             "timeline",
             "audit"
@@ -11660,7 +12911,7 @@
         },
         {
           "title": "Activity log",
-          "description": "One canonical collaboration activity surface: comments, composer, audit events, system events, domain events, mentions, row actions, metadata, changes, and collapsible details under one chronological timeline.",
+          "description": "Mixed comments, audit/domain/system events, adapters, metadata, details, and row actions share one log.",
           "chooseWhen": [
             "Mixed comments, audit/domain/system events, adapters, metadata, details, and row actions share one log."
           ],
@@ -11713,7 +12964,8 @@
             "themelia-react-ui/features/comments"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/ai-chat",
@@ -11831,7 +13083,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/async-preview",
@@ -11893,7 +13146,7 @@
       "guidance": [
         {
           "title": "Async preview",
-          "description": "Accessible hover, focus, cell, and inline previews with callback-owned fetching, caching, and state composition.",
+          "description": "A lazy or preloaded hover preview is needed inline or from a table cell trigger.",
           "chooseWhen": [
             "A lazy or preloaded hover preview is needed inline or from a table cell trigger."
           ],
@@ -11957,7 +13210,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/combobox",
@@ -11994,10 +13248,8 @@
       "tags": [
         "async",
         "async-resource-combobox",
-        "async-selection",
         "build",
         "combobox",
-        "docs",
         "features",
         "inputs",
         "retry"
@@ -12026,9 +13278,7 @@
             "Build an async resource selector that handles rejection, retry, and fast-changing queries."
           ],
           "tags": [
-            "docs",
             "build",
-            "async-selection",
             "async",
             "combobox",
             "retry"
@@ -12059,7 +13309,7 @@
         },
         {
           "title": "Combobox",
-          "description": "Searchable single, multiple, grouped, creatable, and async selectors with consumer-owned options and fetch lifecycle.",
+          "description": "A field needs searchable single/multiple selection, async resource lookup, or headless combobox composition.",
           "chooseWhen": [
             "A field needs searchable single/multiple selection, async resource lookup, or headless combobox composition."
           ],
@@ -12159,7 +13409,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/comments",
@@ -12279,7 +13530,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/data-view",
@@ -12323,24 +13575,22 @@
       "layer": "features",
       "responsibility": "Features family: Data view; Operational index.",
       "jobs": [
-        "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots.",
-        "Build a filtered operational index with selection, actions, and formatted cells."
+        "Build a filtered operational index with selection, actions, and formatted cells.",
+        "Compose a coordinated record directory when the feature query, view and collection contracts fit."
       ],
       "tags": [
         "build",
-        "data-view",
-        "docs",
-        "features",
         "filters",
         "index",
-        "operational-index",
         "optional-peer",
         "table",
-        "tables",
         "tanstack-react-table"
       ],
       "aliases": [
-        "docs/composition-recipes"
+        "contacts list",
+        "docs/composition-recipes",
+        "record directory",
+        "scoped collection"
       ],
       "sections": [
         "Features",
@@ -12365,9 +13615,7 @@
             "Build a filtered operational index with selection, actions, and formatted cells."
           ],
           "tags": [
-            "docs",
             "build",
-            "operational-index",
             "index",
             "table",
             "filters"
@@ -12400,25 +13648,30 @@
         },
         {
           "title": "Data view",
-          "description": "Controlled data-view chrome for tables, filters, saved views, and pagination. Consumers own fetching, query state, table data, and persistence.",
+          "description": "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots.",
           "chooseWhen": [
             "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots."
           ],
           "avoidWhen": [
             "Only table behavior is needed or the page already owns a different index/workspace composition."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "fixed scope versus editable criteria",
+            "server transport and authoritative records",
+            "record priority, permissions and commands"
+          ],
           "jobs": [
-            "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots."
+            "Compose a coordinated record directory when the feature query, view and collection contracts fit."
           ],
           "tags": [
-            "features",
-            "tables",
-            "data-view",
             "optional-peer",
             "tanstack-react-table"
           ],
-          "aliases": [],
+          "aliases": [
+            "record directory",
+            "scoped collection",
+            "contacts list"
+          ],
           "section": "Features",
           "browse": {
             "category": "data-display",
@@ -12453,7 +13706,8 @@
             "themelia-react-ui/features/table"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/email-composer",
@@ -12497,9 +13751,7 @@
         "Compose and prepare personalized email with application-owned delivery."
       ],
       "tags": [
-        "collaboration",
         "email",
-        "features",
         "optional-peer",
         "templates",
         "tiptap"
@@ -12524,12 +13776,10 @@
             "Compose and prepare personalized email with application-owned delivery."
           ],
           "tags": [
-            "features",
-            "collaboration",
-            "email",
-            "templates",
             "optional-peer",
-            "tiptap"
+            "tiptap",
+            "email",
+            "templates"
           ],
           "aliases": [],
           "section": "Features",
@@ -12573,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"
+          ]
+        }
       ]
     },
     {
@@ -12607,7 +13895,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/event-calendar",
@@ -12673,7 +13962,7 @@
       "guidance": [
         {
           "title": "Event calendar",
-          "description": "Month view with categories, filtering, navigation rules, custom event rendering, and three day-heading variants.",
+          "description": "Events need month/week/agenda browsing, categories, day rendering, and callback-driven actions.",
           "chooseWhen": [
             "Events need month/week/agenda browsing, categories, day rendering, and callback-driven actions."
           ],
@@ -12841,7 +14130,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/filters",
@@ -12943,21 +14233,27 @@
         "filters",
         "search & filter"
       ],
-      "aliases": [],
+      "aliases": [
+        "query toolbar"
+      ],
       "sections": [
         "Features"
       ],
       "guidance": [
         {
           "title": "Filters",
-          "description": "Composable filter system. Search + multi-select stay always visible; the rest collapse behind a Filters button. Provider-driven so it works with any data source.",
+          "description": "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job.",
           "chooseWhen": [
             "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job."
           ],
           "avoidWhen": [
             "A complete table/index frame is desired with minimal assembly."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "query transport and scope retention",
+            "criteria definitions and options",
+            "server results and request lifecycle"
+          ],
           "jobs": [
             "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job."
           ],
@@ -12966,7 +14262,9 @@
             "search & filter",
             "filters"
           ],
-          "aliases": [],
+          "aliases": [
+            "query toolbar"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -13000,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"
+          ]
+        }
       ]
     },
     {
@@ -13096,7 +14417,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/kanban",
@@ -13142,10 +14464,7 @@
         "Use Kanban in an admin interface."
       ],
       "tags": [
-        "boards",
         "dnd-kit",
-        "features",
-        "kanban",
         "optional-peer"
       ],
       "aliases": [],
@@ -13163,9 +14482,6 @@
             "Use Kanban in an admin interface."
           ],
           "tags": [
-            "features",
-            "boards",
-            "kanban",
             "optional-peer",
             "dnd-kit"
           ],
@@ -13197,7 +14513,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/map",
@@ -13276,7 +14593,7 @@
       "guidance": [
         {
           "title": "Map",
-          "description": "Leaflet-backed map primitives — Map shell, MapTileLayer, MapMarker, MapPopup. Always wrap in a fixed-height container.",
+          "description": "A Leaflet map needs package controls, layers, markers, drawing, localization, or place search.",
           "chooseWhen": [
             "A Leaflet map needs package controls, layers, markers, drawing, localization, or place search."
           ],
@@ -13288,9 +14605,6 @@
             "A Leaflet map needs package controls, layers, markers, drawing, localization, or place search."
           ],
           "tags": [
-            "features",
-            "navigation & data",
-            "map",
             "optional-peer",
             "leaflet",
             "react-leaflet"
@@ -13374,7 +14688,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/media-library",
@@ -13450,14 +14765,9 @@
         "Use Media library in an admin interface."
       ],
       "tags": [
-        "assets",
         "build",
         "dnd-kit",
-        "docs",
-        "features",
         "media",
-        "media-library",
-        "media-workflow",
         "optional-peer",
         "selection",
         "upload"
@@ -13486,9 +14796,7 @@
             "Build a media selection workflow with app-owned storage services and package-owned UI states."
           ],
           "tags": [
-            "docs",
             "build",
-            "media-workflow",
             "media",
             "upload",
             "selection"
@@ -13526,9 +14834,6 @@
             "Use Media library in an admin interface."
           ],
           "tags": [
-            "features",
-            "assets",
-            "media-library",
             "optional-peer",
             "dnd-kit"
           ],
@@ -13577,7 +14882,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/mentions",
@@ -13670,7 +14976,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/overlays",
@@ -13723,7 +15030,7 @@
       "guidance": [
         {
           "title": "Action overlays",
-          "description": "Callback-driven ActionDialog, ActionDrawer, and ConfirmDialog recipes blocks over the base Dialog, Sheet, and AlertDialog primitives.",
+          "description": "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior.",
           "chooseWhen": [
             "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior."
           ],
@@ -13764,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": []
+        }
       ]
     },
     {
@@ -13910,7 +15246,7 @@
       "guidance": [
         {
           "title": "Products",
-          "description": "Shopify-style product editor surfaces built from standalone product feature components. Routing, forms, and persistence stay consumer-owned.",
+          "description": "Product workspace/editor state, options, variants, tables, support rails, and callbacks must compose together.",
           "chooseWhen": [
             "Product workspace/editor state, options, variants, tables, support rails, and callbacks must compose together."
           ],
@@ -14202,7 +15538,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/questionnaire",
@@ -14267,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": []
+        }
       ]
     },
     {
@@ -14357,7 +15711,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/resource-assignment",
@@ -14439,7 +15794,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/rich-text-editor",
@@ -14471,10 +15827,7 @@
         "Use Rich text editor in an admin interface."
       ],
       "tags": [
-        "features",
-        "inputs",
         "optional-peer",
-        "rich-text",
         "tiptap"
       ],
       "aliases": [],
@@ -14492,9 +15845,6 @@
             "Use Rich text editor in an admin interface."
           ],
           "tags": [
-            "features",
-            "inputs",
-            "rich-text",
             "optional-peer",
             "tiptap"
           ],
@@ -14520,7 +15870,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/schema-form",
@@ -14624,7 +15975,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/suggestions",
@@ -14693,7 +16045,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/sync",
@@ -14764,7 +16117,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/features/table",
@@ -14854,41 +16208,47 @@
       "layer": "features",
       "responsibility": "Features family: Data table.",
       "jobs": [
-        "Table columns, cells, sorting, selection, density, sticky behavior, or row actions are needed without index-page coordination."
+        "Compare records in columns; use ResourceCell for identity cells and CellStack for prioritized supporting values.",
+        "Place app-controlled query tools in topbarContent, export in topbarEnd, and selection commands in bulkActions."
       ],
       "tags": [
-        "features",
         "optional-peer",
-        "table",
-        "tables",
         "tanstack-react-table"
       ],
-      "aliases": [],
+      "aliases": [
+        "comparison table",
+        "identity cell"
+      ],
       "sections": [
         "Features"
       ],
       "guidance": [
         {
           "title": "Data table",
-          "description": "Admin-dense table presentation with sorting, selection, actions, typed cells, toolbar slots, sticky behavior, and pagination.",
+          "description": "Comparison columns, identity cells, sorting, selection or row actions are needed with app-owned query coordination and native toolbar/pagination seams.",
           "chooseWhen": [
-            "Table columns, cells, sorting, selection, density, sticky behavior, or row actions are needed without index-page coordination."
+            "Comparison columns, identity cells, sorting, selection or row actions are needed with app-owned query coordination and native toolbar/pagination seams."
           ],
           "avoidWhen": [
-            "The standard page also needs filter coordination, saved views, framing, and pagination slots."
+            "DataView already covers the required coordinated index workflow, or records do not benefit from comparison columns."
+          ],
+          "appOwned": [
+            "records and row IDs",
+            "query transport, server paging and scope",
+            "column priority, permissioned commands and navigation"
           ],
-          "appOwned": [],
           "jobs": [
-            "Table columns, cells, sorting, selection, density, sticky behavior, or row actions are needed without index-page coordination."
+            "Compare records in columns; use ResourceCell for identity cells and CellStack for prioritized supporting values.",
+            "Place app-controlled query tools in topbarContent, export in topbarEnd, and selection commands in bulkActions."
           ],
           "tags": [
-            "features",
-            "tables",
-            "table",
             "optional-peer",
             "tanstack-react-table"
           ],
-          "aliases": [],
+          "aliases": [
+            "comparison table",
+            "identity cell"
+          ],
           "section": "Features",
           "browse": {
             "category": "data-display",
@@ -14940,19 +16300,56 @@
             "themelia-react-ui/features/data-view"
           ]
         }
-      ]
-    },
-    {
-      "import": "themelia-react-ui/features/theme-tweaker",
-      "declaration": "dist/components/features/theme-tweaker/index.d.ts",
-      "symbols": [
-        "AdminUIElevationRecipe",
-        "AdminUIPaletteRecipe",
-        "AdminUIThemeDefinition",
-        "AdminUIThemeMode",
-        "AdminUIThemeOverrides",
-        "AdminUIThemeProvider",
-        "AdminUIThemeProviderProps",
+      ],
+      "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"
+          ]
+        }
+      ]
+    },
+    {
+      "import": "themelia-react-ui/features/theme-tweaker",
+      "declaration": "dist/components/features/theme-tweaker/index.d.ts",
+      "symbols": [
+        "AdminUIElevationRecipe",
+        "AdminUIPaletteRecipe",
+        "AdminUIThemeDefinition",
+        "AdminUIThemeMode",
+        "AdminUIThemeOverrides",
+        "AdminUIThemeProvider",
+        "AdminUIThemeProviderProps",
         "AdminUIThemeSelectors",
         "AdminUIThemeStyle",
         "AdminUIThemeVariableName",
@@ -15005,11 +16402,9 @@
       "tags": [
         "build",
         "configuration",
-        "docs",
         "features",
         "provider",
         "tenant",
-        "tenant-theme",
         "theme",
         "theme-tweaker"
       ],
@@ -15037,9 +16432,7 @@
             "Build a tenant theme boundary that coordinates public variables and UIProvider defaults."
           ],
           "tags": [
-            "docs",
             "build",
-            "tenant-theme",
             "theme",
             "tenant",
             "provider"
@@ -15068,7 +16461,7 @@
         },
         {
           "title": "Theme tweaker",
-          "description": "Interactive CSS-variable theme editor with scoped application, portal-safe provider composition, and checked CSS/UIProvider export.",
+          "description": "A consumer needs an interactive theme studio, derived brand/type/elevation recipes, scoped or document-level live preview, a combined root theme/config boundary, complete or compact CSS export, or a typed UIProvider recipe.",
           "chooseWhen": [
             "A consumer needs an interactive theme studio, derived brand/type/elevation recipes, scoped or document-level live preview, a combined root theme/config boundary, complete or compact CSS export, or a typed UIProvider recipe."
           ],
@@ -15130,7 +16523,8 @@
             "themelia-react-ui/base/repeaters"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout",
@@ -15372,7 +16766,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/app-shell",
@@ -15405,20 +16800,24 @@
       "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",
-        "application-shell",
         "build",
-        "docs",
         "layout",
         "navigation",
         "responsive",
         "shell",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "admin workspace",
+        "application shell",
+        "dark header",
+        "dark header layout",
+        "light header"
+      ],
       "sections": [
         "Layouts",
         "Recipes"
@@ -15442,9 +16841,7 @@
             "Build a responsive admin application shell with header, sidebar, navigation, and one page viewport."
           ],
           "tags": [
-            "docs",
             "build",
-            "application-shell",
             "shell",
             "navigation",
             "responsive"
@@ -15475,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",
@@ -15505,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": []
         }
       ]
     },
@@ -15636,7 +17070,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/containers",
@@ -15657,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": "Width, scroll, semantic section, and two-column owners for framework-neutral page composition.",
+          "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",
@@ -15728,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": []
+        }
       ]
     },
     {
@@ -15764,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",
@@ -15813,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": []
         }
       ]
     },
@@ -15880,7 +17392,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/navigation",
@@ -15930,7 +17443,7 @@
       "guidance": [
         {
           "title": "Navigation regions",
-          "description": "The navigation regions that frame a page — SideNav, SectionNav, CategoryNav, and BreadcrumbProgress.",
+          "description": "A vertical route rail, in-page anchor nav, category browse rail, or multi-step progress trail needs to frame content it does not own.",
           "chooseWhen": [
             "A vertical route rail, in-page anchor nav, category browse rail, or multi-step progress trail needs to frame content it does not own."
           ],
@@ -16090,7 +17603,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/page",
@@ -16120,15 +17634,23 @@
       "tags": [
         "build",
         "detail",
-        "docs",
         "layout",
         "metadata",
         "page",
         "relationships",
-        "resource-detail",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "centered detail page",
+        "narrow resource page",
+        "page gutters",
+        "page header",
+        "page padding",
+        "route heading",
+        "scope navigation",
+        "single record page",
+        "single resource page"
+      ],
       "sections": [
         "Layouts",
         "Recipes"
@@ -16152,9 +17674,7 @@
             "Build a responsive resource detail page with primary facts, related context, and actions."
           ],
           "tags": [
-            "docs",
             "build",
-            "resource-detail",
             "detail",
             "metadata",
             "relationships"
@@ -16185,14 +17705,18 @@
         },
         {
           "title": "Page shell",
-          "description": "Framework-neutral page header, actions, containment, and body composition without duplicate scroll ownership.",
+          "description": "A page needs shell-level title, back/link rendering, actions, content, and page composition slots.",
           "chooseWhen": [
             "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
           ],
           "avoidWhen": [
             "An existing shell needs only a visual title/description/badge block."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "route title and contextual lead",
+            "primary command importance",
+            "navigation callbacks and permissioned actions"
+          ],
           "jobs": [
             "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
           ],
@@ -16201,7 +17725,17 @@
             "shells",
             "page"
           ],
-          "aliases": [],
+          "aliases": [
+            "page header",
+            "page padding",
+            "page gutters",
+            "route heading",
+            "scope navigation",
+            "narrow resource page",
+            "centered detail page",
+            "single resource page",
+            "single record page"
+          ],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -16232,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"
+          ]
+        }
       ]
     },
     {
@@ -16304,7 +17888,8 @@
           ],
           "alternatives": []
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/layout/sidebar",
@@ -16356,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",
@@ -16407,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": []
         }
       ]
     },
@@ -16445,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",
@@ -16469,7 +18165,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/lib/utils",
@@ -16484,7 +18181,8 @@
       "tags": [],
       "aliases": [],
       "sections": [],
-      "guidance": []
+      "guidance": [],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/primitives",
@@ -16597,7 +18295,7 @@
       "guidance": [
         {
           "title": "Primitives overview",
-          "description": "Semantic display primitives for identities, values, links, money, numbers, durations, dimensions, file sizes, and dates. Use these before hand-rolling text classes in metadata, cards, tables, previews, and activity surfaces.",
+          "description": "Displayed data has money, date, contact, identity, code, numeric, duration, or empty-value semantics.",
           "chooseWhen": [
             "Displayed data has money, date, contact, identity, code, numeric, duration, or empty-value semantics."
           ],
@@ -17072,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": []
+        }
       ]
     },
     {
@@ -17170,13 +18969,10 @@
       "tags": [
         "actions",
         "feedback",
-        "foundations",
         "lifecycle",
         "overlays",
         "request-runner",
-        "runtime",
-        "runtime & provider",
-        "services"
+        "runtime"
       ],
       "aliases": [],
       "sections": [
@@ -17197,9 +18993,6 @@
             "Share one action definition across buttons, menus, command results, and overlays without coupling the package to an application framework."
           ],
           "tags": [
-            "foundations",
-            "runtime & provider",
-            "services",
             "actions",
             "runtime",
             "lifecycle",
@@ -17250,7 +19043,8 @@
             "themelia-react-ui/features/overlays"
           ]
         }
-      ]
+      ],
+      "recipes": []
     },
     {
       "import": "themelia-react-ui/typography",
@@ -17260,6 +19054,7 @@
         "DisplayLabelProps",
         "Heading",
         "HeadingProps",
+        "HeadingSize",
         "HeadingTag",
         "Label",
         "LabelProps",
@@ -17287,7 +19082,7 @@
       "guidance": [
         {
           "title": "Typography",
-          "description": "Heading, Text, DisplayLabel, Label, and TextLink — the typography primitives every higher layer composes from.",
+          "description": "Library-owned prose, headings, labels, or text links need a typography role.",
           "chooseWhen": [
             "Library-owned prose, headings, labels, or text links need a typography role."
           ],
@@ -17370,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": []
+        }
       ]
     },
     {
@@ -17382,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",
@@ -17453,18 +19448,30 @@
       "layer": "foundations",
       "responsibility": "Stable display defaults through UIProvider and a basic CSS-inheritance ThemeScope with native div/style props and portal hosting. The root re-exports this same ThemeScope.",
       "jobs": [
+        "Host a CSS-inheriting ThemeScope and its portals at a theme boundary.",
         "Set locale, density, formatting, and component defaults once without moving request or application state into the package."
       ],
       "tags": [
         "configuration",
         "display-defaults",
-        "foundations",
         "provider",
-        "runtime",
-        "runtime & provider",
-        "ui-provider"
+        "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"
       ],
-      "aliases": [],
       "sections": [
         "Foundations"
       ],
@@ -17473,25 +19480,31 @@
           "title": "UIProvider",
           "description": "Configure one React-root boundary for stable application-wide display defaults.",
           "chooseWhen": [
-            "Stable application-wide display defaults need one isolated configuration boundary per React root."
+            "Stable application-wide display defaults need one isolated configuration boundary per React root.",
+            "ThemeScope needs to preserve CSS inheritance for portaled surfaces without an interactive theme editor."
           ],
           "avoidWhen": [
             "A value is visual CSS, call-site-specific, request-scoped, translated copy, or application state."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "semantic theme CSS and active theme selection",
+            "stable provider defaults",
+            "portal container within the active scope"
+          ],
           "jobs": [
-            "Set locale, density, formatting, and component defaults once without moving request or application state into the package."
+            "Set locale, density, formatting, and component defaults once without moving request or application state into the package.",
+            "Host a CSS-inheriting ThemeScope and its portals at a theme boundary."
           ],
           "tags": [
-            "foundations",
-            "runtime & provider",
-            "ui-provider",
             "provider",
             "configuration",
             "display-defaults",
             "runtime"
           ],
-          "aliases": [],
+          "aliases": [
+            "theme boundary",
+            "theming"
+          ],
           "section": "Foundations",
           "browse": {
             "category": "foundations",
@@ -17521,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": []
+        }
       ]
     }
   ]