themelia-react-ui 2.0.5 → 3.0.0

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

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "2.0.5",
+  "version": "3.0.0",
   "stylesheets": [
     "themelia-react-ui/style.css",
     "themelia-react-ui/theme.css",
@@ -207,6 +207,8 @@
         "StringsProp",
         "TableSize",
         "TextSize",
+        "ThemeBoundary",
+        "ThemeBoundaryProps",
         "ThemeScope",
         "ThemeScopeProps",
         "ToastConfig",
@@ -914,7 +916,15 @@
         "base",
         "foundations"
       ],
-      "aliases": [],
+      "aliases": [
+        "chip",
+        "count badge",
+        "pill",
+        "status label",
+        "status pill",
+        "status tag",
+        "tag"
+      ],
       "sections": [
         "Base components"
       ],
@@ -937,7 +947,15 @@
             "foundations",
             "badge"
           ],
-          "aliases": [],
+          "aliases": [
+            "status pill",
+            "pill",
+            "tag",
+            "chip",
+            "status label",
+            "count badge",
+            "status tag"
+          ],
           "section": "Base components",
           "browse": {
             "category": "data-display",
@@ -1181,7 +1199,8 @@
         "IconPosition",
         "TextButton",
         "TextButtonProps",
-        "buttonGroupVariants"
+        "buttonGroupVariants",
+        "defaultButtonLoadingStrings"
       ],
       "optionalPeers": [],
       "layer": "base",
@@ -1570,26 +1589,9 @@
         "CardStrings",
         "CardSurface",
         "CardTitle",
-        "SmartCard",
-        "SmartCardAction",
-        "SmartCardProps",
-        "SmartCardSkeleton",
-        "SmartCardSkeletonProps",
-        "SmartCardStrings",
-        "SmartCardSurface",
         "defaultCardStrings",
-        "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.",
@@ -1603,10 +1605,14 @@
         "foundations"
       ],
       "aliases": [
-        "base/content-block",
+        "box",
         "card header footer",
         "card padding",
-        "card separators"
+        "card separators",
+        "panel",
+        "section card",
+        "titled section",
+        "widget"
       ],
       "sections": [
         "Base components"
@@ -1666,10 +1672,14 @@
             "cards"
           ],
           "aliases": [
-            "base/content-block",
             "card padding",
             "card header footer",
-            "card separators"
+            "card separators",
+            "panel",
+            "box",
+            "section card",
+            "titled section",
+            "widget"
           ],
           "section": "Base components",
           "browse": {
@@ -2066,8 +2076,10 @@
         "Cascader",
         "CascaderChangeDetails",
         "CascaderMode",
+        "CascaderMultipleProps",
         "CascaderNode",
         "CascaderProps",
+        "CascaderSingleProps",
         "CascaderStrings"
       ],
       "optionalPeers": [],
@@ -2281,7 +2293,8 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics"
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/analytics/charts"
           ]
         }
       ],
@@ -2329,14 +2342,14 @@
       "layer": "base",
       "responsibility": "Base family: Card checkbox group; Card radio group; Checkbox; Choice inputs overview; List radio group; Pill radio group; Select; Switch; Switch card; Toggle field.",
       "jobs": [
+        "CardCheckboxGroup selects multiple values from comparable options whose labels and descriptions benefit from card targets, including a small two-option set.",
+        "SwitchCard gives one boolean setting a label, supporting description and clickable card-shaped target.",
         "The user picks from a known set of options, including a binary on/off.",
-        "Use Card checkbox group in an admin interface.",
         "Use Card radio group in an admin interface.",
         "Use Checkbox in an admin interface.",
         "Use List radio group in an admin interface.",
         "Use Pill radio group in an admin interface.",
         "Use Select in an admin interface.",
-        "Use Switch card in an admin interface.",
         "Use Switch in an admin interface.",
         "Use Toggle field in an admin interface."
       ],
@@ -2403,12 +2416,39 @@
         },
         {
           "title": "Card checkbox group",
-          "description": "Multi-select visual choices rendered as cards.",
-          "chooseWhen": [],
-          "avoidWhen": [],
+          "description": "CardCheckboxGroup selects multiple values from comparable options whose labels and descriptions benefit from card targets, including a small two-option set.",
+          "chooseWhen": [
+            "CardCheckboxGroup selects multiple values from comparable options whose labels and descriptions benefit from card targets, including a small two-option set."
+          ],
+          "avoidWhen": [
+            "A single boolean setting needs SwitchCard, ToggleField, Switch or Checkbox.",
+            "Unrelated flags have independent meaning and lifecycle; give each its own boolean control."
+          ],
           "appOwned": [],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "CardCheckboxGroup",
+                "roles": [
+                  "multiple-choice"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "self"
+              }
+            ],
+            "owns": [
+              "Option-card targets, selection markers and responsive columns",
+              "Selected-values array and controlled/uncontrolled interaction"
+            ],
+            "parentOwns": [
+              "Comparable option records and selected value keys",
+              "onValueChange persistence, validation and domain meaning"
+            ],
+            "embedded": "Choose from the domain value shape and option meaning rather than an arbitrary minimum count. A filtered or permission-limited real choice set can contain one item."
+          },
           "jobs": [
-            "Use Card checkbox group in an admin interface."
+            "CardCheckboxGroup selects multiple values from comparable options whose labels and descriptions benefit from card targets, including a small two-option set."
           ],
           "tags": [
             "base",
@@ -2436,7 +2476,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/choice-inputs"
+          ]
         },
         {
           "title": "Card radio group",
@@ -2662,12 +2704,39 @@
         },
         {
           "title": "Switch card",
-          "description": "Prominent card-shaped boolean setting with supporting copy and icon.",
-          "chooseWhen": [],
-          "avoidWhen": [],
+          "description": "SwitchCard gives one boolean setting a label, supporting description and clickable card-shaped target.",
+          "chooseWhen": [
+            "SwitchCard gives one boolean setting a label, supporting description and clickable card-shaped target."
+          ],
+          "avoidWhen": [
+            "A dense form needs a compact Switch, Checkbox or ToggleField.",
+            "The value is a selection of items from a comparable option set; use a choice group."
+          ],
           "appOwned": [],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "SwitchCard",
+                "roles": [
+                  "boolean-setting"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "self"
+              }
+            ],
+            "owns": [
+              "Framed setting row and accessible control label",
+              "Single-toggle pointer and keyboard interaction"
+            ],
+            "parentOwns": [
+              "Boolean value/defaultValue and onValueChange callback",
+              "Persistence, disabled and validation state"
+            ],
+            "embedded": "Use the boolean value channel directly; no one-element selected-values array or duplicate outer field label is needed."
+          },
           "jobs": [
-            "Use Switch card in an admin interface."
+            "SwitchCard gives one boolean setting a label, supporting description and clickable card-shaped target."
           ],
           "tags": [
             "base",
@@ -2695,7 +2764,9 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/choice-inputs"
+          ]
         },
         {
           "title": "Toggle field",
@@ -3433,18 +3504,13 @@
       "symbols": [
         "BooleanIndicator",
         "BooleanIndicatorProps",
+        "BooleanIndicatorStrings",
         "Collapsible",
         "CollapsibleContent",
         "CollapsibleContentProps",
         "CollapsibleProps",
         "CollapsibleTrigger",
         "CollapsibleTriggerProps",
-        "ContentBlock",
-        "ContentBlockPadding",
-        "ContentBlockProps",
-        "ContentBlockStrings",
-        "ContentBlockSurface",
-        "ContentBlockTitleSize",
         "DateBlock",
         "DateBlockLayout",
         "DateBlockProps",
@@ -3475,17 +3541,9 @@
         "TooltipTriggerProps",
         "VisuallyHidden",
         "VisuallyHiddenProps",
-        "defaultContentBlockStrings",
+        "defaultBooleanIndicatorStrings",
         "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.",
@@ -3952,11 +4010,14 @@
         "EmptyHeaderProps",
         "EmptyMedia",
         "EmptyMediaProps",
+        "EmptyPadding",
         "EmptyProps",
+        "EmptySurface",
         "EmptyTitle",
         "EmptyTitleProps",
         "ErrorState",
         "ErrorStateProps",
+        "ErrorStateStrings",
         "ErrorStateVariant",
         "LoadingState",
         "LoadingStateProps",
@@ -3974,6 +4035,7 @@
         "ProgressTrackProps",
         "ProgressValue",
         "ProgressValueProps",
+        "defaultErrorStateStrings",
         "defaultProgressStrings"
       ],
       "optionalPeers": [],
@@ -4377,13 +4439,13 @@
         "A label, editable control, and hint or error form one accessible field row.",
         "Build an application-owned validated form with consistent field and action presentation.",
         "Editable values need canonical field controls, field chrome, grouped choices, uploads, or form-state recipes.",
+        "FormActionsBar gives a multi-section form a full-width footer with leading status and trailing actions, optionally sticky to its scrolling ancestor.",
         "Related form fields need one titled section with optional actions and footer.",
+        "SubmitStateButton submits a form with a pending state and optional pristine protection through submitting, dirty and disableWhenPristine.",
         "Use Controlled form field in an admin interface.",
         "Use Dirty state banner in an admin interface.",
         "Use Error summary in an admin interface.",
-        "Use Form actions bar in an admin interface.",
-        "Use Operation password form in an admin interface.",
-        "Use Submit state button in an admin interface."
+        "Use Operation password form in an admin interface."
       ],
       "tags": [
         "base",
@@ -4572,12 +4634,46 @@
         },
         {
           "title": "Form actions bar",
-          "description": "Responsive leading and trailing action chrome for form workflows.",
-          "chooseWhen": [],
-          "avoidWhen": [],
+          "description": "FormActionsBar gives a multi-section form a full-width footer with leading status and trailing actions, optionally sticky to its scrolling ancestor.",
+          "chooseWhen": [
+            "FormActionsBar gives a multi-section form a full-width footer with leading status and trailing actions, optionally sticky to its scrolling ancestor."
+          ],
+          "avoidWhen": [
+            "A padded Card or FormSection footer already owns the inset and divider; pass action buttons directly to that footer.",
+            "A compact form needs only a local SubmitStateButton beside its fields."
+          ],
           "appOwned": [],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "FormActionsBar",
+                "roles": [
+                  "form-actions"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "self",
+                "slots": [
+                  "leading",
+                  "trailing",
+                  "children"
+                ]
+              }
+            ],
+            "owns": [
+              "Top divider, opaque background and shared surface inset",
+              "Parent-width action wrapping and optional sticky positioning",
+              "Leading status and trailing actions; trailing takes precedence over children"
+            ],
+            "parentOwns": [
+              "Native form, validation and submission lifecycle",
+              "Action buttons and pending, dirty, cancel and accepted state"
+            ],
+            "page": "Place at the end of the form. In Card padding=\"none\", use flat FormSections with ordinary body insets followed by this edge-to-edge bar.",
+            "embedded": "Card.footerSlot and FormSection.footer already own footer geometry. Put SubmitStateButton or an action row directly in those slots; review custom hosts before nesting another bar."
+          },
           "jobs": [
-            "Use Form actions bar in an admin interface."
+            "FormActionsBar gives a multi-section form a full-width footer with leading status and trailing actions, optionally sticky to its scrolling ancestor."
           ],
           "tags": [
             "base",
@@ -4609,7 +4705,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/cards",
+            "themelia-react-ui/base/forms"
+          ]
         },
         {
           "title": "Form field",
@@ -4694,7 +4793,7 @@
               "Gaps between separate form subjects"
             ],
             "page": "Use ordinary section insets in an unpadded page or layout region.",
