themelia-react-ui 1.0.2 → 2.0.1

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

@@ -2,10 +2,11 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "1.0.2",
+  "version": "2.0.1",
   "stylesheets": [
     "themelia-react-ui/style.css",
     "themelia-react-ui/theme.css",
+    "themelia-react-ui/themes/green.css",
     "themelia-react-ui/features/map/style.css"
   ],
   "peers": [
@@ -197,6 +198,8 @@
         "MoneyDisplayMode",
         "MoneyDualLayout",
         "MoneyFormatMode",
+        "OverlayAlign",
+        "OverlayConfigSlice",
         "ResolvedUIConfig",
         "SEMANTIC_TONES",
         "SemanticTone",
@@ -228,6 +231,7 @@
         "useFormattingConfig",
         "useItemConfig",
         "useMoneyConfig",
+        "useOverlayConfig",
         "useSpinnerConfig",
         "useStrings",
         "useToastConfig",
@@ -362,6 +366,7 @@
         "ActionButtonsProps",
         "ActionMenu",
         "ActionMenuAction",
+        "ActionMenuContext",
         "ActionMenuIcon",
         "ActionMenuLinkRenderProps",
         "ActionMenuProps",
@@ -913,6 +918,110 @@
         }
       ]
     },
+    {
+      "import": "themelia-react-ui/base/batch-action-bar",
+      "declaration": "dist/components/base/batch-action-bar/index.d.ts",
+      "symbols": [
+        "BatchActionBar",
+        "BatchActionBarPlacement",
+        "BatchActionBarProps",
+        "BatchActionBarStrings",
+        "defaultBatchActionBarStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "base",
+      "responsibility": "Base family: Batch action bar.",
+      "jobs": [
+        "A list, grid or table selection needs a count, bulk actions and Clear, docked to the viewport or inline."
+      ],
+      "tags": [
+        "base",
+        "batch-action-bar",
+        "navigation & data"
+      ],
+      "aliases": [
+        "bulk action bar",
+        "bulk actions",
+        "selected rows",
+        "selection bar",
+        "selection toolbar"
+      ],
+      "sections": [
+        "Base components"
+      ],
+      "guidance": [
+        {
+          "title": "Batch action bar",
+          "description": "A list, grid or table selection needs a count, bulk actions and Clear, docked to the viewport or inline.",
+          "chooseWhen": [
+            "A list, grid or table selection needs a count, bulk actions and Clear, docked to the viewport or inline."
+          ],
+          "avoidWhen": [
+            "The actions concern one record or the whole page rather than a selection."
+          ],
+          "appOwned": [
+            "selection state and the list it belongs to",
+            "bulk action callbacks and their results"
+          ],
+          "jobs": [
+            "A list, grid or table selection needs a count, bulk actions and Clear, docked to the viewport or inline."
+          ],
+          "tags": [
+            "base",
+            "navigation & data",
+            "batch-action-bar"
+          ],
+          "aliases": [
+            "bulk actions",
+            "selection bar",
+            "selection toolbar",
+            "bulk action bar",
+            "selected rows"
+          ],
+          "section": "Base components",
+          "browse": {
+            "category": "actions-navigation",
+            "group": "Batch action bar",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Floating",
+              "symbols": []
+            },
+            {
+              "title": "Inline",
+              "symbols": []
+            },
+            {
+              "title": "Copy and overflow actions",
+              "symbols": []
+            },
+            {
+              "title": "Keyboard and focus",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "BatchActionBar"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/base/action-menu",
+            "themelia-react-ui/features/resource",
+            "themelia-react-ui/features/table"
+          ]
+        }
+      ],
+      "recipes": []
+    },
     {
       "import": "themelia-react-ui/base/buttons",
       "declaration": "dist/components/base/buttons/index.d.ts",
@@ -1134,21 +1243,6 @@
         }
       ],
       "recipes": [
-        {
-          "file": "examples/app-layout.tsx",
-          "exports": [
-            "WorkspaceLayout"
-          ],
-          "symbols": [
-            "Button"
-          ],
-          "references": [
-            "references/composition.md#application-layouts",
-            "references/integration.md",
-            "references/workflows.md#single-resource-page"
-          ],
-          "optionalPeers": []
-        },
         {
           "file": "examples/composition.tsx",
           "exports": [
@@ -1191,22 +1285,6 @@
           ],
           "optionalPeers": []
         },
-        {
-          "file": "examples/detail.tsx",
-          "exports": [
-            "AccountDetailPage"
-          ],
-          "symbols": [
-            "Button"
-          ],
-          "references": [
-            "references/analytics.md#usage-facts-and-verification",
-            "references/composition.md#application-layouts",
-            "references/workflows.md#detail-and-framing",
-            "references/workflows.md#single-resource-page"
-          ],
-          "optionalPeers": []
-        },
         {
           "file": "examples/edit.tsx",
           "exports": [
@@ -1302,6 +1380,15 @@
         "defaultSmartCardStrings",
         "hasRenderableContent"
       ],
+      "deprecated": {
+        "SmartCard": "Use Card.",
+        "SmartCardAction": "Use CardAction.",
+        "SmartCardProps": "Use CardProps.",
+        "SmartCardSkeleton": "Use CardSkeleton.",
+        "SmartCardSkeletonProps": "Use CardSkeletonProps.",
+        "SmartCardStrings": "Use CardStrings.",
+        "SmartCardSurface": "Use CardSurface."
+      },
       "optionalPeers": [],
       "layer": "base",
       "responsibility": "Base family: Card.",
@@ -2918,6 +3005,14 @@
         "defaultContentBlockStrings",
         "defaultDateBlockStrings"
       ],
+      "deprecated": {
+        "ContentBlock": "Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockPadding": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockProps": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockStrings": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockSurface": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content.",
+        "ContentBlockTitleSize": "Part of deprecated ContentBlock. Use Card with surface=\"flat\" and padding=\"none\" for unframed content."
+      },
       "optionalPeers": [],
       "layer": "base",
       "responsibility": "Base family: Boolean indicator; Collapsible; Date block; Icon badge; Placeholder pattern; Scroll area; Separator; Tooltip; Visually hidden.",
@@ -3081,7 +3176,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/primitives"
           ]
         },
@@ -3843,7 +3938,7 @@
           "alternatives": [
             "themelia-react-ui/base/forms",
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/primitives"
           ]
         },
@@ -4040,7 +4135,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/base/metadata-list"
           ]
         },
         {
@@ -4870,8 +4965,8 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/forms",
-            "themelia-react-ui/base/structure",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/base/structure"
           ]
         }
       ],
