@sdcorejs/angular 21.2.15 → 21.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 +8 -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 +105 -50
  48. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  49. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +5844 -6504
  50. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  51. package/fesm2022/sdcorejs-angular-components-highlight.mjs +63 -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 +2088 -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 +9 -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 +129 -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 +11 -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 +99 -13
  102. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  103. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +149 -6
  104. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  105. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +19 -4
  106. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  107. package/fesm2022/sdcorejs-angular-forms-chip.mjs +19 -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 +17 -7
  112. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  113. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +17 -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 +18 -4
  122. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  123. package/fesm2022/sdcorejs-angular-forms-input.mjs +29 -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 +498 -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 +20 -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 +1429 -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 +196 -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 +107 -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
@@ -1,13 +1,14 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { TemplateRef, OnInit, Signal } from '@angular/core';
2
+ import { TemplateRef, OnInit, DoCheck, Signal } from '@angular/core';
3
3
  import { FormGroup, FormControl } from '@angular/forms';
4
+ import { ErrorStateMatcher } from '@angular/material/core';
4
5
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
5
6
  import { MatInput } from '@angular/material/input';
6
7
  import { MatSelect, MatSelectChange } from '@angular/material/select';
7
8
  import { SdDataStateTemplateDirective } from '@sdcorejs/angular/components/data-state';
8
9
  import { SdSearchReadState } from '@sdcorejs/angular/utilities/read-state';
9
10
  import { SdItemDefDefDirective, SdViewDefDirective } from '@sdcorejs/angular/forms/directives';
10
- import { SdViewed, SdViewedInput, SdCustomValidator, SdSearch, SdSelectionData, SdFormControl } from '@sdcorejs/angular/forms/models';
11
+ import { SdViewed, SdViewedInput, SdCustomValidator, SdLabelPlacement, SdSearch, SdSelectionData, SdFormControl } from '@sdcorejs/angular/forms/models';
11
12
  import { Size } from '@sdcorejs/utils/models';
12
13
 