-            "embedded": "Inside a padded Card, use surface=\"flat\" padding=\"none\" so the parent supplies the single inset."
+            "embedded": "Inside a padded Card, use surface=\"flat\" padding=\"none\" so the parent supplies the single inset. A flat section in a zero-padding Card keeps its ordinary body inset. Choose each section from its own parent; do not flatten independent page sections to match an embedded sibling."
           },
           "jobs": [
             "Related form fields need one titled section with optional actions and footer."
@@ -4769,12 +4868,42 @@
         },
         {
           "title": "Submit state button",
-          "description": "Submit control that resolves loading and pristine form states.",
-          "chooseWhen": [],
-          "avoidWhen": [],
+          "description": "SubmitStateButton submits a form with a pending state and optional pristine protection through submitting, dirty and disableWhenPristine.",
+          "chooseWhen": [
+            "SubmitStateButton submits a form with a pending state and optional pristine protection through submitting, dirty and disableWhenPristine."
+          ],
+          "avoidWhen": [
+            "The command does not submit a form; use Button with an explicit type and callback."
+          ],
           "appOwned": [],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "SubmitStateButton",
+                "roles": [
+                  "form-submit"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "none",
+                "slots": [
+                  "children"
+                ]
+              }
+            ],
+            "owns": [
+              "Button geometry, pending state and default submit type",
+              "Default primary tone and optional pristine disabling"
+            ],
+            "parentOwns": [
+              "Native form association, validation and async transport",
+              "submitting and dirty state; accepted values and error feedback"
+            ],
+            "page": "Keep the submit with its task-local form. Independent forms can each own a primary submit; a single full-page editor can deliberately use one header submit.",
+            "embedded": "Use directly in Card.footerSlot or FormSection.footer, or in FormActionsBar trailing. The pending prop is submitting, not loading."
+          },
           "jobs": [
-            "Use Submit state button in an admin interface."
+            "SubmitStateButton submits a form with a pending state and optional pristine protection through submitting, dirty and disableWhenPristine."
           ],
           "tags": [
             "base",
@@ -4802,7 +4931,10 @@
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/buttons",
+            "themelia-react-ui/base/forms"
+          ]
         },
         {
           "title": "Validated form",
@@ -4877,7 +5009,6 @@
             "ControlledFormField",
             "DirtyStateBanner",
             "ErrorSummary",
-            "FormActionsBar",
             "SubmitStateButton"
           ],
           "references": [
@@ -4985,6 +5116,7 @@
       "symbols": [
         "CoordinatesInput",
         "CoordinatesInputProps",
+        "CoordinatesInputStrings",
         "CoordinatesObjectValue",
         "CoordinatesValue",
         "CurrencyInput",
@@ -4993,11 +5125,14 @@
         "CurrencyOption",
         "DecimalInput",
         "DecimalInputProps",
+        "DecimalInputStrings",
+        "DecimalRoundingMode",
         "DimensionObject",
         "DimensionUnit",
         "DimensionValue",
         "DimensionsInput",
         "DimensionsInputProps",
+        "DimensionsInputStrings",
         "MoneyInput",
         "MoneyInputContext",
         "MoneyInputData",
@@ -5011,7 +5146,10 @@
         "WeightInputProps",
         "WeightInputStrings",
         "WeightUnit",
+        "defaultCoordinatesInputStrings",
         "defaultCurrencyInputStrings",
+        "defaultDecimalInputStrings",
+        "defaultDimensionsInputStrings",
         "defaultMoneyInputStrings",
         "defaultWeightInputStrings"
       ],
@@ -5572,7 +5710,14 @@
         "foundations",
         "item"
       ],
-      "aliases": [],
+      "aliases": [
+        "list item",
+        "list of items",
+        "list row",
+        "notification list",
+        "record rows",
+        "simple list"
+      ],
       "sections": [
         "Base components"
       ],
@@ -5637,7 +5782,14 @@
             "foundations",
             "item"
           ],
-          "aliases": [],
+          "aliases": [
+            "list of items",
+            "list row",
+            "simple list",
+            "notification list",
+            "record rows",
+            "list item"
+          ],
           "section": "Base components",
           "browse": {
             "category": "data-display",
@@ -5826,14 +5978,18 @@
         "metadata-list"
       ],
       "aliases": [
-        "blocks/data-display/metadata-list",
-        "blocks/metadata-list",
         "contact details",
+        "customer details",
+        "description list",
         "details",
         "fact list",
         "key value",
+        "label value",
         "metadata",
-        "read-only facts"
+        "profile details",
+        "properties",
+        "read-only facts",
+        "user profile"
       ],
       "sections": [
         "Base components"
@@ -5890,14 +6046,18 @@
             "metadata-list"
           ],
           "aliases": [
-            "blocks/data-display/metadata-list",
-            "blocks/metadata-list",
             "metadata",
             "fact list",
             "read-only facts",
             "contact details",
             "key value",
-            "details"
+            "details",
+            "label value",
+            "description list",
+            "properties",
+            "user profile",
+            "profile details",
+            "customer details"
           ],
           "section": "Base components",
           "browse": {
@@ -6054,8 +6214,8 @@
         "PageHeaderLinkRenderProps",
         "PageHeaderLinkRenderer",
         "PageHeading",
-        "PageHeadingBadge",
         "PageHeadingProps",
+        "PageHeadingStrings",
         "PaginationContent",
         "PaginationContentProps",
         "PaginationEllipsis",
@@ -6068,8 +6228,8 @@
         "PaginationNextProps",
         "PaginationPrevious",
         "PaginationPreviousProps",
-        "PaginationPrimitive",
         "PaginationProps",
+        "PaginationRoot",
         "PaginationStrings",
         "Tabs",
         "TabsContent",
@@ -6080,6 +6240,7 @@
         "defaultBreadcrumbsStrings",
         "defaultNavigationTabsStrings",
         "defaultOverflowTabBarStrings",
+        "defaultPageHeadingStrings",
         "defaultPaginationStrings",
         "defaultTabsScrollStrings"
       ],
@@ -6464,10 +6625,10 @@
             {
               "title": "API",
               "symbols": [
-                "PaginationPrimitive",
                 "PaginationPrevious",
                 "PaginationNext",
-                "PaginationEllipsis"
+                "PaginationEllipsis",
+                "PaginationRoot"
               ]
             }
           ],
@@ -6737,6 +6898,7 @@
       "symbols": [
         "KeyValueEditor",
         "KeyValueEditorProps",
+        "KeyValueEditorStrings",
         "KeyValuePair",
         "LocalizedObjectField",
         "LocalizedObjectFieldDef",
@@ -6764,6 +6926,7 @@
         "StringRepeaterFieldRenderContext",
         "StringRepeaterProps",
         "StringRepeaterStrings",
+        "defaultKeyValueEditorStrings",
         "defaultLocalizedStringRepeaterStrings",
         "defaultObjectRepeaterStrings",
         "defaultRepeaterPrimitiveStrings",
@@ -7113,41 +7276,6 @@
       ],
       "recipes": []
     },