@@ -4962,124 +5057,81 @@
       "recipes": []
     },
     {
-      "import": "themelia-react-ui/base/navigation",
-      "declaration": "dist/components/base/navigation/index.d.ts",
+      "import": "themelia-react-ui/base/metadata-list",
+      "declaration": "dist/components/base/metadata-list/index.d.ts",
       "symbols": [
-        "BreadcrumbItemType",
-        "BreadcrumbSize",
-        "Breadcrumbs",
-        "BreadcrumbsProps",
-        "BreadcrumbsStrings",
-        "DropdownMenu",
-        "DropdownMenuCheckboxItem",
-        "DropdownMenuContent",
-        "DropdownMenuGroup",
-        "DropdownMenuItem",
-        "DropdownMenuLabel",
-        "DropdownMenuLinkItem",
-        "DropdownMenuPortal",
-        "DropdownMenuRadioGroup",
-        "DropdownMenuRadioItem",
-        "DropdownMenuSeparator",
-        "DropdownMenuShortcut",
-        "DropdownMenuSub",
-        "DropdownMenuSubContent",
-        "DropdownMenuSubTrigger",
-        "DropdownMenuTrigger",
-        "LanguageSwitcher",
-        "LanguageSwitcherProps",
-        "NavigationTabItem",
-        "NavigationTabs",
-        "NavigationTabsProps",
-        "NavigationTabsStrings",
-        "NavigationTabsVariant",
-        "OverflowTabBar",
-        "OverflowTabBarProps",
-        "OverflowTabBarStrings",
-        "OverflowTabItem",
-        "PageHeading",
-        "PageHeadingBadge",
-        "PageHeadingProps",
-        "PaginationContent",
-        "PaginationContentProps",
-        "PaginationEllipsis",
-        "PaginationEllipsisProps",
-        "PaginationItem",
-        "PaginationItemProps",
-        "PaginationLink",
-        "PaginationLinkProps",
-        "PaginationNext",
-        "PaginationNextProps",
-        "PaginationPrevious",
-        "PaginationPreviousProps",
-        "PaginationPrimitive",
-        "PaginationProps",
-        "PaginationStrings",
-        "Tabs",
-        "TabsContent",
-        "TabsList",
-        "TabsListProps",
-        "TabsScrollStrings",
-        "TabsTrigger",
-        "defaultBreadcrumbsStrings",
-        "defaultNavigationTabsStrings",
-        "defaultOverflowTabBarStrings",
-        "defaultPaginationStrings",
-        "defaultTabsScrollStrings"
+        "MetadataDensity",
+        "MetadataInlineListItem",
+        "MetadataLayout",
+        "MetadataList",
+        "MetadataListItem",
+        "MetadataListProps",
+        "MetadataListStrings",
+        "MetadataValue",
+        "MetadataValueDescriptor",
+        "MetadataValueKind",
+        "MetadataValueProps",
+        "defaultMetadataListStrings"
       ],
       "optionalPeers": [],
       "layer": "base",
-      "responsibility": "Base family: Breadcrumbs; Dropdown menu; Language switcher; Navigation overview; Navigation tabs; Overflow tab bar; Page heading; Pagination.",
+      "responsibility": "Base family: Metadata list.",
       "jobs": [
-        "A small, always-visible set of sibling application routes needs compact or prominent tab navigation.",
-        "An existing shell needs only a visual title, description, badges, and actions block.",
-        "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy.",
-        "Use Breadcrumbs in an admin interface.",
-        "Use Dropdown menu in an admin interface.",
-        "Use Language switcher in an admin interface.",
-        "Use Overflow tab bar in an admin interface.",
-        "Use Pagination in an admin interface."
+        "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
       ],
       "tags": [
         "base",
-        "breadcrumbs",
-        "dropdown-menu",
-        "language-switcher",
-        "navigation",
-        "navigation & data",
-        "navigation-tabs",
-        "overflow-tab-bar",
-        "page-header",
-        "pagination"
+        "display",
+        "metadata-list"
+      ],
+      "aliases": [
+        "blocks/data-display/metadata-list",
+        "blocks/metadata-list",
+        "contact details",
+        "details",
+        "fact list",
+        "key value",
+        "read-only facts"
       ],
-      "aliases": [],
       "sections": [
         "Base components"
       ],
       "guidance": [
         {
-          "title": "Navigation overview",
-          "description": "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy.",
+          "title": "Metadata list",
+          "description": "Customer, order, account, or record label/value facts need a grid, rows, or inline summary.",
           "chooseWhen": [
-            "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy."
+            "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
           ],
           "avoidWhen": [
-            "The surface frames content it does not own, or the menu is a list of repeated action definitions."
+            "Each row has independent identity/actions or the relationship needs title, alerts, and action regions."
+          ],
+          "appOwned": [
+            "fact labels and priority",
+            "loaded subject data",
+            "formatting defaults"
           ],
-          "appOwned": [],
           "jobs": [
-            "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy."
+            "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
           ],
           "tags": [
             "base",
-            "navigation & data",
-            "navigation"
+            "display",
+            "metadata-list"
+          ],
+          "aliases": [
+            "blocks/data-display/metadata-list",
+            "blocks/metadata-list",
+            "fact list",
+            "read-only facts",
+            "contact details",
+            "key value",
+            "details"
           ],
-          "aliases": [],
           "section": "Base components",
           "browse": {
-            "category": "actions-navigation",
-            "group": "Navigation",
+            "category": "data-display",
+            "group": "Metadata list",
             "domain": "",
             "collection": ""
           },
@@ -5089,27 +5141,242 @@
               "symbols": []
             },
             {
-              "title": "Page header",
+              "title": "Consumer usage",
               "symbols": []
             },
             {
-              "title": "Breadcrumbs",
+              "title": "Grid",
               "symbols": []
             },
             {
-              "title": "Tabs",
+              "title": "API surface",
               "symbols": []
             },
             {
-              "title": "Language switcher",
+              "title": "Two-column rows",
+              "symbols": []
+            },
+            {
+              "title": "Inline summaries",
+              "symbols": []
+            },
+            {
+              "title": "Composition",
               "symbols": []
             },
             {
               "title": "API",
               "symbols": [
-                "PageHeading",
-                "Tabs",
-                "TabsList",
+                "MetadataList"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/base/item",
+            "themelia-react-ui/blocks/data-display"
+          ]
+        }
+      ],
+      "recipes": [
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetail"
+          ],
+          "symbols": [
+            "MetadataList"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "MetadataList"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
+        {
+          "file": "examples/receipt.tsx",
+          "exports": [
+            "PurchaseReceipt"
+          ],
+          "symbols": [
+            "MetadataList"
+          ],
+          "references": [
+            "references/composition.md#receipts"
+          ],
+          "optionalPeers": []
+        }
+      ]
+    },
+    {
+      "import": "themelia-react-ui/base/navigation",
+      "declaration": "dist/components/base/navigation/index.d.ts",
+      "symbols": [
+        "BreadcrumbItemType",
+        "BreadcrumbSize",
+        "Breadcrumbs",
+        "BreadcrumbsProps",
+        "BreadcrumbsStrings",
+        "DropdownMenu",
+        "DropdownMenuCheckboxItem",
+        "DropdownMenuContent",
+        "DropdownMenuGroup",
+        "DropdownMenuItem",
+        "DropdownMenuLabel",
+        "DropdownMenuLinkItem",
+        "DropdownMenuPortal",
+        "DropdownMenuRadioGroup",
+        "DropdownMenuRadioItem",
+        "DropdownMenuSeparator",
+        "DropdownMenuShortcut",
+        "DropdownMenuSub",
+        "DropdownMenuSubContent",
+        "DropdownMenuSubTrigger",
+        "DropdownMenuTrigger",
+        "LanguageSwitcher",
+        "LanguageSwitcherProps",
+        "NavigationTabItem",
+        "NavigationTabs",
+        "NavigationTabsProps",
+        "NavigationTabsStrings",
+        "NavigationTabsVariant",
+        "OverflowTabBar",
+        "OverflowTabBarProps",
+        "OverflowTabBarStrings",
+        "OverflowTabItem",
+        "PageHeaderAction",
+        "PageHeaderLinkRenderProps",
+        "PageHeaderLinkRenderer",
+        "PageHeading",
+        "PageHeadingBadge",
+        "PageHeadingProps",
+        "PaginationContent",
+        "PaginationContentProps",
+        "PaginationEllipsis",
+        "PaginationEllipsisProps",
+        "PaginationItem",
+        "PaginationItemProps",
+        "PaginationLink",
+        "PaginationLinkProps",
+        "PaginationNext",
+        "PaginationNextProps",
+        "PaginationPrevious",
+        "PaginationPreviousProps",
+        "PaginationPrimitive",
+        "PaginationProps",
+        "PaginationStrings",
+        "Tabs",
+        "TabsContent",
+        "TabsList",
+        "TabsListProps",
+        "TabsScrollStrings",
+        "TabsTrigger",
+        "defaultBreadcrumbsStrings",
+        "defaultNavigationTabsStrings",
+        "defaultOverflowTabBarStrings",
+        "defaultPaginationStrings",
+        "defaultTabsScrollStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "base",
+      "responsibility": "Base family: Breadcrumbs; Dropdown menu; Language switcher; Navigation overview; Navigation tabs; Overflow tab bar; Page heading; Pagination.",
+      "jobs": [
+        "A small, always-visible set of sibling application routes needs compact or prominent tab navigation.",
+        "An existing shell needs only a visual title, description, badges, and actions block.",
+        "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy.",
+        "Use Breadcrumbs in an admin interface.",
+        "Use Dropdown menu in an admin interface.",
+        "Use Language switcher in an admin interface.",
+        "Use Overflow tab bar in an admin interface.",
+        "Use Pagination in an admin interface."
+      ],
+      "tags": [
+        "base",
+        "breadcrumbs",
+        "dropdown-menu",
+        "language-switcher",
+        "navigation",
+        "navigation & data",
+        "navigation-tabs",
+        "overflow-tab-bar",
+        "page-header",
+        "pagination"
+      ],
+      "aliases": [],
+      "sections": [
+        "Base components"
+      ],
+      "guidance": [
+        {
+          "title": "Navigation overview",
+          "description": "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy.",
+          "chooseWhen": [
+            "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy."
+          ],
+          "avoidWhen": [
+            "The surface frames content it does not own, or the menu is a list of repeated action definitions."
+          ],
+          "appOwned": [],
+          "jobs": [
+            "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy."
+          ],
+          "tags": [
+            "base",
+            "navigation & data",
+            "navigation"
+          ],
+          "aliases": [],
+          "section": "Base components",
+          "browse": {
+            "category": "actions-navigation",
+            "group": "Navigation",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Page header",
+              "symbols": []
+            },
+            {
+              "title": "Breadcrumbs",
+              "symbols": []
+            },
+            {
+              "title": "Tabs",
+              "symbols": []
+            },
+            {
+              "title": "Language switcher",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "PageHeading",
+                "Tabs",
+                "TabsList",
                 "TabsTrigger",
                 "TabsContent",
                 "Breadcrumbs",
@@ -5791,7 +6058,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/forms",
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/table"
           ]
         },
@@ -6071,74 +6338,25 @@
         "SheetTitle",
         "SheetTrigger"
       ],
+      "deprecated": {
+        "Sheet": "Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetBody": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetClose": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetContent": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetDescription": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetFooter": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetHeader": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetTitle": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`.",
+        "SheetTrigger": "Part of deprecated Sheet. Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`."
+      },
       "optionalPeers": [],
       "layer": "base",
-      "responsibility": "Base family: Sheet.",
-      "jobs": [
-        "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
-      ],
-      "tags": [
-        "base",
-        "menus & overlays",
-        "sheet"
-      ],
+      "responsibility": "Deprecated Sheet parts kept for existing callers. New dialogs, drawers and side panels use ActionDrawer, ActionDialog or ConfirmDialog from features/overlays.",
+      "jobs": [],
+      "tags": [],
       "aliases": [],
-      "sections": [
-        "Base components"
-      ],
-      "guidance": [
-        {
-          "title": "Sheet",
-          "description": "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy.",
-          "chooseWhen": [
-            "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
-          ],
-          "avoidWhen": [
-            "The workflow fits a centered dialog or the standard callback-driven drawer recipe."
-          ],
-          "appOwned": [],
-          "jobs": [
-            "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
-          ],
-          "tags": [
-            "base",
-            "menus & overlays",
-            "sheet"
-          ],
-          "aliases": [],
-          "section": "Base components",
-          "browse": {
-            "category": "surfaces-overlays",
-            "group": "Sheet",
-            "domain": "",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Overview",
-              "symbols": []
-            },
-            {
-              "title": "Consumer usage",
-              "symbols": []
-            },
-            {
-              "title": "Examples",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "Sheet",
-                "SheetContent"
-              ]
-            }
-          ],
-          "alternatives": [
-            "themelia-react-ui/features/overlays"
-          ]
-        }
-      ],
+      "sections": [],
+      "guidance": [],
       "recipes": []
     },
     {
@@ -6748,7 +6966,7 @@
       "layer": "base",
       "responsibility": "Base family: Structural composition.",
       "jobs": [
-        "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
+        "Compose layout blocks, vertical siblings, a horizontal row, wrapping actions, responsive grids and peer card gaps."
       ],
       "tags": [
         "base",
@@ -6758,6 +6976,9 @@
       "aliases": [
         "copy gaps",
         "copy-gap",
+        "horizontal row",
+        "layout blocks",
+        "peer card gaps",
         "title description spacing"
       ],
       "references": [
@@ -6770,7 +6991,7 @@
       "guidance": [
         {
           "title": "Structural composition",
-          "description": "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks.",
+          "description": "Compose passive layout blocks with Stack rows, responsive Grid tracks, GridCell spans and available-width AdaptiveGrid.",
           "chooseWhen": [
             "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
           ],
@@ -6779,14 +7000,18 @@
           ],
           "appOwned": [],
           "jobs": [
-            "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
+            "Compose layout blocks, vertical siblings, a horizontal row, wrapping actions, responsive grids and peer card gaps."
           ],
           "tags": [
             "base",
             "foundations",
             "structure"
           ],
-          "aliases": [],
+          "aliases": [
+            "layout blocks",
+            "horizontal row",
+            "peer card gaps"
+          ],
           "section": "Foundations",
           "browse": {
             "category": "foundations",
@@ -6829,27 +7054,12 @@
             "themelia-react-ui/base/cards",
             "themelia-react-ui/base/forms",
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/table"
           ]
         }
       ],
       "recipes": [
-        {
-          "file": "examples/app-layout.tsx",
-          "exports": [
-            "WorkspaceLayout"
-          ],
-          "symbols": [
-            "Stack"
-          ],
-          "references": [
-            "references/composition.md#application-layouts",
-            "references/integration.md",
-            "references/workflows.md#single-resource-page"
-          ],
-          "optionalPeers": []
-        },
         {
           "file": "examples/composition.tsx",
           "exports": [
@@ -6933,6 +7143,21 @@
             "@tanstack/react-table"
           ]
         },
+        {
+          "file": "examples/layout-blocks.tsx",
+          "exports": [
+            "LayoutBlocks"
+          ],
+          "symbols": [
+            "Stack"
+          ],
+          "references": [
+            "references/composition.md#horizontal-rows",
+            "references/composition.md#main-and-aside-card-gaps",
+            "references/composition.md#structure-and-spacing"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/planning-usage-edit.tsx",
           "exports": [
@@ -7934,9 +8159,11 @@
         "SliderStrings",
         "TagsInput",
         "TagsInputProps",
+        "TagsInputStrings",
         "defaultColorInputStrings",
         "defaultPhoneInputStrings",
-        "defaultSliderStrings"
+        "defaultSliderStrings",
+        "defaultTagsInputStrings"
       ],
       "optionalPeers": [
         "react-day-picker"
@@ -8301,7 +8528,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/overlays"
           ]
         },
@@ -9552,6 +9779,7 @@
         "AnalyticsStrings",
         "ChartCard",
         "ChartCardProps",
+        "FormatMetricValueOptions",
         "Metric",
         "MetricBar",
         "MetricBarProps",
@@ -9702,6 +9930,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/chart",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/blocks/data-display"
           ]
         },
@@ -9812,7 +10041,7 @@
         },
         {
           "title": "Comparison",
-          "description": "`MetricComparison` — side-by-side current vs previous with a tone-tinted delta box. Reuses the unified `MetricData` shape so currency/percent formatting carries through.",
+          "description": "`MetricComparison` — side-by-side current vs previous with a signed delta badge. Reuses the unified `MetricData` shape so currency/percent formatting carries through.",
           "chooseWhen": [],
           "avoidWhen": [],
           "appOwned": [],
@@ -10080,6 +10309,7 @@
             }
           ],
           "alternatives": [
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/blocks/analytics",
             "themelia-react-ui/blocks/data-display"
           ]
