@sdcorejs/angular 21.3.1 → 21.3.3

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 (386) hide show
  1. package/assets/STYLE-GUIDE.md +25 -5
  2. package/assets/THEME.md +289 -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 +444 -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 +123 -32
  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/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +5 -5
  17. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  18. package/fesm2022/sdcorejs-angular-components-avatar.mjs +142 -11
  19. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  20. package/fesm2022/sdcorejs-angular-components-badge.mjs +542 -24
  21. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  22. package/fesm2022/sdcorejs-angular-components-button.mjs +31 -3
  23. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  24. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +5 -20
  25. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  26. package/fesm2022/sdcorejs-angular-components-data-state.mjs +1 -1
  27. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  28. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1872 -0
  29. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -0
  30. package/fesm2022/sdcorejs-angular-components-editor.mjs +457 -756
  31. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  32. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +68 -37
  33. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  34. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +2118 -1159
  35. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  36. package/fesm2022/sdcorejs-angular-components-history.mjs +5 -2
  37. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  38. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +1 -1
  39. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -1
  40. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +21 -6
  41. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  42. package/fesm2022/sdcorejs-angular-components-inform.mjs +1 -1
  43. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  44. package/fesm2022/sdcorejs-angular-components-kanban.mjs +12 -2
  45. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -1
  46. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +177 -283
  47. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  48. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +1 -308
  49. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  50. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  51. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  52. package/fesm2022/sdcorejs-angular-components-operator.mjs +260 -43
  53. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  54. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +12 -12
  55. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  56. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +1 -1
  57. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  58. package/fesm2022/sdcorejs-angular-components-section.mjs +17 -5
  59. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  60. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  61. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  62. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  63. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +559 -94
  64. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  65. package/fesm2022/sdcorejs-angular-components-table.mjs +1001 -119
  66. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  67. package/fesm2022/sdcorejs-angular-components-tree.mjs +1 -1
  68. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  69. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +887 -174
  70. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  71. package/fesm2022/sdcorejs-angular-components-view.mjs +2 -2
  72. package/fesm2022/sdcorejs-angular-components-view.mjs.map +1 -1
  73. package/fesm2022/sdcorejs-angular-components-window.mjs +484 -0
  74. package/fesm2022/sdcorejs-angular-components-window.mjs.map +1 -0
  75. package/fesm2022/sdcorejs-angular-components.mjs +1 -0
  76. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  77. package/fesm2022/sdcorejs-angular-configurations.mjs.map +1 -1
  78. package/fesm2022/sdcorejs-angular-directives.mjs +18 -1
  79. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  80. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +20 -2
  81. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  82. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs +2 -2
  83. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs.map +1 -1
  84. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +457 -125
  85. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  86. package/fesm2022/sdcorejs-angular-forms-chip.mjs +414 -122
  87. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  88. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +79 -13
  89. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  90. package/fesm2022/sdcorejs-angular-forms-date.mjs +75 -18
  91. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  92. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +79 -16
  93. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  94. package/fesm2022/sdcorejs-angular-forms-directives.mjs +82 -2
  95. package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
  96. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  97. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  98. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +1 -1
  99. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  100. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +56 -6
  101. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  102. package/fesm2022/sdcorejs-angular-forms-input.mjs +54 -7
  103. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  104. package/fesm2022/sdcorejs-angular-forms-models.mjs +88 -5
  105. package/fesm2022/sdcorejs-angular-forms-models.mjs.map +1 -1
  106. package/fesm2022/sdcorejs-angular-forms-radio.mjs +2 -2
  107. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  108. package/fesm2022/sdcorejs-angular-forms-segmented.mjs +5 -4
  109. package/fesm2022/sdcorejs-angular-forms-segmented.mjs.map +1 -1
  110. package/fesm2022/sdcorejs-angular-forms-select.mjs +87 -33
  111. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  112. package/fesm2022/sdcorejs-angular-forms-switch.mjs +2 -2
  113. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  114. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +16 -3
  115. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  116. package/fesm2022/sdcorejs-angular-forms-time.mjs +2 -2
  117. package/fesm2022/sdcorejs-angular-forms-time.mjs.map +1 -1
  118. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  119. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  120. package/fesm2022/sdcorejs-angular-i18n.mjs +1745 -22
  121. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  122. package/fesm2022/sdcorejs-angular-interceptors.mjs +1 -1
  123. package/fesm2022/sdcorejs-angular-interceptors.mjs.map +1 -1
  124. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-BR6jxyYd.mjs +478 -0
  125. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-BR6jxyYd.mjs.map +1 -0
  126. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-BsEL-y-M.mjs +214 -0
  127. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-BsEL-y-M.mjs.map +1 -0
  128. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-qTFKh4UG.mjs +277 -0
  129. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-qTFKh4UG.mjs.map +1 -0
  130. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-Cq0GFfo1.mjs +1556 -0
  131. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-Cq0GFfo1.mjs.map +1 -0
  132. package/fesm2022/sdcorejs-angular-modules-generic.mjs +2 -0
  133. package/fesm2022/sdcorejs-angular-modules-generic.mjs.map +1 -0
  134. package/fesm2022/sdcorejs-angular-modules-icon.mjs +96 -3
  135. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  136. package/fesm2022/sdcorejs-angular-modules-layout.mjs +2055 -37
  137. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  138. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
  139. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
  140. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
  141. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
  142. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-p8-V_Ol9.mjs +51 -0
  143. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-p8-V_Ol9.mjs.map +1 -0
  144. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-DTcpSsbe.mjs +130 -0
  145. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-DTcpSsbe.mjs.map +1 -0
  146. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-T2ox0oMZ.mjs +131 -0
  147. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-T2ox0oMZ.mjs.map +1 -0
  148. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DAjVXHXc.mjs +99 -0
  149. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DAjVXHXc.mjs.map +1 -0
  150. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DkHR_ix2.mjs +118 -0
  151. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DkHR_ix2.mjs.map +1 -0
  152. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DxWuy1ul.mjs +460 -0
  153. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DxWuy1ul.mjs.map +1 -0
  154. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
  155. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
  156. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-Cbs05A2j.mjs +66 -0
  157. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-Cbs05A2j.mjs.map +1 -0
  158. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-Bkk3_Lf0.mjs +148 -0
  159. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-Bkk3_Lf0.mjs.map +1 -0
  160. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-BIuEchUV.mjs +467 -0
  161. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-BIuEchUV.mjs.map +1 -0
  162. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CH21RSWx.mjs +172 -0
  163. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CH21RSWx.mjs.map +1 -0
  164. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CX4WWzER.mjs +90 -0
  165. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CX4WWzER.mjs.map +1 -0
  166. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-D1kpfcf_.mjs +514 -0
  167. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-D1kpfcf_.mjs.map +1 -0
  168. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DYyFPZUU.mjs +61 -0
  169. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DYyFPZUU.mjs.map +1 -0
  170. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-B9vCzIT6.mjs +232 -0
  171. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-B9vCzIT6.mjs.map +1 -0
  172. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BnROr-Wg.mjs +87 -0
  173. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BnROr-Wg.mjs.map +1 -0
  174. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-qs8Yoxn0.mjs +170 -0
  175. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-qs8Yoxn0.mjs.map +1 -0
  176. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-Cbwdhc0Z.mjs +70 -0
  177. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-Cbwdhc0Z.mjs.map +1 -0
  178. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-DYphTR6C.mjs +100 -0
  179. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-DYphTR6C.mjs.map +1 -0
  180. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-C692P-z0.mjs +522 -0
  181. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-C692P-z0.mjs.map +1 -0
  182. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-5sLtmhG1.mjs +71 -0
  183. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-5sLtmhG1.mjs.map +1 -0
  184. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BIFg9bUW.mjs +629 -0
  185. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BIFg9bUW.mjs.map +1 -0
  186. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CZ1NoLIo.mjs +115 -0
  187. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CZ1NoLIo.mjs.map +1 -0
  188. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CmZeYoF7.mjs +118 -0
  189. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CmZeYoF7.mjs.map +1 -0
  190. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Dy2Rkh8f.mjs +164 -0
  191. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Dy2Rkh8f.mjs.map +1 -0
  192. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-BdxQkZXW.mjs +1069 -0
  193. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-BdxQkZXW.mjs.map +1 -0
  194. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs +186 -0
  195. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +1 -0
  196. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs +97 -0
  197. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +1 -0
  198. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
  199. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
  200. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-BpSTfkeT.mjs +48 -0
  201. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-BpSTfkeT.mjs.map +1 -0
  202. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-D3QP1i9v.mjs +293 -0
  203. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-D3QP1i9v.mjs.map +1 -0
  204. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BA64XAgv.mjs +74 -0
  205. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BA64XAgv.mjs.map +1 -0
  206. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CWTlhZzo.mjs +50 -0
  207. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CWTlhZzo.mjs.map +1 -0
  208. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ClRXOw9g.mjs +165 -0
  209. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ClRXOw9g.mjs.map +1 -0
  210. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DYT6cDVo.mjs +45 -0
  211. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DYT6cDVo.mjs.map +1 -0
  212. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Dww3V1b9.mjs +43 -0
  213. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Dww3V1b9.mjs.map +1 -0
  214. package/fesm2022/sdcorejs-angular-modules-pattern-routes-HwJm344-.mjs +74 -0
  215. package/fesm2022/sdcorejs-angular-modules-pattern-routes-HwJm344-.mjs.map +1 -0
  216. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ZkBSRFv_.mjs +99 -0
  217. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ZkBSRFv_.mjs.map +1 -0
  218. package/fesm2022/sdcorejs-angular-modules-pattern-routes-px1VU73r.mjs +66 -0
  219. package/fesm2022/sdcorejs-angular-modules-pattern-routes-px1VU73r.mjs.map +1 -0
  220. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BSDQaT9e.mjs +406 -0
  221. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BSDQaT9e.mjs.map +1 -0
  222. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-2EN7PuIE.mjs +317 -0
  223. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-2EN7PuIE.mjs.map +1 -0
  224. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-Crg1J2V5.mjs +132 -0
  225. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-Crg1J2V5.mjs.map +1 -0
  226. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-LIBiOZLn.mjs +143 -0
  227. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-LIBiOZLn.mjs.map +1 -0
  228. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-4Mm8-ehz.mjs +128 -0
  229. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-4Mm8-ehz.mjs.map +1 -0
  230. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-ClEGOr5D.mjs +357 -0
  231. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-ClEGOr5D.mjs.map +1 -0
  232. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CoGA7wxY.mjs +100 -0
  233. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CoGA7wxY.mjs.map +1 -0
  234. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
  235. package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
  236. package/fesm2022/sdcorejs-angular-modules.mjs +1 -0
  237. package/fesm2022/sdcorejs-angular-modules.mjs.map +1 -1
  238. package/fesm2022/sdcorejs-angular-pipes.mjs +27 -7
  239. package/fesm2022/sdcorejs-angular-pipes.mjs.map +1 -1
  240. package/fesm2022/sdcorejs-angular-services-confirm.mjs +1 -1
  241. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  242. package/fesm2022/sdcorejs-angular-services-date-time.mjs +143 -0
  243. package/fesm2022/sdcorejs-angular-services-date-time.mjs.map +1 -0
  244. package/fesm2022/sdcorejs-angular-services-storage.mjs +44 -8
  245. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  246. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
  247. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
  248. package/fesm2022/sdcorejs-angular-services.mjs +1 -0
  249. package/fesm2022/sdcorejs-angular-services.mjs.map +1 -1
  250. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs +4 -0
  251. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs.map +1 -1
  252. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +10 -0
  253. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -1
  254. package/modules/pattern/README.md +76 -0
  255. package/modules/pattern/docs/detail.md +237 -0
  256. package/modules/pattern/docs/drawer.md +484 -0
  257. package/modules/pattern/docs/flow.md +631 -0
  258. package/modules/pattern/docs/form.md +518 -0
  259. package/modules/pattern/docs/header-actions.md +342 -0
  260. package/modules/pattern/docs/list.md +247 -0
  261. package/modules/pattern/docs/relation.md +180 -0
  262. package/modules/pattern/docs/select.md +206 -0
  263. package/modules/pattern/docs/split.md +350 -0
  264. package/modules/pattern/docs/states.md +168 -0
  265. package/modules/pattern/features/approval/entity.resolver.ts +21 -0
  266. package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
  267. package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
  268. package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
  269. package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
  270. package/modules/pattern/features/approval/routes.ts +30 -0
  271. package/modules/pattern/features/approval/services/approval.model.ts +38 -0
  272. package/modules/pattern/features/approval/services/approval.service.ts +23 -0
  273. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +123 -0
  274. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
  275. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
  276. package/modules/pattern/features/category/entity.resolver.ts +27 -0
  277. package/modules/pattern/features/category/pages/list/list.component.html +20 -0
  278. package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
  279. package/modules/pattern/features/category/routes.ts +42 -0
  280. package/modules/pattern/features/category/services/category.model.ts +39 -0
  281. package/modules/pattern/features/category/services/category.service.ts +36 -0
  282. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +131 -0
  283. package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
  284. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
  285. package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
  286. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
  287. package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
  288. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
  289. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
  290. package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
  291. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
  292. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
  293. package/modules/pattern/features/customer/entity.resolver.ts +21 -0
  294. package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
  295. package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
  296. package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
  297. package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
  298. package/modules/pattern/features/customer/routes.ts +59 -0
  299. package/modules/pattern/features/customer/services/customer.model.ts +87 -0
  300. package/modules/pattern/features/customer/services/customer.service.ts +79 -0
  301. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
  302. package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
  303. package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
  304. package/modules/pattern/features/import/routes.ts +19 -0
  305. package/modules/pattern/features/import/services/import.model.ts +82 -0
  306. package/modules/pattern/features/import/services/import.service.ts +18 -0
  307. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
  308. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
  309. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
  310. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +205 -0
  311. package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
  312. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
  313. package/modules/pattern/features/order/entity.resolver.ts +37 -0
  314. package/modules/pattern/features/order/pages/create/create.component.ts +99 -0
  315. package/modules/pattern/features/order/pages/detail/detail.component.ts +222 -0
  316. package/modules/pattern/features/order/pages/list/list.component.html +38 -0
  317. package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
  318. package/modules/pattern/features/order/pages/update/update.component.ts +119 -0
  319. package/modules/pattern/features/order/routes.ts +54 -0
  320. package/modules/pattern/features/order/services/order.model.ts +109 -0
  321. package/modules/pattern/features/order/services/order.service.ts +63 -0
  322. package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
  323. package/modules/pattern/features/partner/routes.ts +20 -0
  324. package/modules/pattern/features/partner/services/partner.model.ts +30 -0
  325. package/modules/pattern/features/partner/services/partner.service.ts +17 -0
  326. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
  327. package/modules/pattern/features/product/components/product-select/product-select.component.ts +65 -0
  328. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
  329. package/modules/pattern/features/product/entity.resolver.ts +21 -0
  330. package/modules/pattern/features/product/pages/create/create.component.ts +85 -0
  331. package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
  332. package/modules/pattern/features/product/pages/list/list.component.html +30 -0
  333. package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
  334. package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
  335. package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
  336. package/modules/pattern/features/product/routes.ts +48 -0
  337. package/modules/pattern/features/product/services/product.model.ts +38 -0
  338. package/modules/pattern/features/product/services/product.service.ts +48 -0
  339. package/modules/pattern/features/settings/pages/update/update.component.ts +227 -0
  340. package/modules/pattern/features/settings/routes.ts +24 -0
  341. package/modules/pattern/features/settings/services/settings.model.ts +18 -0
  342. package/modules/pattern/features/settings/services/settings.service.ts +15 -0
  343. package/modules/pattern/features/settings/settings.resolver.ts +8 -0
  344. package/package.json +44 -7
  345. package/types/sdcorejs-angular-components-avatar.d.ts +67 -2
  346. package/types/sdcorejs-angular-components-badge.d.ts +206 -6
  347. package/types/sdcorejs-angular-components-button.d.ts +20 -1
  348. package/types/sdcorejs-angular-components-ckeditor-styles.d.ts +3 -18
  349. package/types/sdcorejs-angular-components-editor-engine.d.ts +246 -0
  350. package/types/sdcorejs-angular-components-editor.d.ts +20 -17
  351. package/types/sdcorejs-angular-components-file-explorer.d.ts +4 -2
  352. package/types/sdcorejs-angular-components-form-generic.d.ts +246 -35
  353. package/types/sdcorejs-angular-components-mini-editor.d.ts +33 -70
  354. package/types/sdcorejs-angular-components-modal-resizable.d.ts +1 -124
  355. package/types/sdcorejs-angular-components-operator.d.ts +137 -8
  356. package/types/sdcorejs-angular-components-section.d.ts +13 -1
  357. package/types/sdcorejs-angular-components-splitter.d.ts +1 -1
  358. package/types/sdcorejs-angular-components-tab-router.d.ts +74 -19
  359. package/types/sdcorejs-angular-components-table.d.ts +210 -18
  360. package/types/sdcorejs-angular-components-upload-file.d.ts +181 -21
  361. package/types/sdcorejs-angular-components-window.d.ts +81 -0
  362. package/types/sdcorejs-angular-components.d.ts +1 -0
  363. package/types/sdcorejs-angular-configurations.d.ts +8 -1
  364. package/types/sdcorejs-angular-forms-autocomplete.d.ts +5 -0
  365. package/types/sdcorejs-angular-forms-chip-calendar.d.ts +163 -18
  366. package/types/sdcorejs-angular-forms-chip.d.ts +136 -26
  367. package/types/sdcorejs-angular-forms-date-range.d.ts +24 -2
  368. package/types/sdcorejs-angular-forms-date.d.ts +23 -2
  369. package/types/sdcorejs-angular-forms-directives.d.ts +47 -2
  370. package/types/sdcorejs-angular-forms-input-number.d.ts +23 -2
  371. package/types/sdcorejs-angular-forms-input.d.ts +23 -2
  372. package/types/sdcorejs-angular-forms-models.d.ts +38 -3
  373. package/types/sdcorejs-angular-forms-select.d.ts +32 -2
  374. package/types/sdcorejs-angular-i18n.d.ts +344 -2
  375. package/types/sdcorejs-angular-modules-generic.d.ts +316 -0
  376. package/types/sdcorejs-angular-modules-icon.d.ts +37 -6
  377. package/types/sdcorejs-angular-modules-layout.d.ts +622 -89
  378. package/types/sdcorejs-angular-modules-pattern.d.ts +50 -0
  379. package/types/sdcorejs-angular-modules.d.ts +1 -0
  380. package/types/sdcorejs-angular-pipes.d.ts +2 -0
  381. package/types/sdcorejs-angular-services-date-time.d.ts +57 -0
  382. package/types/sdcorejs-angular-services-storage.d.ts +8 -1
  383. package/types/sdcorejs-angular-services-unsaved-changes.d.ts +11 -0
  384. package/types/sdcorejs-angular-services.d.ts +1 -0
  385. package/types/sdcorejs-angular-utilities-read-state.d.ts +2 -0
  386. package/types/sdcorejs-angular-utilities-theme.d.ts +1 -1
