@sdcorejs/angular 19.0.0 → 20.0.0-rc.2

package/components/history/index.d.ts

@@ -1 +1,23 @@
-export * from './src/history.component';
+import { Color } from '@sdcorejs/utils/models';
+import * as i0 from '@angular/core';
+
+interface SdHistoryItemType {
+    title: string;
+    status?: {
+        title?: string;
+        color?: Color;
+        icon?: string;
+    };
+    date?: string;
+    actor?: string;
+    source?: string;
+    description?: string;
+}
+
+declare class SdHistoryItem {
+    items: SdHistoryItemType[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdHistoryItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdHistoryItem, "sd-history", never, { "items": { "alias": "items"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { SdHistoryItem };

package/components/import-excel/index.d.ts

@@ -1,2 +1,160 @@
-export * from './src/import-excel.model';
-export * from './src/import-excel.component';
+import * as i0 from '@angular/core';
+import { PipeTransform, OnInit, OnDestroy, EventEmitter, ChangeDetectorRef } from '@angular/core';
+import { MatPaginator } from '@angular/material/paginator';
+import { SdModal } from '@sdcorejs/angular/components/modal';
+import { SdExcelService } from '@sdcorejs/angular/services/excel';
+import { SdNotifyService } from '@sdcorejs/angular/services/notify';
+import { SdLoadingService } from '@sdcorejs/angular/services/loading';
+
+interface SdImportExcelValidation {
+    idx: number;
+    errorMessage?: string;
+    warningMessage?: string;
+}
+interface SdImportExcelSheet<T = any> {
+    name: string;
+    items: T[] | (() => Promise<T[]>);
+    headers: {
+        value: Extract<keyof T, string>;
+        display: string;
+    }[];
+}
+interface SdImportExcelOption<T = any> {
+    columns: SdUploadExcelColumn<T>[];
+    accept: (items: T[], args: {
+        file: File;
+    }) => SdImportExcelValidation[] | Promise<SdImportExcelValidation[]>;
+    title?: string;
+    fileName?: string;
+    limit?: number;
+    sheets?: SdImportExcelSheet[];
+    transform?: (items: SdImportExcelItem<T>[]) => SdImportExcelItem<T>[] | Promise<SdImportExcelItem<T>[]>;
+    validateItem?: (item: T, idx: number, items: T[]) => SdImportExcelValidation | Promise<SdImportExcelValidation>;
+    validateItems?: (items: T[]) => SdImportExcelValidation[] | Promise<SdImportExcelValidation[]>;
+}
+type SdUploadExcelColumn<T = any> = SdUploadExcelColumnString<T> | SdUploadExcelColumnNumber<T> | SdUploadExcelColumnBool<T> | SdUploadExcelColumnDate<T> | SdUploadExcelColumnTime<T> | SdUploadExcelColumnDateTime<T> | SdUploadExcelColumnValues<T> | SdUploadExcelColumnStringArray<T>;
+interface SdUploadExcelBaseColumn<T = any> {
+    field: string;
+    title: string;
+    required?: boolean;
+    width?: string;
+    description?: string;
+    hidden?: boolean | (() => boolean);
+    fontColor?: string;
+    fill?: string;
+    transform?: (value: any, rowData: T) => string | Promise<string>;
+}
+interface SdUploadExcelColumnString<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'string';
+    defaultValue?: string;
+    pattern?: string;
+    minlength?: number;
+    maxlength?: number;
+}
+interface SdUploadExcelColumnNumber<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'number';
+    defaultValue?: number;
+    min?: number;
+    max?: number;
+}
+interface SdUploadExcelColumnBool<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'bool';
+    defaultValue?: boolean;
+    parseToBool?: boolean;
+}
+interface SdUploadExcelColumnDate<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'date';
+    format?: 'dd/MM/yyyy';
+    defaultValue?: Date;
+    minDate?: Date;
+    maxDate?: Date;
+}
+interface SdUploadExcelColumnTime<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'time';
+    format?: 'HH:mm' | 'HH:mm:ss';
+    defaultValue?: Date;
+    minDate?: Date;
+    maxDate?: Date;
+}
+interface SdUploadExcelColumnDateTime<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'datetime';
+    format?: 'dd/MM/yyyy HH:mm' | 'dd/MM/yyyy';
+    defaultValue?: Date;
+    minDate?: Date;
+    maxDate?: Date;
+}
+interface SdUploadExcelColumnValues<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'values' | 'radio';
+    defaultValue?: string | number;
+    values: (string | number)[];
+    checkValueInArray?: boolean;
+}
+interface SdUploadExcelColumnStringArray<T = any> extends SdUploadExcelBaseColumn<T> {
+    type: 'array';
+    divideString: string | ';';
+    unitString: string | 'items';
+    defaultValue?: string;
+    minlength?: number;
+    maxlength?: number;
+}
+type SdImportExcelItem<T = any> = {
+    data: T;
+    meta: {
+        excelIndex: number;
+        origin: T;
+        error: Record<string, string>;
+        errorMessages: string[];
+        warning: Record<string, string>;
+        warningMessages: string[];
+    };
+};
+
+declare class ColumnHiddenPipe implements PipeTransform {
+    constructor();
+    transform(column: SdUploadExcelColumn): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ColumnHiddenPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ColumnHiddenPipe, "columnHidden", true>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ColumnHiddenPipe>;
+}
+
+declare class SdImportExcel implements OnInit, OnDestroy {
+    #private;
+    private ref;
+    private excelService;
+    private notifyService;
+    private columnHiddenPipe;
+    private loadingService;
+    option: SdImportExcelOption;
+    modal: SdModal;
+    excelItems: SdImportExcelItem[];
+    hasDescription: boolean;
+    showing: 'ALL' | 'SUCCESS' | 'WARNING' | 'ERROR';
+    filteredItems: SdImportExcelItem[];
+    viewItems: SdImportExcelItem[];
+    numberOfSuccess: number;
+    numberOfError: number;
+    numberOfWarning: number;
+    file?: File;
+    set paginator(paginator: MatPaginator);
+    uploading: boolean;
+    isUploaded: boolean;
+    isDownloadTemplate: boolean;
+    sdClosed: EventEmitter<any>;
+    constructor(ref: ChangeDetectorRef, excelService: SdExcelService, notifyService: SdNotifyService, columnHiddenPipe: ColumnHiddenPipe, loadingService: SdLoadingService);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    open: () => void;
+    close: () => void;
+    upload: () => Promise<void>;
+    accept: () => void;
+    setValidation: (validations: SdImportExcelValidation[]) => void;
+    view: (showing?: "ALL" | "SUCCESS" | "WARNING" | "ERROR") => void;
+    downloadTemplate: () => Promise<void>;
+    export: () => Promise<void>;
+    onClosed: () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdImportExcel, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdImportExcel, "sd-import-excel", never, { "option": { "alias": "option"; "required": true; }; }, { "sdClosed": "sdClosed"; }, never, never, true, never>;
+}
+
+export { SdImportExcel };
+export type { SdImportExcelItem, SdImportExcelOption, SdImportExcelSheet, SdImportExcelValidation, SdUploadExcelBaseColumn, SdUploadExcelColumn, SdUploadExcelColumnBool, SdUploadExcelColumnDate, SdUploadExcelColumnDateTime, SdUploadExcelColumnNumber, SdUploadExcelColumnString, SdUploadExcelColumnStringArray, SdUploadExcelColumnTime, SdUploadExcelColumnValues };

