@sdcorejs/angular 20.3.0 → 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 (199) hide show
  1. package/README.md +2 -2
  2. package/assets/STYLE-GUIDE.md +25 -5
  3. package/assets/THEME.md +237 -5
  4. package/assets/licenses/tiptap-oss-NOTICES.txt +332 -0
  5. package/assets/scss/ckeditor5.scss +2 -88
  6. package/assets/scss/core/_control.scss +39 -0
  7. package/assets/scss/core/form.scss +156 -45
  8. package/assets/scss/core/view.scss +24 -0
  9. package/assets/scss/editor-content.scss +173 -0
  10. package/assets/scss/sd-core.scss +1 -0
  11. package/assets/scss/themes/_component-tokens.scss +93 -31
  12. package/assets/scss/themes/_material-tokens.scss +112 -0
  13. package/assets/scss/themes/_presets.scss +25 -0
  14. package/assets/scss/themes/_scales.scss +10 -0
  15. package/assets/scss/themes/_semantic.scss +13 -0
  16. package/assets/scss/themes/default.scss +8 -2
  17. package/components/avatar/index.d.ts +67 -2
  18. package/components/badge/index.d.ts +188 -6
  19. package/components/button/index.d.ts +20 -1
  20. package/components/ckeditor-styles/index.d.ts +3 -18
  21. package/components/editor/index.d.ts +20 -17
  22. package/components/editor-engine/index.d.ts +246 -0
  23. package/components/file-explorer/index.d.ts +449 -57
  24. package/components/form-generic/index.d.ts +301 -37
  25. package/components/index.d.ts +2 -0
  26. package/components/kanban/index.d.ts +179 -0
  27. package/components/mini-editor/index.d.ts +33 -70
  28. package/components/modal-resizable/index.d.ts +1 -124
  29. package/components/operator/index.d.ts +137 -8
  30. package/components/section/index.d.ts +2 -1
  31. package/components/tab/index.d.ts +3 -1
  32. package/components/tab-router/index.d.ts +31 -18
  33. package/components/table/index.d.ts +84 -6
  34. package/components/window/index.d.ts +81 -0
  35. package/configurations/index.d.ts +8 -1
  36. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +5 -5
  37. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  38. package/fesm2022/sdcorejs-angular-components-avatar.mjs +142 -11
  39. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  40. package/fesm2022/sdcorejs-angular-components-badge.mjs +548 -24
  41. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  42. package/fesm2022/sdcorejs-angular-components-button.mjs +33 -3
  43. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  44. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +5 -20
  45. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  46. package/fesm2022/sdcorejs-angular-components-data-state.mjs +1 -1
  47. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  48. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1872 -0
  49. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -0
  50. package/fesm2022/sdcorejs-angular-components-editor.mjs +457 -756
  51. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  52. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +2209 -106
  53. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  54. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +2616 -1054
  55. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  56. package/fesm2022/sdcorejs-angular-components-history.mjs +5 -2
  57. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  58. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +1 -1
  59. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -1
  60. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +21 -6
  61. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  62. package/fesm2022/sdcorejs-angular-components-inform.mjs +1 -1
  63. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  64. package/fesm2022/sdcorejs-angular-components-kanban.mjs +451 -0
  65. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -0
  66. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +177 -283
  67. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  68. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +1 -308
  69. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  70. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  71. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  72. package/fesm2022/sdcorejs-angular-components-operator.mjs +262 -43
  73. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  74. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +12 -12
  75. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  76. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +1 -1
  77. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  78. package/fesm2022/sdcorejs-angular-components-section.mjs +5 -4
  79. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  80. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  81. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  82. package/fesm2022/sdcorejs-angular-components-stepper.mjs +5 -1
  83. package/fesm2022/sdcorejs-angular-components-stepper.mjs.map +1 -1
  84. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +192 -42
  85. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  86. package/fesm2022/sdcorejs-angular-components-tab.mjs +12 -4
  87. package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
  88. package/fesm2022/sdcorejs-angular-components-table.mjs +564 -110
  89. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  90. package/fesm2022/sdcorejs-angular-components-tree.mjs +1 -1
  91. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  92. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +1 -1
  93. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  94. package/fesm2022/sdcorejs-angular-components-view.mjs +2 -2
  95. package/fesm2022/sdcorejs-angular-components-view.mjs.map +1 -1
  96. package/fesm2022/sdcorejs-angular-components-window.mjs +486 -0
  97. package/fesm2022/sdcorejs-angular-components-window.mjs.map +1 -0
  98. package/fesm2022/sdcorejs-angular-components.mjs +2 -0
  99. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  100. package/fesm2022/sdcorejs-angular-configurations.mjs.map +1 -1
  101. package/fesm2022/sdcorejs-angular-directives.mjs +18 -1
  102. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  103. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +15 -2
  104. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  105. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs +2 -2
  106. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs.map +1 -1
  107. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +460 -125
  108. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  109. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +75 -13
  110. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  111. package/fesm2022/sdcorejs-angular-forms-date.mjs +71 -18
  112. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  113. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +75 -16
  114. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  115. package/fesm2022/sdcorejs-angular-forms-directives.mjs +82 -2
  116. package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
  117. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  118. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  119. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +1 -1
  120. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  121. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +40 -5
  122. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  123. package/fesm2022/sdcorejs-angular-forms-input.mjs +50 -7
  124. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  125. package/fesm2022/sdcorejs-angular-forms-models.mjs +88 -5
  126. package/fesm2022/sdcorejs-angular-forms-models.mjs.map +1 -1
  127. package/fesm2022/sdcorejs-angular-forms-radio.mjs +2 -2
  128. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  129. package/fesm2022/sdcorejs-angular-forms-segmented.mjs +245 -0
  130. package/fesm2022/sdcorejs-angular-forms-segmented.mjs.map +1 -0
  131. package/fesm2022/sdcorejs-angular-forms-select.mjs +63 -15
  132. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  133. package/fesm2022/sdcorejs-angular-forms-switch.mjs +2 -2
  134. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  135. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +2 -2
  136. package/fesm2022/sdcorejs-angular-forms-textarea.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-forms.mjs +8 -0
  142. package/fesm2022/sdcorejs-angular-forms.mjs.map +1 -1
  143. package/fesm2022/sdcorejs-angular-i18n.mjs +1830 -17
  144. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  145. package/fesm2022/sdcorejs-angular-interceptors.mjs +1 -1
  146. package/fesm2022/sdcorejs-angular-interceptors.mjs.map +1 -1
  147. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-DnbDCdcz.mjs +478 -0
  148. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-DnbDCdcz.mjs.map +1 -0
  149. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-EBHM4kx2.mjs +214 -0
  150. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-EBHM4kx2.mjs.map +1 -0
  151. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-BtHe8YIW.mjs +277 -0
  152. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-BtHe8YIW.mjs.map +1 -0
  153. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-eFshU7ew.mjs +1556 -0
  154. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-eFshU7ew.mjs.map +1 -0
  155. package/fesm2022/sdcorejs-angular-modules-generic.mjs +2 -0
  156. package/fesm2022/sdcorejs-angular-modules-generic.mjs.map +1 -0
  157. package/fesm2022/sdcorejs-angular-modules-icon.mjs +96 -3
  158. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  159. package/fesm2022/sdcorejs-angular-modules-layout.mjs +1825 -62
  160. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  161. package/fesm2022/sdcorejs-angular-modules.mjs +1 -0
  162. package/fesm2022/sdcorejs-angular-modules.mjs.map +1 -1
  163. package/fesm2022/sdcorejs-angular-pipes.mjs +27 -7
  164. package/fesm2022/sdcorejs-angular-pipes.mjs.map +1 -1
  165. package/fesm2022/sdcorejs-angular-services-confirm.mjs +2 -2
  166. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  167. package/fesm2022/sdcorejs-angular-services-date-time.mjs +143 -0
  168. package/fesm2022/sdcorejs-angular-services-date-time.mjs.map +1 -0
  169. package/fesm2022/sdcorejs-angular-services-storage.mjs +44 -8
  170. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  171. package/fesm2022/sdcorejs-angular-services.mjs +1 -0
  172. package/fesm2022/sdcorejs-angular-services.mjs.map +1 -1
  173. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs +4 -0
  174. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs.map +1 -1
  175. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +10 -0
  176. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -1
  177. package/forms/autocomplete/index.d.ts +5 -0
  178. package/forms/chip-calendar/index.d.ts +163 -18
  179. package/forms/date/index.d.ts +23 -2
  180. package/forms/date-range/index.d.ts +24 -2
  181. package/forms/directives/index.d.ts +47 -2
  182. package/forms/index.d.ts +8 -6
  183. package/forms/input/index.d.ts +23 -2
  184. package/forms/input-number/index.d.ts +23 -2
  185. package/forms/models/index.d.ts +38 -3
  186. package/forms/segmented/index.d.ts +90 -0
  187. package/forms/select/index.d.ts +32 -2
  188. package/i18n/index.d.ts +360 -1
  189. package/modules/generic/index.d.ts +316 -0
  190. package/modules/icon/index.d.ts +37 -6
  191. package/modules/index.d.ts +1 -0
  192. package/modules/layout/index.d.ts +536 -86
  193. package/package.json +49 -8
  194. package/pipes/index.d.ts +2 -0
  195. package/services/date-time/index.d.ts +57 -0
  196. package/services/index.d.ts +1 -0
  197. package/services/storage/index.d.ts +8 -1
  198. package/utilities/read-state/index.d.ts +2 -0
  199. package/utilities/theme/index.d.ts +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sdcorejs/angular",
