@sdcorejs/angular 19.0.0-rc.1

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

@@ -0,0 +1,44 @@
+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;
+    /** 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;
+}
+export type SdMiniEditorConfig = EditorConfig & {
+    getOption?: () => SdMiniEditorOption;
+};

package/components/modal/index.d.ts

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

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

@@ -0,0 +1,30 @@
+import { ElementRef, TemplateRef } from '@angular/core';
+import { Color } from '@sdcorejs/utils/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>;
+    readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly autoId: import("@angular/core").Signal<string | undefined>;
+    readonly closeButtonAutoId: import("@angular/core").Signal<string | undefined>;
+    readonly dataOpened: import("@angular/core").Signal<"true" | "false">;
+    title: import("@angular/core").InputSignalWithTransform<string, string | null | undefined>;
+    color: import("@angular/core").InputSignalWithTransform<Color, Color | 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>;
+    hideClose: import("@angular/core").InputSignalWithTransform<boolean, boolean | "">;
+    disableBackdropClose: import("@angular/core").InputSignalWithTransform<boolean, boolean | "">;
+    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, { "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>;
+}

package/components/operator/index.d.ts

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

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

@@ -0,0 +1,34 @@
+import { SafeHtml } from '@angular/platform-browser';
+import { Operator } from '@sdcorejs/utils/models';
+import * as i0 from "@angular/core";
+interface OperatorItem {
+    value: Operator;
+    icon: SafeHtml;
+    display: string;
+}
+export 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: import("@angular/core").ModelSignal<Operator | undefined>;
+    /** Danh sách operator cho phép, giữ nguyên thứ tự truyền vào. */
+    operators: import("@angular/core").InputSignal<Operator[]>;
+    /** Vô hiệu hóa trigger (không mở được menu). */
+    disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** data-autoId cho e2e selector. */
+    autoId: import("@angular/core").InputSignal<string | undefined>;
+    /** Allowed operators map sang { value, icon, display } theo thứ tự input. */
+    readonly items: import("@angular/core").Signal<OperatorItem[]>;
+    /** Icon SVG ở trigger — fallback phễu khi model chưa set / không tìm thấy. */
+    readonly currentIcon: import("@angular/core").Signal<SafeHtml>;
+    /** Tooltip = i18n label của operator hiện tại ('' khi chưa chọn). */
+    readonly currentLabel: import("@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: i0.ɵɵFactoryDeclaration<SdOperator, never>;
+    static ɵcmp: i0.ɵɵ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 {};

package/components/preview/index.d.ts

@@ -0,0 +1,4 @@
+export * from './src/preview-image/preview-image.component';
+export * from './src/preview-image/preview-image.types';
+export * from './src/preview-pdf/preview-pdf.component';
+export * from './src/preview-pdf/preview-pdf.types';

package/components/preview/src/preview-image/preview-image.component.d.ts

@@ -0,0 +1,88 @@
+import { OnDestroy } from '@angular/core';
+import { NormalizedImage, PreviewItem, PreviewStage, PreviewTheme, ThumbnailPosition } from './preview-image.types';
+import * as i0 from "@angular/core";
+export declare class SdPreviewImage implements OnDestroy {
+    #private;
+    static readonly MIN_ZOOM = 0.25;
+    static readonly MAX_ZOOM = 4;
+    static readonly ZOOM_STEP = 0.1;
+    static readonly SWIPE_THRESHOLD = 40;
+    readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly autoId: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdPrev: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdNext: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdZoomIn: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdZoomOut: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdFit: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdRotate: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdDownload: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdFullscreen: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdRetry: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdThumb: (i: number) => string | undefined;
+    readonly autoIdDot: (i: number) => string | undefined;
+    readonly items: import("@angular/core").InputSignal<PreviewItem[]>;
+    readonly title: import("@angular/core").InputSignal<string | undefined>;
+    readonly thumbnailPosition: import("@angular/core").InputSignal<ThumbnailPosition>;
+    readonly showToolbar: import("@angular/core").InputSignal<boolean>;
+    readonly downloadable: import("@angular/core").InputSignal<boolean>;
+    readonly zoomable: import("@angular/core").InputSignal<boolean>;
+    readonly loop: import("@angular/core").InputSignal<boolean>;
+    readonly startIndex: import("@angular/core").InputSignal<number>;
+    readonly theme: import("@angular/core").InputSignal<PreviewTheme>;
+    readonly close: import("@angular/core").OutputEmitterRef<void>;
+    readonly activeIndexChange: import("@angular/core").OutputEmitterRef<number>;
+    readonly download: import("@angular/core").OutputEmitterRef<{
+        index: number;
+        item: NormalizedImage;
+    }>;
+    readonly imageError: import("@angular/core").OutputEmitterRef<{
+        index: number;
+        reason: string;
+    }>;
+    readonly activeIndex: import("@angular/core").Signal<number>;
+    readonly images: import("@angular/core").Signal<NormalizedImage[]>;
+    readonly zoom: import("@angular/core").Signal<number>;
+    readonly rotation: import("@angular/core").Signal<number>;
+    readonly pan: import("@angular/core").Signal<{
+        x: number;
+        y: number;
+    }>;
+    readonly stage: import("@angular/core").Signal<PreviewStage>;
+    readonly isFullscreen: import("@angular/core").Signal<boolean>;
+    readonly activeImage: import("@angular/core").Signal<NormalizedImage | undefined>;
+    readonly hasPrev: import("@angular/core").Signal<boolean>;
+    readonly hasNext: import("@angular/core").Signal<boolean>;
+    readonly zoomPercent: import("@angular/core").Signal<number>;
+    readonly imageTransform: import("@angular/core").Signal<string>;
+    readonly shellClass: import("@angular/core").Signal<{
+        [x: string]: boolean;
+        'sd-preview-shell': boolean;
+        'sd-preview-shell--fullscreen': boolean;
+    }>;
+    constructor();
+    ngOnDestroy(): void;
+    onClickThumbnailImage(index: number): void;
+    updateCurrentImage(direction: 1 | -1): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    fitToScreen(): void;
+    rotate(direction: 'left' | 'right'): void;
+    downloadCurrent(): void;
+    toggleFullscreen(): void;
+    /** Retry just the active image (Artboard G action). */
+    retryActive(): Promise<void>;
+    /** User clicked the X button — emit close intent for the consumer to react. */
+    requestClose(): void;
+    onKeyDown(event: KeyboardEvent): void;
+    onWheel(event: WheelEvent): void;
+    onPointerDown(event: PointerEvent): void;
+    onPointerMove(event: PointerEvent): void;
+    onPointerUp(event: PointerEvent): void;
+    onPointerCancel(event: PointerEvent): void;
+    onImageDblClick(): void;
+    onImageError(): void;
+    trackByImage(_i: number, item: NormalizedImage): string;
+    formatBytes(bytes: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdPreviewImage, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdPreviewImage, "sd-preview-image", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "thumbnailPosition": { "alias": "thumbnailPosition"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "downloadable": { "alias": "downloadable"; "required": false; "isSignal": true; }; "zoomable": { "alias": "zoomable"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "startIndex": { "alias": "startIndex"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; }, { "close": "close"; "activeIndexChange": "activeIndexChange"; "download": "download"; "imageError": "imageError"; }, never, never, true, never>;
+}

package/components/preview/src/preview-image/preview-image.types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shape descriptor accepted by SdPreviewImage's `items` signal input.
+ *
+ * - `string` — CDN/HTTP URL; component will fetch as blob and create a File.
+ * - `File` — already-selected file from <input type="file">. Must be `image/*`.
+ * - Detailed object — when the caller wants to override name/caption/alt.
+ */
+export type PreviewItem = string | File | {
+    url?: string;
+    file?: File;
+    name?: string;
+    caption?: string;
+    alt?: string;
+    mime?: string;
+};
+/**
+ * Internal normalized record. One per slot in the gallery.
+ * `blobUrl` is always set after a successful load so the <img> binding can
+ * be uniform; `url` retains the original CDN URL for download fallback.
+ */
+export interface NormalizedImage {
+    id: string;
+    url?: string;
+    blobUrl: string;
+    name: string;
+    size: number;
+    caption?: string;
+    alt?: string;
+    loading: boolean;
+    error: boolean;
+}
+/**
+ * Stage = the visual state of the main image area inside the viewer shell.
+ * Driven by an internal `_stage` signal in the component.
+ */
+export type PreviewStage = 'ready' | 'loading' | 'error' | 'empty';
+/**
+ * Where the thumbnail navigator sits relative to the stage. `none` removes
+ * thumbnails entirely (single-image lightbox); `dots` swaps the strip for
+ * compact dot indicators (≤ 8 images).
+ */
+export type ThumbnailPosition = 'bottom' | 'right' | 'left' | 'top' | 'dots' | 'none';
+/**
+ * Color scheme for the preview shell. `'dark'` (default) keeps the original
+ * dark-theme tokens (black surfaces, white text). `'light'` flips the token
+ * set to white surfaces / dark text — picks up `--sd-primary`, `--sd-error`,
+ * `--sd-success` from the consumer theme when present.
+ *
+ * Exposed via `[attr.data-theme]` on the host so SCSS can swap CSS custom
+ * properties via the `:host([data-theme="light"])` selector — no runtime
+ * style switching is required.
+ */
+export type PreviewTheme = 'dark' | 'light';

package/components/preview/src/preview-pdf/preview-pdf.component.d.ts

@@ -0,0 +1,186 @@
+import { ElementRef, InjectionToken, OnDestroy } from '@angular/core';
+import { PdfErrorEvent, PdfLoadEvent, PdfMeta, PdfScrollMode, PdfSearchResult, PdfSearchState, PdfSidebarMode, PdfSource, PdfStage, PdfZoomMode, PreviewTheme } from './preview-pdf.types';
+import * as i0 from "@angular/core";
+/**
+ * Minimal pdfjs surface the component depends on. We wrap pdfjs in a DI token
+ * so unit tests can supply a hand-rolled mock without going through
+ * jasmine.createSpyObj on the real module (which is harder with ESM).
+ */
+export interface SdPdfJsLib {
+    getDocument: (spec: unknown) => {
+        promise: Promise<unknown>;
+        onProgress?: (p: {
+            loaded: number;
+            total: number;
+        }) => void;
+    };
+    GlobalWorkerOptions: {
+        workerSrc: string;
+    };
+}
+export declare const SD_PDFJS_LIB: InjectionToken<SdPdfJsLib>;
+export declare class SdPreviewPdf implements OnDestroy {
+    #private;
+    static readonly MIN_ZOOM = 0.25;
+    static readonly MAX_ZOOM = 4;
+    static readonly ZOOM_STEP = 0.1;
+    protected readonly pageCanvasRef: import("@angular/core").Signal<ElementRef<HTMLCanvasElement> | undefined>;
+    protected readonly stageEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly pageInputRef: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly searchInputRef: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly thumbCanvases: import("@angular/core").Signal<readonly ElementRef<HTMLCanvasElement>[]>;
+    readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly autoId: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdFirst: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdPrev: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdNext: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdLast: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdPageInput: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdZoomIn: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdZoomOut: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdZoomReadout: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdFitPage: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdFitWidth: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdRotate: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdScrollMode: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchToggle: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdPrint: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdDownload: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdFullscreen: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSidebarToggle: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdTabThumbnails: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdTabOutline: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdTabSearch: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchInput: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchNext: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchPrev: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchCase: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchWhole: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdSearchClose: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdRetry: import("@angular/core").Signal<string | undefined>;
+    readonly autoIdThumb: (i: number) => string | undefined;
+    readonly autoIdResult: (i: number) => string | undefined;
+    readonly source: import("@angular/core").InputSignal<PdfSource | null>;
+    readonly title: import("@angular/core").InputSignal<string | undefined>;
+    readonly startPage: import("@angular/core").InputSignal<number>;
+    readonly initialZoom: import("@angular/core").InputSignal<PdfZoomMode>;
+    readonly sidebar: import("@angular/core").InputSignal<PdfSidebarMode>;
+    readonly sidebarOpen: import("@angular/core").InputSignal<boolean>;
+    readonly scrollMode: import("@angular/core").InputSignal<PdfScrollMode>;
+    readonly showToolbar: import("@angular/core").InputSignal<boolean>;
+    readonly downloadable: import("@angular/core").InputSignal<boolean>;
+    readonly password: import("@angular/core").InputSignal<string | undefined>;
+    readonly httpHeaders: import("@angular/core").InputSignal<Record<string, string> | undefined>;
+    readonly theme: import("@angular/core").InputSignal<PreviewTheme>;
+    readonly close: import("@angular/core").OutputEmitterRef<void>;
+    readonly loaded: import("@angular/core").OutputEmitterRef<PdfLoadEvent>;
+    readonly pageChange: import("@angular/core").OutputEmitterRef<number>;
+    readonly zoomChange: import("@angular/core").OutputEmitterRef<number>;
+    readonly download: import("@angular/core").OutputEmitterRef<{
+        filename: string;
+    }>;
+    readonly loadError: import("@angular/core").OutputEmitterRef<PdfErrorEvent>;
+    readonly searchChange: import("@angular/core").OutputEmitterRef<{
+        term: string;
+        total: number;
+        current: number;
+    }>;
+    readonly stage: import("@angular/core").Signal<PdfStage>;
+    readonly activePage: import("@angular/core").Signal<number>;
+    readonly zoom: import("@angular/core").Signal<number>;
+    readonly zoomMode: import("@angular/core").Signal<PdfZoomMode>;
+    readonly rotation: import("@angular/core").Signal<number>;
+    readonly sidebarMode: import("@angular/core").Signal<PdfSidebarMode>;
+    readonly scrollModeCurrent: import("@angular/core").Signal<PdfScrollMode>;
+    readonly isFullscreen: import("@angular/core").Signal<boolean>;
+    readonly meta: import("@angular/core").Signal<PdfMeta | null>;
+    readonly filename: import("@angular/core").Signal<string>;
+    readonly fileSize: import("@angular/core").Signal<number>;
+    readonly loadError$: import("@angular/core").Signal<PdfErrorEvent | null>;
+    readonly thumbCache: import("@angular/core").Signal<Record<number, string>>;
+    readonly numPages: import("@angular/core").Signal<number>;
+    readonly canPrev: import("@angular/core").Signal<boolean>;
+    readonly canNext: import("@angular/core").Signal<boolean>;
+    readonly zoomPercent: import("@angular/core").Signal<number>;
+    readonly loadPercent: import("@angular/core").Signal<number>;
+    readonly isSidebarOpen: import("@angular/core").Signal<boolean>;
+    readonly pageList: import("@angular/core").Signal<number[]>;
+    readonly pageNumbers: import("@angular/core").Signal<number[]>;
+    readonly searchBarOpen: import("@angular/core").Signal<boolean>;
+    readonly searchTerm: import("@angular/core").Signal<string>;
+    readonly searchResults: import("@angular/core").Signal<PdfSearchResult[]>;
+    readonly searchActiveIndex: import("@angular/core").Signal<number>;
+    readonly searchCaseSensitive: import("@angular/core").Signal<boolean>;
+    readonly searchWholeWord: import("@angular/core").Signal<boolean>;
+    readonly searchTotal: import("@angular/core").Signal<number>;
+    readonly searchCurrent: import("@angular/core").Signal<number>;
+    readonly searchActiveResult: import("@angular/core").Signal<PdfSearchResult | null>;
+    readonly searchState: import("@angular/core").Signal<PdfSearchState>;
+    constructor();
+    ngOnDestroy(): void;
+    goToPage(page: number): void;
+    nextPage(): void;
+    prevPage(): void;
+    firstPage(): void;
+    lastPage(): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    setZoom(mode: PdfZoomMode): void;
+    rotate(direction: 'left' | 'right'): void;
+    toggleSidebar(): void;
+    setSidebarMode(mode: PdfSidebarMode): void;
+    setScrollMode(mode: PdfScrollMode): void;
+    downloadFile(): void;
+    toggleFullscreen(): void;
+    /** Programmatic equivalent of clicking the X — emits the close output. */
+    requestClose(): void;
+    /** Retry the active load attempt (called from the error state retry button). */
+    retryLoad(): void;
+    printFile(): void;
+    /**
+     * Run a full-document search for `term`. Returns the result count.
+     *
+     * Options:
+     * - `caseSensitive`: default off; matches independent of capitalisation.
+     * - `wholeWord`: default off; requires Unicode word-boundary on both sides
+     *   so `cat` does NOT match `category` (uses `/\b...\b/u` so Vietnamese
+     *   diacritic-bearing letters still participate as word characters).
+     *
+     * Implementation: iterate every page once (cached), build a flat plain-text
+     * string per page (joining textItem.str), and slice ~30 chars of context
+     * around each match. We deliberately use plain JS regex rather than
+     * pdf.js's `pdfFindController` — it's <40 lines, fully testable, and
+     * sidesteps the find-controller's dependency on a real text layer (which
+     * we don't render).
+     */
+    search(term: string, options?: {
+        caseSensitive?: boolean;
+        wholeWord?: boolean;
+    }): Promise<number>;
+    searchNext(): void;
+    searchPrev(): void;
+    clearSearch(): void;
+    /** Open the search bar and focus its input. Idempotent. */
+    openSearch(): void;
+    /** Close the search bar AND clear results (mirrors Acrobat behaviour). */
+    closeSearch(): void;
+    toggleSearchCaseSensitive(): void;
+    toggleSearchWholeWord(): void;
+    /** Live binding from the search bar's `(input)` event. */
+    onSearchInput(value: string): void;
+    onKeyDown(event: KeyboardEvent): void;
+    onPageInputEnter(event: Event): void;
+    onPageInputBlur(event: Event): void;
+    onWheel(event: WheelEvent): void;
+    trackByPage(_i: number, page: number): number;
+    /**
+     * Render a single page into a sidebar thumbnail canvas at ~140px width.
+     * Cached via `#thumbsRendering` so rapid scroll bounces don't double-render.
+     *
+     * Visible for testing — tests can stub `getPage()` on the fake doc to
+     * assert this method calls `render(...)` with the right page argument.
+     */
+    renderThumbnailForPage(pageNum: number): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdPreviewPdf, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdPreviewPdf, "sd-preview-pdf", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "source": { "alias": "source"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "startPage": { "alias": "startPage"; "required": false; "isSignal": true; }; "initialZoom": { "alias": "initialZoom"; "required": false; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": false; "isSignal": true; }; "sidebarOpen": { "alias": "sidebarOpen"; "required": false; "isSignal": true; }; "scrollMode": { "alias": "scrollMode"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "downloadable": { "alias": "downloadable"; "required": false; "isSignal": true; }; "password": { "alias": "password"; "required": false; "isSignal": true; }; "httpHeaders": { "alias": "httpHeaders"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; }, { "close": "close"; "loaded": "loaded"; "pageChange": "pageChange"; "zoomChange": "zoomChange"; "download": "download"; "loadError": "loadError"; "searchChange": "searchChange"; }, never, never, true, never>;
+}

package/components/preview/src/preview-pdf/preview-pdf.types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Source descriptor accepted by SdPreviewPdf's `source` signal input.
+ *
+ * Mirrors the input shapes that `pdfjsLib.getDocument()` understands while
+ * adding consumer-friendly variants (raw `File`/`Blob`). The component handles
+ * the bridging internally — caller never touches pdfjs types.
+ */
+export type PdfSource = string | File | Blob | ArrayBuffer | Uint8Array | {
+    url: string;
+    httpHeaders?: Record<string, string>;
+    withCredentials?: boolean;
+} | {
+    data: ArrayBuffer | Uint8Array;
+};
+/**
+ * Zoom expressed either as a raw scale number (1 = 100%) OR a symbolic mode
+ * that auto-fits the stage. The auto modes recompute on container resize +
+ * page change.
+ */
+export type PdfZoomMode = number | 'page-fit' | 'page-width' | 'page-actual';
+/**
+ * Which tab the sidebar shows. `'none'` collapses the sidebar entirely.
+ * NOTE: outline + search tabs are deferred — selecting them shows a placeholder.
+ */
+export type PdfSidebarMode = 'thumbnails' | 'outline' | 'search' | 'none';
+/**
+ * Page layout mode. `'continuous'` is deferred — the input is kept on the
+ * public API so consumer code compiles, but the component falls back to
+ * single-page behavior with a warning.
+ */
+export type PdfScrollMode = 'page' | 'continuous';
+/**
+ * Document-level metadata extracted from `pdfDoc.getMetadata()`.
+ */
+export interface PdfMeta {
+    title?: string;
+    author?: string;
+    subject?: string;
+    numPages: number;
+}
+/** Visual state of the stage. */
+export type PdfStage = 'empty' | 'loading' | 'ready' | 'error';
+/** Classifier for `loadError` output — drives which Artboard H copy renders. */
+export type PdfErrorReason = 'invalid' | 'password' | 'network' | 'unknown';
+/** Fired once after `getDocument()` resolves successfully. */
+export interface PdfLoadEvent {
+    totalPages: number;
+    meta: PdfMeta;
+}
+/** Fired whenever a load attempt rejects. */
+export interface PdfErrorEvent {
+    reason: PdfErrorReason;
+    message?: string;
+}
+/**
+ * One hit returned by `SdPreviewPdf.search()`. `before` / `term` / `after`
+ * are sliced from the original page text so the result list can render a
+ * snippet with the matched substring wrapped in `<mark>` while preserving the
+ * surrounding context (~30 chars each side).
+ *
+ * `textItemIndices` is reserved for the in-page highlight pass — it carries
+ * the indices of the pdfjs text items the match spans across so the renderer
+ * can wrap the right spans without re-running the search per page.
+ */
+export interface PdfSearchResult {
+    page: number;
+    before: string;
+    term: string;
+    after: string;
+    textItemIndices?: number[];
+}
+export type { PreviewTheme } from '../preview-image/preview-image.types';
+/**
+ * Lightweight projection of the internal search state for the
+ * `searchChange` output + the result-list rendering. `activeIndex` is `-1`
+ * when no result is currently focused (e.g. immediately after a `clearSearch`).
+ */
+export interface PdfSearchState {
+    term: string;
+    caseSensitive: boolean;
+    wholeWord: boolean;
+    results: PdfSearchResult[];
+    activeIndex: number;
+}

package/components/query-bar/index.d.ts

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

package/components/query-bar/src/components/actions-bar/actions-bar.component.d.ts

@@ -0,0 +1,28 @@
+import { SdQuery, SdQueryLogic, SdSavedFilter } from '../../query-bar.model';
+import * as i0 from "@angular/core";
+/**
+ * Right-pinned toolbar for `sd-query-bar`: AND/OR connector toggle, clear-all,
+ * saved-filters dropdown (with footer "Lưu bộ lọc hiện tại"), and the deferred
+ * Search trigger. Owns no business logic — just routes user intent back via
+ * outputs (`(logic)` model, `(clear)`, `(search)`, `(applyFilter)`).
+ *
+ * The "save current query" action lives INSIDE the saved-filters mat-menu
+ * footer (one zone for both apply + save). The dropdown trigger sits
+ * immediately before Search so the user sees one filter-cluster on the right.
+ */
+export declare class SdQueryActionsBar {
+    readonly showLogicToggle: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly logic: import("@angular/core").ModelSignal<SdQueryLogic>;
+    readonly filtersCount: import("@angular/core").InputSignal<number>;
+    readonly showSavedFilters: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly savedFiltersKey: import("@angular/core").InputSignal<string | undefined>;
+    readonly query: import("@angular/core").InputSignal<SdQuery<any>>;
+    readonly applyFilter: import("@angular/core").OutputEmitterRef<SdSavedFilter<any>>;
+    readonly showClearAll: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly clear: import("@angular/core").OutputEmitterRef<void>;
+    readonly canSearch: import("@angular/core").InputSignal<boolean>;
+    readonly search: import("@angular/core").OutputEmitterRef<void>;
+    setLogic(value: SdQueryLogic): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdQueryActionsBar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdQueryActionsBar, "sd-query-actions-bar", never, { "showLogicToggle": { "alias": "showLogicToggle"; "required": false; "isSignal": true; }; "logic": { "alias": "logic"; "required": false; "isSignal": true; }; "filtersCount": { "alias": "filtersCount"; "required": false; "isSignal": true; }; "showSavedFilters": { "alias": "showSavedFilters"; "required": false; "isSignal": true; }; "savedFiltersKey": { "alias": "savedFiltersKey"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "showClearAll": { "alias": "showClearAll"; "required": false; "isSignal": true; }; "canSearch": { "alias": "canSearch"; "required": false; "isSignal": true; }; }, { "logic": "logicChange"; "applyFilter": "applyFilter"; "clear": "clear"; "search": "search"; }, never, never, true, never>;
+}