@sdcorejs/angular 22.3.4 → 22.3.6

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 (240) hide show
  1. package/assets/STYLE-GUIDE.md +78 -1
  2. package/assets/THEME.md +45 -3
  3. package/assets/scss/core/_popover-panel.scss +90 -0
  4. package/assets/scss/core/form.scss +5 -2
  5. package/assets/scss/core/utilities/_grid.scss +15 -0
  6. package/assets/scss/core/utilities/_sizing.scss +4 -0
  7. package/assets/scss/themes/_component-tokens.scss +9 -4
  8. package/assets/scss/themes/_semantic.scss +6 -5
  9. package/fesm2022/sdcorejs-angular-components-anchor.mjs +64 -3
  10. package/fesm2022/sdcorejs-angular-components-anchor.mjs.map +1 -1
  11. package/fesm2022/sdcorejs-angular-components-button.mjs +14 -6
  12. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  13. package/fesm2022/sdcorejs-angular-components-calendar.mjs +2565 -0
  14. package/fesm2022/sdcorejs-angular-components-calendar.mjs.map +1 -0
  15. package/fesm2022/sdcorejs-angular-components-card.mjs +521 -23
  16. package/fesm2022/sdcorejs-angular-components-card.mjs.map +1 -1
  17. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1 -1
  18. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -1
  19. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +4 -18
  20. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  21. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +7 -7
  22. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  23. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +1 -1
  24. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  25. package/fesm2022/sdcorejs-angular-components-kanban.mjs +849 -157
  26. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -1
  27. package/fesm2022/sdcorejs-angular-components-modal.mjs +66 -14
  28. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  29. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +1528 -375
  30. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  31. package/fesm2022/sdcorejs-angular-components-quick-action.mjs +78 -2
  32. package/fesm2022/sdcorejs-angular-components-quick-action.mjs.map +1 -1
  33. package/fesm2022/sdcorejs-angular-components-scheduler.mjs +2006 -0
  34. package/fesm2022/sdcorejs-angular-components-scheduler.mjs.map +1 -0
  35. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  36. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  37. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +126 -26
  38. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  39. package/fesm2022/sdcorejs-angular-components-tab.mjs +31 -2
  40. package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
  41. package/fesm2022/sdcorejs-angular-components-table.mjs +6215 -3830
  42. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  43. package/fesm2022/sdcorejs-angular-components-timeline.mjs +501 -0
  44. package/fesm2022/sdcorejs-angular-components-timeline.mjs.map +1 -0
  45. package/fesm2022/sdcorejs-angular-components-tree.mjs +613 -36
  46. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  47. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +2 -4
  48. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  49. package/fesm2022/sdcorejs-angular-components.mjs +3 -1
  50. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  51. package/fesm2022/sdcorejs-angular-directives.mjs +110 -22
  52. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  53. package/fesm2022/sdcorejs-angular-forms-date.mjs +142 -43
  54. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  55. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +71 -22
  56. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  57. package/fesm2022/sdcorejs-angular-forms-directives.mjs +4 -3
  58. package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
  59. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +1 -1
  60. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  61. package/fesm2022/sdcorejs-angular-forms-select.mjs +23 -4
  62. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  63. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  64. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  65. package/fesm2022/sdcorejs-angular-i18n.mjs +812 -52
  66. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  67. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-SJIWI1dX.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-j_thIw4L.mjs} +3 -3
  68. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-SJIWI1dX.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-j_thIw4L.mjs.map} +1 -1
  69. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-BPhMLVbv.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-DLsJ_8NR.mjs} +2 -2
  70. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-BPhMLVbv.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-DLsJ_8NR.mjs.map} +1 -1
  71. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-aGhowe9Y.mjs → sdcorejs-angular-modules-generic-generic-list.page-CkYR7Y-b.mjs} +3 -3
  72. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-aGhowe9Y.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-CkYR7Y-b.mjs.map} +1 -1
  73. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-N8_oGpqD.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-Ddytu3Gb.mjs} +4 -4
  74. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-N8_oGpqD.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-Ddytu3Gb.mjs.map} +1 -1
  75. package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
  76. package/fesm2022/sdcorejs-angular-modules-layout.mjs +17 -8
  77. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  78. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs → sdcorejs-angular-modules-pattern-base-api.service-vMdkWmw-.mjs} +2 -2
  79. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs.map → sdcorejs-angular-modules-pattern-base-api.service-vMdkWmw-.mjs.map} +1 -1
  80. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs → sdcorejs-angular-modules-pattern-create.component--cdb_2ub.mjs} +11 -7
  81. package/fesm2022/sdcorejs-angular-modules-pattern-create.component--cdb_2ub.mjs.map +1 -0
  82. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs → sdcorejs-angular-modules-pattern-create.component-BmKRynOI.mjs} +2 -2
  83. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs.map → sdcorejs-angular-modules-pattern-create.component-BmKRynOI.mjs.map} +1 -1
  84. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs → sdcorejs-angular-modules-pattern-create.component-DoilYt0j.mjs} +2 -2
  85. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs.map → sdcorejs-angular-modules-pattern-create.component-DoilYt0j.mjs.map} +1 -1
  86. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs → sdcorejs-angular-modules-pattern-customer.service-DpPC-tV2.mjs} +2 -2
  87. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs.map → sdcorejs-angular-modules-pattern-customer.service-DpPC-tV2.mjs.map} +1 -1
  88. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs → sdcorejs-angular-modules-pattern-detail.component-Bh_rvQnq.mjs} +61 -55
  89. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-Bh_rvQnq.mjs.map +1 -0
  90. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs → sdcorejs-angular-modules-pattern-detail.component-Dk1bomUT.mjs} +2 -2
  91. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs.map → sdcorejs-angular-modules-pattern-detail.component-Dk1bomUT.mjs.map} +1 -1
  92. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs → sdcorejs-angular-modules-pattern-flow.component-BarNCjsh.mjs} +3 -3
  93. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs.map → sdcorejs-angular-modules-pattern-flow.component-BarNCjsh.mjs.map} +1 -1
  94. package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs → sdcorejs-angular-modules-pattern-index.component--rIi-QIQ.mjs} +2 -2
  95. package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs.map → sdcorejs-angular-modules-pattern-index.component--rIi-QIQ.mjs.map} +1 -1
  96. package/fesm2022/{sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs → sdcorejs-angular-modules-pattern-lines-table-form.component-G9Li--QF.mjs} +5 -5
  97. package/fesm2022/{sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs.map → sdcorejs-angular-modules-pattern-lines-table-form.component-G9Li--QF.mjs.map} +1 -1
  98. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-2AZxTu9a.mjs +522 -0
  99. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-2AZxTu9a.mjs.map +1 -0
  100. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CDM4V05g.mjs +520 -0
  101. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CDM4V05g.mjs.map +1 -0
  102. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs → sdcorejs-angular-modules-pattern-list.component-DS9DROp-.mjs} +3 -3
  103. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs.map → sdcorejs-angular-modules-pattern-list.component-DS9DROp-.mjs.map} +1 -1
  104. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs → sdcorejs-angular-modules-pattern-list.component-DbF9z3da.mjs} +30 -39
  105. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DbF9z3da.mjs.map +1 -0
  106. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs → sdcorejs-angular-modules-pattern-list.component-DlF3i6ai.mjs} +3 -3
  107. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs.map → sdcorejs-angular-modules-pattern-list.component-DlF3i6ai.mjs.map} +1 -1
  108. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs → sdcorejs-angular-modules-pattern-mock-backend.factory-BpECki9p.mjs} +2 -2
  109. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs.map → sdcorejs-angular-modules-pattern-mock-backend.factory-BpECki9p.mjs.map} +1 -1
  110. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs → sdcorejs-angular-modules-pattern-pattern-source-viewer-DuhyXsGn.mjs} +4 -22
  111. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-DuhyXsGn.mjs.map +1 -0
  112. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs → sdcorejs-angular-modules-pattern-pattern-source.generated-bfpj85ke.mjs} +26 -27
  113. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-bfpj85ke.mjs.map +1 -0
  114. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs → sdcorejs-angular-modules-pattern-product.service-DEAQ4oro.mjs} +2 -2
  115. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs.map → sdcorejs-angular-modules-pattern-product.service-DEAQ4oro.mjs.map} +1 -1
  116. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs → sdcorejs-angular-modules-pattern-profile.component-D-dJk5vb.mjs} +27 -14
  117. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-D-dJk5vb.mjs.map +1 -0
  118. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs → sdcorejs-angular-modules-pattern-routes-Brr61WQo.mjs} +4 -4
  119. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs.map → sdcorejs-angular-modules-pattern-routes-Brr61WQo.mjs.map} +1 -1
  120. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs → sdcorejs-angular-modules-pattern-routes-CPVcXcfq.mjs} +3 -3
  121. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs.map → sdcorejs-angular-modules-pattern-routes-CPVcXcfq.mjs.map} +1 -1
  122. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs → sdcorejs-angular-modules-pattern-routes-CWCtuZ4z.mjs} +8 -8
  123. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs.map → sdcorejs-angular-modules-pattern-routes-CWCtuZ4z.mjs.map} +1 -1
  124. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs → sdcorejs-angular-modules-pattern-routes-CfXmYmCp.mjs} +3 -3
  125. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs.map → sdcorejs-angular-modules-pattern-routes-CfXmYmCp.mjs.map} +1 -1
  126. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CuDWVZ4I.mjs +56 -0
  127. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CuDWVZ4I.mjs.map +1 -0
  128. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs → sdcorejs-angular-modules-pattern-routes-D8W_NHEH.mjs} +5 -5
  129. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs.map → sdcorejs-angular-modules-pattern-routes-D8W_NHEH.mjs.map} +1 -1
  130. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Db0ceW1C.mjs +66 -0
  131. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Db0ceW1C.mjs.map +1 -0
  132. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs → sdcorejs-angular-modules-pattern-routes-DdmOGRpF.mjs} +3 -3
  133. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs.map → sdcorejs-angular-modules-pattern-routes-DdmOGRpF.mjs.map} +1 -1
  134. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-JWx3RaLo.mjs} +12 -12
  135. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs.map → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-JWx3RaLo.mjs.map} +1 -1
  136. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs → sdcorejs-angular-modules-pattern-shell.component-DMJpUhpn.mjs} +4 -4
  137. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs.map → sdcorejs-angular-modules-pattern-shell.component-DMJpUhpn.mjs.map} +1 -1
  138. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BHDd7D8y.mjs +498 -0
  139. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BHDd7D8y.mjs.map +1 -0
  140. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs → sdcorejs-angular-modules-pattern-update.component-Bx2zgc86.mjs} +2 -2
  141. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs.map → sdcorejs-angular-modules-pattern-update.component-Bx2zgc86.mjs.map} +1 -1
  142. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs → sdcorejs-angular-modules-pattern-update.component-Cb29tp1H.mjs} +2 -2
  143. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs.map → sdcorejs-angular-modules-pattern-update.component-Cb29tp1H.mjs.map} +1 -1
  144. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs → sdcorejs-angular-modules-pattern-update.component-e5BaHrDk.mjs} +9 -6
  145. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-e5BaHrDk.mjs.map +1 -0
  146. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +1 -1
  147. package/fesm2022/sdcorejs-angular-services-confirm.mjs +171 -158
  148. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  149. package/fesm2022/sdcorejs-angular-services-excel.mjs +34 -0
  150. package/fesm2022/sdcorejs-angular-services-excel.mjs.map +1 -1
  151. package/fesm2022/sdcorejs-angular-services-query-params.mjs +227 -0
  152. package/fesm2022/sdcorejs-angular-services-query-params.mjs.map +1 -0
  153. package/fesm2022/sdcorejs-angular-utilities-extensions.mjs +24 -1
  154. package/fesm2022/sdcorejs-angular-utilities-extensions.mjs.map +1 -1
  155. package/modules/pattern/README.md +5 -4
  156. package/modules/pattern/docs/detail.md +18 -9
  157. package/modules/pattern/docs/drawer.md +185 -83
  158. package/modules/pattern/docs/header-actions.md +1 -1
  159. package/modules/pattern/docs/list.md +3 -3
  160. package/modules/pattern/docs/states.md +1 -1
  161. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +12 -16
  162. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +58 -29
  163. package/modules/pattern/features/category/pages/list/list.component.html +11 -3
  164. package/modules/pattern/features/category/pages/list/list.component.ts +36 -10
  165. package/modules/pattern/features/category/routes.ts +5 -22
  166. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +7 -11
  167. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +70 -27
  168. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +9 -53
  169. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +53 -19
  170. package/modules/pattern/features/customer/entity.resolver.ts +1 -1
  171. package/modules/pattern/features/customer/pages/list/list.component.html +18 -3
  172. package/modules/pattern/features/customer/pages/list/list.component.ts +43 -16
  173. package/modules/pattern/features/customer/pages/profile/profile.component.ts +17 -8
  174. package/modules/pattern/features/customer/routes.ts +6 -27
  175. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +37 -56
  176. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +14 -76
  177. package/modules/pattern/features/order/pages/create/create.component.ts +7 -3
  178. package/modules/pattern/features/order/pages/detail/detail.component.ts +1 -1
  179. package/modules/pattern/features/order/pages/update/update.component.ts +5 -2
  180. package/package.json +17 -5
  181. package/types/sdcorejs-angular-components-anchor.d.ts +6 -1
  182. package/types/sdcorejs-angular-components-button.d.ts +7 -1
  183. package/types/sdcorejs-angular-components-calendar.d.ts +1092 -0
  184. package/types/sdcorejs-angular-components-card.d.ts +247 -9
  185. package/types/sdcorejs-angular-components-kanban.d.ts +191 -74
  186. package/types/sdcorejs-angular-components-modal.d.ts +15 -1
  187. package/types/sdcorejs-angular-components-query-bar.d.ts +204 -38
  188. package/types/sdcorejs-angular-components-quick-action.d.ts +65 -1
  189. package/types/sdcorejs-angular-components-scheduler.d.ts +544 -0
  190. package/types/sdcorejs-angular-components-tab.d.ts +6 -1
  191. package/types/sdcorejs-angular-components-table.d.ts +338 -31
  192. package/types/sdcorejs-angular-components-timeline.d.ts +216 -0
  193. package/types/sdcorejs-angular-components-tree.d.ts +119 -6
  194. package/types/sdcorejs-angular-components.d.ts +3 -1
  195. package/types/sdcorejs-angular-directives.d.ts +4 -2
  196. package/types/sdcorejs-angular-forms-date.d.ts +2 -0
  197. package/types/sdcorejs-angular-forms-directives.d.ts +1 -1
  198. package/types/sdcorejs-angular-i18n.d.ts +159 -9
  199. package/types/sdcorejs-angular-modules-layout.d.ts +2 -1
  200. package/types/sdcorejs-angular-services-confirm.d.ts +22 -81
  201. package/types/sdcorejs-angular-services-excel.d.ts +59 -0
  202. package/types/sdcorejs-angular-services-query-params.d.ts +67 -0
  203. package/types/sdcorejs-angular-utilities-extensions.d.ts +10 -1
  204. package/fesm2022/sdcorejs-angular-components-history.mjs +0 -54
  205. package/fesm2022/sdcorejs-angular-components-history.mjs.map +0 -1
  206. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs +0 -146
  207. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs.map +0 -1
  208. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs +0 -148
  209. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs.map +0 -1
  210. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs.map +0 -1
  211. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +0 -18
  212. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +0 -1
  213. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs +0 -152
  214. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs.map +0 -1
  215. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs.map +0 -1
  216. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D8-WXUAE.mjs +0 -92
  217. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D8-WXUAE.mjs.map +0 -1
  218. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DHTxzjRN.mjs +0 -242
  219. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DHTxzjRN.mjs.map +0 -1
  220. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-CTgHdGeQ.mjs +0 -72
  221. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-CTgHdGeQ.mjs.map +0 -1
  222. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs +0 -172
  223. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs.map +0 -1
  224. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs.map +0 -1
  225. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs +0 -120
  226. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs.map +0 -1
  227. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +0 -1
  228. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +0 -1
  229. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs.map +0 -1
  230. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs +0 -74
  231. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs.map +0 -1
  232. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs +0 -100
  233. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs.map +0 -1
  234. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs +0 -135
  235. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs.map +0 -1
  236. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs +0 -146
  237. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs.map +0 -1
  238. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs.map +0 -1
  239. package/modules/pattern/features/category/entity.resolver.ts +0 -27
  240. package/types/sdcorejs-angular-components-history.d.ts +0 -23