-    {
-      "import": "themelia-react-ui/base/sheet",
-      "declaration": "dist/components/base/sheet/index.d.ts",
-      "symbols": [
-        "Sheet",
-        "SheetBody",
-        "SheetClose",
-        "SheetContent",
-        "SheetDescription",
-        "SheetFooter",
-        "SheetHeader",
-        "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": "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": [],
-      "guidance": [],
-      "recipes": []
-    },
     {
       "import": "themelia-react-ui/base/sidebar",
       "declaration": "dist/components/base/sidebar/index.d.ts",
@@ -7186,11 +7314,11 @@
         "SidebarRail",
         "SidebarRegion",
         "SidebarRegionProps",
+        "SidebarRowTone",
         "SidebarSeparator",
         "SidebarStrings",
         "SidebarTrigger",
-        "defaultSidebarStrings",
-        "useSidebar"
+        "defaultSidebarStrings"
       ],
       "optionalPeers": [],
       "layer": "base",
@@ -8407,8 +8535,10 @@
         "SlugifyValueOptions",
         "Textarea",
         "TextareaProps",
+        "TextareaStrings",
         "defaultInputStrings",
         "defaultPasswordInputStrings",
+        "defaultTextareaStrings",
         "slugifyValue"
       ],
       "optionalPeers": [],
@@ -8824,7 +8954,8 @@
         "Tree",
         "TreeNode",
         "TreeProps",
-        "TreeStrings"
+        "TreeStrings",
+        "defaultTreeStrings"
       ],
       "optionalPeers": [],
       "layer": "base",
@@ -8908,35 +9039,22 @@
         "FileUploadSelectionMode",
         "FileUploadStrings",
         "FileUploadValidator",
+        "FileValidationRejection",
+        "FileValidationResult",
+        "FileValidationRules",
         "ImageUpload",
         "ImageUploadProps",
         "ImageUploadStrings",
-        "MediaGallery",
-        "MediaGalleryProps",
-        "MediaGalleryStrings",
         "MultipleFileUploadProps",
         "SingleFileUploadProps",
-        "UploadItem",
-        "UploadProgressList",
-        "UploadProgressListProps",
-        "UploadProgressListStrings",
-        "UploadStatus",
-        "UploadTray",
-        "UploadTrayProps",
-        "UploadTrayStrings",
         "defaultAvatarUploadStrings",
         "defaultDropzoneStrings",
         "defaultFileUploadStrings",
         "defaultImageUploadStrings",
-        "defaultMediaGalleryStrings",
-        "defaultUploadProgressListStrings",
-        "defaultUploadTrayStrings"
-      ],
-      "optionalPeers": [
-        "@dnd-kit/core",
-        "@dnd-kit/sortable",
-        "@dnd-kit/utilities"
+        "matchesFileAccept",
+        "validateFiles"
       ],
+      "optionalPeers": [],
       "layer": "base",
       "responsibility": "Base family: Avatar upload; Dropzone; File upload; Image upload; Upload overview.",
       "jobs": [
@@ -9347,7 +9465,12 @@
         "tags-input",
         "value-inputs"
       ],
-      "aliases": [],
+      "aliases": [
+        "chips input",
+        "multi value input",
+        "tag input",
+        "tags"
+      ],
       "sections": [
         "Base components"
       ],
@@ -9568,7 +9691,12 @@
             "value-inputs",
             "tags-input"
           ],
-          "aliases": [],
+          "aliases": [
+            "tags",
+            "tag input",
+            "chips input",
+            "multi value input"
+          ],
           "section": "Base components",
           "browse": {
             "category": "forms-inputs",
@@ -9638,6 +9766,7 @@
         "SensitiveActionCard",
         "SensitiveActionCardProps",
         "defaultApiKeyListStrings",
+        "defaultApiTokenListStrings",
         "defaultApiTokenManagerStrings",
         "defaultCopyableSecretAlertStrings"
       ],
@@ -10957,43 +11086,25 @@
         "ActivityHeatmapStrings",
         "ActivityLevel",
         "AnalyticsStrings",
-        "ChartCard",
-        "ChartCardProps",
         "FormatMetricValueOptions",
-        "Metric",
-        "MetricBar",
-        "MetricBarProps",
-        "MetricBarVariant",
         "MetricChange",
-        "MetricColorScheme",
         "MetricComparison",
         "MetricComparisonProps",
         "MetricComparisonStrings",
         "MetricData",
         "MetricDataPoint",
         "MetricDirection",
-        "MetricGradient",
-        "MetricGradientProps",
-        "MetricGradientTheme",
-        "MetricGrid",
-        "MetricGridProps",
-        "MetricMicroGrid",
-        "MetricMicroGridProps",
         "MetricPeriod",
-        "MetricProps",
         "MetricSize",
         "MetricSkeleton",
         "MetricSkeletonProps",
-        "MetricSparkline",
-        "MetricSparklineProps",
         "MetricTrend",
         "MetricTrendChip",
         "MetricTrendChipProps",
+        "MetricTrendChipStrings",
         "MetricTrendVariant",
         "MetricValueType",
         "MetricVariant",
-        "MicroChartKind",
-        "MicroMetricCell",
         "TimeDistributionRuler",
         "TimeDistributionRulerProps",
         "TimeDistributionRulerStrings",
@@ -11008,72 +11119,42 @@
         "UsageCardStrings",
         "defaultAnalyticsStrings",
         "defaultMetricComparisonStrings",
+        "defaultMetricTrendChipStrings",
         "defaultTimeDistributionRulerStrings",
         "defaultUsageCardStrings",
         "formatMetricValue",
         "resolveTrend"
       ],
-      "optionalPeers": [
-        "recharts"
-      ],
+      "optionalPeers": [],
       "layer": "blocks",
