@sdcorejs/angular 22.2.15 → 22.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. package/README.md +7 -5
  2. package/assets/STYLE-GUIDE.md +6 -3
  3. package/assets/THEME.md +166 -0
  4. package/assets/fonts/fonts.scss +1 -1
  5. package/assets/scss/ckeditor5.scss +2 -2
  6. package/assets/scss/core/_inline-edit.scss +3 -3
  7. package/assets/scss/core/_read-state-panel.scss +2 -2
  8. package/assets/scss/core/color.scss +4 -2
  9. package/assets/scss/core/form.scss +35 -12
  10. package/assets/scss/core/scrollbar.scss +3 -3
  11. package/assets/scss/core/utilities/_base.scss +5 -5
  12. package/assets/scss/core/utilities/_typography.scss +22 -22
  13. package/assets/scss/sd-core.scss +12 -0
  14. package/assets/scss/themes/_component-tokens.scss +261 -0
  15. package/assets/scss/themes/_presets.scss +3 -0
  16. package/assets/scss/themes/_ramps.scss +56 -0
  17. package/assets/scss/themes/_scales.scss +90 -0
  18. package/assets/scss/themes/_semantic.scss +22 -0
  19. package/assets/scss/themes/default.scss +113 -10
  20. package/assets/scss/themes/material-theme.scss +3 -0
  21. package/fesm2022/sdcorejs-angular-components-anchor.mjs +2 -2
  22. package/fesm2022/sdcorejs-angular-components-anchor.mjs.map +1 -1
  23. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +6 -6
  24. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  25. package/fesm2022/sdcorejs-angular-components-audit-diff.mjs +2 -2
  26. package/fesm2022/sdcorejs-angular-components-audit-diff.mjs.map +1 -1
  27. package/fesm2022/sdcorejs-angular-components-autoid-inspector.mjs +2 -2
  28. package/fesm2022/sdcorejs-angular-components-autoid-inspector.mjs.map +1 -1
  29. package/fesm2022/sdcorejs-angular-components-avatar.mjs +34 -27
  30. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  31. package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
  32. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  33. package/fesm2022/sdcorejs-angular-components-breadcrumb.mjs +35 -5
  34. package/fesm2022/sdcorejs-angular-components-breadcrumb.mjs.map +1 -1
  35. package/fesm2022/sdcorejs-angular-components-button.mjs +13 -11
  36. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  37. package/fesm2022/sdcorejs-angular-components-card.mjs +2 -2
  38. package/fesm2022/sdcorejs-angular-components-card.mjs.map +1 -1
  39. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +2 -2
  40. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  41. package/fesm2022/sdcorejs-angular-components-code-editor.mjs +2 -2
  42. package/fesm2022/sdcorejs-angular-components-code-editor.mjs.map +1 -1
  43. package/fesm2022/sdcorejs-angular-components-data-state.mjs +10 -4
  44. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  45. package/fesm2022/sdcorejs-angular-components-editor.mjs +12 -4
  46. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  47. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +108 -52
  48. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  49. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +6191 -6611
  50. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  51. package/fesm2022/sdcorejs-angular-components-highlight.mjs +66 -0
  52. package/fesm2022/sdcorejs-angular-components-highlight.mjs.map +1 -0
  53. package/fesm2022/sdcorejs-angular-components-history.mjs +2 -2
  54. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  55. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +2158 -0
  56. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -0
  57. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +2 -2
  58. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  59. package/fesm2022/sdcorejs-angular-components-inform.mjs +11 -5
  60. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  61. package/fesm2022/sdcorejs-angular-components-job-progress.mjs +2 -2
  62. package/fesm2022/sdcorejs-angular-components-job-progress.mjs.map +1 -1
  63. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +40 -22
  64. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  65. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +2 -2
  66. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  67. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  68. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  69. package/fesm2022/sdcorejs-angular-components-operator.mjs +2 -2
  70. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  71. package/fesm2022/sdcorejs-angular-components-org-chart.mjs +2 -2
  72. package/fesm2022/sdcorejs-angular-components-org-chart.mjs.map +1 -1
  73. package/fesm2022/sdcorejs-angular-components-preview.mjs +144 -7
  74. package/fesm2022/sdcorejs-angular-components-preview.mjs.map +1 -1
  75. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +33 -24
  76. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  77. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +2 -2
  78. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  79. package/fesm2022/sdcorejs-angular-components-quick-action.mjs +2 -2
  80. package/fesm2022/sdcorejs-angular-components-quick-action.mjs.map +1 -1
  81. package/fesm2022/sdcorejs-angular-components-section.mjs +13 -7
  82. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  83. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +28 -4
  84. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  85. package/fesm2022/sdcorejs-angular-components-splitter.mjs +2 -2
  86. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  87. package/fesm2022/sdcorejs-angular-components-stepper.mjs +2 -2
  88. package/fesm2022/sdcorejs-angular-components-stepper.mjs.map +1 -1
  89. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +4 -4
  90. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  91. package/fesm2022/sdcorejs-angular-components-tab.mjs +2 -2
  92. package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
  93. package/fesm2022/sdcorejs-angular-components-table.mjs +308 -113
  94. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  95. package/fesm2022/sdcorejs-angular-components-tree.mjs +2 -2
  96. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  97. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +14 -5
  98. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  99. package/fesm2022/sdcorejs-angular-components.mjs +2 -0
  100. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  101. package/fesm2022/sdcorejs-angular-directives.mjs +100 -13
  102. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  103. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +154 -6
  104. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  105. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +20 -4
  106. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  107. package/fesm2022/sdcorejs-angular-forms-chip.mjs +20 -4
  108. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  109. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +2 -2
  110. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  111. package/fesm2022/sdcorejs-angular-forms-date.mjs +18 -7
  112. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  113. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +18 -7
  114. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  115. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  116. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  117. package/fesm2022/sdcorejs-angular-forms-inline-text.mjs +3 -3
  118. package/fesm2022/sdcorejs-angular-forms-inline-text.mjs.map +1 -1
  119. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +2 -2
  120. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  121. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +20 -4
  122. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  123. package/fesm2022/sdcorejs-angular-forms-input.mjs +31 -5
  124. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  125. package/fesm2022/sdcorejs-angular-forms-label.mjs +27 -2
  126. package/fesm2022/sdcorejs-angular-forms-label.mjs.map +1 -1
  127. package/fesm2022/sdcorejs-angular-forms-radio.mjs +1 -1
  128. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  129. package/fesm2022/sdcorejs-angular-forms-select.mjs +509 -7
  130. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  131. package/fesm2022/sdcorejs-angular-forms-switch.mjs +1 -1
  132. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  133. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +21 -4
  134. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  135. package/fesm2022/sdcorejs-angular-forms-time-range.mjs +2 -2
  136. package/fesm2022/sdcorejs-angular-forms-time-range.mjs.map +1 -1
  137. package/fesm2022/sdcorejs-angular-forms-time.mjs +2 -2
  138. package/fesm2022/sdcorejs-angular-forms-time.mjs.map +1 -1
  139. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  140. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  141. package/fesm2022/sdcorejs-angular-i18n.mjs +1430 -271
  142. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  143. package/fesm2022/sdcorejs-angular-modules-auth.mjs +35 -3
  144. package/fesm2022/sdcorejs-angular-modules-auth.mjs.map +1 -1
  145. package/fesm2022/sdcorejs-angular-modules-icon.mjs +19 -0
  146. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  147. package/fesm2022/sdcorejs-angular-modules-layout.mjs +39 -48
  148. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  149. package/fesm2022/sdcorejs-angular-modules-permission.mjs.map +1 -1
  150. package/fesm2022/sdcorejs-angular-services-api.mjs +198 -8
  151. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  152. package/fesm2022/sdcorejs-angular-services-confirm.mjs +10 -3
  153. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  154. package/fesm2022/sdcorejs-angular-services-excel.mjs +5 -0
  155. package/fesm2022/sdcorejs-angular-services-excel.mjs.map +1 -1
  156. package/fesm2022/sdcorejs-angular-services-loading.mjs +1 -1
  157. package/fesm2022/sdcorejs-angular-services-loading.mjs.map +1 -1
  158. package/fesm2022/sdcorejs-angular-services-notify.mjs +109 -7
  159. package/fesm2022/sdcorejs-angular-services-notify.mjs.map +1 -1
  160. package/fesm2022/sdcorejs-angular-utilities-extensions.mjs +458 -1
  161. package/fesm2022/sdcorejs-angular-utilities-extensions.mjs.map +1 -1
  162. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +169 -0
  163. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -0
  164. package/fesm2022/sdcorejs-angular-utilities.mjs +1 -0
  165. package/fesm2022/sdcorejs-angular-utilities.mjs.map +1 -1
  166. package/package.json +14 -2
  167. package/types/sdcorejs-angular-components-breadcrumb.d.ts +2 -1
  168. package/types/sdcorejs-angular-components-data-state.d.ts +6 -2
  169. package/types/sdcorejs-angular-components-file-explorer.d.ts +3 -0
  170. package/types/sdcorejs-angular-components-form-generic.d.ts +897 -835
  171. package/types/sdcorejs-angular-components-highlight.d.ts +27 -0
  172. package/types/sdcorejs-angular-components-image-editor.d.ts +478 -0
  173. package/types/sdcorejs-angular-components-inform.d.ts +5 -2
  174. package/types/sdcorejs-angular-components-mini-editor.d.ts +1 -1
  175. package/types/sdcorejs-angular-components-preview.d.ts +51 -2
  176. package/types/sdcorejs-angular-components-query-builder.d.ts +1 -1
  177. package/types/sdcorejs-angular-components-section.d.ts +5 -1
  178. package/types/sdcorejs-angular-components-table.d.ts +6 -0
  179. package/types/sdcorejs-angular-components.d.ts +2 -0
  180. package/types/sdcorejs-angular-directives.d.ts +8 -0
  181. package/types/sdcorejs-angular-forms-autocomplete.d.ts +19 -1
  182. package/types/sdcorejs-angular-forms-chip-calendar.d.ts +13 -2
  183. package/types/sdcorejs-angular-forms-chip.d.ts +13 -2
  184. package/types/sdcorejs-angular-forms-date.d.ts +7 -2
  185. package/types/sdcorejs-angular-forms-datetime.d.ts +7 -2
  186. package/types/sdcorejs-angular-forms-inline-text.d.ts +1 -1
  187. package/types/sdcorejs-angular-forms-input-number.d.ts +12 -2
  188. package/types/sdcorejs-angular-forms-input.d.ts +21 -5
  189. package/types/sdcorejs-angular-forms-label.d.ts +16 -1
  190. package/types/sdcorejs-angular-forms-models.d.ts +16 -1
  191. package/types/sdcorejs-angular-forms-select.d.ts +66 -4
  192. package/types/sdcorejs-angular-forms-textarea.d.ts +9 -2
  193. package/types/sdcorejs-angular-i18n.d.ts +285 -54
  194. package/types/sdcorejs-angular-modules-auth.d.ts +3 -3
  195. package/types/sdcorejs-angular-modules-icon.d.ts +11 -1
  196. package/types/sdcorejs-angular-modules-layout.d.ts +2 -2
  197. package/types/sdcorejs-angular-modules-permission.d.ts +3 -2
  198. package/types/sdcorejs-angular-services-api.d.ts +49 -2
  199. package/types/sdcorejs-angular-services-confirm.d.ts +15 -0
  200. package/types/sdcorejs-angular-services-notify.d.ts +8 -0
  201. package/types/sdcorejs-angular-utilities-extensions.d.ts +68 -1
  202. package/types/sdcorejs-angular-utilities-theme.d.ts +25 -0
  203. package/types/sdcorejs-angular-utilities.d.ts +1 -0
