themelia-react-ui 1.0.0 → 1.0.1

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

@@ -2,7 +2,12 @@
   "schemaVersion": 1,
   "discoveryVersion": 1,
   "package": "themelia-react-ui",
-  "version": "1.0.0",
+  "version": "1.0.1",
+  "stylesheets": [
+    "themelia-react-ui/style.css",
+    "themelia-react-ui/theme.css",
+    "themelia-react-ui/features/map/style.css"
+  ],
   "peers": [
     {
       "name": "@base-ui/react",
@@ -292,7 +297,7 @@
       "guidance": [
         {
           "title": "Accordion",
-          "description": "Disclosure groups for settings, policy, and review workflows. Use SmartAccordion for data-driven rows; use the compound parts when the trigger or body needs custom structure.",
+          "description": "One or more labeled disclosure items need coordinated accordion behavior.",
           "chooseWhen": [
             "One or more labeled disclosure items need coordinated accordion behavior."
           ],
@@ -372,11 +377,9 @@
         "action-buttons",
         "action-menu",
         "actions",
-        "actions-overlays",
         "base",
         "build",
         "confirmation",
-        "docs",
         "drawer",
         "navigation & data"
       ],
@@ -388,7 +391,7 @@
       "guidance": [
         {
           "title": "Action menu",
-          "description": "The canonical overflow action shell driven by reusable action definitions, groups, visibility, links, and semantic variants.",
+          "description": "Edit, archive, delete, and other repeated action definitions need an overflow action menu.",
           "chooseWhen": [
             "Edit, archive, delete, and other repeated action definitions need an overflow action menu."
           ],
@@ -492,9 +495,7 @@
             "Build permission-aware record actions with package-owned overlay lifecycle and focus return."
           ],
           "tags": [
-            "docs",
             "build",
-            "actions-overlays",
             "actions",
             "drawer",
             "confirmation"
@@ -635,7 +636,7 @@
       "guidance": [
         {
           "title": "Avatar overview",
-          "description": "Avatar, fallback initials, and stacked avatars for compact identity surfaces.",
+          "description": "A person or entity needs image, initials fallback, status, badge, or grouped identity media.",
           "chooseWhen": [
             "A person or entity needs image, initials fallback, status, badge, or grouped identity media."
           ],
@@ -720,7 +721,7 @@
         },
         {
           "title": "Avatar group",
-          "description": "Low-level avatar grouping with explicit members, presence badges, and an overflow count.",
+          "description": "Manual compound control over each Avatar, badge, and overflow node is required.",
           "chooseWhen": [
             "Manual compound control over each Avatar, badge, and overflow node is required."
           ],
@@ -765,7 +766,7 @@
         },
         {
           "title": "Stacked avatars",
-          "description": "Compact overlapping identity groups with image fallbacks, maximum counts, and provider-aligned sizing.",
+          "description": "A data array needs the standard overlapping avatar recipe, initials fallback, and overflow count.",
           "chooseWhen": [
             "A data array needs the standard overlapping avatar recipe, initials fallback, and overflow count."
           ],
@@ -834,7 +835,7 @@
       "guidance": [
         {
           "title": "Badge",
-          "description": "Status pills and chips for tags, counts, and inline state.",
+          "description": "A compact semantic status, category, count, or resource chip is needed, including replacement of a local display-only status pill.",
           "chooseWhen": [
             "A compact semantic status, category, count, or resource chip is needed, including replacement of a local display-only status pill."
           ],
@@ -926,7 +927,7 @@
       "guidance": [
         {
           "title": "Buttons overview",
-          "description": "One canonical Button for actions and links, including loading and tooltip behavior, plus a deliberately prose-like text action.",
+          "description": "An action needs a canonical button or a prose-like text action.",
           "chooseWhen": [
             "An action needs a canonical button or a prose-like text action."
           ],
@@ -1010,7 +1011,7 @@
         },
         {
           "title": "Button",
-          "description": "The canonical action and link control with semantic variants, loading, tooltip, icon, and native-anchor behavior.",
+          "description": "An action or native navigation link needs the canonical provider-aware button, with optional loading and tooltip behavior.",
           "chooseWhen": [
             "An action or native navigation link needs the canonical provider-aware button, with optional loading and tooltip behavior."
           ],
@@ -1054,7 +1055,7 @@
         },
         {
           "title": "Text button",
-          "description": "A lightweight text-shaped action for low-emphasis controls.",
+          "description": "A low-emphasis action should read like inline text while retaining button semantics.",
           "chooseWhen": [
             "A low-emphasis action should read like inline text while retaining button semantics."
           ],
@@ -1151,7 +1152,7 @@
       "guidance": [
         {
           "title": "Card",
-          "description": "Card, its loading state, flat content composition, body and footer actions, and low-level anatomy in one complete card-family reference.",
+          "description": "A call site owns visible card chrome, card actions, or a card loading state.",
           "chooseWhen": [
             "A call site owns visible card chrome, card actions, or a card loading state."
           ],
@@ -1283,10 +1284,7 @@
         "A bounded ordered set genuinely needs horizontal/vertical slide navigation."
       ],
       "tags": [
-        "base",
-        "carousel",
         "embla-carousel-react",
-        "navigation & data",
         "optional-peer"
       ],
       "aliases": [],
@@ -1296,7 +1294,7 @@
       "guidance": [
         {
           "title": "Carousel",
-          "description": "Embla-backed carousel with keyboard navigation, orientation support, plugins, and base Button controls.",
+          "description": "A bounded ordered set genuinely needs horizontal/vertical slide navigation.",
           "chooseWhen": [
             "A bounded ordered set genuinely needs horizontal/vertical slide navigation."
           ],
@@ -1308,9 +1306,6 @@
             "A bounded ordered set genuinely needs horizontal/vertical slide navigation."
           ],
           "tags": [
-            "base",
-            "navigation & data",
-            "carousel",
             "optional-peer",
             "embla-carousel-react"
           ],
@@ -1435,9 +1430,6 @@
         "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
       ],
       "tags": [
-        "base",
-        "chart",
-        "display",
         "optional-peer",
         "recharts"
       ],
@@ -1448,7 +1440,7 @@
       "guidance": [
         {
           "title": "Chart",
-          "description": "Token-aware Recharts helpers plus a blocks ChartCard for admin analytics surfaces.",
+          "description": "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding.",
           "chooseWhen": [
             "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
           ],
@@ -1460,9 +1452,6 @@
             "Recharts output needs package theme tokens, tooltip, legend, and accessible chart scaffolding."
           ],
           "tags": [
-            "base",
-            "display",
-            "chart",
             "optional-peer",
             "recharts"
           ],
@@ -1577,7 +1566,7 @@
       "guidance": [
         {
           "title": "Choice inputs overview",
-          "description": "Controls for picking from a known set: select, checkbox and switch, the card and list choice groups, and the shared select popup anatomy.",
+          "description": "The user picks from a known set of options, including a binary on/off.",
           "chooseWhen": [
             "The user picks from a known set of options, including a binary on/off."
           ],
@@ -2133,7 +2122,7 @@
       "guidance": [
         {
           "title": "Command",
-          "description": "Density-aware command lists with filtering, groups, shortcuts, disabled rows, and controlled selection callbacks.",
+          "description": "A custom keyboard-searchable command list needs low-level compound anatomy.",
           "chooseWhen": [
             "A custom keyboard-searchable command list needs low-level compound anatomy."
           ],
@@ -2215,7 +2204,7 @@
       "guidance": [
         {
           "title": "Copyable",
-          "description": "Inline value plus a dedicated copy action, localizable feedback, and rich-display composition.",
+          "description": "A displayed scalar or semantic value needs an explicit adjacent clipboard action.",
           "chooseWhen": [
             "A displayed scalar or semantic value needs an explicit adjacent clipboard action."
           ],
@@ -2332,7 +2321,7 @@
       "guidance": [
         {
           "title": "Date pickers overview",
-          "description": "DatePicker (single / range / multiple) and MonthYearPicker — popover-based, locale-aware, with optional year dropdown and time input.",
+          "description": "A form needs single, multiple, range, month/year, or segmented-time date selection.",
           "chooseWhen": [
             "A form needs single, multiple, range, month/year, or segmented-time date selection."
           ],
@@ -2344,9 +2333,6 @@
             "A form needs single, multiple, range, month/year, or segmented-time date selection."
           ],
           "tags": [
-            "base",
-            "forms & inputs",
-            "date-pickers",
             "optional-peer",
             "react-day-picker"
           ],
@@ -2603,7 +2589,7 @@
       "guidance": [
         {
           "title": "Boolean indicator",
-          "description": "Compact yes/no status treatment for boolean fields in admin surfaces.",
+          "description": "A read-only boolean field needs a compact icon and localized yes/no label.",
           "chooseWhen": [
             "A read-only boolean field needs a compact icon and localized yes/no label."
           ],
@@ -2646,7 +2632,7 @@
         },
         {
           "title": "Collapsible",
-          "description": "Base wrapper for inline disclosure and expand/collapse content.",
+          "description": "One custom trigger/content region needs low-level controlled or uncontrolled disclosure.",
           "chooseWhen": [
             "One custom trigger/content region needs low-level controlled or uncontrolled disclosure."
           ],
@@ -2690,7 +2676,7 @@
         },
         {
           "title": "Date block",
-          "description": "Semantic calendar tiles and timeline stamps for event, schedule, booking, and deadline rows.",
+          "description": "A date needs a calendar-like month/day visual block rather than inline formatting.",
           "chooseWhen": [
             "A date needs a calendar-like month/day visual block rather than inline formatting."
           ],
@@ -2737,7 +2723,7 @@
         },
         {
           "title": "Icon badge",
-          "description": "Tokenized icon container for status, resource, and row media affordances.",
+          "description": "An icon needs a consistent framed circular or rounded visual container.",
           "chooseWhen": [
             "An icon needs a consistent framed circular or rounded visual container."
           ],
@@ -2780,7 +2766,7 @@
         },
         {
           "title": "Placeholder pattern",
-          "description": "Subtle diagonal SVG placeholder fill for empty media, maps, and generated previews.",
+          "description": "An empty media, map, or generated-preview region needs a quiet decorative fill.",
           "chooseWhen": [
             "An empty media, map, or generated-preview region needs a quiet decorative fill."
           ],
@@ -2823,7 +2809,7 @@
         },
         {
           "title": "Scroll area",
-          "description": "Styled vertical and horizontal overflow with package-owned scrollbar chrome.",
+          "description": "A bounded region needs styled horizontal or vertical overflow and package scrollbar chrome.",
           "chooseWhen": [
             "A bounded region needs styled horizontal or vertical overflow and package scrollbar chrome."
           ],
@@ -2865,7 +2851,7 @@
         },
         {
           "title": "Separator",
-          "description": "Horizontal and vertical separator wrapper for grouping dense admin content.",
+          "description": "Adjacent groups need a semantic visual divider in horizontal or vertical orientation.",
           "chooseWhen": [
             "Adjacent groups need a semantic visual divider in horizontal or vertical orientation."
           ],
@@ -2908,7 +2894,7 @@
         },
         {
           "title": "Tooltip",
-          "description": "Tooltip provider, trigger, and content wrappers for short contextual help.",
+          "description": "Brief supplementary text should appear on hover and keyboard focus.",
           "chooseWhen": [
             "Brief supplementary text should appear on hover and keyboard focus."
           ],
@@ -2953,7 +2939,7 @@
         },
         {
           "title": "Visually hidden",
-          "description": "Accessible hidden text helper for icon-only controls and nonvisual labels.",
+          "description": "Meaningful text must remain available to assistive technology without visual layout.",
           "chooseWhen": [
             "Meaningful text must remain available to assistive technology without visual layout."
           ],
@@ -3071,7 +3057,7 @@
       "guidance": [
         {
           "title": "Alert",
-          "description": "Semantic notice primitive with icon, title, description, structured metadata, and responsive actions.",
+          "description": "Contextual feedback needs alert semantics plus optional title, description, metadata, or action regions.",
           "chooseWhen": [
             "Contextual feedback needs alert semantics plus optional title, description, metadata, or action regions."
           ],
@@ -3127,7 +3113,7 @@
         },
         {
           "title": "Empty state",
-          "description": "Low-level empty-state composition parts for media, title, description, and actions.",
+          "description": "Custom empty-state anatomy must be assembled from low-level media, header, title, description, and content parts.",
           "chooseWhen": [
             "Custom empty-state anatomy must be assembled from low-level media, header, title, description, and content parts."
           ],
@@ -3169,7 +3155,7 @@
         },
         {
           "title": "Feedback overview",
-          "description": "What a region reports about itself: inline notices, task progress, empty anatomy, and a shared loading and recovery grammar.",
+          "description": "A region must report its own status: an inline notice, task progress, or a standard loading or recoverable-error presentation.",
           "chooseWhen": [
             "A region must report its own status: an inline notice, task progress, or a standard loading or recoverable-error presentation."
           ],
@@ -3288,7 +3274,7 @@
         },
         {
           "title": "Progress",
-          "description": "Accessible, token-driven progress for completion, quota, migration, and indeterminate task states.",
+          "description": "Known completion progress must be represented as a determinate bar.",
           "chooseWhen": [
             "Known completion progress must be represented as a determinate bar."
           ],
@@ -3395,7 +3381,6 @@
         "build",
         "controlled-form-field",
         "dirty-state-banner",
-        "docs",
         "error-summary",
         "form",
         "form-actions-bar",
@@ -3406,7 +3391,6 @@
         "operation-password-form",
         "submit",
         "submit-state-button",
-        "validated-form",
         "validation"
       ],
       "aliases": [],
@@ -3417,7 +3401,7 @@
       "guidance": [
         {
           "title": "Forms overview",
-          "description": "The form-row wrapper, workflow chrome, and the plain field controls — text inputs, selects, toggles, choice groups, date/time, sliders, tags, and phone.",
+          "description": "Editable values need canonical field controls, field chrome, grouped choices, uploads, or form-state recipes.",
           "chooseWhen": [
             "Editable values need canonical field controls, field chrome, grouped choices, uploads, or form-state recipes."
           ],
@@ -3620,7 +3604,7 @@
         },
         {
           "title": "Form field",
-          "description": "Canonical label, control, hint, helper, and error presentation.",
+          "description": "A label, editable control, and hint or error form one accessible field row.",
           "chooseWhen": [
             "A label, editable control, and hint or error form one accessible field row."
           ],
@@ -3791,9 +3775,7 @@
             "Build an application-owned validated form with consistent field and action presentation."
           ],
           "tags": [
-            "docs",
             "build",
-            "validated-form",
             "form",
             "validation",
             "submit"
@@ -3894,7 +3876,7 @@
       "guidance": [
         {
           "title": "Numeric fields overview",
-          "description": "Form controls whose value is a number plus a unit, currency, or rounding policy — decimal, percentage, money, currency, weight, dimensions, coordinates, and rounding mode.",
+          "description": "An editable value is a number carrying a unit, a currency, or a rounding policy.",
           "chooseWhen": [
             "An editable value is a number carrying a unit, a currency, or a rounding policy."
           ],
@@ -4272,6 +4254,90 @@
         }
       ]
     },
+    {
+      "import": "themelia-react-ui/base/inline-edit",
+      "declaration": "dist/components/base/inline-edit/index.d.ts",
+      "symbols": [
+        "InlineEdit",
+        "InlineEditProps",
+        "InlineEditSaveContext",
+        "InlineEditStrings",
+        "defaultInlineEditStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "base",
+      "responsibility": "Base family: Inline edit.",
+      "jobs": [
+        "Inline editing",
+        "Multiline editing",
+        "Save and cancel",
+        "Single-line editing"
+      ],
+      "tags": [
+        "base",
+        "cancel",
+        "draft",
+        "editable text",
+        "field editing",
+        "rename",
+        "save"
+      ],
+      "aliases": [],
+      "sections": [
+        "Base components"
+      ],
+      "guidance": [
+        {
+          "title": "Inline edit",
+          "description": "Readable fields with keyboard editing, validation, async save and cancellation.",
+          "chooseWhen": [
+            "A readable string field needs a reusable view/edit/save/cancel control."
+          ],
+          "avoidWhen": [
+            "Several fields need a complete form workflow or remote resource-assignment selection."
+          ],
+          "appOwned": [
+            "Persistence, permissions, data requests and navigation."
+          ],
+          "jobs": [
+            "Inline editing",
+            "Single-line editing",
+            "Multiline editing",
+            "Save and cancel"
+          ],
+          "tags": [
+            "base",
+            "field editing",
+            "rename",
+            "editable text",
+            "draft",
+            "save",
+            "cancel"
+          ],
+          "aliases": [],
+          "section": "Base components",
+          "browse": {
+            "category": "forms-inputs",
+            "group": "Inline edit",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "InlineEdit"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/base/forms",
+            "themelia-react-ui/base/text-inputs",
+            "themelia-react-ui/features/resource-assignment"
+          ]
+        }
+      ]
+    },
     {
       "import": "themelia-react-ui/base/item",
       "declaration": "dist/components/base/item/index.d.ts",
@@ -4308,7 +4374,7 @@
       "layer": "base",
       "responsibility": "Base family: Item.",
       "jobs": [
-        "Each row has its own identity, media/title stack, target, trailing value, or actions."
+        "Present independent record list entries with identity, supporting copy and actions."
       ],
       "tags": [
         "base",
@@ -4322,16 +4388,20 @@
       "guidance": [
         {
           "title": "Item",
-          "description": "Canonical row primitive — icon/avatar/image media, title + description content, optional actions. Use ItemGroup to compose lists.",
+          "description": "Each row has its own identity, media/title stack, target, trailing value, or actions.",
           "chooseWhen": [
             "Each row has its own identity, media/title stack, target, trailing value, or actions."
           ],
           "avoidWhen": [
             "The rows are label/value facts about one entity or merely passive sibling layout."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "record priority",
+            "navigation and actions",
+            "selection state"
+          ],
           "jobs": [
-            "Each row has its own identity, media/title stack, target, trailing value, or actions."
+            "Present independent record list entries with identity, supporting copy and actions."
           ],
           "tags": [
             "base",
@@ -4541,7 +4611,7 @@
       "guidance": [
         {
           "title": "Navigation overview",
-          "description": "The navigation controls — PageHeading, Breadcrumbs, LanguageSwitcher, NavigationTabs, OverflowTabBar, and the dropdown-menu parts.",
+          "description": "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy.",
           "chooseWhen": [
             "Page headings, breadcrumbs, pagination, tabs, or a language switcher need canonical navigation anatomy."
           ],
@@ -4727,7 +4797,7 @@
         },
         {
           "title": "Navigation tabs",
-          "description": "Canonical route-tab navigation with a compact default, a prominent variant, optional icons and badges, and consumer-owned current path.",
+          "description": "A small, always-visible set of sibling application routes needs compact or prominent tab navigation.",
           "chooseWhen": [
             "A small, always-visible set of sibling application routes needs compact or prominent tab navigation."
           ],
@@ -4812,7 +4882,7 @@
         },
         {
           "title": "Page heading",
-          "description": "A framework-agnostic visual heading block with eyebrow, description, badge, and action composition. Use layout PageHeader when the page shell owns navigation and page-level chrome.",
+          "description": "An existing shell needs only a visual title, description, badges, and actions block.",
           "chooseWhen": [
             "An existing shell needs only a visual title, description, badges, and actions block."
           ],
@@ -4934,7 +5004,7 @@
       "guidance": [
         {
           "title": "Popover",
-          "description": "A tokenized popover surface with compound trigger, header, title, description, anchor, and positioning parts.",
+          "description": "A trigger needs a small anchored custom content surface with explicit compound control.",
           "chooseWhen": [
             "A trigger needs a small anchored custom content surface with explicit compound control."
           ],
@@ -5021,7 +5091,7 @@
       "guidance": [
         {
           "title": "Popover menu",
-          "description": "A reusable trigger, search, command-list, and selection shell with typed items, slots, strings, and controlled state seams.",
+          "description": "A trigger opens the recurring optional-header, search, list, and footer menu pattern.",
           "chooseWhen": [
             "A trigger opens the recurring optional-header, search, list, and footer menu pattern."
           ],
@@ -5098,11 +5168,8 @@
         "A string must be rendered as a QR code with an accessible label and optional logo."
       ],
       "tags": [
-        "base",
         "culori",
-        "display",
         "optional-peer",
-        "qr-code",
         "qrcode"
       ],
       "aliases": [],
@@ -5112,7 +5179,7 @@
       "guidance": [
         {
           "title": "QR code",
-          "description": "QR code display wrapper for share links, check-in codes, and payment references.",
+          "description": "A string must be rendered as a QR code with an accessible label and optional logo.",
           "chooseWhen": [
             "A string must be rendered as a QR code with an accessible label and optional logo."
           ],
@@ -5124,9 +5191,6 @@
             "A string must be rendered as a QR code with an accessible label and optional logo."
           ],
           "tags": [
-            "base",
-            "display",
-            "qr-code",
             "optional-peer",
             "qrcode",
             "culori"
@@ -5234,7 +5298,7 @@
       "guidance": [
         {
           "title": "Repeaters overview",
-          "description": "Repeating and locale-keyed field collections — the repeater engine, string and object repeaters, the key-value editor, and the localized field set.",
+          "description": "A field edits a list of rows the person adds, removes, and reorders, or a value keyed by locale.",
           "chooseWhen": [
             "A field edits a list of rows the person adds, removes, and reorders, or a value keyed by locale."
           ],
@@ -5571,7 +5635,7 @@
       "guidance": [
         {
           "title": "Sheet",
-          "description": "A public compound surface for controlled or trigger-driven slide-in panels from any viewport edge.",
+          "description": "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy.",
           "chooseWhen": [
             "A custom side-attached overlay needs low-level trigger/content/header/footer anatomy."
           ],
@@ -5680,7 +5744,7 @@
       "guidance": [
         {
           "title": "Sidebar primitives",
-          "description": "Tokenized low-level provider, shell, groups, menus, nested links, badges, inputs, actions, and loading parts behind app sidebars.",
+          "description": "A shell implementation needs the low-level responsive/collapsible sidebar compound.",
           "chooseWhen": [
             "A shell implementation needs the low-level responsive/collapsible sidebar compound."
           ],
@@ -5845,7 +5909,7 @@
       "guidance": [
         {
           "title": "Skeleton overview",
-          "description": "Reusable loading skeletons for content rows, pages, two-column detail views, and tables.",
+          "description": "Loading should preserve the approximate geometry of content, cards, tables, or pages.",
           "chooseWhen": [
             "Loading should preserve the approximate geometry of content, cards, tables, or pages."
           ],
@@ -6111,7 +6175,7 @@
       "guidance": [
         {
           "title": "Spinner",
-          "description": "Loading indicator with three visual variants. Pairs with content placeholders, route transitions, and Suspense fallbacks.",
+          "description": "A compact control or bounded area needs an indeterminate activity indicator.",
           "chooseWhen": [
             "A compact control or bounded area needs an indeterminate activity indicator."
           ],
@@ -6208,7 +6272,7 @@
       "guidance": [
         {
           "title": "Structural composition",
-          "description": "Stack, Grid, GridCell, and AdaptiveGrid provide one truthful grammar for passive sibling arrangement.",
+          "description": "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks.",
           "chooseWhen": [
             "Passive siblings need one-axis spacing, explicit responsive tracks, or available-width-driven equal tracks."
           ],
@@ -6312,7 +6376,7 @@
       "guidance": [
         {
           "title": "Table primitives",
-          "description": "Styled table elements that wrap shadcn table parts with package density, spacing, and stable DOM hooks.",
+          "description": "Custom semantic table markup only needs package-styled HTML table parts.",
           "chooseWhen": [
             "Custom semantic table markup only needs package-styled HTML table parts."
           ],
@@ -6412,7 +6476,7 @@
       "guidance": [
         {
           "title": "Text inputs overview",
-          "description": "Controls for free-form text entry: the input itself, its multi-line and grouped forms, and the password and slug variants.",
+          "description": "The value is free-form text the user types.",
           "chooseWhen": [
             "The value is free-form text the user types."
           ],
@@ -6618,11 +6682,8 @@
         "Application-level transient feedback should be rendered through the package Sonner host."
       ],
       "tags": [
-        "base",
-        "feedback",
         "optional-peer",
-        "sonner",
-        "toaster"
+        "sonner"
       ],
       "aliases": [],
       "sections": [
@@ -6631,7 +6692,7 @@
       "guidance": [
         {
           "title": "Toaster",
-          "description": "Provider-backed Sonner wrapper with refined admin notification chrome and bottom-center defaults.",
+          "description": "Application-level transient feedback should be rendered through the package Sonner host.",
           "chooseWhen": [
             "Application-level transient feedback should be rendered through the package Sonner host."
           ],
@@ -6643,9 +6704,6 @@
             "Application-level transient feedback should be rendered through the package Sonner host."
           ],
           "tags": [
-            "base",
-            "feedback",
-            "toaster",
             "optional-peer",
             "sonner"
           ],
@@ -6813,7 +6871,7 @@
       "guidance": [
         {
           "title": "Upload overview",
-          "description": "File and media surfaces — dropzone, file/image/avatar upload, progress list, upload tray, and media gallery. The consumer always owns the transfer.",
+          "description": "A surface selects, validates, previews, or reports progress for files the consumer will transfer.",
           "chooseWhen": [
             "A surface selects, validates, previews, or reports progress for files the consumer will transfer."
           ],
@@ -7201,7 +7259,7 @@
       "guidance": [
         {
           "title": "Value inputs overview",
-          "description": "Controls that edit one structured value through a bespoke affordance: tags, phone numbers, colours, ranges, and date-time.",
+          "description": "One structured value needs its own editing affordance — tags, phone, colour, range, date-time.",
           "chooseWhen": [
             "One structured value needs its own editing affordance — tags, phone, colour, range, date-time."
           ],
@@ -7243,7 +7301,7 @@
         },
         {
           "title": "Color input",
-          "description": "Exact CSS-color entry paired with an accessible visual color picker and live swatch.",
+          "description": "A form needs exact CSS-color entry and an accessible visual color picker on one value channel.",
           "chooseWhen": [
             "A form needs exact CSS-color entry and an accessible visual color picker on one value channel."
           ],
@@ -7494,7 +7552,7 @@
       "guidance": [
         {
           "title": "Admin overview",
-          "description": "Role permissions, credential lists, and security action surfaces for admin settings pages — the parts of an admin screen that are worth standardizing.",
+          "description": "Console screens need permission matrices, API-key and token management, or confirmation-gated destructive actions.",
           "chooseWhen": [
             "Console screens need permission matrices, API-key and token management, or confirmation-gated destructive actions."
           ],
@@ -7844,7 +7902,7 @@
       "guidance": [
         {
           "title": "AI overview",
-          "description": "Card-free AI presentation blocks — summaries, reasoning traces, tool calls, citations, artifacts — that the consumer frames, fills, and wires.",
+          "description": "Model output needs a presentation block — summary, reasoning, citation, tool call, artifact — inside a surface the app already owns.",
           "chooseWhen": [
             "Model output needs a presentation block — summary, reasoning, citation, tool call, artifact — inside a surface the app already owns."
           ],
@@ -8819,9 +8877,19 @@
         "TimeDistributionRuler",
         "TimeDistributionRulerProps",
         "TimeDistributionRulerStrings",
+        "UsageCard",
+        "UsageCardCategory",
+        "UsageCardData",
+        "UsageCardDay",
+        "UsageCardPeriod",
+        "UsageCardProps",
+        "UsageCardQuota",
+        "UsageCardResource",
+        "UsageCardStrings",
         "defaultAnalyticsStrings",
         "defaultMetricComparisonStrings",
         "defaultTimeDistributionRulerStrings",
+        "defaultUsageCardStrings",
         "formatMetricValue",
         "resolveTrend"
       ],
@@ -8864,7 +8932,7 @@
       "guidance": [
         {
           "title": "Analytics overview",
-          "description": "One Metric data contract for KPI variants, bars, grids, trends, and sparklines, plus ChartCard for caller-owned chart series.",
+          "description": "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics.",
           "chooseWhen": [
             "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics."
           ],
@@ -8876,8 +8944,6 @@
             "KPI values need trend, comparison, sparkline, bar, heatmap, or dashboard-grid semantics."
           ],
           "tags": [
-            "blocks",
-            "analytics",
             "optional-peer",
             "recharts"
           ],
@@ -9281,6 +9347,92 @@
         }
       ]
     },
+    {
+      "import": "themelia-react-ui/blocks/analytics/usage-card",
+      "declaration": "dist/components/blocks/analytics/usage-card/index.d.ts",
+      "symbols": [
+        "UsageCard",
+        "UsageCardCategory",
+        "UsageCardData",
+        "UsageCardDay",
+        "UsageCardPeriod",
+        "UsageCardProps",
+        "UsageCardQuota",
+        "UsageCardResource",
+        "UsageCardStrings",
+        "defaultUsageCardStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "blocks",
+      "responsibility": "Blocks family: Usage card.",
+      "jobs": [
+        "Daily usage",
+        "Period selection",
+        "Quota summary"
+      ],
+      "tags": [
+        "billing summary",
+        "blocks",
+        "credits",
+        "daily analytics",
+        "quota",
+        "resources",
+        "usage"
+      ],
+      "aliases": [],
+      "sections": [
+        "Blocks"
+      ],
+      "guidance": [
+        {
+          "title": "Usage card",
+          "description": "Quota summaries, category shares, daily analytics and resource limits with app-owned period data.",
+          "chooseWhen": [
+            "Application-supplied usage needs a composed quota and analytics summary."
+          ],
+          "avoidWhen": [
+            "The component needs to fetch billing data or execute subscription changes itself."
+          ],
+          "appOwned": [
+            "Persistence, permissions, data requests and navigation."
+          ],
+          "jobs": [
+            "Quota summary",
+            "Daily usage",
+            "Period selection"
+          ],
+          "tags": [
+            "blocks",
+            "usage",
+            "quota",
+            "credits",
+            "daily analytics",
+            "resources",
+            "billing summary"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Analytics",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "UsageCard"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/base/feedback",
+            "themelia-react-ui/blocks/analytics"
+          ]
+        }
+      ]
+    },
     {
       "import": "themelia-react-ui/blocks/collaboration",
       "declaration": "dist/components/blocks/collaboration/index.d.ts",
@@ -9576,7 +9728,7 @@
       "guidance": [
         {
           "title": "Commerce overview",
-          "description": "Read-mostly display blocks for recognisable commerce subjects — orders, invoices, carts, shipments, bookings, giftcards, and vendors.",
+          "description": "A screen renders a recognisable commerce subject — order, invoice, cart, shipment, giftcard, booking, vendor — as read-mostly display.",
           "chooseWhen": [
             "A screen renders a recognisable commerce subject — order, invoice, cart, shipment, giftcard, booking, vendor — as read-mostly display."
           ],
@@ -10815,7 +10967,10 @@
         "blocks/empty-state",
         "blocks/inline-stat",
         "blocks/metadata-list",
-        "blocks/relationship-card-frame"
+        "blocks/relationship-card-frame",
+        "contact details",
+        "fact list",
+        "read-only facts"
       ],
       "sections": [
         "Blocks"
@@ -10823,7 +10978,7 @@
       "guidance": [
         {
           "title": "Data display overview",
-          "description": "Generic, domain-free readouts: entity facts, single stats, dense info cards, relationship frames, and the standard empty state.",
+          "description": "Entity facts, relationships, dense readouts, or empty regions need the package recipe instead of an app-local one.",
           "chooseWhen": [
             "Entity facts, relationships, dense readouts, or empty regions need the package recipe instead of an app-local one."
           ],
@@ -10865,7 +11020,7 @@
         },
         {
           "title": "Dense info",
-          "description": "Five layout variants — dashboard, classification, financial, project, score.",
+          "description": "A dashboard, classification, financial, project, or score readout needs many facts in one tight card.",
           "chooseWhen": [
             "A dashboard, classification, financial, project, or score readout needs many facts in one tight card."
           ],
@@ -10919,7 +11074,7 @@
         },
         {
           "title": "Empty state",
-          "description": "Adaptive zero-data surface. Wrap with the right illustration per resource — products, users, search results, inbox. Slots for media / actions / footer; consumer overrides every string.",
+          "description": "No-data, no-results, or first-run content needs the standard media, title, description, and actions recipe.",
           "chooseWhen": [
             "No-data, no-results, or first-run content needs the standard media, title, description, and actions recipe."
           ],
@@ -10980,7 +11135,7 @@
         },
         {
           "title": "Inline stat",
-          "description": "Inline label/value pairs for counters, totals, and compact card rows. Use MetadataList for entity detail fields.",
+          "description": "One compact label/value pair needs inline emphasis without trend or chart semantics.",
           "chooseWhen": [
             "One compact label/value pair needs inline emphasis without trend or chart semantics."
           ],
@@ -11030,14 +11185,18 @@
         },
         {
           "title": "Metadata list",
-          "description": "Flexible label/value facts with strong grid, rows, and inline defaults; responsive columns; typed value descriptors; and first-class empty handling.",
+          "description": "Customer, order, account, or record label/value facts need a grid, rows, or inline summary.",
           "chooseWhen": [
             "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
           ],
           "avoidWhen": [
             "Each row has independent identity/actions or the relationship needs title, alerts, and action regions."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "fact labels and priority",
+            "loaded subject data",
+            "formatting defaults"
+          ],
           "jobs": [
             "Customer, order, account, or record label/value facts need a grid, rows, or inline summary."
           ],
@@ -11048,7 +11207,10 @@
             "metadata-list"
           ],
           "aliases": [
-            "blocks/metadata-list"
+            "blocks/metadata-list",
+            "fact list",
+            "read-only facts",
+            "contact details"
           ],
           "section": "Blocks",
           "browse": {
@@ -11100,7 +11262,7 @@
         },
         {
           "title": "Relationship card frame",
-          "description": "Card-free title, badge, alert, selector, metadata, action, and details regions for app-owned relationship content.",
+          "description": "App-owned relationship content needs title, badge, alert, selector, metadata, actions, and details regions.",
           "chooseWhen": [
             "App-owned relationship content needs title, badge, alert, selector, metadata, actions, and details regions."
           ],
@@ -11227,6 +11389,88 @@
         }
       ]
     },
+    {
+      "import": "themelia-react-ui/blocks/planning",
+      "declaration": "dist/components/blocks/planning/index.d.ts",
+      "symbols": [
+        "TaskCard",
+        "TaskCardDueDate",
+        "TaskCardItem",
+        "TaskCardProps",
+        "TaskCardStatus",
+        "TaskCardStrings",
+        "defaultTaskCardStrings"
+      ],
+      "optionalPeers": [],
+      "layer": "blocks",
+      "responsibility": "Blocks family: Task card.",
+      "jobs": [
+        "Assignment",
+        "Controlled checklist",
+        "Task summary"
+      ],
+      "tags": [
+        "assignee",
+        "blocks",
+        "checklist",
+        "progress",
+        "subtasks",
+        "task"
+      ],
+      "aliases": [],
+      "sections": [
+        "Blocks"
+      ],
+      "guidance": [
+        {
+          "title": "Task card",
+          "description": "Compact task summaries with accessible expansion, controlled subtasks and assignment.",
+          "chooseWhen": [
+            "A task needs a compact summary with optional expanded controlled subtasks."
+          ],
+          "avoidWhen": [
+            "A complete task board or task-persistence workflow is required."
+          ],
+          "appOwned": [
+            "Persistence, permissions, data requests and navigation."
+          ],
+          "jobs": [
+            "Task summary",
+            "Controlled checklist",
+            "Assignment"
+          ],
+          "tags": [
+            "blocks",
+            "task",
+            "checklist",
+            "subtasks",
+            "assignee",
+            "progress"
+          ],
+          "aliases": [],
+          "section": "Blocks",
+          "browse": {
+            "category": "domain-ui",
+            "group": "Planning",
+            "domain": "",
+            "collection": ""
+          },
+          "sections": [
+            {
+              "title": "API",
+              "symbols": [
+                "TaskCard"
+              ]
+            }
+          ],
+          "alternatives": [
+            "themelia-react-ui/blocks/ai",
+            "themelia-react-ui/blocks/onboarding",
+            "themelia-react-ui/features/kanban"
+          ]
+        }
+      ]
+    },
     {
       "import": "themelia-react-ui/blocks/timelines",
       "declaration": "dist/components/blocks/timelines/index.d.ts",
@@ -11280,7 +11524,7 @@
       "guidance": [
         {
           "title": "Timelines overview",
-          "description": "The shared marker-rail engine plus its domain-neutral readings: finite steps, release changelogs, and project milestones. Mixed audit, domain, system, and comment activity belongs to the Features activity log instead.",
+          "description": "Read-only milestones, steps, or changelogs need marker-rail presentation, or a new rail needs the shared Timeline engine.",
           "chooseWhen": [
             "Read-only milestones, steps, or changelogs need marker-rail presentation, or a new rail needs the shared Timeline engine."
           ],
@@ -11595,11 +11839,9 @@
       "tags": [
         "activities",
         "activity",
-        "activity-timeline",
         "audit",
         "build",
         "collaboration",
-        "docs",
         "features",
         "timeline"
       ],
@@ -11627,9 +11869,7 @@
             "Build an auditable resource history with mixed events, comments, and milestones."
           ],
           "tags": [
-            "docs",
             "build",
-            "activity-timeline",
             "activity",
             "timeline",
             "audit"
@@ -11660,7 +11900,7 @@
         },
         {
           "title": "Activity log",
-          "description": "One canonical collaboration activity surface: comments, composer, audit events, system events, domain events, mentions, row actions, metadata, changes, and collapsible details under one chronological timeline.",
+          "description": "Mixed comments, audit/domain/system events, adapters, metadata, details, and row actions share one log.",
           "chooseWhen": [
             "Mixed comments, audit/domain/system events, adapters, metadata, details, and row actions share one log."
           ],
@@ -11893,7 +12133,7 @@
       "guidance": [
         {
           "title": "Async preview",
-          "description": "Accessible hover, focus, cell, and inline previews with callback-owned fetching, caching, and state composition.",
+          "description": "A lazy or preloaded hover preview is needed inline or from a table cell trigger.",
           "chooseWhen": [
             "A lazy or preloaded hover preview is needed inline or from a table cell trigger."
           ],
@@ -11994,10 +12234,8 @@
       "tags": [
         "async",
         "async-resource-combobox",
-        "async-selection",
         "build",
         "combobox",
-        "docs",
         "features",
         "inputs",
         "retry"
@@ -12026,9 +12264,7 @@
             "Build an async resource selector that handles rejection, retry, and fast-changing queries."
           ],
           "tags": [
-            "docs",
             "build",
-            "async-selection",
             "async",
             "combobox",
             "retry"
@@ -12059,7 +12295,7 @@
         },
         {
           "title": "Combobox",
-          "description": "Searchable single, multiple, grouped, creatable, and async selectors with consumer-owned options and fetch lifecycle.",
+          "description": "A field needs searchable single/multiple selection, async resource lookup, or headless combobox composition.",
           "chooseWhen": [
             "A field needs searchable single/multiple selection, async resource lookup, or headless combobox composition."
           ],
@@ -12323,24 +12559,22 @@
       "layer": "features",
       "responsibility": "Features family: Data view; Operational index.",
       "jobs": [
-        "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots.",
-        "Build a filtered operational index with selection, actions, and formatted cells."
+        "Build a filtered operational index with selection, actions, and formatted cells.",
+        "Compose a coordinated record directory when the feature query, view and collection contracts fit."
       ],
       "tags": [
         "build",
-        "data-view",
-        "docs",
-        "features",
         "filters",
         "index",
-        "operational-index",
         "optional-peer",
         "table",
-        "tables",
         "tanstack-react-table"
       ],
       "aliases": [
-        "docs/composition-recipes"
+        "contacts list",
+        "docs/composition-recipes",
+        "record directory",
+        "scoped collection"
       ],
       "sections": [
         "Features",
@@ -12365,9 +12599,7 @@
             "Build a filtered operational index with selection, actions, and formatted cells."
           ],
           "tags": [
-            "docs",
             "build",
-            "operational-index",
             "index",
             "table",
             "filters"
@@ -12400,25 +12632,30 @@
         },
         {
           "title": "Data view",
-          "description": "Controlled data-view chrome for tables, filters, saved views, and pagination. Consumers own fetching, query state, table data, and persistence.",
+          "description": "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots.",
           "chooseWhen": [
             "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots."
           ],
           "avoidWhen": [
             "Only table behavior is needed or the page already owns a different index/workspace composition."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "fixed scope versus editable criteria",
+            "server transport and authoritative records",
+            "record priority, permissions and commands"
+          ],
           "jobs": [
-            "A standard filtered customer, booking, product, or resource index coordinates rows, columns, saved views, and named toolbar/footer slots."
+            "Compose a coordinated record directory when the feature query, view and collection contracts fit."
           ],
           "tags": [
-            "features",
-            "tables",
-            "data-view",
             "optional-peer",
             "tanstack-react-table"
           ],
-          "aliases": [],
+          "aliases": [
+            "record directory",
+            "scoped collection",
+            "contacts list"
+          ],
           "section": "Features",
           "browse": {
             "category": "data-display",
@@ -12497,9 +12734,7 @@
         "Compose and prepare personalized email with application-owned delivery."
       ],
       "tags": [
-        "collaboration",
         "email",
-        "features",
         "optional-peer",
         "templates",
         "tiptap"
@@ -12524,12 +12759,10 @@
             "Compose and prepare personalized email with application-owned delivery."
           ],
           "tags": [
-            "features",
-            "collaboration",
-            "email",
-            "templates",
             "optional-peer",
-            "tiptap"
+            "tiptap",
+            "email",
+            "templates"
           ],
           "aliases": [],
           "section": "Features",
@@ -12673,7 +12906,7 @@
       "guidance": [
         {
           "title": "Event calendar",
-          "description": "Month view with categories, filtering, navigation rules, custom event rendering, and three day-heading variants.",
+          "description": "Events need month/week/agenda browsing, categories, day rendering, and callback-driven actions.",
           "chooseWhen": [
             "Events need month/week/agenda browsing, categories, day rendering, and callback-driven actions."
           ],
@@ -12943,21 +13176,27 @@
         "filters",
         "search & filter"
       ],
-      "aliases": [],
+      "aliases": [
+        "query toolbar"
+      ],
       "sections": [
         "Features"
       ],
       "guidance": [
         {
           "title": "Filters",
-          "description": "Composable filter system. Search + multi-select stay always visible; the rest collapse behind a Filters button. Provider-driven so it works with any data source.",
+          "description": "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job.",
           "chooseWhen": [
             "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job."
           ],
           "avoidWhen": [
             "A complete table/index frame is desired with minimal assembly."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "query transport and scope retention",
+            "criteria definitions and options",
+            "server results and request lifecycle"
+          ],
           "jobs": [
             "Controlled facets, operators, active-filter chrome, validation, or query serialization are the primary job."
           ],
@@ -12966,7 +13205,9 @@
             "search & filter",
             "filters"
           ],
-          "aliases": [],
+          "aliases": [
+            "query toolbar"
+          ],
           "section": "Features",
           "browse": {
             "category": "workflows-features",
@@ -13142,10 +13383,7 @@
         "Use Kanban in an admin interface."
       ],
       "tags": [
-        "boards",
         "dnd-kit",
-        "features",
-        "kanban",
         "optional-peer"
       ],
       "aliases": [],
@@ -13163,9 +13401,6 @@
             "Use Kanban in an admin interface."
           ],
           "tags": [
-            "features",
-            "boards",
-            "kanban",
             "optional-peer",
             "dnd-kit"
           ],
@@ -13276,7 +13511,7 @@
       "guidance": [
         {
           "title": "Map",
-          "description": "Leaflet-backed map primitives — Map shell, MapTileLayer, MapMarker, MapPopup. Always wrap in a fixed-height container.",
+          "description": "A Leaflet map needs package controls, layers, markers, drawing, localization, or place search.",
           "chooseWhen": [
             "A Leaflet map needs package controls, layers, markers, drawing, localization, or place search."
           ],
@@ -13288,9 +13523,6 @@
             "A Leaflet map needs package controls, layers, markers, drawing, localization, or place search."
           ],
           "tags": [
-            "features",
-            "navigation & data",
-            "map",
             "optional-peer",
             "leaflet",
             "react-leaflet"
@@ -13450,14 +13682,9 @@
         "Use Media library in an admin interface."
       ],
       "tags": [
-        "assets",
         "build",
         "dnd-kit",
-        "docs",
-        "features",
         "media",
-        "media-library",
-        "media-workflow",
         "optional-peer",
         "selection",
         "upload"
@@ -13486,9 +13713,7 @@
             "Build a media selection workflow with app-owned storage services and package-owned UI states."
           ],
           "tags": [
-            "docs",
             "build",
-            "media-workflow",
             "media",
             "upload",
             "selection"
@@ -13526,9 +13751,6 @@
             "Use Media library in an admin interface."
           ],
           "tags": [
-            "features",
-            "assets",
-            "media-library",
             "optional-peer",
             "dnd-kit"
           ],
@@ -13723,7 +13945,7 @@
       "guidance": [
         {
           "title": "Action overlays",
-          "description": "Callback-driven ActionDialog, ActionDrawer, and ConfirmDialog recipes blocks over the base Dialog, Sheet, and AlertDialog primitives.",
+          "description": "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior.",
           "chooseWhen": [
             "A modal, drawer, or confirmation needs standardized confirm/cancel, async loading, error, strings, and tone behavior."
           ],
@@ -13910,7 +14132,7 @@
       "guidance": [
         {
           "title": "Products",
-          "description": "Shopify-style product editor surfaces built from standalone product feature components. Routing, forms, and persistence stay consumer-owned.",
+          "description": "Product workspace/editor state, options, variants, tables, support rails, and callbacks must compose together.",
           "chooseWhen": [
             "Product workspace/editor state, options, variants, tables, support rails, and callbacks must compose together."
           ],
@@ -14471,10 +14693,7 @@
         "Use Rich text editor in an admin interface."
       ],
       "tags": [
-        "features",
-        "inputs",
         "optional-peer",
-        "rich-text",
         "tiptap"
       ],
       "aliases": [],
@@ -14492,9 +14711,6 @@
             "Use Rich text editor in an admin interface."
           ],
           "tags": [
-            "features",
-            "inputs",
-            "rich-text",
             "optional-peer",
             "tiptap"
           ],
@@ -14854,41 +15070,47 @@
       "layer": "features",
       "responsibility": "Features family: Data table.",
       "jobs": [
-        "Table columns, cells, sorting, selection, density, sticky behavior, or row actions are needed without index-page coordination."
+        "Compare records in columns; use ResourceCell for identity cells and CellStack for prioritized supporting values.",
+        "Place app-controlled query tools in topbarContent, export in topbarEnd, and selection commands in bulkActions."
       ],
       "tags": [
-        "features",
         "optional-peer",
-        "table",
-        "tables",
         "tanstack-react-table"
       ],
-      "aliases": [],
+      "aliases": [
+        "comparison table",
+        "identity cell"
+      ],
       "sections": [
         "Features"
       ],
       "guidance": [
         {
           "title": "Data table",
-          "description": "Admin-dense table presentation with sorting, selection, actions, typed cells, toolbar slots, sticky behavior, and pagination.",
+          "description": "Comparison columns, identity cells, sorting, selection or row actions are needed with app-owned query coordination and native toolbar/pagination seams.",
           "chooseWhen": [
-            "Table columns, cells, sorting, selection, density, sticky behavior, or row actions are needed without index-page coordination."
+            "Comparison columns, identity cells, sorting, selection or row actions are needed with app-owned query coordination and native toolbar/pagination seams."
           ],
           "avoidWhen": [
-            "The standard page also needs filter coordination, saved views, framing, and pagination slots."
+            "DataView already covers the required coordinated index workflow, or records do not benefit from comparison columns."
+          ],
+          "appOwned": [
+            "records and row IDs",
+            "query transport, server paging and scope",
+            "column priority, permissioned commands and navigation"
           ],
-          "appOwned": [],
           "jobs": [
-            "Table columns, cells, sorting, selection, density, sticky behavior, or row actions are needed without index-page coordination."
+            "Compare records in columns; use ResourceCell for identity cells and CellStack for prioritized supporting values.",
+            "Place app-controlled query tools in topbarContent, export in topbarEnd, and selection commands in bulkActions."
           ],
           "tags": [
-            "features",
-            "tables",
-            "table",
             "optional-peer",
             "tanstack-react-table"
           ],
-          "aliases": [],
+          "aliases": [
+            "comparison table",
+            "identity cell"
+          ],
           "section": "Features",
           "browse": {
             "category": "data-display",
@@ -15005,11 +15227,9 @@
       "tags": [
         "build",
         "configuration",
-        "docs",
         "features",
         "provider",
         "tenant",
-        "tenant-theme",
         "theme",
         "theme-tweaker"
       ],
@@ -15037,9 +15257,7 @@
             "Build a tenant theme boundary that coordinates public variables and UIProvider defaults."
           ],
           "tags": [
-            "docs",
             "build",
-            "tenant-theme",
             "theme",
             "tenant",
             "provider"
@@ -15068,7 +15286,7 @@
         },
         {
           "title": "Theme tweaker",
-          "description": "Interactive CSS-variable theme editor with scoped application, portal-safe provider composition, and checked CSS/UIProvider export.",
+          "description": "A consumer needs an interactive theme studio, derived brand/type/elevation recipes, scoped or document-level live preview, a combined root theme/config boundary, complete or compact CSS export, or a typed UIProvider recipe.",
           "chooseWhen": [
             "A consumer needs an interactive theme studio, derived brand/type/elevation recipes, scoped or document-level live preview, a combined root theme/config boundary, complete or compact CSS export, or a typed UIProvider recipe."
           ],
@@ -15409,9 +15627,7 @@
       ],
       "tags": [
         "app-shell",
-        "application-shell",
         "build",
-        "docs",
         "layout",
         "navigation",
         "responsive",
@@ -15442,9 +15658,7 @@
             "Build a responsive admin application shell with header, sidebar, navigation, and one page viewport."
           ],
           "tags": [
-            "docs",
             "build",
-            "application-shell",
             "shell",
             "navigation",
             "responsive"
@@ -15671,7 +15885,7 @@
       "guidance": [
         {
           "title": "Containers",
-          "description": "Width, scroll, semantic section, and two-column owners for framework-neutral page composition.",
+          "description": "Page composition needs one explicit owner for content width, page scrolling, semantic section rhythm, or a main/aside split.",
           "chooseWhen": [
             "Page composition needs one explicit owner for content width, page scrolling, semantic section rhythm, or a main/aside split."
           ],
@@ -15930,7 +16144,7 @@
       "guidance": [
         {
           "title": "Navigation regions",
-          "description": "The navigation regions that frame a page — SideNav, SectionNav, CategoryNav, and BreadcrumbProgress.",
+          "description": "A vertical route rail, in-page anchor nav, category browse rail, or multi-step progress trail needs to frame content it does not own.",
           "chooseWhen": [
             "A vertical route rail, in-page anchor nav, category browse rail, or multi-step progress trail needs to frame content it does not own."
           ],
@@ -16120,15 +16334,17 @@
       "tags": [
         "build",
         "detail",
-        "docs",
         "layout",
         "metadata",
         "page",
         "relationships",
-        "resource-detail",
         "shells"
       ],
-      "aliases": [],
+      "aliases": [
+        "page header",
+        "route heading",
+        "scope navigation"
+      ],
       "sections": [
         "Layouts",
         "Recipes"
@@ -16152,9 +16368,7 @@
             "Build a responsive resource detail page with primary facts, related context, and actions."
           ],
           "tags": [
-            "docs",
             "build",
-            "resource-detail",
             "detail",
             "metadata",
             "relationships"
@@ -16185,14 +16399,18 @@
         },
         {
           "title": "Page shell",
-          "description": "Framework-neutral page header, actions, containment, and body composition without duplicate scroll ownership.",
+          "description": "A page needs shell-level title, back/link rendering, actions, content, and page composition slots.",
           "chooseWhen": [
             "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
           ],
           "avoidWhen": [
             "An existing shell needs only a visual title/description/badge block."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "route title and contextual lead",
+            "primary command importance",
+            "navigation callbacks and permissioned actions"
+          ],
           "jobs": [
             "A page needs shell-level title, back/link rendering, actions, content, and page composition slots."
           ],
@@ -16201,7 +16419,11 @@
             "shells",
             "page"
           ],
-          "aliases": [],
+          "aliases": [
+            "page header",
+            "route heading",
+            "scope navigation"
+          ],
           "section": "Layouts",
           "browse": {
             "category": "layout-shells",
@@ -16597,7 +16819,7 @@
       "guidance": [
         {
           "title": "Primitives overview",
-          "description": "Semantic display primitives for identities, values, links, money, numbers, durations, dimensions, file sizes, and dates. Use these before hand-rolling text classes in metadata, cards, tables, previews, and activity surfaces.",
+          "description": "Displayed data has money, date, contact, identity, code, numeric, duration, or empty-value semantics.",
           "chooseWhen": [
             "Displayed data has money, date, contact, identity, code, numeric, duration, or empty-value semantics."
           ],
@@ -17170,13 +17392,10 @@
       "tags": [
         "actions",
         "feedback",
-        "foundations",
         "lifecycle",
         "overlays",
         "request-runner",
-        "runtime",
-        "runtime & provider",
-        "services"
+        "runtime"
       ],
       "aliases": [],
       "sections": [
@@ -17197,9 +17416,6 @@
             "Share one action definition across buttons, menus, command results, and overlays without coupling the package to an application framework."
           ],
           "tags": [
-            "foundations",
-            "runtime & provider",
-            "services",
             "actions",
             "runtime",
             "lifecycle",
@@ -17287,7 +17503,7 @@
       "guidance": [
         {
           "title": "Typography",
-          "description": "Heading, Text, DisplayLabel, Label, and TextLink — the typography primitives every higher layer composes from.",
+          "description": "Library-owned prose, headings, labels, or text links need a typography role.",
           "chooseWhen": [
             "Library-owned prose, headings, labels, or text links need a typography role."
           ],
@@ -17453,18 +17669,19 @@
       "layer": "foundations",
       "responsibility": "Stable display defaults through UIProvider and a basic CSS-inheritance ThemeScope with native div/style props and portal hosting. The root re-exports this same ThemeScope.",
       "jobs": [
+        "Host a CSS-inheriting ThemeScope and its portals at a theme boundary.",
         "Set locale, density, formatting, and component defaults once without moving request or application state into the package."
       ],
       "tags": [
         "configuration",
         "display-defaults",
-        "foundations",
         "provider",
-        "runtime",
-        "runtime & provider",
-        "ui-provider"
+        "runtime"
+      ],
+      "aliases": [
+        "theme boundary",
+        "theming"
       ],
-      "aliases": [],
       "sections": [
         "Foundations"
       ],
@@ -17473,25 +17690,31 @@
           "title": "UIProvider",
           "description": "Configure one React-root boundary for stable application-wide display defaults.",
           "chooseWhen": [
-            "Stable application-wide display defaults need one isolated configuration boundary per React root."
+            "Stable application-wide display defaults need one isolated configuration boundary per React root.",
+            "ThemeScope needs to preserve CSS inheritance for portaled surfaces without an interactive theme editor."
           ],
           "avoidWhen": [
             "A value is visual CSS, call-site-specific, request-scoped, translated copy, or application state."
           ],
-          "appOwned": [],
+          "appOwned": [
+            "semantic theme CSS and active theme selection",
+            "stable provider defaults",
+            "portal container within the active scope"
+          ],
           "jobs": [
-            "Set locale, density, formatting, and component defaults once without moving request or application state into the package."
+            "Set locale, density, formatting, and component defaults once without moving request or application state into the package.",
+            "Host a CSS-inheriting ThemeScope and its portals at a theme boundary."
           ],
           "tags": [
-            "foundations",
-            "runtime & provider",
-            "ui-provider",
             "provider",
             "configuration",
             "display-defaults",
             "runtime"
           ],
-          "aliases": [],
+          "aliases": [
+            "theme boundary",
+            "theming"
+          ],
           "section": "Foundations",
           "browse": {
             "category": "foundations",