@@ -10384,22 +10614,32 @@
         "AddressCardProps",
         "AddressCardStrings",
         "AddressKind",
+        "AmountRow",
+        "AmountRowProps",
         "BookingCalendarEventCard",
         "BookingCalendarEventCardItem",
         "BookingCalendarEventCardProps",
         "BookingEntry",
         "CartLineItem",
+        "CartSummary",
         "CartSummaryCard",
         "CartSummaryCardProps",
+        "CartSummaryProps",
         "CartSummaryStrings",
         "CouponInputCard",
         "CouponInputCardProps",
         "CouponInputStrings",
         "DEFAULT_SEO_LISTING_LIMITS",
         "Discount",
+        "DiscountStack",
         "DiscountStackPreview",
         "DiscountStackPreviewProps",
+        "DiscountStackProps",
         "DiscountStackStrings",
+        "FulfillmentGroup",
+        "FulfillmentGroupProps",
+        "FulfillmentGroupStrings",
+        "FulfillmentStatus",
         "GiftcardCard",
         "GiftcardCardProps",
         "GiftcardCardVariant",
@@ -10433,20 +10673,42 @@
         "LoyaltyPoints",
         "LoyaltyPointsProps",
         "LoyaltyPointsStrings",
+        "OrderAddress",
+        "OrderCustomer",
+        "OrderCustomerProps",
+        "OrderCustomerStrings",
+        "OrderHeader",
+        "OrderHeaderProps",
+        "OrderHeaderStrings",
+        "OrderLine",
+        "OrderLineItem",
+        "OrderLineItemProps",
+        "OrderLineItemStrings",
+        "OrderLineProperty",
         "OrderStatusCard",
         "OrderStatusCardProps",
         "OrderStatusEvent",
         "OrderStatusKind",
         "OrderStatusStrings",
