@sdcorejs/angular 21.1.3 → 21.1.4

package/types/sdcorejs-angular-components-preview.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/types/sdcorejs-angular-components-side-drawer.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/types/sdcorejs-angular-components-tab.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/types/sdcorejs-angular-components-table.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 {

package/types/sdcorejs-angular-components-tree.d.ts

@@ -68,6 +68,10 @@ interface SdTreeCommand<T = any> {
 }
 interface SdTreeSelectorOption<T = any> {
     visible?: boolean;
+    /** Keep at most one loaded node selected. Takes precedence over cascade. */
+    single?: boolean;
+    /** Select nodes independently or cascade selection through loaded descendants. */
+    cascade?: 'independent' | 'descendants';
     actions?: SdTreeSelectionAction<T>[];
     message?: string | ((selectedItems: T[]) => string);
     disabled?: (item: T, selectedItems: T[]) => boolean;
@@ -117,6 +121,7 @@ interface SdTreeNode<T = any> {
     hasChildren: boolean;
     isExpanded: boolean;
     isLoading: boolean;
+    loadError?: unknown;
 }
 interface SdTreeItemContext<T = any> {
     $implicit: T;
@@ -127,10 +132,12 @@ interface SdTreeItemContext<T = any> {
     expanded: boolean;
     selected: boolean;
     loading: boolean;
+    loadError?: unknown;
     hasChildren: boolean;
     isLeaf: boolean;
     toggle: () => void;
     select: () => void;
+    retry: () => void;
 }
 type SdTreeItemTemplate<T = any> = TemplateRef<SdTreeItemContext<T>>;
 interface SdTreeSelectionEvent<T = any> {
@@ -143,6 +150,10 @@ interface SdTreeToggleEvent<T = any> {
     expanded: boolean;
     node: SdTreeNode<T>;
 }
+interface SdTreeLoadErrorEvent<T = any> {
+    item?: T;
+    error: unknown;
+}
 
 declare class SdTreeItemDefDirective<T = any> {
     static ngTemplateContextGuard<T>(_dir: SdTreeItemDefDirective<T>, ctx: unknown): ctx is SdTreeItemContext<T>;
@@ -175,12 +186,14 @@ interface SdTreeViewNode<T = any> extends SdTreeNode<T> {
     icon?: string;
     selected: boolean;
     selectionDisabled: boolean;
+    selectionIndeterminate: boolean;
     toggleDisabled: boolean;
     toggleLabel: string;
     ariaExpanded: boolean | null;
     autoIds: SdTreeNodeAutoIds;
     commands: SdTreeViewCommand<T>[];
     context: SdTreeItemContext<T>;
+    tabIndex: 0 | -1;
 }
 interface SdTreeSelectionActionView<T = any> {
     action: SdTreeSelectionAction<T>;
@@ -203,6 +216,7 @@ declare class SdTree<T = any> {
     readonly selectChange: _angular_core.OutputEmitterRef<SdTreeSelectionEvent<T>>;
     readonly expandChange: _angular_core.OutputEmitterRef<SdTreeToggleEvent<T>>;
     readonly collapseChange: _angular_core.OutputEmitterRef<SdTreeToggleEvent<T>>;
+    readonly loadError: _angular_core.OutputEmitterRef<SdTreeLoadErrorEvent<T>>;
     readonly itemDef: _angular_core.Signal<SdTreeItemDefDirective<any> | undefined>;
     readonly resolvedItemsSource: _angular_core.Signal<SdTreeDataSource<SdTreeItem<T>>>;
     readonly resolvedTree: _angular_core.Signal<SdTreeOption<T>>;
@@ -212,6 +226,9 @@ declare class SdTree<T = any> {
     readonly autoId: _angular_core.Signal<string | undefined>;
     readonly resolvedItemTemplate: _angular_core.Signal<TemplateRef<SdTreeItemContext<T>> | undefined>;
     readonly indentSize: _angular_core.Signal<number>;
+    readonly rootLoading: _angular_core.WritableSignal<boolean>;
+    readonly rootError: _angular_core.WritableSignal<unknown>;
+    readonly activeNodeId: _angular_core.WritableSignal<string | null>;
     readonly normalizedFilterText: _angular_core.Signal<string>;
     readonly selectionVisible: _angular_core.Signal<boolean>;
     readonly selectedIdSet: _angular_core.Signal<Set<string>>;
@@ -243,12 +260,17 @@ declare class SdTree<T = any> {
     toggleSelection(node: SdTreeNode<T>, event?: Event): void;
     clearSelection(): void;
     onSelectionAction(action: SdTreeSelectionAction<T>): void;
+    retry(): void;
+    retryNode(node: SdTreeNode<T>, event?: Event): void;
+    errorMessage(error: unknown): string;
+    onRowFocus(node: SdTreeNode<T>): void;
+    onRowKeydown(node: SdTreeNode<T>, event: KeyboardEvent): void;
     createContext(node: SdTreeNode<T>): SdTreeItemContext<T>;
     nodeAutoId(node: SdTreeNode<T>, part: SdTreeAutoIdPart): string | undefined;
     commandAutoId(node: SdTreeNode<T>, command: SdTreeCommand<T>): string | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdTree<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdTree<any>, "sd-tree", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "option": { "alias": "option"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "selectedItemsInput": { "alias": "selectedItems"; "required": false; "isSignal": true; }; "commands": { "alias": "commands"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selector": { "alias": "selector"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; }, { "selectedItemsChange": "selectedItemsChange"; "selectChange": "selectChange"; "expandChange": "expandChange"; "collapseChange": "collapseChange"; }, ["itemDef"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdTree<any>, "sd-tree", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "option": { "alias": "option"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "selectedItemsInput": { "alias": "selectedItems"; "required": false; "isSignal": true; }; "commands": { "alias": "commands"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selector": { "alias": "selector"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; }, { "selectedItemsChange": "selectedItemsChange"; "selectChange": "selectChange"; "expandChange": "expandChange"; "collapseChange": "collapseChange"; "loadError": "loadError"; }, ["itemDef"], never, true, never>;
 }
 
 export { SdTree, SdTreeItemDefDirective };
-export type { SdTreeAutoIdPart, SdTreeBaseOption, SdTreeCommand, SdTreeComponentOption, SdTreeComponentOptionBase, SdTreeDataSource, SdTreeItem, SdTreeItemBase, SdTreeItemByLoadType, SdTreeItemContext, SdTreeItemLazy, SdTreeItemStatic, SdTreeItemTemplate, SdTreeLazyComponentOption, SdTreeLazyOption, SdTreeLoadType, SdTreeNode, SdTreeNodeAutoIds, SdTreeOption, SdTreeSelectionAction, SdTreeSelectionActionView, SdTreeSelectionEvent, SdTreeSelectorOption, SdTreeStaticComponentOption, SdTreeStaticOption, SdTreeToggleEvent, SdTreeViewCommand, SdTreeViewNode };
+export type { SdTreeAutoIdPart, SdTreeBaseOption, SdTreeCommand, SdTreeComponentOption, SdTreeComponentOptionBase, SdTreeDataSource, SdTreeItem, SdTreeItemBase, SdTreeItemByLoadType, SdTreeItemContext, SdTreeItemLazy, SdTreeItemStatic, SdTreeItemTemplate, SdTreeLazyComponentOption, SdTreeLazyOption, SdTreeLoadErrorEvent, SdTreeLoadType, SdTreeNode, SdTreeNodeAutoIds, SdTreeOption, SdTreeSelectionAction, SdTreeSelectionActionView, SdTreeSelectionEvent, SdTreeSelectorOption, SdTreeStaticComponentOption, SdTreeStaticOption, SdTreeToggleEvent, SdTreeViewCommand, SdTreeViewNode };

package/types/sdcorejs-angular-components-upload-file.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, EventEmitter, ChangeDetectorRef, ElementRef } from '@angular/core';
+import { InjectionToken, ElementRef } from '@angular/core';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { FormGroup } from '@angular/forms';
 import { SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
@@ -72,13 +72,14 @@ declare class PreviewComponent {
     #private;
     private cd;
     modal: SdModal;
-    download: EventEmitter<PreviewFile>;
-    close: EventEmitter<void>;
+    readonly download: _angular_core.OutputEmitterRef<PreviewFile>;
+    readonly close: _angular_core.OutputEmitterRef<void>;
     title: string;
     thumbnailPosition: 'right' | 'left' | 'bottom' | 'top';
     activeIndex: number;
     previewFiles: PreviewFile[];
-    constructor(cd: ChangeDetectorRef);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     open: (previewFiles: PreviewFile[] | undefined | null, index?: number) => Promise<void>;
     onClickThumbnailImage: (index: number) => void;
     updateCurrentImage: (direction: 1 | -1) => void;

package/types/sdcorejs-angular-components.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/types/sdcorejs-angular-directives.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnInit, ElementRef, Renderer2, OnChanges, SimpleChanges, TemplateRef } from '@angular/core';
+import { OnInit, OnChanges, SimpleChanges, TemplateRef } from '@angular/core';
 
 declare class SdScrollDirective implements OnInit {
     #private;
@@ -7,7 +7,8 @@ declare class SdScrollDirective implements OnInit {
     private renderer;
     onMouseOver(): void;
     onMouseOut(): void;
-    constructor(elementRef: ElementRef, renderer: Renderer2);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     scrollTop: () => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdScrollDirective, never>;
@@ -32,24 +33,25 @@ declare class SdHoverCopyDirective implements OnInit, OnChanges {
     #private;
     private el;
     private renderer;
-    copyText: string;
-    sdHoverCopyDisabled: boolean;
-    constructor(el: ElementRef, renderer: Renderer2);
+    readonly copyText: i0.InputSignal<string>;
+    readonly sdHoverCopyDisabled: i0.InputSignal<boolean>;
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     onMouseEnter(): void;
     onMouseLeave(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdHoverCopyDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SdHoverCopyDirective, "[sdHoverCopy]", never, { "copyText": { "alias": "sdHoverCopy"; "required": true; }; "sdHoverCopyDisabled": { "alias": "sdHoverCopyDisabled"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdHoverCopyDirective, "[sdHoverCopy]", never, { "copyText": { "alias": "sdHoverCopy"; "required": true; "isSignal": true; }; "sdHoverCopyDisabled": { "alias": "sdHoverCopyDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class SdHrefDirective {
     #private;
-    url: string;
+    readonly url: i0.InputSignal<string>;
     get href(): string;
     onClick(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdHrefDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SdHrefDirective, "a[sdHref]", never, { "url": { "alias": "sdHref"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdHrefDirective, "a[sdHref]", never, { "url": { "alias": "sdHref"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';