@sdcorejs/angular 19.3.1 → 19.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 (319) 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 +1 -0
  17. package/components/avatar/src/avatar-group.component.d.ts +43 -0
  18. package/components/avatar/src/avatar.component.d.ts +23 -1
  19. package/components/badge/index.d.ts +2 -0
  20. package/components/badge/src/badge-picker.component.d.ts +148 -0
  21. package/components/badge/src/badge-picker.constants.d.ts +18 -0
  22. package/components/badge/src/badge.component.d.ts +24 -3
  23. package/components/button/src/button.component.d.ts +20 -1
  24. package/components/ckeditor-styles/src/ckeditor-styles.component.d.ts +3 -18
  25. package/components/editor/index.d.ts +1 -0
  26. package/components/editor/src/editor.component.d.ts +17 -15
  27. package/components/editor/src/models/editor.model.d.ts +5 -4
  28. package/components/editor/src/plugins/image-upload/utils/validate.utils.d.ts +5 -2
  29. package/components/editor/src/upload-manager.d.ts +21 -0
  30. package/components/editor-engine/index.d.ts +3 -0
  31. package/components/editor-engine/src/engine/editor-engine.d.ts +68 -0
  32. package/components/editor-engine/src/engine/editor-engine.models.d.ts +51 -0
  33. package/components/editor-engine/src/engine/editor-html-boundary.d.ts +6 -0
  34. package/components/editor-engine/src/engine/editor-schema.d.ts +3 -0
  35. package/components/editor-engine/src/surface/editor-surface.component.d.ts +50 -0
  36. package/components/editor-engine/src/toolbar/editor-button.directive.d.ts +17 -0
  37. package/components/editor-engine/src/toolbar/editor-toolbar.component.d.ts +78 -0
  38. package/components/file-explorer/src/components/actions.component.d.ts +1 -0
  39. package/components/file-explorer/src/file-explorer.model.d.ts +4 -2
  40. package/components/file-explorer/src/file-explorer.utils.d.ts +6 -2
  41. package/components/form-generic/src/components/elements/button-element.component.d.ts +16 -0
  42. package/components/form-generic/src/components/elements/index.d.ts +2 -0
  43. package/components/form-generic/src/components/elements/static-element.component.d.ts +26 -0
  44. package/components/form-generic/src/components/form-builder/canvas/field-preview.component.d.ts +10 -0
  45. package/components/form-generic/src/components/form-builder/form-builder.component.d.ts +9 -4
  46. package/components/form-generic/src/components/form-builder/inspector/inspector.component.d.ts +46 -0
  47. package/components/form-generic/src/components/form-builder/state/builder-document.d.ts +9 -1
  48. package/components/form-generic/src/components/form-builder/state/builder-palette.d.ts +2 -2
  49. package/components/form-generic/src/components/form-builder/state/builder-store.d.ts +13 -1
  50. package/components/form-generic/src/components/form-render/components/item/components/index.d.ts +2 -0
  51. package/components/form-generic/src/components/form-render/components/item/components/json/json.component.d.ts +26 -0
  52. package/components/form-generic/src/components/form-render/components/item/components/time/time.component.d.ts +17 -0
  53. package/components/form-generic/src/components/form-render/form-render.component.d.ts +64 -6
  54. package/components/form-generic/src/models/form-generic-element.model.d.ts +128 -0
  55. package/components/form-generic/src/models/form-generic-field.model.d.ts +5 -1
  56. package/components/form-generic/src/models/form-generic-schema.d.ts +9 -1
  57. package/components/form-generic/src/models/form-generic-schema.model.d.ts +7 -3
  58. package/components/form-generic/src/models/index.d.ts +1 -0
  59. package/components/form-generic/src/rules/form-generic-button.d.ts +21 -0
  60. package/components/form-generic/src/rules/form-generic-display.d.ts +2 -0
  61. package/components/form-generic/src/rules/form-generic-filter.d.ts +21 -3
  62. package/components/form-generic/src/rules/form-generic-url.d.ts +10 -0
  63. package/components/form-generic/src/rules/form-generic-validation.d.ts +13 -0
  64. package/components/history/pipes/view-date.pipe.d.ts +1 -0
  65. package/components/import-excel/src/pipes/column-transform.pipe.d.ts +1 -0
  66. package/components/index.d.ts +1 -0
  67. package/components/mini-editor/index.d.ts +1 -0
  68. package/components/mini-editor/src/mini-editor.component.d.ts +25 -62
  69. package/components/mini-editor/src/mini-editor.model.d.ts +9 -9
  70. package/components/modal-resizable/src/modal-resizable.component.d.ts +3 -121
  71. package/components/operator/index.d.ts +2 -0
  72. package/components/operator/src/operator-chip.component.d.ts +72 -0
  73. package/components/operator/src/operator-items.d.ts +49 -0
  74. package/components/operator/src/operator.component.d.ts +18 -11
  75. package/components/tab-router/src/components/tab-router-item/tab-router-item.component.d.ts +5 -0
  76. package/components/tab-router/src/components/tab-router-list-item/tab-router-list-item.component.d.ts +17 -0
  77. package/components/tab-router/src/components/tab-router-nav/tab-router-nav.component.d.ts +21 -8
  78. package/components/table/src/components/filter/column-filter/column-filter.component.d.ts +7 -0
  79. package/components/table/src/components/unknown-total-paginator/unknown-total-paginator.component.d.ts +52 -0
  80. package/components/table/src/models/table-option-paginate.model.d.ts +14 -0
  81. package/components/table/src/models/table-option.model.d.ts +25 -5
  82. package/components/table/src/services/table-aggregate.util.d.ts +6 -1
  83. package/components/table/src/services/table-export/table-export.service.d.ts +4 -3
  84. package/components/table/src/services/table-filter/table-filter-operator.util.d.ts +16 -0
  85. package/components/table/src/services/table-filter/table-filter.model.d.ts +7 -0
  86. package/components/table/src/services/table-local/table-local-sort.util.d.ts +8 -2
  87. package/components/table/src/services/table-local/table-local.util.d.ts +7 -2
  88. package/components/table/src/services/table-paging/unknown-total.util.d.ts +28 -0
  89. package/components/table/src/table.component.d.ts +16 -0
  90. package/components/window/index.d.ts +1 -0
  91. package/components/window/src/window.component.d.ts +77 -0
  92. package/components/{modal-resizable/src/modal-resizable.registry.d.ts → window/src/window.registry.d.ts} +7 -4
  93. package/configurations/src/sd-core.configuration.d.ts +7 -0
  94. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +5 -5
  95. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  96. package/fesm2022/sdcorejs-angular-components-avatar.mjs +141 -10
  97. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  98. package/fesm2022/sdcorejs-angular-components-badge.mjs +546 -22
  99. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  100. package/fesm2022/sdcorejs-angular-components-button.mjs +32 -2
  101. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  102. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +5 -20
  103. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  104. package/fesm2022/sdcorejs-angular-components-data-state.mjs +1 -1
  105. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  106. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1872 -0
  107. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -0
  108. package/fesm2022/sdcorejs-angular-components-editor.mjs +456 -755
  109. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  110. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +68 -37
  111. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  112. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +2116 -1157
  113. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  114. package/fesm2022/sdcorejs-angular-components-history.mjs +5 -2
  115. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  116. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +1 -1
  117. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -1
  118. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +21 -6
  119. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  120. package/fesm2022/sdcorejs-angular-components-inform.mjs +1 -1
  121. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  122. package/fesm2022/sdcorejs-angular-components-kanban.mjs +12 -2
  123. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -1
  124. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +175 -281
  125. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  126. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +1 -308
  127. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  128. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  129. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  130. package/fesm2022/sdcorejs-angular-components-operator.mjs +261 -42
  131. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  132. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +12 -12
  133. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  134. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +1 -1
  135. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  136. package/fesm2022/sdcorejs-angular-components-section.mjs +2 -2
  137. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  138. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  139. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  140. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +191 -41
  141. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  142. package/fesm2022/sdcorejs-angular-components-table.mjs +564 -110
  143. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  144. package/fesm2022/sdcorejs-angular-components-tree.mjs +1 -1
  145. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  146. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +1 -1
  147. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  148. package/fesm2022/sdcorejs-angular-components-view.mjs +2 -2
  149. package/fesm2022/sdcorejs-angular-components-view.mjs.map +1 -1
  150. package/fesm2022/sdcorejs-angular-components-window.mjs +486 -0
  151. package/fesm2022/sdcorejs-angular-components-window.mjs.map +1 -0
  152. package/fesm2022/sdcorejs-angular-components.mjs +1 -0
  153. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  154. package/fesm2022/sdcorejs-angular-configurations.mjs.map +1 -1
  155. package/fesm2022/sdcorejs-angular-directives.mjs +18 -1
  156. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  157. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +15 -2
  158. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  159. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs +2 -2
  160. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs.map +1 -1
  161. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +459 -124
  162. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  163. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +74 -12
  164. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  165. package/fesm2022/sdcorejs-angular-forms-date.mjs +70 -17
  166. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  167. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +75 -16
  168. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  169. package/fesm2022/sdcorejs-angular-forms-directives.mjs +82 -2
  170. package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
  171. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  172. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  173. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +1 -1
  174. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  175. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +39 -4
  176. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  177. package/fesm2022/sdcorejs-angular-forms-input.mjs +49 -6
  178. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  179. package/fesm2022/sdcorejs-angular-forms-models.mjs +88 -5
  180. package/fesm2022/sdcorejs-angular-forms-models.mjs.map +1 -1
  181. package/fesm2022/sdcorejs-angular-forms-radio.mjs +2 -2
  182. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  183. package/fesm2022/sdcorejs-angular-forms-segmented.mjs +5 -4
  184. package/fesm2022/sdcorejs-angular-forms-segmented.mjs.map +1 -1
  185. package/fesm2022/sdcorejs-angular-forms-select.mjs +62 -14
  186. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  187. package/fesm2022/sdcorejs-angular-forms-switch.mjs +2 -2
  188. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  189. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +2 -2
  190. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  191. package/fesm2022/sdcorejs-angular-forms-time.mjs +2 -2
  192. package/fesm2022/sdcorejs-angular-forms-time.mjs.map +1 -1
  193. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  194. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  195. package/fesm2022/sdcorejs-angular-i18n.mjs +1535 -22
  196. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  197. package/fesm2022/sdcorejs-angular-interceptors.mjs +1 -1
  198. package/fesm2022/sdcorejs-angular-interceptors.mjs.map +1 -1
  199. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs +478 -0
  200. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs.map +1 -0
  201. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs +214 -0
  202. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs.map +1 -0
  203. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs +277 -0
  204. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs.map +1 -0
  205. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs +1556 -0
  206. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs.map +1 -0
  207. package/fesm2022/sdcorejs-angular-modules-generic.mjs +2 -0
  208. package/fesm2022/sdcorejs-angular-modules-generic.mjs.map +1 -0
  209. package/fesm2022/sdcorejs-angular-modules-icon.mjs +96 -3
  210. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  211. package/fesm2022/sdcorejs-angular-modules-layout.mjs +1822 -59
  212. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  213. package/fesm2022/sdcorejs-angular-modules.mjs +1 -0
  214. package/fesm2022/sdcorejs-angular-modules.mjs.map +1 -1
  215. package/fesm2022/sdcorejs-angular-pipes.mjs +27 -7
  216. package/fesm2022/sdcorejs-angular-pipes.mjs.map +1 -1
  217. package/fesm2022/sdcorejs-angular-services-confirm.mjs +1 -1
  218. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  219. package/fesm2022/sdcorejs-angular-services-date-time.mjs +143 -0
  220. package/fesm2022/sdcorejs-angular-services-date-time.mjs.map +1 -0
  221. package/fesm2022/sdcorejs-angular-services-storage.mjs +44 -8
  222. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  223. package/fesm2022/sdcorejs-angular-services.mjs +1 -0
  224. package/fesm2022/sdcorejs-angular-services.mjs.map +1 -1
  225. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs +4 -0
  226. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs.map +1 -1
  227. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +10 -0
  228. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -1
  229. package/forms/autocomplete/src/autocomplete.component.d.ts +5 -0
  230. package/forms/chip-calendar/src/chip-calendar-header.component.d.ts +17 -0
  231. package/forms/chip-calendar/src/chip-calendar.component.d.ts +147 -19
  232. package/forms/date/src/date.component.d.ts +23 -2
  233. package/forms/date-range/src/date-range.component.d.ts +24 -2
  234. package/forms/datetime/src/datetime-time-zone.adapter.d.ts +15 -0
  235. package/forms/directives/index.d.ts +1 -0
  236. package/forms/directives/src/search-field.component.d.ts +45 -0
  237. package/forms/input/src/input.component.d.ts +23 -2
  238. package/forms/input-number/src/input-number.component.d.ts +23 -2
  239. package/forms/models/index.d.ts +1 -0
  240. package/forms/models/src/sd-calendar-day.d.ts +22 -0
  241. package/forms/models/src/sd-model-facing-control.d.ts +3 -1
  242. package/forms/models/src/sd-strict-date-adapter.d.ts +3 -0
  243. package/forms/models/src/sd-temporal-transform.d.ts +7 -0
  244. package/forms/select/src/select.component.d.ts +33 -4
  245. package/i18n/src/en.d.ts +302 -2
  246. package/modules/generic/index.d.ts +4 -0
  247. package/modules/generic/src/components/configuration-form/generic-configuration-form.component.d.ts +33 -0
  248. package/modules/generic/src/components/configuration-general/generic-configuration-general.component.d.ts +28 -0
  249. package/modules/generic/src/components/configuration-import/generic-configuration-import.component.d.ts +27 -0
  250. package/modules/generic/src/components/configuration-list/generic-configuration-list.component.d.ts +39 -0
  251. package/modules/generic/src/components/import-dialog/generic-import-dialog.component.d.ts +15 -0
  252. package/modules/generic/src/components/property-identity/generic-property-identity.component.d.ts +15 -0
  253. package/modules/generic/src/core/generic-columns.d.ts +19 -0
  254. package/modules/generic/src/core/generic-defaults.d.ts +14 -0
  255. package/modules/generic/src/core/generic-form.d.ts +17 -0
  256. package/modules/generic/src/core/generic-import.d.ts +49 -0
  257. package/modules/generic/src/core/generic-merge.d.ts +21 -0
  258. package/modules/generic/src/core/generic-permission.d.ts +3 -0
  259. package/modules/generic/src/core/generic-property-icon.d.ts +8 -0
  260. package/modules/generic/src/core/generic-search.d.ts +19 -0
  261. package/modules/generic/src/core/generic-title.d.ts +11 -0
  262. package/modules/generic/src/core/generic-validate.d.ts +8 -0
  263. package/modules/generic/src/core/index.d.ts +10 -0
  264. package/modules/generic/src/models/generic-adapter.model.d.ts +49 -0
  265. package/modules/generic/src/models/generic-entity.model.d.ts +71 -0
  266. package/modules/generic/src/models/generic-issue.model.d.ts +29 -0
  267. package/modules/generic/src/models/generic-schema.model.d.ts +133 -0
  268. package/modules/generic/src/models/index.d.ts +4 -0
  269. package/modules/generic/src/pages/configuration/generic-configuration.page.d.ts +26 -0
  270. package/modules/generic/src/pages/form/generic-form-host.page.d.ts +42 -0
  271. package/modules/generic/src/pages/list/generic-list.page.d.ts +39 -0
  272. package/modules/generic/src/registry/generic-registry.d.ts +35 -0
  273. package/modules/generic/src/registry/index.d.ts +2 -0
  274. package/modules/generic/src/registry/provide-sd-generic.d.ts +15 -0
  275. package/modules/generic/src/routes/generic-route.guards.d.ts +24 -0
  276. package/modules/generic/src/routes/sd-generic.routes.d.ts +10 -0
  277. package/modules/generic/src/services/generic-configuration-store.d.ts +13 -0
  278. package/modules/generic/src/services/generic-data.service.d.ts +34 -0
  279. package/modules/generic/src/services/generic-import.service.d.ts +21 -0
  280. package/modules/generic/src/services/generic-permission.service.d.ts +26 -0
  281. package/modules/generic/src/services/generic-relation-catalog.d.ts +14 -0
  282. package/modules/generic/src/services/generic-schema.service.d.ts +28 -0
  283. package/modules/generic/src/services/index.d.ts +6 -0
  284. package/modules/icon/src/data-type-icon.d.ts +30 -0
  285. package/modules/icon/src/icon.model.d.ts +2 -1
  286. package/modules/icon/src/index.d.ts +1 -0
  287. package/modules/index.d.ts +1 -0
  288. package/modules/layout/components/index.d.ts +3 -0
  289. package/modules/layout/components/layout-main/layout-main.component.d.ts +2 -1
  290. package/modules/layout/components/shared/context-switcher/context-switcher.component.d.ts +71 -0
  291. package/modules/layout/components/shared/user-menu/user-menu.component.d.ts +1 -1
  292. package/modules/layout/components/sidebar-mobile-v4/main.component.d.ts +95 -0
  293. package/modules/layout/components/sidebar-v1/components/sidebar/sidebar.component.d.ts +1 -0
  294. package/modules/layout/components/sidebar-v3/main.component.d.ts +3 -0
  295. package/modules/layout/components/sidebar-v4/main.component.d.ts +69 -0
  296. package/modules/layout/components/sidebar-v4/menu-tree/sidebar-v4-menu-tree.component.d.ts +174 -0
  297. package/modules/layout/configurations/layout.configuration.d.ts +46 -1
  298. package/modules/layout/services/context/context.model.d.ts +16 -0
  299. package/modules/layout/services/context/context.runtime.d.ts +14 -0
  300. package/modules/layout/services/context/context.service.d.ts +54 -0
  301. package/modules/layout/services/context/index.d.ts +3 -0
  302. package/modules/layout/services/index.d.ts +1 -0
  303. package/modules/layout/services/menu/menu.model.d.ts +33 -0
  304. package/modules/layout/services/menu/menu.utils.d.ts +32 -1
  305. package/modules/layout/services/storage/storage.service.d.ts +20 -1
  306. package/package.json +45 -12
  307. package/pipes/src/format-date.pipe.d.ts +1 -0
  308. package/pipes/src/format-datetime.pipe.d.ts +1 -0
  309. package/services/date-time/index.d.ts +1 -0
  310. package/services/date-time/src/date-time.service.d.ts +54 -0
  311. package/services/index.d.ts +1 -0
  312. package/services/storage/src/storage.model.d.ts +8 -1
  313. package/utilities/read-state/src/read-state.d.ts +2 -0
  314. package/utilities/theme/src/theme-tokens.d.ts +1 -1
  315. package/components/editor/src/plugins/image-upload/image-upload.plugin.d.ts +0 -22
  316. package/components/editor/src/plugins/image-upload/utils/batch.utils.d.ts +0 -14
  317. package/components/editor/src/plugins/image-upload/utils/index.d.ts +0 -3
  318. package/forms/chip-calendar/src/pipes/index.d.ts +0 -1
  319. package/forms/chip-calendar/src/pipes/removable-chip.pipe.d.ts +0 -8