+        "OrderSummary",
+        "OrderSummaryProps",
+        "OrderSummaryStrings",
         "OrderTimeline",
         "OrderTimelineEvent",
         "OrderTimelineProps",
+        "OrderTransactions",
+        "OrderTransactionsProps",
+        "OrderTransactionsStrings",
         "PatternVariant",
         "PaymentBrand",
         "PaymentEvent",
         "PaymentMethod",
+        "PaymentMethodCard",
+        "PaymentMethodCardProps",
         "PaymentMethodProps",
         "PaymentMethodStrings",
+        "PaymentMethodVariant",
+        "PaymentStatus",
         "PaymentTimeline",
         "PaymentTimelineProps",
         "Receipt",
@@ -10455,8 +10717,10 @@
         "ReceiptLineItem",
         "ReceiptProps",
         "RefundStage",
+        "RefundStatus",
         "RefundStatusCard",
         "RefundStatusCardProps",
+        "RefundStatusProps",
         "RefundStatusStrings",
         "SeoListingCard",
         "SeoListingCardProps",
@@ -10476,11 +10740,17 @@
         "SubscriptionSummaryCard",
         "SubscriptionSummaryCardProps",
         "SubscriptionSummaryStrings",
+        "SummaryLine",
+        "SummaryPanel",
+        "SummaryPanelProps",
         "TaxBreakdownCard",
         "TaxBreakdownCardProps",
         "TaxBreakdownStrings",
         "TaxLineItem",
         "TrackingStep",
+        "Transaction",
+        "TransactionKind",
+        "TransactionStatus",
         "UpcomingBookingRow",
         "UpcomingBookingRowProps",
         "VendorProfileCard",
@@ -10498,10 +10768,16 @@
         "defaultCartSummaryStrings",
         "defaultCouponInputStrings",
         "defaultDiscountStackStrings",
+        "defaultFulfillmentGroupStrings",
         "defaultInventoryLevelStrings",
         "defaultInventorySectionStrings",
         "defaultLoyaltyPointsStrings",
+        "defaultOrderCustomerStrings",
+        "defaultOrderHeaderStrings",
+        "defaultOrderLineItemStrings",
         "defaultOrderStatusStrings",
+        "defaultOrderSummaryStrings",
+        "defaultOrderTransactionsStrings",
         "defaultPaymentMethodStrings",
         "defaultRefundStatusStrings",
         "defaultSeoListingCardStrings",
@@ -10515,12 +10791,20 @@
       ],
       "optionalPeers": [
         "react-day-picker",
-        "react-hook-form"
+        "react-hook-form",
+        "sonner"
       ],
       "layer": "blocks",
-      "responsibility": "Blocks family: Address card; Booking event details; Cart summary; Commerce overview; Coupon input; Discount stack; Giftcard; Inventory level; Inventory section; Invoice header; Invoice line items; Invoice mini; Loyalty points; Order status; Order timeline; Payment method; Payment timeline; Refund status; SEO listing; Shipment tracking; Subscription summary; Tax breakdown; Upcoming booking; Vendor profile; Voucher entry.",
+      "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.",
+        "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.",
+        "State what an order costs and where its money stands, with a note about the balance.",
         "Use Address card in an admin interface.",
         "Use Booking event details in an admin interface.",
         "Use Cart summary in an admin interface.",
@@ -10548,27 +10832,37 @@
       ],
       "tags": [
         "address-card",
+        "amount-row",
         "blocks",
         "booking-event",
         "cart-summary",
         "commerce",
         "coupon-input",
         "discount-stack",
+        "fulfillment-group",
         "giftcard",
         "inventory-level",
         "inventory-section",
         "invoice-header",
         "invoice-line-items",
         "invoice-mini",
+        "ledger",
         "loyalty-points",
+        "order-customer",
+        "order-header",
+        "order-line-item",
         "order-status",
+        "order-summary",
         "order-timeline",
+        "order-transactions",
+        "orders",
         "payment-method",
         "payment-timeline",
         "refund-status",
         "seo-listing",
         "shipment-tracking",
         "subscription-summary",
+        "summary-panel",
         "tax-breakdown",
         "upcoming-booking",
         "vendor-profile",
@@ -10599,6 +10893,7 @@
         "blocks/commerce-upcoming-booking",
         "blocks/commerce-vendor-profile",
         "blocks/commerce-voucher-entry",
+        "blocks/commerce/amount-row",
         "blocks/commerce/invoice-table"
       ],
       "sections": [
@@ -10642,8 +10937,8 @@
             }
           ],
           "alternatives": [
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/data-display",
             "themelia-react-ui/features/products"
           ]
         },
@@ -11663,6 +11958,297 @@
             }
           ],
           "alternatives": []
+        },
+        {
+          "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": [],
+          "jobs": [
+            "Build a money ledger with the same rows, deductions and totals as the commerce blocks."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "summary-panel",
+            "amount-row",
+            "ledger"
+          ],
+          "aliases": [
+            "blocks/commerce/amount-row"
+          ],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Checkout & payment"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "AmountRow",
+                "SummaryPanel"
+              ]
+            }
+          ],
+          "alternatives": []
+        },
+        {
+          "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": [],
+          "jobs": [
+            "Open an order page with its reference, payment and fulfillment status, and commands."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "orders",
+            "order-header"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Orders"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "OrderHeader"
+              ]
+            }
+          ],
+          "alternatives": []
+        },
+        {
+          "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": [],
+          "jobs": [
+            "List an order's goods grouped by fulfillment state, with the commands that move them on."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "orders",
+            "fulfillment-group"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Orders"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "FulfillmentGroup"
+              ]
+            }
+          ],
+          "alternatives": []
+        },
+        {
+          "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": [],
+          "jobs": [
+            "Show one ordered product with its variant, SKU, properties, unit price and passed line total."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "orders",
+            "order-line-item"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Orders"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "OrderLineItem"
+              ]
+            }
+          ],
+          "alternatives": []
+        },
+        {
+          "title": "Order summary",
+          "description": "An order's money in two ledgers — what was ordered and what has moved — with the payment status beside the title.",
+          "chooseWhen": [],
+          "avoidWhen": [],
+          "appOwned": [],
+          "jobs": [
+            "State what an order costs and where its money stands, with a note about the balance."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "orders",
+            "order-summary"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Orders"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "OrderSummary"
+              ]
+            }
+          ],
+          "alternatives": []
+        },
+        {
+          "title": "Order transactions",
+          "description": "The payment ledger: every attempt against the order's payment methods, failed ones included, signed by kind.",
+          "chooseWhen": [],
+          "avoidWhen": [],
+          "appOwned": [],
+          "jobs": [
+            "List every payment attempt on an order, including failures, with its kind, status and reference."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "orders",
+            "order-transactions"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Orders"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "OrderTransactions"
+              ]
+            }
+          ],
+          "alternatives": []
+        },
+        {
+          "title": "Order customer",
+          "description": "Who bought the order and where it goes: identity, contact links, and the shipping and billing addresses.",
+          "chooseWhen": [],
+          "avoidWhen": [],
+          "appOwned": [],
+          "jobs": [
+            "Show who placed an order, how to reach them, and where it ships and is billed."
+          ],
+          "tags": [
+            "blocks",
+            "commerce",
+            "orders",
+            "order-customer"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Commerce",
+            "domain": "",
+            "collection": "Orders"
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "OrderCustomer"
+              ]
+            }
+          ],
+          "alternatives": []
         }
       ],
       "recipes": []
