@kerfjs/ui 5.0.0-beta.63 → 5.0.0-beta.65

package/ai/component-catalog.json

@@ -1170,6 +1170,11 @@
               "on": "kui-workbench__rail and kui-workbench__drawer",
               "meaning": "Present while a panel's numeric responsiveOverlayAt threshold applies to the Workbench width; the same measurement drives overlay layout and collapsed-state transitions."
             },
+            {
+              "name": "data-numeric-overlays",
+              "on": "kui-workbench",
+              "meaning": "Space-separated left, right, drawer, rail-open, and open tokens mirror numeric overlay state for local CSS invalidation. Absent when no numeric overlay is active."
+            },
             {
               "name": "data-handle-inset",
               "on": "kui-workbench__rail",
@@ -2726,7 +2731,8 @@
         "Choose a finite gap shorthand such as xs or m, or compose a typed length with @kerfjs/ui/css-values when the spacing scale is insufficient.",
         "Use a finite flex keyword or the flex() builder when List participates in flexible layout.",
         "Apply the standard text or control inset to selected physical sides without an application wrapper.",
-        "Align children horizontally or distribute them vertically with the same physical alignment vocabulary as Row."
+        "Align children horizontally or distribute them vertically with the same physical alignment vocabulary as Row.",
+        "Use selectionMode=\"multiple\" and ariaLabel to group selectable rich ContentItem rows in a multi-select grid."
       ],
       "avoidWhen": [
         "Do not use List as semantic list markup; use ul/ol when list semantics are required and apply layout deliberately.",
@@ -2737,7 +2743,8 @@
       "appOwns": [
         "child semantics and content",
         "the bounded height needed for scrolling",
-        "typed gap, flex, alignment, and divider choices"
+        "typed gap, flex, alignment, and divider choices",
+        "the accessible label and selection state of a multi-select grid"
       ],
       "variants": [
         "no gap",
@@ -2752,10 +2759,11 @@
         "top/right/bottom/left text and control inset combinations",
         "fill: the layout root fills a definite-height parent",
         "rootAttributes: safe data-* metadata on the root",
-        "scroll dividers when named as wireScrollDividers targets chrome"
+        "scroll dividers when named as wireScrollDividers targets chrome",
+        "multi-select grid for rich ContentItem rows"
       ],
       "accessibility": [
-        "List adds layout only and no list role; children retain responsibility for their native or ARIA semantics.",
+        "List adds layout only and no list role by default; selectionMode=\"multiple\" makes it an aria-multiselectable grid with a required ariaLabel for selectable ContentItem rows.",
         "Give a scrollable List a bounded block size and keep keyboard focus visible as its contents scroll."
       ],
       "geometry": {
@@ -3307,7 +3315,8 @@
       "useWhen": [
         "An ordinary surface-like child of a Pane or .kui-content stack needs the shared content-item geometry so its content edge lands at the standard 17px inset.",
         "A content item marks a real distinction and must read as visibly bounded: pass frame=\"framed\" (the border is always reserved, so geometry does not change).",
-        "A content item should follow a pill control's 22px radius: pass shape=\"pill\"."
+        "A content item should follow a pill control's 22px radius: pass shape=\"pill\".",
+        "A selectable rich card needs nested controls: use selectionMode=\"multiple\" inside a labeled List multi-select grid."
       ],
       "avoidWhen": [
         "Do not wrap a component that already owns content-item geometry (ListItem, ListHeader, StateBanner, Toolbar, ValueTable) or pad around a ContentItem; either double-insets.",
@@ -3337,19 +3346,22 @@
         "whether the item marks a real distinction that warrants a visible frame",
         "corner shape",
         "region semantics and accessible name",
-        "whether the item is a programmatic focus target"
+        "whether the item is a programmatic focus target",
+        "the selection set and Shift/Cmd extension for multi-select rich cards"
       ],
       "variants": [
         "unframed rounded item",
         "framed rounded item",
         "pill item",
         "framed pill item",
-        "named focus-target region"
+        "named focus-target region",
+        "multi-select rich grid row"
       ],
       "accessibility": [
         "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."
+        "The frame is decorative and never the only signal of state.",
+        "selectionMode=\"multiple\" renders a focusable row with aria-selected and a gridcell for nested controls; place it in a labeled List selectionMode=\"multiple\" grid. wireContentItems moves focus among rows with Up/Down and Home/End while nested controls retain those keys. Guard the app's delegated card action with isContentItemActivation so a nested control does not select the row."
       ],
       "geometry": {
         "margin": "self",
@@ -3832,7 +3844,8 @@
       },
       "useWhen": [
         "Combine DOM-owned free text with ordered editable/removable filter tokens in one searchbox.",
-        "Enable collapsible mode when an empty, unfocused search should reduce to one iconic action, standalone or inside a toolbar group."
+        "Enable collapsible mode when an empty, unfocused search should reduce to one iconic action, standalone or inside a toolbar group.",
+        "Use presentation=\"form-field\" for a structured search query beside Web Awesome form controls, with a visible label, optional hint, and required marker."
       ],
       "avoidWhen": [
         "Do not use for ordinary text input or separately labeled filter controls."
@@ -3847,19 +3860,22 @@
         "the grammar and evaluation callback when using the optional managed model, or parsing, suggestions, tokens, and query execution in manual mode",
         "results",
         "the revision that rebuilds the DOM-owned editor for a programmatic text replacement",
-        "optional override of the collapsible expand/collapse/focus, which wireTokenSearchFields manages by default (adopt an app expanded signal, opt out per behavior, or drive it via the returned handle)"
+        "optional override of the collapsible expand/collapse/focus, which wireTokenSearchFields manages by default (adopt an app expanded signal, opt out per behavior, or drive it via the returned handle)",
+        "validation of a required form-field value"
       ],
       "variants": [
         "tokens",
         "free text",
         "disabled",
-        "collapsible standalone or toolbar composition"
+        "collapsible standalone or toolbar composition",
+        "visible form-field label, hint, and required marker"
       ],
       "accessibility": [
         "Announce result changes when useful and keep tokens atomic during editing.",
         "Keep leading and trailing controls aligned to the first text line while content wraps. Managed Clear restores replacement focus before the next input task, preserving immediate typing and later focus handoffs without a frame delay.",
         "Wire Enter to submit without inserting a contenteditable line break and preserve focus plus the text-relative caret across controlled keyboard chip deletion before the next keystroke. Select All deletion preserves managed open state and replacement focus; persist both edited query and tokens. Visual wrapping remains available.",
-        "In collapsible mode, wireTokenSearchFields manages this by default: activating the trigger reveals the searchbox and moves focus into it, Escape on an empty field collapses and returns focus to the trigger, and focus leaving an empty field collapses it; each behavior is individually opt-out."
+        "In collapsible mode, wireTokenSearchFields manages this by default: activating the trigger reveals the searchbox and moves focus into it, Escape on an empty field collapses and returns focus to the trigger, and focus leaving an empty field collapses it; each behavior is individually opt-out.",
+        "The form-field presentation associates its visible label and optional hint with the searchbox, exposes aria-required when required, and lets wireTokenSearchFields focus the editor from a label click. The app validates required input."
       ],
       "geometry": {
         "margin": "none",

package/ai/component-composition.json

@@ -1097,6 +1097,12 @@
             "helper": "wireWorkbench",
             "meaning": "Present while a panel's numeric responsiveOverlayAt threshold applies to the Workbench width; the same measurement drives overlay layout and collapsed-state transitions."
           },
+          {
+            "name": "data-numeric-overlays",
+            "on": "kui-workbench",
+            "helper": "wireWorkbench",
+            "meaning": "Space-separated left, right, drawer, rail-open, and open tokens mirror numeric overlay state for local CSS invalidation. Absent when no numeric overlay is active."
+          },
           {
             "name": "data-handle-inset",
             "on": "kui-workbench__rail",
@@ -2252,6 +2258,11 @@
           "id": "typed gap, flex, alignment, and divider choices",
           "owner": "application",
           "required": false
+        },
+        {
+          "id": "the accessible label and selection state of a multi-select grid",
+          "owner": "application",
+          "required": false
         }
       ],
       "wiring": {
@@ -2287,7 +2298,7 @@
       },
       "accessibility": {
         "obligations": [
-          "List adds layout only and no list role; children retain responsibility for their native or ARIA semantics.",
+          "List adds layout only and no list role by default; selectionMode=\"multiple\" makes it an aria-multiselectable grid with a required ariaLabel for selectable ContentItem rows.",
           "Give a scrollable List a bounded block size and keep keyboard focus visible as its contents scroll."
         ]
       },
@@ -2740,6 +2751,11 @@
           "id": "whether the item is a programmatic focus target",
           "owner": "application",
           "required": false
+        },
+        {
+          "id": "the selection set and Shift/Cmd extension for multi-select rich cards",
+          "owner": "application",
+          "required": false
         }
       ],
       "wiring": {
@@ -2764,7 +2780,8 @@
         "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."
+          "The frame is decorative and never the only signal of state.",
+          "selectionMode=\"multiple\" renders a focusable row with aria-selected and a gridcell for nested controls; place it in a labeled List selectionMode=\"multiple\" grid. wireContentItems moves focus among rows with Up/Down and Home/End while nested controls retain those keys. Guard the app's delegated card action with isContentItemActivation so a nested control does not select the row."
         ]
       },
       "cssValueProps": [],