-      "responsibility": "Blocks family: Activity heatmap; Analytics bar; Analytics overview; Chart card; Comparison; Gradient cards; Metric parts; Micro chart grid; Stat cards; Time distribution.",
+      "responsibility": "Blocks family: Activity heatmap; Analytics overview; Comparison; Metric parts; Time distribution.",
       "jobs": [
-        "A custom chart needs shared title, description, action and footer regions.",
+        "A custom metric layout needs the parts on their own: MetricTrendChip and MetricSkeleton from blocks/analytics (no optional peer).",
         "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend.",
-        "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics.",
-        "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface.",
         "MetricComparison presents one metric for the current and previous period with the signed change.",
-        "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer.",
-        "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary.",
-        "TimeDistributionRuler presents counts across the hours of a day with the current hour marked.",
-        "Use Gradient cards in an admin interface.",
-        "Use Metric parts in an admin interface."
+        "The view needs the chart-free analytics blocks: MetricComparison, ActivityHeatmap, TimeDistributionRuler, MetricTrendChip, MetricSkeleton, or the shared metric types and formatters. This entry needs no optional peer.",
+        "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
       ],
       "tags": [
         "analytics",
-        "bar",
         "blocks",
-        "chart-card",
         "comparison",
-        "gradient-cards",
         "heatmap",
         "metric-parts",
-        "micro-grid",
         "optional-peer",
         "recharts",
-        "stat-cards",
         "time-ruler"
       ],
       "aliases": [
-        "KPI grid",
-        "KPI strip",
         "activity heatmap",
+        "analytics without recharts",
+        "chart-free analytics",
         "contribution calendar",
         "current vs previous",
         "daily activity",
-        "dashboard KPIs",
-        "dashboard metrics",
         "hourly distribution",
-        "kpi",
-        "kpi card",
-        "metric card",
         "metric comparison",
-        "metric grid",
-        "micro charts",
-        "mini chart grid",
-        "number card",
         "period comparison",
-        "revenue card",
-        "revenue overview",
-        "single KPI",
-        "single metric",
-        "sparkline grid",
-        "stat",
-        "stat cards",
-        "statistic cards",
-        "statistics",
-        "statistics cards",
         "time of day distribution"
       ],
       "sections": [
@@ -11082,26 +11163,30 @@
       "guidance": [
         {
           "title": "Analytics overview",
-          "description": "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics.",
+          "description": "The view needs the chart-free analytics blocks: MetricComparison, ActivityHeatmap, TimeDistributionRuler, MetricTrendChip, MetricSkeleton, or the shared metric types and formatters. This entry needs no optional peer.",
           "chooseWhen": [
-            "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics."
+            "The view needs the chart-free analytics blocks: MetricComparison, ActivityHeatmap, TimeDistributionRuler, MetricTrendChip, MetricSkeleton, or the shared metric types and formatters. This entry needs no optional peer."
           ],
           "avoidWhen": [
+            "A KPI tile, grid, strip, sparkline or custom chart is required: Metric, MetricGrid, MetricBar, MetricMicroGrid, MetricGradient, MetricSparkline and ChartCard live in blocks/analytics/charts, which needs the recharts peer.",
             "The content is one simple label/value pair or factual metadata about an entity."
           ],
           "appOwned": [
             "metric meaning, accepted values and comparison baselines",
             "transport, refresh and period changes",
-            "choice of one tile, peer cards or a shared strip"
+            "choice of comparison, heatmap, hourly distribution or usage summary"
           ],
           "jobs": [
-            "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics."
+            "The view needs the chart-free analytics blocks: MetricComparison, ActivityHeatmap, TimeDistributionRuler, MetricTrendChip, MetricSkeleton, or the shared metric types and formatters. This entry needs no optional peer."
           ],
           "tags": [
             "optional-peer",
             "recharts"
           ],
-          "aliases": [],
+          "aliases": [
+            "chart-free analytics",
+            "analytics without recharts"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -11122,73 +11207,55 @@
           "alternatives": [
             "themelia-react-ui/base/chart",
             "themelia-react-ui/base/metadata-list",
+            "themelia-react-ui/blocks/analytics/charts",
             "themelia-react-ui/blocks/data-display"
           ]
         },
         {
-          "title": "Analytics bar",
-          "description": "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer.",
+          "title": "Comparison",
+          "description": "MetricComparison presents one metric for the current and previous period with the signed change.",
           "chooseWhen": [
-            "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer."
+            "MetricComparison presents one metric for the current and previous period with the signed change."
           ],
           "avoidWhen": [
-            "Only one metric, quota usage, factual metadata or a bespoke chart is required."
+            "Several peer KPIs; use MetricGrid or MetricBar."
           ],
           "appOwned": [
-            "metric meaning, accepted values and comparison baselines",
-            "requests, refresh and period changes",
-            "error/empty/retry regions around the collection"
+            "Both MetricData values and the comparison baseline"
           ],
           "composition": {
             "mappings": [
               {
-                "symbol": "MetricGrid",
-                "roles": [
-                  "kpi-grid",
-                  "kpi-collection"
-                ],
-                "kind": "layout",
-                "placement": "region",
-                "surface": "self",
-                "props": {
-                  "variant": "card"
-                }
-              },
-              {
-                "symbol": "MetricBar",
+                "symbol": "MetricComparison",
                 "roles": [
-                  "kpi-strip",
-                  "kpi-collection"
+                  "metric-comparison",
+                  "period-comparison"
                 ],
                 "kind": "content",
                 "placement": "region",
-                "surface": "self"
+                "surface": "parent"
               }
             ],
             "owns": [
-              "Available-width KPI peer layout or strip anatomy",
-              "Selected metric presentation and strip surface"
+              "Current, previous and delta anatomy"
             ],
             "parentOwns": [
-              "Metric data, comparison meaning and period state",
-              "Dashboard placement and collection request states"
+              "Metric meaning and period baseline",
+              "Subject surface and placement"
             ]
           },
           "jobs": [
-            "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer."
+            "MetricComparison presents one metric for the current and previous period with the signed change."
           ],
           "tags": [
             "blocks",
             "analytics",
-            "bar"
+            "comparison"
           ],
           "aliases": [
-            "dashboard KPIs",
-            "dashboard metrics",
-            "revenue overview",
-            "KPI grid",
-            "metric grid",
-            "KPI strip"
+            "period comparison",
+            "current vs previous",
+            "metric comparison"
           ],
           "section": "Blocks",
           "browse": {
@@ -11209,65 +11276,105 @@
             {
               "title": "API",
               "symbols": [
-                "MetricBar",
-                "MetricGrid"
+                "MetricComparison"
               ]
             }
           ],
           "alternatives": [
-            "themelia-react-ui/base/chart",
-            "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/analytics/usage-card",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/blocks/analytics/charts"
           ]
         },
         {
-          "title": "Chart card",
-          "description": "A custom chart needs shared title, description, action and footer regions.",
+          "title": "Activity heatmap",
+          "description": "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend.",
           "chooseWhen": [
-            "A custom chart needs shared title, description, action and footer regions."
+            "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend."
           ],
           "avoidWhen": [
-            "A single fact needs no chart, or an existing metric block already owns the presentation."
+            "Values are a time series to compare; use ChartCard with ChartContainer."
           ],
           "appOwned": [
-            "Series, axes and chart data",
-            "Chart sizing and interaction callbacks"
+            "Daily counts and the covered range"
           ],
           "composition": {
             "mappings": [
               {
-                "symbol": "ChartCard",
+                "symbol": "ActivityHeatmap",
                 "roles": [
-                  "chart-subject"
+                  "activity-heatmap",
+                  "daily-activity"
                 ],
                 "kind": "content",
                 "placement": "region",
-                "surface": "variant",
-                "slots": [
-                  "children",
-                  "footer"
-                ]
+                "surface": "parent"
               }
             ],
             "owns": [
-              "Chart title and footer anatomy",
-              "ChartContainer configuration and content region"
+              "Calendar grid, month labels and legend"
             ],
             "parentOwns": [
-              "Surface framing and insets unless explicitly enabled",
-              "Page or dashboard placement"
-            ],
-            "page": "Place chart subjects in a Grid or layout column with deliberate peer gaps.",
-            "embedded": "Keep the default card-free presentation inside an existing Card; opt into a surface at the composition boundary."
+              "Activity data",
+              "Subject surface and placement"
+            ]
           },
           "jobs": [
-            "A custom chart needs shared title, description, action and footer regions."
+            "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend."
           ],
           "tags": [
             "blocks",
             "analytics",
-            "chart-card"
+            "heatmap"
+          ],
+          "aliases": [
+            "activity heatmap",
+            "contribution calendar",
+            "daily activity"
+          ],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Analytics",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "Overview",
+              "symbols": []
+            },
+            {
+              "title": "Examples",
+              "symbols": []
+            },
+            {
+              "title": "API",
+              "symbols": [
+                "ActivityHeatmap"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/analytics/charts"
+          ]
+        },
+        {
+          "title": "Metric parts",
+          "description": "A custom metric layout needs the parts on their own: MetricTrendChip and MetricSkeleton from blocks/analytics (no optional peer).",
+          "chooseWhen": [
+            "A custom metric layout needs the parts on their own: MetricTrendChip and MetricSkeleton from blocks/analytics (no optional peer)."
+          ],
+          "avoidWhen": [
+            "The standalone sparkline is required: MetricSparkline lives in blocks/analytics/charts, which needs the recharts peer."
+          ],
+          "appOwned": [],
+          "jobs": [
+            "A custom metric layout needs the parts on their own: MetricTrendChip and MetricSkeleton from blocks/analytics (no optional peer)."
+          ],
+          "tags": [
+            "blocks",
+            "analytics",
+            "metric-parts"
           ],
           "aliases": [],
           "section": "Blocks",
@@ -11283,44 +11390,48 @@
               "symbols": []
             },
             {
-              "title": "Header and footer slots",
+              "title": "Trend chip",
               "symbols": []
             },
             {
-              "title": "Card-free by default",
+              "title": "Sparkline",
+              "symbols": []
+            },
+            {
+              "title": "Skeleton",
               "symbols": []
             },
             {
               "title": "API",
               "symbols": [
-                "ChartCard"
+                "MetricTrendChip",
+                "MetricSparkline",
+                "MetricSkeleton"
               ]
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics",
-            "themelia-react-ui/blocks/data-display"
+            "themelia-react-ui/blocks/analytics/charts"
           ]
         },
         {
-          "title": "Comparison",
-          "description": "MetricComparison presents one metric for the current and previous period with the signed change.",
+          "title": "Time distribution",
+          "description": "TimeDistributionRuler presents counts across the hours of a day with the current hour marked.",
           "chooseWhen": [
-            "MetricComparison presents one metric for the current and previous period with the signed change."
+            "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
           ],
           "avoidWhen": [
-            "Several peer KPIs; use MetricGrid or MetricBar."
+            "Days or months need comparison; use ActivityHeatmap or ChartCard."
           ],
           "appOwned": [
-            "Both MetricData values and the comparison baseline"
+            "Hourly counts and the current hour"
           ],
           "composition": {
             "mappings": [
               {
-                "symbol": "MetricComparison",
+                "symbol": "TimeDistributionRuler",
                 "roles": [
-                  "metric-comparison",
-                  "period-comparison"
+                  "hourly-distribution"
                 ],
                 "kind": "content",
                 "placement": "region",
@@ -11328,25 +11439,24 @@
               }
             ],
             "owns": [
-              "Current, previous and delta anatomy"
+              "Hour ruler and density ramp"
             ],
             "parentOwns": [
-              "Metric meaning and period baseline",
+              "Hourly data",
               "Subject surface and placement"
             ]
           },
           "jobs": [
-            "MetricComparison presents one metric for the current and previous period with the signed change."
+            "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
           ],
           "tags": [
             "blocks",
             "analytics",
-            "comparison"
+            "time-ruler"
           ],
           "aliases": [
-            "period comparison",
-            "current vs previous",
-            "metric comparison"
+            "hourly distribution",
+            "time of day distribution"
           ],
           "section": "Blocks",
           "browse": {
@@ -11361,35 +11471,175 @@
               "symbols": []
             },
             {
-              "title": "Examples",
+              "title": "Example",
               "symbols": []
             },
             {
               "title": "API",
               "symbols": [
-                "MetricComparison"
+                "TimeDistributionRuler"
               ]
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics"
+            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/analytics/charts"
           ]
-        },
+        }
+      ],
+      "recipes": []
+    },
+    {
+      "import": "themelia-react-ui/blocks/analytics/charts",
+      "declaration": "dist/components/blocks/analytics/charts/index.d.ts",
+      "symbols": [
+        "ChartCard",
+        "ChartCardProps",
+        "Metric",
+        "MetricBar",
+        "MetricBarProps",
+        "MetricBarVariant",
+        "MetricChange",
+        "MetricData",
+        "MetricDataPoint",
+        "MetricDirection",
+        "MetricGradient",
+        "MetricGradientProps",
+        "MetricGradientTheme",
+        "MetricGrid",
+        "MetricGridProps",
+        "MetricMicroGrid",
+        "MetricMicroGridProps",
+        "MetricPeriod",
+        "MetricProps",
+        "MetricSize",
+        "MetricSparkline",
+        "MetricSparklineProps",
+        "MetricTrend",
+        "MetricTrendVariant",
+        "MetricValueType",
+        "MetricVariant",
+        "MicroChartKind",
+        "MicroMetricCell"
+      ],
+      "optionalPeers": [
+        "recharts"
+      ],
+      "layer": "blocks",
+      "responsibility": "Blocks family: Analytics bar; Chart card; Gradient cards; Micro chart grid; Stat cards.",
+      "jobs": [
+        "A custom chart needs shared title, description, action and footer regions. Import ChartCard from blocks/analytics/charts, which needs the recharts peer.",
+        "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface. Import it from blocks/analytics/charts, which needs the recharts peer.",
+        "MetricGradient presents one hero metric over an embedded area chart. Import it from blocks/analytics/charts, which needs the recharts peer.",
+        "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer. Import both from blocks/analytics/charts, which needs the recharts peer.",
+        "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary. Import it from blocks/analytics/charts, which needs the recharts peer."
+      ],
+      "tags": [
+        "optional-peer",
+        "recharts"
+      ],
+      "aliases": [
+        "KPI grid",
+        "KPI strip",
+        "area chart card",
+        "chart card",
+        "chart surface",
+        "custom chart",
+        "dashboard KPIs",
+        "dashboard metrics",
+        "gradient metric",
+        "hero metric",
+        "kpi",
+        "kpi card",
+        "kpi dashboard",
+        "metric",
+        "metric card",
+        "metric grid",
+        "micro charts",
+        "mini chart grid",
+        "number card",
+        "recharts card",
+        "revenue card",
+        "revenue overview",
+        "single KPI",
+        "single metric",
+        "sparkline",
+        "sparkline grid",
+        "stat",
+        "stat cards",
+        "statistic cards",
+        "statistics",
+        "statistics cards"
+      ],
+      "sections": [
+        "Blocks"
+      ],
+      "guidance": [
         {
-          "title": "Gradient cards",
-          "description": "`MetricGradient` — vivid gradient hero card with embedded area chart. Pick a `theme` to drive the colour palette.",
-          "chooseWhen": [],
-          "avoidWhen": [],
-          "appOwned": [],
+          "title": "Analytics bar",
+          "description": "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer. Import both from blocks/analytics/charts, which needs the recharts peer.",
+          "chooseWhen": [
+            "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer. Import both from blocks/analytics/charts, which needs the recharts peer."
+          ],
+          "avoidWhen": [
+            "Only one metric, quota usage, factual metadata or a bespoke chart is required."
+          ],
+          "appOwned": [
+            "metric meaning, accepted values and comparison baselines",
+            "requests, refresh and period changes",
+            "error/empty/retry regions around the collection"
+          ],
+          "composition": {
+            "mappings": [
+              {
+                "symbol": "MetricGrid",
+                "roles": [
+                  "kpi-grid",
+                  "kpi-collection"
+                ],
+                "kind": "layout",
+                "placement": "region",
+                "surface": "self",
+                "props": {
+                  "variant": "card"
+                }
+              },
+              {
+                "symbol": "MetricBar",
+                "roles": [
+                  "kpi-strip",
+                  "kpi-collection"
+                ],
+                "kind": "content",
+                "placement": "region",
+                "surface": "self"
+              }
+            ],
+            "owns": [
+              "Available-width KPI peer layout or strip anatomy",
+              "Selected metric presentation and strip surface"
+            ],
+            "parentOwns": [
+              "Metric data, comparison meaning and period state",
+              "Dashboard placement and collection request states"
+            ]
+          },
           "jobs": [
-            "Use Gradient cards in an admin interface."
+            "MetricGrid renders peer KPI cards from MetricData with parent-width columns; MetricBar renders the same metrics as one strip with optional period/footer. Import both from blocks/analytics/charts, which needs the recharts peer."
           ],
           "tags": [
-            "blocks",
-            "analytics",
-            "gradient-cards"
+            "optional-peer",
+            "recharts"
+          ],
+          "aliases": [
+            "dashboard KPIs",
+            "dashboard metrics",
+            "kpi dashboard",
+            "revenue overview",
+            "KPI grid",
+            "metric grid",
+            "KPI strip"
           ],
-          "aliases": [],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -11409,57 +11659,70 @@
             {
               "title": "API",
               "symbols": [
-                "MetricGradient"
+                "MetricBar",
+                "MetricGrid"
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/base/chart",
+            "themelia-react-ui/blocks/analytics/charts",
+            "themelia-react-ui/blocks/analytics/usage-card",
+            "themelia-react-ui/blocks/data-display"
+          ]
         },
         {
-          "title": "Activity heatmap",
-          "description": "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend.",
+          "title": "Chart card",
+          "description": "A custom chart needs shared title, description, action and footer regions. Import ChartCard from blocks/analytics/charts, which needs the recharts peer.",
           "chooseWhen": [
-            "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend."
+            "A custom chart needs shared title, description, action and footer regions. Import ChartCard from blocks/analytics/charts, which needs the recharts peer."
           ],
           "avoidWhen": [
-            "Values are a time series to compare; use ChartCard with ChartContainer."
+            "A single fact needs no chart, or an existing metric block already owns the presentation."
           ],
           "appOwned": [
-            "Daily counts and the covered range"
+            "Series, axes and chart data",
+            "Chart sizing and interaction callbacks"
           ],
           "composition": {
             "mappings": [
               {
-                "symbol": "ActivityHeatmap",
+                "symbol": "ChartCard",
                 "roles": [
-                  "activity-heatmap",
-                  "daily-activity"
+                  "chart-subject"
                 ],
                 "kind": "content",
                 "placement": "region",
-                "surface": "parent"
+                "surface": "variant",
+                "slots": [
+                  "children",
+                  "footer"
+                ]
               }
             ],
             "owns": [
-              "Calendar grid, month labels and legend"
+              "Chart title and footer anatomy",
+              "ChartContainer around children with the required config; do not add a duplicate container"
             ],
             "parentOwns": [
-              "Activity data",
-              "Subject surface and placement"
-            ]
+              "Surface framing and insets unless explicitly enabled",
+              "Page/dashboard placement, series, axes and legend or direct labels"
+            ],
+            "page": "Place chart subjects in a Grid or layout column with deliberate peer gaps. Bind series to config keys through var(--color-<key>); multi-series charts can use ChartLegend with ChartLegendContent inside the Recharts chart or accessible direct labels.",
+            "embedded": "Keep the default card-free presentation inside an existing Card; opt into a surface at the composition boundary. Footer is supporting caption/actions; substantial tables and disclosures belong in a peer or body region rather than the chart footer."
           },
           "jobs": [
-            "ActivityHeatmap presents daily activity counts as a Monday-aligned calendar grid with month labels and a legend."
+            "A custom chart needs shared title, description, action and footer regions. Import ChartCard from blocks/analytics/charts, which needs the recharts peer."
           ],
           "tags": [
-            "blocks",
-            "analytics",
-            "heatmap"
+            "optional-peer",
+            "recharts"
           ],
           "aliases": [
-            "activity heatmap",
-            "contribution calendar",
-            "daily activity"
+            "chart card",
+            "custom chart",
+            "recharts card",
+            "chart surface"
           ],
           "section": "Blocks",
           "browse": {
@@ -11474,35 +11737,47 @@
               "symbols": []
             },
             {
-              "title": "Examples",
+              "title": "Header and footer slots",
+              "symbols": []
+            },
+            {
+              "title": "Card-free by default",
               "symbols": []
             },
             {
               "title": "API",
               "symbols": [
-                "ActivityHeatmap"
+                "ChartCard"
               ]
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics"
+            "themelia-react-ui/blocks/analytics/charts",
+            "themelia-react-ui/blocks/data-display"
           ]
         },
         {
-          "title": "Metric parts",
-          "description": "The three pieces a Metric is built from — trend chip, sparkline, and skeleton — exported for surfaces that need one without the whole tile.",
-          "chooseWhen": [],
-          "avoidWhen": [],
+          "title": "Gradient cards",
+          "description": "MetricGradient presents one hero metric over an embedded area chart. Import it from blocks/analytics/charts, which needs the recharts peer.",
+          "chooseWhen": [
+            "MetricGradient presents one hero metric over an embedded area chart. Import it from blocks/analytics/charts, which needs the recharts peer."
+          ],
+          "avoidWhen": [
+            "A routine KPI tile or a grid of peers is required; use Metric or MetricGrid."
+          ],
           "appOwned": [],
           "jobs": [
-            "Use Metric parts in an admin interface."
+            "MetricGradient presents one hero metric over an embedded area chart. Import it from blocks/analytics/charts, which needs the recharts peer."
           ],
           "tags": [
-            "blocks",
-            "analytics",
-            "metric-parts"
+            "optional-peer",
+            "recharts"
+          ],
+          "aliases": [
+            "gradient metric",
+            "hero metric",
+            "area chart card"
           ],
-          "aliases": [],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -11516,33 +11791,25 @@
               "symbols": []
             },
             {
-              "title": "Trend chip",
-              "symbols": []
-            },
-            {
-              "title": "Sparkline",
-              "symbols": []
-            },
-            {
-              "title": "Skeleton",
+              "title": "Examples",
               "symbols": []
             },
             {
               "title": "API",
               "symbols": [
-                "MetricTrendChip",
-                "MetricSparkline",
-                "MetricSkeleton"
+                "MetricGradient"
               ]
             }
           ],
-          "alternatives": []
+          "alternatives": [
+            "themelia-react-ui/blocks/analytics/charts"
+          ]
         },
         {
           "title": "Micro chart grid",
-          "description": "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary.",
+          "description": "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary. Import it from blocks/analytics/charts, which needs the recharts peer.",
           "chooseWhen": [
-            "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary."
+            "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary. Import it from blocks/analytics/charts, which needs the recharts peer."
           ],
           "avoidWhen": [
             "Each KPI needs its own trend, comparison or loading state; use MetricGrid."
@@ -11572,12 +11839,11 @@
             ]
           },
           "jobs": [
-            "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary."
+            "MetricMicroGrid packs six label/value cells, each with a small bars, line, dots, progress, area or pie visual, as a dense dashboard summary. Import it from blocks/analytics/charts, which needs the recharts peer."
           ],
           "tags": [
-            "blocks",
-            "analytics",
-            "micro-grid"
+            "optional-peer",
+            "recharts"
           ],
           "aliases": [
             "sparkline grid",
@@ -11608,14 +11874,14 @@
             }
           ],
           "alternatives": [
-            "themelia-react-ui/blocks/analytics"
+            "themelia-react-ui/blocks/analytics/charts"
           ]
         },
         {
           "title": "Stat cards",
-          "description": "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface.",
+          "description": "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface. Import it from blocks/analytics/charts, which needs the recharts peer.",
           "chooseWhen": [
-            "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface."
+            "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface. Import it from blocks/analytics/charts, which needs the recharts peer."
           ],
           "avoidWhen": [
             "Several KPI cards need parent-responsive layout, or the value is a simple factual label/value pair."
@@ -11648,12 +11914,11 @@
             "embedded": "Inspect variant and loading/error presentation before adding a subject surface; default content and card variants have different framing."
           },
           "jobs": [
-            "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface."
+            "Metric renders one KPI with formatting, trend, sparkline and loading/error presentation; variant=\"card\" owns its Card surface. Import it from blocks/analytics/charts, which needs the recharts peer."
           ],
           "tags": [
-            "blocks",
-            "analytics",
-            "stat-cards"
+            "optional-peer",
+            "recharts"
           ],
           "aliases": [
             "statistic cards",
@@ -11663,11 +11928,13 @@
             "single metric",
             "revenue card",
             "kpi",
+            "metric",
             "metric card",
             "kpi card",
             "number card",
             "statistics",
-            "stat"
+            "stat",
+            "sparkline"
           ],
           "section": "Blocks",
           "browse": {
@@ -11694,80 +11961,9 @@
           ],
           "alternatives": [
             "themelia-react-ui/base/metadata-list",
-            "themelia-react-ui/blocks/analytics",
+            "themelia-react-ui/blocks/analytics/charts",
             "themelia-react-ui/blocks/data-display"
           ]
-        },
-        {
-          "title": "Time distribution",
-          "description": "TimeDistributionRuler presents counts across the hours of a day with the current hour marked.",
-          "chooseWhen": [
-            "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
-          ],
-          "avoidWhen": [
-            "Days or months need comparison; use ActivityHeatmap or ChartCard."
-          ],
-          "appOwned": [
-            "Hourly counts and the current hour"
-          ],
-          "composition": {
-            "mappings": [
-              {
-                "symbol": "TimeDistributionRuler",
-                "roles": [
-                  "hourly-distribution"
-                ],
-                "kind": "content",
-                "placement": "region",
-                "surface": "parent"
-              }
-            ],
-            "owns": [
-              "Hour ruler and density ramp"
-            ],
-            "parentOwns": [
-              "Hourly data",
-              "Subject surface and placement"
-            ]
-          },
-          "jobs": [
-            "TimeDistributionRuler presents counts across the hours of a day with the current hour marked."
-          ],
-          "tags": [
-            "blocks",
-            "analytics",
-            "time-ruler"
-          ],
-          "aliases": [
-            "hourly distribution",
-            "time of day distribution"
-          ],
-          "section": "Blocks",
-          "browse": {
-            "category": "domain-ui",
-            "group": "Analytics",
-            "domain": "",
-            "collection": ""
-          },
-          "sections": [
-            {
-              "title": "Overview",
-              "symbols": []
-            },
-            {
-              "title": "Example",
-              "symbols": []
-            },
-            {
-              "title": "API",
-              "symbols": [
-                "TimeDistributionRuler"
-              ]
-            }
-          ],
-          "alternatives": [
-            "themelia-react-ui/blocks/analytics"
-          ]
         }
       ],
       "recipes": [
@@ -12072,20 +12268,16 @@
         "BookingCalendarEventCardProps",
         "BookingEntry",
         "CartLineItem",
-        "CartSummary",
         "CartSummaryCard",
         "CartSummaryCardProps",
-        "CartSummaryProps",
         "CartSummaryStrings",
         "CouponInputCard",
         "CouponInputCardProps",
         "CouponInputStrings",
         "DEFAULT_SEO_LISTING_LIMITS",
         "Discount",
-        "DiscountStack",
         "DiscountStackPreview",
         "DiscountStackPreviewProps",
-        "DiscountStackProps",
         "DiscountStackStrings",
         "FulfillmentGroup",
         "FulfillmentGroupProps",
@@ -12159,8 +12351,6 @@
         "PaymentBrand",
         "PaymentEvent",
         "PaymentMethod",
-        "PaymentMethodCard",
-        "PaymentMethodCardProps",
         "PaymentMethodProps",
         "PaymentMethodStrings",
         "PaymentMethodVariant",
@@ -12170,13 +12360,12 @@
         "Receipt",
         "ReceiptItems",
         "ReceiptItemsProps",
+        "ReceiptItemsStrings",
         "ReceiptLineItem",
         "ReceiptProps",
         "RefundStage",
-        "RefundStatus",
         "RefundStatusCard",
         "RefundStatusCardProps",
-        "RefundStatusProps",
         "RefundStatusStrings",
         "SeoListingCard",
         "SeoListingCardProps",
@@ -12209,6 +12398,7 @@
         "TransactionStatus",
         "UpcomingBookingRow",
         "UpcomingBookingRowProps",
+        "UpcomingBookingStrings",
         "VendorProfileCard",
         "VendorProfileCardProps",
         "VendorProfileChangeTone",
@@ -12243,6 +12433,7 @@
         "defaultShipmentTrackingStrings",
         "defaultSubscriptionSummaryStrings",
         "defaultTaxBreakdownStrings",
+        "defaultUpcomingBookingStrings",
         "defaultVendorProfileStrings",
         "defaultVoucherEntryStrings",
         "fulfillmentStatusTone",
@@ -14694,6 +14885,7 @@
         "Receipt",
         "ReceiptItems",
         "ReceiptItemsProps",
+        "ReceiptItemsStrings",
         "ReceiptLineItem",
         "ReceiptProps"
       ],
