@sdcorejs/angular 19.1.5 → 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-input.util.d.ts

@@ -0,0 +1,18 @@
+export declare const DATE_DISPLAY_FORMAT = "dd/MM/yyyy";
+export declare const DATE_DISPLAY_PATTERN: RegExp;
+export declare const DATE_INPUT_MAX_DIGITS = 8;
+/** Chèn `/` vào chuỗi số người dùng đang gõ: `22081991` → `22/08/1991`. */
+export declare function formatDateInput(value: string, addTrailingSeparator: boolean): string;
+/** Chuỗi còn dở dang (đang gõ) — chưa đủ `dd/MM/yyyy` nhưng vẫn đúng khuôn. */
+export declare function isPartialDateInput(value: string): boolean;
+/**
+ * Chỉ nhận đúng `dd/MM/yyyy` ĐẦY ĐỦ và có thật trên lịch.
+ *
+ * WHY chặt tay như vậy: `date-fns.parse(value, 'dd/MM/yyyy')` rất dễ dãi — nó
+ * nhận cả năm thiếu chữ số, nên `11/12/2` ra năm 0002 còn `11/12/20` ra năm
+ * 0020. Nếu để lọt, người dùng mới gõ nửa chừng đã bị coi là nhập xong.
+ */
+export declare function parseDateInput(value: string): Date | null;
+/** Giữ con trỏ đứng đúng chỗ sau khi chuỗi được chèn thêm `/`. */
+export declare function getCaretPosition(value: string, selectionStart: number, formattedValue: string, addTrailingSeparator: boolean): number;
+export declare function dateControlsEqual(left: Date | null, right: Date | null): boolean;

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

@@ -3,13 +3,21 @@ 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;
+type SdDateKeyupEvent = Event | {
+    target?: {
+        value?: string | null;
+    };
+};
 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>;
@@ -62,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;
@@ -80,10 +96,12 @@ export declare class SdDate implements OnDestroy, OnInit {
     open: () => void;
     focusInputElement(): void;
     onKeyDown: (event: KeyboardEvent) => boolean;
-    onKeyup: (event: any) => void;
+    onInput: (event: Event) => void;
+    /** Kept as a compatibility entry point for callers that used the old keyup handler. */
+    onKeyup: (event: SdDateKeyupEvent) => void;
     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,4 +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-strict-date-adapter.d.ts

@@ -0,0 +1,26 @@
+import { Provider } from '@angular/core';
+import { DateFnsAdapter } from '@angular/material-date-fns-adapter';
+import { MatDateFormats } from '@angular/material/core';
+import * as i0 from "@angular/core";
+/**
+ * DateAdapter từ chối mọi chuỗi người dùng chưa gõ xong.
+ *
+ * WHY cần đến mức này: `<input matInput [matDatepicker]>` khiến Material tự
+ * `parse()` lại ô nhập SAU MỖI PHÍM GÕ rồi ghi thẳng kết quả vào form control.
+ * Adapter mặc định quá dễ dãi trên hai đường:
+ *
+ * 1. `date-fns.parse` nhận năm thiếu chữ số → `11/12/2` thành năm 0002,
+ *    `11/12/20` thành năm 0020. Ô nhập vừa gõ dở đã bị coi là hợp lệ (cờ lỗi
+ *    bị xoá) và control ôm một ngày rác.
+ * 2. `parseISO` coi chuỗi 2 chữ số là thế kỷ → xoá lùi còn `11` ra năm 1100.
+ *
+ * Cả hai đường đều bị chặn ở đây: control chỉ nhận giá trị khi người dùng thực
+ * sự gõ xong.
+ */
+export declare class SdStrictDateFnsAdapter extends DateFnsAdapter {
+    parse(value: unknown, parseFormat: string | string[]): Date | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdStrictDateFnsAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdStrictDateFnsAdapter>;
+}
+/** `provideDateFnsAdapter` + ép dùng adapter parse chặt ở trên. */
+export declare function provideSdStrictDateFnsAdapter(formats: MatDateFormats): Provider[];