@@ -1,24 +1,78 @@
1
1
  # Drawer
2
2
 
3
- Xem, tạo, cập nhật ngay trên danh sách: `sd-side-drawer` trong route con của danh sách. Route mẫu: `/pattern/customer/create`, `/pattern/customer/:id/detail`, `/pattern/customer/:id/update`, `/pattern/category/create?parent=`, `/pattern/category/:id/update`, chi tiết đơn hàng mặc định của `/pattern/order`.
3
+ Xem, tạo, cập nhật ngay trên danh sách: `sd-side-drawer` mở bằng `@if` trên màn đang hiện, không đổi URL. Mẫu: `/pattern/customer` (chi tiết, tạo, cập nhật; cập nhật cũng mở từ hồ sơ 360°), `/pattern/category` (tạo danh mục gốc và danh mục con, cập nhật).
4
4
 
5
5
  ## Khi nào dùng / khi nào không
6
6
 
7
7
  - Dùng khi người dùng cần giữ ngữ cảnh danh sách: xem nhanh, sửa vài field, tạo bản ghi con.
8
- - Nhiều tab, bảng quan hệ lớn, form nhiều bước hoặc rộng hơn 800px: dùng trang ([detail](detail.md), [form](form.md)).
8
+ - Nhiều tab, bảng quan hệ lớn, form nhiều bước hoặc rộng hơn 800px: dùng trang ([detail](detail.md), [form](form.md)). Trang là route con, có URL riêng.
9
+ - Chi tiết cần link chia sẻ được: làm trang chi tiết (route con). `/pattern/order` cho trang đó hiện trong drawer bằng `sd-page-list detail="drawer"` ([list](list.md)); đó là trang chi tiết đổi cách hiện, không phải drawer của pattern này.
9
10
 