@@ -0,0 +1,1556 @@
1
+ import * as i0 from '@angular/core';
2
+ import { InjectionToken, inject, Injector, provideEnvironmentInitializer, makeEnvironmentProviders, Injectable, EnvironmentInjector } from '@angular/core';
3
+ import { provideSdFormGeneric } from '@sdcorejs/angular/components/form-generic';
4
+ import { SdPermissionService, SD_PERMISSION_PUBLIC } from '@sdcorejs/angular/modules/permission';
5
+ import { SD_DATA_TYPE_ICON } from '@sdcorejs/angular/modules/icon';
6
+ import { I18nService } from '@sdcorejs/angular/i18n';
7
+
8
+ /** Provided by the list page for the form pages of its outlet. */
9
+ const SD_GENERIC_LIST_HOST = new InjectionToken('SD_GENERIC_LIST_HOST');
10
+ /** Adapter lists of every `provideSdGeneric` call in one injector. */
11
+ const SD_GENERIC_ADAPTERS = new InjectionToken('SD_GENERIC_ADAPTERS');
12
+ /** Entity configurations of every `provideSdGenericEntity` call in one injector. */
13
+ const SD_GENERIC_ENTITIES = new InjectionToken('SD_GENERIC_ENTITIES');
14
+ /** `permission` option of every `provideSdGeneric` call in one injector. */
15
+ const SD_GENERIC_PERMISSION_OPTION = new InjectionToken('SD_GENERIC_PERMISSION_OPTION');
16
+ const entityKey = (module, entity) => `${module}.${entity}`;
17
+ /**
18
+ * Registrations of one injector plus a link to the scope of the parent injector. Lookups walk from the nearest
19
+ * scope to the root, so a lazy route can override what the root declares (INV-001).
20
+ */
21
+ class SdGenericScope {
22
+ adapters;
23
+ entities;
24
+ permission;
25
+ parent;
26
+ constructor(adapters, entities, permission, parent) {
27
+ this.adapters = adapters;
28
+ this.entities = entities;
29
+ this.permission = permission;
30
+ this.parent = parent;
31
+ }
32
+ adapter(module) {
33
+ return this.adapters.get(module) ?? this.parent?.adapter(module);
34
+ }
35
+ entity(module, entity) {
36
+ return this.entities.get(entityKey(module, entity)) ?? this.parent?.entity(module, entity);
37
+ }
38
+ /** `permission` of the nearest scope that declares it; `true` when none does. */
39
+ permissionEnabled() {
40
+ return this.permission ?? this.parent?.permissionEnabled() ?? true;
41
+ }
42
+ }
43
+ /** Scope of the current injector. Every generic screen reads adapters and entity settings only through it. */
44
+ const SD_GENERIC_SCOPE = new InjectionToken('SD_GENERIC_SCOPE', {
45
+ providedIn: 'root',
46
+ factory: () => new SdGenericScope(new Map(), new Map(), undefined, null),
47
+ });
48
+ const isAdapterClass = (value) => typeof value === 'function';
49
+ /** Factory of the scope of one injector: reads that injector's own registrations, links the parent scope. */
50
+ const sdGenericScopeFactory = () => {
51
+ const injector = inject(Injector);
52
+ const adapters = new Map();
53
+ for (const value of (inject(SD_GENERIC_ADAPTERS, { self: true, optional: true }) ?? []).flat()) {
54
+ const adapter = isAdapterClass(value) ? injector.get(value) : value;
55
+ // why: two adapters for one module in the same injector are ambiguous (D-020); fail while the injector is created.
56
+ if (adapters.has(adapter.module))
57
+ throw new Error(`SdGeneric: the module "${adapter.module}" is registered twice in the same injector.`);
58
+ adapters.set(adapter.module, adapter);
59
+ }
60
+ const entities = new Map();
61
+ for (const entity of inject(SD_GENERIC_ENTITIES, { self: true, optional: true }) ?? []) {
62
+ const key = entityKey(entity.module, entity.entity);
63
+ if (entities.has(key))
64
+ throw new Error(`SdGeneric: the entity "${key}" is configured twice in the same injector.`);
65
+ entities.set(key, entity);
66
+ }
67
+ const permission = (inject(SD_GENERIC_PERMISSION_OPTION, { self: true, optional: true }) ?? [])
68
+ .filter(value => value !== undefined)
69
+ .pop();
70
+ const parent = inject(SD_GENERIC_SCOPE, { skipSelf: true, optional: true });
71
+ return new SdGenericScope(adapters, entities, permission, parent);
72
+ };
73
+
74
+ const scopeProviders = () => [
75
+ { provide: SD_GENERIC_SCOPE, useFactory: sdGenericScopeFactory },
76
+ // why: build the scope as soon as the injector exists, so a duplicate module throws at bootstrap / route
77
+ // activation instead of on the first generic screen (AC-003).
78
+ provideEnvironmentInitializer(() => inject(SD_GENERIC_SCOPE)),
79
+ ];
80
+ /**
81
+ * Registers backend adapters for the generic module. Call it at the root and/or in the `providers` of lazy
82
+ * routes: lookups use the nearest injector first, then its parents. Adapter classes are created by DI.
83
+ *
84
+ * @example
85
+ * provideSdGeneric({ adapters: [TmsAdapter] });
86
+ */
87
+ function provideSdGeneric(configuration) {
88
+ const classes = configuration.adapters.filter((adapter) => typeof adapter === 'function');
89
+ return makeEnvironmentProviders([
90
+ ...classes.map(adapter => ({ provide: adapter, useClass: adapter })),
91
+ { provide: SD_GENERIC_ADAPTERS, multi: true, useValue: configuration.adapters },
92
+ { provide: SD_GENERIC_PERMISSION_OPTION, multi: true, useValue: configuration.permission },
93
+ ...scopeProviders(),
94
+ ]);
95
+ }
96
+ /**
97
+ * Code-level customization of one entity: schema adjustments, dedicated search, display mode, save hooks and
98
+ * custom actions. Same scoping rules as `provideSdGeneric`.
99
+ */
100
+ function provideSdGenericEntity(configuration) {
101
+ return makeEnvironmentProviders([{ provide: SD_GENERIC_ENTITIES, multi: true, useValue: configuration }, ...scopeProviders()]);
102
+ }
103
+
104
+ /** `localStorage` key of the customized schema of one entity (A-005). */
105
+ const sdGenericStorageKey = (module, entity) => `sd-generic:configuration:${module}.${entity}`;
106
+ /**
107
+ * Default schema store when the adapter has no `schemaStore`. It only lives in this browser, so real deployments
108
+ * should give the adapter a `schemaStore` backed by the server.
109
+ */
110
+ class SdGenericLocalStore {
111
+ module;
112
+ constructor(module) {
113
+ this.module = module;
114
+ }
115
+ async get(entity) {
116
+ let raw;
117
+ try {
118
+ raw = localStorage.getItem(sdGenericStorageKey(this.module, entity));
119
+ }
120
+ catch {
121
+ // why: no storage (server rendering, blocked site data) means no configuration yet, not a failed screen.
122
+ return null;
123
+ }
124
+ if (raw === null)
125
+ return null;
126
+ try {
127
+ return JSON.parse(raw);
128
+ }
129
+ catch {
130
+ // why: unreadable content is handed to the validator, which reports it as a shape error (fallback to default).
131
+ return raw;
132
+ }
133
+ }
134
+ async set(entity, schema) {
135
+ localStorage.setItem(sdGenericStorageKey(this.module, entity), JSON.stringify(schema));
136
+ }
137
+ }
138
+
139
+ const SD_GENERIC_DEFAULT_PAGE_SIZE = 20;
140
+ /** Data types that get no list column unless one is configured, and are never imported. */
141
+ const NOT_LISTED = new Set(['json', 'file']);
142
+ /** Configured columns, or every property except `json` and `file`. */
143
+ const sdGenericListColumns = (schema) => schema.list?.columns ??
144
+ schema.general.properties.filter(property => !NOT_LISTED.has(property.dataType)).map(property => ({ key: property.key }));
145
+ const sdGenericPageSize = (schema) => schema.list?.pageSize ?? SD_GENERIC_DEFAULT_PAGE_SIZE;
146
+ const sdGenericPrimaryKey = (schema) => schema.general.primaryKey || 'id';
147
+ /** Whether a create form may contain the property. */
148
+ const sdGenericCanInsert = (property) => !property.system && property.insertable !== false;
149
+ /** Whether an update form may contain the property. */
150
+ const sdGenericCanUpdate = (property) => !property.system && property.updatable !== false;
151
+ /** Whether the default import columns contain the property: insertable, and neither `json` nor `file`. */
152
+ const sdGenericImportable = (property) => sdGenericCanInsert(property) && !NOT_LISTED.has(property.dataType);
153
+ /** Properties indexed by key. */
154
+ const sdGenericPropertyMap = (schema) => new Map(schema.general.properties.map(property => [property.key, property]));
155
+
156
+ const PLACEHOLDER = /\$\{\s*([^}]*?)\s*\}/g;
157
+ /** Keys referenced by `${key}` placeholders, in order. */
158
+ const sdGenericTitlePlaceholders = (template) => Array.from(template.matchAll(PLACEHOLDER), match => match[1]);
159
+ /**
160
+ * Replaces `${key}` with the record value. The result is plain text: callers bind it with text interpolation,
161
+ * never as HTML (INV-006).
162
+ */
163
+ const sdGenericRenderTitle = (template, record) => template.replace(PLACEHOLDER, (_, key) => {
164
+ const value = record?.[key];
165
+ return value === undefined || value === null ? '' : String(value);
166
+ });
167
+ /** Issues of one section title: list/create titles take no placeholder, detail/update ones only known keys. */
168
+ const sdGenericTitleIssues = (section, template, keys) => {
169
+ const path = `${section}.title`;
170
+ if (template === undefined)
171
+ return [];
172
+ if (typeof template !== 'string')
173
+ return [{ code: 'shape', severity: 'error', path, message: `${path} must be a string.` }];
174
+ const placeholders = sdGenericTitlePlaceholders(template);
175
+ if (section === 'list' || section === 'create') {
176
+ return placeholders.length
177
+ ? [
178
+ {
179
+ code: 'title-placeholder-forbidden',
180
+ severity: 'error',
181
+ path,
182
+ message: `${path} cannot contain placeholders; there is no record yet.`,
183
+ },
184
+ ]
185
+ : [];
186
+ }
187
+ return placeholders
188
+ .filter(key => !keys.has(key))
189
+ .map(key => ({
190
+ code: 'title-placeholder-unknown',
191
+ severity: 'error',
192
+ path,
193
+ message: `${path} references the unknown property "${key}".`,
194
+ }));
195
+ };
196
+
197
+ const DEFAULT_LIMIT$1 = 20;
198
+ /** Relation defaults: the schema module, `valueField` `id`, `displayField` the value field, search on the display field. */
199
+ const sdGenericRelationInfo = (property, module) => {
200
+ const relation = property.relation ?? { entity: '' };
201
+ const valueField = relation.valueField || 'id';
202
+ const displayField = relation.displayField || valueField;
203
+ const info = {
204
+ module: relation.module || module,
205
+ entity: relation.entity,
206
+ valueField,
207
+ displayField,
208
+ searchFields: relation.searchFields?.length ? [...relation.searchFields] : [displayField],
209
+ };
210
+ if (relation.display)
211
+ info.display = relation.display;
212
+ return info;
213
+ };
214
+ /** `query` request used when neither the entity nor the adapter has a search: `IN` for values, `CONTAIN` for a term. */
215
+ const sdGenericSearchPagingReq = (req) => {
216
+ const filters = [...(req.filters ?? [])];
217
+ if (req.values?.length) {
218
+ filters.push({ field: req.valueField, operator: 'IN', data: [...req.values] });
219
+ }
220
+ else if (req.term) {
221
+ filters.push({ operator: 'OR', data: req.fields.map(field => ({ field, operator: 'CONTAIN', data: req.term })) });
222
+ }
223
+ return { pageNumber: 0, pageSize: req.values?.length || req.limit || DEFAULT_LIMIT$1, filters };
224
+ };
225
+ /** Text label of a related record: the display template, then the display field, then the value field. */
226
+ const sdGenericRecordLabel = (record, info) => {
227
+ if (info.display)
228
+ return sdGenericRenderTitle(info.display, record);
229
+ const value = record[info.displayField] ?? record[info.valueField];
230
+ return value === undefined || value === null ? '' : String(value);
231
+ };
232
+ /** form-generic option values are strings; this restores the original value (a numeric id stays a number). */
233
+ const sdGenericCoerceValue = (raw, known) => {
234
+ if (Array.isArray(raw))
235
+ return raw.map(item => sdGenericCoerceValue(item, known));
236
+ if (typeof raw === 'string' && known.has(raw))
237
+ return known.get(raw);
238
+ return raw;
239
+ };
240
+
241
+ /** Field added by the data service to related records when the relation has a display template. */
242
+ const SD_GENERIC_LABEL_FIELD = '$label';
243
+ const relationDisplayField = (property, schema) => {
244
+ const info = sdGenericRelationInfo(property, schema.module);
245
+ return info.display ? SD_GENERIC_LABEL_FIELD : info.displayField;
246
+ };
247
+ const fileNames = (value) => (Array.isArray(value) ? value : value === undefined || value === null ? [] : [value])
248
+ .map(item => (item && typeof item === 'object' ? String(item['name'] ?? '') : String(item)))
249
+ .filter(Boolean)
250
+ .join(', ');
251
+ const columnOf = (property, schema, deps) => {
252
+ const base = { field: property.key, title: property.label };
253
+ switch (property.dataType) {
254
+ case 'number':
255
+ return { ...base, type: 'number' };
256
+ case 'boolean':
257
+ return { ...base, type: 'boolean' };
258
+ case 'date':
259
+ case 'datetime':
260
+ return { ...base, type: property.dataType };
261
+ case 'time':
262
+ return { ...base, type: 'time' };
263
+ case 'enum': {
264
+ const enums = property.enums ?? [];
265
+ const styled = enums.some(option => option.color || option.icon);
266
+ return {
267
+ ...base,
268
+ type: 'values',
269
+ option: {
270
+ items: enums,
271
+ valueField: 'value',
272
+ displayField: 'label',
273
+ ...(property.multiple ? { selection: 'MULTIPLE' } : {}),
274
+ },
275
+ ...(styled
276
+ ? {
277
+ useBadge: (value) => {
278
+ const option = enums.find(candidate => candidate.value === value);
279
+ return { color: option?.color, icon: option?.icon };
280
+ },
281
+ }
282
+ : {}),
283
+ };
284
+ }
285
+ case 'relation': {
286
+ const info = sdGenericRelationInfo(property, schema.module);
287
+ return {
288
+ ...base,
289
+ type: 'lazy-values',
290
+ option: {
291
+ items: deps.relationSearch(property),
292
+ valueField: info.valueField,
293
+ displayField: relationDisplayField(property, schema),
294
+ views: deps.relationViews(property),
295
+ ...(property.multiple ? { selection: 'MULTIPLE' } : {}),
296
+ },
297
+ };
298
+ }
299
+ case 'json':
300
+ return {
301
+ ...base,
302
+ type: 'string',
303
+ transform: (value) => (value === undefined || value === null ? '' : JSON.stringify(value)),
304
+ };
305
+ case 'file':
306
+ return { ...base, type: 'string', transform: (value) => fileNames(value) };
307
+ default:
308
+ return { ...base, type: 'string' };
309
+ }
310
+ };
311
+ const withFlags = (column, config) => ({
312
+ ...column,
313
+ ...(config.width ? { width: `${config.width}px` } : {}),
314
+ ...(config.visible === false ? { invisible: true } : {}),
315
+ ...(config.sortable !== undefined ? { sortable: config.sortable } : {}),
316
+ ...(config.filterable === false ? { filter: { disabled: true } } : {}),
317
+ });
318
+ /**
319
+ * sd-table columns of the list (INV-013); configured keys that no longer exist are skipped. With `open`, the first
320
+ * visible column that is not a server field (else the first visible one) links to the record.
321
+ */
322
+ const sdGenericTableColumns = (schema, deps, open) => {
323
+ const properties = sdGenericPropertyMap(schema);
324
+ const configs = sdGenericListColumns(schema).filter(config => properties.has(config.key));
325
+ const visible = configs.filter(config => config.visible !== false);
326
+ const link = open ? (visible.find(config => !properties.get(config.key).system) ?? visible[0]) : undefined;
327
+ return configs.map(config => {
328
+ const column = withFlags(columnOf(properties.get(config.key), schema, deps), config);
329
+ return config === link ? { ...column, click: (_value, row) => open(row) } : column;
330
+ });
331
+ };
332
+ /** sd-table external filters of the list, shown by default; json and file properties cannot be filtered. */
333
+ const sdGenericExternalFilters = (schema, deps) => {
334
+ const properties = sdGenericPropertyMap(schema);
335
+ return (schema.list?.externalFilters ?? []).flatMap(config => {
336
+ const property = properties.get(config.key);
337
+ if (!property)
338
+ return [];
339
+ const base = {
340
+ field: property.key,
341
+ title: property.label,
342
+ // why: a configured filter is shown right away; the list hides the toolbar that would let users pick it.
343
+ defaultShowing: true,
344
+ ...(config.required ? { required: true } : {}),
345
+ ...(config.operator ? { defaultOperator: config.operator } : {}),
346
+ ...(config.default !== undefined ? { default: config.default } : {}),
347
+ };
348
+ switch (property.dataType) {
349
+ case 'string':
350
+ case 'text':
351
+ case 'time':
352
+ return [{ ...base, type: 'string' }];
353
+ case 'number':
354
+ return [{ ...base, type: 'number' }];
355
+ case 'boolean':
356
+ return [{ ...base, type: 'boolean' }];
357
+ case 'date':
358
+ case 'datetime':
359
+ return [{ ...base, type: 'daterange', ...(property.dataType === 'datetime' ? { enableTime: true } : {}) }];
360
+ case 'enum':
361
+ return [
362
+ {
363
+ ...base,
364
+ type: 'values',
365
+ option: { items: property.enums ?? [], valueField: 'value', displayField: 'label', selection: 'MULTIPLE' },
366
+ },
367
+ ];
368
+ case 'relation': {
369
+ const info = sdGenericRelationInfo(property, schema.module);
370
+ return [
371
+ {
372
+ ...base,
373
+ type: 'lazy-values',
374
+ option: {
375
+ items: deps.relationSearch(property),
376
+ valueField: info.valueField,
377
+ displayField: relationDisplayField(property, schema),
378
+ selection: 'MULTIPLE',
379
+ },
380
+ },
381
+ ];
382
+ }
383
+ default:
384
+ return [];
385
+ }
386
+ });
387
+ };
388
+
389
+ /** Id of the form-generic catalog that serves every relation select (D-022). */
390
+ const SD_GENERIC_RELATION_CATALOG = 'sd-generic-relation';
391
+ const STRING_FORMATS$1 = new Set(['email', 'phone', 'url', 'password']);
392
+ const NUMBER_FORMATS$1 = new Set(['integer', 'decimal', 'currency', 'percent']);
393
+ /** Layout-only members of a stored field; everything else comes from `general` (INV-007). */
394
+ const LAYOUT_MEMBERS = ['layout', 'rules', 'helperText', 'placeholder', 'hidden', 'disabled', 'viewed', 'hyperlink', 'direction'];
395
+ /** form-generic field type generated for a property. */
396
+ const sdGenericFieldType = (property) => {
397
+ switch (property.dataType) {
398
+ case 'string':
399
+ return property.multiple ? 'chip-string' : 'textfield';
400
+ case 'text':
401
+ return 'textarea';
402
+ case 'number':
403
+ return 'number';
404
+ case 'boolean':
405
+ return 'checkbox';
406
+ case 'date':
407
+ case 'datetime':
408
+ return 'datetime';
409
+ case 'time':
410
+ return 'time';
411
+ case 'enum':
412
+ case 'relation':
413
+ return 'select';
414
+ case 'json':
415
+ return 'json';
416
+ case 'file':
417
+ return 'upload';
418
+ }
419
+ };
420
+ /** Field types a stored layout may use for a property: a single enum may also be a radio group. */
421
+ const sdGenericAllowedFieldTypes = (property) => property.dataType === 'enum' && !property.multiple ? ['select', 'radio'] : [sdGenericFieldType(property)];
422
+ const validationOf = (property) => {
423
+ const source = property.validation;
424
+ if (!source)
425
+ return undefined;
426
+ const validation = {};
427
+ if (source.required)
428
+ validation.required = true;
429
+ if (source.min !== undefined)
430
+ validation.min = source.min;
431
+ if (source.max !== undefined)
432
+ validation.max = source.max;
433
+ if (source.minLength !== undefined)
434
+ validation.minLength = source.minLength;
435
+ if (source.maxLength !== undefined)
436
+ validation.maxLength = source.maxLength;
437
+ if (source.pattern)
438
+ validation.pattern = { value: source.pattern };
439
+ return Object.keys(validation).length ? validation : undefined;
440
+ };
441
+ const optionsOf = (property, schema) => {
442
+ if (property.dataType === 'enum') {
443
+ return { source: 'static', items: (property.enums ?? []).map(option => ({ value: option.value, label: option.label })) };
444
+ }
445
+ if (property.dataType === 'relation') {
446
+ const info = sdGenericRelationInfo(property, schema.module);
447
+ const param = (name, value) => ({ name, value: { value } });
448
+ return {
449
+ source: 'catalog',
450
+ catalog: SD_GENERIC_RELATION_CATALOG,
451
+ // why: constant params make the form-generic cache key unique per relation, not per entity.
452
+ params: [
453
+ param('module', info.module),
454
+ param('entity', info.entity),
455
+ param('valueField', info.valueField),
456
+ param('displayField', info.displayField),
457
+ param('searchFields', info.searchFields.join(',')),
458
+ param('display', info.display ?? ''),
459
+ ],
460
+ };
461
+ }
462
+ return undefined;
463
+ };
464
+ /**
465
+ * A full form-generic field: data from the property, layout members from the stored field when there is one. The
466
+ * default value only fills a create form; on detail / update it would replace a value the record left empty.
467
+ */
468
+ const hydrate = (property, schema, action, stored) => {
469
+ const allowed = sdGenericAllowedFieldTypes(property);
470
+ const type = stored && allowed.includes(stored['type']) ? stored['type'] : sdGenericFieldType(property);
471
+ const field = {
472
+ id: typeof stored?.['id'] === 'string' ? stored['id'] : property.key,
473
+ key: property.key,
474
+ type,
475
+ label: property.label,
476
+ };
477
+ for (const member of LAYOUT_MEMBERS)
478
+ if (stored && stored[member] !== undefined)
479
+ field[member] = stored[member];
480
+ const validation = validationOf(property);
481
+ if (validation)
482
+ field['validation'] = validation;
483
+ if (action === 'create' && property.defaultValue !== undefined)
484
+ field['defaultValue'] = property.defaultValue;
485
+ if (type === 'textfield' && property.format && STRING_FORMATS$1.has(property.format))
486
+ field['subtype'] = property.format;
487
+ if (type === 'number' && property.format && NUMBER_FORMATS$1.has(property.format))
488
+ field['subtype'] = property.format;
489
+ if (type === 'datetime')
490
+ field['subtype'] = property.dataType === 'datetime' ? 'datetime' : 'date';
491
+ if (type === 'select' || type === 'radio')
492
+ field['options'] = optionsOf(property, schema);
493
+ if (type === 'select')
494
+ field['multiple'] = !!property.multiple;
495
+ if (type === 'upload' && !property.multiple)
496
+ field['maxFiles'] = 1;
497
+ return field;
498
+ };
499
+ const isAllowed = (action) => (property) => action === 'create' ? sdGenericCanInsert(property) : action === 'update' ? sdGenericCanUpdate(property) : true;
500
+ /**
501
+ * Form of one action: the action layout, then the detail layout, then a generated one-page layout. Stored fields
502
+ * keep only their layout; type, label, options and validation always come from `general` (INV-007).
503
+ */
504
+ const sdGenericBuildForm = (schema, action) => {
505
+ const allowed = isAllowed(action);
506
+ const properties = sdGenericPropertyMap(schema);
507
+ const layout = schema[action]?.form ?? (action === 'detail' ? undefined : schema.detail?.form);
508
+ if (!layout) {
509
+ return {
510
+ pages: [{ id: 'main', elements: schema.general.properties.filter(allowed).map(property => hydrate(property, schema, action)) }],
511
+ };
512
+ }
513
+ const elementsOf = (elements) => (Array.isArray(elements) ? elements : []).flatMap((element) => {
514
+ const node = element;
515
+ if (node['type'] === 'group')
516
+ return [{ ...node, elements: elementsOf(node['elements']) }];
517
+ if (node['type'] === 'html')
518
+ return [node];
519
+ const property = properties.get(node['key']);
520
+ return property && allowed(property) ? [hydrate(property, schema, action, node)] : [];
521
+ });
522
+ return { ...layout, pages: layout.pages.map(page => ({ ...page, elements: elementsOf(page.elements) })) };
523
+ };
524
+ /** Payload of a save: only insertable values on create, only updatable values on update (INV-007). */
525
+ const sdGenericFormPayload = (schema, action, value) => {
526
+ const allowed = isAllowed(action);
527
+ const payload = {};
528
+ for (const property of schema.general.properties) {
529
+ if (allowed(property) && Object.hasOwn(value, property.key))
530
+ payload[property.key] = value[property.key];
531
+ }
532
+ return payload;
533
+ };
534
+
535
+ /** Concurrent adapter calls of an import (D-016). */
536
+ const SD_GENERIC_IMPORT_CONCURRENCY = 5;
537
+ /** Values per lookup request of an import, so that one request stays under backend page-size and URL limits. */
538
+ const SD_GENERIC_IMPORT_LOOKUP_SIZE = 100;
539
+ /** Lookup entry of a match value that several records share; such a cell cannot be resolved. */
540
+ const SD_GENERIC_AMBIGUOUS = Symbol('sd-generic-ambiguous');
541
+ const TRUE_VALUES = new Set(['true', '1', 'yes', 'x']);
542
+ /** `values` split into lists of at most `size` items. */
543
+ const sdGenericChunk = (values, size) => {
544
+ const chunks = [];
545
+ for (let start = 0; start < values.length; start += size)
546
+ chunks.push(values.slice(start, start + size));
547
+ return chunks;
548
+ };
549
+ /** `match value -> stored value`; a match value shared by several records maps to `SD_GENERIC_AMBIGUOUS`. */
550
+ const sdGenericLookupMap = (entries) => {
551
+ const lookup = new Map();
552
+ for (const [match, value] of entries)
553
+ lookup.set(match, lookup.has(match) && lookup.get(match) !== value ? SD_GENERIC_AMBIGUOUS : value);
554
+ return lookup;
555
+ };
556
+ const matchFieldOf = (property, schema, configured) => property.dataType === 'relation' ? configured || sdGenericRelationInfo(property, schema.module).displayField : undefined;
557
+ /** Import columns: configured ones that still exist, or every insertable property except system, json and file. */
558
+ const sdGenericImportColumns = (schema) => {
559
+ const properties = sdGenericPropertyMap(schema);
560
+ const configured = schema.import?.columns;
561
+ if (configured) {
562
+ return configured.flatMap(column => {
563
+ const property = properties.get(column.key);
564
+ return property ? [{ key: property.key, property, matchField: matchFieldOf(property, schema, column.matchField) }] : [];
565
+ });
566
+ }
567
+ return schema.general.properties
568
+ .filter(sdGenericImportable)
569
+ .map(property => ({ key: property.key, property, matchField: matchFieldOf(property, schema) }));
570
+ };
571
+ /** Empty spreadsheet cell: no value, or only spaces. */
572
+ const sdGenericIsBlank = (value) => value === undefined || value === null || (typeof value === 'string' && value.trim() === '');
573
+ const isBlank = sdGenericIsBlank;
574
+ /**
575
+ * Converts one spreadsheet row: enum cells by value or label, relation cells through `lookups`
576
+ * (`property key -> match value -> stored value`).
577
+ */
578
+ const sdGenericParseImportRow = (row, columns, lookups) => {
579
+ const data = {};
580
+ const errors = [];
581
+ for (const { key, property } of columns) {
582
+ const cell = row[key];
583
+ if (isBlank(cell))
584
+ continue;
585
+ switch (property.dataType) {
586
+ case 'enum': {
587
+ const text = String(cell).trim();
588
+ const option = property.enums?.find(candidate => candidate.value === text) ??
589
+ property.enums?.find(candidate => candidate.label.trim().toLowerCase() === text.toLowerCase());
590
+ if (option)
591
+ data[key] = option.value;
592
+ else
593
+ errors.push({ key, code: 'enum-unknown', value: cell });
594
+ break;
595
+ }
596
+ case 'relation': {
597
+ const lookup = lookups.get(key);
598
+ const texts = property.multiple
599
+ ? String(cell)
600
+ .split(',')
601
+ .map(part => part.trim())
602
+ .filter(Boolean)
603
+ : [String(cell).trim()];
604
+ const values = texts.map(text => lookup?.get(text));
605
+ const missing = texts.filter((_, index) => values[index] === undefined);
606
+ const ambiguous = texts.filter((_, index) => values[index] === SD_GENERIC_AMBIGUOUS);
607
+ if (missing.length)
608
+ errors.push({ key, code: 'relation-not-found', value: property.multiple ? missing.join(', ') : cell });
609
+ else if (ambiguous.length)
610
+ errors.push({ key, code: 'match-ambiguous', value: property.multiple ? ambiguous.join(', ') : cell });
611
+ else
612
+ data[key] = property.multiple ? values : values[0];
613
+ break;
614
+ }
615
+ case 'number': {
616
+ const value = typeof cell === 'number' ? cell : Number(String(cell).trim());
617
+ if (Number.isFinite(value))
618
+ data[key] = value;
619
+ else
620
+ errors.push({ key, code: 'number-invalid', value: cell });
621
+ break;
622
+ }
623
+ case 'boolean':
624
+ data[key] = typeof cell === 'boolean' ? cell : TRUE_VALUES.has(String(cell).trim().toLowerCase());
625
+ break;
626
+ default:
627
+ data[key] = cell;
628
+ }
629
+ }
630
+ return { data, errors };
631
+ };
632
+ /**
633
+ * Update when the upsert key matches one existing record (`existing`: key value -> id), otherwise create. A key
634
+ * value that several records share is not planned: the caller reports the row as ambiguous.
635
+ */
636
+ const sdGenericPlanUpsert = (rows, upsertKey, existing) => rows.map(data => {
637
+ const match = upsertKey && !isBlank(data[upsertKey]) ? existing.get(String(data[upsertKey])) : undefined;
638
+ if (match === SD_GENERIC_AMBIGUOUS)
639
+ return null;
640
+ return match === undefined ? { kind: 'create', data } : { kind: 'update', id: String(match), data };
641
+ });
642
+ /** Runs `worker` over `items` with at most `limit` calls in flight; results keep the item order. */
643
+ const sdGenericRunLimited = async (items, limit, worker) => {
644
+ const results = new Array(items.length);
645
+ let next = 0;
646
+ const lane = async () => {
647
+ while (next < items.length) {
648
+ const index = next++;
649
+ try {
650
+ results[index] = { status: 'fulfilled', value: await worker(items[index], index) };
651
+ }
652
+ catch (reason) {
653
+ results[index] = { status: 'rejected', reason };
654
+ }
655
+ }
656
+ };
657
+ await Promise.all(Array.from({ length: Math.min(Math.max(1, limit), items.length) }, lane));
658
+ return results;
659
+ };
660
+
661
+ /**
662
+ * One property: structure (`key`, `dataType`, `multiple`, `system`, `enums[].value`, `relation.entity`) from the
663
+ * current schema, display and form settings from the stored one.
664
+ */
665
+ const sdGenericMergeProperty = (current, stored) => {
666
+ if (!stored)
667
+ return current;
668
+ const merged = { ...current };
669
+ if (typeof stored.label === 'string')
670
+ merged.label = stored.label;
671
+ if (stored.format !== undefined)
672
+ merged.format = stored.format;
673
+ if (stored.validation !== undefined)
674
+ merged.validation = stored.validation;
675
+ if (Object.hasOwn(stored, 'defaultValue'))
676
+ merged.defaultValue = stored.defaultValue;
677
+ // why: a configuration may only narrow what the backend allows; it never reopens a field the adapter locked.
678
+ if (stored.insertable === false)
679
+ merged.insertable = false;
680
+ if (stored.updatable === false)
681
+ merged.updatable = false;
682
+ if (current.enums) {
683
+ merged.enums = current.enums.map(option => {
684
+ const saved = stored.enums?.find(candidate => candidate.value === option.value);
685
+ if (!saved)
686
+ return option;
687
+ return {
688
+ ...option,
689
+ ...(typeof saved.label === 'string' ? { label: saved.label } : {}),
690
+ ...(saved.color !== undefined ? { color: saved.color } : {}),
691
+ ...(saved.icon !== undefined ? { icon: saved.icon } : {}),
692
+ };
693
+ });
694
+ }
695
+ if (current.relation) {
696
+ const saved = stored.relation;
697
+ merged.relation = {
698
+ ...current.relation,
699
+ ...(saved?.displayField !== undefined ? { displayField: saved.displayField } : {}),
700
+ ...(saved?.display !== undefined ? { display: saved.display } : {}),
701
+ ...(saved?.searchFields !== undefined ? { searchFields: saved.searchFields } : {}),
702
+ };
703
+ }
704
+ return merged;
705
+ };
706
+ /** Removes fields whose key is not in `keys`; groups and html elements stay. */
707
+ const sdGenericPruneLayout = (form, keys) => {
708
+ const prune = (elements) => (Array.isArray(elements) ? elements : []).flatMap((element) => {
709
+ const node = element;
710
+ if (node['type'] === 'group')
711
+ return [{ ...node, elements: prune(node['elements']) }];
712
+ if (node['type'] === 'html')
713
+ return [node];
714
+ return keys.has(node['key']) ? [node] : [];
715
+ });
716
+ return { ...form, pages: form.pages.map(page => ({ ...page, elements: prune(page.elements) })) };
717
+ };
718
+ const mergeSection = (section, keys) => section && { ...section, ...(section.form ? { form: sdGenericPruneLayout(section.form, keys) } : {}) };
719
+ /**
720
+ * Lays a stored configuration over the current schema (INV-002). Dangling references are dropped; new properties
721
+ * join `general` and the configured columns (hidden) but never a stored form layout.
722
+ */
723
+ const sdGenericMergeSchema = (storedInput, currentInput) => {
724
+ const stored = structuredClone(storedInput);
725
+ const current = structuredClone(currentInput);
726
+ const currentByKey = new Map(current.general.properties.map(property => [property.key, property]));
727
+ const storedByKey = new Map(stored.general.properties.map(property => [property.key, property]));
728
+ const keys = new Set(currentByKey.keys());
729
+ const removed = stored.general.properties.map(property => property.key).filter(key => !keys.has(key));
730
+ const added = current.general.properties.map(property => property.key).filter(key => !storedByKey.has(key));
731
+ const properties = [
732
+ ...stored.general.properties
733
+ .filter(property => keys.has(property.key))
734
+ .map(property => sdGenericMergeProperty(currentByKey.get(property.key), property)),
735
+ ...added.map(key => currentByKey.get(key)),
736
+ ];
737
+ const schema = {
738
+ version: 1,
739
+ module: current.module,
740
+ entity: current.entity,
741
+ general: { ...current.general, label: stored.general.label || current.general.label, properties },
742
+ };
743
+ const list = stored.list ?? current.list;
744
+ if (list) {
745
+ schema.list = { ...list };
746
+ if (list.columns) {
747
+ const columns = list.columns.filter(column => keys.has(column.key));
748
+ const listed = new Set(columns.map(column => column.key));
749
+ schema.list.columns = [...columns, ...added.filter(key => !listed.has(key)).map(key => ({ key, visible: false }))];
750
+ }
751
+ // why: external filters are declared in code (backend schema or provideSdGenericEntity), never by a stored
752
+ // configuration. `list` may be the stored one, so drop its value and take the current schema's (INV-004).
753
+ delete schema.list.externalFilters;
754
+ const externalFilters = current.list?.externalFilters;
755
+ if (externalFilters)
756
+ schema.list.externalFilters = externalFilters.filter(filter => keys.has(filter.key));
757
+ if (list.orders)
758
+ schema.list.orders = list.orders.filter(order => keys.has(order.field));
759
+ }
760
+ for (const action of ['detail', 'create', 'update']) {
761
+ const section = mergeSection(stored[action] ?? current[action], keys);
762
+ if (section)
763
+ schema[action] = section;
764
+ }
765
+ const importSection = stored.import ?? current.import;
766
+ if (importSection) {
767
+ schema.import = { ...importSection };
768
+ if (importSection.columns)
769
+ schema.import.columns = importSection.columns.filter(column => keys.has(column.key));
770
+ if (importSection.upsertKey && !keys.has(importSection.upsertKey))
771
+ delete schema.import.upsertKey;
772
+ }
773
+ return { schema, removed, added };
774
+ };
775
+
776
+ /** Upper-case word chain: `purchaseOrder` and `sales.invoice` become `PURCHASE_ORDER` and `SALES_INVOICE`. */
777
+ const segment = (value) => value
778
+ .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
779
+ .replace(/[^A-Za-z0-9]+/g, '_')
780
+ .replace(/^_+|_+$/g, '')
781
+ .toUpperCase();
782
+ /** Permission code `<MODULE>_<ENTITY>_C_GENERIC_<ACTION>`; the only place that builds one (INV-005). */
783
+ const sdGenericPermissionCode = (module, entity, action) => `${segment(module)}_${segment(entity)}_C_GENERIC_${action.toUpperCase()}`;
784
+
785
+ const STRING_FORMATS = new Set(['email', 'phone', 'url', 'password']);
786
+ const NUMBER_FORMATS = new Set(['integer', 'decimal', 'currency', 'percent']);
787
+ /**
788
+ * Key of the shared data-type icon set (`@sdcorejs/angular/modules/icon`) for a property (INV-003).
789
+ * `relation` and `file` keep one icon whether or not they hold several values; a format that does not belong
790
+ * to the data type is ignored. A data type outside the set has no key: the backend schema is not validated.
791
+ */
792
+ function sdGenericPropertyIconKey(property) {
793
+ const format = property.format;
794
+ switch (property.dataType) {
795
+ case 'string':
796
+ if (property.multiple)
797
+ return 'string-multiple';
798
+ return format && STRING_FORMATS.has(format) ? format : 'string';
799
+ case 'number':
800
+ return format && NUMBER_FORMATS.has(format) ? format : 'number';
801
+ case 'enum':
802
+ return property.multiple ? 'enum-multiple' : 'enum';
803
+ default:
804
+ return Object.hasOwn(SD_DATA_TYPE_ICON, property.dataType) ? property.dataType : undefined;
805
+ }
806
+ }
807
+
808
+ const DATA_TYPES = new Set(['string', 'text', 'number', 'boolean', 'date', 'datetime', 'time', 'enum', 'relation', 'json', 'file']);
809
+ /**
810
+ * Issues a load tolerates because a backend change can cause them and the merge or the form builder already
811
+ * handles them: dangling references are dropped (D-013), unknown title placeholders render empty, and fields whose
812
+ * type or create / update flag no longer fits are rebuilt or left out of the form. A save still refuses them.
813
+ */
814
+ const TOLERATED_AT_LOAD = new Set([
815
+ 'reference-dangling',
816
+ 'title-placeholder-unknown',
817
+ 'layout-type-mismatch',
818
+ 'create-not-insertable',
819
+ 'update-not-updatable',
820
+ ]);
821
+ const isRecord = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
822
+ const isStringList = (value) => Array.isArray(value) && value.every(item => typeof item === 'string');
823
+ /** Whether an issue must replace the stored configuration with the default one. */
824
+ const sdGenericBlocksLoad = (issue) => !TOLERATED_AT_LOAD.has(issue.code);
825
+ /** Members of a stored property that the merge reads, checked so that a merge never meets a wrong type. */
826
+ const propertyShapeIssue = (value) => {
827
+ for (const member of ['multiple', 'insertable', 'updatable', 'system']) {
828
+ if (value[member] !== undefined && typeof value[member] !== 'boolean')
829
+ return `${member} must be a boolean.`;
830
+ }
831
+ if (value['format'] !== undefined && typeof value['format'] !== 'string')
832
+ return 'format must be a string.';
833
+ if (value['validation'] !== undefined && !isRecord(value['validation']))
834
+ return 'validation must be an object.';
835
+ const enums = value['enums'];
836
+ if (enums !== undefined && (!Array.isArray(enums) || !enums.every(option => isRecord(option) && typeof option['value'] === 'string')))
837
+ return 'enums must be a list of options with a value.';
838
+ const relation = value['relation'];
839
+ if (relation === undefined)
840
+ return null;
841
+ if (!isRecord(relation))
842
+ return 'relation must be an object.';
843
+ for (const member of ['displayField', 'display']) {
844
+ if (relation[member] !== undefined && typeof relation[member] !== 'string')
845
+ return `relation.${member} must be a string.`;
846
+ }
847
+ if (relation['searchFields'] !== undefined && !isStringList(relation['searchFields']))
848
+ return 'relation.searchFields must be a list of strings.';
849
+ return null;
850
+ };
851
+ /**
852
+ * Validates a stored configuration against the current schema of the entity (INV-003). The same function guards
853
+ * the load and the configuration screen; an empty list means valid.
854
+ */
855
+ function validateSdGenericSchema(stored, base) {
856
+ const issues = [];
857
+ const report = (code, path, message) => issues.push({ code, severity: 'error', path, message });
858
+ /** Items of an optional list member; a present member that is not a list is a `shape` issue. */
859
+ const listAt = (container, member, path) => {
860
+ const value = container[member];
861
+ if (value === undefined)
862
+ return [];
863
+ if (Array.isArray(value))
864
+ return value;
865
+ report('shape', path, `${path} must be a list.`);
866
+ return [];
867
+ };
868
+ if (!isRecord(stored)) {
869
+ report('shape', '$', 'The configuration must be an object.');
870
+ return issues;
871
+ }
872
+ if (stored['version'] !== 1)
873
+ report('version', 'version', `Unsupported configuration version ${String(stored['version'])}; expected 1.`);
874
+ for (const member of ['module', 'entity']) {
875
+ const value = stored[member];
876
+ if (typeof value !== 'string')
877
+ report('shape', member, `${member} must be a string.`);
878
+ else if (value !== base[member])
879
+ report(member === 'module' ? 'module-mismatch' : 'entity-mismatch', member, `${member} "${value}" does not match "${base[member]}".`);
880
+ }
881
+ const general = stored['general'];
882
+ if (!isRecord(general) || typeof general['label'] !== 'string' || !Array.isArray(general['properties'])) {
883
+ report('shape', 'general', 'general must have a label and a properties array.');
884
+ return issues;
885
+ }
886
+ const current = new Map(base.general.properties.map(property => [property.key, property]));
887
+ const keys = new Set(current.keys());
888
+ const storedProperties = new Map();
889
+ general['properties'].forEach((value, index) => {
890
+ const path = `general.properties[${index}]`;
891
+ if (!isRecord(value) || typeof value['key'] !== 'string' || !value['key'] || typeof value['label'] !== 'string') {
892
+ report('shape', path, `${path} must have a key and a label.`);
893
+ return;
894
+ }
895
+ const key = value['key'];
896
+ if (storedProperties.has(key))
897
+ report('property-key-duplicate', `${path}.key`, `The property key "${key}" is used twice.`);
898
+ if (!DATA_TYPES.has(value['dataType']))
899
+ report('property-type', `${path}.dataType`, `Unknown data type "${String(value['dataType'])}".`);
900
+ if (!keys.has(key))
901
+ report('reference-dangling', `${path}.key`, `The property "${key}" no longer exists.`);
902
+ const shapeIssue = propertyShapeIssue(value);
903
+ if (shapeIssue) {
904
+ report('shape', path, `${path}: ${shapeIssue}`);
905
+ return;
906
+ }
907
+ storedProperties.set(key, value);
908
+ });
909
+ const effective = (key) => {
910
+ const property = current.get(key);
911
+ return property && sdGenericMergeProperty(property, storedProperties.get(key));
912
+ };
913
+ const reference = (key, path) => {
914
+ const property = typeof key === 'string' ? effective(key) : undefined;
915
+ if (!property)
916
+ report('reference-dangling', path, `"${String(key)}" is not a property of ${base.module}.${base.entity}.`);
917
+ return property;
918
+ };
919
+ const list = stored['list'];
920
+ if (list !== undefined) {
921
+ if (!isRecord(list))
922
+ report('shape', 'list', 'list must be an object.');
923
+ else {
924
+ listAt(list, 'columns', 'list.columns').forEach((column, index) => reference(isRecord(column) ? column['key'] : undefined, `list.columns[${index}].key`));
925
+ listAt(list, 'externalFilters', 'list.externalFilters').forEach((filter, index) => reference(isRecord(filter) ? filter['key'] : undefined, `list.externalFilters[${index}].key`));
926
+ listAt(list, 'orders', 'list.orders').forEach((order, index) => reference(isRecord(order) ? order['field'] : undefined, `list.orders[${index}].field`));
927
+ const pageSize = list['pageSize'];
928
+ if (pageSize !== undefined && !(Number.isInteger(pageSize) && pageSize > 0))
929
+ report('shape', 'list.pageSize', 'list.pageSize must be a positive integer.');
930
+ }
931
+ }
932
+ const importSection = stored['import'];
933
+ if (importSection !== undefined) {
934
+ if (!isRecord(importSection))
935
+ report('shape', 'import', 'import must be an object.');
936
+ else {
937
+ const columns = importSection['columns'];
938
+ const imported = new Set();
939
+ listAt(importSection, 'columns', 'import.columns').forEach((column, index) => {
940
+ const property = reference(isRecord(column) ? column['key'] : undefined, `import.columns[${index}].key`);
941
+ if (property)
942
+ imported.add(property.key);
943
+ });
944
+ if (!Array.isArray(columns)) {
945
+ for (const key of keys)
946
+ if (sdGenericImportable(effective(key)))
947
+ imported.add(key);
948
+ }
949
+ if (importSection['upsertKey'] !== undefined) {
950
+ const property = reference(importSection['upsertKey'], 'import.upsertKey');
951
+ if (property?.multiple)
952
+ report('upsert-key-multiple', 'import.upsertKey', `The upsert key "${property.key}" cannot hold several values.`);
953
+ else if (property && !imported.has(property.key))
954
+ report('upsert-key-not-imported', 'import.upsertKey', `The upsert key "${property.key}" is not one of the import columns.`);
955
+ }
956
+ }
957
+ }
958
+ for (const action of ['detail', 'create', 'update']) {
959
+ const section = stored[action];
960
+ if (section === undefined)
961
+ continue;
962
+ if (!isRecord(section)) {
963
+ report('shape', action, `${action} must be an object.`);
964
+ continue;
965
+ }
966
+ if (section['form'] === undefined)
967
+ continue;
968
+ const fields = layoutFields(section['form']);
969
+ if (!fields) {
970
+ report('layout-grammar', `${action}.form`, `${action}.form must be pages of groups and fields, with no nested group.`);
971
+ continue;
972
+ }
973
+ for (const { node, path } of fields) {
974
+ if (node['type'] === 'html')
975
+ continue;
976
+ const property = reference(node['key'], `${action}.form.${path}.key`);
977
+ if (!property)
978
+ continue;
979
+ if (!sdGenericAllowedFieldTypes(property).includes(node['type'])) {
980
+ report('layout-type-mismatch', `${action}.form.${path}.type`, `"${property.key}" (${property.dataType}) cannot use a ${String(node['type'])} field.`);
981
+ }
982
+ else if (action === 'create' && !sdGenericCanInsert(property)) {
983
+ report('create-not-insertable', `create.form.${path}.key`, `"${property.key}" cannot be set on create.`);
984
+ }
985
+ else if (action === 'update' && !sdGenericCanUpdate(property)) {
986
+ report('update-not-updatable', `update.form.${path}.key`, `"${property.key}" cannot be changed on update.`);
987
+ }
988
+ }
989
+ }
990
+ for (const section of ['list', 'create', 'detail', 'update']) {
991
+ const value = stored[section];
992
+ if (isRecord(value))
993
+ issues.push(...sdGenericTitleIssues(section, value['title'], keys));
994
+ }
995
+ return issues;
996
+ }
997
+ /** Field nodes of a layout with their paths, or `null` when the layout breaks the form-generic grammar. */
998
+ const layoutFields = (form) => {
999
+ if (!isRecord(form) || !Array.isArray(form['pages']))
1000
+ return null;
1001
+ const fields = [];
1002
+ for (const [pageIndex, page] of form['pages'].entries()) {
1003
+ if (!isRecord(page) || !Array.isArray(page['elements']))
1004
+ return null;
1005
+ for (const [index, element] of page['elements'].entries()) {
1006
+ const path = `pages[${pageIndex}].elements[${index}]`;
1007
+ if (!isRecord(element))
1008
+ return null;
1009
+ if (element['type'] !== 'group') {
1010
+ fields.push({ node: element, path });
1011
+ continue;
1012
+ }
1013
+ if (!Array.isArray(element['elements']))
1014
+ return null;
1015
+ for (const [childIndex, child] of element['elements'].entries()) {
1016
+ if (!isRecord(child) || child['type'] === 'group')
1017
+ return null;
1018
+ fields.push({ node: child, path: `${path}.elements[${childIndex}]` });
1019
+ }
1020
+ }
1021
+ }
1022
+ return fields;
1023
+ };
1024
+
1025
+ // Pure functions shared by every screen of the module (D-019): no DI, no DOM, no HTTP client.
1026
+
1027
+ const DEFAULT_LIMIT = 20;
1028
+ /** Option strings remembered per relation; the oldest are forgotten first. */
1029
+ const KNOWN_LIMIT = 500;
1030
+ const text = (value) => (value === undefined || value === null ? '' : String(value));
1031
+ /** Records `option string -> original value`, keeping at most `KNOWN_LIMIT` entries (least recently set first out). */
1032
+ const remember = (known, option, value) => {
1033
+ known.delete(option);
1034
+ known.set(option, value);
1035
+ if (known.size > KNOWN_LIMIT)
1036
+ known.delete(known.keys().next().value);
1037
+ };
1038
+ /** Relation info carried by the constant params of the relation catalog (D-022). */
1039
+ const infoFromParams = (params) => {
1040
+ const info = {
1041
+ module: text(params['module']),
1042
+ entity: text(params['entity']),
1043
+ valueField: text(params['valueField']) || 'id',
1044
+ displayField: text(params['displayField']) || text(params['valueField']) || 'id',
1045
+ searchFields: text(params['searchFields'])
1046
+ .split(',')
1047
+ .map(field => field.trim())
1048
+ .filter(Boolean),
1049
+ };
1050
+ if (!info.searchFields.length)
1051
+ info.searchFields = [info.displayField];
1052
+ if (text(params['display']))
1053
+ info.display = text(params['display']);
1054
+ return info;
1055
+ };
1056
+ /**
1057
+ * The only caller of the data methods of the adapters (INV-008): applies the save hooks, the search order
1058
+ * (entity search -> adapter search -> `query`) and keeps relation values in their original type.
1059
+ */
1060
+ class SdGenericDataService {
1061
+ #scope = inject(SD_GENERIC_SCOPE);
1062
+ /** `module.entity.valueField` -> option string -> original value. */
1063
+ #known = new Map();
1064
+ async query(module, entity, req) {
1065
+ return this.#adapter(module).query(entity, req);
1066
+ }
1067
+ async detail(module, entity, id) {
1068
+ return this.#adapter(module).detail(entity, id);
1069
+ }
1070
+ async delete(module, entity, id) {
1071
+ await this.#adapter(module).delete(entity, id);
1072
+ }
1073
+ async search(module, entity, req) {
1074
+ const own = this.#scope.entity(module, entity)?.search;
1075
+ if (own)
1076
+ return own(req);
1077
+ const adapter = this.#adapter(module);
1078
+ if (adapter.search)
1079
+ return adapter.search(entity, req);
1080
+ return (await adapter.query(entity, sdGenericSearchPagingReq(req))).items;
1081
+ }
1082
+ /** Saves through the adapter: allowed fields only, relation values restored, then `beforeSave` / `afterSave`. */
1083
+ async save(schema, action, value, id) {
1084
+ const adapter = this.#adapter(schema.module);
1085
+ const hooks = this.#scope.entity(schema.module, schema.entity)?.hooks;
1086
+ let data = this.#restoreRelations(schema, sdGenericFormPayload(schema, action, value));
1087
+ if (hooks?.beforeSave)
1088
+ data = await hooks.beforeSave({ action, data, schema, ...(id === undefined ? {} : { id }) });
1089
+ const result = action === 'create' ? await adapter.create(schema.entity, data) : await adapter.update(schema.entity, id ?? '', data);
1090
+ await hooks?.afterSave?.({ action, data, schema, result, ...(id === undefined ? {} : { id }) });
1091
+ return result;
1092
+ }
1093
+ /** Record prepared for `sd-form-render`: relation values become the option strings of the relation catalog. */
1094
+ toFormValue(schema, record) {
1095
+ const value = { ...record };
1096
+ for (const property of schema.general.properties) {
1097
+ if (property.dataType !== 'relation' || value[property.key] === undefined || value[property.key] === null)
1098
+ continue;
1099
+ const known = this.#knownFor(sdGenericRelationInfo(property, schema.module));
1100
+ const toText = (item) => {
1101
+ remember(known, String(item), item);
1102
+ return String(item);
1103
+ };
1104
+ const current = value[property.key];
1105
+ value[property.key] = Array.isArray(current) ? current.map(toText) : toText(current);
1106
+ }
1107
+ return value;
1108
+ }
1109
+ /** Options of the relation catalog, by term, by values, or the first page. */
1110
+ async relationItems(params, request) {
1111
+ const info = infoFromParams(params);
1112
+ const known = this.#knownFor(info);
1113
+ const records = await this.search(info.module, info.entity, {
1114
+ fields: info.searchFields,
1115
+ valueField: info.valueField,
1116
+ // why: option strings go back to their original type (a numeric id stays a number) before reaching the adapter.
1117
+ ...(request.values
1118
+ ? { values: request.values.map(value => (known.has(value) ? known.get(value) : value)) }
1119
+ : { term: request.term ?? '', limit: DEFAULT_LIMIT }),
1120
+ });
1121
+ return records.map(record => {
1122
+ remember(known, text(record[info.valueField]), record[info.valueField]);
1123
+ return { value: text(record[info.valueField]), label: sdGenericRecordLabel(record, info), data: record };
1124
+ });
1125
+ }
1126
+ /** Search function of a relation column or filter of `sd-table`. */
1127
+ relationSearch(schema, property) {
1128
+ const info = sdGenericRelationInfo(property, schema.module);
1129
+ return async (args) => {
1130
+ const values = args.type === 'VALUE' ? [].concat(args.value ?? []) : undefined;
1131
+ const records = await this.search(info.module, info.entity, {
1132
+ fields: args.searchFields?.length ? args.searchFields : info.searchFields,
1133
+ valueField: info.valueField,
1134
+ ...(values ? { values } : { term: args.searchText ?? '', limit: DEFAULT_LIMIT }),
1135
+ });
1136
+ return this.#labelled(records, info);
1137
+ };
1138
+ }
1139
+ /** Related records of displayed values for a relation column of `sd-table`. */
1140
+ relationViews(schema, property) {
1141
+ const info = sdGenericRelationInfo(property, schema.module);
1142
+ const known = this.#knownFor(info);
1143
+ return async (values) => this.#labelled(await this.search(info.module, info.entity, {
1144
+ values: values.map(value => (known.has(value) ? known.get(value) : value)),
1145
+ fields: info.searchFields,
1146
+ valueField: info.valueField,
1147
+ }), info);
1148
+ }
1149
+ /** Lookups of the table columns and filters of a schema. */
1150
+ columnDeps(schema) {
1151
+ return {
1152
+ relationSearch: property => this.relationSearch(schema, property),
1153
+ relationViews: property => this.relationViews(schema, property),
1154
+ };
1155
+ }
1156
+ #labelled(records, info) {
1157
+ return info.display ? records.map(record => ({ ...record, [SD_GENERIC_LABEL_FIELD]: sdGenericRecordLabel(record, info) })) : records;
1158
+ }
1159
+ #restoreRelations(schema, data) {
1160
+ for (const property of schema.general.properties) {
1161
+ if (property.dataType === 'relation' && Object.hasOwn(data, property.key)) {
1162
+ data[property.key] = sdGenericCoerceValue(data[property.key], this.#knownFor(sdGenericRelationInfo(property, schema.module)));
1163
+ }
1164
+ }
1165
+ return data;
1166
+ }
1167
+ #knownFor(info) {
1168
+ const key = `${info.module}.${info.entity}.${info.valueField}`;
1169
+ let known = this.#known.get(key);
1170
+ if (!known)
1171
+ this.#known.set(key, (known = new Map()));
1172
+ return known;
1173
+ }
1174
+ #adapter(module) {
1175
+ const adapter = this.#scope.adapter(module);
1176
+ if (!adapter)
1177
+ throw new Error(`SdGeneric: no adapter is registered for the module "${module}".`);
1178
+ return adapter;
1179
+ }
1180
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericDataService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
1181
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericDataService });
1182
+ }
1183
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericDataService, decorators: [{
1184
+ type: Injectable
1185
+ }] });
1186
+
1187
+ /** Runs one lookup per batch, at most five at a time; the first failed batch fails the import. */
1188
+ const lookupBatches = async (values, lookup) => {
1189
+ const settled = await sdGenericRunLimited(sdGenericChunk(values, SD_GENERIC_IMPORT_LOOKUP_SIZE), SD_GENERIC_IMPORT_CONCURRENCY, lookup);
1190
+ return settled.flatMap(outcome => {
1191
+ if (outcome.status === 'rejected')
1192
+ throw outcome.reason;
1193
+ return outcome.value;
1194
+ });
1195
+ };
1196
+ /**
1197
+ * Imports spreadsheet rows (INV-014): converts cells, looks up relations and existing records in batches, then
1198
+ * creates or updates through `SdGenericDataService` (so hooks apply) with at most five saves in flight.
1199
+ */
1200
+ class SdGenericImportService {
1201
+ #data = inject(SdGenericDataService);
1202
+ columns(schema) {
1203
+ return sdGenericImportColumns(schema);
1204
+ }
1205
+ async run(schema, rows) {
1206
+ const columns = this.columns(schema);
1207
+ const lookups = await this.#relationLookups(schema, columns, rows);
1208
+ const parsed = rows.map(row => sdGenericParseImportRow(row, columns, lookups));
1209
+ const results = parsed.map((row, index) => ({
1210
+ index,
1211
+ status: row.errors.length ? 'error' : 'created',
1212
+ errors: row.errors,
1213
+ }));
1214
+ const valid = parsed.flatMap((row, index) => (row.errors.length ? [] : [{ data: row.data, index }]));
1215
+ const data = valid.map(item => item.data);
1216
+ const upsertKey = schema.import?.upsertKey;
1217
+ const existing = upsertKey ? await this.#existing(schema, upsertKey, data) : new Map();
1218
+ const ops = [];
1219
+ sdGenericPlanUpsert(data, upsertKey, existing).forEach((op, position) => {
1220
+ const { index } = valid[position];
1221
+ if (op)
1222
+ ops.push({ op, index });
1223
+ else
1224
+ results[index] = {
1225
+ index,
1226
+ status: 'error',
1227
+ errors: [{ key: upsertKey, code: 'match-ambiguous', value: data[position][upsertKey] }],
1228
+ };
1229
+ });
1230
+ const settled = await sdGenericRunLimited(ops, SD_GENERIC_IMPORT_CONCURRENCY, ({ op }) => op.kind === 'create' ? this.#data.save(schema, 'create', op.data) : this.#data.save(schema, 'update', op.data, op.id));
1231
+ settled.forEach((outcome, position) => {
1232
+ const { op, index } = ops[position];
1233
+ const result = results[index];
1234
+ if (outcome.status === 'fulfilled')
1235
+ result.status = op.kind === 'create' ? 'created' : 'updated';
1236
+ else {
1237
+ result.status = 'error';
1238
+ result.message = outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason);
1239
+ }
1240
+ });
1241
+ return results;
1242
+ }
1243
+ /** `property key -> cell text -> stored value` for each relation column, searched in batches. */
1244
+ async #relationLookups(schema, columns, rows) {
1245
+ const lookups = new Map();
1246
+ for (const column of columns.filter(item => item.property.dataType === 'relation')) {
1247
+ const info = sdGenericRelationInfo(column.property, schema.module);
1248
+ const matchField = column.matchField ?? info.displayField;
1249
+ const texts = [
1250
+ ...new Set(rows
1251
+ .map(row => row[column.key])
1252
+ .filter(value => !sdGenericIsBlank(value))
1253
+ .flatMap(value => (column.property.multiple ? String(value).split(',') : [String(value)]))
1254
+ .map(value => value.trim())
1255
+ .filter(Boolean)),
1256
+ ];
1257
+ const records = await lookupBatches(texts, batch => this.#data.search(info.module, info.entity, { values: batch, fields: [matchField], valueField: matchField }));
1258
+ lookups.set(column.key, sdGenericLookupMap(records.map(record => [String(record[matchField]), record[info.valueField]])));
1259
+ }
1260
+ return lookups;
1261
+ }
1262
+ /** `upsert key value -> id` of the records that already exist, paging until each batch is complete. */
1263
+ async #existing(schema, upsertKey, rows) {
1264
+ const values = [...new Set(rows.map(row => row[upsertKey]).filter(value => !sdGenericIsBlank(value)))];
1265
+ const primaryKey = sdGenericPrimaryKey(schema);
1266
+ const records = await lookupBatches(values, async (batch) => {
1267
+ const filters = [{ field: upsertKey, operator: 'IN', data: batch }];
1268
+ const items = [];
1269
+ for (let pageNumber = 0;; pageNumber++) {
1270
+ const page = await this.#data.query(schema.module, schema.entity, { pageNumber, pageSize: batch.length, filters });
1271
+ items.push(...page.items);
1272
+ // why: a backend may cap the page size; keep reading until the reported total is reached.
1273
+ if (!page.items.length || items.length >= page.total)
1274
+ return items;
1275
+ }
1276
+ });
1277
+ return sdGenericLookupMap(records.map(record => [String(record[upsertKey]), String(record[primaryKey])]));
1278
+ }
1279
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericImportService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
1280
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericImportService });
1281
+ }
1282
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericImportService, decorators: [{
1283
+ type: Injectable
1284
+ }] });
1285
+
1286
+ /**
1287
+ * Permission checks of the generic screens (INV-005). Codes come from `sdGenericPermissionCode`; the default
1288
+ * permission key of the portal is used (D-029). These checks hide UI and block routes only: the backend behind
1289
+ * the adapter must enforce permissions again.
1290
+ */
1291
+ class SdGenericPermissionService {
1292
+ #scope = inject(SD_GENERIC_SCOPE);
1293
+ // why: SdPermissionService requires SD_PERMISSION_CONFIGURATION; with `permission: false` a portal may have none,
1294
+ // so the service is only resolved when a check really runs.
1295
+ #injector = inject(Injector);
1296
+ #loading;
1297
+ get enabled() {
1298
+ return this.#scope.permissionEnabled();
1299
+ }
1300
+ can(module, entity, action) {
1301
+ return !this.enabled || this.#service().hasPermission(sdGenericPermissionCode(module, entity, action));
1302
+ }
1303
+ /** Whether `provideSdGenericEntity({ hiddenDefaults })` hides the default action; `list` and `configuration` never are. */
1304
+ hides(module, entity, action) {
1305
+ return this.#scope.entity(module, entity)?.hiddenDefaults?.includes(action) ?? false;
1306
+ }
1307
+ /** The one rule of a default action, shared by the screens and the route guard: not hidden, and permitted. */
1308
+ allows(module, entity, action) {
1309
+ return !this.hides(module, entity, action) && this.can(module, entity, action);
1310
+ }
1311
+ /** A custom action without `permission` is allowed. */
1312
+ canCode(code) {
1313
+ return !this.enabled || !code || this.#service().hasPermission(code);
1314
+ }
1315
+ /**
1316
+ * Loads the permission list before a route check; a failed load denies instead of throwing. Only a load in
1317
+ * flight is shared: SdPermissionService skips keys it already loaded, and its `reset()` on sign-out must make
1318
+ * the next check load the permissions of the new user.
1319
+ */
1320
+ ensureLoaded() {
1321
+ if (!this.enabled)
1322
+ return Promise.resolve();
1323
+ this.#loading ??= this.#service()
1324
+ .loadPermissions()
1325
+ .catch(error => console.error(error))
1326
+ .finally(() => (this.#loading = undefined));
1327
+ return this.#loading;
1328
+ }
1329
+ #service() {
1330
+ return this.#injector.get(SdPermissionService);
1331
+ }
1332
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericPermissionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
1333
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericPermissionService });
1334
+ }
1335
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericPermissionService, decorators: [{
1336
+ type: Injectable
1337
+ }] });
1338
+
1339
+ /**
1340
+ * Holds the environment injector of a generic route. form-generic catalogs are plain objects created before any
1341
+ * injector exists, so `sdGenericRoutes()` attaches the route injector here once Angular creates it (D-022).
1342
+ */
1343
+ class SdGenericCatalogBridge {
1344
+ #injector;
1345
+ attach(injector) {
1346
+ this.#injector = injector;
1347
+ }
1348
+ data() {
1349
+ if (!this.#injector)
1350
+ throw new Error('SdGeneric: the relation catalog is only available inside a generic route.');
1351
+ return this.#injector.get(SdGenericDataService);
1352
+ }
1353
+ }
1354
+ const param = (name) => ({ name, label: name, required: name === 'module' || name === 'entity' });
1355
+ /** The single form-generic catalog behind every relation select; params identify the relation. */
1356
+ const sdGenericRelationCatalog = (bridge) => ({
1357
+ id: SD_GENERIC_RELATION_CATALOG,
1358
+ label: 'Generic relation',
1359
+ params: ['module', 'entity', 'valueField', 'displayField', 'searchFields', 'display'].map(param),
1360
+ load: async (params) => bridge.data().relationItems(params, {}),
1361
+ search: async (term, params) => bridge.data().relationItems(params, { term }),
1362
+ labels: async (values, params) => bridge.data().relationItems(params, { values }),
1363
+ });
1364
+
1365
+ /**
1366
+ * Copy of a stored configuration without `list.externalFilters`. External filters are declared in code (backend
1367
+ * schema or `provideSdGenericEntity`), so a stored configuration neither carries nor contributes them (INV-004).
1368
+ * Anything that is not a configuration object is returned unchanged for the validator to report.
1369
+ */
1370
+ function withoutExternalFilters(configuration) {
1371
+ const list = configuration?.list;
1372
+ if (!list || typeof list !== 'object' || Array.isArray(list) || !('externalFilters' in list))
1373
+ return configuration;
1374
+ const rest = { ...list };
1375
+ delete rest['externalFilters'];
1376
+ return { ...configuration, list: rest };
1377
+ }
1378
+ /**
1379
+ * Owns the effective schema of each entity (INV-002): adapter schema -> entity schema function -> stored
1380
+ * configuration (validated, then merged). It is the only caller of `adapter.schema` and of the schema store.
1381
+ */
1382
+ class SdGenericSchemaService {
1383
+ #scope = inject(SD_GENERIC_SCOPE);
1384
+ #cache = new Map();
1385
+ resolve(module, entity) {
1386
+ const key = `${module}.${entity}`;
1387
+ let pending = this.#cache.get(key);
1388
+ if (!pending) {
1389
+ pending = this.#load(module, entity);
1390
+ // why: a failed load must not stay cached, so the next navigation retries.
1391
+ pending.catch(() => this.#cache.delete(key));
1392
+ this.#cache.set(key, pending);
1393
+ }
1394
+ return pending;
1395
+ }
1396
+ /** Validates, stores and drops the cached schema of the entity; returns the issues when it refuses to save. */
1397
+ async save(module, entity, schema) {
1398
+ const { base } = await this.resolve(module, entity);
1399
+ const configuration = withoutExternalFilters(schema);
1400
+ const issues = validateSdGenericSchema(configuration, base);
1401
+ if (issues.length)
1402
+ return issues;
1403
+ await this.#store(this.#adapter(module)).set(entity, configuration);
1404
+ this.invalidate(module, entity);
1405
+ return [];
1406
+ }
1407
+ invalidate(module, entity) {
1408
+ this.#cache.delete(`${module}.${entity}`);
1409
+ }
1410
+ async #load(module, entity) {
1411
+ const adapter = this.#adapter(module);
1412
+ const config = this.#scope.entity(module, entity);
1413
+ let base = await adapter.schema(entity);
1414
+ if (config?.schema)
1415
+ base = await config.schema(structuredClone(base));
1416
+ const stored = withoutExternalFilters(await this.#store(adapter).get(entity));
1417
+ if (stored === null || stored === undefined)
1418
+ return { schema: base, base, invalid: false, issues: [], removed: [], added: [] };
1419
+ const issues = validateSdGenericSchema(stored, base);
1420
+ if (issues.some(sdGenericBlocksLoad)) {
1421
+ console.warn(`SdGeneric: the stored configuration of ${module}.${entity} is invalid; the default configuration is in use.`, issues);
1422
+ return { schema: base, base, invalid: true, issues, removed: [], added: [] };
1423
+ }
1424
+ try {
1425
+ const merged = sdGenericMergeSchema(stored, base);
1426
+ return { schema: merged.schema, base, invalid: false, issues, removed: merged.removed, added: merged.added };
1427
+ }
1428
+ catch (error) {
1429
+ // why: a configuration the validator did not foresee must still fall back to the default one (AC-007).
1430
+ const issue = {
1431
+ code: 'shape',
1432
+ severity: 'error',
1433
+ path: '$',
1434
+ message: `The configuration cannot be merged: ${String(error)}`,
1435
+ };
1436
+ console.warn(`SdGeneric: the stored configuration of ${module}.${entity} is invalid; the default configuration is in use.`, [issue]);
1437
+ return { schema: base, base, invalid: true, issues: [...issues, issue], removed: [], added: [] };
1438
+ }
1439
+ }
1440
+ #adapter(module) {
1441
+ const adapter = this.#scope.adapter(module);
1442
+ if (!adapter)
1443
+ throw new Error(`SdGeneric: no adapter is registered for the module "${module}".`);
1444
+ return adapter;
1445
+ }
1446
+ #store(adapter) {
1447
+ return adapter.schemaStore ?? new SdGenericLocalStore(adapter.module);
1448
+ }
1449
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericSchemaService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
1450
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericSchemaService });
1451
+ }
1452
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: SdGenericSchemaService, decorators: [{
1453
+ type: Injectable
1454
+ }] });
1455
+
1456
+ /** `module`, `entity` and `id` of a generic route, read from every ancestor because nested routes do not inherit params. */
1457
+ const sdGenericRouteParams = (route) => {
1458
+ const read = (key) => route.pathFromRoot
1459
+ .map(snapshot => snapshot.paramMap.get(key))
1460
+ .filter((value) => value !== null)
1461
+ .pop() ?? null;
1462
+ return { module: read('module') ?? '', entity: read('entity') ?? '', id: read('id') };
1463
+ };
1464
+ /**
1465
+ * Module and entity names a route may carry: letters, digits, `_` and `-`, with single dots between parts. It
1466
+ * keeps decoded `/`, `..` and other separators away from permission codes and adapter calls.
1467
+ */
1468
+ const NAME = /^[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*$/;
1469
+ /**
1470
+ * Blocks a generic route without its permission code (INV-005), with an unsafe module / entity name, or whose
1471
+ * action the entity hides through `hiddenDefaults`. Permissions are loaded before the check.
1472
+ */
1473
+ const sdGenericPermissionGuard = (action) => async (route) => {
1474
+ const permission = inject(SdGenericPermissionService);
1475
+ const { module, entity } = sdGenericRouteParams(route);
1476
+ if (!NAME.test(module) || !NAME.test(entity))
1477
+ return false;
1478
+ // why: a hidden route is refused before the permission list is loaded.
1479
+ if (permission.hides(module, entity, action))
1480
+ return false;
1481
+ await permission.ensureLoaded();
1482
+ return permission.allows(module, entity, action);
1483
+ };
1484
+ /** Resolves the effective schema before the page renders; a failure becomes `error` instead of a navigation error. */
1485
+ const sdGenericSchemaResolver = async (route) => {
1486
+ const schemas = inject(SdGenericSchemaService);
1487
+ const scope = inject(SD_GENERIC_SCOPE);
1488
+ const i18n = inject(I18nService);
1489
+ const { module, entity } = sdGenericRouteParams(route);
1490
+ if (!scope.adapter(module))
1491
+ return { module, entity, resolved: null, error: i18n.t('core.module.generic.error.adapter-missing', { module }) };
1492
+ try {
1493
+ return { module, entity, resolved: await schemas.resolve(module, entity), error: null };
1494
+ }
1495
+ catch (error) {
1496
+ return { module, entity, resolved: null, error: error instanceof Error ? error.message : String(error) };
1497
+ }
1498
+ };
1499
+
1500
+ /**
1501
+ * Routes of the generic module:
1502
+ * `generic/:module/:entity` (list), `create`, `:id/detail`, `:id/update` (page or side drawer over the list)
1503
+ * and `configuration`. Mount them where the adapters of the module are provided (root or the lazy route).
1504
+ *
1505
+ * @example
1506
+ * { path: 'tms', providers: [provideSdGeneric({ adapters: [TmsAdapter] })], children: sdGenericRoutes() }
1507
+ */
1508
+ function sdGenericRoutes() {
1509
+ const bridge = new SdGenericCatalogBridge();
1510
+ // why: a portal SdPermissionGuard denies routes without data.permission; the generic guards check the real
1511
+ // codes, which depend on :module/:entity and cannot be static route data (D-024).
1512
+ const data = (action) => ({ permission: SD_PERMISSION_PUBLIC, ...(action ? { sdGenericAction: action } : {}) });
1513
+ const form = (action) => ({
1514
+ path: action === 'create' ? 'create' : `:id/${action}`,
1515
+ data: data(action),
1516
+ canActivate: [sdGenericPermissionGuard(action)],
1517
+ loadComponent: () => import('./sdcorejs-angular-modules-generic-generic-form-host.page-BsEL-y-M.mjs').then(m => m.GenericFormHostPage),
1518
+ });
1519
+ return [
1520
+ {
1521
+ path: 'generic/:module/:entity',
1522
+ data: data(),
1523
+ providers: [
1524
+ SdGenericSchemaService,
1525
+ SdGenericDataService,
1526
+ SdGenericPermissionService,
1527
+ provideSdFormGeneric({ catalogs: [sdGenericRelationCatalog(bridge)] }),
1528
+ provideEnvironmentInitializer(() => bridge.attach(inject(EnvironmentInjector))),
1529
+ ],
1530
+ children: [
1531
+ {
1532
+ path: 'configuration',
1533
+ data: data('configuration'),
1534
+ canActivate: [sdGenericPermissionGuard('configuration')],
1535
+ resolve: { generic: sdGenericSchemaResolver },
1536
+ loadComponent: () => import('./sdcorejs-angular-modules-generic-generic-configuration.page-BR6jxyYd.mjs').then(m => m.GenericConfigurationPage),
1537
+ },
1538
+ {
1539
+ path: '',
1540
+ data: data('list'),
1541
+ canActivate: [sdGenericPermissionGuard('list')],
1542
+ resolve: { generic: sdGenericSchemaResolver },
1543
+ loadComponent: () => import('./sdcorejs-angular-modules-generic-generic-list.page-qTFKh4UG.mjs').then(m => m.GenericListPage),
1544
+ children: [form('create'), form('detail'), form('update')],
1545
+ },
1546
+ ],
1547
+ },
1548
+ ];
1549
+ }
1550
+
1551
+ /**
1552
+ * Generated bundle index. Do not edit.
1553
+ */
1554
+
1555
+ export { SdGenericDataService as S, SdGenericPermissionService as a, SD_GENERIC_SCOPE as b, SD_GENERIC_LIST_HOST as c, sdGenericRenderTitle as d, sdGenericRouteParams as e, sdGenericCanInsert as f, sdGenericCanUpdate as g, sdGenericFieldType as h, sdGenericPropertyIconKey as i, sdGenericImportColumns as j, sdGenericImportable as k, sdGenericListColumns as l, sdGenericPageSize as m, SdGenericSchemaService as n, SdGenericImportService as o, sdGenericPrimaryKey as p, sdGenericExternalFilters as q, sdGenericTableColumns as r, sdGenericBuildForm as s, provideSdGeneric as t, provideSdGenericEntity as u, sdGenericRoutes as v, validateSdGenericSchema as w };
1556
+ //# sourceMappingURL=sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-Cq0GFfo1.mjs.map