@sdcorejs/angular 20.1.5 → 20.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/index.d.ts

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

package/forms/chip-calendar/index.d.ts

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

package/forms/date/index.d.ts

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

package/forms/date-range/index.d.ts

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

package/forms/datetime/index.d.ts

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

package/forms/entity-picker/index.d.ts

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

package/forms/index.d.ts

@@ -1,42 +1,51 @@
+import * as i21 from '@sdcorejs/angular/forms/directives';
 export * from '@sdcorejs/angular/forms/directives';
 export * from '@sdcorejs/angular/forms/models';
+import * as i1 from '@sdcorejs/angular/forms/label';
 export * from '@sdcorejs/angular/forms/label';
-import * as i1 from '@sdcorejs/angular/forms/input';
+import * as i2 from '@sdcorejs/angular/forms/input';
 export * from '@sdcorejs/angular/forms/input';
+import * as i3 from '@sdcorejs/angular/forms/input-color';
 export * from '@sdcorejs/angular/forms/input-color';
+import * as i4 from '@sdcorejs/angular/forms/inline-text';
 export * from '@sdcorejs/angular/forms/inline-text';
-import * as i2 from '@sdcorejs/angular/forms/input-number';
+import * as i5 from '@sdcorejs/angular/forms/input-number';
 export * from '@sdcorejs/angular/forms/input-number';
-import * as i3 from '@sdcorejs/angular/forms/date';
+import * as i6 from '@sdcorejs/angular/forms/date';
 export * from '@sdcorejs/angular/forms/date';
+import * as i7 from '@sdcorejs/angular/forms/datetime';
 export * from '@sdcorejs/angular/forms/datetime';
-import * as i4 from '@sdcorejs/angular/forms/date-range';
+import * as i8 from '@sdcorejs/angular/forms/date-range';
 export * from '@sdcorejs/angular/forms/date-range';
-import * as i5 from '@sdcorejs/angular/forms/time';
+import * as i9 from '@sdcorejs/angular/forms/time';
 export * from '@sdcorejs/angular/forms/time';
-import * as i6 from '@sdcorejs/angular/forms/time-range';
+import * as i10 from '@sdcorejs/angular/forms/time-range';
 export * from '@sdcorejs/angular/forms/time-range';
-import * as i7 from '@sdcorejs/angular/forms/entity-picker';
+import * as i11 from '@sdcorejs/angular/forms/entity-picker';
 export * from '@sdcorejs/angular/forms/entity-picker';
-import * as i8 from '@sdcorejs/angular/forms/tree-select';
+import * as i12 from '@sdcorejs/angular/forms/tree-select';
 export * from '@sdcorejs/angular/forms/tree-select';
-import * as i9 from '@sdcorejs/angular/forms/select';
+import * as i13 from '@sdcorejs/angular/forms/select';
 export * from '@sdcorejs/angular/forms/select';
-import * as i10 from '@sdcorejs/angular/forms/autocomplete';
+import * as i14 from '@sdcorejs/angular/forms/autocomplete';
 export * from '@sdcorejs/angular/forms/autocomplete';
+import * as i15 from '@sdcorejs/angular/forms/switch';
 export * from '@sdcorejs/angular/forms/switch';
-import * as i11 from '@sdcorejs/angular/forms/radio';
+import * as i16 from '@sdcorejs/angular/forms/radio';
 export * from '@sdcorejs/angular/forms/radio';
-import * as i12 from '@sdcorejs/angular/forms/textarea';
+import * as i17 from '@sdcorejs/angular/forms/textarea';
 export * from '@sdcorejs/angular/forms/textarea';
+import * as i18 from '@sdcorejs/angular/forms/chip';
 export * from '@sdcorejs/angular/forms/chip';
+import * as i19 from '@sdcorejs/angular/forms/chip-calendar';
 export * from '@sdcorejs/angular/forms/chip-calendar';
+import * as i20 from '@sdcorejs/angular/forms/checkbox';
 export * from '@sdcorejs/angular/forms/checkbox';
 import * as i0 from '@angular/core';
 
 declare class SdFormsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SdFormsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SdFormsModule, never, [typeof i1.SdInput, typeof i2.SdInputNumber, typeof i3.SdDate, typeof i4.SdDateRange, typeof i5.SdTime, typeof i6.SdTimeRange, typeof i7.SdEntityPicker, typeof i8.SdTreeSelect, typeof i9.SdSelect, typeof i10.SdAutocomplete, typeof i11.SdRadio, typeof i12.SdTextarea], [typeof i1.SdInput, typeof i2.SdInputNumber, typeof i3.SdDate, typeof i4.SdDateRange, typeof i5.SdTime, typeof i6.SdTimeRange, typeof i7.SdEntityPicker, typeof i8.SdTreeSelect, typeof i9.SdSelect, typeof i10.SdAutocomplete, typeof i11.SdRadio, typeof i12.SdTextarea]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SdFormsModule, never, [typeof i1.SdLabel, typeof i2.SdInput, typeof i3.SdInputColor, typeof i4.SdInlineText, typeof i5.SdInputNumber, typeof i6.SdDate, typeof i7.SdDatetime, typeof i8.SdDateRange, typeof i9.SdTime, typeof i10.SdTimeRange, typeof i11.SdEntityPicker, typeof i12.SdTreeSelect, typeof i13.SdSelect, typeof i14.SdAutocomplete, typeof i15.SdSwitch, typeof i16.SdRadio, typeof i17.SdTextarea, typeof i18.SdChip, typeof i19.SdChipCalendar, typeof i20.SdCheckbox, typeof i21.SdSuffixDefDirective, typeof i21.SdLabelDefDirective, typeof i21.SdViewDefDirective, typeof i21.SdItemDefDefDirective, typeof i13.SdSelectFooterActionDirective, typeof i11.SdEntityPickerSelectedTemplateDirective, typeof i11.SdEntityPickerRowTemplateDirective, typeof i11.SdEntityPickerDetailTemplateDirective, typeof i12.SdTreeSelectNodeTemplateDirective], [typeof i1.SdLabel, typeof i2.SdInput, typeof i3.SdInputColor, typeof i4.SdInlineText, typeof i5.SdInputNumber, typeof i6.SdDate, typeof i7.SdDatetime, typeof i8.SdDateRange, typeof i9.SdTime, typeof i10.SdTimeRange, typeof i11.SdEntityPicker, typeof i12.SdTreeSelect, typeof i13.SdSelect, typeof i14.SdAutocomplete, typeof i15.SdSwitch, typeof i16.SdRadio, typeof i17.SdTextarea, typeof i18.SdChip, typeof i19.SdChipCalendar, typeof i20.SdCheckbox, typeof i21.SdSuffixDefDirective, typeof i21.SdLabelDefDirective, typeof i21.SdViewDefDirective, typeof i21.SdItemDefDefDirective, typeof i13.SdSelectFooterActionDirective, typeof i11.SdEntityPickerSelectedTemplateDirective, typeof i11.SdEntityPickerRowTemplateDirective, typeof i11.SdEntityPickerDetailTemplateDirective, typeof i12.SdTreeSelectNodeTemplateDirective]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SdFormsModule>;
 }
 

package/forms/input/index.d.ts

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

package/forms/input-color/index.d.ts

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

package/forms/input-number/index.d.ts

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