themelia-react-ui 2.0.4 → 2.0.5

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

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "stylesheets": [
     "themelia-react-ui/style.css",
     "themelia-react-ui/theme.css",
@@ -289,37 +289,76 @@
       "layer": "base",
       "responsibility": "Base family: Accordion.",
       "jobs": [
-        "One or more labeled disclosure items need coordinated accordion behavior."
+        "Labeled disclosure or expandable form sections need coordinated state, custom validation badges or multiple open panels."
       ],
       "tags": [
         "accordion",
         "base",
         "display"
       ],
-      "aliases": [],
+      "aliases": [
+        "collapsible sections",
+        "disclosure sections",
+        "editable sections",
+        "expandable form sections"
+      ],
       "sections": [
         "Base components"
       ],
       "guidance": [
         {
           "title": "Accordion",
-          "description": "One or more labeled disclosure items need coordinated accordion behavior.",
+          "description": "Labeled disclosure or expandable form sections need coordinated state, custom validation badges or multiple open panels.",
           "chooseWhen": [
-            "One or more labeled disclosure items need coordinated accordion behavior."
+            "Labeled disclosure or expandable form sections need coordinated state, custom validation badges or multiple open panels."
           ],
           "avoidWhen": [
             "Only one custom trigger/content region needs low-level disclosure state."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "Form values, validation and submission",
+            "Which invalid section to open before focusing a field"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "Accordion",
+                "roles": [
+                  "disclosure-group",
+                  "editable-sections"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "self",
+                "slots": [
+                  "children"
+                ]
+              }
+            ],
+            "owns": [
+              "Coordinated disclosure state and keyboard behavior",
+              "Trigger typography, chevrons and panel geometry"
+            ],
+            "parentOwns": [
+              "Section content and validation badges",
+              "Form lifecycle and retained-field policy"
+            ],
+            "embedded": "Inspect compound AccordionContent.keepMounted for retained field DOM; SmartAccordion does not expose that prop. Keep panel headings separate from disclosure labels."
+          },
           "jobs": [
-            "One or more labeled disclosure items need coordinated accordion behavior."
+            "Labeled disclosure or expandable form sections need coordinated state, custom validation badges or multiple open panels."
           ],
           "tags": [
             "base",
             "display",
             "accordion"
           ],
-          "aliases": [],
+          "aliases": [
+            "expandable form sections",
+            "collapsible sections",
+            "editable sections",
+            "disclosure sections"
+          ],
           "section": "Base components",
           "browse": {
             "category": "surfaces-overlays",
@@ -347,7 +386,11 @@
             {
               "title": "API",
               "symbols": [
-                "SmartAccordion"
+                "SmartAccordion",
+                "Accordion",
+                "AccordionItem",
+                "AccordionTrigger",
+                "AccordionContent"
               ]
             }
           ],
@@ -356,7 +399,25 @@
           ]
         }
       ],
-      "recipes": []
+      "recipes": [
+        {
+          "file": "examples/editable-sections.tsx",
+          "exports": [
+            "EditableSections"
+          ],
+          "symbols": [
+            "Accordion",
+            "AccordionContent",
+            "AccordionItem",
+            "AccordionTrigger"
+          ],
+          "references": [
+            "references/custom-composition.md#disclosure-sections",
+            "references/rhf-workflows.md#screen-and-state-ownership"
+          ],
+          "optionalPeers": []
+        }
+      ]
     },
     {
       "import": "themelia-react-ui/base/action-menu",
@@ -903,6 +964,48 @@
         }
       ],
       "recipes": [
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "OrderFulfillmentDetail"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "ReceivableInvoiceDetail"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
         {
           "file": "examples/composition.tsx",
           "exports": [
@@ -915,6 +1018,37 @@
             "references/workflows.md#destructive-confirmation"
           ],
           "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/screen-archetypes.md",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/editable-sections.tsx",
+          "exports": [
+            "EditableSections"
+          ],
+          "symbols": [
+            "Badge"
+          ],
+          "references": [
+            "references/custom-composition.md#disclosure-sections",
+            "references/rhf-workflows.md#screen-and-state-ownership"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -1364,6 +1498,22 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/rhf-overlay-form.tsx",
+          "exports": [
+            "RHFDialogForm"
+          ],
+          "symbols": [
+            "Button"
+          ],
+          "references": [
+            "references/rhf-workflows.md#overlay-create-and-edit",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        },
         {
           "file": "examples/scoped-directory.tsx",
           "exports": [
@@ -1490,21 +1640,18 @@
                   "children",
                   "headerStart",
                   "footerSlot"
-                ],
-                "props": {
-                  "contentGap": "2xl"
-                }
+                ]
               }
             ],
             "owns": [
               "Surface framing, aligned insets and header/footer boundaries",
               "Title, suffix and action anatomy",
-              "Opt-in contentGap between direct body children"
+              "Related rhythm between direct body children; explicit contentGap overrides it"
             ],
             "parentOwns": [
               "Page gutters",
               "Gaps between independent subjects",
-              "Body layout when contentGap is omitted"
+              "Application content and interactions"
             ],
             "page": "Place each independent subject Card in the Page body or a layout column.",
             "embedded": "Use surface=\"flat\" padding=\"none\" inside an existing padded boundary; retain ordinary padding when that boundary has no inset."
@@ -1614,6 +1761,69 @@
           ],
           "optionalPeers": []
         },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "SoldProductWithSummary"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "OrderFulfillmentDetail"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "ReceivableInvoiceDetail"
