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

package/dist/index.js

@@ -1,7 +1,8 @@
 export { wireResizableRegions } from './chunk-XQV2B4IL.js';
 export { reorderTabs, wireTabBars } from './chunk-46263QLK.js';
-export { wireTokenSearchFields } from './chunk-NBYTIVHS.js';
-export { TokenSearchField, placeTokenSearchCaret, readTokenSearchField } from './chunk-63ZWBGE3.js';
+export { wireTokenSearchFields } from './chunk-UFYZHYWU.js';
+export { TokenSearchField, placeTokenSearchCaret, readTokenSearchField } from './chunk-RRB26JRJ.js';
+export { createTokenSearchModel } from './chunk-F7F7KRO2.js';
 export { ValueTable, ValueTableRow } from './chunk-6CINWX2E.js';
 export { wireScrollDividers } from './chunk-JCV4GXWB.js';
 
@@ -17,7 +18,7 @@ export { EmptyState } from './chunk-E36EVCKG.js';
 export { Grid } from './chunk-AGXQQFKZ.js';
 export { ListActionRow } from './chunk-F4QMLOXJ.js';
 export { AppTab } from './chunk-WOUF7YXM.js';
-export { PopupMenu } from './chunk-WLG6SSNT.js';
+export { PopupMenu, closePopupMenu, openPopupMenuAt } from './chunk-UWONG4QE.js';
 export { ResizableRegion, clampRegionSize, resizeRegionFromPointer } from './chunk-VHADGP3B.js';
 export { Row } from './chunk-VZOFZPSO.js';
 export { ListInsetText } from './chunk-DG6G5EPF.js';
@@ -28,12 +29,12 @@ export { ToolbarText } from './chunk-XDKAYSVD.js';
 export { FloatingToolbar } from './chunk-M7QV3IHH.js';
 
 export { LoadingSpinner } from './chunk-ZLWQZUGF.js';
-export { ListHeader } from './chunk-553ASUK6.js';
-export { Text } from './chunk-24PHKUR3.js';
+export { ListHeader } from './chunk-UX2VVXZ3.js';
+export { Text } from './chunk-UXT7TE6B.js';
 export { DisclosureArrow } from './chunk-KROD7KZK.js';
 export { Skeleton } from './chunk-AHEG27M7.js';
 export { Badge } from './chunk-MP2GDBQZ.js';
-export { ToolbarActionLink, ToolbarControlGroup } from './chunk-ZIYOJFZD.js';
+export { ToolbarActionLink, ToolbarControlGroup } from './chunk-7JUBXOIV.js';
 export { Toolbar } from './chunk-6YFHCLHG.js';
 export { Pane } from './chunk-EZVNC4J6.js';
 export { LucideIcon } from './chunk-4R777DUZ.js';

package/dist/list-header.js

@@ -1,4 +1,4 @@
-export { ListHeader } from './chunk-553ASUK6.js';
+export { ListHeader } from './chunk-UX2VVXZ3.js';
 
 
 

package/dist/nav-stack.js

@@ -1,4 +1,4 @@
-export { NavStack } from './chunk-PWXNJS2B.js';
+export { NavStack } from './chunk-W4XKTST6.js';
 
 
 

package/dist/{panel-toolbar-BN4x0rth.d.ts → panel-toolbar-DqwtBxQL.d.ts}