10
11
  ## Code mẫu
11
12
 
12
- Chi tiết trong drawer: bản ghi tải bằng `detail(id)` qua resolver, footer có Hồ sơ 360° và Cập nhật, Xoá là icon đỏ cạnh X, đóng bằng X điều hướng về danh sách:
13
+ Màn danh sách giữ drawer đang mở trong một signal và dựng drawer bằng `@if`; mỗi lần mở là một drawer mới, đóng thì gỡ khỏi màn. Chi tiết sang cập nhật thay drawer này bằng drawer kia:
14
+
15
+ <!-- @source features/customer/pages/list/list.component.html -->
16
+ ```html
17
+ @let _drawer = drawer();
18
+ <sd-page-list title="Khách hàng" description="Khách cá nhân và doanh nghiệp đang giao dịch.">
19
+ <sd-button
20
+ headerRight
21
+ *sdPermission="'PATTERN_CUSTOMER_C_CREATE'"
22
+ title="Tạo khách hàng"
23
+ prefixIcon="add"
24
+ type="fill"
25
+ color="primary"
26
+ autoId="customer-create"
27
+ (click)="drawer.set({ type: 'create' })" />
28
+
29
+ <summary-cards [counts]="counts()" [(segment)]="segment" />
30
+
31
+ <sd-table autoId="customer-list" [option]="tableOption">
32
+ <ng-template sdTableCellDef="code" let-customer="item">
33
+ <a *sdPermission="'PATTERN_CUSTOMER_R_DETAIL'" href="" (click)="openDetail($event, customer.id)">{{ customer.code }}</a>
34
+ @if (!canOpenDetail) {
35
+ <span>{{ customer.code }}</span>
36
+ }
37
+ </ng-template>
38
+ </sd-table>
39
+ </sd-page-list>
40
+
41
+ @if (_drawer?.type === 'create') {
42
+ <create-side-drawer (closed)="drawer.set(null)" />
43
+ }
44
+ @if (_drawer?.type === 'detail') {
45
+ <detail-side-drawer
46
+ [id]="_drawer.id"
47
+ (update)="drawer.set({ type: 'update', id: _drawer.id })"
48
+ (profile)="openProfile(_drawer.id)"
49
+ (closed)="drawer.set(null)" />
50
+ }
51
+ @if (_drawer?.type === 'update') {
52
+ <update-side-drawer [id]="_drawer.id" (closed)="drawer.set(null)" />
53
+ }
54
+ ```
55
+
56
+ Chi tiết trong drawer: nhận `id`, tự tải bằng `detail(id)` và hiện trạng thái tải, lỗi bằng `sd-data-state`; footer có Hồ sơ 360° và Cập nhật, Xoá là icon đỏ cạnh X, chỉ đóng bằng X:
13
57
 
