@sd-angular/core 19.0.0-beta.13 → 19.0.0-beta.15

package/assets/scss/ckeditor5.scss

@@ -21,11 +21,68 @@
 @import '@ckeditor/ckeditor5-basic-styles/dist/index.css';
 // @import '@ckeditor/ckeditor5-block-quote/dist/index.css';
 @import '@ckeditor/ckeditor5-heading/dist/index.css';
-@import '@ckeditor/ckeditor5-image/dist/index.css';
+// @import '@ckeditor/ckeditor5-image/dist/index.css';
+@import '@ckeditor/ckeditor5-image/dist/index-editor.css';
 @import '@ckeditor/ckeditor5-indent/dist/index.css';
 @import '@ckeditor/ckeditor5-link/dist/index.css';
 @import '@ckeditor/ckeditor5-list/dist/index.css';
 // @import '@ckeditor/ckeditor5-media-embed/dist/index.css';
 @import '@ckeditor/ckeditor5-paste-from-office/dist/index.css';
-@import '@ckeditor/ckeditor5-table/dist/index.css';
+
+// hung.pham16: không sử dụng default styles của ckeditor vì server không hỗ trợ
+// @import '@ckeditor/ckeditor5-table/dist/index.css';
+@import '@ckeditor/ckeditor5-table/dist/index-editor.css';
+
 // @import '@ckeditor/ckeditor5-mention/dist/index.css';
+
+// Custom toolbar
+.ck-editor {
+  /* --- 1. GIẢM KÍCH THƯỚC ICON VÀ CHỮ --- */
+  /* Giảm cỡ chữ trong dropdown (mặc định khoảng 13px) */
+  --ck-font-size-base: 11px !important;
+
+  /* Giảm kích thước Icon (mặc định 20px) */
+  --ck-icon-size: 16px !important;
+
+  /* --- 2. TỐI ƯU KHOẢNG CÁCH (Padding/Margin) --- */
+
+  /* Giảm khoảng cách giữa các nút */
+  --ck-spacing-small: 2px !important;
+  --ck-spacing-standard: 6px !important;
+  --ck-spacing-large: 8px !important;
+
+  /*  */
+  --ck-color-table-focused-cell-background: transparent !important;
+  --ck-table-content-default-border-color: transparent !important;
+
+  //
+  --ck-insert-table-dropdown-padding: 10px;
+  --ck-insert-table-dropdown-box-height: 16px;
+  --ck-insert-table-dropdown-box-width: 16px;
+  --ck-insert-table-dropdown-box-margin: 1px;
+
+  --ck-focus-ring: 1px solid var(--ck-color-base-border);
+}
+
+/* Giảm độ cao của thanh toolbar (cho gọn) */
+.ck-toolbar {
+  min-height: 32px !important; /* Mặc định thường là 40px */
+  padding: 2px !important;
+
+  /* Làm màu nền toolbar nhạt hơn cho hiện đại */
+  background: #f8f9fa !important;
+  border-bottom: 1px solid #e0e0e0 !important;
+}
+
+.ck-toolbar__items {
+  /* Chỉnh nút bấm trong toolbar nhỏ lại */
+  > .ck-button {
+    padding: 2px 4px !important; /* Giảm padding trái phải của nút */
+    min-height: 24px !important;
+  }
+
+  /* Chỉnh lại dropdown (Heading, Font Size) cho khớp */
+  > .ck-dropdown {
+    min-height: 24px !important;
+  }
+}

package/components/document-builder/src/document-builder.component.d.ts

@@ -42,7 +42,10 @@ export declare class SdDocumentBuilder {
          * @param data - Dữ liệu extra data
          * @returns SdDocumentBuilderComment hoặc null nếu không có text được chọn
          */
-        add: <T = any>(range: ModelRange, comment: string, data?: T) => SdDocumentBuilderComment<T> | null;
+        add: <T = any>(range: ModelRange, comment: string, args?: {
+            markerIdExternal?: string | number;
+            data?: T;
+        }) => SdDocumentBuilderComment<T> | null;
         /**
          * Cập nhật nội dung comment
          * @param markerId - ID của marker
@@ -73,7 +76,7 @@ export declare class SdDocumentBuilder {
          * Lấy tất cả variabes trong document
          * @returns Danh sách tất cả variables
          */
-        all: () => SdDocumentBuilderVariable[];
+        all: <T = any>() => SdDocumentBuilderVariable<T>[];
         /**
          * Scroll tới vị trí của variable
          * @param uuid - uuid của variable FE sẽ tự sinh sau mỗi lần drop vào editor
@@ -93,6 +96,8 @@ export declare class SdDocumentBuilder {
         header?: string;
         footer?: string;
     }): void;
+    hightSelectRange: (range: ModelRange) => void;
+    removeHighlightSeclectRange: () => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdDocumentBuilder, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SdDocumentBuilder, "sd-document-builder", never, { "option": { "alias": "option"; "required": true; }; "_disabled": { "alias": "disabled"; "required": false; }; }, { "contentChange": "contentChange"; }, never, never, true, never>;
 }

package/components/document-builder/src/document-builder.model.d.ts

@@ -4,7 +4,7 @@ export type SdEditorConfig = EditorConfig & {
 };
 export interface SdDocumentBuilderOption {
     onDropVariable?: (variable: SdDocumentBuilderVariable, dropIndex: number) => boolean | Promise<boolean | SdDocumentBuilderVariable>;
-    onAddComment?: (range: ModelRange) => void;
+    onAddComment?: (selectedComment: SdDocumentBuilderSelectedComment) => void;
     onSelectComment?: (markerId: string) => void;
     onSelection?: (selection: ModelDocumentSelection, $event: EventInfo<string, unknown>) => void;
     onOrientation?: (orientation: 'PORTRAIT' | 'LANDSCAPE') => void;
@@ -17,6 +17,10 @@ export interface SdDocumentBuilderVariable<T = any> {
     display: string;
     data?: T;
 }
+export interface SdDocumentBuilderSelectedComment {
+    range: ModelRange;
+    selectedText: string;
+}
 export interface SdDocumentBuilderComment<T = any> {
     markerId: string;
     selectedText: string;

package/components/document-builder/src/plugins/highlight-range/highlight-range.plugin.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from 'ckeditor5';
+export declare class HighlightRangePlugin extends Plugin {
+    init(): void;
+}

package/components/document-builder/src/plugins/image-custom/image-custom.plugin.d.ts

@@ -0,0 +1,31 @@
+import { Plugin } from 'ckeditor5';
+export declare class ImageCustomPlugin extends Plugin {
+    static get pluginName(): "ImageCustomPlugin";
+    init(): void;
+    /**
+     * Xử lý sự kiện chèn ảnh
+     */
+    private handleImageInsert;
+    /**
+     * Xử lý sự kiện thay đổi attribute ảnh
+     */
+    private handleImageAttributeChange;
+    /**
+     * Xử lý sự kiện thay đổi style ảnh - thêm float inline style cho căn chỉnh
+     */
+    private handleImageStyleChange;
+    /**
+     * Áp dụng custom styles cho element ảnh
+     */
+    private applyCustomStyles;
+    /**
+     * Tìm container ck-widget (element figure)
+     * CKEditor wrap ảnh block trong <figure class="ck-widget"><img></figure>
+     */
+    private findWidgetElement;
+    /**
+     * Tìm element img thực tế bên trong widget structure
+     * CKEditor wrap ảnh block trong <figure class="ck-widget"><img></figure>
+     */
+    private findImgElement;
+}