@@ -0,0 +1,69 @@
1
+ import { ResolvedSidebarRecentConfiguration, SdLayoutUserInfo, SidebarConfigurationV4 } from '../../configurations';
2
+ import { SdLayoutMenu } from '../../services';
3
+ import * as i0 from "@angular/core";
4
+ /** `SidebarConfigurationV4` as `normalizeSidebarConfiguration` returns it: every V4 default is filled (INV-012). */
5
+ type SdSidebarV4ResolvedConfiguration = SidebarConfigurationV4 & Required<Pick<SidebarConfigurationV4, 'defaultCollapsed' | 'itemShape' | 'density' | 'collapsedGroup'>> & {
6
+ recent: ResolvedSidebarRecentConfiguration;
7
+ };
8
+ /**
9
+ * Sidebar V4 desktop shell: a 280px drawer (72px rail when collapsed) with the brand header and Context Switcher,
10
+ * a pill search (`Ctrl+K` / `⌘K`), Pinned and Recent shortcuts, the V4 menu tree and the account footer.
11
+ * Routed content is projected into `<main>`.
12
+ *
13
+ * Routing, recent/pinned handling and the collapse preference behave like `sd-sidebar-v3`; the collapsed state is
14
+ * stored in the same version 3 entry (D-004). Options are read only after `normalizeSidebarConfiguration` (INV-012);
15
+ * `brandColor` / `brandLightColor` are ignored. Size tokens (`--sd-sidebar-v4-width`, `-rail-width`, `-item-height`,
16
+ * `-child-height`, `-item-radius`) are declared on the host and follow `density`, `itemShape` and the pointer type.
17
+ */
18
+ export declare class SdSidebarV4 {
19
+ #private;
20
+ private readonly searchInput;
21
+ private readonly list;
22
+ private readonly mainTree;
23
+ private readonly headerSwitcher;
24
+ menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
25
+ userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
26
+ sidebar: import("@angular/core").InputSignal<SidebarConfigurationV4>;
27
+ /** `sidebar()` with the V4 defaults filled by `normalizeSidebarConfiguration`, the only place they are resolved (INV-012). */
28
+ protected readonly configuration: import("@angular/core").Signal<SdSidebarV4ResolvedConfiguration>;
29
+ isCollapsed: import("@angular/core").WritableSignal<boolean>;
30
+ protected readonly collapsedGroupKeys: import("@angular/core").WritableSignal<string[]>;
31
+ searchText: import("@angular/core").WritableSignal<string>;
32
+ activePath: import("@angular/core").WritableSignal<string>;
33
+ /** Search results in the order the tree renders its options (accent-insensitive, without `comingSoon` items). */
34
+ protected readonly searchResults: import("@angular/core").Signal<import("./menu-tree/sidebar-v4-menu-tree.component").SdSidebarV4SearchResult[]>;
35
+ /** Index of the keyboard-selected result: the first one when results appear, -1 when there is none. */
36
+ protected readonly focusedResultIndex: import("@angular/core").Signal<number>;
37
+ recentConfiguration: import("@angular/core").Signal<{
38
+ enabled?: boolean;
39
+ maxItems?: number;
40
+ } & ResolvedSidebarRecentConfiguration>;
41
+ pinnedKeys: import("@angular/core").WritableSignal<string[]>;
42
+ pinnedMenus: import("@angular/core").Signal<(import("@sdcorejs/angular/modules/layout").SdLayoutRootMenu | import("@sdcorejs/angular/modules/layout").SdLayoutChildrenMenu)[]>;
43
+ recentMenus: import("@angular/core").Signal<(import("@sdcorejs/angular/modules/layout").SdLayoutRootMenu | import("@sdcorejs/angular/modules/layout").SdLayoutChildrenMenu)[]>;
44
+ protected readonly hasQuery: import("@angular/core").Signal<boolean>;
45
+ protected readonly title: import("@angular/core").Signal<string>;
46
+ protected readonly logoInitial: import("@angular/core").Signal<string>;
47
+ /** The hierarchy starts with items that have no section heading. */
48
+ protected readonly leadsWithUnsectioned: import("@angular/core").Signal<boolean>;
49
+ protected readonly shortcutHint: string;
50
+ protected readonly shortcutKeys: string;
51
+ /** The header Context Switcher popover is open; the whole header then takes the hover background (README CS1). */
52
+ protected readonly contextOpen: import("@angular/core").Signal<boolean>;
53
+ constructor();
54
+ /** Collapses or expands the drawer and stores the choice in the version 3 entry, like V3 (D-004). */
55
+ toggleCollapsed(): void;
56
+ /** Expands a collapsed drawer, then moves focus to the menu search. */
57
+ focusSearch(): void;
58
+ /** Collapsed rail: a leaf navigates; a group expands the drawer and opens that group, like V3. */
59
+ activateCollapsedMenu(menu: SdLayoutMenu): void;
60
+ navigateMenu(menu: SdLayoutMenu): void;
61
+ onTogglePinned(menu: SdLayoutMenu): void;
62
+ protected onSearchInput(event: Event): void;
63
+ protected clearSearch(): void;
64
+ protected onSearchKeydown(event: KeyboardEvent): void;
65
+ protected onDocumentKeydown(event: KeyboardEvent): void;
66
+ static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarV4, never>;
67
+ static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarV4, "sd-sidebar-v4", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
68
+ }
69
+ export {};
@@ -0,0 +1,174 @@
1
+ import { CdkConnectedOverlay, ConnectedPosition } from '@angular/cdk/overlay';
2
+ import { SdLayoutMenu, SdLayoutMenuTrailing, SdLayoutRootMenu } from '../../../services';
3
+ import * as i0 from "@angular/core";
4
+ /** One row of the V4 search results, in the order `buildSidebarV4SearchResults` returns them. */
5
+ export interface SdSidebarV4SearchResult {
6
+ /** `getMenuStableKey(menu)` of the leaf. */
7
+ key: string;
8
+ menu: SdLayoutRootMenu;
9
+ /** Ancestor titles joined with " / ", or the top-level `section` for a root leaf; empty when neither exists. */
10
+ path: string;
11
+ }
12
+ export type SdSidebarV4MenuTreePresentation = 'hierarchy' | 'shortcuts' | 'results';
13
+ export type SdSidebarV4MenuTreeMode = 'expanded' | 'collapsed' | 'mobile';
14
+ /**
15
+ * Accent-insensitive V4 search over `menus` (via `searchAvailableMenuLeaves`, so `comingSoon` items and everything under a
16
+ * `comingSoon` group are left out) with the parent path of every hit. A blank query returns no rows.
17
+ * The `results` presentation renders exactly this list, so a parent's keyboard index matches the rendered options.
18
+ */
19
+ export declare function buildSidebarV4SearchResults(menus: SdLayoutMenu[], query: string): SdSidebarV4SearchResult[];
20
+ interface SdSidebarV4TreeNode {
21
+ menu: SdLayoutMenu;
22
+ key: string;
23
+ title: string;
24
+ depth: number;
25
+ isGroup: boolean;
26
+ isExpanded: boolean;
27
+ isActive: boolean;
28
+ /** Closed group that contains the active route. */
29
+ showActiveDot: boolean;
30
+ /** `comingSoon`: aria-disabled, never navigates, a group never expands. */
31
+ disabled: boolean;
32
+ trailing: SdLayoutMenuTrailing | null;
33
+ /** Indent of a nested row container: 32px for depth 1, +16px per further level. */
34
+ paddingLeft: number;
35
+ /** Left offsets of the 1px branch rails, one per ancestor level. */
36
+ branchOffsets: number[];
37
+ markerLeft: number;
38
+ pinnable: boolean;
39
+ isPinned: boolean;
40
+ /** Accessible name of the pin toggle, already i18n-resolved with the title interpolated. */
41
+ pinLabel: string;
42
+ }
43
+ interface SdSidebarV4TreeSection {
44
+ key: string;
45
+ label: string | null;
46
+ labelId: string;
47
+ /** Unsectioned group that follows a sectioned one; spaced so it does not read as part of that section. */
48
+ separated: boolean;
49
+ nodes: SdSidebarV4TreeNode[];
50
+ }
51
+ interface SdSidebarV4ShortcutRow {
52
+ menu: SdLayoutRootMenu;
53
+ key: string;
54
+ title: string;
55
+ path: string;
56
+ isActive: boolean;
57
+ disabled: boolean;
58
+ isPinned: boolean;
59
+ pinLabel: string;
60
+ }
61
+ interface SdSidebarV4TextSegment {
62
+ text: string;
63
+ match: boolean;
64
+ }
65
+ interface SdSidebarV4ResultRow extends SdSidebarV4SearchResult {
66
+ segments: SdSidebarV4TextSegment[];
67
+ }
68
+ interface SdSidebarV4RailItem {
69
+ menu: SdLayoutMenu;
70
+ key: string;
71
+ title: string;
72
+ isGroup: boolean;
73
+ isActive: boolean;
74
+ disabled: boolean;
75
+ badge: {
76
+ value: number | string;
77
+ tone: 'warning' | 'error';
78
+ } | null;
79
+ liveTone: 'success' | 'warning' | 'error' | null;
80
+ descriptionId: string;
81
+ /**
82
+ * Warning/error badge ("3 pending") or live status label, read out after the title; the visual mark is aria-hidden.
83
+ * Like the README D4 mock, a neutral count is neither shown nor announced on the rail.
84
+ */
85
+ description: string;
86
+ }
87
+ interface SdSidebarV4RailGroup {
88
+ key: string;
89
+ items: SdSidebarV4RailItem[];
90
+ }
91
+ /**
92
+ * Private menu tree of sidebar V4 (D-014, D-023): imported only by `sd-sidebar-v4` and `sd-sidebar-mobile-v4`, never exported
93
+ * from a public index. Navigation is the parent's job — the tree only emits.
94
+ *
95
+ * Inputs
96
+ * - `menus`: what to render. `hierarchy`: the full tree; `shortcuts`: the pinned or recent menus; `results`: the full tree
97
+ * searched with `query` (the rendered options are exactly `results()` / `buildSidebarV4SearchResults(menus, query)`).
98
+ * - `pathSource`: full tree used for parent paths and the active route when `menus` is a subset (shortcuts); defaults to `menus`.
99
+ * - `activePath`: current route path; the most exact matching menu is active (`resolveActiveMenuPath`).
100
+ * - `presentation`: `hierarchy` (sections, groups, branch rails) | `shortcuts` (flat "title · path" rows) | `results` (search).
101
+ * - `mode`: `expanded` | `collapsed` (72px rail; hierarchy only) | `mobile` (hierarchy with 44px fallbacks, pin always shown).
102
+ * Row sizes come from `--sd-sidebar-v4-item-height`, `--sd-sidebar-v4-child-height` and `--sd-sidebar-v4-item-radius`
103
+ * set by the parent (fallbacks 36px / 32px / 999px, or 44px in mobile mode).
104
+ * - `collapsedGroupKeys` (two-way): stable keys of closed groups — same keys and semantics as the V3 tree.
105
+ * - `pinnedKeys`, `showPin`: pin toggles on leaf rows (hierarchy) and the unpin toggle on shortcut rows.
106
+ * - `collapsedGroup`: rail group click opens a flyout (`flyout`) or emits `expandGroup` (`expand`). The flyout closes on
107
+ * navigation, Escape or a click outside it (that click still reaches its target, e.g. another rail item).
108
+ * - `query`, `focusedIndex`: search text and the keyboard-selected option of the `results` presentation.
109
+ *
110
+ * Outputs: `navigate` (root/leaf rows, never `comingSoon`), `togglePinned`, `expandGroup`.
111
+ * The host is not a landmark; the parent wraps the tree in its `<nav>`. It always holds a polite live region that announces
112
+ * the result count (or the no-match message) while the `results` presentation has a query — keep the same tree instance
113
+ * mounted while switching presentations so the change is announced.
114
+ * The collapsed rail shows (and announces) only warning/error badges and live status dots; neutral counts stay off the rail.
115
+ */
116
+ export declare class SdSidebarV4MenuTree {
117
+ #private;
118
+ /** Menus to render; see the class description for what each presentation expects. */
119
+ menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
120
+ /** Full menu tree for parent paths and the active route when `menus` is a subset; empty means `menus`. */
121
+ pathSource: import("@angular/core").InputSignal<SdLayoutMenu[]>;
122
+ /** Current route path without query or fragment. */
123
+ activePath: import("@angular/core").InputSignal<string>;
124
+ presentation: import("@angular/core").InputSignal<SdSidebarV4MenuTreePresentation>;
125
+ mode: import("@angular/core").InputSignal<SdSidebarV4MenuTreeMode>;
126
+ /** Stable keys of closed groups (default: every group open), shared two-way with the parent. */
127
+ collapsedGroupKeys: import("@angular/core").ModelSignal<string[]>;
128
+ pinnedKeys: import("@angular/core").InputSignal<string[]>;
129
+ showPin: import("@angular/core").InputSignal<boolean>;
130
+ /** What a group click does on the collapsed rail. */
131
+ collapsedGroup: import("@angular/core").InputSignal<"flyout" | "expand">;
132
+ /** Search text of the `results` presentation. */
133
+ query: import("@angular/core").InputSignal<string>;
134
+ /** Index in `results()` of the keyboard-selected option; -1 for none. */
135
+ focusedIndex: import("@angular/core").InputSignal<number>;
136
+ /** A root or leaf row was activated (never a `comingSoon` item). */
137
+ navigate: import("@angular/core").OutputEmitterRef<SdLayoutRootMenu>;
138
+ togglePinned: import("@angular/core").OutputEmitterRef<SdLayoutMenu>;
139
+ /** A rail group was clicked with `collapsedGroup: 'expand'`; the parent expands the sidebar and opens that group. */
140
+ expandGroup: import("@angular/core").OutputEmitterRef<SdLayoutMenu>;
141
+ /** Id of the results listbox, for the parent's `aria-controls`. */
142
+ readonly resultsId: string;
143
+ protected readonly resultCountId: string;
144
+ protected readonly flyoutPositions: ConnectedPosition[];
145
+ protected readonly flyoutKey: import("@angular/core").Signal<string | null>;
146
+ protected readonly flyoutRadius: import("@angular/core").WritableSignal<string | null>;
147
+ protected readonly isRail: import("@angular/core").Signal<boolean>;
148
+ /** Rows of the `results` presentation, in render order. */
149
+ readonly results: import("@angular/core").Signal<SdSidebarV4SearchResult[]>;
150
+ protected readonly sections: import("@angular/core").Signal<SdSidebarV4TreeSection[]>;
151
+ protected readonly shortcuts: import("@angular/core").Signal<SdSidebarV4ShortcutRow[]>;
152
+ protected readonly resultRows: import("@angular/core").Signal<SdSidebarV4ResultRow[]>;
153
+ /** Text of the always-mounted polite live region: the result count, or the no-match message, while searching. */
154
+ protected readonly liveMessage: import("@angular/core").Signal<string>;
155
+ protected readonly railGroups: import("@angular/core").Signal<SdSidebarV4RailGroup[]>;
156
+ protected readonly flyoutNodes: import("@angular/core").Signal<SdSidebarV4TreeNode[]>;
157
+ constructor();
158
+ /** Id of the result option at `index`, for the parent's `aria-activedescendant`. */
159
+ resultOptionId(index: number): string;
160
+ /** Closes the collapsed-rail flyout; focus returns to its group button unless `restoreFocus` is false. */
161
+ closeFlyout(restoreFocus?: boolean): void;
162
+ protected onNavigate(menu: SdLayoutMenu): void;
163
+ protected onToggleGroup(node: SdSidebarV4TreeNode): void;
164
+ protected onTogglePinned(event: MouseEvent, menu: SdLayoutMenu): void;
165
+ protected onRailGroup(item: SdSidebarV4RailItem, trigger: HTMLElement): void;
166
+ protected onFlyoutNavigate(node: SdSidebarV4TreeNode): void;
167
+ protected onFlyoutAttach(overlay: CdkConnectedOverlay): void;
168
+ protected onFlyoutKeydown(event: KeyboardEvent): void;
169
+ protected onFlyoutOutsideClick(): void;
170
+ protected onFlyoutDetach(key: string): void;
171
+ static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarV4MenuTree, never>;
172
+ static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarV4MenuTree, "sd-sidebar-v4-menu-tree", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "pathSource": { "alias": "pathSource"; "required": false; "isSignal": true; }; "activePath": { "alias": "activePath"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "collapsedGroupKeys": { "alias": "collapsedGroupKeys"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "showPin": { "alias": "showPin"; "required": false; "isSignal": true; }; "collapsedGroup": { "alias": "collapsedGroup"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "focusedIndex": { "alias": "focusedIndex"; "required": false; "isSignal": true; }; }, { "collapsedGroupKeys": "collapsedGroupKeysChange"; "navigate": "navigate"; "togglePinned": "togglePinned"; "expandGroup": "expandGroup"; }, never, never, true, never>;
173
+ }
174
+ export {};
@@ -71,6 +71,30 @@ export interface SdLayoutUserInfo {
71
71
  role?: SdLayoutUserRole;
72
72
  }
73
73
  export declare const DEFAULT_LAYOUT_MOBILE_BREAKPOINT = 1024;
74
+ /** A context the signed-in user can switch between (for example a store or a legal entity). */
75
+ export interface SdLayoutContext {
76
+ /** Stable identifier that Core persists and matches against the configured `items`. */
77
+ id: string;
78
+ /** Display name shown in the switcher. */
79
+ title: string;
80
+ /** Secondary line shown below the title. */
81
+ subtitle?: string;
82
+ /** Avatar image URL; the initial of `title` is shown when it is missing or fails to load. */
83
+ avatar?: string;
84
+ }
85
+ /**
86
+ * Context switcher configuration shared by sidebar versions 1–4.
87
+ * The consumer only assigns `items`; Core persists and restores the current context and reloads the page after a switch.
88
+ * Read the current context with `SdLayoutContextService.getCurrentContext()`.
89
+ */
90
+ export interface SdLayoutContextConfiguration {
91
+ /** Name of the context kind shown in the switcher. Defaults to the translated "Context" label. */
92
+ label?: string;
93
+ /** Contexts the user can switch between. An empty list hides the switcher. */
94
+ items: SdLayoutContext[];
95
+ /** Forces the search box on or off. By default it is shown when there are more than 7 items. */
96
+ searchable?: boolean;
97
+ }
74
98
  export interface SidebarConfigurationBase {
75
99
  brandColor?: string;
76
100
  brandLightColor?: string;
@@ -79,8 +103,14 @@ export interface SidebarConfigurationBase {
79
103
  pin?: {
80
104
  enabled?: boolean;
81
105
  };
106
+ /**
107
+ * Context switcher rendered in the sidebar header. The consumer only assigns `items`;
108
+ * Core persists and restores the current context and reloads the page on switch.
109
+ * Read it with `SdLayoutContextService.getCurrentContext()`.
110
+ */
111
+ context?: SdLayoutContextConfiguration;
82
112
  }
83
- export type ISdSidebarConfiguration = SidebarConfigurationV1 | SidebarConfigurationV2 | SidebarConfigurationV3;
113
+ export type ISdSidebarConfiguration = SidebarConfigurationV1 | SidebarConfigurationV2 | SidebarConfigurationV3 | SidebarConfigurationV4;
84
114
  export interface SidebarConfigurationV1 extends SidebarConfigurationBase {
85
115
  version: 1;
86
116
  /**
@@ -127,6 +157,20 @@ export interface SidebarConfigurationV3 extends SidebarConfigurationBase {
127
157
  maxItems?: number;
128
158
  };
129
159
  }
160
+ /** Sidebar V4: V3 behaviour (collapse, pinned, recent) with token-driven colours; `brandColor`/`brandLightColor` are ignored. */
161
+ export interface SidebarConfigurationV4 extends Omit<SidebarConfigurationV3, 'version'> {
162
+ version: 4;
163
+ /** Shape of the active/hover item highlight. @default 'pill' */
164
+ itemShape?: 'pill' | 'soft';
165
+ /** Row height: `compact` 36/32px, `comfortable` 40/34px. @default 'compact' */
166
+ density?: 'compact' | 'comfortable';
167
+ /** How a group opens while the rail is collapsed. @default 'flyout' */
168
+ collapsedGroup?: 'flyout' | 'expand';
169
+ /** Mobile shell options. `bottomBar` lists at most 4 menu ids shown in the bottom navigation bar. */
170
+ mobile?: {
171
+ bottomBar?: string[];
172
+ };
173
+ }
130
174
  export interface ResolvedSidebarRecentConfiguration {
131
175
  enabled: boolean;
132
176
  maxItems: number;
@@ -137,4 +181,5 @@ export declare function resolveSidebarV3Recent(sidebar: SidebarConfigurationV3):
137
181
  export declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV1): SidebarConfigurationV1;
138
182
  export declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV2): SidebarConfigurationV2;
139
183
  export declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV3): SidebarConfigurationV3;
184
+ export declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV4): SidebarConfigurationV4;
140
185
  export declare const SD_LAYOUT_CONFIGURATION: InjectionToken<ISdLayoutConfiguration>;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Browser effects used by `SdLayoutContextService`. The default implementation wraps the document window;
3
+ * provide `SD_LAYOUT_CONTEXT_RUNTIME` with a fake in specs and demos so nothing reloads for real.
4
+ */
5
+ export interface SdLayoutContextRuntime {
6
+ /** Reloads the page. */
7
+ reload(): void;
8
+ /** Subscribes to cross-tab localStorage changes (window 'storage' events); returns an unsubscribe function. */
9
+ onStorage(listener: () => void): () => void;
10
+ /** Per-tab reconcile marker; `undefined` when session storage is unavailable. */
11
+ readMarker(): string | null | undefined;
12
+ /** Writes the marker (`null` clears it); returns false when it could not be persisted. */
13
+ writeMarker(value: string | null): boolean;
14
+ }
15
+ /** Session storage key of the per-tab reconcile marker (id of the last context reconcile reload target). */
16
+ export declare const SD_LAYOUT_CONTEXT_MARKER_KEY = "sd.layout.context.reconcile-marker";
@@ -0,0 +1,14 @@
1
+ import { InjectionToken } from '@angular/core';
2
+ import { SdLayoutContextRuntime } from './context.model';
3
+ /**
4
+ * Browser effects of the layout context feature: page reload, cross-tab `storage` events and the
5
+ * per-tab reconcile marker. Defaults to the document window; provide a fake `SdLayoutContextRuntime`
6
+ * in specs and demos so nothing reloads for real:
7
+ *
8
+ * ```ts
9
+ * providers: [{ provide: SD_LAYOUT_CONTEXT_RUNTIME, useValue: fakeRuntime }];
10
+ * ```
11
+ */
12
+ export declare const SD_LAYOUT_CONTEXT_RUNTIME: InjectionToken<SdLayoutContextRuntime>;
13
+ /** Creates the default runtime over `view`; without a window every operation is a no-op. */
14
+ export declare function createSdLayoutContextBrowserRuntime(view: Window | null): SdLayoutContextRuntime;
@@ -0,0 +1,54 @@
1
+ import { SdLayoutContext } from '../../configurations';
2
+ import * as i0 from "@angular/core";
3
+ /**
4
+ * Owns the current layout context (for example a store or a legal entity) and its persisted snapshot.
5
+ *
6
+ * The snapshot is captured once, when the service is first injected, so `SD_LAYOUT_STORAGE_NAMESPACE`
7
+ * must already resolve at that moment (see `sd-layout.md`). Switching reloads the page — there is no
8
+ * change event. Read the context during bootstrap:
9
+ *
10
+ * ```ts
11
+ * provideAppInitializer(() => {
12
+ * const context = inject(SdLayoutContextService).getCurrentContext();
13
+ * inject(ApiContextHeader).set(context?.id);
14
+ * });
15
+ * ```
16
+ *
17
+ * The service works without `SD_LAYOUT_CONFIGURATION`; the context switcher passes the configured items to
18
+ * `syncItems()`, which reconciles the snapshot. A reconcile reload happens at most once per target id
19
+ * while the per-tab marker holds that id.
20
+ */
21
+ export declare class SdLayoutContextService {
22
+ #private;
23
+ /** Context of this page load; title, subtitle and avatar may refresh from the configured items. */
24
+ readonly current: import("@angular/core").Signal<SdLayoutContext | null>;
25
+ /** Valid items last passed to `syncItems()` (entries without `id`/`title` and duplicate ids are dropped). */
26
+ readonly items: import("@angular/core").Signal<readonly SdLayoutContext[]>;
27
+ /** Id of the context being switched to, or `null`. */
28
+ readonly switchingId: import("@angular/core").Signal<string | null>;
29
+ /** `true` when the last switch could not be persisted (no reload happened). */
30
+ readonly switchFailed: import("@angular/core").Signal<boolean>;
31
+ /** `true` when another tab switched the stored context; this tab keeps its context until reloaded. */
32
+ readonly changedElsewhere: import("@angular/core").Signal<boolean>;
33
+ constructor();
34
+ /** Returns a copy of the current context, or `null` before any context was stored. */
35
+ getCurrentContext(): SdLayoutContext | null;
36
+ /**
37
+ * Switches to the item with `id`, then reloads the page once the snapshot is confirmed in storage.
38
+ * Ignored for the active id, before `syncItems()`, for ids that are not in `items` and once a reload
39
+ * was requested in this page load.
40
+ */
41
+ setCurrentContext(id: string): void;
42
+ /**
43
+ * Reconciles the stored snapshot with the configured items: a valid id only refreshes its metadata;
44
+ * a missing or stale id falls back to `items[0]` and reloads, unless the per-tab marker already holds
45
+ * that target. Empty items store nothing. While the load-time context is still in `items`, a different
46
+ * stored id only raises `changedElsewhere` and a removed snapshot keeps the context in memory.
47
+ * Repeated calls with the same items neither write nor reload again.
48
+ */
49
+ syncItems(items: readonly SdLayoutContext[] | null | undefined): void;
50
+ /** Reloads the page, for example from the "changed in another tab" notice. Does nothing once a reload was requested. */
51
+ reload(): void;
52
+ static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutContextService, never>;
53
+ static ɵprov: i0.ɵɵInjectableDeclaration<SdLayoutContextService>;
54
+ }
@@ -0,0 +1,3 @@
1
+ export * from './context.model';
2
+ export * from './context.runtime';
3
+ export * from './context.service';
@@ -4,3 +4,4 @@ export * from './responsive/responsive.service';
4
4
  export * from './navigation-state/navigation-state.service';
5
5
  export * from './menu/menu.utils';
6
6
  export * from './layout.service';
7
+ export * from './context';
@@ -1,6 +1,23 @@
1
1
  import { Params } from '@angular/router';
2
2
  export type SdLayoutMenu = SdLayoutRootMenu | SdLayoutChildrenMenu;
3
3
  export type Menus = SdLayoutMenu[];
4
+ /**
5
+ * Amount of work the user must handle from this menu, such as 3 pending approvals.
6
+ * `neutral` (default) renders a plain count; `warning` and `error` render an attention pill.
7
+ */
8
+ export interface SdLayoutMenuBadge {
9
+ value: number | string;
10
+ tone?: 'neutral' | 'warning' | 'error';
11
+ }
12
+ /**
13
+ * Informational system or connection state, such as "1 running" or "Connected"; it asks for no action.
14
+ * `live` adds a ring around the status dot.
15
+ */
16
+ export interface SdLayoutMenuStatus {
17
+ label: string;
18
+ tone: 'success' | 'warning' | 'error';
19
+ live?: boolean;
20
+ }
4
21
  export interface SdLayoutRootMenu {
5
22
  id?: string;
6
23
  path: string;
@@ -12,6 +29,14 @@ export interface SdLayoutRootMenu {
12
29
  permission: string | string[] | boolean | (() => boolean);
13
30
  level?: number;
14
31
  tooltipTitle?: string;
32
+ /** Section heading this top-level menu is grouped under. Rendered by sidebar V4 only. */
33
+ section?: string;
34
+ /** Rendered by sidebar V4 only. */
35
+ badge?: SdLayoutMenuBadge;
36
+ /** Rendered by sidebar V4 only. */
37
+ status?: SdLayoutMenuStatus;
38
+ /** Sidebar V4 shows the item as aria-disabled, never navigates and leaves it out of search. */
39
+ comingSoon?: boolean;
15
40
  }
16
41
  export interface SdLayoutChildrenMenu {
17
42
  id?: string;
@@ -21,4 +46,12 @@ export interface SdLayoutChildrenMenu {
21
46
  children?: (SdLayoutRootMenu | SdLayoutChildrenMenu)[];
22
47
  level?: number;
23
48
  tooltipTitle?: string;
49
+ /** Section heading this top-level menu is grouped under. Rendered by sidebar V4 only. */
50
+ section?: string;
51
+ /** Rendered by sidebar V4 only. */
52
+ badge?: SdLayoutMenuBadge;
53
+ /** Rendered by sidebar V4 only. */
54
+ status?: SdLayoutMenuStatus;
55
+ /** Sidebar V4 shows the item as aria-disabled, never navigates and leaves it and its children out of search. */
56
+ comingSoon?: boolean;
24
57
  }
@@ -1,6 +1,37 @@
1
- import { SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutRootMenu } from './menu.model';
1
+ import { SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutMenuStatus, SdLayoutRootMenu } from './menu.model';
2
+ /** Top-level menus sharing one `section`; `section: null` holds unsectioned menus rendered without a heading. */
3
+ export interface SdLayoutMenuSectionGroup {
4
+ section: string | null;
5
+ menus: SdLayoutMenu[];
6
+ }
7
+ /** The single trailing element sidebar V4 renders after a menu title. */
8
+ export type SdLayoutMenuTrailing = {
9
+ kind: 'soon';
10
+ } | {
11
+ kind: 'count';
12
+ value: number | string;
13
+ } | {
14
+ kind: 'badge';
15
+ value: number | string;
16
+ tone: 'warning' | 'error';
17
+ } | {
18
+ kind: 'status';
19
+ label: string;
20
+ tone: SdLayoutMenuStatus['tone'];
21
+ live: boolean;
22
+ };
2
23
  export declare function getMenuStableKey(menu: SdLayoutMenu | null | undefined, ancestors?: string[]): string;
3
24
  export declare function searchMenuLeaves(menus: SdLayoutMenu[], query: string): SdLayoutRootMenu[];
25
+ /** Matches like `searchMenuLeaves` but leaves out `comingSoon` leaves and every leaf under a `comingSoon` group (sidebar V4 search). */
26
+ export declare function searchAvailableMenuLeaves(menus: SdLayoutMenu[], query: string): SdLayoutRootMenu[];
4
27
  export declare function selectPrimaryMenuGroups(menus: SdLayoutMenu[], requestedIds: string[] | undefined, maximum?: number): SdLayoutMenu[];
5
28
  export declare function resolveMenuKeys(menus: SdLayoutMenu[], keys: string[]): (SdLayoutRootMenu | SdLayoutChildrenMenu)[];
6
29
  export declare function flattenMenuLeaves(menus: SdLayoutMenu[]): SdLayoutRootMenu[];
30
+ /**
31
+ * Groups top-level menus by `section` in order of first appearance (sidebar V4).
32
+ * An unsectioned menu joins only the immediately preceding output group when that group is unsectioned (`section: null`);
33
+ * otherwise it starts a new unsectioned group.
34
+ */
35
+ export declare function groupMenusBySection(menus: SdLayoutMenu[]): SdLayoutMenuSectionGroup[];
36
+ /** The one trailing element sidebar V4 renders, in the order `comingSoon`, `badge`, `status`; empty values are skipped. */
37
+ export declare function resolveMenuTrailing(menu: SdLayoutMenu | null | undefined): SdLayoutMenuTrailing | null;
@@ -1,5 +1,6 @@
1
1
  import { InjectionToken } from '@angular/core';
2
2
  import { SdStorage } from '@sdcorejs/angular/services';
3
+ import { SdLayoutContext } from '../../configurations';
3
4
  import { SdLayoutChildrenMenu, SdLayoutMenu } from '../menu/menu.model';
4
5
  import * as i0 from "@angular/core";
5
6
  /**
@@ -17,7 +18,7 @@ export type SdLayoutStorageNamespace = string | (() => string | null | undefined
17
18
  *
18
19
  * ⚠️ `SdLayoutStorageService` là singleton `providedIn: 'root'`, thường được khởi tạo TRƯỚC khi biết
19
20
  * người dùng là ai. Vì vậy hãy cấp một **hàm** — nó được gọi lại ở mỗi lần truy cập handle, nên khi
20
- * danh tính đến (hoặc đổi) thì cả bảy handle tự dựng lại trên namespace mới:
21
+ * danh tính đến (hoặc đổi) thì cả tám handle tự dựng lại trên namespace mới:
21
22
  *
22
23
  * ```ts
23
24
  * providers: [
@@ -43,6 +44,8 @@ export declare class SdLayoutStorageService {
43
44
  get pinnedMenuKeys(): SdStorage<string[]>;
44
45
  get recentMenuKeys(): SdStorage<string[]>;
45
46
  get versionStates(): SdStorage<Record<string, SdLayoutVersionState>>;
47
+ /** Snapshot context hiện tại (`{ id, title, subtitle?, avatar? }`), chỉ `SdLayoutContextService` đọc/ghi. */
48
+ get currentContext(): SdStorage<SdLayoutContext>;
46
49
  /**
47
50
  * Xoá toàn bộ state layout đã persist.
48
51
  *
@@ -55,12 +58,28 @@ export declare class SdLayoutStorageService {
55
58
  * của user vừa thoát thì vẫn nguyên.
56
59
  */
57
60
  clear(): void;
61
+ /**
62
+ * Namespace mà các handle đang dùng tại lúc gọi (đã trim; rỗng/không cấu hình → `undefined`).
63
+ * So hai lần gọi để biết partition lưu trữ đã đổi (đăng nhập/đăng xuất trong SPA).
64
+ */
65
+ resolvedNamespace(): string | undefined;
58
66
  readPinnedMenuKeys(menus: SdLayoutMenu[]): string[];
59
67
  writePinnedMenuKeys(keys: string[]): void;
60
68
  readRecentMenuKeys(menus: SdLayoutMenu[], maximum?: number): string[];
61
69
  writeRecentMenuKeys(keys: string[]): void;
62
70
  readVersionState(version: 1 | 2 | 3): SdLayoutVersionState;
63
71
  patchVersionState(version: 1 | 2 | 3, patch: SdLayoutVersionState): SdLayoutVersionState;
72
+ /** Đọc snapshot context từ bộ nhớ; trả bản sao, hoặc `null` khi chưa có hay sai dạng (thiếu/rỗng `id`, `title`). */
73
+ readCurrentContext(): SdLayoutContext | null;
74
+ /** Lưu snapshot context, chỉ giữ `id`, `title`, `subtitle`, `avatar`; bỏ field tuỳ chọn đang `undefined`. */
75
+ writeCurrentContext(context: SdLayoutContext): void;
76
+ /**
77
+ * Đọc lại snapshot context từ storage, bỏ qua entry trong bộ nhớ; kiểm dạng như `readCurrentContext()`.
78
+ *
79
+ * why: `set()` cập nhật bộ nhớ trước và không báo ghi lỗi, còn tab khác ghi thì entry trong bộ nhớ không
80
+ * đổi — chỉ `refresh()` mới cho biết giá trị thật sự đã lưu.
81
+ */
82
+ refreshCurrentContext(): SdLayoutContext | null;
64
83
  static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutStorageService, never>;
65
84
  static ɵprov: i0.ɵɵInjectableDeclaration<SdLayoutStorageService>;
66
85
  }