14
58
  <!-- @source features/customer/components/detail-side-drawer/detail-side-drawer.component.ts -->
15
59
  ```ts
16
- import { afterNextRender, ChangeDetectionStrategy, Component, computed, inject, signal, viewChild } from '@angular/core';
17
- import { toSignal } from '@angular/core/rxjs-interop';
18
- import { ActivatedRoute, Router, RouterLink } from '@angular/router';
19
- import { firstValueFrom, map } from 'rxjs';
60
+ import {
61
+ afterNextRender,
62
+ ChangeDetectionStrategy,
63
+ Component,
64
+ computed,
65
+ inject,
66
+ input,
67
+ OnInit,
68
+ output,
69
+ signal,
70
+ viewChild,
71
+ } from '@angular/core';
72
+ import { firstValueFrom, timeout } from 'rxjs';
20
73
  import { SdBadge } from '@sdcorejs/angular/components/badge';
21
74
  import { SdButton } from '@sdcorejs/angular/components/button';
75
+ import { SdDataState } from '@sdcorejs/angular/components/data-state';
22
76
  import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
23
77
  import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
24
78
  import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
@@ -29,24 +83,30 @@ import { customerStatusBadge, customerTypeName, type CustomerDto } from '../../s
29
83
  import { GeneralInformationViewComponent } from '../general-information-view/general-information-view.component';
30
84
 
31
85
  /**
32
- * Chi tiết khách hàng trong drawer (route con `:id/detail` của danh sách). Bản ghi do resolver tải bằng
33
- * `detail(id)`, không lấy dữ liệu của dòng. Chỉ đóng bằng X (cùng Esc, backdrop): không có nút Đóng (E4).
34
- * Xoá là tác vụ hiếm dùng và phá huỷ: nút chỉ có icon màu đỏ ở header, cạnh X; footer giữ tác vụ thường dùng.
86
+ * Chi tiết khách hàng trong drawer, mở từ mã khách hàng bằng `@if` (không đổi URL). Drawer mở ngay rồi tải bản ghi
87
+ * bằng `detail(id)`, không lấy dữ liệu của dòng; trạng thái tải và lỗi do `sd-data-state` hiện. Chỉ đóng bằng X (cùng
88
+ * Esc, backdrop): không có nút Đóng (E4). Xoá là tác vụ hiếm dùng và phá huỷ: nút chỉ có icon màu đỏ ở header, cạnh X;
89
+ * footer giữ tác vụ thường dùng. Cập nhật và Hồ sơ 360° báo lên danh sách, danh sách thay drawer này.
35
90
  */
36
91
  @Component({
37
92
  selector: 'detail-side-drawer',
38
93
  standalone: true,
39
- imports: [RouterLink, SdSideDrawer, SdBadge, SdButton, SdPermissionDirective, GeneralInformationViewComponent],
94
+ imports: [SdSideDrawer, SdBadge, SdButton, SdDataState, SdPermissionDirective, GeneralInformationViewComponent],
40
95
  changeDetection: ChangeDetectionStrategy.OnPush,
41
96
  template: `
42
97
  @let customer = entity();
43
- <sd-side-drawer width="600px" autoId="customer-detail" (sdClosed)="closed()">
98
+ <sd-side-drawer width="600px" autoId="customer-detail" (sdClosed)="closed.emit()">
44
99
  <div sdHeaderLeft class="d-flex flex-column">
45
- <div class="d-flex align-items-center gap-8">
46
- <span class="T16M">Chi tiết khách hàng #{{ customer.code }}</span>
47
- <sd-badge size="md" [type]="badge().type ?? 'round'" [title]="badge().title" [color]="badge().color" />
48
- </div>
49
- <span class="T14R text-secondary">{{ typeName() }} · {{ customer.phone }}</span>
100
+ @if (customer) {
101
+ @let _badge = badge();
102
+ <div class="d-flex align-items-center gap-8">
103
+ <span class="T16M">Chi tiết khách hàng #{{ customer.code }}</span>
104
+ <sd-badge size="md" [type]="_badge?.type ?? 'round'" [title]="_badge?.title" [color]="_badge?.color" />
105
+ </div>
106
+ <span class="T14R text-secondary">{{ typeName() }} · {{ customer.phone }}</span>
107
+ } @else {
108
+ <span class="T16M">Chi tiết khách hàng</span>
109
+ }
50
110
  </div>
51
111
  <sd-button
52
112
  sdHeaderRight
@@ -56,11 +116,16 @@ import { GeneralInformationViewComponent } from '../general-information-view/gen
56
116
  type="text"
57
117
  color="error"
58
118
  autoId="customer-delete"
119
+ [disabled]="!customer"
59
120
  [loading]="deleting()"
60
121
  (click)="delete()" />
61
- <general-information-view [customer]="customer" />
122
+ <sd-data-state [state]="state()" retryable (sdRetry)="load()">
123
+ @if (customer) {
124
+ <general-information-view [customer]="customer" />
125
+ }
126
+ </sd-data-state>
62
127
  <div sdFooterRight class="d-flex align-items-center gap-8">
63
- <sd-button title="Hồ sơ 360°" prefixIcon="contact_page" type="outline" autoId="customer-profile" [routerLink]="['../360']" />
128
+ <sd-button title="Hồ sơ 360°" prefixIcon="contact_page" type="outline" autoId="customer-profile" (click)="profile.emit()" />
64
129
  <sd-button
