@sdcorejs/angular 19.1.2 → 19.1.4

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

@@ -18,17 +18,18 @@ export type PdfSource = string | File | Blob | ArrayBuffer | Uint8Array | {
  * 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.
- */
+/** Which tab the sidebar shows. `'none'` collapses the sidebar entirely. */
 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.
- */
+/** Page layout mode. */
 export type PdfScrollMode = 'page' | 'continuous';
+/** Consumer-facing, recursively resolved PDF document-outline item. */
+export 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()`.
  */
@@ -81,4 +82,5 @@ export interface PdfSearchState {
     wholeWord: boolean;
     results: PdfSearchResult[];
     activeIndex: number;
+    truncated: boolean;
 }

package/components/side-drawer/src/side-drawer.component.d.ts

@@ -1,6 +1,7 @@
 import { CdkPortal } from '@angular/cdk/portal';
 import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
+export type SdSideDrawerBeforeClose = () => boolean | Promise<boolean>;
 export declare class SdSideDrawer {
     #private;
     id: string;
@@ -9,10 +10,12 @@ export declare class SdSideDrawer {
     width: import("@angular/core").InputSignal<string>;
     hideClose: import("@angular/core").InputSignalWithTransform<boolean, boolean | "">;
     disableBackdropClose: import("@angular/core").InputSignalWithTransform<boolean, boolean | "">;
+    beforeClose: import("@angular/core").InputSignal<SdSideDrawerBeforeClose | undefined>;
     drawerClass: import("@angular/core").InputSignal<any>;
     readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
     readonly autoId: import("@angular/core").Signal<string | undefined>;
     sdClosed: import("@angular/core").OutputEmitterRef<void>;
+    sdCloseError: import("@angular/core").OutputEmitterRef<unknown>;
     readonly isOpened: import("@angular/core").Signal<boolean>;
     readonly isLoading: import("@angular/core").Signal<boolean>;
     readonly dataOpened: import("@angular/core").Signal<"true" | "false">;
@@ -21,9 +24,11 @@ export declare class SdSideDrawer {
     constructor();
     open: () => void;
     close: () => void;
+    requestClose: () => Promise<boolean>;
+    forceClose: () => void;
     startLoading: () => void;
     stopLoading: () => void;
     preventScroll: (event: Event) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSideDrawer, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }

package/components/tab/src/tab-group.component.d.ts

@@ -7,6 +7,7 @@ export interface SdTabClosedEvent {
     tab: SdTab;
 }
 export declare class SdTabGroup {
+    #private;
     tabs: import("@angular/core").Signal<readonly SdTab[]>;
     selectedIndex: import("@angular/core").ModelSignal<number>;
     variant: import("@angular/core").InputSignal<"line" | "pills" | "segmented">;

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

@@ -1,13 +1,19 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
+export type SdTabBeforeClose = () => boolean | Promise<boolean>;
 export declare class SdTab {
+    #private;
     label: import("@angular/core").InputSignal<string>;
     icon: import("@angular/core").InputSignal<string | null | undefined>;
     badge: import("@angular/core").InputSignal<string | number | null | undefined>;
     disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     closable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    beforeClose: import("@angular/core").InputSignal<SdTabBeforeClose | undefined>;
     close: import("@angular/core").OutputEmitterRef<void>;
+    closeError: import("@angular/core").OutputEmitterRef<unknown>;
+    requestClose: () => Promise<boolean>;
+    forceClose: () => void;
     bodyTpl: import("@angular/core").Signal<TemplateRef<unknown>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdTab, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }

package/components/tab-router/src/components/tab-router-item/tab-router-item.component.d.ts

@@ -1,7 +1,5 @@
-import { ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
+import { OnDestroy, OnInit } from '@angular/core';
 import { SdTab, SdTabInfo } from '../../models';
-import { SdTabRouterService } from '../../services/tab-router.service';
-import { Router } from '@angular/router';
 import * as i0 from "@angular/core";
 export declare class SdTabRouterItemComponent implements OnInit, OnDestroy {
     #private;
@@ -10,7 +8,8 @@ export declare class SdTabRouterItemComponent implements OnInit, OnDestroy {
     private router;
     tab: SdTab;
     tabInfo?: SdTabInfo;
-    constructor(cdRef: ChangeDetectorRef, tabRouterService: SdTabRouterService, router: Router);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     ngOnDestroy(): void;
     onTabClick: (event: Event) => void;

package/components/tab-router/src/pipes/tab-info.pipe.d.ts

@@ -1,10 +1,10 @@
 import { PipeTransform } from '@angular/core';
 import { SdTab, SdTabInfo } from '../models/tab-router.model';
-import { SdTabRouterService } from '../services/tab-router.service';
 import * as i0 from "@angular/core";
 export declare class SdTabInfoPipe implements PipeTransform {
     private tabRouterService;
-    constructor(tabRouterService: SdTabRouterService);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     transform(tabInfo: SdTabInfo | undefined | null, tab: SdTab): SdTabInfo;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdTabInfoPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<SdTabInfoPipe, "sdTabInfo", true>;

package/components/tab-router/src/services/tab-decorator.service.d.ts

@@ -3,7 +3,8 @@ import { SdTabRouterService } from './tab-router.service';
 import * as i0 from "@angular/core";
 export declare class SdTabDecoratorService {
     static tabRouterService: BehaviorSubject<SdTabRouterService | undefined>;
-    constructor(tabRouterService: SdTabRouterService);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     static ɵfac: i0.ɵɵFactoryDeclaration<SdTabDecoratorService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdTabDecoratorService>;
 }

package/components/table/index.d.ts

@@ -8,4 +8,4 @@ export * from './src/table.component';
 export * from './src/services/table-filter/table-filter.model';
 export type { ISdTableConfiguration } from './src/configurations';
 export { SD_TABLE_CONFIGURATION } from './src/configurations';
-export * from './src/models';
+export type * from './src/models';

package/components/table/src/components/filter/column-filter/column-filter.component.d.ts

@@ -1,5 +1,5 @@
 import { Signal } from '@angular/core';
-import { SdSearch } from '@sdcorejs/angular/forms';
+import type { SdSearch } from '@sdcorejs/angular/forms/models';
 import { Operator } from '@sdcorejs/utils/models';
 import { SdTableColumn } from '../../../models/table-column.model';
 import * as i0 from "@angular/core";

package/components/table/src/components/popup-export/popup-export.component.d.ts

@@ -1,8 +1,7 @@
-import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { MatSelectionList } from '@angular/material/list';
 import { SdModal } from '@sdcorejs/angular/components/modal';
-import { SdConfirmService, SdExcelColumn, SdExcelService, SdLoadingService, SdNotifyService } from '@sdcorejs/angular/services';
+import { SdExcelColumn } from '@sdcorejs/angular/services';
 import { SdTableOption } from '../../models';
 import { ConfiguredTableResult } from '../../models/table-option-config.model';
 import { SdTableOptionExportDefault } from '../../models/table-option-export.model';
@@ -22,7 +21,7 @@ export declare class SdPopupExport {
     listGroups?: MatSelectionList;
     selected: Record<string, boolean>;
     files: any[];
-    export: EventEmitter<{
+    readonly export: import("@angular/core").OutputEmitterRef<{
         file: any | null;
         columns: SdExcelColumn[];
         isCSV?: boolean;
@@ -30,11 +29,12 @@ export declare class SdPopupExport {
     form: FormGroup<{}>;
     exportOption?: SdTableOptionExportDefault;
     set _tableOption(option: SdTableOption);
-    configuration?: ConfiguredTableResult;
+    readonly configuration: import("@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;
@@ -47,5 +47,5 @@ export declare class SdPopupExport {
     createTemplate: () => Promise<void>;
     templateNameValidator: (val: string) => string;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdPopupExport, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdPopupExport, "sd-popup-export", never, { "_tableOption": { "alias": "tableOption"; "required": false; }; "configuration": { "alias": "configuration"; "required": false; }; }, { "export": "export"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdPopupExport, "sd-popup-export", never, { "_tableOption": { "alias": "tableOption"; "required": false; }; "configuration": { "alias": "configuration"; "required": false; "isSignal": true; }; }, { "export": "export"; }, never, never, true, never>;
 }

package/components/table/src/models/index.d.ts

@@ -1,5 +1,5 @@
-export * from './table-option.model';
-export * from './table-column.model';
-export * from './table-command.model';
-export * from './table-option-tree.model';
+export type * from './table-option.model';
+export type * from './table-column.model';
+export type * from './table-command.model';
+export type * from './table-option-tree.model';
 export type { SdTableItem, SdTableMeta, SdTableDisplay } from './table-item.model';

package/components/table/src/models/table-column.model.d.ts

@@ -1,6 +1,6 @@
 import { Signal, TemplateRef } from '@angular/core';
 import { SdBadge } from '@sdcorejs/angular/components/badge';
-import { SdSearch } from '@sdcorejs/angular/forms';
+import type { SdSearch } from '@sdcorejs/angular/forms/models';
 import { NestedKeyOf, Operator } from '@sdcorejs/utils/models';
 import { SdUnwrapSignal } from '@sdcorejs/angular/utilities/models';
 export type SdTableColumn<T = any> = SdTableColumnText<T> | SdTableColumnNumber<T> | SdTableColumnBool<T> | SdTableColumnDate<T> | SdTableColumnValues<T> | SdTableColumnLazyValues<T> | SdTableColumnChildren<T>;

package/components/table/src/services/config.service.d.ts

@@ -1,4 +1,4 @@
-import { SdStorage } from '@sdcorejs/angular/services';
+import { SdStorageWithDefault } from '@sdcorejs/angular/services';
 import { ConfiguredTable, ConfiguredTableResult } from '../models/table-option-config.model';
 import { SdTableOption } from '../models/table-option.model';
 import { ISdTableConfiguration } from '../configurations';
@@ -11,9 +11,10 @@ export declare class ConfigService {
     }>;
     private readonly storageService;
     readonly tableConfiguration: ISdTableConfiguration | null;
+    constructor();
     loadConfiguredTable: (option: SdTableOption) => ConfiguredTable;
     loadConfigurationResult: (option: SdTableOption, configuration: ConfiguredTable) => ConfiguredTableResult;
-    init: (tableOption: SdTableOption) => SdStorage<ConfiguredTable>;
+    init: (tableOption: SdTableOption) => SdStorageWithDefault<ConfiguredTable>;
     persistColumnWidth: (field: string, width: string) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfigService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ConfigService>;

package/components/table/src/services/table-filter/table-filter.model.d.ts

@@ -1,5 +1,5 @@
 import { TemplateRef } from '@angular/core';
-import { SdSearch } from '@sdcorejs/angular/forms';
+import type { SdSearch } from '@sdcorejs/angular/forms/models';
 import { NestedKeyOf, Operator, Order, PagingReq } from '@sdcorejs/utils/models';
 import { Observable } from 'rxjs';
 import { SdTableColumn } from '../../models/table-column.model';

package/components/table/src/services/table-filter/table-filter.service.d.ts

@@ -1,4 +1,3 @@
-import { SdStorageService } from '@sdcorejs/angular/services';
 import { Operator } from '@sdcorejs/utils/models';
 import { SdTableFilterDefDirective } from '../../directives/sd-table-filter-def.directive';
 import { SdTableColumn } from '../../models/table-column.model';
@@ -7,7 +6,8 @@ import * as i0 from "@angular/core";
 export declare class SdTableFilterService {
     #private;
     private storageService;
-    constructor(storageService: SdStorageService);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     register: (filter: SdTableOptionFilter | undefined, args: {
         id: string;
         columns: SdTableColumn[] | undefined;

package/components/tree/index.d.ts

@@ -1,3 +1,3 @@
 export * from './src/tree.component';
 export * from './src/tree-item-def.directive';
-export * from './src/tree.model';
+export type * from './src/tree.model';

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

@@ -1,6 +1,6 @@
 import { TemplateRef } from '@angular/core';
 import { SdTreeItemDefDirective } from './tree-item-def.directive';
-import { SdTreeCommand, SdTreeDataSource, SdTreeComponentOption, SdTreeItem, SdTreeItemContext, SdTreeNode, SdTreeOption, SdTreeSelectionAction, SdTreeSelectionEvent, SdTreeSelectorOption, SdTreeToggleEvent } from './tree.model';
+import { SdTreeCommand, SdTreeDataSource, SdTreeComponentOption, SdTreeItem, SdTreeItemContext, SdTreeLoadErrorEvent, SdTreeNode, SdTreeOption, SdTreeSelectionAction, SdTreeSelectionEvent, SdTreeSelectorOption, SdTreeToggleEvent } from './tree.model';
 import * as i0 from "@angular/core";
 export type SdTreeAutoIdPart = 'row' | 'toggle' | 'checkbox' | 'icon' | 'label' | 'command';
 export interface SdTreeNodeAutoIds {
@@ -26,12 +26,14 @@ export 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;
 }
 export interface SdTreeSelectionActionView<T = any> {
     action: SdTreeSelectionAction<T>;
@@ -54,6 +56,7 @@ export declare class SdTree<T = any> {
     readonly selectChange: import("@angular/core").OutputEmitterRef<SdTreeSelectionEvent<T>>;
     readonly expandChange: import("@angular/core").OutputEmitterRef<SdTreeToggleEvent<T>>;
     readonly collapseChange: import("@angular/core").OutputEmitterRef<SdTreeToggleEvent<T>>;
+    readonly loadError: import("@angular/core").OutputEmitterRef<SdTreeLoadErrorEvent<T>>;
     readonly itemDef: import("@angular/core").Signal<SdTreeItemDefDirective<any> | undefined>;
     readonly resolvedItemsSource: import("@angular/core").Signal<SdTreeDataSource<SdTreeItem<T>>>;
     readonly resolvedTree: import("@angular/core").Signal<SdTreeOption<T>>;
@@ -63,6 +66,9 @@ export declare class SdTree<T = any> {
     readonly autoId: import("@angular/core").Signal<string | undefined>;
     readonly resolvedItemTemplate: import("@angular/core").Signal<TemplateRef<SdTreeItemContext<T>> | undefined>;
     readonly indentSize: import("@angular/core").Signal<number>;
+    readonly rootLoading: import("@angular/core").WritableSignal<boolean>;
+    readonly rootError: import("@angular/core").WritableSignal<unknown>;
+    readonly activeNodeId: import("@angular/core").WritableSignal<string | null>;
     readonly normalizedFilterText: import("@angular/core").Signal<string>;
     readonly selectionVisible: import("@angular/core").Signal<boolean>;
     readonly selectedIdSet: import("@angular/core").Signal<Set<string>>;
@@ -94,9 +100,14 @@ export 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: i0.ɵɵFactoryDeclaration<SdTree<any>, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }

package/components/tree/src/tree.model.d.ts

@@ -66,6 +66,10 @@ export interface SdTreeCommand<T = any> {
 }
 export 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;
@@ -115,6 +119,7 @@ export interface SdTreeNode<T = any> {
     hasChildren: boolean;
     isExpanded: boolean;
     isLoading: boolean;
+    loadError?: unknown;
 }
 export interface SdTreeItemContext<T = any> {
     $implicit: T;
@@ -125,10 +130,12 @@ export interface SdTreeItemContext<T = any> {
     expanded: boolean;
     selected: boolean;
     loading: boolean;
+    loadError?: unknown;
     hasChildren: boolean;
     isLeaf: boolean;
     toggle: () => void;
     select: () => void;
+    retry: () => void;
 }
 export type SdTreeItemTemplate<T = any> = TemplateRef<SdTreeItemContext<T>>;
 export interface SdTreeSelectionEvent<T = any> {
@@ -141,3 +148,7 @@ export interface SdTreeToggleEvent<T = any> {
     expanded: boolean;
     node: SdTreeNode<T>;
 }
+export interface SdTreeLoadErrorEvent<T = any> {
+    item?: T;
+    error: unknown;
+}

package/components/upload-file/src/components/preview/preview.component.d.ts

@@ -1,4 +1,3 @@
-import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { SdModal } from '@sdcorejs/angular/components/modal';
 import { PreviewFile } from '../../services';
 import * as i0 from "@angular/core";
@@ -6,13 +5,14 @@ export declare class PreviewComponent {
     #private;
     private cd;
     modal: SdModal;
-    download: EventEmitter<PreviewFile>;
-    close: EventEmitter<void>;
+    readonly download: import("@angular/core").OutputEmitterRef<PreviewFile>;
+    readonly close: import("@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/directives/src/sd-hover-copy.directive.d.ts

@@ -1,16 +1,17 @@
-import { ElementRef, Renderer2, OnInit, OnChanges, SimpleChanges } from '@angular/core';
+import { OnInit, OnChanges, SimpleChanges } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class SdHoverCopyDirective implements OnInit, OnChanges {
     #private;
     private el;
     private renderer;
-    copyText: string;
-    sdHoverCopyDisabled: boolean;
-    constructor(el: ElementRef, renderer: Renderer2);
+    readonly copyText: import("@angular/core").InputSignal<string>;
+    readonly sdHoverCopyDisabled: import("@angular/core").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>;
 }

package/directives/src/sd-href.directive.d.ts

@@ -1,9 +1,9 @@
 import * as i0 from "@angular/core";
 export declare class SdHrefDirective {
     #private;
-    url: string;
+    readonly url: import("@angular/core").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>;
 }

package/directives/src/sd-scroll.directive.d.ts

@@ -1,4 +1,4 @@
-import { ElementRef, OnInit, Renderer2 } from '@angular/core';
+import { OnInit } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class SdScrollDirective implements OnInit {
     #private;
@@ -6,7 +6,8 @@ export 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>;

package/fesm2022/sdcorejs-angular-components-anchor.mjs

@@ -73,10 +73,10 @@ class SdAnchor {
     sidebarWidth = input('200px');
     ellipsis = input(false, { transform: booleanAttribute });
     overScroll = input(false, { transform: booleanAttribute });
-    // Mobile: default ?n nav (sidebar TOC chi?m ch? tr�n m�n h�nh h?p).
-    // Consumer truy?n `[hideNav]="false"` d? force hi?n tr�n mobile.
+    // Mobile: mặc định ẩn nav (sidebar TOC chiếm chỗ trên màn hình hẹp).
+    // Consumer truyền `[hideNav]="false"` để buộc hiển thị trên mobile.
     hideNav = input(BrowserUtilities.isMobile(), { transform: booleanAttribute });
-    // M�u highlight active nav (text + icon + vertical bar). Default 'primary'.
+    // Màu highlight active nav (text + icon + vertical bar). Default 'primary'.
     color = input('primary');
     activeSectionId = signal('');
     #initialized = false;
@@ -93,7 +93,7 @@ class SdAnchor {
                 this.#registerIntersectionObserver();
             }
         });
-        // L?ng nghe thay d?i sections d? dang k� l?i observe section
+        // Lắng nghe thay đổi sections để đăng ký lại observer cho từng section.
         effect(() => {
             this.sections();
             if (!this.hideNav() && this.#initialized) {
@@ -104,24 +104,24 @@ class SdAnchor {
     #registerIntersectionObserver() {
         this.#cleanIntersectionObserver();
         const wrapperEl = this.wrapper().nativeElement;
-        // Brower API IntersectionObserver s? h? tr? khi n�o 1 section du?c hi?n ra trong wrapperEl
+        // Browser API IntersectionObserver hỗ trợ xác định section đang hiển thị trong wrapperEl.
         this.#intersectionObserver = new IntersectionObserver(entries => {
             for (const entry of entries) {
                 if (entry.isIntersecting) {
-                    // N?u section m?i di v�o v�ng nh�n th?y -> add v�o set
+                    // Nếu section mới đi vào vùng nhìn thấy thì thêm vào set.
                     this.#visibleSections.add(entry.target);
                 }
                 else {
-                    // N?u section d� di ra kh?i v�ng nh�n th?y -> x�a kh?i Set
+                    // Nếu section đã đi ra khỏi vùng nhìn thấy thì xóa khỏi set.
                     this.#visibleSections.delete(entry.target);
                 }
             }
-            // N?u dang scroll b?i click section th� return lu�n, k ph?i qu�t qua t�m v�ng section du?c active
+            // Nếu đang scroll do click section thì không cần quét section đang active.
             if (this.#isClickScrolling) {
                 return;
             }
             for (const section of this.sections()) {
-                // Ki?m tra xem DOM c?a section n�o dang n?m trong danh s�ch dang nh�n th?y d? active ch�nh x�c
+                // Kiểm tra DOM của section nào đang nằm trong danh sách nhìn thấy để active chính xác.
                 if (this.#visibleSections.has(section.elementRef.nativeElement)) {
                     if (this.activeSectionId() !== section.id) {
                         this.activeSectionId.set(section.id);
@@ -130,7 +130,7 @@ class SdAnchor {
                 }
             }
         }, { root: wrapperEl, threshold: 0 });
-        // �ang k� theo d�i t?ng section c� trong anchor
+        // Đăng ký theo dõi từng section có trong anchor.
         for (const section of this.sections()) {
             this.#intersectionObserver.observe(section.elementRef.nativeElement);
         }
@@ -145,15 +145,15 @@ class SdAnchor {
         this.#isClickScrolling = true;
         const wrapperEl = this.wrapper().nativeElement;
         const targetElement = targetSection.nativeElement;
-        const prevScrollTop = wrapperEl.scrollTop; // Luu l?i v? tr� cu?n hi?n t?i c?a container
-        const scrollTop = prevScrollTop + targetElement.getBoundingClientRect().top - wrapperEl.getBoundingClientRect().top; // V? tr� section c?n scroll t?i
-        // �ang k� s? ki?n n?u d� du?c scroll xong
+        const prevScrollTop = wrapperEl.scrollTop; // Lưu lại vị trí cuộn hiện tại của container.
+        const scrollTop = prevScrollTop + targetElement.getBoundingClientRect().top - wrapperEl.getBoundingClientRect().top; // Vị trí section cần scroll tới.
+        // Đăng ký sự kiện khi scroll hoàn tất.
         this.#clickScrollSubscription = fromEvent(wrapperEl, 'scrollend')
             .pipe(take(1))
             .subscribe(() => {
             this.#isClickScrolling = false;
         });
-        // N?u sectionTarget d� ? d�ng v? tr� (click nhung kh�ng scroll) th� sau #timeoutScrollFallback k�ch ho?t l?i IntersectionObserver
+        // Nếu sectionTarget đã ở đúng vị trí (click nhưng không scroll) thì kích hoạt lại IntersectionObserver sau timeout.
         this.#timeoutId = setTimeout(() => {
             if (wrapperEl.scrollTop === prevScrollTop) {
                 this.#isClickScrolling = false;