@shival99/z-ui 2.0.50 → 2.0.52

package/types/shival99-z-ui-components-z-autocomplete.d.ts

@@ -78,7 +78,8 @@ interface ZAutocompleteControl<T = unknown> {
     close: () => void;
     setValue: (value: string) => void;
     value: Signal<string>;
-    selectedOption: Signal<ZAutocompleteOption<T> | null>;
+    /** Signal with selected options. Autocomplete returns an empty or one-item array. */
+    selected: Signal<ZAutocompleteOption<T>[]>;
     /**
      * @deprecated Use individual event outputs (zOnFocus, zOnBlur, etc.) instead.
      * Will be removed in a future version.
@@ -180,6 +181,7 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
     private readonly _measureVirtualItems;
     protected readonly config: _angular_core.Signal<ZAutocompleteConfig<T>>;
     protected readonly hasAsyncOptions: _angular_core.Signal<boolean>;
+    protected readonly asyncSelectedOptions: _angular_core.Signal<ZAutocompleteOption<T>[]>;
     protected readonly sourceOptions: _angular_core.Signal<ZAutocompleteOption<T>[]>;
     protected readonly isLoading: _angular_core.Signal<boolean>;
     protected readonly isLoadingMore: _angular_core.Signal<boolean>;
@@ -194,6 +196,7 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
     protected readonly effectiveDebounceTime: _angular_core.Signal<number>;
     protected readonly effectiveOptionTemplate: _angular_core.Signal<TemplateRef<any> | null>;
     protected readonly hasCustomOptionTemplate: _angular_core.Signal<boolean>;
+    protected readonly selected: _angular_core.Signal<ZAutocompleteOption<T>[]>;
     protected readonly highlightQuery: _angular_core.Signal<string>;
     /**
      * Local-mode loading state after debounce to avoid quick flicker.
@@ -271,7 +274,7 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
 
 declare const zAutocompleteInputVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "disabled" | "readonly" | "open" | "error" | null | undefined;
+    zStatus?: "default" | "error" | "disabled" | "readonly" | "open" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZAutocompleteInputVariants = VariantProps<typeof zAutocompleteInputVariants>;
 declare const zAutocompleteOptionVariants: (props?: ({

package/types/shival99-z-ui-components-z-gallery.d.ts

@@ -188,7 +188,7 @@ declare class ZGalleryComponent implements AfterViewInit {
     protected readonly headerControlHeight: _angular_core.Signal<"1.75rem" | "2rem" | "2.5rem" | "2.25rem">;
     protected readonly skeletonMediaHeight: _angular_core.Signal<"9rem" | "14rem" | "11rem">;
     protected readonly toggleIconSize: _angular_core.Signal<"14" | "16" | "20" | "18">;
-    protected readonly searchInputSize: _angular_core.Signal<"default" | "sm" | "lg">;
+    protected readonly searchInputSize: _angular_core.Signal<"sm" | "default" | "lg">;
     protected readonly filteredFiles: _angular_core.Signal<ZGalleryFile[]>;
     protected readonly selectedIds: _angular_core.Signal<Set<string>>;
     protected readonly isAllSelected: _angular_core.Signal<boolean>;
@@ -382,16 +382,16 @@ declare const isPreviewable: (file: ZGalleryFile) => boolean;
 declare const isImage: (file: ZGalleryFile) => boolean;
 
 declare const zGalleryVariants: (props?: ({
-    zSize?: "default" | "sm" | "lg" | null | undefined;
+    zSize?: "sm" | "default" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZGalleryVariants = VariantProps<typeof zGalleryVariants>;
 declare const zGalleryItemVariants: (props?: ({
     zMode?: "grid" | "list" | null | undefined;
-    zSize?: "default" | "sm" | "lg" | null | undefined;
+    zSize?: "sm" | "default" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZGalleryItemVariants = VariantProps<typeof zGalleryItemVariants>;
 declare const zGalleryFileIconVariants: (props?: ({
-    zSize?: "default" | "sm" | "lg" | null | undefined;
+    zSize?: "sm" | "default" | "lg" | null | undefined;
     zMode?: "grid" | "list" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZGalleryFileIconVariants = VariantProps<typeof zGalleryFileIconVariants>;

package/types/shival99-z-ui-components-z-popover.d.ts

@@ -6,6 +6,12 @@ import { VariantProps } from 'class-variance-authority';
 type ZPopoverTrigger = 'click' | 'hover' | 'manual';
 type ZPopoverPosition = 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'left-top' | 'left-bottom' | 'right' | 'right-top' | 'right-bottom';
 type ZPopoverContent = TemplateRef<unknown>;
+type ZPopoverOverlaySize = {
+    width?: number | string;
+    minWidth?: number | string;
+    maxWidth?: number | string;
+};
+type ZPopoverPaneStyles = Record<'top' | 'left' | 'right' | 'bottom' | 'transform', string>;
 interface ZPopoverControl {
     close: () => void;
     closeImmediate: () => void;
@@ -40,6 +46,7 @@ declare class ZPopoverComponent implements OnInit, OnDestroy {
     readonly zManualClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zOutsideClickClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zScrollClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
+    readonly zSticky: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zShowArrow: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     private _overlayRef;
     private _componentRef;
@@ -47,8 +54,10 @@ declare class ZPopoverComponent implements OnInit, OnDestroy {
     private _listenerCleanups;
     private _positionSubscription;
     private _scrollSubscription;
+    private _viewportResizeSubscription;
     private _resizeObserver;
     private _hideTimeout;
+    private _positionFrame;
     private readonly _isVisible;
     ngOnInit(): void;
     private _setupOverlayContainerListener;
@@ -61,21 +70,30 @@ declare class ZPopoverComponent implements OnInit, OnDestroy {
     isOpen(): boolean;
     updatePosition(): void;
     private _createOverlay;
+    private _createScrollStrategy;
     private _disposeOverlay;
     private _setupDelayMechanism;
     private _setupTriggers;
     private _setupOutsideClick;
     private _delay;
     private _setupScrollClose;
+    private _setupViewportResizeReposition;
     private _showPopover;
     private _isNestedPopoverTarget;
     private _setupResizeObserver;
+    private _updatePositionAfterContentSettles;
+    private _schedulePositionUpdate;
+    private _cancelScheduledPositionUpdate;
+    private _updatePositionNow;
+    private _applyMobilePopoverPosition;
+    private _isTriggerVisibleInViewport;
+    private _setOverlayPaneStyles;
     private _setupPopoverHover;
     private _hidePopover;
     private _clearHideTimeout;
     private _cleanupListeners;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZPopoverComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZPopoverComponent, "z-popover", never, { "zContent": { "alias": "zContent"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zTrigger": { "alias": "zTrigger"; "required": false; "isSignal": true; }; "zClass": { "alias": "zClass"; "required": false; "isSignal": true; }; "zShowDelay": { "alias": "zShowDelay"; "required": false; "isSignal": true; }; "zHideDelay": { "alias": "zHideDelay"; "required": false; "isSignal": true; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zOffset": { "alias": "zOffset"; "required": false; "isSignal": true; }; "zManualClose": { "alias": "zManualClose"; "required": false; "isSignal": true; }; "zOutsideClickClose": { "alias": "zOutsideClickClose"; "required": false; "isSignal": true; }; "zScrollClose": { "alias": "zScrollClose"; "required": false; "isSignal": true; }; "zShowArrow": { "alias": "zShowArrow"; "required": false; "isSignal": true; }; }, { "zShow": "zShow"; "zHide": "zHide"; "zControl": "zControl"; "zOutsideClick": "zOutsideClick"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZPopoverComponent, "z-popover", never, { "zContent": { "alias": "zContent"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zTrigger": { "alias": "zTrigger"; "required": false; "isSignal": true; }; "zClass": { "alias": "zClass"; "required": false; "isSignal": true; }; "zShowDelay": { "alias": "zShowDelay"; "required": false; "isSignal": true; }; "zHideDelay": { "alias": "zHideDelay"; "required": false; "isSignal": true; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zOffset": { "alias": "zOffset"; "required": false; "isSignal": true; }; "zManualClose": { "alias": "zManualClose"; "required": false; "isSignal": true; }; "zOutsideClickClose": { "alias": "zOutsideClickClose"; "required": false; "isSignal": true; }; "zScrollClose": { "alias": "zScrollClose"; "required": false; "isSignal": true; }; "zSticky": { "alias": "zSticky"; "required": false; "isSignal": true; }; "zShowArrow": { "alias": "zShowArrow"; "required": false; "isSignal": true; }; }, { "zShow": "zShow"; "zHide": "zHide"; "zControl": "zControl"; "zOutsideClick": "zOutsideClick"; }, never, ["*"], true, never>;
 }
 
 declare class ZPopoverDirective implements OnInit, OnDestroy {
@@ -89,11 +107,12 @@ declare class ZPopoverDirective implements OnInit, OnDestroy {
     readonly zHideDelay: _angular_core.InputSignal<number>;
     readonly zDisabled: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zOffset: _angular_core.InputSignal<number>;
-    readonly zPopoverWidth: _angular_core.InputSignal<number | "auto" | "trigger">;
+    readonly zPopoverWidth: _angular_core.InputSignal<number | "trigger" | "auto">;
     readonly zTriggerRef: _angular_core.InputSignal<HTMLElement | ElementRef<HTMLElement> | null>;
     readonly zManualClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zOutsideClickClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zScrollClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
+    readonly zSticky: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zShowArrow: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zShow: _angular_core.OutputEmitterRef<void>;
     readonly zHide: _angular_core.OutputEmitterRef<void>;
@@ -116,8 +135,10 @@ declare class ZPopoverDirective implements OnInit, OnDestroy {
     private _listenerCleanups;
     private _positionSubscription;
     private _scrollSubscription;
+    private _viewportResizeSubscription;
     private _resizeObserver;
     private _hideTimeout;
+    private _positionFrame;
     private readonly _isDestroyed;
     private readonly _isVisible;
     ngOnInit(): void;
@@ -131,6 +152,7 @@ declare class ZPopoverDirective implements OnInit, OnDestroy {
     isOpen(): boolean;
     updatePosition(): void;
     private _createOverlay;
+    private _createScrollStrategy;
     private _getWidthConfig;
     private _getTriggerElement;
     private _disposeOverlay;
@@ -138,16 +160,24 @@ declare class ZPopoverDirective implements OnInit, OnDestroy {
     private _setupTriggers;
     private _setupOutsideClick;
     private _setupScrollClose;
+    private _setupViewportResizeReposition;
     private _delay;
     private _showPopover;
     private _isNestedPopoverTarget;
     private _setupResizeObserver;
+    private _updatePositionAfterContentSettles;
+    private _schedulePositionUpdate;
+    private _cancelScheduledPositionUpdate;
+    private _updatePositionNow;
+    private _applyMobilePopoverPosition;
+    private _isTriggerVisibleInViewport;
+    private _setOverlayPaneStyles;
     private _setupPopoverHover;
     private _hidePopover;
     private _clearHideTimeout;
     private _cleanupListeners;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZPopoverDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ZPopoverDirective, "[z-popover]", ["zPopover"], { "zContent": { "alias": "zPopoverContent"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zTrigger": { "alias": "zTrigger"; "required": false; "isSignal": true; }; "zPopoverTrigger": { "alias": "zPopoverTrigger"; "required": false; "isSignal": true; }; "zClass": { "alias": "zClass"; "required": false; "isSignal": true; }; "zShowDelay": { "alias": "zShowDelay"; "required": false; "isSignal": true; }; "zHideDelay": { "alias": "zHideDelay"; "required": false; "isSignal": true; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zOffset": { "alias": "zOffset"; "required": false; "isSignal": true; }; "zPopoverWidth": { "alias": "zPopoverWidth"; "required": false; "isSignal": true; }; "zTriggerRef": { "alias": "zTriggerRef"; "required": false; "isSignal": true; }; "zManualClose": { "alias": "zManualClose"; "required": false; "isSignal": true; }; "zOutsideClickClose": { "alias": "zOutsideClickClose"; "required": false; "isSignal": true; }; "zScrollClose": { "alias": "zScrollClose"; "required": false; "isSignal": true; }; "zShowArrow": { "alias": "zShowArrow"; "required": false; "isSignal": true; }; }, { "zShow": "zShow"; "zHide": "zHide"; "zHideStart": "zHideStart"; "zControl": "zControl"; "zPositionChange": "zPositionChange"; "zOutsideClick": "zOutsideClick"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ZPopoverDirective, "[z-popover]", ["zPopover"], { "zContent": { "alias": "zPopoverContent"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zTrigger": { "alias": "zTrigger"; "required": false; "isSignal": true; }; "zPopoverTrigger": { "alias": "zPopoverTrigger"; "required": false; "isSignal": true; }; "zClass": { "alias": "zClass"; "required": false; "isSignal": true; }; "zShowDelay": { "alias": "zShowDelay"; "required": false; "isSignal": true; }; "zHideDelay": { "alias": "zHideDelay"; "required": false; "isSignal": true; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zOffset": { "alias": "zOffset"; "required": false; "isSignal": true; }; "zPopoverWidth": { "alias": "zPopoverWidth"; "required": false; "isSignal": true; }; "zTriggerRef": { "alias": "zTriggerRef"; "required": false; "isSignal": true; }; "zManualClose": { "alias": "zManualClose"; "required": false; "isSignal": true; }; "zOutsideClickClose": { "alias": "zOutsideClickClose"; "required": false; "isSignal": true; }; "zScrollClose": { "alias": "zScrollClose"; "required": false; "isSignal": true; }; "zSticky": { "alias": "zSticky"; "required": false; "isSignal": true; }; "zShowArrow": { "alias": "zShowArrow"; "required": false; "isSignal": true; }; }, { "zShow": "zShow"; "zHide": "zHide"; "zHideStart": "zHideStart"; "zControl": "zControl"; "zPositionChange": "zPositionChange"; "zOutsideClick": "zOutsideClick"; }, never, never, true, never>;
 }
 
 declare const zPopoverVariants: (props?: ({
@@ -156,4 +186,4 @@ declare const zPopoverVariants: (props?: ({
 type ZPopoverVariants = VariantProps<typeof zPopoverVariants>;
 
 export { ZPopoverComponent, ZPopoverDirective, zPopoverVariants };
-export type { ZPopoverContent, ZPopoverControl, ZPopoverPosition, ZPopoverTrigger, ZPopoverVariants };
+export type { ZPopoverContent, ZPopoverControl, ZPopoverOverlaySize, ZPopoverPaneStyles, ZPopoverPosition, ZPopoverTrigger, ZPopoverVariants };

package/types/shival99-z-ui-components-z-select.d.ts

@@ -45,10 +45,8 @@ interface ZSelectControl<T = unknown> {
     isOpen: Signal<boolean>;
     /** Signal with current value */
     value: Signal<T | T[] | null>;
-    /** Signal with currently selected option (single mode) */
-    selectedOption: Signal<ZSelectOption<T> | null>;
-    /** Signal with all selected options (multiple/tags mode) */
-    selectedOptions: Signal<ZSelectOption<T>[]>;
+    /** Signal with selected options. Single mode returns an empty or one-item array. */
+    selected: Signal<ZSelectOption<T>[]>;
     /** Signal with current error message */
     errorMessage: Signal<string>;
 }
