@sdcorejs/angular 19.0.10 → 19.0.11

package/modules/icon/src/icon.component.d.ts

@@ -0,0 +1,101 @@
+import { type Size } from '@sdcorejs/utils/models';
+import { type SdIconSet, type SdMaterialIconSet } from './icon.model';
+import * as i0 from "@angular/core";
+/**
+ * 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.
+ */
+export 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: import("@angular/core").InputSignalWithTransform<string | undefined, string | null | undefined>;
+    fontIcon: import("@angular/core").InputSignalWithTransform<string | undefined, string | null | undefined>;
+    color: import("@angular/core").InputSignalWithTransform<string | undefined, string | null | undefined>;
+    /**
+     * Renderer icon của riêng instance này.
+     *
+     * Deprecated alias for `fontSet`.
+     */
+    set: import("@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: import("@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: import("@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: import("@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: import("@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: import("@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: import("@angular/core").Signal<SdIconSet>;
+    /** @deprecated Use `resolvedFontSet` instead. */
+    resolvedSet: import("@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: import("@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: import("@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: import("@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: import("@angular/core").Signal<string>;
+    /**
+     * Stroke width cuối cùng cho Lucide SVG.
+     *
+     * @returns giá trị input instance hoặc fallback từ provider.
+     */
+    resolvedStrokeWidth: import("@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: import("@angular/core").Signal<boolean | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdIcon, never>;
+    static ɵcmp: i0.ɵɵ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>;
+}

package/modules/icon/src/icon.model.d.ts

@@ -0,0 +1,59 @@
+import { type LucideConfig, type LucideIcon, type LucideIconData } from '@lucide/angular';
+import { type Size } from '@sdcorejs/utils/models';
+import { type SdIconSet, type SdMaterialIconSet } from '@sdcorejs/angular/utilities/models';
+/**
+ * Chọn renderer icon chính cho `SdIcon`.
+ *
+ * Material dùng đúng tên font set để tránh thêm mapping nội bộ; `lucide` chuyển sang renderer SVG của `@lucide/angular`.
+ */
+export type { SdIconSet, SdMaterialIconSet };
+/** @deprecated Use `SdIconSet` instead. */
+export type SdIconFontSet = SdIconSet;
+/**
+ * Một icon Lucide có thể đăng ký bằng class icon Angular hoặc dữ liệu path thuần.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export interface ISdIconResolvedConfiguration extends Required<Omit<ISdIconConfiguration, 'lucideIcons'>> {
+}
+/**
+ * Quy đổi token `Size` chung của SDCoreJS sang pixel cho icon.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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ó.
+ */
+export declare const SD_ICON_DEFAULT_CONFIG: ISdIconResolvedConfiguration;

package/modules/icon/src/icon.provider.d.ts

@@ -0,0 +1,33 @@
+import { InjectionToken, type EnvironmentProviders } from '@angular/core';
+import { type ISdIconConfiguration, type ISdIconResolvedConfiguration, type SdLucideIconRegistration, type SdLucideIconRegistrations } from './icon.model';
+/**
+ * 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`.
+ */
+export 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`.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function normalizeSdLucideIcons(registrations?: SdLucideIconRegistrations): SdLucideIconRegistration[];

package/modules/icon/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './icon.component';
+export * from './icon.model';
+export * from './icon.provider';

package/modules/index.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "19.0.10",
+  "version": "19.0.11",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",
@@ -10,6 +10,7 @@
   },
   "dependencies": {
     "@sdcorejs/utils": "1.1.4",
+    "@lucide/angular": "^1.22.0",
     "@ckeditor/ckeditor5-angular": "11.1.2",
     "@omer-go/docx-parser-converter-ts": "^1.0.0",
     "@bjorn3/browser_wasi_shim": "^0.4.2",
@@ -45,14 +46,14 @@
       "types": "./directives/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-directives.mjs"
     },
-    "./forms": {
-      "types": "./forms/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-forms.mjs"
-    },
     "./handlers": {
       "types": "./handlers/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-handlers.mjs"
     },
+    "./forms": {
+      "types": "./forms/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms.mjs"
+    },
     "./i18n": {
       "types": "./i18n/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-i18n.mjs"
@@ -297,6 +298,10 @@
       "types": "./modules/authom/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-modules-authom.mjs"
     },
+    "./modules/icon": {
+      "types": "./modules/icon/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-modules-icon.mjs"
+    },
     "./modules/keycloak": {
       "types": "./modules/keycloak/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-modules-keycloak.mjs"

package/services/excel/src/lib/spreadsheet-formula-injection.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Prefix spreadsheet formula-like strings so exported files treat them as text.
+ */
+export declare function neutralizeSpreadsheetFormula(value: string): string;
+export declare function neutralizeSpreadsheetFormula<T>(value: T): T;

package/utilities/models/src/icon.model.d.ts

@@ -1,2 +1,4 @@
-export type MaterialIconFontSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp';
-export declare const DefaultMaterialIconFontSet: MaterialIconFontSet;
+export type SdIconSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp' | 'lucide';
+export type SdMaterialIconSet = Exclude<SdIconSet, 'lucide'>;
+export declare const DefaultSdIconSet: SdIconSet;
+export declare const DefaultSdMaterialIconSet: SdMaterialIconSet;