65
130
  *sdPermission="'PATTERN_CUSTOMER_U_UPDATE'"
66
131
  title="Cập nhật khách hàng"
@@ -68,35 +133,57 @@ import { GeneralInformationViewComponent } from '../general-information-view/gen
68
133
  type="fill"
69
134
  color="primary"
70
135
  autoId="customer-update"
71
- [routerLink]="['../update']" />
136
+ (click)="update.emit()" />
72
137
  </div>
73
138
  </sd-side-drawer>
74
139
  `,
75
140
  })
76
- export class DetailSideDrawerComponent {
141
+ export class DetailSideDrawerComponent implements OnInit {
77
142
  readonly #customerService = inject(CustomerService);
78
143
  readonly #confirm = inject(SdConfirmService);
79
144
  readonly #notify = inject(SdNotifyService);
80
- readonly #router = inject(Router);
81
- readonly #route = inject(ActivatedRoute);
145
+ readonly id = input.required<string>();
146
+ /** Người dùng chọn Cập nhật: danh sách thay drawer này bằng drawer cập nhật, không chồng hai lớp. */
147
+ readonly update = output<void>();
148
+ /** Người dùng chọn Hồ sơ 360°: danh sách đóng drawer này và mở trang hồ sơ. */
149
+ readonly profile = output<void>();
150
+ /** Drawer đã đóng (X, Esc, backdrop hoặc xoá xong): danh sách gỡ drawer khỏi màn. */
151
+ readonly closed = output<void>();
82
152
  private readonly drawer = viewChild.required(SdSideDrawer);
83
- protected readonly entity = toSignal(this.#route.data.pipe(map(data => data['entity'] as CustomerDto)), { requireSync: true });
84
- protected readonly badge = computed(() => customerStatusBadge(this.entity().status));
85
- protected readonly typeName = computed(() => customerTypeName(this.entity().type));
153
+ protected readonly state = signal<'loading' | 'error' | 'success'>('loading');
154
+ protected readonly entity = signal<CustomerDto | null>(null);
155
+ protected readonly badge = computed(() => {
156
+ const customer = this.entity();
157
+ return customer ? customerStatusBadge(customer.status) : null;
158
+ });
159
+ protected readonly typeName = computed(() => {
160
+ const customer = this.entity();
161
+ return customer ? customerTypeName(customer.type) : '';
162
+ });
86
163
  protected readonly deleting = signal(false);
87
164
 
88
165
  constructor() {
89
166
  afterNextRender(() => this.drawer().open());
90
167
  }
91
168
 
92
- protected closed(): void {
93
- // X, Esc, backdrop đều qua sdClosed; về danh sách bằng điều hướng để Back của trình duyệt cũng đóng được.
94
- // Sang drawer cập nhật hay hồ sơ 360° thì drawer này bị huỷ cùng route, không phát sdClosed.
95
- void this.#router.navigate(['../..'], { relativeTo: this.#route });
169
+ ngOnInit(): void {
170
+ void this.load();
171
+ }
172
+
173
+ /** Tải bản ghi bằng `detail(id)`, không dùng object của dòng; lỗi hiện trong drawer kèm nút thử lại. */
174
+ protected async load(): Promise<void> {
175
+ this.state.set('loading');
176
+ try {
177
+ this.entity.set(await firstValueFrom(this.#customerService.detail(this.id()).pipe(timeout(10_000))));
178
+ this.state.set('success');
179
+ } catch {
180
+ this.state.set('error');
181
+ }
96
182
  }
97
183
 
98
184
  protected async delete(): Promise<void> {
99
185
  const customer = this.entity();
186
+ if (!customer) return;
100
187
  try {
101
188
  await this.#confirm.confirm(`Xoá khách hàng ${customer.name}? Thao tác không hoàn tác được.`, {
102
189
  title: 'Xoá khách hàng',
@@ -121,7 +208,7 @@ export class DetailSideDrawerComponent {
121
208
  }
122
209
  ```
123
210
 
124
- Cập nhật trong drawer: `beforeClose` hỏi trước khi bỏ thay đổi, lưu xong đóng drawer, danh sách tải lại, focus trở về dòng:
211
+ Cập nhật trong drawer: `beforeClose` hỏi trước khi bỏ thay đổi, lưu xong báo `saved` rồi đóng drawer, danh sách tải lại, focus trở về dòng:
125
212
 
126
213
  <!-- @source features/customer/components/update-side-drawer/update-side-drawer.component.ts -->
127
214
  ```ts
@@ -133,14 +220,16 @@ import {
133
220
  ElementRef,
134
221
  inject,
135
222
  Injector,
223
+ input,
224
+ OnInit,
225
+ output,
136
226
  signal,
137
227
  viewChild,
138
228
  } from '@angular/core';
139
- import { toSignal } from '@angular/core/rxjs-interop';
140
229
  import { FormGroup } from '@angular/forms';
141
- import { ActivatedRoute, Router } from '@angular/router';
142
- import { firstValueFrom, map } from 'rxjs';
230
+ import { firstValueFrom, timeout } from 'rxjs';
143
231
  import { SdButton } from '@sdcorejs/angular/components/button';
232
+ import { SdDataState } from '@sdcorejs/angular/components/data-state';
144
233
  import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
145
234
  import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
146
235
  import { SdNotifyService } from '@sdcorejs/angular/services/notify';
@@ -159,46 +248,65 @@ import {
159
248
  } from '../general-information-form/general-information-form.component';
160
249
 
161
250
  /**
162
- * Cập nhật khách hàng trong drawer (route con `:id/update`). X, Esc và backdrop đi qua `beforeClose`: còn thay đổi
163
- * thì hỏi trước khi bỏ. Lưu thành công thì đóng drawer; danh sách tải lại và focus trở về dòng đã mở.
251
+ * Cập nhật khách hàng trong drawer, mở bằng `@if` từ drawer chi tiết hoặc hồ sơ 360° (không đổi URL). Drawer mở ngay
252
+ * rồi tải bản ghi bằng `detail(id)`; trạng thái tải và lỗi do `sd-data-state` hiện. X, Esc và backdrop đi qua
253
+ * `beforeClose`: còn thay đổi thì hỏi trước khi bỏ. Lưu thành công thì báo `saved` rồi đóng drawer; danh sách tải lại
254
+ * và focus trở về phần tử đã mở drawer.
164
255
  */
165
256
  @Component({
166
257
  selector: 'update-side-drawer',
167
258
  standalone: true,
168
- imports: [SdSideDrawer, SdButton, GeneralInformationFormComponent],
259
+ imports: [SdSideDrawer, SdButton, SdDataState, GeneralInformationFormComponent],
169
260
  changeDetection: ChangeDetectionStrategy.OnPush,
170
261
  template: `
