@sdcorejs/angular 20.1.3 → 20.1.5

package/components/import-excel/index.d.ts

@@ -1,10 +1,7 @@
 import * as i0 from '@angular/core';
-import { PipeTransform, OnInit, OnDestroy, EventEmitter, ChangeDetectorRef } from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
 import { MatPaginator } from '@angular/material/paginator';
 import { SdModal } from '@sdcorejs/angular/components/modal';
-import { SdExcelService } from '@sdcorejs/angular/services/excel';
-import { SdNotifyService } from '@sdcorejs/angular/services/notify';
-import { SdLoadingService } from '@sdcorejs/angular/services/loading';
 
 interface SdImportExcelValidation {
     idx: number;
@@ -109,14 +106,6 @@ interface SdImportExcelItem<T = any> {
     };
 }
 
-declare class ColumnHiddenPipe implements PipeTransform {
-    constructor();
-    transform(column: SdUploadExcelColumn): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ColumnHiddenPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<ColumnHiddenPipe, "columnHidden", true>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ColumnHiddenPipe>;
-}
-
 declare class SdImportExcel implements OnInit, OnDestroy {
     #private;
     private ref;
@@ -139,8 +128,9 @@ declare class SdImportExcel implements OnInit, OnDestroy {
     uploading: boolean;
     isUploaded: boolean;
     isDownloadTemplate: boolean;
-    sdClosed: EventEmitter<any>;
-    constructor(ref: ChangeDetectorRef, excelService: SdExcelService, notifyService: SdNotifyService, columnHiddenPipe: ColumnHiddenPipe, loadingService: SdLoadingService);
+    readonly sdClosed: i0.OutputEmitterRef<void>;
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     ngOnDestroy(): void;
     open: () => void;

package/components/index.d.ts

@@ -25,3 +25,7 @@ export * from '@sdcorejs/angular/components/editor';
 export * from '@sdcorejs/angular/components/splitter';
 export * from '@sdcorejs/angular/components/preview';
 export * from '@sdcorejs/angular/components/autoid-inspector';
+export * from '@sdcorejs/angular/components/breadcrumb';
+export * from '@sdcorejs/angular/components/data-state';
+export * from '@sdcorejs/angular/components/job-progress';
+export * from '@sdcorejs/angular/components/audit-diff';

package/components/job-progress/index.d.ts

@@ -0,0 +1,38 @@
+import * as _angular_core from '@angular/core';
+import { SdTaskState, SdTaskView, SdTaskStatus } from '@sdcorejs/angular/services/task';
+
+type SdJobProgressMode = 'bar' | 'compact' | 'details';
+declare class SdJobProgress {
+    #private;
+    readonly taskId: _angular_core.InputSignal<string | undefined>;
+    readonly state: _angular_core.InputSignal<SdTaskState<unknown> | undefined>;
+    readonly mode: _angular_core.InputSignal<SdJobProgressMode>;
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    readonly message: _angular_core.InputSignal<string | undefined>;
+    readonly showActions: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly sdCancel: _angular_core.OutputEmitterRef<void>;
+    readonly sdRetry: _angular_core.OutputEmitterRef<void>;
+    readonly task: _angular_core.Signal<SdTaskView<unknown> | undefined>;
+    readonly resolvedState: _angular_core.Signal<SdTaskState<unknown> | undefined>;
+    readonly progress: _angular_core.Signal<number | undefined>;
+    readonly effectiveTitle: _angular_core.Signal<string | undefined>;
+    readonly effectiveMessage: _angular_core.Signal<string | undefined>;
+    readonly statusLabel: _angular_core.Signal<string>;
+    readonly progressLabel: _angular_core.Signal<string>;
+    readonly cancelLabel: _angular_core.Signal<string>;
+    readonly retryLabel: _angular_core.Signal<string>;
+    readonly displayedError: _angular_core.Signal<string | undefined>;
+    readonly active: _angular_core.Signal<boolean>;
+    readonly canCancel: _angular_core.Signal<boolean>;
+    readonly canRetry: _angular_core.Signal<boolean>;
+    get modeAttr(): SdJobProgressMode;
+    get statusAttr(): SdTaskStatus;
+    readonly ariaLive = "polite";
+    onCancel(): void;
+    onRetry(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdJobProgress, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdJobProgress, "sd-job-progress", never, { "taskId": { "alias": "taskId"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; }, { "sdCancel": "sdCancel"; "sdRetry": "sdRetry"; }, never, never, true, never>;
+}
+
+export { SdJobProgress };
+export type { SdJobProgressMode };

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

@@ -1,7 +1,7 @@
 import { MentionFeed, MentionFeedObjectItem, EditorConfig, ClassicEditor } from 'ckeditor5';
 export { MentionFeedObjectItem } from 'ckeditor5';
-import * as i0 from '@angular/core';
-import { OnDestroy, EventEmitter } from '@angular/core';
+import * as _angular_core from '@angular/core';
+import { OnDestroy } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 
 type SdMiniEditorOutputFormat = 'html' | 'markdown';
@@ -69,15 +69,15 @@ declare class SdMiniEditor implements ControlValueAccessor, OnDestroy {
     get maxEditorHeight(): string | undefined;
     /** NgModel binding - nội dung HTML/Markdown */
     value: string;
-    valueChange: EventEmitter<string>;
+    readonly valueChange: _angular_core.OutputEmitterRef<string>;
     /** Event emitter khi content thay đổi */
-    contentChange: EventEmitter<string>;
+    readonly contentChange: _angular_core.OutputEmitterRef<string>;
     /** Event emitter khi blur */
-    blur: EventEmitter<FocusEvent>;
+    readonly blur: _angular_core.OutputEmitterRef<FocusEvent>;
     /** Event emitter khi focus */
-    focus: EventEmitter<FocusEvent>;
+    readonly focus: _angular_core.OutputEmitterRef<FocusEvent>;
     /** Disabled state */
-    disabled: boolean;
+    readonly disabled: _angular_core.InputSignal<boolean>;
     Editor: typeof ClassicEditor;
     get editorConfig(): SdMiniEditorConfig;
     constructor();
@@ -130,8 +130,8 @@ declare class SdMiniEditor implements ControlValueAccessor, OnDestroy {
      * 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>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdMiniEditor, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdMiniEditor, "sd-mini-editor", never, { "option": { "alias": "option"; "required": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "contentChange": "contentChange"; "blur": "blur"; "focus": "focus"; }, never, never, true, never>;
 }
 
 export { SdMiniEditor };

package/components/modal/index.d.ts

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { TemplateRef, ElementRef } from '@angular/core';
 import { Color } from '@sdcorejs/utils/models';
 
+type SdModalBeforeClose = () => boolean | Promise<boolean>;
 declare class SdModal {
     #private;
     static index: _angular_core.WritableSignal<number>;
@@ -20,14 +21,19 @@ declare class SdModal {
     lazyLoadContent: _angular_core.InputSignalWithTransform<boolean, unknown>;
     hideClose: _angular_core.InputSignalWithTransform<boolean, boolean | "">;
     disableBackdropClose: _angular_core.InputSignalWithTransform<boolean, boolean | "">;
+    beforeClose: _angular_core.InputSignal<SdModalBeforeClose | undefined>;
     sdClosed: _angular_core.OutputEmitterRef<void>;
+    sdCloseError: _angular_core.OutputEmitterRef<unknown>;
     isOpened: _angular_core.WritableSignal<boolean>;
     alreadyOpened: _angular_core.WritableSignal<boolean>;
     constructor();
     open: () => void;
     close: () => void;
+    requestClose: () => Promise<boolean>;
+    forceClose: () => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdModal, never>;
-    static ɵcmp: _angular_core.ɵɵ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]", "*", "[sdFooterLeft]", "[sdFooterRight]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵ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; }; "beforeClose": { "alias": "beforeClose"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; "sdCloseError": "sdCloseError"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "*", "[sdFooterLeft]", "[sdFooterRight]"], true, never>;
 }
 
 export { SdModal };
+export type { SdModalBeforeClose };

package/components/preview/index.d.ts

@@ -161,17 +161,18 @@ type PdfSource = string | File | Blob | ArrayBuffer | Uint8Array | {
  * page change.
  */
 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.
- */
+/** Which tab the sidebar shows. `'none'` collapses the sidebar entirely. */
 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.
- */
+/** Page layout mode. */
 type PdfScrollMode = 'page' | 'continuous';
+/** Consumer-facing, recursively resolved PDF document-outline item. */
+interface PdfOutlineItem {
+    readonly id: string;
+    readonly title: string;
+    readonly page: number | null;
+    readonly url?: string;
+    readonly children: readonly PdfOutlineItem[];
+}
 /**
  * Document-level metadata extracted from `pdfDoc.getMetadata()`.
  */
@@ -224,35 +225,115 @@ interface PdfSearchState {
     wholeWord: boolean;
     results: PdfSearchResult[];
     activeIndex: number;
+    truncated: boolean;
 }
 
-/**
- * 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).
- */
+interface SdPdfRenderTask {
+    readonly promise: Promise<void>;
+    cancel(): void;
+}
+interface SdPdfViewport {
+    readonly width: number;
+    readonly height: number;
+}
+interface SdPdfTextItem {
+    readonly str: string;
+}
+interface SdPdfTextContent {
+    readonly items: readonly unknown[];
+}
+interface SdPdfPageProxy {
+    getViewport(parameters: {
+        scale: number;
+        rotation?: number;
+    }): SdPdfViewport;
+    render(parameters: {
+        canvasContext: CanvasRenderingContext2D;
+        viewport: SdPdfViewport;
+    }): SdPdfRenderTask;
+    getTextContent(): Promise<SdPdfTextContent | unknown>;
+    cleanup(): void;
+}
+interface SdPdfReference {
+    readonly num: number;
+    readonly gen: number;
+}
+type SdPdfDestination = string | readonly unknown[] | null;
+interface SdPdfRawOutlineItem {
+    readonly title?: string;
+    readonly dest?: SdPdfDestination;
+    readonly url?: string | null;
+    readonly items?: readonly SdPdfRawOutlineItem[];
+}
+interface SdPdfDocumentProxy {
+    readonly numPages: number;
+    getPage(pageNumber: number): Promise<SdPdfPageProxy>;
+    getMetadata(): Promise<{
+        readonly info?: {
+            readonly Title?: string;
+            readonly Author?: string;
+            readonly Subject?: string;
+        };
+    }>;
+    getOutline(): Promise<readonly SdPdfRawOutlineItem[] | null>;
+    getDestination(name: string): Promise<readonly unknown[] | null>;
+    getPageIndex(reference: SdPdfReference): Promise<number>;
+    cachedPageNumber(reference: SdPdfReference): number | null;
+    getData(): Promise<Uint8Array>;
+    destroy(): Promise<void>;
+}
+interface SdPdfLoadingTask {
+    readonly promise: Promise<SdPdfDocumentProxy>;
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+    }) => void;
+    destroy?(): Promise<void> | void;
+}
+interface SdPdfDocumentSpec {
+    url?: string;
+    data?: Uint8Array;
+    httpHeaders?: Record<string, string>;
+    withCredentials?: boolean;
+    password?: string;
+}
 interface SdPdfJsLib {
-    getDocument: (spec: unknown) => {
-        promise: Promise<unknown>;
-        onProgress?: (p: {
-            loaded: number;
-            total: number;
-        }) => void;
-    };
-    GlobalWorkerOptions: {
+    getDocument(spec: SdPdfDocumentSpec): SdPdfLoadingTask;
+    readonly GlobalWorkerOptions: {
         workerSrc: string;
     };
 }
 declare const SD_PDFJS_LIB: InjectionToken<SdPdfJsLib>;
-declare class SdPreviewPdf implements OnDestroy {
+
+interface PdfOutlineRow {
+    readonly item: PdfOutlineItem;
+    readonly level: number;
+    readonly parentId: string | null;
+}
+type PdfSidebarTabMode = Exclude<PdfSidebarMode, 'none'>;
+declare class SdPreviewPdf {
     #private;
     static readonly MIN_ZOOM = 0.25;
     static readonly MAX_ZOOM = 4;
     static readonly ZOOM_STEP = 0.1;
+    static readonly OUTLINE_MAX_DEPTH = 64;
+    static readonly OUTLINE_MAX_NODES = 10000;
+    static readonly MAX_SEARCH_RESULTS = 1000;
+    static readonly MAX_PAGE_TEXT_CACHE_PAGES = 128;
+    static readonly THUMBNAIL_WINDOW_SIZE = 48;
+    static readonly THUMBNAIL_ITEM_HEIGHT = 220;
+    static readonly MAX_THUMBNAIL_CACHE_ENTRIES = 96;
+    private static readonly MAX_CONCURRENT_THUMBNAIL_WORK;
+    static readonly MAX_CANVAS_DIMENSION = 8192;
+    static readonly MAX_CANVAS_PIXELS = 16777216;
     protected readonly pageCanvasRef: _angular_core.Signal<ElementRef<HTMLCanvasElement> | undefined>;
     protected readonly stageEl: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
     protected readonly pageInputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly searchInputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly sidebarContentRef: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly outlineItemRefs: _angular_core.Signal<readonly ElementRef<HTMLElement>[]>;
+    protected readonly sidebarTabRefs: _angular_core.Signal<readonly ElementRef<HTMLButtonElement>[]>;
+    protected readonly continuousCanvases: _angular_core.Signal<readonly ElementRef<HTMLCanvasElement>[]>;
     protected readonly thumbCanvases: _angular_core.Signal<readonly ElementRef<HTMLCanvasElement>[]>;
     readonly autoIdInput: _angular_core.InputSignal<string | null | undefined>;
     readonly autoId: _angular_core.Signal<string | undefined>;
@@ -276,6 +357,13 @@ declare class SdPreviewPdf implements OnDestroy {
     readonly autoIdTabThumbnails: _angular_core.Signal<string | undefined>;
     readonly autoIdTabOutline: _angular_core.Signal<string | undefined>;
     readonly autoIdTabSearch: _angular_core.Signal<string | undefined>;
+    readonly sidebarPanelId: _angular_core.Signal<string>;
+    readonly sidebarRegionId: _angular_core.Signal<string>;
+    readonly searchBarId: _angular_core.Signal<string>;
+    readonly tabThumbnailsId: _angular_core.Signal<string>;
+    readonly tabOutlineId: _angular_core.Signal<string>;
+    readonly tabSearchId: _angular_core.Signal<string>;
+    readonly sidebarActiveTabId: _angular_core.Signal<string>;
     readonly autoIdSearchInput: _angular_core.Signal<string | undefined>;
     readonly autoIdSearchNext: _angular_core.Signal<string | undefined>;
     readonly autoIdSearchPrev: _angular_core.Signal<string | undefined>;
@@ -309,6 +397,7 @@ declare class SdPreviewPdf implements OnDestroy {
         term: string;
         total: number;
         current: number;
+        truncated: boolean;
     }>;
     readonly stage: _angular_core.Signal<PdfStage>;
     readonly activePage: _angular_core.Signal<number>;
@@ -323,14 +412,28 @@ declare class SdPreviewPdf implements OnDestroy {
     readonly fileSize: _angular_core.Signal<number>;
     readonly loadError$: _angular_core.Signal<PdfErrorEvent | null>;
     readonly thumbCache: _angular_core.Signal<Record<number, string>>;
+    readonly thumbnailWorkCount: _angular_core.Signal<number>;
+    readonly pageTextCacheSize: _angular_core.Signal<number>;
+    readonly continuousPages: _angular_core.Signal<number[]>;
+    readonly continuousTopSpacer: _angular_core.Signal<number>;
+    readonly continuousBottomSpacer: _angular_core.Signal<number>;
+    readonly continuousPageHeights: _angular_core.Signal<Record<number, number>>;
+    readonly outline: _angular_core.Signal<readonly PdfOutlineItem[]>;
+    readonly outlineFocusId: _angular_core.Signal<string | null>;
+    readonly visibleOutline: _angular_core.Signal<readonly PdfOutlineRow[]>;
     readonly numPages: _angular_core.Signal<number>;
     readonly canPrev: _angular_core.Signal<boolean>;
     readonly canNext: _angular_core.Signal<boolean>;
     readonly zoomPercent: _angular_core.Signal<number>;
     readonly loadPercent: _angular_core.Signal<number>;
     readonly isSidebarOpen: _angular_core.Signal<boolean>;
+    readonly canDownload: _angular_core.Signal<boolean>;
+    readonly canFullscreen: _angular_core.Signal<boolean>;
+    readonly canPrint: _angular_core.Signal<boolean>;
     readonly pageList: _angular_core.Signal<number[]>;
     readonly pageNumbers: _angular_core.Signal<number[]>;
+    readonly thumbnailTopSpacer: _angular_core.Signal<number>;
+    readonly thumbnailBottomSpacer: _angular_core.Signal<number>;
     readonly searchBarOpen: _angular_core.Signal<boolean>;
     readonly searchTerm: _angular_core.Signal<string>;
     readonly searchResults: _angular_core.Signal<PdfSearchResult[]>;
@@ -338,11 +441,11 @@ declare class SdPreviewPdf implements OnDestroy {
     readonly searchCaseSensitive: _angular_core.Signal<boolean>;
     readonly searchWholeWord: _angular_core.Signal<boolean>;
     readonly searchTotal: _angular_core.Signal<number>;
+    readonly searchTruncated: _angular_core.Signal<boolean>;
     readonly searchCurrent: _angular_core.Signal<number>;
     readonly searchActiveResult: _angular_core.Signal<PdfSearchResult | null>;
     readonly searchState: _angular_core.Signal<PdfSearchState>;
     constructor();
-    ngOnDestroy(): void;
     goToPage(page: number): void;
     nextPage(): void;
     prevPage(): void;
@@ -354,14 +457,23 @@ declare class SdPreviewPdf implements OnDestroy {
     rotate(direction: 'left' | 'right'): void;
     toggleSidebar(): void;
     setSidebarMode(mode: PdfSidebarMode): void;
+    onSidebarTabKeyDown(event: KeyboardEvent, currentMode: PdfSidebarTabMode): void;
+    onThumbnailSidebarScroll(event: Event): void;
     setScrollMode(mode: PdfScrollMode): void;
     downloadFile(): void;
+    downloadFileAsync(): Promise<boolean>;
     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;
+    print(): Promise<void>;
+    isOutlineExpanded(id: string): boolean;
+    toggleOutlineItem(id: string, event?: Event): void;
+    focusOutlineItem(id: string): void;
+    activateOutlineItem(id: string): void;
+    onOutlineKeyDown(event: KeyboardEvent, id: string): void;
     /**
      * Run a full-document search for `term`. Returns the result count.
      *
@@ -384,6 +496,7 @@ declare class SdPreviewPdf implements OnDestroy {
     }): Promise<number>;
     searchNext(): void;
     searchPrev(): void;
+    activateSearchResult(index: number): void;
     clearSearch(): void;
     /** Open the search bar and focus its input. Idempotent. */
     openSearch(): void;
@@ -392,15 +505,17 @@ declare class SdPreviewPdf implements OnDestroy {
     toggleSearchCaseSensitive(): void;
     toggleSearchWholeWord(): void;
     /** Live binding from the search bar's `(input)` event. */
-    onSearchInput(value: string): void;
+    onSearchInput(event: Event): void;
     onKeyDown(event: KeyboardEvent): void;
     onPageInputEnter(event: Event): void;
     onPageInputBlur(event: Event): void;
     onWheel(event: WheelEvent): void;
     trackByPage(_i: number, page: number): number;
+    onStageScroll(): void;
     /**
      * Render a single page into a sidebar thumbnail canvas at ~140px width.
-     * Cached via `#thumbsRendering` so rapid scroll bounces don't double-render.
+     * Reserved in `#thumbnailWork` before getPage() so rapid scroll bounces
+     * cannot start duplicate work for the same mounted page.
      *
      * Visible for testing — tests can stub `getPage()` on the fake doc to
      * assert this method calls `render(...)` with the right page argument.
@@ -410,5 +525,43 @@ declare class SdPreviewPdf implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵ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>;
 }
 
-export { SD_PDFJS_LIB, SdPreviewImage, SdPreviewPdf };
-export type { NormalizedImage, PdfErrorEvent, PdfErrorReason, PdfLoadEvent, PdfMeta, PdfScrollMode, PdfSearchResult, PdfSearchState, PdfSidebarMode, PdfSource, PdfStage, PdfZoomMode, PreviewItem, PreviewStage, PreviewTheme, SdPdfJsLib, ThumbnailPosition };
+interface SdPdfIntersectionEntry {
+    readonly target: Element;
+    readonly isIntersecting: boolean;
+}
+interface SdPdfBrowserAdapter {
+    readonly isBrowser: boolean;
+    /** The platform can trigger an anchor download for an existing URL. */
+    readonly canDownloadUrl: boolean;
+    /** The platform can create/revoke an object URL and then download it. */
+    readonly canDownloadBlob: boolean;
+    readonly canFullscreen: boolean;
+    isFile(value: unknown): value is File;
+    isBlob(value: unknown): value is Blob;
+    createPdfBlob(data: Uint8Array): Blob | null;
+    createObjectUrl(blob: Blob): string | null;
+    revokeObjectUrl(url: string): void;
+    download(href: string, filename: string): boolean;
+    createElement<K extends keyof HTMLElementTagNameMap>(tagName: K): HTMLElementTagNameMap[K] | null;
+    createImage(): HTMLImageElement | null;
+    listenFullscreen(host: HTMLElement, listener: (active: boolean) => void): () => void;
+    toggleFullscreen(host: HTMLElement): Promise<void>;
+    observeResize(element: Element, listener: () => void): () => void;
+    observeIntersections(elements: readonly Element[], listener: (entries: readonly SdPdfIntersectionEntry[]) => void, options?: IntersectionObserverInit): () => void;
+    scheduleFrame(callback: FrameRequestCallback): number | null;
+    cancelFrame(handle: number | null): void;
+}
+declare const SD_PDF_BROWSER_ADAPTER: InjectionToken<SdPdfBrowserAdapter>;
+
+interface SdPdfPrintJob {
+    readonly finished: Promise<void>;
+    cancel(): void;
+}
+interface SdPdfPrintAdapter {
+    readonly isSupported: boolean;
+    start(data: Uint8Array, filename: string): SdPdfPrintJob | null;
+}
+declare const SD_PDF_PRINT_ADAPTER: InjectionToken<SdPdfPrintAdapter>;
+
+export { SD_PDFJS_LIB, SD_PDF_BROWSER_ADAPTER, SD_PDF_PRINT_ADAPTER, SdPreviewImage, SdPreviewPdf };
+export type { NormalizedImage, PdfErrorEvent, PdfErrorReason, PdfLoadEvent, PdfMeta, PdfOutlineItem, PdfScrollMode, PdfSearchResult, PdfSearchState, PdfSidebarMode, PdfSource, PdfStage, PdfZoomMode, PreviewItem, PreviewStage, PreviewTheme, SdPdfBrowserAdapter, SdPdfDestination, SdPdfDocumentProxy, SdPdfDocumentSpec, SdPdfIntersectionEntry, SdPdfJsLib, SdPdfLoadingTask, SdPdfPageProxy, SdPdfPrintAdapter, SdPdfPrintJob, SdPdfRawOutlineItem, SdPdfReference, SdPdfRenderTask, SdPdfTextContent, SdPdfTextItem, SdPdfViewport, ThumbnailPosition };

package/components/side-drawer/index.d.ts

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { CdkPortal } from '@angular/cdk/portal';
 import { Observable } from 'rxjs';
 
+type SdSideDrawerBeforeClose = () => boolean | Promise<boolean>;
 declare class SdSideDrawer {
     #private;
     id: string;
@@ -10,10 +11,12 @@ declare class SdSideDrawer {
     width: _angular_core.InputSignal<string>;
     hideClose: _angular_core.InputSignalWithTransform<boolean, boolean | "">;
     disableBackdropClose: _angular_core.InputSignalWithTransform<boolean, boolean | "">;
+    beforeClose: _angular_core.InputSignal<SdSideDrawerBeforeClose | undefined>;
     drawerClass: _angular_core.InputSignal<any>;
     readonly autoIdInput: _angular_core.InputSignal<string | null | undefined>;
     readonly autoId: _angular_core.Signal<string | undefined>;
     sdClosed: _angular_core.OutputEmitterRef<void>;
+    sdCloseError: _angular_core.OutputEmitterRef<unknown>;
     readonly isOpened: _angular_core.Signal<boolean>;
     readonly isLoading: _angular_core.Signal<boolean>;
     readonly dataOpened: _angular_core.Signal<"true" | "false">;
@@ -22,11 +25,14 @@ declare class SdSideDrawer {
     constructor();
     open: () => void;
     close: () => void;
+    requestClose: () => Promise<boolean>;
+    forceClose: () => void;
     startLoading: () => void;
     stopLoading: () => void;
     preventScroll: (event: Event) => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdSideDrawer, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdSideDrawer, "sd-side-drawer", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; "disableBackdropClose": { "alias": "disableBackdropClose"; "required": false; "isSignal": true; }; "drawerClass": { "alias": "drawerClass"; "required": false; "isSignal": true; }; "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "*", "[sdFooterLeft]", "[sdFooterRight]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdSideDrawer, "sd-side-drawer", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; "disableBackdropClose": { "alias": "disableBackdropClose"; "required": false; "isSignal": true; }; "beforeClose": { "alias": "beforeClose"; "required": false; "isSignal": true; }; "drawerClass": { "alias": "drawerClass"; "required": false; "isSignal": true; }; "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; "sdCloseError": "sdCloseError"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "*", "[sdFooterLeft]", "[sdFooterRight]"], true, never>;
 }
 
 export { SdSideDrawer };
+export type { SdSideDrawerBeforeClose };

package/components/tab/index.d.ts

@@ -3,16 +3,22 @@ import { TemplateRef } from '@angular/core';
 import { MatTabGroup } from '@angular/material/tabs';
 import { Color } from '@sdcorejs/utils/models';
 
+type SdTabBeforeClose = () => boolean | Promise<boolean>;
 declare class SdTab {
+    #private;
     label: _angular_core.InputSignal<string>;
     icon: _angular_core.InputSignal<string | null | undefined>;
     badge: _angular_core.InputSignal<string | number | null | undefined>;
     disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    beforeClose: _angular_core.InputSignal<SdTabBeforeClose | undefined>;
     close: _angular_core.OutputEmitterRef<void>;
+    closeError: _angular_core.OutputEmitterRef<unknown>;
+    requestClose: () => Promise<boolean>;
+    forceClose: () => void;
     bodyTpl: _angular_core.Signal<TemplateRef<unknown>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdTab, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdTab, "sd-tab", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; }, { "close": "close"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdTab, "sd-tab", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "beforeClose": { "alias": "beforeClose"; "required": false; "isSignal": true; }; }, { "close": "close"; "closeError": "closeError"; }, never, ["*"], true, never>;
 }
 
 interface SdTabClosedEvent {
@@ -20,6 +26,7 @@ interface SdTabClosedEvent {
     tab: SdTab;
 }
 declare class SdTabGroup {
+    #private;
     tabs: _angular_core.Signal<readonly SdTab[]>;
     selectedIndex: _angular_core.ModelSignal<number>;
     variant: _angular_core.InputSignal<"line" | "pills" | "segmented">;
@@ -49,4 +56,4 @@ declare class SdTabGroup {
 }
 
 export { SdTab, SdTabGroup };
-export type { SdTabClosedEvent };
+export type { SdTabBeforeClose, SdTabClosedEvent };

package/components/table/index.d.ts

@@ -1,13 +1,13 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, Signal, EventEmitter, ChangeDetectorRef, InjectionToken, AfterViewInit, OnDestroy } from '@angular/core';
+import { TemplateRef, Signal, InjectionToken, AfterViewInit, OnDestroy } from '@angular/core';
 import { SdBadge } from '@sdcorejs/angular/components/badge';
-import { SdSearch } from '@sdcorejs/angular/forms';
+import { SdSearch } from '@sdcorejs/angular/forms/models';
 import { Operator, NestedKeyOf, Order, PagingReq, Color } from '@sdcorejs/utils/models';
 import { SdUnwrapSignal } from '@sdcorejs/angular/utilities/models';
 import { MatPaginatorIntl, MatPaginator } from '@angular/material/paginator';
 import { MatSort } from '@angular/material/sort';
 import { MatTable } from '@angular/material/table';
-import { SdExcelColumn, SdLoadingService, SdExcelService, SdNotifyService, SdConfirmService } from '@sdcorejs/angular/services';
+import { SdExcelColumn } from '@sdcorejs/angular/services';
 import { Observable } from 'rxjs';
 import { SdIconSet } from '@sdcorejs/angular/modules/icon';
 import { SdButton } from '@sdcorejs/angular/components/button';
@@ -1077,7 +1077,7 @@ declare class SdPopupExport {
     listGroups?: MatSelectionList;
     selected: Record<string, boolean>;
     files: any[];
-    export: EventEmitter<{
+    readonly export: _angular_core.OutputEmitterRef<{
         file: any | null;
         columns: SdExcelColumn[];
         isCSV?: boolean;
@@ -1085,11 +1085,12 @@ declare class SdPopupExport {
     form: FormGroup<{}>;
     exportOption?: SdTableOptionExportDefault;
     set _tableOption(option: SdTableOption);
-    configuration?: ConfiguredTableResult;
+    readonly configuration: _angular_core.InputSignal<ConfiguredTableResult | undefined>;
     private get key();
     private get tableColumns();
     private get additionalColumns();
-    constructor(ref: ChangeDetectorRef, loadingService: SdLoadingService, excelService: SdExcelService, notifyService: SdNotifyService, confirmService: SdConfirmService);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     open: () => Promise<void>;
     exportDefault: () => void;
     exportCSV: () => void;
@@ -1102,7 +1103,7 @@ declare class SdPopupExport {
     createTemplate: () => Promise<void>;
     templateNameValidator: (val: string) => string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdPopupExport, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdPopupExport, "sd-popup-export", never, { "_tableOption": { "alias": "tableOption"; "required": false; }; "configuration": { "alias": "configuration"; "required": false; }; }, { "export": "export"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdPopupExport, "sd-popup-export", never, { "_tableOption": { "alias": "tableOption"; "required": false; }; "configuration": { "alias": "configuration"; "required": false; "isSignal": true; }; }, { "export": "export"; }, never, never, true, never>;
 }
 
 interface ISdTableConfiguration {