@@ -11839,13 +12425,24 @@
         "defaultDenseInfoStrings",
         "defaultEmptyStateStrings"
       ],
+      "deprecated": {
+        "MetadataDensity": "Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataInlineListItem": "Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataLayout": "Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataList": "Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataListItem": "Part of deprecated MetadataList. Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataListProps": "Part of deprecated MetadataList. Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataValue": "Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataValueDescriptor": "Part of deprecated MetadataValue. Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataValueKind": "Part of deprecated MetadataValue. Import from `themelia-react-ui/base/metadata-list`.",
+        "MetadataValueProps": "Part of deprecated MetadataValue. Import from `themelia-react-ui/base/metadata-list`."
+      },
       "optionalPeers": [],
       "layer": "blocks",
-      "responsibility": "Blocks family: Data display overview; Dense info; Empty state; Inline stat; Metadata list; Relationship card frame.",
+      "responsibility": "Blocks family: Data display overview; Dense info; Empty state; Inline stat; Relationship card frame.",
       "jobs": [
         "A dashboard, classification, financial, project, or score readout needs many facts in one tight card.",
         "App-owned relationship content needs title, badge, alert, selector, metadata, actions, and details regions.",
-        "Customer, order, account, or record label/value facts need a grid, rows, or inline summary.",
         "Entity facts, relationships, dense readouts, or empty regions need the package recipe instead of an app-local one.",
         "No-data, no-results, or first-run content needs the standard media, title, description, and actions recipe.",
         "One compact label/value pair needs inline emphasis without trend or chart semantics."
@@ -11857,22 +12454,17 @@
         "dense-info",
         "empty-state",
         "inline-stat",
-        "metadata-list",
         "relationship-card-frame"
       ],
       "aliases": [
         "blocks/data-display-dense-info",
         "blocks/empty-state",
         "blocks/inline-stat",
-        "blocks/metadata-list",
         "blocks/relationship-card-frame",
-        "contact details",
         "details",
-        "fact list",
         "inline fact",
         "key value",
         "plain label value",
-        "read-only facts",
         "simple statistic"
       ],
       "sections": [
@@ -11971,8 +12563,8 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/analytics"
           ]
         },
         {
@@ -12090,87 +12682,8 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/data-display"
-          ]
-        },
-        {
-          "title": "Metadata list",
-          "description": "Customer, order, account, or record label/value facts need a grid, rows, or inline summary.",
-          "chooseWhen": [
-            "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
-          ],
-          "avoidWhen": [
-            "Each row has independent identity/actions or the relationship needs title, alerts, and action regions."
-          ],
-          "appOwned": [
-            "fact labels and priority",
-            "loaded subject data",
-            "formatting defaults"
-          ],
-          "jobs": [
-            "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
-          ],
-          "tags": [
-            "blocks",
-            "data display",
-            "data-display",
-            "metadata-list"
-          ],
-          "aliases": [
-            "blocks/metadata-list",
-            "fact list",
-            "read-only facts",
-            "contact details",
-            "key value",
-            "details"
-          ],
-          "section": "Blocks",
-          "browse": {
-            "category": "data-display",
-            "group": "Data display",
-            "domain": "",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Overview",
-              "symbols": []
-            },
-            {
-              "title": "Consumer usage",
-              "symbols": []
-            },
-            {
-              "title": "Grid",
-              "symbols": []
-            },
-            {
-              "title": "API surface",
-              "symbols": []
-            },
-            {
-              "title": "Two-column rows",
-              "symbols": []
-            },
-            {
-              "title": "Inline summaries",
-              "symbols": []
-            },
-            {
-              "title": "Composition",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "MetadataList"
-              ]
-            }
-          ],
-          "alternatives": [
-            "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/analytics"
           ]
         },
         {
@@ -12219,95 +12732,50 @@
               "title": "Advanced composition",
               "symbols": []
             },
-            {
-              "title": "API",
-              "symbols": [
-                "RelationshipCardFrame"
-              ]
-            }
-          ],
-          "alternatives": [
-            "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display",
-            "themelia-react-ui/features/resource-assignment"
-          ]
-        }
-      ],
-      "recipes": [
-        {
-          "file": "examples/analytics.tsx",
-          "exports": [
-            "RevenueOverview"
-          ],
-          "symbols": [
-            "EmptyState"
-          ],
-          "references": [
-            "references/analytics.md#dashboard-and-revenue-data"
-          ],
-          "optionalPeers": [
-            "recharts"
-          ]
-        },
-        {
-          "file": "examples/analytics.tsx",
-          "exports": [
-            "PlainStatistic"
-          ],
-          "symbols": [
-            "InlineStat"
-          ],
-          "references": [
-            "references/analytics.md#dashboard-and-revenue-data"
-          ],
-          "optionalPeers": [
-            "recharts"
-          ]
-        },
-        {
-          "file": "examples/detail.tsx",
-          "exports": [
-            "AccountDetail"
-          ],
-          "symbols": [
-            "MetadataList"
-          ],
-          "references": [
-            "references/analytics.md#usage-facts-and-verification",
-            "references/composition.md#application-layouts",
-            "references/workflows.md#detail-and-framing",
-            "references/workflows.md#single-resource-page"
+            {
+              "title": "API",
+              "symbols": [
+                "RelationshipCardFrame"
+              ]
+            }
           ],
-          "optionalPeers": []
-        },
+          "alternatives": [
+            "themelia-react-ui/base/item",
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/features/resource-assignment"
+          ]
+        }
+      ],
+      "recipes": [
         {
-          "file": "examples/detail.tsx",
+          "file": "examples/analytics.tsx",
           "exports": [
-            "AccountDetailPage"
+            "RevenueOverview"
           ],
           "symbols": [
-            "MetadataList"
+            "EmptyState"
           ],
           "references": [
-            "references/analytics.md#usage-facts-and-verification",
-            "references/composition.md#application-layouts",
-            "references/workflows.md#detail-and-framing",
-            "references/workflows.md#single-resource-page"
+            "references/analytics.md#dashboard-and-revenue-data"
           ],
-          "optionalPeers": []
+          "optionalPeers": [
+            "recharts"
+          ]
         },
         {
-          "file": "examples/receipt.tsx",
+          "file": "examples/analytics.tsx",
           "exports": [
-            "PurchaseReceipt"
+            "PlainStatistic"
           ],
           "symbols": [
-            "MetadataList"
+            "InlineStat"
           ],
           "references": [
-            "references/composition.md#receipts"
+            "references/analytics.md#dashboard-and-revenue-data"
           ],
-          "optionalPeers": []
+          "optionalPeers": [
+            "recharts"
+          ]
         }
       ]
     },
@@ -12577,7 +13045,7 @@
         },
         {
           "title": "Changelog",
-          "description": "ChangelogTimeline renders release history as a marker rail, mapping added, removed, modified, and fixed to colour-coded chips with version, author, and timestamp.",
+          "description": "ChangelogTimeline renders release history as a marker rail, mapping added, removed, modified, and fixed to neutral kind chips and marker icons with version, author, and timestamp.",
           "chooseWhen": [],
           "avoidWhen": [],
           "appOwned": [],
@@ -12839,7 +13307,8 @@
       ],
       "optionalPeers": [
         "@tiptap/react",
-        "@tiptap/starter-kit"
+        "@tiptap/starter-kit",
+        "react-hook-form"
       ],
       "layer": "features",
       "responsibility": "Features family: Activity and timeline; Activity log.",
@@ -13465,7 +13934,8 @@
       ],
       "optionalPeers": [
         "@tiptap/react",
-        "@tiptap/starter-kit"
+        "@tiptap/starter-kit",
+        "react-hook-form"
       ],
       "layer": "features",
       "responsibility": "Features family: Comments.",
