themelia-react-ui 2.0.0 → 2.0.2

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

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "stylesheets": [
     "themelia-react-ui/style.css",
     "themelia-react-ui/theme.css",
@@ -12,7 +12,7 @@
   "peers": [
     {
       "name": "@base-ui/react",
-      "range": "^1.8.0",
+      "range": "1.8.0-kpo.2",
       "optional": false
     },
     {
@@ -198,6 +198,8 @@
         "MoneyDisplayMode",
         "MoneyDualLayout",
         "MoneyFormatMode",
+        "OverlayAlign",
+        "OverlayConfigSlice",
         "ResolvedUIConfig",
         "SEMANTIC_TONES",
         "SemanticTone",
@@ -229,6 +231,7 @@
         "useFormattingConfig",
         "useItemConfig",
         "useMoneyConfig",
+        "useOverlayConfig",
         "useSpinnerConfig",
         "useStrings",
         "useToastConfig",
@@ -363,6 +366,7 @@
         "ActionButtonsProps",
         "ActionMenu",
         "ActionMenuAction",
+        "ActionMenuContext",
         "ActionMenuIcon",
         "ActionMenuLinkRenderProps",
         "ActionMenuProps",
@@ -914,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",
@@ -2342,15 +2450,19 @@
         "ComboboxArrow",
         "ComboboxBackdrop",
         "ComboboxChip",
+        "ComboboxChipProps",
         "ComboboxChips",
         "ComboboxChipsInput",
         "ComboboxClear",
+        "ComboboxClearProps",
         "ComboboxCollection",
+        "ComboboxControlStrings",
         "ComboboxEmpty",
         "ComboboxGroup",
         "ComboboxGroupLabel",
         "ComboboxInput",
         "ComboboxInputTrigger",
+        "ComboboxInputTriggerProps",
         "ComboboxItem",
         "ComboboxItemIndicator",
         "ComboboxList",
@@ -2362,6 +2474,7 @@
         "ComboboxStatus",
         "ComboboxTrigger",
         "ComboboxValue",
+        "defaultComboboxControlStrings",
         "useComboboxFilter"
       ],
       "optionalPeers": [],
@@ -3068,7 +3181,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/primitives"
           ]
         },
@@ -3830,7 +3943,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"
           ]
         },
@@ -4027,7 +4140,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/base/metadata-list"
           ]
         },
         {
@@ -4857,8 +4970,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"
           ]
         }
       ],
@@ -4948,6 +5061,175 @@
       ],
       "recipes": []
     },
+    {
+      "import": "themelia-react-ui/base/metadata-list",
+      "declaration": "dist/components/base/metadata-list/index.d.ts",
+      "symbols": [
+        "MetadataDensity",
+        "MetadataInlineListItem",
+        "MetadataLayout",
+        "MetadataList",
+        "MetadataListItem",
+        "MetadataListProps",
+        "MetadataListStrings",
+        "MetadataValue",
+        "MetadataValueDescriptor",
+        "MetadataValueKind",
+        "MetadataValueProps",
+        "defaultMetadataListStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "base",
+      "responsibility": "Base family: Metadata list.",
+      "jobs": [
+        "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
+      ],
+      "tags": [
+        "base",
+        "display",
+        "metadata-list"
+      ],
+      "aliases": [
+        "blocks/data-display/metadata-list",
+        "blocks/metadata-list",
+        "contact details",
+        "details",
+        "fact list",
+        "key value",
+        "read-only facts"
+      ],
+      "sections": [
+        "Base components"
+      ],
+      "guidance": [
+        {
+          "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": [
+            "base",
+            "display",
+            "metadata-list"
+          ],
+          "aliases": [
+            "blocks/data-display/metadata-list",
+            "blocks/metadata-list",
+            "fact list",
+            "read-only facts",
+            "contact details",
+            "key value",
+            "details"
+          ],
+          "section": "Base components",
+          "browse": {
+            "category": "data-display",
+            "group": "Metadata list",
+            "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"
+          ]
+        }
+      ],
+      "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",
@@ -4984,6 +5266,9 @@
         "OverflowTabBarProps",
         "OverflowTabBarStrings",
         "OverflowTabItem",
+        "PageHeaderAction",
+        "PageHeaderLinkRenderProps",
+        "PageHeaderLinkRenderer",
         "PageHeading",
         "PageHeadingBadge",
         "PageHeadingProps",
@@ -5778,7 +6063,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,72 +6356,12 @@
       },
       "optionalPeers": [],
       "layer": "base",
-      "responsibility": "Base family: Sheet.",
-      "jobs": [
-        "Maintaining code that still imports the deprecated Sheet parts."
-      ],
-      "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": "Maintaining code that still imports the deprecated Sheet parts.",
-          "chooseWhen": [
-            "Maintaining code that still imports the deprecated Sheet parts."
-          ],
-          "avoidWhen": [
-            "Any new dialog, drawer or side panel: use ActionDialog, ConfirmDialog or ActionDrawer from features/overlays."
-          ],
-          "appOwned": [],
-          "jobs": [
-            "Maintaining code that still imports the deprecated Sheet parts."
-          ],
-          "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": []
     },
     {
@@ -6834,7 +7059,7 @@
             "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"
           ]
         }
