@shival99/z-ui 2.1.30 → 2.1.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shival99/z-ui",
-  "version": "2.1.30",
+  "version": "2.1.32",
   "description": "Z-UI: Modern Angular UI Component Library - A comprehensive, high-performance design system built with Angular 21, featuring 40+ customizable components with dark mode, accessibility, and enterprise-ready features.",
   "keywords": [
     "angular",

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

@@ -119,7 +119,9 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
     readonly zVirtualScroll: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zDynamicSize: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zOptionHeight: _angular_core.InputSignal<number>;
-    readonly zHeightExpand: _angular_core.InputSignal<number>;
+    readonly zDropdownMaxHeight: _angular_core.InputSignal<number | null>;
+    /** @deprecated Dùng zDropdownMaxHeight để đồng nhất với z-select. */
+    readonly zHeightExpand: _angular_core.InputSignal<number | null>;
     readonly zMaxVisible: _angular_core.InputSignal<number | null>;
     readonly zResetOnSelect: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly zEmptyText: _angular_core.InputSignal<string>;
@@ -271,7 +273,7 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
     private _emitControl;
     private _getOptionKey;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZAutocompleteComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZAutocompleteComponent<any>, "z-autocomplete", ["zAutocomplete"], { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zOptions": { "alias": "zOptions"; "required": false; "isSignal": true; }; "zConfig": { "alias": "zConfig"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zType": { "alias": "zType"; "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; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zReadonly": { "alias": "zReadonly"; "required": false; "isSignal": true; }; "zLoading": { "alias": "zLoading"; "required": false; "isSignal": true; }; "zLoadingOutline": { "alias": "zLoadingOutline"; "required": false; "isSignal": true; }; "zRequired": { "alias": "zRequired"; "required": false; "isSignal": true; }; "zPrefix": { "alias": "zPrefix"; "required": false; "isSignal": true; }; "zSuffix": { "alias": "zSuffix"; "required": false; "isSignal": true; }; "zAllowClear": { "alias": "zAllowClear"; "required": false; "isSignal": true; }; "zVirtualScroll": { "alias": "zVirtualScroll"; "required": false; "isSignal": true; }; "zDynamicSize": { "alias": "zDynamicSize"; "required": false; "isSignal": true; }; "zOptionHeight": { "alias": "zOptionHeight"; "required": false; "isSignal": true; }; "zHeightExpand": { "alias": "zHeightExpand"; "required": false; "isSignal": true; }; "zMaxVisible": { "alias": "zMaxVisible"; "required": false; "isSignal": true; }; "zResetOnSelect": { "alias": "zResetOnSelect"; "required": false; "isSignal": true; }; "zEmptyText": { "alias": "zEmptyText"; "required": false; "isSignal": true; }; "zEmptyIcon": { "alias": "zEmptyIcon"; "required": false; "isSignal": true; }; "zNoDataText": { "alias": "zNoDataText"; "required": false; "isSignal": true; }; "zNoDataIcon": { "alias": "zNoDataIcon"; "required": false; "isSignal": true; }; "zAllowCustomValue": { "alias": "zAllowCustomValue"; "required": false; "isSignal": true; }; "zDebounceTime": { "alias": "zDebounceTime"; "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; }; "zKey": { "alias": "zKey"; "required": false; "isSignal": true; }; "zOptionTemplate": { "alias": "zOptionTemplate"; "required": false; "isSignal": true; }; }, { "zOnSearch": "zOnSearch"; "zOnLoadMore": "zOnLoadMore"; "zOnSelect": "zOnSelect"; "zOnEnter": "zOnEnter"; "zOnCommit": "zOnCommit"; "zValueChange": "zValueChange"; "zOnBlur": "zOnBlur"; "zOnFocus": "zOnFocus"; "zControl": "zControl"; "zEvent": "zEvent"; }, ["customOptionDirective"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZAutocompleteComponent<any>, "z-autocomplete", ["zAutocomplete"], { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zOptions": { "alias": "zOptions"; "required": false; "isSignal": true; }; "zConfig": { "alias": "zConfig"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zType": { "alias": "zType"; "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; }; "zDisabled": { "alias": "zDisabled"; "required": false; "isSignal": true; }; "zReadonly": { "alias": "zReadonly"; "required": false; "isSignal": true; }; "zLoading": { "alias": "zLoading"; "required": false; "isSignal": true; }; "zLoadingOutline": { "alias": "zLoadingOutline"; "required": false; "isSignal": true; }; "zRequired": { "alias": "zRequired"; "required": false; "isSignal": true; }; "zPrefix": { "alias": "zPrefix"; "required": false; "isSignal": true; }; "zSuffix": { "alias": "zSuffix"; "required": false; "isSignal": true; }; "zAllowClear": { "alias": "zAllowClear"; "required": false; "isSignal": true; }; "zVirtualScroll": { "alias": "zVirtualScroll"; "required": false; "isSignal": true; }; "zDynamicSize": { "alias": "zDynamicSize"; "required": false; "isSignal": true; }; "zOptionHeight": { "alias": "zOptionHeight"; "required": false; "isSignal": true; }; "zDropdownMaxHeight": { "alias": "zDropdownMaxHeight"; "required": false; "isSignal": true; }; "zHeightExpand": { "alias": "zHeightExpand"; "required": false; "isSignal": true; }; "zMaxVisible": { "alias": "zMaxVisible"; "required": false; "isSignal": true; }; "zResetOnSelect": { "alias": "zResetOnSelect"; "required": false; "isSignal": true; }; "zEmptyText": { "alias": "zEmptyText"; "required": false; "isSignal": true; }; "zEmptyIcon": { "alias": "zEmptyIcon"; "required": false; "isSignal": true; }; "zNoDataText": { "alias": "zNoDataText"; "required": false; "isSignal": true; }; "zNoDataIcon": { "alias": "zNoDataIcon"; "required": false; "isSignal": true; }; "zAllowCustomValue": { "alias": "zAllowCustomValue"; "required": false; "isSignal": true; }; "zDebounceTime": { "alias": "zDebounceTime"; "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; }; "zKey": { "alias": "zKey"; "required": false; "isSignal": true; }; "zOptionTemplate": { "alias": "zOptionTemplate"; "required": false; "isSignal": true; }; }, { "zOnSearch": "zOnSearch"; "zOnLoadMore": "zOnLoadMore"; "zOnSelect": "zOnSelect"; "zOnEnter": "zOnEnter"; "zOnCommit": "zOnCommit"; "zValueChange": "zValueChange"; "zOnBlur": "zOnBlur"; "zOnFocus": "zOnFocus"; "zControl": "zControl"; "zEvent": "zEvent"; }, ["customOptionDirective"], never, true, never>;
 }
 
 declare const zAutocompleteInputVariants: (props?: ({

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

@@ -1,12 +1,12 @@
 import * as i0 from '@angular/core';
-import { Signal, InjectionToken } from '@angular/core';
+import { Type, TemplateRef, ViewContainerRef, EventEmitter, ComponentRef, Signal, InjectionToken } from '@angular/core';
+import { PositionStrategy, ScrollStrategy, OverlayConfig, OverlayRef } from '@angular/cdk/overlay';
 import { ZFormatNumExcelOptions } from '@shival99/z-ui/utils';
 import { HttpHeaders, HttpContext, HttpParams, HttpClient } from '@angular/common/http';
 import { Router } from '@angular/router';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
 import { TranslationObject, TranslateService } from '@ngx-translate/core';
-import { OverlayRef } from '@angular/cdk/overlay';
 
 interface ZCacheEntry<T = unknown> {
     data: T;
@@ -43,6 +43,107 @@ declare class ZCacheService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZCacheService>;
 }
 
+/** Content accepted by the dynamic overlay service. */
+type ZDynamicContent<T> = Type<T> | TemplateRef<T>;
+/** Template context supplied to a dynamic template. */
+interface ZDynamicTemplateContext<TData, TResult> {
+    /** Dynamic ref exposed as the implicit template value. */
+    $implicit: ZDynamicRef<unknown, TResult>;
+    /** Dynamic ref used to close or update the overlay from the template. */
+    dynamicRef: ZDynamicRef<unknown, TResult>;
+    /** Data passed to `open`. */
+    data: TData | undefined;
+}
+/** Options for opening a free-form CDK dynamic overlay. */
+interface ZDynamicOptions<TData = unknown> {
+    /** Data injected into a component or exposed in a template context. */
+    data?: TData;
+    /** View container used as the logical parent of the attached portal. */
+    viewContainerRef?: ViewContainerRef;
+    /** 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;
+    /** 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'];
+}
+/** Result type emitted when a dynamic overlay closes. */
+type ZDynamicResult<TResult> = TResult | undefined;
+
+/**
+ * Controls one free-form dynamic overlay instance.
+ *
+ * @template T Component instance type, when the overlay contains a component.
+ * @template TResult Value emitted after the overlay closes.
+ */
+declare class ZDynamicRef<T = unknown, TResult = unknown> {
+    private readonly _overlayRef;
+    private readonly _platformId;
+    private readonly _destroy$;
+    private _isClosing;
+    private _componentRef;
+    /** Component instance attached to the overlay, or `null` for template content. */
+    componentInstance: T | null;
+    /** Emits the close result once, then completes. */
+    readonly afterClose: EventEmitter<ZDynamicResult<TResult>>;
+    constructor(_overlayRef: OverlayRef | undefined, _platformId: object);
+    private _closeOnBackdropClick;
+    private _closeOnEscape;
+    /** Configures close triggers for the instance. */
+    setCloseBehavior(closeOnBackdropClick: boolean, closeOnEscape: boolean): void;
+    /** Returns whether this ref has already been closed. */
+    isClosed(): boolean;
+    /** Closes the overlay and emits the optional result exactly once. */
+    close(result?: TResult): void;
+    /** Updates the overlay position using its configured strategy. */
+    updatePosition(): void;
+    /** Updates the overlay pane dimensions. */
+    updateSize(width?: string, height?: string): void;
+    /** @internal Used by the service after attaching a component portal. */
+    attachComponentRef(componentRef: ComponentRef<T>): void;
+}
+
+/**
+ * Opens components and templates in a bare CDK overlay.
+ *
+ * @description The service supplies overlay lifecycle and positioning only. The
+ * mounted content owns its complete layout, including close controls and styling.
+ */
+declare class ZDynamicService {
+    private readonly _overlay;
+    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. */
+    open<T, TData = unknown, TResult = unknown>(content: ZDynamicContent<T>, options?: ZDynamicOptions<TData>): ZDynamicRef<T, TResult>;
+    private _createOverlay;
+    private _isTemplate;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZDynamicService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ZDynamicService>;
+}
+
 type ZExcelAlign = 'left' | 'center' | 'right';
 interface ZExcelTableColumnConfig<T = unknown> {
     id: string;
@@ -589,6 +690,9 @@ declare function zBuildScopedCacheKey(baseKey: string): string;
 declare function zBuildScopedDbName(baseDbName: string): string;
 declare function zStripScopedCacheKey(key: string): string;
 
+/** Injection token for data passed to a dynamic component or template. */
+declare const Z_DYNAMIC_DATA: InjectionToken<unknown>;
+
 declare const Z_EXCEL_COLORS: {
     readonly 'green-50': "FFF0FDF4";
     readonly 'green-100': "FFDCFCE7";
@@ -667,5 +771,5 @@ interface ZTranslateI18nConfig {
 }
 declare const Z_LANG_CACHE_KEY = "Z_LANGUAGE";
 
-export { ZCacheService, ZExcelService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_DEFAULT_THEME, 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 type { ZCacheConfig, ZCacheEntry, 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 };
+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 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 };