@kerfjs/ui 5.0.0-beta.104 → 5.0.0-beta.106

package/dist/{token-search-model-JA1i8z4D.d.ts → search-field-CrGTN5sa.d.ts}

@@ -1,7 +1,7 @@
 import { SafeHtml, Signal, ReadonlySignal } from 'kerfjs';
 import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
 
-interface TokenSearchToken {
+interface SearchFieldToken {
     value: string;
     label: string;
     offset?: number;
@@ -11,12 +11,12 @@ interface TokenSearchToken {
  * Domain `data-*` metadata for a trailing action button. The component owns
  * `data-action` (pass `action`) and its state attributes.
  */
-type TokenSearchTrailingActionAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
+type SearchFieldTrailingActionAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
     'data-action'?: never;
     'data-component'?: never;
     'data-key'?: never;
 }>;
-interface TokenSearchTrailingActionBase {
+interface SearchFieldTrailingActionBase {
     /** Decorative glyph, such as a `LucideIcon`. */
     icon: SafeHtml;
     /** Accessible name and tooltip, in title style ("Search Help"). */
@@ -29,35 +29,35 @@ interface TokenSearchTrailingActionBase {
     /** `aria-haspopup` for a button that opens a dialog, menu, or listbox. */
     haspopup?: 'dialog' | 'menu' | 'listbox' | 'true';
     /** Domain `data-*` metadata for the app's delegated handler. */
-    attributes?: TokenSearchTrailingActionAttributes;
+    attributes?: SearchFieldTrailingActionAttributes;
 }
 /**
  * A compact icon button in the field's trailing slot, sized and styled like
  * the clear button. Pass `expanded` for a disclosure (a help surface it opens)
  * or `pressed` for a toggle; the button shows the state with its hover fill.
  */
-type TokenSearchTrailingAction = TokenSearchTrailingActionBase & ({
+type SearchFieldTrailingAction = SearchFieldTrailingActionBase & ({
     expanded?: boolean;
     pressed?: never;
 } | {
     expanded?: never;
     pressed?: boolean;
 });
-type TokenSearchEditorAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
+type SearchFieldEditorAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
     'data-component'?: never;
     'data-key'?: never;
     'data-morph-skip'?: never;
-    'data-token-search-editor'?: never;
+    'data-search-field-editor'?: never;
     'data-token-count'?: never;
     'data-placeholder'?: never;
 }>;
-interface TokenSearchFieldBaseProps {
+interface SearchFieldBaseProps {
     id: string;
     label: string;
     query?: string;
-    tokens?: readonly TokenSearchToken[];
+    tokens?: readonly SearchFieldToken[];
     /** Opt-in grammar, suggestion, and evaluation state. Overrides `query` and `tokens`. */
-    model?: TokenSearchModel;
+    model?: SearchFieldModel;
     /**
      * 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
@@ -81,18 +81,18 @@ interface TokenSearchFieldBaseProps {
     /** Icon for the clear button. Default: the Lucide `x` glyph token chips also use. */
     clearIcon?: SafeHtml;
     className?: string;
-    editorAttributes?: TokenSearchEditorAttributes;
+    editorAttributes?: SearchFieldEditorAttributes;
     /** Native named-slot assignment when composed inside a web component. */
     slot?: string;
 }
-type TokenSearchTrailingProps = {
+type SearchFieldTrailingProps = {
     trailing?: KerfUiContent;
     trailingAction?: never;
 } | {
     trailing?: never;
-    trailingAction: TokenSearchTrailingAction;
+    trailingAction: SearchFieldTrailingAction;
 };
-type TokenSearchPresentationProps = {
+type SearchFieldPresentationProps = {
     /** Standalone field chrome or the inset visual layer of a configured toolbar group. */
     presentation?: 'standalone' | 'toolbar-group';
     hint?: never;
@@ -104,7 +104,7 @@ type TokenSearchPresentationProps = {
     /** Marks the editor required; the app validates its value. */
     required?: boolean;
 };
-type TokenSearchCollapsibleProps = {
+type SearchFieldCollapsibleProps = {
     /** Allow an empty field to render as one iconic action. */
     collapsible: true;
     /** Keep an empty collapsible field open while the application owns focus. */
@@ -117,18 +117,18 @@ type TokenSearchCollapsibleProps = {
     expandAction?: never;
     expandLabel?: never;
 };
-type TokenSearchFieldProps = TokenSearchFieldBaseProps & TokenSearchCollapsibleProps & TokenSearchTrailingProps & TokenSearchPresentationProps;
-interface TokenSearchFieldValue {
+type SearchFieldProps = SearchFieldBaseProps & SearchFieldCollapsibleProps & SearchFieldTrailingProps & SearchFieldPresentationProps;
+interface SearchFieldValue {
     query: string;
-    tokens: TokenSearchToken[];
+    tokens: SearchFieldToken[];
 }
-declare function TokenSearchField({ id, label, query, tokens, model, revision, placeholder, tokenPlaceholder, disabled, autofocus, fill, collapsible, expanded, expandAction, expandLabel, leading, trailing, trailingAction, presentation, hint, required, 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;
+declare function SearchField({ id, label, query, tokens, model, revision, placeholder, tokenPlaceholder, disabled, autofocus, fill, collapsible, expanded, expandAction, expandLabel, leading, trailing, trailingAction, presentation, hint, required, editAction, removeAction, clearAction, clearLabel, clearIcon, className, editorAttributes, slot, }: SearchFieldProps): SafeHtml;
+/** Read editable text and ordered token offsets from a rendered SearchField editor. */
+declare function readSearchField(editor: HTMLElement, knownTokens?: readonly SearchFieldToken[]): SearchFieldValue;
 /** Focus an editor and place its caret at a text offset, skipping atomic token chips. */
-declare function placeTokenSearchCaret(editor: HTMLElement, offset?: number): void;
+declare function placeSearchFieldCaret(editor: HTMLElement, offset?: number): void;
 
-interface TokenSearchRule {
+interface SearchFieldRule {
     /** The word before `:` (for example `tag` or `status`). */
     name: string;
     /** Return a canonical value, or undefined to leave invalid input as text. */
@@ -136,20 +136,20 @@ interface TokenSearchRule {
     /** Label for a committed chip. Defaults to `name:input`. */
     label?: (value: string, input: string) => string;
     /** Suggestions for the unfinished value after `name:`, with current committed tokens. */
-    suggest?: (input: string, state: TokenSearchState) => readonly (string | {
+    suggest?: (input: string, state: SearchFieldState) => readonly (string | {
         value: string;
         label: string;
     })[];
 }
-interface TokenSearchResolvedToken extends TokenSearchToken {
+interface SearchFieldResolvedToken extends SearchFieldToken {
     kind: string;
     parsedValue: string;
 }
-interface TokenSearchState {
+interface SearchFieldState {
     query: string;
-    tokens: TokenSearchResolvedToken[];
+    tokens: SearchFieldResolvedToken[];
 }
-interface TokenSearchSuggestion {
+interface SearchFieldSuggestion {
     value: string;
     label: string;
 }
@@ -157,7 +157,7 @@ interface TokenSearchSuggestion {
  * The render-relevant shape of a managed field: everything a host render
  * needs to re-run for. Plain text edits do not change it.
  */
-interface TokenSearchStructure {
+interface SearchFieldStructure {
     /** Whether the free text is non-empty (drives clear, placeholder, and collapsed state). */
     hasQuery: boolean;
     /** Committed token values in editor order. */
@@ -165,28 +165,28 @@ interface TokenSearchStructure {
     /** The model's editor revision (programmatic text replacement). */
     editorRevision: number;
 }
-interface TokenSearchModel<Result = unknown> {
+interface SearchFieldModel<Result = unknown> {
     /**
      * The live query and tokens. Changes on every keystroke: read it with
      * `.peek()` (or in an event handler) to avoid subscribing a render per key.
      */
-    state: Signal<TokenSearchState>;
+    state: Signal<SearchFieldState>;
     /** Changes when a model action must replace DOM-owned editor text. */
     editorRevision: Signal<number>;
     /**
      * Changes only on structural edits (a token committed, removed, or
      * reordered; the text becoming empty or non-empty; an editor revision), and
-     * keeps the same reference otherwise. `TokenSearchField` subscribes to this
+     * keeps the same reference otherwise. `SearchField` subscribes to this
      * instead of `state`, so typing does not re-run the host render.
      */
-    structure: ReadonlySignal<TokenSearchStructure>;
+    structure: ReadonlySignal<SearchFieldStructure>;
     /** Visible suggestions. Publishes only when the list's content changes. */
-    suggestions: Signal<readonly TokenSearchSuggestion[]>;
+    suggestions: Signal<readonly SearchFieldSuggestion[]>;
     result: Signal<Result | undefined>;
-    edit(value: TokenSearchFieldValue, commit?: boolean): void;
+    edit(value: SearchFieldValue, commit?: boolean): void;
     /** Replace app-owned search state and rebuild the DOM-owned editor text. */
-    replace(value: TokenSearchFieldValue): void;
-    submit(value: TokenSearchFieldValue): void;
+    replace(value: SearchFieldValue): void;
+    submit(value: SearchFieldValue): void;
     choose(value: string): void;
     /** Commit a value for the active `name:` prefix, even when it is not suggested. */
     commit(value: string): void;
@@ -195,14 +195,14 @@ interface TokenSearchModel<Result = unknown> {
     clear(): void;
     dismiss(): void;
 }
-interface TokenSearchModelOptions<Result> {
-    rules?: readonly TokenSearchRule[];
-    initial?: TokenSearchFieldValue;
+interface SearchFieldModelOptions<Result> {
+    rules?: readonly SearchFieldRule[];
+    initial?: SearchFieldValue;
     /** Runs after every state change, including initial state. */
-    evaluate?: (state: TokenSearchState) => Result;
-    onSubmit?: (state: TokenSearchState, result: Result | undefined) => void;
+    evaluate?: (state: SearchFieldState) => Result;
+    onSubmit?: (state: SearchFieldState, 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>;
+/** Opt-in state, token parsing, suggestions, and evaluation for SearchField. */
+declare function createSearchFieldModel<Result = unknown>({ rules, initial, evaluate, onSubmit, }?: SearchFieldModelOptions<Result>): SearchFieldModel<Result>;
 
-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 TokenSearchStructure as i, type TokenSearchSuggestion as j, type TokenSearchToken as k, type TokenSearchTrailingAction as l, type TokenSearchTrailingActionAttributes as m, createTokenSearchModel as n, placeTokenSearchCaret as p, readTokenSearchField as r };
+export { SearchField as S, type SearchFieldEditorAttributes as a, type SearchFieldModel as b, type SearchFieldModelOptions as c, type SearchFieldProps as d, type SearchFieldResolvedToken as e, type SearchFieldRule as f, type SearchFieldState as g, type SearchFieldStructure as h, type SearchFieldSuggestion as i, type SearchFieldToken as j, type SearchFieldTrailingAction as k, type SearchFieldTrailingActionAttributes as l, type SearchFieldValue as m, createSearchFieldModel as n, placeSearchFieldCaret as p, readSearchField as r };

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

@@ -0,0 +1,3 @@
+export { b as SearchFieldModel, c as SearchFieldModelOptions, e as SearchFieldResolvedToken, f as SearchFieldRule, g as SearchFieldState, h as SearchFieldStructure, i as SearchFieldSuggestion, n as createSearchFieldModel } from './search-field-CrGTN5sa.js';
+import 'kerfjs';
+import './semantic-content-BbzjvSu9.js';

package/dist/search-field-model.js

@@ -0,0 +1,3 @@
+export { createSearchFieldModel } from './chunk-CIAUILRR.js';
+
+//# sourceMappingURL=search-field-model.js.map

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

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

package/dist/search-field.d.ts

@@ -0,0 +1,3 @@
+export { S as SearchField, a as SearchFieldEditorAttributes, d as SearchFieldProps, j as SearchFieldToken, k as SearchFieldTrailingAction, l as SearchFieldTrailingActionAttributes, m as SearchFieldValue, p as placeSearchFieldCaret, r as readSearchField } from './search-field-CrGTN5sa.js';
+import 'kerfjs';
+import './semantic-content-BbzjvSu9.js';

package/dist/search-field.js

@@ -0,0 +1,5 @@
+export { SearchField, placeSearchFieldCaret, readSearchField } from './chunk-VEME3D7K.js';
+
+
+
+//# sourceMappingURL=search-field.js.map

package/dist/search-field.js.map

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

package/dist/select-register.d.ts

@@ -1,7 +1,10 @@
 /**
- * Marker export for tests and tooling; importing this module performs registration.
- * Registers both the `Select` elements and the `Catalog` related-entries popup-menu
- * elements (`wa-dropdown` / `wa-dropdown-item` / `wa-button`).
+ * Marker export for tests and tooling; importing this module defines the
+ * `kui-select` root element and wires every `Select` in the document:
+ * opening, placement, keyboard navigation and typeahead, choosing, the
+ * select-all and clear actions, form participation, and dismissal. It also
+ * wires the `Catalog` related-entries `PopupMenu`s and registers the help tag
+ * an icon-only trigger shows on hover or keyboard focus.
  */
 declare const selectElementsRegistered = true;