+          ],
+          "symbols": [
+            "Card"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
         {
           "file": "examples/composition.tsx",
           "exports": [
@@ -1703,33 +1913,30 @@
           "optionalPeers": []
         },
         {
-          "file": "examples/index-table.tsx",
+          "file": "examples/planning-usage-edit.tsx",
           "exports": [
-            "AccountIndex"
+            "WorkspaceSummary"
           ],
           "symbols": [
             "Card"
           ],
           "references": [
-            "references/screen-archetypes.md",
-            "references/workflows.md#index-and-navigation"
+            "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": [
-            "@tanstack/react-table"
-          ]
+          "optionalPeers": []
         },
         {
-          "file": "examples/planning-usage-edit.tsx",
+          "file": "examples/token-domain-structure.tsx",
           "exports": [
-            "WorkspaceSummary"
+            "AllocationSubjectExample"
           ],
           "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"
+            "references/domain-structures.md#executable-example"
           ],
           "optionalPeers": []
         },
@@ -1867,35 +2074,50 @@
       "layer": "base",
       "responsibility": "Base family: Cascader.",
       "jobs": [
-        "Hierarchical choice through drill, columns or tree views, with application-owned asynchronous children."
+        "A form field chooses one or several nodes from a nested hierarchy, such as categories, locations or org units, with path search and optional async branches."
       ],
       "tags": [
         "base",
         "cascader"
       ],
-      "aliases": [],
+      "aliases": [
+        "cascading select",
+        "category picker",
+        "hierarchical select",
+        "location picker",
+        "nested picker"
+      ],
       "sections": [
         "Base components"
       ],
       "guidance": [
         {
           "title": "Cascader",
-          "description": "Hierarchical choice through drill, columns or tree views, with application-owned asynchronous children.",
+          "description": "A form field chooses one or several nodes from a nested hierarchy, such as categories, locations or org units, with path search and optional async branches.",
           "chooseWhen": [
-            "Hierarchical choice through drill, columns or tree views, with application-owned asynchronous children."
+            "A form field chooses one or several nodes from a nested hierarchy, such as categories, locations or org units, with path search and optional async branches."
+          ],
+          "avoidWhen": [
+            "The hierarchy filters a collection: give FilterOption children in features/filters.",
+            "The hierarchy is browsed or displayed rather than chosen: use base/tree."
           ],
-          "avoidWhen": [],
           "appOwned": [
             "Application data, persistence and business effects."
           ],
           "jobs": [
-            "Hierarchical choice through drill, columns or tree views, with application-owned asynchronous children."
+            "A form field chooses one or several nodes from a nested hierarchy, such as categories, locations or org units, with path search and optional async branches."
           ],
           "tags": [
             "base",
             "cascader"
           ],
-          "aliases": [],
+          "aliases": [
+            "cascading select",
+            "hierarchical select",
+            "nested picker",
+            "category picker",
+            "location picker"
+          ],
           "section": "Base components",
           "browse": {
             "category": "forms-inputs",
@@ -1904,7 +2126,11 @@
             "collection": ""
           },
           "sections": [],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/combobox",
+            "themelia-react-ui/base/tree",
+            "themelia-react-ui/features/filters"
+          ]
         }
       ],
       "recipes": [
@@ -1946,35 +2172,84 @@
       "layer": "base",
       "responsibility": "Base family: Chart.",
       "jobs": [
-        "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
+        "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding: compose Recharts AreaChart, BarChart, LineChart or PieChart inside ChartContainer with a ChartConfig."
       ],
       "tags": [
         "optional-peer",
         "recharts"
       ],
-      "aliases": [],
+      "aliases": [
+        "area chart",
+        "bar chart",
+        "donut chart",
+        "line chart",
+        "pie chart",
+        "recharts",
+        "time series chart"
+      ],
       "sections": [
         "Base components"
       ],
       "guidance": [
         {
           "title": "Chart",
-          "description": "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding.",
+          "description": "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding: compose Recharts AreaChart, BarChart, LineChart or PieChart inside ChartContainer with a ChartConfig.",
           "chooseWhen": [
-            "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
+            "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding: compose Recharts AreaChart, BarChart, LineChart or PieChart inside ChartContainer with a ChartConfig."
           ],
           "avoidWhen": [
-            "The requirement is a ready-made metric, comparison, heatmap, or analytics recipe."
+            "The requirement is a ready-made metric, comparison, heatmap, or analytics recipe.",
+            "The chart needs a titled card with description and footer; place ChartContainer inside ChartCard."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "Series data, ChartConfig labels and colors from chart tokens",
+            "Recharts chart type, axes and interaction callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "ChartContainer",
+                "roles": [
+                  "chart",
+                  "area-chart",
+                  "bar-chart",
+                  "line-chart",
+                  "donut-chart",
+                  "time-series-chart"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent",
+                "slots": [
+                  "children"
+                ]
+              }
+            ],
+            "owns": [
+              "Theme-token chart colors, sizing and accessible scaffolding",
+              "Tooltip and legend content recipes"
+            ],
+            "parentOwns": [
+              "Recharts primitives, series and axes",
+              "The ChartCard or Card that titles the chart"
+            ]
+          },
           "jobs": [
-            "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
+            "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding: compose Recharts AreaChart, BarChart, LineChart or PieChart inside ChartContainer with a ChartConfig."
           ],
           "tags": [
             "optional-peer",
             "recharts"
           ],
-          "aliases": [],
+          "aliases": [
+            "area chart",
+            "bar chart",
+            "line chart",
+            "donut chart",
+            "pie chart",
+            "time series chart",
+            "recharts"
+          ],
           "section": "Base components",
           "browse": {
             "category": "data-display",
@@ -2529,6 +2804,23 @@
           "optionalPeers": [
             "react-hook-form"
           ]
+        },
+        {
+          "file": "examples/rhf-overlay-form.tsx",
+          "exports": [
+            "RHFDialogForm"
+          ],
+          "symbols": [
+            "Select",
+            "ToggleField"
+          ],
+          "references": [
+            "references/rhf-workflows.md#overlay-create-and-edit",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
         }
       ]
     },
@@ -4005,30 +4297,70 @@
           "optionalPeers": [
             "recharts"
           ]
-        }
-      ]
-    },
-    {
-      "import": "themelia-react-ui/base/forms",
-      "declaration": "dist/components/base/forms/index.d.ts",
-      "symbols": [
-        "ApplyServerErrorsOptions",
-        "ControlledFormField",
-        "ControlledFormFieldProps",
-        "ControlledFormFieldStrings",
-        "DirtyStateBanner",
-        "DirtyStateBannerProps",
-        "ErrorSummary",
-        "ErrorSummaryProps",
-        "FieldChromeProps",
-        "FormActionsBar",
-        "FormActionsBarProps",
-        "FormField",
-        "FormFieldErrorGetter",
-        "FormFieldProps",
-        "FormSection",
-        "FormSectionProps",
-        "OperationPasswordForm",
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "OrderFulfillmentDetail"
+          ],
+          "symbols": [
+            "Alert",
+            "AlertDescription",
+            "AlertTitle"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "VariantInspectionAndEditor"
+          ],
+          "symbols": [
+            "Alert",
+            "AlertDescription"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        }
+      ]
+    },
+    {
+      "import": "themelia-react-ui/base/forms",
+      "declaration": "dist/components/base/forms/index.d.ts",
+      "symbols": [
+        "ApplyServerErrorsOptions",
+        "ControlledFormField",
+        "ControlledFormFieldProps",
+        "ControlledFormFieldStrings",
+        "DirtyStateBanner",
+        "DirtyStateBannerProps",
+        "ErrorSummary",
+        "ErrorSummaryProps",
+        "FieldChromeProps",
+        "FormActionsBar",
+        "FormActionsBarProps",
+        "FormField",
+        "FormFieldErrorGetter",
+        "FormFieldProps",
+        "FormSection",
+        "FormSectionProps",
+        "OperationPasswordForm",
         "OperationPasswordFormProps",
         "ServerErrors",
         "SubmitStateButton",
@@ -4555,6 +4887,25 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/product-media.tsx",
+          "exports": [
+            "LocalProductImages"
+          ],
+          "symbols": [
+            "FormField"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@dnd-kit/core",
+            "@dnd-kit/sortable",
+            "@dnd-kit/utilities",
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
         {
           "file": "examples/rhf-bindings.tsx",
           "exports": [
@@ -4608,6 +4959,23 @@
           "optionalPeers": [
             "react-hook-form"
           ]
+        },
+        {
+          "file": "examples/rhf-overlay-form.tsx",
+          "exports": [
+            "RHFDialogForm"
+          ],
+          "symbols": [
+            "ControlledFormField",
+            "ErrorSummary"
+          ],
+          "references": [
+            "references/rhf-workflows.md#overlay-create-and-edit",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
         }
       ]
     },
@@ -5337,7 +5705,7 @@
       "layer": "base",
       "responsibility": "Base family: Media gallery.",
       "jobs": [
-        "Use Media gallery in an admin interface."
+        "MediaGallery edits a product media gallery of local File[] images before upload: add files, preview, remove, sort by drag or keyboard, and use the first image as cover."
       ],
       "tags": [
         "base",
@@ -5345,19 +5713,31 @@
         "media-gallery",
         "upload"
       ],
-      "aliases": [],
+      "aliases": [
+        "local product images",
+        "product image upload",
+        "product media gallery"
+      ],
       "sections": [
         "Base components"
       ],
       "guidance": [
         {
           "title": "Media gallery",
-          "description": "Multi-image picker with sortable previews and a cover image.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "MediaGallery edits a product media gallery of local File[] images before upload: add files, preview, remove, sort by drag or keyboard, and use the first image as cover.",
+          "chooseWhen": [
+            "MediaGallery edits a product media gallery of local File[] images before upload: add files, preview, remove, sort by drag or keyboard, and use the first image as cover."
+          ],
+          "avoidWhen": [
+            "Existing product images are persisted URL records; use MediaResourceGallery with typed accessors and attachment callbacks.",
+            "One image or a full searchable asset catalogue is needed; inspect ImageUpload or MediaLibrary."
+          ],
+          "appOwned": [
+            "Controlled File[] value, transfer and persistence",
+            "File acceptance, limits and accepted form state"
+          ],
           "jobs": [
-            "Use Media gallery in an admin interface."
+            "MediaGallery edits a product media gallery of local File[] images before upload: add files, preview, remove, sort by drag or keyboard, and use the first image as cover."
           ],
           "tags": [
             "base",
@@ -5365,7 +5745,11 @@
             "upload",
             "media-gallery"
           ],
-          "aliases": [],
+          "aliases": [
+            "product media gallery",
+            "local product images",
+            "product image upload"
+          ],
           "section": "Base components",
           "browse": {
             "category": "forms-inputs",
@@ -5385,10 +5769,33 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/upload",
+            "themelia-react-ui/features/media-library"
+          ]
         }
       ],
-      "recipes": []
+      "recipes": [
+        {
+          "file": "examples/product-media.tsx",
+          "exports": [
+            "LocalProductImages"
+          ],
+          "symbols": [
+            "MediaGallery"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@dnd-kit/core",
+            "@dnd-kit/sortable",
+            "@dnd-kit/utilities",
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        }
+      ]
     },
     {
       "import": "themelia-react-ui/base/metadata-list",
@@ -6771,10 +7178,14 @@
         "SidebarMenuSubButton",
         "SidebarMenuSubButtonProps",
         "SidebarMenuSubItem",
+        "SidebarPanelId",
+        "SidebarPresentation",
         "SidebarProps",
         "SidebarProvider",
         "SidebarProviderProps",
         "SidebarRail",
+        "SidebarRegion",
+        "SidebarRegionProps",
         "SidebarSeparator",
         "SidebarStrings",
         "SidebarTrigger",
@@ -7357,12 +7768,17 @@
         "structure"
       ],
       "aliases": [
+        "app composite",
         "copy gaps",
         "copy-gap",
+        "custom composite component",
+        "custom composition",
+        "domain structure",
         "horizontal row",
         "layout blocks",
         "peer card gaps",
-        "title description spacing"
+        "title description spacing",
+        "token backed tailwind layout"
       ],
       "references": [
         "references/design-contract.md",
@@ -7376,7 +7792,7 @@
           "title": "Structural composition",
           "description": "Compose passive layout blocks with Stack rows, responsive Grid tracks, GridCell spans and available-width AdaptiveGrid.",
           "chooseWhen": [
-            "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
+            "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks. Compose specialized domain tracks with public parts and app-owned token-backed Tailwind; inspect the allocation recipe."
           ],
           "avoidWhen": [
             "The shape has stronger Item, Metadata, FormField, card, table, or mechanical semantics."
@@ -7450,7 +7866,12 @@
           "aliases": [
             "layout blocks",
             "horizontal row",
-            "peer card gaps"
+            "peer card gaps",
+            "custom composition",
+            "custom composite component",
+            "app composite",
+            "domain structure",
+            "token backed tailwind layout"
           ],
           "section": "Foundations",
           "browse": {
@@ -7515,6 +7936,69 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "SoldProductWithSummary"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "CustomServiceInvoice"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "ReceivableInvoiceDetail"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
         {
           "file": "examples/composition.tsx",
           "exports": [
@@ -7542,6 +8026,20 @@
           ],
           "optionalPeers": []
         },
+        {
+          "file": "examples/custom-composition.tsx",
+          "exports": [
+            "AssessmentComparison"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/custom-composition.md#token-backed-placement-and-drawing",
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/destructive-confirm.tsx",
           "exports": [
@@ -7570,6 +8068,20 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/editable-sections.tsx",
+          "exports": [
+            "EditableSections"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/custom-composition.md#disclosure-sections",
+            "references/rhf-workflows.md#screen-and-state-ownership"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/hierarchy-capture.tsx",
           "exports": [
@@ -7630,6 +8142,22 @@
           ],
           "optionalPeers": []
         },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "VariantInspectionAndEditor"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
         {
           "file": "examples/receipt.tsx",
           "exports": [
@@ -7691,6 +8219,22 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/rhf-overlay-form.tsx",
+          "exports": [
+            "RHFDialogForm"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/rhf-workflows.md#overlay-create-and-edit",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
+        },
         {
           "file": "examples/scoped-directory.tsx",
           "exports": [
@@ -7709,6 +8253,32 @@
             "react-day-picker"
           ]
         },
+        {
+          "file": "examples/token-domain-structure.tsx",
+          "exports": [
+            "AllocationByLocation"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/token-domain-structure.tsx",
+          "exports": [
+            "AllocationSubjectExample"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/website.tsx",
           "exports": [
@@ -8150,6 +8720,22 @@
           "optionalPeers": [
             "react-hook-form"
           ]
+        },
+        {
+          "file": "examples/rhf-overlay-form.tsx",
+          "exports": [
+            "RHFDialogForm"
+          ],
+          "symbols": [
+            "Input"
+          ],
+          "references": [
+            "references/rhf-workflows.md#overlay-create-and-edit",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
         }
       ]
     },
@@ -8158,7 +8744,8 @@
       "declaration": "dist/components/base/toaster/index.d.ts",
       "symbols": [
         "Toaster",
-        "ToasterProps"
+        "ToasterProps",
+        "toast"
       ],
       "optionalPeers": [
         "sonner"
@@ -10433,15 +11020,15 @@
       "responsibility": "Blocks family: Activity heatmap; Analytics bar; Analytics overview; Chart card; Comparison; Gradient cards; Metric parts; Micro chart grid; Stat cards; Time distribution.",
       "jobs": [
         "A custom chart needs shared title, description, action and footer regions.",
+        "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend.",
         "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.",
+        "MetricComparison presents one metric for the current and previous period with the signed change.",
         "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 Comparison in an admin interface.",
+        "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary.",
+        "TimeDistributionRuler presents counts across the hours of a day with the current hour marked.",
         "Use Gradient cards in an admin interface.",
-        "Use Metric parts in an admin interface.",
-        "Use Micro chart grid in an admin interface.",
-        "Use Time distribution in an admin interface."
+        "Use Metric parts in an admin interface."
       ],
       "tags": [
         "analytics",
@@ -10461,22 +11048,33 @@
       "aliases": [
         "KPI grid",
         "KPI strip",
+        "activity heatmap",
+        "contribution calendar",
+        "current vs previous",
+        "daily activity",
         "dashboard KPIs",
         "dashboard metrics",
+        "hourly distribution",
         "kpi",
         "kpi card",
         "metric card",
+        "metric comparison",
         "metric grid",
+        "micro charts",
+        "mini chart grid",
         "number card",
+        "period comparison",
         "revenue card",
         "revenue overview",
         "single KPI",
         "single metric",
+        "sparkline grid",
         "stat",
         "stat cards",
         "statistic cards",
         "statistics",
-        "statistics cards"
+        "statistics cards",
+        "time of day distribution"
       ],
       "sections": [
         "Blocks"
@@ -10706,26 +11304,57 @@
         },
         {
           "title": "Comparison",
-          "description": "`MetricComparison` — side-by-side current vs previous with a signed delta badge. Reuses the unified `MetricData` shape so currency/percent formatting carries through.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
-          "jobs": [
-            "Use Comparison in an admin interface."
+          "description": "MetricComparison presents one metric for the current and previous period with the signed change.",
+          "chooseWhen": [
+            "MetricComparison presents one metric for the current and previous period with the signed change."
           ],
-          "tags": [
-            "blocks",
-            "analytics",
-            "comparison"
+          "avoidWhen": [
+            "Several peer KPIs; use MetricGrid or MetricBar."
           ],
-          "aliases": [],
-          "section": "Blocks",
-          "browse": {
-            "category": "domain-ui",
-            "group": "Analytics",
-            "domain": "",
-            "collection": ""
-          },
+          "appOwned": [
+            "Both MetricData values and the comparison baseline"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "MetricComparison",
+                "roles": [
+                  "metric-comparison",
+                  "period-comparison"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Current, previous and delta anatomy"
+            ],
+            "parentOwns": [
+              "Metric meaning and period baseline",
+              "Subject surface and placement"
+            ]
+          },
+          "jobs": [
+            "MetricComparison presents one metric for the current and previous period with the signed change."
+          ],
+          "tags": [
+            "blocks",
+            "analytics",
+            "comparison"
+          ],
+          "aliases": [
+            "period comparison",
+            "current vs previous",
+            "metric comparison"
+          ],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Analytics",
+            "domain": "",
+            "collection": ""
+          },
           "sections": [
             {
               "title": "Overview",
@@ -10742,7 +11371,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics"
+          ]
         },
         {
           "title": "Gradient cards",
@@ -10786,19 +11417,50 @@
         },
         {
           "title": "Activity heatmap",
-          "description": "`ActivityHeatmap` — GitHub-style daily-activity calendar with success-tinted intensity cells.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend.",
+          "chooseWhen": [
+            "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend."
+          ],
+          "avoidWhen": [
+            "Values are a time series to compare; use ChartCard with ChartContainer."
+          ],
+          "appOwned": [
+            "Daily counts and the covered range"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "ActivityHeatmap",
+                "roles": [
+                  "activity-heatmap",
+                  "daily-activity"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Calendar grid, month labels and legend"
+            ],
+            "parentOwns": [
+              "Activity data",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Activity heatmap in an admin interface."
+            "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend."
           ],
           "tags": [
             "blocks",
             "analytics",
             "heatmap"
           ],
-          "aliases": [],
+          "aliases": [
+            "activity heatmap",
+            "contribution calendar",
+            "daily activity"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -10822,7 +11484,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics"
+          ]
         },
         {
           "title": "Metric parts",
@@ -10876,19 +11540,50 @@
         },
         {
           "title": "Micro chart grid",
-          "description": "`MetricMicroGrid` — six-cell dense overview pairing each KPI with a different lightweight visualization (bars / line / dots / progress / area / pie).",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary.",
+          "chooseWhen": [
+            "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary."
+          ],
+          "avoidWhen": [
+            "Each KPI needs its own trend, comparison or loading state; use MetricGrid."
+          ],
+          "appOwned": [
+            "Cell values and series"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "MetricMicroGrid",
+                "roles": [
+                  "sparkline-grid",
+                  "micro-chart-grid"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Cell grid and lightweight visuals"
+            ],
+            "parentOwns": [
+              "Cell data",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Micro chart grid in an admin interface."
+            "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary."
           ],
           "tags": [
             "blocks",
             "analytics",
             "micro-grid"
           ],
-          "aliases": [],
+          "aliases": [
+            "sparkline grid",
+            "micro charts",
+            "mini chart grid"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -10912,7 +11607,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics"
+          ]
         },
         {
           "title": "Stat cards",
@@ -11003,19 +11700,48 @@
         },
         {
           "title": "Time distribution",
-          "description": "A compact 24-hour density visualization with localized labels and an optional current-time marker.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "TimeDistributionRuler presents counts across the hours of a day with the current hour marked.",
+          "chooseWhen": [
+            "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
+          ],
+          "avoidWhen": [
+            "Days or months need comparison; use ActivityHeatmap or ChartCard."
+          ],
+          "appOwned": [
+            "Hourly counts and the current hour"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "TimeDistributionRuler",
+                "roles": [
+                  "hourly-distribution"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Hour ruler and density ramp"
+            ],
+            "parentOwns": [
+              "Hourly data",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Time distribution in an admin interface."
+            "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
           ],
           "tags": [
             "blocks",
             "analytics",
             "time-ruler"
           ],
-          "aliases": [],
+          "aliases": [
+            "hourly distribution",
+            "time of day distribution"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -11039,7 +11765,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics"
+          ]
         }
       ],
       "recipes": [
@@ -11382,14 +12110,19 @@
         "InventorySectionStrings",
         "InventorySectionValue",
         "InventoryStatus",
+        "InvoiceColumn",
         "InvoiceHeader",
         "InvoiceHeaderProps",
+        "InvoiceHeaderStrings",
         "InvoiceLineItem",
         "InvoiceLineItems",
+        "InvoiceLineItemsFooterRow",
         "InvoiceLineItemsProps",
+        "InvoiceLineItemsStrings",
         "InvoiceMini",
         "InvoiceMiniData",
         "InvoiceMiniProps",
+        "InvoiceMiniStrings",
         "InvoiceParty",
         "InvoiceStatus",
         "LoyaltyHistoryEntry",
@@ -11494,6 +12227,9 @@
         "defaultFulfillmentGroupStrings",
         "defaultInventoryLevelStrings",
         "defaultInventorySectionStrings",
+        "defaultInvoiceHeaderStrings",
+        "defaultInvoiceLineItemsStrings",
+        "defaultInvoiceMiniStrings",
         "defaultLoyaltyPointsStrings",
         "defaultOrderCustomerStrings",
         "defaultOrderHeaderStrings",
@@ -11509,8 +12245,12 @@
         "defaultTaxBreakdownStrings",
         "defaultVendorProfileStrings",
         "defaultVoucherEntryStrings",
+        "fulfillmentStatusTone",
         "getSeoPermalinkPath",
-        "getSeoPermalinkSlug"
+        "getSeoPermalinkSlug",
+        "invoiceStatusTone",
+        "paymentStatusTone",
+        "transactionStatusTone"
       ],
       "optionalPeers": [
         "react-day-picker",
@@ -11521,34 +12261,35 @@
       "responsibility": "Blocks family: Address card; Booking event details; Cart summary; Commerce overview; Coupon input; Discount stack; Fulfillment group; Giftcard; Inventory level; Inventory section; Invoice header; Invoice line items; Invoice mini; Loyalty points; Order customer; Order header; Order line item; Order status; Order summary; Order timeline; Order transactions; Payment method; Payment timeline; Refund status; SEO listing; Shipment tracking; Subscription summary; Summary panel; Tax breakdown; Upcoming booking; Vendor profile; Voucher entry.",
       "jobs": [
         "A screen renders a recognisable commerce subject — order, invoice, cart, shipment, giftcard, booking, vendor — as read-mostly display.",
-        "Build a money ledger with the same rows, deductions and totals as the commerce blocks.",
-        "List an order's goods grouped by fulfillment state, with the commands that move them on.",
-        "List every payment attempt on an order, including failures, with its kind, status and reference.",
+        "AddressCard presents one saved postal address with its kind, default marker and edit/remove/make-default callbacks.",
+        "AmountRow presents one already-formatted amount with an optional note, deduction, total emphasis and rollup rule.",
+        "CartSummaryCard presents cart lines, subtotal, discount, shipping, tax and total with an optional checkout callback.",
+        "DiscountStackPreview lists the discounts applied to an order in stacking order, each a deduction, with the total saved.",
+        "FulfillmentGroup presents one shipment worth of order goods that share a fulfillment status and ship-from location, as OrderLineItem rows with the commands that move them on.",
+        "InventoryLevel presents one product stock snapshot: units in stock against capacity, reorder level and a critical/low/in-stock status.",
+        "InventorySectionCard edits one SKU inventory record: identity, tracked quantities, policy, location, shipping, customs and tags through a controlled value.",
+        "InvoiceHeader opens an invoice document: title and status, invoice number, bill-from and bill-to parties, issue and due dates and the amount due.",
+        "InvoiceLineItems presents invoice descriptions, quantities, unit prices and line totals with a financial footer; typed columns and footerRows support a different invoice shape.",
+        "InvoiceMini summarises one invoice in a list or dashboard: number, status, customer, item count, due date and total.",
         "One order needs goods, total and payment ledgers with status and an optional balance note.",
-        "Open an order page with its reference, payment and fulfillment status, and commands.",
-        "Show one ordered product with its variant, SKU, properties, unit price and passed line total.",
-        "Show who placed an order, how to reach them, and where it ships and is billed.",
-        "Use Address card in an admin interface.",
+        "OrderCustomer presents the buyer of one order: name, contact, order count and shipping/billing addresses with edit callbacks.",
+        "OrderHeader is an order route title row: the order number as the heading, separate payment and fulfillment status chips, placement facts and one actions menu.",
+        "OrderLineItem presents purchased order items: one sold product with selected options, variant, SKU, quantity, unit price and passed line total in an order, refund or packing slip.",
+        "OrderStatusCard presents one order status with its ETA and event list for a customer-facing order view.",
+        "OrderTransactions lists every payment attempt of an order (authorizations, captures, refunds, failures) with amount, status and reference.",
+        "PaymentMethod presents one saved payment instrument as a card face or a compact row, with default marker and change callback.",
+        "RefundStatusCard presents one refund moving through requested, approved, processing and completed stages with amount, method, reason and ETA.",
+        "ShipmentTracking presents one parcel: carrier, tracking number, delivery status and its checkpoint rail.",
+        "SummaryPanel groups financial AmountRow entries such as subtotal, shipping, tax and a grand total inside an app-owned surface.",
+        "TaxBreakdownCard presents a subtotal, each tax line and the taxed total as one ledger.",
         "Use Booking event details in an admin interface.",
-        "Use Cart summary in an admin interface.",
         "Use Coupon input in an admin interface.",
-        "Use Discount stack in an admin interface.",
         "Use Giftcard in an admin interface.",
-        "Use Inventory level in an admin interface.",
-        "Use Inventory section in an admin interface.",
-        "Use Invoice header in an admin interface.",
-        "Use Invoice line items in an admin interface.",
-        "Use Invoice mini in an admin interface.",
         "Use Loyalty points in an admin interface.",
-        "Use Order status in an admin interface.",
         "Use Order timeline in an admin interface.",
-        "Use Payment method in an admin interface.",
         "Use Payment timeline in an admin interface.",
-        "Use Refund status in an admin interface.",
         "Use SEO listing in an admin interface.",
-        "Use Shipment tracking in an admin interface.",
         "Use Subscription summary in an admin interface.",
-        "Use Tax breakdown in an admin interface.",
         "Use Upcoming booking in an admin interface.",
         "Use Vendor profile in an admin interface.",
         "Use Voucher entry in an admin interface."
@@ -11592,6 +12333,10 @@
         "voucher-entry"
       ],
       "aliases": [
+        "applied discounts",
+        "basket summary",
+        "billing address",
+        "billing parties",
         "blocks/commerce-address-card",
         "blocks/commerce-booking-event",
         "blocks/commerce-cart-summary",
@@ -11617,7 +12362,68 @@
         "blocks/commerce-vendor-profile",
         "blocks/commerce-voucher-entry",
         "blocks/commerce/amount-row",
-        "blocks/commerce/invoice-table"
+        "blocks/commerce/invoice-table",
+        "buyer details",
+        "captures and refunds",
+        "card on file",
+        "carrier tracking",
+        "cart summary",
+        "checkout summary",
+        "credit status",
+        "customer contact",
+        "customer details",
+        "delivery address",
+        "delivery eta",
+        "delivery tracking",
+        "discount codes",
+        "discount stack",
+        "fulfilled items",
+        "fulfillment",
+        "inventory editor",
+        "inventory form",
+        "inventory level",
+        "invoice card",
+        "invoice header",
+        "invoice metadata",
+        "invoice parties",
+        "invoice preview",
+        "invoice tile",
+        "order customer",
+        "order items",
+        "order line items",
+        "order number header",
+        "order page header",
+        "order progress",
+        "order status",
+        "order title row",
+        "order transactions",
+        "parcel status",
+        "payment ledger",
+        "payment method",
+        "payment transactions",
+        "pick list",
+        "postal address",
+        "promotions summary",
+        "refund progress",
+        "refund status",
+        "reorder level",
+        "return refund",
+        "saved card",
+        "shipment group",
+        "shipment tracking",
+        "shipping address",
+        "sku inventory",
+        "stock level",
+        "stock meter",
+        "stock settings",
+        "tax breakdown",
+        "tax lines",
+        "tax summary",
+        "tracking number",
+        "transaction history",
+        "unfulfilled items",
+        "vat summary",
+        "warehouse fulfillment"
       ],
       "sections": [
         "Blocks",
@@ -11667,12 +12473,44 @@
         },
         {
           "title": "Address card",
-          "description": "Shipping and billing address cards with edit, remove, default, and make-default callbacks.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "AddressCard presents one saved postal address with its kind, default marker and edit/remove/make-default callbacks.",
+          "chooseWhen": [
+            "AddressCard presents one saved postal address with its kind, default marker and edit/remove/make-default callbacks."
+          ],
+          "avoidWhen": [
+            "The buyer, contact and both addresses belong together; use OrderCustomer."
+          ],
+          "appOwned": [
+            "Address values, default choice and validation",
+            "Edit, remove and make-default callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "AddressCard",
+                "roles": [
+                  "address",
+                  "shipping-address",
+                  "billing-address",
+                  "delivery-address"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Address lines, kind title and default marker",
+              "Address command placement"
+            ],
+            "parentOwns": [
+              "Address data and mutation callbacks",
+              "Subject surface and placement"
+            ],
+            "embedded": "Unframed by default; pass surface=\"card\" for a standalone address card."
+          },
           "jobs": [
-            "Use Address card in an admin interface."
+            "AddressCard presents one saved postal address with its kind, default marker and edit/remove/make-default callbacks."
           ],
           "tags": [
             "blocks",
@@ -11680,7 +12518,11 @@
             "address-card"
           ],
           "aliases": [
-            "blocks/commerce-address-card"
+            "blocks/commerce-address-card",
+            "shipping address",
+            "billing address",
+            "delivery address",
+            "postal address"
           ],
           "section": "Blocks",
           "browse": {
@@ -11705,7 +12547,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Booking event details",
@@ -11755,12 +12600,40 @@
         },
         {
           "title": "Cart summary",
-          "description": "Checkout summary card with line items, thumbnails, totals, discounts, tax, and checkout callback.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "CartSummaryCard presents cart lines, subtotal, discount, shipping, tax and total with an optional checkout callback.",
+          "chooseWhen": [
+            "CartSummaryCard presents cart lines, subtotal, discount, shipping, tax and total with an optional checkout callback."
+          ],
+          "avoidWhen": [
+            "A placed order; use OrderLineItem rows with OrderSummary."
+          ],
+          "appOwned": [
+            "Cart lines, amounts and checkout callback"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "CartSummaryCard",
+                "roles": [
+                  "cart-summary",
+                  "checkout-summary"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Cart line list and amount ledger",
+              "Checkout command"
+            ],
+            "parentOwns": [
+              "Cart data and checkout flow",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Cart summary in an admin interface."
+            "CartSummaryCard presents cart lines, subtotal, discount, shipping, tax and total with an optional checkout callback."
           ],
           "tags": [
             "blocks",
@@ -11768,7 +12641,10 @@
             "cart-summary"
           ],
           "aliases": [
-            "blocks/commerce-cart-summary"
+            "blocks/commerce-cart-summary",
+            "cart summary",
+            "checkout summary",
+            "basket summary"
           ],
           "section": "Blocks",
           "browse": {
@@ -11793,7 +12669,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Coupon input",
@@ -11839,12 +12717,41 @@
         },
         {
           "title": "Discount stack",
-          "description": "Discount stack preview for coupons, loyalty savings, promotions, and total savings.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "DiscountStackPreview lists the discounts applied to an order in stacking order, each a deduction, with the total saved.",
+          "chooseWhen": [
+            "DiscountStackPreview lists the discounts applied to an order in stacking order, each a deduction, with the total saved."
+          ],
+          "avoidWhen": [
+            "Discounts are one row of a wider order breakdown; add a deduction AmountRow to SummaryPanel."
+          ],
+          "appOwned": [
+            "Discount eligibility, order and amounts"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "DiscountStackPreview",
+                "roles": [
+                  "discount-stack",
+                  "applied-discounts"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Deduction rows, kind notes and total savings",
+              "Stack title"
+            ],
+            "parentOwns": [
+              "Authoritative discount amounts",
+              "Subject surface and placement"
+            ],
+            "embedded": "Unframed by default; pass surface=\"card\" for a separate card."
+          },
           "jobs": [
-            "Use Discount stack in an admin interface."
+            "DiscountStackPreview lists the discounts applied to an order in stacking order, each a deduction, with the total saved."
           ],
           "tags": [
             "blocks",
@@ -11852,7 +12759,11 @@
             "discount-stack"
           ],
           "aliases": [
-            "blocks/commerce-discount-stack"
+            "blocks/commerce-discount-stack",
+            "discount stack",
+            "applied discounts",
+            "promotions summary",
+            "discount codes"
           ],
           "section": "Blocks",
           "browse": {
@@ -11877,7 +12788,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Giftcard",
@@ -11923,12 +12836,41 @@
         },
         {
           "title": "Inventory level",
-          "description": "A stateless stock snapshot for one product or variant. Product editor and mutation state remain in the Products feature.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "InventoryLevel presents one product stock snapshot: units in stock against capacity, reorder level and a critical/low/in-stock status.",
+          "chooseWhen": [
+            "InventoryLevel presents one product stock snapshot: units in stock against capacity, reorder level and a critical/low/in-stock status."
+          ],
+          "avoidWhen": [
+            "Stock values are edited; use InventorySectionCard.",
+            "Many products need comparison; use DataTable with a stock column."
+          ],
+          "appOwned": [
+            "Stock counts, capacity and reorder thresholds"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "InventoryLevel",
+                "roles": [
+                  "inventory-level",
+                  "stock-level",
+                  "stock-health"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Stock meter, status and restock facts"
+            ],
+            "parentOwns": [
+              "Stock data",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Inventory level in an admin interface."
+            "InventoryLevel presents one product stock snapshot: units in stock against capacity, reorder level and a critical/low/in-stock status."
           ],
           "tags": [
             "blocks",
@@ -11936,7 +12878,11 @@
             "inventory-level"
           ],
           "aliases": [
-            "blocks/commerce-inventory-level"
+            "blocks/commerce-inventory-level",
+            "inventory level",
+            "stock level",
+            "stock meter",
+            "reorder level"
           ],
           "section": "Blocks",
           "browse": {
@@ -11961,24 +12907,63 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce",
+            "themelia-react-ui/features/table"
+          ]
         },
         {
           "title": "Inventory section",
-          "description": "Controlled inventory form card for product and variant stock, identifiers, sell-through policy, fulfillment location, shipping weight, customs data, and operational tags.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
-          "jobs": [
-            "Use Inventory section in an admin interface."
+          "description": "InventorySectionCard edits one SKU inventory record: identity, tracked quantities, policy, location, shipping, customs and tags through a controlled value.",
+          "chooseWhen": [
+            "InventorySectionCard edits one SKU inventory record: identity, tracked quantities, policy, location, shipping, customs and tags through a controlled value."
           ],
-          "tags": [
-            "blocks",
-            "commerce",
-            "inventory-section"
+          "avoidWhen": [
+            "A read-only stock snapshot with a reorder threshold; use InventoryLevel.",
+            "Several warehouses need comparable editable balances; compose an app-owned structure from public form owners."
           ],
-          "aliases": [
-            "blocks/commerce-inventory-section"
+          "appOwned": [
+            "Controlled inventory value, validation errors and submission",
+            "Location and country options, SKU generation and restock callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "InventorySectionCard",
+                "roles": [
+                  "inventory-section",
+                  "inventory-editor",
+                  "stock-settings"
+                ],
+                "kind": "workflow",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Inventory field sections and status badge",
+              "Section and field visibility"
+            ],
+            "parentOwns": [
+              "Controlled value, errors and persistence",
+              "Subject surface and form submission"
+            ],
+            "embedded": "Unframed by default inside a form surface; pass surface=\"card\" for its own card."
+          },
+          "jobs": [
+            "InventorySectionCard edits one SKU inventory record: identity, tracked quantities, policy, location, shipping, customs and tags through a controlled value."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "inventory-section"
+          ],
+          "aliases": [
+            "blocks/commerce-inventory-section",
+            "inventory editor",
+            "stock settings",
+            "sku inventory",
+            "inventory form"
           ],
           "section": "Features",
           "browse": {
@@ -12003,16 +12988,50 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce",
+            "themelia-react-ui/features/products"
+          ]
         },
         {
           "title": "Invoice header",
-          "description": "Top of an invoice — number, status, parties, amount.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "InvoiceHeader opens an invoice document: title and status, invoice number, bill-from and bill-to parties, issue and due dates and the amount due.",
+          "chooseWhen": [
+            "InvoiceHeader opens an invoice document: title and status, invoice number, bill-from and bill-to parties, issue and due dates and the amount due."
+          ],
+          "avoidWhen": [
+            "A compact invoice tile in a list or dashboard; use InvoiceMini.",
+            "The route title belongs to Page; keep InvoiceHeader as the document subject inside it."
+          ],
+          "appOwned": [
+            "Invoice number, status, parties, dates and amount due"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "InvoiceHeader",
+                "roles": [
+                  "invoice-header",
+                  "invoice-parties",
+                  "billing-parties"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Invoice title, status and number",
+              "Party, date and amount-due anatomy"
+            ],
+            "parentOwns": [
+              "Invoice data and status",
+              "Document surface shared with the line items"
+            ],
+            "embedded": "Unframed by default: place it above InvoiceLineItems surface=\"flat\" in one document Card; pass surface=\"card\" only for a standalone header."
+          },
           "jobs": [
-            "Use Invoice header in an admin interface."
+            "InvoiceHeader opens an invoice document: title and status, invoice number, bill-from and bill-to parties, issue and due dates and the amount due."
           ],
           "tags": [
             "blocks",
@@ -12020,7 +13039,11 @@
             "invoice-header"
           ],
           "aliases": [
-            "blocks/commerce-invoice-header"
+            "blocks/commerce-invoice-header",
+            "invoice header",
+            "invoice parties",
+            "billing parties",
+            "invoice metadata"
           ],
           "section": "Blocks",
           "browse": {
@@ -12045,38 +13068,51 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Invoice line items",
-          "description": "Line items with qty / price / total.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "InvoiceLineItems presents invoice descriptions, quantities, unit prices and line totals with a financial footer; typed columns and footerRows support a different invoice shape.",
+          "chooseWhen": [
+            "InvoiceLineItems presents invoice descriptions, quantities, unit prices and line totals with a financial footer; typed columns and footerRows support a different invoice shape."
+          ],
+          "avoidWhen": [
+            "A purchased product needs its selected options, variant or SKU beside the goods; consider OrderLineItem with SummaryPanel for the financial breakdown.",
+            "Only subtotal, tax and grand-total amounts are needed; use SummaryPanel and AmountRow. Interactive sorting, selection and row actions belong to DataTable."
+          ],
+          "appOwned": [
+            "Authoritative invoice line values, tax policy and custom footer amounts",
+            "Custom cell and React-node footer typography"
+          ],
           "composition": {
             "mappings": [
               {
                 "symbol": "InvoiceLineItems",
                 "roles": [
-                  "invoice-lines"
+                  "invoice-lines",
+                  "invoice-line-items",
+                  "invoice-table",
+                  "billing-lines"
                 ],
                 "kind": "content",
                 "placement": "region",
-                "surface": "self"
+                "surface": "variant"
               }
             ],
             "owns": [
               "Invoice columns, rows and financial footer anatomy",
-              "Rounded table surface and internal row insets"
+              "Its framed table surface, or flush flat rows inside a parent Card"
             ],
             "parentOwns": [
               "Authoritative line items, totals and currency",
               "Subject title and placement"
             ],
-            "embedded": "The line-item table already paints its own surface; do not infer a second Card from the word table."
+            "embedded": "The default surface=\"card\" paints its own frame; do not wrap it in a second Card. Inside an invoice document Card, pass surface=\"flat\" so rows sit flush with the card edge."
           },
           "jobs": [
-            "Use Invoice line items in an admin interface."
+            "InvoiceLineItems presents invoice descriptions, quantities, unit prices and line totals with a financial footer; typed columns and footerRows support a different invoice shape."
           ],
           "tags": [
             "blocks",
@@ -12110,16 +13146,47 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce",
+            "themelia-react-ui/features/table"
+          ]
         },
         {
           "title": "Invoice mini",
-          "description": "Compact invoice tile — paid / pending / overdue.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "InvoiceMini summarises one invoice in a list or dashboard: number, status, customer, item count, due date and total.",
+          "chooseWhen": [
+            "InvoiceMini summarises one invoice in a list or dashboard: number, status, customer, item count, due date and total."
+          ],
+          "avoidWhen": [
+            "The route presents the invoice document; use InvoiceHeader with InvoiceLineItems.",
+            "Many invoices need sorting, selection or paging; use DataTable."
+          ],
+          "appOwned": [
+            "Invoice summary data and navigation"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "InvoiceMini",
+                "roles": [
+                  "invoice-card",
+                  "invoice-preview"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Invoice tile anatomy and status chip"
+            ],
+            "parentOwns": [
+              "Invoice data, link and selection",
+              "The card or list surface that frames each tile"
+            ]
+          },
           "jobs": [
-            "Use Invoice mini in an admin interface."
+            "InvoiceMini summarises one invoice in a list or dashboard: number, status, customer, item count, due date and total."
           ],
           "tags": [
             "blocks",
@@ -12127,7 +13194,10 @@
             "invoice-mini"
           ],
           "aliases": [
-            "blocks/commerce-invoice-mini"
+            "blocks/commerce-invoice-mini",
+            "invoice card",
+            "invoice preview",
+            "invoice tile"
           ],
           "section": "Blocks",
           "browse": {
@@ -12152,7 +13222,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce",
+            "themelia-react-ui/features/table"
+          ]
         },
         {
           "title": "Loyalty points",
@@ -12198,12 +13271,39 @@
         },
         {
           "title": "Order status",
-          "description": "Order status card with current stage, ETA, and timeline events.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "OrderStatusCard presents one order status with its ETA and event list for a customer-facing order view.",
+          "chooseWhen": [
+            "OrderStatusCard presents one order status with its ETA and event list for a customer-facing order view."
+          ],
+          "avoidWhen": [
+            "An operator order page needs separate payment and fulfillment axes; use OrderHeader with FulfillmentGroup and OrderTimeline."
+          ],
+          "appOwned": [
+            "Order status, ETA and events"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "OrderStatusCard",
+                "roles": [
+                  "order-status-progress",
+                  "order-progress"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent"
+              }
+            ],
+            "owns": [
+              "Status, ETA and event anatomy"
+            ],
+            "parentOwns": [
+              "Order status data",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Order status in an admin interface."
+            "OrderStatusCard presents one order status with its ETA and event list for a customer-facing order view."
           ],
           "tags": [
             "blocks",
@@ -12211,7 +13311,10 @@
             "order-status"
           ],
           "aliases": [
-            "blocks/commerce-order-status"
+            "blocks/commerce-order-status",
+            "order status",
+            "order progress",
+            "delivery eta"
           ],
           "section": "Blocks",
           "browse": {
@@ -12236,7 +13339,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Order timeline",
@@ -12303,12 +13408,41 @@
         },
         {
           "title": "Payment method",
-          "description": "One stored payment method drawn as a card face — brand, last four, expiry, default state, and a change callback.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "PaymentMethod presents one saved payment instrument as a card face or a compact row, with default marker and change callback.",
+          "chooseWhen": [
+            "PaymentMethod presents one saved payment instrument as a card face or a compact row, with default marker and change callback."
+          ],
+          "avoidWhen": [
+            "Payment attempts or captures; use OrderTransactions."
+          ],
+          "appOwned": [
+            "Instrument brand, masked number and expiry",
+            "Change and default callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "PaymentMethod",
+                "roles": [
+                  "payment-method",
+                  "saved-card"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Card face or row anatomy",
+              "Default marker and change command"
+            ],
+            "parentOwns": [
+              "Instrument data and callbacks",
+              "Subject surface and placement"
+            ]
+          },
           "jobs": [
-            "Use Payment method in an admin interface."
+            "PaymentMethod presents one saved payment instrument as a card face or a compact row, with default marker and change callback."
           ],
           "tags": [
             "blocks",
@@ -12316,7 +13450,10 @@
             "payment-method"
           ],
           "aliases": [
-            "blocks/commerce-payment-method"
+            "blocks/commerce-payment-method",
+            "payment method",
+            "saved card",
+            "card on file"
           ],
           "section": "Blocks",
           "browse": {
@@ -12341,7 +13478,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Payment timeline",
@@ -12408,12 +13547,46 @@
         },
         {
           "title": "Refund status",
-          "description": "Refund status card with amount, reason, payment method, ETA, and requested timestamp.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "RefundStatusCard presents one refund moving through requested, approved, processing and completed stages with amount, method, reason and ETA.",
+          "chooseWhen": [
+            "RefundStatusCard presents one refund moving through requested, approved, processing and completed stages with amount, method, reason and ETA."
+          ],
+          "avoidWhen": [
+            "Several refunds or captures need a ledger; use OrderTransactions."
+          ],
+          "appOwned": [
+            "Refund stage, amount, method and reason",
+            "Refund decisions and resulting state"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "RefundStatusCard",
+                "roles": [
+                  "refund-status",
+                  "refund-progress"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant",
+                "slots": [
+                  "method",
+                  "reason"
+                ]
+              }
+            ],
+            "owns": [
+              "Refund stage progress and amount anatomy",
+              "Method, reason and ETA facts"
+            ],
+            "parentOwns": [
+              "Refund data and decisions",
+              "Subject surface and placement"
+            ],
+            "embedded": "Unframed by default; pass surface=\"card\" for a standalone card."
+          },
           "jobs": [
-            "Use Refund status in an admin interface."
+            "RefundStatusCard presents one refund moving through requested, approved, processing and completed stages with amount, method, reason and ETA."
           ],
           "tags": [
             "blocks",
@@ -12421,7 +13594,11 @@
             "refund-status"
           ],
           "aliases": [
-            "blocks/commerce-refund-status"
+            "blocks/commerce-refund-status",
+            "refund status",
+            "refund progress",
+            "return refund",
+            "credit status"
           ],
           "section": "Blocks",
           "browse": {
@@ -12446,7 +13623,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "SEO listing",
@@ -12492,12 +13671,44 @@
         },
         {
           "title": "Shipment tracking",
-          "description": "Tracking number, carrier, a status-toned checkpoint rail, and delivery details.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "ShipmentTracking presents one parcel: carrier, tracking number, delivery status and its checkpoint rail.",
+          "chooseWhen": [
+            "ShipmentTracking presents one parcel: carrier, tracking number, delivery status and its checkpoint rail."
+          ],
+          "avoidWhen": [
+            "The history mixes order or payment events; use OrderTimeline or PaymentTimeline.",
+            "Goods awaiting fulfillment need commands; use FulfillmentGroup."
+          ],
+          "appOwned": [
+            "Carrier data, checkpoints and formatted timestamps",
+            "Tracking links and refresh requests"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "ShipmentTracking",
+                "roles": [
+                  "shipment-tracking",
+                  "carrier-tracking",
+                  "delivery-progress"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Carrier, tracking number and status anatomy",
+              "Checkpoint rail presentation"
+            ],
+            "parentOwns": [
+              "Carrier data and accepted checkpoints",
+              "Subject surface and placement"
+            ],
+            "embedded": "Unframed by default inside a padded subject; pass surface=\"card\" for a standalone card in an aside."
+          },
           "jobs": [
-            "Use Shipment tracking in an admin interface."
+            "ShipmentTracking presents one parcel: carrier, tracking number, delivery status and its checkpoint rail."
           ],
           "tags": [
             "blocks",
@@ -12505,7 +13716,12 @@
             "shipment-tracking"
           ],
           "aliases": [
-            "blocks/commerce-shipment-tracking"
+            "blocks/commerce-shipment-tracking",
+            "shipment tracking",
+            "carrier tracking",
+            "delivery tracking",
+            "tracking number",
+            "parcel status"
           ],
           "section": "Blocks",
           "browse": {
@@ -12530,7 +13746,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Subscription summary",
@@ -12576,12 +13794,42 @@
         },
         {
           "title": "Tax breakdown",
-          "description": "Tax breakdown card for item subtotals, rate lines, total tax, and final totals.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "TaxBreakdownCard presents a subtotal, each tax line and the taxed total as one ledger.",
+          "chooseWhen": [
+            "TaxBreakdownCard presents a subtotal, each tax line and the taxed total as one ledger."
+          ],
+          "avoidWhen": [
+            "Shipping, discounts or payments share the same breakdown; compose SummaryPanel with AmountRow."
+          ],
+          "appOwned": [
+            "Tax policy, rates and formatted amounts"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "TaxBreakdownCard",
+                "roles": [
+                  "tax-breakdown",
+                  "vat-summary",
+                  "tax-summary"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Tax line ledger and total rule",
+              "Breakdown title"
+            ],
+            "parentOwns": [
+              "Authoritative tax amounts",
+              "Subject surface and placement"
+            ],
+            "embedded": "Unframed by default beneath invoice lines in the same Card; pass surface=\"card\" for a separate card."
+          },
           "jobs": [
-            "Use Tax breakdown in an admin interface."
+            "TaxBreakdownCard presents a subtotal, each tax line and the taxed total as one ledger."
           ],
           "tags": [
             "blocks",
@@ -12589,7 +13837,11 @@
             "tax-breakdown"
           ],
           "aliases": [
-            "blocks/commerce-tax-breakdown"
+            "blocks/commerce-tax-breakdown",
+            "tax breakdown",
+            "vat summary",
+            "tax summary",
+            "tax lines"
           ],
           "section": "Blocks",
           "browse": {
@@ -12614,7 +13866,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Upcoming booking",
@@ -12748,12 +14002,62 @@
         },
         {
           "title": "Summary panel",
-          "description": "The money ledger commerce surfaces share: label, note and amount rows, with totals, deductions and one rule above a grand total.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "SummaryPanel groups financial AmountRow entries such as subtotal, shipping, tax and a grand total inside an app-owned surface.",
+          "chooseWhen": [
+            "SummaryPanel groups financial AmountRow entries such as subtotal, shipping, tax and a grand total inside an app-owned surface.",
+            "AmountRow presents one already-formatted amount with an optional note, deduction, total emphasis and rollup rule."
+          ],
+          "avoidWhen": [
+            "The subject is purchased product identity, selected options or SKU; use OrderLineItem and compose a SummaryPanel alongside the goods.",
+            "The subject needs invoice description, quantity, rate and line-total columns; use InvoiceLineItems."
+          ],
+          "appOwned": [
+            "Authoritative formatted amounts, calculations and business rules",
+            "Subject surface, title and placement"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "SummaryPanel",
+                "roles": [
+                  "financial-summary",
+                  "totals",
+                  "amount-breakdown"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent",
+                "slots": [
+                  "children"
+                ]
+              },
+              {
+                "symbol": "AmountRow",
+                "roles": [
+                  "financial-amount"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent",
+                "slots": [
+                  "label",
+                  "note"
+                ]
+              }
+            ],
+            "owns": [
+              "Financial row alignment and summary rhythm",
+              "AmountRow total, deduction and grand-total rule treatments"
+            ],
+            "parentOwns": [
+              "Formatted amounts and authoritative calculations",
+              "Subject surface, title and placement"
+            ],
+            "embedded": "SummaryPanel is card-free; place it beneath OrderLineItem rows or in another padded subject surface without adding an inset box."
+          },
           "jobs": [
-            "Build a money ledger with the same rows, deductions and totals as the commerce blocks."
+            "SummaryPanel groups financial AmountRow entries such as subtotal, shipping, tax and a grand total inside an app-owned surface.",
+            "AmountRow presents one already-formatted amount with an optional note, deduction, total emphasis and rollup rule."
           ],
           "tags": [
             "blocks",
@@ -12789,16 +14093,51 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Order header",
-          "description": "The order number as the page heading, a status chip for each axis the order moves on, and the order's commands in one menu.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "OrderHeader is an order route title row: the order number as the heading, separate payment and fulfillment status chips, placement facts and one actions menu.",
+          "chooseWhen": [
+            "OrderHeader is an order route title row: the order number as the heading, separate payment and fulfillment status chips, placement facts and one actions menu."
+          ],
+          "avoidWhen": [
+            "Page already renders the route heading; keep one heading owner and compose order status badges in the Page header.",
+            "The subject is an invoice document; use InvoiceHeader."
+          ],
+          "appOwned": [
+            "Order number, placement facts and payment/fulfillment status values",
+            "Permitted order commands and their callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "OrderHeader",
+                "roles": [
+                  "order-header",
+                  "order-title",
+                  "order-status-header"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "none"
+              }
+            ],
+            "owns": [
+              "Order heading, status chips and placement facts",
+              "Order command menu anatomy"
+            ],
+            "parentOwns": [
+              "Route gutters and the single page heading",
+              "Order data and permitted commands"
+            ],
+            "page": "Use OrderHeader as the route title row only when Page renders no header of its own; pass headingTag when another h1 already names the route."
+          },
           "jobs": [
-            "Open an order page with its reference, payment and fulfillment status, and commands."
+            "OrderHeader is an order route title row: the order number as the heading, separate payment and fulfillment status chips, placement facts and one actions menu."
           ],
           "tags": [
             "blocks",
@@ -12806,7 +14145,11 @@
             "orders",
             "order-header"
           ],
-          "aliases": [],
+          "aliases": [
+            "order page header",
+            "order title row",
+            "order number header"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -12830,16 +14173,57 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce",
+            "themelia-react-ui/layout/page"
+          ]
         },
         {
           "title": "Fulfillment group",
-          "description": "One shipment's worth of an order: goods that share a fulfillment state and location, and the commands that move them on.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "FulfillmentGroup presents one shipment worth of order goods that share a fulfillment status and ship-from location, as OrderLineItem rows with the commands that move them on.",
+          "chooseWhen": [
+            "FulfillmentGroup presents one shipment worth of order goods that share a fulfillment status and ship-from location, as OrderLineItem rows with the commands that move them on."
+          ],
+          "avoidWhen": [
+            "Goods are not grouped by fulfillment status or location; compose OrderLineItem rows in the subject surface.",
+            "A ledger compares reserved quantities across several locations; compose an app-owned allocation structure from public owners."
+          ],
+          "appOwned": [
+            "Fulfillment status, location and accepted line values",
+            "Fulfillment commands, permissions and resulting state"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "FulfillmentGroup",
+                "roles": [
+                  "fulfillment-group",
+                  "fulfillment",
+                  "warehouse-fulfillment",
+                  "shipment-group"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant",
+                "slots": [
+                  "children",
+                  "location",
+                  "notice"
+                ]
+              }
+            ],
+            "owns": [
+              "Status heading, location and notice anatomy",
+              "Line rows and first-action/overflow command placement"
+            ],
+            "parentOwns": [
+              "Order lines, statuses and permitted commands",
+              "Placement among the other order subjects"
+            ],
+            "embedded": "Framed by default; pass surface=\"flat\" inside an existing Card so the group adds no second frame."
+          },
           "jobs": [
-            "List an order's goods grouped by fulfillment state, with the commands that move them on."
+            "FulfillmentGroup presents one shipment worth of order goods that share a fulfillment status and ship-from location, as OrderLineItem rows with the commands that move them on."
           ],
           "tags": [
             "blocks",
@@ -12847,7 +14231,14 @@
             "orders",
             "fulfillment-group"
           ],
-          "aliases": [],
+          "aliases": [
+            "fulfillment",
+            "warehouse fulfillment",
+            "shipment group",
+            "unfulfilled items",
+            "fulfilled items",
+            "pick list"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -12871,16 +14262,55 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Order line item",
-          "description": "One row of ordered goods: thumbnail, title, variant, SKU, properties, unit price × quantity, and the line total.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "OrderLineItem presents purchased order items: one sold product with selected options, variant, SKU, quantity, unit price and passed line total in an order, refund or packing slip.",
+          "chooseWhen": [
+            "OrderLineItem presents purchased order items: one sold product with selected options, variant, SKU, quantity, unit price and passed line total in an order, refund or packing slip."
+          ],
+          "avoidWhen": [
+            "An invoice needs description, quantity, rate and line-total columns; use InvoiceLineItems.",
+            "Only a financial breakdown or grand total is needed; use SummaryPanel and AmountRow."
+          ],
+          "appOwned": [
+            "Purchased product identity, selected options and authoritative formatted prices",
+            "Line grouping, surrounding surface and financial summary"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "OrderLineItem",
+                "roles": [
+                  "order-line",
+                  "order-line-items",
+                  "order-items",
+                  "sold-line",
+                  "purchased-item"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent",
+                "slots": [
+                  "children"
+                ]
+              }
+            ],
+            "owns": [
+              "Purchased product identity, options and per-line facts",
+              "Container-responsive unit-price/quantity and line-total placement"
+            ],
+            "parentOwns": [
+              "Purchased line data and authoritative formatted amounts",
+              "Line grouping, subject surface and financial summary"
+            ],
+            "embedded": "Compose the goods row and a SummaryPanel inside the subject surface; pass the accepted line total rather than deriving it in presentation code."
+          },
           "jobs": [
-            "Show one ordered product with its variant, SKU, properties, unit price and passed line total."
+            "OrderLineItem presents purchased order items: one sold product with selected options, variant, SKU, quantity, unit price and passed line total in an order, refund or packing slip."
           ],
           "tags": [
             "blocks",
@@ -12888,7 +14318,10 @@
             "orders",
             "order-line-item"
           ],
-          "aliases": [],
+          "aliases": [
+            "order items",
+            "order line items"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -12912,7 +14345,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Order summary",
@@ -12990,12 +14425,44 @@
         },
         {
           "title": "Order transactions",
-          "description": "The payment ledger: every attempt against the order's payment methods, failed ones included, signed by kind.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "OrderTransactions lists every payment attempt of an order (authorizations, captures, refunds, failures) with amount, status and reference.",
+          "chooseWhen": [
+            "OrderTransactions lists every payment attempt of an order (authorizations, captures, refunds, failures) with amount, status and reference."
+          ],
+          "avoidWhen": [
+            "The subject is a chronological payment narrative; use PaymentTimeline.",
+            "Only totals and balances are needed; use OrderSummary or SummaryPanel."
+          ],
+          "appOwned": [
+            "Authoritative transactions, amounts and references",
+            "Capture, refund and retry commands outside the ledger"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "OrderTransactions",
+                "roles": [
+                  "order-transactions",
+                  "payment-ledger",
+                  "transaction-history"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Transaction rows, status chips and sign treatment",
+              "Empty ledger presentation"
+            ],
+            "parentOwns": [
+              "Transaction data and money formatting",
+              "Subject surface and placement"
+            ],
+            "embedded": "Unframed by default; pass surface=\"card\" for its own card on an order or invoice page."
+          },
           "jobs": [
-            "List every payment attempt on an order, including failures, with its kind, status and reference."
+            "OrderTransactions lists every payment attempt of an order (authorizations, captures, refunds, failures) with amount, status and reference."
           ],
           "tags": [
             "blocks",
@@ -13003,7 +14470,13 @@
             "orders",
             "order-transactions"
           ],
-          "aliases": [],
+          "aliases": [
+            "order transactions",
+            "payment ledger",
+            "payment transactions",
+            "transaction history",
+            "captures and refunds"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -13027,16 +14500,50 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         },
         {
           "title": "Order customer",
-          "description": "Who bought the order and where it goes: identity, contact links, and the shipping and billing addresses.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "OrderCustomer presents the buyer of one order: name, contact, order count and shipping/billing addresses with edit callbacks.",
+          "chooseWhen": [
+            "OrderCustomer presents the buyer of one order: name, contact, order count and shipping/billing addresses with edit callbacks."
+          ],
+          "avoidWhen": [
+            "The route is the customer record itself; use Page with MetadataList and customer subjects.",
+            "Only one postal address is needed; use AddressCard."
+          ],
+          "appOwned": [
+            "Customer identity, contact facts and addresses",
+            "Customer navigation and address edit callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "OrderCustomer",
+                "roles": [
+                  "order-customer",
+                  "customer-summary",
+                  "buyer-details"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "variant"
+              }
+            ],
+            "owns": [
+              "Buyer identity, contact and address anatomy",
+              "Address edit command placement"
+            ],
+            "parentOwns": [
+              "Customer data and edit callbacks",
+              "Subject surface and aside placement"
+            ],
+            "embedded": "Unframed by default; pass surface=\"card\" when it is its own card in an order aside."
+          },
           "jobs": [
-            "Show who placed an order, how to reach them, and where it ships and is billed."
+            "OrderCustomer presents the buyer of one order: name, contact, order count and shipping/billing addresses with edit callbacks."
           ],
           "tags": [
             "blocks",
@@ -13044,7 +14551,12 @@
             "orders",
             "order-customer"
           ],
-          "aliases": [],
+          "aliases": [
+            "order customer",
+            "customer details",
+            "buyer details",
+            "customer contact"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -13068,10 +14580,112 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/commerce"
+          ]
         }
       ],
-      "recipes": []
+      "recipes": [
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "SoldProductWithSummary"
+          ],
+          "symbols": [
+            "AmountRow",
+            "OrderLineItem",
+            "SummaryPanel"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "CustomServiceInvoice"
+          ],
+          "symbols": [
+            "InvoiceColumn",
+            "InvoiceLineItem",
+            "InvoiceLineItems"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "OrderFulfillmentDetail"
+          ],
+          "symbols": [
+            "FulfillmentGroup",
+            "OrderCustomer",
+            "OrderSummary",
+            "OrderTimeline",
+            "OrderTransactions",
+            "ShipmentTracking"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "ReceivableInvoiceDetail"
+          ],
+          "symbols": [
+            "AddressCard",
+            "AmountRow",
+            "InvoiceHeader",
+            "InvoiceLineItems",
+            "PaymentTimeline",
+            "SummaryPanel"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        }
+      ]
     },
     {
       "import": "themelia-react-ui/blocks/commerce/receipt",
@@ -13087,7 +14701,7 @@
       "layer": "blocks",
       "responsibility": "Blocks family: Receipt.",
       "jobs": [
-        "Compose a purchase receipt with financial values and verification."
+        "Receipt renders a printable paper receipt with header, ReceiptItems content, footer and optional QR code."
       ],
       "tags": [
         "blocks",
@@ -13097,7 +14711,9 @@
         "verification"
       ],
       "aliases": [
+        "payment receipt",
         "purchase-receipt",
+        "receipt summary",
         "receipt-paper"
       ],
       "sections": [
@@ -13106,20 +14722,45 @@
       "guidance": [
         {
           "title": "Receipt",
-          "description": "Composable receipt paper with Card insets, monetary line items and optional verification.",
+          "description": "Receipt renders a printable paper receipt with header, ReceiptItems content, footer and optional QR code.",
           "chooseWhen": [
-            "Render a compact purchase receipt or proof of payment."
+            "Receipt renders a printable paper receipt with header, ReceiptItems content, footer and optional QR code."
           ],
           "avoidWhen": [
-            "Use InvoiceLineItems for a full invoice table."
+            "An invoice document with parties and line columns; use InvoiceHeader and InvoiceLineItems."
           ],
           "appOwned": [
-            "Accounting calculations",
-            "Verification URLs and optional QRCode",
-            "Translated merchant/details copy and actions"
+            "Receipt content, amounts and QR payload"
           ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "Receipt",
+                "roles": [
+                  "receipt",
+                  "payment-receipt"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "self",
+                "slots": [
+                  "children",
+                  "header",
+                  "footer"
+                ]
+              }
+            ],
+            "owns": [
+              "Paper surface, tooth edge and insets",
+              "Header, body and footer regions"
+            ],
+            "parentOwns": [
+              "Receipt content and amounts",
+              "Placement and print flow"
+            ]
+          },
           "jobs": [
-            "Compose a purchase receipt with financial values and verification."
+            "Receipt renders a printable paper receipt with header, ReceiptItems content, footer and optional QR code."
           ],
           "tags": [
             "blocks",
@@ -13130,7 +14771,9 @@
           ],
           "aliases": [
             "receipt-paper",
-            "purchase-receipt"
+            "purchase-receipt",
+            "payment receipt",
+            "receipt summary"
           ],
           "section": "Blocks",
           "browse": {
@@ -13170,7 +14813,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce"
+          ]
         }
       ],
       "recipes": [
@@ -13625,6 +15270,20 @@
           "optionalPeers": [
             "recharts"
           ]
+        },
+        {
+          "file": "examples/custom-composition.tsx",
+          "exports": [
+            "AssessmentComparison"
+          ],
+          "symbols": [
+            "InlineStat"
+          ],
+          "references": [
+            "references/custom-composition.md#token-backed-placement-and-drawing",
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -15707,6 +17366,7 @@
       "layer": "features",
       "responsibility": "Features family: Filters.",
       "jobs": [
+        "A filter chooses from a hierarchy (locations, categories): give SELECT or MULTI_SELECT options children; the editor shows one level at a time and selectableOptions allows branches.",
         "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job."
       ],
       "tags": [
@@ -15715,7 +17375,12 @@
         "search & filter"
       ],
       "aliases": [
-        "query toolbar"
+        "category tree filter",
+        "filter bar",
+        "hierarchical filter",
+        "nested filter options",
+        "query toolbar",
+        "server filtering"
       ],
       "sections": [
         "Features"
@@ -15725,7 +17390,8 @@
           "title": "Filters",
           "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."
+            "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job.",
+            "A filter chooses from a hierarchy (locations, categories): give SELECT or MULTI_SELECT options children; the editor shows one level at a time and selectableOptions allows branches."
           ],
           "avoidWhen": [
             "A complete table/index frame is desired with minimal assembly."
@@ -15735,8 +17401,49 @@
             "criteria definitions and options",
             "server results and request lifecycle"
           ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "FilterLayout",
+                "roles": [
+                  "query-toolbar",
+                  "filter-bar"
+                ],
+                "kind": "content",
+                "placement": "toolbar",
+                "surface": "parent",
+                "props": {
+                  "variant": "compact",
+                  "showClearFilters": true
+                }
+              },
+              {
+                "symbol": "FilterProvider",
+                "roles": [
+                  "filter-context"
+                ],
+                "kind": "layout",
+                "placement": "region",
+                "surface": "none",
+                "slots": [
+                  "children"
+                ]
+              }
+            ],
+            "owns": [
+              "Controlled filter context and active criteria",
+              "Filter controls, pills and clear command"
+            ],
+            "parentOwns": [
+              "Filter definitions, accepted state and query transport",
+              "Table topbar surface and insertion slot"
+            ],
+            "page": "Wrap DataTable in FilterProvider and pass FilterLayout to topbarContent; DataView is the complete collection alternative.",
+            "embedded": "FilterLayout requires FilterProvider context; use its compact variant inside the table topbar instead of a detached strip."
+          },
           "jobs": [
-            "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job."
+            "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job.",
+            "A filter chooses from a hierarchy (locations, categories): give SELECT or MULTI_SELECT options children; the editor shows one level at a time and selectableOptions allows branches."
           ],
           "tags": [
             "features",
@@ -15744,7 +17451,12 @@
             "filters"
           ],
           "aliases": [
-            "query toolbar"
+            "query toolbar",
+            "filter bar",
+            "server filtering",
+            "nested filter options",
+            "hierarchical filter",
+            "category tree filter"
           ],
           "section": "Features",
           "browse": {
@@ -16245,7 +17957,8 @@
       "responsibility": "Features family: Media library; Media workflow.",
       "jobs": [
         "Build a media selection workflow with app-owned storage services and package-owned UI states.",
-        "Use Media library in an admin interface."
+        "MediaLibrary and MediaLibraryDialog browse, search, select and upload reusable assets with app-owned catalogue requests and picker state.",
+        "MediaResourceGallery manages existing product media gallery attachments with typed accessors, primaryId, remove/reorder/primary callbacks, optional add and read-only presentation."
       ],
       "tags": [
         "build",
@@ -16255,7 +17968,11 @@
         "selection",
         "upload"
       ],
-      "aliases": [],
+      "aliases": [
+        "attached product media",
+        "existing product images",
+        "product media gallery"
+      ],
       "sections": [
         "Features",
         "Recipes"
@@ -16309,18 +18026,73 @@
         },
         {
           "title": "Media library",
-          "description": "Framework-agnostic media picker for admin product, CMS, and campaign flows. Provides an embeddable library surface, a Dialog-backed picker wrapper, upload staging, details editing, controlled selection, async fetching, slots, render hooks, and headless state through useMediaLibrary.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "MediaResourceGallery manages existing product media gallery attachments with typed accessors, primaryId, remove/reorder/primary callbacks, optional add and read-only presentation.",
+          "chooseWhen": [
+            "MediaResourceGallery manages existing product media gallery attachments with typed accessors, primaryId, remove/reorder/primary callbacks, optional add and read-only presentation.",
+            "MediaLibrary and MediaLibraryDialog browse, search, select and upload reusable assets with app-owned catalogue requests and picker state."
+          ],
+          "avoidWhen": [
+            "A new local File[] selection is needed before transfer; use MediaGallery rather than manufacturing stored asset records or converting URL records into files."
+          ],
+          "appOwned": [
+            "Asset identity, URLs, accessors, accepted attachment order and primary image",
+            "Catalogue transport, upload persistence and permitted mutation callbacks"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "MediaResourceGallery",
+                "roles": [
+                  "media-gallery",
+                  "product-media",
+                  "attached-media"
+                ],
+                "kind": "workflow",
+                "placement": "region",
+                "surface": "self",
+                "slots": [
+                  "action",
+                  "description",
+                  "empty",
+                  "title"
+                ]
+              },
+              {
+                "symbol": "MediaLibraryDialog",
+                "roles": [
+                  "media-picker",
+                  "asset-picker"
+                ],
+                "kind": "workflow",
+                "placement": "overlay",
+                "surface": "self",
+                "slots": [
+                  "trigger"
+                ]
+              }
+            ],
+            "owns": [
+              "Gallery frame, primary marker, reorder and remove commands",
+              "Asset browsing, search, selection and upload dialog"
+            ],
+            "parentOwns": [
+              "Asset records, accessors and accepted order",
+              "Catalogue transport and upload persistence"
+            ]
+          },
           "jobs": [
-            "Use Media library in an admin interface."
+            "MediaResourceGallery manages existing product media gallery attachments with typed accessors, primaryId, remove/reorder/primary callbacks, optional add and read-only presentation.",
+            "MediaLibrary and MediaLibraryDialog browse, search, select and upload reusable assets with app-owned catalogue requests and picker state."
           ],
           "tags": [
             "optional-peer",
             "dnd-kit"
           ],
-          "aliases": [],
+          "aliases": [
+            "product media gallery",
+            "existing product images",
+            "attached product media"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -16363,10 +18135,54 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/media-gallery",
+            "themelia-react-ui/base/upload"
+          ]
         }
       ],
-      "recipes": []
+      "recipes": [
+        {
+          "file": "examples/product-media.tsx",
+          "exports": [
+            "AttachedProductImages"
+          ],
+          "symbols": [
+            "MediaLibraryAccessors",
+            "MediaResourceGallery"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@dnd-kit/core",
+            "@dnd-kit/sortable",
+            "@dnd-kit/utilities",
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/product-media.tsx",
+          "exports": [
+            "MediaOnlyProductOverview"
+          ],
+          "symbols": [
+            "MediaLibraryAccessors",
+            "MediaResourceGallery"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@dnd-kit/core",
+            "@dnd-kit/sortable",
+            "@dnd-kit/utilities",
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        }
+      ]
     },
     {
       "import": "themelia-react-ui/features/mentions",
@@ -16501,13 +18317,16 @@
       "layer": "features",
       "responsibility": "Features family: Action overlays.",
       "jobs": [
-        "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior."
+        "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior.",
+        "ActionDialog and ActionDrawer submit a native form through formId, loading and strings; the form owns validation and transport while the overlay keeps its generated action footer."
       ],
       "tags": [
         "features",
         "overlays"
       ],
-      "aliases": [],
+      "aliases": [
+        "overlay form"
+      ],
       "sections": [
         "Features"
       ],
@@ -16516,7 +18335,8 @@
           "title": "Action overlays",
           "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."
+            "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior.",
+            "ActionDialog and ActionDrawer submit a native form through formId, loading and strings; the form owns validation and transport while the overlay keeps its generated action footer."
           ],
           "avoidWhen": [
             "The surface is anchored to a trigger (a popover, menu, select or tooltip) rather than a dialog."
@@ -16572,16 +18392,19 @@
               "Opening state and application effects",
               "Form or mutation data and permitted callbacks"
             ],
-            "embedded": "Open through app or feature callbacks; a modal workflow is not an ordinary page-subject child."
+            "embedded": "Open through app or feature callbacks. For formId forms, keep generated actions instead of adding FormActionsBar inside the padded footer; custom footer replaces the action content and owns its states."
           },
           "jobs": [
-            "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior."
+            "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior.",
+            "ActionDialog and ActionDrawer submit a native form through formId, loading and strings; the form owns validation and transport while the overlay keeps its generated action footer."
           ],
           "tags": [
             "features",
             "overlays"
           ],
-          "aliases": [],
+          "aliases": [
+            "overlay form"
+          ],
           "section": "Features",
           "browse": {
             "category": "surfaces-overlays",
@@ -16671,6 +18494,23 @@
           "optionalPeers": [
             "react-hook-form"
           ]
+        },
+        {
+          "file": "examples/rhf-overlay-form.tsx",
+          "exports": [
+            "RHFDialogForm"
+          ],
+          "symbols": [
+            "ActionDialog",
+            "useOverlayVisibility"
+          ],
+          "references": [
+            "references/rhf-workflows.md#overlay-create-and-edit",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-hook-form"
+          ]
         }
       ]
     },
@@ -16747,6 +18587,7 @@
         "ProductVariantDetailsStrings",
         "ProductVariantEditableField",
         "ProductVariantEditor",
+        "ProductVariantEditorField",
         "ProductVariantEditorProps",
         "ProductVariantEditorStrings",
         "ProductVariantEditorValues",
@@ -16825,9 +18666,11 @@
       "responsibility": "Features family: Product overview; Products; Variant details; Variant management.",
       "jobs": [
         "Product workspace/editor state, options, variants, tables, support rails, and callbacks must compose together.",
-        "Use Product overview in an admin interface.",
-        "Use Variant details in an admin interface.",
-        "Use Variant management in an admin interface."
+        "ProductOptionsMatrix and ProductVariantsBulkTable can compose separately when option definitions and variant comparisons need independent placement.",
+        "ProductOverview composes product identity, media, facts, options, variants and selected supporting regions. Media enters through details.media; named slots insert separate app subjects.",
+        "ProductVariantDetails presents one selected SKU with chosen options, media, metadata and commands; renderMetadata and footerSlot can add domain-specific inventory or costing context.",
+        "ProductVariantEditor edits variant fields and option choices through controlled values, awaited onSubmit, pending/error callbacks and cancellation.",
+        "ProductVariantsManager combines optionGroups with sellable variants and coordinates option editing, grouping and variant commands through app callbacks."
       ],
       "tags": [
         "commerce",
@@ -16840,7 +18683,16 @@
       "aliases": [
         "features/products/actions",
         "features/products/main-column",
-        "features/products/support-rail"
+        "features/products/support-rail",
+        "product detail media",
+        "product option editing",
+        "product option values",
+        "product options variants",
+        "product view",
+        "single SKU editor",
+        "single variant details",
+        "variant comparison",
+        "variant edit"
       ],
       "sections": [
         "Features"
@@ -16889,12 +18741,44 @@
         },
         {
           "title": "Product overview",
-          "description": "The composition root that arranges the product editor's main column and support rail from one set of props.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "ProductOverview composes product identity, media, facts, options, variants and selected supporting regions. Media enters through details.media; named slots insert separate app subjects.",
+          "chooseWhen": [
+            "ProductOverview composes product identity, media, facts, options, variants and selected supporting regions. Media enters through details.media; named slots insert separate app subjects."
+          ],
+          "avoidWhen": [
+            "Only one option-definition editor, variant comparison or selected SKU is needed; inspect ProductOptionsMatrix, ProductVariantsBulkTable or ProductVariantDetails."
+          ],
+          "appOwned": [
+            "Product records, selected regions and accepted mutations",
+            "Readiness and publication policy; route shell and commands"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "ProductOverview",
+                "roles": [
+                  "product-overview",
+                  "product-workspace",
+                  "product-details",
+                  "product-specifications"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "none"
+              }
+            ],
+            "owns": [
+              "Main column and support-rail arrangement",
+              "Region cards rendered from details, options, variants and rail props"
+            ],
+            "parentOwns": [
+              "Product records and the regions the screen shows",
+              "Route header, commands and publication policy"
+            ],
+            "page": "Place ProductOverview as the product route body; pass only the regions the screen shows and insert other subjects through slots."
+          },
           "jobs": [
-            "Use Product overview in an admin interface."
+            "ProductOverview composes product identity, media, facts, options, variants and selected supporting regions. Media enters through details.media; named slots insert separate app subjects."
           ],
           "tags": [
             "features",
@@ -16905,7 +18789,9 @@
           "aliases": [
             "features/products/main-column",
             "features/products/support-rail",
-            "features/products/actions"
+            "features/products/actions",
+            "product view",
+            "product detail media"
           ],
           "section": "Features",
           "browse": {
@@ -16930,16 +18816,75 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/features/media-library",
+            "themelia-react-ui/features/products"
+          ]
         },
         {
           "title": "Variant details",
-          "description": "Variant detail and editor surfaces for product-specific edit flows. Persistence, validation, and routing stay callback-owned by the consumer.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "ProductVariantDetails presents one selected SKU with chosen options, media, metadata and commands; renderMetadata and footerSlot can add domain-specific inventory or costing context.",
+          "chooseWhen": [
+            "ProductVariantDetails presents one selected SKU with chosen options, media, metadata and commands; renderMetadata and footerSlot can add domain-specific inventory or costing context.",
+            "ProductVariantEditor edits variant fields and option choices through controlled values, awaited onSubmit, pending/error callbacks and cancellation."
+          ],
+          "avoidWhen": [
+            "Several sellable variants need comparison or option definitions need editing; inspect ProductVariantsBulkTable, ProductVariantsManager and ProductOptionsMatrix.",
+            "The app requires per-warehouse editable balances or extra fields: compare supported slots first, then compose the missing fields with public form owners."
+          ],
+          "appOwned": [
+            "Selected variant, validation, transport and accepted field values",
+            "Warehouse balances, reservations and other domain-specific data"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "ProductVariantDetails",
+                "roles": [
+                  "selected-variant-details",
+                  "variant-details",
+                  "sku-details"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "parent",
+                "slots": [
+                  "footerSlot",
+                  "headerEnd",
+                  "media",
+                  "empty"
+                ]
+              },
+              {
+                "symbol": "ProductVariantEditor",
+                "roles": [
+                  "variant-editor",
+                  "sku-editor",
+                  "variant-form"
+                ],
+                "kind": "workflow",
+                "placement": "region",
+                "surface": "parent",
+                "slots": [
+                  "children",
+                  "footerSlot",
+                  "headerEnd"
+                ]
+              }
+            ],
+            "owns": [
+              "Selected SKU facts, options, media and commands",
+              "Variant form fields, option selects and save/cancel/delete lifecycle"
+            ],
+            "parentOwns": [
+              "Selected variant, validation and persistence",
+              "The drawer or subject surface that hosts the editor"
+            ],
+            "embedded": "Open ProductVariantEditor inside ActionDrawer for editing; hide unused fields with visibleFields and add app-owned fields such as unit cost as children."
+          },
           "jobs": [
-            "Use Variant details in an admin interface."
+            "ProductVariantDetails presents one selected SKU with chosen options, media, metadata and commands; renderMetadata and footerSlot can add domain-specific inventory or costing context.",
+            "ProductVariantEditor edits variant fields and option choices through controlled values, awaited onSubmit, pending/error callbacks and cancellation."
           ],
           "tags": [
             "features",
@@ -16947,7 +18892,11 @@
             "products",
             "variant-details"
           ],
-          "aliases": [],
+          "aliases": [
+            "single SKU editor",
+            "variant edit",
+            "single variant details"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -16968,16 +18917,88 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/forms",
+            "themelia-react-ui/features/products"
+          ]
         },
         {
           "title": "Variant management",
-          "description": "Option matrix and generated variants table with controlled collapse, selection, editable cells, render-props, and bulk callbacks.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "ProductVariantsManager combines optionGroups with sellable variants and coordinates option editing, grouping and variant commands through app callbacks.",
+          "chooseWhen": [
+            "ProductVariantsManager combines optionGroups with sellable variants and coordinates option editing, grouping and variant commands through app callbacks.",
+            "ProductOptionsMatrix and ProductVariantsBulkTable can compose separately when option definitions and variant comparisons need independent placement."
+          ],
+          "avoidWhen": [
+            "One sellable SKU needs its own details or field editor; inspect ProductVariantDetails and ProductVariantEditor.",
+            "The package is expected to reconcile option combinations, warehouse reservations or authoritative prices without application data and rules."
+          ],
+          "appOwned": [
+            "Option definitions, sellable variants and reconciliation rules",
+            "Controlled editing state, commands and accepted mutations"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "ProductVariantsManager",
+                "roles": [
+                  "product-variants-manager",
+                  "options-and-variants",
+                  "variant-management"
+                ],
+                "kind": "workflow",
+                "placement": "region",
+                "surface": "variant",
+                "slots": [
+                  "controlsEnd",
+                  "footerSlot",
+                  "headerEnd"
+                ]
+              },
+              {
+                "symbol": "ProductOptionsMatrix",
+                "roles": [
+                  "product-options",
+                  "option-matrix"
+                ],
+                "kind": "workflow",
+                "placement": "region",
+                "surface": "variant",
+                "slots": [
+                  "footerSlot",
+                  "headerEnd",
+                  "empty"
+                ]
+              },
+              {
+                "symbol": "ProductVariantsBulkTable",
+                "roles": [
+                  "product-variants-table",
+                  "variant-table"
+                ],
+                "kind": "workflow",
+                "placement": "region",
+                "surface": "variant",
+                "slots": [
+                  "footerSlot",
+                  "headerEnd",
+                  "empty"
+                ]
+              }
+            ],
+            "owns": [
+              "Option and variant presentation with coordinated editing controls",
+              "Grouping, selection and supported render seams"
+            ],
+            "parentOwns": [
+              "Authoritative option/variant data and reconciliation",
+              "Command callbacks, transport and accepted state"
+            ],
+            "embedded": "To allow controlled option editing, pair editingOptionId with onEditingOptionIdChange; null keeps all option editors closed. renderValue replaces value content, while onAddValue and save/cancel callbacks still own the supported editing workflow."
+          },
           "jobs": [
-            "Use Variant management in an admin interface."
+            "ProductVariantsManager combines optionGroups with sellable variants and coordinates option editing, grouping and variant commands through app callbacks.",
+            "ProductOptionsMatrix and ProductVariantsBulkTable can compose separately when option definitions and variant comparisons need independent placement."
           ],
           "tags": [
             "features",
@@ -16985,7 +19006,12 @@
             "products",
             "variant-management"
           ],
-          "aliases": [],
+          "aliases": [
+            "product option values",
+            "product option editing",
+            "product options variants",
+            "variant comparison"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -17012,10 +19038,105 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/commerce",
+            "themelia-react-ui/features/products"
+          ]
+        }
+      ],
+      "recipes": [
+        {
+          "file": "examples/product-media.tsx",
+          "exports": [
+            "MediaOnlyProductOverview"
+          ],
+          "symbols": [
+            "ProductOverview"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@dnd-kit/core",
+            "@dnd-kit/sortable",
+            "@dnd-kit/utilities",
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "ProductOptionDefinitions"
+          ],
+          "symbols": [
+            "ProductOptionGroup",
+            "ProductOptionsMatrix"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "ProductVariantManagement"
+          ],
+          "symbols": [
+            "ProductOptionEditDraft",
+            "ProductOptionGroup",
+            "ProductVariantRow",
+            "ProductVariantsManager"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "VariantComparison"
+          ],
+          "symbols": [
+            "ProductOptionGroup",
+            "ProductVariantRow",
+            "ProductVariantsBulkTable"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "VariantInspectionAndEditor"
+          ],
+          "symbols": [
+            "ProductVariantDetails",
+            "ProductVariantEditor",
+            "ProductVariantEditorValues"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
         }
-      ],
-      "recipes": []
+      ]
     },
     {
       "import": "themelia-react-ui/features/questionnaire",
@@ -17122,11 +19243,22 @@
         "TabbedResourceShellProps",
         "defaultResourceStrings"
       ],
+      "deprecated": {
+        "ResourceHeader": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "ResourceHeaderCommandProps": "Part of deprecated ResourceHeader. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "ResourceHeaderProps": "Part of deprecated ResourceHeader. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "ResourceIndexShell": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "ResourceIndexShellProps": "Part of deprecated ResourceIndexShell. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "ResourceShowShell": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "ResourceShowShellProps": "Part of deprecated ResourceShowShell. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "TabbedResourceShell": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
+        "TabbedResourceShellProps": "Part of deprecated TabbedResourceShell. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers."
+      },
       "optionalPeers": [],
       "layer": "features",
       "responsibility": "Features family: Resource workspaces.",
       "jobs": [
-        "A record index or detail needs resource identity, toolbar, body, aside and loading/empty/error regions."
+        "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject."
       ],
       "tags": [
         "features",
@@ -17140,12 +19272,12 @@
       "guidance": [
         {
           "title": "Resource workspaces",
-          "description": "A record index or detail needs resource identity, toolbar, body, aside and loading/empty/error regions.",
+          "description": "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject.",
           "chooseWhen": [
-            "A record index or detail needs resource identity, toolbar, body, aside and loading/empty/error regions."
+            "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject."
           ],
           "avoidWhen": [
-            "Only a page title or one plain fact list is needed."
+            "New routes should use Page for identity, toolbar, aside and loading/empty/error regions."
           ],
           "appOwned": [
             "Resource data and request lifecycle",
@@ -17153,32 +19285,6 @@
           ],
           "composition": {
             "mappings": [
-              {
-                "symbol": "ResourceIndexShell",
-                "roles": [
-                  "resource-index"
-                ],
-                "kind": "layout",
-                "placement": "region",
-                "surface": "none",
-                "slots": [
-                  "children",
-                  "toolbar"
-                ]
-              },
-              {
-                "symbol": "ResourceShowShell",
-                "roles": [
-                  "resource-detail"
-                ],
-                "kind": "layout",
-                "placement": "region",
-                "surface": "none",
-                "slots": [
-                  "children",
-                  "toolbar"
-                ]
-              },
               {
                 "symbol": "ResourceDetailsSection",
                 "roles": [
@@ -17202,11 +19308,11 @@
               "Application chrome and page gutters",
               "Route heading and command ownership"
             ],
-            "page": "Embed the resource shell in one Page and choose which header owns the route title; tabs are optional when switching sections is useful.",
+            "page": "Use Page for new resource routes. Deprecated resource shells retain their existing inset-free embedding contract for migration.",
             "embedded": "The resource shell adds no page inset; ResourceDetailsSection owns its Card and adapts facts to its available width."
           },
           "jobs": [
-            "A record index or detail needs resource identity, toolbar, body, aside and loading/empty/error regions."
+            "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject."
           ],
           "tags": [
             "features",
@@ -17757,6 +19863,10 @@
                 "kind": "workflow",
                 "placement": "region",
                 "surface": "self",
+                "slots": [
+                  "topbarContent",
+                  "topbarEnd"
+                ],
                 "props": {
                   "surface": "card"
                 }
@@ -18081,6 +20191,9 @@
         "AppLayout",
         "AppLayoutProps",
         "AppLayoutVariant",
+        "AppShellContentSurface",
+        "AppShellSidebarPresentation",
+        "AppShellSidebarRegionProps",
         "AppSidebar",
         "AppSidebarProps",
         "AsideNavGroup",
@@ -18186,10 +20299,14 @@
         "PageHeader",
         "PageHeaderAction",
         "PageHeaderProps",
+        "PageHeaderRenderContext",
+        "PageHeaderRenderSlot",
         "PageHeaderSlots",
         "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
+        "PageSlots",
+        "PageStrings",
         "PageViewport",
         "PageViewportProps",
         "Section",
@@ -18225,11 +20342,19 @@
         "SidebarNavigation",
         "SidebarNavigationFooter",
         "SidebarNavigationFooterProps",
+        "SidebarNavigationGroup",
+        "SidebarNavigationGroups",
+        "SidebarNavigationRail",
+        "SidebarNavigationRailItem",
+        "SidebarNavigationRailProps",
         "SidebarNavigationStrings",
         "SidebarNavigationUser",
         "SidebarNavigationUserProps",
         "SidebarNavigationUserStrings",
+        "SidebarRenderItemContentContext",
         "SidebarRenderItemContext",
+        "SidebarSlot",
+        "SidebarSlotContext",
         "SidebarSlots",
         "SidebarWorkspaceDropdown",
         "SidebarWorkspaceDropdownProps",
@@ -18285,6 +20410,7 @@
         "defaultHeaderSearchStrings",
         "defaultHeaderUserMenuStrings",
         "defaultPageActionsStrings",
+        "defaultPageStrings",
         "defaultRenderLink",
         "defaultSectionNavStrings",
         "defaultSideNavStrings",
@@ -18334,6 +20460,9 @@
         "AppLayout",
         "AppLayoutProps",
         "AppLayoutVariant",
+        "AppShellContentSurface",
+        "AppShellSidebarPresentation",
+        "AppShellSidebarRegionProps",
         "SidebarInsetContentElement",
         "SidebarInsetLayout",
         "SidebarInsetLayoutProps",
@@ -18358,7 +20487,8 @@
       "responsibility": "Layout family: App shell; Application shell.",
       "jobs": [
         "Build a responsive admin application shell with header, sidebar, navigation, and one page viewport.",
-        "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport."
+        "Compose a Header, App sidebar or Inset shell with single or dual navigation and one PageViewport.",
+        "Configure light-header, dark-header, sidebar, inset or stacked chrome through the existing AppLayout presets."
       ],
       "tags": [
         "app-shell",
@@ -18371,10 +20501,18 @@
       ],
       "aliases": [
         "admin workspace",
+        "app sidebar shell",
         "application shell",
+        "contextual sidebar",
         "dark header",
         "dark header layout",
-        "light header"
+        "dual sidebar",
+        "header shell",
+        "inset page surface",
+        "light header",
+        "multi sidebar layout",
+        "shadcn inset shell",
+        "single sidebar"
       ],
       "sections": [
         "Layouts",
@@ -18430,9 +20568,10 @@
         },
         {
           "title": "App shell",
-          "description": "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport.",
+          "description": "Compose a Header, App sidebar or Inset shell with single or dual navigation and one PageViewport.",
           "chooseWhen": [
-            "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport."
+            "Compose a Header, App sidebar or Inset shell with single or dual navigation and one PageViewport.",
+            "Configure light-header, dark-header, sidebar, inset or stacked chrome through the existing AppLayout presets."
           ],
           "avoidWhen": [
             "Only a route heading or content gutter is needed."
@@ -18459,9 +20598,9 @@
               }
             ],
             "owns": [
-              "Application header and sidebar chrome",
+              "Application header and independently scoped primary/contextual/aside regions",
               "One PageViewport and its scrolling boundary",
-              "Responsive shell regions"
+              "Plain or inset page surface and responsive shell placement"
             ],
             "parentOwns": [
               "Viewport height",
@@ -18471,7 +20610,8 @@
             "embedded": "Use Page or lower regions for content inside a shell; another AppLayout is a separate application boundary."
           },
           "jobs": [
-            "Compose light-header, dark-header, sidebar, inset or stacked chrome with one PageViewport."
+            "Compose a Header, App sidebar or Inset shell with single or dual navigation and one PageViewport.",
+            "Configure light-header, dark-header, sidebar, inset or stacked chrome through the existing AppLayout presets."
           ],
           "tags": [
             "layout",
@@ -18481,9 +20621,17 @@
           "aliases": [
             "application shell",
             "admin workspace",
+            "header shell",
+            "app sidebar shell",
+            "shadcn inset shell",
             "dark header layout",
             "dark header",
-            "light header"
+            "light header",
+            "single sidebar",
+            "dual sidebar",
+            "multi sidebar layout",
+            "inset page surface",
+            "contextual sidebar"
           ],
           "section": "Layouts",
           "browse": {
@@ -19004,7 +21152,9 @@
       "layer": "layout",
       "responsibility": "Layout family: Header.",
       "jobs": [
-        "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome."
+        "Header adapts by container width: brand appears from @2xl/app-header and center from @3xl/app-header; left/right always render when supplied. Essential narrow navigation must not live only in brand/center.",
+        "Use Header for application chrome: compose brand, primary navigation and tools through its typed regions. Use OverflowTabBar when route navigation must preserve the active item and disclose overflow.",
+        "Use HeaderUserMenu, HeaderSearch and HeaderNotifications for their specific application tools."
       ],
       "tags": [
         "header",
@@ -19012,6 +21162,9 @@
         "shells"
       ],
       "aliases": [
+        "app topbar navigation",
+        "application header navigation",
+        "application topbar",
         "header account menu",
         "header tools",
         "signed-in user",
@@ -19023,19 +21176,25 @@
       "guidance": [
         {
           "title": "Header",
-          "description": "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome.",
+          "description": "Use Header for application chrome: compose brand, primary navigation and tools through its typed regions. Use OverflowTabBar when route navigation must preserve the active item and disclose overflow.",
           "chooseWhen": [
-            "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome."
+            "Use Header for application chrome: compose brand, primary navigation and tools through its typed regions. Use OverflowTabBar when route navigation must preserve the active item and disclose overflow.",
+            "Header adapts by container width: brand appears from @2xl/app-header and center from @3xl/app-header; left/right always render when supplied. Essential narrow navigation must not live only in brand/center.",
+            "Use HeaderUserMenu, HeaderSearch and HeaderNotifications for their specific application tools."
           ],
           "avoidWhen": [
-            "Only an avatar image or route title is needed."
+            "Only an avatar image or a route title/command heading is needed."
           ],
           "appOwned": [
+            "brand, route navigation model and tool callbacks",
+            "essential narrow-width identity/navigation in always-visible left/right slots; compact content and constrained overflow",
             "signed-in user and permissioned account callbacks",
             "search/dialog state and notification data"
           ],
           "jobs": [
-            "Use HeaderUserMenu, HeaderSearch, HeaderNotifications or typed Header regions in application chrome."
+            "Use Header for application chrome: compose brand, primary navigation and tools through its typed regions. Use OverflowTabBar when route navigation must preserve the active item and disclose overflow.",
+            "Header adapts by container width: brand appears from @2xl/app-header and center from @3xl/app-header; left/right always render when supplied. Essential narrow navigation must not live only in brand/center.",
+            "Use HeaderUserMenu, HeaderSearch and HeaderNotifications for their specific application tools."
           ],
           "tags": [
             "layout",
@@ -19043,6 +21202,9 @@
             "header"
           ],
           "aliases": [
+            "application header navigation",
+            "app topbar navigation",
+            "application topbar",
             "header account menu",
             "user avatar menu",
             "signed-in user",
@@ -19066,12 +21228,14 @@
                 "HeaderToolButton",
                 "HeaderToolPopover",
                 "HeaderGlobalSearchTrigger",
-                "HeaderUserMenu"
+                "HeaderUserMenu",
+                "Header"
               ]
             }
           ],
           "alternatives": [
             "themelia-react-ui/base/avatar",
+            "themelia-react-ui/base/navigation",
             "themelia-react-ui/layout/page",
             "themelia-react-ui/layout/sidebar"
           ]
@@ -19388,11 +21552,16 @@
         "PageHeader",
         "PageHeaderAction",
         "PageHeaderProps",
+        "PageHeaderRenderContext",
+        "PageHeaderRenderSlot",
         "PageHeaderSlots",
         "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
-        "defaultPageActionsStrings"
+        "PageSlots",
+        "PageStrings",
+        "defaultPageActionsStrings",
+        "defaultPageStrings"
       ],
       "deprecated": {
         "PageAction": "Use PageHeaderAction with `primaryAction` and `secondaryActions`.",
@@ -19406,7 +21575,7 @@
       "layer": "layout",
       "responsibility": "Layout family: Page shell; Resource detail.",
       "jobs": [
-        "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots.",
+        "A route needs a title, composed context, back navigation, commands, tabs, toolbar, aside or loading/empty/error states.",
         "Build a responsive resource detail page with primary facts, related context, and actions."
       ],
       "tags": [
@@ -19487,9 +21656,9 @@
         },
         {
           "title": "Page shell",
-          "description": "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots.",
+          "description": "A route needs a title, composed context, back navigation, commands, tabs, toolbar, aside or loading/empty/error states.",
           "chooseWhen": [
-            "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots."
+            "A route needs a title, composed context, back navigation, commands, tabs, toolbar, aside or loading/empty/error states."
           ],
           "avoidWhen": [
             "An existing shell needs only a visual title/description/badge block."
@@ -19504,30 +21673,37 @@
               {
                 "symbol": "Page",
                 "roles": [
-                  "route"
+                  "route",
+                  "resource-index",
+                  "resource-detail"
                 ],
                 "kind": "page",
                 "placement": "region",
                 "surface": "none",
                 "slots": [
-                  "children"
+                  "children",
+                  "aside",
+                  "toolbar",
+                  "beforeHeader",
+                  "afterHeader",
+                  "emptySlot"
                 ]
               }
             ],
             "owns": [
               "Content measure and page gutters",
-              "Route header, command placement and header/body rhythm",
-              "Subject gaps between direct body children"
+              "Route header with content slots, responsive command placement, toolbar and lifecycle states",
+              "Main/aside geometry and direct-subject rhythm"
             ],
             "parentOwns": [
               "Application chrome",
               "Scrolling through PageViewport"
             ],
-            "page": "Use one Page for each route; narrow selects the centered measure unless maxWidth is explicit.",
+            "page": "Use one Page per route: explicit maxWidth wins, then narrow md (48rem), then aside xl (80rem), otherwise lg (64rem).",
             "embedded": "Inside an existing Page, compose subject regions with Card, TwoColumnLayout or Stack instead of another Page."
           },
           "jobs": [
-            "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots."
+            "A route needs a title, composed context, back navigation, commands, tabs, toolbar, aside or loading/empty/error states."
           ],
           "tags": [
             "layout",
@@ -19576,7 +21752,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/navigation",
-            "themelia-react-ui/features/resource"
+            "themelia-react-ui/features/data-view"
           ]
         }
       ],
@@ -19598,6 +21774,48 @@
           ],
           "optionalPeers": []
         },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "OrderFulfillmentDetail"
+          ],
+          "symbols": [
+            "Page"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "ReceivableInvoiceDetail"
+          ],
+          "symbols": [
+            "Page"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
         {
           "file": "examples/detail.tsx",
           "exports": [
@@ -19616,6 +21834,22 @@
           ],
           "optionalPeers": []
         },
+        {
+          "file": "examples/index-table.tsx",
+          "exports": [
+            "AccountIndex"
+          ],
+          "symbols": [
+            "Page"
+          ],
+          "references": [
+            "references/screen-archetypes.md",
+            "references/workflows.md#index-and-navigation"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table"
+          ]
+        },
         {
           "file": "examples/rhf-edit-page.tsx",
           "exports": [
@@ -19669,33 +21903,76 @@
       "layer": "layout",
       "responsibility": "Layout family: Settings shell.",
       "jobs": [
-        "Use Settings shell in an admin interface."
+        "Several settings sections need persistent side navigation and a content region."
       ],
       "tags": [
         "layout",
         "settings",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "multi-section settings",
+        "preferences",
+        "settings navigation"
+      ],
       "sections": [
         "Layouts"
       ],
       "guidance": [
         {
           "title": "Settings shell",
-          "description": "Router-neutral settings chrome with grouped aside navigation and a consumer-owned content region.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "description": "Several settings sections need persistent side navigation and a content region.",
+          "chooseWhen": [
+            "Several settings sections need persistent side navigation and a content region."
+          ],
+          "avoidWhen": [
+            "One focused form needs no settings navigation."
+          ],
+          "appOwned": [
+            "Settings groups and current route",
+            "Form state, permissions and save/discard transport"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "SettingsShell",
+                "roles": [
+                  "settings-workspace"
+                ],
+                "kind": "layout",
+                "placement": "region",
+                "surface": "none",
+                "slots": [
+                  "children",
+                  "aside",
+                  "footer"
+                ]
+              }
+            ],
+            "owns": [
+              "Settings navigation and responsive content regions",
+              "Subject gaps between content children"
+            ],
+            "parentOwns": [
+              "Page measure, gutters and route identity",
+              "Application form lifecycle and routing"
+            ],
+            "page": "Place SettingsShell inside one Page; keep each form subject in FormSection and supply the navigation groups.",
+            "embedded": "SettingsShell adds content rhythm, not another Page or automatic Card. Avoid repeating its section title in nested headers."
+          },
           "jobs": [
-            "Use Settings shell in an admin interface."
+            "Several settings sections need persistent side navigation and a content region."
           ],
           "tags": [
             "layout",
             "shells",
             "settings"
           ],
-          "aliases": [],
+          "aliases": [
+            "preferences",
+            "settings navigation",
+            "multi-section settings"
+          ],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -19720,7 +21997,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/forms",
+            "themelia-react-ui/layout/page"
+          ]
         }
       ],
       "recipes": []
@@ -19751,11 +22031,19 @@
         "SidebarNavigation",
         "SidebarNavigationFooter",
         "SidebarNavigationFooterProps",
+        "SidebarNavigationGroup",
+        "SidebarNavigationGroups",
+        "SidebarNavigationRail",
+        "SidebarNavigationRailItem",
+        "SidebarNavigationRailProps",
         "SidebarNavigationStrings",
         "SidebarNavigationUser",
         "SidebarNavigationUserProps",
         "SidebarNavigationUserStrings",
+        "SidebarRenderItemContentContext",
         "SidebarRenderItemContext",
+        "SidebarSlot",
+        "SidebarSlotContext",
         "SidebarSlots",
         "SidebarWorkspaceDropdown",
         "SidebarWorkspaceDropdownProps",
@@ -19775,7 +22063,8 @@
       "layer": "layout",
       "responsibility": "Layout family: Sidebar.",
       "jobs": [
-        "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition."
+        "Use AppSidebar for ordered/grouped navigation, contextual render slots, workspace partials and account footer composition.",
+        "Use SidebarNavigationRail for primary area icons alongside contextual navigation; LayoutSidebarProvider coordinates named desktop states and one drawer."
       ],
       "tags": [
         "layout",
@@ -19784,8 +22073,11 @@
       ],
       "aliases": [
         "application navigation",
+        "ordered navigation groups",
         "pinned sidebar header",
+        "primary navigation rail",
         "sidebar account menu",
+        "sidebar render hooks",
         "workspace switcher"
       ],
       "sections": [
@@ -19794,9 +22086,10 @@
       "guidance": [
         {
           "title": "Sidebar",
-          "description": "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition.",
+          "description": "Use AppSidebar for ordered/grouped navigation, contextual render slots, workspace partials and account footer composition.",
           "chooseWhen": [
-            "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition."
+            "Use AppSidebar for ordered/grouped navigation, contextual render slots, workspace partials and account footer composition.",
+            "Use SidebarNavigationRail for primary area icons alongside contextual navigation; LayoutSidebarProvider coordinates named desktop states and one drawer."
           ],
           "avoidWhen": [
             "Only an inline hierarchy picker is needed."
@@ -19807,7 +22100,8 @@
             "user callbacks and custom pinned header content"
           ],
           "jobs": [
-            "Use AppSidebar with fixed header additions, grouped navigation, workspace partials and SidebarNavigationUser footer composition."
+            "Use AppSidebar for ordered/grouped navigation, contextual render slots, workspace partials and account footer composition.",
+            "Use SidebarNavigationRail for primary area icons alongside contextual navigation; LayoutSidebarProvider coordinates named desktop states and one drawer."
           ],
           "tags": [
             "layout",
@@ -19818,7 +22112,10 @@
             "workspace switcher",
             "sidebar account menu",
             "pinned sidebar header",
-            "application navigation"
+            "application navigation",
+            "primary navigation rail",
+            "sidebar render hooks",
+            "ordered navigation groups"
           ],
           "section": "Layouts",
           "browse": {
@@ -19845,7 +22142,8 @@
                 "SidebarWorkspaceDropdown",
                 "SidebarNavigationFooter",
                 "SidebarNavigationUser",
-                "LayoutSidebarProvider"
+                "LayoutSidebarProvider",
+                "SidebarNavigationRail"
               ]
             }
           ],
@@ -20640,6 +22938,63 @@
         }
       ],
       "recipes": [
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "CustomServiceInvoice"
+          ],
+          "symbols": [
+            "Money",
+            "Number"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "ReceivableInvoiceDetail"
+          ],
+          "symbols": [
+            "Money"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
+        {
+          "file": "examples/custom-composition.tsx",
+          "exports": [
+            "AssessmentComparison"
+          ],
+          "symbols": [
+            "Money"
+          ],
+          "references": [
+            "references/custom-composition.md#token-backed-placement-and-drawing",
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/detail.tsx",
           "exports": [
@@ -20697,6 +23052,22 @@
             "@tanstack/react-table"
           ]
         },
+        {
+          "file": "examples/product-parts.tsx",
+          "exports": [
+            "VariantInspectionAndEditor"
+          ],
+          "symbols": [
+            "Money"
+          ],
+          "references": [
+            "references/product-composition.md#executable-product-parts"
+          ],
+          "optionalPeers": [
+            "@tanstack/react-table",
+            "react-hook-form"
+          ]
+        },
         {
           "file": "examples/receipt.tsx",
           "exports": [
@@ -20744,6 +23115,32 @@
             "react-day-picker"
           ]
         },
+        {
+          "file": "examples/token-domain-structure.tsx",
+          "exports": [
+            "AllocationByLocation"
+          ],
+          "symbols": [
+            "Number"
+          ],
+          "references": [
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/token-domain-structure.tsx",
+          "exports": [
+            "AllocationSubjectExample"
+          ],
+          "symbols": [
+            "Number"
+          ],
+          "references": [
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/website.tsx",
           "exports": [
@@ -21122,6 +23519,27 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/commerce-lines.tsx",
+          "exports": [
+            "CustomServiceInvoice"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/commerce-composition.md#invoice-and-receivable-detail",
+            "references/commerce-composition.md#order-and-fulfillment-detail",
+            "references/custom-composition.md#commerce-lines-and-financial-summaries",
+            "references/domain-structures.md#executable-example",
+            "references/screen-archetypes.md"
+          ],
+          "optionalPeers": [
+            "react-day-picker",
+            "react-hook-form",
+            "sonner"
+          ]
+        },
         {
           "file": "examples/composition.tsx",
           "exports": [
@@ -21193,6 +23611,21 @@
             "react-hook-form"
           ]
         },
+        {
+          "file": "examples/editable-sections.tsx",
+          "exports": [
+            "EditableSections"
+          ],
+          "symbols": [
+            "Heading",
+            "Text"
+          ],
+          "references": [
+            "references/custom-composition.md#disclosure-sections",
+            "references/rhf-workflows.md#screen-and-state-ownership"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/hierarchy-capture.tsx",
           "exports": [
@@ -21286,6 +23719,34 @@
             "react-day-picker"
           ]
         },
+        {
+          "file": "examples/token-domain-structure.tsx",
+          "exports": [
+            "AllocationByLocation"
+          ],
+          "symbols": [
+            "Heading",
+            "Text"
+          ],
+          "references": [
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/token-domain-structure.tsx",
+          "exports": [
+            "AllocationSubjectExample"
+          ],
+          "symbols": [
+            "Heading",
+            "Text"
+          ],
+          "references": [
+            "references/domain-structures.md#executable-example"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/website.tsx",
           "exports": [