@sd-angular/core 19.0.0-beta.8 → 19.0.0-beta.81

package/components/upload-file/src/configurations/upload-file.configuration.d.ts

@@ -1,17 +1,50 @@
 import { InjectionToken } from '@angular/core';
+/**
+ * Contract cấu hình cho cơ chế upload file của sd-angular.
+ *
+ * Cách dùng phổ biến:
+ * - Portal có thể provide cấu hình mặc định ở tầng global.
+ * - Mỗi module có thể provide thêm cấu hình riêng (thường với `multi: true`).
+ * - Khi có nhiều cấu hình cùng lúc, dùng `key` để chọn đúng provider.
+ *
+ * Luồng xử lý:
+ * 1) `upload`: upload file mới, trả về danh sách id/key.
+ * 2) `details`: lấy metadata để render danh sách file từ id/key.
+ * 3) `download` (optional): tải file theo id/key.
+ */
 export interface ISdUploadFileConfiguration<TArgs = any> {
+    /**
+     * Định danh cấu hình upload.
+     * Bắt buộc khi app có nhiều provider upload để tránh mapping nhầm.
+     */
+    key?: string;
+    /** Upload file và trả về danh sách id/key dùng cho lưu trữ. */
     upload: SdUploadFileFuncUpload<TArgs>;
+    /** Nhận danh sách id/key và trả về dữ liệu hiển thị file trong UI. */
     details: SdUploadFileFuncDetails<TArgs>;
+    /** Tùy chọn: tải file về theo id/key. */
     download?: SdUploadFileFuncDownload<TArgs>;
 }
-export declare const SD_UPLOAD_FILE_CONFIG: InjectionToken<ISdUploadFileConfiguration<any>>;
+/**
+ * Token DI cho upload configuration.
+ * Khuyến nghị provide dạng `multi: true` để hỗ trợ nhiều nguồn upload trong cùng app/module.
+ */
+export declare const SD_UPLOAD_FILE_CONFIGURATION: InjectionToken<ISdUploadFileConfiguration<any>>;
+/** Hàm upload file và trả về danh sách id/key tương ứng. */
 export type SdUploadFileFuncUpload<TArgs> = (files: File[], args?: TArgs) => Promise<string[]>;
+/** Hàm lấy thông tin file phục vụ hiển thị từ danh sách id/key. */
 export type SdUploadFileFuncDetails<TArgs> = (idOrKey: (string | number)[], args?: TArgs) => Promise<SdUploadFileDetail[]>;
+/** Hàm tải file theo id/key. */
 export type SdUploadFileFuncDownload<TArgs> = (idOrKey: string | number, args?: TArgs) => Promise<void>;
 export interface SdUploadFileDetail {
+    /** Định danh file được backend trả về sau upload. */
     idOrKey: string;
+    /** URL truy cập file (CDN hoặc direct URL). */
     cdn: string;
+    /** Tên hiển thị file. */
     name?: string;
+    /** Đuôi file: png, jpg, pdf... */
     extension?: string;
+    /** Dung lượng file tính theo MB (nếu backend có trả về). */
     size?: number;
 }

package/components/upload-file/src/services/upload-file.service.d.ts