@@ -13836,7 +14306,7 @@
             "PreparedEmail"
           ],
           "references": [
-            "references/integration.md"
+            "references/integration.md#dialogs-confirmations-and-drawers"
           ],
           "optionalPeers": [
             "@tiptap/react",
@@ -13854,7 +14324,7 @@
             "PreparedEmail"
           ],
           "references": [
-            "references/integration.md"
+            "references/integration.md#dialogs-confirmations-and-drawers"
           ],
           "optionalPeers": [
             "@tiptap/react",
@@ -14474,7 +14944,7 @@
       "guidance": [
         {
           "title": "Kanban",
-          "description": "Drag-and-drop board, generic in T. Pass `itemActions` (static array or per-item factory) for the ⋮ menu, `onItemClick` for whole-card click. Headless via `useKanban`; slots: KanbanBoard / KanbanColumn / KanbanColumnContent / KanbanItem / KanbanItemHandle / KanbanItemActions / KanbanOverlay.",
+          "description": "Drag-and-drop board, generic in T. Pass `itemActions` (static array or per-item factory) for the ⋯ menu, `onItemClick` for whole-card click. Headless via `useKanban`; slots: KanbanBoard / KanbanColumn / KanbanColumnContent / KanbanItem / KanbanItemHandle / KanbanItemActions / KanbanOverlay.",
           "chooseWhen": [],
           "avoidWhen": [],
           "appOwned": [],
@@ -14697,6 +15167,7 @@
       "symbols": [
         "MediaLibrary",
         "MediaLibraryAccessors",
+        "MediaLibraryBulkActionContext",
         "MediaLibraryCard",
         "MediaLibraryCardProps",
         "MediaLibraryCollectionOption",
@@ -14991,6 +15462,7 @@
         "ConfirmDialogProps",
         "DrawerDirection",
         "OverlayActionProps",
+        "OverlayAlign",
         "OverlayBaseProps",
         "OverlayButtonStyle",
         "OverlayButtonTone",
@@ -15035,7 +15507,7 @@
             "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior."
           ],
           "avoidWhen": [
-            "The caller needs custom compound anatomy without the shared action lifecycle."
+            "The surface is anchored to a trigger (a popover, menu, select or tooltip) rather than a dialog."
           ],
           "appOwned": [],
           "jobs": [
@@ -15068,7 +15540,8 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/base/sheet"
+            "themelia-react-ui/base/popover",
+            "themelia-react-ui/layout/sidebar"
           ]
         }
       ],
@@ -15099,6 +15572,23 @@
             "references/workflows.md#destructive-confirmation"
           ],
           "optionalPeers": []
+        },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "ConfirmDialog",
+            "useOverlayVisibility"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
         }
       ]
     },
@@ -15213,33 +15703,63 @@
         "defaultProductVariantsManagerStrings",
         "defaultProductVariantsTableStrings"
       ],
+      "deprecated": {
+        "ProductContractOverview": "An internal region of `ProductOverview`, which renders it from its `contract` prop (still typed `ProductContractOverviewProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductContractOverviewProps": "Part of deprecated ProductContractOverview. An internal region of `ProductOverview`, which renders it from its `contract` prop (still typed `ProductContractOverviewProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductContractOverviewStrings": "Part of deprecated ProductContractOverview. An internal region of `ProductOverview`, which renders it from its `contract` prop (still typed `ProductContractOverviewProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductDetailsCard": "An internal region of `ProductOverview`, which renders it from its `details` prop (still typed `ProductDetailsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductDetailsCardProps": "Part of deprecated ProductDetailsCard. An internal region of `ProductOverview`, which renders it from its `details` prop (still typed `ProductDetailsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductDetailsCardStrings": "Part of deprecated ProductDetailsCard. An internal region of `ProductOverview`, which renders it from its `details` prop (still typed `ProductDetailsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductOperationsCard": "An internal region of `ProductOverview`, which renders it from its `operations` prop (still typed `ProductOperationsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductOperationsCardProps": "Part of deprecated ProductOperationsCard. An internal region of `ProductOverview`, which renders it from its `operations` prop (still typed `ProductOperationsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductOperationsCardStrings": "Part of deprecated ProductOperationsCard. An internal region of `ProductOverview`, which renders it from its `operations` prop (still typed `ProductOperationsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductOptionActionMenu": "An internal part of `ProductOptionsSummary` (and so of `ProductOverview`), which renders it for every option. Replace it there with `renderOptionActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.",
+        "ProductOptionActionMenuProps": "Part of deprecated ProductOptionActionMenu. An internal part of `ProductOptionsSummary` (and so of `ProductOverview`), which renders it for every option. Replace it there with `renderOptionActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.",
+        "ProductOptionActionMenuStrings": "Part of deprecated ProductOptionActionMenu. An internal part of `ProductOptionsSummary` (and so of `ProductOverview`), which renders it for every option. Replace it there with `renderOptionActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.",
+        "ProductOptionsSummary": "An internal region of `ProductOverview`, which renders it from its `options` prop (still typed `ProductOptionsSummaryProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductOptionsSummaryProps": "Part of deprecated ProductOptionsSummary. An internal region of `ProductOverview`, which renders it from its `options` prop (still typed `ProductOptionsSummaryProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductOptionsSummaryStrings": "Part of deprecated ProductOptionsSummary. An internal region of `ProductOverview`, which renders it from its `options` prop (still typed `ProductOptionsSummaryProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductPoliciesCard": "An internal region of `ProductOverview`, which renders it from its `policies` prop (still typed `ProductPoliciesCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductPoliciesCardProps": "Part of deprecated ProductPoliciesCard. An internal region of `ProductOverview`, which renders it from its `policies` prop (still typed `ProductPoliciesCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductPoliciesCardStrings": "Part of deprecated ProductPoliciesCard. An internal region of `ProductOverview`, which renders it from its `policies` prop (still typed `ProductPoliciesCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductQuotePreviewCard": "An internal region of `ProductOverview`, which renders it from its `quote` prop (still typed `ProductQuotePreviewCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductQuotePreviewCardProps": "Part of deprecated ProductQuotePreviewCard. An internal region of `ProductOverview`, which renders it from its `quote` prop (still typed `ProductQuotePreviewCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductQuotePreviewCardStrings": "Part of deprecated ProductQuotePreviewCard. An internal region of `ProductOverview`, which renders it from its `quote` prop (still typed `ProductQuotePreviewCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductReadinessCard": "An internal region of `ProductOverview`, which renders it from its `readiness` prop (still typed `ProductReadinessCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductReadinessCardProps": "Part of deprecated ProductReadinessCard. An internal region of `ProductOverview`, which renders it from its `readiness` prop (still typed `ProductReadinessCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductReadinessCardStrings": "Part of deprecated ProductReadinessCard. An internal region of `ProductOverview`, which renders it from its `readiness` prop (still typed `ProductReadinessCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductStructureCard": "An internal region of `ProductOverview`, which renders it from its `structure` prop (still typed `ProductStructureCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductStructureCardProps": "Part of deprecated ProductStructureCard. An internal region of `ProductOverview`, which renders it from its `structure` prop (still typed `ProductStructureCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductStructureCardStrings": "Part of deprecated ProductStructureCard. An internal region of `ProductOverview`, which renders it from its `structure` prop (still typed `ProductStructureCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.",
+        "ProductVariantActionMenu": "An internal part of the variant tables and `ProductVariantDetails`, which render it for every variant. Replace it there with `renderVariantActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.",
+        "ProductVariantActionMenuProps": "Part of deprecated ProductVariantActionMenu. An internal part of the variant tables and `ProductVariantDetails`, which render it for every variant. Replace it there with `renderVariantActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.",
+        "ProductVariantActionMenuStrings": "Part of deprecated ProductVariantActionMenu. An internal part of the variant tables and `ProductVariantDetails`, which render it for every variant. Replace it there with `renderVariantActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility."
+      },
       "optionalPeers": [
         "@tanstack/react-table",
         "react-hook-form"
       ],
       "layer": "features",
-      "responsibility": "Features family: Actions; Main column; Product overview; Products; Support rail; Variant details; Variant management.",
+      "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 Actions in an admin interface.",
-        "Use Main column in an admin interface.",
         "Use Product overview in an admin interface.",