@@ -590,6 +590,12 @@ interface SdTableOptionExportDefault<T = any> {
590
590
  visible?: 'ALL' | 'EXCEL' | 'CSV';
591
591
  enableUpload?: boolean;
592
592
  fileName?: string;
593
+ /**
594
+ * Số dòng tối đa được phép export (Excel/CSV). Khi tổng số dòng — tổng của server, số dòng local sau
595
+ * lọc, hoặc tổng/số dòng mà `items` trả về trong lúc export — vượt `max`, export bị chặn: không ghi
596
+ * file, hiện cảnh báo `core.component.table.export-max-exceeded`. Chỉ số dương hữu hạn mới là giới
597
+ * hạn; bỏ trống thì không giới hạn.
598
+ */
593
599
  max?: number;
594
600
  maxItemsPerRequest?: number;
595
601
  batch?: number;
@@ -36,3 +36,5 @@ export * from '@sdcorejs/angular/components/operator';
36
36
  export * from '@sdcorejs/angular/components/stepper';
37
37
  export * from '@sdcorejs/angular/components/tab';
38
38
  export * from '@sdcorejs/angular/components/file-explorer';
39
+ export * from '@sdcorejs/angular/components/image-editor';
40
+ export * from '@sdcorejs/angular/components/highlight';
@@ -66,6 +66,7 @@ declare class SdTooltipDirective {
66
66
  private readonly overlay;
67
67
  private readonly viewContainerRef;
68
68
  private readonly destroyRef;
69
+ private readonly document;
69
70
  private overlayRef;
70
71
  private tooltipComponentRef;
71
72
  private tooltipInstance;
@@ -74,6 +75,13 @@ declare class SdTooltipDirective {
74
75
  constructor();
75
76
  onMouseEnter(): void;
76
77
  onMouseLeave(): void;
78
+ /**
79
+ * why: tooltip trước đây chỉ mở bằng chuột, người dùng bàn phím không bao giờ đọc được nội dung.
80
+ * Dùng `focusin`/`focusout` (có nổi bọt) để phủ cả trường hợp host bọc một phần tử focus được.
81
+ * Hiện ngay, không chờ delay, để `aria-describedby` đã có khi screen reader đọc phần tử vừa focus.
82
+ */
83
+ onFocusIn(): void;
84
+ onFocusOut(event: FocusEvent): void;
77
85
  forceHide: () => void;
78
86
  static ɵfac: i0.ɵɵFactoryDeclaration<SdTooltipDirective, never>;
79
87
  static ɵdir: i0.ɵɵDirectiveDeclaration<SdTooltipDirective, "[sdTooltip]", never, { "content": { "alias": "sdTooltip"; "required": true; "isSignal": true; }; "sdTooltipPosition": { "alias": "sdTooltipPosition"; "required": false; "isSignal": true; }; "sdTooltipDelay": { "alias": "sdTooltipDelay"; "required": false; "isSignal": true; }; "sdTooltipColor": { "alias": "sdTooltipColor"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -23,6 +23,8 @@ declare class SdAutocomplete<T = unknown> implements OnInit, OnDestroy {
23
23
  readonly errorId: string;
24
24
  inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
25
25
  autocompleteTrigger: _angular_core.Signal<MatAutocompleteTrigger | undefined>;
26
+ private readonly matAutocomplete;
27
+ private readonly virtualViewport;
26
28
  sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
27
29
  sdValueTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
28
30
  itemDef: _angular_core.Signal<SdItemDefDefDirective<any> | undefined>;
@@ -48,6 +50,13 @@ declare class SdAutocomplete<T = unknown> implements OnInit, OnDestroy {
48
50
  displayField: _angular_core.InputSignal<string | undefined>;
49
51
  disabledField: _angular_core.InputSignal<string>;
50
52
  limit: _angular_core.InputSignal<number>;
53
+ /**
54
+ * Virtual scrolling for long lists (opt-in, default `false`). When on, the panel renders only the rows
55
+ * in view and array items are no longer cut by `limit`. See sd-autocomplete.md, "Virtual scroll".
56
+ */
57
+ readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
58
+ /** Fixed row height in px for the virtual viewport. Default 36 = the panel's compact option row. */
59
+ readonly itemSize: _angular_core.InputSignalWithTransform<number, unknown>;
51
60
  cacheChecksum: _angular_core.InputSignal<any>;
52
61
  hyperlink: _angular_core.InputSignal<string | null | undefined>;
53
62
  items: _angular_core.InputSignal<SdSearch<T> | T[] | null | undefined>;
@@ -95,6 +104,13 @@ declare class SdAutocomplete<T = unknown> implements OnInit, OnDestroy {
95
104
  display: _angular_core.WritableSignal<string>;
96
105
  controlPlaceHolder: _angular_core.WritableSignal<string>;
97
106
  normalizedValue: _angular_core.Signal<string | number | null | undefined>;
107
+ /** Panel classes: the virtual one only adds `sd-autocomplete-virtual`. */
108
+ protected readonly panelClass: _angular_core.Signal<"sd-autocomplete-panel sd-autocomplete-virtual" | "sd-autocomplete-panel">;
109
+ protected readonly virtualViewportHeight: _angular_core.Signal<number>;
110
+ /** Stable id per row index: Material's aria-activedescendant points at it and the adapter finds the row by it. */
111
+ protected readonly virtualOptionId: (index: number) => string;
112
+ /** Row the keyboard made active in the full filtered list, or -1 (reset when the results change, like Material). */
113
+ readonly virtualActiveIndex: _angular_core.WritableSignal<number>;
98
114
  getNestedValue: (obj: any, path: string | undefined) => any;
99
115
  constructor();
100
116
  ngOnInit(): void;
@@ -112,10 +128,12 @@ declare class SdAutocomplete<T = unknown> implements OnInit, OnDestroy {
112
128
  clear: ($event?: any) => void;
113
129
  onAdd: ($event: Event) => void;
114
130
  reValidate: () => void;
131
+ protected onVirtualOpened: () => void;
132
+ protected onVirtualClosed: () => void;
115
133
  /** Retry bypasses text debounce/distinctness while using the original loader and request snapshot. */
116
134
  retryRead: () => void;
117
135
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdAutocomplete<any>, never>;
118
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdAutocomplete<any>, "sd-autocomplete", 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; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "hideReadError": { "alias": "hideReadError"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "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; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "sdReadStateChange": "sdReadStateChange"; "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; "sdAdd": "sdAdd"; }, ["sdLabelTemplate", "sdValueTemplate", "itemDef", "sdViewDef", "dataStateTemplate"], ["[sdLabel]"], true, never>;
136
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdAutocomplete<any>, "sd-autocomplete", 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; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "itemSize": { "alias": "itemSize"; "required": false; "isSignal": true; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "hideReadError": { "alias": "hideReadError"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "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; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "sdReadStateChange": "sdReadStateChange"; "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; "sdAdd": "sdAdd"; }, ["sdLabelTemplate", "sdValueTemplate", "itemDef", "sdViewDef", "dataStateTemplate"], ["[sdLabel]"], true, never>;
119
137
  }
120
138
 
121
139
  export { SdAutocomplete };
@@ -7,7 +7,7 @@ import { MatCalendar } from '@angular/material/datepicker';
7
7
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
8
8
  import { MatMenuTrigger } from '@angular/material/menu';
9
9
  import { SdViewDefDirective, SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
10
- import { SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/models';
10
+ import { SdLabelPlacement, SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/models';
11
11
  import { Size } from '@sdcorejs/utils/models';
12
12
 
13
13
  declare class SdChipCalendarErrorStateMatcher implements ErrorStateMatcher {
@@ -32,6 +32,17 @@ declare class SdChipCalendar implements AfterViewInit, OnDestroy {
32
32
  readonly dataErrorMessage: _angular_core.Signal<string | null>;
33
33
  name: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
34
34
  appearance: _angular_core.InputSignalWithTransform<MatFormFieldAppearance, MatFormFieldAppearance | null | undefined>;
35
+ /**
36
+ * `'float'` (mặc định) hoặc `'top'` — nhãn `<label for>` tĩnh phía trên ô nhập chip.
37
+ * why: ô nhập chip là `<input matInput>` thật nên nhãn rời gắn `for` vào đó (`inputId`).
38
+ */
39
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
40
+ /**
41
+ * id ổn định của ô nhập chip — nhãn rời trỏ `for` sang, và `mat-chip-grid` dùng nó làm id cho
42
+ * `<mat-label>` ở chế độ nổi. why: luôn gán (kể cả `'float'`): `[id]="null"` sẽ ghi đè id mặc định
43
+ * của `MatChipInput` thành chuỗi `"null"` và làm mất liên kết nhãn.
44
+ */
45
+ readonly inputId: string;
35
46
  floatLabel: _angular_core.InputSignalWithTransform<FloatLabelType, FloatLabelType | null | undefined>;
36
47
  size: _angular_core.InputSignalWithTransform<Size, Size | null | undefined>;
37
48
  form: _angular_core.InputSignalWithTransform<FormGroup<any> | undefined, any>;
@@ -80,7 +91,7 @@ declare class SdChipCalendar implements AfterViewInit, OnDestroy {
80
91
  onCloseCalendar: () => void;
81
92
  dateClass: (cellDate: Date) => "" | "sd-chip-calendar-selected-date";
82
93
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdChipCalendar, never>;
83
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdChipCalendar, "sd-chip-calendar", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; "sdChange": "sdChange"; }, ["sdViewDef", "sdLabelDef", "sdLabelTemplate", "sdValueTemplate"], never, true, never>;
94
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdChipCalendar, "sd-chip-calendar", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; "sdChange": "sdChange"; }, ["sdViewDef", "sdLabelDef", "sdLabelTemplate", "sdValueTemplate"], never, true, never>;
84
95
  }
85
96
 
86
97
  export { SdChipCalendar };
@@ -6,7 +6,7 @@ import { MatChipInputEvent } from '@angular/material/chips';
6
6
  import { ErrorStateMatcher } from '@angular/material/core';
7
7
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
8
8
  import { SdViewDefDirective, SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
9
- import { SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/models';
9
+ import { SdLabelPlacement, SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/models';
10
10
  import { Size } from '@sdcorejs/utils/models';
11
11
 
12
12
  declare class SdRemovableChipPipe implements PipeTransform {
@@ -33,6 +33,17 @@ declare class SdChip implements AfterViewInit, OnDestroy {
33
33
  readonly dataErrorMessage: _angular_core.Signal<string | null>;
34
34
  name: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
35
35
  appearance: _angular_core.InputSignalWithTransform<MatFormFieldAppearance, MatFormFieldAppearance | null | undefined>;
36
+ /**
37
+ * `'float'` (mặc định) hoặc `'top'` — nhãn `<label for>` tĩnh phía trên ô nhập chip.
38
+ * why: ô nhập chip là `<input matInput>` thật nên nhãn rời gắn `for` vào đó (`inputId`).
39
+ */
40
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
41
+ /**
42
+ * id ổn định của ô nhập chip — nhãn rời trỏ `for` sang, và `mat-chip-grid` dùng nó làm id cho
43
+ * `<mat-label>` ở chế độ nổi. why: luôn gán (kể cả `'float'`): `[id]="null"` sẽ ghi đè id mặc định
44
+ * của `MatChipInput` thành chuỗi `"null"` và làm mất liên kết nhãn.
45
+ */
46
+ readonly inputId: string;
36
47
  floatLabel: _angular_core.InputSignalWithTransform<FloatLabelType, FloatLabelType | null | undefined>;
37
48
  size: _angular_core.InputSignalWithTransform<Size, Size | null | undefined>;
38
49
  form: _angular_core.InputSignalWithTransform<FormGroup<any> | undefined, any>;
@@ -77,7 +88,7 @@ declare class SdChip implements AfterViewInit, OnDestroy {
77
88
  focus: () => void;
78
89
  onClear: ($event?: any) => void;
79
90
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdChip, never>;
80
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdChip, "sd-chip", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; "sdChange": "sdChange"; }, ["sdViewDef", "sdLabelDef", "sdLabelTemplate", "sdValueTemplate"], never, true, never>;
91
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdChip, "sd-chip", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "model": { "alias": "model"; "required": false; "isSignal": true; }; }, { "model": "modelChange"; "sdChange": "sdChange"; }, ["sdViewDef", "sdLabelDef", "sdLabelTemplate", "sdValueTemplate"], never, true, never>;
81
92
  }
82
93
 
83
94
  export { SdChip, SdRemovableChipPipe };
@@ -4,7 +4,7 @@ import { FormGroup } from '@angular/forms';
4
4
  import { MatDatepicker, MatDatepickerInputEvent } from '@angular/material/datepicker';
5
5
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
6
6
  import { SdViewDefDirective, SdLabelDefDirective } from '@sdcorejs/angular/forms/directives';
7
- import { SdViewed, SdViewedInput, SdTemporalValueTransform, SdFormControl } from '@sdcorejs/angular/forms/models';
7
+ import { SdViewed, SdViewedInput, SdLabelPlacement, SdTemporalValueTransform, SdFormControl } from '@sdcorejs/angular/forms/models';
8
8
  import { Size } from '@sdcorejs/utils/models';
9
9
 
10
10
  type SdDateModelValue = string | number | Date | undefined | null;
@@ -19,6 +19,9 @@ declare class SdDate implements OnDestroy, OnInit {
19
19
  /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
20
20
  * phải đọc được từ chính control, không chỉ hiện ra màn hình. */
21
21
  readonly errorId: string;
22
+ /** id của nhãn/helper khi `labelPlacement='top'`. */
23
+ readonly labelId: string;
24
+ readonly hintId: string;
22
25
  inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
23
26
  datePicker: _angular_core.Signal<MatDatepicker<Date> | undefined>;
24
27
  sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -65,6 +68,8 @@ declare class SdDate implements OnDestroy, OnInit {
65
68
  appearanceInput: _angular_core.InputSignal<MatFormFieldAppearance | undefined>;
66
69
  appearance: _angular_core.Signal<MatFormFieldAppearance>;
67
70
  floatLabel: _angular_core.InputSignal<FloatLabelType>;
71
+ /** `'float'` (mặc định) hoặc `'top'` — nhãn `<label for>` tĩnh phía trên, helper text dưới control. */
72
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
68
73
  minInput: _angular_core.InputSignal<any>;
69
74
  minDateInput: _angular_core.InputSignal<any>;
70
75
  resolvedMin: _angular_core.Signal<Date | null>;
@@ -103,7 +108,7 @@ declare class SdDate implements OnDestroy, OnInit {
103
108
  onChange: (event: MatDatepickerInputEvent<Date>) => void;
104
109
  clear: ($event: any) => void;
105
110
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdDate, never>;
106
- 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>;
111
+ 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; }; "labelPlacement": { "alias": "labelPlacement"; "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>;
107
112
  }
108
113
 
109
114
  export { SdDate };
@@ -3,7 +3,7 @@ import { OnDestroy, OnInit, ElementRef, TemplateRef } from '@angular/core';
3
3
  import { FormGroup } from '@angular/forms';
4
4
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
5
5
  import { SdViewDefDirective } from '@sdcorejs/angular/forms/directives';
6
- import { SdViewed, SdViewedInput, SdTemporalValueTransform, SdFormControl } from '@sdcorejs/angular/forms/models';
6
+ import { SdViewed, SdViewedInput, SdLabelPlacement, SdTemporalValueTransform, SdFormControl } from '@sdcorejs/angular/forms/models';
7
7
  import { Size } from '@sdcorejs/utils/models';
8
8
 
9
9
  type SdDatetimeModelValue = string | number | Date | undefined | null;
@@ -13,6 +13,9 @@ declare class SdDatetime implements OnDestroy, OnInit {
13
13
  /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
14
14
  * phải đọc được từ chính control, không chỉ hiện ra màn hình. */
15
15
  readonly errorId: string;
16
+ /** id của nhãn/helper khi `labelPlacement='top'`. */
17
+ readonly labelId: string;
18
+ readonly hintId: string;
16
19
  inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
17
20
  private readonly dateTimePicker;
18
21
  sdLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -61,6 +64,8 @@ declare class SdDatetime implements OnDestroy, OnInit {
61
64
  appearanceInput: _angular_core.InputSignal<MatFormFieldAppearance | undefined>;
62
65
  appearance: _angular_core.Signal<MatFormFieldAppearance>;
63
66
  floatLabel: _angular_core.InputSignal<FloatLabelType>;
67
+ /** `'float'` (mặc định) hoặc `'top'` — nhãn `<label for>` tĩnh phía trên, helper text dưới control. */
68
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
64
69
  minInput: _angular_core.InputSignal<any>;
65
70
  minDateInput: _angular_core.InputSignal<any>;
66
71
  resolvedMin: _angular_core.Signal<Date | null>;
@@ -106,7 +111,7 @@ declare class SdDatetime implements OnDestroy, OnInit {
106
111
  onConfirmInput: (event: any) => void;
107
112
  clear: ($event: any) => void;
108
113
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdDatetime, never>;
109
- 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>;
114
+ 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; }; "labelPlacement": { "alias": "labelPlacement"; "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>;
110
115
  }
111
116
 
112
117
  export { SdDatetime };
@@ -15,7 +15,7 @@ type SdInlineTextChrome = 'standalone' | 'seamless';
15
15
  *
16
16
  * It is intentionally unopinionated about commit/parse/format: it forwards the raw DOM events
17
17
  * (focus / blur / keydown / paste / composition / Enter / Escape) so each consumer keeps its own
18
- * logic (e.g. sd-input-number's vi-VN formatting). Two binding modes:
18
+ * logic (e.g. sd-input-number's number formatting). Two binding modes:
19
19
  * - **uncontrolled** via `[(value)]` — used by the chips' signal drafts;
20
20
  * - **controlled** via `[control]` (an external `SdFormControl`) — used by the form controls.
21
21
  */
@@ -5,7 +5,7 @@ import { ErrorStateMatcher } from '@angular/material/core';
5
5
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
6
6
  import { SdInlineText } from '@sdcorejs/angular/forms/inline-text';
7
7
  import { SdViewDefDirective, SdSuffixDefDirective } from '@sdcorejs/angular/forms/directives';
8
- import { SdViewed, SdViewedInput, SdCustomValidator, SdFormControl } from '@sdcorejs/angular/forms/models';
8
+ import { SdViewed, SdViewedInput, SdCustomValidator, SdLabelPlacement, SdFormControl } from '@sdcorejs/angular/forms/models';
9
9
  import { Size } from '@sdcorejs/utils/models';
10
10
 
11
11
  declare class SdInputNumberErrotStateMatcher implements ErrorStateMatcher {
@@ -19,6 +19,9 @@ declare class SdInputNumber implements OnDestroy, OnInit, AfterViewInit {
19
19
  /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
20
20
  * phải đọc được từ chính control, không chỉ hiện ra màn hình. */
21
21
  readonly errorId: string;
22
+ /** id của nhãn/helper khi `labelPlacement='top'`. */
23
+ readonly labelId: string;
24
+ readonly hintId: string;
22
25
  control: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
23
26
  /** The inline primitive — only present when `viewed='inline'`; drives focus/blur in that mode. */
24
27
  inlineRef: _angular_core.Signal<SdInlineText | undefined>;
@@ -75,6 +78,13 @@ declare class SdInputNumber implements OnDestroy, OnInit, AfterViewInit {
75
78
  appearanceInput: _angular_core.InputSignal<MatFormFieldAppearance | undefined>;
76
79
  appearance: _angular_core.Signal<MatFormFieldAppearance>;
77
80
  floatLabel: _angular_core.InputSignal<FloatLabelType>;
81
+ /** `'float'` (mặc định) hoặc `'top'` — nhãn `<label for>` tĩnh phía trên, helper text dưới control. */
82
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
83
+ /**
84
+ * `inputmode` gốc (vd `'numeric'`, `'decimal'`). Mặc định không đặt — bàn phím số của iOS không có
85
+ * dấu trừ, nên chỉ consumer biết chắc giá trị không âm mới nên bật.
86
+ */
87
+ readonly inputmode: _angular_core.InputSignal<string | null | undefined>;
78
88
  valueModel: _angular_core.ModelSignal<any>;
79
89
  sdChange: _angular_core.OutputEmitterRef<any>;
80
90
  sdFocus: _angular_core.OutputEmitterRef<void>;
@@ -107,7 +117,7 @@ declare class SdInputNumber implements OnDestroy, OnInit, AfterViewInit {
107
117
  blur: () => void;
108
118
  focus: () => void;
109
119
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdInputNumber, never>;
110
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdInputNumber, "sd-input-number", 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; }; "blurOnEnter": { "alias": "blurOnEnter"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "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; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; "sdBlur": "sdBlur"; "keyupEnter": "keyupEnter"; "cleared": "cleared"; "sdFocusForceBlur": "sdFocusForceBlur"; }, ["sdLabelTemplate", "sdValueTemplate", "sdViewDef", "sdSuffixDef"], ["[sdLabel]"], true, never>;
120
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdInputNumber, "sd-input-number", 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; }; "blurOnEnter": { "alias": "blurOnEnter"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "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; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "inputmode": { "alias": "inputmode"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; "sdBlur": "sdBlur"; "keyupEnter": "keyupEnter"; "cleared": "cleared"; "sdFocusForceBlur": "sdFocusForceBlur"; }, ["sdLabelTemplate", "sdValueTemplate", "sdViewDef", "sdSuffixDef"], ["[sdLabel]"], true, never>;
111
121
  }
112
122
 
113
123
  export { SdInputNumber };
@@ -1,5 +1,5 @@
1
1
  import * as _sdcorejs_angular_forms_models from '@sdcorejs/angular/forms/models';
2
- import { SdViewed, SdViewedInput, SdCustomValidator, SdFormControl } from '@sdcorejs/angular/forms/models';
2
+ import { SdLabelPlacement, SdViewed, SdViewedInput, SdCustomValidator, SdFormControl } from '@sdcorejs/angular/forms/models';
3
3
  import * as _sdcorejs_angular_forms_input from '@sdcorejs/angular/forms/input';
4
4
  import * as _angular_core from '@angular/core';
5
5
  import { OnDestroy, OnInit, AfterViewInit, ElementRef, TemplateRef, EventEmitter } from '@angular/core';
@@ -59,6 +59,9 @@ declare class SdInput implements OnDestroy, OnInit, AfterViewInit {
59
59
  /** why: id ổn định của <mat-error> để `<input>` trỏ `aria-describedby` sang — thông báo lỗi
60
60
  * phải đọc được từ chính control, không chỉ hiện ra màn hình. */
61
61
  readonly errorId: string;
62
+ /** id của nhãn/helper khi `labelPlacement='top'` — control trỏ `aria-describedby` sang helper. */
63
+ readonly labelId: string;
64
+ readonly hintId: string;
62
65
  control: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
63
66
  /** The inline primitive — only present when `viewed='inline'`; drives focus/blur in that mode. */
64
67
  inlineRef: _angular_core.Signal<SdInlineText | undefined>;
@@ -81,16 +84,29 @@ declare class SdInput implements OnDestroy, OnInit, AfterViewInit {
81
84
  appearanceInput: _angular_core.InputSignal<MatFormFieldAppearance | undefined>;
82
85
  appearance: _angular_core.Signal<MatFormFieldAppearance>;
83
86
  floatLabel: _angular_core.InputSignal<FloatLabelType>;
87
+ /**
88
+ * `'float'` (mặc định) giữ floating label của Material. `'top'` đặt nhãn `<label for>` tĩnh
89
+ * phía trên control, helper text thành dòng gợi ý dưới control. Xem `SdLabelPlacement`.
90
+ */
91
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
84
92
  size: _angular_core.InputSignal<Size>;
85
93
  form: _angular_core.InputSignalWithTransform<FormGroup<any> | undefined, any>;
86
94
  label: _angular_core.InputSignal<string | undefined>;
87
95
  helperText: _angular_core.InputSignal<string | undefined>;
88
96
  placeholder: _angular_core.InputSignal<string | undefined>;
89
- type: _angular_core.InputSignal<"number" | "text" | "email" | "password">;
97
+ /** Kiểu `<input>` gốc. `'tel'`/`'url'` chỉ đổi bàn phím/autofill — KHÔNG tự thêm validation. */
98
+ type: _angular_core.InputSignal<"number" | "text" | "tel" | "email" | "url" | "password">;
90
99
  mask: _angular_core.InputSignal<SdInputMask | null | undefined>;
91
100
  readonly maskAdapter: _angular_core.Signal<_sdcorejs_angular_forms_input.SdInputMaskAdapter | undefined>;
92
- readonly effectiveType: _angular_core.Signal<"number" | "text" | "email" | "password">;
93
- readonly inputMode: _angular_core.Signal<_sdcorejs_angular_forms_input.SdInputMaskInputMode | undefined>;
101
+ readonly effectiveType: _angular_core.Signal<"number" | "text" | "tel" | "email" | "url" | "password">;
102
+ /** `inputmode` gốc do consumer chỉ định; mask (nếu có) luôn thắng vì nó biết ký tự hợp lệ. */
103
+ readonly inputmodeInput: _angular_core.InputSignal<string | null | undefined>;
104
+ readonly inputMode: _angular_core.Signal<string | undefined>;
105
+ /**
106
+ * Token `autocomplete` (vd `email`, `tel`, `url`, `new-password`). Không truyền thì giữ hành vi
107
+ * cũ: gán một token ngẫu nhiên để trình duyệt không tự điền.
108
+ */
109
+ readonly autocomplete: _angular_core.InputSignal<string | null | undefined>;
94
110
  readonly maxDisplayLength: _angular_core.Signal<number | undefined>;
95
111
  hideInlineError: _angular_core.InputSignalWithTransform<boolean, unknown>;
96
112
  blurOnEnter: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -160,7 +176,7 @@ declare class SdInput implements OnDestroy, OnInit, AfterViewInit {
160
176
  blur: () => void;
161
177
  focus: () => void;
162
178
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdInput, never>;
163
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdInput, "sd-input", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "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; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "blurOnEnter": { "alias": "blurOnEnter"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "minlength": { "alias": "minlength"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "patternErrorMessage": { "alias": "patternErrorMessage"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; "sdBlur": "sdBlur"; "keyupEnter": "keyupEnter"; "cleared": "cleared"; "sdFocusForceBlur": "sdFocusForceBlur"; }, ["sdLabelTemplate", "sdValueTemplate", "sdSuffixDef", "sdViewDef"], ["[sdLabel]"], true, never>;
179
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdInput, "sd-input", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "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; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "inputmodeInput": { "alias": "inputmode"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "blurOnEnter": { "alias": "blurOnEnter"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "minlength": { "alias": "minlength"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "patternErrorMessage": { "alias": "patternErrorMessage"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdFocus": "sdFocus"; "sdBlur": "sdBlur"; "keyupEnter": "keyupEnter"; "cleared": "cleared"; "sdFocusForceBlur": "sdFocusForceBlur"; }, ["sdLabelTemplate", "sdValueTemplate", "sdSuffixDef", "sdViewDef"], ["[sdLabel]"], true, never>;
164
180
  }
165
181
 
166
182
  export { SD_INPUT_MASKS, SdInput, sdCreateInputMask, sdResolveInputMask };
@@ -9,8 +9,23 @@ declare class SdLabel {
9
9
  set _required(val: boolean | '' | undefined | null);
10
10
  helperText?: string;
11
11
  set _helperText(val: string | undefined);
12
+ /**
13
+ * `id` của phần tử nhập liệu THẬT (input/textarea) mà nhãn gắn vào. Khi có, nhãn render bằng
14
+ * `<label for>` gốc: bấm nhãn focus control và screen reader đọc nhãn làm tên của control.
15
+ *
16
+ * why: `<sd-label>` trước đây chỉ là `<span>` trình bày — bấm vào không làm gì và không nối
17
+ * được với control. Nhãn rời (`labelPlacement="top"`) cần liên kết thật tới input.
18
+ */
19
+ htmlFor?: string | null;
20
+ set _for(val: string | undefined | null);
21
+ /**
22
+ * `id` đặt lên phần tử chứa chữ của nhãn, để control không phải input gốc (vd `mat-select`)
23
+ * trỏ `aria-labelledby` sang.
24
+ */
25
+ labelId?: string | null;
26
+ set _labelId(val: string | undefined | null);
12
27
  static ɵfac: i0.ɵɵFactoryDeclaration<SdLabel, never>;
13
- static ɵcmp: i0.ɵɵComponentDeclaration<SdLabel, "sd-label", never, { "_label": { "alias": "label"; "required": false; }; "_description": { "alias": "description"; "required": false; }; "_required": { "alias": "required"; "required": false; }; "_helperText": { "alias": "helperText"; "required": false; }; }, {}, never, never, true, never>;
28
+ static ɵcmp: i0.ɵɵComponentDeclaration<SdLabel, "sd-label", never, { "_label": { "alias": "label"; "required": false; }; "_description": { "alias": "description"; "required": false; }; "_required": { "alias": "required"; "required": false; }; "_helperText": { "alias": "helperText"; "required": false; }; "_for": { "alias": "for"; "required": false; }; "_labelId": { "alias": "labelId"; "required": false; }; }, {}, never, never, true, never>;
14
29
  }
15
30
 
16
31
  export { SdLabel };
@@ -122,6 +122,21 @@ interface SdViewedInlineApi {
122
122
  */
123
123
  declare function sdViewedInline(viewed: Signal<SdViewed>, open?: () => void, disabled?: Signal<boolean>): SdViewedInlineApi;
124
124
 
125
+ /**
126
+ * Vị trí nhãn của một form control Core.
127
+ *
128
+ * - `'float'` (mặc định): floating label của Material nằm trong viền `mat-form-field`. Đây là
129
+ * hành vi lịch sử của mọi control — KHÔNG đổi.
130
+ * - `'top'`: nhãn tĩnh (`<label for>` thật) đặt phía trên control, luôn hiển thị; placeholder
131
+ * chỉ là placeholder (không còn tự lấy nhãn làm placeholder); helper text hiện thành dòng
132
+ * gợi ý phía dưới control và được liên kết `aria-describedby`, bị thay bằng thông báo lỗi khi
133
+ * control lỗi.
134
+ *
135
+ * why: form-generic (builder/renderer) cần nhãn rời phía trên control mà không đổi mặc định của
136
+ * toàn bộ thư viện. Đây là API additive — control nào không truyền vẫn là `'float'`.
137
+ */
138
+ type SdLabelPlacement = 'float' | 'top';
139
+
125
140
  /**
126
141
  * Output serialization strategy for the temporal form controls (`<sd-date>`, `<sd-datetime>`,
127
142
  * `<sd-date-range>`).
@@ -344,4 +359,4 @@ declare class SdStrictDateFnsAdapter extends DateFnsAdapter {
344
359
  declare function provideSdStrictDateFnsAdapter(formats: MatDateFormats): Provider[];
345
360
 
346
361
  export { HandleSdCustomValidator, SD_FORM_CONFIGURATION, SD_TEMPORAL_VALUE_TRANSFORMS, SdFormControl, SdInlineErrorValidator, SdStrictDateFnsAdapter, provideSdStrictDateFnsAdapter, sdFormControlState, sdIsTemporalValueTransform, sdLocalStartOfDay, sdParseTransformedTemporal, sdSerializeTemporalValue, sdViewedInline, sdViewedTransform, ɵsdCoerceFormGroup, ɵsdFormControlConnector, ɵsdModelFacingControl, ɵsdTimerScope };
347
- export type { ISdFormConfiguration, SdCustomValidator, SdFormControlSnapshot, SdSearch, SdSearchReq, SdSelectionData, SdTemporalValueTransform, SdViewed, SdViewedInlineApi, SdViewedInput, ɵSdFormControlConnector, ɵSdFormControlConnectorOptions, ɵSdFormControlConnectorState, ɵSdFormControlParent, ɵSdModelFacingControl, ɵSdModelFacingControlOptions, ɵSdTimerScope };
362
+ export type { ISdFormConfiguration, SdCustomValidator, SdFormControlSnapshot, SdLabelPlacement, SdSearch, SdSearchReq, SdSelectionData, SdTemporalValueTransform, SdViewed, SdViewedInlineApi, SdViewedInput, ɵSdFormControlConnector, ɵSdFormControlConnectorOptions, ɵSdFormControlConnectorState, ɵSdFormControlParent, ɵSdModelFacingControl, ɵSdModelFacingControlOptions, ɵSdTimerScope };