@@ -7939,9 +8164,11 @@
         "SliderStrings",
         "TagsInput",
         "TagsInputProps",
+        "TagsInputStrings",
         "defaultColorInputStrings",
         "defaultPhoneInputStrings",
-        "defaultSliderStrings"
+        "defaultSliderStrings",
+        "defaultTagsInputStrings"
       ],
       "optionalPeers": [
         "react-day-picker"
@@ -8306,7 +8533,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/overlays"
           ]
         },
@@ -9708,6 +9935,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/chart",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/blocks/data-display"
           ]
         },
@@ -10086,6 +10314,7 @@
             }
           ],
           "alternatives": [
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/blocks/analytics",
             "themelia-react-ui/blocks/data-display"
           ]
@@ -10390,22 +10619,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",
@@ -10439,20 +10678,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",
@@ -10461,8 +10722,10 @@
         "ReceiptLineItem",
         "ReceiptProps",
         "RefundStage",
+        "RefundStatus",
         "RefundStatusCard",
         "RefundStatusCardProps",
+        "RefundStatusProps",
         "RefundStatusStrings",
         "SeoListingCard",
         "SeoListingCardProps",
@@ -10482,11 +10745,17 @@
         "SubscriptionSummaryCard",
         "SubscriptionSummaryCardProps",
         "SubscriptionSummaryStrings",
+        "SummaryLine",
+        "SummaryPanel",
+        "SummaryPanelProps",
         "TaxBreakdownCard",
         "TaxBreakdownCardProps",
         "TaxBreakdownStrings",
         "TaxLineItem",
         "TrackingStep",
+        "Transaction",
+        "TransactionKind",
+        "TransactionStatus",
         "UpcomingBookingRow",
         "UpcomingBookingRowProps",
         "VendorProfileCard",
@@ -10504,10 +10773,16 @@
         "defaultCartSummaryStrings",
         "defaultCouponInputStrings",
         "defaultDiscountStackStrings",
+        "defaultFulfillmentGroupStrings",
         "defaultInventoryLevelStrings",
         "defaultInventorySectionStrings",
         "defaultLoyaltyPointsStrings",
+        "defaultOrderCustomerStrings",
+        "defaultOrderHeaderStrings",
+        "defaultOrderLineItemStrings",
         "defaultOrderStatusStrings",
+        "defaultOrderSummaryStrings",
+        "defaultOrderTransactionsStrings",
         "defaultPaymentMethodStrings",
         "defaultRefundStatusStrings",
         "defaultSeoListingCardStrings",
@@ -10521,12 +10796,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.",
@@ -10554,27 +10837,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",
@@ -10605,6 +10898,7 @@
         "blocks/commerce-upcoming-booking",
         "blocks/commerce-vendor-profile",
         "blocks/commerce-voucher-entry",