262
+ @let _entity = entity();
171
263
  <sd-side-drawer
172
- [title]="'Cập nhật khách hàng #' + entity().code"
264
+ [title]="_entity ? 'Cập nhật khách hàng #' + _entity.code : 'Cập nhật khách hàng'"
173
265
  width="600px"
174
266
  autoId="customer-update"
175
267
  [beforeClose]="beforeClose"
176
- (sdClosed)="closed()">
177
- <general-information-form [form]="form" [seed]="entity()" [errors]="apiErrors.errors()" [invalidGroups]="invalidGroups()" />
268
+ (sdClosed)="closed.emit()">
269
+ <sd-data-state [state]="state()" retryable (sdRetry)="load()">
270
+ @if (_entity) {
271
+ <general-information-form [form]="form" [seed]="_entity" [errors]="apiErrors.errors()" [invalidGroups]="invalidGroups()" />
272
+ }
273
+ </sd-data-state>
178
274
  <div sdFooterRight class="d-flex align-items-center gap-8">
179
- <sd-button title="Lưu" prefixIcon="save" type="fill" color="primary" autoId="customer-save" [loading]="saving()" (click)="save()" />
275
+ <sd-button
276
+ title="Lưu"
277
+ prefixIcon="save"
278
+ type="fill"
279
+ color="primary"
280
+ autoId="customer-save"
281
+ [disabled]="!_entity"
282
+ [loading]="saving()"
283
+ (click)="save()" />
180
284
  </div>
181
285
  </sd-side-drawer>
182
286
  `,
183
287
  })
184
- export class UpdateSideDrawerComponent {
288
+ export class UpdateSideDrawerComponent implements OnInit {
185
289
  readonly #customerService = inject(CustomerService);
186
290
  readonly #confirm = inject(SdConfirmService);
187
291
  readonly #notify = inject(SdNotifyService);
188
- readonly #router = inject(Router);
189
- readonly #route = inject(ActivatedRoute);
190
292
  readonly #injector = inject(Injector);
293
+ readonly id = input.required<string>();
294
+ /** Lưu thành công, kèm bản ghi API trả về: màn đang hiện bản ghi (hồ sơ 360°) cập nhật theo. */
295
+ readonly saved = output<CustomerDto>();
296
+ /** Drawer đã đóng (X, Esc, backdrop hoặc lưu xong): màn mở drawer gỡ nó khỏi màn. */
297
+ readonly closed = output<void>();
191
298
  private readonly drawer = viewChild.required(SdSideDrawer);
192
299
  // why: sd-side-drawer chuyển nội dung ra body, nên tìm field lỗi trong form chứ không trong host của component.
193
300
  private readonly formElement = viewChild.required(GeneralInformationFormComponent, { read: ElementRef });
194
- protected readonly entity = toSignal(this.#route.data.pipe(map(data => data['entity'] as CustomerDto)), { requireSync: true });
301
+ protected readonly state = signal<'loading' | 'error' | 'success'>('loading');
302
+ protected readonly entity = signal<CustomerDto | null>(null);
195
303
  protected readonly form: CustomerForm = new FormGroup({});
196
304
  protected readonly saving = signal(false);
197
305
  protected readonly apiErrors = formApiErrors(this.form);
198
306
  protected readonly invalidGroups = signal<CustomerFormGroup[]>([]);
199
307
  readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'customer-update', dirty: 'value' });
200
308
 
201
- /** Đóng khi còn thay đổi chưa lưu: hỏi, đồng ý thì bỏ thay đổi (guard rời route không hỏi lại). */
309
+ /** Đóng khi còn thay đổi chưa lưu: hỏi, đồng ý thì bỏ thay đổi (guard rời trang không hỏi lại). */
202
310
  protected readonly beforeClose = async (): Promise<boolean> => {
203
311
  if (!this.#unsaved.dirty() || this.saving()) return !this.saving();
204
312
  try {
@@ -220,12 +328,24 @@ export class UpdateSideDrawerComponent {
220
328
  inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
221
329
  }
222
330
 
223
- protected closed(): void {
224
- void this.#router.navigate(['../..'], { relativeTo: this.#route });
331
+ ngOnInit(): void {
332
+ void this.load();
333
+ }
334
+
335
+ /** Tải bản ghi bằng `detail(id)`, không dùng object của dòng; lỗi hiện trong drawer kèm nút thử lại. */
336
+ protected async load(): Promise<void> {
337
+ this.state.set('loading');
338
+ try {
339
+ this.entity.set(await firstValueFrom(this.#customerService.detail(this.id()).pipe(timeout(10_000))));
340
+ this.state.set('success');
341
+ } catch {
342
+ this.state.set('error');
343
+ }
225
344
  }
226
345
 
227
346
  protected async save(): Promise<void> {
228
- if (this.saving()) return;
347
+ const entity = this.entity();
348
+ if (!entity || this.saving()) return;
229
349
  this.form.markAllAsTouched();
230
350
  if (this.form.invalid) {
231
351
  this.#showErrors();
@@ -233,9 +353,10 @@ export class UpdateSideDrawerComponent {
233
353
  }
234
354
  this.saving.set(true);
235
355
  try {
236
- await firstValueFrom(this.#customerService.update(this.entity().id, customerSaveReq(this.form)));
356
+ const customer = await firstValueFrom(this.#customerService.update(entity.id, customerSaveReq(this.form)));
237
357
  this.#unsaved.markPristine();
238
358
  this.#notify.success('Đã cập nhật khách hàng.');
359
+ this.saved.emit(customer);
239
360
  this.saving.set(false);
240
361
  this.drawer().close();
241
362
  } catch (error) {
@@ -400,7 +521,7 @@ export class GeneralInformationFormComponent {
400
521
  }
401
522
  ```
402
523
 
403
- Route con của danh sách; `data.detail: 'page'` cho route mở thành trang thay chỗ danh sách:
524
+ Drawer không có route; chỉ hồ sơ 360° (trang) là route con. Route của màn mở drawer có `sdPageFormLeaveGuard`, nên Back của trình duyệt lúc drawer còn thay đổi vẫn hỏi:
404
525
 
405
526
  <!-- @source features/customer/routes.ts -->
