@sdcorejs/angular 21.1.6 → 21.2.0

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

@@ -5,12 +5,12 @@ import { SdIconSet } from '@sdcorejs/angular/modules/icon';
 import { SdUnwrapSignal } from '@sdcorejs/angular/utilities/models';
 import { Color } from '@sdcorejs/utils/models';
 
-type SdTreeDataSource<TItem = any> = TItem[] | Signal<TItem[]> | (() => TItem[] | Promise<TItem[]>);
+type SdTreeDataSource<TItem = unknown> = TItem[] | Signal<TItem[]> | (() => TItem[] | Promise<TItem[]>);
 type SdTreeLoadType = 'static' | 'lazy';
-type SdTreeOption<T = any> = SdTreeStaticOption<T> | SdTreeLazyOption<T>;
-type SdTreeItem<T = any> = SdTreeItemStatic<T> | SdTreeItemLazy<T>;
-type SdTreeItemByLoadType<T = any, TLoadType extends SdTreeLoadType = SdTreeLoadType> = TLoadType extends 'lazy' ? SdTreeItemLazy<T> : SdTreeItemStatic<T>;
-interface SdTreeItemBase<T = any> {
+type SdTreeOption<T = unknown> = SdTreeStaticOption<T> | SdTreeLazyOption<T>;
+type SdTreeItem<T = unknown> = SdTreeItemStatic<T> | SdTreeItemLazy<T>;
+type SdTreeItemByLoadType<T = unknown, TLoadType extends SdTreeLoadType = SdTreeLoadType> = TLoadType extends 'lazy' ? SdTreeItemLazy<T> : SdTreeItemStatic<T>;
+interface SdTreeItemBase<T = unknown> {
     /** Stable node id used for expansion, selection, filtering ancestry, and auto-id generation. */
     id: string;
     /** Text shown by the default tree row. Custom templates can still read `item` / `treeItem`. */
@@ -27,13 +27,13 @@ interface SdTreeItemBase<T = any> {
     /** Initial expansion state for this node. Component state wins after the user toggles. */
     expanded?: boolean;
 }
-interface SdTreeItemStatic<T = any> extends SdTreeItemBase<T> {
+interface SdTreeItemStatic<T = unknown> extends SdTreeItemBase<T> {
     /** Static-mode children. Lazy mode does not use this field. */
     children?: SdTreeItemStatic<T>[];
     /** `hasChildren` belongs to lazy mode only; static mode derives branches from `children`. */
     hasChildren?: never;
 }
-interface SdTreeItemLazy<T = any> extends SdTreeItemBase<T> {
+interface SdTreeItemLazy<T = unknown> extends SdTreeItemBase<T> {
     /** Lazy-mode hint. Set `false` for known leaf nodes that do not need `onExpandChildren`. */
     hasChildren?: boolean;
     /** `children` belongs to static mode only; lazy loaded children are cached inside the component. */
@@ -43,12 +43,12 @@ interface SdTreeBaseOption {
     maxDepth?: number;
     indentSize?: number;
 }
-interface SdTreeStaticOption<T = any> extends SdTreeBaseOption {
+interface SdTreeStaticOption<T = unknown> extends SdTreeBaseOption {
     loadType: 'static';
     /** Expand all (`true`), none (`false`), or root levels where `level < number`. */
     defaultExpanded?: boolean | number;
 }
-interface SdTreeLazyOption<T = any> extends SdTreeBaseOption {
+interface SdTreeLazyOption<T = unknown> extends SdTreeBaseOption {
     loadType: 'lazy';
     /**
      * Called once when a lazy node is first expanded. Return wrapped `SdTreeItemLazy<T>` children,
@@ -56,7 +56,7 @@ interface SdTreeLazyOption<T = any> extends SdTreeBaseOption {
      */
     onExpandChildren: (item: SdTreeItemLazy<T>) => Promise<SdTreeItemLazy<T>[]> | SdTreeItemLazy<T>[];
 }
-interface SdTreeCommand<T = any> {
+interface SdTreeCommand<T = unknown> {
     key: string;
     title: string | ((item: T) => string);
     icon?: string | ((item: T) => string | undefined | null);
@@ -66,7 +66,7 @@ interface SdTreeCommand<T = any> {
     hidden?: boolean | ((item: T) => boolean);
     click: (item: T) => void;
 }
-interface SdTreeSelectorOption<T = any> {
+interface SdTreeSelectorOption<T = unknown> {
     visible?: boolean;
     /** Keep at most one loaded node selected. Takes precedence over cascade. */
     single?: boolean;
@@ -76,7 +76,7 @@ interface SdTreeSelectorOption<T = any> {
     message?: string | ((selectedItems: T[]) => string);
     disabled?: (item: T, selectedItems: T[]) => boolean;
 }
-interface SdTreeSelectionAction<T = any> {
+interface SdTreeSelectionAction<T = unknown> {
     icon?: string;
     fontSet?: SdUnwrapSignal<SdButton['fontSet']>;
     tooltip?: SdUnwrapSignal<SdButton['tooltip']>;
@@ -86,7 +86,7 @@ interface SdTreeSelectionAction<T = any> {
     hidden?: boolean | ((selectedItems: T[]) => boolean);
     click: (selectedItems: T[]) => void;
 }
-interface SdTreeComponentOptionBase<T = any, TItem extends SdTreeItem<T> = SdTreeItem<T>> {
+interface SdTreeComponentOptionBase<T = unknown, TItem extends SdTreeItem<T> = SdTreeItem<T>> {
     autoId?: string | null;
     /** Root nodes can be an array, a signal, a sync loader, or an async loader. Call `reload()` to rerun loader sources. */
     items: SdTreeDataSource<TItem>;
@@ -100,15 +100,15 @@ interface SdTreeComponentOptionBase<T = any, TItem extends SdTreeItem<T> = SdTre
     onExpand?: (event: SdTreeToggleEvent<T>) => void;
     onCollapse?: (event: SdTreeToggleEvent<T>) => void;
 }
-interface SdTreeStaticComponentOption<T = any> extends SdTreeComponentOptionBase<T, SdTreeItemStatic<T>> {
+interface SdTreeStaticComponentOption<T = unknown> extends SdTreeComponentOptionBase<T, SdTreeItemStatic<T>> {
     /** Static tree is the default when `tree` is omitted. */
     tree?: SdTreeStaticOption<T>;
 }
-interface SdTreeLazyComponentOption<T = any> extends SdTreeComponentOptionBase<T, SdTreeItemLazy<T>> {
+interface SdTreeLazyComponentOption<T = unknown> extends SdTreeComponentOptionBase<T, SdTreeItemLazy<T>> {
     tree: SdTreeLazyOption<T>;
 }
-type SdTreeComponentOption<T = any> = SdTreeStaticComponentOption<T> | SdTreeLazyComponentOption<T>;
-interface SdTreeNode<T = any> {
+type SdTreeComponentOption<T = unknown> = SdTreeStaticComponentOption<T> | SdTreeLazyComponentOption<T>;
+interface SdTreeNode<T = unknown> {
     /** Wrapped tree item containing id/label/icon/data plus mode-specific tree metadata. */
     treeItem: SdTreeItem<T>;
     /** Raw consumer payload. Kept as a shortcut because most callbacks operate on data, not wrapper metadata. */
@@ -119,11 +119,17 @@ interface SdTreeNode<T = any> {
     parent: SdTreeNode<T> | null;
     children: SdTreeNode<T>[];
     hasChildren: boolean;
-    isExpanded: boolean;
-    isLoading: boolean;
-    loadError?: unknown;
+    /**
+     * why: ba field dưới đây là GETTER chỉ-đọc, đọc thẳng từ signal state của component — nhờ vậy
+     * mở/đóng một node không phải dựng lại toàn bộ cây node. Khai `readonly` để `node.isExpanded = true`
+     * báo lỗi lúc biên dịch; nếu để mutable thì nó vẫn type-check rồi ném `TypeError` ở runtime.
+     * Đổi trạng thái qua API của component (`toggle()` / `expand()` / `collapse()`).
+     */
+    readonly isExpanded: boolean;
+    readonly isLoading: boolean;
+    readonly loadError?: unknown;
 }
-interface SdTreeItemContext<T = any> {
+interface SdTreeItemContext<T = unknown> {
     $implicit: T;
     item: T;
     treeItem: SdTreeItem<T>;
@@ -139,23 +145,23 @@ interface SdTreeItemContext<T = any> {
     select: () => void;
     retry: () => void;
 }
-type SdTreeItemTemplate<T = any> = TemplateRef<SdTreeItemContext<T>>;
-interface SdTreeSelectionEvent<T = any> {
+type SdTreeItemTemplate<T = unknown> = TemplateRef<SdTreeItemContext<T>>;
+interface SdTreeSelectionEvent<T = unknown> {
     item: T;
     selected: boolean;
     selectedItems: T[];
 }
-interface SdTreeToggleEvent<T = any> {
+interface SdTreeToggleEvent<T = unknown> {
     item: T;
     expanded: boolean;
     node: SdTreeNode<T>;
 }
-interface SdTreeLoadErrorEvent<T = any> {
+interface SdTreeLoadErrorEvent<T = unknown> {
     item?: T;
     error: unknown;
 }
 
-declare class SdTreeItemDefDirective<T = any> {
+declare class SdTreeItemDefDirective<T = unknown> {
     static ngTemplateContextGuard<T>(_dir: SdTreeItemDefDirective<T>, ctx: unknown): ctx is SdTreeItemContext<T>;
     readonly templateRef: TemplateRef<SdTreeItemContext<T>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdTreeItemDefDirective<any>, never>;
@@ -171,7 +177,7 @@ interface SdTreeNodeAutoIds {
     label?: string;
     command?: string;
 }
-interface SdTreeViewCommand<T = any> {
+interface SdTreeViewCommand<T = unknown> {
     key: string;
     command: SdTreeCommand<T>;
     title: string;
@@ -182,7 +188,7 @@ interface SdTreeViewCommand<T = any> {
     autoId?: string;
     defaultColor: boolean;
 }
-interface SdTreeViewNode<T = any> extends SdTreeNode<T> {
+interface SdTreeViewNode<T = unknown> extends SdTreeNode<T> {
     icon?: string;
     selected: boolean;
     selectionDisabled: boolean;
@@ -195,11 +201,11 @@ interface SdTreeViewNode<T = any> extends SdTreeNode<T> {
     context: SdTreeItemContext<T>;
     tabIndex: 0 | -1;
 }
-interface SdTreeSelectionActionView<T = any> {
+interface SdTreeSelectionActionView<T = unknown> {
     action: SdTreeSelectionAction<T>;
     autoId: string | null;
 }
-declare class SdTree<T = any> {
+declare class SdTree<T = unknown> {
     #private;
     readonly autoIdInput: _angular_core.InputSignal<string | null | undefined>;
     readonly option: _angular_core.InputSignal<SdTreeComponentOption<T> | undefined>;
@@ -231,6 +237,12 @@ declare class SdTree<T = any> {
     readonly activeNodeId: _angular_core.WritableSignal<string | null>;
     readonly normalizedFilterText: _angular_core.Signal<string>;
     readonly selectionVisible: _angular_core.Signal<boolean>;
+    /**
+     * why: `selector.single` giới hạn đúng một node, nên ô chọn phải là radio — checkbox là ký hiệu
+     * của "chọn nhiều" và người dùng chỉ phát hiện ra giới hạn sau khi tick node thứ hai và thấy node
+     * đầu tự bỏ chọn. `<sd-tree-select>` không multiple sẽ tự rơi vào nhánh này.
+     */
+    readonly selectionSingle: _angular_core.Signal<boolean>;
     readonly selectedIdSet: _angular_core.Signal<Set<string>>;
     readonly rootNodes: _angular_core.Signal<SdTreeNode<T>[]>;
     readonly visibleNodes: _angular_core.Signal<SdTreeNode<T>[]>;
@@ -240,6 +252,12 @@ declare class SdTree<T = any> {
     readonly visibleSelectionActions: _angular_core.Signal<SdTreeSelectionAction<T>[]>;
     readonly selectionActionViews: _angular_core.Signal<SdTreeSelectionActionView<T>[]>;
     readonly clearSelectionAutoId: _angular_core.Signal<string | null>;
+    /**
+     * why: chọn node mà selector KHÔNG khai action nào thì thanh quick-action chỉ còn bộ đếm + nút ✕.
+     * Nó nổi đè lên cây để nói lại đúng thứ checkbox đã nói. Đó cũng là lý do `<sd-tree-select>` —
+     * vốn chỉ chọn rồi bấm "Áp dụng" ở footer modal, không có action nào — không còn thấy thanh này.
+     */
+    readonly selectionQuickActionOpened: _angular_core.Signal<boolean>;
     /**
      * Template-facing row model. Expensive/variable values are resolved once per
      * signal recomputation so the HTML does not call helper methods for every CD pass.

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

@@ -19,7 +19,7 @@ import { SdModal } from '@sdcorejs/angular/components/modal';
  * 2) `details`: lấy metadata để render danh sách file từ id/key.
  * 3) `download` (optional): tải file theo id/key.
  */
-interface ISdUploadFileConfiguration<TArgs = any> {
+interface ISdUploadFileConfiguration<TArgs = unknown> {
     /**
      * Định danh cấu hình upload.
      * Bắt buộc khi app có nhiều provider upload để tránh mapping nhầm.
@@ -36,7 +36,7 @@ interface ISdUploadFileConfiguration<TArgs = any> {
  * Token DI cho upload configuration.
  * Khuyến nghị provide dạng `multi: true` để hỗ trợ nhiều nguồn upload trong cùng app/module.
  */
-declare const SD_UPLOAD_FILE_CONFIGURATION: InjectionToken<ISdUploadFileConfiguration<any>>;
+declare const SD_UPLOAD_FILE_CONFIGURATION: InjectionToken<ISdUploadFileConfiguration<unknown>>;
 /** Hàm upload file và trả về danh sách id/key tương ứng. */
 type SdUploadFileFuncUpload<TArgs> = (files: File[], args?: TArgs) => Promise<string[]>;
 /** Hàm lấy thông tin file phục vụ hiển thị từ danh sách id/key. */
@@ -89,7 +89,7 @@ declare class PreviewComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PreviewComponent, "preview", never, {}, { "download": "download"; "close": "close"; }, never, never, true, never>;
 }
 
-declare class SdUploadFile<TArgs = any> {
+declare class SdUploadFile<TArgs = unknown> {
     #private;
     readonly id: string;
     readonly formControl: SdFormControl;
@@ -140,6 +140,9 @@ declare class SdUploadFile<TArgs = any> {
     onDrop: (event: CdkDragDrop<string[]>) => void;
     onImgError: (previewFile: PreviewFile) => void;
     onSelect: (file: PreviewFile) => void;
+    readonly isTouchDevice: boolean;
+    onUploadKeydown: (event: Event) => void;
+    onSelectKeydown: (file: PreviewFile, event: KeyboardEvent) => void;
     /**
      * Lấy danh sách các File từ previewFiles (chưa upload).
      */

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

@@ -11,12 +11,12 @@ export * from '@sdcorejs/angular/components/query-bar';
 export * from '@sdcorejs/angular/components/upload-file';
 export * from '@sdcorejs/angular/components/section';
 export * from '@sdcorejs/angular/components/inform';
+export * from '@sdcorejs/angular/components/form-generic';
 export * from '@sdcorejs/angular/components/anchor';
 export * from '@sdcorejs/angular/components/query-builder';
 export * from '@sdcorejs/angular/components/org-chart';
 export * from '@sdcorejs/angular/components/tree';
 export * from '@sdcorejs/angular/components/import-excel';
-export * from '@sdcorejs/angular/components/document-builder';
 export * from '@sdcorejs/angular/components/mini-editor';
 export * from '@sdcorejs/angular/components/view';
 export * from '@sdcorejs/angular/components/code-editor';
@@ -29,3 +29,8 @@ export * from '@sdcorejs/angular/components/breadcrumb';
 export * from '@sdcorejs/angular/components/data-state';
 export * from '@sdcorejs/angular/components/job-progress';
 export * from '@sdcorejs/angular/components/audit-diff';
+export * from '@sdcorejs/angular/components/ckeditor-styles';
+export * from '@sdcorejs/angular/components/history';
+export * from '@sdcorejs/angular/components/operator';
+export * from '@sdcorejs/angular/components/stepper';
+export * from '@sdcorejs/angular/components/tab';

package/types/sdcorejs-angular-configurations.d.ts

@@ -1,8 +1,7 @@
 import { InjectionToken } from '@angular/core';
-import { Language } from '@sdcorejs/angular/models';
+import { Language } from '@sdcorejs/utils/models';
 
 interface ISdCoreConfiguration {
-    licenseKey?: string | string[];
     format?: {
         number?: '1,234,567.89' | '1.234.567,89';
     };

package/types/sdcorejs-angular-forms-autocomplete.d.ts

@@ -13,9 +13,12 @@ declare class SdAutocompleteErrotStateMatcher implements ErrorStateMatcher {
     constructor(formControl: FormControl);
     isErrorState(control: FormControl | null, form: FormGroupDirective | NgForm | null): boolean;
 }
-declare class SdAutocomplete<T = any> implements OnInit, OnDestroy {
+declare class SdAutocomplete<T = unknown> implements OnInit, OnDestroy {
     #private;
     id: string;
+    /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
+     *  phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     autocompleteTrigger: _angular_core.Signal<MatAutocompleteTrigger | undefined>;
     sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -72,7 +75,7 @@ declare class SdAutocomplete<T = any> implements OnInit, OnDestroy {
     appearance: _angular_core.Signal<MatFormFieldAppearance>;
     valueModel: _angular_core.ModelSignal<string | number | null | undefined>;
     sdChange: _angular_core.OutputEmitterRef<string | number | null>;
-    sdSelection: _angular_core.OutputEmitterRef<SdSelectionData<any>>;
+    sdSelection: _angular_core.OutputEmitterRef<SdSelectionData<unknown>>;
     readonly sdAdd: EventEmitter<void>;
     loading: _angular_core.WritableSignal<boolean>;
     isFocused: boolean;

package/types/sdcorejs-angular-forms-chip-calendar.d.ts

@@ -17,6 +17,9 @@ declare class SdChipCalendarErrorStateMatcher implements ErrorStateMatcher {
 }
 declare class SdChipCalendar implements AfterViewInit, OnDestroy {
     #private;
+    /** why: id ổn định của <mat-error> để ô nhập chip trỏ `aria-describedby` sang — thông báo
+     *  lỗi phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     menuTrigger: _angular_core.Signal<MatMenuTrigger | undefined>;
     calendar: _angular_core.Signal<MatCalendar<Date> | undefined>;
     autoIdInput: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
@@ -65,6 +68,13 @@ declare class SdChipCalendar implements AfterViewInit, OnDestroy {
     onRemove: (item: string) => void;
     onSelect: (event: MatAutocompleteSelectedEvent) => void;
     onClick: () => void;
+    /**
+     * why: khi `sdViewDef` đang hiển thị thì bên trong KHÔNG còn phần tử nào focus được, nên
+     * click là lối vào DUY NHẤT để chuyển sang chế độ sửa. Bàn phím phải mở được y hệt chuột
+     * → Enter/Space chạy chung handler. preventDefault chặn Space cuộn trang (hành vi mặc
+     * định của phần tử không phải <button>).
+     */
+    onViewKeydown: (event: Event) => void;
     onClear: (evt?: any) => void;
     onSelectDate: (date: Date | null) => void;
     onCloseCalendar: () => void;

package/types/sdcorejs-angular-forms-date-range.d.ts

@@ -1,10 +1,11 @@
+import * as _sdcorejs_angular_forms_models from '@sdcorejs/angular/forms/models';
+import { SdViewed, SdViewedInput, SdTemporalValueTransform } from '@sdcorejs/angular/forms/models';
 import * as _angular_core from '@angular/core';
 import { TemplateRef } from '@angular/core';
 import { FormGroup, FormControl } from '@angular/forms';
 import { MatDateRangePicker, MatDatepickerInputEvent } from '@angular/material/datepicker';
 import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
 import { SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
-import { SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
 import { Size } from '@sdcorejs/utils/models';
 
 interface SdDateRangeValue {
@@ -15,6 +16,9 @@ declare class SdDateRange {
     #private;
     id1: string;
     id2: string;
+    /** why: id ổn định của <mat-error> để hai ô nhập trỏ `aria-describedby` sang — thông báo
+     *  lỗi phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     picker: _angular_core.Signal<MatDateRangePicker<Date> | undefined>;
     sdLabelDef: _angular_core.Signal<SdLabelDefDirective | undefined>;
     private cdRef;
@@ -68,12 +72,20 @@ declare class SdDateRange {
     resolvedMin: _angular_core.Signal<Date | null>;
     maxInput: _angular_core.InputSignal<any>;
     resolvedMax: _angular_core.Signal<Date | null>;
+    /**
+     * Output serialization strategy applied to **each endpoint** of the committed range. Affects
+     * `model` / `modelChange` / `sdChange` and the registered form field only — the field keeps
+     * showing `dd/MM/yyyy → dd/MM/yyyy`. Left unset, endpoints stay canonical `yyyy/MM/dd` strings.
+     */
+    transform: _angular_core.InputSignal<SdTemporalValueTransform | undefined>;
     valueModel: _angular_core.ModelSignal<SdDateRangeValue | null | undefined>;
     sdChange: _angular_core.OutputEmitterRef<SdDateRangeValue | null | undefined>;
     isMobileOrTablet: boolean;
     formControl: FormControl<any>;
     control1: FormControl<any>;
     control2: FormControl<any>;
+    /** Control registered in the parent form while a `transform` is active; holds the public model. */
+    readonly modelControl: _sdcorejs_angular_forms_models.SdFormControl;
     constructor();
     onStartChange: (event: MatDatepickerInputEvent<Date>) => void;
     onEndChange: (event: MatDatepickerInputEvent<Date>) => void;
@@ -84,7 +96,7 @@ declare class SdDateRange {
     onClosePicker: () => void;
     onOpenPicker: (event: MouseEvent) => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdDateRange, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdDateRange, "sd-date-range", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "minInput": { "alias": "min"; "required": false; "isSignal": true; }; "maxInput": { "alias": "max"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; }, ["sdLabelDef", "sdValueTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdDateRange, "sd-date-range", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "minInput": { "alias": "min"; "required": false; "isSignal": true; }; "maxInput": { "alias": "max"; "required": false; "isSignal": true; }; "transform": { "alias": "transform"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; }, ["sdLabelDef", "sdValueTemplate"], never, true, never>;
 }
 
 export { SdDateRange };

package/types/sdcorejs-angular-forms-date.d.ts

@@ -4,7 +4,7 @@ import { FormGroup } from '@angular/forms';
 import { MatDatepicker, MatDatepickerInputEvent } from '@angular/material/datepicker';
 import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
 import { SdViewDefDirective, SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
-import { SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/models';
+import { SdViewed, SdViewedInput, SdTemporalValueTransform, SdFormControl } from '@sdcorejs/angular/forms/models';
 import { Size } from '@sdcorejs/utils/models';
 
 type SdDateModelValue = string | number | Date | undefined | null;
@@ -16,6 +16,9 @@ type SdDateKeyupEvent = Event | {
 declare class SdDate implements OnDestroy, OnInit {
     #private;
     id: string;
+    /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
+     *  phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     datePicker: _angular_core.Signal<MatDatepicker<Date> | undefined>;
     sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -68,11 +71,19 @@ declare class SdDate implements OnDestroy, OnInit {
     maxInput: _angular_core.InputSignal<any>;
     maxDateInput: _angular_core.InputSignal<any>;
     resolvedMax: _angular_core.Signal<Date | null>;
+    /**
+     * Output serialization strategy for the committed value. Affects `model` / `modelChange` /
+     * `sdChange` and the registered form field only — the input keeps showing `dd/MM/yyyy`.
+     * Left unset, the component keeps emitting its canonical `yyyy/MM/dd` string.
+     */
+    transform: _angular_core.InputSignal<SdTemporalValueTransform | undefined>;
     valueModel: _angular_core.ModelSignal<SdDateModelValue>;
     sdChange: _angular_core.OutputEmitterRef<any>;
     sdFocus: _angular_core.OutputEmitterRef<void>;
     isMobileOrTablet: boolean;
     formControl: SdFormControl;
+    /** Control registered in the parent form while a `transform` is active; holds the public model. */
+    readonly modelControl: SdFormControl;
     isFocused: boolean;
     isValid?: boolean;
     ngOnInit(): void;
@@ -92,7 +103,7 @@ declare class SdDate implements OnDestroy, OnInit {
     onChange: (event: MatDatepickerInputEvent<Date>) => void;
     clear: ($event: any) => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdDate, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdDate, "sd-date", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "minInput": { "alias": "min"; "required": false; "isSignal": true; }; "minDateInput": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxInput": { "alias": "max"; "required": false; "isSignal": true; }; "maxDateInput": { "alias": "maxDate"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; }, ["sdLabelTemplate", "sdValueTemplate", "sdViewDef", "sdLabelDef"], ["[sdLabel]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdDate, "sd-date", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "minInput": { "alias": "min"; "required": false; "isSignal": true; }; "minDateInput": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxInput": { "alias": "max"; "required": false; "isSignal": true; }; "maxDateInput": { "alias": "maxDate"; "required": false; "isSignal": true; }; "transform": { "alias": "transform"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; }, ["sdLabelTemplate", "sdValueTemplate", "sdViewDef", "sdLabelDef"], ["[sdLabel]"], true, never>;
 }
 
 export { SdDate };

package/types/sdcorejs-angular-forms-datetime.d.ts

@@ -3,13 +3,16 @@ import { OnDestroy, OnInit, ElementRef, TemplateRef } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
 import { SdViewDefDirective } from '@sdcorejs/angular/forms/directives';
-import { SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/models';
+import { SdViewed, SdViewedInput, SdTemporalValueTransform, SdFormControl } from '@sdcorejs/angular/forms/models';
 import { Size } from '@sdcorejs/utils/models';
 
 type SdDatetimeModelValue = string | number | Date | undefined | null;
 declare class SdDatetime implements OnDestroy, OnInit {
     #private;
     id: string;
+    /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
+     *  phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     private readonly dateTimePicker;
     sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -64,12 +67,20 @@ declare class SdDatetime implements OnDestroy, OnInit {
     maxInput: _angular_core.InputSignal<any>;
     maxDateInput: _angular_core.InputSignal<any>;
     resolvedMax: _angular_core.Signal<Date | null>;
+    /**
+     * Output serialization strategy for the committed value. Affects `model` / `modelChange` /
+     * `sdChange` and the registered form field only — the field keeps displaying
+     * `dd/MM/yyyy HH:mm[:ss]` per `showSeconds`. Left unset, the canonical string is emitted.
+     */
+    transform: _angular_core.InputSignal<SdTemporalValueTransform | undefined>;
     valueModel: _angular_core.ModelSignal<SdDatetimeModelValue>;
     viewedDate: _angular_core.Signal<Date | null>;
     sdChange: _angular_core.OutputEmitterRef<any>;
     sdFocus: _angular_core.OutputEmitterRef<void>;
     isMobileOrTablet: boolean;
     formControl: SdFormControl;
+    /** Control registered in the parent form while a `transform` is active; holds the public model. */
+    readonly modelControl: SdFormControl;
     isFocused: boolean;
     isValid?: boolean;
     /** State popup — true khi picker package đang mở. */
@@ -95,7 +106,7 @@ declare class SdDatetime implements OnDestroy, OnInit {
     onConfirmInput: (event: any) => void;
     clear: ($event: any) => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdDatetime, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdDatetime, "sd-datetime", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "minInput": { "alias": "min"; "required": false; "isSignal": true; }; "minDateInput": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxInput": { "alias": "max"; "required": false; "isSignal": true; }; "maxDateInput": { "alias": "maxDate"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; }, ["sdLabelTemplate", "sdValueTemplate", "sdViewDef"], ["[sdLabel]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdDatetime, "sd-datetime", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "minInput": { "alias": "min"; "required": false; "isSignal": true; }; "minDateInput": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxInput": { "alias": "max"; "required": false; "isSignal": true; }; "maxDateInput": { "alias": "maxDate"; "required": false; "isSignal": true; }; "transform": { "alias": "transform"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; }, ["sdLabelTemplate", "sdValueTemplate", "sdViewDef"], ["[sdLabel]"], true, never>;
 }
 
 export { SdDatetime };

package/types/sdcorejs-angular-forms-entity-picker.d.ts

@@ -60,6 +60,7 @@ declare class SdEntityPicker<T = unknown, TKey = string | number> {
     readonly selectedTemplate: _angular_core.Signal<SdEntityPickerSelectedTemplateDirective<any, any> | undefined>;
     readonly rowTemplate: _angular_core.Signal<SdEntityPickerRowTemplateDirective<any> | undefined>;
     readonly detailTemplate: _angular_core.Signal<SdEntityPickerDetailTemplateDirective<any, any> | undefined>;
+    readonly errorId: string;
     readonly autoIdInput: _angular_core.InputSignal<string | null | undefined>;
     readonly autoId: _angular_core.Signal<string | undefined>;
     readonly name: _angular_core.InputSignal<string>;
@@ -80,6 +81,8 @@ declare class SdEntityPicker<T = unknown, TKey = string | number> {
     readonly disabledEntity: _angular_core.InputSignal<((item: T) => boolean) | undefined>;
     readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Component-local error text. Set it to force the control invalid and render the message. */
+    readonly inlineError: _angular_core.InputSignal<string | undefined>;
     readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -88,11 +91,14 @@ declare class SdEntityPicker<T = unknown, TKey = string | number> {
     readonly model: _angular_core.ModelSignal<SdEntityPickerModel<TKey>>;
     readonly sdChange: _angular_core.OutputEmitterRef<SdEntityPickerModel<TKey>>;
     readonly sdAdd: _angular_core.OutputEmitterRef<void>;
-    readonly sdLoadError: _angular_core.OutputEmitterRef<unknown>;
+    readonly loadError: _angular_core.OutputEmitterRef<unknown>;
     readonly formControl: SdFormControl;
+    readonly errorMessage: _angular_core.Signal<string | undefined>;
     readonly connectorState: _angular_core.Signal<_sdcorejs_angular_forms_models.ɵSdFormControlConnectorState<SdEntityPickerModel<TKey>>>;
+    /** Interaction-gated validation message; `undefined` until the control is touched/dirty. */
+    readonly visibleErrorMessage: _angular_core.Signal<string | undefined>;
     readonly draftKeys: _angular_core.WritableSignal<TKey[]>;
-    readonly loadError: _angular_core.WritableSignal<unknown>;
+    readonly loadErrorState: _angular_core.WritableSignal<unknown>;
     readonly loading: _angular_core.WritableSignal<boolean>;
     readonly hydrating: _angular_core.WritableSignal<boolean>;
     readonly query: _angular_core.WritableSignal<SdQuery<T>>;
@@ -120,7 +126,7 @@ declare class SdEntityPicker<T = unknown, TKey = string | number> {
     keyOf(item: T): TKey;
     displayEntity(item: T): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdEntityPicker<any, any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdEntityPicker<any, any>, "sd-entity-picker", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "modalTitle": { "alias": "modalTitle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "provider": { "alias": "provider"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "queryFields": { "alias": "queryFields"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "keySelector": { "alias": "keySelector"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "disabledEntity": { "alias": "disabledEntity"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; "sdChange": "sdChange"; "sdAdd": "sdAdd"; "sdLoadError": "sdLoadError"; }, ["selectedTemplate", "rowTemplate", "detailTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdEntityPicker<any, any>, "sd-entity-picker", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "modalTitle": { "alias": "modalTitle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "provider": { "alias": "provider"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "queryFields": { "alias": "queryFields"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "keySelector": { "alias": "keySelector"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "disabledEntity": { "alias": "disabledEntity"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; "sdChange": "sdChange"; "sdAdd": "sdAdd"; "loadError": "loadError"; }, ["selectedTemplate", "rowTemplate", "detailTemplate"], never, true, never>;
 }
 declare function normalizePickerKeys<TKey>(value: SdEntityPickerModel<TKey>, multiple: boolean): TKey[];
 

package/types/sdcorejs-angular-forms-input-color.d.ts

@@ -24,6 +24,10 @@ declare class SdInputColor {
     readonly hideInlineError: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Display mode — forwarded to the inner `<sd-input>`. `'inline'` = borderless inline-edit; disabled `'inline'` → static. */
     readonly viewed: _angular_core.InputSignalWithTransform<SdViewed, SdViewedInput>;
+    /** `true` when `viewed === true` (static view — no editor, no picker). */
+    readonly isViewed: _angular_core.Signal<boolean>;
+    /** `true` when `viewed === 'inline'` and the control is still editable. */
+    readonly isInline: _angular_core.Signal<boolean>;
     readonly valueModel: _angular_core.ModelSignal<string | null | undefined>;
     readonly sdChange: _angular_core.OutputEmitterRef<string | null | undefined>;
     readonly picker: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;

package/types/sdcorejs-angular-forms-input-number.d.ts

@@ -16,6 +16,9 @@ declare class SdInputNumberErrotStateMatcher implements ErrorStateMatcher {
 declare class SdInputNumber implements OnDestroy, OnInit, AfterViewInit {
     #private;
     id: string;
+    /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
+     *  phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     control: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     /** The inline primitive — only present when `viewed='inline'`; drives focus/blur in that mode. */
     inlineRef: _angular_core.Signal<SdInlineText | undefined>;

package/types/sdcorejs-angular-forms-input.d.ts

@@ -56,6 +56,9 @@ declare function sdResolveInputMask(mask: SdInputMask | null | undefined): SdInp
 declare class SdInput implements OnDestroy, OnInit, AfterViewInit {
     #private;
     id: string;
+    /** why: id ổn định của <mat-error> để `<input>` trỏ `aria-describedby` sang — thông báo lỗi
+     *  phải đọc được từ chính control, không chỉ hiện ra màn hình. */
+    readonly errorId: string;
     control: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     /** The inline primitive — only present when `viewed='inline'`; drives focus/blur in that mode. */
     inlineRef: _angular_core.Signal<SdInlineText | undefined>;