@sdcorejs/angular 21.0.10 → 21.1.0

package/types/sdcorejs-angular-forms-datetime.d.ts

@@ -10,13 +10,12 @@ declare class SdDatetime implements OnDestroy, OnInit {
     #private;
     id: string;
     inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    private readonly dateTimePicker;
     sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
     sdValueTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
     sdViewDef: _angular_core.Signal<SdViewDefDirective<any, any> | undefined>;
     private ref;
-    private overlay;
     private elementRef;
-    private injector;
     private formConfig;
     autoIdInput: _angular_core.InputSignal<string | null | undefined>;
     autoId: _angular_core.Signal<string | undefined>;
@@ -72,8 +71,8 @@ declare class SdDatetime implements OnDestroy, OnInit {
     formControl: SdFormControl;
     isFocused: boolean;
     isValid?: boolean;
-    /** State popup — true khi đang mở. */
-    pickerOpened: _angular_core.WritableSignal<boolean>;
+    /** State popup — true khi picker package đang mở. */
+    pickerOpened: _angular_core.Signal<boolean>;
     constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -81,6 +80,7 @@ declare class SdDatetime implements OnDestroy, OnInit {
     open(): void;
     /** Đóng popup (public — gọi từ template nếu cần). */
     close(): void;
+    onPickerConfirm(value: Date): void;
     onFocus: () => void;
     onBlur: () => void;
     onClick: () => void;

package/types/sdcorejs-angular-modules-icon.d.ts

@@ -0,0 +1,191 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+import { Size } from '@sdcorejs/utils/models';
+import { SdIconSet, SdMaterialIconSet } from '@sdcorejs/angular/utilities/models';
+export { SdIconSet, SdMaterialIconSet } from '@sdcorejs/angular/utilities/models';
+import { LucideConfig, LucideIcon, LucideIconData } from '@lucide/angular';
+
+/** @deprecated Use `SdIconSet` instead. */
+type SdIconFontSet = SdIconSet;
+/**
+ * Một icon Lucide có thể đăng ký bằng class icon Angular hoặc dữ liệu path thuần.
+ */
+type SdLucideIconRegistration = LucideIcon | LucideIconData;
+/**
+ * Danh sách đăng ký Lucide cho provider, hỗ trợ cả array và object map để app có thể giữ cấu trúc import riêng.
+ */
+type SdLucideIconRegistrations = SdLucideIconRegistration[] | Record<string, SdLucideIconRegistration>;
+/**
+ * Cấu hình app-level cho `SdIcon`.
+ *
+ * Các alias tách riêng theo renderer để app có thể giữ tên Material trong template trong lúc chuyển dần sang Lucide.
+ */
+interface ISdIconConfiguration {
+    /** Default icon font set when component does not pass `fontSet`. */
+    defaultFontSet?: SdIconSet;
+    /** Alias áp dụng khi renderer hiện tại là Material. */
+    materialAliases?: Record<string, string>;
+    /** Alias áp dụng khi renderer hiện tại là Lucide. */
+    lucideAliases?: Record<string, string>;
+    /** Cấu hình stroke toàn cục cho Lucide SVG. */
+    lucideConfig?: Partial<LucideConfig>;
+    /** Icon Lucide cần đăng ký vào `@lucide/angular`. */
+    lucideIcons?: SdLucideIconRegistrations;
+}
+/**
+ * Cấu hình đã resolve đầy đủ để component không phải tự xử lý fallback nhiều lần.
+ */
+interface ISdIconResolvedConfiguration extends Required<Omit<ISdIconConfiguration, 'lucideIcons'>> {
+}
+/**
+ * Quy đổi token `Size` chung của SDCoreJS sang pixel cho icon.
+ */
+declare const SD_ICON_SIZE_MAP: Record<Size, number>;
+/**
+ * Alias mặc định giúp template giữ tên Material trong khi renderer có thể là Lucide.
+ */
+declare const SD_DEFAULT_LUCIDE_ALIASES: Record<string, string>;
+/**
+ * Alias mac dinh giup template dung ten Lucide van render duoc khi quay ve Material font.
+ */
+declare const SD_DEFAULT_MATERIAL_ALIASES: Record<string, string>;
+/**
+ * Cấu hình mặc định của Core UI icon.
+ *
+ * `material-icons-outlined` được giữ làm mặc định để không đổi visual của các component Material hiện có.
+ */
+declare const SD_ICON_DEFAULT_CONFIG: ISdIconResolvedConfiguration;
+
+/**
+ * Facade icon dùng chung cho Core UI.
+ *
+ * Component này giữ template app theo tên icon ổn định, còn renderer có thể đổi giữa Material font và Lucide SVG qua provider hoặc input.
+ */
+declare class SdIcon {
+    private readonly config;
+    /**
+     * Tên icon theo namespace hiện tại.
+     *
+     * Khi `set` là `lucide`, tên này sẽ đi qua alias để app có thể tiếp tục dùng tên Material trong template.
+     */
+    name: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
+    fontIcon: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
+    color: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
+    /**
+     * Renderer icon của riêng instance này.
+     *
+     * Deprecated alias for `fontSet`.
+     */
+    set: _angular_core.InputSignalWithTransform<SdIconSet | undefined, SdIconSet | null | undefined>;
+    /**
+     * Escape hatch cho Material icon font set.
+     *
+     * Prefer this input for both Material font families and Lucide SVG icons.
+     */
+    fontSet: _angular_core.InputSignalWithTransform<SdIconSet | undefined, SdIconSet | null | undefined>;
+    /**
+     * Kích thước icon theo token SDCoreJS hoặc CSS size tùy biến.
+     *
+     * Token `sm | md | lg` giữ icon đồng bộ với các component Core UI; CSS string xử lý các ngoại lệ layout.
+     */
+    size: _angular_core.InputSignalWithTransform<Size | (string & {}), Size | (string & {}) | null | undefined>;
+    /**
+     * Độ dày stroke riêng cho Lucide SVG.
+     *
+     * Bỏ trống để nhận giá trị từ `lucideConfig` app-level.
+     */
+    strokeWidth: _angular_core.InputSignalWithTransform<string | number | undefined, string | number | null | undefined>;
+    /**
+     * Giữ stroke width tuyệt đối cho Lucide khi SVG đổi kích thước.
+     *
+     * Input này đi qua `booleanAttribute` để hỗ trợ cả attribute trần trong template.
+     */
+    absoluteStrokeWidth: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /**
+     * Nhãn truy cập cho icon có ý nghĩa.
+     *
+     * Khi không có nhãn, component tự đánh dấu decorative bằng `aria-hidden`.
+     */
+    ariaLabel: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
+    /**
+     * Set icon cuối cùng sau khi áp dụng input và provider.
+     *
+     * @returns renderer hiện tại của component.
+     */
+    resolvedFontSet: _angular_core.Signal<SdIconSet>;
+    /** @deprecated Use `resolvedFontSet` instead. */
+    resolvedSet: _angular_core.Signal<SdIconSet>;
+    /**
+     * Tên icon cuối cùng theo renderer hiện tại.
+     *
+     * @returns tên icon đã áp alias nếu renderer yêu cầu.
+     */
+    resolvedName: _angular_core.Signal<string | undefined>;
+    /**
+     * Font set Material cuối cùng.
+     *
+     * @returns font set dùng cho `mat-icon`; với Lucide trả về fallback Material để computed luôn có type ổn định.
+     */
+    resolvedMaterialFontSet: _angular_core.Signal<SdMaterialIconSet>;
+    /**
+     * Kích thước runtime cho renderer hiện tại.
+     *
+     * @returns số pixel cho token chuẩn hoặc CSS string nguyên bản cho custom size.
+     */
+    resolvedSize: _angular_core.Signal<string | number>;
+    /**
+     * Kích thước CSS cuối cùng cho host element.
+     *
+     * @returns CSS length dùng cho custom property `--sd-icon-size`.
+     */
+    resolvedCssSize: _angular_core.Signal<string>;
+    /**
+     * Stroke width cuối cùng cho Lucide SVG.
+     *
+     * @returns giá trị input instance hoặc fallback từ provider.
+     */
+    resolvedStrokeWidth: _angular_core.Signal<string | number | undefined>;
+    /**
+     * Absolute stroke width cuối cùng cho Lucide SVG.
+     *
+     * @returns giá trị input instance hoặc fallback từ provider.
+     */
+    resolvedAbsoluteStrokeWidth: _angular_core.Signal<boolean | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdIcon, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdIcon, "sd-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "fontIcon": { "alias": "fontIcon"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "set": { "alias": "set"; "required": false; "isSignal": true; }; "fontSet": { "alias": "fontSet"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "absoluteStrokeWidth": { "alias": "absoluteStrokeWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Injection token chứa cấu hình icon đã resolve cho toàn bộ app.
+ *
+ * Token có factory mặc định để `SdIcon` vẫn chạy khi app chưa gọi `provideSdIcon`.
+ */
+declare const SD_ICON_CONFIGURATION: InjectionToken<ISdIconResolvedConfiguration>;
+/**
+ * Đăng ký cấu hình icon Core UI ở app-level.
+ *
+ * Provider này gom cả cấu hình `SdIcon` và registry của `@lucide/angular` để consumer chỉ cần gọi một hàm.
+ *
+ * @param config - cấu hình app-level cho Material/Lucide icon.
+ * @returns environment providers dùng được trong `ApplicationConfig.providers`.
+ */
+declare function provideSdIcon(config?: ISdIconConfiguration): EnvironmentProviders;
+/**
+ * Resolve cấu hình `SdIcon` thành object đầy đủ, không còn field optional.
+ *
+ * Alias mặc định đứng trước để app có thể override từng key mà không phải copy toàn bộ bảng alias.
+ *
+ * @param config - cấu hình rời rạc từ consumer hoặc mặc định rỗng.
+ * @returns cấu hình đầy đủ dùng trực tiếp trong component.
+ */
+declare function resolveSdIconConfig(config?: ISdIconConfiguration): ISdIconResolvedConfiguration;
+/**
+ * Chuẩn hóa nhiều kiểu khai báo Lucide icon về array cho `provideLucideIcons`.
+ *
+ * @param registrations - array hoặc object map icon Lucide từ consumer.
+ * @returns danh sách icon Lucide đã sẵn sàng để spread vào provider của Lucide.
+ */
+declare function normalizeSdLucideIcons(registrations?: SdLucideIconRegistrations): SdLucideIconRegistration[];
+
+export { SD_DEFAULT_LUCIDE_ALIASES, SD_DEFAULT_MATERIAL_ALIASES, SD_ICON_CONFIGURATION, SD_ICON_DEFAULT_CONFIG, SD_ICON_SIZE_MAP, SdIcon, normalizeSdLucideIcons, provideSdIcon, resolveSdIconConfig };
+export type { ISdIconConfiguration, ISdIconResolvedConfiguration, SdIconFontSet, SdLucideIconRegistration, SdLucideIconRegistrations };

package/types/sdcorejs-angular-modules.d.ts

@@ -3,3 +3,4 @@ export * from '@sdcorejs/angular/modules/permission';
 export * from '@sdcorejs/angular/modules/auth';
 export * from '@sdcorejs/angular/modules/layout';
 export * from '@sdcorejs/angular/modules/authom';
+export * from '@sdcorejs/angular/modules/icon';

package/types/sdcorejs-angular-services-confirm.d.ts

@@ -24,6 +24,14 @@ interface DialogData {
         min?: string | Date;
         max?: string | Date;
     };
+    datetime?: {
+        required?: boolean;
+        placeholder?: string;
+        defaultValue?: string | Date;
+        min?: string | Date;
+        max?: string | Date;
+        showSeconds?: boolean;
+    };
     radio?: {
         required?: boolean;
         defaultValue?: string | number;
@@ -32,6 +40,15 @@ interface DialogData {
         displayField: string;
         display?: 'row' | 'column';
     };
+    select?: {
+        required?: boolean;
+        defaultValue?: string | number | (string | number)[];
+        items: any[];
+        valueField: string;
+        displayField: string;
+        placeholder?: string;
+        multiple?: boolean;
+    };
 }
 declare class DialogConfirmComponent {
     value: any;
@@ -84,6 +101,21 @@ declare class SdConfirmService {
         display?: "row" | "column";
         disableBackdropClose?: boolean;
     }) => Promise<string>;
+    withSelect: (message?: string, option?: {
+        title?: string;
+        yesTitle?: string;
+        noTitle?: string;
+        required?: boolean;
+        yesButtonColor?: Color;
+        noButtonColor?: Color;
+        defaultValue?: string | number | (string | number)[];
+        items: any[];
+        valueField: string;
+        displayField: string;
+        placeholder?: string;
+        multiple?: boolean;
+        disableBackdropClose?: boolean;
+    }) => Promise<string | number | (string | number)[]>;
     withDate: (message?: string, option?: {
         title?: string;
         yesTitle?: string;
@@ -93,8 +125,24 @@ declare class SdConfirmService {
         noButtonColor?: Color;
         defaultValue?: string | Date;
         placeholder?: string;
+        min?: string | Date;
+        max?: string | Date;
         disableBackdropClose?: boolean;
-    }) => Promise<string>;
+    }) => Promise<string | Date>;
+    withDatetime: (message?: string, option?: {
+        title?: string;
+        yesTitle?: string;
+        noTitle?: string;
+        required?: boolean;
+        yesButtonColor?: Color;
+        noButtonColor?: Color;
+        defaultValue?: string | Date;
+        placeholder?: string;
+        min?: string | Date;
+        max?: string | Date;
+        showSeconds?: boolean;
+        disableBackdropClose?: boolean;
+    }) => Promise<string | Date>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdConfirmService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdConfirmService>;
 }

package/types/sdcorejs-angular-utilities-models.d.ts

@@ -10,8 +10,10 @@ type SdColor = Color;
 /** @deprecated Use {@link Size} from `@sdcorejs/utils/models` instead */
 type SdSize = Size;
 
-type MaterialIconFontSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp';
-declare const DefaultMaterialIconFontSet: MaterialIconFontSet;
+type SdIconSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp' | 'lucide';
+type SdMaterialIconSet = Exclude<SdIconSet, 'lucide'>;
+declare const DefaultSdIconSet: SdIconSet;
+declare const DefaultSdMaterialIconSet: SdMaterialIconSet;
 
 /**
  * @deprecated Use {@link ValidationPatternType} from `@sdcorejs/utils/models` instead.
@@ -83,5 +85,5 @@ type SdPagingReq<T = any> = PagingReq<T>;
 /** @deprecated Use {@link PagingRes} from `@sdcorejs/utils/models` instead */
 type SdPagingRes<T = any> = PagingRes<T>;
 
-export { DefaultMaterialIconFontSet, SD_EMPTY_STR, SdNormalizeAsync, SdOperators, SdPatternCommons, SdResolveMaybeAsync };
-export type { MaterialIconFontSet, SdColor, SdFilter, SdFilterAndOr, SdFilterBetween, SdFilterHasData, SdFilterNoData, SdMaybeAsync, SdNestedKeyOf, SdOperator, SdOperatorHasData, SdOperatorNoData, SdOrder, SdPagingReq, SdPagingRes, SdPatternCommon, SdPatternType, SdQueryReq, SdSize, SdUnwrapSafe, SdUnwrapSignal };
+export { DefaultSdIconSet, DefaultSdMaterialIconSet, SD_EMPTY_STR, SdNormalizeAsync, SdOperators, SdPatternCommons, SdResolveMaybeAsync };
+export type { SdColor, SdFilter, SdFilterAndOr, SdFilterBetween, SdFilterHasData, SdFilterNoData, SdIconSet, SdMaterialIconSet, SdMaybeAsync, SdNestedKeyOf, SdOperator, SdOperatorHasData, SdOperatorNoData, SdOrder, SdPagingReq, SdPagingRes, SdPatternCommon, SdPatternType, SdQueryReq, SdSize, SdUnwrapSafe, SdUnwrapSignal };