@shival99/z-ui 2.0.50 → 2.0.51

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" | "open" | "error" | "disabled" | "readonly" | 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-calendar.d.ts

@@ -429,16 +429,16 @@ declare class ZCalendarComponent implements OnInit, ControlValueAccessor {
 
 declare const zCalendarVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "disabled" | "readonly" | "open" | "error" | null | undefined;
+    zStatus?: "default" | "disabled" | "open" | "error" | "readonly" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zCalendarDayVariants: (props?: ({
-    state?: "default" | "disabled" | "today" | "selected" | "inRange" | "rangeStart" | "rangeEnd" | "rangeSingle" | "otherMonth" | "hovered" | null | undefined;
+    state?: "default" | "today" | "selected" | "inRange" | "rangeStart" | "rangeEnd" | "rangeSingle" | "disabled" | "otherMonth" | "hovered" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zCalendarMonthVariants: (props?: ({
-    state?: "default" | "current" | "disabled" | "selected" | null | undefined;
+    state?: "default" | "selected" | "disabled" | "current" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zCalendarYearVariants: (props?: ({
-    state?: "default" | "current" | "disabled" | "selected" | null | undefined;
+    state?: "default" | "selected" | "disabled" | "current" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 
 export { ZCalendarComponent, zCalendarDayVariants, zCalendarMonthVariants, zCalendarVariants, zCalendarYearVariants };

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

@@ -328,7 +328,7 @@ declare const Z_EDITOR_DEFAULT_TOOLBAR: readonly ZEditorToolbarItem[];
 
 declare const zEditorVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "disabled" | "readonly" | "error" | null | undefined;
+    zStatus?: "default" | "error" | "disabled" | "readonly" | null | undefined;
     zPlaceholderMode?: "firstLine" | "everyLine" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZEditorVariants = VariantProps<typeof zEditorVariants>;

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

@@ -89,7 +89,7 @@ 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>;

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>;
 }
@@ -187,12 +185,15 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     }>;
     protected readonly selectId: string;
     protected readonly dropdownId: string;
+    protected readonly actualPosition: _angular_core.WritableSignal<ZPopoverPosition>;
+    protected readonly isPositionTop: _angular_core.Signal<boolean>;
     protected readonly searchText: _angular_core.WritableSignal<string>;
     protected readonly dropdownWidth: _angular_core.WritableSignal<number>;
     protected readonly currentValue: _angular_core.Signal<T | T[] | null>;
     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 +210,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 +219,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>;
@@ -266,6 +269,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected onPopoverShow(): void;
     protected onPopoverHideStart(): void;
     protected onPopoverHideEnd(): void;
+    protected onPositionChange(position: ZPopoverPosition): void;
     protected onSearchChange(value: string): void;
     protected checkScrollShadow(): void;
     protected selectOption(option: ZSelectOption<T>, closeFn?: () => void): void;
@@ -275,6 +279,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;
@@ -297,7 +304,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
 }
 
 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 +323,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" | "open" | "error" | "disabled" | "readonly" | 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-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

@@ -113,6 +113,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 +125,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 +217,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, 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 };