-        "Use Support rail in an admin interface.",
         "Use Variant details in an admin interface.",
         "Use Variant management in an admin interface."
       ],
       "tags": [
-        "actions",
         "commerce",
         "features",
-        "main-column",
         "product-overview",
         "products",
-        "support-rail",
         "variant-details",
         "variant-management"
       ],
-      "aliases": [],
+      "aliases": [
+        "features/products/actions",
+        "features/products/main-column",
+        "features/products/support-rail"
+      ],
       "sections": [
         "Features"
       ],
@@ -15285,95 +15805,6 @@
             "themelia-react-ui/features/resource"
           ]
         },
-        {
-          "title": "Actions",
-          "description": "Product option and variant action menus that can be mounted inside tables, cards, rows, or fully custom consumer layouts.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
-          "jobs": [
-            "Use Actions in an admin interface."
-          ],
-          "tags": [
-            "features",
-            "commerce",
-            "products",
-            "actions"
-          ],
-          "aliases": [],
-          "section": "Features",
-          "browse": {
-            "category": "workflows-features",
-            "group": "Products",
-            "domain": "Commerce",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Standalone menus",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "ProductOptionActionMenu",
-                "ProductVariantActionMenu"
-              ]
-            }
-          ],
-          "alternatives": []
-        },
-        {
-          "title": "Main column",
-          "description": "The primary product editor cards — identity and metadata, commercial contract, and the option summary.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
-          "jobs": [
-            "Use Main column in an admin interface."
-          ],
-          "tags": [
-            "features",
-            "commerce",
-            "products",
-            "main-column"
-          ],
-          "aliases": [],
-          "section": "Features",
-          "browse": {
-            "category": "workflows-features",
-            "group": "Products",
-            "domain": "Commerce",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Overview",
-              "symbols": []
-            },
-            {
-              "title": "Product details",
-              "symbols": []
-            },
-            {
-              "title": "Commercial contract",
-              "symbols": []
-            },
-            {
-              "title": "Option summary",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "ProductDetailsCard",
-                "ProductContractOverview",
-                "ProductOptionsSummary"
-              ]
-            }
-          ],
-          "alternatives": []
-        },
         {
           "title": "Product overview",
           "description": "The composition root that arranges the product editor's main column and support rail from one set of props.",
@@ -15389,7 +15820,11 @@
             "products",
             "product-overview"
           ],
-          "aliases": [],
+          "aliases": [
+            "features/products/main-column",
+            "features/products/support-rail",
+            "features/products/actions"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -15415,47 +15850,6 @@
           ],
           "alternatives": []
         },
-        {
-          "title": "Support rail",
-          "description": "Secondary product cards for readiness, structure, operations, quote preview, and policies.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
-          "jobs": [
-            "Use Support rail in an admin interface."
-          ],
-          "tags": [
-            "features",
-            "commerce",
-            "products",
-            "support-rail"
-          ],
-          "aliases": [],
-          "section": "Features",
-          "browse": {
-            "category": "workflows-features",
-            "group": "Products",
-            "domain": "Commerce",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Rail cards",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "ProductReadinessCard",
-                "ProductStructureCard",
-                "ProductOperationsCard",
-                "ProductQuotePreviewCard",
-                "ProductPoliciesCard"
-              ]
-            }
-          ],
-          "alternatives": []
-        },
         {
           "title": "Variant details",
           "description": "Variant detail and editor surfaces for product-specific edit flows. Persistence, validation, and routing stay callback-owned by the consumer.",
@@ -15634,6 +16028,7 @@
         "ResourceEmptyState",
         "ResourceEmptyStateProps",
         "ResourceHeader",
+        "ResourceHeaderCommandProps",
         "ResourceHeaderProps",
         "ResourceIndexShell",
         "ResourceIndexShellProps",
@@ -15808,13 +16203,17 @@
         "RichTextCaretContext",
         "RichTextEditor",
         "RichTextEditorHandle",
+        "RichTextEditorImages",
         "RichTextEditorProps",
         "RichTextEditorStrings",
         "RichTextEditorToolbar",
         "RichTextEditorToolbarItem",
         "RichTextEditorToolbarProps",
+        "RichTextImage",
+        "RichTextImageUploadContext",
         "ToolbarButtonConfig",
-        "defaultRichTextEditorStrings"
+        "defaultRichTextEditorStrings",
+        "useRichTextImages"
       ],
       "optionalPeers": [
         "@tiptap/react",
@@ -15934,7 +16333,9 @@
         "inputs",
         "schema-form"
       ],
-      "aliases": [],
+      "aliases": [
+        "features/sync"
+      ],
       "sections": [
         "Features"
       ],
@@ -15953,7 +16354,9 @@
             "inputs",
             "schema-form"
           ],
-          "aliases": [],
+          "aliases": [
+            "features/sync"
+          ],
           "section": "Features",
           "browse": {
             "category": "forms-inputs",
@@ -16059,65 +16462,24 @@
         "SyncRangeDialogFormValues",
         "defaultSyncRangeDialogFormStrings"
       ],
+      "deprecated": {
+        "SyncRangeDialogForm": "Use `SchemaForm` from `themelia-react-ui/features/schema-form` with a `radio-cards` field for the window and a `checkbox-cards` field for the options; map its values to your payload in `onSubmit`.",
+        "SyncRangeDialogFormProps": "Part of deprecated SyncRangeDialogForm. Use `SchemaForm` from `themelia-react-ui/features/schema-form` with a `radio-cards` field for the window and a `checkbox-cards` field for the options; map its values to your payload in `onSubmit`.",
+        "SyncRangeDialogFormStrings": "Part of deprecated SyncRangeDialogForm. Use `SchemaForm` from `themelia-react-ui/features/schema-form` with a `radio-cards` field for the window and a `checkbox-cards` field for the options; map its values to your payload in `onSubmit`.",
+        "SyncRangeDialogFormSubmit": "Part of deprecated SyncRangeDialogForm. Use `SchemaForm` from `themelia-react-ui/features/schema-form` with a `radio-cards` field for the window and a `checkbox-cards` field for the options; map its values to your payload in `onSubmit`.",
+        "SyncRangeDialogFormValues": "Part of deprecated SyncRangeDialogForm. Use `SchemaForm` from `themelia-react-ui/features/schema-form` with a `radio-cards` field for the window and a `checkbox-cards` field for the options; map its values to your payload in `onSubmit`.",
+        "defaultSyncRangeDialogFormStrings": "Supply labels and descriptions on the `SchemaForm` field definitions."
+      },
       "optionalPeers": [
         "react-hook-form"
       ],
       "layer": "features",
-      "responsibility": "Features family: Sync form.",
-      "jobs": [
-        "Use Sync form in an admin interface."
-      ],
-      "tags": [
-        "features",
-        "operations",
-        "sync"
-      ],
+      "responsibility": "Deprecated compatibility family: SyncRangeDialogForm, one application's sync-window form. New code uses SchemaForm from features/schema-form with radio-cards and checkbox-cards fields.",
+      "jobs": [],
+      "tags": [],
       "aliases": [],
-      "sections": [
-        "Features"
-      ],
-      "guidance": [
-        {
-          "title": "Sync form",
-          "description": "Reusable sync-range form for integration repair flows. The feature owns form state and validation wiring; consumers own dialog placement, submission, errors, and telemetry.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
-          "jobs": [
-            "Use Sync form in an admin interface."
-          ],
-          "tags": [
-            "features",
-            "operations",
-            "sync"
-          ],
-          "aliases": [],
-          "section": "Features",
-          "browse": {
-            "category": "feedback-status",
-            "group": "Sync",
-            "domain": "Workflow infrastructure",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Contract",
-              "symbols": []
-            },
-            {
-              "title": "Examples",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "SyncRangeDialogForm"
-              ]
-            }
-          ],
-          "alternatives": []
-        }
-      ],
+      "sections": [],
+      "guidance": [],
       "recipes": []
     },
     {
@@ -16636,8 +16998,10 @@
         "PageActionsProps",
         "PageActionsStrings",
         "PageHeader",
+        "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderSlots",
+        "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
         "PageViewport",
@@ -16759,6 +17123,14 @@
         "useLayoutLinkRenderer",
         "useLayoutSidebar"
       ],