@@ -14870,16 +15062,6 @@
         "InlineStat",
         "InlineStatLayout",
         "InlineStatProps",
-        "MetadataDensity",
-        "MetadataInlineListItem",
-        "MetadataLayout",
-        "MetadataList",
-        "MetadataListItem",
-        "MetadataListProps",
-        "MetadataValue",
-        "MetadataValueDescriptor",
-        "MetadataValueKind",
-        "MetadataValueProps",
         "ProjectMetaPair",
         "RelationshipCardFrame",
         "RelationshipCardFrameProps",
@@ -14890,18 +15072,6 @@
         "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; Relationship card frame.",
@@ -15476,13 +15646,15 @@
         "StepsCardProps",
         "StepsHorizontal",
         "StepsHorizontalProps",
+        "StepsStrings",
         "Timeline",
         "TimelineDotSize",
         "TimelineItem",
         "TimelineProps",
         "TimelineStatus",
         "defaultChangelogTimelineStrings",
-        "defaultMilestonesTimelineStrings"
+        "defaultMilestonesTimelineStrings",
+        "defaultStepsStrings"
       ],
       "optionalPeers": [],
       "layer": "blocks",
@@ -15502,7 +15674,13 @@
         "timeline",
         "timelines"
       ],
-      "aliases": [],
+      "aliases": [
+        "progress steps",
+        "step list",
+        "stepper",
+        "steps wizard",
+        "wizard"
+      ],
       "sections": [
         "Blocks"
       ],
