@kerfjs/ui 5.0.0-beta.55 → 5.0.0-beta.57

package/ai/{component-catalog-v2.json → component-composition.json}

@@ -1,9 +1,9 @@
 {
-  "$schema": "./component-catalog-v2.schema.json",
-  "schemaVersion": 2,
+  "$schema": "./component-composition.schema.json",
+  "schemaVersion": 1,
   "package": "@kerfjs/ui",
   "compatibility": {
-    "v1Catalog": "./component-catalog.json",
+    "componentCatalog": "./component-catalog.json",
     "identity": "package:id"
   },
   "entries": [
@@ -44,7 +44,7 @@
       },
       "accessibility": {
         "obligations": [
-          "Badge is non-interactive. Supply label when visible content is abbreviated, and ariaHidden when it repeats an accessible name owned by the surrounding component.",
+          "Badge is non-interactive. Supply label when visible content is abbreviated, and ariaHidden when it repeats an accessible name owned by the surrounding component. A text-free dot must take either label (exposed as an image) or ariaHidden, which the types enforce.",
           "Keep meaningful text visible because tone is supplementary."
         ]
       },
@@ -139,7 +139,19 @@
           "The arrow is decorative; expose expanded state through aria-expanded on its owning control and keep that control's accessible name stable."
         ]
       },
-      "cssValueProps": [],
+      "cssValueProps": [
+        {
+          "path": "size",
+          "grammar": "length",
+          "helpers": ["px", "rem", "em", "pct", "space", "lengthVar", "calc"],
+          "nonStandaloneHelpers": ["plus"],
+          "shorthands": [],
+          "canonicalShorthands": [],
+          "exceptionalShorthands": [],
+          "rawPolicy": "forbid",
+          "examples": ["size={remify(24)}"]
+        }
+      ],
       "boundaries": {
         "rootClass": "kui-disclosure-arrow",
         "publicClasses": ["kui-disclosure-arrow"],
@@ -306,18 +318,6 @@
           "--kui-color-danger-on-normal",
           "--kui-color-danger-on-loud",
           "--kui-color-danger-on-fill",
-          "--kui-color-border",
-          "--kui-color-border-quiet",
-          "--kui-color-accent",
-          "--kui-color-accent-text",
-          "--kui-color-pop",
-          "--kui-color-pop-text",
-          "--kui-color-success",
-          "--kui-color-success-text",
-          "--kui-color-warning",
-          "--kui-color-warning-text",
-          "--kui-color-danger",
-          "--kui-color-danger-text",
           "--kui-focus-ring",
           "--kui-shadow-s",
           "--kui-shadow-l"
@@ -379,6 +379,7 @@
       "boundaries": {
         "rootClass": "kui-app-root",
         "publicClasses": ["kui-app-root"],
+        "placeableClasses": ["kui-app-root"],
         "publicTokens": []
       },
       "diagnostics": [],
@@ -434,8 +435,12 @@
         "rootClass": "kui-content",
         "publicClasses": [
           "kui-content",
-          "kui-content-item",
-          "kui-content-item--pill",
+          "kui-control-cluster",
+          "kui-inline-metadata",
+          "kui-scroll-owner"
+        ],
+        "placeableClasses": [
+          "kui-content",
           "kui-control-cluster",
           "kui-inline-metadata",
           "kui-scroll-owner"
@@ -526,13 +531,31 @@
           "id": "responsive placement and visibility",
           "owner": "application",
           "required": false
+        },
+        {
+          "id": "whether the chrome dividers follow the scroll, always show, or never show (chromeDividers)",
+          "owner": "application",
+          "required": false
         }
       ],
       "wiring": {
         "required": false,
-        "helpers": [],
+        "helpers": ["wireScrollDividers"],
         "obligations": [],
-        "stateAttributes": []
+        "stateAttributes": [
+          {
+            "name": "data-scroll-overflow",
+            "on": "kui-pane__content",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "kui-pane__header and kui-pane__footer",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
+          }
+        ]
       },
       "responsive": { "owner": "not-applicable", "behaviors": [] },
       "layout": {
@@ -614,11 +637,26 @@
           "id": "per-view bottom toolbar content or a persistent fallback",
           "owner": "application",
           "required": false
+        },
+        {
+          "id": "per-view leading, center, and trailing top-toolbar groups",
+          "owner": "application",
+          "required": false
+        },
+        {
+          "id": "top-toolbar configuration, title size, and heading level",
+          "owner": "application",
+          "required": false
+        },
+        {
+          "id": "whether the chrome and bottom-toolbar dividers follow the scroll, always show, or never show (chromeDividers)",
+          "owner": "application",
+          "required": false
         }
       ],
       "wiring": {
         "required": true,
-        "helpers": ["wireNavStack"],
+        "helpers": ["wireNavStack", "wireScrollDividers"],
         "obligations": ["Use wireNavStack as documented."],
         "stateAttributes": [
           {
@@ -638,6 +676,18 @@
             "on": "kui-nav-stack__view",
             "helper": "wireNavStack",
             "meaning": "\"true\" on a popped view the helper briefly re-inserts to slide it out."
+          },
+          {
+            "name": "data-scroll-overflow",
+            "on": "the active kui-nav-stack__view, or the kui-pane__content of a sole Pane in it",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "kui-nav-stack__chrome and kui-nav-stack__bottom",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
           }
         ]
       },