+        "blocks/commerce/amount-row",
         "blocks/commerce/invoice-table"
       ],
       "sections": [
@@ -10648,8 +10942,8 @@
             }
           ],
           "alternatives": [
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/data-display",
             "themelia-react-ui/features/products"
           ]
         },
@@ -11669,6 +11963,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": []
@@ -11845,13 +12430,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."
@@ -11863,22 +12459,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": [
@@ -11977,8 +12568,8 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/analytics"
           ]
         },
         {
@@ -12096,87 +12687,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"
           ]
         },
         {
@@ -12234,7 +12746,7 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/item",
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/resource-assignment"
           ]
         }
@@ -12269,51 +12781,6 @@
           "optionalPeers": [
             "recharts"
           ]
-        },
-        {
-          "file": "examples/detail.tsx",
-          "exports": [
-            "AccountDetail"
-          ],
-          "symbols": [
-            "MetadataList"
-          ],
-          "references": [
-            "references/analytics.md#usage-facts-and-verification",
-            "references/composition.md#application-layouts",
-            "references/workflows.md#detail-and-framing",
-            "references/workflows.md#single-resource-page"
-          ],
-          "optionalPeers": []
-        },
-        {
-          "file": "examples/detail.tsx",
-          "exports": [
-            "AccountDetailPage"
-          ],
-          "symbols": [
-            "MetadataList"
-          ],
-          "references": [
-            "references/analytics.md#usage-facts-and-verification",
-            "references/composition.md#application-layouts",
-            "references/workflows.md#detail-and-framing",
-            "references/workflows.md#single-resource-page"
-          ],
-          "optionalPeers": []
-        },
-        {
-          "file": "examples/receipt.tsx",
-          "exports": [
-            "PurchaseReceipt"
-          ],
-          "symbols": [
-            "MetadataList"
-          ],
-          "references": [
-            "references/composition.md#receipts"
-          ],
-          "optionalPeers": []
         }
       ]
     },
@@ -12845,7 +13312,8 @@
       ],
       "optionalPeers": [
         "@tiptap/react",
-        "@tiptap/starter-kit"
+        "@tiptap/starter-kit",
+        "react-hook-form"
       ],
       "layer": "features",
       "responsibility": "Features family: Activity and timeline; Activity log.",
@@ -13024,36 +13492,145 @@
       "jobs": [
         "Use AI chat in an admin interface."
       ],
