@sdcorejs/angular 20.3.1 → 20.3.2

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 (187) hide show
  1. package/assets/STYLE-GUIDE.md +25 -5
  2. package/assets/THEME.md +237 -5
  3. package/assets/licenses/tiptap-oss-NOTICES.txt +332 -0
  4. package/assets/scss/ckeditor5.scss +2 -88
  5. package/assets/scss/core/_control.scss +39 -0
  6. package/assets/scss/core/form.scss +156 -45
  7. package/assets/scss/core/view.scss +24 -0
  8. package/assets/scss/editor-content.scss +173 -0
  9. package/assets/scss/sd-core.scss +1 -0
  10. package/assets/scss/themes/_component-tokens.scss +93 -31
  11. package/assets/scss/themes/_material-tokens.scss +112 -0
  12. package/assets/scss/themes/_presets.scss +25 -0
  13. package/assets/scss/themes/_scales.scss +10 -0
  14. package/assets/scss/themes/_semantic.scss +13 -0
  15. package/assets/scss/themes/default.scss +8 -2
  16. package/components/avatar/index.d.ts +67 -2
  17. package/components/badge/index.d.ts +188 -6
  18. package/components/button/index.d.ts +20 -1
  19. package/components/ckeditor-styles/index.d.ts +3 -18
  20. package/components/editor/index.d.ts +20 -17
  21. package/components/editor-engine/index.d.ts +246 -0
  22. package/components/file-explorer/index.d.ts +4 -2
  23. package/components/form-generic/index.d.ts +246 -35
  24. package/components/index.d.ts +1 -0
  25. package/components/mini-editor/index.d.ts +33 -70
  26. package/components/modal-resizable/index.d.ts +1 -124
  27. package/components/operator/index.d.ts +137 -8
  28. package/components/tab-router/index.d.ts +31 -18
  29. package/components/table/index.d.ts +84 -6
  30. package/components/window/index.d.ts +81 -0
  31. package/configurations/index.d.ts +8 -1
  32. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +5 -5
  33. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  34. package/fesm2022/sdcorejs-angular-components-avatar.mjs +142 -11
  35. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  36. package/fesm2022/sdcorejs-angular-components-badge.mjs +548 -24
  37. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  38. package/fesm2022/sdcorejs-angular-components-button.mjs +33 -3
  39. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  40. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +5 -20
  41. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  42. package/fesm2022/sdcorejs-angular-components-data-state.mjs +1 -1
  43. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  44. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1872 -0
  45. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -0
  46. package/fesm2022/sdcorejs-angular-components-editor.mjs +457 -756
  47. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  48. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +68 -37
  49. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  50. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +2115 -1156
  51. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  52. package/fesm2022/sdcorejs-angular-components-history.mjs +5 -2
  53. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  54. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +1 -1
  55. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -1
  56. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +21 -6
  57. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  58. package/fesm2022/sdcorejs-angular-components-inform.mjs +1 -1
  59. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  60. package/fesm2022/sdcorejs-angular-components-kanban.mjs +12 -2
  61. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -1
  62. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +177 -283
  63. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  64. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +1 -308
  65. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  66. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  67. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  68. package/fesm2022/sdcorejs-angular-components-operator.mjs +262 -43
  69. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  70. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +12 -12
  71. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  72. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +1 -1
  73. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  74. package/fesm2022/sdcorejs-angular-components-section.mjs +2 -2
  75. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  76. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  77. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  78. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +192 -42
  79. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  80. package/fesm2022/sdcorejs-angular-components-table.mjs +564 -110
  81. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  82. package/fesm2022/sdcorejs-angular-components-tree.mjs +1 -1
  83. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  84. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +1 -1
  85. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  86. package/fesm2022/sdcorejs-angular-components-view.mjs +2 -2
  87. package/fesm2022/sdcorejs-angular-components-view.mjs.map +1 -1
  88. package/fesm2022/sdcorejs-angular-components-window.mjs +486 -0
  89. package/fesm2022/sdcorejs-angular-components-window.mjs.map +1 -0
  90. package/fesm2022/sdcorejs-angular-components.mjs +1 -0
  91. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  92. package/fesm2022/sdcorejs-angular-configurations.mjs.map +1 -1
  93. package/fesm2022/sdcorejs-angular-directives.mjs +18 -1
  94. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  95. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +15 -2
  96. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  97. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs +2 -2
  98. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs.map +1 -1
  99. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +460 -125
  100. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  101. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +75 -13
  102. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  103. package/fesm2022/sdcorejs-angular-forms-date.mjs +71 -18
  104. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  105. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +75 -16
  106. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  107. package/fesm2022/sdcorejs-angular-forms-directives.mjs +82 -2
  108. package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
  109. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  110. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  111. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +1 -1
  112. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  113. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +40 -5
  114. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  115. package/fesm2022/sdcorejs-angular-forms-input.mjs +50 -7
  116. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  117. package/fesm2022/sdcorejs-angular-forms-models.mjs +88 -5
  118. package/fesm2022/sdcorejs-angular-forms-models.mjs.map +1 -1
  119. package/fesm2022/sdcorejs-angular-forms-radio.mjs +2 -2
  120. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  121. package/fesm2022/sdcorejs-angular-forms-segmented.mjs +5 -4
  122. package/fesm2022/sdcorejs-angular-forms-segmented.mjs.map +1 -1
  123. package/fesm2022/sdcorejs-angular-forms-select.mjs +63 -15
  124. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  125. package/fesm2022/sdcorejs-angular-forms-switch.mjs +2 -2
  126. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  127. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +2 -2
  128. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  129. package/fesm2022/sdcorejs-angular-forms-time.mjs +2 -2
  130. package/fesm2022/sdcorejs-angular-forms-time.mjs.map +1 -1
  131. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  132. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  133. package/fesm2022/sdcorejs-angular-i18n.mjs +1535 -22
  134. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  135. package/fesm2022/sdcorejs-angular-interceptors.mjs +1 -1
  136. package/fesm2022/sdcorejs-angular-interceptors.mjs.map +1 -1
  137. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-DnbDCdcz.mjs +478 -0
  138. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-DnbDCdcz.mjs.map +1 -0
  139. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-EBHM4kx2.mjs +214 -0
  140. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-EBHM4kx2.mjs.map +1 -0
  141. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-BtHe8YIW.mjs +277 -0
  142. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-BtHe8YIW.mjs.map +1 -0
  143. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-eFshU7ew.mjs +1556 -0
  144. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-eFshU7ew.mjs.map +1 -0
  145. package/fesm2022/sdcorejs-angular-modules-generic.mjs +2 -0
  146. package/fesm2022/sdcorejs-angular-modules-generic.mjs.map +1 -0
  147. package/fesm2022/sdcorejs-angular-modules-icon.mjs +96 -3
  148. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  149. package/fesm2022/sdcorejs-angular-modules-layout.mjs +1825 -62
  150. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  151. package/fesm2022/sdcorejs-angular-modules.mjs +1 -0
  152. package/fesm2022/sdcorejs-angular-modules.mjs.map +1 -1
  153. package/fesm2022/sdcorejs-angular-pipes.mjs +27 -7
  154. package/fesm2022/sdcorejs-angular-pipes.mjs.map +1 -1
  155. package/fesm2022/sdcorejs-angular-services-confirm.mjs +1 -1
  156. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  157. package/fesm2022/sdcorejs-angular-services-date-time.mjs +143 -0
  158. package/fesm2022/sdcorejs-angular-services-date-time.mjs.map +1 -0
  159. package/fesm2022/sdcorejs-angular-services-storage.mjs +44 -8
  160. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  161. package/fesm2022/sdcorejs-angular-services.mjs +1 -0
  162. package/fesm2022/sdcorejs-angular-services.mjs.map +1 -1
  163. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs +4 -0
  164. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs.map +1 -1
  165. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +10 -0
  166. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -1
  167. package/forms/autocomplete/index.d.ts +5 -0
  168. package/forms/chip-calendar/index.d.ts +163 -18
  169. package/forms/date/index.d.ts +23 -2
  170. package/forms/date-range/index.d.ts +24 -2
  171. package/forms/directives/index.d.ts +47 -2
  172. package/forms/input/index.d.ts +23 -2
  173. package/forms/input-number/index.d.ts +23 -2
  174. package/forms/models/index.d.ts +38 -3
  175. package/forms/select/index.d.ts +32 -2
  176. package/i18n/index.d.ts +302 -2
  177. package/modules/generic/index.d.ts +316 -0
  178. package/modules/icon/index.d.ts +37 -6
  179. package/modules/index.d.ts +1 -0
  180. package/modules/layout/index.d.ts +536 -86
  181. package/package.json +41 -8
  182. package/pipes/index.d.ts +2 -0
  183. package/services/date-time/index.d.ts +57 -0
  184. package/services/index.d.ts +1 -0
  185. package/services/storage/index.d.ts +8 -1
  186. package/utilities/read-state/index.d.ts +2 -0
  187. package/utilities/theme/index.d.ts +1 -1
