@kerfjs/ui 5.0.0-beta.59 → 5.0.0-beta.60

package/ai/component-catalog.json

@@ -1420,6 +1420,7 @@
         "stacked zones at compact or narrow widths",
         "content-driven wrap that keeps a heading title whole",
         "center priority for an expanded center control",
+        "trailing priority for an expanded trailing control at compact or narrow widths",
         "trailing groups wrap instead of clipping",
         "app bar or bottom bar claiming its screen edges (safeAreaEdges)"
       ],
@@ -1470,7 +1471,15 @@
       "publicTokens": [
         "--kui-color-neutral-border-normal",
         "--kui-font-sans",
-        "--kui-toolbar-divider-color"
+        "--kui-toolbar-center-padding-inline",
+        "--kui-toolbar-divider-color",
+        "--kui-toolbar-leading-min-width",
+        "--kui-toolbar-leading-padding-inline",
+        "--kui-toolbar-trailing-gap",
+        "--kui-toolbar-trailing-justify",
+        "--kui-toolbar-trailing-justify-self",
+        "--kui-toolbar-trailing-padding-inline",
+        "--kui-toolbar-zone-padding-inline"
       ],
       "links": {
         "catalogRoute": "?component=toolbar",
@@ -1725,7 +1734,9 @@
         "bottom",
         "top-end",
         "top-start",
-        "top"
+        "top",
+        "inline placement",
+        "safe-area-aware per-edge inset"
       ],
       "accessibility": [
         "Give the toolbar an accessible name (label is required — it exposes role=\"toolbar\")."
@@ -1748,6 +1759,10 @@
       ],
       "publicTokens": [
         "--kui-floating-toolbar-inset",
+        "--kui-floating-toolbar-inset-block-start",
+        "--kui-floating-toolbar-inset-block-end",
+        "--kui-floating-toolbar-inset-inline-start",
+        "--kui-floating-toolbar-inset-inline-end",
         "--kui-space-m",
         "--kui-space-xs"
       ],
@@ -1763,9 +1778,9 @@
       "category": "Structure",
       "kind": "component",
       "source": "kerf",
-      "description": "Large, default, and compact toolbar identity text.",
+      "description": "Extra-large through extra-small toolbar identity text.",
       "uses": [],
-      "purpose": "Large, default, and compact toolbar identity text.",
+      "purpose": "Extra-large through extra-small toolbar identity text.",
       "publicExports": [
         "ToolbarText"
       ],