-      "tags": [
-        "ai",
-        "ai-chat",
-        "features"
+      "tags": [
+        "ai",
+        "ai-chat",
+        "features"
+      ],
+      "aliases": [],
+      "sections": [
+        "Features"
+      ],
+      "guidance": [
+        {
+          "title": "AI chat",
+          "description": "Callback-driven AI conversation shell with streaming, queue, attachment, suggestion, empty, and headless composition seams.",
+          "chooseWhen": [],
+          "avoidWhen": [],
+          "appOwned": [],
+          "jobs": [
+            "Use AI chat in an admin interface."
+          ],
+          "tags": [
+            "features",
+            "ai",
+            "ai-chat"
+          ],
+          "aliases": [],
+          "section": "Features",
+          "browse": {
+            "category": "workflows-features",
+            "group": "AI chat",
+            "domain": "AI",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Recommended composition",
+              "symbols": []
+            },
+            {
+              "title": "Meaningful states",
+              "symbols": []
+            },
+            {
+              "title": "Headless composition",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "AiChat",
+                "AiChatConversation",
+                "AiChatMessage",
+                "AiChatPromptInput",
+                "AiChatEmptyState",
+                "AiChatQueue",
+                "AiChatSuggestionsRow",
+                "AiChatAttachmentsStrip"
+              ]
+            }
+          ],
+          "alternatives": []
+        }
+      ],
+      "recipes": []
+    },
+    {
+      "import": "themelia-react-ui/features/appointment-calendar",
+      "declaration": "dist/components/features/appointment-calendar/index.d.ts",
+      "symbols": [
+        "Appointment",
+        "AppointmentCalendar",
+        "AppointmentCalendarProps",
+        "AppointmentCalendarStrings",
+        "AppointmentCalendarView",
+        "AppointmentCategory",
+        "AppointmentCategoryColor",
+        "AppointmentConflict",
+        "AppointmentDateRange",
+        "AppointmentPerson",
+        "AppointmentRenderContext",
+        "AppointmentStatus",
+        "appointmentsOn",
+        "defaultAppointmentCalendarStrings",
+        "filterAppointments",
+        "findConflicts"
+      ],
+      "optionalPeers": [],
+      "layer": "features",
+      "responsibility": "Features family: Appointment calendar.",
+      "jobs": [
+        "Bookings need a month beside a day or week agenda with category and staff filters and double-booking alerts."
+      ],
+      "tags": [
+        "appointment-calendar",
+        "features",
+        "navigation & data"
+      ],
+      "aliases": [
+        "appointments",
+        "booking calendar",
+        "salon bookings",
+        "scheduler"
       ],
-      "aliases": [],
       "sections": [
         "Features"
       ],
       "guidance": [
         {
-          "title": "AI chat",
-          "description": "Callback-driven AI conversation shell with streaming, queue, attachment, suggestion, empty, and headless composition seams.",
-          "chooseWhen": [],
-          "avoidWhen": [],
+          "title": "Appointment calendar",
+          "description": "Bookings need a month beside a day or week agenda with category and staff filters and double-booking alerts.",
+          "chooseWhen": [
+            "Bookings need a month beside a day or week agenda with category and staff filters and double-booking alerts."
+          ],
+          "avoidWhen": [
+            "Events need month-grid browsing with in-cell event chips; use the event calendar."
+          ],
           "appOwned": [],
           "jobs": [
-            "Use AI chat in an admin interface."
+            "Bookings need a month beside a day or week agenda with category and staff filters and double-booking alerts."
           ],
           "tags": [
             "features",
-            "ai",
-            "ai-chat"
+            "navigation & data",
+            "appointment-calendar"
+          ],
+          "aliases": [
+            "booking calendar",
+            "appointments",
+            "scheduler",
+            "salon bookings"
           ],
-          "aliases": [],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
-            "group": "AI chat",
-            "domain": "AI",
+            "group": "Appointment calendar",
+            "domain": "Planning & places",
             "collection": ""
           },
           "sections": [
@@ -13062,32 +13639,20 @@
               "symbols": []
             },
             {
-              "title": "Recommended composition",
-              "symbols": []
-            },
-            {
-              "title": "Meaningful states",
-              "symbols": []
-            },
-            {
-              "title": "Headless composition",
+              "title": "Examples",
               "symbols": []
             },
             {
               "title": "API",
               "symbols": [
-                "AiChat",
-                "AiChatConversation",
-                "AiChatMessage",
-                "AiChatPromptInput",
-                "AiChatEmptyState",
-                "AiChatQueue",
-                "AiChatSuggestionsRow",
-                "AiChatAttachmentsStrip"
+                "AppointmentCalendar"
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/date-pickers",
+            "themelia-react-ui/features/event-calendar"
+          ]
         }
       ],
       "recipes": []
@@ -13471,7 +14036,8 @@
       ],
       "optionalPeers": [
         "@tiptap/react",
-        "@tiptap/starter-kit"
+        "@tiptap/starter-kit",
+        "react-hook-form"
       ],
       "layer": "features",
       "responsibility": "Features family: Comments.",
@@ -14480,7 +15046,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": [],
@@ -14703,6 +15269,7 @@
       "symbols": [
         "MediaLibrary",
         "MediaLibraryAccessors",
+        "MediaLibraryBulkActionContext",
         "MediaLibraryCard",
         "MediaLibraryCardProps",
         "MediaLibraryCollectionOption",
@@ -14997,6 +15564,7 @@
         "ConfirmDialogProps",
         "DrawerDirection",
         "OverlayActionProps",
+        "OverlayAlign",
         "OverlayBaseProps",
         "OverlayButtonStyle",
         "OverlayButtonTone",
@@ -15106,6 +15674,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": []
         }
       ]
     },