@@ -649,13 +699,15 @@
           "border": "conditional",
           "padding": "child",
           "notes": [
-            "The stack owns its full-height chrome and viewport; each view owns its internal content padding and scrollable content."
+            "The stack owns its full-height chrome and viewport; each view owns its internal content padding and scrollable content.",
+            "The top chrome's bottom line and the bottom toolbar's top line are scroll state (wireScrollDividers), drawn as an overlaid 1px pseudo-element on the chrome and the bottom toolbar's always-present 1px top border, so neither moves the chrome or the content."
           ]
         }
       },
       "accessibility": {
         "obligations": [
-          "Give the stack region an accessible label and every back control a stable action label.",
+          "Give the stack region an accessible label and every back control a stable action label; visible backText names the control itself.",
+          "Set toolbarConfig.headingLevel when the view title is the page's or section's heading landmark.",
           "Use wireNavStack so each controlled push moves focus into the new top view and each pop restores the revealed view's remembered descendant.",
           "Mark a preferred initial heading or control with data-nav-focus when the first enabled focusable descendant is not the right target."
         ]
@@ -671,11 +723,6 @@
           "kui-nav-stack__chrome-copy",
           "kui-nav-stack__chrome-copy--bottom",
           "kui-nav-stack__chrome-copy--exiting",
-          "kui-nav-stack__lead",
-          "kui-nav-stack__back",
-          "kui-nav-stack__back-icon",
-          "kui-nav-stack__title",
-          "kui-nav-stack__actions",
           "kui-nav-stack__viewport",
           "kui-nav-stack__view",
           "kui-nav-stack__view--entering",
@@ -736,6 +783,16 @@
           "owner": "application",
           "required": false
         },
+        {
+          "id": "optional list collapse state and its restore control",
+          "owner": "application",
+          "required": false
+        },
+        {
+          "id": "compact list and detail toolbar groups, toolbar configuration, and chrome dividers",
+          "owner": "application",
+          "required": false
+        },
         { "id": "back action", "owner": "application", "required": false }
       ],
       "wiring": {
@@ -832,6 +889,11 @@
           "owner": "application",
           "required": false
         },
