@ardium-ui/ui 5.0.0-alpha.85 → 5.0.0-alpha.87

package/lib/_internal/item-storages/dropdown-item-storage.d.ts

@@ -15,7 +15,7 @@ export interface ItemStorageHost {
     readonly hideSelected: Signal<boolean>;
     readonly deferValueWrites: Signal<boolean>;
     readonly searchCaseSensitive: Signal<boolean>;
-    readonly searchFn: Signal<SearchFn>;
+    readonly searchFn: Signal<SearchFn | null>;
     readonly compareWith: Signal<Nullable<CompareWithFn>>;
     readonly multiselectable: Signal<boolean>;
     readonly maxSelectedItems: Signal<Nullable<number>>;
@@ -74,6 +74,6 @@ export declare class ItemStorage {
     highlightAllItems(): void;
     setRecentlyHighlighted(itemToSet: ArdOption): void;
     highlightNextItem(offset: number, hasShift?: boolean): ArdOption | null;
-    filter(filterTerm: string): any[];
+    filter(filterTerm: string): void;
     resetFiltered(): ArdOption[];
 }

package/lib/select/select.component.d.ts

@@ -24,7 +24,7 @@ export declare class ArdiumSelectComponent extends _FormFieldComponentBase imple
     private readonly _isMouseBeingUsed;
     private readonly _searchBarFocused;
     private readonly _destroy$;
-    readonly searchTerm: import("@angular/core").WritableSignal<string>;
+    readonly searchTerm: import("@angular/core").ModelSignal<string>;
     isItemsInputUsed: boolean;
     readonly valueFrom: import("@angular/core").InputSignal<string>;
     readonly labelFrom: import("@angular/core").InputSignal<string>;
@@ -56,7 +56,13 @@ export declare class ArdiumSelectComponent extends _FormFieldComponentBase imple
     readonly keepSearchAfterSelect: import("@angular/core").InputSignalWithTransform<boolean, BooleanLike>;
     readonly maxSelectedItems: import("@angular/core").InputSignalWithTransform<number, NumberLike>;
     readonly itemDisplayLimit: import("@angular/core").InputSignalWithTransform<number, NumberLike>;
-    readonly searchFn: import("@angular/core").InputSignal<SearchFn>;
+    /**
+     * The function used to search for matching items based on the search term.
+     *
+     * When set to `null`, the search functionality will be disabled (all items will be shown),
+     * but the `searchEvent` will still be emitted with the search term whenever it changes.
+     */
+    readonly searchFn: import("@angular/core").InputSignal<SearchFn | null>;
     readonly compareWith: import("@angular/core").InputSignal<Nullable<CompareWithFn>>;
     readonly appearance: import("@angular/core").InputSignal<FormElementAppearance>;
     readonly variant: import("@angular/core").InputSignal<FormElementVariant>;
@@ -98,10 +104,6 @@ export declare class ArdiumSelectComponent extends _FormFieldComponentBase imple
         end: number;
     }>;
     readonly scrollToEndEvent: import("@angular/core").OutputEmitterRef<void>;
-    readonly searchEvent: import("@angular/core").OutputEmitterRef<{
-        search: string;
-        matching: any[];
-    }>;
     readonly isOpen: import("@angular/core").ModelSignal<boolean>;
     readonly searchInput: Signal<ElementRef<HTMLInputElement> | undefined>;
     readonly dropdownPanel: Signal<ArdiumDropdownPanelComponent | undefined>;
@@ -165,7 +167,7 @@ export declare class ArdiumSelectComponent extends _FormFieldComponentBase imple
     readonly isInputElementReadonly: Signal<boolean>;
     isValueWithinDisplayLimit(i: number): boolean;
     readonly placeholderForCurrentContext: Signal<string>;
-    filter(filterTerm: string, suppressSearchEvent?: boolean): void;
+    filter(filterTerm: string): void;
     onSearchInputFocus(): void;
     onBlur(event: FocusEvent): void;
     toggleItem(item: ArdOption): void;