406
527
  ```ts
@@ -411,8 +532,9 @@ import { entityResolver } from './entity.resolver';
411
532
  import { CustomerService } from './services/customer.service';
412
533
 
413
534
  /**
414
- * Chi tiết, tạo và cập nhật mở trong drawer (route con của danh sách); hồ sơ 360° là trang thay chỗ danh sách
415
- * (`data.detail: 'page'`). Đóng drawer hay quay lại đều giữ bộ lọc, trang và vị trí cuộn của danh sách.
535
+ * Chi tiết, tạo và cập nhật mở trong drawer trên danh sách, không đổi URL. Hồ sơ 360° là trang, route con thay chỗ
536
+ * danh sách; quay lại vẫn giữ bộ lọc, trang và vị trí cuộn. Guard rời trang hỏi trước khi bỏ thay đổi khi màn bị rời
537
+ * lúc drawer còn thay đổi chưa lưu (Back của trình duyệt).
416
538
  */
417
539
  export const routes: Routes = [
418
540
  {
@@ -424,36 +546,14 @@ export const routes: Routes = [
424
546
  path: '',
425
547
  title: 'Khách hàng',
426
548
  data: { permission: 'PATTERN_CUSTOMER_R_LIST' },
549
+ canDeactivate: [sdPageFormLeaveGuard],
427
550
  loadComponent: () => import('./pages/list/list.component').then(module => module.ListComponent),
428
551
  children: [
429
- {
430
- path: 'create',
431
- data: { permission: 'PATTERN_CUSTOMER_C_CREATE' },
432
- canDeactivate: [sdPageFormLeaveGuard],
433
- loadComponent: () =>
434
- import('./components/create-side-drawer/create-side-drawer.component').then(module => module.CreateSideDrawerComponent),
435
- },
436
- {
437
- path: ':id/detail',
438
- data: { permission: 'PATTERN_CUSTOMER_R_DETAIL' },
439
- resolve: { entity: entityResolver },
440
- runGuardsAndResolvers: 'paramsChange',
441
- loadComponent: () =>
442
- import('./components/detail-side-drawer/detail-side-drawer.component').then(module => module.DetailSideDrawerComponent),
443
- },
444
- {
445
- path: ':id/update',
446
- data: { permission: 'PATTERN_CUSTOMER_U_UPDATE' },
447
- resolve: { entity: entityResolver },
448
- runGuardsAndResolvers: 'paramsChange',
449
- canDeactivate: [sdPageFormLeaveGuard],
450
- loadComponent: () =>
451
- import('./components/update-side-drawer/update-side-drawer.component').then(module => module.UpdateSideDrawerComponent),
452
- },
453
552
  {
454
553
  path: ':id/360',
455
554
  title: 'Hồ sơ khách hàng',
456
- data: { permission: 'PATTERN_CUSTOMER_R_DETAIL', detail: 'page' },
555
+ data: { permission: 'PATTERN_CUSTOMER_R_DETAIL' },
556
+ canDeactivate: [sdPageFormLeaveGuard],
457
557
  resolve: { entity: entityResolver },
458
558
  runGuardsAndResolvers: 'paramsChange',
459
559
  loadComponent: () => import('./pages/profile/profile.component').then(module => module.ProfileComponent),
@@ -467,18 +567,20 @@ export const routes: Routes = [
467
567
 
468
568
  ## Quy tắc
469
569
 
470
- - MUST đặt drawer trong component của route con (`create`, `:id/detail`, `:id/update`) và mở khi component sẵn sàng; `sdClosed` điều hướng về danh sách (`'../..'` từ route hai segment), nên Back của trình duyệt cũng đóng drawer.
570
+ - MUST mở drawer bằng `@if` trên màn đang hiện (danh sách, hồ sơ) theo một signal của màn; drawer không có route và không đổi URL. `sdClosed` của drawer báo `closed`, màn đặt signal về `null` để gỡ drawer.
571
+ - MUST truyền vào drawer `id` của bản ghi (hoặc dữ liệu tối thiểu cho bản ghi con, như danh mục cha); drawer tự tải bằng `detail(id)` và hiện tải, lỗi bằng `sd-data-state` có thử lại. Không dùng object của dòng làm dữ liệu chi tiết.
471
572
  - MUST chỉ đóng bằng X, Esc, backdrop (E4); không có nút Đóng hay Huỷ thường trực.
472
- - MUST đi qua `beforeClose` cho mọi đường đóng khi còn thay đổi; đồng ý bỏ thì `markPristine()` để guard của route không hỏi lần hai.
573
+ - MUST đi qua `beforeClose` cho mọi đường đóng khi còn thay đổi; đồng ý bỏ thì `markPristine()`. Route của màn mở drawer khai báo `canDeactivate: [sdPageFormLeaveGuard]` để rời màn lúc drawer còn thay đổi vẫn hỏi.
473
574
  - MUST đặt tác vụ thường dùng ở `sdFooterRight`: nút chính (`fill`, có icon) ở ngoài cùng bên phải, nút phụ (`outline`) bên trái nó. Mở màn khác (Hồ sơ 360°) cũng là nút, không phải link.
474
575
  - MUST đặt tác vụ phá huỷ ít dùng (Xoá) ở `sdHeaderRight`, cạnh X: nút chỉ có icon màu đỏ (`type="text"`, `color="error"`) với `tooltip` làm tên, và vẫn hỏi xác nhận (E13).
475
- - MUST tải chi tiết bằng `detail(id)`; không dùng object của dòng làm dữ liệu chi tiết.
476
- - MUST chỉ tải lại danh sách khi lưu thành công; trả focus về phần tử đã mở drawer (`sd-page-list` giữ phần tử này kể cả khi chi tiết chuyển sang cập nhật).
576
+ - MUST chuyển chi tiết sang cập nhật bằng cách thay drawer trong cùng signal: mỗi lúc chỉ một drawer.
577
+ - MUST chỉ tải lại danh sách khi lưu thành công, sau khi drawer đã đóng; `sd-side-drawer` trả focus về phần tử đã mở drawer.
477
578
  - SHOULD dùng bề rộng 600px cho chi tiết và form thường, 480px cho nội dung ngắn, tối đa 800px (E9).
478
579
  - SHOULD tách `detail-side-drawer`, `create-side-drawer`, `update-side-drawer`; dùng chung `-form`/`-view`, không gộp ba chế độ vào một drawer.
479
580
 
480
581
  ## Lỗi hay gặp
481
582
 
482
- - Drawer mở bằng method mà không có route: Back của trình duyệt rời cả màn danh sách, link không chia sẻ được.
583
+ - Đặt drawer làm route con (`create`, `:id/update`): mỗi lần mở đổi URL, Back của trình duyệt mở lại form đã đóng, link dẫn thẳng vào form mất ngữ cảnh danh sách.
584
+ - Giữ drawer luôn trong DOM rồi gọi `open()`: form còn giá trị của lần mở trước. Dựng lại bằng `@if` mỗi lần mở.
483
585
  - Mở chồng drawer cập nhật lên drawer chi tiết: hai lớp backdrop, Esc chỉ đóng một lớp.
484
586
  - Tải lại danh sách mỗi lần đóng drawer: mất vị trí cuộn và lựa chọn dù không có gì thay đổi.
@@ -202,7 +202,7 @@ import { canUpdateOrder, orderApprovalBadge, orderStatusBadge, type OrderAction,
202
202
  <sd-section-item label="Ghi chú">{{ order.note | sdEmpty }}</sd-section-item>
203
203
  </sd-section>
204
204
  </div>
205
- <approval-steps sdAside [steps]="order.approvalHistory" />
205
+ <approval-steps sdAside [steps]="order.approvalHistory" [createdAt]="order.createdAt" [creator]="order.creator" />
206
206
  </sd-page-detail>
207
207
  }
208
208
  `,