+        {
+          "id": "tab badge counts or dots and their localized badgeLabel phrases",
+          "owner": "application",
+          "required": false
+        },
         {
           "id": "routing and persistence",
           "owner": "application",
@@ -841,30 +903,50 @@
           "id": "responsive replacement on larger device classes",
           "owner": "application",
           "required": false
+        },
+        {
+          "id": "whether the bar divider follows the scroll, always shows, or never shows (chromeDividers)",
+          "owner": "application",
+          "required": false
         }
       ],
       "wiring": {
         "required": true,
-        "helpers": ["wireTabScaffold"],
+        "helpers": ["wireTabScaffold", "wireScrollDividers"],
         "obligations": ["Use wireTabScaffold as documented."],
-        "stateAttributes": []
+        "stateAttributes": [
+          {
+            "name": "data-scroll-overflow",
+            "on": "the active kui-tab-scaffold__scene, or what scrolls inside it (a sole NavStack's active view or a sole Pane's content)",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "kui-tab-scaffold__bar",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
+          }
+        ]
       },
       "responsive": { "owner": "not-applicable", "behaviors": [] },
       "layout": {
         "roles": ["structure"],
         "geometry": {
           "margin": "none",
-          "border": "self",
+          "border": "conditional",
           "padding": "self",
           "notes": [
-            "The scaffold owns the full-height scene region and safe-area-aware bottom bar; scene content owns its internal geometry."
+            "The scaffold owns the full-height scene region and safe-area-aware bottom bar; scene content owns its internal geometry.",
+            "The bar's top line is scroll state (wireScrollDividers): it shows only while the active scene's content continues below the bar, by coloring the bar's always-present 1px top border."
           ]
         }
       },
       "accessibility": {
         "obligations": [
           "Give the tablist an accessible label and keep exactly the active tab in the sequential focus order.",
-          "Wire selection through the controlled active id while leaving inactive scenes mounted and hidden."
+          "Wire selection through the controlled active id while leaving inactive scenes mounted and hidden.",
+          "A tab badge is aria-hidden; supply badgeLabel so the tab's accessible name becomes \"<label>, <badgeLabel>\" (it defaults to the badge text). The dot form, badge: true, has no text, so its badgeLabel is required."
         ]
       },
       "cssValueProps": [],
@@ -877,6 +959,7 @@
           "kui-tab-scaffold__bar",
           "kui-tab-scaffold__tab",
           "kui-tab-scaffold__tab-icon",
+          "kui-tab-scaffold__tab-badge",
           "kui-tab-scaffold__tab-label"
         ],
         "publicTokens": []
@@ -945,7 +1028,7 @@
       ],
       "wiring": {
         "required": false,
-        "helpers": ["wireWorkbench"],
+        "helpers": ["wireWorkbench", "wireScrollDividers"],
         "obligations": [],
         "stateAttributes": [
           {
@@ -959,6 +1042,18 @@
             "on": "kui-workbench__rail",
             "helper": "wireWorkbench",
             "meaning": "Present on a resizable rail or the drawer while a pointer drag resizes it."
+          },
+          {
+            "name": "data-scroll-overflow",
+            "on": "kui-pane__content of each panel and work-area Pane",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "kui-pane__header and kui-pane__footer of each panel and work-area Pane",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
           }
         ]
       },
@@ -1053,7 +1148,7 @@
       ],
       "wiring": {
         "required": true,
-        "helpers": ["wireSidebar"],
+        "helpers": ["wireSidebar", "wireScrollDividers"],
         "obligations": ["Use wireSidebar as documented."],
         "stateAttributes": [
           {
@@ -1073,6 +1168,18 @@
             "on": "kui-collapsible-panel__backdrop",
             "helper": "wireSidebar",
             "meaning": "Keeps the injected compact-overlay backdrop through the application's re-render; the helper creates and removes the backdrop itself."
+          },
+          {
+            "name": "data-scroll-overflow",
+            "on": "kui-pane__content of each panel and work-area Pane",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "kui-pane__header and kui-pane__footer of each panel and work-area Pane",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
           }
         ]
       },
@@ -1251,9 +1358,22 @@
       ],
       "wiring": {
         "required": false,
-        "helpers": [],
+        "helpers": ["wireScrollDividers"],
         "obligations": [],
-        "stateAttributes": []
+        "stateAttributes": [
+          {
+            "name": "data-scroll-overflow",
+            "on": "the targets scroller",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "a Toolbar named as targets chrome",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
+          }
+        ]
       },
       "responsive": { "owner": "not-applicable", "behaviors": [] },
       "layout": {
@@ -1283,7 +1403,7 @@
           "kui-toolbar__trailing"
         ],
         "publicTokens": [
-          "--kui-color-border",
+          "--kui-color-neutral-border-normal",
           "--kui-font-sans",
           "--kui-toolbar-divider-color"
         ]
