ngwr 9.0.1 → 9.1.0

package/types/ngwr-drawer.d.ts

@@ -1,5 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef } from '@angular/core';
+import { TemplateRef, ComponentRef, InjectionToken } from '@angular/core';
+import { ComponentType } from '@angular/cdk/portal';
+import { ConfigurableFocusTrap } from '@angular/cdk/a11y';
+import { OverlayRef } from '@angular/cdk/overlay';
+import { ReplaySubject } from 'rxjs';
 
 /**
  * @license
@@ -10,6 +14,44 @@ import { TemplateRef } from '@angular/core';
 /** Side of the viewport the drawer slides in from. */
 type WrDrawerPosition = 'left' | 'right' | 'top' | 'bottom';
 
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Options accepted by `WrDrawerManager.open()`.
+ *
+ * Mirrors the `<wr-drawer>` inputs, minus the ones that need the component's
+ * own wrapper markup (`showHandle` / swipe-to-dismiss).
+ */
+interface WrDrawerOptions<D = unknown> {
+    /** Data payload exposed to the drawer content via `WR_DRAWER_DATA`. */
+    readonly data?: D;
+    /** Side the drawer slides in from. @default 'right' */
+    readonly position?: WrDrawerPosition;
+    /** Width when position is left/right. Any CSS length. @default '20rem' */
+    readonly width?: string;
+    /** Height when position is top/bottom. Any CSS length. @default '16rem' */
+    readonly height?: string;
+    /** Upper cap on height (top/bottom positions). Any CSS length. @default null (no cap) */
+    readonly maxHeight?: string | null;
+    /** Round the leading corners — the edge facing the viewport interior. @default false */
+    readonly rounded?: boolean;
+    /** Pad the trailing edge with `env(safe-area-inset-*)`. @default false */
+    readonly safeArea?: boolean;
+    /** Show the dimming backdrop. @default true */
+    readonly hasBackdrop?: boolean;
+    /** When `true`, clicks on the backdrop close the drawer. @default true */
+    readonly closeOnBackdropClick?: boolean;
+    /** When `true`, the Escape key closes the drawer. @default true */
+    readonly closeOnEscape?: boolean;
+    /** Extra CSS class(es) added to the panel. */
+    readonly panelClass?: string | readonly string[];
+}
+
 /**
  * Side panel that slides in from an edge of the viewport. Two-way binds
  * `open` and renders into a CDK overlay so it sits above page content.
@@ -92,6 +134,170 @@ declare class WrDrawer {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrDrawer, "wr-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "showHandle": { "alias": "showHandle"; "required": false; "isSignal": true; }; "safeArea": { "alias": "safeArea"; "required": false; "isSignal": true; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
 }
 
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Handle returned by `WrDrawerManager.open()`.
+ *
+ * Wraps the underlying `OverlayRef` and tracks the close result. It is also
+ * provided inside the drawer's own injector, so the projected content can
+ * inject it and close itself — the counterpart to `[wrDrawerClose]` when the
+ * close is programmatic (after a save succeeds, say) rather than a click.
+ *
+ * @example
+ * ```ts
+ * // Caller side.
+ * const ref = drawers.open<ChatComponent, boolean>(ChatComponent, { position: 'right' });
+ * const result = await ref.awaitClose(); // boolean | undefined
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Content side — the drawer closes itself.
+ * @Component({...})
+ * export class ChatComponent {
+ *   private readonly ref = inject(WrDrawerRef);
+ *
+ *   send(): void {
+ *     this.store.send(this.draft());
+ *     this.ref.close(true);
+ *   }
+ * }
+ * ```
+ */
+declare class WrDrawerRef<C, R = unknown> {
+    private readonly _overlayRef;
+    /**
+     * Emits the close result once and completes.
+     *
+     * A `ReplaySubject`, not a plain `Subject`, so the result survives a late
+     * subscriber: content can close itself before `open()` has even returned, and
+     * `awaitClose()` may be called long after the dismissal — both would otherwise
+     * see only `complete` and resolve `undefined`.
+     */
+    readonly closed: ReplaySubject<R | undefined>;
+    /** @internal */
+    componentRef: ComponentRef<C> | null;
+    /** @internal */
+    focusTrap: ConfigurableFocusTrap | null;
+    /** @internal */
+    previouslyFocused: HTMLElement | null;
+    constructor(_overlayRef: OverlayRef);
+    /** The instantiated drawer component. */
+    get componentInstance(): C;
+    private isClosed;
+    /** Close the drawer, optionally returning a result. */
+    close(result?: R): void;
+    private teardown;
+    /** Resolves with the close result when the drawer is dismissed. */
+    awaitClose(): Promise<R | undefined>;
+    /** Underlying overlay ref — escape hatch for advanced cases. */
+    get overlayRef(): OverlayRef;
+}
+
+/**
+ * Opens drawer components in an isolated NGWR overlay — the programmatic
+ * counterpart to `<wr-drawer [(open)]="…">`.
+ *
+ * Use the component when the drawer is part of a template and its open state
+ * is a signal you already own; use this service when the caller doesn't own
+ * the markup (opening a chat panel from a toolbar action, from an effect, from
+ * a route guard) or when you need the close result.
+ *
+ * Uses `WR_OVERLAY` so it composes cleanly with `provideWrOverlay()`
+ * — drawers render into NGWR's own overlay container and never collide
+ * with other CDK consumers (Material, NG-ZORRO, etc.).
+ *
+ * `showHandle` / swipe-to-dismiss is component-only: it needs the drawer's own
+ * wrapper markup, which the service path replaces with your component.
+ *
+ * @example
+ * ```ts
+ * const drawers = inject(WrDrawerManager);
+ *
+ * const ref = drawers.open(ChatComponent, {
+ *   data: { threadId },
+ *   position: 'right',
+ *   width: '28rem',
+ * });
+ *
+ * await ref.awaitClose();
+ * ```
+ *
+ * @see https://ngwr.dev/reference/components/drawer
+ */
+declare class WrDrawerManager {
+    private readonly overlay;
+    private readonly scrollStrategies;
+    private readonly parentInjector;
+    private readonly focusTrapFactory;
+    private readonly isBrowser;
+    open<C, R = unknown, D = unknown>(component: ComponentType<C>, options?: WrDrawerOptions<D>): WrDrawerRef<C, R>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerManager, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<WrDrawerManager>;
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Token that exposes the `data` payload passed to `WrDrawerManager.open()`.
+ *
+ * @example
+ * ```ts
+ * @Component({...})
+ * export class ChatComponent {
+ *   readonly data = inject<ChatData>(WR_DRAWER_DATA);
+ * }
+ * ```
+ */
+declare const WR_DRAWER_DATA: InjectionToken<unknown>;
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Token exposing the open drawer's `WrDrawerRef` to components and
+ * directives rendered inside it (e.g. `[wrDrawerClose]`).
+ *
+ * **Prefer `inject(WrDrawerRef)`** — the ref is provided under the class token
+ * too, and the class path is the documented one. It already covers both cases
+ * you might reach for a token for: `inject(WrDrawerRef, { optional: true })`
+ * works for content that also renders outside a drawer, and
+ * `inject<WrDrawerRef<ChatComponent, boolean>>(WrDrawerRef)` types the generics
+ * without a cast.
+ *
+ * This token is the same object under a second key. It exists for the library's
+ * own directives (`[wrDrawerClose]`) and for swapping the provider out — a test
+ * stub, say — without touching the class.
+ *
+ * @example
+ * ```ts
+ * @Component({...})
+ * export class ChatComponent {
+ *   private readonly ref = inject<WrDrawerRef<ChatComponent, boolean>>(WrDrawerRef);
+ *
+ *   dismiss(): void {
+ *     this.ref.close(true);
+ *   }
+ * }
+ * ```
+ */
+declare const WR_DRAWER_REF: InjectionToken<WrDrawerRef<unknown, unknown>>;
+
 /**
  * Marks an element as the drawer's title row. Applies the `wr-drawer__title`
  * class so the drawer's stylesheet can lay it out alongside content and
@@ -147,17 +353,30 @@ declare class WrDrawerFooter {
 /**
  * Closes the parent drawer on click. Attach to any clickable element.
  *
+ * Works for both drawer flavours: inside `<wr-drawer>` it clears the
+ * component's `open` model, and inside a `WrDrawerManager.open()` drawer it
+ * closes the ref — optionally passing a `[wrDrawerClose]` value as the close
+ * result (the component flavour has no result to carry, so the value is
+ * ignored there).
+ *
  * @example
  * ```html
  * <wr-btn wrDrawerClose>Close</wr-btn>
+ * <wr-btn color="primary" [wrDrawerClose]="true">Save</wr-btn>
  * ```
  */
-declare class WrDrawerClose {
+declare class WrDrawerClose<R = unknown> {
+    /**
+     * Value to pass to `close()` for service-opened drawers. When unset — or
+     * used as a bare attribute — the drawer closes with `undefined`.
+     */
+    readonly result: _angular_core.InputSignalWithTransform<R | undefined, "" | R | undefined>;
     private readonly drawer;
+    private readonly ref;
     protected close(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerClose, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDrawerClose, "[wrDrawerClose]", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerClose<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDrawerClose<any>, "[wrDrawerClose]", never, { "result": { "alias": "wrDrawerClose"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { WrDrawer, WrDrawerClose, WrDrawerContent, WrDrawerFooter, WrDrawerTitle };
-export type { WrDrawerPosition };
+export { WR_DRAWER_DATA, WR_DRAWER_REF, WrDrawer, WrDrawerClose, WrDrawerContent, WrDrawerFooter, WrDrawerManager, WrDrawerRef, WrDrawerTitle };
+export type { WrDrawerOptions, WrDrawerPosition };

package/types/ngwr-select.d.ts

@@ -81,8 +81,18 @@ interface WrSelectContext {
      * no filter applied — options treat that as "show me".
      */
     readonly searchQuery: Signal<string>;
-    /** True only when `mode="search"`. Options gate filtering on this. */
+    /** True only when `mode="search"`. */
     readonly isSearch: Signal<boolean>;
+    /**
+     * True when a filter is active — `mode="search"` or `[searchable]`. Options
+     * gate self-hiding on this.
+     */
+    readonly isSearchable: Signal<boolean>;
+    /**
+     * False when the option list is already query-scoped upstream (`[loader]` or
+     * `[serverSearch]`), in which case options must NOT self-hide.
+     */
+    readonly clientFilter: Signal<boolean>;
     /** Is the given option value currently selected? Handles both single and multi. */
     isSelected(value: unknown): boolean;
     /**
@@ -120,6 +130,11 @@ interface SelectedChip {
  * - `'tag'` — free-text + chips with `[separators]` / `[validate]` /
  *   `[allowDuplicates]`. Replaces `<wr-chips-input>`.
  *
+ * `[searchable]` is orthogonal to the mode — it adds the type-ahead filter to
+ * `single` / `multi` without changing the value shape, which is how you get a
+ * searchable multi-select. Server-side search hangs off the `(searchChange)` output
+ * plus `[options]` / `[loading]`.
+ *
  * A signal-forms native control: it implements `FormValueControl<unknown>`, so
  * `[formField]` binds straight to its `value` model — no
  * `ControlValueAccessor` in between. `[(value)]` works standalone, and classic
@@ -139,6 +154,16 @@ interface SelectedChip {
  *   <wr-option value="ts">TypeScript</wr-option>
  *   <wr-option value="ng">Angular</wr-option>
  * </wr-select>
+ *
+ * <!-- Multi + type-ahead, options from a store -->
+ * <wr-select
+ *   mode="multi"
+ *   searchable
+ *   [options]="results()"
+ *   [loading]="pending()"
+ *   [(value)]="categories"
+ *   (searchChange)="store.search($event)"
+ * />
  * ```
  *
  * The legacy `[multi]="true"` boolean is still accepted but is now an
@@ -192,15 +217,44 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
     protected readonly isTag: _angular_core.Signal<boolean>;
     /** Convenience — `effectiveMode() === 'search'`. Exposed via context for options. */
     readonly isSearch: _angular_core.Signal<boolean>;
+    /**
+     * Add a type-ahead filter without changing the value shape — the missing
+     * multi-with-search combination, since `[mode]` picks exactly one shape:
+     *
+     * ```html
+     * <wr-select mode="multi" searchable [(value)]="categories">…</wr-select>
+     * ```
+     *
+     * On `multi` the trigger keeps its chips and grows an inline text field (the
+     * shape `tag` mode already uses); on `single` it is equivalent to
+     * `mode="search"`. Every search input (`[options]`, `[loader]`,
+     * `[debounceMs]`, `[minChars]`, `[virtualScroll]`, the `(searchChange)` output, …)
+     * applies either way. Ignored in `tag` mode, which owns its own input.
+     * @default false
+     */
+    readonly searchable: _angular_core.InputSignalWithTransform<boolean, any>;
+    /**
+     * Filtering is active — either `mode="search"` or `[searchable]`. Exposed via
+     * context so each `<wr-option>` can self-hide non-matching rows.
+     */
+    readonly isSearchable: _angular_core.Signal<boolean>;
+    /** The trigger *is* the search input: `mode="search"`, or a searchable single. */
+    protected readonly isSearchTrigger: _angular_core.Signal<boolean>;
+    /** Chips plus an inline search field — a searchable multi-select. */
+    protected readonly hasChipSearch: _angular_core.Signal<boolean>;
     /** WrSelectContext — resolved multi-selection flag for child options. */
     readonly multi: _angular_core.Signal<boolean>;
     /** Both multi and tag render chips on the trigger. */
     protected readonly hasChips: _angular_core.Signal<boolean>;
     /**
-     * Search-mode query. Empty string = no filter. Exposed via context so
+     * The live search query. Empty string = no filter. Exposed via context so
      * each `<wr-option>` can self-hide non-matching rows.
+     *
+     * Two-way bindable, so the query can be owned or reset from outside:
+     * `[(searchQuery)]="query"`. For server-side search prefer the debounced
+     * {@link searchChange} output — `searchQueryChange` fires on every keystroke.
      */
-    readonly searchQuery: _angular_core.WritableSignal<string>;
+    readonly searchQuery: _angular_core.ModelSignal<string>;
     /**
      * Search mode: dynamic option array. Each item is rendered as a
      * `<wr-option>` whose label comes from `[displayWith]`. Works
@@ -216,6 +270,21 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
      * Observables, Promises, and plain arrays.
      */
     readonly loader: _angular_core.InputSignal<WrSelectSearchLoader<unknown> | null>;
+    /**
+     * The option list is already scoped to the query upstream — skip the built-in
+     * client-side label filter. Set it when `[options]` is fed from a server via
+     * the {@link searchChange} output; the async `[loader]` path implies it.
+     *
+     * Without this, a server that ranks or fuzzy-matches (returning rows whose
+     * labels don't literally contain the query) would have those rows hidden
+     * again on the client. @default false
+     */
+    readonly serverSearch: _angular_core.InputSignalWithTransform<boolean, any>;
+    /**
+     * Whether the built-in label filter runs. Exposed via context so each
+     * `<wr-option>` knows whether to self-hide. @internal
+     */
+    readonly clientFilter: _angular_core.Signal<boolean>;
     /** Search mode: debounce (ms) applied to the loader. @default 250 */
     readonly debounceMs: _angular_core.InputSignalWithTransform<number, unknown>;
     /** Search mode: minimum query length before the panel opens / loader fires. @default 0 */
@@ -253,10 +322,42 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
     readonly loadingText: _angular_core.InputSignal<string | null>;
     protected readonly resolvedNoResults: _angular_core.Signal<string>;
     protected readonly resolvedLoading: _angular_core.Signal<string>;
+    /**
+     * Debounced search query, gated to searchable selects. Emits on every settled
+     * change — including the empty string when the field is cleared — so a
+     * store-backed option list can stay in sync and reset itself. `[debounceMs]`
+     * controls the delay; `[minChars]` does NOT gate it, for the same reason the
+     * `[loader]` path clears its results below that threshold.
+     *
+     * This is the hook for server-side search: dispatch on `(searchChange)`, feed
+     * the results back through `[options]` (plus `[serverSearch]`), and drive the
+     * panel's progress row with `[loading]`. Prefer it over the model's raw
+     * `(searchQueryChange)`, which fires on every keystroke.
+     *
+     * @example
+     * ```html
+     * <wr-select
+     *   mode="search"
+     *   serverSearch
+     *   [options]="results()"
+     *   [loading]="pending()"
+     *   (searchChange)="store.search($event)"
+     * />
+     * ```
+     */
+    readonly searchChange: _angular_core.OutputEmitterRef<string>;
+    /**
+     * Show the panel's progress row. Independent of `[loader]`, which raises and
+     * lowers its own flag — use this when the options come from a store fed by
+     * the {@link searchChange} output. @default false
+     */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, any>;
     /** Search mode: results returned by the async loader. @internal */
     protected readonly loadedOptions: _angular_core.WritableSignal<readonly unknown[]>;
-    /** Search mode: true while the loader is in flight. @internal */
-    protected readonly loading: _angular_core.WritableSignal<boolean>;
+    /** True while the async `[loader]` is in flight. @internal */
+    private readonly loaderLoading;
+    /** Either flag shows the panel's progress row. @internal */
+    protected readonly isLoading: _angular_core.Signal<boolean>;
     /**
      * Tag mode: keys / characters that commit the current draft into a chip.
      * `'Enter'` is the key name; everything else is a literal character watched
@@ -331,7 +432,7 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
      * `dynamicOptions()` narrowed to the current search query. `dynamicOptions()`
      * is intentionally UNFILTERED (projected `<wr-option>` self-hide via CSS), so
      * the virtual path — which renders plain rows that can't self-hide — filters
-     * here. Loader results are already query-scoped upstream.
+     * here. Loader / `serverSearch` results are already query-scoped upstream.
      */
     protected readonly filteredDynamicOptions: _angular_core.Signal<readonly unknown[]>;
     /**
@@ -376,12 +477,17 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
     /** Search mode: is this option hidden by the current query? @internal */
     private isOptionHidden;
     protected readonly panelTpl: _angular_core.Signal<TemplateRef<any>>;
-    /** Tag-mode inline input. Present only when `mode="tag"`. @internal */
+    /** The inline input inside a chip trigger — tag mode or a searchable multi. @internal */
     protected readonly tagInputEl: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     /** Search-mode inline input. Present only when `mode="search"`. @internal */
     protected readonly searchInputEl: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     protected focusTagInput(): void;
     protected focusSearchInput(): void;
+    protected onChipsInput(event: Event): void;
+    protected onChipsKeydown(event: KeyboardEvent): void;
+    protected onChipsFocus(): void;
+    protected onChipsPaste(event: ClipboardEvent): void;
+    protected onChipsBlur(): void;
     protected onSearchInput(event: Event): void;
     protected onSearchFocus(): void;
     protected onSearchKey(event: KeyboardEvent): void;
@@ -426,7 +532,7 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
     private openOverlay;
     private closeOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrSelect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrSelect, "wr-select", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "responsive": { "alias": "responsive"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "loader": { "alias": "loader"; "required": false; "isSignal": true; }; "debounceMs": { "alias": "debounceMs"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "freeText": { "alias": "freeText"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "noResultsText": { "alias": "noResultsText"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "separators": { "alias": "separators"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "validate": { "alias": "validate"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "maxItems": { "alias": "maxItems"; "required": false; "isSignal": true; }; "maxTagCount": { "alias": "maxTagCount"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, ["projectedOptions"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrSelect, "wr-select", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "responsive": { "alias": "responsive"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchQuery": { "alias": "searchQuery"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "loader": { "alias": "loader"; "required": false; "isSignal": true; }; "serverSearch": { "alias": "serverSearch"; "required": false; "isSignal": true; }; "debounceMs": { "alias": "debounceMs"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "freeText": { "alias": "freeText"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "noResultsText": { "alias": "noResultsText"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "separators": { "alias": "separators"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "validate": { "alias": "validate"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "maxItems": { "alias": "maxItems"; "required": false; "isSignal": true; }; "maxTagCount": { "alias": "maxTagCount"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "searchQuery": "searchQueryChange"; "searchChange": "searchChange"; "value": "valueChange"; "touch": "touch"; }, ["projectedOptions"], ["*"], true, never>;
 }
 
 /**
@@ -458,7 +564,7 @@ declare class WrOption {
     /** @internal — true when this option is the keyboard cursor target. */
     protected readonly active: _angular_core.Signal<boolean>;
     /**
-     * @internal — search mode only. True when the parent has a query that
+     * @internal — searchable selects only. True when the parent has a query that
      * the option's text content does not match (case-insensitive substring).
      * Hidden options stay in the DOM so registration order survives but
      * collapse via CSS.

package/types/ngwr-version.d.ts

@@ -16,7 +16,7 @@ import { InjectionToken } from '@angular/core';
  * Distinct from `Version` exported by `@angular/core`, which reports the
  * loaded Angular runtime version (e.g. `'21.2.13'`), not ngwr's.
  */
-declare const NGWR_VERSION = "9.0.1";
+declare const NGWR_VERSION = "9.1.0";
 
 /**
  * @license