@@ -121,7 +121,7 @@ export class ListComponent {
121
121
  }
122
122
  ```
123
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:
124
+ Trang 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
125
 
126
126
  <!-- @source features/product/routes.ts -->
127
127
  ```ts
@@ -232,8 +232,8 @@ protected readonly counts = signal<OrderCounts | null>(null);
232
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
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
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.
235
+ - MUST đặt trang 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"` hiện trang con trong drawer và giữ danh sách trên màn. Drawer xem/sửa nhanh ([drawer](drawer.md)) không phải route con: mở bằng `@if`, không đổi URL.
236
+ - MUST tải lại danh sách khi trang con hay drawer đã 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
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
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
239
  - SHOULD giữ mặc định `hideInlineFilter: false`; màn ít dữ liệu dùng `'auto'`; không dùng `true` (E7).
@@ -76,7 +76,7 @@ import { map, timeout } from 'rxjs';
76
76
  import { CustomerService } from './services/customer.service';
77
77
  import type { CustomerDto } from './services/customer.model';
78
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. */
79
+ /** Tải khách hàng bằng `detail(id)` trước khi mở hồ sơ 360°; lỗi đi tới navigation error handler của host. */
80
80
  export const entityResolver: ResolveFn<CustomerDto> = route => {
81
81
  const id = route.paramMap.get('id');
82
82
  if (!id?.trim()) throw new HttpErrorResponse({ status: 404 });
@@ -6,13 +6,13 @@ import {
6
6
  ElementRef,
7
7
  inject,
8
8
  Injector,
9
+ input,
10
+ output,
9
11
  signal,
10
12
  viewChild,
11
13
  } from '@angular/core';
12
- import { toSignal } from '@angular/core/rxjs-interop';
13
14
  import { FormGroup } from '@angular/forms';
14
- import { ActivatedRoute, Router } from '@angular/router';
15
- import { firstValueFrom, map } from 'rxjs';
15
+ import { firstValueFrom } from 'rxjs';
16
16
  import { SdButton } from '@sdcorejs/angular/components/button';
17
17
  import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
18
18
  import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
@@ -30,7 +30,7 @@ import {
30
30
  } from '../general-information-form/general-information-form.component';
31
31
 
32
32
  /**
33
- * Tạo danh mục trong drawer (route con `create`, `?parent=<id>` cho danh mục con). Danh mục cha do resolver tải.
33
+ * Tạo danh mục trong drawer, mở từ danh sách bằng `@if` (không đổi URL); `parent` là danh mục cha khi thêm danh mục con.
34
34
  * X, Esc và backdrop hỏi trước khi bỏ thay đổi; lưu xong đóng drawer và danh sách tải lại.
35
35
  */
36
36
  @Component({
@@ -39,12 +39,13 @@ import {
39
39
  imports: [SdSideDrawer, SdButton, GeneralInformationFormComponent],
40
40
  changeDetection: ChangeDetectionStrategy.OnPush,
41
41
  template: `
42
+ @let _parent = parent();
42
43
  <sd-side-drawer
43
- [title]="parent() ? 'Thêm danh mục con của ' + parent()!.name : 'Tạo danh mục'"
44
+ [title]="_parent ? 'Thêm danh mục con của ' + _parent.name : 'Tạo danh mục'"
44
45
  autoId="category-create"
45
46
  [beforeClose]="beforeClose"
46
- (sdClosed)="closed()">
47
- <general-information-form [form]="form" [seed]="seed" [parentName]="parent()?.name ?? null" [errors]="apiErrors.errors()" />
47
+ (sdClosed)="closed.emit()">
48
+ <general-information-form [form]="form" [seed]="seed" [parentName]="_parent?.name ?? null" [errors]="apiErrors.errors()" />
48
49
  <div sdFooterRight class="d-flex align-items-center gap-8">
49
50
  <sd-button
50
51
  title="Tạo danh mục"
@@ -62,14 +63,13 @@ export class CreateSideDrawerComponent {
62
63
  readonly #categoryService = inject(CategoryService);
63
64
  readonly #confirm = inject(SdConfirmService);
64
65
  readonly #notify = inject(SdNotifyService);
65
- readonly #router = inject(Router);
66
- readonly #route = inject(ActivatedRoute);
67
66
  readonly #injector = inject(Injector);
67
+ /** Danh mục cha khi thêm danh mục con; `null` tạo danh mục gốc. */
68
+ readonly parent = input<Pick<CategoryDto, 'id' | 'name'> | null>(null);
69
+ /** Drawer đã đóng (X, Esc, backdrop hoặc lưu xong): danh sách gỡ drawer khỏi màn. */
70
+ readonly closed = output<void>();
68
71
  private readonly drawer = viewChild.required(SdSideDrawer);
69
72
  private readonly formElement = viewChild.required(GeneralInformationFormComponent, { read: ElementRef });
70
- protected readonly parent = toSignal(this.#route.data.pipe(map(data => (data['parent'] as CategoryDto | null) ?? null)), {
71
- requireSync: true,
72
- });
73
73
  protected readonly seed: CategorySaveReq = { code: '', name: '', parentId: null, status: 'active' };
74
74
  protected readonly form: CategoryForm = new FormGroup({});
75
75
  protected readonly saving = signal(false);
@@ -98,10 +98,6 @@ export class CreateSideDrawerComponent {
98
98
  inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
99
99
  }
100
100
 
101
- protected closed(): void {
102
- void this.#router.navigate(['..'], { relativeTo: this.#route });
103
- }
104
-
105
101
  protected async save(): Promise<void> {
106
102
  if (this.saving()) return;
107
103
  this.form.markAllAsTouched();