3
- "version": "20.3.0",
3
+ "version": "20.3.2",
4
4
  "description": "Angular component library: data table, query bar/builder, 20+ signal-based form controls, layout, auth and workflow services. Standalone, OnPush, signals-first. Published in parallel lines for Angular 19, 20, 21 and 22.",
5
5
  "keywords": [
6
6
  "angular",
@@ -41,16 +41,29 @@
41
41
  },
42
42
  "dependencies": {
43
43
  "@sdcorejs/angular-material-datetime": "1.0.4",
44
- "@sdcorejs/utils": "1.2.5",
44
+ "@sdcorejs/utils": "1.3.1",
45
45
  "@lucide/angular": "^1.22.0",
46
- "@ckeditor/ckeditor5-angular": "11.1.2",
47
- "ckeditor5": "48.0.0",
48
46
  "date-fns": "^3.6.0",
49
47
  "exceljs": "^4.4.0",
50
48
  "keycloak-js": "^26.0.0",
51
49
  "pdfjs-dist": "^4.10.38",
52
50
  "prismjs": "^1.30.0",
53
- "tslib": "^2.8.0"
51
+ "tslib": "^2.8.0",
52
+ "@tiptap/core": "3.31.4",
53
+ "@tiptap/extension-image": "3.31.4",
54
+ "@tiptap/extension-mention": "3.31.4",
55
+ "@tiptap/extension-subscript": "3.31.4",
56
+ "@tiptap/extension-superscript": "3.31.4",
57
+ "@tiptap/extension-table": "3.31.4",
58
+ "@tiptap/extension-text-align": "3.31.4",
59
+ "@tiptap/extension-text-style": "3.31.4",
60
+ "@tiptap/extensions": "3.31.4",
61
+ "@tiptap/markdown": "3.31.4",
62
+ "@tiptap/pm": "3.31.4",
63
+ "@tiptap/starter-kit": "3.31.4",
64
+ "@tiptap/suggestion": "3.31.4",
65
+ "@floating-ui/dom": "1.8.0",
66
+ "parse5": "7.3.0"
54
67
  },