@@ -155,6 +153,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     readonly zScrollDistance: _angular_core.InputSignal<number>;
     readonly zMaxVisible: _angular_core.InputSignal<number | null>;
     readonly zScrollClose: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
+    readonly zSticky: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zPosition: _angular_core.InputSignal<ZPopoverPosition>;
     readonly zSelectedTemplate: _angular_core.InputSignal<ZSelectLabelTemplate<T> | null>;
     readonly zOptionTemplate: _angular_core.InputSignal<ZSelectOptionTemplate<T> | null>;
@@ -193,6 +192,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected readonly config: _angular_core.Signal<ZSelectConfig<T>>;
     protected readonly hasAsyncOptions: _angular_core.Signal<boolean>;
     protected readonly sourceOptions: _angular_core.Signal<ZSelectOption<T>[]>;
+    protected readonly asyncSelectedOptions: _angular_core.Signal<ZSelectOption<T>[]>;
     protected readonly isLoading: _angular_core.Signal<boolean>;
     protected readonly isLoadingMore: _angular_core.Signal<boolean>;
     protected readonly canLoadMore: _angular_core.Signal<boolean>;
@@ -209,6 +209,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected readonly effectiveClearAllText: _angular_core.Signal<string>;
     protected readonly effectiveRequiredErrorText: _angular_core.Signal<string>;
     protected readonly translatedOptions: _angular_core.Signal<ZSelectOption<T>[]>;