@@ -1347,7 +1467,8 @@
       },
       "accessibility": {
         "obligations": [
-          "Name the group when its relationship is not evident from context."
+          "Name the group when its relationship is not evident from context.",
+          "Name an icon-only button or link with aria-label, not title. Once any help-tag installer is imported (select/register, popup-menu/register, or help-tags/register), it shows an aria-hidden Web Awesome help tag repeating that name after a 500ms hover and at once on keyboard focus, hidden on a press and on Escape, and never joins aria-labelledby. A native title keeps the browser tooltip and gets no second tag."
         ]
       },
       "cssValueProps": [],
@@ -1474,7 +1595,19 @@
           "Give the toolbar an accessible name (label is required — it exposes role=\"toolbar\")."
         ]
       },
-      "cssValueProps": [],
+      "cssValueProps": [
+        {
+          "path": "inset",
+          "grammar": "length",
+          "helpers": ["px", "rem", "em", "pct", "space", "lengthVar", "calc"],
+          "nonStandaloneHelpers": ["plus"],
+          "shorthands": [],
+          "canonicalShorthands": [],
+          "exceptionalShorthands": [],
+          "rawPolicy": "forbid",
+          "examples": ["inset={space(\"xs\")}"]
+        }
+      ],
       "boundaries": {
         "rootClass": "kui-floating-toolbar",
         "publicClasses": ["kui-floating-toolbar"],
@@ -1598,7 +1731,7 @@
         "rootClass": "kui-text",
         "publicClasses": ["kui-text"],
         "publicTokens": [
-          "--kui-color-danger-text",
+          "--kui-color-danger-on-quiet",
           "--kui-color-text-quiet",
           "--kui-font-mono",
           "--kui-font-xs",
@@ -1697,7 +1830,7 @@
           "kui-value-table__label"
         ],
         "publicTokens": [
-          "--kui-color-border",
+          "--kui-color-neutral-border-normal",
           "--kui-color-surface-lowered",
           "--kui-color-text",
           "--kui-color-text-quiet",
@@ -2018,9 +2151,22 @@
       ],
       "wiring": {
         "required": false,
-        "helpers": [],
+        "helpers": ["wireScrollDividers"],
         "obligations": [],
-        "stateAttributes": []
+        "stateAttributes": [
+          {
+            "name": "data-scroll-overflow",
+            "on": "the targets scroller",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "a List named as targets chrome",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which this chrome currently draws its scroll divider: the side facing the scroller while content is hidden beyond it. Re-applied if a re-render drops it."
+          }
+        ]
       },
       "responsive": { "owner": "not-applicable", "behaviors": [] },
       "layout": {
@@ -2071,7 +2217,7 @@
         "rootClass": "kui-list",
         "publicClasses": ["kui-list"],
         "publicTokens": [
-          "--kui-color-border",
+          "--kui-color-neutral-border-normal",
           "--kui-layout-item-gap",
           "--kui-list-divider-color",
           "--kui-list-gap"
@@ -2119,14 +2265,12 @@
           "kui-list-header",
           "kui-list-header__action",
           "kui-list-header__action-layer",
-          "kui-list-header__label",
           "kui-list-header__title",
           "kui-list-header__toggle"
         ],
         "publicTokens": [
           "--kui-color-neutral-border-quiet",
           "--kui-focus-ring",
-          "--kui-font-xs",
           "--kui-list-header-action-icon-size",
           "--kui-list-header-color",
           "--kui-layout-inline-margin",
@@ -2413,11 +2557,89 @@
       "cssValueProps": [],
       "boundaries": {
         "rootClass": "kui-list-inset-text",
+        "publicClasses": ["kui-list-inset-text"],
+        "publicTokens": []
+      },
+      "diagnostics": [],
+      "provenance": {
+        "selection": "ai/component-catalog.json",
+        "composition": "generated-permissive-default"
+      }
+    },
+    {
+      "key": "@kerfjs/ui:content-item",
+      "package": "@kerfjs/ui",
+      "id": "content-item",
+      "name": "ContentItem",
+      "kind": "component",
+      "source": "kerf",
+      "parents": { "mode": "any", "entries": [] },
+      "contexts": ["application-ui"],
+      "zones": [],
+      "children": { "mode": "any", "concepts": [], "requiredConcepts": [] },
+      "state": [
+        { "id": "the item content", "owner": "application", "required": false },
+        {
+          "id": "whether the item marks a real distinction that warrants a visible frame",
+          "owner": "application",
+          "required": false
+        },
+        { "id": "corner shape", "owner": "application", "required": false },
+        {
+          "id": "region semantics and accessible name",
+          "owner": "application",
+          "required": false
+        },
+        {
+          "id": "whether the item is a programmatic focus target",
+          "owner": "application",
+          "required": false
+        }
+      ],
+      "wiring": {
+        "required": false,
+        "helpers": [],
+        "obligations": [],
+        "stateAttributes": []
+      },
+      "responsive": { "owner": "not-applicable", "behaviors": [] },
+      "layout": {
+        "roles": ["structure"],
+        "geometry": {
+          "margin": "self",
+          "border": "self",
+          "padding": "self",
+          "notes": [
+            "The 1px border is always reserved and transparent unless frame=\"framed\", so framed and unframed items share the same geometry."
+          ]
+        }
+      },
+      "accessibility": {
+        "obligations": [
+          "An ordinary item adds no role or name; pass ariaLabel only when the item is a distinct named region (it then renders role=\"region\").",
+          "focusTarget makes the item a programmatic focus target (tabindex=\"-1\", never a tab stop), such as a NavStack view's data-nav-focus target.",
+          "The frame is decorative and never the only signal of state."
+        ]
+      },
+      "cssValueProps": [],
+      "boundaries": {
+        "rootClass": "kui-content-item",
         "publicClasses": [
-          "kui-list-inset-text",
-          "kui-list-inset-text--horizontal"
+          "kui-content-item",
+          "kui-content-item--pill",
+          "kui-content-item--framed"
         ],
-        "publicTokens": []
+        "placeableClasses": [
+          "kui-content-item",
+          "kui-content-item--pill",
+          "kui-content-item--framed"
+        ],
+        "rootElement": "div",
+        "publicTokens": [
+          "--kui-content-item-border",
+          "--kui-content-item-radius",
+          "--kui-content-item-background"
+        ]
       },
       "diagnostics": [],
       "provenance": {
@@ -2629,7 +2851,7 @@
       ],
       "wiring": {
         "required": true,
-        "helpers": ["wireTabBars"],
+        "helpers": ["wireTabBars", "wireScrollDividers"],
         "obligations": [
           "Retain and invoke the disposer.",
           "Apply onReorder to application-owned order."
@@ -2652,6 +2874,18 @@
             "on": "kui-tab-bar__tabs",
             "helper": "wireTabBars",
             "meaning": "\"start\" or \"end\" while a drag near that edge auto-scrolls the strip."
+          },
+          {
+            "name": "data-scroll-overflow",
+            "on": "kui-tab-bar__tabs",
+            "helper": "wireScrollDividers",
+            "meaning": "The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it."
+          },
+          {
+            "name": "data-scroll-divider",
+            "on": "chrome named in wireScrollDividers targets (a TabBar strip has none)",
+            "helper": "wireScrollDividers",
+            "meaning": "The sides, in t/r/b/l order, on which that chrome currently draws its scroll divider. Re-applied if a re-render drops it."
           }
         ]
       },
@@ -2683,7 +2917,11 @@
           "kui-tab-bar__trailing",
           "kui-tab-bar__end"
         ],
-        "publicTokens": ["--kui-tab-bar-background", "--kui-tab-bar-border"]
+        "publicTokens": [
+          "--kui-tab-bar-background",
+          "--kui-tab-bar-border",
+          "--kui-tab-bar-divider-color"
+        ]
       },
       "diagnostics": [
         {
@@ -2849,9 +3087,9 @@
           "kui-token-search__trailing"
         ],
         "publicTokens": [
-          "--kui-color-accent",
-          "--kui-color-accent-text",
-          "--kui-color-border",
+          "--kui-color-brand-fill-normal",
+          "--kui-color-brand-on-quiet",
+          "--kui-color-neutral-border-normal",
           "--kui-color-text-link",
           "--kui-color-surface",
           "--kui-color-text",
@@ -2944,7 +3182,7 @@
           "kui-resizable-region__restore"
         ],
         "publicTokens": [
-          "--kui-color-border",
+          "--kui-color-neutral-border-normal",
           "--kui-color-neutral-on-quiet",
           "--kui-color-text-link",
           "--kui-focus-ring",
@@ -3003,7 +3241,10 @@
           "Verify the live value, standard events, focus, and rendered output.",
           "A nonempty label names the internal combobox; otherwise ariaLabel supplies a visually hidden label without adding control height, including custom selected content.",
           "Hint text is visible below the control through Web Awesome's native hint relationship; placeholderText remains the empty value inside the closed control.",
-          "Import select/register once; its scoped lifecycle adapter keeps the latest open/close request authoritative across animation reversals, canceled transitions, and removal. Do not add consumer popup timing or position repairs."
+          "Import select/register once; its scoped lifecycle adapter keeps the latest open/close request authoritative across animation reversals, canceled transitions, and removal. Do not add consumer popup timing or position repairs.",
+          "With multiple, the popup stays open while choices toggle (pointer, Enter, or Space) and closes on an outside press, Escape, or focus leaving; each chosen option shows a check, and the closed control summarizes the chosen labels in choice order.",
+          "A multiple icon-only trigger shows its fixed triggerIcon and, while any choice is chosen, an aria-hidden count Badge; the combobox's accessible name ends with the chosen labels in choice order, and its hidden value stays empty.",
+          "Once registered, an icon-only trigger (single or multiple) shows an aria-hidden Web Awesome help tag repeating its accessible name (a single Select adds its current choice) after a 500ms hover and at once on keyboard focus; it hides while the popup is open, on a press, and on Escape, and never joins aria-labelledby. Do not add a title or another tooltip."
         ]
       },
       "cssValueProps": [
@@ -3035,8 +3276,6 @@
           "kui-select__icon"
         ],
         "publicTokens": [
-          "--kui-color-brand-fill-normal",
-          "--kui-color-brand-on-fill",
           "--kui-color-neutral-border-quiet",
           "--kui-color-neutral-on-quiet",
           "--kui-disclosure-icon-scale",
@@ -3097,7 +3336,8 @@
       },
       "accessibility": {
         "obligations": [
-          "An icon-only trigger requires label, rendered as visually hidden slotted text because a Web Awesome button takes its accessible name from its content; a trigger with visible text is named by that text. Web Awesome provides menu roles, arrow-key navigation, typeahead, and Escape."
+          "An icon-only trigger requires label, rendered as visually hidden slotted text because a Web Awesome button takes its accessible name from its content; a trigger with visible text is named by that text. Web Awesome provides menu roles, arrow-key navigation, typeahead, and Escape.",
+          "Once registered, an icon-only trigger shows its label as an aria-hidden Web Awesome help tag after a 500ms hover and at once on keyboard focus; it hides while the menu is open, on a press, and on Escape, and never joins aria-labelledby. Do not add a title or another tooltip."
         ]
       },
       "cssValueProps": [],
@@ -4476,6 +4716,7 @@
       "boundaries": {
         "rootClass": null,
         "publicClasses": ["hide-actions"],
+        "placeableClasses": ["hide-actions"],
         "publicTokens": []
       },
       "diagnostics": [],