55
68
  "sideEffects": [
56
69
  "**/*.css",
@@ -58,9 +71,11 @@
58
71
  "./fesm2022/sdcorejs-angular-components-code-editor.mjs",
59
72
  "./fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs"
60
73
  ],
61
- "module": "fesm2022/sdcorejs-angular.mjs",
62
- "typings": "index.d.ts",
63
74
  "exports": {
75
+ "./assets/*": {
76
+ "sass": "./assets/*",
77
+ "default": "./assets/*"
78
+ },
64
79
  "./package.json": {
65
80
  "default": "./package.json"
66
81
  },
@@ -124,6 +139,10 @@
124
139
  "types": "./components/editor/index.d.ts",
125
140
  "default": "./fesm2022/sdcorejs-angular-components-editor.mjs"
126
141
  },
142
+ "./components/editor-engine": {
143
+ "types": "./components/editor-engine/index.d.ts",
144
+ "default": "./fesm2022/sdcorejs-angular-components-editor-engine.mjs"
145
+ },
127
146
  "./components/file-explorer": {
128
147
  "types": "./components/file-explorer/index.d.ts",
129
148
  "default": "./fesm2022/sdcorejs-angular-components-file-explorer.mjs"
@@ -156,6 +175,10 @@
156
175
  "types": "./components/job-progress/index.d.ts",
157
176
  "default": "./fesm2022/sdcorejs-angular-components-job-progress.mjs"
158
177
  },
