@sdcorejs/angular 22.3.2 → 22.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 (253) hide show
  1. package/assets/THEME.md +58 -6
  2. package/assets/scss/core/form.scss +291 -3
  3. package/assets/scss/themes/_component-tokens.scss +35 -6
  4. package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
  5. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  6. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +3 -3
  7. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  8. package/fesm2022/sdcorejs-angular-components-section.mjs +15 -3
  9. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  10. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  11. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  12. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  13. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +398 -78
  14. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  15. package/fesm2022/sdcorejs-angular-components-table.mjs +460 -16
  16. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  17. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +932 -174
  18. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  19. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +7 -2
  20. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  21. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +5 -2
  22. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  23. package/fesm2022/sdcorejs-angular-forms-chip.mjs +437 -122
  24. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  25. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +4 -0
  26. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  27. package/fesm2022/sdcorejs-angular-forms-date.mjs +4 -0
  28. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  29. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +4 -0
  30. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  31. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +18 -2
  32. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  33. package/fesm2022/sdcorejs-angular-forms-input.mjs +4 -0
  34. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  35. package/fesm2022/sdcorejs-angular-forms-select.mjs +26 -20
  36. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  37. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +14 -1
  38. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  39. package/fesm2022/sdcorejs-angular-i18n.mjs +210 -0
  40. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  41. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BrJfOTWy.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-SJIWI1dX.mjs} +3 -3
  42. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BrJfOTWy.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-SJIWI1dX.mjs.map} +1 -1
  43. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-DQYXx2nr.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-BPhMLVbv.mjs} +3 -3
  44. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-DQYXx2nr.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-BPhMLVbv.mjs.map} +1 -1
  45. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-Cjg3Dfq1.mjs → sdcorejs-angular-modules-generic-generic-list.page-aGhowe9Y.mjs} +3 -3
  46. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-Cjg3Dfq1.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-aGhowe9Y.mjs.map} +1 -1
  47. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DpXg2yI7.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-N8_oGpqD.mjs} +4 -4
  48. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DpXg2yI7.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-N8_oGpqD.mjs.map} +1 -1
  49. package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
  50. package/fesm2022/sdcorejs-angular-modules-layout.mjs +289 -11
  51. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  52. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
  53. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
  54. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
  55. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
  56. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-Cfmr0L_5.mjs +51 -0
  57. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-Cfmr0L_5.mjs.map +1 -0
  58. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-C7-itJqB.mjs +134 -0
  59. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-C7-itJqB.mjs.map +1 -0
  60. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CxgmaNod.mjs +132 -0
  61. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CxgmaNod.mjs.map +1 -0
  62. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-C2GdGhkJ.mjs +100 -0
  63. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-C2GdGhkJ.mjs.map +1 -0
  64. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CzJh4LMR.mjs +119 -0
  65. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CzJh4LMR.mjs.map +1 -0
  66. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DIivNX4o.mjs +469 -0
  67. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DIivNX4o.mjs.map +1 -0
  68. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
  69. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
  70. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-B0nhFd_M.mjs +67 -0
  71. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-B0nhFd_M.mjs.map +1 -0
  72. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-D1dqsKX0.mjs +152 -0
  73. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-D1dqsKX0.mjs.map +1 -0
  74. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-Dkmm0a2Y.mjs +479 -0
  75. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-Dkmm0a2Y.mjs.map +1 -0
  76. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-WK0AcxNJ.mjs +175 -0
  77. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-WK0AcxNJ.mjs.map +1 -0
  78. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-yJ5fPyYU.mjs +92 -0
  79. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-yJ5fPyYU.mjs.map +1 -0
  80. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-BvhEMUgY.mjs +533 -0
  81. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-BvhEMUgY.mjs.map +1 -0
  82. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-Ydotvlyc.mjs +64 -0
  83. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-Ydotvlyc.mjs.map +1 -0
  84. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D8-WXUAE.mjs +92 -0
  85. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D8-WXUAE.mjs.map +1 -0
  86. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DHTxzjRN.mjs +242 -0
  87. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DHTxzjRN.mjs.map +1 -0
  88. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-cxNRkeRU.mjs +179 -0
  89. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-cxNRkeRU.mjs.map +1 -0
  90. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-CTgHdGeQ.mjs +72 -0
  91. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-CTgHdGeQ.mjs.map +1 -0
  92. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-D1zWXyN6.mjs +100 -0
  93. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-D1zWXyN6.mjs.map +1 -0
  94. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BK__9Mzb.mjs +541 -0
  95. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BK__9Mzb.mjs.map +1 -0
  96. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-1Xn1WaAP.mjs +647 -0
  97. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-1Xn1WaAP.mjs.map +1 -0
  98. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-B6Ndq542.mjs +120 -0
  99. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-B6Ndq542.mjs.map +1 -0
  100. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Bv_l7vnz.mjs +73 -0
  101. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Bv_l7vnz.mjs.map +1 -0
  102. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CaXgC8wK.mjs +172 -0
  103. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CaXgC8wK.mjs.map +1 -0
  104. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-ChwTb4BU.mjs +118 -0
  105. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-ChwTb4BU.mjs.map +1 -0
  106. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-DKK3NmbN.mjs +1069 -0
  107. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-DKK3NmbN.mjs.map +1 -0
  108. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs +186 -0
  109. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +1 -0
  110. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs +97 -0
  111. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +1 -0
  112. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
  113. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
  114. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-GSlXwL2Z.mjs +49 -0
  115. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-GSlXwL2Z.mjs.map +1 -0
  116. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-DPBwMafn.mjs +301 -0
  117. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-DPBwMafn.mjs.map +1 -0
  118. package/fesm2022/sdcorejs-angular-modules-pattern-routes-1kifjm82.mjs +100 -0
  119. package/fesm2022/sdcorejs-angular-modules-pattern-routes-1kifjm82.mjs.map +1 -0
  120. package/fesm2022/sdcorejs-angular-modules-pattern-routes-B6z9lJYB.mjs +45 -0
  121. package/fesm2022/sdcorejs-angular-modules-pattern-routes-B6z9lJYB.mjs.map +1 -0
  122. package/fesm2022/sdcorejs-angular-modules-pattern-routes-D1fsRfRB.mjs +66 -0
  123. package/fesm2022/sdcorejs-angular-modules-pattern-routes-D1fsRfRB.mjs.map +1 -0
  124. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DdCFCwxY.mjs +50 -0
  125. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DdCFCwxY.mjs.map +1 -0
  126. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DeThmv4f.mjs +74 -0
  127. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DeThmv4f.mjs.map +1 -0
  128. package/fesm2022/sdcorejs-angular-modules-pattern-routes-bQpdxKlY.mjs +166 -0
  129. package/fesm2022/sdcorejs-angular-modules-pattern-routes-bQpdxKlY.mjs.map +1 -0
  130. package/fesm2022/sdcorejs-angular-modules-pattern-routes-h66efEeH.mjs +74 -0
  131. package/fesm2022/sdcorejs-angular-modules-pattern-routes-h66efEeH.mjs.map +1 -0
  132. package/fesm2022/sdcorejs-angular-modules-pattern-routes-t3O2L2J5.mjs +43 -0
  133. package/fesm2022/sdcorejs-angular-modules-pattern-routes-t3O2L2J5.mjs.map +1 -0
  134. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-B6w4N6wo.mjs +413 -0
  135. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-B6w4N6wo.mjs.map +1 -0
  136. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BIYHlzVQ.mjs +325 -0
  137. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BIYHlzVQ.mjs.map +1 -0
  138. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DKgmhJT2.mjs +146 -0
  139. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DKgmhJT2.mjs.map +1 -0
  140. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-nnldn2cz.mjs +135 -0
  141. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-nnldn2cz.mjs.map +1 -0
  142. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-C0Bewuwz.mjs +129 -0
  143. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-C0Bewuwz.mjs.map +1 -0
  144. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Qlh3Lm2p.mjs +360 -0
  145. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Qlh3Lm2p.mjs.map +1 -0
  146. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-p9R5-eou.mjs +101 -0
  147. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-p9R5-eou.mjs.map +1 -0
  148. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
  149. package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
  150. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
  151. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
  152. package/modules/pattern/README.md +76 -0
  153. package/modules/pattern/docs/detail.md +237 -0
  154. package/modules/pattern/docs/drawer.md +484 -0
  155. package/modules/pattern/docs/flow.md +631 -0
  156. package/modules/pattern/docs/form.md +518 -0
  157. package/modules/pattern/docs/header-actions.md +342 -0
  158. package/modules/pattern/docs/list.md +247 -0
  159. package/modules/pattern/docs/relation.md +180 -0
  160. package/modules/pattern/docs/select.md +206 -0
  161. package/modules/pattern/docs/split.md +350 -0
  162. package/modules/pattern/docs/states.md +168 -0
  163. package/modules/pattern/features/approval/entity.resolver.ts +21 -0
  164. package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
  165. package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
  166. package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
  167. package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
  168. package/modules/pattern/features/approval/routes.ts +30 -0
  169. package/modules/pattern/features/approval/services/approval.model.ts +38 -0
  170. package/modules/pattern/features/approval/services/approval.service.ts +23 -0
  171. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +123 -0
  172. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
  173. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
  174. package/modules/pattern/features/category/entity.resolver.ts +27 -0
  175. package/modules/pattern/features/category/pages/list/list.component.html +20 -0
  176. package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
  177. package/modules/pattern/features/category/routes.ts +42 -0
  178. package/modules/pattern/features/category/services/category.model.ts +39 -0
  179. package/modules/pattern/features/category/services/category.service.ts +36 -0
  180. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +131 -0
  181. package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
  182. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
  183. package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
  184. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
  185. package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
  186. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
  187. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
  188. package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
  189. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
  190. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
  191. package/modules/pattern/features/customer/entity.resolver.ts +21 -0
  192. package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
  193. package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
  194. package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
  195. package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
  196. package/modules/pattern/features/customer/routes.ts +59 -0
  197. package/modules/pattern/features/customer/services/customer.model.ts +87 -0
  198. package/modules/pattern/features/customer/services/customer.service.ts +79 -0
  199. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
  200. package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
  201. package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
  202. package/modules/pattern/features/import/routes.ts +19 -0
  203. package/modules/pattern/features/import/services/import.model.ts +82 -0
  204. package/modules/pattern/features/import/services/import.service.ts +18 -0
  205. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
  206. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
  207. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
  208. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +205 -0
  209. package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
  210. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
  211. package/modules/pattern/features/order/entity.resolver.ts +37 -0
  212. package/modules/pattern/features/order/pages/create/create.component.ts +99 -0
  213. package/modules/pattern/features/order/pages/detail/detail.component.ts +222 -0
  214. package/modules/pattern/features/order/pages/list/list.component.html +38 -0
  215. package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
  216. package/modules/pattern/features/order/pages/update/update.component.ts +119 -0
  217. package/modules/pattern/features/order/routes.ts +54 -0
  218. package/modules/pattern/features/order/services/order.model.ts +109 -0
  219. package/modules/pattern/features/order/services/order.service.ts +63 -0
  220. package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
  221. package/modules/pattern/features/partner/routes.ts +20 -0
  222. package/modules/pattern/features/partner/services/partner.model.ts +30 -0
  223. package/modules/pattern/features/partner/services/partner.service.ts +17 -0
  224. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
  225. package/modules/pattern/features/product/components/product-select/product-select.component.ts +65 -0
  226. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
  227. package/modules/pattern/features/product/entity.resolver.ts +21 -0
  228. package/modules/pattern/features/product/pages/create/create.component.ts +85 -0
  229. package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
  230. package/modules/pattern/features/product/pages/list/list.component.html +30 -0
  231. package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
  232. package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
  233. package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
  234. package/modules/pattern/features/product/routes.ts +48 -0
  235. package/modules/pattern/features/product/services/product.model.ts +38 -0
  236. package/modules/pattern/features/product/services/product.service.ts +48 -0
  237. package/modules/pattern/features/settings/pages/update/update.component.ts +227 -0
  238. package/modules/pattern/features/settings/routes.ts +24 -0
  239. package/modules/pattern/features/settings/services/settings.model.ts +18 -0
  240. package/modules/pattern/features/settings/services/settings.service.ts +15 -0
  241. package/modules/pattern/features/settings/settings.resolver.ts +8 -0
  242. package/package.json +5 -1
  243. package/types/sdcorejs-angular-components-badge.d.ts +19 -1
  244. package/types/sdcorejs-angular-components-section.d.ts +13 -1
  245. package/types/sdcorejs-angular-components-splitter.d.ts +1 -1
  246. package/types/sdcorejs-angular-components-tab-router.d.ts +47 -5
  247. package/types/sdcorejs-angular-components-table.d.ts +127 -13
  248. package/types/sdcorejs-angular-components-upload-file.d.ts +181 -21
  249. package/types/sdcorejs-angular-forms-chip.d.ts +136 -26
  250. package/types/sdcorejs-angular-i18n.d.ts +42 -0
  251. package/types/sdcorejs-angular-modules-layout.d.ts +89 -6
  252. package/types/sdcorejs-angular-modules-pattern.d.ts +50 -0
  253. package/types/sdcorejs-angular-services-unsaved-changes.d.ts +11 -0