@@ -15645,7 +15823,13 @@
             "timelines",
             "steps-card"
           ],
-          "aliases": [],
+          "aliases": [
+            "steps wizard",
+            "wizard",
+            "stepper",
+            "progress steps",
+            "step list"
+          ],
           "section": "Blocks",
           "browse": {
             "category": "domain-ui",
@@ -15805,6 +15989,7 @@
         "ActivityLogEventRenderContext",
         "ActivityLogProps",
         "ActivityLogRenderer",
+        "ActivityLogSlots",
         "ActivityLogSubmit",
         "ActivityMarker",
         "ActivityMarkerProps",
@@ -15854,7 +16039,13 @@
         "features",
         "timeline"
       ],
-      "aliases": [],
+      "aliases": [
+        "activity feed",
+        "audit log",
+        "audit trail",
+        "history",
+        "record history"
+      ],
       "sections": [
         "Features",
         "Recipes"
@@ -15947,7 +16138,13 @@
             "collaboration",
             "activities"
           ],
-          "aliases": [],
+          "aliases": [
+            "history",
+            "audit log",
+            "audit trail",
+            "activity feed",
+            "record history"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -16114,6 +16311,7 @@
         "AppointmentCalendar",
         "AppointmentCalendarProps",
         "AppointmentCalendarStrings",
+        "AppointmentCalendarSurface",
         "AppointmentCalendarView",
         "AppointmentCategory",
         "AppointmentCategoryColor",
@@ -16342,6 +16540,7 @@
         "AsyncResourceComboboxRenderOptionContext",
         "AsyncResourceComboboxStrings",
         "Combobox",
+        "ComboboxListControl",
         "ComboboxProps",
         "ComboboxSharedProps",
         "ComboboxSize",
@@ -17288,6 +17487,7 @@
         "DisplayConfig",
         "FilterConfig",
         "FilterContextValue",
+        "FilterDateShortcut",
         "FilterDependency",
         "FilterErrorBoundary",
         "FilterErrorBoundaryProps",
@@ -17346,7 +17546,10 @@
         "getDateOperators",
         "getDefaultOperatorForType",
         "getFilterString",
+        "getMultiSelectOperators",
         "getNumberOperators",
+        "getOperatorLabel",
+        "getOperatorsForFilter",
         "getOperatorsForType",
         "getSelectOperators",
         "getTextOperators",
@@ -17354,6 +17557,7 @@
         "mergeFilterQuery",
         "parseFiltersFromQuery",
         "predicateValidator",
+        "resolveDefaultOperator",
         "serializeFiltersToQuery",
         "useAsyncOptions",
         "useFilterGroups",
@@ -17534,6 +17738,7 @@
         "GlobalSearchIdleStateProps",
         "GlobalSearchInput",
         "GlobalSearchInputProps",
+        "GlobalSearchInputSlotContext",
         "GlobalSearchMeta",
         "GlobalSearchProps",
         "GlobalSearchRenderResultContext",
@@ -17636,6 +17841,8 @@
         "KanbanItemHandleProps",
         "KanbanItemMoveEvent",
         "KanbanItemProps",
+        "KanbanItemTrigger",
+        "KanbanItemTriggerProps",
         "KanbanOverlay",
         "KanbanOverlayProps",
         "KanbanProps",
@@ -17948,9 +18155,6 @@
         "useMediaLibrary"
       ],
       "optionalPeers": [
-        "@dnd-kit/core",
-        "@dnd-kit/sortable",
-        "@dnd-kit/utilities",
         "react-hook-form"
       ],
       "layer": "features",
