commons-shared-web-ui 0.0.45 → 0.0.46

package/index.d.ts

@@ -360,6 +360,22 @@ interface TimeConfig {
      */
     minTimeField?: string;
 }
+/**
+ * Configuration for enabling search functionality inside DROPDOWN fields.
+ * Supports both client-side (local) and server-side (remote GET) filtering.
+ */
+interface DropdownSearchConfig {
+    /** Whether to display a search input inside the dropdown panel. */
+    enabled: boolean;
+    /** Filtering mode. 'local' filters client-side (default). 'server' queries the API on typing via GET. */
+    mode?: 'local' | 'server';
+    /** Query parameter key for the search term sent to the API (default: 'search'). Only used in 'server' mode. */
+    searchKey?: string;
+    /** Minimum characters required before triggering a server-side search (default: 3). Only used in 'server' mode. */
+    minSearchLength?: number;
+    /** Debounce delay in milliseconds before firing search (default: 300). */
+    debounceTime?: number;
+}
 interface OptionConfig$1 {
     optionClass?: string;
     optionUrl?: string;
@@ -375,6 +391,10 @@ interface OptionConfig$1 {
     sortDirection?: 'ASC' | 'DESC';
     layout?: 'row' | 'column';
     optionList?: OptionItem[];
+    /** Configuration for enabling search functionality inside the dropdown panel. */
+    searchConfig?: DropdownSearchConfig;
+    /** When true, renders a 'Select All' checkbox at the top of a MULTIPLE select dropdown. */
+    showSelectAll?: boolean;
 }
 interface AutocompleteDisplayField {
     /** Dot-notation path to the value in the API response item (e.g. 'login', 'contact.phone'). */
@@ -1494,6 +1514,10 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     /** Effective maximum time for the time input (explicit maxTime only). */
     get effectiveMaxTime(): string | null;
     isMultiDropdownOpen: boolean;
+    isSingleDropdownOpen: boolean;
+    searchText: string;
+    filteredOptionList: any[];
+    dropdownSearch$: Subject<string>;
     isDragOver: boolean;
     fileUploadError: string;
     multiSaveError: string;
@@ -1585,6 +1609,16 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     get expandLessLabel(): string;
     /** Getter for expand more icon name */
     get expandMoreLabel(): string;
+    /** Getter for dropdown search placeholder label */
+    get searchPlaceholderLabel(): string;
+    /** Getter for Select All label */
+    get selectAllLabel(): string;
+    /** Getter for No matching options label */
+    get noMatchingOptionsLabel(): string;
+    /** Returns the label of the currently selected option for single-select custom dropdowns */
+    get singleSelectedLabel(): string;
+    /** Whether the dropdown search feature is enabled for this field */
+    get isSearchableDropdown(): boolean;
     private initGroupField;
     /**
      * Sets up cross-field validation based on the `onValidate` formula.
@@ -1660,9 +1694,23 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     get showCharCount(): boolean;
     get remainingCharacters(): number | null;
     toggleMultiDropdown(event: MouseEvent): void;
+    toggleSingleDropdown(event: MouseEvent): void;
+    selectSingleOption(option: any): void;
     onDocumentClick(): void;
     onEscapeKey(): void;
     get multiSelectedCount(): number;
+    /** Initialise the RxJS search stream for dropdown filtering. */
+    private initDropdownSearch;
+    /** Execute client-side or server-side dropdown search. */
+    private executeDropdownSearch;
+    /** Resets the dropdown search text and filtered list. */
+    resetDropdownSearch(): void;
+    /** Returns true if every option in the current filtered list is selected. */
+    isAllSelected(): boolean;
+    /** Returns true if some (but not all) filtered options are selected — for indeterminate state. */
+    isSomeSelected(): boolean;
+    /** Toggles selection of all filtered options. */
+    toggleSelectAll(checked: boolean): void;
     get isTextField(): boolean;
     get isNumberField(): boolean;
     get isDateField(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.45",
+  "version": "0.0.46",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",