@@ -15220,33 +15805,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"
       ],
@@ -15292,95 +15907,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.",
@@ -15396,7 +15922,11 @@
             "products",
             "product-overview"
           ],
-          "aliases": [],
+          "aliases": [
+            "features/products/main-column",
+            "features/products/support-rail",
+            "features/products/actions"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -15422,47 +15952,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.",
@@ -15641,6 +16130,7 @@
         "ResourceEmptyState",
         "ResourceEmptyStateProps",
         "ResourceHeader",
+        "ResourceHeaderCommandProps",
         "ResourceHeaderProps",
         "ResourceIndexShell",
         "ResourceIndexShellProps",
@@ -15814,14 +16304,19 @@
         "FormRichTextEditorProps",
         "RichTextCaretContext",
         "RichTextEditor",
+        "RichTextEditorBodyHeight",
         "RichTextEditorHandle",
+        "RichTextEditorImages",
         "RichTextEditorProps",
         "RichTextEditorStrings",
         "RichTextEditorToolbar",
         "RichTextEditorToolbarItem",
         "RichTextEditorToolbarProps",
+        "RichTextImage",
+        "RichTextImageUploadContext",
         "ToolbarButtonConfig",
-        "defaultRichTextEditorStrings"
+        "defaultRichTextEditorStrings",
+        "useRichTextImages"
       ],
       "optionalPeers": [
         "@tiptap/react",
@@ -15941,7 +16436,9 @@
         "inputs",
         "schema-form"
       ],
-      "aliases": [],
+      "aliases": [
+        "features/sync"
+      ],
       "sections": [
         "Features"
       ],
@@ -15960,7 +16457,9 @@
             "inputs",
             "schema-form"
           ],
-          "aliases": [],
+          "aliases": [
+            "features/sync"
+          ],
           "section": "Features",
           "browse": {
             "category": "forms-inputs",
@@ -16066,65 +16565,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": []
     },
     {
@@ -16646,6 +17104,7 @@
         "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderSlots",
+        "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
         "PageViewport",
@@ -16767,6 +17226,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.",
@@ -17650,10 +18117,19 @@
         "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.",
@@ -17732,7 +18208,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/resource",
             "themelia-react-ui/layout/page"
           ]
@@ -17827,7 +18303,8 @@
             "AccountDetailPage"
           ],
           "symbols": [
-            "Page"
+            "Page",
+            "PageHeaderAction"
           ],
           "references": [
             "references/analytics.md#usage-facts-and-verification",
@@ -18376,7 +18853,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/features/table",
             "themelia-react-ui/typography"
           ]
@@ -18991,6 +19468,7 @@
         "toCommandAction",
         "toMenuAction",
         "toPageAction",
+        "toPageHeaderAction",
         "toTableAction",
         "useAction",
         "useActionScope",
@@ -19001,6 +19479,9 @@
         "useLocalAction",
         "useRegisterActions"
       ],
+      "deprecated": {
+        "toPageAction": "Use toPageHeaderAction for a header's `primaryAction` and `secondaryActions`."
+      },
       "optionalPeers": [],
       "layer": "foundations",
       "responsibility": "Foundational roles: Runtime actions.",
@@ -19202,7 +19683,7 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/data-display",
+            "themelia-react-ui/base/metadata-list",
             "themelia-react-ui/primitives"
           ]
         }
@@ -19262,6 +19743,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": [
@@ -19357,12 +19854,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"
       ],
@@ -19383,7 +19883,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."
@@ -19456,6 +19956,8 @@
         "MoneyDisplayMode",
         "MoneyDualLayout",
         "MoneyFormatMode",
+        "OverlayAlign",
+        "OverlayConfigSlice",
         "ResolvedUIConfig",
         "SpinnerConfigSlice",
         "TableSize",
@@ -19481,6 +19983,7 @@
         "useFormattingConfig",
         "useItemConfig",
         "useMoneyConfig",
+        "useOverlayConfig",
         "useSpinnerConfig",
         "useToastConfig",
         "useTypographyConfig"