@@ -1793,9 +1808,11 @@
         "responsive priority"
       ],
       "variants": [
+        "xlarge",
         "large",
         "default",
         "small",
+        "xsmall",
         "placeholder (loading)"
       ],
       "accessibility": [
@@ -1820,6 +1837,7 @@
       "publicTokens": [
         "--kui-color-neutral-on-quiet",
         "--kui-color-text",
+        "--kui-font-2xs",
         "--kui-font-2xl",
         "--kui-font-l",
         "--kui-font-m",
@@ -1873,7 +1891,8 @@
         "p, h1 through h6, or inline span semantic variant",
         "default, quiet, or danger tone",
         "compact, default, large, or xlarge size",
-        "default or monospace font"
+        "default or monospace font",
+        "flush item geometry and tight line height"
       ],
       "accessibility": [
         "Text renders a native paragraph by default; choose an h1 through h6 variant by document outline rather than appearance, or span for inline secondary text.",
@@ -1885,7 +1904,7 @@
         "border": "self",
         "padding": "self",
         "notes": [
-          "Block Text variants reset native margins and add a 1px transparent border plus the standard 8px item padding; span has no margin, border, or padding."
+          "Block Text variants reset native margins and add a 1px transparent border plus the standard 8px item padding; flush removes the border and padding. Tight line height is available for compact copy. Span has no margin, border, or padding."
         ]
       },
       "delivery": {
@@ -1998,6 +2017,7 @@
       "variants": [
         "icon rows",
         "iconless rows",
+        "compact density",
         "placeholder (loading)"
       ],
       "accessibility": [
@@ -2034,7 +2054,10 @@
         "--kui-space-2xs",
         "--kui-value-table-background",
         "--kui-value-table-border",
-        "--kui-value-table-icon-size"
+        "--kui-value-table-icon-size",
+        "--kui-value-table-row-columns",
+        "--kui-value-table-row-padding-block",
+        "--kui-value-table-row-gap"
       ],
       "links": {
         "catalogRoute": "?component=value-table",
@@ -2766,7 +2789,12 @@
         "--kui-color-neutral-border-quiet",
         "--kui-focus-ring",
         "--kui-list-header-action-icon-size",
+        "--kui-list-header-border-width",
         "--kui-list-header-color",
+        "--kui-list-header-min-height",
+        "--kui-list-header-title-min-height",
+        "--kui-list-header-title-padding-block",
+        "--kui-list-header-title-padding-inline",
         "--kui-layout-inline-margin",
         "--kui-layout-item-gap",
         "--kui-layout-item-padding",
@@ -2965,6 +2993,9 @@
         "multiline",
         "placeholder (loading)",
         "compact density",
+        "spacious density",
+        "centered icon beside a multiline label",
+        "drag-target state",
         "description and status",
         "busy while retaining content",
         "before, after, or paired group divider"
@@ -2995,6 +3026,8 @@
         "kui-list-item__trailing"
       ],
       "publicTokens": [
+        "--kui-color-brand-border-normal",
+        "--kui-color-brand-fill-quiet",
         "--kui-color-brand-fill-normal",
         "--kui-color-neutral-fill-quiet",
         "--kui-color-neutral-on-normal",
@@ -3002,9 +3035,25 @@
         "--kui-color-neutral-border-quiet",
         "--kui-focus-ring",
         "--kui-list-item-color",
+        "--kui-list-item-align-items",
+        "--kui-list-item-border-width",
+        "--kui-list-item-columns",
+        "--kui-list-item-drag-target-background",
+        "--kui-list-item-drag-target-outline",
+        "--kui-list-item-drag-target-outline-offset",
+        "--kui-list-item-gap",
         "--kui-list-item-hover-background",
+        "--kui-list-item-icon-color",
+        "--kui-list-item-icon-size",
+        "--kui-list-item-label-max-width",
+        "--kui-list-item-label-weight",
+        "--kui-list-item-min-height",
+        "--kui-list-item-padding-block",
+        "--kui-list-item-padding-inline",
+        "--kui-list-item-radius",
         "--kui-list-item-selected-background",
         "--kui-list-item-selected-color",
+        "--kui-list-item-trailing-color",
         "--kui-list-group-divider-color",
         "--kui-font-xs",
         "--kui-layout-inline-margin",
@@ -3333,7 +3382,8 @@
         "compact size",
         "segmented presentation",
         "icon-only accessible presentation",
-        "label maximum width and truncation"
+        "label maximum width and truncation",
+        "attention name color"
       ],
       "accessibility": [
         "Compose in a tablist and pair with an application-owned tabpanel.",
@@ -3362,6 +3412,7 @@
         "kui-app-tab__trailing"
       ],
       "publicTokens": [
+        "--kui-app-tab-attention-color",
         "--kui-app-tab-color",
         "--kui-app-tab-drop-indicator",
         "--kui-app-tab-hover-background",
@@ -3517,7 +3568,18 @@
       "publicTokens": [
         "--kui-tab-bar-background",
         "--kui-tab-bar-border",
-        "--kui-tab-bar-divider-color"
+        "--kui-tab-bar-divider-color",
+        "--kui-tab-bar-strip-background",
+        "--kui-tab-bar-strip-border-width",
+        "--kui-tab-bar-strip-flex",
+        "--kui-tab-bar-strip-gap",
+        "--kui-tab-bar-strip-margin-block",
+        "--kui-tab-bar-strip-min-height",
+        "--kui-tab-bar-strip-overflow-block",
+        "--kui-tab-bar-strip-padding",
+        "--kui-tab-bar-strip-radius",
+        "--kui-tab-bar-strip-scroll-padding-inline",
+        "--kui-tab-bar-trailing-flex"
       ],
       "links": {
         "catalogRoute": "?component=tab-bar",
@@ -3749,6 +3811,7 @@
         "--kui-radius-pill",
         "--kui-token-search-background",
         "--kui-token-search-border",
+        "--kui-token-search-editor-min-width",
         "--kui-token-search-line-size",
         "--kui-token-search-token-background",
         "--kui-token-search-token-foreground",
@@ -3777,6 +3840,19 @@
         "resizeRegionFromPointer",
         "wireResizableRegions"
       ],
+      "cssValueProps": [
+        {
+          "path": "restoreInset",
+          "grammar": "length",
+          "helpers": ["px", "rem", "em", "pct", "space", "lengthVar", "calc"],
+          "nonStandaloneHelpers": ["plus"],
+          "shorthands": [],
+          "canonicalShorthands": [],
+          "exceptionalShorthands": [],
+          "rawPolicy": "forbid",
+          "examples": ["restoreInset={space(\"xs\")}"]
+        }
+      ],
       "useWhen": [
         "Provide a controlled user-resizable application pane."
       ],
@@ -3811,6 +3887,7 @@
         "clipped, scrolling, or popup-visible content",
         "inline, overlay, or hidden responsive presentation",
         "safe-area restore control"
+        ,"top-corner or inline restore placement"
       ],
       "accessibility": [
         "Preserve separator naming, value ARIA, and keyboard behavior.",
@@ -3874,6 +3951,7 @@
         "--kui-focus-ring",
         "--kui-radius-s",
         "--kui-resizable-region-edge-extent",
+        "--kui-resizable-region-background",
         "--kui-resizable-region-handle-active-color",
         "--kui-resizable-region-handle-color",
         "--kui-resizable-region-overlay-z",
@@ -3969,6 +4047,8 @@
         "label or icon-only selected presentation",
         "select- or group-owned focus ring",
         "label maximum width and truncation",
+        "fit-content, max-content, or fill trigger width",
+        "custom selected content typography and ellipsis",
         "multiple selection",
         "multiple icon-only filter trigger with a fixed triggerIcon"
       ],
@@ -4001,6 +4081,7 @@
         "kui-select--fit-menu",
         "kui-select--label-hidden",
         "kui-select__custom-selected",
+        "kui-select__custom-selected-content",
         "kui-select__group",
         "kui-select__group--separated",
         "kui-select__group-title",
@@ -4010,7 +4091,11 @@
         "--kui-color-neutral-border-quiet",
         "--kui-color-neutral-on-quiet",
         "--kui-disclosure-icon-scale",
-        "--kui-font-2xs"
+        "--kui-font-2xs",
+        "--kui-select-selected-color",
+        "--kui-select-selected-font-size",
+        "--kui-select-selected-font-weight",
+        "--kui-select-trigger-max-width"
       ],
       "links": {
         "catalogRoute": "?component=select",
@@ -4249,6 +4334,8 @@
         "status",
         "alert",
         "badge",
+        "stacked copy",
+        "action below",
         "placeholder (loading)"
       ],
       "accessibility": [
@@ -4304,6 +4391,8 @@
         "--kui-state-banner-action-hover-background",
         "--kui-state-banner-background",
         "--kui-state-banner-border",
+        "--kui-state-banner-copy-gap",
+        "--kui-state-banner-copy-row-gap",
         "--kui-state-banner-danger-background",
         "--kui-state-banner-danger-border",
         "--kui-state-banner-danger-foreground",

package/ai/component-composition.json

@@ -1405,7 +1405,15 @@
         "publicTokens": [
           "--kui-color-neutral-border-normal",
           "--kui-font-sans",
-          "--kui-toolbar-divider-color"
+          "--kui-toolbar-center-padding-inline",
+          "--kui-toolbar-divider-color",
+          "--kui-toolbar-leading-min-width",
+          "--kui-toolbar-leading-padding-inline",
+          "--kui-toolbar-trailing-gap",
+          "--kui-toolbar-trailing-justify",
+          "--kui-toolbar-trailing-justify-self",
+          "--kui-toolbar-trailing-padding-inline",
+          "--kui-toolbar-zone-padding-inline"
         ]
       },
       "diagnostics": [
@@ -1613,6 +1621,10 @@
         "publicClasses": ["kui-floating-toolbar"],
         "publicTokens": [
           "--kui-floating-toolbar-inset",
+          "--kui-floating-toolbar-inset-block-start",
+          "--kui-floating-toolbar-inset-block-end",
+          "--kui-floating-toolbar-inset-inline-start",
+          "--kui-floating-toolbar-inset-inline-end",
           "--kui-space-m",
           "--kui-space-xs"
         ]
@@ -1665,6 +1677,7 @@
         "publicTokens": [
           "--kui-color-neutral-on-quiet",
           "--kui-color-text",
+          "--kui-font-2xs",
           "--kui-font-2xl",
           "--kui-font-l",
           "--kui-font-m",
@@ -1715,7 +1728,7 @@
           "border": "self",
           "padding": "self",
           "notes": [
-            "Block Text variants reset native margins and add a 1px transparent border plus the standard 8px item padding; span has no margin, border, or padding."
+            "Block Text variants reset native margins and add a 1px transparent border plus the standard 8px item padding; flush removes the border and padding. Tight line height is available for compact copy. Span has no margin, border, or padding."
           ]
         }
       },
@@ -1843,7 +1856,10 @@
           "--kui-space-2xs",
           "--kui-value-table-background",
           "--kui-value-table-border",
-          "--kui-value-table-icon-size"
+          "--kui-value-table-icon-size",
+          "--kui-value-table-row-columns",
+          "--kui-value-table-row-padding-block",
+          "--kui-value-table-row-gap"
         ]
       },
       "diagnostics": [],