@@ -3237,7 +3254,8 @@
           "Announce result changes when useful and keep tokens atomic during editing.",
           "Keep leading and trailing controls aligned to the first text line while content wraps. Managed Clear restores replacement focus before the next input task, preserving immediate typing and later focus handoffs without a frame delay.",
           "Wire Enter to submit without inserting a contenteditable line break and preserve focus plus the text-relative caret across controlled keyboard chip deletion before the next keystroke. Select All deletion preserves managed open state and replacement focus; persist both edited query and tokens. Visual wrapping remains available.",
-          "In collapsible mode, wireTokenSearchFields manages this by default: activating the trigger reveals the searchbox and moves focus into it, Escape on an empty field collapses and returns focus to the trigger, and focus leaving an empty field collapses it; each behavior is individually opt-out."
+          "In collapsible mode, wireTokenSearchFields manages this by default: activating the trigger reveals the searchbox and moves focus into it, Escape on an empty field collapses and returns focus to the trigger, and focus leaving an empty field collapses it; each behavior is individually opt-out.",
+          "The form-field presentation associates its visible label and optional hint with the searchbox, exposes aria-required when required, and lets wireTokenSearchFields focus the editor from a label click. The app validates required input."
         ]
       },
       "cssValueProps": [],

package/ai/components/content-item.md