@@ -203,5 +205,5 @@ export declare class ArdiumSelectComponent extends _FormFieldComponentBase imple
     private _onBackspaceOrDeletePress;
     private _onCtrlAPress;
     static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumSelectComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ArdiumSelectComponent, "ard-select", never, { "valueFrom": { "alias": "valueFrom"; "required": false; "isSignal": true; }; "labelFrom": { "alias": "labelFrom"; "required": false; "isSignal": true; }; "disabledFrom": { "alias": "disabledFrom"; "required": false; "isSignal": true; }; "groupLabelFrom": { "alias": "groupLabelFrom"; "required": false; "isSignal": true; }; "groupDisabledFrom": { "alias": "groupDisabledFrom"; "required": false; "isSignal": true; }; "childrenFrom": { "alias": "childrenFrom"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "clearButtonTitle": { "alias": "clearButtonTitle"; "required": false; "isSignal": true; }; "dropdownPosition": { "alias": "dropdownPosition"; "required": false; "isSignal": true; }; "noItemsFoundText": { "alias": "noItemsFoundText"; "required": false; "isSignal": true; }; "addCustomOptionText": { "alias": "addCustomOptionText"; "required": false; "isSignal": true; }; "loadingPlaceholderText": { "alias": "loadingPlaceholderText"; "required": false; "isSignal": true; }; "searchInputId": { "alias": "searchInputId"; "required": false; "isSignal": true; }; "inputAttrs": { "alias": "inputAttrs"; "required": false; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; "_deferValueWrites": { "alias": "deferValueWrites"; "required": false; "isSignal": true; }; "itemsAlreadyGrouped": { "alias": "itemsAlreadyGrouped"; "required": false; "isSignal": true; }; "invertDisabled": { "alias": "invertDisabled"; "required": false; "isSignal": true; }; "noGroupActions": { "alias": "noGroupActions"; "required": false; "isSignal": true; }; "autoHighlightFirst": { "alias": "autoHighlightFirst"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; "keepOpen": { "alias": "keepOpen"; "required": false; "isSignal": true; }; "hideSelected": { "alias": "hideSelected"; "required": false; "isSignal": true; }; "noBackspaceClear": { "alias": "noBackspaceClear"; "required": false; "isSignal": true; }; "searchCaseSensitive": { "alias": "searchCaseSensitive"; "required": false; "isSignal": true; }; "keepSearchAfterSelect": { "alias": "keepSearchAfterSelect"; "required": false; "isSignal": true; }; "maxSelectedItems": { "alias": "maxSelectedItems"; "required": false; "isSignal": true; }; "itemDisplayLimit": { "alias": "itemDisplayLimit"; "required": false; "isSignal": true; }; "searchFn": { "alias": "searchFn"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "dropdownAppearance": { "alias": "dropdownAppearance"; "required": false; "isSignal": true; }; "dropdownVariant": { "alias": "dropdownVariant"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; }; "multiselectable": { "alias": "multiselectable"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "addCustom": { "alias": "addCustom"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; }; "isOpen": { "alias": "isOpen"; "required": false; "isSignal": true; }; "dropdownPanelWidth": { "alias": "dropdownPanelWidth"; "required": false; "isSignal": true; }; "dropdownPanelHeight": { "alias": "dropdownPanelHeight"; "required": false; "isSignal": true; }; "dropdownPanelMinWidth": { "alias": "dropdownPanelMinWidth"; "required": false; "isSignal": true; }; "dropdownPanelMinHeight": { "alias": "dropdownPanelMinHeight"; "required": false; "isSignal": true; }; "dropdownPanelMaxWidth": { "alias": "dropdownPanelMaxWidth"; "required": false; "isSignal": true; }; "dropdownPanelMaxHeight": { "alias": "dropdownPanelMaxHeight"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "addEvent": "add"; "failedToAddEvent": "failedToAdd"; "removeEvent": "remove"; "clearEvent": "clear"; "openEvent": "open"; "closeEvent": "close"; "scrollEvent": "scroll"; "scrollToEndEvent": "scrollToEnd"; "searchEvent": "search"; "isOpen": "isOpenChange"; }, ["optionTemplate", "optgroupTemplate", "valueTemplate", "placeholderTemplate", "dropdownArrowTemplate", "loadingSpinnerTemplate", "loadingPlaceholderTemplate", "dropdownHeaderTemplate", "dropdownFooterTemplate", "noItemsFoundTemplate", "addCustomTemplate", "itemLimitReachedTemplate", "itemDisplayLimitTemplate", "prefixTemplate", "suffixTemplate", "optionComponents"], never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ArdiumSelectComponent, "ard-select", never, { "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; "valueFrom": { "alias": "valueFrom"; "required": false; "isSignal": true; }; "labelFrom": { "alias": "labelFrom"; "required": false; "isSignal": true; }; "disabledFrom": { "alias": "disabledFrom"; "required": false; "isSignal": true; }; "groupLabelFrom": { "alias": "groupLabelFrom"; "required": false; "isSignal": true; }; "groupDisabledFrom": { "alias": "groupDisabledFrom"; "required": false; "isSignal": true; }; "childrenFrom": { "alias": "childrenFrom"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "clearButtonTitle": { "alias": "clearButtonTitle"; "required": false; "isSignal": true; }; "dropdownPosition": { "alias": "dropdownPosition"; "required": false; "isSignal": true; }; "noItemsFoundText": { "alias": "noItemsFoundText"; "required": false; "isSignal": true; }; "addCustomOptionText": { "alias": "addCustomOptionText"; "required": false; "isSignal": true; }; "loadingPlaceholderText": { "alias": "loadingPlaceholderText"; "required": false; "isSignal": true; }; "searchInputId": { "alias": "searchInputId"; "required": false; "isSignal": true; }; "inputAttrs": { "alias": "inputAttrs"; "required": false; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; "_deferValueWrites": { "alias": "deferValueWrites"; "required": false; "isSignal": true; }; "itemsAlreadyGrouped": { "alias": "itemsAlreadyGrouped"; "required": false; "isSignal": true; }; "invertDisabled": { "alias": "invertDisabled"; "required": false; "isSignal": true; }; "noGroupActions": { "alias": "noGroupActions"; "required": false; "isSignal": true; }; "autoHighlightFirst": { "alias": "autoHighlightFirst"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; "keepOpen": { "alias": "keepOpen"; "required": false; "isSignal": true; }; "hideSelected": { "alias": "hideSelected"; "required": false; "isSignal": true; }; "noBackspaceClear": { "alias": "noBackspaceClear"; "required": false; "isSignal": true; }; "searchCaseSensitive": { "alias": "searchCaseSensitive"; "required": false; "isSignal": true; }; "keepSearchAfterSelect": { "alias": "keepSearchAfterSelect"; "required": false; "isSignal": true; }; "maxSelectedItems": { "alias": "maxSelectedItems"; "required": false; "isSignal": true; }; "itemDisplayLimit": { "alias": "itemDisplayLimit"; "required": false; "isSignal": true; }; "searchFn": { "alias": "searchFn"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "dropdownAppearance": { "alias": "dropdownAppearance"; "required": false; "isSignal": true; }; "dropdownVariant": { "alias": "dropdownVariant"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; }; "multiselectable": { "alias": "multiselectable"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "addCustom": { "alias": "addCustom"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; }; "isOpen": { "alias": "isOpen"; "required": false; "isSignal": true; }; "dropdownPanelWidth": { "alias": "dropdownPanelWidth"; "required": false; "isSignal": true; }; "dropdownPanelHeight": { "alias": "dropdownPanelHeight"; "required": false; "isSignal": true; }; "dropdownPanelMinWidth": { "alias": "dropdownPanelMinWidth"; "required": false; "isSignal": true; }; "dropdownPanelMinHeight": { "alias": "dropdownPanelMinHeight"; "required": false; "isSignal": true; }; "dropdownPanelMaxWidth": { "alias": "dropdownPanelMaxWidth"; "required": false; "isSignal": true; }; "dropdownPanelMaxHeight": { "alias": "dropdownPanelMaxHeight"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; "valueChange": "valueChange"; "addEvent": "add"; "failedToAddEvent": "failedToAdd"; "removeEvent": "remove"; "clearEvent": "clear"; "openEvent": "open"; "closeEvent": "close"; "scrollEvent": "scroll"; "scrollToEndEvent": "scrollToEnd"; "isOpen": "isOpenChange"; }, ["optionTemplate", "optgroupTemplate", "valueTemplate", "placeholderTemplate", "dropdownArrowTemplate", "loadingSpinnerTemplate", "loadingPlaceholderTemplate", "dropdownHeaderTemplate", "dropdownFooterTemplate", "noItemsFoundTemplate", "addCustomTemplate", "itemLimitReachedTemplate", "itemDisplayLimitTemplate", "prefixTemplate", "suffixTemplate", "optionComponents"], never, false, never>;
 }

package/lib/slider/range-slider/range-slider.component.d.ts

@@ -29,7 +29,7 @@ export declare class ArdiumRangeSliderComponent extends _AbstractSlider<SliderRa
     onPointerMove(event: MouseEvent | TouchEvent): void;
     protected _percentValueToValue(percent: number, handleId: number): SliderRange;
     protected readonly _handlePositions: import("@angular/core").Signal<[number, number]>;
-    readonly currentHandle: import("@angular/core").WritableSignal<2 | 1 | null>;
+    readonly currentHandle: import("@angular/core").WritableSignal<1 | 2 | null>;
     onHandleFocus(event: FocusEvent, handleId: 1 | 2): void;
     onBlur(event: FocusEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumRangeSliderComponent, never>;

package/lib/types/item-storage.types.d.ts

@@ -33,6 +33,18 @@ export declare const ArdPanelPosition: {
 };
 export type ArdPanelPosition = (typeof ArdPanelPosition)[keyof typeof ArdPanelPosition];
 export type ArdItemGroupMap = Map<any, ArdOptionGroup>;
+/**
+ * Function used to determine the group label for an item, based on the item's data.
+ */
 export type GroupByFn = (item: any) => any;
+/**
+ * Function used to search for items based on a search term.
+ *
+ * Should return a tuple where the first value is a boolean indicating if the item matches the search term,
+ * and the second value is a boolean indicating if the match is an exact match (used for auto-highlighting).
+ */
 export type SearchFn = (searchTerm: string, item: ArdOption) => [boolean, boolean];
+/**
+ * Function used to compare a value with an option's value to determine if they are considered equal.
+ */
 export type CompareWithFn = (value: any, optionValue: any) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ardium-ui/ui",
-  "version": "5.0.0-alpha.85",
+  "version": "5.0.0-alpha.87",
   "peerDependencies": {
     "@angular/common": ">=18.0.0",
     "@angular/core": ">=18.0.0",