13
14
  interface SdSelectFooterActionContext {
@@ -24,14 +25,19 @@ declare class SdSelectFooterActionDirective {
24
25
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SdSelectFooterActionDirective, "ng-template[sdSelectFooterAction]", never, { "when": { "alias": "when"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
25
26
  }
26
27
 
27
- declare class SdSelect<T extends object | string | number = Record<string, unknown>> implements OnInit {
28
+ declare class SdSelect<T extends object | string | number = Record<string, unknown>> implements OnInit, DoCheck {
28
29
  #private;
29
30
  id: string;
30
31
  /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
31
32
  * phải đọc được từ chính control, không chỉ hiện ra màn hình. */
32
33
  readonly errorId: string;
34
+ /** id của nhãn/helper khi `labelPlacement='top'` — `mat-select` trỏ `aria-labelledby` sang nhãn. */
35
+ readonly labelId: string;
36
+ readonly hintId: string;
33
37
  matInputRef: Signal<MatInput | undefined>;
34
38
  selectRef: Signal<MatSelect | undefined>;
39
+ private readonly selectElement;
40
+ private readonly virtualViewport;
35
41
  sdLabelTemplate: Signal<TemplateRef<any> | undefined>;
36
42
  sdValueTemplate: Signal<TemplateRef<any> | undefined>;
37
43
  /**
@@ -72,6 +78,14 @@ declare class SdSelect<T extends object | string | number = Record<string, unkno
72
78
  disabledField: _angular_core.InputSignal<"" | (T extends object ? { [Key in keyof T & string]: T[Key] extends string | number | boolean | Function | Date | null | undefined ? Key : T[Key] extends any[] ? Key : T[Key] extends object ? Key | `${Key}.${T[Key] extends infer T_1 ? T_1 extends T[Key] ? T_1 extends object ? { [Key_2 in keyof T_1 & string]: T_1[Key_2] extends string | number | boolean | Function | Date | null | undefined ? Key_2 : T_1[Key_2] extends any[] ? Key_2 : T_1[Key_2] extends object ? Key_2 | `${Key_2}.${T_1[Key_2] extends infer T_2 ? T_2 extends T_1[Key_2] ? T_2 extends object ? { [Key_3 in keyof T_2 & string]: T_2[Key_3] extends string | number | boolean | Function | Date | null | undefined ? Key_3 : T_2[Key_3] extends any[] ? Key_3 : T_2[Key_3] extends object ? Key_3 | `${Key_3}.${T_2[Key_3] extends infer T_3 ? T_3 extends T_2[Key_3] ? T_3 extends object ? { [Key_4 in keyof T_3 & string]: T_3[Key_4] extends string | number | boolean | Function | Date | null | undefined ? Key_4 : T_3[Key_4] extends any[] ? Key_4 : T_3[Key_4] extends object ? Key_4 : Key_4; }[keyof T_3 & string] : string : never : never}` : Key_3; }[keyof T_2 & string] : string : never : never}` : Key_2; }[keyof T_1 & string] : string : never : never}` : Key; }[keyof T & string] : string)>;
73
79
  cacheChecksum: _angular_core.InputSignal<any>;
74
80
  limit: _angular_core.InputSignal<number>;
81
+ /**
82
+ * Virtual scrolling for long lists (opt-in, default `false`). When on, the panel renders only the rows
83
+ * in view, array items are no longer cut by `limit`, and the component — not `mat-select` — owns the
84
+ * value. See sd-select.md, "Virtual scroll".
85
+ */
86
+ readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
87
+ /** Fixed row height in px for the virtual viewport. Default 36 = the panel's compact option row. */
88
+ readonly itemSize: _angular_core.InputSignalWithTransform<number, unknown>;
75
89
  hyperlink: _angular_core.InputSignal<string | null | undefined>;
76
90
  minWidthPanel: _angular_core.InputSignalWithTransform<string | number, string | number | null | undefined>;
77
91
  hideInlineError: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -110,6 +124,8 @@ declare class SdSelect<T extends object | string | number = Record<string, unkno
110
124
  appearanceInput: _angular_core.InputSignal<MatFormFieldAppearance | undefined>;
111
125
  appearance: Signal<MatFormFieldAppearance>;
112
126
  floatLabel: _angular_core.InputSignal<FloatLabelType>;
127
+ /** `'float'` (mặc định) hoặc `'top'` — nhãn tĩnh phía trên, helper text dưới control. */
128
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
113
129
  items: _angular_core.InputSignal<SdSearch | T[] | Signal<T[]> | null | undefined>;
114
130
  valueModel: _angular_core.ModelSignal<string | number | boolean | (string | number)[] | null | undefined>;
115
131
  sdChange: _angular_core.OutputEmitterRef<any>;
@@ -131,6 +147,41 @@ declare class SdSelect<T extends object | string | number = Record<string, unkno
131
147
  selectedItems: T[];
132
148
  }>;
133
149
  readonly visibleFooterActions: Signal<SdSelectFooterActionDirective[]>;
150
+ /** Value bound one-way to the virtual shell; the shell never writes it back (no `formControl` on it). */
151
+ protected readonly virtualShellValue: Signal<string | number | boolean | (string | number | boolean)[] | null>;
152
+ protected readonly virtualSentinel: symbol;
153
+ protected readonly virtualPanelClass: {
154
+ single: string[];
155
+ multiple: string[];
156
+ };
157
+ /** A rendered option matches its own value; the sentinel matches any value whose option is not rendered. */
158
+ protected readonly virtualCompareWith: (optionValue: unknown, value: unknown) => boolean;
159
+ /** The virtual shell cannot see `formControl`, so the component supplies Material's error state. */
160
+ protected readonly virtualErrorStateMatcher: ErrorStateMatcher;
161
+ /** Same rule as the non-virtual template: rows render when both fields are set, or neither. */
162
+ protected readonly virtualRenderable: Signal<boolean>;
163
+ protected readonly virtualViewportHeight: Signal<number>;
164
+ protected readonly virtualTrackBy: (_index: number, item: T) => unknown;
165
+ /** Stable id per row index: aria-activedescendant targets and finds the rendered option by it. */
166
+ protected readonly virtualOptionId: (index: number) => string;
167
+ /** Context of `#sdSelected` in the virtual branch — the same shape as the non-virtual templates. */
168
+ protected readonly selectedTemplateContext: Signal<{
169
+ $implicit: T[];
170
+ item: T[];
171
+ items: T[];
172
+ display: string;
173
+ multiple: boolean;
174
+ } | {
175
+ $implicit: T;
176
+ item: T;
177
+ items: T[];
178
+ display: string;
179
+ multiple: boolean;
180
+ }>;
181
+ /** Index of the active row in the full filtered list, or -1. */
182
+ readonly virtualActiveIndex: Signal<number>;
183
+ /** `aria-activedescendant` of the search box: the active row, only while it is rendered. */
184
+ protected readonly virtualActiveDescendant: Signal<string | null>;
134
185
  normalizedValue: Signal<string | number | boolean | (string | number | boolean)[] | null | undefined>;
135
186
  filtered: Signal<boolean>;
136
187
  delayTime: Signal<0 | 500>;
@@ -151,6 +202,7 @@ declare class SdSelect<T extends object | string | number = Record<string, unkno
151
202
  tooltip: Signal<string>;
152
203
  updatePanelWidth: () => void;
153
204
  constructor();
205
+ ngDoCheck(): void;
154
206
  ngOnInit(): void;
155
207
  protected focusReadRetry: (event: KeyboardEvent) => void;
156
208
  protected onReadRegionKeydown: (event: KeyboardEvent) => void;
@@ -166,14 +218,24 @@ declare class SdSelect<T extends object | string | number = Record<string, unkno
166
218
  reValidate: () => void;
167
219
  clear: ($event?: any) => void;
168
220
  onClick: () => void;
221
+ /**
222
+ * Bấm nhãn rời (`labelPlacement='top'`) focus `mat-select` — như `<label for>` với input gốc.
223
+ * why: `mat-select` không phải phần tử "labelable" nên `for` không có tác dụng; chỉ focus, KHÔNG
224
+ * mở panel (hành vi giống select gốc).
225
+ */
226
+ onLabelClick: () => void;
169
227
  focus: () => void;
170
228
  /** Clears the panel search/filter input and resets `searchText`. */
171
229
  clearSearch: () => void;
172
230
  /** Open the select panel programmatically (anchors to the mat-select trigger). */
173
231
  open: () => void;
174
232
  onOpenedChange: (isOpened: boolean) => void;
233
+ /** Mirrors MatSelect._onBlur: a blur while the panel is open is focus moving into the panel. */
234
+ protected onVirtualBlur: () => void;
235
+ /** Keys in the search box: rows move with the arrows/Page/Home/End, Enter chooses the active row. */
236
+ protected onVirtualSearchKeydown: (event: KeyboardEvent) => void;
175
237
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdSelect<any>, never>;
176
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdSelect<any>, "sd-select", 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; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "minWidthPanel": { "alias": "minWidthPanel"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "hideReadError": { "alias": "hideReadError"; "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; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showSelectAll": { "alias": "showSelectAll"; "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; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "sdReadStateChange": "sdReadStateChange"; "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; }, ["sdLabelTemplate", "sdValueTemplate", "sdSelectedTemplate", "itemDef", "sdViewDef", "footerActions", "dataStateTemplate"], ["[sdLabel]"], true, never>;
238
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdSelect<any>, "sd-select", 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; }; "cacheChecksum": { "alias": "cacheChecksum"; "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; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "minWidthPanel": { "alias": "minWidthPanel"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "hideReadError": { "alias": "hideReadError"; "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; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showSelectAll": { "alias": "showSelectAll"; "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; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "sdReadStateChange": "sdReadStateChange"; "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; }, ["sdLabelTemplate", "sdValueTemplate", "sdSelectedTemplate", "itemDef", "sdViewDef", "footerActions", "dataStateTemplate"], ["[sdLabel]"], true, never>;
177
239
  }
178
240
 
179
241
  export { SdSelect, SdSelectFooterActionDirective };
@@ -3,7 +3,7 @@ import { OnInit, OnDestroy, ElementRef } from '@angular/core';
3
3
  import { FormGroup } from '@angular/forms';
4
4
  import { MatFormFieldAppearance, FloatLabelType } from '@angular/material/form-field';
5
5
  import { SdViewDefDirective, SdLabelDefDirective, SdSuffixDefDirective } from '@sdcorejs/angular/forms/directives';
6
- import { SdViewed, SdViewedInput, SdCustomValidator, SdFormControl } from '@sdcorejs/angular/forms/models';
6
+ import { SdViewed, SdViewedInput, SdCustomValidator, SdLabelPlacement, SdFormControl } from '@sdcorejs/angular/forms/models';
7
7
  import { Size } from '@sdcorejs/utils/models';
8
8
 
9
9
  declare class SdTextarea implements OnInit, OnDestroy {
@@ -12,6 +12,9 @@ declare class SdTextarea implements OnInit, OnDestroy {
12
12
  /** why: id ổn định của <mat-error> để control trỏ `aria-describedby` sang — thông báo lỗi
13
13
  * phải đọc được từ chính control, không chỉ hiện ra màn hình. */
14
14
  readonly errorId: string;
15
+ /** id của nhãn/helper khi `labelPlacement='top'`. */
16
+ readonly labelId: string;
17
+ readonly hintId: string;
15
18
  textareaRef: _angular_core.Signal<ElementRef<HTMLTextAreaElement> | undefined>;
16
19
  sdViewDef: _angular_core.Signal<SdViewDefDirective<any, any> | undefined>;
17
20
  sdLabelDef: _angular_core.Signal<SdLabelDefDirective | undefined>;
@@ -46,6 +49,8 @@ declare class SdTextarea implements OnInit, OnDestroy {
46
49
  /** Focus the inline textarea. No-op unless `viewed='inline'`. */
47
50
  enterInlineEdit: () => void;
48
51
  maxlength: _angular_core.InputSignalWithTransform<number | null, unknown>;
52
+ /** Số ký tự tối thiểu (khi có giá trị). Rỗng vẫn do `required` quyết định. */
53
+ minlength: _angular_core.InputSignalWithTransform<number | null, unknown>;
49
54
  pattern: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
50
55
  validator: _angular_core.InputSignal<SdCustomValidator | undefined>;
51
56
  inlineError: _angular_core.InputSignalWithTransform<string | undefined, string | null | undefined>;
@@ -56,6 +61,8 @@ declare class SdTextarea implements OnInit, OnDestroy {
56
61
  appearanceInput: _angular_core.InputSignal<MatFormFieldAppearance | undefined>;
57
62
  appearance: _angular_core.Signal<MatFormFieldAppearance>;
58
63
  floatLabel: _angular_core.InputSignal<FloatLabelType>;
64
+ /** `'float'` (mặc định) hoặc `'top'` — nhãn `<label for>` tĩnh phía trên, helper text dưới control. */
65
+ labelPlacement: _angular_core.InputSignal<SdLabelPlacement>;
59
66
  valueModel: _angular_core.ModelSignal<any>;
60
67
  sdChange: _angular_core.OutputEmitterRef<any>;
61
68
  formControl: SdFormControl;
@@ -71,7 +78,7 @@ declare class SdTextarea implements OnInit, OnDestroy {
71
78
  getCurrentLength: () => number;
72
79
  isMaxlengthExceeded: () => boolean;
73
80
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdTextarea, never>;
74
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdTextarea, "sd-textarea", 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; }; "rows": { "alias": "rows"; "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; }; "autoHeight": { "alias": "autoHeight"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "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; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; }, ["sdViewDef", "sdLabelDef", "sdSuffixDef"], never, true, never>;
81
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdTextarea, "sd-textarea", 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; }; "rows": { "alias": "rows"; "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; }; "autoHeight": { "alias": "autoHeight"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "minlength": { "alias": "minlength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "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; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; }, ["sdViewDef", "sdLabelDef", "sdSuffixDef"], never, true, never>;
75
82
  }
76
83
 
77
84
  export { SdTextarea };