@@ -2274,7 +2290,12 @@
           "--kui-color-neutral-border-quiet",
           "--kui-focus-ring",
           "--kui-list-header-action-icon-size",
+          "--kui-list-header-border-width",
           "--kui-list-header-color",
+          "--kui-list-header-min-height",
+          "--kui-list-header-title-min-height",
+          "--kui-list-header-title-padding-block",
+          "--kui-list-header-title-padding-inline",
           "--kui-layout-inline-margin",
           "--kui-layout-item-gap",
           "--kui-layout-item-padding",
@@ -2458,6 +2479,8 @@
           "kui-list-item__trailing"
         ],
         "publicTokens": [
+          "--kui-color-brand-border-normal",
+          "--kui-color-brand-fill-quiet",
           "--kui-color-brand-fill-normal",
           "--kui-color-neutral-fill-quiet",
           "--kui-color-neutral-on-normal",
@@ -2465,9 +2488,25 @@
           "--kui-color-neutral-border-quiet",
           "--kui-focus-ring",
           "--kui-list-item-color",
+          "--kui-list-item-align-items",
+          "--kui-list-item-border-width",
+          "--kui-list-item-columns",
+          "--kui-list-item-drag-target-background",
+          "--kui-list-item-drag-target-outline",
+          "--kui-list-item-drag-target-outline-offset",
+          "--kui-list-item-gap",
           "--kui-list-item-hover-background",
+          "--kui-list-item-icon-color",
+          "--kui-list-item-icon-size",
+          "--kui-list-item-label-max-width",
+          "--kui-list-item-label-weight",
+          "--kui-list-item-min-height",
+          "--kui-list-item-padding-block",
+          "--kui-list-item-padding-inline",
+          "--kui-list-item-radius",
           "--kui-list-item-selected-background",
           "--kui-list-item-selected-color",
+          "--kui-list-item-trailing-color",
           "--kui-list-group-divider-color",
           "--kui-font-xs",
           "--kui-layout-inline-margin",
@@ -2778,6 +2817,7 @@
           "kui-app-tab__trailing"
         ],
         "publicTokens": [
+          "--kui-app-tab-attention-color",
           "--kui-app-tab-color",
           "--kui-app-tab-drop-indicator",
           "--kui-app-tab-hover-background",
@@ -2922,7 +2962,18 @@
         "publicTokens": [
           "--kui-tab-bar-background",
           "--kui-tab-bar-border",
-          "--kui-tab-bar-divider-color"
+          "--kui-tab-bar-divider-color",
+          "--kui-tab-bar-strip-background",
+          "--kui-tab-bar-strip-border-width",
+          "--kui-tab-bar-strip-flex",
+          "--kui-tab-bar-strip-gap",
+          "--kui-tab-bar-strip-margin-block",
+          "--kui-tab-bar-strip-min-height",
+          "--kui-tab-bar-strip-overflow-block",
+          "--kui-tab-bar-strip-padding",
+          "--kui-tab-bar-strip-radius",
+          "--kui-tab-bar-strip-scroll-padding-inline",
+          "--kui-tab-bar-trailing-flex"
         ]
       },
       "diagnostics": [
@@ -3104,6 +3155,7 @@
           "--kui-radius-pill",
           "--kui-token-search-background",
           "--kui-token-search-border",
+          "--kui-token-search-editor-min-width",
           "--kui-token-search-line-size",
           "--kui-token-search-token-background",
           "--kui-token-search-token-foreground",
@@ -3175,7 +3227,19 @@
           "Keep handleIcon decorative and free of interactive descendants; the separator owns focus, naming, and pointer/keyboard interaction."
         ]
       },