@@ -18194,7 +18398,6 @@
         "MentionContent",
         "MentionContentProps",
         "MentionEditorHandle",
-        "MentionHtmlSegment",
         "MentionInlineSuggestions",
         "MentionInlineSuggestionsProps",
         "MentionInlineSuggestionsStrings",
@@ -18217,7 +18420,6 @@
         "defaultMentionInlineSuggestionsStrings",
         "defaultMentionPickerStrings",
         "parseMentionsFromHtml",
-        "splitHtmlByMentions",
         "useMentions",
         "useMentionsSearch"
       ],
@@ -18269,7 +18471,8 @@
               "symbols": [
                 "MentionInlineSuggestions",
                 "MentionPicker",
-                "MentionChip"
+                "MentionChip",
+                "MentionContent"
               ]
             }
           ],
@@ -18295,6 +18498,8 @@
         "OverlayButtonStyle",
         "OverlayButtonTone",
         "OverlayEmphasisProps",
+        "OverlayFinalFocus",
+        "OverlayInteractionType",
         "OverlayOpenSetter",
         "OverlaySize",
         "OverlayStrings",
@@ -18307,7 +18512,7 @@
         "UseOverlayVisibilityGroupReturn",
         "UseOverlayVisibilityOptions",
         "UseOverlayVisibilityReturn",
-        "defaultAlertDialogStrings",
+        "defaultConfirmDialogStrings",
         "defaultOverlayStrings",
         "useOverlayActions",
         "useOverlayVisibility",
@@ -18519,20 +18724,16 @@
       "declaration": "dist/components/features/products/index.d.ts",
       "symbols": [
         "ProductChoice",
-        "ProductContractOverview",
         "ProductContractOverviewProps",
         "ProductContractOverviewStrings",
-        "ProductDetailsCard",
         "ProductDetailsCardProps",
         "ProductDetailsCardStrings",
         "ProductMetricSummary",
         "ProductOperationActionContext",
-        "ProductOperationsCard",
         "ProductOperationsCardProps",
         "ProductOperationsCardStrings",
         "ProductOperationsItem",
         "ProductOptionActionContext",
-        "ProductOptionActionMenu",
         "ProductOptionActionMenuProps",
         "ProductOptionActionMenuStrings",
         "ProductOptionEditDraft",
@@ -18544,37 +18745,31 @@
         "ProductOptionsMatrixActionContext",
         "ProductOptionsMatrixProps",
         "ProductOptionsMatrixStrings",
-        "ProductOptionsSummary",
         "ProductOptionsSummaryProps",
         "ProductOptionsSummaryStrings",
         "ProductOverview",
         "ProductOverviewProps",
         "ProductOverviewSlots",
         "ProductOverviewStrings",
-        "ProductPoliciesCard",
         "ProductPoliciesCardProps",
         "ProductPoliciesCardStrings",
         "ProductPolicyActionContext",
         "ProductPolicySummary",
         "ProductQuoteLine",
         "ProductQuoteLineActionContext",
-        "ProductQuotePreviewCard",
         "ProductQuotePreviewCardProps",
         "ProductQuotePreviewCardStrings",
-        "ProductReadinessCard",
         "ProductReadinessCardProps",
         "ProductReadinessCardStrings",
         "ProductReadinessItem",
         "ProductReadinessItemActionContext",
         "ProductRuleActionContext",
-        "ProductStructureCard",
         "ProductStructureCardProps",
         "ProductStructureCardStrings",
         "ProductStructureMetric",
         "ProductStructureMetricActionContext",
         "ProductTone",
         "ProductVariantActionContext",
-        "ProductVariantActionMenu",
         "ProductVariantActionMenuProps",
         "ProductVariantActionMenuStrings",
         "ProductVariantBulkActionContext",
@@ -18626,38 +18821,6 @@
         "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"
@@ -19229,36 +19392,13 @@
         "ResourceDetailsSection",
         "ResourceDetailsSectionProps",
         "ResourceEmptyState",
-        "ResourceEmptyStateProps",
-        "ResourceHeader",
-        "ResourceHeaderCommandProps",
-        "ResourceHeaderProps",
-        "ResourceIndexShell",
-        "ResourceIndexShellProps",
-        "ResourceShellSlots",
-        "ResourceShowShell",
-        "ResourceShowShellProps",
-        "ResourceStrings",
-        "TabbedResourceShell",
-        "TabbedResourceShellProps",
-        "defaultResourceStrings"
-      ],
-      "deprecated": {
-        "ResourceHeader": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "ResourceHeaderCommandProps": "Part of deprecated ResourceHeader. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "ResourceHeaderProps": "Part of deprecated ResourceHeader. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "ResourceIndexShell": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "ResourceIndexShellProps": "Part of deprecated ResourceIndexShell. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "ResourceShowShell": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "ResourceShowShellProps": "Part of deprecated ResourceShowShell. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "TabbedResourceShell": "Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers.",
-        "TabbedResourceShellProps": "Part of deprecated TabbedResourceShell. Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers."
-      },
+        "ResourceEmptyStateProps"
+      ],
       "optionalPeers": [],
       "layer": "features",
       "responsibility": "Features family: Resource workspaces.",
       "jobs": [
-        "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject."
+        "A resource route needs ResourceDetailsSection for a framed facts subject, ResourceEmptyState for an empty region, or ResourceActionBar for a row of record commands."
       ],
       "tags": [
         "features",
@@ -19272,12 +19412,12 @@
       "guidance": [
         {
           "title": "Resource workspaces",
-          "description": "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject.",
+          "description": "A resource route needs ResourceDetailsSection for a framed facts subject, ResourceEmptyState for an empty region, or ResourceActionBar for a row of record commands.",
           "chooseWhen": [
-            "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject."
+            "A resource route needs ResourceDetailsSection for a framed facts subject, ResourceEmptyState for an empty region, or ResourceActionBar for a row of record commands."
           ],
           "avoidWhen": [
-            "New routes should use Page for identity, toolbar, aside and loading/empty/error regions."
+            "The route needs identity, toolbar, aside and loading/empty/error regions: Page owns those."
           ],
           "appOwned": [
             "Resource data and request lifecycle",
@@ -19300,19 +19440,18 @@
               }
             ],
             "owns": [
-              "Resource identity and toolbar regions",
-              "Body/aside geometry and subject gaps",
-              "Resource loading, empty and error presentation"
+              "The framed facts section and its footer",
+              "Resource empty-state presentation and the record command row"
             ],
             "parentOwns": [
               "Application chrome and page gutters",
-              "Route heading and command ownership"
+              "Route heading, toolbar, aside and command ownership through Page"
             ],
-            "page": "Use Page for new resource routes. Deprecated resource shells retain their existing inset-free embedding contract for migration.",
-            "embedded": "The resource shell adds no page inset; ResourceDetailsSection owns its Card and adapts facts to its available width."
+            "page": "Use Page for the route; place these parts in its body or aside.",
+            "embedded": "ResourceDetailsSection owns its Card and adapts facts to its available width."
           },
           "jobs": [
-            "Maintain an existing resource composition or use ResourceDetailsSection for a framed facts subject."
+            "A resource route needs ResourceDetailsSection for a framed facts subject, ResourceEmptyState for an empty region, or ResourceActionBar for a row of record commands."
           ],
           "tags": [
             "features",
@@ -19343,10 +19482,6 @@
             {
               "title": "API",
               "symbols": [
-                "ResourceIndexShell",
-                "ResourceShowShell",
-                "TabbedResourceShell",
-                "ResourceHeader",
                 "ResourceActionBar",
                 "ResourceDetailsSection",
                 "ResourceEmptyState"
@@ -19517,7 +19652,8 @@
             {
               "title": "API",
               "symbols": [
-                "RichTextEditor"
+                "RichTextEditor",
+                "FormRichTextEditor"
               ]
             }
           ],
@@ -19587,9 +19723,7 @@
         "inputs",
         "schema-form"
       ],
-      "aliases": [
-        "features/sync"
-      ],
+      "aliases": [],
       "sections": [
         "Features"
       ],
@@ -19608,9 +19742,7 @@
             "inputs",
             "schema-form"
           ],
-          "aliases": [
-            "features/sync"
-          ],
+          "aliases": [],
           "section": "Features",
           "browse": {
             "category": "forms-inputs",
@@ -19705,37 +19837,6 @@
       ],
       "recipes": []
     },