@@ -33,17 +33,17 @@ interface PanelToggle {
  * A collapsible panel's top toolbar, composed so its groups follow the
  * panel's open state.
  *
- * - `title` (a `ToolbarText`) and `panelOnly` groups lead the toolbar and are
- *   available only while the panel is open.
- * - `constant` groups stay available either way: they trail the panel's
- *   toolbar while it is open and move to the work area's toolbar while it is
- *   collapsed.
+ * - `title` precedes the `leading` zone. Groups may appear in any of the
+ *   `leading`, `center`, and `trailing` zones while the panel is open.
+ * - Groups marked `relocateOnCollapse` move to the work area's toolbar while
+ *   the panel is collapsed, preserving their order across the three zones.
  * - `toggle` is always the last group: in the panel's toolbar while it is
- *   open, and right after the `constant` groups in the work area's toolbar
+ *   open, and right after the relocated groups in the work area's toolbar
  *   while it is collapsed.
  *
- * `constant` content renders in both places while the panel is collapsed (the
- * panel's copy is inert), so give it no `id`s.
+ * Relocated content renders in both places while the panel is collapsed (the
+ * panel's copy is inert), so give it no `id`s. Pass groups directly or in
+ * arrays so their render-time annotation remains available to the panel.
  *
  * The toolbar's configuration (`dividerSides`, `centerAlign`, `responsive`,
  * `responsiveAt`, `safeAreaEdges`) forwards to its `Toolbar`. It draws no
@@ -54,10 +54,9 @@ interface PanelToolbar extends ToolbarConfig {
     /** Accessible name of the panel's toolbar. */
     label: string;
     title?: KerfUiContent;
-    panelOnly?: KerfUiContent;
-    /** Panel-only center content, available only while the panel is open. */
+    leading?: KerfUiContent;
     center?: KerfUiContent;
-    constant?: KerfUiContent;
+    trailing?: KerfUiContent;
     toggle?: PanelToggle;
 }
 

package/dist/popup-menu.d.ts

@@ -18,9 +18,19 @@ interface PopupMenuItem {
     value?: string;
     /** Leading icon, typically a `LucideIcon`; it is placed in the item's icon slot. */
     icon?: SafeHtml;
+    /** A checked menu choice, including nested choices. */
+    checked?: boolean;
+    /** Trailing safe content, such as a selected-choice tick. */
+    details?: SafeHtml;
+    /** Destructive command styling. */
+    tone?: 'default' | 'danger';
     disabled?: boolean;
+    /** Native tooltip text for a disabled command. */
+    disabledReason?: string;
     /** Application `data-*` metadata such as a record id. */
     attributes?: PopupMenuDataAttributes;
+    /** Child commands opened by hover or keyboard navigation. */
+    submenu?: readonly PopupMenuItem[];
 }
 /** A labeled group heading; items that follow it belong to the group. */
 interface PopupMenuHeading {
@@ -44,7 +54,17 @@ type PopupMenuTriggerName = {
      */
     label: string;
 };
-type PopupMenuProps = PopupMenuTriggerName & {
+type PopupMenuTrigger = (PopupMenuTriggerName & {
+    context?: false;
+}) | {
+    context: true;
+    label: string;
+    text?: never;
+    icon?: never;
+    caret?: never;
+    disabled?: never;
+};
+type PopupMenuProps = PopupMenuTrigger & {
     /** Trigger icon, typically a `LucideIcon`, before any visible text. */
     icon?: KerfUiContent;
     items: readonly PopupMenuEntry[];
@@ -58,6 +78,14 @@ type PopupMenuProps = PopupMenuTriggerName & {
     /** Native named-slot assignment when composed inside a web component. */
     slot?: string;
 };
+/** A rendered context PopupMenu with Web Awesome's controlled open state. */
+type PopupMenuElement = HTMLElement & {
+    open: boolean;
+};
+/** Open a context PopupMenu at viewport pointer coordinates. */
+declare function openPopupMenuAt(menu: PopupMenuElement, x: number, y: number): void;
+/** Close a programmatically opened PopupMenu. */
+declare function closePopupMenu(menu: PopupMenuElement): void;
 /**
  * An action menu: a trigger button that opens a list of commands. Renders the
  * `wa-dropdown` root directly, so a `single` `ToolbarControlGroup` (with
@@ -66,6 +94,6 @@ type PopupMenuProps = PopupMenuTriggerName & {
  * open-state reaction. Import `@kerfjs/ui/popup-menu/register` once to register
  * the Web Awesome elements.
  */
-declare function PopupMenu({ text, label, icon, items, placement, caret, disabled, rootAttributes, slot, }: PopupMenuProps): SafeHtml;
+declare function PopupMenu({ text, label, icon, items, placement, caret, disabled, rootAttributes, slot, context, }: PopupMenuProps): SafeHtml;
 
-export { PopupMenu, type PopupMenuDivider, type PopupMenuEntry, type PopupMenuHeading, type PopupMenuItem, type PopupMenuPlacement, type PopupMenuProps };
+export { PopupMenu, type PopupMenuDivider, type PopupMenuElement, type PopupMenuEntry, type PopupMenuHeading, type PopupMenuItem, type PopupMenuPlacement, type PopupMenuProps, closePopupMenu, openPopupMenuAt };

package/dist/popup-menu.js

@@ -1,3 +1,3 @@
-export { PopupMenu } from './chunk-WLG6SSNT.js';
+export { PopupMenu, closePopupMenu, openPopupMenuAt } from './chunk-UWONG4QE.js';
 
 //# sourceMappingURL=popup-menu.js.map

package/dist/split-view.js

@@ -1,4 +1,4 @@
-import { NavStack } from './chunk-PWXNJS2B.js';
+import { NavStack } from './chunk-W4XKTST6.js';
 import { ResizableRegion } from './chunk-VHADGP3B.js';
 
 

package/dist/styles/popup-menu.css

@@ -33,7 +33,7 @@
   scale: none !important;
 }
 
-.kui-popup-menu > wa-dropdown-item {
+.kui-popup-menu wa-dropdown-item {
   /* Leading inset plus the Select's check column, so item icons and labels
      start where a Select option's do. */
   padding: var(--_kui-popup-row-padding-block)
@@ -43,13 +43,13 @@
         var(--_kui-popup-row-check-width)
     );
 }
-.kui-popup-menu > wa-dropdown-item::part(label) {
+.kui-popup-menu wa-dropdown-item::part(label) {
   padding-block: var(--_kui-popup-row-label-padding-block);
   line-height: var(--_kui-popup-row-label-line-height);
 }
 /* A keyboard-focused item is the menu's current row: the Select's brand fill,
    with no second focus ring inside the open popup. */
-.kui-popup-menu > wa-dropdown-item:focus-visible {
+.kui-popup-menu wa-dropdown-item:focus-visible {
   outline: none;
   color: var(--_kui-popup-row-current-color);
   background-color: var(--_kui-popup-row-current-background);
@@ -59,7 +59,7 @@
 }
 
 /* Center the icon on the label's line, like the Select's start slot. */
-.kui-popup-menu > wa-dropdown-item::part(icon) {
+.kui-popup-menu wa-dropdown-item::part(icon) {
   display: flex;
   align-self: center;
 }
@@ -78,6 +78,35 @@
   height: 100%;
 }
 
+.kui-popup-menu__details {
+  display: inline-flex;
+  align-items: center;
+}
+
+.kui-popup-menu__details svg {
+  display: block;
+  width: var(--_kui-popup-row-icon-size);
+  height: var(--_kui-popup-row-icon-size);
+}
+
+.kui-popup-menu[data-trigger="context"] {
+  display: inline-block;
+  width: 0;
+  height: 0;
+}
+
+.kui-popup-menu__context-anchor {
+  position: fixed;
+  top: var(--kui-popup-menu-context-y, 0px);
+  left: var(--kui-popup-menu-context-x, 0px);
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  border: 0;
+  opacity: 0;
+  pointer-events: none;
+}
+
 /* A group title matches the Select's group title. It is a styled element
    rather than a slotted heading, whose Web Awesome metrics are !important. */
 .kui-popup-menu__heading {

package/dist/styles/text.css

@@ -17,6 +17,14 @@
   font-size: var(--kui-font-xs);
 }
 
+.kui-text[data-size="large"] {
+  font-size: var(--kui-font-l);
+}
+
+.kui-text[data-size="xlarge"] {
+  font-size: var(--kui-font-2xl);
+}
+
 .kui-text[data-font="monospace"] {
   font-family: var(--kui-font-mono);
 }

package/dist/styles/token-search-field.css

@@ -145,6 +145,35 @@
   grid-column: 4;
 }
 
+.kui-token-search__suggestions {
+  display: grid;
+  grid-column: 2 / -1;
+  min-width: 0;
+  padding: 0.25rem;
+  border: 1px solid var(--kui-token-search-border);
+  border-radius: var(--kui-radius-pill);
+  background: var(--kui-token-search-background);
+  gap: 0.125rem;
+}
+
+.kui-token-search__suggestion {
+  width: 100%;
+  padding: 0.375rem 0.5rem;
+  border: 0;
+  border-radius: var(--kui-radius-pill);
+  color: var(--kui-color-text);
+  background: transparent;
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+}
+
+.kui-token-search__suggestion:hover,
+.kui-token-search__suggestion:focus-visible {
+  background: var(--kui-color-surface-lowered);
+  outline: var(--kui-focus-ring);
+}
+
 .kui-token-search[data-has-trailing="false"] .kui-token-search__clear {
   grid-column: 4;
 }

package/dist/text.d.ts

@@ -4,7 +4,7 @@ import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
 
 type TextVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span';
 type TextTone = 'default' | 'quiet' | 'danger';
-type TextSize = 'default' | 'compact';
+type TextSize = 'compact' | 'default' | 'large' | 'xlarge';
 type TextFont = 'default' | 'monospace';
 type TextBorder = 'transparent' | 'none';
 type TextContent = KerfUiContent | string | number | readonly TextContent[];

package/dist/text.js

@@ -1,3 +1,3 @@
-export { Text } from './chunk-24PHKUR3.js';
+export { Text } from './chunk-UXT7TE6B.js';
 
 //# sourceMappingURL=text.js.map

package/dist/token-search-field-CCke1yvQ.d.ts

@@ -0,0 +1,126 @@
+import { Signal, SafeHtml } from 'kerfjs';
+import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
+
+interface TokenSearchRule {
+    /** The word before `:` (for example `tag` or `status`). */
+    name: string;
+    /** Return a canonical value, or undefined to leave invalid input as text. */
+    parse?: (input: string) => string | undefined;
+    /** Label for a committed chip. Defaults to `name:input`. */
+    label?: (value: string, input: string) => string;
+    /** Suggestions for the unfinished value after `name:`. */
+    suggest?: (input: string) => readonly (string | {
+        value: string;
+        label: string;
+    })[];
+}
+interface TokenSearchResolvedToken extends TokenSearchToken {
+    kind: string;
+    parsedValue: string;
+}
+interface TokenSearchState {
+    query: string;
+    tokens: TokenSearchResolvedToken[];
+}
+interface TokenSearchSuggestion {
+    value: string;
+    label: string;
+}
+interface TokenSearchModel<Result = unknown> {
+    state: Signal<TokenSearchState>;
+    /** Changes when a model action must replace DOM-owned editor text. */
+    editorRevision: Signal<number>;
+    suggestions: Signal<readonly TokenSearchSuggestion[]>;
+    result: Signal<Result | undefined>;
+    edit(value: TokenSearchFieldValue, commit?: boolean): void;
+    submit(value: TokenSearchFieldValue): void;
+    choose(value: string): void;
+    expandToken(value: string): void;
+    remove(value: string): void;
+    clear(): void;
+    dismiss(): void;
+}
+interface TokenSearchModelOptions<Result> {
+    rules?: readonly TokenSearchRule[];
+    initial?: TokenSearchFieldValue;
+    /** Runs after every state change, including initial state. */
+    evaluate?: (state: TokenSearchState) => Result;
+    onSubmit?: (state: TokenSearchState, result: Result | undefined) => void;
+}
+/** Opt-in state, token parsing, suggestions, and evaluation for TokenSearchField. */
+declare function createTokenSearchModel<Result = unknown>({ rules, initial, evaluate, onSubmit, }?: TokenSearchModelOptions<Result>): TokenSearchModel<Result>;
+
+interface TokenSearchToken {
+    value: string;
+    label: string;
+    offset?: number;
+    accessibleLabel?: string;
+}
+type TokenSearchEditorAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
+    'data-component'?: never;
+    'data-key'?: never;
+    'data-morph-skip'?: never;
+    'data-token-search-editor'?: never;
+    'data-token-count'?: never;
+    'data-placeholder'?: never;
+}>;
+interface TokenSearchFieldBaseProps {
+    id: string;
+    label: string;
+    query?: string;
+    tokens?: readonly TokenSearchToken[];
+    /** Opt-in grammar, suggestion, and evaluation state. Overrides `query` and `tokens`. */
+    model?: TokenSearchModel;
+    /**
+     * Editor identity for a programmatic text replacement. The editor's text is
+     * DOM-owned between token changes, so a new `query` with the same tokens
+     * does not re-render it (that would reset the caret on every keystroke).
+     * Change `revision` when the app replaces the text itself — reseeding a
+     * persistent dialog's field on reopen, applying a saved search — and the
+     * editor is rebuilt from `query` and `tokens`.
+     */
+    revision?: string | number;
+    placeholder?: string;
+    tokenPlaceholder?: string;
+    disabled?: boolean;
+    autofocus?: boolean;
+    leading?: KerfUiContent;
+    trailing?: KerfUiContent;
+    /** Standalone field chrome or the inset visual layer of a configured toolbar group. */
+    presentation?: 'standalone' | 'toolbar-group';
+    editAction?: string;
+    removeAction?: string;
+    clearAction?: string;
+    clearLabel?: string;
+    /** Icon for the clear button. Default: the Lucide `x` glyph token chips also use. */
+    clearIcon?: SafeHtml;
+    className?: string;
+    editorAttributes?: TokenSearchEditorAttributes;
+    /** Native named-slot assignment when composed inside a web component. */
+    slot?: string;
+}
+type TokenSearchCollapsibleProps = {
+    /** Allow an empty field to render as one iconic action. */
+    collapsible: true;
+    /** Keep an empty collapsible field open while the application owns focus. */
+    expanded?: boolean;
+    expandAction?: string;
+    expandLabel?: string;
+} | {
+    collapsible?: false;
+    expanded?: never;
+    expandAction?: never;
+    expandLabel?: never;
+};
+type TokenSearchFieldProps = TokenSearchFieldBaseProps & TokenSearchCollapsibleProps;
+interface TokenSearchFieldValue {
+    query: string;
+    tokens: TokenSearchToken[];
+}
+declare function TokenSearchField({ id, label, query, tokens, model, revision, placeholder, tokenPlaceholder, disabled, autofocus, collapsible, expanded, expandAction, expandLabel, leading, trailing, presentation, editAction, removeAction, clearAction, clearLabel, clearIcon, className, editorAttributes, slot, }: TokenSearchFieldProps): SafeHtml;
+/** Read editable text and ordered token offsets from a rendered TokenSearchField editor. */
+declare function readTokenSearchField(editor: HTMLElement, knownTokens?: readonly TokenSearchToken[]): TokenSearchFieldValue;
+/** Focus an editor and place its caret at a text offset, skipping atomic token chips. */
+declare function placeTokenSearchCaret(editor: HTMLElement, offset?: number): void;
+
+export { type TokenSearchEditorAttributes as T, TokenSearchField as a, type TokenSearchFieldProps as b, type TokenSearchFieldValue as c, type TokenSearchModel as d, type TokenSearchModelOptions as e, type TokenSearchResolvedToken as f, type TokenSearchRule as g, type TokenSearchState as h, type TokenSearchSuggestion as i, type TokenSearchToken as j, createTokenSearchModel as k, placeTokenSearchCaret as p, readTokenSearchField as r };

package/dist/token-search-field.d.ts

@@ -1,75 +1,3 @@
-import { SafeHtml } from 'kerfjs';
-import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
-
-interface TokenSearchToken {
-    value: string;
-    label: string;
-    offset?: number;
-    accessibleLabel?: string;
-}
-type TokenSearchEditorAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
-    'data-component'?: never;
-    'data-key'?: never;
-    'data-morph-skip'?: never;
-    'data-token-search-editor'?: never;
-    'data-token-count'?: never;
-    'data-placeholder'?: never;
-}>;
-interface TokenSearchFieldBaseProps {
-    id: string;
-    label: string;
-    query?: string;
-    tokens?: readonly TokenSearchToken[];
-    /**
-     * Editor identity for a programmatic text replacement. The editor's text is
-     * DOM-owned between token changes, so a new `query` with the same tokens
-     * does not re-render it (that would reset the caret on every keystroke).
-     * Change `revision` when the app replaces the text itself — reseeding a
-     * persistent dialog's field on reopen, applying a saved search — and the
-     * editor is rebuilt from `query` and `tokens`.
-     */
-    revision?: string | number;
-    placeholder?: string;
-    tokenPlaceholder?: string;
-    disabled?: boolean;
-    autofocus?: boolean;
-    leading?: KerfUiContent;
-    trailing?: KerfUiContent;
-    /** Standalone field chrome or the inset visual layer of a configured toolbar group. */
-    presentation?: 'standalone' | 'toolbar-group';
-    editAction?: string;
-    removeAction?: string;
-    clearAction?: string;
-    clearLabel?: string;
-    /** Icon for the clear button. Default: the Lucide `x` glyph token chips also use. */
-    clearIcon?: SafeHtml;
-    className?: string;
-    editorAttributes?: TokenSearchEditorAttributes;
-    /** Native named-slot assignment when composed inside a web component. */
-    slot?: string;
-}
-type TokenSearchCollapsibleProps = {
-    /** Allow an empty field to render as one iconic action. */
-    collapsible: true;
-    /** Keep an empty collapsible field open while the application owns focus. */
-    expanded?: boolean;
-    expandAction?: string;
-    expandLabel?: string;
-} | {
-    collapsible?: false;
-    expanded?: never;
-    expandAction?: never;
-    expandLabel?: never;
-};
-type TokenSearchFieldProps = TokenSearchFieldBaseProps & TokenSearchCollapsibleProps;
-interface TokenSearchFieldValue {
-    query: string;
-    tokens: TokenSearchToken[];
-}
-declare function TokenSearchField({ id, label, query, tokens, revision, placeholder, tokenPlaceholder, disabled, autofocus, collapsible, expanded, expandAction, expandLabel, leading, trailing, presentation, editAction, removeAction, clearAction, clearLabel, clearIcon, className, editorAttributes, slot, }: TokenSearchFieldProps): SafeHtml;
-/** Read editable text and ordered token offsets from a rendered TokenSearchField editor. */
-declare function readTokenSearchField(editor: HTMLElement, knownTokens?: readonly TokenSearchToken[]): TokenSearchFieldValue;
-/** Focus an editor and place its caret at a text offset, skipping atomic token chips. */
-declare function placeTokenSearchCaret(editor: HTMLElement, offset?: number): void;
-
-export { type TokenSearchEditorAttributes, TokenSearchField, type TokenSearchFieldProps, type TokenSearchFieldValue, type TokenSearchToken, placeTokenSearchCaret, readTokenSearchField };
+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-CCke1yvQ.js';

package/dist/token-search-field.js

@@ -1,4 +1,4 @@
-export { TokenSearchField, placeTokenSearchCaret, readTokenSearchField } from './chunk-63ZWBGE3.js';
+export { TokenSearchField, placeTokenSearchCaret, readTokenSearchField } from './chunk-RRB26JRJ.js';
 
 
 //# sourceMappingURL=token-search-field.js.map

package/dist/token-search-model.d.ts

@@ -0,0 +1,3 @@
+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-CCke1yvQ.js';
+import './semantic-content-BbzjvSu9.js';

package/dist/token-search-model.js

@@ -0,0 +1,3 @@
+export { createTokenSearchModel } from './chunk-F7F7KRO2.js';
+
+//# sourceMappingURL=token-search-model.js.map

package/dist/token-search-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"token-search-model.js"}

package/dist/toolbar-control-group.d.ts

@@ -56,6 +56,8 @@ interface ToolbarControlGroupProps {
     overflow?: ToolbarControlGroupOverflow;
     /** Responsive visibility owned by the enclosing Toolbar container. */
     visibility?: ToolbarControlGroupVisibility;
+    /** Move this group into the work-area toolbar when its panel collapses. */
+    relocateOnCollapse?: boolean;
     /** Add contrast behind photo-backed avatar content. */
     scrim?: boolean;
     /**
@@ -66,6 +68,6 @@ interface ToolbarControlGroupProps {
     /** Native named-slot assignment when composed inside a web component. */
     slot?: string;
 }
-declare function ToolbarControlGroup({ children, label, className, expanded, single, appearance, tone, buttonAppearance, shape, size, density, content, focusRing, selectedChrome, selectedTone, nestedDropdown, menuInset, overflow, visibility, scrim, avatarImage, slot, }: ToolbarControlGroupProps): kerfjs.SafeHtml;
+declare function ToolbarControlGroup({ children, label, className, expanded, single, appearance, tone, buttonAppearance, shape, size, density, content, focusRing, selectedChrome, selectedTone, nestedDropdown, menuInset, overflow, visibility, relocateOnCollapse, scrim, avatarImage, slot, }: ToolbarControlGroupProps): kerfjs.SafeHtml;
 
 export { ToolbarActionLink, type ToolbarActionLinkProps, ToolbarControlGroup, type ToolbarControlGroupAppearance, type ToolbarControlGroupButtonAppearance, type ToolbarControlGroupContent, type ToolbarControlGroupDensity, type ToolbarControlGroupFocusRing, type ToolbarControlGroupMenuInset, type ToolbarControlGroupOverflow, type ToolbarControlGroupProps, type ToolbarControlGroupSelectedChrome, type ToolbarControlGroupSelectedTone, type ToolbarControlGroupShape, type ToolbarControlGroupSize, type ToolbarControlGroupTone, type ToolbarControlGroupVisibility };

package/dist/toolbar-control-group.js

@@ -1,3 +1,3 @@
-export { ToolbarActionLink, ToolbarControlGroup } from './chunk-ZIYOJFZD.js';
+export { ToolbarActionLink, ToolbarControlGroup } from './chunk-7JUBXOIV.js';
 
 //# sourceMappingURL=toolbar-control-group.js.map

package/dist/wire-token-search-fields.d.ts

@@ -1,4 +1,6 @@
 import { Signal } from 'kerfjs';
+import { d as TokenSearchModel } from './token-search-field-CCke1yvQ.js';
+import './semantic-content-BbzjvSu9.js';
 
 interface TokenSearchSubmit {
     id: string;
@@ -76,6 +78,8 @@ interface TokenSearchCollapsibleOptions {
     signals?: Readonly<Record<string, Signal<boolean>>>;
 }
 interface WireTokenSearchFieldsOptions {
+    /** Optional automatic grammar/suggestion models, keyed by TokenSearchField id. */
+    models?: Readonly<Record<string, TokenSearchModel>>;
     onSubmit?: (submission: TokenSearchSubmit) => void;
     /** Fired on every editor `input`, after the browser mutates it, so a caller can drop its own `input` listener. */
     onEdit?: (edit: TokenSearchEdit) => void;
@@ -106,6 +110,6 @@ interface TokenSearchFieldsHandle {
  * expand/collapse/focus. Returns a {@link TokenSearchFieldsHandle} — a disposer that also
  * exposes the managed `expanded` state per field id.
  */
-declare function wireTokenSearchFields(root: HTMLElement, { onSubmit, onEdit, collapsible, keyboard, }?: WireTokenSearchFieldsOptions): TokenSearchFieldsHandle;
+declare function wireTokenSearchFields(root: HTMLElement, { models, onSubmit, onEdit, collapsible, keyboard, }?: WireTokenSearchFieldsOptions): TokenSearchFieldsHandle;
 
 export { type TokenSearchCollapsibleOptions, type TokenSearchEdit, type TokenSearchFieldsHandle, type TokenSearchKeyboardOptions, type TokenSearchSubmit, type TokenSearchTokenRemoval, type WireTokenSearchFieldsOptions, wireTokenSearchFields };

package/dist/wire-token-search-fields.js

@@ -1,4 +1,4 @@
-export { wireTokenSearchFields } from './chunk-NBYTIVHS.js';
+export { wireTokenSearchFields } from './chunk-UFYZHYWU.js';
 
 
 

package/dist/workbench.d.ts

@@ -3,7 +3,7 @@ import { ListConfig } from './list.js';
 import { PaneConfig } from './pane.js';
 import { ResizableRegionSeparator, ResizableRegionCollapseMotion, ResizableRegionContentOverflow, ResizableRegionPresentation, ResizableRegionRestorePosition } from './resizable-region.js';
 import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
-import { a as PanelToolbar, b as PanelToggle } from './panel-toolbar-BN4x0rth.js';
+import { a as PanelToolbar, b as PanelToggle } from './panel-toolbar-DqwtBxQL.js';
 import { ToolbarConfig } from './toolbar.js';
 import './css-values.js';
 import './flex-alignment-4ms8ZbV8.js';
@@ -16,7 +16,7 @@ type WorkbenchPanelToggle = PanelToggle;
 /**
  * A Workbench panel's top toolbar, composed by the Workbench so its groups can
  * follow the panel's open state (see {@link PanelToolbar} for the roles).
- * A collapsed rail's `constant` groups and toggle go to the leading edge of
+ * A collapsed rail's marked groups and toggle go to the leading edge of
  * `mainToolbar` (left rail) or its trailing edge (right rail); a collapsed
  * drawer's go to the trailing edge of `mainBottomToolbar`, else to a
  * `FloatingToolbar` in the work area's bottom-end corner.
@@ -83,7 +83,7 @@ interface WorkbenchPanelResizable {
 interface WorkbenchPanel {
     content: KerfUiContent;
     /**
-     * The panel's top toolbar, composed by the Workbench: its `constant` groups
+     * The panel's top toolbar, composed by the Workbench: its marked groups
      * and standard `toggle` move to the work area's toolbar while the panel is
      * collapsed. With it, `content` renders in a `Pane` below the toolbar.
      */
@@ -154,7 +154,7 @@ interface WorkbenchProps {
     /** The central work area. */
     main: KerfUiContent;
     /**
-     * The work area's top toolbar. A collapsed left rail's `constant` groups
+     * The work area's top toolbar. A collapsed left rail's marked groups
      * and toggle lead it; a collapsed right rail's trail it. With it, `main`
      * renders in a `Pane` below the toolbar.
      */
@@ -170,7 +170,7 @@ interface WorkbenchProps {
      */
     mainFooter?: KerfUiContent;
     /**
-     * The work area's bottom toolbar. A collapsed drawer's `constant` groups and
+     * The work area's bottom toolbar. A collapsed drawer's marked groups and
      * toggle trail it; without it they float in the work area's corner.
      */
     mainBottomToolbar?: WorkbenchMainBottomToolbar;

package/dist/workbench.js

@@ -1,4 +1,4 @@
-export { Workbench } from './chunk-G2RKFVRB.js';
+export { Workbench } from './chunk-2CCMJTVY.js';