@sdcorejs/angular 19.1.6 → 19.2.0

package/fesm2022/sdcorejs-angular-utilities-models.mjs

@@ -1,71 +1,9 @@
-import { EMPTY_STR } from '@sdcorejs/utils/constants';
-export { EMPTY_STR, VALIDATION_PATTERNS } from '@sdcorejs/utils/constants';
-import { StringUtilities } from '@sdcorejs/utils/fns';
-import { resolveMaybeAsync, normalizeAsync } from '@sdcorejs/utils/models';
-export { normalizeAsync, resolveMaybeAsync } from '@sdcorejs/utils/models';
-
 const DefaultSdIconSet = 'material-icons-outlined';
 const DefaultSdMaterialIconSet = 'material-icons-outlined';
 
-// `name` và `errorMessage` chứa i18n KEY (không phải chuỗi đã dịch).
-/** @deprecated Use `VALIDATION_PATTERNS` from `@sdcorejs/utils/constants` instead. */
-const SdPatternCommons = [
-    { type: 'EMAIL', name: 'core.validator.email.name', regex: StringUtilities.REGEX_EMAIL, errorMessage: 'core.validator.email.error' },
-    { type: 'PHONE', name: 'core.validator.phone.name', regex: StringUtilities.REGEX_PHONE, errorMessage: 'core.validator.phone.error' },
-    {
-        type: 'PHONE_VN',
-        name: 'core.validator.phone-vn.name',
-        regex: StringUtilities.REGEX_VN_PHONE,
-        errorMessage: 'core.validator.phone-vn.error',
-    },
-    { type: 'IDVN', name: 'core.validator.cccd.name', regex: StringUtilities.REGEX_VN_ID, errorMessage: 'core.validator.cccd.error' },
-    {
-        type: 'PASSPORT',
-        name: 'core.validator.passport.name',
-        regex: StringUtilities.REGEX_PASSPORT,
-        errorMessage: 'core.validator.passport.error',
-    },
-    {
-        type: 'IDVN_OR_PASSPORT',
-        name: 'core.validator.id-vn.name',
-        regex: StringUtilities.REGEX_VN_ID_OR_PASSPORT,
-        errorMessage: 'core.validator.id-vn.error',
-    },
-    { type: 'TIME', name: 'core.validator.time.name', regex: StringUtilities.REGEX_TIME, errorMessage: 'core.validator.time.error' },
-];
-
-/** @deprecated Use {@link EMPTY_STR} from `@sdcorejs/utils/constants` instead */
-const SD_EMPTY_STR = EMPTY_STR;
-
-/** @deprecated Use {@link resolveMaybeAsync} from `@sdcorejs/utils/models` instead */
-const SdResolveMaybeAsync = resolveMaybeAsync;
-/** @deprecated Use {@link normalizeAsync} from `@sdcorejs/utils/models` instead */
-const SdNormalizeAsync = normalizeAsync;
-
-// `display` chứa i18n KEY (không phải chuỗi đã dịch).
-// Consumer phải gọi i18n.t(display) trước khi render ra UI.
-// @deprecated Use `OPERATORS` from `@sdcorejs/utils/constants` instead.
-// Note: OPERATORS has translated display labels; SdOperators uses i18n keys.
-const SdOperators = [
-    { value: 'EQUAL', symbol: '=', display: 'core.operator.equal.display' },
-    { value: 'NOT_EQUAL', symbol: '≠', display: 'core.operator.not-equal.display' },
-    { value: 'GREATER_THAN', symbol: '>', display: 'core.operator.greater-than.display' },
-    { value: 'LESS_THAN', symbol: '<', display: 'core.operator.less-than.display' },
-    { value: 'GREATER_OR_EQUAL', symbol: '≥', display: 'core.operator.greater-or-equal.display' },
-    { value: 'LESS_OR_EQUAL', symbol: '≤', display: 'core.operator.less-or-equal.display' },
-    { value: 'CONTAIN', symbol: 'join_inner', display: 'core.operator.contain.display' },
-    { value: 'NOT_CONTAIN', symbol: 'join', display: 'core.operator.not-contain.display' },
-    { value: 'START_WITH', symbol: 'line_start_circle', display: 'core.operator.start-with.display' },
-    { value: 'END_WITH', symbol: 'line_end_circle', display: 'core.operator.end-with.display' },
-    { value: 'IN', symbol: 'checklist_rtl', display: 'core.operator.in.display' },
-    { value: 'NOT_IN', symbol: 'event_list', display: 'core.operator.not-in.display' },
-    { value: 'NULL', symbol: 'motion_photos_off', display: 'core.operator.null.display' },
-    { value: 'NOT_NULL', symbol: 'adjust', display: 'core.operator.not-null.display' },
-];
-
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { DefaultSdIconSet, DefaultSdMaterialIconSet, SD_EMPTY_STR, SdNormalizeAsync, SdOperators, SdPatternCommons, SdResolveMaybeAsync };
+export { DefaultSdIconSet, DefaultSdMaterialIconSet };
 //# sourceMappingURL=sdcorejs-angular-utilities-models.mjs.map

