@sd-angular/core 19.0.0-beta.93 → 19.0.0-beta.95

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

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

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

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

package/components/quick-action/src/quick-action.component.d.ts

@@ -1,10 +1,9 @@
 import * as i0 from "@angular/core";
 export declare class SdQuickAction {
-    isOpened: boolean;
-    set _isOpened(isOpened: '' | boolean | undefined | null);
-    constructor();
-    open: () => void;
-    close: () => void;
+    /**
+     * Toggle visibility of the floating toolbar. Bare attribute = true.
+     */
+    readonly opened: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdQuickAction, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdQuickAction, "sd-quick-action", never, { "_isOpened": { "alias": "isOpened"; "required": false; }; }, {}, never, ["[sdMessage]", "[sdAction]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdQuickAction, "sd-quick-action", never, { "opened": { "alias": "opened"; "required": false; "isSignal": true; }; }, {}, never, ["[sdMessage]", "[sdAction]"], true, never>;
 }

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

@@ -1,5 +1,5 @@
 import { SdSplitterPanelComponent } from './splitter-panel/splitter-panel.component';
-import { SplitterOrientation } from './splitter.models';
+import { SplitterLayoutState, SplitterOrientation } from './splitter.models';
 import * as i0 from "@angular/core";
 export declare class SdSplitterComponent {
     #private;
@@ -8,8 +8,21 @@ export declare class SdSplitterComponent {
     storageKey: import("@angular/core").InputSignal<string | undefined>;
     snapThreshold: import("@angular/core").InputSignalWithTransform<number, unknown>;
     keyboardStep: import("@angular/core").InputSignalWithTransform<number, unknown>;
+    readonly resizeEnd: import("@angular/core").OutputEmitterRef<SplitterLayoutState>;
+    readonly collapsedChange: import("@angular/core").OutputEmitterRef<{
+        panelId: string | number;
+        collapsed: boolean;
+    }>;
+    readonly layoutChange: import("@angular/core").OutputEmitterRef<SplitterLayoutState>;
     readonly panels: import("@angular/core").Signal<readonly SdSplitterPanelComponent[]>;
     constructor();
+    getLayout(): SplitterLayoutState;
+    setLayout(state: SplitterLayoutState): void;
+    resetLayout(): void;
+    collapse(target: number | string): void;
+    expand(target: number | string): void;
+    toggle(target: number | string): void;
+    resizePanel(target: number | string, size: number): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSplitterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdSplitterComponent, "sd-splitter", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "snapThreshold": { "alias": "snapThreshold"; "required": false; "isSignal": true; }; "keyboardStep": { "alias": "keyboardStep"; "required": false; "isSignal": true; }; }, {}, ["panels"], ["sd-splitter-panel"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSplitterComponent, "sd-splitter", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "snapThreshold": { "alias": "snapThreshold"; "required": false; "isSignal": true; }; "keyboardStep": { "alias": "keyboardStep"; "required": false; "isSignal": true; }; }, { "resizeEnd": "resizeEnd"; "collapsedChange": "collapsedChange"; "layoutChange": "layoutChange"; }, ["panels"], ["sd-splitter-panel"], true, never>;
 }

package/components/table/src/components/selector-action/selector-action.component.d.ts

@@ -4,6 +4,7 @@ import { SdTableOption } from '../../models/table-option.model';
 import { Action } from './action-filter.pipe';
 import * as i0 from "@angular/core";
 export declare class SelectorActionComponent {
+    #private;
     tableOption: import("@angular/core").InputSignal<SdTableOption | undefined>;
     selectedTableItems: import("@angular/core").InputSignal<SdTableItem<any>[] | undefined>;
     clear: EventEmitter<any>;

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

@@ -24,6 +24,7 @@ import { SdTableItem } from './models/table-item.model';
 import { ConfiguredTableResult } from './models/table-option-config.model';
 import * as i0 from "@angular/core";
 export declare class MatPaginatorIntlCro extends MatPaginatorIntl {
+    #private;
     firstPageLabel: string;
     lastPageLabel: string;
     itemsPerPageLabel: string;
@@ -61,9 +62,7 @@ export declare class SdTable<T = unknown> extends SdBaseSecureComponent implemen
     selectedTableItems: import("@angular/core").WritableSignal<SdTableItem<T>[]>;
     total: import("@angular/core").WritableSignal<number | undefined>;
     loading: import("@angular/core").WritableSignal<boolean>;
-    exporting: import("@angular/core").WritableSignal<boolean>;
     isSelectAll: import("@angular/core").WritableSignal<boolean>;
-    exportTitle: import("@angular/core").WritableSignal<string>;
     isFiltered: import("@angular/core").WritableSignal<boolean>;
     requireFiltered: import("@angular/core").WritableSignal<boolean>;
     filterRegister: TableFilterRegister;
@@ -71,6 +70,8 @@ export declare class SdTable<T = unknown> extends SdBaseSecureComponent implemen
     columnOperator: Record<string, SdOperator>;
     columnFilter?: Record<string, any>;
     cacheValues: Record<string, any[]>;
+    exporting: import("@angular/core").WritableSignal<boolean>;
+    exportTitle: import("@angular/core").WritableSignal<string>;
     tableConfiguration: ISdTableConfiguration | null;
     constructor();
     ngOnInit(): void;

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

@@ -16,6 +16,9 @@ export declare class SdUploadFile<TArgs = any> {
     readonly previewFileComponent: import("@angular/core").Signal<PreviewComponent | undefined>;
     readonly dropElements: import("@angular/core").Signal<readonly ElementRef<any>[]>;
     readonly sdLabelDef: import("@angular/core").Signal<SdLabelDefDirective | undefined>;
+    readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly autoId: import("@angular/core").Signal<string | undefined>;
+    readonly removeAutoId: (index: number) => string | undefined;
     readonly args: import("@angular/core").InputSignal<TArgs | undefined>;
     readonly label: import("@angular/core").InputSignal<string | undefined>;
     readonly key: import("@angular/core").InputSignal<string | undefined>;
@@ -75,5 +78,5 @@ export declare class SdUploadFile<TArgs = any> {
     onDownload: (previewFile: PreviewFile) => void;
     isLastVisibleOverlay(fileIndex: number): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdUploadFile<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdUploadFile<any>, "sd-upload-file", never, { "args": { "alias": "args"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "previewWidth": { "alias": "previewWidth"; "required": false; "isSignal": true; }; "previewHeight": { "alias": "previewHeight"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "uploadInput": { "alias": "upload"; "required": false; "isSignal": true; }; "details": { "alias": "details"; "required": false; "isSignal": true; }; "downloadInput": { "alias": "download"; "required": false; "isSignal": true; }; "imageValidator": { "alias": "imageValidator"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "scaleToPixel": { "alias": "scaleToPixel"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "nameInput": { "alias": "name"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxOfImage": { "alias": "maxOfImage"; "required": false; "isSignal": true; }; "extensions": { "alias": "extensions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "filesChanged": "filesChanged"; "model": "modelChange"; }, ["sdLabelDef"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdUploadFile<any>, "sd-upload-file", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "args": { "alias": "args"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "previewWidth": { "alias": "previewWidth"; "required": false; "isSignal": true; }; "previewHeight": { "alias": "previewHeight"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "uploadInput": { "alias": "upload"; "required": false; "isSignal": true; }; "details": { "alias": "details"; "required": false; "isSignal": true; }; "downloadInput": { "alias": "download"; "required": false; "isSignal": true; }; "imageValidator": { "alias": "imageValidator"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "scaleToPixel": { "alias": "scaleToPixel"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "nameInput": { "alias": "name"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxOfImage": { "alias": "maxOfImage"; "required": false; "isSignal": true; }; "extensions": { "alias": "extensions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "filesChanged": "filesChanged"; "model": "modelChange"; }, ["sdLabelDef"], never, true, never>;
 }

package/configurations/src/sd-core.configuration.d.ts

@@ -1,8 +1,10 @@
 import { InjectionToken } from "@angular/core";
+import type { Language } from "@sd-angular/core/models";
 export interface ISdCoreConfiguration {
     licenseKey?: string | string[];
     format?: {
         number?: '1,234,567.89' | '1.234.567,89';
     };
+    language?: Language | (() => Record<string, string>);
 }
 export declare const SD_CORE_CONFIGURATION: InjectionToken<ISdCoreConfiguration>;

package/fesm2022/sd-angular-core-components-anchor.mjs

@@ -1,7 +1,7 @@
 import * as i1$1 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i0 from '@angular/core';
-import { input, inject, ElementRef, effect, Component, output, ChangeDetectionStrategy, viewChild, contentChildren, booleanAttribute, signal, afterNextRender } from '@angular/core';
+import { input, inject, ElementRef, effect, Component, output, ChangeDetectionStrategy, viewChild, contentChildren, computed, booleanAttribute, signal, afterNextRender } from '@angular/core';
 import { v4 } from 'uuid';
 import { Subject, Subscription, debounceTime, fromEvent, auditTime, map, filter, take } from 'rxjs';
 import * as i1 from '@angular/material/icon';
@@ -10,6 +10,8 @@ import { MatIconModule } from '@angular/material/icon';
 class SdAnchorItem {
     title = input.required();
     icon = input();
+    // Stable key dùng cho data-autoId. Nếu không truyền thì fallback về uuid (không stable giữa các lần render).
+    key = input(undefined);
     id = v4();
     elementRef = inject(ElementRef);
     constructor() {
@@ -20,7 +22,7 @@ class SdAnchorItem {
         });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.21", ngImport: i0, type: SdAnchorItem, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "19.2.21", type: SdAnchorItem, isStandalone: true, selector: "sd-anchor-item", inputs: { title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: true, transformFunction: null }, icon: { classPropertyName: "icon", publicName: "icon", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "<section>\r\n  <ng-content></ng-content>\r\n</section>\r\n", styles: [""], dependencies: [{ kind: "ngmodule", type: CommonModule }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "19.2.21", type: SdAnchorItem, isStandalone: true, selector: "sd-anchor-item", inputs: { title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: true, transformFunction: null }, icon: { classPropertyName: "icon", publicName: "icon", isSignal: true, isRequired: false, transformFunction: null }, key: { classPropertyName: "key", publicName: "key", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "<section>\r\n  <ng-content></ng-content>\r\n</section>\r\n", styles: [""], dependencies: [{ kind: "ngmodule", type: CommonModule }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.21", ngImport: i0, type: SdAnchorItem, decorators: [{
             type: Component,
@@ -32,6 +34,13 @@ class SdAnchorVerticalList {
     activeSectionId = input('');
     ellipsis = input(false);
     sidebarWidth = input('');
+    // autoId được forward từ <sd-anchor>. Derive per-item autoId theo `key` của item (nếu có).
+    parentAutoId = input(undefined);
+    itemAutoId(section) {
+        const parent = this.parentAutoId();
+        const key = section.key();
+        return parent && key ? `${parent}-${key}` : undefined;
+    }
     sdClickSection = output();
     #delay = 200;
     #clickSectionSubject = new Subject();
@@ -48,16 +57,20 @@ class SdAnchorVerticalList {
         this.#subscription.unsubscribe();
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.21", ngImport: i0, type: SdAnchorVerticalList, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.21", type: SdAnchorVerticalList, isStandalone: true, selector: "sd-anchor-vertical-list", inputs: { sections: { classPropertyName: "sections", publicName: "sections", isSignal: true, isRequired: true, transformFunction: null }, activeSectionId: { classPropertyName: "activeSectionId", publicName: "activeSectionId", isSignal: true, isRequired: false, transformFunction: null }, ellipsis: { classPropertyName: "ellipsis", publicName: "ellipsis", isSignal: true, isRequired: false, transformFunction: null }, sidebarWidth: { classPropertyName: "sidebarWidth", publicName: "sidebarWidth", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { sdClickSection: "sdClickSection" }, ngImport: i0, template: "<div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n  @for (section of sections(); track section.id) {\r\n    <div\r\n      class=\"c-anchor-list-item\"\r\n      [class.active]=\"section.id === activeSectionId()\"\r\n      (click)=\"onClickSection(section.id)\"\r\n      (keydown.enter)=\"onClickSection(section.id)\"\r\n      tabindex=\"0\">\r\n      @if (section.icon()) {\r\n        <mat-icon class=\"c-anchor-list-item-icon\">{{ section.icon() }}</mat-icon>\r\n      }\r\n      <div class=\"c-anchor-list-item-text\" [class.ellipsis]=\"ellipsis()\">\r\n        {{ section.title() }}\r\n      </div>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [".text-primary{color:var(--sd-primary)!important}.bg-primary{background:var(--sd-primary)!important}.border-primary{border-color:var(--sd-primary)!important}.text-primary-light{color:var(--sd-primary-light)!important}.bg-primary-light{background:var(--sd-primary-light)!important}.border-primary-light{border-color:var(--sd-primary-light)!important}.text-primary-dark{color:var(--sd-primary-dark)!important}.bg-primary-dark{background:var(--sd-primary-dark)!important}.border-primary-dark{border-color:var(--sd-primary-dark)!important}.text-info{color:var(--sd-info)!important}.bg-info{background:var(--sd-info)!important}.border-info{border-color:var(--sd-info)!important}.text-info-light{color:var(--sd-info-light)!important}.bg-info-light{background:var(--sd-info-light)!important}.border-info-light{border-color:var(--sd-info-light)!important}.text-info-dark{color:var(--sd-info-dark)!important}.bg-info-dark{background:var(--sd-info-dark)!important}.border-info-dark{border-color:var(--sd-info-dark)!important}.text-success{color:var(--sd-success)!important}.bg-success{background:var(--sd-success)!important}.border-success{border-color:var(--sd-success)!important}.text-success-light{color:var(--sd-success-light)!important}.bg-success-light{background:var(--sd-success-light)!important}.border-success-light{border-color:var(--sd-success-light)!important}.text-success-dark{color:var(--sd-success-dark)!important}.bg-success-dark{background:var(--sd-success-dark)!important}.border-success-dark{border-color:var(--sd-success-dark)!important}.text-warning{color:var(--sd-warning)!important}.bg-warning{background:var(--sd-warning)!important}.border-warning{border-color:var(--sd-warning)!important}.text-warning-light{color:var(--sd-warning-light)!important}.bg-warning-light{background:var(--sd-warning-light)!important}.border-warning-light{border-color:var(--sd-warning-light)!important}.text-warning-dark{color:var(--sd-warning-dark)!important}.bg-warning-dark{background:var(--sd-warning-dark)!important}.border-warning-dark{border-color:var(--sd-warning-dark)!important}.text-error{color:var(--sd-error)!important}.bg-error{background:var(--sd-error)!important}.border-error{border-color:var(--sd-error)!important}.text-error-light{color:var(--sd-error-light)!important}.bg-error-light{background:var(--sd-error-light)!important}.border-error-light{border-color:var(--sd-error-light)!important}.text-error-dark{color:var(--sd-error-dark)!important}.bg-error-dark{background:var(--sd-error-dark)!important}.border-error-dark{border-color:var(--sd-error-dark)!important}.text-secondary{color:var(--sd-secondary)!important}.bg-secondary{background:var(--sd-secondary)!important}.border-secondary{border-color:var(--sd-secondary)!important}.text-secondary-light{color:var(--sd-secondary-light)!important}.bg-secondary-light{background:var(--sd-secondary-light)!important}.border-secondary-light{border-color:var(--sd-secondary-light)!important}.text-secondary-dark{color:var(--sd-secondary-dark)!important}.bg-secondary-dark{background:var(--sd-secondary-dark)!important}.border-secondary-dark{border-color:var(--sd-secondary-dark)!important}.text-light{color:var(--sd-light)!important}.bg-light{background:var(--sd-light)!important}.border-light{border-color:var(--sd-light)!important}.text-dark{color:var(--sd-dark)!important}.bg-dark{background:var(--sd-dark)!important}.border-dark{border-color:var(--sd-dark)!important}.text-black500{color:var(--sd-black500)!important}.bg-black500{background:var(--sd-black500)!important}.border-black500{border-color:var(--sd-black500)!important}.text-black400{color:var(--sd-black400)!important}.bg-black400{background:var(--sd-black400)!important}.border-black400{border-color:var(--sd-black400)!important}.text-black300{color:var(--sd-black300)!important}.bg-black300{background:var(--sd-black300)!important}.border-black300{border-color:var(--sd-black300)!important}.text-black200{color:var(--sd-black200)!important}.bg-black200{background:var(--sd-black200)!important}.border-black200{border-color:var(--sd-black200)!important}.text-black100{color:var(--sd-black100)!important}.bg-black100{background:var(--sd-black100)!important}.border-black100{border-color:var(--sd-black100)!important}.text-white{color:#fff!important}.bg-white{background:#fff!important}.border-white{border-color:#fff!important}.text-black{color:#000!important}.bg-black{background:#000!important}.border-black{border-color:#000!important}.c-anchor-list{height:100%;display:flex;flex-direction:column}.c-anchor-list .c-anchor-list-item{border-left:2px solid var(--sd-secondary-light);color:var(--sd-black500);padding:.5rem 1.5rem;cursor:pointer;display:flex;align-items:center;gap:.5rem}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text{user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text.ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.c-anchor-list .c-anchor-list-item.active{border-left:2px solid var(--sd-primary);font-weight:700}.c-anchor-list .c-anchor-list-item:not(.active){border-left:2px solid var(--sd-secondary-light);font-weight:400}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i1.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.21", type: SdAnchorVerticalList, isStandalone: true, selector: "sd-anchor-vertical-list", inputs: { sections: { classPropertyName: "sections", publicName: "sections", isSignal: true, isRequired: true, transformFunction: null }, activeSectionId: { classPropertyName: "activeSectionId", publicName: "activeSectionId", isSignal: true, isRequired: false, transformFunction: null }, ellipsis: { classPropertyName: "ellipsis", publicName: "ellipsis", isSignal: true, isRequired: false, transformFunction: null }, sidebarWidth: { classPropertyName: "sidebarWidth", publicName: "sidebarWidth", isSignal: true, isRequired: false, transformFunction: null }, parentAutoId: { classPropertyName: "parentAutoId", publicName: "parentAutoId", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { sdClickSection: "sdClickSection" }, ngImport: i0, template: "<div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n  @for (section of sections(); track section.id) {\r\n    <div\r\n      class=\"c-anchor-list-item\"\r\n      [class.active]=\"section.id === activeSectionId()\"\r\n      (click)=\"onClickSection(section.id)\"\r\n      (keydown.enter)=\"onClickSection(section.id)\"\r\n      [attr.data-autoId]=\"itemAutoId(section)\"\r\n      tabindex=\"0\">\r\n      @if (section.icon()) {\r\n        <mat-icon class=\"c-anchor-list-item-icon\">{{ section.icon() }}</mat-icon>\r\n      }\r\n      <div class=\"c-anchor-list-item-text\" [class.ellipsis]=\"ellipsis()\">\r\n        {{ section.title() }}\r\n      </div>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [".text-primary{color:var(--sd-primary)!important}.bg-primary{background:var(--sd-primary)!important}.border-primary{border-color:var(--sd-primary)!important}.text-primary-light{color:var(--sd-primary-light)!important}.bg-primary-light{background:var(--sd-primary-light)!important}.border-primary-light{border-color:var(--sd-primary-light)!important}.text-primary-dark{color:var(--sd-primary-dark)!important}.bg-primary-dark{background:var(--sd-primary-dark)!important}.border-primary-dark{border-color:var(--sd-primary-dark)!important}.text-info{color:var(--sd-info)!important}.bg-info{background:var(--sd-info)!important}.border-info{border-color:var(--sd-info)!important}.text-info-light{color:var(--sd-info-light)!important}.bg-info-light{background:var(--sd-info-light)!important}.border-info-light{border-color:var(--sd-info-light)!important}.text-info-dark{color:var(--sd-info-dark)!important}.bg-info-dark{background:var(--sd-info-dark)!important}.border-info-dark{border-color:var(--sd-info-dark)!important}.text-success{color:var(--sd-success)!important}.bg-success{background:var(--sd-success)!important}.border-success{border-color:var(--sd-success)!important}.text-success-light{color:var(--sd-success-light)!important}.bg-success-light{background:var(--sd-success-light)!important}.border-success-light{border-color:var(--sd-success-light)!important}.text-success-dark{color:var(--sd-success-dark)!important}.bg-success-dark{background:var(--sd-success-dark)!important}.border-success-dark{border-color:var(--sd-success-dark)!important}.text-warning{color:var(--sd-warning)!important}.bg-warning{background:var(--sd-warning)!important}.border-warning{border-color:var(--sd-warning)!important}.text-warning-light{color:var(--sd-warning-light)!important}.bg-warning-light{background:var(--sd-warning-light)!important}.border-warning-light{border-color:var(--sd-warning-light)!important}.text-warning-dark{color:var(--sd-warning-dark)!important}.bg-warning-dark{background:var(--sd-warning-dark)!important}.border-warning-dark{border-color:var(--sd-warning-dark)!important}.text-error{color:var(--sd-error)!important}.bg-error{background:var(--sd-error)!important}.border-error{border-color:var(--sd-error)!important}.text-error-light{color:var(--sd-error-light)!important}.bg-error-light{background:var(--sd-error-light)!important}.border-error-light{border-color:var(--sd-error-light)!important}.text-error-dark{color:var(--sd-error-dark)!important}.bg-error-dark{background:var(--sd-error-dark)!important}.border-error-dark{border-color:var(--sd-error-dark)!important}.text-secondary{color:var(--sd-secondary)!important}.bg-secondary{background:var(--sd-secondary)!important}.border-secondary{border-color:var(--sd-secondary)!important}.text-secondary-light{color:var(--sd-secondary-light)!important}.bg-secondary-light{background:var(--sd-secondary-light)!important}.border-secondary-light{border-color:var(--sd-secondary-light)!important}.text-secondary-dark{color:var(--sd-secondary-dark)!important}.bg-secondary-dark{background:var(--sd-secondary-dark)!important}.border-secondary-dark{border-color:var(--sd-secondary-dark)!important}.text-light{color:var(--sd-light)!important}.bg-light{background:var(--sd-light)!important}.border-light{border-color:var(--sd-light)!important}.text-dark{color:var(--sd-dark)!important}.bg-dark{background:var(--sd-dark)!important}.border-dark{border-color:var(--sd-dark)!important}.text-black500{color:var(--sd-black500)!important}.bg-black500{background:var(--sd-black500)!important}.border-black500{border-color:var(--sd-black500)!important}.text-black400{color:var(--sd-black400)!important}.bg-black400{background:var(--sd-black400)!important}.border-black400{border-color:var(--sd-black400)!important}.text-black300{color:var(--sd-black300)!important}.bg-black300{background:var(--sd-black300)!important}.border-black300{border-color:var(--sd-black300)!important}.text-black200{color:var(--sd-black200)!important}.bg-black200{background:var(--sd-black200)!important}.border-black200{border-color:var(--sd-black200)!important}.text-black100{color:var(--sd-black100)!important}.bg-black100{background:var(--sd-black100)!important}.border-black100{border-color:var(--sd-black100)!important}.text-white{color:#fff!important}.bg-white{background:#fff!important}.border-white{border-color:#fff!important}.text-black{color:#000!important}.bg-black{background:#000!important}.border-black{border-color:#000!important}.c-anchor-list{height:100%;display:flex;flex-direction:column}.c-anchor-list .c-anchor-list-item{border-left:2px solid var(--sd-secondary-light);color:var(--sd-black500);padding:.5rem 1.5rem;cursor:pointer;display:flex;align-items:center;gap:.5rem}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text{user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text.ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.c-anchor-list .c-anchor-list-item.active{border-left:2px solid var(--sd-primary);font-weight:700}.c-anchor-list .c-anchor-list-item:not(.active){border-left:2px solid var(--sd-secondary-light);font-weight:400}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i1.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.21", ngImport: i0, type: SdAnchorVerticalList, decorators: [{
             type: Component,
-            args: [{ selector: 'sd-anchor-vertical-list', changeDetection: ChangeDetectionStrategy.OnPush, imports: [CommonModule, MatIconModule], standalone: true, template: "<div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n  @for (section of sections(); track section.id) {\r\n    <div\r\n      class=\"c-anchor-list-item\"\r\n      [class.active]=\"section.id === activeSectionId()\"\r\n      (click)=\"onClickSection(section.id)\"\r\n      (keydown.enter)=\"onClickSection(section.id)\"\r\n      tabindex=\"0\">\r\n      @if (section.icon()) {\r\n        <mat-icon class=\"c-anchor-list-item-icon\">{{ section.icon() }}</mat-icon>\r\n      }\r\n      <div class=\"c-anchor-list-item-text\" [class.ellipsis]=\"ellipsis()\">\r\n        {{ section.title() }}\r\n      </div>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [".text-primary{color:var(--sd-primary)!important}.bg-primary{background:var(--sd-primary)!important}.border-primary{border-color:var(--sd-primary)!important}.text-primary-light{color:var(--sd-primary-light)!important}.bg-primary-light{background:var(--sd-primary-light)!important}.border-primary-light{border-color:var(--sd-primary-light)!important}.text-primary-dark{color:var(--sd-primary-dark)!important}.bg-primary-dark{background:var(--sd-primary-dark)!important}.border-primary-dark{border-color:var(--sd-primary-dark)!important}.text-info{color:var(--sd-info)!important}.bg-info{background:var(--sd-info)!important}.border-info{border-color:var(--sd-info)!important}.text-info-light{color:var(--sd-info-light)!important}.bg-info-light{background:var(--sd-info-light)!important}.border-info-light{border-color:var(--sd-info-light)!important}.text-info-dark{color:var(--sd-info-dark)!important}.bg-info-dark{background:var(--sd-info-dark)!important}.border-info-dark{border-color:var(--sd-info-dark)!important}.text-success{color:var(--sd-success)!important}.bg-success{background:var(--sd-success)!important}.border-success{border-color:var(--sd-success)!important}.text-success-light{color:var(--sd-success-light)!important}.bg-success-light{background:var(--sd-success-light)!important}.border-success-light{border-color:var(--sd-success-light)!important}.text-success-dark{color:var(--sd-success-dark)!important}.bg-success-dark{background:var(--sd-success-dark)!important}.border-success-dark{border-color:var(--sd-success-dark)!important}.text-warning{color:var(--sd-warning)!important}.bg-warning{background:var(--sd-warning)!important}.border-warning{border-color:var(--sd-warning)!important}.text-warning-light{color:var(--sd-warning-light)!important}.bg-warning-light{background:var(--sd-warning-light)!important}.border-warning-light{border-color:var(--sd-warning-light)!important}.text-warning-dark{color:var(--sd-warning-dark)!important}.bg-warning-dark{background:var(--sd-warning-dark)!important}.border-warning-dark{border-color:var(--sd-warning-dark)!important}.text-error{color:var(--sd-error)!important}.bg-error{background:var(--sd-error)!important}.border-error{border-color:var(--sd-error)!important}.text-error-light{color:var(--sd-error-light)!important}.bg-error-light{background:var(--sd-error-light)!important}.border-error-light{border-color:var(--sd-error-light)!important}.text-error-dark{color:var(--sd-error-dark)!important}.bg-error-dark{background:var(--sd-error-dark)!important}.border-error-dark{border-color:var(--sd-error-dark)!important}.text-secondary{color:var(--sd-secondary)!important}.bg-secondary{background:var(--sd-secondary)!important}.border-secondary{border-color:var(--sd-secondary)!important}.text-secondary-light{color:var(--sd-secondary-light)!important}.bg-secondary-light{background:var(--sd-secondary-light)!important}.border-secondary-light{border-color:var(--sd-secondary-light)!important}.text-secondary-dark{color:var(--sd-secondary-dark)!important}.bg-secondary-dark{background:var(--sd-secondary-dark)!important}.border-secondary-dark{border-color:var(--sd-secondary-dark)!important}.text-light{color:var(--sd-light)!important}.bg-light{background:var(--sd-light)!important}.border-light{border-color:var(--sd-light)!important}.text-dark{color:var(--sd-dark)!important}.bg-dark{background:var(--sd-dark)!important}.border-dark{border-color:var(--sd-dark)!important}.text-black500{color:var(--sd-black500)!important}.bg-black500{background:var(--sd-black500)!important}.border-black500{border-color:var(--sd-black500)!important}.text-black400{color:var(--sd-black400)!important}.bg-black400{background:var(--sd-black400)!important}.border-black400{border-color:var(--sd-black400)!important}.text-black300{color:var(--sd-black300)!important}.bg-black300{background:var(--sd-black300)!important}.border-black300{border-color:var(--sd-black300)!important}.text-black200{color:var(--sd-black200)!important}.bg-black200{background:var(--sd-black200)!important}.border-black200{border-color:var(--sd-black200)!important}.text-black100{color:var(--sd-black100)!important}.bg-black100{background:var(--sd-black100)!important}.border-black100{border-color:var(--sd-black100)!important}.text-white{color:#fff!important}.bg-white{background:#fff!important}.border-white{border-color:#fff!important}.text-black{color:#000!important}.bg-black{background:#000!important}.border-black{border-color:#000!important}.c-anchor-list{height:100%;display:flex;flex-direction:column}.c-anchor-list .c-anchor-list-item{border-left:2px solid var(--sd-secondary-light);color:var(--sd-black500);padding:.5rem 1.5rem;cursor:pointer;display:flex;align-items:center;gap:.5rem}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text{user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text.ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.c-anchor-list .c-anchor-list-item.active{border-left:2px solid var(--sd-primary);font-weight:700}.c-anchor-list .c-anchor-list-item:not(.active){border-left:2px solid var(--sd-secondary-light);font-weight:400}\n"] }]
+            args: [{ selector: 'sd-anchor-vertical-list', changeDetection: ChangeDetectionStrategy.OnPush, imports: [CommonModule, MatIconModule], standalone: true, template: "<div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n  @for (section of sections(); track section.id) {\r\n    <div\r\n      class=\"c-anchor-list-item\"\r\n      [class.active]=\"section.id === activeSectionId()\"\r\n      (click)=\"onClickSection(section.id)\"\r\n      (keydown.enter)=\"onClickSection(section.id)\"\r\n      [attr.data-autoId]=\"itemAutoId(section)\"\r\n      tabindex=\"0\">\r\n      @if (section.icon()) {\r\n        <mat-icon class=\"c-anchor-list-item-icon\">{{ section.icon() }}</mat-icon>\r\n      }\r\n      <div class=\"c-anchor-list-item-text\" [class.ellipsis]=\"ellipsis()\">\r\n        {{ section.title() }}\r\n      </div>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [".text-primary{color:var(--sd-primary)!important}.bg-primary{background:var(--sd-primary)!important}.border-primary{border-color:var(--sd-primary)!important}.text-primary-light{color:var(--sd-primary-light)!important}.bg-primary-light{background:var(--sd-primary-light)!important}.border-primary-light{border-color:var(--sd-primary-light)!important}.text-primary-dark{color:var(--sd-primary-dark)!important}.bg-primary-dark{background:var(--sd-primary-dark)!important}.border-primary-dark{border-color:var(--sd-primary-dark)!important}.text-info{color:var(--sd-info)!important}.bg-info{background:var(--sd-info)!important}.border-info{border-color:var(--sd-info)!important}.text-info-light{color:var(--sd-info-light)!important}.bg-info-light{background:var(--sd-info-light)!important}.border-info-light{border-color:var(--sd-info-light)!important}.text-info-dark{color:var(--sd-info-dark)!important}.bg-info-dark{background:var(--sd-info-dark)!important}.border-info-dark{border-color:var(--sd-info-dark)!important}.text-success{color:var(--sd-success)!important}.bg-success{background:var(--sd-success)!important}.border-success{border-color:var(--sd-success)!important}.text-success-light{color:var(--sd-success-light)!important}.bg-success-light{background:var(--sd-success-light)!important}.border-success-light{border-color:var(--sd-success-light)!important}.text-success-dark{color:var(--sd-success-dark)!important}.bg-success-dark{background:var(--sd-success-dark)!important}.border-success-dark{border-color:var(--sd-success-dark)!important}.text-warning{color:var(--sd-warning)!important}.bg-warning{background:var(--sd-warning)!important}.border-warning{border-color:var(--sd-warning)!important}.text-warning-light{color:var(--sd-warning-light)!important}.bg-warning-light{background:var(--sd-warning-light)!important}.border-warning-light{border-color:var(--sd-warning-light)!important}.text-warning-dark{color:var(--sd-warning-dark)!important}.bg-warning-dark{background:var(--sd-warning-dark)!important}.border-warning-dark{border-color:var(--sd-warning-dark)!important}.text-error{color:var(--sd-error)!important}.bg-error{background:var(--sd-error)!important}.border-error{border-color:var(--sd-error)!important}.text-error-light{color:var(--sd-error-light)!important}.bg-error-light{background:var(--sd-error-light)!important}.border-error-light{border-color:var(--sd-error-light)!important}.text-error-dark{color:var(--sd-error-dark)!important}.bg-error-dark{background:var(--sd-error-dark)!important}.border-error-dark{border-color:var(--sd-error-dark)!important}.text-secondary{color:var(--sd-secondary)!important}.bg-secondary{background:var(--sd-secondary)!important}.border-secondary{border-color:var(--sd-secondary)!important}.text-secondary-light{color:var(--sd-secondary-light)!important}.bg-secondary-light{background:var(--sd-secondary-light)!important}.border-secondary-light{border-color:var(--sd-secondary-light)!important}.text-secondary-dark{color:var(--sd-secondary-dark)!important}.bg-secondary-dark{background:var(--sd-secondary-dark)!important}.border-secondary-dark{border-color:var(--sd-secondary-dark)!important}.text-light{color:var(--sd-light)!important}.bg-light{background:var(--sd-light)!important}.border-light{border-color:var(--sd-light)!important}.text-dark{color:var(--sd-dark)!important}.bg-dark{background:var(--sd-dark)!important}.border-dark{border-color:var(--sd-dark)!important}.text-black500{color:var(--sd-black500)!important}.bg-black500{background:var(--sd-black500)!important}.border-black500{border-color:var(--sd-black500)!important}.text-black400{color:var(--sd-black400)!important}.bg-black400{background:var(--sd-black400)!important}.border-black400{border-color:var(--sd-black400)!important}.text-black300{color:var(--sd-black300)!important}.bg-black300{background:var(--sd-black300)!important}.border-black300{border-color:var(--sd-black300)!important}.text-black200{color:var(--sd-black200)!important}.bg-black200{background:var(--sd-black200)!important}.border-black200{border-color:var(--sd-black200)!important}.text-black100{color:var(--sd-black100)!important}.bg-black100{background:var(--sd-black100)!important}.border-black100{border-color:var(--sd-black100)!important}.text-white{color:#fff!important}.bg-white{background:#fff!important}.border-white{border-color:#fff!important}.text-black{color:#000!important}.bg-black{background:#000!important}.border-black{border-color:#000!important}.c-anchor-list{height:100%;display:flex;flex-direction:column}.c-anchor-list .c-anchor-list-item{border-left:2px solid var(--sd-secondary-light);color:var(--sd-black500);padding:.5rem 1.5rem;cursor:pointer;display:flex;align-items:center;gap:.5rem}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text{user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.c-anchor-list .c-anchor-list-item .c-anchor-list-item-text.ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.c-anchor-list .c-anchor-list-item.active{border-left:2px solid var(--sd-primary);font-weight:700}.c-anchor-list .c-anchor-list-item:not(.active){border-left:2px solid var(--sd-secondary-light);font-weight:400}\n"] }]
         }], ctorParameters: () => [] });
 
 class SdAnchor {
     wrapper = viewChild.required('wrapper');
     sections = contentChildren(SdAnchorItem);
+    autoIdInput = input(undefined, { alias: 'autoId' });
+    autoId = computed(() => (this.autoIdInput() ? `components-anchor-${this.autoIdInput()}` : undefined));
+    // Derive autoId cho từng item theo `key` (nếu consumer không truyền key → undefined, không bind).
+    itemAutoId = (key) => this.autoId() && key ? `${this.autoId()}-${key}` : undefined;
     type = input('vertical');
     sidebarWidth = input('200px');
     ellipsis = input(false, { transform: booleanAttribute });
@@ -136,11 +149,11 @@ class SdAnchor {
         this.#disposeResources();
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.21", ngImport: i0, type: SdAnchor, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.21", type: SdAnchor, isStandalone: true, selector: "sd-anchor", inputs: { type: { classPropertyName: "type", publicName: "type", isSignal: true, isRequired: false, transformFunction: null }, sidebarWidth: { classPropertyName: "sidebarWidth", publicName: "sidebarWidth", isSignal: true, isRequired: false, transformFunction: null }, ellipsis: { classPropertyName: "ellipsis", publicName: "ellipsis", isSignal: true, isRequired: false, transformFunction: null }, isOverscroll: { classPropertyName: "isOverscroll", publicName: "isOverscroll", isSignal: true, isRequired: false, transformFunction: null }, isHiddenAnchorList: { classPropertyName: "isHiddenAnchorList", publicName: "isHiddenAnchorList", isSignal: true, isRequired: false, transformFunction: null } }, queries: [{ propertyName: "sections", predicate: SdAnchorItem, isSignal: true }], viewQueries: [{ propertyName: "wrapper", first: true, predicate: ["wrapper"], descendants: true, isSignal: true }], ngImport: i0, template: "<div class=\"c-anchor-vertical\" [ngClass]=\"{ 'c-stop-scroll-propagation': !isOverscroll() }\" #wrapper>\r\n  <div class=\"c-anchor-content\" [style.width]=\"'calc(100% - ' + sidebarWidth() + ' - 16px)'\">\r\n    <ng-content></ng-content>\r\n  </div>\r\n\r\n  @if (!isHiddenAnchorList()) {\r\n    <div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n      <sd-anchor-vertical-list\r\n        [sections]=\"sections()\"\r\n        [ellipsis]=\"ellipsis()\"\r\n        [sidebarWidth]=\"sidebarWidth()\"\r\n        [activeSectionId]=\"activeSectionId()\"\r\n        (sdClickSection)=\"scrollSectionByClick($event)\">\r\n      </sd-anchor-vertical-list>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: ["@charset \"UTF-8\";.c-anchor-vertical{position:relative;display:flex;height:100%;width:100%;gap:16px;overflow-y:auto}.c-anchor-vertical.c-stop-scroll-propagation{overscroll-behavior:contain}.c-anchor-vertical .c-anchor-content{width:100%}.c-anchor-vertical .c-anchor-list{position:sticky;top:0;right:6px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1$1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "component", type: SdAnchorVerticalList, selector: "sd-anchor-vertical-list", inputs: ["sections", "activeSectionId", "ellipsis", "sidebarWidth"], outputs: ["sdClickSection"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.21", type: SdAnchor, isStandalone: true, selector: "sd-anchor", inputs: { autoIdInput: { classPropertyName: "autoIdInput", publicName: "autoId", isSignal: true, isRequired: false, transformFunction: null }, type: { classPropertyName: "type", publicName: "type", isSignal: true, isRequired: false, transformFunction: null }, sidebarWidth: { classPropertyName: "sidebarWidth", publicName: "sidebarWidth", isSignal: true, isRequired: false, transformFunction: null }, ellipsis: { classPropertyName: "ellipsis", publicName: "ellipsis", isSignal: true, isRequired: false, transformFunction: null }, isOverscroll: { classPropertyName: "isOverscroll", publicName: "isOverscroll", isSignal: true, isRequired: false, transformFunction: null }, isHiddenAnchorList: { classPropertyName: "isHiddenAnchorList", publicName: "isHiddenAnchorList", isSignal: true, isRequired: false, transformFunction: null } }, queries: [{ propertyName: "sections", predicate: SdAnchorItem, isSignal: true }], viewQueries: [{ propertyName: "wrapper", first: true, predicate: ["wrapper"], descendants: true, isSignal: true }], ngImport: i0, template: "<div class=\"c-anchor-vertical\" [ngClass]=\"{ 'c-stop-scroll-propagation': !isOverscroll() }\" #wrapper>\r\n  <div class=\"c-anchor-content\" [style.width]=\"'calc(100% - ' + sidebarWidth() + ' - 16px)'\">\r\n    <ng-content></ng-content>\r\n  </div>\r\n\r\n  @if (!isHiddenAnchorList()) {\r\n    <div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n      <sd-anchor-vertical-list\r\n        [sections]=\"sections()\"\r\n        [ellipsis]=\"ellipsis()\"\r\n        [sidebarWidth]=\"sidebarWidth()\"\r\n        [activeSectionId]=\"activeSectionId()\"\r\n        [parentAutoId]=\"autoId()\"\r\n        (sdClickSection)=\"scrollSectionByClick($event)\">\r\n      </sd-anchor-vertical-list>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: ["@charset \"UTF-8\";.c-anchor-vertical{position:relative;display:flex;height:100%;width:100%;gap:16px;overflow-y:auto}.c-anchor-vertical.c-stop-scroll-propagation{overscroll-behavior:contain}.c-anchor-vertical .c-anchor-content{width:100%}.c-anchor-vertical .c-anchor-list{position:sticky;top:0;right:6px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1$1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "component", type: SdAnchorVerticalList, selector: "sd-anchor-vertical-list", inputs: ["sections", "activeSectionId", "ellipsis", "sidebarWidth", "parentAutoId"], outputs: ["sdClickSection"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.21", ngImport: i0, type: SdAnchor, decorators: [{
             type: Component,
-            args: [{ selector: 'sd-anchor', changeDetection: ChangeDetectionStrategy.OnPush, imports: [CommonModule, SdAnchorVerticalList], standalone: true, template: "<div class=\"c-anchor-vertical\" [ngClass]=\"{ 'c-stop-scroll-propagation': !isOverscroll() }\" #wrapper>\r\n  <div class=\"c-anchor-content\" [style.width]=\"'calc(100% - ' + sidebarWidth() + ' - 16px)'\">\r\n    <ng-content></ng-content>\r\n  </div>\r\n\r\n  @if (!isHiddenAnchorList()) {\r\n    <div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n      <sd-anchor-vertical-list\r\n        [sections]=\"sections()\"\r\n        [ellipsis]=\"ellipsis()\"\r\n        [sidebarWidth]=\"sidebarWidth()\"\r\n        [activeSectionId]=\"activeSectionId()\"\r\n        (sdClickSection)=\"scrollSectionByClick($event)\">\r\n      </sd-anchor-vertical-list>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: ["@charset \"UTF-8\";.c-anchor-vertical{position:relative;display:flex;height:100%;width:100%;gap:16px;overflow-y:auto}.c-anchor-vertical.c-stop-scroll-propagation{overscroll-behavior:contain}.c-anchor-vertical .c-anchor-content{width:100%}.c-anchor-vertical .c-anchor-list{position:sticky;top:0;right:6px}\n"] }]
+            args: [{ selector: 'sd-anchor', changeDetection: ChangeDetectionStrategy.OnPush, imports: [CommonModule, SdAnchorVerticalList], standalone: true, template: "<div class=\"c-anchor-vertical\" [ngClass]=\"{ 'c-stop-scroll-propagation': !isOverscroll() }\" #wrapper>\r\n  <div class=\"c-anchor-content\" [style.width]=\"'calc(100% - ' + sidebarWidth() + ' - 16px)'\">\r\n    <ng-content></ng-content>\r\n  </div>\r\n\r\n  @if (!isHiddenAnchorList()) {\r\n    <div class=\"c-anchor-list\" [style.width]=\"sidebarWidth()\">\r\n      <sd-anchor-vertical-list\r\n        [sections]=\"sections()\"\r\n        [ellipsis]=\"ellipsis()\"\r\n        [sidebarWidth]=\"sidebarWidth()\"\r\n        [activeSectionId]=\"activeSectionId()\"\r\n        [parentAutoId]=\"autoId()\"\r\n        (sdClickSection)=\"scrollSectionByClick($event)\">\r\n      </sd-anchor-vertical-list>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: ["@charset \"UTF-8\";.c-anchor-vertical{position:relative;display:flex;height:100%;width:100%;gap:16px;overflow-y:auto}.c-anchor-vertical.c-stop-scroll-propagation{overscroll-behavior:contain}.c-anchor-vertical .c-anchor-content{width:100%}.c-anchor-vertical .c-anchor-list{position:sticky;top:0;right:6px}\n"] }]
         }], ctorParameters: () => [] });
 
 /**