@shival99/z-ui 2.0.49 → 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.

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

@@ -140,6 +140,9 @@ interface ZGalleryPreviewOptions {
 type ZGalleryPreviewItemOptions = Omit<ZGalleryPreviewOptions, 'file' | 'files'>;
 
 declare class ZGalleryComponent implements AfterViewInit {
+    private readonly _destroyRef;
+    private readonly _previewService;
+    private _previewRef;
     readonly zFiles: _angular_core.InputSignal<ZGalleryFile[]>;
     readonly zMode: _angular_core.ModelSignal<ZGalleryMode>;
     readonly zSize: _angular_core.InputSignal<ZGallerySize>;
@@ -174,7 +177,6 @@ declare class ZGalleryComponent implements AfterViewInit {
     readonly zSelectionChange: _angular_core.OutputEmitterRef<ZGallerySelectionChange>;
     readonly zOnAction: _angular_core.OutputEmitterRef<ZGalleryActionEvent>;
     protected readonly modeIndex: _angular_core.WritableSignal<number | null>;
-    protected readonly previewFile: _angular_core.WritableSignal<ZGalleryFile | null>;
     protected readonly searchInputQuery: _angular_core.WritableSignal<string>;
     protected readonly searchQuery: _angular_core.WritableSignal<string>;
     protected readonly skeletonItems: _angular_core.Signal<number[]>;
@@ -198,8 +200,8 @@ declare class ZGalleryComponent implements AfterViewInit {
     protected onPreview(file: ZGalleryFile): void;
     protected onRemove(file: ZGalleryFile): void;
     protected closePreview(): void;
-    protected onNavigatePreview(file: ZGalleryFile): void;
     protected onRemoveFromPreview(file: ZGalleryFile): void;
+    private _openPreview;
     protected isFileSelected(file: ZGalleryFile): boolean;
     protected toggleSelection(file: ZGalleryFile): void;
     protected selectAll(): void;

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

@@ -251,7 +251,7 @@ declare class ZModalComponent<T, U> extends BasePortalOutlet implements OnDestro
     protected readonly effectiveOkText: _angular_core.Signal<string | null | undefined>;
     protected readonly effectiveCancelText: _angular_core.Signal<string | null | undefined>;
     protected readonly effectiveOkDestructive: _angular_core.Signal<boolean | undefined>;
-    protected readonly effectiveTypeOk: _angular_core.Signal<"info" | "warning" | "error" | "link" | "default" | "primary" | "secondary" | "destructive" | "destructive-heartbeat" | "success" | "outline" | "outline-primary" | "outline-secondary" | "outline-success" | "outline-info" | "outline-warning" | "outline-error" | "outline-destructive" | "outline-shimmer" | "outline-success-secondary" | "outline-info-secondary" | "outline-warning-secondary" | "outline-error-secondary" | "outline-destructive-secondary" | "outline-primary-secondary" | "outline-primary-soft" | "outline-success-soft" | "outline-info-soft" | "outline-warning-soft" | "outline-error-soft" | "outline-destructive-soft" | "outline-primary-soft-border" | "outline-success-soft-border" | "outline-info-soft-border" | "outline-warning-soft-border" | "outline-error-soft-border" | "outline-destructive-soft-border" | "ghost" | "ghost-primary" | "ghost-success" | "ghost-info" | "ghost-warning" | "ghost-error" | "ghost-destructive" | "subtle" | "subtle-primary" | "subtle-success" | "subtle-info" | "subtle-warning" | "subtle-destructive" | "subtle-outline" | "subtle-primary-outline" | "subtle-success-outline" | "subtle-info-outline" | "subtle-warning-outline" | "subtle-destructive-outline" | null | undefined>;
+    protected readonly effectiveTypeOk: _angular_core.Signal<"info" | "warning" | "error" | "default" | "primary" | "secondary" | "destructive" | "destructive-heartbeat" | "success" | "outline" | "outline-primary" | "outline-secondary" | "outline-success" | "outline-info" | "outline-warning" | "outline-error" | "outline-destructive" | "outline-shimmer" | "outline-success-secondary" | "outline-info-secondary" | "outline-warning-secondary" | "outline-error-secondary" | "outline-destructive-secondary" | "outline-primary-secondary" | "outline-primary-soft" | "outline-success-soft" | "outline-info-soft" | "outline-warning-soft" | "outline-error-soft" | "outline-destructive-soft" | "outline-primary-soft-border" | "outline-success-soft-border" | "outline-info-soft-border" | "outline-warning-soft-border" | "outline-error-soft-border" | "outline-destructive-soft-border" | "ghost" | "ghost-primary" | "ghost-success" | "ghost-info" | "ghost-warning" | "ghost-error" | "ghost-destructive" | "subtle" | "subtle-primary" | "subtle-success" | "subtle-info" | "subtle-warning" | "subtle-destructive" | "subtle-outline" | "subtle-primary-outline" | "subtle-success-outline" | "subtle-info-outline" | "subtle-warning-outline" | "subtle-destructive-outline" | "link" | null | undefined>;
     protected readonly effectiveOkDisabled: _angular_core.Signal<boolean | undefined>;
     protected readonly effectiveLoading: _angular_core.Signal<boolean>;
     protected readonly effectiveContentLoading: _angular_core.Signal<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>;
 }

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 | "desc" | "asc">;
+    protected readonly draftSortState: _angular_core.WritableSignal<false | "asc" | "desc">;
     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<"none" | "desc" | "asc">;
+    protected readonly draftSortValue: _angular_core.Signal<"asc" | "desc" | "none">;
     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<"sm" | "default" | "lg" | "xs" | "xl" | null | undefined>;
+    readonly zDropdownButtonSize: _angular_core.InputSignal<"default" | "sm" | "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-services.d.ts

@@ -492,7 +492,7 @@ declare class ZOverlayZIndexService {
      * Kept for backward compatibility with existing overlay flow.
      */
     next(): number;
-    applyToOverlay(_overlayRef: OverlayRef): number;
+    applyToOverlay(overlayRef: OverlayRef): number;
     deferMoveToTop(overlayRef: OverlayRef): void;
     moveToTop(overlayRef: OverlayRef): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ZOverlayZIndexService, never>;

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 };