+      "deprecated": {
+        "PageAction": "Use PageHeaderAction with `primaryAction` and `secondaryActions`.",
+        "PageActionContext": "Part of deprecated PageAction. Use PageHeaderAction with `primaryAction` and `secondaryActions`.",
+        "PageActions": "Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row.",
+        "PageActionsDisplay": "Part of deprecated PageActions. Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row.",
+        "PageActionsProps": "Part of deprecated PageActions. Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row.",
+        "PageActionsStrings": "Part of deprecated PageActions. Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row."
+      },
       "optionalPeers": [],
       "layer": "layout",
       "responsibility": "Framework-neutral layout aggregate and shared layout types; exact layout family subpaths keep selection focused.",
@@ -17104,8 +17476,11 @@
         "website"
       ],
       "aliases": [
+        "main aside card gaps",
+        "main aside layout",
         "public website",
         "service overview",
+        "two column layout",
         "website landing page"
       ],
       "sections": [
@@ -17142,7 +17517,10 @@
           "aliases": [
             "website landing page",
             "public website",
-            "service overview"
+            "service overview",
+            "main aside card gaps",
+            "main aside layout",
+            "two column layout"
           ],
           "section": "Layouts",
           "browse": {
@@ -17186,6 +17564,21 @@
         }
       ],
       "recipes": [
+        {
+          "file": "examples/layout-blocks.tsx",
+          "exports": [
+            "LayoutBlocks"
+          ],
+          "symbols": [
+            "TwoColumnLayout"
+          ],
+          "references": [
+            "references/composition.md#horizontal-rows",
+            "references/composition.md#main-and-aside-card-gaps",
+            "references/composition.md#structure-and-spacing"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/website.tsx",
           "exports": [
@@ -17618,17 +18011,27 @@
         "PageActionsProps",
         "PageActionsStrings",
         "PageHeader",
+        "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderSlots",
+        "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
         "defaultPageActionsStrings"
       ],
+      "deprecated": {
+        "PageAction": "Use PageHeaderAction with `primaryAction` and `secondaryActions`.",
+        "PageActionContext": "Part of deprecated PageAction. Use PageHeaderAction with `primaryAction` and `secondaryActions`.",
+        "PageActions": "Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row.",
+        "PageActionsDisplay": "Part of deprecated PageActions. Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row.",
+        "PageActionsProps": "Part of deprecated PageActions. Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row.",
+        "PageActionsStrings": "Part of deprecated PageActions. Pass page commands as `primaryAction` and `secondaryActions`; use ActionButtons for a toolbar row."
+      },
       "optionalPeers": [],
       "layer": "layout",
       "responsibility": "Layout family: Page shell; Resource detail.",
       "jobs": [
-        "A page needs shell-level title, back/link rendering, actions, content, and page composition slots.",
+        "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots.",
         "Build a responsive resource detail page with primary facts, related context, and actions."
       ],
       "tags": [
@@ -17642,12 +18045,16 @@
       ],
       "aliases": [
         "centered detail page",
+        "more actions menu",
         "narrow resource page",
+        "page commands",
         "page gutters",
         "page header",
         "page padding",
+        "primary action",
         "route heading",
         "scope navigation",
+        "secondary actions",
         "single record page",
         "single resource page"
       ],
@@ -17698,27 +18105,27 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/resource",
             "themelia-react-ui/layout/page"
           ]
         },
         {
           "title": "Page shell",
-          "description": "A page needs shell-level title, back/link rendering, actions, content, and page composition slots.",
+          "description": "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots.",
           "chooseWhen": [
-            "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
+            "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots."
           ],
           "avoidWhen": [
             "An existing shell needs only a visual title/description/badge block."
           ],
           "appOwned": [
             "route title and contextual lead",
-            "primary command importance",
+            "which command is primary and which are destructive",
             "navigation callbacks and permissioned actions"
           ],
           "jobs": [
-            "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
+            "A page needs shell-level title, back/link rendering, role-based primary/secondary commands, content, and page composition slots."
           ],
           "tags": [
             "layout",
@@ -17734,7 +18141,11 @@
             "narrow resource page",
             "centered detail page",
             "single resource page",
-            "single record page"
+            "single record page",
+            "primary action",
+            "secondary actions",
+            "page commands",
+            "more actions menu"
           ],
           "section": "Layouts",
           "browse": {
@@ -17789,7 +18200,8 @@
             "AccountDetailPage"
           ],
           "symbols": [
-            "Page"
+            "Page",
+            "PageHeaderAction"
           ],
           "references": [
             "references/analytics.md#usage-facts-and-verification",
@@ -18221,6 +18633,8 @@
         "Link",
         "LinkProps",
         "Money",
+        "MoneyFormatter",
+        "MoneyFormatterOptions",
         "MoneyLayout",
         "MoneyProps",
         "MoneySecondaryEmphasis",
@@ -18253,7 +18667,8 @@
         "formatFileSize",
         "formatInitials",
         "formatName",
-        "parseDateInput"
+        "parseDateInput",
+        "useMoneyFormatter"
       ],
       "optionalPeers": [],
       "layer": "foundations",
@@ -18335,7 +18750,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/table",
             "themelia-react-ui/typography"
           ]
@@ -18950,6 +19365,7 @@
         "toCommandAction",
         "toMenuAction",
         "toPageAction",
+        "toPageHeaderAction",
         "toTableAction",
         "useAction",
         "useActionScope",
@@ -18960,6 +19376,9 @@
         "useLocalAction",
         "useRegisterActions"
       ],
+      "deprecated": {
+        "toPageAction": "Use toPageHeaderAction for a header's `primaryAction` and `secondaryActions`."
+      },
       "optionalPeers": [],
       "layer": "foundations",
       "responsibility": "Foundational roles: Runtime actions.",
@@ -19161,7 +19580,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/primitives"
           ]
         }
@@ -19221,6 +19640,22 @@
           ],
           "optionalPeers": []
         },
+        {
+          "file": "examples/detail.tsx",
+          "exports": [
+            "AccountDetailPage"
+          ],
+          "symbols": [
+            "Text"
+          ],
+          "references": [
+            "references/analytics.md#usage-facts-and-verification",
+            "references/composition.md#application-layouts",
+            "references/workflows.md#detail-and-framing",
+            "references/workflows.md#single-resource-page"
+          ],
+          "optionalPeers": []
+        },
         {
           "file": "examples/edit.tsx",
           "exports": [
@@ -19316,12 +19751,15 @@
       "import": "themelia-react-ui/typography/rich-text",
       "declaration": "dist/components/typography/rich-text/index.d.ts",
       "symbols": [
+        "RenderRichTextImage",
         "RichText",
+        "RichTextImageAttributes",
+        "RichTextImageRendering",
         "RichTextProps"
       ],
       "optionalPeers": [],
       "layer": "foundations",
-      "responsibility": "Sanitized rich HTML display with scoped reading rhythm; editing belongs to the rich-text-editor feature.",
+      "responsibility": "Sanitized rich HTML display with scoped reading rhythm and opt-in images drawn by a consumer renderImage; editing belongs to the rich-text-editor feature.",
       "jobs": [
         "Display rich HTML and converted Markdown content"
       ],
@@ -19342,7 +19780,7 @@
       "guidance": [
         {
           "title": "Rich HTML display",
-          "description": "Sanitized rich HTML display with scoped reading rhythm; editing belongs to the rich-text-editor feature.",
+          "description": "Sanitized rich HTML display with scoped reading rhythm and opt-in images drawn by a consumer renderImage; editing belongs to the rich-text-editor feature.",
           "section": "Foundations",
           "chooseWhen": [
             "Display sanitized HTML, including application-converted Markdown."
@@ -19415,6 +19853,8 @@
         "MoneyDisplayMode",
         "MoneyDualLayout",
         "MoneyFormatMode",
+        "OverlayAlign",
+        "OverlayConfigSlice",
         "ResolvedUIConfig",
         "SpinnerConfigSlice",
         "TableSize",
@@ -19440,6 +19880,7 @@
         "useFormattingConfig",
         "useItemConfig",
         "useMoneyConfig",
+        "useOverlayConfig",
         "useSpinnerConfig",
         "useToastConfig",
         "useTypographyConfig"