@@ -0,0 +1,350 @@
1
+ # Split
2
+
3
+ Danh sách và chi tiết cạnh nhau để xử lý nhanh từng mục: `sd-page-list detail="none"` + `sd-splitter` + route con `:id` trong panel phải. Route mẫu: `/pattern/approval`, `/pattern/approval/:id`.
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng cho hộp xử lý: người dùng đi qua từng mục, duyệt hoặc từ chối, rồi sang mục kế.
8
+ - Xem chi tiết thỉnh thoảng: dùng [drawer](drawer.md) hoặc [detail](detail.md).
9
+
10
+ ## Code mẫu
11
+
12
+ <!-- @source features/approval/pages/list/list.component.html -->
13
+ ```html
14
+ <sd-page-list title="Phê duyệt" description="Đề nghị thanh toán chờ xử lý. Dùng ↑ ↓ để chuyển mục." detail="none">
15
+ <div sdPageListMain class="approval" [class.approval--narrow]="narrow()" [class.approval--active]="active()">
16
+ <sd-splitter [option]="splitter">
17
+ <!-- Kéo trong khoảng 360–760px; panel chi tiết nhận phần còn lại (unit flex: minSize là trọng số, không phải px). -->
18
+ <sd-splitter-panel class="approval__list" panelId="list" [size]="520" unit="px" [minSize]="360" [maxSize]="760">
19
+ <sd-table autoId="approval-list" [option]="option">
20
+ <ng-template sdTableCellDef="code" let-item="item">
21
+ <a [routerLink]="[item.id]" [attr.aria-current]="item.id === selectedId() ? 'true' : null">{{ item.code }}</a>
22
+ </ng-template>
23
+ </sd-table>
24
+ </sd-splitter-panel>
25
+ <sd-splitter-panel class="approval__detail" panelId="detail" [size]="1">
26
+ <router-outlet (activate)="active.set(true)" (deactivate)="active.set(false)" />
27
+ @if (!active()) {
28
+ <sd-data-state state="empty" icon="inbox" title="Chọn một mục" message="Chọn một đề nghị bên trái để xem chi tiết và xử lý." />
29
+ }
30
+ </sd-splitter-panel>
31
+ </sd-splitter>
32
+ </div>
33
+ </sd-page-list>
34
+ ```
35
+
36
+ <!-- @source features/approval/pages/list/list.component.ts -->
37
+ ```ts
38
+ import { ChangeDetectionStrategy, Component, DestroyRef, effect, forwardRef, inject, signal, untracked, viewChild } from '@angular/core';
39
+ import { toSignal } from '@angular/core/rxjs-interop';
40
+ import { ActivatedRoute, NavigationEnd, Router, RouterLink, RouterOutlet } from '@angular/router';
41
+ import { filter, firstValueFrom, map, startWith } from 'rxjs';
42
+ import { SdDataState } from '@sdcorejs/angular/components/data-state';
43
+ import { SdSplitterComponent, SdSplitterPanelComponent, type SdSplitterOption } from '@sdcorejs/angular/components/splitter';
44
+ import { SdTable, SdTableCellDefDirective, type SdTableOption } from '@sdcorejs/angular/components/table';
45
+ import { SdPageList } from '@sdcorejs/angular/modules/layout';
46
+ import { ApprovalService } from '../../services/approval.service';
47
+ import { APPROVAL_STATUS_OPTIONS, approvalStatusBadge, type ApprovalDto } from '../../services/approval.model';
48
+ import { ApprovalInbox } from './approval-inbox';
49
+
50
+ /** Dưới bề rộng này chi tiết thay hẳn danh sách, có nút quay lại. */
51
+ const NARROW = '(max-width: 767.98px)';
52
+
53
+ /**
54
+ * Hộp duyệt (pattern split): danh sách bên trái, chi tiết là route con `:id` trong panel phải. ↑ ↓ chuyển mục;
55
+ * duyệt hoặc từ chối xong panel chi tiết tự chọn mục kế, bộ lọc và vị trí cuộn của danh sách giữ nguyên.
56
+ */
57
+ @Component({
58
+ selector: 'list',
59
+ standalone: true,
60
+ templateUrl: './list.component.html',
61
+ changeDetection: ChangeDetectionStrategy.OnPush,
62
+ // Phím ↑ ↓ nổi lên từ dòng hay nút đang focus trong danh sách hoặc panel chi tiết.
63
+ host: { '(keydown)': 'move($event)' },
64
+ imports: [
65
+ RouterLink,
66
+ RouterOutlet,
67
+ SdPageList,
68
+ SdSplitterComponent,
69
+ SdSplitterPanelComponent,
70
+ SdTable,
71
+ SdTableCellDefDirective,
72
+ SdDataState,
73
+ ],
74
+ providers: [{ provide: ApprovalInbox, useExisting: forwardRef(() => ListComponent) }],
75
+ styles: `
76
+ .approval > sd-splitter {
77
+ flex: 1 1 0;
78
+ min-height: 0;
79
+ }
80
+ .approval sd-splitter-panel {
81
+ display: flex;
82
+ flex-direction: column;
83
+ }
84
+ .approval__list {
85
+ background: var(--sd-surface, #ffffff);
86
+ border: 1px solid var(--sd-border, #e3e5ea);
87
+ border-radius: 8px;
88
+ }
89
+ .approval__list > sd-table {
90
+ flex: 1 1 0;
91
+ min-height: 0;
92
+ }
93
+ .approval__detail {
94
+ overflow-y: auto;
95
+ }
96
+ .approval--narrow.approval--active sd-splitter-panel:first-child,
97
+ .approval--narrow:not(.approval--active) sd-splitter-panel:last-of-type {
98
+ display: none;
99
+ }
100
+ `,
101
+ })
102
+ export class ListComponent extends ApprovalInbox {
103
+ readonly #approvalService = inject(ApprovalService);
104
+ readonly #router = inject(Router);
105
+ readonly #route = inject(ActivatedRoute);
106
+ private readonly table = viewChild.required(SdTable);
107
+ protected readonly active = signal(false);
108
+ protected readonly narrow = signal(false);
109
+ /** ID đang mở ở panel phải, đọc từ route con. */
110
+ protected readonly selectedId = toSignal(
111
+ this.#router.events.pipe(
112
+ filter(event => event instanceof NavigationEnd),
113
+ startWith(null),
114
+ map(() => this.#route.firstChild?.snapshot.paramMap.get('id') ?? null)
115
+ ),
116
+ { requireSync: true }
117
+ );
118
+ protected readonly splitter: SdSplitterOption = { storageKey: 'sd-pattern.approval.splitter' };
119
+ protected readonly option: SdTableOption<ApprovalDto> = {
120
+ type: 'server',
121
+ rowKey: 'id',
122
+ items: (_, req) => firstValueFrom(this.#approvalService.list(req)),
123
+ filter: {
124
+ quickSearch: { containFields: ['code', 'title', 'requester'], placeholder: 'Tìm theo mã, nội dung, người đề nghị' },
125
+ },
126
+ paginate: { pageSize: 20, pages: [20, 50] },
127
+ columns: [
128
+ { field: 'code', title: 'Mã', type: 'string', width: '96px' },
129
+ { field: 'title', title: 'Nội dung', type: 'string', minWidth: '140px' },
130
+ { field: 'amount', title: 'Số tiền (₫)', type: 'number', width: '120px', align: 'right' },
131
+ {
132
+ field: 'status',
133
+ title: 'Trạng thái',
134
+ type: 'values',
135
+ width: '128px',
136
+ option: { items: APPROVAL_STATUS_OPTIONS, valueField: 'id', displayField: 'name' },
137
+ useBadge: status => approvalStatusBadge(status),
138
+ // Hộp duyệt mở sẵn các đề nghị đang chờ; đổi bộ lọc để xem đề nghị đã xử lý.
139
+ filter: { default: 'pending' },
140
+ },
141
+ ],
142
+ style: {
143
+ rowCss: (row): Record<string, string> => (row.id === this.selectedId() ? { background: 'var(--sd-primary-light)' } : {}),
144
+ },
145
+ };
146
+
147
+ constructor() {
148
+ super();
149
+ // Dòng đang mở được tô nền: vẽ lại bảng khi chọn mục khác.
150
+ effect(() => {
151
+ this.selectedId();
152
+ untracked(() => this.table().detectChanges());
153
+ });
154
+ const media = typeof matchMedia === 'function' ? matchMedia(NARROW) : null;
155
+ if (media) {
156
+ this.narrow.set(media.matches);
157
+ const onChange = (event: MediaQueryListEvent): void => this.narrow.set(event.matches);
158
+ media.addEventListener('change', onChange);
159
+ inject(DestroyRef).onDestroy(() => media.removeEventListener('change', onChange));
160
+ }
161
+ }
162
+
163
+ nextOf(id: string): string | null {
164
+ const rows = this.table().dataItems;
165
+ const index = rows.findIndex(row => row.id === id);
166
+ if (index < 0) return rows[0]?.id ?? null;
167
+ return rows[index + 1]?.id ?? rows[index - 1]?.id ?? null;
168
+ }
169
+
170
+ async refresh(): Promise<void> {
171
+ await this.table().reload(true, false);
172
+ }
173
+
174
+ /** ↑ ↓ chuyển sang dòng trước/sau; bỏ qua khi đang gõ trong ô nhập. */
175
+ protected move(event: KeyboardEvent): void {
176
+ if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return;
177
+ const target = event.target as HTMLElement | null;
178
+ if (target?.closest('input, textarea, select, [contenteditable="true"], mat-select, [role="separator"]')) return;
179
+ const rows = this.table().dataItems;
180
+ if (!rows.length) return;
181
+ const index = rows.findIndex(row => row.id === this.selectedId());
182
+ const next = rows[Math.min(rows.length - 1, Math.max(0, index < 0 ? 0 : index + (event.key === 'ArrowDown' ? 1 : -1)))];
183
+ event.preventDefault();
184
+ if (next.id !== this.selectedId()) void this.#router.navigate([next.id], { relativeTo: this.#route });
185
+ }
186
+ }
187
+ ```
188
+
189
+ Panel chi tiết: xử lý xong thì tự mở mục kế trong danh sách đang lọc:
190
+
191
+ <!-- @source features/approval/pages/detail/detail.component.ts -->
192
+ ```ts
193
+ import { ChangeDetectionStrategy, Component, computed, inject, linkedSignal, signal } from '@angular/core';
194
+ import { toSignal } from '@angular/core/rxjs-interop';
195
+ import { ActivatedRoute, Router, RouterLink } from '@angular/router';
196
+ import { firstValueFrom, map } from 'rxjs';
197
+ import { SdBadge } from '@sdcorejs/angular/components/badge';
198
+ import { SdButton } from '@sdcorejs/angular/components/button';
199
+ import { SdSection, SdSectionItem } from '@sdcorejs/angular/components/section';
200
+ import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
201
+ import { SdEmptyPipe, SdFormatDatetimePipe, SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
202
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
203
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
204
+ import { apiErrorMessage } from '../../../../utils/api-error';
205
+ import { ApprovalService } from '../../services/approval.service';
206
+ import { approvalStatusBadge, type ApprovalDto } from '../../services/approval.model';
207
+ import { ApprovalInbox } from '../list/approval-inbox';
208
+
209
+ /** Chi tiết một đề nghị trong panel phải của hộp duyệt (route con `:id`). */
210
+ @Component({
211
+ selector: 'detail',
212
+ standalone: true,
213
+ imports: [
214
+ RouterLink,
215
+ SdBadge,
216
+ SdButton,
217
+ SdSection,
218
+ SdSectionItem,
219
+ SdPermissionDirective,
220
+ SdEmptyPipe,
221
+ SdFormatDatetimePipe,
222
+ SdFormatNumberPipe,
223
+ ],
224
+ changeDetection: ChangeDetectionStrategy.OnPush,
225
+ template: `
226
+ @let item = entity();
227
+ <article class="d-flex flex-column gap-16 p-16" [attr.aria-label]="'Đề nghị ' + item.code">
228
+ <header class="d-flex align-items-start justify-content-between gap-16 flex-wrap">
229
+ <div class="d-flex flex-column gap-4">
230
+ <!-- Màn hẹp: chi tiết thay danh sách, quay lại bằng liên kết này. -->
231
+ <a class="approval-back" [routerLink]="['..']">← Danh sách</a>
232
+ <div class="d-flex align-items-center gap-8">
233
+ <h2 class="T18M m-0">{{ item.code }} · {{ item.title }}</h2>
234
+ <sd-badge size="md" type="round" [title]="badge().title" [color]="badge().color" />
235
+ </div>
236
+ <span class="T14R text-secondary">{{ item.requester }} · {{ item.department }}</span>
237
+ </div>
238
+ @if (item.status === 'pending') {
239
+ <div class="d-flex align-items-center gap-8">
240
+ <sd-button
241
+ *sdPermission="'PATTERN_APPROVAL_U_REJECT'"
242
+ title="Từ chối"
243
+ prefixIcon="close"
244
+ type="light"
245
+ color="warning"
246
+ autoId="approval-reject"
247
+ [disabled]="pending()"
248
+ (click)="decide('reject')" />
249
+ <sd-button
250
+ *sdPermission="'PATTERN_APPROVAL_U_APPROVE'"
251
+ title="Duyệt"
252
+ prefixIcon="check"
253
+ type="fill"
254
+ color="success"
255
+ autoId="approval-approve"
256
+ [disabled]="pending()"
257
+ (click)="decide('approve')" />
258
+ </div>
259
+ }
260
+ </header>
261
+ <sd-section title="Thông tin đề nghị">
262
+ <sd-section-item label="Số tiền (₫)">{{ item.amount | sdFormatNumber: 0 }}</sd-section-item>
263
+ <sd-section-item label="Ngày gửi">{{ item.submittedAt | sdFormatDatetime }}</sd-section-item>
264
+ <sd-section-item label="Ghi chú">{{ item.note | sdEmpty }}</sd-section-item>
265
+ <sd-section-item label="Lý do từ chối">{{ item.reason | sdEmpty }}</sd-section-item>
266
+ </sd-section>
267
+ </article>
268
+ `,
269
+ styles: `
270
+ .approval-back {
271
+ display: none;
272
+ font-size: 13px;
273
+ }
274
+ @media (max-width: 767.98px) {
275
+ .approval-back {
276
+ display: inline;
277
+ }
278
+ }
279
+ `,
280
+ })
281
+ export class DetailComponent {
282
+ readonly #approvalService = inject(ApprovalService);
283
+ readonly #inbox = inject(ApprovalInbox);
284
+ readonly #confirm = inject(SdConfirmService);
285
+ readonly #notify = inject(SdNotifyService);
286
+ readonly #router = inject(Router);
287
+ readonly #route = inject(ActivatedRoute);
288
+ readonly #resolved = toSignal(this.#route.data.pipe(map(data => data['entity'] as ApprovalDto)), { requireSync: true });
289
+ protected readonly entity = linkedSignal(() => this.#resolved());
290
+ protected readonly badge = computed(() => approvalStatusBadge(this.entity().status));
291
+ protected readonly pending = signal(false);
292
+
293
+ /** Hỏi xác nhận (Từ chối kèm lý do), xử lý, rồi tự mở mục kế trong danh sách đang lọc. */
294
+ protected async decide(action: 'approve' | 'reject'): Promise<void> {
295
+ const item = this.entity();
296
+ let reason: string | undefined;
297
+ try {
298
+ if (action === 'reject') {
299
+ reason = await this.#confirm.withInput(`Từ chối ${item.code}. Lý do được gửi cho ${item.requester}.`, {
300
+ title: 'Từ chối đề nghị',
301
+ label: 'Lý do từ chối',
302
+ required: true,
303
+ maxlength: 200,
304
+ yesTitle: 'Từ chối',
305
+ noTitle: 'Không',
306
+ yesButtonColor: 'warning',
307
+ });
308
+ } else {
309
+ await this.#confirm.confirm(`Duyệt ${item.code}: ${item.title}?`, { title: 'Duyệt đề nghị', yesTitle: 'Duyệt', noTitle: 'Không' });
310
+ }
311
+ } catch {
312
+ return;
313
+ }
314
+ this.pending.set(true);
315
+ try {
316
+ const next = this.#inbox.nextOf(item.id);
317
+ this.entity.set(
318
+ await firstValueFrom(
319
+ action === 'approve' ? this.#approvalService.approve({ id: item.id }) : this.#approvalService.reject({ id: item.id, reason })
320
+ )
321
+ );
322
+ this.#notify.success(action === 'approve' ? `Đã duyệt ${item.code}.` : `Đã từ chối ${item.code}.`);
323
+ await this.#inbox.refresh();
324
+ await this.#router.navigate(next ? ['..', next] : ['..'], { relativeTo: this.#route });
325
+ } catch (error) {
326
+ this.#notify.error(apiErrorMessage(error));
327
+ } finally {
328
+ this.pending.set(false);
329
+ }
330
+ }
331
+ }
332
+ ```
333
+
334
+ ## Quy tắc
335
+
336
+ - MUST dùng `detail="none"`: `sd-page-list` không đặt router-outlet, màn đặt outlet trong panel phải. Bọc `sd-splitter` trong phần tử `sdPageListMain` để vùng chia đôi lấp phần còn lại của trang.
337
+ - MUST hiện trạng thái trống ("Chọn một mục") khi chưa mở mục nào.
338
+ - MUST cho ↑ ↓ chuyển mục khi focus không ở ô nhập; tô nền dòng đang mở.
339
+ - MUST giữ bộ lọc, trang và vị trí cuộn khi chuyển mục và sau khi xử lý; tải lại bằng `reload(true, false)`.
340
+ - MUST cho panel danh sách bề rộng px (`unit="px"`) với `minSize`/`maxSize` px, panel chi tiết `unit="flex"` nhận phần còn lại; đặt `display: flex; flex-direction: column` cho panel để bảng lấp chiều cao và paginator luôn hiện.
341
+ - SHOULD lưu bề rộng panel (`storageKey` của `sd-splitter`).
342
+ - SHOULD dưới 768px cho chi tiết thay hẳn danh sách, có liên kết quay lại.
343
+
344
+ ## Lỗi hay gặp
345
+
346
+ - Để `sd-page-list` mặc định (`detail="page"`): route con hiện thay chỗ cả danh sách, không còn cạnh nhau.
347
+ - Đặt `sdPageListMain` trực tiếp lên `sd-splitter`: kiểu cột của vùng chính đè hướng ngang của splitter.
348
+ - Đặt `[minSize]="360"` lên panel `unit="flex"` để giữ chỗ cho chi tiết: với panel flex, `minSize` là trọng số chứ không phải px, nên handle không kéo được. Giới hạn bằng `maxSize` px của panel danh sách.
349
+ - Để panel ở `display: block` mặc định: bảng ở chế độ fill không co theo panel, dòng cuối và paginator bị cắt.
350
+ - Chọn mục kế sau khi đã tải lại danh sách: mục vừa xử lý đã biến mất khỏi bộ lọc, vị trí kế bị lệch. Lấy mục kế trước khi tải lại.
@@ -0,0 +1,168 @@
1
+ # States
2
+
3
+ Đang tải, rỗng, lỗi và thiếu quyền. Thanh công cụ của `/pattern` đổi độ trễ, lỗi giả lập (500, timeout, 404, 403) và vai trò để xem từng trạng thái trên mọi route; drawer "Tuỳ chỉnh hiển thị" của `/pattern/order` ép trạng thái đọc của danh sách.
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Mọi vùng tải dữ liệu đều có trạng thái đang tải, rỗng và lỗi riêng.
8
+ - Bảng `sd-table` đã tự có ba trạng thái này: không bọc thêm.
9
+
10
+ ## Code mẫu
11
+
12
+ Tab tự tải, trạng thái riêng bằng `sd-data-state`:
13
+
14
+ <!-- @source features/customer/components/documents-view/documents-view.component.ts -->
15
+ ```ts
16
+ import { ChangeDetectionStrategy, Component, inject, input, OnInit, signal } from '@angular/core';
17
+ import { firstValueFrom } from 'rxjs';
18
+ import { SdDataState } from '@sdcorejs/angular/components/data-state';
19
+ import { SdSection, SdSectionItem } from '@sdcorejs/angular/components/section';
20
+ import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
21
+ import { CustomerService } from '../../services/customer.service';
22
+ import type { CustomerDocumentDto } from '../../services/customer.model';
23
+
24
+ /** Tab Tài liệu của hồ sơ 360°: danh sách ngắn, trạng thái riêng bằng `sd-data-state`. */
25
+ @Component({
26
+ selector: 'documents-view',
27
+ standalone: true,
28
+ imports: [SdDataState, SdSection, SdSectionItem, SdFormatNumberPipe],
29
+ changeDetection: ChangeDetectionStrategy.OnPush,
30
+ template: `
31
+ <sd-data-state
32
+ [state]="state()"
33
+ retryable
34
+ title=""
35
+ [message]="state() === 'empty' ? 'Khách hàng chưa có tài liệu.' : undefined"
36
+ (sdRetry)="load()">
37
+ <sd-section title="Tài liệu">
38
+ @for (document of documents(); track document.id) {
39
+ <sd-section-item [label]="document.name">{{ document.size / 1024 | sdFormatNumber: 0 }} KB</sd-section-item>
40
+ }
41
+ </sd-section>
42
+ </sd-data-state>
43
+ `,
44
+ })
45
+ export class DocumentsViewComponent implements OnInit {
46
+ readonly #customerService = inject(CustomerService);
47
+ readonly customerId = input.required<string>();
48
+ protected readonly state = signal<'loading' | 'empty' | 'error' | 'success'>('loading');
49
+ protected readonly documents = signal<readonly CustomerDocumentDto[]>([]);
50
+
51
+ ngOnInit(): void {
52
+ void this.load();
53
+ }
54
+
55
+ protected async load(): Promise<void> {
56
+ this.state.set('loading');
57
+ try {
58
+ const res = await firstValueFrom(this.#customerService.documents(this.customerId()));
59
+ this.documents.set(res.items);
60
+ this.state.set(res.items.length ? 'success' : 'empty');
61
+ } catch {
62
+ this.state.set('error');
63
+ }
64
+ }
65
+ }
66
+ ```
67
+
68
+ Lỗi trước khi mở trang thuộc resolver; host chuyển 404, 403, lỗi mạng sang trang lỗi của mình:
69
+
70
+ <!-- @source features/customer/entity.resolver.ts -->
71
+ ```ts
72
+ import { HttpErrorResponse } from '@angular/common/http';
73
+ import { inject } from '@angular/core';
74
+ import type { ResolveFn } from '@angular/router';
75
+ import { map, timeout } from 'rxjs';
76
+ import { CustomerService } from './services/customer.service';
77
+ import type { CustomerDto } from './services/customer.model';
78
+
79
+ /** Tải khách hàng bằng `detail(id)` trước khi mở drawer/trang; lỗi đi tới navigation error handler của host. */
80
+ export const entityResolver: ResolveFn<CustomerDto> = route => {
81
+ const id = route.paramMap.get('id');
82
+ if (!id?.trim()) throw new HttpErrorResponse({ status: 404 });
83
+ return inject(CustomerService)
84
+ .detail(id)
85
+ .pipe(
86
+ timeout(10_000),
87
+ map(entity => {
88
+ if (!entity || entity.id !== id) throw new HttpErrorResponse({ status: 404 });
89
+ return entity;
90
+ })
91
+ );
92
+ };
93
+ ```
94
+
95
+ Quyền vào route bằng `canActivateChild: [SdPermissionGuard]` và `data.permission` trên từng route:
96
+
97
+ <!-- @source features/order/routes.ts -->
98
+ ```ts
99
+ import type { Routes } from '@angular/router';
100
+ import { sdPageFormLeaveGuard } from '@sdcorejs/angular/modules/layout';
101
+ import { SdPermissionGuard } from '@sdcorejs/angular/modules/permission';
102
+ import { CustomerService } from '../customer/services/customer.service';
103
+ import { ProductService } from '../product/services/product.service';
104
+ import { entityResolver, updatableEntityResolver } from './entity.resolver';
105
+ import { OrderService } from './services/order.service';
106
+
107
+ /**
108
+ * Chi tiết là route con của danh sách (drawer hoặc trang theo `detail`); tạo và cập nhật là trang thay chỗ danh sách
109
+ * (`data.detail: 'page'`). CustomerService và ProductService được cấp ở đây cho `customer-select`, `product-select`
110
+ * và các pipe relation: đơn hàng dùng wrapper của feature sở hữu entity, không tự gọi API của entity khác.
111
+ */
112
+ export const routes: Routes = [
113
+ {
114
+ path: '',
115
+ providers: [OrderService, CustomerService, ProductService],
116
+ canActivateChild: [SdPermissionGuard],
117
+ children: [
118
+ {
119
+ path: '',
120
+ title: 'Đơn hàng',
121
+ data: { permission: 'PATTERN_ORDER_R_LIST' },
122
+ loadComponent: () => import('./pages/list/list.component').then(module => module.ListComponent),
123
+ children: [
124
+ {
125
+ path: 'create',
126
+ title: 'Tạo mới đơn hàng',
127
+ data: { permission: 'PATTERN_ORDER_C_CREATE', detail: 'page' },
128
+ canDeactivate: [sdPageFormLeaveGuard],
129
+ loadComponent: () => import('./pages/create/create.component').then(module => module.CreateComponent),
130
+ },
131
+ {
132
+ path: ':id/detail',
133
+ title: 'Chi tiết đơn hàng',
134
+ data: { permission: 'PATTERN_ORDER_R_DETAIL' },
135
+ resolve: { entity: entityResolver },
136
+ runGuardsAndResolvers: 'paramsChange',
137
+ loadComponent: () => import('./pages/detail/detail.component').then(module => module.DetailComponent),
138
+ },
139
+ {
140
+ path: ':id/update',
141
+ title: 'Cập nhật đơn hàng',
142
+ data: { permission: 'PATTERN_ORDER_U_UPDATE', detail: 'page' },
143
+ resolve: { entity: updatableEntityResolver },
144
+ runGuardsAndResolvers: 'paramsChange',
145
+ canDeactivate: [sdPageFormLeaveGuard],
146
+ loadComponent: () => import('./pages/update/update.component').then(module => module.UpdateComponent),
147
+ },
148
+ ],
149
+ },
150
+ ],
151
+ },
152
+ ];
153
+ ```
154
+
155
+ ## Quy tắc
156
+
157
+ - MUST để lỗi tải bản ghi bắt buộc đi qua resolver tới navigation error handler của host; không mở trang rồi mới báo lỗi.
158
+ - MUST khai báo `data.permission` cho mọi route con; guard từ chối route quên khai báo.
159
+ - MUST giữ các vùng phụ (tab của hồ sơ, relation) có trạng thái riêng; lỗi một vùng không làm hỏng cả trang.
160
+ - MUST không biến lỗi thành dữ liệu rỗng thành công; có nút thử lại khi lỗi có thể hết.
161
+ - MUST giữ dữ liệu người dùng đã nhập khi lưu lỗi (500, timeout).
162
+ - SHOULD dùng `sd-data-state` cho vùng không phải bảng; `retryable` khi thử lại có ý nghĩa.
163
+
164
+ ## Lỗi hay gặp
165
+
166
+ - Bắt lỗi API rồi trả mảng rỗng: người dùng thấy "Không có dữ liệu" khi máy chủ đang lỗi.
167
+ - Chỉ ẩn nút theo quyền mà không chặn route: mở URL trực tiếp vẫn vào được.
168
+ - Đổi vai trò mà không chạy lại guard: nút theo quyền cũ còn trên màn. `*sdPermission` đọc quyền lúc tạo, nên màn phải mở lại.
@@ -0,0 +1,21 @@
1
+ import { HttpErrorResponse } from '@angular/common/http';
2
+ import { inject } from '@angular/core';
3
+ import type { ResolveFn } from '@angular/router';
4
+ import { map, timeout } from 'rxjs';
5
+ import { ApprovalService } from './services/approval.service';
6
+ import type { ApprovalDto } from './services/approval.model';
7
+
8
+ /** Tải đề nghị bằng `detail(id)` trước khi mở panel chi tiết; lỗi đi tới navigation error handler của host. */
9
+ export const entityResolver: ResolveFn<ApprovalDto> = route => {
10
+ const id = route.paramMap.get('id');
11
+ if (!id?.trim()) throw new HttpErrorResponse({ status: 404 });
12
+ return inject(ApprovalService)
13
+ .detail(id)
14
+ .pipe(
15
+ timeout(10_000),
16
+ map(entity => {
17
+ if (!entity || entity.id !== id) throw new HttpErrorResponse({ status: 404 });
18
+ return entity;
19
+ })
20
+ );
21
+ };
@@ -0,0 +1,139 @@
1
+ import { ChangeDetectionStrategy, Component, computed, inject, linkedSignal, signal } from '@angular/core';
2
+ import { toSignal } from '@angular/core/rxjs-interop';
3
+ import { ActivatedRoute, Router, RouterLink } from '@angular/router';
4
+ import { firstValueFrom, map } from 'rxjs';
5
+ import { SdBadge } from '@sdcorejs/angular/components/badge';
6
+ import { SdButton } from '@sdcorejs/angular/components/button';
7
+ import { SdSection, SdSectionItem } from '@sdcorejs/angular/components/section';
8
+ import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
9
+ import { SdEmptyPipe, SdFormatDatetimePipe, SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
10
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
11
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
12
+ import { apiErrorMessage } from '../../../../utils/api-error';
13
+ import { ApprovalService } from '../../services/approval.service';
14
+ import { approvalStatusBadge, type ApprovalDto } from '../../services/approval.model';
15
+ import { ApprovalInbox } from '../list/approval-inbox';
16
+
17
+ /** Chi tiết một đề nghị trong panel phải của hộp duyệt (route con `:id`). */
18
+ @Component({
19
+ selector: 'detail',
20
+ standalone: true,
21
+ imports: [
22
+ RouterLink,
23
+ SdBadge,
24
+ SdButton,
25
+ SdSection,
26
+ SdSectionItem,
27
+ SdPermissionDirective,
28
+ SdEmptyPipe,
29
+ SdFormatDatetimePipe,
30
+ SdFormatNumberPipe,
31
+ ],
32
+ changeDetection: ChangeDetectionStrategy.OnPush,
33
+ template: `
34
+ @let item = entity();
35
+ <article class="d-flex flex-column gap-16 p-16" [attr.aria-label]="'Đề nghị ' + item.code">
36
+ <header class="d-flex align-items-start justify-content-between gap-16 flex-wrap">
37
+ <div class="d-flex flex-column gap-4">
38
+ <!-- Màn hẹp: chi tiết thay danh sách, quay lại bằng liên kết này. -->
39
+ <a class="approval-back" [routerLink]="['..']">← Danh sách</a>
40
+ <div class="d-flex align-items-center gap-8">
41
+ <h2 class="T18M m-0">{{ item.code }} · {{ item.title }}</h2>
42
+ <sd-badge size="md" type="round" [title]="badge().title" [color]="badge().color" />
43
+ </div>
44
+ <span class="T14R text-secondary">{{ item.requester }} · {{ item.department }}</span>
45
+ </div>
46
+ @if (item.status === 'pending') {
47
+ <div class="d-flex align-items-center gap-8">
48
+ <sd-button
49
+ *sdPermission="'PATTERN_APPROVAL_U_REJECT'"
50
+ title="Từ chối"
51
+ prefixIcon="close"
52
+ type="light"
53
+ color="warning"
54
+ autoId="approval-reject"
55
+ [disabled]="pending()"
56
+ (click)="decide('reject')" />
57
+ <sd-button
58
+ *sdPermission="'PATTERN_APPROVAL_U_APPROVE'"
59
+ title="Duyệt"
60
+ prefixIcon="check"
61
+ type="fill"
62
+ color="success"
63
+ autoId="approval-approve"
64
+ [disabled]="pending()"
65
+ (click)="decide('approve')" />
66
+ </div>
67
+ }
68
+ </header>
69
+ <sd-section title="Thông tin đề nghị">
70
+ <sd-section-item label="Số tiền (₫)">{{ item.amount | sdFormatNumber: 0 }}</sd-section-item>
71
+ <sd-section-item label="Ngày gửi">{{ item.submittedAt | sdFormatDatetime }}</sd-section-item>
72
+ <sd-section-item label="Ghi chú">{{ item.note | sdEmpty }}</sd-section-item>
73
+ <sd-section-item label="Lý do từ chối">{{ item.reason | sdEmpty }}</sd-section-item>
74
+ </sd-section>
75
+ </article>
76
+ `,
77
+ styles: `
78
+ .approval-back {
79
+ display: none;
80
+ font-size: 13px;
81
+ }
82
+ @media (max-width: 767.98px) {
83
+ .approval-back {
84
+ display: inline;
85
+ }
86
+ }
87
+ `,
88
+ })
89
+ export class DetailComponent {
90
+ readonly #approvalService = inject(ApprovalService);
91
+ readonly #inbox = inject(ApprovalInbox);
92
+ readonly #confirm = inject(SdConfirmService);
93
+ readonly #notify = inject(SdNotifyService);
94
+ readonly #router = inject(Router);
95
+ readonly #route = inject(ActivatedRoute);
96
+ readonly #resolved = toSignal(this.#route.data.pipe(map(data => data['entity'] as ApprovalDto)), { requireSync: true });
97
+ protected readonly entity = linkedSignal(() => this.#resolved());
98
+ protected readonly badge = computed(() => approvalStatusBadge(this.entity().status));
99
+ protected readonly pending = signal(false);
100
+
101
+ /** Hỏi xác nhận (Từ chối kèm lý do), xử lý, rồi tự mở mục kế trong danh sách đang lọc. */
102
+ protected async decide(action: 'approve' | 'reject'): Promise<void> {
103
+ const item = this.entity();
104
+ let reason: string | undefined;
105
+ try {
106
+ if (action === 'reject') {
107
+ reason = await this.#confirm.withInput(`Từ chối ${item.code}. Lý do được gửi cho ${item.requester}.`, {
108
+ title: 'Từ chối đề nghị',
109
+ label: 'Lý do từ chối',
110
+ required: true,
111
+ maxlength: 200,
112
+ yesTitle: 'Từ chối',
113
+ noTitle: 'Không',
114
+ yesButtonColor: 'warning',
115
+ });
116
+ } else {
117
+ await this.#confirm.confirm(`Duyệt ${item.code}: ${item.title}?`, { title: 'Duyệt đề nghị', yesTitle: 'Duyệt', noTitle: 'Không' });
118
+ }
119
+ } catch {
120
+ return;
121
+ }
122
+ this.pending.set(true);
123
+ try {
124
+ const next = this.#inbox.nextOf(item.id);
125
+ this.entity.set(
126
+ await firstValueFrom(
127
+ action === 'approve' ? this.#approvalService.approve({ id: item.id }) : this.#approvalService.reject({ id: item.id, reason })
128
+ )
129
+ );
130
+ this.#notify.success(action === 'approve' ? `Đã duyệt ${item.code}.` : `Đã từ chối ${item.code}.`);
131
+ await this.#inbox.refresh();
132
+ await this.#router.navigate(next ? ['..', next] : ['..'], { relativeTo: this.#route });
133
+ } catch (error) {
134
+ this.#notify.error(apiErrorMessage(error));
135
+ } finally {
136
+ this.pending.set(false);
137
+ }
138
+ }
139
+ }