package/fesm2022/sdcorejs-angular-utilities-models.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sdcorejs-angular-utilities-models.mjs","sources":["../../../projects/sdcorejs-angular/utilities/models/src/icon.model.ts","../../../projects/sdcorejs-angular/utilities/models/src/pattern.model.ts","../../../projects/sdcorejs-angular/utilities/models/src/empty.model.ts","../../../projects/sdcorejs-angular/utilities/models/src/maybe-async.model.ts","../../../projects/sdcorejs-angular/utilities/models/src/operator.model.ts","../../../projects/sdcorejs-angular/utilities/models/sdcorejs-angular-utilities-models.ts"],"sourcesContent":["export type SdIconSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp' | 'lucide';\nexport type SdMaterialIconSet = Exclude<SdIconSet, 'lucide'>;\nexport const DefaultSdIconSet: SdIconSet = 'material-icons-outlined';\nexport const DefaultSdMaterialIconSet: SdMaterialIconSet = 'material-icons-outlined';\n","import type { ValidationPatternType, ValidationPattern } from '@sdcorejs/utils/models';\nimport { VALIDATION_PATTERNS } from '@sdcorejs/utils/constants';\nimport { StringUtilities } from '@sdcorejs/utils/fns';\nexport type { ValidationPatternType, ValidationPattern };\nexport { VALIDATION_PATTERNS };\n\n/**\n * @deprecated Use {@link ValidationPatternType} from `@sdcorejs/utils/models` instead.\n * Note: member names changed — PHONE_VN → VN_PHONE, IDVN → VN_ID, IDVN_OR_PASSPORT → VN_ID_OR_PASSPORT.\n */\nexport type SdPatternType = 'EMAIL' | 'PHONE' | 'PHONE_VN' | 'IDVN' | 'PASSPORT' | 'IDVN_OR_PASSPORT' | 'TIME';\n\n/**\n * @deprecated Use {@link ValidationPattern} from `@sdcorejs/utils/models` instead.\n * Note: `regex` field renamed to `pattern` to align with Angular `Validators.pattern()`.\n */\nexport interface SdPatternCommon {\n  type: SdPatternType;\n  name: string;\n  regex: string;\n  errorMessage: string;\n}\n\n// `name` và `errorMessage` chứa i18n KEY (không phải chuỗi đã dịch).\n/** @deprecated Use `VALIDATION_PATTERNS` from `@sdcorejs/utils/constants` instead. */\nexport const SdPatternCommons: SdPatternCommon[] = [\n  { type: 'EMAIL', name: 'core.validator.email.name', regex: StringUtilities.REGEX_EMAIL, errorMessage: 'core.validator.email.error' },\n  { type: 'PHONE', name: 'core.validator.phone.name', regex: StringUtilities.REGEX_PHONE, errorMessage: 'core.validator.phone.error' },\n  {\n    type: 'PHONE_VN',\n    name: 'core.validator.phone-vn.name',\n    regex: StringUtilities.REGEX_VN_PHONE,\n    errorMessage: 'core.validator.phone-vn.error',\n  },\n  { type: 'IDVN', name: 'core.validator.cccd.name', regex: StringUtilities.REGEX_VN_ID, errorMessage: 'core.validator.cccd.error' },\n  {\n    type: 'PASSPORT',\n    name: 'core.validator.passport.name',\n    regex: StringUtilities.REGEX_PASSPORT,\n    errorMessage: 'core.validator.passport.error',\n  },\n  {\n    type: 'IDVN_OR_PASSPORT',\n    name: 'core.validator.id-vn.name',\n    regex: StringUtilities.REGEX_VN_ID_OR_PASSPORT,\n    errorMessage: 'core.validator.id-vn.error',\n  },\n  { type: 'TIME', name: 'core.validator.time.name', regex: StringUtilities.REGEX_TIME, errorMessage: 'core.validator.time.error' },\n];\n","import { EMPTY_STR } from '@sdcorejs/utils/constants';\nexport { EMPTY_STR };\n\n/** @deprecated Use {@link EMPTY_STR} from `@sdcorejs/utils/constants` instead */\nexport const SD_EMPTY_STR = EMPTY_STR;\n","import type { MaybeAsync } from '@sdcorejs/utils/models';\nimport { resolveMaybeAsync, normalizeAsync } from '@sdcorejs/utils/models';\nexport type { MaybeAsync };\nexport { resolveMaybeAsync, normalizeAsync };\n\n/** @deprecated Use {@link MaybeAsync} from `@sdcorejs/utils/models` instead */\nexport type SdMaybeAsync<T> = MaybeAsync<T>;\n/** @deprecated Use {@link resolveMaybeAsync} from `@sdcorejs/utils/models` instead */\nexport const SdResolveMaybeAsync = resolveMaybeAsync;\n/** @deprecated Use {@link normalizeAsync} from `@sdcorejs/utils/models` instead */\nexport const SdNormalizeAsync = normalizeAsync;\n","import type { Operator, OperatorHasData, OperatorNoData } from '@sdcorejs/utils/models';\nexport type { Operator, OperatorHasData, OperatorNoData };\n\n/** @deprecated Use {@link Operator} from `@sdcorejs/utils/models` instead */\nexport type SdOperator = Operator;\n/** @deprecated Use {@link OperatorHasData} from `@sdcorejs/utils/models` instead */\nexport type SdOperatorHasData = OperatorHasData;\n/** @deprecated Use {@link OperatorNoData} from `@sdcorejs/utils/models` instead */\nexport type SdOperatorNoData = OperatorNoData;\n\n// `display` chứa i18n KEY (không phải chuỗi đã dịch).\n// Consumer phải gọi i18n.t(display) trước khi render ra UI.\n// @deprecated Use `OPERATORS` from `@sdcorejs/utils/constants` instead.\n// Note: OPERATORS has translated display labels; SdOperators uses i18n keys.\nexport const SdOperators: {\n  value: Operator;\n  symbol?: string;\n  display: string;\n}[] = [\n  { value: 'EQUAL', symbol: '=', display: 'core.operator.equal.display' },\n  { value: 'NOT_EQUAL', symbol: '≠', display: 'core.operator.not-equal.display' },\n  { value: 'GREATER_THAN', symbol: '>', display: 'core.operator.greater-than.display' },\n  { value: 'LESS_THAN', symbol: '<', display: 'core.operator.less-than.display' },\n  { value: 'GREATER_OR_EQUAL', symbol: '≥', display: 'core.operator.greater-or-equal.display' },\n  { value: 'LESS_OR_EQUAL', symbol: '≤', display: 'core.operator.less-or-equal.display' },\n  { value: 'CONTAIN', symbol: 'join_inner', display: 'core.operator.contain.display' },\n  { value: 'NOT_CONTAIN', symbol: 'join', display: 'core.operator.not-contain.display' },\n  { value: 'START_WITH', symbol: 'line_start_circle', display: 'core.operator.start-with.display' },\n  { value: 'END_WITH', symbol: 'line_end_circle', display: 'core.operator.end-with.display' },\n  { value: 'IN', symbol: 'checklist_rtl', display: 'core.operator.in.display' },\n  { value: 'NOT_IN', symbol: 'event_list', display: 'core.operator.not-in.display' },\n  { value: 'NULL', symbol: 'motion_photos_off', display: 'core.operator.null.display' },\n  { value: 'NOT_NULL', symbol: 'adjust', display: 'core.operator.not-null.display' },\n];\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;AAEO,MAAM,gBAAgB,GAAc;AACpC,MAAM,wBAAwB,GAAsB;;ACoB3D;AACA;AACO,MAAM,gBAAgB,GAAsB;AACjD,IAAA,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,EAAE,YAAY,EAAE,4BAA4B,EAAE;AACpI,IAAA,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,EAAE,YAAY,EAAE,4BAA4B,EAAE;AACpI,IAAA;AACE,QAAA,IAAI,EAAE,UAAU;AAChB,QAAA,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,eAAe,CAAC,cAAc;AACrC,QAAA,YAAY,EAAE,+BAA+B;AAC9C,KAAA;AACD,IAAA,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,EAAE,YAAY,EAAE,2BAA2B,EAAE;AACjI,IAAA;AACE,QAAA,IAAI,EAAE,UAAU;AAChB,QAAA,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,eAAe,CAAC,cAAc;AACrC,QAAA,YAAY,EAAE,+BAA+B;AAC9C,KAAA;AACD,IAAA;AACE,QAAA,IAAI,EAAE,kBAAkB;AACxB,QAAA,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,eAAe,CAAC,uBAAuB;AAC9C,QAAA,YAAY,EAAE,4BAA4B;AAC3C,KAAA;AACD,IAAA,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,2BAA2B,EAAE;;;AC5ClI;AACO,MAAM,YAAY,GAAG;;ACG5B;AACO,MAAM,mBAAmB,GAAG;AACnC;AACO,MAAM,gBAAgB,GAAG;;ACAhC;AACA;AACA;AACA;AACO,MAAM,WAAW,GAIlB;IACJ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,6BAA6B,EAAE;IACvE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,iCAAiC,EAAE;IAC/E,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,oCAAoC,EAAE;IACrF,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,iCAAiC,EAAE;IAC/E,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,wCAAwC,EAAE;IAC7F,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,qCAAqC,EAAE;IACvF,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,+BAA+B,EAAE;IACpF,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACtF,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,kCAAkC,EAAE;IACjG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,gCAAgC,EAAE;IAC3F,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,0BAA0B,EAAE;IAC7E,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,8BAA8B,EAAE;IAClF,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,4BAA4B,EAAE;IACrF,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,EAAE;;;AChCpF;;AAEG;;;;"}
+{"version":3,"file":"sdcorejs-angular-utilities-models.mjs","sources":["../../../projects/sdcorejs-angular/utilities/models/src/icon.model.ts","../../../projects/sdcorejs-angular/utilities/models/sdcorejs-angular-utilities-models.ts"],"sourcesContent":["export type SdIconSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp' | 'lucide';\nexport type SdMaterialIconSet = Exclude<SdIconSet, 'lucide'>;\nexport const DefaultSdIconSet: SdIconSet = 'material-icons-outlined';\nexport const DefaultSdMaterialIconSet: SdMaterialIconSet = 'material-icons-outlined';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"AAEO,MAAM,gBAAgB,GAAc;AACpC,MAAM,wBAAwB,GAAsB;;ACH3D;;AAEG;;;;"}

package/fesm2022/sdcorejs-angular.mjs

@@ -1,16 +1,23 @@
-import '@sdcorejs/angular/configurations';
-import '@sdcorejs/angular/utilities';
-import '@sdcorejs/angular/pipes';
-import '@sdcorejs/angular/directives';
-import '@sdcorejs/angular/services';
-import '@sdcorejs/angular/interceptors';
-import '@sdcorejs/angular/handlers';
-import '@sdcorejs/angular/components';
-import '@sdcorejs/angular/forms';
-import '@sdcorejs/angular/modules';
+export * from '@sdcorejs/angular/configurations';
+export * from '@sdcorejs/angular/i18n';
+export * from '@sdcorejs/angular/utilities';
+export * from '@sdcorejs/angular/pipes';
+export * from '@sdcorejs/angular/directives';
+export * from '@sdcorejs/angular/services';
+export * from '@sdcorejs/angular/interceptors';
+export * from '@sdcorejs/angular/handlers';
+export * from '@sdcorejs/angular/components';
+export * from '@sdcorejs/angular/forms';
+export * from '@sdcorejs/angular/modules';
 
 /*
  * Public API Surface of sd-angular
+ *
+ * why: these were previously bare `import '...'` statements, which meant the primary
+ * entry point re-exported NOTHING — `import { SdButton } from '@sdcorejs/angular'`
+ * resolved to nothing for every symbol, and the built FESM bundle was 517 bytes with
+ * no `export` statement. Deep imports (`@sdcorejs/angular/components/button`) remain
+ * the recommended path for bundle size; this barrel exists so the root import works.
  */
 
 /**

package/fesm2022/sdcorejs-angular.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sdcorejs-angular.mjs","sources":["../../../projects/sdcorejs-angular/src/public-api.ts","../../../projects/sdcorejs-angular/src/sdcorejs-angular.ts"],"sourcesContent":["/*\n * Public API Surface of sd-angular\n */\nimport '@sdcorejs/angular/configurations';\nimport '@sdcorejs/angular/utilities';\nimport '@sdcorejs/angular/pipes';\nimport '@sdcorejs/angular/directives';\nimport '@sdcorejs/angular/services';\nimport '@sdcorejs/angular/interceptors';\nimport '@sdcorejs/angular/handlers';\nimport '@sdcorejs/angular/components';\nimport '@sdcorejs/angular/forms';\nimport '@sdcorejs/angular/modules';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;AAAA;;AAEG;;ACFH;;AAEG"}
+{"version":3,"file":"sdcorejs-angular.mjs","sources":["../../../projects/sdcorejs-angular/src/public-api.ts","../../../projects/sdcorejs-angular/src/sdcorejs-angular.ts"],"sourcesContent":["/*\n * Public API Surface of sd-angular\n *\n * why: these were previously bare `import '...'` statements, which meant the primary\n * entry point re-exported NOTHING — `import { SdButton } from '@sdcorejs/angular'`\n * resolved to nothing for every symbol, and the built FESM bundle was 517 bytes with\n * no `export` statement. Deep imports (`@sdcorejs/angular/components/button`) remain\n * the recommended path for bundle size; this barrel exists so the root import works.\n */\nexport * from '@sdcorejs/angular/configurations';\nexport * from '@sdcorejs/angular/i18n';\nexport * from '@sdcorejs/angular/utilities';\nexport * from '@sdcorejs/angular/pipes';\nexport * from '@sdcorejs/angular/directives';\nexport * from '@sdcorejs/angular/services';\nexport * from '@sdcorejs/angular/interceptors';\nexport * from '@sdcorejs/angular/handlers';\nexport * from '@sdcorejs/angular/components';\nexport * from '@sdcorejs/angular/forms';\nexport * from '@sdcorejs/angular/modules';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;;;;;;;AAQG;;ACRH;;AAEG"}

package/forms/autocomplete/src/autocomplete.component.d.ts

@@ -12,9 +12,12 @@ declare class SdAutocompleteErrotStateMatcher implements ErrorStateMatcher {
     constructor(formControl: FormControl);
     isErrorState(control: FormControl | null, form: FormGroupDirective | NgForm | null): boolean;
 }
-export declare class SdAutocomplete<T = any> implements OnInit, OnDestroy {
+export 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: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
     autocompleteTrigger: import("@angular/core").Signal<MatAutocompleteTrigger | undefined>;
     sdLabelTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
@@ -71,7 +74,7 @@ export declare class SdAutocomplete<T = any> implements OnInit, OnDestroy {
     appearance: import("@angular/core").Signal<MatFormFieldAppearance>;
     valueModel: import("@angular/core").ModelSignal<string | number | null | undefined>;
     sdChange: import("@angular/core").OutputEmitterRef<string | number | null>;
-    sdSelection: import("@angular/core").OutputEmitterRef<SdSelectionData<any>>;
+    sdSelection: import("@angular/core").OutputEmitterRef<SdSelectionData<unknown>>;
     readonly sdAdd: EventEmitter<void>;
     loading: import("@angular/core").WritableSignal<boolean>;
     isFocused: boolean;

package/forms/chip-calendar/src/chip-calendar.component.d.ts

@@ -16,6 +16,9 @@ declare class SdChipCalendarErrorStateMatcher implements ErrorStateMatcher {
 }
 export 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: import("@angular/core").Signal<MatMenuTrigger | undefined>;
     calendar: import("@angular/core").Signal<MatCalendar<Date> | undefined>;
     autoIdInput: import("@angular/core").InputSignalWithTransform<string | undefined, string | null | undefined>;
@@ -64,6 +67,13 @@ export 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/forms/date/src/date.component.d.ts

@@ -3,7 +3,7 @@ import { FormGroup } from '@angular/forms';
 import { MatDatepicker, MatDatepickerInputEvent } from '@angular/material/datepicker';
 import { FloatLabelType, MatFormFieldAppearance } from '@angular/material/form-field';
 import { SdLabelDefDirective, SdViewDefDirective } from '@sdcorejs/angular/forms/directives';
-import { SdFormControl, SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
+import { SdFormControl, SdTemporalValueTransform, SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
 import { Size } from '@sdcorejs/utils/models';
 import * as i0 from "@angular/core";
 type SdDateModelValue = string | number | Date | undefined | null;
@@ -15,6 +15,9 @@ type SdDateKeyupEvent = Event | {
 export 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: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
     datePicker: import("@angular/core").Signal<MatDatepicker<Date> | undefined>;
     sdLabelTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
@@ -67,11 +70,19 @@ export declare class SdDate implements OnDestroy, OnInit {
     maxInput: import("@angular/core").InputSignal<any>;
     maxDateInput: import("@angular/core").InputSignal<any>;
     resolvedMax: import("@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: import("@angular/core").InputSignal<SdTemporalValueTransform | undefined>;
     valueModel: import("@angular/core").ModelSignal<SdDateModelValue>;
     sdChange: import("@angular/core").OutputEmitterRef<any>;
     sdFocus: import("@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;
@@ -91,6 +102,6 @@ export declare class SdDate implements OnDestroy, OnInit {
     onChange: (event: MatDatepickerInputEvent<Date>) => void;
     clear: ($event: any) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdDate, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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 {};

package/forms/date-range/src/date-range.component.d.ts

@@ -3,7 +3,7 @@ import { FormControl, FormGroup } from '@angular/forms';
 import { MatDatepickerInputEvent, MatDateRangePicker } from '@angular/material/datepicker';
 import { FloatLabelType, MatFormFieldAppearance } from '@angular/material/form-field';
 import { SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
-import { SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
+import { SdTemporalValueTransform, SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
 import { Size } from '@sdcorejs/utils/models';
 import * as i0 from "@angular/core";
 export interface SdDateRangeValue {
@@ -14,6 +14,9 @@ export 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: import("@angular/core").Signal<MatDateRangePicker<Date> | undefined>;
     sdLabelDef: import("@angular/core").Signal<SdLabelDefDirective | undefined>;
     private cdRef;
@@ -67,12 +70,20 @@ export declare class SdDateRange {
     resolvedMin: import("@angular/core").Signal<Date | null>;
     maxInput: import("@angular/core").InputSignal<any>;
     resolvedMax: import("@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: import("@angular/core").InputSignal<SdTemporalValueTransform | undefined>;
     valueModel: import("@angular/core").ModelSignal<SdDateRangeValue | null | undefined>;
     sdChange: import("@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: import("@sdcorejs/angular/forms/models").SdFormControl;
     constructor();
     onStartChange: (event: MatDatepickerInputEvent<Date>) => void;
     onEndChange: (event: MatDatepickerInputEvent<Date>) => void;
@@ -83,5 +94,5 @@ export declare class SdDateRange {
     onClosePicker: () => void;
     onOpenPicker: (event: MouseEvent) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdDateRange, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }

package/forms/datetime/src/datetime.component.d.ts

@@ -2,13 +2,16 @@ import { ElementRef, OnDestroy, OnInit, TemplateRef } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { FloatLabelType, MatFormFieldAppearance } from '@angular/material/form-field';
 import { SdViewDefDirective } from '@sdcorejs/angular/forms/directives';
-import { SdFormControl, SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
+import { SdFormControl, SdTemporalValueTransform, SdViewed, SdViewedInput } from '@sdcorejs/angular/forms/models';
 import { Size } from '@sdcorejs/utils/models';
 import * as i0 from "@angular/core";
 type SdDatetimeModelValue = string | number | Date | undefined | null;
 export 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: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
     private readonly dateTimePicker;
     sdLabelTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
@@ -63,12 +66,20 @@ export declare class SdDatetime implements OnDestroy, OnInit {
     maxInput: import("@angular/core").InputSignal<any>;
     maxDateInput: import("@angular/core").InputSignal<any>;
     resolvedMax: import("@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: import("@angular/core").InputSignal<SdTemporalValueTransform | undefined>;
     valueModel: import("@angular/core").ModelSignal<SdDatetimeModelValue>;
     viewedDate: import("@angular/core").Signal<Date | null>;
     sdChange: import("@angular/core").OutputEmitterRef<any>;
     sdFocus: import("@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ở. */
@@ -94,6 +105,6 @@ export declare class SdDatetime implements OnDestroy, OnInit {
     onConfirmInput: (event: any) => void;
     clear: ($event: any) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdDatetime, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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 {};

package/forms/entity-picker/src/entity-picker.component.d.ts

@@ -58,6 +58,7 @@ export declare class SdEntityPicker<T = unknown, TKey = string | number> {
     readonly selectedTemplate: import("@angular/core").Signal<SdEntityPickerSelectedTemplateDirective<any, any> | undefined>;
     readonly rowTemplate: import("@angular/core").Signal<SdEntityPickerRowTemplateDirective<any> | undefined>;
     readonly detailTemplate: import("@angular/core").Signal<SdEntityPickerDetailTemplateDirective<any, any> | undefined>;
+    readonly errorId: string;
     readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
     readonly autoId: import("@angular/core").Signal<string | undefined>;
     readonly name: import("@angular/core").InputSignal<string>;
@@ -78,6 +79,8 @@ export declare class SdEntityPicker<T = unknown, TKey = string | number> {
     readonly disabledEntity: import("@angular/core").InputSignal<((item: T) => boolean) | undefined>;
     readonly multiple: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly required: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Component-local error text. Set it to force the control invalid and render the message. */
+    readonly inlineError: import("@angular/core").InputSignal<string | undefined>;
     readonly clearable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly readonly: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
@@ -86,11 +89,14 @@ export declare class SdEntityPicker<T = unknown, TKey = string | number> {
     readonly model: import("@angular/core").ModelSignal<SdEntityPickerModel<TKey>>;
     readonly sdChange: import("@angular/core").OutputEmitterRef<SdEntityPickerModel<TKey>>;
     readonly sdAdd: import("@angular/core").OutputEmitterRef<void>;
-    readonly sdLoadError: import("@angular/core").OutputEmitterRef<unknown>;
+    readonly loadError: import("@angular/core").OutputEmitterRef<unknown>;
     readonly formControl: SdFormControl;
+    readonly errorMessage: import("@angular/core").Signal<string | undefined>;
     readonly connectorState: import("@angular/core").Signal<import("@sdcorejs/angular/forms/models").ɵSdFormControlConnectorState<SdEntityPickerModel<TKey>>>;
+    /** Interaction-gated validation message; `undefined` until the control is touched/dirty. */
+    readonly visibleErrorMessage: import("@angular/core").Signal<string | undefined>;
     readonly draftKeys: import("@angular/core").WritableSignal<TKey[]>;
-    readonly loadError: import("@angular/core").WritableSignal<unknown>;
+    readonly loadErrorState: import("@angular/core").WritableSignal<unknown>;
     readonly loading: import("@angular/core").WritableSignal<boolean>;
     readonly hydrating: import("@angular/core").WritableSignal<boolean>;
     readonly query: import("@angular/core").WritableSignal<SdQuery<T>>;
@@ -118,6 +124,6 @@ export declare class SdEntityPicker<T = unknown, TKey = string | number> {
     keyOf(item: T): TKey;
     displayEntity(item: T): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdEntityPicker<any, any>, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }
 export declare function normalizePickerKeys<TKey>(value: SdEntityPickerModel<TKey>, multiple: boolean): TKey[];

package/forms/input/src/input.component.d.ts

@@ -10,6 +10,9 @@ import * as i0 from "@angular/core";
 export 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: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
     /** The inline primitive — only present when `viewed='inline'`; drives focus/blur in that mode. */
     inlineRef: import("@angular/core").Signal<SdInlineText | undefined>;

package/forms/input-color/src/input-color.component.d.ts

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

package/forms/input-number/src/input-number.component.d.ts

@@ -15,6 +15,9 @@ declare class SdInputNumberErrotStateMatcher implements ErrorStateMatcher {
 export 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: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
     /** The inline primitive — only present when `viewed='inline'`; drives focus/blur in that mode. */
     inlineRef: import("@angular/core").Signal<SdInlineText | undefined>;

package/forms/models/index.d.ts

@@ -5,5 +5,8 @@ export type * from './src/sd-selection-data.model';
 export type * from './src/sd-search.model';
 export * from './src/form-control-state';
 export * from './src/sd-viewed';
+export * from './src/sd-temporal-transform';
+export * from './src/sd-model-facing-control';
+export * from './src/sd-timer-scope';
 export * from './src/sd-form-control-connector';
 export * from './src/sd-strict-date-adapter';

package/forms/models/src/sd-form-control-connector.d.ts

@@ -11,6 +11,18 @@ interface ɵSdFormControlConnectorBaseOptions<TControl> {
     readonly name: Signal<string | null | undefined>;
     /** Canonical control registered in the parent form. */
     readonly control: Signal<AbstractControl<TControl>>;
+    /**
+     * Control to register in the parent form **instead of** `control`, when the two must differ.
+     *
+     * why: `<sd-date>` / `<sd-datetime>` / `<sd-date-range>` bind `control` straight to the Material
+     * editor, so it necessarily holds the editor's own representation (a `Date`, or the display
+     * string) — not the public model. That is fine until `transform` is set, at which point the
+     * consumer is promised that `form.get(name).value` matches `model` and the `sdChange` payload.
+     * Yielding a model-facing control here moves only the *registration*; validators, disabled, state
+     * and the model binding all stay on `control`, so a `null`/absent signal keeps today's behaviour
+     * exactly. The component owning both controls is responsible for mirroring value and validity.
+     */
+    readonly registeredControl?: Signal<AbstractControl | null | undefined>;
     readonly validators?: Signal<ValidatorFn | readonly ValidatorFn[] | null | undefined>;
     readonly asyncValidators?: Signal<AsyncValidatorFn | readonly AsyncValidatorFn[] | null | undefined>;
     /** Adds/removes Validators.required while preserving validators supplied above. */

package/forms/models/src/sd-model-facing-control.d.ts

@@ -0,0 +1,43 @@
+import { Signal } from '@angular/core';
+import { AbstractControl } from '@angular/forms';
+import { SdFormControl } from './sd-form-control.model';
+export interface ɵSdModelFacingControlOptions<TModel> {
+    /** Whether the model-facing control should be the one registered in the parent form. */
+    readonly active: Signal<boolean>;
+    /** The component's public model. */
+    readonly model: Signal<TModel>;
+    /** Applies an external write that arrived through the registered control. */
+    readonly writeModel: (value: TModel) => void;
+    /** The internal UI control whose validity, disabled and interaction state must be mirrored. */
+    readonly source: Signal<AbstractControl>;
+    /** Compares two model values; defaults to `Object.is`. */
+    readonly modelEquals?: (left: TModel, right: TModel) => boolean;
+}
+export interface ɵSdModelFacingControl<TModel> {
+    /** The control itself. Holds the public model value, never the editor representation. */
+    readonly control: SdFormControl;
+    /** Feed straight into `ɵsdFormControlConnector`'s `registeredControl`. */
+    readonly registered: Signal<AbstractControl | null>;
+}
+/**
+ * A second control that carries the **public model** so it can be registered in the parent form in
+ * place of the editor-facing control.
+ *
+ * why: `<sd-date>` and friends bind their control directly to the Material editor, so that control
+ * necessarily holds a `Date` or a display string. That is invisible until `transform` is set — at
+ * which point the consumer is told `form.get(name).value` equals `model`, and finding a raw `Date`
+ * there instead makes the promise false. Rather than reshaping the editor binding (which would
+ * change behaviour for every existing consumer), this mirrors the model into a control of its own
+ * and hands *that* one to the form.
+ *
+ * Both directions are wired, and neither can feed back on the other:
+ *  - model changes are pushed in with `emitEvent: false`, so they raise no `valueChanges`;
+ *  - a write that arrives on this control goes to `writeModel`, exactly like a write on the editor
+ *    control would, so `modelChange` / `sdChange` still fire once.
+ *
+ * Validity, disabled and touched/dirty are mirrored from `source`, so registering this control does
+ * not quietly drop the editor's validators (min/max, parse errors, required) from the parent form.
+ *
+ * Must be called from an injection context.
+ */
+export declare function ɵsdModelFacingControl<TModel>(options: ɵSdModelFacingControlOptions<TModel>): ɵSdModelFacingControl<TModel>;

package/forms/models/src/sd-search.model.d.ts

@@ -4,4 +4,4 @@ export interface SdSearchReq<TData extends string | number = string> {
     searchFields?: string[];
     value?: TData | TData[];
 }
-export type SdSearch<T = any> = (args: SdSearchReq) => Promise<T[]>;
+export type SdSearch<T = unknown> = (args: SdSearchReq) => Promise<T[]>;

package/forms/models/src/sd-selection-data.model.d.ts

@@ -1,4 +1,4 @@
-export interface SdSelectionData<T = any> {
+export interface SdSelectionData<T = unknown> {
     multiple?: boolean;
     values: any[];
     selectedItems: T[];

package/forms/models/src/sd-temporal-transform.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Output serialization strategy for the temporal form controls (`<sd-date>`, `<sd-datetime>`,
+ * `<sd-date-range>`).
+ *
+ * This names how a committed value leaves the component — through `model` / `modelChange` /
+ * `sdChange` and the registered `FormGroup` field. It does **not** touch what the field displays,
+ * and it is **not** an Angular input-coercion `transform`.
+ */
+export type SdTemporalValueTransform = 'ISOString' | 'UTCString';
+/** Every supported strategy, derived from the strategy map so the two can never drift. */
+export declare const SD_TEMPORAL_VALUE_TRANSFORMS: readonly SdTemporalValueTransform[];
+export declare function sdIsTemporalValueTransform(value: unknown): value is SdTemporalValueTransform;
+/**
+ * Serializes a committed value with the active strategy.
+ *
+ * Returns `null` for anything that is not a usable `Date`, so an invalid value can never reach a
+ * serializer and produce the string `"Invalid Date"`. Callers treat `null` as "keep the existing
+ * representation".
+ */
+export declare function sdSerializeTemporalValue(value: Date | null | undefined, transform: SdTemporalValueTransform | null | undefined): string | null;
+/** Local midnight of the given day. Date-only controls serialize this instant, never the raw value. */
+export declare function sdLocalStartOfDay(value: Date): Date;
+/**
+ * Parses the wire formats these transforms emit, so a component can read back its own output.
+ *
+ * Deliberately narrow: only ISO 8601 and the RFC-1123 shape `toUTCString()` produces are accepted.
+ * Handing the whole job to `new Date(text)` would make every loosely date-shaped string parse
+ * differently per browser, and would swallow the legacy canonical formats the components already
+ * parse with their own strict parsers. Returns `null` when the text is not one of these.
+ */
+export declare function sdParseTransformedTemporal(value: unknown): Date | null;

package/forms/models/src/sd-timer-scope.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @internal Macrotask timers owned by a component/directive injector.
+ *
+ * Every pending handle is cleared when the host is destroyed, so a deferred focus,
+ * panel-open or emit can never run against a torn-down view.
+ */
+export interface ɵSdTimerScope {
+    /**
+     * `setTimeout` with the same observable timing, minus the leak: the handle is tracked
+     * and cleared on destroy. Scheduling after destroy is a no-op.
+     */
+    schedule(handler: () => void, delayMs?: number): void;
+    /** Cancels every pending timer without waiting for destroy. */
+    clear(): void;
+    /** Number of timers still pending. Test/diagnostics only. */
+    readonly pending: number;
+}
+/**
+ * @internal Creates a destroy-scoped timer bag. MUST be called from an injection context
+ * (class field initializer or constructor) because it resolves `DestroyRef`.
+ *
+ * why: gần như mọi form control đều hoãn focus / mở panel bằng `setTimeout(..., 100)` để chờ
+ * Material dựng xong DOM. Handle không được giữ lại nên callback vẫn chạy sau khi host view đã
+ * destroy — route đổi nhanh hoặc chip bị gỡ giữa lúc focus là đủ để `detectChanges()` ném
+ * `ViewDestroyedError`, hoặc để một output bắn ra sau khi consumer đã unsubscribe. Gom vào một
+ * scope duy nhất để nơi dùng chỉ cần đổi `setTimeout(fn, ms)` → `#timers.schedule(fn, ms)`,
+ * KHÔNG đổi độ trễ (đây là fix vòng đời, không phải fix hành vi).
+ */
+export declare function ɵsdTimerScope(): ɵSdTimerScope;