package/components/inform/index.d.ts

@@ -1,2 +1,70 @@
-export * from './src/inform.component';
-export * from './src/inform-action.directive';
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { Color } from '@sdcorejs/utils/models';
+import { MaterialIconFontSet } from '@sdcorejs/angular/utilities/models';
+
+/**
+ * Marker cho vùng action custom chiếu vào <sd-inform>.
+ * Khi có phần tử mang [sdInformAction], component ẩn link `actionLabel` mặc định.
+ */
+declare class SdInformActionDirective {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdInformActionDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SdInformActionDirective, "[sdInformAction]", never, {}, {}, never, never, true, never>;
+}
+
+declare class SdInform {
+    #private;
+    color: _angular_core.InputSignalWithTransform<Color, Color | null | undefined>;
+    primary: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    secondary: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    info: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    success: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    warning: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    error: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    title: _angular_core.InputSignal<string | undefined>;
+    description: _angular_core.InputSignal<string | undefined>;
+    icon: _angular_core.InputSignal<string | undefined>;
+    hideIcon: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    fontSet: _angular_core.InputSignalWithTransform<MaterialIconFontSet, MaterialIconFontSet | null | undefined>;
+    closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    actionLabel: _angular_core.InputSignal<string | undefined>;
+    lineClamp: _angular_core.InputSignal<number | undefined>;
+    autoId: _angular_core.InputSignal<string | undefined>;
+    sdClosed: _angular_core.OutputEmitterRef<Event>;
+    sdAction: _angular_core.OutputEmitterRef<Event>;
+    readonly dismissed: _angular_core.WritableSignal<boolean>;
+    readonly expanded: _angular_core.WritableSignal<boolean>;
+    readonly overflowing: _angular_core.WritableSignal<boolean>;
+    protected readonly bodyRef: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly actionSlot: _angular_core.Signal<SdInformActionDirective | undefined>;
+    effectiveColor: _angular_core.Signal<Color>;
+    colorClasses: _angular_core.Signal<{
+        'c-primary': boolean;
+        'c-secondary': boolean;
+        'c-info': boolean;
+        'c-success': boolean;
+        'c-warning': boolean;
+        'c-error': boolean;
+    }>;
+    effectiveIcon: _angular_core.Signal<string | null>;
+    fontSetClasses: _angular_core.Signal<{
+        'material-icons': boolean;
+        'material-icons-outlined': boolean;
+        'material-icons-round': boolean;
+        'material-icons-sharp': boolean;
+    }>;
+    hasActionSlot: _angular_core.Signal<boolean>;
+    clampLines: _angular_core.Signal<number | null>;
+    showToggle: _angular_core.Signal<boolean>;
+    liveRole: _angular_core.Signal<"alert" | "status">;
+    constructor();
+    /** Đo tràn dòng của body; chỉ có ý nghĩa khi đang clamp. */
+    measureOverflow(): void;
+    toggleExpanded(): void;
+    onClose(event: Event): void;
+    onAction(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdInform, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdInform, "sd-inform", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "primary": { "alias": "primary"; "required": false; "isSignal": true; }; "secondary": { "alias": "secondary"; "required": false; "isSignal": true; }; "info": { "alias": "info"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "hideIcon": { "alias": "hideIcon"; "required": false; "isSignal": true; }; "fontSet": { "alias": "fontSet"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "lineClamp": { "alias": "lineClamp"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; "sdAction": "sdAction"; }, ["actionSlot"], ["[sdInformAction]"], true, never>;
+}
+
+export { SdInform, SdInformActionDirective };

package/components/mini-editor/index.d.ts

@@ -1,2 +1,138 @@
-export * from './src/mini-editor.model';
-export * from './src/mini-editor.component';
+import { MentionFeed, MentionFeedObjectItem, EditorConfig, ClassicEditor } from 'ckeditor5';
+export { MentionFeedObjectItem } from 'ckeditor5';
+import * as i0 from '@angular/core';
+import { EventEmitter } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+type SdMiniEditorOutputFormat = 'html' | 'markdown';
+interface SdMiniEditorMentionConfig {
+    /** Feed data cho mention - có thể là array hoặc function trả về Promise
+     * CKEditor MentionFeed đã hỗ trợ: marker, minChars, dropdownLimit, itemRenderer
+     */
+    feeds?: MentionFeed[];
+    /** Custom render function cho giá trị mention khi chèn vào editor
+     * Trả về object với text và các attributes tùy chỉnh
+     */
+    valueRender?: (item: MentionFeedObjectItem) => {
+        text: string;
+        attributes?: Record<string, string>;
+    };
+}
+type SdMiniEditorMentionItem<T = any> = MentionFeedObjectItem & {
+    data?: T;
+};
+interface SdMiniEditorOption {
+    /** Output format: 'html' hoặc 'markdown' (mặc định: 'html') */
+    outputFormat?: SdMiniEditorOutputFormat;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Chiều cao editor (mặc định: auto) */
+    height?: string;
+    /** Chiều cao tối đa của editor (ví dụ: '300px') */
+    maxHeight?: string;
+    /** Bật/tắt mention plugin */
+    enableMention?: boolean;
+    /** Cấu hình mention */
+    mentionConfig?: SdMiniEditorMentionConfig;
+    /** Callback khi nội dung thay đổi */
+    onChange?: (content: string) => void;
+    /** Callback khi blur */
+    onBlur?: (event: FocusEvent) => void;
+    /** Callback khi focus */
+    onFocus?: (event: FocusEvent) => void;
+    /** Callback khi mention được chọn */
+    onMentionSelect?: (item: SdMiniEditorMentionItem) => void;
+}
+type SdMiniEditorConfig = EditorConfig & {
+    getOption?: () => SdMiniEditorOption;
+};
+
+/**
+ * Component sd-mini-editor - Editor đơn giản cho comment input
+ * Sử dụng CKEditor với chế độ đơn giản (bold, italic, link)
+ * Hỗ trợ mention và output format (html/markdown)
+ *
+ * @example
+ * ```html
+ * <sd-mini-editor
+ *   [option]="editorOption"
+ *   [(ngModel)]="content"
+ *   (contentChange)="onContentChange($event)"
+ * >
+ * </sd-mini-editor>
+ * ```
+ */
+declare class SdMiniEditor implements ControlValueAccessor {
+    #private;
+    /** Cấu hình option cho editor */
+    option: SdMiniEditorOption;
+    get maxEditorHeight(): string | undefined;
+    /** NgModel binding - nội dung HTML/Markdown */
+    value: string;
+    valueChange: EventEmitter<string>;
+    /** Event emitter khi content thay đổi */
+    contentChange: EventEmitter<string>;
+    /** Event emitter khi blur */
+    blur: EventEmitter<FocusEvent>;
+    /** Event emitter khi focus */
+    focus: EventEmitter<FocusEvent>;
+    /** Disabled state */
+    disabled: boolean;
+    Editor: typeof ClassicEditor;
+    get editorConfig(): SdMiniEditorConfig;
+    constructor();
+    ngOnDestroy(): void;
+    /**
+     * Xử lý khi editor ready
+     */
+    onReady(editor: ClassicEditor): void;
+    /**
+     * Set nội dung cho editor
+     */
+    setContent(content: string): void;
+    /**
+     * Get nội dung từ editor
+     */
+    getContent(): string;
+    /**
+     * Get nội dung HTML gốc (không convert)
+     */
+    getHtmlContent(): string;
+    /**
+     * Focus vào editor
+     */
+    focusEditor(): void;
+    /**
+     * Insert mention vào vị trí con trỏ hiện tại
+     */
+    insertMention(item: {
+        id: string;
+        name: string;
+        marker?: string;
+    }): void;
+    /**
+     * Get danh sách mentions trong nội dung
+     */
+    getMentions(): Array<{
+        id: string;
+        name: string;
+        marker: string;
+    }>;
+    /**
+     * ControlValueAccessor: Write value
+     */
+    writeValue(value: string): void;
+    /**
+     * ControlValueAccessor: Register change callback
+     */
+    registerOnChange(fn: (value: string) => void): void;
+    /**
+     * ControlValueAccessor: Register touched callback
+     */
+    registerOnTouched(fn: () => void): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdMiniEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdMiniEditor, "sd-mini-editor", never, { "option": { "alias": "option"; "required": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; "contentChange": "contentChange"; "blur": "blur"; "focus": "focus"; }, never, never, true, never>;
+}
+
+export { SdMiniEditor };
+export type { SdMiniEditorConfig, SdMiniEditorMentionConfig, SdMiniEditorMentionItem, SdMiniEditorOption, SdMiniEditorOutputFormat };

package/components/modal/index.d.ts

@@ -1 +1,33 @@
-export * from './src/modal.component';
+import * as _angular_core from '@angular/core';
+import { TemplateRef, ElementRef } from '@angular/core';
+import { Color } from '@sdcorejs/utils/models';
+
+declare class SdModal {
+    #private;
+    static index: _angular_core.WritableSignal<number>;
+    templateRef: _angular_core.Signal<TemplateRef<any>>;
+    modal: _angular_core.Signal<ElementRef<any> | undefined>;
+    readonly autoIdInput: _angular_core.InputSignal<string | null | undefined>;
+    readonly autoId: _angular_core.Signal<string | undefined>;
+    readonly closeButtonAutoId: _angular_core.Signal<string | undefined>;
+    readonly dataOpened: _angular_core.Signal<"true" | "false">;
+    title: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
+    color: _angular_core.InputSignalWithTransform<Color, Color | null | undefined>;
+    width: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
+    height: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
+    view: _angular_core.InputSignalWithTransform<"dialog" | "bottom-sheet" | undefined, "dialog" | "bottom-sheet" | null | undefined>;
+    modalClass: _angular_core.InputSignalWithTransform<string | string[] | Record<string, boolean>, string | string[] | Record<string, boolean> | null | undefined>;
+    lazyLoadContent: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    hideClose: _angular_core.InputSignalWithTransform<boolean, boolean | "">;
+    disableBackdropClose: _angular_core.InputSignalWithTransform<boolean, boolean | "">;
+    sdClosed: _angular_core.OutputEmitterRef<void>;
+    isOpened: _angular_core.WritableSignal<boolean>;
+    alreadyOpened: _angular_core.WritableSignal<boolean>;
+    constructor();
+    open: () => void;
+    close: () => void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdModal, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdModal, "sd-modal", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "modalClass": { "alias": "modalClass"; "required": false; "isSignal": true; }; "lazyLoadContent": { "alias": "lazyLoadContent"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; "disableBackdropClose": { "alias": "disableBackdropClose"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "[sdHeader]", "*", "[sdFooterLeft]", "[sdFooterRight]", "[sdFooter]"], true, never>;
+}
+
+export { SdModal };

package/components/operator/index.d.ts

@@ -1 +1,36 @@
-export * from './src/operator.component';
+import * as _angular_core from '@angular/core';
+import { SafeHtml } from '@angular/platform-browser';
+import { Operator } from '@sdcorejs/utils/models';
+
+interface OperatorItem {
+    value: Operator;
+    icon: SafeHtml;
+    display: string;
+}
+declare class SdOperator {
+    #private;
+    static readonly FALLBACK_ICON = "<path d=\"M4 5h16l-6.5 7.5V19l-3 2v-8.5z\"/>";
+    /** Operator hiện tại — binding hai chiều [(model)]. */
+    model: _angular_core.ModelSignal<Operator | undefined>;
+    /** Danh sách operator cho phép, giữ nguyên thứ tự truyền vào. */
+    operators: _angular_core.InputSignal<Operator[]>;
+    /** Vô hiệu hóa trigger (không mở được menu). */
+    disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** data-autoId cho e2e selector. */
+    autoId: _angular_core.InputSignal<string | undefined>;
+    /** Allowed operators map sang { value, icon, display } theo thứ tự input. */
+    readonly items: _angular_core.Signal<OperatorItem[]>;
+    /** Icon SVG ở trigger — fallback phễu khi model chưa set / không tìm thấy. */
+    readonly currentIcon: _angular_core.Signal<SafeHtml>;
+    /** Tooltip = i18n label của operator hiện tại ('' khi chưa chọn). */
+    readonly currentLabel: _angular_core.Signal<string>;
+    private readonly trigger;
+    /** Open the operator menu programmatically (used by the query-bar build flow). */
+    open(): void;
+    /** Chọn operator từ menu. */
+    select(value: Operator): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdOperator, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdOperator, "sd-operator", never, { "model": { "alias": "model"; "required": false; "isSignal": true; }; "operators": { "alias": "operators"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; }, never, never, true, never>;
+}
+
+export { SdOperator };