@@ -1,7 +1,6 @@
 import * as i0 from "@angular/core";
 export declare class UploadFileService {
     #private;
-    constructor();
     isHashedKey: (key: string) => boolean;
     get: (key: string) => File | null;
     add: (file: File) => string | null;

package/components/upload-file/src/upload-file.component.d.ts

@@ -1,69 +1,67 @@
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import { AfterViewInit, ChangeDetectorRef, ElementRef, EventEmitter, OnDestroy, QueryList } from '@angular/core';
-import { FormGroup, NgForm } from '@angular/forms';
+import { ElementRef } from '@angular/core';
+import { FormGroup } from '@angular/forms';
 import { SdLabelDefDirective } from '@sd-angular/core/forms/directives';
 import { SdFormControl } from '@sd-angular/core/forms/models';
-import { SdConfirmService, SdNotifyService } from '@sd-angular/core/services';
 import { PreviewComponent } from './components/preview/preview.component';
-import { ISdUploadFileConfiguration, SdUploadFileFuncDetails } from './configurations';
-import { PreviewFile, UploadFileService } from './services';
+import { SdUploadFileFuncDownload, SdUploadFileFuncDetails, SdUploadFileFuncUpload } from './configurations';
+import { PreviewFile } from './services';
 import * as i0 from "@angular/core";
-export declare class SdUploadFile<TArgs = any> implements AfterViewInit, OnDestroy {
+export declare class SdUploadFile<TArgs = any> {
     #private;
-    private ref;
-    private notifyService;
-    private confirmService;
-    private readonly uploadFileConfig;
-    private uploadFileService;
-    previewFile?: PreviewComponent;
-    id: string;
-    selectedFile?: PreviewFile | null;
-    formControl: SdFormControl;
-    set _form(val: NgForm | FormGroup);
-    set _name(val: string | undefined);
-    args?: TArgs;
-    label?: string;
-    helperText?: string;
-    set _helperText(val: string | undefined);
-    description?: string;
-    type: 'image' | 'document' | 'file';
-    set _type(type: 'image' | 'document' | 'file' | undefined | null);
-    set disabled(val: boolean | '' | undefined | null);
-    required: boolean;
-    set _required(val: boolean | '' | undefined | null);
-    extensions: string[];
-    set _extensions(extensions: string[] | undefined | null);
-    max: number;
-    set _max(max: number | undefined | null);
-    maxOfImage: number;
-    set _maxOfImage(value: number | undefined | null);
-    maxSize?: number;
-    maxWidth?: number;
-    maxHeight?: number;
-    scaleToPixel?: number;
-    previewWidth: string;
-    previewHeight: string;
-    align: 'left' | 'center';
-    details?: SdUploadFileFuncDetails<any>;
-    imageValidator?: (image: HTMLImageElement) => string;
-    previewFiles: PreviewFile[];
-    set model(model: (string | number | undefined | null)[] | undefined | null);
-    loaded: EventEmitter<PreviewFile[]>;
-    modelChange: EventEmitter<(string | number)[]>;
-    filesChanged: EventEmitter<(string | File)[]>;
-    dropElements?: QueryList<ElementRef>;
-    canvas?: ElementRef;
-    sdLabelDef?: SdLabelDefDirective;
-    constructor(ref: ChangeDetectorRef, notifyService: SdNotifyService, confirmService: SdConfirmService, uploadFileConfig: ISdUploadFileConfiguration, uploadFileService: UploadFileService);
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
+    readonly id: string;
+    readonly formControl: SdFormControl;
+    readonly previewFiles: import("@angular/core").WritableSignal<PreviewFile[]>;
+    readonly selectedFile: import("@angular/core").WritableSignal<PreviewFile | null | undefined>;
+    readonly previewFileComponent: import("@angular/core").Signal<PreviewComponent | undefined>;
+    readonly dropElements: import("@angular/core").Signal<readonly ElementRef<any>[]>;
+    readonly sdLabelDef: import("@angular/core").Signal<SdLabelDefDirective | undefined>;
+    readonly args: import("@angular/core").InputSignal<TArgs | undefined>;
+    readonly label: import("@angular/core").InputSignal<string | undefined>;
+    readonly key: import("@angular/core").InputSignal<string | undefined>;
+    readonly description: import("@angular/core").InputSignal<string | undefined>;
+    readonly previewWidth: import("@angular/core").InputSignal<string>;
+    readonly previewHeight: import("@angular/core").InputSignal<string>;
+    readonly align: import("@angular/core").InputSignal<"left" | "center">;
+    readonly uploadInput: import("@angular/core").InputSignal<SdUploadFileFuncUpload<any> | undefined>;
+    readonly details: import("@angular/core").InputSignal<SdUploadFileFuncDetails<any> | undefined>;
+    readonly downloadInput: import("@angular/core").InputSignal<SdUploadFileFuncDownload<any> | undefined>;
+    readonly imageValidator: import("@angular/core").InputSignal<((image: HTMLImageElement) => string) | undefined>;
+    readonly maxSize: import("@angular/core").InputSignal<number | undefined>;
+    readonly maxWidth: import("@angular/core").InputSignal<number | undefined>;
+    readonly maxHeight: import("@angular/core").InputSignal<number | undefined>;
+    readonly scaleToPixel: import("@angular/core").InputSignal<number | undefined>;
+    form: import("@angular/core").InputSignalWithTransform<FormGroup<any> | undefined, any>;
+    readonly nameInput: import("@angular/core").InputSignalWithTransform<string, string | undefined>;
+    readonly required: import("@angular/core").InputSignalWithTransform<boolean, boolean | "" | null | undefined>;
+    readonly type: import("@angular/core").InputSignalWithTransform<"image" | "document" | "file", "image" | "document" | "file" | null | undefined>;
+    readonly helperText: import("@angular/core").InputSignal<string | undefined>;
+    readonly max: import("@angular/core").InputSignalWithTransform<number, number | null | undefined>;
+    readonly maxOfImage: import("@angular/core").InputSignalWithTransform<number, number | null | undefined>;
+    readonly extensions: import("@angular/core").InputSignalWithTransform<string[], string[] | null | undefined>;
+    readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, boolean | "" | null | undefined>;
+    readonly generatedDescription: import("@angular/core").Signal<string | undefined>;
+    readonly loaded: import("@angular/core").OutputEmitterRef<PreviewFile[]>;
+    readonly filesChanged: import("@angular/core").OutputEmitterRef<(string | File)[]>;
+    readonly model: import("@angular/core").ModelSignal<(string | number)[]>;
+    constructor();
     onUpload: () => void;
     onRemove: (file: PreviewFile) => void;
     onDrop: (event: CdkDragDrop<string[]>) => void;
     onImgError: (previewFile: PreviewFile) => void;
     onSelect: (file: PreviewFile) => void;
+    /**
+     * Lấy danh sách các File từ previewFiles (chưa upload).
+     */
     getFiles: () => Promise<File[]>;
+    /**
+     * Thực hiện upload các file và gán giá trị, output trả ra mảng idOrKeys.
+     * HÀM NÀY BẮT BUỘC PHẢI GỌI TRƯỚC KHI GỌI VỀ SERVER.
+     */
     upload: () => Promise<void>;
+    /**
+     * Mở popup preview ảnh.
+     */
     preview: () => Promise<void>;
     /**
      * Tải xuống một tệp tin dựa trên đối tượng PreviewFile.
@@ -77,5 +75,5 @@ export declare class SdUploadFile<TArgs = any> implements AfterViewInit, OnDestr
     onDownload: (previewFile: PreviewFile) => void;
     isLastVisibleOverlay(fileIndex: number): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdUploadFile<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdUploadFile<any>, "sd-upload-file", never, { "_form": { "alias": "form"; "required": false; }; "_name": { "alias": "name"; "required": false; }; "args": { "alias": "args"; "required": false; }; "label": { "alias": "label"; "required": false; }; "_helperText": { "alias": "helperText"; "required": false; }; "description": { "alias": "description"; "required": false; }; "_type": { "alias": "type"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "_required": { "alias": "required"; "required": false; }; "_extensions": { "alias": "extensions"; "required": false; }; "_max": { "alias": "max"; "required": false; }; "_maxOfImage": { "alias": "maxOfImage"; "required": false; }; "maxSize": { "alias": "maxSize"; "required": false; }; "maxWidth": { "alias": "maxWidth"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "scaleToPixel": { "alias": "scaleToPixel"; "required": false; }; "previewWidth": { "alias": "previewWidth"; "required": false; }; "previewHeight": { "alias": "previewHeight"; "required": false; }; "align": { "alias": "align"; "required": false; }; "details": { "alias": "details"; "required": false; }; "imageValidator": { "alias": "imageValidator"; "required": false; }; "model": { "alias": "model"; "required": false; }; }, { "loaded": "loaded"; "modelChange": "modelChange"; "filesChanged": "filesChanged"; }, ["sdLabelDef"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdUploadFile<any>, "sd-upload-file", never, { "args": { "alias": "args"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "previewWidth": { "alias": "previewWidth"; "required": false; "isSignal": true; }; "previewHeight": { "alias": "previewHeight"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "uploadInput": { "alias": "upload"; "required": false; "isSignal": true; }; "details": { "alias": "details"; "required": false; "isSignal": true; }; "downloadInput": { "alias": "download"; "required": false; "isSignal": true; }; "imageValidator": { "alias": "imageValidator"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "scaleToPixel": { "alias": "scaleToPixel"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "nameInput": { "alias": "name"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxOfImage": { "alias": "maxOfImage"; "required": false; "isSignal": true; }; "extensions": { "alias": "extensions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "filesChanged": "filesChanged"; "model": "modelChange"; }, ["sdLabelDef"], never, true, never>;
 }

package/components/view/index.d.ts

@@ -0,0 +1 @@
+export * from './src/view.component';

package/components/view/src/view.component.d.ts

@@ -0,0 +1,16 @@
+import { TemplateRef } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class SdView {
+    label: import("@angular/core").InputSignal<string | null | undefined>;
+    value: import("@angular/core").InputSignal<any>;
+    display: import("@angular/core").InputSignal<string | null | undefined>;
+    hyperlink: import("@angular/core").InputSignal<string | null | undefined>;
+    labelTemplate: import("@angular/core").InputSignal<TemplateRef<any> | undefined>;
+    valueTemplate: import("@angular/core").InputSignal<TemplateRef<any> | undefined>;
+    contentLabelTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
+    contentValueTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
+    activeLabelTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
+    activeValueTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdView, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdView, "sd-view", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": true; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "labelTemplate": { "alias": "labelTemplate"; "required": false; "isSignal": true; }; "valueTemplate": { "alias": "valueTemplate"; "required": false; "isSignal": true; }; }, {}, ["contentLabelTemplate", "contentValueTemplate"], never, true, never>;
+}

package/components/workflow/src/models/form-generic-component.model.d.ts

@@ -5,6 +5,7 @@ import { SdPatternType } from '@sd-angular/core/utilities/models';
 import { SdFormGenericSelectionStaticItem } from './form-generic-definition-selection.model';
 import { SdFormGenericExpression } from './form-generic-expression.model';
 import { SdFormGeneric } from './form-generic.model';
+import { SdUnwrapSignal } from '@sd-angular/core/utilities/models';
 export interface SdFormRenderConfiguration {
     onLoaded?: () => void;
     components: SdFormGeneric['components'];
@@ -158,10 +159,10 @@ export interface SdFormGenericGroup {
 export interface SdFormGenericUpload extends SdFormGenericComponentBase {
     type: 'upload';
     properties?: {
-        type?: SdUploadFile['type'];
-        maxSize?: SdUploadFile['maxSize'];
-        max?: SdUploadFile['max'];
-        extensions?: SdUploadFile['extensions'];
+        type?: SdUnwrapSignal<SdUploadFile['type']>;
+        maxSize?: SdUnwrapSignal<SdUploadFile['maxSize']>;
+        max?: SdUnwrapSignal<SdUploadFile['max']>;
+        extensions?: SdUnwrapSignal<SdUploadFile['extensions']>;
         args?: Record<string, any>;
         source?: 'ALL' | 'PHOTO_LIBRARY' | 'CAPTURE';
     } & SdFormGenericComponentBase['properties'];

package/components/workflow/src/models/form-generic-expression.model.d.ts

@@ -69,5 +69,6 @@ export declare const AttributeOperators: Record<Attribute['type'], {
 }[]>;
 export declare const GetAttributes: (components: (SdFormGenericComponent | SdFormGenericGroup)[]) => Attribute[];
 export declare const TemplateToCondition: (template: string | undefined | null, entity: Record<string, any>) => string | undefined;
+export declare const EvaluateExpression: (condition: SdFormGenericExpression | SdFormGenericExpressionCondition, entity: Record<string, any>) => boolean | undefined;
 export declare const ExpressionToJavascriptExpression: (condition: SdFormGenericExpression | SdFormGenericExpressionCondition) => string | undefined;
 export {};

package/components/workflow/src/models/index.d.ts

@@ -1,4 +1,5 @@
 export * from './form-render';
+export * from './form-generic.model';
 export * from './form-generic-component.model';
 export * from './form-generic-template.model';
 export * from './form-generic-definition-selection.model';

package/components/workflow/src/pipes/html.pipe.d.ts

@@ -1,11 +1,11 @@
 import { PipeTransform } from '@angular/core';
-import { SdSafeHtmlPipe } from '@sd-angular/core/pipes';
+import { DomSanitizer } from '@angular/platform-browser';
 import { SdFormGenericHtml } from '../models';
 import * as i0 from "@angular/core";
 export declare class HtmlPipe implements PipeTransform {
-    private readonly htmlSafePipe;
-    constructor(htmlSafePipe: SdSafeHtmlPipe);
-    transform: (hashed: string | undefined | null, content: string, component: SdFormGenericHtml) => import("@angular/platform-browser").SafeHtml | undefined;
+    private readonly sanitizer;
+    constructor(sanitizer: DomSanitizer);
+    transform: (hashed: string | undefined | null, content: string, component: SdFormGenericHtml) => string;
     static ɵfac: i0.ɵɵFactoryDeclaration<HtmlPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<HtmlPipe, "htmlPipe", true>;
 }

package/directives/index.d.ts

@@ -2,3 +2,5 @@ export * from './src/sd-scroll.directive';
 export * from './src/sd-desktop.directive';
 export * from './src/sd-mobile.directive';
 export * from './src/sd-hover-copy.directive';
+export * from './src/sd-href.directive';
+export { SdTooltipDirective } from './src/sd-tooltip.directive';

package/directives/src/sd-href.directive.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class SdHrefDirective {
+    #private;
+    url: string;
+    get href(): string;
+    onClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdHrefDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdHrefDirective, "a[sdHref]", never, { "url": { "alias": "sdHref"; "required": false; }; }, {}, never, never, true, never>;
+}

package/directives/src/sd-tooltip.directive.d.ts

@@ -0,0 +1,26 @@
+import { TemplateRef } from '@angular/core';
+import * as i0 from "@angular/core";
+export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+export declare class SdTooltipDirective {
+    #private;
+    content: import("@angular/core").InputSignal<string | TemplateRef<any>>;
+    sdTooltipPosition: import("@angular/core").InputSignal<TooltipPosition>;
+    sdTooltipDelay: import("@angular/core").InputSignal<number>;
+    sdTooltipColor: import("@angular/core").InputSignal<string>;
+    private static activeTooltip;
+    private readonly elementRef;
+    private readonly overlay;
+    private readonly viewContainerRef;
+    private readonly destroyRef;
+    private overlayRef;
+    private tooltipComponentRef;
+    private tooltipInstance;
+    private showTimeout;
+    private hideTimeout;
+    constructor();
+    onMouseEnter(): void;
+    onMouseLeave(): void;
+    forceHide: () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdTooltipDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdTooltipDirective, "[sdTooltip]", never, { "content": { "alias": "sdTooltip"; "required": true; "isSignal": true; }; "sdTooltipPosition": { "alias": "sdTooltipPosition"; "required": false; "isSignal": true; }; "sdTooltipDelay": { "alias": "sdTooltipDelay"; "required": false; "isSignal": true; }; "sdTooltipColor": { "alias": "sdTooltipColor"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}