+    protected readonly translatedAsyncSelectedOptions: _angular_core.Signal<ZSelectOption<T>[]>;
     protected readonly isMultipleMode: _angular_core.Signal<boolean>;
     protected readonly isTagsMode: _angular_core.Signal<boolean>;
     protected readonly effectiveSelectedTemplate: _angular_core.Signal<TemplateRef<any> | null>;
@@ -217,6 +218,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected readonly shouldUseVirtualScroll: _angular_core.Signal<boolean>;
     protected readonly selectedOption: _angular_core.Signal<ZSelectOption<T> | null>;
     protected readonly selectedOptions: _angular_core.Signal<ZSelectOption<T>[]>;
+    protected readonly selected: _angular_core.Signal<ZSelectOption<T>[]>;
     protected readonly displayedTags: _angular_core.Signal<ZSelectOption<T>[]>;
     protected readonly remainingCount: _angular_core.Signal<number>;
     protected readonly hasValue: _angular_core.Signal<boolean>;
@@ -264,6 +266,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected toggleDropdown(): void;
     protected onPopoverControl(control: ZPopoverControl): void;
     protected onPopoverShow(): void;
+    private _focusWithoutScroll;
     protected onPopoverHideStart(): void;
     protected onPopoverHideEnd(): void;
     protected onSearchChange(value: string): void;