package/components/document-builder/src/plugins/index.d.ts

@@ -3,4 +3,5 @@ export * from './comment/comment.plugin';
 export * from './variable/variable.plugin';
 export * from './table-fit/table-fit.plugin';
 export * from './image-upload/image-upload.plugin';
+export * from './image-custom/image-custom.plugin';
 export * from './page-orientation/page-orientation.plugin';

package/components/document-builder/src/plugins/table-fit/table-fit.plugin.d.ts

@@ -1,4 +1,29 @@
 import { Plugin } from 'ckeditor5';
 export declare class TableFitPlugin extends Plugin {
     init(): void;
+    /**
+     * Apply default table width
+     */
+    private _applyTableDefaults;
+    /**
+     * Apply default borders to all cells in a table
+     */
+    private _applyCellBorders;
+    /**
+     * Setup listener to preserve cell/table styles when model changes
+     */
+    private _setupStylePreservationOnModelChange;
+    /**
+     * Find tables that need border fixes from model changes
+     */
+    private _findTablesNeedingFix;
+    /**
+     * Find parent table element
+     */
+    private _findParentTable;
+    /**
+     * Cleanup listeners when plugin is destroyed
+     * Note: this.listenTo() listeners are automatically cleaned up by super.destroy()
+     */
+    destroy(): void;
 }

package/components/index.d.ts

@@ -14,3 +14,4 @@ export * from '@sd-angular/core/components/anchor-v2';
 export * from '@sd-angular/core/components/query-builder';
 export * from '@sd-angular/core/components/import-excel';
 export * from '@sd-angular/core/components/document-builder';
+export * from '@sd-angular/core/components/mini-editor';

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

@@ -0,0 +1,2 @@
+export * from './src/mini-editor.model';
+export * from './src/mini-editor.component';

package/components/mini-editor/src/mini-editor.component.d.ts

@@ -0,0 +1,90 @@
+import { EventEmitter } from '@angular/core';
+import { ClassicEditor } from 'ckeditor5';
+import { ControlValueAccessor } from '@angular/forms';
+import { SdMiniEditorOption, SdMiniEditorConfig } from './mini-editor.model';
+import * as i0 from "@angular/core";
+/**
+ * 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>
+ * ```
+ */
+export declare class SdMiniEditor implements ControlValueAccessor {
+    #private;
+    /** Cấu hình option cho editor */
+    option: SdMiniEditorOption;
+    /** 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>;
+}

package/components/mini-editor/src/mini-editor.model.d.ts

@@ -0,0 +1,42 @@
+import { EditorConfig, MentionFeed, MentionFeedObjectItem } from 'ckeditor5';
+export type { MentionFeedObjectItem };
+export type SdMiniEditorOutputFormat = 'html' | 'markdown';
+export 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>;
+    };
+}
+export type SdMiniEditorMentionItem<T = any> = MentionFeedObjectItem & {
+    data?: T;
+};
+export 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;
+    /** 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;
+}
+export type SdMiniEditorConfig = EditorConfig & {
+    getOption?: () => SdMiniEditorOption;
+};

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,14 @@
+import { OnInit } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class SdAvatar implements OnInit {
+    #private;
+    src: string | undefined | null;
+    size: number;
+    isUrl: boolean;
+    initials: string;
+    bgColor: string;
+    ngOnInit(): void;
+    handleError(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAvatar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdAvatar, "sd-view", never, { "src": { "alias": "src"; "required": true; }; "size": { "alias": "size"; "required": false; }; }, {}, never, never, true, never>;
+}

package/directives/index.d.ts

@@ -2,3 +2,4 @@ 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';

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>;
+}