angular-perfect-select 2.2.0 → 2.3.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as angular_perfect_select from 'angular-perfect-select';
 import * as _angular_core from '@angular/core';
-import { OnInit, OnChanges, OnDestroy, EventEmitter, ElementRef, TemplateRef, SimpleChanges } from '@angular/core';
+import { OnInit, OnChanges, OnDestroy, EventEmitter, ElementRef, TemplateRef, SimpleChanges, EnvironmentProviders } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
 import { CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
@@ -85,8 +85,69 @@ interface SelectPinEvent {
     pinned: boolean;
 }
 
+/**
+ * Utility functions for sorting select options
+ */
+
+type SortMode = 'none' | 'alphabetical-asc' | 'alphabetical-desc' | 'recently-used' | 'custom';
+interface SortConfig {
+    mode: SortMode;
+    customComparator?: (a: SelectOption, b: SelectOption) => number;
+    getLabel?: (option: SelectOption) => string;
+    recentlyUsedIds?: Set<any>;
+}
+/**
+ * Sorts options based on the specified mode
+ */
+declare function sortOptions(options: SelectOption[], config: SortConfig): SelectOption[];
+
+type ColorScheme = 'light' | 'dark' | 'auto';
+declare class DarkModeProvider {
+    private platformId;
+    private isBrowser;
+    private preferredScheme;
+    private systemPrefersDark;
+    isDarkMode: _angular_core.Signal<boolean>;
+    constructor();
+    /**
+     * Initialize system dark mode detection
+     */
+    private initDarkModeDetection;
+    /**
+     * Set user's color scheme preference
+     */
+    setColorScheme(scheme: ColorScheme): void;
+    /**
+     * Get current color scheme preference
+     */
+    getColorScheme(): ColorScheme;
+    /**
+     * Toggle between light and dark mode
+     */
+    toggleDarkMode(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DarkModeProvider, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DarkModeProvider>;
+}
+
+/**
+ * Bulk actions for multi-select mode
+ */
+
+interface BulkAction {
+    id: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    action: (selectedOptions: SelectOption[]) => void;
+}
+interface SelectBulkActionEvent {
+    action: BulkAction;
+    selectedOptions: SelectOption[];
+}
+
 declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, OnChanges, OnDestroy {
     private sanitizer;
+    private darkModeProvider;
     options: SelectOption[];
     placeholder: string;
     isMulti: boolean;
@@ -180,6 +241,28 @@ declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, On
     collapsibleTags: boolean;
     showAllTagsText: string;
     showLessTagsText: string;
+    enableFuzzySearch: boolean;
+    fuzzySearchThreshold: number;
+    fuzzySearchCaseSensitive: boolean;
+    enableAutoThemeDetection: boolean;
+    colorScheme: ColorScheme;
+    darkModeTheme: ThemeName;
+    lightModeTheme: ThemeName;
+    enableLoadingSkeleton: boolean;
+    skeletonItemCount: number;
+    skeletonItemHeight: number;
+    skeletonAnimationDelay: number;
+    compactMode: boolean;
+    showOptionCheckboxes: boolean;
+    checkboxPosition: 'left' | 'right';
+    checkboxStyle: 'default' | 'filled' | 'outlined';
+    bulkActions: BulkAction[];
+    enableBulkActions: boolean;
+    bulkActionsPosition: 'above' | 'below' | 'float';
+    bulkActionsLabel: string;
+    sortMode: SortMode;
+    customSortComparator: ((a: SelectOption, b: SelectOption) => number) | null;
+    recentlyUsedLimit: number;
     name: string;
     id: string;
     autoFocus: boolean;
@@ -205,12 +288,14 @@ declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, On
     scrollEnd: EventEmitter<SelectScrollEndEvent>;
     reorder: EventEmitter<SelectReorderEvent>;
     pin: EventEmitter<SelectPinEvent>;
+    bulkActionSelected: EventEmitter<SelectBulkActionEvent>;
     selectContainerRef: ElementRef;
     searchInputRef: ElementRef;
     menuElementRef: ElementRef;
     virtualScrollViewport?: CdkVirtualScrollViewport;
     optionTemplate?: TemplateRef<any>;
     selectedOptionTemplate?: TemplateRef<any>;
+    tagTemplate?: TemplateRef<any>;
     isOpen: _angular_core.WritableSignal<boolean>;
     searchTerm: _angular_core.WritableSignal<string>;
     highlightedIndex: _angular_core.WritableSignal<number>;
@@ -231,6 +316,8 @@ declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, On
     isDragging: _angular_core.WritableSignal<boolean>;
     private pinnedOptionsStorageKey;
     tagsExpanded: _angular_core.WritableSignal<boolean>;
+    isDarkMode: _angular_core.WritableSignal<boolean>;
+    recentlyUsedIds: _angular_core.WritableSignal<Set<any>>;
     currentTheme: _angular_core.Signal<angular_perfect_select.ThemeColors>;
     filteredOptions: _angular_core.Signal<SelectOption[]>;
     selectedOptions: _angular_core.Signal<(SelectOption | {
@@ -245,6 +332,8 @@ declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, On
         value: any;
     })[]>;
     hiddenTagsCount: _angular_core.Signal<number>;
+    resolvedTheme: _angular_core.Signal<ThemeName>;
+    hasBulkActions: _angular_core.Signal<boolean>;
     groupedOptions: _angular_core.Signal<Record<string, SelectOption[]> | null>;
     displayOptions: _angular_core.Signal<SelectOption[]>;
     allOptionsSelected: _angular_core.Signal<boolean>;
@@ -252,11 +341,11 @@ declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, On
     isMaxSelectionReached: _angular_core.Signal<boolean>;
     showMinSearchMessage: _angular_core.Signal<boolean>;
     displayOptionsWithRecent: _angular_core.Signal<SelectOption[]>;
-    validationIconName: _angular_core.Signal<"error" | "warning" | "info" | "" | "check_circle">;
+    validationIconName: _angular_core.Signal<"" | "error" | "warning" | "check_circle" | "info">;
     getEnabledOptionsCount(): number;
     private onChange;
     private onTouched;
-    constructor(sanitizer: DomSanitizer);
+    constructor(sanitizer: DomSanitizer, darkModeProvider: DarkModeProvider);
     ngOnChanges(changes: SimpleChanges): void;
     writeValue(value: any): void;
     registerOnChange(fn: any): void;
@@ -305,8 +394,12 @@ declare class PerfectSelectComponent implements ControlValueAccessor, OnInit, On
     hideTooltip(): void;
     getTooltipContent(option: SelectOption): string;
     getValidationClass(): string;
+    trackRecentlyUsed(option: SelectOption): void;
+    isOptionSelected(option: SelectOption): boolean;
+    executeBulkAction(action: BulkAction): void;
+    getSkeletonItems(): number[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PerfectSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PerfectSelectComponent, "ng-perfect-select", never, { "options": { "alias": "options"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "isMulti": { "alias": "isMulti"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "isSearchable": { "alias": "isSearchable"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "isClearable": { "alias": "isClearable"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "isDisabled": { "alias": "isDisabled"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "isRtl": { "alias": "isRtl"; "required": false; }; "closeMenuOnSelect": { "alias": "closeMenuOnSelect"; "required": false; }; "hideSelectedOptions": { "alias": "hideSelectedOptions"; "required": false; }; "isCreatable": { "alias": "isCreatable"; "required": false; }; "allowCreateWhileLoading": { "alias": "allowCreateWhileLoading"; "required": false; }; "createOptionPosition": { "alias": "createOptionPosition"; "required": false; }; "formatCreateLabel": { "alias": "formatCreateLabel"; "required": false; }; "loadOptions": { "alias": "loadOptions"; "required": false; }; "cacheOptions": { "alias": "cacheOptions"; "required": false; }; "defaultOptions": { "alias": "defaultOptions"; "required": false; }; "selectSize": { "alias": "selectSize"; "required": false; }; "containerSize": { "alias": "containerSize"; "required": false; }; "theme": { "alias": "theme"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "customStyles": { "alias": "customStyles"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "menuPlacement": { "alias": "menuPlacement"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "getOptionLabel": { "alias": "getOptionLabel"; "required": false; }; "getOptionValue": { "alias": "getOptionValue"; "required": false; }; "isOptionDisabled": { "alias": "isOptionDisabled"; "required": false; }; "filterOption": { "alias": "filterOption"; "required": false; }; "isGrouped": { "alias": "isGrouped"; "required": false; }; "groupBy": { "alias": "groupBy"; "required": false; }; "showSelectAll": { "alias": "showSelectAll"; "required": false; }; "selectAllText": { "alias": "selectAllText"; "required": false; }; "deselectAllText": { "alias": "deselectAllText"; "required": false; }; "showOptionIcons": { "alias": "showOptionIcons"; "required": false; }; "showOptionBadges": { "alias": "showOptionBadges"; "required": false; }; "maxOptionsDisplay": { "alias": "maxOptionsDisplay"; "required": false; }; "optionHeight": { "alias": "optionHeight"; "required": false; }; "emptyStateText": { "alias": "emptyStateText"; "required": false; }; "emptySearchText": { "alias": "emptySearchText"; "required": false; }; "maxSelectedOptions": { "alias": "maxSelectedOptions"; "required": false; }; "maxSelectedMessage": { "alias": "maxSelectedMessage"; "required": false; }; "debounceTime": { "alias": "debounceTime"; "required": false; }; "minSearchLength": { "alias": "minSearchLength"; "required": false; }; "minSearchMessage": { "alias": "minSearchMessage"; "required": false; }; "enableVirtualScroll": { "alias": "enableVirtualScroll"; "required": false; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; }; "virtualScrollMinBufferPx": { "alias": "virtualScrollMinBufferPx"; "required": false; }; "virtualScrollMaxBufferPx": { "alias": "virtualScrollMaxBufferPx"; "required": false; }; "validationState": { "alias": "validationState"; "required": false; }; "validationMessage": { "alias": "validationMessage"; "required": false; }; "showValidationIcon": { "alias": "showValidationIcon"; "required": false; }; "showTooltips": { "alias": "showTooltips"; "required": false; }; "tooltipDelay": { "alias": "tooltipDelay"; "required": false; }; "getOptionTooltip": { "alias": "getOptionTooltip"; "required": false; }; "showRecentSelections": { "alias": "showRecentSelections"; "required": false; }; "recentSelectionsLimit": { "alias": "recentSelectionsLimit"; "required": false; }; "recentSelectionsLabel": { "alias": "recentSelectionsLabel"; "required": false; }; "enableRecentSelectionsPersistence": { "alias": "enableRecentSelectionsPersistence"; "required": false; }; "enableInfiniteScroll": { "alias": "enableInfiniteScroll"; "required": false; }; "infiniteScrollThreshold": { "alias": "infiniteScrollThreshold"; "required": false; }; "totalOptionsCount": { "alias": "totalOptionsCount"; "required": false; }; "enableAdvancedKeyboard": { "alias": "enableAdvancedKeyboard"; "required": false; }; "typeAheadDelay": { "alias": "typeAheadDelay"; "required": false; }; "enableCopyPaste": { "alias": "enableCopyPaste"; "required": false; }; "copyDelimiter": { "alias": "copyDelimiter"; "required": false; }; "pasteDelimiter": { "alias": "pasteDelimiter"; "required": false; }; "enableDragDrop": { "alias": "enableDragDrop"; "required": false; }; "dragDropPlaceholder": { "alias": "dragDropPlaceholder"; "required": false; }; "dragDropAnimation": { "alias": "dragDropAnimation"; "required": false; }; "enablePinning": { "alias": "enablePinning"; "required": false; }; "maxPinnedOptions": { "alias": "maxPinnedOptions"; "required": false; }; "pinnedOptionsLabel": { "alias": "pinnedOptionsLabel"; "required": false; }; "persistPinnedOptions": { "alias": "persistPinnedOptions"; "required": false; }; "enableSearchHighlight": { "alias": "enableSearchHighlight"; "required": false; }; "searchHighlightColor": { "alias": "searchHighlightColor"; "required": false; }; "searchHighlightTextColor": { "alias": "searchHighlightTextColor"; "required": false; }; "maxVisibleTags": { "alias": "maxVisibleTags"; "required": false; }; "showMoreTagsText": { "alias": "showMoreTagsText"; "required": false; }; "collapsibleTags": { "alias": "collapsibleTags"; "required": false; }; "showAllTagsText": { "alias": "showAllTagsText"; "required": false; }; "showLessTagsText": { "alias": "showLessTagsText"; "required": false; }; "name": { "alias": "name"; "required": false; }; "id": { "alias": "id"; "required": false; }; "autoFocus": { "alias": "autoFocus"; "required": false; }; "openMenuOnFocus": { "alias": "openMenuOnFocus"; "required": false; }; "openMenuOnClick": { "alias": "openMenuOnClick"; "required": false; }; "tabSelectsValue": { "alias": "tabSelectsValue"; "required": false; }; "backspaceRemovesValue": { "alias": "backspaceRemovesValue"; "required": false; }; "escapeClearsValue": { "alias": "escapeClearsValue"; "required": false; }; "noOptionsMessage": { "alias": "noOptionsMessage"; "required": false; }; "loadingMessage": { "alias": "loadingMessage"; "required": false; }; }, { "change": "change"; "clear": "clear"; "focus": "focus"; "blur": "blur"; "menuOpen": "menuOpen"; "menuClose": "menuClose"; "inputChange": "inputChange"; "createOption": "createOption"; "optionsLoaded": "optionsLoaded"; "loadError": "loadError"; "copy": "copy"; "paste": "paste"; "scrollEnd": "scrollEnd"; "reorder": "reorder"; "pin": "pin"; }, ["optionTemplate", "selectedOptionTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PerfectSelectComponent, "ng-perfect-select", never, { "options": { "alias": "options"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "isMulti": { "alias": "isMulti"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "isSearchable": { "alias": "isSearchable"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "isClearable": { "alias": "isClearable"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "isDisabled": { "alias": "isDisabled"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "isRtl": { "alias": "isRtl"; "required": false; }; "closeMenuOnSelect": { "alias": "closeMenuOnSelect"; "required": false; }; "hideSelectedOptions": { "alias": "hideSelectedOptions"; "required": false; }; "isCreatable": { "alias": "isCreatable"; "required": false; }; "allowCreateWhileLoading": { "alias": "allowCreateWhileLoading"; "required": false; }; "createOptionPosition": { "alias": "createOptionPosition"; "required": false; }; "formatCreateLabel": { "alias": "formatCreateLabel"; "required": false; }; "loadOptions": { "alias": "loadOptions"; "required": false; }; "cacheOptions": { "alias": "cacheOptions"; "required": false; }; "defaultOptions": { "alias": "defaultOptions"; "required": false; }; "selectSize": { "alias": "selectSize"; "required": false; }; "containerSize": { "alias": "containerSize"; "required": false; }; "theme": { "alias": "theme"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "customStyles": { "alias": "customStyles"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "menuPlacement": { "alias": "menuPlacement"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "getOptionLabel": { "alias": "getOptionLabel"; "required": false; }; "getOptionValue": { "alias": "getOptionValue"; "required": false; }; "isOptionDisabled": { "alias": "isOptionDisabled"; "required": false; }; "filterOption": { "alias": "filterOption"; "required": false; }; "isGrouped": { "alias": "isGrouped"; "required": false; }; "groupBy": { "alias": "groupBy"; "required": false; }; "showSelectAll": { "alias": "showSelectAll"; "required": false; }; "selectAllText": { "alias": "selectAllText"; "required": false; }; "deselectAllText": { "alias": "deselectAllText"; "required": false; }; "showOptionIcons": { "alias": "showOptionIcons"; "required": false; }; "showOptionBadges": { "alias": "showOptionBadges"; "required": false; }; "maxOptionsDisplay": { "alias": "maxOptionsDisplay"; "required": false; }; "optionHeight": { "alias": "optionHeight"; "required": false; }; "emptyStateText": { "alias": "emptyStateText"; "required": false; }; "emptySearchText": { "alias": "emptySearchText"; "required": false; }; "maxSelectedOptions": { "alias": "maxSelectedOptions"; "required": false; }; "maxSelectedMessage": { "alias": "maxSelectedMessage"; "required": false; }; "debounceTime": { "alias": "debounceTime"; "required": false; }; "minSearchLength": { "alias": "minSearchLength"; "required": false; }; "minSearchMessage": { "alias": "minSearchMessage"; "required": false; }; "enableVirtualScroll": { "alias": "enableVirtualScroll"; "required": false; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; }; "virtualScrollMinBufferPx": { "alias": "virtualScrollMinBufferPx"; "required": false; }; "virtualScrollMaxBufferPx": { "alias": "virtualScrollMaxBufferPx"; "required": false; }; "validationState": { "alias": "validationState"; "required": false; }; "validationMessage": { "alias": "validationMessage"; "required": false; }; "showValidationIcon": { "alias": "showValidationIcon"; "required": false; }; "showTooltips": { "alias": "showTooltips"; "required": false; }; "tooltipDelay": { "alias": "tooltipDelay"; "required": false; }; "getOptionTooltip": { "alias": "getOptionTooltip"; "required": false; }; "showRecentSelections": { "alias": "showRecentSelections"; "required": false; }; "recentSelectionsLimit": { "alias": "recentSelectionsLimit"; "required": false; }; "recentSelectionsLabel": { "alias": "recentSelectionsLabel"; "required": false; }; "enableRecentSelectionsPersistence": { "alias": "enableRecentSelectionsPersistence"; "required": false; }; "enableInfiniteScroll": { "alias": "enableInfiniteScroll"; "required": false; }; "infiniteScrollThreshold": { "alias": "infiniteScrollThreshold"; "required": false; }; "totalOptionsCount": { "alias": "totalOptionsCount"; "required": false; }; "enableAdvancedKeyboard": { "alias": "enableAdvancedKeyboard"; "required": false; }; "typeAheadDelay": { "alias": "typeAheadDelay"; "required": false; }; "enableCopyPaste": { "alias": "enableCopyPaste"; "required": false; }; "copyDelimiter": { "alias": "copyDelimiter"; "required": false; }; "pasteDelimiter": { "alias": "pasteDelimiter"; "required": false; }; "enableDragDrop": { "alias": "enableDragDrop"; "required": false; }; "dragDropPlaceholder": { "alias": "dragDropPlaceholder"; "required": false; }; "dragDropAnimation": { "alias": "dragDropAnimation"; "required": false; }; "enablePinning": { "alias": "enablePinning"; "required": false; }; "maxPinnedOptions": { "alias": "maxPinnedOptions"; "required": false; }; "pinnedOptionsLabel": { "alias": "pinnedOptionsLabel"; "required": false; }; "persistPinnedOptions": { "alias": "persistPinnedOptions"; "required": false; }; "enableSearchHighlight": { "alias": "enableSearchHighlight"; "required": false; }; "searchHighlightColor": { "alias": "searchHighlightColor"; "required": false; }; "searchHighlightTextColor": { "alias": "searchHighlightTextColor"; "required": false; }; "maxVisibleTags": { "alias": "maxVisibleTags"; "required": false; }; "showMoreTagsText": { "alias": "showMoreTagsText"; "required": false; }; "collapsibleTags": { "alias": "collapsibleTags"; "required": false; }; "showAllTagsText": { "alias": "showAllTagsText"; "required": false; }; "showLessTagsText": { "alias": "showLessTagsText"; "required": false; }; "enableFuzzySearch": { "alias": "enableFuzzySearch"; "required": false; }; "fuzzySearchThreshold": { "alias": "fuzzySearchThreshold"; "required": false; }; "fuzzySearchCaseSensitive": { "alias": "fuzzySearchCaseSensitive"; "required": false; }; "enableAutoThemeDetection": { "alias": "enableAutoThemeDetection"; "required": false; }; "colorScheme": { "alias": "colorScheme"; "required": false; }; "darkModeTheme": { "alias": "darkModeTheme"; "required": false; }; "lightModeTheme": { "alias": "lightModeTheme"; "required": false; }; "enableLoadingSkeleton": { "alias": "enableLoadingSkeleton"; "required": false; }; "skeletonItemCount": { "alias": "skeletonItemCount"; "required": false; }; "skeletonItemHeight": { "alias": "skeletonItemHeight"; "required": false; }; "skeletonAnimationDelay": { "alias": "skeletonAnimationDelay"; "required": false; }; "compactMode": { "alias": "compactMode"; "required": false; }; "showOptionCheckboxes": { "alias": "showOptionCheckboxes"; "required": false; }; "checkboxPosition": { "alias": "checkboxPosition"; "required": false; }; "checkboxStyle": { "alias": "checkboxStyle"; "required": false; }; "bulkActions": { "alias": "bulkActions"; "required": false; }; "enableBulkActions": { "alias": "enableBulkActions"; "required": false; }; "bulkActionsPosition": { "alias": "bulkActionsPosition"; "required": false; }; "bulkActionsLabel": { "alias": "bulkActionsLabel"; "required": false; }; "sortMode": { "alias": "sortMode"; "required": false; }; "customSortComparator": { "alias": "customSortComparator"; "required": false; }; "recentlyUsedLimit": { "alias": "recentlyUsedLimit"; "required": false; }; "name": { "alias": "name"; "required": false; }; "id": { "alias": "id"; "required": false; }; "autoFocus": { "alias": "autoFocus"; "required": false; }; "openMenuOnFocus": { "alias": "openMenuOnFocus"; "required": false; }; "openMenuOnClick": { "alias": "openMenuOnClick"; "required": false; }; "tabSelectsValue": { "alias": "tabSelectsValue"; "required": false; }; "backspaceRemovesValue": { "alias": "backspaceRemovesValue"; "required": false; }; "escapeClearsValue": { "alias": "escapeClearsValue"; "required": false; }; "noOptionsMessage": { "alias": "noOptionsMessage"; "required": false; }; "loadingMessage": { "alias": "loadingMessage"; "required": false; }; }, { "change": "change"; "clear": "clear"; "focus": "focus"; "blur": "blur"; "menuOpen": "menuOpen"; "menuClose": "menuClose"; "inputChange": "inputChange"; "createOption": "createOption"; "optionsLoaded": "optionsLoaded"; "loadError": "loadError"; "copy": "copy"; "paste": "paste"; "scrollEnd": "scrollEnd"; "reorder": "reorder"; "pin": "pin"; "bulkActionSelected": "bulkActionSelected"; }, ["optionTemplate", "selectedOptionTemplate", "tagTemplate"], never, true, never>;
 }
 
 declare const dropdownAnimation: AnimationTriggerMetadata;
@@ -323,5 +416,52 @@ declare class ClickOutsideDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ClickOutsideDirective, "[clickOutside]", never, {}, { "clickOutside": "clickOutside"; }, never, never, true, never>;
 }
 
-export { ClickOutsideDirective, PerfectSelectComponent, THEMES, dropdownAnimation, optionListAnimation, selectAnimations, tagAnimation };
-export type { InputChangeAction, SelectChangeAction, SelectChangeEvent, SelectCopyEvent, SelectCreateOptionEvent, SelectInputChangeEvent, SelectLoadErrorEvent, SelectOption, SelectOptionsLoadedEvent, SelectPasteEvent, SelectPinEvent, SelectReorderEvent, SelectScrollEndEvent, ThemeColors, ThemeName, ValidationConfig, ValidationState };
+/**
+ * Provides necessary CDK modules for PerfectSelectComponent.
+ * Import this in your app configuration if you encounter production build issues.
+ *
+ * @example
+ * ```typescript
+ * import { providePerfectSelect } from 'angular-perfect-select';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     // ... other providers
+ *     providePerfectSelect()
+ *   ]
+ * });
+ * ```
+ */
+declare function providePerfectSelect(): EnvironmentProviders;
+
+/**
+ * Fuzzy search utility for flexible string matching
+ * Supports acronym-style matching (e.g., 'fb' matches 'Facebook')
+ * and partial substring matching with scoring
+ */
+interface FuzzyMatchResult {
+    matches: boolean;
+    score: number;
+    matchedIndices: number[];
+}
+/**
+ * Performs fuzzy search matching
+ * @param searchTerm The search query
+ * @param targetString The string to search in
+ * @param options Configuration options
+ * @returns Match result with score and matched character indices
+ */
+declare function fuzzyMatch(searchTerm: string, targetString: string, options?: {
+    caseSensitive?: boolean;
+    threshold?: number;
+}): FuzzyMatchResult;
+/**
+ * Sorts options by fuzzy match score
+ */
+declare function sortByFuzzyScore<T>(items: T[], searchTerm: string, getLabel: (item: T) => string, options?: {
+    caseSensitive?: boolean;
+    threshold?: number;
+}): T[];
+
+export { ClickOutsideDirective, DarkModeProvider, PerfectSelectComponent, THEMES, dropdownAnimation, fuzzyMatch, optionListAnimation, providePerfectSelect, selectAnimations, sortByFuzzyScore, sortOptions, tagAnimation };
+export type { BulkAction, ColorScheme, FuzzyMatchResult, InputChangeAction, SelectBulkActionEvent, SelectChangeAction, SelectChangeEvent, SelectCopyEvent, SelectCreateOptionEvent, SelectInputChangeEvent, SelectLoadErrorEvent, SelectOption, SelectOptionsLoadedEvent, SelectPasteEvent, SelectPinEvent, SelectReorderEvent, SelectScrollEndEvent, SortConfig, SortMode, ThemeColors, ThemeName, ValidationConfig, ValidationState };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-perfect-select",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "A modern, feature-rich select component for Angular with react-select API compatibility",
   "main": "dist/index.js",
   "module": "dist/index.js",