-    {
-      "import": "themelia-react-ui/features/sync",
-      "declaration": "dist/components/features/sync/index.d.ts",
-      "symbols": [
-        "SyncRangeDialogForm",
-        "SyncRangeDialogFormProps",
-        "SyncRangeDialogFormStrings",
-        "SyncRangeDialogFormSubmit",
-        "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": "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": [],
-      "guidance": [],
-      "recipes": []
-    },
     {
       "import": "themelia-react-ui/features/table",
       "declaration": "dist/components/features/table/index.d.ts",
@@ -19750,6 +19851,7 @@
         "CellValueKind",
         "CellValueProps",
         "CellValueTuple",
+        "ColumnDef",
         "ColumnFiltersHandler",
         "ColumnGroup",
         "ColumnVisibilityHandler",
@@ -20194,6 +20296,7 @@
         "AppShellContentSurface",
         "AppShellSidebarPresentation",
         "AppShellSidebarRegionProps",
+        "AppShellSkipLinkProps",
         "AppSidebar",
         "AppSidebarProps",
         "AsideNavGroup",
@@ -20290,18 +20393,13 @@
         "NavLink",
         "NotificationTone",
         "Page",
-        "PageAction",
-        "PageActionContext",
-        "PageActions",
-        "PageActionsDisplay",
-        "PageActionsProps",
-        "PageActionsStrings",
         "PageHeader",
         "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderRenderContext",
         "PageHeaderRenderSlot",
         "PageHeaderSlots",
+        "PageHeaderStrings",
         "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
@@ -20315,8 +20413,6 @@
         "SectionNavProps",
         "SectionNavStrings",
         "SectionProps",
-        "SettingsShell",
-        "SettingsShellProps",
         "SideNav",
         "SideNavGroup",
         "SideNavItem",
@@ -20347,6 +20443,7 @@
         "SidebarNavigationRail",
         "SidebarNavigationRailItem",
         "SidebarNavigationRailProps",
+        "SidebarNavigationRailStrings",
         "SidebarNavigationStrings",
         "SidebarNavigationUser",
         "SidebarNavigationUserProps",
@@ -20364,6 +20461,7 @@
         "StackedLayout",
         "StackedLayoutProps",
         "StackedLayoutSlots",
+        "StackedNavElement",
         "TopbarSidebarContentElement",
         "TopbarSidebarHeaderTheme",
         "TopbarSidebarLayout",
@@ -20409,11 +20507,12 @@
         "defaultHeaderNotificationsStrings",
         "defaultHeaderSearchStrings",
         "defaultHeaderUserMenuStrings",
-        "defaultPageActionsStrings",
+        "defaultPageHeaderStrings",
         "defaultPageStrings",
         "defaultRenderLink",
         "defaultSectionNavStrings",
         "defaultSideNavStrings",
+        "defaultSidebarNavigationRailStrings",
         "defaultSidebarNavigationStrings",
         "defaultSidebarNavigationUserStrings",
         "defaultSidebarWorkspaceDropdownStrings",
@@ -20435,14 +20534,6 @@
         "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.",
@@ -20463,6 +20554,7 @@
         "AppShellContentSurface",
         "AppShellSidebarPresentation",
         "AppShellSidebarRegionProps",
+        "AppShellSkipLinkProps",
         "SidebarInsetContentElement",
         "SidebarInsetLayout",
         "SidebarInsetLayoutProps",
@@ -20474,6 +20566,7 @@
         "StackedLayout",
         "StackedLayoutProps",
         "StackedLayoutSlots",
+        "StackedNavElement",
         "TopbarSidebarContentElement",
         "TopbarSidebarHeaderTheme",
         "TopbarSidebarLayout",
@@ -21543,34 +21636,21 @@
       "declaration": "dist/components/layout/page/index.d.ts",
       "symbols": [
         "Page",
-        "PageAction",
-        "PageActionContext",
-        "PageActions",
-        "PageActionsDisplay",
-        "PageActionsProps",
-        "PageActionsStrings",
         "PageHeader",
         "PageHeaderAction",
         "PageHeaderProps",
         "PageHeaderRenderContext",
         "PageHeaderRenderSlot",
         "PageHeaderSlots",
+        "PageHeaderStrings",
         "PageHeaderTabs",
         "PageProps",
         "PageSlotProps",
         "PageSlots",
         "PageStrings",
-        "defaultPageActionsStrings",
+        "defaultPageHeaderStrings",
         "defaultPageStrings"
       ],
-      "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.",
@@ -21685,7 +21765,6 @@
                   "aside",
                   "toolbar",
                   "beforeHeader",
-                  "afterHeader",
                   "emptySlot"
                 ]
               }
@@ -21745,8 +21824,7 @@
               "title": "API",
               "symbols": [
                 "Page",
-                "PageHeader",
-                "PageActions"
+                "PageHeader"
               ]
             }
           ],
@@ -21895,8 +21973,6 @@
         "AsideNavShell",
         "AsideNavShellProps",
         "AsideNavShellStrings",
-        "SettingsShell",
-        "SettingsShellProps",
         "defaultAsideNavShellStrings"
       ],
       "optionalPeers": [],
@@ -21911,9 +21987,12 @@
         "shells"
       ],
       "aliases": [
+        "account settings",
         "multi-section settings",
         "preferences",
-        "settings navigation"
+        "settings navigation",
+        "settings page",
+        "settings screen"
       ],
       "sections": [
         "Layouts"
@@ -21935,7 +22014,7 @@
           "composition": {
             "mappings": [
               {
-                "symbol": "SettingsShell",
+                "symbol": "AsideNavShell",
                 "roles": [
                   "settings-workspace"
                 ],
@@ -21957,8 +22036,8 @@
               "Page measure, gutters and route identity",
               "Application form lifecycle and routing"
             ],
-            "page": "Place SettingsShell inside one Page; keep each form subject in FormSection and supply the navigation groups.",
-            "embedded": "SettingsShell adds content rhythm, not another Page or automatic Card. Avoid repeating its section title in nested headers."
+            "page": "Place AsideNavShell inside one Page; keep each form subject in FormSection and supply the navigation groups.",
+            "embedded": "AsideNavShell adds content rhythm, not another Page or automatic Card. Avoid repeating its section title in nested headers."
           },
           "jobs": [
             "Several settings sections need persistent side navigation and a content region."
@@ -21971,7 +22050,10 @@
           "aliases": [
             "preferences",
             "settings navigation",
-            "multi-section settings"
+            "multi-section settings",
+            "settings page",
+            "settings screen",
+            "account settings"
           ],
           "section": "Layouts",
           "browse": {
@@ -21992,7 +22074,6 @@
             {
               "title": "API",
               "symbols": [
-                "SettingsShell",
                 "AsideNavShell"
               ]
             }
@@ -22036,6 +22117,7 @@
         "SidebarNavigationRail",
         "SidebarNavigationRailItem",
         "SidebarNavigationRailProps",
+        "SidebarNavigationRailStrings",
         "SidebarNavigationStrings",
         "SidebarNavigationUser",
         "SidebarNavigationUserProps",
@@ -22049,6 +22131,7 @@
         "SidebarWorkspaceDropdownProps",
         "SidebarWorkspaceDropdownStrings",
         "WorkspaceLink",
+        "defaultSidebarNavigationRailStrings",
         "defaultSidebarNavigationStrings",
         "defaultSidebarNavigationUserStrings",
         "defaultSidebarWorkspaceDropdownStrings",
@@ -22371,8 +22454,10 @@
         "EmptyValue",
         "EmptyValueProps",
         "FileSize",
+        "FileSizeFormatOptions",
         "FileSizeProps",
         "FileSizeUnit",
+        "FileSizeUnitLabels",
         "FormatDateRangeOptions",
         "FormatDimensionsOptions",
         "FormatDurationOptions",
@@ -23233,9 +23318,9 @@
         "parseActionError",
         "resolveActionMessage",
         "resolveActionRequest",
+        "toButtonAction",
         "toCommandAction",
         "toMenuAction",
-        "toPageAction",
         "toPageHeaderAction",
         "toTableAction",
         "useAction",
@@ -23247,9 +23332,6 @@
         "useLocalAction",
         "useRegisterActions"
       ],
-      "deprecated": {
-        "toPageAction": "Use toPageHeaderAction for a header's `primaryAction` and `secondaryActions`."
-      },
       "optionalPeers": [],
       "layer": "foundations",
       "responsibility": "Foundational roles: Runtime actions.",
@@ -23343,6 +23425,7 @@
         "DisplayLabel",
         "DisplayLabelProps",
         "Heading",
+        "HeadingDisplayTag",
         "HeadingProps",
         "HeadingSize",
         "HeadingTag",
@@ -23877,6 +23960,8 @@
         "SpinnerConfigSlice",
         "TableSize",
         "TextSize",
+        "ThemeBoundary",
+        "ThemeBoundaryProps",
         "ThemeScope",
         "ThemeScopeProps",
         "ToastConfig",