@@ -275,6 +278,9 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected removeAll(): void;
     protected toggleSelectAllAction(): void;
     protected trackByValue: (_index: number, option: ZSelectOption<T>) => unknown;
+    private _findOptionByValue;
+    private _getOptionKey;
+    private _isValueEqual;
     private _emitControl;
     private _loadAsyncOptionsOnFocus;
     private _loadAsyncOptions;
@@ -293,11 +299,11 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     private _cancelAsyncValidation;
     private _triggerAsyncValidation;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZSelectComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZSelectComponent<any>, "z-select", ["zSelect"], { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zMode": { "alias": "zMode"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zLabel": { "alias": "zLabel"; "required": false; "isSignal": true; }; "zLabelClass": { "alias": "zLabelClass"; "required": false; "isSignal": true; }; "zPlaceholder": { "alias": "zPlaceholder"; "required": false; "isSignal": true; }; "zRequired": { "alias": "zRequired"; "required": false; "isSignal": true; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zReadonly": { "alias": "zReadonly"; "required": false; "isSignal": true; }; "zLoading": { "alias": "zLoading"; "required": false; "isSignal": true; }; "zPrefix": { "alias": "zPrefix"; "required": false; "isSignal": true; }; "zAllowClear": { "alias": "zAllowClear"; "required": false; "isSignal": true; }; "zWrap": { "alias": "zWrap"; "required": false; "isSignal": true; }; "zShowSearch": { "alias": "zShowSearch"; "required": false; "isSignal": true; }; "zPlaceholderSearch": { "alias": "zPlaceholderSearch"; "required": false; "isSignal": true; }; "zDebounce": { "alias": "zDebounce"; "required": false; "isSignal": true; }; "zNotFoundText": { "alias": "zNotFoundText"; "required": false; "isSignal": true; }; "zEmptyText": { "alias": "zEmptyText"; "required": false; "isSignal": true; }; "zEmptyIcon": { "alias": "zEmptyIcon"; "required": false; "isSignal": true; }; "zMaxTagCount": { "alias": "zMaxTagCount"; "required": false; "isSignal": true; }; "zDropdownMaxHeight": { "alias": "zDropdownMaxHeight"; "required": false; "isSignal": true; }; "zOptionHeight": { "alias": "zOptionHeight"; "required": false; "isSignal": true; }; "zVirtualScroll": { "alias": "zVirtualScroll"; "required": false; "isSignal": true; }; "zShowAction": { "alias": "zShowAction"; "required": false; "isSignal": true; }; "zOptions": { "alias": "zOptions"; "required": false; "isSignal": true; }; "zConfig": { "alias": "zConfig"; "required": false; "isSignal": true; }; "zTranslateLabels": { "alias": "zTranslateLabels"; "required": false; "isSignal": true; }; "zKey": { "alias": "zKey"; "required": false; "isSignal": true; }; "zSearchServer": { "alias": "zSearchServer"; "required": false; "isSignal": true; }; "zLoadingMore": { "alias": "zLoadingMore"; "required": false; "isSignal": true; }; "zEnableLoadMore": { "alias": "zEnableLoadMore"; "required": false; "isSignal": true; }; "zScrollDistance": { "alias": "zScrollDistance"; "required": false; "isSignal": true; }; "zMaxVisible": { "alias": "zMaxVisible"; "required": false; "isSignal": true; }; "zScrollClose": { "alias": "zScrollClose"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zSelectedTemplate": { "alias": "zSelectedTemplate"; "required": false; "isSignal": true; }; "zOptionTemplate": { "alias": "zOptionTemplate"; "required": false; "isSignal": true; }; "zActionTemplate": { "alias": "zActionTemplate"; "required": false; "isSignal": true; }; "zAsyncValidators": { "alias": "zAsyncValidators"; "required": false; "isSignal": true; }; "zAsyncDebounce": { "alias": "zAsyncDebounce"; "required": false; "isSignal": true; }; "zAsyncValidateOn": { "alias": "zAsyncValidateOn"; "required": false; "isSignal": true; }; "zValidators": { "alias": "zValidators"; "required": false; "isSignal": true; }; }, { "zOnSearch": "zOnSearch"; "zOnLoadMore": "zOnLoadMore"; "zOnBlur": "zOnBlur"; "zOnFocus": "zOnFocus"; "zControl": "zControl"; "zEvent": "zEvent"; }, ["customSelectedDirective", "customOptionDirective"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZSelectComponent<any>, "z-select", ["zSelect"], { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zMode": { "alias": "zMode"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zLabel": { "alias": "zLabel"; "required": false; "isSignal": true; }; "zLabelClass": { "alias": "zLabelClass"; "required": false; "isSignal": true; }; "zPlaceholder": { "alias": "zPlaceholder"; "required": false; "isSignal": true; }; "zRequired": { "alias": "zRequired"; "required": false; "isSignal": true; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zReadonly": { "alias": "zReadonly"; "required": false; "isSignal": true; }; "zLoading": { "alias": "zLoading"; "required": false; "isSignal": true; }; "zPrefix": { "alias": "zPrefix"; "required": false; "isSignal": true; }; "zAllowClear": { "alias": "zAllowClear"; "required": false; "isSignal": true; }; "zWrap": { "alias": "zWrap"; "required": false; "isSignal": true; }; "zShowSearch": { "alias": "zShowSearch"; "required": false; "isSignal": true; }; "zPlaceholderSearch": { "alias": "zPlaceholderSearch"; "required": false; "isSignal": true; }; "zDebounce": { "alias": "zDebounce"; "required": false; "isSignal": true; }; "zNotFoundText": { "alias": "zNotFoundText"; "required": false; "isSignal": true; }; "zEmptyText": { "alias": "zEmptyText"; "required": false; "isSignal": true; }; "zEmptyIcon": { "alias": "zEmptyIcon"; "required": false; "isSignal": true; }; "zMaxTagCount": { "alias": "zMaxTagCount"; "required": false; "isSignal": true; }; "zDropdownMaxHeight": { "alias": "zDropdownMaxHeight"; "required": false; "isSignal": true; }; "zOptionHeight": { "alias": "zOptionHeight"; "required": false; "isSignal": true; }; "zVirtualScroll": { "alias": "zVirtualScroll"; "required": false; "isSignal": true; }; "zShowAction": { "alias": "zShowAction"; "required": false; "isSignal": true; }; "zOptions": { "alias": "zOptions"; "required": false; "isSignal": true; }; "zConfig": { "alias": "zConfig"; "required": false; "isSignal": true; }; "zTranslateLabels": { "alias": "zTranslateLabels"; "required": false; "isSignal": true; }; "zKey": { "alias": "zKey"; "required": false; "isSignal": true; }; "zSearchServer": { "alias": "zSearchServer"; "required": false; "isSignal": true; }; "zLoadingMore": { "alias": "zLoadingMore"; "required": false; "isSignal": true; }; "zEnableLoadMore": { "alias": "zEnableLoadMore"; "required": false; "isSignal": true; }; "zScrollDistance": { "alias": "zScrollDistance"; "required": false; "isSignal": true; }; "zMaxVisible": { "alias": "zMaxVisible"; "required": false; "isSignal": true; }; "zScrollClose": { "alias": "zScrollClose"; "required": false; "isSignal": true; }; "zSticky": { "alias": "zSticky"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zSelectedTemplate": { "alias": "zSelectedTemplate"; "required": false; "isSignal": true; }; "zOptionTemplate": { "alias": "zOptionTemplate"; "required": false; "isSignal": true; }; "zActionTemplate": { "alias": "zActionTemplate"; "required": false; "isSignal": true; }; "zAsyncValidators": { "alias": "zAsyncValidators"; "required": false; "isSignal": true; }; "zAsyncDebounce": { "alias": "zAsyncDebounce"; "required": false; "isSignal": true; }; "zAsyncValidateOn": { "alias": "zAsyncValidateOn"; "required": false; "isSignal": true; }; "zValidators": { "alias": "zValidators"; "required": false; "isSignal": true; }; }, { "zOnSearch": "zOnSearch"; "zOnLoadMore": "zOnLoadMore"; "zOnBlur": "zOnBlur"; "zOnFocus": "zOnFocus"; "zControl": "zControl"; "zEvent": "zEvent"; }, ["customSelectedDirective", "customOptionDirective"], never, true, never>;
 }
 
 declare class ZIsSelectedPipe implements PipeTransform {
-    transform<T>(option: ZSelectOption<T>, value: T | T[] | null, isMultipleMode: boolean): boolean;
+    transform<T>(option: ZSelectOption<T>, value: T | T[] | null, isMultipleMode: boolean, zKey?: string): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZIsSelectedPipe, never>;
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<ZIsSelectedPipe, "zIsSelected", true>;
 }
@@ -316,7 +322,7 @@ declare class ZTagClassesPipe implements PipeTransform {
 
 declare const zSelectVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "disabled" | "readonly" | "open" | "error" | null | undefined;
+    zStatus?: "default" | "error" | "disabled" | "readonly" | "open" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zSelectTagVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;

package/types/shival99-z-ui-components-z-table.d.ts

@@ -1263,7 +1263,7 @@ declare class ZTableFilterComponent<T> {
     protected readonly sortOptions: _angular_core.Signal<ZSelectOption<string>[]>;
     protected readonly draftFilters: _angular_core.WritableSignal<ZTableDraftFilterCondition[]>;
     protected readonly draftLegacyFilterValue: _angular_core.WritableSignal<unknown>;
-    protected readonly draftSortState: _angular_core.WritableSignal<false | "asc" | "desc">;
+    protected readonly draftSortState: _angular_core.WritableSignal<false | "desc" | "asc">;
     protected readonly columnFilterValue: _angular_core.Signal<unknown>;
     protected readonly effectiveFilterValue: _angular_core.Signal<unknown>;
     protected readonly sortState: _angular_core.Signal<false | _tanstack_angular_table.SortDirection>;
@@ -1285,7 +1285,7 @@ declare class ZTableFilterComponent<T> {
     protected readonly filterBadgeCount: _angular_core.Signal<number>;
     protected readonly hasFilterValue: _angular_core.Signal<boolean>;
     protected readonly isActive: _angular_core.Signal<boolean>;
-    protected readonly draftSortValue: _angular_core.Signal<"asc" | "desc" | "none">;
+    protected readonly draftSortValue: _angular_core.Signal<"none" | "desc" | "asc">;
     protected readonly rangeMinValue: _angular_core.Signal<any>;
     protected readonly rangeMaxValue: _angular_core.Signal<any>;
     protected readonly dateValue: _angular_core.Signal<Date | null>;
@@ -1353,7 +1353,7 @@ declare class ZTableActionsComponent<T = unknown> {
     readonly zConfig: _angular_core.InputSignal<ZTableActionColumnConfig<T>>;
     readonly zRow: _angular_core.InputSignal<T>;
     readonly zRowId: _angular_core.InputSignal<string>;
-    readonly zDropdownButtonSize: _angular_core.InputSignal<"default" | "sm" | "lg" | "xs" | "xl" | null | undefined>;
+    readonly zDropdownButtonSize: _angular_core.InputSignal<"sm" | "default" | "lg" | "xs" | "xl" | null | undefined>;
     readonly zActionClick: _angular_core.OutputEmitterRef<ZTableActionClickEvent<T>>;
     protected readonly allActions: _angular_core.Signal<ZTableActionItem<T>[]>;
     protected readonly shouldShowAsButtons: _angular_core.Signal<boolean>;

package/types/shival99-z-ui-components-z-upload.d.ts

@@ -100,7 +100,7 @@ declare class ZUploadComponent implements OnInit, ControlValueAccessor {
     protected readonly hasError: _angular_core.Signal<boolean>;
     protected readonly showError: _angular_core.Signal<boolean>;
     protected readonly errorMessage: _angular_core.Signal<string>;
-    protected readonly currentStatus: _angular_core.Signal<"default" | "disabled" | "readonly" | "error" | "active">;
+    protected readonly currentStatus: _angular_core.Signal<"default" | "error" | "disabled" | "readonly" | "active">;
     protected readonly dropzoneClasses: _angular_core.Signal<string>;
     protected readonly acceptTypes: _angular_core.Signal<string>;
     protected readonly formatFileSize: (bytes: number) => string;
@@ -141,11 +141,11 @@ declare class ZUploadComponent implements OnInit, ControlValueAccessor {
 
 declare const zUploadDropzoneVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "disabled" | "readonly" | "error" | "active" | null | undefined;
+    zStatus?: "default" | "error" | "active" | "disabled" | "readonly" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZUploadDropzoneVariants = VariantProps<typeof zUploadDropzoneVariants>;
 declare const zUploadFileItemVariants: (props?: ({
-    zStatus?: "error" | "pending" | "uploading" | "success" | null | undefined;
+    zStatus?: "pending" | "uploading" | "success" | "error" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZUploadFileItemVariants = VariantProps<typeof zUploadFileItemVariants>;
 

package/types/shival99-z-ui-utils.d.ts

@@ -82,6 +82,7 @@ declare const zMiniSearch$: <T>(data: T[], query: string, fields: (keyof T | str
     fakeDelay?: number;
 }) => Observable<T[]>;
 declare const zDetectBrowser: () => ZBrowserInfo;
+declare const zIsMobileViewport: (maxWidth?: number) => boolean;
 
 /** Thông tin truy vấn dùng cho autocomplete/select tự tải dữ liệu. */
 interface ZAsyncOptionsQuery {
@@ -113,6 +114,8 @@ interface ZAsyncOptionsConfig<TOption> {
     pageSize?: number;
     /** Tự tải trang đầu khi dropdown mở/focus, kể cả keyword rỗng. */
     loadOnFocus?: boolean;
+    /** Các option đang được chọn cần giữ lại để hiển thị nhãn dù không nằm trong trang async hiện tại. */
+    selectedOptions?: TOption[] | (() => TOption[]);
     /** Khóa chống trùng khi append trang mới, ví dụ: option => option.value.code. */
     dedupeBy?: (option: TOption) => unknown;
 }
@@ -123,6 +126,8 @@ declare const Z_ASYNC_OPTIONS_DEFAULT_PAGE_SIZE = 20;
 declare function zToAsyncOptionsObservable<TOption>(result: ZAsyncOptionsLoadResult<TOption>): Observable<ZAsyncOptionsResult<TOption>>;
 /** Gộp option mới vào danh sách cũ và loại bỏ phần tử trùng theo dedupeBy/default key. */
 declare function zMergeAsyncOptions<TOption>(current: TOption[], next: TOption[], dedupeBy?: ZAsyncOptionsConfig<TOption>['dedupeBy']): TOption[];
+/** Lấy option đang chọn từ config, hỗ trợ truyền mảng tĩnh hoặc signal/computed. */
+declare function zResolveAsyncSelectedOptions<TOption>(config: ZAsyncOptionsConfig<TOption> | undefined): TOption[];
 /** Tính còn dữ liệu để load-more dựa trên hasMore, total hoặc độ dài page vừa trả về. */
 declare function zResolveAsyncOptionsHasMore<TOption>(result: ZAsyncOptionsResult<TOption>, pageSize: number, loadedCount: number): boolean;
 /** Lấy khóa ổn định cho option, hỗ trợ value là object và vẫn cho phép truyền dedupeBy riêng. */
@@ -213,5 +218,5 @@ interface ZFormDebugOptions {
     logLevel?: 'error' | 'warn' | 'log';
 }
 
-export { VIETNAMESE_MAP, Z_ASYNC_OPTIONS_DEFAULT_PAGE_SIZE, Z_DIVIDE_SCALE, Z_EMOJI_KEYWORDS, Z_EMOJI_SHEET, Z_EXCEL_NUMBER_FORMAT_MAP, Z_LOCALE_MAP, zCapitalCase, zCleanObject, zConvertColorToArgb, zCreateEvent, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zFormatNum, zFormatNumExcel, zGetAsyncOptionKey, zMergeAsyncOptions, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zNormalize, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zResolveAsyncOptionsHasMore, zToAsyncOptionsObservable, zTransform, zTreeBuild, zTreeFlatten, zUuid, zValidForm };
+export { VIETNAMESE_MAP, Z_ASYNC_OPTIONS_DEFAULT_PAGE_SIZE, Z_DIVIDE_SCALE, Z_EMOJI_KEYWORDS, Z_EMOJI_SHEET, Z_EXCEL_NUMBER_FORMAT_MAP, Z_LOCALE_MAP, zCapitalCase, zCleanObject, zConvertColorToArgb, zCreateEvent, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zFormatNum, zFormatNumExcel, zGetAsyncOptionKey, zIsMobileViewport, zMergeAsyncOptions, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zNormalize, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zResolveAsyncOptionsHasMore, zResolveAsyncSelectedOptions, zToAsyncOptionsObservable, zTransform, zTreeBuild, zTreeFlatten, zUuid, zValidForm };
 export type { ZAsyncOptionsConfig, ZAsyncOptionsLoadFn, ZAsyncOptionsLoadResult, ZAsyncOptionsQuery, ZAsyncOptionsResult, ZBlurEventData, ZBrowserInfo, ZBrowserName, ZCapitalizeType, ZChangeEventData, ZClickEventData, ZCopyEventData, ZCutEventData, ZDblclickEventData, ZDeviceType, ZDragenterEventData, ZDragleaveEventData, ZDragoverEventData, ZDropEventData, ZEchartsThemeOptions, ZEmojiCategory, ZEmojiEntry, ZEmptyCheck, ZEvent, ZEventType, ZFocusEventData, ZFormDebugOptions, ZFormSubmitResult, ZFormatNumExcelOptions, ZFormatNumOptions, ZInputEventData, ZKeydownEventData, ZKeypressEventData, ZKeyupEventData, ZMousedownEventData, ZMouseenterEventData, ZMouseleaveEventData, ZMouseoutEventData, ZMouseoverEventData, ZMouseupEventData, ZNavigatorUABrandVersion, ZNavigatorUAData, ZNumberDivide, ZPasteEventData, ZTouchendEventData, ZTouchmoveEventData, ZTouchstartEventData };