178
+ "./components/kanban": {
179
+ "types": "./components/kanban/index.d.ts",
180
+ "default": "./fesm2022/sdcorejs-angular-components-kanban.mjs"
181
+ },
159
182
  "./components/mini-editor": {
160
183
  "types": "./components/mini-editor/index.d.ts",
161
184
  "default": "./fesm2022/sdcorejs-angular-components-mini-editor.mjs"
@@ -232,6 +255,10 @@
232
255
  "types": "./components/view/index.d.ts",
233
256
  "default": "./fesm2022/sdcorejs-angular-components-view.mjs"
234
257
  },
258
+ "./components/window": {
259
+ "types": "./components/window/index.d.ts",
260
+ "default": "./fesm2022/sdcorejs-angular-components-window.mjs"
261
+ },
235
262
  "./configurations": {
236
263
  "types": "./configurations/index.d.ts",
237
264
  "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
@@ -308,6 +335,10 @@
308
335
  "types": "./forms/radio/index.d.ts",
309
336
  "default": "./fesm2022/sdcorejs-angular-forms-radio.mjs"
310
337
  },
338
+ "./forms/segmented": {
339
+ "types": "./forms/segmented/index.d.ts",
340
+ "default": "./fesm2022/sdcorejs-angular-forms-segmented.mjs"
341
+ },
311
342
  "./forms/select": {
312
343
  "types": "./forms/select/index.d.ts",
313
344
  "default": "./fesm2022/sdcorejs-angular-forms-select.mjs"
@@ -352,6 +383,10 @@
352
383
  "types": "./modules/auth/index.d.ts",
353
384
  "default": "./fesm2022/sdcorejs-angular-modules-auth.mjs"
354
385
  },
386
+ "./modules/generic": {
387
+ "types": "./modules/generic/index.d.ts",
388
+ "default": "./fesm2022/sdcorejs-angular-modules-generic.mjs"
389
+ },
355
390
  "./modules/icon": {
356
391
  "types": "./modules/icon/index.d.ts",
357
392
  "default": "./fesm2022/sdcorejs-angular-modules-icon.mjs"
@@ -388,6 +423,10 @@
388
423
  "types": "./services/confirm/index.d.ts",
389
424
  "default": "./fesm2022/sdcorejs-angular-services-confirm.mjs"
390
425
  },
