@sd-angular/core 19.0.0-beta.70 → 19.0.0-beta.72

package/assets/scss/ckeditor5.scss

@@ -1,5 +1,5 @@
 // Import the core styles.
-@import '@ckeditor/ckeditor5-theme-lark/dist/index.css';
+@import '@ckeditor/ckeditor5-ui/dist/index.css';
 @import '@ckeditor/ckeditor5-clipboard/dist/index.css';
 @import '@ckeditor/ckeditor5-core/dist/index.css';
 @import '@ckeditor/ckeditor5-engine/dist/index.css';
@@ -7,7 +7,6 @@
 @import '@ckeditor/ckeditor5-paragraph/dist/index.css';
 @import '@ckeditor/ckeditor5-select-all/dist/index.css';
 @import '@ckeditor/ckeditor5-typing/dist/index.css';
-@import '@ckeditor/ckeditor5-ui/dist/index.css';
 @import '@ckeditor/ckeditor5-undo/dist/index.css';
 @import '@ckeditor/ckeditor5-upload/dist/index.css';
 @import '@ckeditor/ckeditor5-utils/dist/index.css';

package/components/modal/index.d.ts

@@ -1 +1 @@
-export * from './src/modal/modal.component';
+export * from './src/modal.component';

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

@@ -0,0 +1,24 @@
+import { ElementRef, TemplateRef } from '@angular/core';
+import { SdColor } from '@sd-angular/core/utilities/models';
+import * as i0 from "@angular/core";
+export declare class SdModal {
+    #private;
+    static index: import("@angular/core").WritableSignal<number>;
+    templateRef: import("@angular/core").Signal<TemplateRef<any>>;
+    modal: import("@angular/core").Signal<ElementRef<any> | undefined>;
+    title: import("@angular/core").InputSignalWithTransform<string, string | null | undefined>;
+    color: import("@angular/core").InputSignalWithTransform<SdColor, SdColor | null | undefined>;
+    width: import("@angular/core").InputSignalWithTransform<string, string | null | undefined>;
+    height: import("@angular/core").InputSignalWithTransform<string, string | null | undefined>;
+    view: import("@angular/core").InputSignalWithTransform<"dialog" | "bottom-sheet" | undefined, "dialog" | "bottom-sheet" | null | undefined>;
+    modalClass: import("@angular/core").InputSignalWithTransform<string | string[] | Record<string, boolean>, string | string[] | Record<string, boolean> | null | undefined>;
+    lazyLoadContent: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    sdClosed: import("@angular/core").OutputEmitterRef<void>;
+    isOpened: import("@angular/core").WritableSignal<boolean>;
+    alreadyOpened: import("@angular/core").WritableSignal<boolean>;
+    constructor();
+    open: () => void;
+    close: () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdModal, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdModal, "sd-modal", never, { "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; }; }, { "sdClosed": "sdClosed"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "[sdHeader]", "*", "[sdFooterLeft]", "[sdFooterRight]", "[sdFooter]"], true, never>;
+}

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>;
 }
+/**
+ * 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/upload-file.component.d.ts

@@ -4,7 +4,7 @@ import { FormGroup } from '@angular/forms';
 import { SdLabelDefDirective } from '@sd-angular/core/forms/directives';
 import { SdFormControl } from '@sd-angular/core/forms/models';
 import { PreviewComponent } from './components/preview/preview.component';
-import { SdUploadFileFuncDetails } from './configurations';
+import { SdUploadFileFuncDownload, SdUploadFileFuncDetails, SdUploadFileFuncUpload } from './configurations';
 import { PreviewFile } from './services';
 import * as i0 from "@angular/core";
 export declare class SdUploadFile<TArgs = any> {
@@ -18,11 +18,14 @@ export declare class SdUploadFile<TArgs = 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>;
@@ -72,5 +75,5 @@ export declare class SdUploadFile<TArgs = any> {
     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, { "args": { "alias": "args"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "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; }; "details": { "alias": "details"; "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>;
+    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/fesm2022/sd-angular-core-components-document-builder.mjs

@@ -3333,7 +3333,7 @@ class PasteHandler extends Plugin {
         const normalizers = [];
         const hasMultiLevelListPlugin = this.editor.plugins.has('MultiLevelListEditing');
         const hasTablePropertiesPlugin = this.editor.plugins.has('TablePropertiesEditing');
-        const hasExtendedTableBlockAlignment = !!this.editor.config.get('experimentalFlags.useExtendedTableBlockAlignment');
+        const hasExtendedTableBlockAlignment = true; // In CKEditor 5 v48, extended table block alignment is stable and enabled by default.
         normalizers.push(new PasteFromOfficeMSWordNormalizer(viewDocument, hasMultiLevelListPlugin, hasTablePropertiesPlugin, hasExtendedTableBlockAlignment));
         normalizers.push(new GoogleDocsNormalizer(viewDocument));
         normalizers.push(new GoogleSheetsNormalizer(viewDocument));