@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,342 @@
1
+ # Header actions
2
+
3
+ Nút ở header của trang và tác vụ trên dòng, trên thanh chọn nhiều. Mẫu: `/pattern/product` (menu Nhập/Xuất + Tạo mới), `/pattern/order/:id/detail` (tác vụ theo trạng thái duyệt), `/pattern/order` (tác vụ hàng loạt), `/pattern/category` (thao tác theo dòng).
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Header chứa tác vụ của cả trang: tạo mới, nhập, xuất, cập nhật bản ghi, tác vụ trạng thái.
8
+ - Tác vụ của một dòng: `command` của `sd-table`; của nhiều dòng đã chọn: `selector.actions`.
9
+
10
+ ## Code mẫu
11
+
12
+ Một wrapper `headerRight`; nút chính `type="fill"` ngoài cùng bên phải; menu dùng Action Popover của `sd-button`:
13
+
14
+ <!-- @source features/product/pages/list/list.component.html -->
15
+ ```html
16
+ <sd-page-list title="Sản phẩm" description="Danh mục sản phẩm đang kinh doanh.">
17
+ <div headerRight class="d-flex align-items-center gap-8 flex-wrap">
18
+ <sd-button
19
+ *sdPermission="'PATTERN_PRODUCT_R_MENU'"
20
+ title="Nhập/Xuất"
21
+ suffixIcon="expand_more"
22
+ type="outline"
23
+ autoId="product-data-menu">
24
+ <sd-button-item *sdPermission="'PATTERN_PRODUCT_C_IMPORT'" prefixIcon="upload" (click)="openImport()">Nhập dữ liệu</sd-button-item>
25
+ <sd-button-item *sdPermission="'PATTERN_PRODUCT_R_EXPORT'" prefixIcon="download" (click)="exportData()">Xuất dữ liệu</sd-button-item>
26
+ </sd-button>
27
+ <sd-button
28
+ *sdPermission="'PATTERN_PRODUCT_C_CREATE'"
29
+ title="Tạo mới"
30
+ prefixIcon="add"
31
+ type="fill"
32
+ color="primary"
33
+ autoId="product-create"
34
+ [routerLink]="['create']" />
35
+ </div>
36
+
37
+ <sd-table autoId="product-list" [option]="tableOption">
38
+ <ng-template sdTableCellDef="code" let-product="item">
39
+ <a *sdPermission="'PATTERN_PRODUCT_R_DETAIL'" [routerLink]="[product.id, 'detail']">{{ product.code }}</a>
40
+ @if (!canOpenDetail) {
41
+ <span>{{ product.code }}</span>
42
+ }
43
+ </ng-template>
44
+ </sd-table>
45
+ </sd-page-list>
46
+ ```
47
+
48
+ Tác vụ theo quyền và trạng thái, xác nhận trước khi đổi trạng thái, Từ chối bắt buộc lý do:
49
+
50
+ <!-- @source features/order/pages/detail/detail.component.ts -->
51
+ ```ts
52
+ import { AsyncPipe, NgTemplateOutlet } from '@angular/common';
53
+ import { afterNextRender, ChangeDetectionStrategy, Component, computed, inject, linkedSignal, signal, viewChild } from '@angular/core';
54
+ import { toSignal } from '@angular/core/rxjs-interop';
55
+ import { ActivatedRoute, Router, RouterLink } from '@angular/router';
56
+ import { firstValueFrom, map } from 'rxjs';
57
+ import { SdBadge } from '@sdcorejs/angular/components/badge';
58
+ import { SdButton } from '@sdcorejs/angular/components/button';
59
+ import { SdSection, SdSectionItem } from '@sdcorejs/angular/components/section';
60
+ import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
61
+ import { SdView } from '@sdcorejs/angular/components/view';
62
+ import { SD_PAGE_LIST, SdPageComponent } from '@sdcorejs/angular/modules/layout';
63
+ import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
64
+ import { SdEmptyPipe, SdFormatDatePipe, SdFormatDatetimePipe, SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
65
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
66
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
67
+ import { apiErrorMessage } from '../../../../utils/api-error';
68
+ import { CustomerDetailPipe } from '../../../customer/pipes/customer-detail.pipe';
69
+ import { ApprovalStepsComponent } from '../../components/approval-steps/approval-steps.component';
70
+ import { LinesViewComponent } from '../../components/lines-view/lines-view.component';
71
+ import { OrderService } from '../../services/order.service';
72
+ import {
73
+ canUpdateOrder,
74
+ ORDER_APPROVAL_OPTIONS,
75
+ orderApprovalBadge,
76
+ orderStatusBadge,
77
+ type OrderAction,
78
+ type OrderDto,
79
+ } from '../../services/order.model';
80
+
81
+ /**
82
+ * Chi tiết đơn (`:id/detail`, route con của danh sách). Mở trong drawer 600px hoặc trang `sd-page-detail` theo
83
+ * `detail` của `sd-page-list`. Gửi duyệt, Duyệt và Từ chối đều hỏi xác nhận; Từ chối bắt buộc lý do (E13).
84
+ */
85
+ @Component({
86
+ selector: 'detail',
87
+ standalone: true,
88
+ imports: [
89
+ AsyncPipe,
90
+ NgTemplateOutlet,
91
+ RouterLink,
92
+ SdPageComponent,
93
+ SdSideDrawer,
94
+ SdBadge,
95
+ SdButton,
96
+ SdSection,
97
+ SdSectionItem,
98
+ SdView,
99
+ SdPermissionDirective,
100
+ SdEmptyPipe,
101
+ SdFormatDatePipe,
102
+ SdFormatDatetimePipe,
103
+ SdFormatNumberPipe,
104
+ CustomerDetailPipe,
105
+ ApprovalStepsComponent,
106
+ LinesViewComponent,
107
+ ],
108
+ changeDetection: ChangeDetectionStrategy.OnPush,
109
+ template: `
110
+ @let order = entity();
111
+ @let customer = order.customerId | customerDetail | async;
112
+ <ng-template #actions>
113
+ @if (order.approval === 'submitted') {
114
+ <sd-button
115
+ *sdPermission="'PATTERN_ORDER_U_REJECT'"
116
+ title="Từ chối"
117
+ prefixIcon="close"
118
+ type="light"
119
+ color="warning"
120
+ autoId="order-reject"
121
+ [disabled]="pending()"
122
+ (click)="act('reject')" />
123
+ <sd-button
124
+ *sdPermission="'PATTERN_ORDER_U_APPROVE'"
125
+ title="Duyệt"
126
+ prefixIcon="check"
127
+ type="fill"
128
+ color="success"
129
+ autoId="order-approve"
130
+ [disabled]="pending()"
131
+ (click)="act('approve')" />
132
+ }
133
+ @if (editable()) {
134
+ <sd-button
135
+ *sdPermission="'PATTERN_ORDER_U_SUBMIT'"
136
+ title="Gửi duyệt"
137
+ prefixIcon="send"
138
+ type="outline"
139
+ autoId="order-submit"
140
+ [disabled]="pending()"
141
+ (click)="act('submit')" />
142
+ <sd-button
143
+ *sdPermission="'PATTERN_ORDER_U_UPDATE'"
144
+ title="Cập nhật đơn hàng"
145
+ prefixIcon="edit"
146
+ type="fill"
147
+ color="primary"
148
+ autoId="order-update"
149
+ [disabled]="pending()"
150
+ [routerLink]="['../update']" />
151
+ }
152
+ </ng-template>
153
+
154
+ @if (mode() === 'drawer') {
155
+ <sd-side-drawer width="600px" autoId="order-detail" (sdClosed)="closed()">
156
+ <div sdHeaderLeft class="d-flex align-items-center gap-8">
157
+ <span class="T16M">Đơn hàng {{ order.code }}</span>
158
+ <sd-badge size="md" type="round" [title]="statusBadge().title" [color]="statusBadge().color" />
159
+ </div>
160
+ <sd-section title="Thông tin chung">
161
+ <sd-section-item label="Khách hàng">{{ order.customer }}</sd-section-item>
162
+ <sd-section-item label="Kênh bán">{{ order.channel }}</sd-section-item>
163
+ <sd-section-item label="Kho xuất">{{ order.warehouse }}</sd-section-item>
164
+ <sd-section-item label="Thanh toán">{{ order.payment }}</sd-section-item>
165
+ <sd-section-item label="Ngày tạo">{{ order.createdAt | sdFormatDatetime }}</sd-section-item>
166
+ <sd-section-item label="Tổng tiền (₫)">{{ order.total | sdFormatNumber: 0 }}</sd-section-item>
167
+ <sd-section-item label="Trạng thái">{{ statusBadge().title }} · {{ approvalName() }}</sd-section-item>
168
+ </sd-section>
169
+ <div sdFooterRight class="d-flex align-items-center gap-8 flex-wrap">
170
+ <ng-container [ngTemplateOutlet]="actions" />
171
+ </div>
172
+ </sd-side-drawer>
173
+ } @else {
174
+ <sd-page-detail
175
+ [title]="'Chi tiết đơn hàng #' + order.code"
176
+ [description]="order.customer + ' · ' + order.channel"
177
+ [badges]="badges()"
178
+ [backLink]="['../..']">
179
+ <div headerRight class="d-flex align-items-center gap-8 flex-wrap">
180
+ <ng-container [ngTemplateOutlet]="actions" />
181
+ </div>
182
+ <div class="d-flex flex-column gap-16 py-16">
183
+ <sd-section title="Thông tin chung">
184
+ <div class="row p-8">
185
+ <div class="col-12 col-md-6 p-8"><sd-view label="Khách hàng" [display]="order.customer" /></div>
186
+ <div class="col-12 col-md-6 p-8"><sd-view label="Điện thoại" [display]="customer?.phone" /></div>
187
+ <div class="col-12 col-md-6 p-8"><sd-view label="Kênh bán" [display]="order.channel" /></div>
188
+ <div class="col-12 col-md-6 p-8"><sd-view label="Kho xuất" [display]="order.warehouse" /></div>
189
+ <div class="col-12 col-md-6 p-8"><sd-view label="Thanh toán" [display]="order.payment" /></div>
190
+ <div class="col-12 col-md-6 p-8"><sd-view label="Ngày tạo" [display]="order.createdAt | sdFormatDatetime" /></div>
191
+ <div class="col-12 col-md-6 p-8"><sd-view label="Ngày giao" [display]="order.deliveredAt | sdFormatDate" /></div>
192
+ <div class="col-12 col-md-6 p-8"><sd-view label="Mã vận đơn" [display]="order.tracking" /></div>
193
+ </div>
194
+ </sd-section>
195
+ <lines-view [lines]="order.lines" />
196
+ <sd-section title="Thông tin phê duyệt">
197
+ <sd-section-item label="Trạng thái duyệt">{{ approvalName() }}</sd-section-item>
198
+ <sd-section-item label="Người gửi duyệt">{{ submitted()?.by | sdEmpty }}</sd-section-item>
199
+ <sd-section-item label="Người duyệt">{{ decided()?.by | sdEmpty }}</sd-section-item>
200
+ <sd-section-item label="Lý do từ chối">{{ decided()?.reason | sdEmpty }}</sd-section-item>
201
+ <sd-section-item label="Ghi chú">{{ order.note | sdEmpty }}</sd-section-item>
202
+ </sd-section>
203
+ </div>
204
+ <approval-steps sdAside [steps]="order.approvalHistory" />
205
+ </sd-page-detail>
206
+ }
207
+ `,
208
+ })
209
+ export class DetailComponent {
210
+ readonly #orderService = inject(OrderService);
211
+ readonly #confirm = inject(SdConfirmService);
212
+ readonly #notify = inject(SdNotifyService);
213
+ readonly #router = inject(Router);
214
+ readonly #route = inject(ActivatedRoute);
215
+ private readonly drawer = viewChild(SdSideDrawer);
216
+ protected readonly mode = inject(SD_PAGE_LIST).detail;
217
+ readonly #resolved = toSignal(this.#route.data.pipe(map(data => data['entity'] as OrderDto)), { requireSync: true });
218
+ /** Đơn do resolver tải; sau mỗi tác vụ thay bằng đơn API trả về. */
219
+ protected readonly entity = linkedSignal(() => this.#resolved());
220
+ protected readonly pending = signal(false);
221
+ protected readonly statusBadge = computed(() => orderStatusBadge(this.entity().status));
222
+ protected readonly badges = computed(() => [this.statusBadge(), orderApprovalBadge(this.entity().approval)]);
223
+ protected readonly approvalName = computed(() => ORDER_APPROVAL_OPTIONS.find(option => option.id === this.entity().approval)?.name);
224
+ protected readonly editable = computed(() => canUpdateOrder(this.entity()));
225
+ protected readonly submitted = computed(() => [...this.entity().approvalHistory].reverse().find(step => step.action === 'submit'));
226
+ protected readonly decided = computed(() =>
227
+ this.entity().approval === 'approved' || this.entity().approval === 'rejected' ? this.entity().approvalHistory.at(-1) : undefined
228
+ );
229
+
230
+ constructor() {
231
+ afterNextRender(() => this.drawer()?.open());
232
+ }
233
+
234
+ protected closed(): void {
235
+ void this.#router.navigate(['../..'], { relativeTo: this.#route });
236
+ }
237
+
238
+ /** Hỏi xác nhận (Từ chối kèm lý do), gọi API, rồi hiển thị đơn mới; lỗi giữ nguyên màn để thử lại. */
239
+ protected async act(action: Extract<OrderAction, 'submit' | 'approve' | 'reject'>): Promise<void> {
240
+ const order = this.entity();
241
+ let reason: string | undefined;
242
+ try {
243
+ if (action === 'reject') {
244
+ reason = await this.#confirm.withInput(`Từ chối đơn ${order.code}. Lý do được gửi cho người lập đơn.`, {
245
+ title: 'Từ chối đơn hàng',
246
+ label: 'Lý do từ chối',
247
+ required: true,
248
+ maxlength: 200,
249
+ yesTitle: 'Từ chối',
250
+ noTitle: 'Không',
251
+ yesButtonColor: 'warning',
252
+ });
253
+ } else {
254
+ await this.#confirm.confirm(action === 'approve' ? `Duyệt đơn ${order.code}?` : `Gửi đơn ${order.code} cho người duyệt?`, {
255
+ title: action === 'approve' ? 'Duyệt đơn hàng' : 'Gửi duyệt',
256
+ yesTitle: action === 'approve' ? 'Duyệt' : 'Gửi duyệt',
257
+ noTitle: 'Không',
258
+ });
259
+ }
260
+ } catch {
261
+ return;
262
+ }
263
+ this.pending.set(true);
264
+ try {
265
+ this.entity.set(await firstValueFrom(this.#orderService.act(action, { id: order.id, reason })));
266
+ this.#notify.success(action === 'approve' ? 'Đã duyệt đơn.' : action === 'reject' ? 'Đã từ chối đơn.' : 'Đã gửi duyệt.');
267
+ } catch (error) {
268
+ this.#notify.error(apiErrorMessage(error));
269
+ } finally {
270
+ this.pending.set(false);
271
+ }
272
+ }
273
+ }
274
+ ```
275
+
276
+ Tác vụ hàng loạt báo kết quả từng phần, giữ các dòng lỗi đang chọn, cho thử lại phần lỗi:
277
+
278
+ <!-- @source features/order/components/bulk-result/bulk-result.component.ts -->
279
+ ```ts
280
+ import { ChangeDetectionStrategy, Component, computed, input, output } from '@angular/core';
281
+ import { SdInform } from '@sdcorejs/angular/components/inform';
282
+
283
+ /** Kết quả của một tác vụ hàng loạt: số thành công trên tổng và từng đơn lỗi. */
284
+ export interface OrderBulkSummary {
285
+ /** Động từ của tác vụ, ví dụ "Đã xác nhận". */
286
+ readonly done: string;
287
+ readonly total: number;
288
+ readonly failed: readonly { readonly id: string; readonly code: string; readonly message: string }[];
289
+ }
290
+
291
+ /** Báo kết quả từng phần (E13): "Đã xác nhận 8/10. 2 đơn lỗi." kèm lỗi từng đơn và nút thử lại phần lỗi. */
292
+ @Component({
293
+ selector: 'bulk-result',
294
+ standalone: true,
295
+ imports: [SdInform],
296
+ changeDetection: ChangeDetectionStrategy.OnPush,
297
+ template: `
298
+ @let _result = result();
299
+ <sd-inform
300
+ autoId="order-bulk-result"
301
+ [color]="_result.failed.length ? 'warning' : 'success'"
302
+ [title]="title()"
303
+ [description]="failures()"
304
+ [actionLabel]="_result.failed.length ? 'Thử lại phần lỗi' : undefined"
305
+ closable
306
+ (sdAction)="retry.emit()"
307
+ (sdClosed)="dismiss.emit()" />
308
+ `,
309
+ })
310
+ export class BulkResultComponent {
311
+ readonly result = input.required<OrderBulkSummary>();
312
+ readonly retry = output<void>();
313
+ readonly dismiss = output<void>();
314
+ protected readonly title = computed(() => {
315
+ const { done, total, failed } = this.result();
316
+ return `${done} ${total - failed.length}/${total}.` + (failed.length ? ` ${failed.length} đơn lỗi.` : '');
317
+ });
318
+ // why: nội dung chiếu vào sd-inform thay cả tiêu đề lẫn nút hành động; lỗi từng đơn đi qua `description`.
319
+ protected readonly failures = computed(
320
+ () =>
321
+ this.result()
322
+ .failed.map(item => `${item.code}: ${item.message}`)
323
+ .join(' ') || undefined
324
+ );
325
+ }
326
+ ```
327
+
328
+ ## Quy tắc
329
+
330
+ - MUST có một nút chính nổi bật; nút phụ dùng kiểu nhẹ hơn và thứ tự ổn định.
331
+ - MUST tối đa ba tác vụ cấp ngoài trong mỗi vùng; từ bốn tác vụ, giữ hai tác vụ ưu tiên và gom từ tác vụ thứ ba vào "Thao tác khác".
332
+ - MUST dùng "Cập nhật <entity>", không dùng "Chỉnh sửa" (E5); nút cập nhật có icon `edit`.
333
+ - MUST gắn `*sdPermission` cho từng tác vụ và cho menu; điều kiện trạng thái tính trong TS. Không có nhóm rỗng khi mọi tác vụ con bị ẩn.
334
+ - MUST hỏi xác nhận trước Xoá, Duyệt, Từ chối và mọi tác vụ đổi trạng thái, cả từng bản ghi lẫn hàng loạt; Từ chối và Huỷ bắt buộc lý do (E13).
335
+ - MUST báo kết quả hàng loạt theo từng bản ghi: "Đã xác nhận 8/10. 2 đơn lỗi.", giữ dòng lỗi đang chọn, có "Thử lại phần lỗi".
336
+ - MUST chặn bấm lặp khi tác vụ đang chạy (`disabled`, `loading`).
337
+
338
+ ## Lỗi hay gặp
339
+
340
+ - Coi request hàng loạt trả 200 là thành công toàn bộ: API trả kết quả từng bản ghi, phải đọc.
341
+ - Bỏ chọn tất cả sau tác vụ hàng loạt: người dùng mất dấu các dòng lỗi.
342
+ - Tác vụ Cập nhật, Chi tiết trên dòng danh sách: mở chi tiết bằng link trên mã; cập nhật nằm ở chi tiết.
@@ -0,0 +1,247 @@
1
+ # List
2
+
3
+ Danh sách có bảng: `sd-page-list` + `sd-table`. Route mẫu: `/pattern/product` (đơn giản), `/pattern/order` (tab, score card, chọn nhiều, tác vụ hàng loạt), `/pattern/customer` (score card lọc), `/pattern/category` (bảng cây).
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng cho màn có một bảng chính: tìm, lọc, phân trang, mở chi tiết.
8
+ - Danh sách và chi tiết cần cạnh nhau để xử lý nhanh từng mục: dùng [split](split.md).
9
+ - Một bản ghi duy nhất (cài đặt): dùng [form](form.md), không dựng danh sách một dòng.
10
+
11
+ ## Code mẫu
12
+
13
+ Danh sách đơn giản: quick search, filter dưới cột, mã là link theo quyền, header có menu Nhập/Xuất và Tạo mới.
14
+
15
+ <!-- @source features/product/pages/list/list.component.html -->
16
+ ```html
17
+ <sd-page-list title="Sản phẩm" description="Danh mục sản phẩm đang kinh doanh.">
18
+ <div headerRight class="d-flex align-items-center gap-8 flex-wrap">
19
+ <sd-button
20
+ *sdPermission="'PATTERN_PRODUCT_R_MENU'"
21
+ title="Nhập/Xuất"
22
+ suffixIcon="expand_more"
23
+ type="outline"
24
+ autoId="product-data-menu">
25
+ <sd-button-item *sdPermission="'PATTERN_PRODUCT_C_IMPORT'" prefixIcon="upload" (click)="openImport()">Nhập dữ liệu</sd-button-item>
26
+ <sd-button-item *sdPermission="'PATTERN_PRODUCT_R_EXPORT'" prefixIcon="download" (click)="exportData()">Xuất dữ liệu</sd-button-item>
27
+ </sd-button>
28
+ <sd-button
29
+ *sdPermission="'PATTERN_PRODUCT_C_CREATE'"
30
+ title="Tạo mới"
31
+ prefixIcon="add"
32
+ type="fill"
33
+ color="primary"
34
+ autoId="product-create"
35
+ [routerLink]="['create']" />
36
+ </div>
37
+
38
+ <sd-table autoId="product-list" [option]="tableOption">
39
+ <ng-template sdTableCellDef="code" let-product="item">
40
+ <a *sdPermission="'PATTERN_PRODUCT_R_DETAIL'" [routerLink]="[product.id, 'detail']">{{ product.code }}</a>
41
+ @if (!canOpenDetail) {
42
+ <span>{{ product.code }}</span>
43
+ }
44
+ </ng-template>
45
+ </sd-table>
46
+ </sd-page-list>
47
+ ```
48
+
49
+ <!-- @source features/product/pages/list/list.component.ts -->
50
+ ```ts
51
+ import { ChangeDetectionStrategy, Component, effect, inject, untracked, viewChild } from '@angular/core';
52
+ import { ActivatedRoute, Router, RouterLink } from '@angular/router';
53
+ import { firstValueFrom } from 'rxjs';
54
+ import { SdButton, SdButtonItem } from '@sdcorejs/angular/components/button';
55
+ import { SdTable, SdTableCellDefDirective, type SdTableOption } from '@sdcorejs/angular/components/table';
56
+ import { SdPageList } from '@sdcorejs/angular/modules/layout';
57
+ import { SdPermissionDirective, SdPermissionService } from '@sdcorejs/angular/modules/permission';
58
+ import { ProductService } from '../../services/product.service';
59
+ import { PRODUCT_STATUS_OPTIONS, productStatusBadge, type ProductDto } from '../../services/product.model';
60
+
61
+ @Component({
62
+ selector: 'list',
63
+ standalone: true,
64
+ templateUrl: './list.component.html',
65
+ changeDetection: ChangeDetectionStrategy.OnPush,
66
+ imports: [RouterLink, SdPageList, SdButton, SdButtonItem, SdTable, SdTableCellDefDirective, SdPermissionDirective],
67
+ })
68
+ export class ListComponent {
69
+ readonly #productService = inject(ProductService);
70
+ readonly #router = inject(Router);
71
+ readonly #route = inject(ActivatedRoute);
72
+ private readonly pageList = viewChild.required(SdPageList);
73
+ private readonly table = viewChild.required(SdTable);
74
+ // Route guard đã nạp quyền trước khi tạo page; dùng cho text thay link khi thiếu quyền xem chi tiết.
75
+ protected readonly canOpenDetail = inject(SdPermissionService).hasPermission('PATTERN_PRODUCT_R_DETAIL');
76
+
77
+ protected readonly tableOption: SdTableOption<ProductDto> = {
78
+ type: 'server',
79
+ items: (_, req) => firstValueFrom(this.#productService.list(req)),
80
+ sort: { enable: true },
81
+ filter: {
82
+ quickSearch: {
83
+ containFields: ['code', 'name'],
84
+ placeholder: 'Tìm theo mã hoặc tên sản phẩm',
85
+ },
86
+ },
87
+ columns: [
88
+ { field: 'code', title: 'Mã sản phẩm', type: 'string', width: '160px', sortable: true },
89
+ { field: 'name', title: 'Tên sản phẩm', type: 'string', minWidth: '240px', sortable: true },
90
+ { field: 'unit', title: 'Đơn vị tính', type: 'string', width: '140px' },
91
+ { field: 'price', title: 'Giá bán (₫)', type: 'number', width: '150px', align: 'right', sortable: true },
92
+ {
93
+ field: 'status',
94
+ title: 'Trạng thái',
95
+ type: 'values',
96
+ width: '180px',
97
+ option: { items: PRODUCT_STATUS_OPTIONS, valueField: 'id', displayField: 'name' },
98
+ useBadge: status => productStatusBadge(status),
99
+ },
100
+ ],
101
+ };
102
+
103
+ constructor() {
104
+ // Lưu ở trang con xong rồi quay về: tải lại đúng trang, bộ lọc và vị trí cuộn đang có.
105
+ let seen = this.#productService.changes();
106
+ effect(() => {
107
+ const changes = this.#productService.changes();
108
+ if (this.pageList().childActive() || changes === seen) return;
109
+ seen = changes;
110
+ untracked(() => void this.table().reload(true, false));
111
+ });
112
+ }
113
+
114
+ protected openImport(): void {
115
+ void this.#router.navigate(['../import'], { relativeTo: this.#route });
116
+ }
117
+
118
+ protected exportData(): void {
119
+ this.table().exportExcel();
120
+ }
121
+ }
122
+ ```
123
+
124
+ Chi tiết, tạo và cập nhật là route con của danh sách, nên quay lại vẫn giữ bộ lọc, trang và vị trí cuộn:
125
+
126
+ <!-- @source features/product/routes.ts -->
127
+ ```ts
128
+ import type { Routes } from '@angular/router';
129
+ import { sdPageFormLeaveGuard } from '@sdcorejs/angular/modules/layout';
130
+ import { SdPermissionGuard } from '@sdcorejs/angular/modules/permission';
131
+ import { entityResolver } from './entity.resolver';
132
+ import { ProductService } from './services/product.service';
133
+
134
+ /** Detail, create và update là route con của danh sách: quay lại vẫn giữ bộ lọc, trang và vị trí cuộn. */
135
+ export const routes: Routes = [
136
+ {
137
+ path: '',
138
+ providers: [ProductService],
139
+ canActivateChild: [SdPermissionGuard],
140
+ children: [
141
+ {
142
+ path: '',
143
+ title: 'Sản phẩm',
144
+ data: { permission: 'PATTERN_PRODUCT_R_LIST' },
145
+ loadComponent: () => import('./pages/list/list.component').then(module => module.ListComponent),
146
+ children: [
147
+ {
148
+ path: 'create',
149
+ title: 'Tạo sản phẩm',
150
+ data: { permission: 'PATTERN_PRODUCT_C_CREATE' },
151
+ canDeactivate: [sdPageFormLeaveGuard],
152
+ loadComponent: () => import('./pages/create/create.component').then(module => module.CreateComponent),
153
+ },
154
+ {
155
+ path: ':id/detail',
156
+ title: 'Chi tiết sản phẩm',
157
+ data: { permission: 'PATTERN_PRODUCT_R_DETAIL' },
158
+ resolve: { entity: entityResolver },
159
+ runGuardsAndResolvers: 'paramsChange',
160
+ loadComponent: () => import('./pages/detail/detail.component').then(module => module.DetailComponent),
161
+ },
162
+ {
163
+ path: ':id/update',
164
+ title: 'Cập nhật sản phẩm',
165
+ data: { permission: 'PATTERN_PRODUCT_U_UPDATE' },
166
+ resolve: { entity: entityResolver },
167
+ runGuardsAndResolvers: 'paramsChange',
168
+ canDeactivate: [sdPageFormLeaveGuard],
169
+ loadComponent: () => import('./pages/update/update.component').then(module => module.UpdateComponent),
170
+ },
171
+ ],
172
+ },
173
+ ],
174
+ },
175
+ ];
176
+ ```
177
+
178
+ Tab, score card và request dùng chung một state; đổi trạng thái thì đọc lại từ trang 1:
179
+
180
+ <!-- @source features/order/pages/list/list.component.html -->
181
+ ```html
182
+ @let _settings = settings();
183
+ <sd-page-list title="Đơn hàng" description="Đơn bán lẻ từ mọi kênh." [detail]="detailMode()" [autoCompact]="_settings.autoCompact">
184
+ <div headerRight class="d-flex align-items-center gap-8 flex-wrap">
185
+ <!-- Chỉ có ở /pattern. -->
186
+ <sd-pattern-settings-button />
187
+ <sd-button
188
+ *sdPermission="'PATTERN_ORDER_C_CREATE'"
189
+ title="Tạo đơn hàng"
190
+ prefixIcon="add"
191
+ type="fill"
192
+ color="primary"
193
+ autoId="order-create"
194
+ [routerLink]="['create']" />
195
+ </div>
196
+
197
+ @if (_settings.tabs) {
198
+ <sd-tab-group sdSubheader [selectedIndex]="tabIndex()" (selectedIndexChange)="selectTab($event)">
199
+ @for (tab of tabs; track tab.label) {
200
+ <sd-tab [label]="tab.label" [badge]="counts()?.[tab.status ?? 'all']" />
201
+ }
202
+ </sd-tab-group>
203
+ }
204
+ @if (_settings.score) {
205
+ <summary-cards [counts]="counts()" [(status)]="status" />
206
+ }
207
+ @if (bulkResult(); as result) {
208
+ <bulk-result [result]="result" (retry)="retryFailed()" (dismiss)="bulkResult.set(null)" />
209
+ }
210
+
211
+ <sd-table autoId="orders" [option]="option()">
212
+ <ng-template sdTableCellDef="code" let-order="item">
213
+ <a *sdPermission="'PATTERN_ORDER_R_DETAIL'" [routerLink]="[order.id, 'detail']">{{ order.code }}</a>
214
+ @if (!canOpenDetail) {
215
+ <span>{{ order.code }}</span>
216
+ }
217
+ </ng-template>
218
+ </sd-table>
219
+ </sd-page-list>
220
+ ```
221
+
222
+ <!-- @source features/order/pages/list/list.component.ts#state -->
223
+ ```ts
224
+ /** Một state cho tab, score card và request: đổi trạng thái thì đọc lại từ trang 1. */
225
+ protected readonly status = signal<OrderStatus | null>(null);
226
+ protected readonly tabIndex = computed(() => TABS.findIndex(tab => tab.status === this.status()));
227
+ protected readonly counts = signal<OrderCounts | null>(null);
228
+ ```
229
+
230
+ ## Quy tắc
231
+
232
+ - MUST dùng `sd-page-list`; bảng chính là `sd-table` trực tiếp trong thân (hoặc phần tử gắn `sdPageListMain`). Không viết `h-full`, `overflow` hay chiều cao cho danh sách (E1).
233
+ - MUST mở chi tiết bằng link trên mã hoặc tên ở cột dữ liệu đầu tiên. Không có tác vụ Xem/Cập nhật trên dòng, trên thanh chọn nhiều hay ở header.
234
+ - MUST hiện mã dạng chữ khi thiếu quyền xem chi tiết; chuẩn bị cờ quyền trong TS (`hasPermission` sau khi guard đã nạp quyền), không gọi service quyền trong template.
235
+ - MUST đặt chi tiết, tạo, cập nhật là route con của danh sách; `detail="page"` ẩn danh sách, `detail="drawer"` giữ danh sách trên màn.
236
+ - MUST tải lại danh sách khi trang con đã lưu thành công (service đếm số lần thay đổi), không tải lại mỗi lần đóng.
237
+ - MUST giữ một chỗ lọc cho mỗi field (E6): field có cột lọc dưới cột; external filter chỉ chứa field không có cột; có tab trạng thái thì tắt filter dưới cột Trạng thái. Không bật quick search cùng external filter.
238
+ - MUST truyền nguyên `PagingReq` (tham số thứ hai của `items`) vào service; service chuyển sang định dạng của API.
239
+ - SHOULD giữ mặc định `hideInlineFilter: false`; màn ít dữ liệu dùng `'auto'`; không dùng `true` (E7).
240
+ - SHOULD gọi `reloadFirstPage()` của `sd-table` khi một điều kiện ngoài bảng (tab, score card) đổi; `reload()` giữ trang hiện tại.
241
+
242
+ ## Lỗi hay gặp
243
+
244
+ - Bọc `sd-table` trong `div` có chiều cao cố định hoặc `overflow: auto`: sinh scrollbar thứ hai, paginator bị đẩy khỏi màn hình.
245
+ - Lọc trạng thái ở cả tab, score card và dưới cột: ba state lệch nhau, request không khớp thứ người dùng thấy.
246
+ - Đổi tab mà vẫn ở trang 3: danh sách rỗng dù có dữ liệu.
247
+ - Lấy dữ liệu của dòng làm chi tiết: dòng chỉ có vài field; chi tiết luôn tải bằng `detail(id)`.