@@ -13,6 +13,7 @@ Render one self-contained .kui-content child that owns its 8px inline margin, re
 - An ordinary surface-like child of a Pane or .kui-content stack needs the shared content-item geometry so its content edge lands at the standard 17px inset.
 - A content item marks a real distinction and must read as visibly bounded: pass frame="framed" (the border is always reserved, so geometry does not change).
 - A content item should follow a pill control's 22px radius: pass shape="pill".
+- A selectable rich card needs nested controls: use selectionMode="multiple" inside a labeled List multi-select grid.
 
 **Not when:**
 
@@ -44,6 +45,7 @@ Exact prop names and types: [`@kerfjs/ui/content-item`](../public-api-signatures
 - pill item
 - framed pill item
 - named focus-target region
+- multi-select rich grid row
 
 ## Composition
 
@@ -53,7 +55,7 @@ Exact prop names and types: [`@kerfjs/ui/content-item`](../public-api-signatures
 
 ## State and wiring
 
-**The app owns:** the item content; whether the item marks a real distinction that warrants a visible frame; corner shape; region semantics and accessible name; whether the item is a programmatic focus target.
+**The app owns:** the item content; whether the item marks a real distinction that warrants a visible frame; corner shape; region semantics and accessible name; whether the item is a programmatic focus target; the selection set and Shift/Cmd extension for multi-select rich cards.
 
 No wiring helper.
 
@@ -68,6 +70,7 @@ Margin: self · border: self · padding: self (layout role: structure). `self` m
 - 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.
+- selectionMode="multiple" renders a focusable row with aria-selected and a gridcell for nested controls; place it in a labeled List selectionMode="multiple" grid. wireContentItems moves focus among rows with Up/Down and Home/End while nested controls retain those keys. Guard the app's delegated card action with isContentItemActivation so a nested control does not select the row.
 
 ## Styling boundary
 

package/ai/components/list.md

@@ -16,6 +16,7 @@ Standardize vertical component layout, optional physical-side text/control inset
 - Use a finite flex keyword or the flex() builder when List participates in flexible layout.
 - Apply the standard text or control inset to selected physical sides without an application wrapper.
 - Align children horizontally or distribute them vertically with the same physical alignment vocabulary as Row.
+- Use selectionMode="multiple" and ariaLabel to group selectable rich ContentItem rows in a multi-select grid.
 
 **Not when:**
 
@@ -49,6 +50,7 @@ Exact prop names and types: [`@kerfjs/ui/list`](../public-api-signatures-v1.md#k
 - fill: the layout root fills a definite-height parent
 - rootAttributes: safe data-\* metadata on the root
 - scroll dividers when named as wireScrollDividers targets chrome
+- multi-select grid for rich ContentItem rows
 
 **CSS-value props** (typed builders from `@kerfjs/ui/css-values`; raw CSS strings are rejected):
 
@@ -64,7 +66,7 @@ Exact prop names and types: [`@kerfjs/ui/list`](../public-api-signatures-v1.md#k
 
 ## State and wiring
 
-**The app owns:** child semantics and content; the bounded height needed for scrolling; typed gap, flex, alignment, and divider choices.
+**The app owns:** child semantics and content; the bounded height needed for scrolling; typed gap, flex, alignment, and divider choices; the accessible label and selection state of a multi-select grid.
 
 **Wiring:** `wireScrollDividers` is optional.
 
@@ -81,7 +83,7 @@ Margin: none · border: conditional · padding: conditional (layout role: naviga
 
 ## Accessibility
 
-- List adds layout only and no list role; children retain responsibility for their native or ARIA semantics.
+- List adds layout only and no list role by default; selectionMode="multiple" makes it an aria-multiselectable grid with a required ariaLabel for selectable ContentItem rows.
 - Give a scrollable List a bounded block size and keep keyboard focus visible as its contents scroll.
 
 ## Styling boundary

package/ai/components/token-search-field.md

@@ -10,6 +10,7 @@ Token-controlled, optionally collapsible search editor with ordered, editable, r
 
 - Combine DOM-owned free text with ordered editable/removable filter tokens in one searchbox.
 - Enable collapsible mode when an empty, unfocused search should reduce to one iconic action, standalone or inside a toolbar group.
+- Use presentation="form-field" for a structured search query beside Web Awesome form controls, with a visible label, optional hint, and required marker.
 
 **Not when:**
 
@@ -40,6 +41,7 @@ Exact prop names and types: [`@kerfjs/ui/token-search-field`](../public-api-sign
 - free text
 - disabled
 - collapsible standalone or toolbar composition
+- visible form-field label, hint, and required marker
 
 ## Composition
 
@@ -79,6 +81,7 @@ Margin: none · border: self · padding: self (layout role: controls). `self` me
 - Keep leading and trailing controls aligned to the first text line while content wraps. Managed Clear restores replacement focus before the next input task, preserving immediate typing and later focus handoffs without a frame delay.
 - Wire Enter to submit without inserting a contenteditable line break and preserve focus plus the text-relative caret across controlled keyboard chip deletion before the next keystroke. Select All deletion preserves managed open state and replacement focus; persist both edited query and tokens. Visual wrapping remains available.
 - In collapsible mode, wireTokenSearchFields manages this by default: activating the trigger reveals the searchbox and moves focus into it, Escape on an empty field collapses and returns focus to the trigger, and focus leaving an empty field collapses it; each behavior is individually opt-out.
+- The form-field presentation associates its visible label and optional hint with the searchbox, exposes aria-required when required, and lets wireTokenSearchFields focus the editor from a label click. The app validates required input.
 
 ## Styling boundary
 

package/ai/components/workbench.md

@@ -77,6 +77,7 @@ Zones (a zone is bound to JSX only through its listed prop; never assume the zon
 **Wiring-owned state attributes** — never render, remove, or branch on these as app state:
 
 - `data-responsive-overlay-active` on `kui-workbench__rail and kui-workbench__drawer` (`wireWorkbench`): Present while a panel's numeric responsiveOverlayAt threshold applies to the Workbench width; the same measurement drives overlay layout and collapsed-state transitions.
+- `data-numeric-overlays` on `kui-workbench` (`wireWorkbench`): Space-separated left, right, drawer, rail-open, and open tokens mirror numeric overlay state for local CSS invalidation. Absent when no numeric overlay is active.
 - `data-handle-inset` on `kui-workbench__rail` (`wireWorkbench`): Written by the shared resize wiring when the work-area minimum or a parent clamp holds a rail's maximum near its size. It carries no Workbench styling; the Workbench handle stays at the rail's inner edge.
 - `data-resizing` on `kui-workbench__rail` (`wireWorkbench`): Present on a resizable rail or the drawer while a pointer drag resizes it.
 - `data-scroll-overflow` on `kui-pane__content of each panel and work-area Pane` (`wireScrollDividers`): 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.

package/ai/public-api-signatures-v1.md

@@ -1,6 +1,6 @@
 # Public API signatures for the UI authoring corpus
 
-Generated from emitted declarations for `@kerfjs/ui@5.0.0-beta.63` and `kerfjs@5.0.0-beta.63`. This bounded reference covers only APIs used by the seven-task corpus. It is interface evidence, not an implementation or runtime guarantee.
+Generated from emitted declarations for `@kerfjs/ui@5.0.0-beta.65` and `kerfjs@5.0.0-beta.65`. This bounded reference covers only APIs used by the seven-task corpus. It is interface evidence, not an implementation or runtime guarantee.
 
 ## `@kerfjs/ui/css-values`
 
@@ -494,7 +494,8 @@ declare function closePopupMenu(menu: PopupMenuElement): void;
  * `nestedDropdown`) or a `PopupSurface` sizes and insets it as usual. Items
  * dispatch through delegated `data-action`s; the app owns the commands and any
  * open-state reaction. Import `@kerfjs/ui/popup-menu/register` once to register
- * the Web Awesome elements.
+ * the Web Awesome elements. At viewport widths up to 480px, submenus appear
+ * above or below their parent menu so their rows do not cover the parent list.
  */
 declare function PopupMenu({ text, label, icon, items, placement, caret, disabled, rootAttributes, slot, context, }: PopupMenuProps): SafeHtml;
 
@@ -628,6 +629,10 @@ type ListRootAttributes = Readonly<Record<`data-${string}`, string | undefined>
 }>;
 interface ListProps {
     children?: KerfUiContent;
+    /** Make this list a labeled multi-select grid for `ContentItem selectionMode="multiple"` rows. */
+    selectionMode?: 'multiple';
+    /** Accessible name for the multi-select grid. */
+    ariaLabel?: string;
     /** Use the standard item gap, a named UI spacing token, or a typed CSS length. Defaults to no gap. */
     gap?: boolean | UiSpaceName | CssLength;
     /** Allow this list to grow/shrink, use a keyword, or supply a typed CSS flex shorthand. */
@@ -664,7 +669,7 @@ interface ListProps {
  */
 type ListConfig = Pick<ListProps, 'gap' | 'hAlign' | 'vAlign' | 'dividerSides' | 'textInsets' | 'controlInsets'>;
 /** A stretch-aligned vertical stack with optional gap, flex, fill, scroll, and dividers. */
-declare function List({ children, gap, flex, fill, hAlign, vAlign, scrollable, dividerSides, textInsets, controlInsets, className, rootAttributes, slot, }: ListProps): kerfjs.SafeHtml;
+declare function List({ children, selectionMode, ariaLabel, gap, flex, fill, hAlign, vAlign, scrollable, dividerSides, textInsets, controlInsets, className, rootAttributes, slot, }: ListProps): kerfjs.SafeHtml;
 
 export { CssFlex, CssFlexKeyword, CssLength, HorizontalAlignment, List, type ListConfig, type ListProps, ListVerticalAlignment, Sides, UiSpaceName };
 ```
@@ -877,8 +882,8 @@ import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
 type ContentItemFrame = 'none' | 'framed';
 /** Corner shape: the 12px rounded rectangle or the 22px pill. */
 type ContentItemShape = 'rounded' | 'pill';
-/** `single` uses option selection; `toggle` uses a pressed button. */
-type ContentItemSelectionMode = 'none' | 'single' | 'toggle';
+/** `single` uses an option; `multiple` uses a grid row; `toggle` uses a pressed button. */
+type ContentItemSelectionMode = 'none' | 'single' | 'multiple' | 'toggle';
 type ContentItemRootAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
     'data-component'?: never;
 }>;
@@ -901,8 +906,12 @@ interface ContentItemBaseProps {
      * marks a real distinction. Defaults to `none` (transparent border).
      */
     frame?: ContentItemFrame;
+    /** Remove block padding and block borders while retaining inline geometry. */
+    flush?: boolean;
     /** Corner shape. Defaults to `rounded`. */
     shape?: ContentItemShape;
+    /** Native hover tooltip. */
+    title?: string;
     /**
      * Names the item as a distinct region (`role="region"`). Omit it for an
      * ordinary item, which stays a non-landmark grouping.
@@ -944,7 +953,7 @@ type ContentItemProps = ContentItemBaseProps & ({
  * border (transparent unless `framed`), 8px padding, and a rounded or pill
  * radius. It owns that whole geometry, so wrappers must not add more.
  */
-declare function ContentItem({ children, frame, shape, ariaLabel, focusTarget, interactive, action, itemId, selectionMode, selected, disabled, className, rootAttributes, slot, }: ContentItemProps): kerfjs.SafeHtml;
+declare function ContentItem({ children, frame, flush, shape, title, ariaLabel, focusTarget, interactive, action, itemId, selectionMode, selected, disabled, className, rootAttributes, slot, }: ContentItemProps): kerfjs.SafeHtml;
 
 export { ContentItem, type ContentItemFrame, type ContentItemProps, type ContentItemSelectionMode, type ContentItemShape };
 ```
@@ -2391,7 +2400,7 @@ import 'lucide';
 declare function Catalog({ id, brand, sections, active, content, collapsed, theme, headerActions, secondarySections, sidebarFooter, status, geometryOverlay, stageRootAttributes, selectAction, toggleSidebarAction, toggleThemeAction, toggleSecondaryAction, headerPlacement, footerPlacement, sidebar, mainToolbar, footerToolbar, className, slot, }: CatalogProps): kerfjs.SafeHtml;
 
 /** How a specimen aligns its visible edge with its `ListHeader` label. */
-type CatalogExampleAlign = 'glyph' | 'inline-control' | 'none';
+type CatalogExampleAlign = 'glyph' | 'inline-control' | 'text-trigger' | 'none';
 interface CatalogExampleViewport {
     layout?: 'grid' | 'flex' | 'flex-column';
     width?: 'full' | 'compact' | 'medium' | 'wide' | 'text' | 'control';
@@ -2905,14 +2914,14 @@ export { SunkenPanel, type SunkenPanelProps, type SunkenPanelShape };
 ```ts
 import 'kerfjs';
 import './semantic-content-BbzjvSu9.js';
-export { T as TokenSearchEditorAttributes, a as TokenSearchField, b as TokenSearchFieldProps, c as TokenSearchFieldValue, j as TokenSearchToken, p as placeTokenSearchCaret, r as readTokenSearchField } from './token-search-field-DvgFLhLL.js';
+export { T as TokenSearchEditorAttributes, a as TokenSearchField, b as TokenSearchFieldProps, c as TokenSearchFieldValue, j as TokenSearchToken, k as TokenSearchTrailingAction, p as placeTokenSearchCaret, r as readTokenSearchField } from './token-search-field-CVGwDn2y.js';
 ```
 
 ## `@kerfjs/ui/wire-token-search-fields`
 
 ```ts
 import { Signal } from 'kerfjs';
-import { d as TokenSearchModel } from './token-search-field-DvgFLhLL.js';
+import { d as TokenSearchModel } from './token-search-field-CVGwDn2y.js';
 import './semantic-content-BbzjvSu9.js';
 
 interface TokenSearchSubmit {
@@ -3379,6 +3388,7 @@ type GridRootAttributes = Readonly<Record<`data-${string}`, string | undefined>
     'data-component'?: never;
     'data-columns'?: never;
     'data-min-column-width'?: never;
+    'data-auto-fill'?: never;
     'data-flex'?: never;
     'data-fill'?: never;
 }>;
@@ -3404,13 +3414,16 @@ type GridProps = GridCommonProps & ({
     /** Number of equal-width columns. Must be a positive safe integer. */
     columns: number;
     minColumnWidth?: never;
+    autoFill?: never;
 } | {
     columns?: never;
     /** Fit equal columns of at least this width; collapse as the container narrows. */
     minColumnWidth: CssLength;
+    /** Keep empty tracks instead of stretching a sparse row. Defaults to false. */
+    autoFill?: boolean;
 });
 /** Render equal tracks with a fixed count or a responsive minimum width. */
-declare function Grid({ children, columns, minColumnWidth, gap, flex, fill, className, rootAttributes, slot, }: GridProps): kerfjs.SafeHtml;
+declare function Grid({ children, columns, minColumnWidth, autoFill, gap, flex, fill, className, rootAttributes, slot, }: GridProps): kerfjs.SafeHtml;
 
 export { CssFlex, CssFlexKeyword, CssLength, Grid, type GridProps, UiSpaceName };
 ```
@@ -3442,6 +3455,6 @@ export { CssLength, Spacer, type SpacerProps, UiSpaceName };
 
 ```ts
 import 'kerfjs';
-export { d as TokenSearchModel, e as TokenSearchModelOptions, f as TokenSearchResolvedToken, g as TokenSearchRule, h as TokenSearchState, i as TokenSearchSuggestion, k as createTokenSearchModel } from './token-search-field-DvgFLhLL.js';
+export { d as TokenSearchModel, e as TokenSearchModelOptions, f as TokenSearchResolvedToken, g as TokenSearchRule, h as TokenSearchState, i as TokenSearchSuggestion, l as createTokenSearchModel } from './token-search-field-CVGwDn2y.js';
 import './semantic-content-BbzjvSu9.js';
 ```

package/ai/webawesome-jsx-signatures-v1.md

@@ -1,6 +1,6 @@
 # Web Awesome JSX signatures for the UI authoring corpus
 
-Generated from the emitted `@kerfjs/ui@5.0.0-beta.63` declaration boundary. Import `@kerfjs/ui/webawesome` for type effects when authoring direct `wa-*` JSX. The module emits no runtime behavior and does not register custom elements.
+Generated from the emitted `@kerfjs/ui@5.0.0-beta.65` declaration boundary. Import `@kerfjs/ui/webawesome` for type effects when authoring direct `wa-*` JSX. The module emits no runtime behavior and does not register custom elements.
 
 ```ts
 import { KerfCustomElement } from 'kerfjs/jsx-runtime';

package/dist/catalog.d.ts

@@ -25,7 +25,7 @@ import 'lucide';
 declare function Catalog({ id, brand, sections, active, content, collapsed, theme, headerActions, secondarySections, sidebarFooter, status, geometryOverlay, stageRootAttributes, selectAction, toggleSidebarAction, toggleThemeAction, toggleSecondaryAction, headerPlacement, footerPlacement, sidebar, mainToolbar, footerToolbar, className, slot, }: CatalogProps): kerfjs.SafeHtml;
 
 /** How a specimen aligns its visible edge with its `ListHeader` label. */
-type CatalogExampleAlign = 'glyph' | 'inline-control' | 'none';
+type CatalogExampleAlign = 'glyph' | 'inline-control' | 'text-trigger' | 'none';
 interface CatalogExampleViewport {
     layout?: 'grid' | 'flex' | 'flex-column';
     width?: 'full' | 'compact' | 'medium' | 'wide' | 'text' | 'control';

package/dist/catalog.js

@@ -1,6 +1,6 @@
-import { Workbench } from './chunk-KFYANKJI.js';
+import { Workbench } from './chunk-PWQAVNON.js';
 
-import { PopupMenu } from './chunk-ZRWXFDDS.js';
+import { PopupMenu } from './chunk-J3KGJ6P6.js';
 
 import { Row } from './chunk-VZOFZPSO.js';
 import { ListHeader } from './chunk-5IJ6UGNZ.js';
@@ -15,7 +15,7 @@ import { ToolbarText } from './chunk-V3DX3K65.js';
 
 
 
-import { List } from './chunk-NAPE7WUS.js';
+import { List } from './chunk-W2AC6Q2A.js';
 
 import { ToolbarControlGroup, ToolbarActionLink } from './chunk-NXWE5S57.js';
 import { Toolbar } from './chunk-RGS4WX2M.js';