@ixfx/components 0.16.0 → 0.16.1

package/bundle/index.d.ts

@@ -294,7 +294,7 @@ interface AcTokenElement {
   addEventListener: (<K extends keyof AcTokenElementEventMap>(type: K, listener: (this: AcTokenElement, event: AcTokenElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions) => void);
 }
 //#endregion
-//#region node_modules/.pnpm/@clinth+ui-commands@1.1.0/node_modules/@clinth/ui-commands/dist/types.d.ts
+//#region node_modules/.pnpm/@clinth+ui-commands@1.1.1/node_modules/@clinth/ui-commands/dist/types.d.ts
 type CommandId = string;
 type CommandOptions = Readonly<{
   onInvoke?: (id: CommandId, args?: Record<string, unknown>) => void;
@@ -328,11 +328,15 @@ interface KeyBinding<TAppModes extends string = string> {
   mode?: TAppModes | `all`;
   nonExclusive?: boolean;
   commandContext?: string;
+  /** Fire even while focus is in a text field (input, textarea, contenteditable). Default false. */
+  inTextInput?: boolean;
+  /** Require the event's modifiers to match exactly, rather than being a superset. Default false. */
+  exact?: boolean;
   commandId: CommandId;
 }
 type KeyEventHandler = (commandId: CommandId, modifiers: Modifiers, context: InputContext) => void;
 //#endregion
-//#region node_modules/.pnpm/@clinth+ui-commands@1.1.0/node_modules/@clinth/ui-commands/dist/command-registry.d.ts
+//#region node_modules/.pnpm/@clinth+ui-commands@1.1.1/node_modules/@clinth/ui-commands/dist/command-registry.d.ts
 /**
  * Command registry.
  */
@@ -402,7 +406,7 @@ declare class CommandRegistry<TState = unknown> {
   has(id: CommandId): boolean;
 }
 //#endregion
-//#region node_modules/.pnpm/@clinth+ui-commands@1.1.0/node_modules/@clinth/ui-commands/dist/keyboard-manager.d.ts
+//#region node_modules/.pnpm/@clinth+ui-commands@1.1.1/node_modules/@clinth/ui-commands/dist/keyboard-manager.d.ts
 /**
  * Manages keyboard bindings and event handling.
  * @typeParam M - The mode type (e.g., 'detail' | 'coarse')
@@ -413,6 +417,7 @@ declare class KeyboardManager<M extends string = string> {
   private element;
   private eventHandlers;
   private modeGetter;
+  private readonly keydownListener;
   /**
    * Sets the function that returns the current application mode.
    * @param getter - Function that returns the current mode
@@ -4065,7 +4070,8 @@ declare class IncrSearchTreeController {
  * - `navigate` — move the cursor to the best match; ↑/↓ cycle between matches;
  *   Enter activates the current match and closes.
  * - `select` — (re)select every item whose label matches, live as you type.
- * - `filter` — hide items that don't match; restored when the popover closes.
+ * - `filter` — hide items that don't match; restored when the popover closes
+ *   (unless `stickyFilter` keeps it on Enter).
  */
 type ListSearchMode = `navigate` | `select` | `filter`;
 /** Canonical order — used for the switch-row and to normalise a requested set. */
@@ -4118,6 +4124,8 @@ interface ListSearchControllerOptions<TItem> {
   modes?: readonly ListSearchMode[];
   fzf?: Partial<FzfOptions<SearchItem>>;
   placeholder?: string;
+  /** Initial {@link ListSearchController.stickyFilter}. Default false. */
+  stickyFilter?: boolean;
 }
 type ListSearchHost = ReactiveControllerHost & HTMLElement & {
   renderRoot?: DocumentFragment | HTMLElement;
@@ -4130,6 +4138,12 @@ type ListSearchHost = ReactiveControllerHost & HTMLElement & {
  */
 declare class ListSearchController<TItem> implements ReactiveController {
   #private;
+  /**
+   * When true, Enter in `filter` mode closes the popover but keeps the filter,
+   * shown as a "Filtered: …" chip. Clear it with the chip's ×, Escape on the
+   * host, or {@link clearFilter}; click the chip to edit the query.
+   */
+  stickyFilter: boolean;
   constructor(host: ListSearchHost, options: ListSearchControllerOptions<TItem>);
   /** `false` when no modes are available — the host should register no commands and render no field. */
   get enabled(): boolean;
@@ -4147,20 +4161,38 @@ declare class ListSearchController<TItem> implements ReactiveController {
   get query(): string;
   get matchCount(): number;
   get matchIndex(): number;
+  /** The query of a filter kept applied after the popover closed (see {@link stickyFilter}). */
+  get keptFilter(): string | undefined;
   hostConnected(): void;
   hostDisconnected(): void;
-  /** Open the popover in `mode` (clamped to the available set). */
+  /**
+   * Open the popover in `mode` (clamped to the available set). When it is
+   * already open the query is kept: the mode switches if it differs and the
+   * input is refocused with its text selected.
+   */
   open(mode: ListSearchMode): void;
   /** Close the popover, restoring any live filter. Selection / cursor stay put. */
   close(): void;
+  /** Remove a filter kept by {@link stickyFilter}. No-op when none is kept. */
+  clearFilter(): void;
   setQuery(query: string): void;
   /** Re-interpret the current query under a new mode (undoing the old mode's effect). */
   switchMode(next: ListSearchMode): void;
+  /**
+   * Step through {@link registeredModes} (wrapping) and switch to the result.
+   * Bound to Tab / Shift+Tab in the popover input.
+   */
+  cycleMode(delta: 1 | -1): void;
+  /** Refocus the popover input (text selected) without touching the query. No-op when closed. */
+  focus(): void;
   /** One-shot: turn the current match set into the selection, staying in the current mode. */
   selectMatches(): void;
   nextMatch(): void;
   prevMatch(): void;
-  /** Enter: in `navigate` activate the current match; then close. */
+  /**
+   * Enter: in `navigate` activate the current match; then close. In `filter`
+   * with {@link stickyFilter} and a query, close but keep the filter.
+   */
   commit(): void;
   /** Rebuild the searchable item set from the adapter. Called on open and on container mutation. */
   refresh(): void;
@@ -4677,8 +4709,17 @@ declare class DataGridElement extends LitElement {
    * view and navigation.
    */
   filterPredicate?: (row: unknown) => boolean;
-  /** Text a row is matched against by incremental search. Default: its visible cells joined by a space. */
+  /**
+   * Text a row is matched against by incremental search. Overrides
+   * `searchColumn`; matches against it aren't highlighted, since they can't be
+   * mapped onto a cell.
+   */
   rowSearchText?: (row: unknown) => string;
+  /**
+   * Key of the column incremental search matches against, using the cell's
+   * displayed (formatted) text. Default: the first visible column.
+   */
+  searchColumn: string;
   /**
    * Space-separated subset of `navigate select filter` — limits which
    * incremental-search modes are offered. Unset ⇒ all three; empty ⇒ search
@@ -5581,6 +5622,13 @@ declare class DetailListElement extends LitElement {
   provider: IDataProvider<void, unknown> | undefined;
   displayProperty: string;
   formatter: DetailFormatter | undefined;
+  /**
+   * Text incremental search matches for an object item. Defaults to the
+   * caption when it is a string (`displayProperty` or a string `formatter`),
+   * else the row's whole text — set this when `formatter` returns a `Node`
+   * carrying more than the name (sublines, sizes, dates).
+   */
+  searchText: ((item: unknown, index: number) => string) | undefined;
   iconProperty: string;
   /**
    * Property on each `items` entry holding a CSS colour for the item's
@@ -5664,6 +5712,13 @@ declare class DetailListElement extends LitElement {
    * changed by outside forces (e.g. an external font load).
    */
   refreshLayout(): void;
+  /**
+   * Rebuild every object-item row, for when something the `formatter` (or
+   * `searchText`) reads has changed but the items themselves haven't —
+   * reassigning the same objects keeps their rows as they are. Assigning a new
+   * `formatter` function has the same effect.
+   */
+  reformat(): void;
   addItem(item: Element | string, options?: AddItemOptions): void;
   /**
    * Collapse + fade `item` out, then detach it; the rows after it slide up to
@@ -6506,6 +6561,11 @@ declare class DockHostElement extends LitElement {
   acceptsKinds: readonly string[] | null;
   /** Finest-grained veto, consulted per candidate zone. */
   canAccept: ((panelId: string, op: DockOperation) => boolean) | undefined;
+  /**
+   * Tab label for a placeholder (a panel a restored layout names that the host
+   * doesn't hold yet). Defaults to the panel id.
+   */
+  placeholderLabel: ((panelId: string) => string) | undefined;
   private _model;
   private _pool;
   private _dropZone;
@@ -6594,11 +6654,15 @@ declare class DockHostElement extends LitElement {
    */
   setViewState(state: Partial<DockHostViewState>): void;
   /**
-   * Placeholders are part of the layout tree rather than a separate pending
-   * set, so there is nothing to clear here: remove a placeholder with
-   * `removePanel(id)`.
+   * Drop every placeholder: panels the restored layout names that the host
+   * doesn't hold. Call it once the app has added all the panels it has, so
+   * ids for panels that no longer exist don't linger (and get saved again).
    */
   clearPendingViewState(): void;
+  /** @deprecated Since 0.16; use `getViewState().layout`. */
+  saveLayout(): DockLayout;
+  /** @deprecated Since 0.16; use `setViewState({ layout })`. */
+  loadLayout(layout: DockLayout): void;
   /** The current layout, folding live split weights from the DOM. */
   private _captureLayout;
   /** Whether `panelId` is in the model only as a placeholder from a restored layout. */