@sdcorejs/angular 19.3.2 → 19.3.4

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 (429) 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/components/badge/index.d.ts +1 -0
  5. package/components/badge/src/badge.model.d.ts +19 -0
  6. package/components/query-bar/src/components/actions-bar/actions-bar.component.d.ts +6 -1
  7. package/components/query-bar/src/components/field-picker/field-picker.component.d.ts +21 -0
  8. package/components/query-bar/src/components/inline-chip/inline-chip.component.d.ts +7 -1
  9. package/components/query-bar/src/components/inline-value-chip/inline-value-chip.component.d.ts +7 -1
  10. package/components/query-bar/src/components/popover-chip/popover-chip.component.d.ts +16 -2
  11. package/components/query-bar/src/query-bar.component.d.ts +66 -8
  12. package/components/query-bar/src/query-bar.model.d.ts +44 -1
  13. package/components/section/index.d.ts +1 -0
  14. package/components/section/src/section-registry.d.ts +11 -0
  15. package/components/splitter/index.d.ts +1 -1
  16. package/components/tab-router/src/actions/tab-router.action.d.ts +1 -1
  17. package/components/tab-router/src/components/tab-router-item/tab-router-item.component.d.ts +4 -2
  18. package/components/tab-router/src/components/tab-router-nav/tab-router-nav.component.d.ts +31 -3
  19. package/components/tab-router/src/components/tab-router-outlet/tab-router-outlet.component.d.ts +6 -1
  20. package/components/tab-router/src/models/tab-router.model.d.ts +5 -0
  21. package/components/tab-router/src/pipes/tab-info.pipe.d.ts +7 -0
  22. package/components/tab-router/src/services/tab-router.service.d.ts +5 -0
  23. package/components/table/index.d.ts +2 -0
  24. package/components/table/src/components/config/config-width.util.d.ts +9 -0
  25. package/components/table/src/components/config/config.component.d.ts +58 -11
  26. package/components/table/src/components/filter/column-filter/column-filter.component.d.ts +5 -0
  27. package/components/table/src/components/filter/external-filter/external-filter.component.d.ts +5 -1
  28. package/components/table/src/components/mobile-cards/mobile-cards.component.d.ts +4 -0
  29. package/components/table/src/configurations/index.d.ts +1 -0
  30. package/components/table/src/configurations/table-layout.d.ts +16 -0
  31. package/components/table/src/configurations/table.configuration.d.ts +7 -1
  32. package/components/table/src/models/index.d.ts +1 -0
  33. package/components/table/src/models/table-column.model.d.ts +3 -10
  34. package/components/table/src/models/table-item.model.d.ts +4 -1
  35. package/components/table/src/models/table-option-loading.model.d.ts +42 -0
  36. package/components/table/src/models/table-option.model.d.ts +6 -0
  37. package/components/table/src/services/column-leaf.util.d.ts +6 -0
  38. package/components/table/src/services/config-custom.util.d.ts +14 -0
  39. package/components/table/src/services/table-filter/table-filter.model.d.ts +30 -0
  40. package/components/table/src/services/table-filter/table-query-bar.util.d.ts +110 -0
  41. package/components/table/src/services/table-loading/table-loading.util.d.ts +91 -0
  42. package/components/table/src/services/tree/tree.util.d.ts +2 -0
  43. package/components/table/src/table.component.d.ts +60 -1
  44. package/components/upload-file/src/components/file-type-icon/file-type-icon.component.d.ts +15 -0
  45. package/components/upload-file/src/components/preview/preview.component.d.ts +88 -10
  46. package/components/upload-file/src/configurations/upload-file.configuration.d.ts +1 -1
  47. package/components/upload-file/src/helpers/file-type.d.ts +25 -0
  48. package/components/upload-file/src/pipes/file-meta.pipe.d.ts +9 -0
  49. package/components/upload-file/src/pipes/file-reason.pipe.d.ts +11 -0
  50. package/components/upload-file/src/pipes/index.d.ts +2 -0
  51. package/components/upload-file/src/upload-file.component.d.ts +89 -8
  52. package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
  53. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  54. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +3 -3
  55. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  56. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +455 -37
  57. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  58. package/fesm2022/sdcorejs-angular-components-section.mjs +15 -3
  59. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  60. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  61. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  62. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  63. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +390 -75
  64. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  65. package/fesm2022/sdcorejs-angular-components-table.mjs +1667 -124
  66. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  67. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +886 -173
  68. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  69. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +7 -2
  70. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  71. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +5 -2
  72. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  73. package/fesm2022/sdcorejs-angular-forms-chip.mjs +421 -121
  74. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  75. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +4 -0
  76. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  77. package/fesm2022/sdcorejs-angular-forms-date.mjs +4 -0
  78. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  79. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +4 -0
  80. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  81. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +17 -2
  82. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  83. package/fesm2022/sdcorejs-angular-forms-input.mjs +4 -0
  84. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  85. package/fesm2022/sdcorejs-angular-forms-select.mjs +26 -20
  86. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  87. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +14 -1
  88. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  89. package/fesm2022/sdcorejs-angular-i18n.mjs +350 -5
  90. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  91. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs} +3 -3
  92. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs.map} +1 -1
  93. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs} +3 -3
  94. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs.map} +1 -1
  95. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs → sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs} +3 -3
  96. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs.map} +1 -1
  97. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs} +4 -4
  98. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs.map} +1 -1
  99. package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
  100. package/fesm2022/sdcorejs-angular-modules-layout.mjs +347 -10
  101. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  102. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
  103. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
  104. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
  105. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
  106. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-DK33LxHm.mjs +51 -0
  107. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-DK33LxHm.mjs.map +1 -0
  108. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B1BUBiag.mjs +145 -0
  109. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B1BUBiag.mjs.map +1 -0
  110. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B27ZX8Co.mjs +144 -0
  111. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B27ZX8Co.mjs.map +1 -0
  112. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-Bi2tMFHf.mjs +460 -0
  113. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-Bi2tMFHf.mjs.map +1 -0
  114. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CPwGkrNk.mjs +142 -0
  115. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CPwGkrNk.mjs.map +1 -0
  116. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-VCbA_FkZ.mjs +113 -0
  117. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-VCbA_FkZ.mjs.map +1 -0
  118. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
  119. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
  120. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-CehsdBRP.mjs +66 -0
  121. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-CehsdBRP.mjs.map +1 -0
  122. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-CPhLTiyx.mjs +148 -0
  123. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-CPhLTiyx.mjs.map +1 -0
  124. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-5kI7wGdX.mjs +484 -0
  125. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-5kI7wGdX.mjs.map +1 -0
  126. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CjAy-B9K.mjs +172 -0
  127. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CjAy-B9K.mjs.map +1 -0
  128. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CnL2FzCx.mjs +90 -0
  129. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CnL2FzCx.mjs.map +1 -0
  130. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-DObN_wCR.mjs +514 -0
  131. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-DObN_wCR.mjs.map +1 -0
  132. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DpnYSG2j.mjs +61 -0
  133. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DpnYSG2j.mjs.map +1 -0
  134. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-C_ST-ld5.mjs +170 -0
  135. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-C_ST-ld5.mjs.map +1 -0
  136. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs +87 -0
  137. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs.map +1 -0
  138. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs +232 -0
  139. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs.map +1 -0
  140. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs +70 -0
  141. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs.map +1 -0
  142. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-TTrWCXIT.mjs +100 -0
  143. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-TTrWCXIT.mjs.map +1 -0
  144. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-B1qePLfk.mjs +812 -0
  145. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-B1qePLfk.mjs.map +1 -0
  146. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BY5gjtNS.mjs +71 -0
  147. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BY5gjtNS.mjs.map +1 -0
  148. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CJ38CJXg.mjs +629 -0
  149. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CJ38CJXg.mjs.map +1 -0
  150. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CdgPtSjJ.mjs +164 -0
  151. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CdgPtSjJ.mjs.map +1 -0
  152. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DKIwrluh.mjs +118 -0
  153. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DKIwrluh.mjs.map +1 -0
  154. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-W9vY7HrT.mjs +115 -0
  155. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-W9vY7HrT.mjs.map +1 -0
  156. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-CI0H_5a4.mjs +1069 -0
  157. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-CI0H_5a4.mjs.map +1 -0
  158. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs +193 -0
  159. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +1 -0
  160. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs +99 -0
  161. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +1 -0
  162. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
  163. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
  164. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-D829aEk5.mjs +48 -0
  165. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-D829aEk5.mjs.map +1 -0
  166. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-BEFVmSSj.mjs +295 -0
  167. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-BEFVmSSj.mjs.map +1 -0
  168. package/fesm2022/sdcorejs-angular-modules-pattern-routes-1kDb9T7_.mjs +74 -0
  169. package/fesm2022/sdcorejs-angular-modules-pattern-routes-1kDb9T7_.mjs.map +1 -0
  170. package/fesm2022/sdcorejs-angular-modules-pattern-routes-B-TJUSV_.mjs +66 -0
  171. package/fesm2022/sdcorejs-angular-modules-pattern-routes-B-TJUSV_.mjs.map +1 -0
  172. package/fesm2022/sdcorejs-angular-modules-pattern-routes-B6z7KO0P.mjs +45 -0
  173. package/fesm2022/sdcorejs-angular-modules-pattern-routes-B6z7KO0P.mjs.map +1 -0
  174. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DS39vgzU.mjs +50 -0
  175. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DS39vgzU.mjs.map +1 -0
  176. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DVlcUUzh.mjs +43 -0
  177. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DVlcUUzh.mjs.map +1 -0
  178. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DxWDWUdo.mjs +165 -0
  179. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DxWDWUdo.mjs.map +1 -0
  180. package/fesm2022/sdcorejs-angular-modules-pattern-routes-r9CTj-8C.mjs +74 -0
  181. package/fesm2022/sdcorejs-angular-modules-pattern-routes-r9CTj-8C.mjs.map +1 -0
  182. package/fesm2022/sdcorejs-angular-modules-pattern-routes-xI1XYRo6.mjs +99 -0
  183. package/fesm2022/sdcorejs-angular-modules-pattern-routes-xI1XYRo6.mjs.map +1 -0
  184. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-nV5dVFx2.mjs +406 -0
  185. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-nV5dVFx2.mjs.map +1 -0
  186. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-0rRaWsuo.mjs +317 -0
  187. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-0rRaWsuo.mjs.map +1 -0
  188. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-6uH7sDEg.mjs +143 -0
  189. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-6uH7sDEg.mjs.map +1 -0
  190. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DglN2sS_.mjs +132 -0
  191. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DglN2sS_.mjs.map +1 -0
  192. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-BmsOgENL.mjs +359 -0
  193. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-BmsOgENL.mjs.map +1 -0
  194. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DPZ_ucNB.mjs +138 -0
  195. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DPZ_ucNB.mjs.map +1 -0
  196. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DkAcDmsZ.mjs +100 -0
  197. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DkAcDmsZ.mjs.map +1 -0
  198. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
  199. package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
  200. package/fesm2022/sdcorejs-angular-services-api.mjs +11 -11
  201. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  202. package/fesm2022/sdcorejs-angular-services-cache.mjs +7 -5
  203. package/fesm2022/sdcorejs-angular-services-cache.mjs.map +1 -1
  204. package/fesm2022/sdcorejs-angular-services-storage.mjs +6 -4
  205. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  206. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
  207. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
  208. package/forms/chip/src/chip.component.d.ts +135 -19
  209. package/forms/chip/src/index.d.ts +0 -1
  210. package/i18n/src/en.d.ts +70 -1
  211. package/modules/layout/components/index.d.ts +2 -0
  212. package/modules/layout/components/page/page-form-leave.guard.d.ts +9 -0
  213. package/modules/layout/components/page/page.component.d.ts +38 -2
  214. package/modules/layout/components/page-list/page-list.component.d.ts +42 -0
  215. package/modules/layout/components/shared/context-switcher/context-switcher.component.d.ts +1 -1
  216. package/modules/pattern/README.md +76 -0
  217. package/modules/pattern/configurations/pattern.configuration.d.ts +30 -0
  218. package/modules/pattern/configurations/provide-sd-patterns.d.ts +19 -0
  219. package/modules/pattern/core/mock-api/mock-api.interceptor.d.ts +8 -0
  220. package/modules/pattern/core/mock-api/mock-api.model.d.ts +62 -0
  221. package/modules/pattern/core/mock-api/mock-api.state.d.ts +36 -0
  222. package/modules/pattern/core/mock-api/mock-backend.d.ts +18 -0
  223. package/modules/pattern/core/mock-api/mock-backend.factory.d.ts +3 -0
  224. package/modules/pattern/core/mock-api/prng.d.ts +4 -0
  225. package/modules/pattern/core/mock-api/resources/approval.resource.d.ts +14 -0
  226. package/modules/pattern/core/mock-api/resources/category.resource.d.ts +9 -0
  227. package/modules/pattern/core/mock-api/resources/customer.resource.d.ts +22 -0
  228. package/modules/pattern/core/mock-api/resources/index.d.ts +3 -0
  229. package/modules/pattern/core/mock-api/resources/names.d.ts +5 -0
  230. package/modules/pattern/core/mock-api/resources/order.resource.d.ts +44 -0
  231. package/modules/pattern/core/mock-api/resources/partner.resource.d.ts +16 -0
  232. package/modules/pattern/core/mock-api/resources/product.resource.d.ts +13 -0
  233. package/modules/pattern/core/mock-api/resources/settings.resource.d.ts +18 -0
  234. package/modules/pattern/core/pattern-shell/catalog/pattern-catalog.d.ts +24 -0
  235. package/modules/pattern/core/pattern-shell/index/index.component.d.ts +9 -0
  236. package/modules/pattern/core/pattern-shell/settings/pattern-settings.store.d.ts +57 -0
  237. package/modules/pattern/core/pattern-shell/settings/settings-button.component.d.ts +44 -0
  238. package/modules/pattern/core/pattern-shell/shell/pattern-source-viewer.d.ts +8 -0
  239. package/modules/pattern/core/pattern-shell/shell/shell.component.d.ts +13 -0
  240. package/modules/pattern/core/pattern-shell/source/pattern-source.generated.d.ts +1 -0
  241. package/modules/pattern/core/pattern-shell/source/source-drawer.component.d.ts +27 -0
  242. package/modules/pattern/core/pattern-shell/toolbar/toolbar.component.d.ts +24 -0
  243. package/modules/pattern/core/permission/pattern-permission.d.ts +15 -0
  244. package/modules/pattern/core/permission/pattern-role.store.d.ts +13 -0
  245. package/modules/pattern/core/session-state.d.ts +4 -0
  246. package/modules/pattern/docs/detail.md +237 -0
  247. package/modules/pattern/docs/drawer.md +484 -0
  248. package/modules/pattern/docs/flow.md +631 -0
  249. package/modules/pattern/docs/form.md +815 -0
  250. package/modules/pattern/docs/header-actions.md +344 -0
  251. package/modules/pattern/docs/list.md +247 -0
  252. package/modules/pattern/docs/relation.md +180 -0
  253. package/modules/pattern/docs/select.md +214 -0
  254. package/modules/pattern/docs/split.md +350 -0
  255. package/modules/pattern/docs/states.md +168 -0
  256. package/modules/pattern/features/approval/entity.resolver.d.ts +4 -0
  257. package/modules/pattern/features/approval/entity.resolver.ts +21 -0
  258. package/modules/pattern/features/approval/pages/detail/detail.component.d.ts +13 -0
  259. package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
  260. package/modules/pattern/features/approval/pages/list/approval-inbox.d.ts +7 -0
  261. package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
  262. package/modules/pattern/features/approval/pages/list/list.component.d.ts +26 -0
  263. package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
  264. package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
  265. package/modules/pattern/features/approval/routes.d.ts +3 -0
  266. package/modules/pattern/features/approval/routes.ts +30 -0
  267. package/modules/pattern/features/approval/services/approval.model.d.ts +37 -0
  268. package/modules/pattern/features/approval/services/approval.model.ts +38 -0
  269. package/modules/pattern/features/approval/services/approval.service.d.ts +12 -0
  270. package/modules/pattern/features/approval/services/approval.service.ts +23 -0
  271. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.d.ts +23 -0
  272. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +130 -0
  273. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.d.ts +20 -0
  274. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
  275. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.d.ts +23 -0
  276. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
  277. package/modules/pattern/features/category/entity.resolver.d.ts +6 -0
  278. package/modules/pattern/features/category/entity.resolver.ts +27 -0
  279. package/modules/pattern/features/category/pages/list/list.component.d.ts +17 -0
  280. package/modules/pattern/features/category/pages/list/list.component.html +20 -0
  281. package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
  282. package/modules/pattern/features/category/routes.d.ts +3 -0
  283. package/modules/pattern/features/category/routes.ts +42 -0
  284. package/modules/pattern/features/category/services/category.model.d.ts +34 -0
  285. package/modules/pattern/features/category/services/category.model.ts +39 -0
  286. package/modules/pattern/features/category/services/category.service.d.ts +17 -0
  287. package/modules/pattern/features/category/services/category.service.ts +36 -0
  288. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.d.ts +24 -0
  289. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +138 -0
  290. package/modules/pattern/features/customer/components/customer-select/customer-select.component.d.ts +20 -0
  291. package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
  292. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.d.ts +20 -0
  293. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
  294. package/modules/pattern/features/customer/components/debts-view/debts-view.component.d.ts +11 -0
  295. package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
  296. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.d.ts +20 -0
  297. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
  298. package/modules/pattern/features/customer/components/documents-view/documents-view.component.d.ts +14 -0
  299. package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
  300. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.d.ts +33 -0
  301. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
  302. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.d.ts +9 -0
  303. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
  304. package/modules/pattern/features/customer/components/orders-view/orders-view.component.d.ts +11 -0
  305. package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
  306. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.d.ts +22 -0
  307. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
  308. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.d.ts +24 -0
  309. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
  310. package/modules/pattern/features/customer/entity.resolver.d.ts +4 -0
  311. package/modules/pattern/features/customer/entity.resolver.ts +21 -0
  312. package/modules/pattern/features/customer/pages/list/list.component.d.ts +19 -0
  313. package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
  314. package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
  315. package/modules/pattern/features/customer/pages/profile/profile.component.d.ts +31 -0
  316. package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
  317. package/modules/pattern/features/customer/pipes/customer-detail.pipe.d.ts +14 -0
  318. package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
  319. package/modules/pattern/features/customer/routes.d.ts +6 -0
  320. package/modules/pattern/features/customer/routes.ts +59 -0
  321. package/modules/pattern/features/customer/services/customer.model.d.ts +77 -0
  322. package/modules/pattern/features/customer/services/customer.model.ts +87 -0
  323. package/modules/pattern/features/customer/services/customer.service.d.ts +24 -0
  324. package/modules/pattern/features/customer/services/customer.service.ts +79 -0
  325. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.d.ts +21 -0
  326. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
  327. package/modules/pattern/features/import/components/preview-view/preview-view.component.d.ts +10 -0
  328. package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
  329. package/modules/pattern/features/import/pages/flow/flow.component.d.ts +43 -0
  330. package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
  331. package/modules/pattern/features/import/routes.d.ts +2 -0
  332. package/modules/pattern/features/import/routes.ts +19 -0
  333. package/modules/pattern/features/import/services/import.model.d.ts +38 -0
  334. package/modules/pattern/features/import/services/import.model.ts +82 -0
  335. package/modules/pattern/features/import/services/import.service.d.ts +15 -0
  336. package/modules/pattern/features/import/services/import.service.ts +18 -0
  337. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.d.ts +9 -0
  338. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
  339. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.d.ts +22 -0
  340. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
  341. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.d.ts +30 -0
  342. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
  343. package/modules/pattern/features/order/components/lines-form/lines-form.component.d.ts +19 -0
  344. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +182 -0
  345. package/modules/pattern/features/order/components/lines-form/order-lines.d.ts +35 -0
  346. package/modules/pattern/features/order/components/lines-form/order-lines.ts +101 -0
  347. package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.d.ts +34 -0
  348. package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.ts +196 -0
  349. package/modules/pattern/features/order/components/lines-view/lines-view.component.d.ts +12 -0
  350. package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
  351. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.d.ts +25 -0
  352. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
  353. package/modules/pattern/features/order/entity.resolver.d.ts +9 -0
  354. package/modules/pattern/features/order/entity.resolver.ts +37 -0
  355. package/modules/pattern/features/order/pages/create/create.component.d.ts +18 -0
  356. package/modules/pattern/features/order/pages/create/create.component.ts +113 -0
  357. package/modules/pattern/features/order/pages/detail/detail.component.d.ts +27 -0
  358. package/modules/pattern/features/order/pages/detail/detail.component.ts +224 -0
  359. package/modules/pattern/features/order/pages/list/list.component.d.ts +29 -0
  360. package/modules/pattern/features/order/pages/list/list.component.html +38 -0
  361. package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
  362. package/modules/pattern/features/order/pages/update/update.component.d.ts +22 -0
  363. package/modules/pattern/features/order/pages/update/update.component.ts +126 -0
  364. package/modules/pattern/features/order/routes.d.ts +7 -0
  365. package/modules/pattern/features/order/routes.ts +54 -0
  366. package/modules/pattern/features/order/services/order.model.d.ts +106 -0
  367. package/modules/pattern/features/order/services/order.model.ts +109 -0
  368. package/modules/pattern/features/order/services/order.service.d.ts +25 -0
  369. package/modules/pattern/features/order/services/order.service.ts +63 -0
  370. package/modules/pattern/features/partner/pages/create/create.component.d.ts +41 -0
  371. package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
  372. package/modules/pattern/features/partner/routes.d.ts +2 -0
  373. package/modules/pattern/features/partner/routes.ts +20 -0
  374. package/modules/pattern/features/partner/services/partner.model.d.ts +30 -0
  375. package/modules/pattern/features/partner/services/partner.model.ts +30 -0
  376. package/modules/pattern/features/partner/services/partner.service.d.ts +13 -0
  377. package/modules/pattern/features/partner/services/partner.service.ts +17 -0
  378. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.d.ts +23 -0
  379. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
  380. package/modules/pattern/features/product/components/product-select/product-select.component.d.ts +26 -0
  381. package/modules/pattern/features/product/components/product-select/product-select.component.ts +73 -0
  382. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.d.ts +22 -0
  383. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
  384. package/modules/pattern/features/product/entity.resolver.d.ts +4 -0
  385. package/modules/pattern/features/product/entity.resolver.ts +21 -0
  386. package/modules/pattern/features/product/pages/create/create.component.d.ts +15 -0
  387. package/modules/pattern/features/product/pages/create/create.component.ts +92 -0
  388. package/modules/pattern/features/product/pages/detail/detail.component.d.ts +10 -0
  389. package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
  390. package/modules/pattern/features/product/pages/list/list.component.d.ts +15 -0
  391. package/modules/pattern/features/product/pages/list/list.component.html +30 -0
  392. package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
  393. package/modules/pattern/features/product/pages/update/update.component.d.ts +16 -0
  394. package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
  395. package/modules/pattern/features/product/pipes/product-detail.pipe.d.ts +14 -0
  396. package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
  397. package/modules/pattern/features/product/routes.d.ts +3 -0
  398. package/modules/pattern/features/product/routes.ts +48 -0
  399. package/modules/pattern/features/product/services/product.model.d.ts +34 -0
  400. package/modules/pattern/features/product/services/product.model.ts +38 -0
  401. package/modules/pattern/features/product/services/product.service.d.ts +17 -0
  402. package/modules/pattern/features/product/services/product.service.ts +48 -0
  403. package/modules/pattern/features/settings/pages/update/update.component.d.ts +26 -0
  404. package/modules/pattern/features/settings/pages/update/update.component.ts +228 -0
  405. package/modules/pattern/features/settings/routes.d.ts +3 -0
  406. package/modules/pattern/features/settings/routes.ts +24 -0
  407. package/modules/pattern/features/settings/services/settings.model.d.ts +17 -0
  408. package/modules/pattern/features/settings/services/settings.model.ts +18 -0
  409. package/modules/pattern/features/settings/services/settings.service.d.ts +10 -0
  410. package/modules/pattern/features/settings/services/settings.service.ts +15 -0
  411. package/modules/pattern/features/settings/settings.resolver.d.ts +4 -0
  412. package/modules/pattern/features/settings/settings.resolver.ts +8 -0
  413. package/modules/pattern/index.d.ts +3 -0
  414. package/modules/pattern/routes.d.ts +6 -0
  415. package/modules/pattern/services/base-api.service.d.ts +16 -0
  416. package/modules/pattern/utils/api-error.d.ts +4 -0
  417. package/modules/pattern/utils/focus-first-invalid.d.ts +5 -0
  418. package/modules/pattern/utils/form-api-errors.d.ts +16 -0
  419. package/modules/pattern/utils/resource-url.d.ts +2 -0
  420. package/package.json +13 -9
  421. package/services/api/src/api-handler-registry.d.ts +3 -3
  422. package/services/api/src/api-route-configurations.d.ts +2 -2
  423. package/services/api/src/api.model.d.ts +2 -2
  424. package/services/cache/src/cache.model.d.ts +3 -1
  425. package/services/storage/src/storage.model.d.ts +2 -0
  426. package/services/unsaved-changes/src/unsaved-changes.adapters.d.ts +9 -0
  427. package/services/unsaved-changes/src/unsaved-changes.model.d.ts +2 -0
  428. package/forms/chip/src/pipes/index.d.ts +0 -1
  429. package/forms/chip/src/pipes/removable-chip.pipe.d.ts +0 -8
