@myrmidon/gve-core 7.0.17 → 7.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/gve-core",
-  "version": "7.0.17",
+  "version": "7.0.18",
   "description": "Cadmus - GVE Angular frontend core components.",
   "keywords": [
     "GVE"

package/types/myrmidon-gve-core.d.ts

@@ -1,7 +1,7 @@
 import { MatDialogConfig, MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
-import { OnInit, OnDestroy, ElementRef, AfterViewInit } from '@angular/core';
-import { FormControl, FormGroup, FormBuilder } from '@angular/forms';
+import { OnInit, OnDestroy, AfterViewInit, ElementRef } from '@angular/core';
+import { FormControl, FormGroup, FormBuilder, ControlValueAccessor } from '@angular/forms';
 import { DialogService } from '@myrmidon/ngx-mat-tools';
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
@@ -727,6 +727,94 @@ declare class BatchOperationEditorComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BatchOperationEditorComponent, "gve-batch-operation-editor", never, { "preset": { "alias": "preset"; "required": false; "isSignal": true; }; }, { "operationsChange": "operationsChange"; }, never, never, true, never>;
 }
 
+/**
+ * 🔑 `gve-searchable-select`
+ *
+ * A generic, reusable `mat-select` wrapper adding a sticky filter input
+ * pinned to the top of the options panel. Users get the best of both
+ * worlds: the full, scrollable list is visible as soon as the panel
+ * opens, and typing instantly narrows it down in place.
+ *
+ * Implements `ControlValueAccessor`, so it's a drop-in replacement for a
+ * plain `mat-select` bound via `[formControl]` or `formControlName`: the
+ * selected value is the `id` of the chosen `LabeledId`.
+ *
+ * `mat-error` and `mat-hint` elements can be projected as children, just
+ * like when nesting them directly under a `mat-form-field`.
+ *
+ * - ▶️ `options` (`LabeledId[]`): the selectable items.
+ * - ▶️ `label` (`string`): the form field label.
+ * - ▶️ `filterPlaceholder` (`string`): placeholder for the filter input.
+ * - ▶️ `noOptionsText` (`string`): text shown when no option matches the
+ * filter.
+ * - ▶️ `required` (`boolean`): whether a value is required.
+ */
+declare class SearchableSelectComponent implements ControlValueAccessor {
+    private readonly _select;
+    private readonly _filterInput;
+    /**
+     * The selectable items.
+     */
+    readonly options: _angular_core.InputSignal<LabeledId[]>;
+    /**
+     * The form field label.
+     */
+    readonly label: _angular_core.InputSignal<string>;
+    /**
+     * Placeholder for the sticky filter input.
+     */
+    readonly filterPlaceholder: _angular_core.InputSignal<string>;
+    /**
+     * Text shown when no option matches the current filter.
+     */
+    readonly noOptionsText: _angular_core.InputSignal<string>;
+    /**
+     * Whether a value is required.
+     */
+    readonly required: _angular_core.InputSignal<boolean>;
+    /**
+     * The current filter term, typed into the sticky filter input.
+     */
+    readonly filterTerm: _angular_core.WritableSignal<string>;
+    /**
+     * The currently selected option's ID, or null when none is selected.
+     */
+    readonly value: _angular_core.WritableSignal<string | null>;
+    /**
+     * Whether the control is disabled.
+     */
+    readonly disabled: _angular_core.WritableSignal<boolean>;
+    /**
+     * The options matching the current filter term. Matches against both
+     * label and ID, case-insensitively.
+     */
+    readonly filteredOptions: _angular_core.Signal<LabeledId[]>;
+    private _onChange;
+    private _onTouched;
+    writeValue(value: string | null): void;
+    registerOnChange(fn: (value: string | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    onSelectionChange(value: string): void;
+    onFilterInput(event: Event): void;
+    /**
+     * Keys that should still reach mat-select's own panel keydown handler
+     * (closing, and moving into / activating the option list). Everything
+     * else (letters, digits, etc.) is kept local to the filter input so it
+     * doesn't trigger mat-select's built-in type-ahead.
+     */
+    private static readonly PASSTHROUGH_KEYS;
+    onFilterKeydown(event: KeyboardEvent): void;
+    onOpenedChange(opened: boolean): void;
+    /**
+     * Moves keyboard focus to the select trigger, without opening the
+     * panel. Mirrors the native `focus()` behavior of a plain `mat-select`.
+     */
+    focus(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchableSelectComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchableSelectComponent, "gve-searchable-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "noOptionsText": { "alias": "noOptionsText"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; }, {}, never, ["mat-error", "mat-hint"], true, never>;
+}
+
 /**
  * Features map. This is used for features from closed sets,
  * and lists the possible values for each feature.
@@ -776,7 +864,7 @@ interface FeaturePropMap {
  */
 declare class FeatureEditorComponent implements OnInit, OnDestroy {
     private _sub?;
-    readonly nameControl: _angular_core.Signal<ElementRef<any> | undefined>;
+    readonly nameControl: _angular_core.Signal<SearchableSelectComponent | HTMLInputElement | undefined>;
     /**
      * The list of feature names to display in the name selection.
      * This is used when you have a closed list of features.
@@ -1890,5 +1978,5 @@ declare class SettingsService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SettingsService>;
 }
 
-export { BaseTextCharComponent, BaseTextEditorComponent, BaseTextPeepholeComponent, BaseTextViewComponent, BatchOperationEditorComponent, ChainOperationEditorComponent, ChainResultViewComponent, FeatureEditorComponent, FeatureSetEditorComponent, FeatureSetPolicy, FeatureSetViewComponent, GveApiService, GveBaseTextService, GveGraphvizService, OperationSourceEditorComponent, OperationType, SettingsService, SnapshotEditorComponent, SnapshotTextEditorComponent, StepsMapComponent };
+export { BaseTextCharComponent, BaseTextEditorComponent, BaseTextPeepholeComponent, BaseTextViewComponent, BatchOperationEditorComponent, ChainOperationEditorComponent, ChainResultViewComponent, FeatureEditorComponent, FeatureSetEditorComponent, FeatureSetPolicy, FeatureSetViewComponent, GveApiService, GveBaseTextService, GveGraphvizService, OperationSourceEditorComponent, OperationType, SearchableSelectComponent, SettingsService, SnapshotEditorComponent, SnapshotTextEditorComponent, StepsMapComponent };
 export type { BaseTextChar, BaseTextCharEvent, BaseTextRange, ChainOperationContextStep, ChainOperationTags, CharChain, CharChainLink, CharChainNode, CharChainOperation, CharChainResult, CharNode, Feature, FeatureDefinitions, FeatureMap, FeaturePropMap, GraphvizRankdir, LabeledId, OpBaseTextRange, OperationFeature, OperationMetadata, OperationSource, PayloadMatDialogConfig, ResultWrapper, Snapshot, TreeNode };