@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,631 @@
1
+ # Flow
2
+
3
+ Quy trình nhiều bước: `sd-page width="narrow"` + `sd-stepper` trong thân + nút bước ở `sdFooterLeft` / `sdFooterRight`. Route mẫu: `/pattern/import` (bốn bước ngang: nguồn, ánh xạ, xem trước & xung đột, xác nhận), `/pattern/partner/create` (bước dọc, rẽ nhánh theo loại, kiểm tra trùng mã, lưu nháp).
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng khi bước sau phụ thuộc kết quả bước trước (ánh xạ cột rồi mới xem trước), hoặc khi dữ liệu nhiều đến mức chia bước giúp người dùng.
8
+ - Các nhóm độc lập, nhập theo thứ tự nào cũng được: dùng [form](form.md) với mục lục.
9
+
10
+ ## Code mẫu
11
+
12
+ Bước ngang, mỗi bước có cổng (`stepControl`) chỉ mở khi bước đã qua kiểm tra; bước cuối mới ghi dữ liệu:
13
+
14
+ <!-- @source features/import/pages/flow/flow.component.ts -->
15
+ ```ts
16
+ import { ChangeDetectionStrategy, Component, computed, inject, signal } from '@angular/core';
17
+ import { FormControl, FormGroup, Validators } from '@angular/forms';
18
+ import { RouterLink } from '@angular/router';
19
+ import { firstValueFrom } from 'rxjs';
20
+ import { SdButton } from '@sdcorejs/angular/components/button';
21
+ import { SdInform } from '@sdcorejs/angular/components/inform';
22
+ import { SdSection, SdSectionItem } from '@sdcorejs/angular/components/section';
23
+ import { SdStep, SdStepper } from '@sdcorejs/angular/components/stepper';
24
+ import { SdSegmentedComponent, type SdSegmentedItem, type SdSegmentedModel } from '@sdcorejs/angular/forms/segmented';
25
+ import { SdTextarea } from '@sdcorejs/angular/forms/textarea';
26
+ import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
27
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
28
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
29
+ import { apiErrorMessage } from '../../../../utils/api-error';
30
+ import { MappingFormComponent } from '../../components/mapping-form/mapping-form.component';
31
+ import { PreviewViewComponent } from '../../components/preview-view/preview-view.component';
32
+ import { ImportService } from '../../services/import.service';
33
+ import {
34
+ guessMapping,
35
+ IMPORT_FIELDS,
36
+ IMPORT_SAMPLE,
37
+ parseCsv,
38
+ type ImportCommitRes,
39
+ type ImportDuplicatePolicy,
40
+ type ImportMapping,
41
+ type ImportPreviewRowDto,
42
+ } from '../../services/import.model';
43
+
44
+ const DUPLICATES: readonly SdSegmentedItem<ImportDuplicatePolicy>[] = [
45
+ { value: 'skip', label: 'Bỏ qua dòng trùng' },
46
+ { value: 'overwrite', label: 'Ghi đè sản phẩm đã có' },
47
+ ];
48
+
49
+ /**
50
+ * Pattern flow ngang: `sd-page` hẹp + `sd-stepper`, nút bước ở footer. Bốn bước giữ dữ liệu khi quay lại; mỗi bước
51
+ * kiểm tra điều kiện của chính nó trước khi sang bước sau, bước cuối mới ghi dữ liệu.
52
+ */
53
+ @Component({
54
+ selector: 'flow',
55
+ standalone: true,
56
+ imports: [
57
+ RouterLink,
58
+ SdPageComponent,
59
+ SdStepper,
60
+ SdStep,
61
+ SdButton,
62
+ SdInform,
63
+ SdSection,
64
+ SdSectionItem,
65
+ SdSegmentedComponent,
66
+ SdTextarea,
67
+ MappingFormComponent,
68
+ PreviewViewComponent,
69
+ ],
70
+ changeDetection: ChangeDetectionStrategy.OnPush,
71
+ template: `
72
+ <sd-page title="Nhập dữ liệu sản phẩm" description="Nhập danh mục sản phẩm từ tệp CSV." [backLink]="['..']" width="narrow">
73
+ <sd-stepper linear [(selectedIndex)]="step" animationDuration="0ms" autoId="import-steps">
74
+ <sd-step label="Nguồn dữ liệu" [stepControl]="gates[0]">
75
+ <div class="d-flex flex-column gap-8 py-16">
76
+ <sd-inform type="tip" description="Dán nội dung CSV có dòng tiêu đề, hoặc dùng dữ liệu mẫu." />
77
+ <sd-textarea
78
+ label="Nội dung CSV"
79
+ name="source"
80
+ autoId="import-source"
81
+ [form]="sourceForm"
82
+ [model]="source()"
83
+ (modelChange)="editSource($event ?? '')"
84
+ [inlineError]="showErrors() && !rows().length ? 'Cần ít nhất một dòng dữ liệu dưới dòng tiêu đề.' : undefined"
85
+ [maxlength]="20000"
86
+ required />
87
+ <div>
88
+ <sd-button title="Dùng dữ liệu mẫu" type="text" prefixIcon="description" autoId="import-sample" (click)="useSample()" />
89
+ </div>
90
+ </div>
91
+ </sd-step>
92
+ <sd-step label="Nhận diện & ánh xạ" [stepControl]="gates[1]">
93
+ <div class="py-16">
94
+ <p class="T14R text-secondary mt-0">Đọc được {{ rows().length }} dòng, {{ columns().length }} cột.</p>
95
+ <mapping-form
96
+ [sourceColumns]="columns()"
97
+ [mapping]="mapping()"
98
+ [showErrors]="showErrors()"
99
+ (mappingChange)="mapping.set($event)" />
100
+ </div>
101
+ </sd-step>
102
+ <sd-step label="Xem trước & xung đột" [stepControl]="gates[2]">
103
+ <div class="d-flex flex-column gap-12 py-16">
104
+ @if (preview(); as rows) {
105
+ <p class="T14R m-0">
106
+ {{ counts().new }} dòng mới · {{ counts().duplicate }} dòng trùng mã · {{ counts().invalid }} dòng lỗi (bỏ qua)
107
+ </p>
108
+ <preview-view [rows]="rows" />
109
+ @if (counts().duplicate) {
110
+ <sd-segmented
111
+ ariaLabel="Xử lý dòng trùng"
112
+ autoId="import-duplicates"
113
+ [items]="duplicateItems"
114
+ [model]="duplicates()"
115
+ (sdChange)="setDuplicates($event)" />
116
+ }
117
+ } @else {
118
+ <p class="T14R text-secondary">Đang kiểm tra dữ liệu…</p>
119
+ }
120
+ </div>
121
+ </sd-step>
122
+ <sd-step label="Xác nhận">
123
+ <div class="py-16">
124
+ @if (result(); as done) {
125
+ <sd-inform
126
+ success
127
+ title="Đã nhập dữ liệu"
128
+ [description]="done.created + ' sản phẩm mới, ' + done.updated + ' cập nhật, ' + done.skipped + ' bỏ qua.'" />
129
+ <a class="d-inline-block mt-12" [routerLink]="['../product']">Xem danh sách sản phẩm</a>
130
+ } @else {
131
+ <sd-section title="Tóm tắt">
132
+ <sd-section-item label="Thêm mới">{{ counts().new }}</sd-section-item>
133
+ <sd-section-item label="Trùng mã"
134
+ >{{ counts().duplicate }} ({{ duplicates() === 'overwrite' ? 'ghi đè' : 'bỏ qua' }})</sd-section-item
135
+ >
136
+ <sd-section-item label="Lỗi, bỏ qua">{{ counts().invalid }}</sd-section-item>
137
+ </sd-section>
138
+ }
139
+ </div>
140
+ </sd-step>
141
+ </sd-stepper>
142
+ <sd-button
143
+ sdFooterLeft
144
+ title="Quay lại"
145
+ type="outline"
146
+ autoId="import-previous"
147
+ [disabled]="step() === 0 || !!result()"
148
+ (click)="step.set(step() - 1)" />
149
+ @if (step() < 3) {
150
+ <sd-button
151
+ sdFooterRight
152
+ title="Tiếp tục"
153
+ type="fill"
154
+ color="primary"
155
+ autoId="import-next"
156
+ [loading]="checking()"
157
+ (click)="next()" />
158
+ } @else if (!result()) {
159
+ <sd-button
160
+ sdFooterRight
161
+ title="Nhập dữ liệu"
162
+ type="fill"
163
+ color="primary"
164
+ autoId="import-commit"
165
+ [loading]="committing()"
166
+ (click)="commit()" />
167
+ }
168
+ </sd-page>
169
+ `,
170
+ })
171
+ export class FlowComponent {
172
+ readonly #importService = inject(ImportService);
173
+ readonly #confirm = inject(SdConfirmService);
174
+ readonly #notify = inject(SdNotifyService);
175
+ protected readonly duplicateItems = DUPLICATES;
176
+ protected readonly step = signal(0);
177
+ /**
178
+ * Một cổng cho mỗi bước: chỉ đúng sau khi bước đó qua kiểm tra, nên stepper `linear` không cho bấm tiêu đề để
179
+ * vượt qua bước chưa kiểm tra. Đổi nguồn dữ liệu thì đóng lại các bước sau.
180
+ */
181
+ protected readonly gates = [0, 1, 2].map(() => new FormControl(false, { nonNullable: true, validators: Validators.requiredTrue }));
182
+ protected readonly showErrors = signal(false);
183
+ /** Chỉ để đánh dấu đã chạm ô nguồn khi bấm Tiếp: lỗi của ô hiện ngay cả khi người dùng chưa gõ gì. */
184
+ protected readonly sourceForm = new FormGroup({});
185
+ protected readonly source = signal('');
186
+ readonly #parsed = computed(() => parseCsv(this.source()));
187
+ protected readonly columns = computed(() => this.#parsed().columns);
188
+ protected readonly rows = computed(() => this.#parsed().rows);
189
+ protected readonly mapping = signal<ImportMapping>({ code: null, name: null, unit: null, price: null });
190
+ protected readonly preview = signal<readonly ImportPreviewRowDto[] | null>(null);
191
+ protected readonly duplicates = signal<ImportDuplicatePolicy>('skip');
192
+ protected readonly checking = signal(false);
193
+ protected readonly committing = signal(false);
194
+ protected readonly result = signal<ImportCommitRes | null>(null);
195
+ protected readonly counts = computed(() => {
196
+ const rows = this.preview() ?? [];
197
+ return {
198
+ new: rows.filter(row => row.result === 'new').length,
199
+ duplicate: rows.filter(row => row.result === 'duplicate').length,
200
+ invalid: rows.filter(row => row.result === 'invalid').length,
201
+ };
202
+ });
203
+
204
+ protected useSample(): void {
205
+ this.editSource(IMPORT_SAMPLE);
206
+ }
207
+
208
+ /** Đổi nguồn thì các bước sau phải kiểm tra lại. */
209
+ protected editSource(value: string): void {
210
+ this.source.set(value);
211
+ this.gates.forEach(gate => gate.setValue(false));
212
+ }
213
+
214
+ protected setDuplicates(value: SdSegmentedModel<ImportDuplicatePolicy>): void {
215
+ if (value === 'skip' || value === 'overwrite') this.duplicates.set(value);
216
+ }
217
+
218
+ protected async next(): Promise<void> {
219
+ const step = this.step();
220
+ if (step === 0) {
221
+ if (!this.rows().length) {
222
+ this.sourceForm.markAllAsTouched();
223
+ return this.showErrors.set(true);
224
+ }
225
+ // Nguồn mới: ánh xạ lại theo tên cột, bỏ kết quả kiểm tra cũ.
226
+ this.mapping.set(guessMapping(this.columns()));
227
+ this.preview.set(null);
228
+ this.gates.slice(1).forEach(gate => gate.setValue(false));
229
+ }
230
+ if (step === 1) {
231
+ const missing = IMPORT_FIELDS.some(field => field.required && !this.mapping()[field.field]);
232
+ if (missing) return this.showErrors.set(true);
233
+ if (!(await this.#check())) return;
234
+ }
235
+ this.showErrors.set(false);
236
+ this.gates[step].setValue(true);
237
+ this.step.set(step + 1);
238
+ }
239
+
240
+ protected async commit(): Promise<void> {
241
+ const { new: created, duplicate } = this.counts();
242
+ const overwrite = this.duplicates() === 'overwrite' ? duplicate : 0;
243
+ try {
244
+ await this.#confirm.confirm(`Thêm ${created} sản phẩm${overwrite ? `, ghi đè ${overwrite} sản phẩm` : ''}?`, {
245
+ title: 'Nhập dữ liệu',
246
+ yesTitle: 'Nhập dữ liệu',
247
+ noTitle: 'Không',
248
+ });
249
+ } catch {
250
+ return;
251
+ }
252
+ this.committing.set(true);
253
+ try {
254
+ this.result.set(await firstValueFrom(this.#importService.commit(this.#mappedRows(), this.duplicates())));
255
+ } catch (error) {
256
+ this.#notify.error(apiErrorMessage(error, 'Không nhập được dữ liệu. Thử lại.'));
257
+ } finally {
258
+ this.committing.set(false);
259
+ }
260
+ }
261
+
262
+ async #check(): Promise<boolean> {
263
+ this.checking.set(true);
264
+ try {
265
+ this.preview.set((await firstValueFrom(this.#importService.preview(this.#mappedRows()))).rows);
266
+ return true;
267
+ } catch (error) {
268
+ this.#notify.error(apiErrorMessage(error, 'Không kiểm tra được dữ liệu. Thử lại.'));
269
+ return false;
270
+ } finally {
271
+ this.checking.set(false);
272
+ }
273
+ }
274
+
275
+ #mappedRows() {
276
+ const mapping = this.mapping();
277
+ return this.rows().map(row => ({
278
+ code: mapping.code ? (row[mapping.code] ?? '') : '',
279
+ name: mapping.name ? (row[mapping.name] ?? '') : '',
280
+ unit: mapping.unit ? (row[mapping.unit] ?? '') : '',
281
+ price: mapping.price ? (row[mapping.price] ?? '') : '0',
282
+ }));
283
+ }
284
+ }
285
+ ```
286
+
287
+ Bước dọc, rẽ nhánh theo loại đối tác, kiểm tra trùng mã khi rời bước đầu, lưu nháp mỗi lần thay đổi:
288
+
289
+ <!-- @source features/partner/pages/create/create.component.ts -->
290
+ ```ts
291
+ import { ChangeDetectionStrategy, Component, computed, DestroyRef, inject, signal } from '@angular/core';
292
+ import { FormGroup } from '@angular/forms';
293
+ import { ActivatedRoute, Router } from '@angular/router';
294
+ import { firstValueFrom, merge } from 'rxjs';
295
+ import { SdButton } from '@sdcorejs/angular/components/button';
296
+ import { SdInform } from '@sdcorejs/angular/components/inform';
297
+ import { SdSection, SdSectionItem } from '@sdcorejs/angular/components/section';
298
+ import { SdStep, SdStepper } from '@sdcorejs/angular/components/stepper';
299
+ import { SdInput } from '@sdcorejs/angular/forms/input';
300
+ import { SdSegmentedComponent } from '@sdcorejs/angular/forms/segmented';
301
+ import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
302
+ import { SdFormatDatetimePipe } from '@sdcorejs/angular/pipes';
303
+ import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
304
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
305
+ import { apiErrorMessage, apiFieldErrors } from '../../../../utils/api-error';
306
+ import { PartnerService } from '../../services/partner.service';
307
+ import { PARTNER_TYPE_OPTIONS, type PartnerSaveReq, type PartnerType } from '../../services/partner.model';
308
+
309
+ /** Bản nháp giữ trong tab trình duyệt: tải lại trang vẫn tiếp tục được. */
310
+ interface PartnerDraft extends PartnerSaveReq {
311
+ readonly step: number;
312
+ readonly savedAt: string;
313
+ }
314
+
315
+ const DRAFT_KEY = 'pattern.partner.create.draft';
316
+ const EMPTY: PartnerSaveReq = {
317
+ code: '',
318
+ type: 'individual',
319
+ name: '',
320
+ identity: '',
321
+ representative: null,
322
+ email: '',
323
+ phone: '',
324
+ address: '',
325
+ };
326
+
327
+ function readDraft(): PartnerDraft | null {
328
+ try {
329
+ const raw = sessionStorage.getItem(DRAFT_KEY);
330
+ return raw ? (JSON.parse(raw) as PartnerDraft) : null;
331
+ } catch {
332
+ return null;
333
+ }
334
+ }
335
+
336
+ function writeDraft(draft: PartnerDraft | null): void {
337
+ try {
338
+ if (draft) sessionStorage.setItem(DRAFT_KEY, JSON.stringify(draft));
339
+ else sessionStorage.removeItem(DRAFT_KEY);
340
+ } catch {
341
+ // Không lưu được nháp (chế độ riêng tư, hết dung lượng): flow vẫn chạy, chỉ không khôi phục sau khi tải lại.
342
+ }
343
+ }
344
+
345
+ /**
346
+ * Pattern flow dọc: `sd-page` hẹp + `sd-stepper` dọc, nút bước ở footer. Bước 2 rẽ nhánh theo loại đối tác; rời bước 1
347
+ * thì kiểm tra trùng mã với API; mọi thay đổi được lưu nháp và khôi phục khi tải lại trang.
348
+ */
349
+ @Component({
350
+ selector: 'create',
351
+ standalone: true,
352
+ imports: [
353
+ SdPageComponent,
354
+ SdStepper,
355
+ SdStep,
356
+ SdButton,
357
+ SdInform,
358
+ SdSection,
359
+ SdSectionItem,
360
+ SdInput,
361
+ SdSegmentedComponent,
362
+ SdFormatDatetimePipe,
363
+ ],
364
+ changeDetection: ChangeDetectionStrategy.OnPush,
365
+ template: `
366
+ @let value = seed();
367
+ <sd-page title="Tạo đối tác" description="Đối tác cá nhân hoặc doanh nghiệp." [backLink]="['../..']" width="narrow">
368
+ @if (restored(); as draft) {
369
+ <sd-inform
370
+ info
371
+ class="mt-16"
372
+ autoId="partner-draft"
373
+ [description]="'Đã khôi phục bản nháp lưu lúc ' + (draft.savedAt | sdFormatDatetime) + '.'"
374
+ actionLabel="Bỏ nháp"
375
+ (sdAction)="discard()" />
376
+ }
377
+ <sd-stepper linear orientation="vertical" animationDuration="0ms" autoId="partner-steps" [(selectedIndex)]="step">
378
+ <sd-step label="Loại và mã đối tác" [stepControl]="kind">
379
+ <div class="d-flex flex-column gap-8 py-8">
380
+ <sd-segmented
381
+ name="type"
382
+ ariaLabel="Loại đối tác"
383
+ autoId="partner-type"
384
+ [form]="kind"
385
+ [items]="types"
386
+ [model]="value.type"
387
+ (sdChange)="type.set($any($event) ?? 'individual')" />
388
+ <sd-input
389
+ label="Mã đối tác"
390
+ name="code"
391
+ autoId="partner-code"
392
+ [form]="kind"
393
+ [model]="value.code"
394
+ [inlineError]="codeError() ?? undefined"
395
+ maxlength="20"
396
+ required />
397
+ </div>
398
+ </sd-step>
399
+ <sd-step [label]="type() === 'business' ? 'Thông tin doanh nghiệp' : 'Thông tin cá nhân'" [stepControl]="identity">
400
+ <div class="d-flex flex-column gap-8 py-8">
401
+ @if (type() === 'business') {
402
+ <sd-input label="Tên doanh nghiệp" name="name" autoId="partner-name" [form]="identity" [model]="value.name" required />
403
+ <sd-input
404
+ label="Mã số thuế"
405
+ name="identity"
406
+ autoId="partner-identity"
407
+ [form]="identity"
408
+ [model]="value.identity"
409
+ maxlength="14"
410
+ required />
411
+ <sd-input
412
+ label="Người đại diện"
413
+ name="representative"
414
+ autoId="partner-representative"
415
+ [form]="identity"
416
+ [model]="value.representative"
417
+ required />
418
+ } @else {
419
+ <sd-input label="Họ và tên" name="name" autoId="partner-name" [form]="identity" [model]="value.name" required />
420
+ <sd-input
421
+ label="Số CCCD"
422
+ name="identity"
423
+ autoId="partner-identity"
424
+ [form]="identity"
425
+ [model]="value.identity"
426
+ maxlength="12"
427
+ required />
428
+ }
429
+ </div>
430
+ </sd-step>
431
+ <sd-step label="Liên hệ" [stepControl]="contact">
432
+ <div class="d-flex flex-column gap-8 py-8">
433
+ <sd-input label="Email" name="email" autoId="partner-email" [form]="contact" [model]="value.email" pattern="EMAIL" required />
434
+ <sd-input
435
+ label="Điện thoại"
436
+ name="phone"
437
+ autoId="partner-phone"
438
+ [form]="contact"
439
+ [model]="value.phone"
440
+ maxlength="15"
441
+ required />
442
+ <sd-input label="Địa chỉ" name="address" autoId="partner-address" [form]="contact" [model]="value.address" maxlength="200" />
443
+ </div>
444
+ </sd-step>
445
+ <sd-step label="Xác nhận">
446
+ @let summary = request();
447
+ <sd-section title="Kiểm tra lại" class="d-block my-8">
448
+ <sd-section-item label="Mã đối tác">{{ summary.code }}</sd-section-item>
449
+ <sd-section-item label="Loại">{{ summary.type === 'business' ? 'Doanh nghiệp' : 'Cá nhân' }}</sd-section-item>
450
+ <sd-section-item label="Tên">{{ summary.name }}</sd-section-item>
451
+ <sd-section-item [label]="summary.type === 'business' ? 'Mã số thuế' : 'Số CCCD'">{{ summary.identity }}</sd-section-item>
452
+ @if (summary.type === 'business') {
453
+ <sd-section-item label="Người đại diện">{{ summary.representative }}</sd-section-item>
454
+ }
455
+ <sd-section-item label="Email">{{ summary.email }}</sd-section-item>
456
+ <sd-section-item label="Điện thoại">{{ summary.phone }}</sd-section-item>
457
+ </sd-section>
458
+ </sd-step>
459
+ </sd-stepper>
460
+ <sd-button
461
+ sdFooterLeft
462
+ title="Quay lại"
463
+ type="outline"
464
+ autoId="partner-previous"
465
+ [disabled]="step() === 0"
466
+ (click)="step.set(step() - 1)" />
467
+ @if (step() < 3) {
468
+ <sd-button
469
+ sdFooterRight
470
+ title="Tiếp tục"
471
+ type="fill"
472
+ color="primary"
473
+ autoId="partner-next"
474
+ [loading]="checking()"
475
+ (click)="next()" />
476
+ } @else {
477
+ <sd-button
478
+ sdFooterRight
479
+ title="Tạo đối tác"
480
+ type="fill"
481
+ color="primary"
482
+ autoId="partner-save"
483
+ [loading]="saving()"
484
+ (click)="save()" />
485
+ }
486
+ </sd-page>
487
+ `,
488
+ })
489
+ export class CreateComponent {
490
+ readonly #partnerService = inject(PartnerService);
491
+ readonly #confirm = inject(SdConfirmService);
492
+ readonly #notify = inject(SdNotifyService);
493
+ readonly #router = inject(Router);
494
+ readonly #route = inject(ActivatedRoute);
495
+ readonly #draft = readDraft();
496
+ protected readonly types = PARTNER_TYPE_OPTIONS;
497
+ /** Giá trị ban đầu của các field: bản nháp nếu có. */
498
+ protected readonly seed = signal<PartnerSaveReq>(this.#draft ?? EMPTY);
499
+ protected readonly restored = signal<PartnerDraft | null>(this.#draft);
500
+ protected readonly step = signal(this.#draft?.step ?? 0);
501
+ protected readonly type = signal<PartnerType>(this.#draft?.type ?? 'individual');
502
+ // Mỗi bước một FormGroup: stepper `linear` không cho sang bước sau khi bước hiện tại còn lỗi.
503
+ protected readonly kind = new FormGroup({});
504
+ protected readonly identity = new FormGroup({});
505
+ protected readonly contact = new FormGroup({});
506
+ protected readonly codeError = signal<string | null>(null);
507
+ protected readonly checking = signal(false);
508
+ protected readonly saving = signal(false);
509
+ readonly #values = signal(0);
510
+ /** Đã tạo xong: khi trang đóng, field gỡ control khỏi form và phát valueChanges; không được ghi lại nháp vừa xoá. */
511
+ #created = false;
512
+ protected readonly request = computed<PartnerSaveReq>(() => {
513
+ this.#values();
514
+ // why: nội dung bước chỉ tạo khi bước được mở; bước chưa mở lại sau khi khôi phục nháp lấy giá trị của nháp.
515
+ const value = {
516
+ ...this.seed(),
517
+ ...this.kind.getRawValue(),
518
+ ...this.identity.getRawValue(),
519
+ ...this.contact.getRawValue(),
520
+ } as Partial<PartnerSaveReq>;
521
+ const type = this.type();
522
+ return {
523
+ code: (value.code ?? '').trim().toUpperCase(),
524
+ type,
525
+ name: value.name ?? '',
526
+ identity: value.identity ?? '',
527
+ representative: type === 'business' ? (value.representative ?? '') : null,
528
+ email: value.email ?? '',
529
+ phone: value.phone ?? '',
530
+ address: value.address ?? '',
531
+ };
532
+ });
533
+
534
+ constructor() {
535
+ // Mỗi thay đổi lưu nháp; mã đổi thì bỏ lỗi trùng mã cũ.
536
+ const subscription = merge(this.kind.valueChanges, this.identity.valueChanges, this.contact.valueChanges).subscribe(() => {
537
+ if (this.#created) return;
538
+ this.#values.update(count => count + 1);
539
+ this.#saveDraft();
540
+ });
541
+ const code = this.kind.valueChanges.subscribe(() => this.codeError.set(null));
542
+ inject(DestroyRef).onDestroy(() => {
543
+ subscription.unsubscribe();
544
+ code.unsubscribe();
545
+ });
546
+ }
547
+
548
+ protected async next(): Promise<void> {
549
+ const step = this.step();
550
+ const group = [this.kind, this.identity, this.contact][step];
551
+ group.markAllAsTouched();
552
+ if (group.invalid) return;
553
+ if (step === 0 && !(await this.#codeAvailable())) return;
554
+ this.step.set(step + 1);
555
+ this.#saveDraft();
556
+ }
557
+
558
+ protected async save(): Promise<void> {
559
+ if (this.saving()) return;
560
+ this.saving.set(true);
561
+ try {
562
+ const partner = await firstValueFrom(this.#partnerService.create(this.request()));
563
+ this.#created = true;
564
+ writeDraft(null);
565
+ this.#notify.success(`Đã tạo đối tác ${partner.code}.`);
566
+ await this.#router.navigate(['../..'], { relativeTo: this.#route });
567
+ } catch (error) {
568
+ const fields = apiFieldErrors(error);
569
+ if (fields['code']) {
570
+ // Mã vừa bị người khác dùng: quay lại bước nhập mã, dữ liệu các bước khác giữ nguyên.
571
+ this.codeError.set(fields['code']);
572
+ this.step.set(0);
573
+ } else this.#notify.error(apiErrorMessage(error, 'Không tạo được đối tác. Dữ liệu vẫn được giữ trong bản nháp.'));
574
+ } finally {
575
+ this.saving.set(false);
576
+ }
577
+ }
578
+
579
+ protected async discard(): Promise<void> {
580
+ try {
581
+ await this.#confirm.confirm('Xoá bản nháp và nhập lại từ đầu?', {
582
+ title: 'Bỏ nháp',
583
+ yesTitle: 'Bỏ nháp',
584
+ noTitle: 'Giữ lại',
585
+ yesButtonColor: 'warning',
586
+ });
587
+ } catch {
588
+ return;
589
+ }
590
+ writeDraft(null);
591
+ this.restored.set(null);
592
+ this.step.set(0);
593
+ this.type.set('individual');
594
+ this.seed.set({ ...EMPTY });
595
+ }
596
+
597
+ async #codeAvailable(): Promise<boolean> {
598
+ this.checking.set(true);
599
+ try {
600
+ const { available } = await firstValueFrom(this.#partnerService.checkCode(this.request().code));
601
+ if (!available) this.codeError.set(`Mã ${this.request().code} đã được dùng.`);
602
+ return available;
603
+ } catch (error) {
604
+ this.#notify.error(apiErrorMessage(error, 'Không kiểm tra được mã. Thử lại.'));
605
+ return false;
606
+ } finally {
607
+ this.checking.set(false);
608
+ }
609
+ }
610
+
611
+ #saveDraft(): void {
612
+ writeDraft({ ...this.request(), step: this.step(), savedAt: new Date().toISOString() });
613
+ }
614
+ }
615
+ ```
616
+
617
+ ## Quy tắc
618
+
619
+ - MUST dùng `sd-page` với `backLink` và `width="narrow"`; nút bước (Quay lại, Tiếp tục, nút hoàn tất) ở footer, không ở header (E3).
620
+ - MUST giữ dữ liệu khi quay lại bước trước hoặc chuyển bước (E8); đổi dữ liệu nguồn thì các bước sau phải kiểm tra lại.
621
+ - MUST kiểm tra bước hiện tại trước khi sang bước sau (validation của form bước, kiểm tra với API như trùng mã); dùng `linear` + `stepControl` để người dùng không vượt bước bằng tiêu đề.
622
+ - MUST chỉ ghi dữ liệu ở bước cuối, sau khi hỏi xác nhận; trước đó chỉ đọc hoặc kiểm tra.
623
+ - SHOULD lưu nháp vào storage của tab khi quy trình dài; tải lại trang thì khôi phục và báo rõ, kèm cách bỏ nháp.
624
+ - SHOULD hiện tóm tắt ở bước Xác nhận để người dùng kiểm tra lại trước khi ghi.
625
+
626
+ ## Lỗi hay gặp
627
+
628
+ - Mỗi bước là một route riêng: dữ liệu mất khi tải lại hoặc quay lại.
629
+ - Bấm tiêu đề bước sau để bỏ qua kiểm tra: dữ liệu lỗi tới bước ghi.
630
+ - Rẽ nhánh bằng cách ẩn field bằng CSS: field ẩn vẫn còn validator và chặn bước.
631
+ - Thanh bước của `mat-stepper` cuộn cùng nội dung; có màn thứ ba cần thanh bước ghim thì tách thành component riêng.