426
+ "./services/date-time": {
427
+ "types": "./services/date-time/index.d.ts",
428
+ "default": "./fesm2022/sdcorejs-angular-services-date-time.mjs"
429
+ },
391
430
  "./services/excel": {
392
431
  "types": "./services/excel/index.d.ts",
393
432
  "default": "./fesm2022/sdcorejs-angular-services-excel.mjs"
@@ -444,5 +483,7 @@
444
483
  "types": "./utilities/theme/index.d.ts",
445
484
  "default": "./fesm2022/sdcorejs-angular-utilities-theme.mjs"
446
485
  }
447
- }
486
+ },
487
+ "module": "fesm2022/sdcorejs-angular.mjs",
488
+ "typings": "index.d.ts"
448
489
  }
package/pipes/index.d.ts CHANGED
@@ -4,6 +4,7 @@ import { SafeHtml } from '@angular/platform-browser';
4
4
  import { Observable } from 'rxjs';
5
5
 
6
6
  declare class SdFormatDatePipe implements PipeTransform {
7
+ #private;
7
8
  transform(value: unknown, format?: string): string | null;
8
9
  static ɵfac: i0.ɵɵFactoryDeclaration<SdFormatDatePipe, never>;
9
10
  static ɵpipe: i0.ɵɵPipeDeclaration<SdFormatDatePipe, "sdFormatDate", true>;
@@ -11,6 +12,7 @@ declare class SdFormatDatePipe implements PipeTransform {
11
12
  }
12
13
 
13
14
  declare class SdFormatDatetimePipe implements PipeTransform {
15
+ #private;
14
16
  transform(value: unknown, format?: string): string | null;
15
17
  static ɵfac: i0.ɵɵFactoryDeclaration<SdFormatDatetimePipe, never>;
16
18
  static ɵpipe: i0.ɵɵPipeDeclaration<SdFormatDatetimePipe, "sdFormatDatetime", true>;
@@ -0,0 +1,57 @@
1
+ import { SdTimeZone } from '@sdcorejs/angular/configurations';
2
+ import * as i0 from '@angular/core';
3
+
4
+ /**
5
+ * Converts and parses model dates in the zone of `ISdCoreConfiguration.timeZone`.
6
+ *
7
+ * - An instant (`Z`/offset, `Date`, epoch) shows as the wall clock of the zone.
8
+ * - A zone-less or date-only string keeps its digits and is read as wall clock in the zone.
9
+ * - A carrier is a local `Date` whose fields are a wall clock (what Material pickers hold);
10
+ * `toWallClock` / `fromWallClock` are the only crossings between carriers and model values.
11
+ *
12
+ * With `'local'` (the default) every method returns exactly what `DateUtilities` returns
13
+ * without options.
14
+ */
15
+ declare class SdDateTimeService {
16
+ #private;
17
+ /** The configured zone, resolved once from the root injector. */
18
+ readonly timeZone: SdTimeZone;
19
+ constructor();
20
+ /** Formats a model value; `''` when invalid. */
21
+ toFormat(value: unknown, format: string): string;
22
+ /** Parses a model value to an instant; `null` when invalid. */
23
+ parse(value: unknown): Date | null;
24
+ /** Parses text in `format` as wall clock in the zone; `null` when invalid. */
25
+ parseFrom(value: unknown, format: string): Date | null;
26
+ /** First instant of the value's calendar day. */
27
+ begin(value: unknown): Date | null;
28
+ /** Last millisecond of the value's calendar day. */
29
+ end(value: unknown): Date | null;
30
+ /** First instant of the next calendar day: the exclusive upper bound of a day filter. */
31
+ beginOfNextDay(value: unknown): Date | null;
32
+ /** Carrier of today 00:00 in the zone. */
33
+ today(): Date;
34
+ /** Carrier of the current wall clock in the zone. */
35
+ now(): Date;
36
+ /** Carrier of a model value's wall clock in the zone; `null` when invalid. */
37
+ toWallClock(value: unknown): Date | null;
38
+ /** Instant of a carrier's wall clock in the zone. */
39
+ fromWallClock(value: Date): Date;
40
+ static ɵfac: i0.ɵɵFactoryDeclaration<SdDateTimeService, never>;
41
+ static ɵprov: i0.ɵɵInjectableDeclaration<SdDateTimeService>;
42
+ }
43
+ /**
44
+ * @internal `SdDateTimeService` with `'local'`, for pure helpers that run without an injector (public
45
+ * helpers called directly by consumers, unit tests). Every method equals the service in local mode.
46
+ */
47
+ declare const ɵSD_LOCAL_DATE_TIME: Pick<SdDateTimeService, 'timeZone' | 'toFormat' | 'parse' | 'begin' | 'end' | 'beginOfNextDay'>;
48
+ /**
49
+ * @internal The service inside an injection context, `null` outside one.
50
+ *
51
+ * Pipes call it from a field initializer: created by DI or a template they follow the zone, while
52
+ * `new SdFormatDatePipe()` outside an injection context keeps the local behavior. Only the
53
+ * "no injection context" error (NG0203) is swallowed; an invalid zone still throws.
54
+ */
55
+ declare function ɵsdInjectDateTime(): SdDateTimeService | null;
56
+
57
+ export { SdDateTimeService, ɵSD_LOCAL_DATE_TIME, ɵsdInjectDateTime };
@@ -9,3 +9,4 @@ export * from '@sdcorejs/angular/services/excel';
9
9
  export * from '@sdcorejs/angular/services/viewport';
10
10
  export * from '@sdcorejs/angular/services/unsaved-changes';
11
11
  export * from '@sdcorejs/angular/services/task';
12
+ export * from '@sdcorejs/angular/services/date-time';
@@ -19,11 +19,18 @@ interface SdStorage<T = unknown> {
19
19
  has: () => boolean;
20
20
  remove: () => void;
21
21
  destroy: () => void;
22
+ /**
23
+ * Re-reads the persisted value, bypassing the in-memory entry shared by every live handle of the key.
24
+ * Notifies subscribers only when the value changed and returns the value from that same read.
25
+ */
26
+ refresh: () => T | undefined;
22
27
  subject: BehaviorSubject<T | undefined>;
23
28
  observer: Observable<T | undefined>;
24
29
  }
25
- interface SdStorageWithDefault<T> extends Omit<SdStorage<T>, 'get' | 'subject' | 'observer'> {
30
+ interface SdStorageWithDefault<T> extends Omit<SdStorage<T>, 'get' | 'refresh' | 'subject' | 'observer'> {
26
31
  get: () => T;
32
+ /** Same as `SdStorage.refresh()`, returning the default when nothing is stored. */
33
+ refresh: () => T;
27
34
  subject: BehaviorSubject<T>;
28
35
  observer: Observable<T>;
29
36
  }
@@ -28,6 +28,8 @@ declare class SdReadChannel {
28
28
  constructor(operation: SdReadOperation, changed?: ((state: SdReadState) => void) | undefined);
29
29
  begin(valid?: () => boolean): number;
30
30
  isCurrent(revision: number): boolean;
31
+ /** No read began and nothing invalidated since `revision`, even if its context is no longer valid. */
32
+ isLatest(revision: number): boolean;
31
33
  succeed(revision: number, count: number): boolean;
32
34
  fail(revision: number, error: unknown): boolean;
33
35
  invalidate(): void;
@@ -5,7 +5,7 @@
5
5
  * Token component (`--sd-{component}-{role}`) và thang space/radius/typography… không nằm ở đây: chúng là hook
6
6
  * tuỳ biến, không phải màu nền tảng để app tự dùng.
7
7
  */
8
- declare const SD_COLOR_TOKENS: readonly ["primary", "primary-light", "primary-dark", "primary-contrast", "secondary", "secondary-light", "secondary-dark", "secondary-contrast", "info", "info-light", "info-dark", "info-contrast", "success", "success-light", "success-dark", "success-contrast", "warning", "warning-light", "warning-dark", "warning-contrast", "error", "error-light", "error-dark", "error-contrast", "surface", "surface-muted", "text", "text-secondary", "text-muted", "border", "border-strong", "disabled-bg", "disabled-text", "primary-50", "primary-100", "primary-200", "primary-300", "primary-400", "primary-500", "primary-600", "primary-700", "primary-800", "primary-900", "primary-950", "secondary-50", "secondary-100", "secondary-200", "secondary-300", "secondary-400", "secondary-500", "secondary-600", "secondary-700", "secondary-800", "secondary-900", "secondary-950", "info-50", "info-100", "info-200", "info-300", "info-400", "info-500", "info-600", "info-700", "info-800", "info-900", "info-950", "success-50", "success-100", "success-200", "success-300", "success-400", "success-500", "success-600", "success-700", "success-800", "success-900", "success-950", "warning-50", "warning-100", "warning-200", "warning-300", "warning-400", "warning-500", "warning-600", "warning-700", "warning-800", "warning-900", "warning-950", "error-50", "error-100", "error-200", "error-300", "error-400", "error-500", "error-600", "error-700", "error-800", "error-900", "error-950", "neutral-50", "neutral-100", "neutral-200", "neutral-300", "neutral-400", "neutral-500", "neutral-600", "neutral-700", "neutral-800", "neutral-900", "neutral-950", "status-info-bg", "status-info-fg", "status-success-bg", "status-success-fg", "status-warning-bg", "status-warning-fg", "status-error-bg", "status-error-fg", "link", "surface-inverse", "text-on-solid", "border-focus", "border-danger", "overlay-backdrop", "focus-ring-color"];
8
+ declare const SD_COLOR_TOKENS: readonly ["primary", "primary-light", "primary-dark", "primary-contrast", "secondary", "secondary-light", "secondary-dark", "secondary-contrast", "info", "info-light", "info-dark", "info-contrast", "success", "success-light", "success-dark", "success-contrast", "warning", "warning-light", "warning-dark", "warning-contrast", "error", "error-light", "error-dark", "error-contrast", "surface", "surface-muted", "text", "text-secondary", "text-muted", "border", "border-strong", "disabled-bg", "disabled-text", "primary-50", "primary-100", "primary-200", "primary-300", "primary-400", "primary-500", "primary-600", "primary-700", "primary-800", "primary-900", "primary-950", "secondary-50", "secondary-100", "secondary-200", "secondary-300", "secondary-400", "secondary-500", "secondary-600", "secondary-700", "secondary-800", "secondary-900", "secondary-950", "info-50", "info-100", "info-200", "info-300", "info-400", "info-500", "info-600", "info-700", "info-800", "info-900", "info-950", "success-50", "success-100", "success-200", "success-300", "success-400", "success-500", "success-600", "success-700", "success-800", "success-900", "success-950", "warning-50", "warning-100", "warning-200", "warning-300", "warning-400", "warning-500", "warning-600", "warning-700", "warning-800", "warning-900", "warning-950", "error-50", "error-100", "error-200", "error-300", "error-400", "error-500", "error-600", "error-700", "error-800", "error-900", "error-950", "neutral-50", "neutral-100", "neutral-200", "neutral-300", "neutral-400", "neutral-500", "neutral-600", "neutral-700", "neutral-800", "neutral-900", "neutral-950", "status-info-bg", "status-info-fg", "status-success-bg", "status-success-fg", "status-warning-bg", "status-warning-fg", "status-error-bg", "status-error-fg", "link", "surface-inverse", "text-on-solid", "border-focus", "border-danger", "overlay-backdrop", "overlay-surface", "focus-ring-color", "control-border", "control-border-hover", "control-border-focus", "control-border-disabled", "control-ring", "control-ring-error", "control-bg-disabled"];
9
9
  /** Tên một token màu public của Core UI, ví dụ `'primary'`, `'primary-600'`, `'status-error-fg'`. */
10
10
  type SdColorToken = (typeof SD_COLOR_TOKENS)[number];
11
11
  /**