@shival99/z-ui 2.2.5 → 2.3.0

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" | "error" | "disabled" | "readonly" | "active">;
+    protected readonly currentStatus: _angular_core.Signal<"default" | "disabled" | "readonly" | "error" | "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" | "error" | "active" | "disabled" | "readonly" | null | undefined;
+    zStatus?: "default" | "disabled" | "readonly" | "error" | "active" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZUploadDropzoneVariants = VariantProps<typeof zUploadDropzoneVariants>;
 declare const zUploadFileItemVariants: (props?: ({
-    zStatus?: "pending" | "uploading" | "success" | "error" | null | undefined;
+    zStatus?: "error" | "pending" | "uploading" | "success" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZUploadFileItemVariants = VariantProps<typeof zUploadFileItemVariants>;
 

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

@@ -18,7 +18,8 @@ declare const Z_CACHE_CONFIG: InjectionToken<ZCacheConfig>;
  * export const appConfig: ApplicationConfig = {
  *   providers: [
  *     provideZCache({
- *       prefix: 'myapp_',
+ *       appName: 'my-app',
+ *       prefix: 'custom_',
  *       encrypt: false, // Disable encryption for debugging
  *     }),
  *   ],
@@ -39,6 +40,7 @@ declare const Z_INDEXDB_SERVICE: InjectionToken<ZIndexDbService>;
  * export const appConfig: ApplicationConfig = {
  *   providers: [
  *     provideZIndexDb({
+ *       appName: 'my-app',
  *       dbName: 'MyApp',
  *       version: 1,
  *       stores: [

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

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
 import { Type, TemplateRef, ViewContainerRef, EventEmitter, ComponentRef, Signal, InjectionToken } from '@angular/core';
-import { PositionStrategy, ScrollStrategy, OverlayConfig, OverlayRef } from '@angular/cdk/overlay';
+import { ZOverlayRef } from '@shival99/z-ui/components/z-overlay';
 import { ZFormatNumExcelOptions } from '@shival99/z-ui/utils';
 import { HttpHeaders, HttpContext, HttpParams, HttpClient } from '@angular/common/http';
 import { Router } from '@angular/router';
@@ -14,6 +14,7 @@ interface ZCacheEntry<T = unknown> {
     ttl: number;
 }
 interface ZCacheConfig {
+    appName?: string;
     prefix?: string;
     encrypt?: boolean;
 }
@@ -27,8 +28,9 @@ declare class ZCacheService {
     private static _normalizeLegacyKey;
     private static _normalizeKey;
     private static _toStorageKey;
+    private static _toLegacyStorageKey;
     private static _getFullKey;
-    private static _getLegacyFullKey;
+    private static _getLegacyFullKeys;
     private static _getCandidateStorageKeys;
     private static _decodeStorageKey;
     private static _isManagedStorageKey;
@@ -54,7 +56,7 @@ interface ZDynamicTemplateContext<TData, TResult> {
     /** Data passed to `open`. */
     data: TData | undefined;
 }
-/** Options for opening a free-form CDK dynamic overlay. */
+/** Options for opening a free-form global dynamic overlay. */
 interface ZDynamicOptions<TData = unknown> {
     /** Data injected into a component or exposed in a template context. */
     data?: TData;
@@ -63,29 +65,27 @@ interface ZDynamicOptions<TData = unknown> {
     /** Whether the overlay renders a backdrop. Defaults to `true`. */
     hasBackdrop?: boolean;
     /** CSS class or classes applied to the backdrop. */
-    backdropClass?: string | string[];
-    /** CSS class or classes applied to the overlay pane. */
-    panelClass?: string | string[];
-    /** Custom position strategy. Defaults to a global overlay strategy. */
-    positionStrategy?: PositionStrategy;
-    /** Custom scroll strategy. Defaults to the CDK block strategy. */
-    scrollStrategy?: ScrollStrategy;
+    backdropClass?: string;
+    /** CSS class or classes applied to the overlay host. */
+    panelClass?: string;
+    /** Locks page scroll while the overlay is open. Defaults to `true`. */
+    scrollLock?: boolean;
     /** Close when the backdrop is clicked. Defaults to `true`. */
     closeOnBackdropClick?: boolean;
     /** Close when Escape is pressed. Defaults to `true`. */
     closeOnEscape?: boolean;
-    /** Initial pane width passed to CDK. */
-    width?: OverlayConfig['width'];
-    /** Initial pane height passed to CDK. */
-    height?: OverlayConfig['height'];
-    /** Minimum pane width passed to CDK. */
-    minWidth?: OverlayConfig['minWidth'];
-    /** Maximum pane width passed to CDK. */
-    maxWidth?: OverlayConfig['maxWidth'];
-    /** Minimum pane height passed to CDK. */
-    minHeight?: OverlayConfig['minHeight'];
-    /** Maximum pane height passed to CDK. */
-    maxHeight?: OverlayConfig['maxHeight'];
+    /** Initial pane width. */
+    width?: string | number;
+    /** Initial pane height. */
+    height?: string | number;
+    /** Minimum pane width. */
+    minWidth?: string | number;
+    /** Maximum pane width. */
+    maxWidth?: string | number;
+    /** Minimum pane height. */
+    minHeight?: string | number;
+    /** Maximum pane height. */
+    maxHeight?: string | number;
 }
 /** Result type emitted when a dynamic overlay closes. */
 type ZDynamicResult<TResult> = TResult | undefined;
@@ -106,7 +106,7 @@ declare class ZDynamicRef<T = unknown, TResult = unknown> {
     componentInstance: T | null;
     /** Emits the close result once, then completes. */
     readonly afterClose: EventEmitter<ZDynamicResult<TResult>>;
-    constructor(_overlayRef: OverlayRef | undefined, _platformId: object);
+    constructor(_overlayRef: ZOverlayRef | undefined, _platformId: object);
     private _closeOnBackdropClick;
     private _closeOnEscape;
     /** Configures close triggers for the instance. */
@@ -115,7 +115,11 @@ declare class ZDynamicRef<T = unknown, TResult = unknown> {
     isClosed(): boolean;
     /** Closes the overlay and emits the optional result exactly once. */
     close(result?: TResult): void;
-    /** Updates the overlay position using its configured strategy. */
+    /**
+     * @deprecated Không còn tác dụng — overlay tự do giờ luôn dùng vị trí toàn cục (global),
+     * tự canh giữa bằng CSS, không còn "chiến lược định vị" nào cần cập nhật lại. Giữ lại method
+     * rỗng để không phá vỡ code đang gọi nó.
+     */
     updatePosition(): void;
     /** Updates the overlay pane dimensions. */
     updateSize(width?: string, height?: string): void;
@@ -124,19 +128,19 @@ declare class ZDynamicRef<T = unknown, TResult = unknown> {
 }
 
 /**
- * Opens components and templates in a bare CDK overlay.
+ * Opens components and templates in a bare global overlay (no anchored positioning).
  *
- * @description The service supplies overlay lifecycle and positioning only. The
- * mounted content owns its complete layout, including close controls and styling.
+ * @description The service supplies overlay lifecycle only. The mounted content owns its
+ * complete layout, including close controls and styling.
  */
 declare class ZDynamicService {
-    private readonly _overlay;
+    private readonly _overlayService;
     private readonly _injector;
     private readonly _platformId;
     private readonly _zIndexService;
     /** Alias for `open`, matching the create-style API used by modal and drawer services. */
     create<T, TData = unknown, TResult = unknown>(content: ZDynamicContent<T>, options?: ZDynamicOptions<TData>): ZDynamicRef<T, TResult>;
-    /** Opens a component or template in a free-form CDK overlay. */
+    /** Opens a component or template in a free-form global overlay. */
     open<T, TData = unknown, TResult = unknown>(content: ZDynamicContent<T>, options?: ZDynamicOptions<TData>): ZDynamicRef<T, TResult>;
     private _createOverlay;
     private _isTemplate;
@@ -390,6 +394,7 @@ interface ZIndexDbStoreConfig {
     protectedKeys?: string[];
 }
 interface ZIndexDbConfig {
+    appName?: string;
     dbName?: string;
     version?: number;
     mode?: IDBTransactionMode;
@@ -411,6 +416,7 @@ interface ZIndexDbSetOptions {
 declare class ZIndexDbService {
     private _db;
     private _dbName;
+    private _appName;
     private _legacyDbName;
     private _version;
     private _mode;
@@ -430,7 +436,6 @@ declare class ZIndexDbService {
     private _shouldEncrypt;
     private _normalizeLegacyKey;
     private _normalizeKey;
-    private _resolveLegacyNormalizedKey;
     private _buildStorageKeys;
     private _encryptData;
     private _decryptData;
@@ -446,6 +451,7 @@ declare class ZIndexDbService {
     private _resetDatabase;
     private _getMissingStores;
     private _ensureStoreExists;
+    private _getDbOrThrow;
     get<T>(key: string, options?: ZIndexDbGetOptions<T>): Promise<T | undefined>;
     set<T>(key: string, value: T, options?: ZIndexDbSetOptions): Promise<void>;
     /**
@@ -578,6 +584,16 @@ declare class ZOverlayContainerService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZOverlayContainerService>;
 }
 
+/**
+ * Bề mặt tối thiểu mà dịch vụ này cần — khớp cấu trúc với cả CDK `OverlayRef`
+ * (z-command, z-gallery-preview, z-dynamic.service vẫn dùng CDK) lẫn `ZOverlayRef`
+ * mới (tooltip/popover/modal/drawer), không cần import type từ nơi nào trong hai bên.
+ */
+interface ZOverlayZIndexTarget {
+    readonly hostElement: HTMLElement;
+    readonly backdropElement?: HTMLElement | null;
+}
+
 /**
  * Global z-index counter for overlay components (z-modal, z-drawer, etc.).
  *
@@ -593,9 +609,18 @@ declare class ZOverlayZIndexService {
      * Kept for backward compatibility with existing overlay flow.
      */
     next(): number;
-    applyToOverlay(overlayRef: OverlayRef): number;
-    deferMoveToTop(overlayRef: OverlayRef): void;
-    moveToTop(overlayRef: OverlayRef): void;
+    applyToOverlay(overlayRef: ZOverlayZIndexTarget): number;
+    /**
+     * @deprecated Thừa với overlay đã dùng native Popover API (`[popover]` + `showPopover()`):
+     * top layer đã tự xếp overlay hiện gần nhất lên trên cùng, hide+show lại chỉ là restack thủ
+     * công cho hành vi mà trình duyệt đã làm sẵn. CDK 22 cũng mặc định `usePopover: true` nên
+     * z-command/z-gallery-preview cũng đang gọi thừa. Chỉ còn có ý nghĩa làm fallback DOM-reorder
+     * (nhánh `else` trong `moveToTop`) cho trình duyệt KHÔNG hỗ trợ Popover API (Chrome <114,
+     * Firefox <125, Safari <17). Xoá khi dự án xác nhận không còn cần hỗ trợ nhóm trình duyệt đó.
+     */
+    deferMoveToTop(overlayRef: ZOverlayZIndexTarget): void;
+    /** @deprecated Xem ghi chú tại {@link deferMoveToTop}. */
+    moveToTop(overlayRef: ZOverlayZIndexTarget): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ZOverlayZIndexService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ZOverlayZIndexService>;
 }
@@ -686,9 +711,20 @@ declare class ZThemeService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZThemeService>;
 }
 
-declare function zBuildScopedCacheKey(baseKey: string): string;
-declare function zBuildScopedDbName(baseDbName: string): string;
-declare function zStripScopedCacheKey(key: string): string;
+declare const Z_CACHE_SCOPE_SEPARATOR = "-";
+declare const Z_DB_SCOPE_SEPARATOR = "__";
+declare const Z_STORAGE_SCOPE_FALLBACK = "global";
+declare const Z_CACHE_DEFAULT_PREFIX = "z_";
+
+declare function zNormalizeStorageAppName(appName?: string): string;
+declare function zConfigureStorageAppName(appName?: string): void;
+declare function zGetStorageAppName(): string | undefined;
+declare function zBuildScopedCacheKey(baseKey: string, appName?: string | undefined): string;
+declare function zBuildScopedDbName(baseDbName: string, appName?: string | undefined): string;
+declare function zStripScopedCacheKey(key: string, appName?: string | undefined): string;
+declare function zBuildLegacyScopedCacheKey(baseKey: string): string;
+declare function zBuildLegacyScopedDbName(baseDbName: string): string;
+declare function zStripLegacyScopedCacheKey(key: string): string;
 
 /** Injection token for data passed to a dynamic component or template. */
 declare const Z_DYNAMIC_DATA: InjectionToken<unknown>;
@@ -771,5 +807,5 @@ interface ZTranslateI18nConfig {
 }
 declare const Z_LANG_CACHE_KEY = "Z_LANGUAGE";
 
-export { ZCacheService, ZDynamicRef, ZDynamicService, ZExcelService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_DEFAULT_THEME, Z_DYNAMIC_DATA, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_LANG_TO_LOCALE, Z_THEME_CONFIG, Z_THEME_CSS_MAP, Z_THEME_PREFERENCES_CACHE_KEY, zBuildScopedCacheKey, zBuildScopedDbName, zStripScopedCacheKey };
+export { ZCacheService, ZDynamicRef, ZDynamicService, ZExcelService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_CACHE_DEFAULT_PREFIX, Z_CACHE_SCOPE_SEPARATOR, Z_DB_SCOPE_SEPARATOR, Z_DEFAULT_THEME, Z_DYNAMIC_DATA, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_LANG_TO_LOCALE, Z_STORAGE_SCOPE_FALLBACK, Z_THEME_CONFIG, Z_THEME_CSS_MAP, Z_THEME_PREFERENCES_CACHE_KEY, zBuildLegacyScopedCacheKey, zBuildLegacyScopedDbName, zBuildScopedCacheKey, zBuildScopedDbName, zConfigureStorageAppName, zGetStorageAppName, zNormalizeStorageAppName, zStripLegacyScopedCacheKey, zStripScopedCacheKey };
 export type { ZCacheConfig, ZCacheEntry, ZDynamicContent, ZDynamicOptions, ZDynamicResult, ZDynamicTemplateContext, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbGetOptions, ZIndexDbSetOptions, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZThemePreferences, ZTranslateConfig, ZTranslateI18nConfig };