@@ -148,8 +148,10 @@ type SdFileExplorerState<T> = boolean | ((context: T) => boolean);
148
148
  /** Appearance and state shared by every explorer action, flat button or group. */
149
149
  interface SdFileExplorerActionAppearance<T> {
150
150
  /**
151
- * Visible label. Without it the button is icon-only and `tooltip` is its accessible name. A menu item shows its
152
- * `title`, or its `tooltip` when it has no title. Every definition needs a `title` or a `tooltip`.
151
+ * Label of selector buttons, label-only commands, menu items and drawer entries. File/folder command buttons with
152
+ * icons show their declared icons and use `tooltip ?? title` as their tooltip and accessible name. Without a title, a menu
153
+ * item or drawer entry shows its tooltip. A command without an icon shows `title ?? tooltip`. Every definition
154
+ * needs a `title` or a `tooltip`.
153
155
  */
154
156
  title?: string;
155
157
  /** Tooltip, and the accessible name of an icon-only button. */
@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
2
2
  import { EnvironmentProviders, ElementRef } from '@angular/core';
3
3
  import { Filter, Color } from '@sdcorejs/utils/models';
4
4
  import { SdModal } from '@sdcorejs/angular/components/modal';
5
+ import { SdSegmentedItem, SdSegmentedModel } from '@sdcorejs/angular/forms/segmented';
5
6
  import * as _sdcorejs_angular_components_form_generic from '@sdcorejs/angular/components/form-generic';
6
7
  import { Subject } from 'rxjs';
7
8
  import { FormGroup } from '@angular/forms';
@@ -167,7 +168,11 @@ interface SdFormGenericHtml extends Omit<SdFormGenericFieldBase<'html', never>,
167
168
  variables?: Record<string, string>;
168
169
  query?: SdFormGenericParam[];
169
170
  }
170
- type SdFormGenericField = SdFormGenericTextfield | SdFormGenericTextarea | SdFormGenericNumber | SdFormGenericSelect | SdFormGenericRadio | SdFormGenericCheckbox | SdFormGenericDatetime | SdFormGenericChipString | SdFormGenericChipCalendar | SdFormGenericUpload | SdFormGenericHtml;
171
+ /** Time of day stored as canonical `HH:mm`; `validation.min`/`max` take `HH:mm` boundaries. */
172
+ type SdFormGenericTime = SdFormGenericFieldBase<'time', string>;
173
+ /** JSON edited as text in `sd-code-editor`; the stored value is the parsed JSON, never the text. */
174
+ type SdFormGenericJson = SdFormGenericFieldBase<'json', unknown>;
175
+ type SdFormGenericField = SdFormGenericTextfield | SdFormGenericTextarea | SdFormGenericNumber | SdFormGenericSelect | SdFormGenericRadio | SdFormGenericCheckbox | SdFormGenericDatetime | SdFormGenericChipString | SdFormGenericChipCalendar | SdFormGenericUpload | SdFormGenericTime | SdFormGenericJson | SdFormGenericHtml;
171
176
  type SdFormGenericFieldType = SdFormGenericField['type'];
172
177
 
173
178
  /** Mục trả về từ catalog; `data` là dữ liệu thêm để `fill` đọc (`item.data[from]`). */
