@sdcorejs/angular 19.1.6 → 19.2.1

package/pipes/src/safe-html.pipe.d.ts

@@ -1,10 +1,32 @@
 import { PipeTransform } from '@angular/core';
+import { SafeHtml } from '@angular/platform-browser';
 import * as i0 from "@angular/core";
+/**
+ * Render an HTML string through `[innerHTML]`.
+ *
+ * why: this pipe used to call `bypassSecurityTrustHtml()` unconditionally, on every value, with no
+ * sanitize step. That turned every call site into a stored-XSS sink — and the library itself pipes
+ * server-supplied table cell data through it
+ * (`components/table/src/components/desktop-cell/view/view.component.html`), while
+ * `components/table/sd-table.md` already described the value as "sanitized via sdSafeHtml".
+ *
+ * Now it **sanitizes by default** and the bypass is an explicit, per-call-site opt-in:
+ *
+ * ```html
+ * <!-- untrusted / server-supplied: script, on* handlers and javascript: urls are stripped -->
+ * <div [innerHTML]="row.note | sdSafeHtml"></div>
+ *
+ * <!-- app-authored markup you control, e.g. an inline SVG sprite -->
+ * <span [innerHTML]="iconSvg | sdSafeHtml: true"></span>
+ * ```
+ *
+ * This mirrors the decision already taken for the toast in `services/notify`: text-safe by default,
+ * opt-in HTML. Auto-detecting "this looks like HTML" is deliberately NOT done — it would escalate
+ * untrusted text that merely contains `<` straight back into the unsanitized sink.
+ */
 export declare class SdSafeHtmlPipe implements PipeTransform {
-    private sanitizer;
-    /** Inserted by Angular inject() migration for backwards compatibility */
-    constructor(...args: unknown[]);
-    transform(html: string | number | undefined | null): import("@angular/platform-browser").SafeHtml | undefined;
+    #private;
+    transform(html: string | number | undefined | null, trusted?: boolean): SafeHtml | string | number | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSafeHtmlPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<SdSafeHtmlPipe, "sdSafeHtml", true>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdSafeHtmlPipe>;

package/pipes/src/time-different.pipe.d.ts

@@ -2,6 +2,7 @@ import { PipeTransform } from '@angular/core';
 import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
 export declare class SdTimeDifferentPipe implements PipeTransform {
+    #private;
     private maxSecond;
     private maxMinute;
     private maxHour;

package/public-api.d.ts

@@ -1,10 +1,11 @@
-import '@sdcorejs/angular/configurations';
-import '@sdcorejs/angular/utilities';
-import '@sdcorejs/angular/pipes';
-import '@sdcorejs/angular/directives';
-import '@sdcorejs/angular/services';
-import '@sdcorejs/angular/interceptors';
-import '@sdcorejs/angular/handlers';
-import '@sdcorejs/angular/components';
-import '@sdcorejs/angular/forms';
-import '@sdcorejs/angular/modules';
+export * from '@sdcorejs/angular/configurations';
+export * from '@sdcorejs/angular/i18n';
+export * from '@sdcorejs/angular/utilities';
+export * from '@sdcorejs/angular/pipes';
+export * from '@sdcorejs/angular/directives';
+export * from '@sdcorejs/angular/services';
+export * from '@sdcorejs/angular/interceptors';
+export * from '@sdcorejs/angular/handlers';
+export * from '@sdcorejs/angular/components';
+export * from '@sdcorejs/angular/forms';
+export * from '@sdcorejs/angular/modules';

package/services/api/src/api-host.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Handler nào chịu trách nhiệm cho `url`?
+ *
+ * why: trước đây là `url.startsWith(host)` — so chuỗi thô. Với host `https://api.example.com`,
+ * url `https://api.example.com.attacker.tld/x` cũng "khớp", nên handler chạy `intercept` cho host
+ * giả mạo đó và gắn luôn header auth mà nó đính kèm. `sdMatchesSecureRoute` parse URL rồi so
+ * origin + path prefix theo segment, nên `.attacker.tld` khác origin → không khớp, và
+ * `/api/v1beta` không bị coi là nằm dưới `/api/v1`.
+ *
+ * Việc chọn base origin khi không có `window.location` (SSR/prerender) do
+ * `sdResolveBaseOrigin` trong `url-safety` lo — trước đây file này tự giữ một origin giả riêng,
+ * nhưng `SdKeycloakInterceptor` lại không có, nên nó âm thầm ngừng đính token trên server. Logic
+ * đó giờ nằm ở helper chung để mọi call site cùng hành xử.
+ */
+export declare function sdApiMatchesHandlerHosts(url: string, hosts: readonly string[] | undefined): boolean;

package/services/api/src/api.model.d.ts

@@ -72,4 +72,18 @@ export interface ISdApiConfiguration {
 export declare const SD_API_CONFIG: InjectionToken<ISdApiConfiguration>;
 /** @deprecated Use `SD_API_CONFIG`. This is the same injection token. */
 export declare const SD_API_CONFIGURATION: InjectionToken<ISdApiConfiguration>;
+/**
+ * Lỗi nghiệp vụ: HTTP 200 nhưng body envelope báo thất bại (`{ ok: false, ... }`).
+ *
+ * why: trước đây `SdApiService` `throw body` — một plain object. Hệ quả: `error instanceof Error`
+ * là `false`, `error.message` là `undefined`, nên mọi `catch` của consumer và predicate
+ * `retry.retryWhen` đều bỏ sót nhánh này. Bọc vào một Error thật để envelope lỗi đi chung
+ * đường với lỗi HTTP; body gốc vẫn giữ nguyên ở `.body`.
+ */
+export declare class SdApiError<TBody = unknown> extends Error {
+    readonly name = "SdApiError";
+    /** Body nguyên bản của response (đúng object server trả về). */
+    readonly body: TBody;
+    constructor(body: TBody, message?: string);
+}
 export {};

package/services/api/src/api.module.d.ts

@@ -1,5 +1,11 @@
 import * as i0 from "@angular/core";
+/**
+ * Thông điệp của assertion dev-mode ở constructor. Export ra để spec khẳng định đúng nội dung,
+ * và để consumer grep được khi thấy nó trong console.
+ */
+export declare const SD_API_MISSING_HTTP_CLIENT_MESSAGE: string;
 export declare class SdApiModule {
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SdApiModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<SdApiModule, never, never, never>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SdApiModule>;

package/services/cache/src/cache.model.d.ts

@@ -41,12 +41,22 @@ export interface SdCacheStoredValue<T = unknown> {
 export type SdCacheSetCallback = (key: string, value: SdCacheStoredValue<unknown>, option?: SdCacheOption<unknown>) => Promise<void> | void;
 export type SdCacheGetCallback = (key: string, option?: SdCacheOption<unknown>) => Promise<SdCacheStoredValue<unknown> | undefined>;
 export type SdCacheRemoveCallback = (key: string, option?: SdCacheOption<unknown>) => Promise<void> | void;
+/**
+ * Số entry `type: 'memory'` tối đa được giữ trước khi LRU đẩy entry cũ nhất ra.
+ * Ghi đè bằng `maxMemoryEntries` trên `SD_CACHE_CONFIG`.
+ */
+export declare const SD_CACHE_DEFAULT_MAX_MEMORY_ENTRIES = 500;
 export interface ISdCacheConfiguration {
     convertKey?: (key: string) => string;
     namespace?: string;
     version?: string | number;
     serializer?: SdPersistenceSerializer;
     identityCanonicalizer?: SdPersistenceIdentityCanonicalizer;
+    /**
+     * Trần LRU cho cache `type: 'memory'`. Mặc định `SD_CACHE_DEFAULT_MAX_MEMORY_ENTRIES` (500).
+     * Giá trị không hợp lệ (không hữu hạn, < 1) sẽ rơi về mặc định.
+     */
+    maxMemoryEntries?: number;
     set?: SdCacheSetCallback;
     get?: SdCacheGetCallback;
     remove?: SdCacheRemoveCallback;

package/services/index.d.ts

@@ -6,7 +6,6 @@ export * from '@sdcorejs/angular/services/confirm';
 export * from '@sdcorejs/angular/services/api';
 export * from '@sdcorejs/angular/services/loading';
 export * from '@sdcorejs/angular/services/excel';
-export * from '@sdcorejs/angular/services/docx';
 export * from '@sdcorejs/angular/services/viewport';
 export * from '@sdcorejs/angular/services/unsaved-changes';
 export * from '@sdcorejs/angular/services/task';

package/services/notify/index.d.ts

@@ -1,2 +1,2 @@
-export { type NotifyOption as SdNotifyOption } from './src/notify.model';
+export { type NotifyOption as SdNotifyOption, type ToastData as SdToastData, type ToastType as SdToastType } from './src/notify.model';
 export * from './src/notify.service';

package/utilities/extensions/index.d.ts

@@ -1,7 +1,3 @@
-export * from './src/array.extension';
-export * from './src/string.extension';
-export * from './src/number.extension';
-export * from './src/date.extension';
 export * from './src/utility.extension';
-export * from './src/color.extension';
 export * from './src/object.extension';
+export * from './src/url-safety';

package/utilities/extensions/src/url-safety.d.ts

@@ -0,0 +1,72 @@
+/**
+ * URL safety helpers.
+ *
+ * why: this library used to decide "is this an external link?" and "should this request carry the
+ * bearer token?" with plain substring tests — `path.includes('http')` and `url.includes(route)`.
+ * Both are unsound:
+ *
+ *   - `'javascript:fetch(...)//http'.includes('http')` is `true`, so a menu entry could be opened
+ *     with `window.open()` and execute script in the app origin.
+ *   - With `secureRoutes: ['/api/v1']`, `'https://evil.example.com/api/v1/collect'.includes('/api/v1')`
+ *     is `true`, so a third-party host received the `Authorization: Bearer <token>` header.
+ *
+ * Everything here parses the URL instead of pattern-matching the string, and fails closed.
+ */
+/**
+ * Stand-in origin used when there is no `window.location` (SSR, prerender, unit tests).
+ *
+ * why: without a base, a relative route entry like `'/api/v1'` cannot be parsed, so every
+ * origin-aware check would silently answer `false` on the server — e.g. the keycloak interceptor
+ * would stop attaching the bearer token to every server-rendered request. Resolving BOTH the route
+ * entry and the request URL against one fixed synthetic origin keeps relative-vs-relative matching
+ * consistent across environments, while an ABSOLUTE route entry still has to match a real origin,
+ * so nothing is loosened.
+ */
+export declare const SD_NON_BROWSER_ORIGIN = "http://sdcorejs.invalid";
+/** Resolve the origin that relative URLs should be interpreted against. */
+export declare function sdResolveBaseOrigin(explicit?: string): string;
+/**
+ * Parse `value` into a URL. Relative values are resolved against `base` when one is supplied.
+ * Returns `undefined` instead of throwing so callers can fail closed with a simple null check.
+ */
+export declare function sdParseUrl(value: string | null | undefined, base?: string): URL | undefined;
+/**
+ * True only when `value` is an ABSOLUTE `http:`/`https:` URL.
+ *
+ * Replaces `url.startsWith('http')` / `path.includes('http')`. Note that `startsWith('http')` also
+ * accepts nonsense like `'httpfoo'`, and `includes('http')` accepts any string that merely mentions
+ * it — including `javascript:` payloads.
+ */
+export declare function sdIsExternalHttpUrl(value: string | null | undefined): boolean;
+/**
+ * Open an external link in a new browsing context.
+ *
+ * Refuses anything that is not absolute `http:`/`https:` (returns `null` without opening), and
+ * always passes `noopener,noreferrer` so the opened page cannot reach back through `window.opener`
+ * (reverse tabnabbing).
+ */
+export declare function sdOpenExternal(value: string | null | undefined, target?: string): Window | null;
+/**
+ * True when `url` is same-origin, or its origin is in `allowedOrigins`.
+ *
+ * Relative URLs (`/api/v1/users`) always count as same-origin. Outside a browser they resolve
+ * against {@link SD_NON_BROWSER_ORIGIN} unless `baseOrigin` is supplied.
+ */
+export declare function sdIsAllowedOrigin(url: string | null | undefined, allowedOrigins: readonly string[], baseOrigin?: string): boolean;
+/**
+ * Decide whether an outgoing request matches one of the configured secure routes, i.e. whether it
+ * is allowed to carry credentials.
+ *
+ * A route entry is either:
+ *   - a path prefix (`'/api/v1'`) — matches ONLY same-origin requests under that path, or
+ *   - an absolute URL (`'https://api.example.com/v1'`) — matches that exact origin, under that path.
+ *
+ * Path matching is segment-aware: `'/api/v1'` matches `/api/v1` and `/api/v1/users`, but NOT
+ * `/api/v1beta`. Anything that fails to parse returns `false`.
+ */
+export declare function sdMatchesSecureRoute(url: string | null | undefined, routes: readonly string[] | undefined, baseOrigin?: string): boolean;
+/**
+ * Segment-aware path prefix test: `/api/v1` covers `/api/v1` and `/api/v1/users`, but not
+ * `/api/v1beta`. A bare `/` prefix covers everything on that origin.
+ */
+export declare function sdIsPathPrefix(prefix: string, pathname: string): boolean;

package/utilities/extensions/src/utility.extension.d.ts

@@ -1,8 +1,12 @@
-export { Utilities, BrowserUtilities } from '@sdcorejs/utils/fns';
 /**
- * @deprecated Use {@link Utilities} and {@link BrowserUtilities} from `@sdcorejs/utils/fns` instead.
- * - upload/download/clipboard/isMobile → BrowserUtilities
- * - allWithPaging (→ fetchAllByPaging) / randomId / hash / parseQueryParams / generateUuid / getNestedValue → Utilities
+ * Facade tiện ích chung của `@sdcorejs/angular` (upload/download, clipboard, paging, hash, uuid…).
+ *
+ * why: khối này TỪNG bị đánh dấu `@deprecated` như thể chỉ là alias mỏng của `Utilities` /
+ * `BrowserUtilities` bên `@sdcorejs/utils/fns` — điều đó SAI. Cả 14 member dưới đây là cài đặt
+ * cục bộ trong chính file này (xem phần trên), có hành vi riêng cho môi trường Angular (interceptor,
+ * i18n, DOM). Xoá nó theo diện "dead alias" sẽ mất code thật, nên marker `@deprecated` đã được gỡ
+ * trong đợt breaking rename thay vì gỡ implementation. Các alias thật sự chết ở `utilities/**`
+ * (`SdColor`, `SD_EMPTY_STR`, `SdFilter*`, `SdPatternCommons`, `hslToHex`/`rgbToHex`…) đã bị xoá hẳn.
  */
 declare const SdUtilities: {
     upload: (option?: {
@@ -24,7 +28,7 @@ declare const SdUtilities: {
     randomId: (prefix?: string | null) => string;
     hash: (obj: any) => string;
     parseQueryParams: (queryString?: string) => Record<string, string>;
-    getClientPublicIp: () => Promise<string | null>;
+    getClientPublicIp: (endpoint: string) => Promise<string | null>;
     generateUuid: () => string;
     getNestedValue: (obj: any, path: string) => any;
 };

package/utilities/models/index.d.ts

@@ -1,12 +1,2 @@
-export type * from './src/color.model';
-export type * from './src/size.model';
 export * from './src/icon.model';
-export * from './src/pattern.model';
-export * from './src/empty.model';
-export * from './src/maybe-async.model';
-export type * from './src/nested-key-of.model';
 export type * from './src/unwrap-signal.model';
-export * from './src/operator.model';
-export type * from './src/filter.model';
-export type * from './src/order.model';
-export type * from './src/paging.model';

package/components/base/index.d.ts

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

package/components/base/src/base-secure.component.d.ts

@@ -1,8 +0,0 @@
-import { SdLicenseService } from '@sdcorejs/angular/services/license';
-import * as i0 from "@angular/core";
-export declare abstract class SdBaseSecureComponent {
-    protected licenseService: SdLicenseService;
-    constructor();
-    static ɵfac: i0.ɵɵFactoryDeclaration<SdBaseSecureComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SdBaseSecureComponent, never, never, {}, {}, never, never, true, never>;
-}

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

@@ -1,4 +0,0 @@
-export * from './src/components';
-export type * from './src/document-builder.model';
-export * from './src/document-builder.component';
-export type * from './src/plugins/ck-comment/ck-comment.plugin.model';

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

@@ -1,15 +0,0 @@
-import { DocumentBuilderI18n } from '../../document-builder.model';
-import { ClassicEditor, EditorConfig } from 'ckeditor5';
-import * as i0 from "@angular/core";
-export declare class SdHeaderFooterBuilder {
-    #private;
-    Editor: typeof ClassicEditor;
-    set model(value: string | undefined | null);
-    readonly modelChange: import("@angular/core").OutputEmitterRef<string>;
-    config: EditorConfig & {
-        _i18n?: DocumentBuilderI18n;
-    };
-    onReady(editor: ClassicEditor): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SdHeaderFooterBuilder, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdHeaderFooterBuilder, "sd-header-footer-builder", never, { "model": { "alias": "model"; "required": false; }; }, { "modelChange": "modelChange"; }, never, never, true, never>;
-}

package/components/document-builder/src/components/header-footer-builder/plugins/page-number.plugin.d.ts

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

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

@@ -1 +0,0 @@
-export * from './header-footer-builder/header-footer-builder.component';

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

@@ -1,53 +0,0 @@
-import { OnInit, OnDestroy } from '@angular/core';
-import { ClassicEditor, ModelRange } from 'ckeditor5';
-import { VariablePlugin, CkCommentPlugin } from './plugins';
-import { DocumentBuilderOption, SdDocumentBuilderHeading, SdDocumentBuilderOption } from './document-builder.model';
-import * as i0 from "@angular/core";
-export declare class SdDocumentBuilder implements OnInit, OnDestroy {
-    #private;
-    readonly option: import("@angular/core").InputSignal<SdDocumentBuilderOption>;
-    disabled: boolean;
-    set _disabled(val: boolean | '' | undefined | null);
-    readonly contentChange: import("@angular/core").OutputEmitterRef<string>;
-    Editor: typeof ClassicEditor;
-    config: DocumentBuilderOption;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    onReady(editor: ClassicEditor): void;
-    setContent: (html: string) => void;
-    getContent: () => string;
-    setOrientation: (orientation: "PORTRAIT" | "LANDSCAPE") => void;
-    getOrientation: () => "PORTRAIT" | "LANDSCAPE";
-    scrollToTop(): void;
-    heading: {
-        /**
-         * Lấy tất cả headings trong document
-         * @returns Danh sách tất cả headings
-         */
-        all: () => SdDocumentBuilderHeading[];
-        /**
-         * Scroll tới vị trí của heading
-         * @param id - ID của heading cần scroll tới
-         */
-        scroll: (id: string) => void;
-    };
-    getCommentPluginAPI(): CkCommentPlugin | null;
-    getVariablePluginAPI(): VariablePlugin | null;
-    /**
-     * Xuất file Word có Header/Footer
-     * @param fileName Tên file
-     * @param headerText Nội dung Header (hoặc HTML)
-     * '<p style="text-align: center; font-weight: bold;">CÔNG TY CỔ PHẦN CÔNG NGHỆ ABC</p>'
-     * @param footerText Nội dung Footer (hoặc HTML)
-     * '<p style="text-align: right; font-size: 10pt;">Trang <span style="mso-field-code: PAGE"></span> / <span style="mso-field-code: NUMPAGES"></span></p>'
-     */
-    exportDocx(args: {
-        fileName?: string;
-        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; "isSignal": true; }; "_disabled": { "alias": "disabled"; "required": false; }; }, { "contentChange": "contentChange"; }, never, never, true, never>;
-}

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

@@ -1,21 +0,0 @@
-/**
- * Cấu hình màu cho Document Builder
- * Bảng màu tập trung và cấu hình cho việc lựa chọn màu nhất quán
- */
-import { ColorPickerConfig, FontColorConfig, FontSizeConfig, HeadingConfig } from 'ckeditor5';
-/**
- * Trả về bảng màu chung được sử dụng trong tất cả tính năng của document builder
- * @returns Mảng các tùy chọn màu được định sẵn với giá trị hex và label
- */
-export declare function getPresetColors(): FontColorConfig['colors'];
-/**
- * Trả về cấu hình bộ chọn màu với định dạng hex
- * @returns Đối tượng cấu hình bộ chọn màu
- */
-export declare function getColorPickerConfig(): ColorPickerConfig;
-/**
- * Trả về cấu hình kích thước font cho document builder
- * @returns Mảng các tùy chọn kích thước font được định sẵn
- */
-export declare function getFontSizeOptions(): FontSizeConfig['options'];
-export declare function getHeadingOptions(): HeadingConfig['options'];

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

@@ -1,41 +0,0 @@
-import { EditorConfig, EventInfo, ModelDocumentSelection, ViewDataTransfer } from 'ckeditor5';
-import { I18nParams } from '@sdcorejs/angular/i18n';
-import { CkCommentConfig } from './plugins/ck-comment/ck-comment.plugin.model';
-/** Plain translator cho CKEditor plugin — tránh truyền thẳng I18nService (private fields mất `this` qua config). */
-export interface DocumentBuilderI18n {
-    t(key: string, params?: I18nParams): string;
-}
-export type DocumentBuilderOption = EditorConfig & {
-    getOption?: () => SdDocumentBuilderOption;
-    _i18n?: DocumentBuilderI18n;
-};
-export interface SdDocumentBuilderOption {
-    onDropVariable?: (variable: SdDocumentBuilderVariable) => boolean | Promise<boolean | SdDocumentBuilderVariable>;
-    onAfterDropVariable?: (variable: SdDocumentBuilderVariable) => void;
-    onPasteVariable?: (display: string) => SdDocumentBuilderVariable | null | Promise<SdDocumentBuilderVariable | null>;
-    comment?: CkCommentConfig;
-    onSelection?: (selection: ModelDocumentSelection, $event: EventInfo<string, unknown>) => void;
-    onOrientation?: (orientation: 'PORTRAIT' | 'LANDSCAPE') => void;
-    onPaste?: (data: SdPasteEventData) => void | Promise<void>;
-    orientation?: 'PORTRAIT' | 'LANDSCAPE';
-}
-export interface SdDocumentBuilderVariable<T = any> {
-    id: string;
-    uuid?: string;
-    value: string;
-    display: string;
-    bindingValue?: string;
-    data?: T;
-}
-export interface SdDocumentBuilderHeading {
-    id: string;
-    text: string;
-    level: number;
-    type: string;
-}
-export interface SdPasteEventData {
-    html?: string;
-    text: string;
-    source: 'word' | 'excel' | 'google-docs' | 'web' | 'unknown';
-    dataTransfer: ViewDataTransfer;
-}

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

@@ -1,10 +0,0 @@
-/**
- * Document Builder Utilities
- * Các hàm tiện ích cho document builder
- */
-/**
- * Chuẩn hóa nội dung bằng cách chuyển đổi tất cả màu HSL và RGB sang hex
- * @param content - Nội dung HTML cần chuẩn hóa
- * @returns Nội dung đã được chuẩn hóa với màu hex
- */
-export declare function normalize(content: string): string;

package/components/document-builder/src/plugins/block-space/block-space.plugin.d.ts

@@ -1,9 +0,0 @@
-import { Plugin } from 'ckeditor5';
-/**
- * Plugin để thêm margin-bottom: 4px cho các block elements
- * (paragraph, heading, list, table) thông qua downcast conversion
- */
-export declare class BlockSpace extends Plugin {
-    static get pluginName(): string;
-    init(): void;
-}

package/components/document-builder/src/plugins/ck-comment/ck-comment.plugin.d.ts

@@ -1,44 +0,0 @@
-import { Plugin, ContextualBalloon } from 'ckeditor5';
-import { CkComment, CkCommentConfig, CkCommentColors } from './ck-comment.plugin.model';
-export declare class CkCommentPlugin extends Plugin {
-    #private;
-    static get pluginName(): string;
-    static get requires(): (typeof ContextualBalloon)[];
-    static readonly PENDING_MARKER_ID = "__pending_comment__";
-    static readonly DEFAULT_SEARCH_RANGE = 5;
-    static readonly DEFAULT_MAX_TEXT_LENGTH = 1000;
-    static readonly DEFAULT_COLORS: CkCommentColors;
-    init(): void;
-    /**
-     * Thiết lập config với callbacks
-     */
-    setConfig(config: CkCommentConfig): void;
-    /**
-     * Thêm comment và tạo marker
-     */
-    addComment(comment: CkComment): boolean;
-    /**
-     * Xóa comment theo id
-     */
-    removeComment(id: string | number): boolean;
-    /**
-     * Chọn comment theo id - chỉ thêm class highlight, không bôi đen text
-     */
-    selectComment(id: string | number, scrollIntoView?: boolean): void;
-    /**
-     * Thiết lập tất cả comments (khôi phục từ dữ liệu)
-     */
-    setComments(comments: CkComment[]): void;
-    /**
-     * Lấy tất cả comments
-     */
-    get comments(): CkComment[];
-    /**
-     * Thiết lập pending highlight cho selection (khi user đang nhập nội dung comment)
-     */
-    setPendingSelection(startPath: number[], endPath: number[]): boolean;
-    /**
-     * Xóa pending highlight và fire onCancelPending callback
-     */
-    clearPendingSelection(): void;
-}

package/components/document-builder/src/plugins/ck-comment/ck-comment.plugin.model.d.ts

@@ -1,57 +0,0 @@
-import { ModelRange } from 'ckeditor5';
-/**
- * Comment status based on text changes
- */
-export type CkCommentStatus = 'normal' | 'modified' | 'broken';
-/**
- * Color configuration for comment markers
- */
-export interface CkCommentColors {
-    marker?: string;
-    markerSelected?: string;
-    markerPending?: string;
-    markerModified?: string;
-    markerBroken?: string;
-}
-/**
- * Comment data structure for CkCommentPlugin
- */
-export interface CkComment<T = any> {
-    id: string | number;
-    startPath: number[];
-    endPath: number[];
-    originalText: string;
-    currentText: string;
-    status: CkCommentStatus;
-    data?: T;
-}
-/**
- * Config for CkCommentPlugin
- */
-export interface CkCommentConfig {
-    onPendingComment?: (comment: CkComment) => void;
-    onAddComment?: (comment: CkComment) => void;
-    onSelectComment?: (id: string | number) => void;
-    onRemoveComment?: (id: string | number) => void;
-    onChange?: (comments: CkComment[]) => void;
-    onCancelPending?: () => void;
-    onError?: (error: {
-        code: string;
-        message: string;
-        data?: any;
-    }) => void;
-    searchRange?: number;
-    debug?: boolean;
-    colors?: CkCommentColors;
-    maxTextLength?: number;
-    allowCreating?: boolean;
-}
-/**
- * Data returned when user selects text for comment
- */
-export interface CkCommentSelection {
-    range: ModelRange;
-    startPath: number[];
-    endPath: number[];
-    text: string;
-}

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

@@ -1,5 +0,0 @@
-import { Plugin } from 'ckeditor5';
-export declare class HeadingPlugin extends Plugin {
-    static get pluginName(): string;
-    init(): void;
-}

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

@@ -1,4 +0,0 @@
-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

@@ -1,31 +0,0 @@
-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/image-upload/image-upload.plugin.d.ts

@@ -1,5 +0,0 @@
-import { Plugin } from 'ckeditor5';
-export declare class ImageUploadPlugin extends Plugin {
-    static get pluginName(): "ImageUploadPlugin";
-    init(): void;
-}

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

@@ -1,11 +0,0 @@
-export * from './heading/heading.plugin';
-export * from './variable/variable.plugin';
-export * from './table-custom';
-export * from './image-upload/image-upload.plugin';
-export * from './image-custom/image-custom.plugin';
-export * from './page-orientation/page-orientation.plugin';
-export * from './paste-handler';
-export * from './highlight-range/highlight-range.plugin';
-export * from './block-space/block-space.plugin';
-export * from './ck-comment/ck-comment.plugin';
-export type * from './ck-comment/ck-comment.plugin.model';