-      "cssValueProps": [],
+      "cssValueProps": [
+        {
+          "path": "restoreInset",
+          "grammar": "length",
+          "helpers": ["px", "rem", "em", "pct", "space", "lengthVar", "calc"],
+          "nonStandaloneHelpers": ["plus"],
+          "shorthands": [],
+          "canonicalShorthands": [],
+          "exceptionalShorthands": [],
+          "rawPolicy": "forbid",
+          "examples": ["restoreInset={space(\"xs\")}"]
+        }
+      ],
       "boundaries": {
         "rootClass": "kui-resizable-region",
         "publicClasses": [
@@ -3192,6 +3256,7 @@
           "--kui-focus-ring",
           "--kui-radius-s",
           "--kui-resizable-region-edge-extent",
+          "--kui-resizable-region-background",
           "--kui-resizable-region-handle-active-color",
           "--kui-resizable-region-handle-color",
           "--kui-resizable-region-overlay-z",
@@ -3274,6 +3339,7 @@
           "kui-select--fit-menu",
           "kui-select--label-hidden",
           "kui-select__custom-selected",
+          "kui-select__custom-selected-content",
           "kui-select__group",
           "kui-select__group--separated",
           "kui-select__group-title",
@@ -3283,7 +3349,11 @@
           "--kui-color-neutral-border-quiet",
           "--kui-color-neutral-on-quiet",
           "--kui-disclosure-icon-scale",
-          "--kui-font-2xs"
+          "--kui-font-2xs",
+          "--kui-select-selected-color",
+          "--kui-select-selected-font-size",
+          "--kui-select-selected-font-weight",
+          "--kui-select-trigger-max-width"
         ]
       },
       "diagnostics": [
@@ -3499,6 +3569,8 @@
           "--kui-state-banner-action-hover-background",
           "--kui-state-banner-background",
           "--kui-state-banner-border",
+          "--kui-state-banner-copy-gap",
+          "--kui-state-banner-copy-row-gap",
           "--kui-state-banner-danger-background",
           "--kui-state-banner-danger-border",
           "--kui-state-banner-danger-foreground",

package/ai/components/README.md

@@ -28,7 +28,7 @@ Exact prop and callback types live in [`public-api-signatures-v1.md`](../public-
 - [ToolbarControlGroup](./toolbar-control-group.md) — Provide complete toolbar action geometry through configuration, including semantic anchors, overflow containment, and dropdown menu insets without application CSS.
 - [Surface scaffolds](./surface-scaffold.md) — Configure recurring dialog and popup geometry without consumer ::part() overrides.
 - [FloatingToolbar](./floating-toolbar.md) — A transparent, forced-dark toolbar that floats over its container's content.
-- [ToolbarText](./toolbar-text.md) — Large, default, and compact toolbar identity text.
+- [ToolbarText](./toolbar-text.md) — Extra-large through extra-small toolbar identity text.
 - [Text](./text.md) — Render paragraph semantics by default, h1 through h6 when selected, or geometry-free inline secondary text as a span while independently configuring quiet or danger tone, compact through extra-large size, or monospace font.
 - [Headers](./headers.md) — Page, dialog, and definition-list hierarchy.
 - [ValueTable](./value-table.md) — Key/value rows with optional icons and aligned separators.

package/ai/components/floating-toolbar.md

@@ -36,6 +36,8 @@ Exact prop names and types: [`@kerfjs/ui/floating-toolbar`](../public-api-signat
 - top-end
 - top-start
 - top
+- inline placement
+- safe-area-aware per-edge inset
 
 **CSS-value props** (typed builders from `@kerfjs/ui/css-values`; raw CSS strings are rejected):
 
@@ -69,7 +71,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-floating-toolbar` on an element you write; render `FloatingToolbar` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-floating-toolbar-inset`, `--kui-space-m`, `--kui-space-xs`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-floating-toolbar-inset`, `--kui-floating-toolbar-inset-block-start`, `--kui-floating-toolbar-inset-block-end`, `--kui-floating-toolbar-inset-inline-start`, `--kui-floating-toolbar-inset-inline-end`, `--kui-space-m`, `--kui-space-xs`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/list-header.md

@@ -74,7 +74,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-list-header`, `kui-list-header__action`, `kui-list-header__action-layer`, `kui-list-header__title`, `kui-list-header__toggle` on an element you write; render `ListHeader` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-color-neutral-border-quiet`, `--kui-focus-ring`, `--kui-list-header-action-icon-size`, `--kui-list-header-color`, `--kui-layout-inline-margin`, `--kui-layout-item-gap`, `--kui-layout-item-padding`, `--kui-list-header-hover-background`, `--kui-list-group-divider-color`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-color-neutral-border-quiet`, `--kui-focus-ring`, `--kui-list-header-action-icon-size`, `--kui-list-header-border-width`, `--kui-list-header-color`, `--kui-list-header-min-height`, `--kui-list-header-title-min-height`, `--kui-list-header-title-padding-block`, `--kui-list-header-title-padding-inline`, `--kui-layout-inline-margin`, `--kui-layout-item-gap`, `--kui-layout-item-padding`, `--kui-list-header-hover-background`, `--kui-list-group-divider-color`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/list-item.md

@@ -40,6 +40,9 @@ Exact prop names and types: [`@kerfjs/ui/list-item`](../public-api-signatures-v1
 - multiline
 - placeholder (loading)
 - compact density
+- spacious density
+- centered icon beside a multiline label
+- drag-target state
 - description and status
 - busy while retaining content
 - before, after, or paired group divider
@@ -77,7 +80,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-list-item`, `kui-list-item__icon`, `kui-list-item__label`, `kui-list-item__primary-label`, `kui-list-item__description`, `kui-list-item__status`, `kui-list-item__trailing` on an element you write; render `ListItem` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-color-brand-fill-normal`, `--kui-color-neutral-fill-quiet`, `--kui-color-neutral-on-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-neutral-border-quiet`, `--kui-focus-ring`, `--kui-list-item-color`, `--kui-list-item-hover-background`, `--kui-list-item-selected-background`, `--kui-list-item-selected-color`, `--kui-list-group-divider-color`, `--kui-font-xs`, `--kui-layout-inline-margin`, `--kui-layout-item-gap`, `--kui-layout-item-padding`, `--kui-layout-rounded-radius`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-color-brand-border-normal`, `--kui-color-brand-fill-quiet`, `--kui-color-brand-fill-normal`, `--kui-color-neutral-fill-quiet`, `--kui-color-neutral-on-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-neutral-border-quiet`, `--kui-focus-ring`, `--kui-list-item-color`, `--kui-list-item-align-items`, `--kui-list-item-border-width`, `--kui-list-item-columns`, `--kui-list-item-drag-target-background`, `--kui-list-item-drag-target-outline`, `--kui-list-item-drag-target-outline-offset`, `--kui-list-item-gap`, `--kui-list-item-hover-background`, `--kui-list-item-icon-color`, `--kui-list-item-icon-size`, `--kui-list-item-label-max-width`, `--kui-list-item-label-weight`, `--kui-list-item-min-height`, `--kui-list-item-padding-block`, `--kui-list-item-padding-inline`, `--kui-list-item-radius`, `--kui-list-item-selected-background`, `--kui-list-item-selected-color`, `--kui-list-item-trailing-color`, `--kui-list-group-divider-color`, `--kui-font-xs`, `--kui-layout-inline-margin`, `--kui-layout-item-gap`, `--kui-layout-item-padding`, `--kui-layout-rounded-radius`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/resize.md

@@ -45,6 +45,11 @@ Exact prop names and types: [`@kerfjs/ui/resizable-region`](../public-api-signat
 - clipped, scrolling, or popup-visible content
 - inline, overlay, or hidden responsive presentation
 - safe-area restore control
+- top-corner or inline restore placement
+
+**CSS-value props** (typed builders from `@kerfjs/ui/css-values`; raw CSS strings are rejected):
+
+- `restoreInset`: length grammar; raw values: forbid; helpers `px`, `rem`, `em`, `pct`, `space`, `lengthVar`, `calc` — e.g. `restoreInset={space("xs")}`
 
 ## Composition
 
@@ -86,7 +91,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-resizable-region`, `kui-resizable-region__content`, `kui-resizable-region__handle`, `kui-resizable-region__handle-icon`, `kui-resizable-region__restore` on an element you write; render `ResizableRegion` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-color-neutral-border-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-text-link`, `--kui-focus-ring`, `--kui-radius-s`, `--kui-resizable-region-edge-extent`, `--kui-resizable-region-handle-active-color`, `--kui-resizable-region-handle-color`, `--kui-resizable-region-overlay-z`, `--kui-resizable-region-popup-z`, `--kui-resizable-region-restore-inset`, `--kui-resizable-region-restore-z`, `--kui-resizable-region-separator-color`, `--kui-resizable-region-size`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-color-neutral-border-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-text-link`, `--kui-focus-ring`, `--kui-radius-s`, `--kui-resizable-region-edge-extent`, `--kui-resizable-region-background`, `--kui-resizable-region-handle-active-color`, `--kui-resizable-region-handle-color`, `--kui-resizable-region-overlay-z`, `--kui-resizable-region-popup-z`, `--kui-resizable-region-restore-inset`, `--kui-resizable-region-restore-z`, `--kui-resizable-region-separator-color`, `--kui-resizable-region-size`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/select.md

@@ -48,6 +48,8 @@ Exact prop names and types: [`@kerfjs/ui/select`](../public-api-signatures-v1.md
 - label or icon-only selected presentation
 - select- or group-owned focus ring
 - label maximum width and truncation
+- fit-content, max-content, or fill trigger width
+- custom selected content typography and ellipsis
 - multiple selection
 - multiple icon-only filter trigger with a fixed triggerIcon
 
@@ -88,11 +90,11 @@ Margin: none · border: self · padding: self (layout role: controls). `self` me
 
 The component owns its own styles. Configure it through its props and variants; do not override its internals.
 
-Public class hooks (select for layout placement only, never to change the component's look): `kui-select`, `kui-select--custom-selected`, `kui-select--fit-menu`, `kui-select--label-hidden`, `kui-select__custom-selected`, `kui-select__group`, `kui-select__group--separated`, `kui-select__group-title`, `kui-select__icon`.
+Public class hooks (select for layout placement only, never to change the component's look): `kui-select`, `kui-select--custom-selected`, `kui-select--fit-menu`, `kui-select--label-hidden`, `kui-select__custom-selected`, `kui-select__custom-selected-content`, `kui-select__group`, `kui-select__group--separated`, `kui-select__group-title`, `kui-select__icon`.
 
-Never put `kui-select`, `kui-select--custom-selected`, `kui-select--fit-menu`, `kui-select--label-hidden`, `kui-select__custom-selected`, `kui-select__group`, `kui-select__group--separated`, `kui-select__group-title`, `kui-select__icon` on an element you write; render `Select` instead (`KUI-L103`).
+Never put `kui-select`, `kui-select--custom-selected`, `kui-select--fit-menu`, `kui-select--label-hidden`, `kui-select__custom-selected`, `kui-select__custom-selected-content`, `kui-select__group`, `kui-select__group--separated`, `kui-select__group-title`, `kui-select__icon` on an element you write; render `Select` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-color-neutral-border-quiet`, `--kui-color-neutral-on-quiet`, `--kui-disclosure-icon-scale`, `--kui-font-2xs`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-color-neutral-border-quiet`, `--kui-color-neutral-on-quiet`, `--kui-disclosure-icon-scale`, `--kui-font-2xs`, `--kui-select-selected-color`, `--kui-select-selected-font-size`, `--kui-select-selected-font-weight`, `--kui-select-trigger-max-width`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/state-banner.md

@@ -44,6 +44,8 @@ Exact prop names and types: [`@kerfjs/ui/state-banner`](../public-api-signatures
 - status
 - alert
 - badge
+- stacked copy
+- action below
 - placeholder (loading)
 
 ## Composition
@@ -81,7 +83,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-state-banner`, `kui-state-banner__action`, `kui-state-banner__copy`, `kui-state-banner__detail`, `kui-state-banner__icon` on an element you write; render `StateBanner` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-color-brand-border-quiet`, `--kui-color-brand-fill-quiet`, `--kui-color-brand-on-fill`, `--kui-color-pop-border-normal`, `--kui-color-pop-fill-quiet`, `--kui-color-pop-on-fill`, `--kui-color-danger-border-quiet`, `--kui-color-danger-fill-quiet`, `--kui-color-danger-on-fill`, `--kui-color-neutral-border-normal`, `--kui-color-neutral-fill-quiet`, `--kui-color-neutral-on-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-success-border-normal`, `--kui-color-success-fill-quiet`, `--kui-color-success-on-fill`, `--kui-color-surface`, `--kui-color-text-link`, `--kui-color-warning-border-normal`, `--kui-color-warning-fill-quiet`, `--kui-color-warning-on-fill`, `--kui-font-2xs`, `--kui-font-xs`, `--kui-radius-pill`, `--kui-state-banner-action-background`, `--kui-state-banner-action-hover-background`, `--kui-state-banner-background`, `--kui-state-banner-border`, `--kui-state-banner-danger-background`, `--kui-state-banner-danger-border`, `--kui-state-banner-danger-foreground`, `--kui-state-banner-detail`, `--kui-state-banner-foreground`, `--kui-state-banner-info-background`, `--kui-state-banner-info-border`, `--kui-state-banner-info-foreground`, `--kui-state-banner-pop-background`, `--kui-state-banner-pop-border`, `--kui-state-banner-pop-foreground`, `--kui-state-banner-neutral-background`, `--kui-state-banner-neutral-border`, `--kui-state-banner-neutral-foreground`, `--kui-state-banner-success-background`, `--kui-state-banner-success-border`, `--kui-state-banner-success-foreground`, `--kui-state-banner-warning-background`, `--kui-state-banner-warning-border`, `--kui-state-banner-warning-foreground`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-color-brand-border-quiet`, `--kui-color-brand-fill-quiet`, `--kui-color-brand-on-fill`, `--kui-color-pop-border-normal`, `--kui-color-pop-fill-quiet`, `--kui-color-pop-on-fill`, `--kui-color-danger-border-quiet`, `--kui-color-danger-fill-quiet`, `--kui-color-danger-on-fill`, `--kui-color-neutral-border-normal`, `--kui-color-neutral-fill-quiet`, `--kui-color-neutral-on-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-success-border-normal`, `--kui-color-success-fill-quiet`, `--kui-color-success-on-fill`, `--kui-color-surface`, `--kui-color-text-link`, `--kui-color-warning-border-normal`, `--kui-color-warning-fill-quiet`, `--kui-color-warning-on-fill`, `--kui-font-2xs`, `--kui-font-xs`, `--kui-radius-pill`, `--kui-state-banner-action-background`, `--kui-state-banner-action-hover-background`, `--kui-state-banner-background`, `--kui-state-banner-border`, `--kui-state-banner-copy-gap`, `--kui-state-banner-copy-row-gap`, `--kui-state-banner-danger-background`, `--kui-state-banner-danger-border`, `--kui-state-banner-danger-foreground`, `--kui-state-banner-detail`, `--kui-state-banner-foreground`, `--kui-state-banner-info-background`, `--kui-state-banner-info-border`, `--kui-state-banner-info-foreground`, `--kui-state-banner-pop-background`, `--kui-state-banner-pop-border`, `--kui-state-banner-pop-foreground`, `--kui-state-banner-neutral-background`, `--kui-state-banner-neutral-border`, `--kui-state-banner-neutral-foreground`, `--kui-state-banner-success-background`, `--kui-state-banner-success-border`, `--kui-state-banner-success-foreground`, `--kui-state-banner-warning-background`, `--kui-state-banner-warning-border`, `--kui-state-banner-warning-foreground`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/tab-bar.md

@@ -97,7 +97,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-tab-bar`, `kui-tab-bar__leading`, `kui-tab-bar__tabs`, `kui-tab-bar__trailing`, `kui-tab-bar__end` on an element you write; render `TabBar` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-tab-bar-background`, `--kui-tab-bar-border`, `--kui-tab-bar-divider-color`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-tab-bar-background`, `--kui-tab-bar-border`, `--kui-tab-bar-divider-color`, `--kui-tab-bar-strip-background`, `--kui-tab-bar-strip-border-width`, `--kui-tab-bar-strip-flex`, `--kui-tab-bar-strip-gap`, `--kui-tab-bar-strip-margin-block`, `--kui-tab-bar-strip-min-height`, `--kui-tab-bar-strip-overflow-block`, `--kui-tab-bar-strip-padding`, `--kui-tab-bar-strip-radius`, `--kui-tab-bar-strip-scroll-padding-inline`, `--kui-tab-bar-trailing-flex`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).
 

package/ai/components/tabs.md

@@ -41,6 +41,7 @@ Exact prop names and types: [`@kerfjs/ui/app-tab`](../public-api-signatures-v1.m
 - segmented presentation
 - icon-only accessible presentation
 - label maximum width and truncation
+- attention name color
 
 ## Composition
 
@@ -79,7 +80,7 @@ Public class hooks (select for layout placement only, never to change the compon
 
 Never put `kui-app-tab`, `kui-app-tab__close`, `kui-app-tab__close-icon`, `kui-app-tab__name`, `kui-app-tab__select`, `kui-app-tab__trailing` on an element you write; render `AppTab` instead (`KUI-L103`).
 
-Public tokens it reads: `--kui-app-tab-color`, `--kui-app-tab-drop-indicator`, `--kui-app-tab-hover-background`, `--kui-app-tab-selected-background`, `--kui-app-tab-selected-border`, `--kui-app-tab-selected-color`, `--kui-color-brand-border-normal`, `--kui-color-brand-on-quiet`, `--kui-color-neutral-border-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-surface`, `--kui-color-text`, `--kui-focus-ring`, `--kui-font-xs`, `--kui-radius-pill`, `--kui-shadow-s`, `--kui-space-2xs`, `--kui-space-xs`. Set a token only where its public contract allows; prefer a prop.
+Public tokens it reads: `--kui-app-tab-attention-color`, `--kui-app-tab-color`, `--kui-app-tab-drop-indicator`, `--kui-app-tab-hover-background`, `--kui-app-tab-selected-background`, `--kui-app-tab-selected-border`, `--kui-app-tab-selected-color`, `--kui-color-brand-border-normal`, `--kui-color-brand-on-quiet`, `--kui-color-neutral-border-normal`, `--kui-color-neutral-on-quiet`, `--kui-color-surface`, `--kui-color-text`, `--kui-focus-ring`, `--kui-font-xs`, `--kui-radius-pill`, `--kui-shadow-s`, `--kui-space-2xs`, `--kui-space-xs`. Set a token only where its public contract allows; prefer a prop.
 
 Everything else is internal: `kerf-ui-analyze` reports private or unknown `.kui-*` selectors (`KUI-L001`, `KUI-L010`), unknown or private tokens (`KUI-L002`, `KUI-L012`), and any application rule that restyles the component, forced dimensions included (`KUI-L019`).