@@ -266,6 +271,146 @@ interface SdFormGenericConfig {
266
271
  */
267
272
  declare function provideSdFormGeneric(config?: SdFormGenericConfig): EnvironmentProviders;
268
273
 
274
+ interface SdFormGenericElementState {
275
+ visible: boolean;
276
+ disabled: boolean;
277
+ required: boolean;
278
+ }
279
+
280
+ interface SdFormGenericValidationMessages {
281
+ error: string[];
282
+ warning: string[];
283
+ }
284
+ /** Kết quả `validate()`: luôn có hai danh sách; chỉ lỗi `error` làm `valid = false`. */
285
+ interface SdFormGenericValidationResult {
286
+ valid: boolean;
287
+ messages: SdFormGenericValidationMessages;
288
+ }
289
+
290
+ /**
291
+ * Phần tử không phải field (đợt 2): đặt trong trang hoặc group như field, có `layout` và `rules`, nhưng
292
+ * KHÔNG có `key` — không bao giờ nằm trong `value`, `validate()` hay `viewEntities`.
293
+ *
294
+ * Mọi chữ là chữ thuần do người thiết kế nhập: không HTML, không chèn giá trị động (nội dung giàu dùng
295
+ * field `html`).
296
+ */
297
+ interface SdFormGenericElementBase {
298
+ id: string;
299
+ layout?: SdFormGenericLayout;
300
+ hidden?: boolean;
301
+ }
302
+ /** Cấp tiêu đề; vắng = 3. */
303
+ type SdFormGenericHeadingLevel = 2 | 3 | 4;
304
+ interface SdFormGenericHeading extends SdFormGenericElementBase {
305
+ type: 'heading';
306
+ text: string;
307
+ level?: SdFormGenericHeadingLevel;
308
+ rules?: SdFormGenericVisibilityRules;
309
+ }
310
+ /** Đoạn văn; xuống dòng trong `text` được giữ. */
311
+ interface SdFormGenericParagraph extends SdFormGenericElementBase {
312
+ type: 'paragraph';
313
+ text: string;
314
+ rules?: SdFormGenericVisibilityRules;
315
+ }
316
+ interface SdFormGenericQuote extends SdFormGenericElementBase {
317
+ type: 'quote';
318
+ text: string;
319
+ cite?: string;
320
+ rules?: SdFormGenericVisibilityRules;
321
+ }
322
+ /**
323
+ * Ảnh theo URL. `src` chỉ được dùng khi an toàn (http(s) không kèm credential, đường dẫn tương đối,
324
+ * `data:image/*`); rỗng = chưa đặt. `alt` rỗng nghĩa là ảnh trang trí. `width` tính bằng px, tối đa bề
325
+ * rộng ô.
326
+ */
327
+ interface SdFormGenericImage extends SdFormGenericElementBase {
328
+ type: 'image';
329
+ src: string;
330
+ alt: string;
331
+ width?: number;
332
+ caption?: string;
333
+ rules?: SdFormGenericVisibilityRules;
334
+ }
335
+ /**
336
+ * Liên kết. `href` chỉ được dùng khi an toàn (http(s) không kèm credential, đường dẫn tương đối cùng
337
+ * origin, `mailto:`, `tel:`); không an toàn hoặc rỗng thì chỉ hiện chữ.
338
+ */
339
+ interface SdFormGenericLink extends SdFormGenericElementBase {
340
+ type: 'link';
341
+ text: string;
342
+ href: string;
343
+ /** Mở tab mới (luôn kèm `rel="noopener noreferrer"`). */
344
+ newTab?: boolean;
345
+ rules?: SdFormGenericVisibilityRules;
346
+ }
347
+ interface SdFormGenericDivider extends SdFormGenericElementBase {
348
+ type: 'divider';
349
+ rules?: SdFormGenericVisibilityRules;
350
+ }
351
+ type SdFormGenericNoticeColor = 'info' | 'success' | 'warning' | 'error';
352
+ /** Hộp thông báo (`sd-inform`); vắng `color` = `info`. */
353
+ interface SdFormGenericNotice extends SdFormGenericElementBase {
354
+ type: 'notice';
355
+ text: string;
356
+ title?: string;
357
+ color?: SdFormGenericNoticeColor;
358
+ rules?: SdFormGenericVisibilityRules;
359
+ }
360
+ type SdFormGenericStatic = SdFormGenericHeading | SdFormGenericParagraph | SdFormGenericQuote | SdFormGenericImage | SdFormGenericLink | SdFormGenericDivider | SdFormGenericNotice;
361
+ type SdFormGenericStaticType = SdFormGenericStatic['type'];
362
+ /**
363
+ * `submit`: chạy `validate()`, chỉ phát `(sdAction)` khi hợp lệ. `reset`: đưa value về giá trị consumer nạp
364
+ * gần nhất. `custom`: phát `name` ngay, hoặc như submit khi `validate: true`.
365
+ */
366
+ type SdFormGenericButtonAction = 'submit' | 'reset' | 'custom';
367
+ /** Kiểu của `sd-button`. */
368
+ type SdFormGenericButtonVariant = 'fill' | 'light' | 'outline' | 'text';
369
+ type SdFormGenericButtonAlign = 'start' | 'center' | 'end' | 'stretch';
370
+ /** Điều kiện của button: ẩn/hiện và vô hiệu. */
371
+ interface SdFormGenericButtonRules extends SdFormGenericVisibilityRules {
372
+ disabled?: Filter;
373
+ }
374
+ /** Nút hành động. Renderer không gọi API: consumer xử lý `(sdAction)`. */
375
+ interface SdFormGenericButton extends SdFormGenericElementBase {
376
+ type: 'button';
377
+ label: string;
378
+ /** Tên icon Material đặt trước nhãn. */
379
+ icon?: string;
380
+ action: SdFormGenericButtonAction;
381
+ /** Bắt buộc với `custom`: action được phát. Không được là `submit` hay `reset`. */
382
+ name?: string;
383
+ /** Chỉ có hiệu lực với `custom`: `true` thì chạy như submit. */
384
+ validate?: boolean;
385
+ /** Vắng: `fill` cho submit, `light` cho reset và custom. */
386
+ variant?: SdFormGenericButtonVariant;
387
+ /** Vắng: `primary` cho submit, `secondary` cho reset và custom. */
388
+ color?: Color;
389
+ /** Vắng: `start`; `stretch` chiếm hết ô. */
390
+ align?: SdFormGenericButtonAlign;
391
+ disabled?: boolean;
392
+ /** Ở `[viewed]` mọi button bị ẩn, trừ button bật cờ này (vd "In"). */
393
+ showWhenViewed?: boolean;
394
+ rules?: SdFormGenericButtonRules;
395
+ }
396
+ /** Payload của `(sdAction)` của `<sd-form-render>`. */
397
+ interface SdFormGenericAction {
398
+ /** `submit`, `reset`, hoặc `name` của button custom. */
399
+ action: 'submit' | 'reset' | (string & {});
400
+ /** `null` khi gọi `submit()` / `reset()` từ code. */
401
+ buttonId: string | null;
402
+ /** Object value lúc chạy action (chưa có kết quả upload — gọi `upload()` trước khi lưu). */
403
+ value: Readonly<Record<string, unknown>>;
404
+ /** Thông báo của validation cấp form khi action đã validate; `null` khi không validate. */
405
+ messages: SdFormGenericValidationMessages | null;
406
+ }
407
+ /** Kết quả của `submit()`. */
408
+ interface SdFormGenericSubmitResult {
409
+ valid: boolean;
410
+ messages: SdFormGenericValidationMessages;
411
+ value: Readonly<Record<string, unknown>>;
412
+ }
413
+
269
414
  /**
270
415
  * Schema form generic — phiên bản đầu tiên, JSON do consumer lưu trữ.
271
416
  *
@@ -295,7 +440,10 @@ interface SdFormGenericVisibilityRules {
295
440
  }
296
441
  interface SdFormGenericPage {
297
442
  id: string;
443
+ /** Page title: tab/step label, and the page name in the builder. */
298
444
  label?: string;
445
+ /** Plain text shown at the top of the page content while filling in the form. */
446
+ description?: string;
299
447
  icon?: string;
300
448
  rules?: SdFormGenericVisibilityRules;
301
449
  elements: SdFormGenericPageElement[];
@@ -314,10 +462,10 @@ interface SdFormGenericGroup {
314
462
  elements: SdFormGenericElement[];
315
463
  }
316
464
  /**
317
- * Phần tử đặt trên lưới. Các đợt sau THÊM thành viên vào union (static, button, table) mà không đổi
318
- * shape thành viên cũ; renderer bỏ qua type chưa biết, builder giữ nguyên khi phát lại.
465
+ * Phần tử đặt trên lưới: field, phần tử Tĩnh (đợt 2) hoặc button (đợt 2). Đợt sau THÊM thành viên vào union
466
+ * (table) mà không đổi shape thành viên cũ; renderer bỏ qua type chưa biết, builder giữ nguyên khi phát lại.
319
467
  */
320
- type SdFormGenericElement = SdFormGenericField;
468
+ type SdFormGenericElement = SdFormGenericField | SdFormGenericStatic | SdFormGenericButton;
321
469
  interface SdFormGenericVariable {
322
470
  key: string;
323
471
  label: string;
@@ -338,23 +486,7 @@ interface SdFormGenericFunctionValidation {
338
486
  }
339
487
  type SdFormGenericValidation = SdFormGenericFilterValidation | SdFormGenericFunctionValidation;
340
488
 
341
- interface SdFormGenericElementState {
342
- visible: boolean;
343
- disabled: boolean;
344
- required: boolean;
345
- }
346
-
347
- interface SdFormGenericValidationMessages {
348
- error: string[];
349
- warning: string[];
350
- }
351
- /** Kết quả `validate()`: luôn có hai danh sách; chỉ lỗi `error` làm `valid = false`. */
352
- interface SdFormGenericValidationResult {
353
- valid: boolean;
354
- messages: SdFormGenericValidationMessages;
355
- }
356
-
357
- /** Một phần tử trên canvas: field, group, hoặc phần tử type chưa hỗ trợ (giữ nguyên khi phát lại). */
489
+ /** Một phần tử trên canvas: field, group, phần tử Tĩnh, button, hoặc phần tử type chưa hỗ trợ (giữ nguyên khi phát lại). */
358
490
  type BuilderItem = SdFormGenericPageElement;
359
491
  /** Vùng chứa phần tử: `null` = trang, ngược lại là `id` của group. */
360
492
  type ContainerId = string | null;
@@ -491,8 +623,8 @@ interface VariableEdit {
491
623
  readonly label: string;
492
624
  }
493
625
 
494
- /** Nhóm của palette. */
495
- type PaletteCategory = 'basic' | 'number' | 'choice' | 'datetime' | 'advanced' | 'layout';
626
+ /** Nhóm của palette. `static` = "Tĩnh", `action` = "Nút" (đợt 2); `layout` đổi thành "Cấu trúc" ở đợt 3. */
627
+ type PaletteCategory = 'basic' | 'number' | 'choice' | 'datetime' | 'advanced' | 'static' | 'action' | 'layout';
496
628
  /** Dịch key i18n (truyền từ component để palette không phụ thuộc DI). */
497
629
  type PaletteTranslate = (key: string, params?: Record<string, string | number>) => string;
498
630
  interface PaletteCreateContext {
@@ -550,8 +682,18 @@ declare class FormBuilderStore {
550
682
  readonly activePage: _angular_core.Signal<Omit<SdFormGenericPage, "elements">>;
551
683
  readonly allElements: _angular_core.Signal<_sdcorejs_angular_components_form_generic.SdFormGenericPageElement[]>;
552
684
  readonly navigation: _angular_core.Signal<SdFormGenericNavigation | undefined>;
685
+ /**
686
+ * Single-page navigation (no `navigation`) renders only the first page, so with two or more pages the
687
+ * others are kept in the schema but never shown. The builder warns instead of changing the schema.
688
+ */
689
+ readonly singlePageHidesPages: _angular_core.Signal<boolean>;
553
690
  readonly canDuplicatePage: _angular_core.Signal<boolean>;
554
691
  readonly selectedId: _angular_core.WritableSignal<string | null>;
692
+ /**
693
+ * With no element selected, the inspector shows the active page (title, description, icon, rules)
694
+ * instead of the form-level settings (navigation, variables, validations). Not saved in the schema.
695
+ */
696
+ readonly pageInspected: _angular_core.WritableSignal<boolean>;
555
697
  readonly mode: _angular_core.WritableSignal<BuilderMode>;
556
698
  readonly viewport: _angular_core.WritableSignal<_sdcorejs_angular_components_form_generic.SdFormGenericBreakpoint>;
557
699
  readonly leftTab: _angular_core.WritableSignal<LeftTab>;
@@ -593,13 +735,15 @@ declare class FormBuilderStore {
593
735
  requestFocus(id: string | null): void;
594
736
  announce(message: string): void;
595
737
  select(id: string | null): void;
738
+ /** Opens the page settings in the inspector, optionally switching to that page first. */
739
+ inspectPage(id?: string): void;
596
740
  /** Editor page selection is transient: preserve schema order, values and undo history. */
597
741
  selectPage(id: string): void;
598
742
  addPage(): void;
599
743
  duplicatePage(): string | null;
600
744
  removePage(id: string): boolean;
601
745
  movePage(id: string, delta: -1 | 1): boolean;
602
- setPageMetadata(patch: Partial<Pick<SdFormGenericPage, 'label' | 'icon' | 'rules'>>, coalesceKey?: string): boolean;
746
+ setPageMetadata(patch: Partial<Pick<SdFormGenericPage, 'label' | 'description' | 'icon' | 'rules'>>, coalesceKey?: string): boolean;
603
747
  setPageRule(key: keyof SdFormGenericVisibilityRules, filter: Filter | undefined): boolean;
604
748
  setNavigation(mode: 'single' | 'tabs' | 'steps'): boolean;
605
749
  setLinear(linear: boolean): boolean;
@@ -858,6 +1002,8 @@ declare class SdFormBuilder {
858
1002
  readonly shortcutsModal: _angular_core.Signal<SdModal | undefined>;
859
1003
  /** Container hẹp → palette/inspector thành panel nổi. */
860
1004
  readonly compact: _angular_core.WritableSignal<boolean>;
1005
+ /** Builder < 720px: lựa chọn chế độ trên toolbar chỉ còn icon. Đo cùng ResizeObserver với `compact`. */
1006
+ readonly narrow: _angular_core.WritableSignal<boolean>;
861
1007
  readonly leftOpen: _angular_core.WritableSignal<boolean>;
862
1008
  readonly rightOpen: _angular_core.WritableSignal<boolean>;
863
1009
  /** Id của hai panel — nút mở trỏ tới qua `aria-controls`. */
@@ -869,6 +1015,10 @@ declare class SdFormBuilder {
869
1015
  readonly viewports: readonly BuilderViewport[];
870
1016
  readonly modeIcons: Record<BuilderMode, string>;
871
1017
  readonly viewportIcons: Record<BuilderViewport, string>;
1018
+ /** Chế độ là sd-segmented size sm (thiết kế đợt 1): nhãn i18n có sẵn, builder hẹp thì chỉ còn icon. */
1019
+ protected readonly modeItems: _angular_core.Signal<readonly SdSegmentedItem<BuilderMode>[]>;
1020
+ /** Khung nhìn luôn chỉ có icon; nhãn giữ làm accessible name. */
1021
+ protected readonly viewportItems: readonly SdSegmentedItem<BuilderViewport>[];
872
1022
  readonly isDesign: _angular_core.Signal<boolean>;
873
1023
  readonly schemaText: _angular_core.Signal<string>;
874
1024
  readonly variableDrafts: _angular_core.WritableSignal<VariableDraft[]>;
@@ -881,10 +1031,8 @@ declare class SdFormBuilder {
881
1031
  protected revealPageHeader(event: Event): void;
882
1032
  setMode(mode: BuilderMode): void;
883
1033
  setViewport(viewport: BuilderViewport): void;
884
- /** Phím của radiogroup (APG): ←/↑ lùi, →/↓ tiến (vòng), Home/End về đầu/cuối. */
885
- onSegmentKeydown(event: KeyboardEvent, values: readonly string[], current: string, apply: (value: string) => void): void;
886
- applyMode: (value: string) => void;
887
- applyViewport: (value: string) => void;
1034
+ protected onModeChange(value: SdSegmentedModel<BuilderMode>): void;
1035
+ protected onViewportChange(value: SdSegmentedModel<BuilderViewport>): void;
888
1036
  undo(): void;
889
1037
  redo(): void;
890
1038
  /** Phím tắt trong phạm vi builder (không bắt toàn trang). Ô nhập giữ undo gõ chữ của trình duyệt. */
@@ -918,6 +1066,13 @@ interface SdFormGenericLayoutCell<T> {
918
1066
  }
919
1067
  type SdFormGenericLayoutRow<T> = SdFormGenericLayoutCell<T>[];
920
1068
 
1069
+ /** Action mà button chạy: tên được phát và có chạy `validate()` trước hay không. */
1070
+ interface SdFormGenericButtonIntent {
1071
+ kind: 'submit' | 'reset' | 'custom';
1072
+ action: string;
1073
+ validates: boolean;
1074
+ }
1075
+
921
1076
  interface FieldNode {
922
1077
  kind: 'field';
923
1078
  id: string;
@@ -926,15 +1081,32 @@ interface FieldNode {
926
1081
  field: SdFormGenericField;
927
1082
  state: SdFormGenericElementState;
928
1083
  }
1084
+ interface StaticNode {
1085
+ kind: 'static';
1086
+ id: string;
1087
+ type: string;
1088
+ layout?: SdFormGenericLayout;
1089
+ element: SdFormGenericStatic;
1090
+ }
1091
+ interface ButtonNode {
1092
+ kind: 'button';
1093
+ id: string;
1094
+ type: 'button';
1095
+ layout?: SdFormGenericLayout;
1096
+ element: SdFormGenericButton;
1097
+ intent: SdFormGenericButtonIntent;
1098
+ state: SdFormGenericElementState;
1099
+ }
1100
+ type LeafNode = FieldNode | StaticNode | ButtonNode;
929
1101
  interface GroupNode {
930
1102
  kind: 'group';
931
1103
  id: string;
932
1104
  type: 'group';
933
1105
  layout?: undefined;
934
1106
  group: SdFormGenericGroup;
935
- rows: SdFormGenericLayoutRow<FieldNode>[];
1107
+ rows: SdFormGenericLayoutRow<LeafNode>[];
936
1108
  }
937
- type RenderNode = FieldNode | GroupNode;
1109
+ type RenderNode = LeafNode | GroupNode;
938
1110
  /** Ô của lưới CSS 12 cột: hàng (1-based) và cột (`start / span n`) lấy từ `sdPackRows`. */
939
1111
  interface FieldCell {
940
1112
  kind: 'field';
@@ -944,15 +1116,32 @@ interface FieldCell {
944
1116
  field: SdFormGenericField;
945
1117
  state: SdFormGenericElementState;
946
1118
  }
1119
+ interface StaticCell {
1120
+ kind: 'static';
1121
+ id: string;
1122
+ row: number;
1123
+ column: string;
1124
+ element: SdFormGenericStatic;
1125
+ }
1126
+ interface ButtonCell {
1127
+ kind: 'button';
1128
+ id: string;
1129
+ row: number;
1130
+ column: string;
1131
+ element: SdFormGenericButton;
1132
+ intent: SdFormGenericButtonIntent;
1133
+ disabled: boolean;
1134
+ }
1135
+ type LeafCell = FieldCell | StaticCell | ButtonCell;
947
1136
  interface GroupCell {
948
1137
  kind: 'group';
949
1138
  id: string;
950
1139
  row: number;
951
1140
  column: string;
952
1141
  group: SdFormGenericGroup;
953
- children: FieldCell[];
1142
+ children: LeafCell[];
954
1143
  }
955
- type RenderCell = FieldCell | GroupCell;
1144
+ type RenderCell = LeafCell | GroupCell;
956
1145
  declare class SdFormRender {
957
1146
  #private;
958
1147
  /** Schema form (không bị sửa). */
@@ -977,7 +1166,13 @@ declare class SdFormRender {
977
1166
  protected readonly navigationTip: _angular_core.WritableSignal<boolean>;
978
1167
  readonly effectivePageId: _angular_core.WritableSignal<string | null>;
979
1168
  readonly focusedPageId: _angular_core.WritableSignal<string | null>;
1169
+ /**
1170
+ * Action của button (hoặc của `submit()` / `reset()`). Renderer không gọi API: consumer xử lý theo `action`.
1171
+ * `value` chưa có kết quả upload — gọi `upload()` trước khi lưu.
1172
+ */
1173
+ readonly sdAction: _angular_core.OutputEmitterRef<SdFormGenericAction>;
980
1174
  private readonly grid;
1175
+ private readonly errorBlock;
981
1176
  private readonly items;
982
1177
  private readonly pageTabs;
983
1178
  private readonly pageStepper;
@@ -998,6 +1193,10 @@ declare class SdFormRender {
998
1193
  readonly rows: _angular_core.Signal<SdFormGenericLayoutRow<RenderNode>[]>;
999
1194
  /** Ô của lưới theo thứ tự tài liệu (DOM phẳng, vị trí từ `rows`). */
1000
1195
  readonly cells: _angular_core.Signal<RenderCell[]>;
1196
+ protected readonly formErrors: _angular_core.Signal<readonly string[]>;
1197
+ protected readonly formErrorText: _angular_core.Signal<string>;
1198
+ /** Button đang chạy action có validate (hiện trạng thái loading). */
1199
+ protected readonly busyButtonId: _angular_core.WritableSignal<string | null>;
1001
1200
  constructor();
1002
1201
  /**
1003
1202
  * Đánh dấu mọi control đã chạm, chờ validator bất đồng bộ, rồi chạy validation cấp form.
@@ -1006,7 +1205,7 @@ declare class SdFormRender {
1006
1205
  validate(): Promise<SdFormGenericValidationResult>;
1007
1206
  t: (key: string, params?: Record<string, string | number>) => string;
1008
1207
  pageLabel(page: SdFormGenericPage): string;
1009
- pageDomId(pageId: string, part: 'tab' | 'panel'): string;
1208
+ pageDomId(pageId: string, part: 'tab' | 'panel' | 'description'): string;
1010
1209
  protected onCorePageChange(index: number): void;
1011
1210
  protected onCorePageFocus(event: FocusEvent): void;
1012
1211
  /** Shared navigation gate for consumer model writes, page headers and Next. */
@@ -1014,10 +1213,22 @@ declare class SdFormRender {
1014
1213
  previous(): void;
1015
1214
  next(): void;
1016
1215
  onPageKeydown(event: KeyboardEvent, pageId: string): void;
1216
+ /**
1217
+ * Chạy như bấm button submit: `validate()`, hợp lệ thì phát `(sdAction)` `{ action: 'submit', buttonId: null }`,
1218
+ * không hợp lệ thì hiện lỗi (lỗi cấp form trong khối trước lưới). Đang có lượt chạy thì trả cùng promise.
1219
+ */
1220
+ submit(): Promise<SdFormGenericSubmitResult>;
1221
+ /**
1222
+ * Chạy như bấm button reset: value về value consumer nạp gần nhất (áp lại defaultValue), xoá trạng thái đã
1223
+ * chạm/dirty và phát `(sdAction)` `{ action: 'reset', buttonId: null }`. Bị bỏ qua khi một lượt submit đang chạy.
1224
+ */
1225
+ reset(): void;
1017
1226
  /** Tải lên các tệp đang chờ của mọi field upload; kết quả được ghi vào value. Gọi trước khi lưu. */
1018
1227
  upload(): Promise<void>;
1228
+ /** Bấm một button của schema (D-018: một luồng action duy nhất). */
1229
+ protected press(cell: ButtonCell): void;
1019
1230
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdFormRender, never>;
1020
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdFormRender, "sd-form-render", never, { "schema": { "alias": "schema"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "variables": { "alias": "variables"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "keys": { "alias": "keys"; "required": false; "isSignal": true; }; "activePageId": { "alias": "activePageId"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "activePageId": "activePageIdChange"; }, never, never, true, never>;
1231
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdFormRender, "sd-form-render", never, { "schema": { "alias": "schema"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "variables": { "alias": "variables"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "keys": { "alias": "keys"; "required": false; "isSignal": true; }; "activePageId": { "alias": "activePageId"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "activePageId": "activePageIdChange"; "sdAction": "sdAction"; }, never, never, true, never>;
1021
1232
  }
1022
1233
 
1023
1234
  declare class SdFormRenderService {
@@ -1033,4 +1244,4 @@ declare class SdFormRenderService {
1033
1244
  }
1034
1245
 
1035
1246
  export { SD_FORM_GENERIC_BREAKPOINTS, SdFormBuilder, SdFormRender, SdFormRenderService, provideSdFormGeneric };
1036
- export type { SdFormGenericAlert, SdFormGenericBreakpoint, SdFormGenericBreakpoints, SdFormGenericCatalog, SdFormGenericCatalogContext, SdFormGenericCatalogItem, SdFormGenericCheckbox, SdFormGenericChipCalendar, SdFormGenericChipString, SdFormGenericConfig, SdFormGenericDatetime, SdFormGenericElement, SdFormGenericField, SdFormGenericFieldType, SdFormGenericFieldValidation, SdFormGenericFill, SdFormGenericFilterValidation, SdFormGenericFunctionValidation, SdFormGenericGroup, SdFormGenericHtml, SdFormGenericHtmlDefinition, SdFormGenericHtmlQueryDefinition, SdFormGenericHtmlStaticDefinition, SdFormGenericLayout, SdFormGenericNavigation, SdFormGenericNumber, SdFormGenericNumberSubtype, SdFormGenericOption, SdFormGenericOptions, SdFormGenericPage, SdFormGenericPageElement, SdFormGenericParam, SdFormGenericPhoneCountry, SdFormGenericRadio, SdFormGenericRules, SdFormGenericSchema, SdFormGenericSelect, SdFormGenericTemplate, SdFormGenericTextarea, SdFormGenericTextfield, SdFormGenericTextfieldSubtype, SdFormGenericUpload, SdFormGenericValidation, SdFormGenericValidationMessages, SdFormGenericValidationResult, SdFormGenericValidator, SdFormGenericValueRef, SdFormGenericVariable, SdFormGenericVisibilityRules };
1247
+ export type { SdFormGenericAction, SdFormGenericAlert, SdFormGenericBreakpoint, SdFormGenericBreakpoints, SdFormGenericButton, SdFormGenericButtonAction, SdFormGenericButtonAlign, SdFormGenericButtonRules, SdFormGenericButtonVariant, SdFormGenericCatalog, SdFormGenericCatalogContext, SdFormGenericCatalogItem, SdFormGenericCheckbox, SdFormGenericChipCalendar, SdFormGenericChipString, SdFormGenericConfig, SdFormGenericDatetime, SdFormGenericDivider, SdFormGenericElement, SdFormGenericField, SdFormGenericFieldType, SdFormGenericFieldValidation, SdFormGenericFill, SdFormGenericFilterValidation, SdFormGenericFunctionValidation, SdFormGenericGroup, SdFormGenericHeading, SdFormGenericHeadingLevel, SdFormGenericHtml, SdFormGenericHtmlDefinition, SdFormGenericHtmlQueryDefinition, SdFormGenericHtmlStaticDefinition, SdFormGenericImage, SdFormGenericJson, SdFormGenericLayout, SdFormGenericLink, SdFormGenericNavigation, SdFormGenericNotice, SdFormGenericNoticeColor, SdFormGenericNumber, SdFormGenericNumberSubtype, SdFormGenericOption, SdFormGenericOptions, SdFormGenericPage, SdFormGenericPageElement, SdFormGenericParagraph, SdFormGenericParam, SdFormGenericPhoneCountry, SdFormGenericQuote, SdFormGenericRadio, SdFormGenericRules, SdFormGenericSchema, SdFormGenericSelect, SdFormGenericStatic, SdFormGenericStaticType, SdFormGenericSubmitResult, SdFormGenericTemplate, SdFormGenericTextarea, SdFormGenericTextfield, SdFormGenericTextfieldSubtype, SdFormGenericTime, SdFormGenericUpload, SdFormGenericValidation, SdFormGenericValidationMessages, SdFormGenericValidationResult, SdFormGenericValidator, SdFormGenericValueRef, SdFormGenericVariable, SdFormGenericVisibilityRules };
@@ -5,6 +5,7 @@ export * from '@sdcorejs/angular/components/badge';
5
5
  export * from '@sdcorejs/angular/components/tab-router';
6
6
  export * from '@sdcorejs/angular/components/side-drawer';
7
7
  export * from '@sdcorejs/angular/components/modal-resizable';
8
+ export * from '@sdcorejs/angular/components/window';
8
9
  export * from '@sdcorejs/angular/components/modal';
9
10
  export * from '@sdcorejs/angular/components/table';
10
11
  export * from '@sdcorejs/angular/components/quick-action';
@@ -1,18 +1,19 @@
1
- import { MentionFeed, MentionFeedObjectItem, EditorConfig, ClassicEditor } from 'ckeditor5';
2
- export { MentionFeedObjectItem } from 'ckeditor5';
1
+ import { SdEditorMentionItem, SdEditorMentionFeed, SdEditorEngineOptions, SdEditorImportDiagnostic, SdEditorEngine, SdEditorSourceChangeReason } from '@sdcorejs/angular/components/editor-engine';
2
+ export { SdEditorImportDiagnostic, SdEditorImportError, SdEditorMentionFeed, SdEditorMentionItem } from '@sdcorejs/angular/components/editor-engine';
3
3
  import * as _angular_core from '@angular/core';
4
- import { OnDestroy } from '@angular/core';
4
+ import { OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
5
5
  import { ControlValueAccessor } from '@angular/forms';
6
6
 
7
+ /** @deprecated Use SdEditorMentionItem. CK DOM renderers are unsupported. */
8
+ type MentionFeedObjectItem = SdEditorMentionItem;
7
9
  type SdMiniEditorOutputFormat = 'html' | 'markdown';
8
10
  interface SdMiniEditorMentionConfig {
9
- /** Feed data cho mention - có thể là array hoặc function trả về Promise
10
- * CKEditor MentionFeed đã hỗ trợ: marker, minChars, dropdownLimit, itemRenderer
11
- */
12
- feeds?: MentionFeed[];
11
+ /** Library-owned feed arrays/functions. CK itemRenderer is unsupported and diagnosed. */
12
+ feeds?: SdEditorMentionFeed[];
13
13
  /** Custom render function cho giá trị mention khi chèn vào editor
14
14
  * Trả về object với text và các attributes tùy chỉnh
15
15
  */
16
+ /** @deprecated This previously unused callback has no rendering behavior. */
16
17
  valueRender?: (item: MentionFeedObjectItem) => {
17
18
  text: string;
18
19
  attributes?: Record<string, string>;
@@ -43,96 +44,58 @@ interface SdMiniEditorOption {
43
44
  /** Callback khi mention được chọn */
44
45
  onMentionSelect?: (item: SdMiniEditorMentionItem) => void;
45
46
  }
46
- type SdMiniEditorConfig = EditorConfig & {
47
- getOption?: () => SdMiniEditorOption;
48
- };
47
+ /** @deprecated Use component options. CK plugins/config/licenseKey are unsupported. */
48
+ type SdMiniEditorConfig = SdEditorEngineOptions;
49
49
 
50
- /**
51
- * Component sd-mini-editor - Editor đơn giản cho comment input
52
- * Sử dụng CKEditor với chế độ đơn giản (bold, italic, link)
53
- * Hỗ trợ mention và output format (html/markdown)
54
- *
55
- * @example
56
- * ```html
57
- * <sd-mini-editor
58
- * [option]="editorOption"
59
- * [(ngModel)]="content"
60
- * (contentChange)="onContentChange($event)"
61
- * >
62
- * </sd-mini-editor>
63
- * ```
64
- */
65
- declare class SdMiniEditor implements ControlValueAccessor, OnDestroy {
50
+ /** Compact Core toolbar with the same document schema as SdEditor. */
51
+ declare class SdMiniEditor implements ControlValueAccessor, OnChanges, OnDestroy {
66
52
  #private;
67
- /** Cấu hình option cho editor */
68
53
  option: SdMiniEditorOption;
69
- get maxEditorHeight(): string | undefined;
70
- /** NgModel binding - nội dung HTML/Markdown */
71
54
  value: string;
55
+ readonly disabled: _angular_core.InputSignal<boolean>;
72
56
  readonly valueChange: _angular_core.OutputEmitterRef<string>;
73
- /** Event emitter khi content thay đổi */
74
57
  readonly contentChange: _angular_core.OutputEmitterRef<string>;
75
- /** Event emitter khi blur */
76
58
  readonly blur: _angular_core.OutputEmitterRef<FocusEvent>;
77
- /** Event emitter khi focus */
78
59
  readonly focus: _angular_core.OutputEmitterRef<FocusEvent>;
79
- /** Disabled state */
80
- readonly disabled: _angular_core.InputSignal<boolean>;
81
- Editor: typeof ClassicEditor;
82
- get editorConfig(): SdMiniEditorConfig;
60
+ readonly importWarning: _angular_core.OutputEmitterRef<readonly SdEditorImportDiagnostic[]>;
61
+ readonly importDiagnostics: _angular_core.Signal<readonly SdEditorImportDiagnostic[]>;
62
+ readonly surfaceContent: _angular_core.WritableSignal<string>;
63
+ readonly effectiveDisabled: _angular_core.Signal<boolean>;
64
+ get maxEditorHeight(): string | undefined;
83
65
  constructor();
84
- ngOnDestroy(): void;
85
- /**
86
- * Xử lý khi editor ready
87
- */
88
- onReady(editor: ClassicEditor): void;
89
- /**
90
- * Set nội dung cho editor
91
- */
66
+ ngOnChanges(changes: SimpleChanges): void;
67
+ onEngineReady(engine: SdEditorEngine): void;
68
+ /** Cancel a stale throttle window before replacing an authoritative source. */
69
+ onSourceChange(reason?: SdEditorSourceChangeReason): void;
70
+ onFormatChange(value: string | undefined): void;
71
+ onSurfaceChange(value: string): void;
72
+ onCompositionChange(composing: boolean): void;
73
+ onSurfaceFocus(event: FocusEvent): void;
74
+ onSurfaceBlur(event: FocusEvent): void;
75
+ onDiagnostics(diagnostics: readonly SdEditorImportDiagnostic[]): void;
76
+ onMentionSelected(item: SdEditorMentionItem): void;
92
77
  setContent(content: string): void;
93
- /**
94
- * Get nội dung từ editor
95
- */
96
78
  getContent(): string;
97
- /**
98
- * Nội dung dạng HTML (đã lọc), bất kể `outputFormat`.
99
- */
100
79
  getHtmlContent(): string;
101
- /**
102
- * Focus vào editor
103
- */
104
80
  focusEditor(): void;
105
- /**
106
- * Insert mention vào vị trí con trỏ hiện tại
107
- */
108
81
  insertMention(item: {
109
82
  id: string;
110
83
  name: string;
111
84
  marker?: string;
112
85
  }): void;
113
- /**
114
- * Get danh sách mentions trong nội dung
115
- */
116
86
  getMentions(): {
117
87
  id: string;
118
88
  name: string;
119
89
  marker: string;
120
90
  }[];
121
- /**
122
- * ControlValueAccessor: Write value
123
- */
124
91
  writeValue(value: string): void;
125
- /**
126
- * ControlValueAccessor: Register change callback
127
- */
128
92
  registerOnChange(fn: (value: string) => void): void;
129
- /**
130
- * ControlValueAccessor: Register touched callback
131
- */
132
93
  registerOnTouched(fn: () => void): void;
94
+ setDisabledState(disabled: boolean): void;
95
+ ngOnDestroy(): void;
133
96
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdMiniEditor, never>;
134
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdMiniEditor, "sd-mini-editor", never, { "option": { "alias": "option"; "required": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "contentChange": "contentChange"; "blur": "blur"; "focus": "focus"; }, never, never, true, never>;
97
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdMiniEditor, "sd-mini-editor", never, { "option": { "alias": "option"; "required": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "contentChange": "contentChange"; "blur": "blur"; "focus": "focus"; "importWarning": "importWarning"; }, never, never, true, never>;
135
98
  }
136
99
 
137
100
  export { SdMiniEditor };
138
- export type { SdMiniEditorConfig, SdMiniEditorMentionConfig, SdMiniEditorMentionItem, SdMiniEditorOption, SdMiniEditorOutputFormat };
101
+ export type { MentionFeedObjectItem, SdMiniEditorConfig, SdMiniEditorMentionConfig, SdMiniEditorMentionItem, SdMiniEditorOption, SdMiniEditorOutputFormat };