@@ -0,0 +1,484 @@
1
+ # Drawer
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`.
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
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)).
9
+
10
+ ## Code mẫu
11
+
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
+
14
+ <!-- @source features/customer/components/detail-side-drawer/detail-side-drawer.component.ts -->
15
+ ```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';
20
+ import { SdBadge } from '@sdcorejs/angular/components/badge';
21
+ import { SdButton } from '@sdcorejs/angular/components/button';
22
+ import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
23
+ import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
24
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
25
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
26
+ import { apiErrorMessage } from '../../../../utils/api-error';
27
+ import { CustomerService } from '../../services/customer.service';
28
+ import { customerStatusBadge, customerTypeName, type CustomerDto } from '../../services/customer.model';
29
+ import { GeneralInformationViewComponent } from '../general-information-view/general-information-view.component';
30
+
31
+ /**
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.
35
+ */
36
+ @Component({
37
+ selector: 'detail-side-drawer',
38
+ standalone: true,
39
+ imports: [RouterLink, SdSideDrawer, SdBadge, SdButton, SdPermissionDirective, GeneralInformationViewComponent],
40
+ changeDetection: ChangeDetectionStrategy.OnPush,
41
+ template: `
42
+ @let customer = entity();
43
+ <sd-side-drawer width="600px" autoId="customer-detail" (sdClosed)="closed()">
44
+ <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>
50
+ </div>
51
+ <sd-button
52
+ sdHeaderRight
53
+ *sdPermission="'PATTERN_CUSTOMER_D_DELETE'"
54
+ prefixIcon="delete"
55
+ tooltip="Xoá khách hàng"
56
+ type="text"
57
+ color="error"
58
+ autoId="customer-delete"
59
+ [loading]="deleting()"
60
+ (click)="delete()" />
61
+ <general-information-view [customer]="customer" />
62
+ <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']" />
64
+ <sd-button
65
+ *sdPermission="'PATTERN_CUSTOMER_U_UPDATE'"
66
+ title="Cập nhật khách hàng"
67
+ prefixIcon="edit"
68
+ type="fill"
69
+ color="primary"
70
+ autoId="customer-update"
71
+ [routerLink]="['../update']" />
72
+ </div>
73
+ </sd-side-drawer>
74
+ `,
75
+ })
76
+ export class DetailSideDrawerComponent {
77
+ readonly #customerService = inject(CustomerService);
78
+ readonly #confirm = inject(SdConfirmService);
79
+ readonly #notify = inject(SdNotifyService);
80
+ readonly #router = inject(Router);
81
+ readonly #route = inject(ActivatedRoute);
82
+ 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));
86
+ protected readonly deleting = signal(false);
87
+
88
+ constructor() {
89
+ afterNextRender(() => this.drawer().open());
90
+ }
91
+
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 });
96
+ }
97
+
98
+ protected async delete(): Promise<void> {
99
+ const customer = this.entity();
100
+ try {
101
+ await this.#confirm.confirm(`Xoá khách hàng ${customer.name}? Thao tác không hoàn tác được.`, {
102
+ title: 'Xoá khách hàng',
103
+ yesTitle: 'Xoá',
104
+ noTitle: 'Không xoá',
105
+ yesButtonColor: 'error',
106
+ });
107
+ } catch {
108
+ return;
109
+ }
110
+ this.deleting.set(true);
111
+ try {
112
+ await firstValueFrom(this.#customerService.delete(customer.id));
113
+ this.#notify.success(`Đã xoá khách hàng ${customer.name}.`);
114
+ this.drawer().close();
115
+ } catch (error) {
116
+ this.#notify.error(apiErrorMessage(error, 'Không xoá được khách hàng.'));
117
+ } finally {
118
+ this.deleting.set(false);
119
+ }
120
+ }
121
+ }
122
+ ```
123
+
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:
125
+
126
+ <!-- @source features/customer/components/update-side-drawer/update-side-drawer.component.ts -->
127
+ ```ts
128
+ import {
129
+ afterNextRender,
130
+ ChangeDetectionStrategy,
131
+ Component,
132
+ DestroyRef,
133
+ ElementRef,
134
+ inject,
135
+ Injector,
136
+ signal,
137
+ viewChild,
138
+ } from '@angular/core';
139
+ import { toSignal } from '@angular/core/rxjs-interop';
140
+ import { FormGroup } from '@angular/forms';
141
+ import { ActivatedRoute, Router } from '@angular/router';
142
+ import { firstValueFrom, map } from 'rxjs';
143
+ import { SdButton } from '@sdcorejs/angular/components/button';
144
+ import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
145
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
146
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
147
+ import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
148
+ import { apiErrorMessage } from '../../../../utils/api-error';
149
+ import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
150
+ import { formApiErrors } from '../../../../utils/form-api-errors';
151
+ import { CustomerService } from '../../services/customer.service';
152
+ import type { CustomerDto } from '../../services/customer.model';
153
+ import {
154
+ customerSaveReq,
155
+ GeneralInformationFormComponent,
156
+ invalidCustomerGroups,
157
+ type CustomerForm,
158
+ type CustomerFormGroup,
159
+ } from '../general-information-form/general-information-form.component';
160
+
161
+ /**
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ở.
164
+ */
165
+ @Component({
166
+ selector: 'update-side-drawer',
167
+ standalone: true,
168
+ imports: [SdSideDrawer, SdButton, GeneralInformationFormComponent],
169
+ changeDetection: ChangeDetectionStrategy.OnPush,
170
+ template: `
171
+ <sd-side-drawer
172
+ [title]="'Cập nhật khách hàng #' + entity().code"
173
+ width="600px"
174
+ autoId="customer-update"
175
+ [beforeClose]="beforeClose"
176
+ (sdClosed)="closed()">
177
+ <general-information-form [form]="form" [seed]="entity()" [errors]="apiErrors.errors()" [invalidGroups]="invalidGroups()" />
178
+ <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()" />
180
+ </div>
181
+ </sd-side-drawer>
182
+ `,
183
+ })
184
+ export class UpdateSideDrawerComponent {
185
+ readonly #customerService = inject(CustomerService);
186
+ readonly #confirm = inject(SdConfirmService);
187
+ readonly #notify = inject(SdNotifyService);
188
+ readonly #router = inject(Router);
189
+ readonly #route = inject(ActivatedRoute);
190
+ readonly #injector = inject(Injector);
191
+ private readonly drawer = viewChild.required(SdSideDrawer);
192
+ // 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
+ 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 });
195
+ protected readonly form: CustomerForm = new FormGroup({});
196
+ protected readonly saving = signal(false);
197
+ protected readonly apiErrors = formApiErrors(this.form);
198
+ protected readonly invalidGroups = signal<CustomerFormGroup[]>([]);
199
+ readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'customer-update', dirty: 'value' });
200
+
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). */
202
+ protected readonly beforeClose = async (): Promise<boolean> => {
203
+ if (!this.#unsaved.dirty() || this.saving()) return !this.saving();
204
+ try {
205
+ await this.#confirm.confirm('Thay đổi chưa lưu sẽ bị mất.', {
206
+ title: 'Đóng khi chưa lưu?',
207
+ yesTitle: 'Bỏ thay đổi',
208
+ noTitle: 'Tiếp tục sửa',
209
+ yesButtonColor: 'warning',
210
+ });
211
+ } catch {
212
+ return false;
213
+ }
214
+ this.#unsaved.markPristine();
215
+ return true;
216
+ };
217
+
218
+ constructor() {
219
+ afterNextRender(() => this.drawer().open());
220
+ inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
221
+ }
222
+
223
+ protected closed(): void {
224
+ void this.#router.navigate(['../..'], { relativeTo: this.#route });
225
+ }
226
+
227
+ protected async save(): Promise<void> {
228
+ if (this.saving()) return;
229
+ this.form.markAllAsTouched();
230
+ if (this.form.invalid) {
231
+ this.#showErrors();
232
+ return;
233
+ }
234
+ this.saving.set(true);
235
+ try {
236
+ await firstValueFrom(this.#customerService.update(this.entity().id, customerSaveReq(this.form)));
237
+ this.#unsaved.markPristine();
238
+ this.#notify.success('Đã cập nhật khách hàng.');
239
+ this.saving.set(false);
240
+ this.drawer().close();
241
+ } catch (error) {
242
+ if (this.apiErrors.set(error)) this.#showErrors();
243
+ else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
244
+ } finally {
245
+ this.saving.set(false);
246
+ }
247
+ }
248
+
249
+ /** `sd-inform` trong từng nhóm có lỗi, rồi focus field lỗi đầu tiên. */
250
+ #showErrors(): void {
251
+ this.invalidGroups.set(invalidCustomerGroups(this.form, this.apiErrors.errors()));
252
+ afterNextRender(() => focusFirstInvalid(this.formElement().nativeElement), { injector: this.#injector });
253
+ }
254
+ }
255
+ ```
256
+
257
+ Form ba nhóm, nhóm còn lỗi có `sd-inform` cảnh báo ngay trong nhóm:
258
+
259
+ <!-- @source features/customer/components/general-information-form/general-information-form.component.ts -->
260
+ ```ts
261
+ import { ChangeDetectionStrategy, Component, input, linkedSignal } from '@angular/core';
262
+ import type { FormControl, FormGroup } from '@angular/forms';
263
+ import { SdInform } from '@sdcorejs/angular/components/inform';
264
+ import { SdSection } from '@sdcorejs/angular/components/section';
265
+ import { SdInput } from '@sdcorejs/angular/forms/input';
266
+ import { SdSwitch } from '@sdcorejs/angular/forms/switch';
267
+ import { SdTextarea } from '@sdcorejs/angular/forms/textarea';
268
+ import type { CustomerSaveReq, CustomerStatus, CustomerTier, CustomerType } from '../../services/customer.model';
269
+ import { CustomerTypeSelectComponent } from '../customer-type-select/customer-type-select.component';
270
+
271
+ /** Các field Core tự đăng ký control qua `[form]` + `name`. */
272
+ export type CustomerForm = FormGroup<{
273
+ name?: FormControl<string>;
274
+ type?: FormControl<CustomerType>;
275
+ taxCode?: FormControl<string | null>;
276
+ vip?: FormControl<boolean>;
277
+ email?: FormControl<string>;
278
+ phone?: FormControl<string>;
279
+ address?: FormControl<string>;
280
+ active?: FormControl<boolean>;
281
+ note?: FormControl<string | null>;
282
+ }>;
283
+
284
+ /** Ba nhóm của form; nhóm còn lỗi sau khi bấm Lưu hiện `sd-inform` cảnh báo ngay trong nhóm. */
285
+ export type CustomerFormGroup = 'general' | 'contact' | 'other';
286
+
287
+ const GROUP_FIELDS: Readonly<Record<CustomerFormGroup, readonly string[]>> = {
288
+ general: ['name', 'type', 'taxCode', 'vip'],
289
+ contact: ['email', 'phone', 'address'],
290
+ other: ['active', 'note'],
291
+ };
292
+
293
+ /** Nhóm có field không hợp lệ: field còn lỗi validate hoặc lỗi do API trả về. */
294
+ export function invalidCustomerGroups(form: CustomerForm, apiErrors: Readonly<Record<string, string>>): CustomerFormGroup[] {
295
+ return (Object.keys(GROUP_FIELDS) as CustomerFormGroup[]).filter(group =>
296
+ GROUP_FIELDS[group].some(field => form.get(field)?.invalid || !!apiErrors[field])
297
+ );
298
+ }
299
+
300
+ /** Giá trị form → request lưu. */
301
+ export function customerSaveReq(form: CustomerForm): CustomerSaveReq {
302
+ const value = form.getRawValue();
303
+ const type: CustomerType = value.type ?? 'individual';
304
+ const tier: CustomerTier = value.vip ? 'vip' : 'standard';
305
+ const status: CustomerStatus = value.active === false ? 'inactive' : 'active';
306
+ return {
307
+ name: value.name ?? '',
308
+ type,
309
+ tier,
310
+ email: value.email ?? '',
311
+ phone: value.phone ?? '',
312
+ address: value.address ?? '',
313
+ taxCode: type === 'business' ? (value.taxCode ?? null) : null,
314
+ status,
315
+ note: value.note || null,
316
+ };
317
+ }
318
+
319
+ /** Form khách hàng ba nhóm, dùng chung cho drawer tạo mới và cập nhật. */
320
+ @Component({
321
+ selector: 'general-information-form',
322
+ standalone: true,
323
+ imports: [SdSection, SdInput, SdTextarea, SdSwitch, SdInform, CustomerTypeSelectComponent],
324
+ changeDetection: ChangeDetectionStrategy.OnPush,
325
+ template: `
326
+ @let invalid = invalidGroups();
327
+ <div class="d-flex flex-column gap-16">
328
+ <sd-section title="Thông tin chung">
329
+ <div class="d-flex flex-column gap-8 p-16">
330
+ @if (invalid.includes('general')) {
331
+ <sd-inform warning description="Kiểm tra tên và loại khách hàng." autoId="customer-general-warning" />
332
+ }
333
+ <sd-input
334
+ label="Tên khách hàng"
335
+ name="name"
336
+ autoId="customer-name"
337
+ [form]="form()"
338
+ [model]="seed().name"
339
+ [inlineError]="errors()['name']"
340
+ maxlength="120"
341
+ required />
342
+ <customer-type-select [form]="form()" [model]="seed().type" (modelChange)="type.set($event ?? 'individual')" />
343
+ @if (type() === 'business') {
344
+ <sd-input
345
+ label="Mã số thuế"
346
+ name="taxCode"
347
+ autoId="customer-tax-code"
348
+ [form]="form()"
349
+ [model]="seed().taxCode"
350
+ [inlineError]="errors()['taxCode']"
351
+ maxlength="14"
352
+ required />
353
+ }
354
+ <sd-switch label="Khách VIP" name="vip" [form]="form()" [model]="seed().tier === 'vip'" />
355
+ </div>
356
+ </sd-section>
357
+ <sd-section title="Liên hệ">
358
+ <div class="d-flex flex-column gap-8 p-16">
359
+ @if (invalid.includes('contact')) {
360
+ <sd-inform warning description="Kiểm tra email và số điện thoại." autoId="customer-contact-warning" />
361
+ }
362
+ <sd-input
363
+ label="Email"
364
+ name="email"
365
+ autoId="customer-email"
366
+ [form]="form()"
367
+ [model]="seed().email"
368
+ [inlineError]="errors()['email']"
369
+ pattern="EMAIL"
370
+ required />
371
+ <sd-input
372
+ label="Điện thoại"
373
+ name="phone"
374
+ autoId="customer-phone"
375
+ [form]="form()"
376
+ [model]="seed().phone"
377
+ [inlineError]="errors()['phone']"
378
+ maxlength="15"
379
+ required />
380
+ <sd-input label="Địa chỉ" name="address" autoId="customer-address" [form]="form()" [model]="seed().address" maxlength="200" />
381
+ </div>
382
+ </sd-section>
383
+ <sd-section title="Khác">
384
+ <div class="d-flex flex-column gap-8 p-16">
385
+ <sd-switch label="Đang hoạt động" name="active" [form]="form()" [model]="seed().status !== 'inactive'" />
386
+ <sd-textarea label="Ghi chú" name="note" [form]="form()" [model]="seed().note" maxlength="500" />
387
+ </div>
388
+ </sd-section>
389
+ </div>
390
+ `,
391
+ })
392
+ export class GeneralInformationFormComponent {
393
+ readonly form = input.required<CustomerForm>();
394
+ readonly seed = input.required<CustomerSaveReq>();
395
+ /** Lỗi theo field do API trả về. */
396
+ readonly errors = input<Readonly<Record<string, string>>>({});
397
+ readonly invalidGroups = input<readonly CustomerFormGroup[]>([]);
398
+ /** Loại khách đang chọn: doanh nghiệp mới có mã số thuế. */
399
+ protected readonly type = linkedSignal(() => this.seed().type);
400
+ }
401
+ ```
402
+
403
+ Route con của danh sách; `data.detail: 'page'` cho route mở thành trang thay chỗ danh sách:
404
+
405
+ <!-- @source features/customer/routes.ts -->
406
+ ```ts
407
+ import type { Routes } from '@angular/router';
408
+ import { sdPageFormLeaveGuard } from '@sdcorejs/angular/modules/layout';
409
+ import { SdPermissionGuard } from '@sdcorejs/angular/modules/permission';
410
+ import { entityResolver } from './entity.resolver';
411
+ import { CustomerService } from './services/customer.service';
412
+
413
+ /**
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.
416
+ */
417
+ export const routes: Routes = [
418
+ {
419
+ path: '',
420
+ providers: [CustomerService],
421
+ canActivateChild: [SdPermissionGuard],
422
+ children: [
423
+ {
424
+ path: '',
425
+ title: 'Khách hàng',
426
+ data: { permission: 'PATTERN_CUSTOMER_R_LIST' },
427
+ loadComponent: () => import('./pages/list/list.component').then(module => module.ListComponent),
428
+ 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
+ {
454
+ path: ':id/360',
455
+ title: 'Hồ sơ khách hàng',
456
+ data: { permission: 'PATTERN_CUSTOMER_R_DETAIL', detail: 'page' },
457
+ resolve: { entity: entityResolver },
458
+ runGuardsAndResolvers: 'paramsChange',
459
+ loadComponent: () => import('./pages/profile/profile.component').then(module => module.ProfileComponent),
460
+ },
461
+ ],
462
+ },
463
+ ],
464
+ },
465
+ ];
466
+ ```
467
+
468
+ ## Quy tắc
469
+
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.
471
+ - 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.
473
+ - 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
+ - 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).
477
+ - 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
+ - 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
+
480
+ ## Lỗi hay gặp
481
+
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.
483
+ - 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
+ - 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.