@sdcorejs/angular 19.3.2 → 19.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (399) 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/section/index.d.ts +1 -0
  7. package/components/section/src/section-registry.d.ts +11 -0
  8. package/components/splitter/index.d.ts +1 -1
  9. package/components/tab-router/src/actions/tab-router.action.d.ts +1 -1
  10. package/components/tab-router/src/components/tab-router-item/tab-router-item.component.d.ts +4 -2
  11. package/components/tab-router/src/components/tab-router-nav/tab-router-nav.component.d.ts +31 -3
  12. package/components/tab-router/src/components/tab-router-outlet/tab-router-outlet.component.d.ts +6 -1
  13. package/components/tab-router/src/models/tab-router.model.d.ts +5 -0
  14. package/components/tab-router/src/pipes/tab-info.pipe.d.ts +7 -0
  15. package/components/tab-router/src/services/tab-router.service.d.ts +5 -0
  16. package/components/table/index.d.ts +2 -0
  17. package/components/table/src/components/filter/external-filter/external-filter.component.d.ts +5 -1
  18. package/components/table/src/components/mobile-cards/mobile-cards.component.d.ts +4 -0
  19. package/components/table/src/configurations/index.d.ts +1 -0
  20. package/components/table/src/configurations/table-layout.d.ts +16 -0
  21. package/components/table/src/configurations/table.configuration.d.ts +3 -1
  22. package/components/table/src/models/index.d.ts +1 -0
  23. package/components/table/src/models/table-column.model.d.ts +3 -10
  24. package/components/table/src/models/table-item.model.d.ts +4 -1
  25. package/components/table/src/models/table-option-loading.model.d.ts +42 -0
  26. package/components/table/src/models/table-option.model.d.ts +6 -0
  27. package/components/table/src/services/table-filter/table-filter.model.d.ts +5 -0
  28. package/components/table/src/services/table-loading/table-loading.util.d.ts +91 -0
  29. package/components/table/src/services/tree/tree.util.d.ts +2 -0
  30. package/components/table/src/table.component.d.ts +23 -0
  31. package/components/upload-file/src/components/file-type-icon/file-type-icon.component.d.ts +15 -0
  32. package/components/upload-file/src/components/preview/preview.component.d.ts +88 -10
  33. package/components/upload-file/src/configurations/upload-file.configuration.d.ts +1 -1
  34. package/components/upload-file/src/helpers/file-type.d.ts +25 -0
  35. package/components/upload-file/src/pipes/file-meta.pipe.d.ts +9 -0
  36. package/components/upload-file/src/pipes/file-reason.pipe.d.ts +11 -0
  37. package/components/upload-file/src/pipes/index.d.ts +2 -0
  38. package/components/upload-file/src/upload-file.component.d.ts +89 -8
  39. package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
  40. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  41. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +3 -3
  42. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  43. package/fesm2022/sdcorejs-angular-components-section.mjs +15 -3
  44. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  45. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  46. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  47. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  48. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +390 -75
  49. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  50. package/fesm2022/sdcorejs-angular-components-table.mjs +443 -15
  51. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  52. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +886 -173
  53. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  54. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +7 -2
  55. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  56. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +5 -2
  57. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  58. package/fesm2022/sdcorejs-angular-forms-chip.mjs +421 -121
  59. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  60. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +4 -0
  61. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  62. package/fesm2022/sdcorejs-angular-forms-date.mjs +4 -0
  63. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  64. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +4 -0
  65. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  66. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +17 -2
  67. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  68. package/fesm2022/sdcorejs-angular-forms-input.mjs +4 -0
  69. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  70. package/fesm2022/sdcorejs-angular-forms-select.mjs +26 -20
  71. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  72. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +14 -1
  73. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  74. package/fesm2022/sdcorejs-angular-i18n.mjs +210 -0
  75. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  76. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs} +3 -3
  77. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs.map} +1 -1
  78. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs} +3 -3
  79. 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
  80. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs → sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs} +3 -3
  81. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs.map} +1 -1
  82. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs} +4 -4
  83. 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
  84. package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
  85. package/fesm2022/sdcorejs-angular-modules-layout.mjs +265 -10
  86. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  87. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
  88. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
  89. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
  90. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
  91. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-CVEKaR8U.mjs +51 -0
  92. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-CVEKaR8U.mjs.map +1 -0
  93. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-BqHybMk0.mjs +130 -0
  94. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-BqHybMk0.mjs.map +1 -0
  95. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CND3d2zl.mjs +131 -0
  96. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CND3d2zl.mjs.map +1 -0
  97. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BbDoQccI.mjs +99 -0
  98. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BbDoQccI.mjs.map +1 -0
  99. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CB_wJIP8.mjs +460 -0
  100. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CB_wJIP8.mjs.map +1 -0
  101. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DlP4BrhU.mjs +118 -0
  102. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DlP4BrhU.mjs.map +1 -0
  103. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
  104. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
  105. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-VAMePx_q.mjs +66 -0
  106. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-VAMePx_q.mjs.map +1 -0
  107. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-BD79VR0c.mjs +148 -0
  108. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-BD79VR0c.mjs.map +1 -0
  109. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B1rFhbOc.mjs +172 -0
  110. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B1rFhbOc.mjs.map +1 -0
  111. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-BhCjw6ZL.mjs +467 -0
  112. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-BhCjw6ZL.mjs.map +1 -0
  113. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CnL2FzCx.mjs +90 -0
  114. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CnL2FzCx.mjs.map +1 -0
  115. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-BeH-NYvE.mjs +514 -0
  116. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-BeH-NYvE.mjs.map +1 -0
  117. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DpnYSG2j.mjs +61 -0
  118. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DpnYSG2j.mjs.map +1 -0
  119. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-1bi0JZdf.mjs +170 -0
  120. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-1bi0JZdf.mjs.map +1 -0
  121. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs +87 -0
  122. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs.map +1 -0
  123. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs +232 -0
  124. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs.map +1 -0
  125. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs +70 -0
  126. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs.map +1 -0
  127. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-BAZLCVci.mjs +100 -0
  128. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-BAZLCVci.mjs.map +1 -0
  129. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-ikk0cK1M.mjs +522 -0
  130. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-ikk0cK1M.mjs.map +1 -0
  131. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Cex41xzy.mjs +164 -0
  132. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Cex41xzy.mjs.map +1 -0
  133. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-D643jEmo.mjs +629 -0
  134. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-D643jEmo.mjs.map +1 -0
  135. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DTWHhNNl.mjs +71 -0
  136. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DTWHhNNl.mjs.map +1 -0
  137. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-YJUJsrIZ.mjs +115 -0
  138. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-YJUJsrIZ.mjs.map +1 -0
  139. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-qH-YO6wP.mjs +118 -0
  140. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-qH-YO6wP.mjs.map +1 -0
  141. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-S0Vuy6Oc.mjs +1069 -0
  142. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-S0Vuy6Oc.mjs.map +1 -0
  143. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs +186 -0
  144. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +1 -0
  145. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs +97 -0
  146. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +1 -0
  147. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
  148. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
  149. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-Ba73HPGG.mjs +48 -0
  150. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-Ba73HPGG.mjs.map +1 -0
  151. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-CBlN7eEn.mjs +295 -0
  152. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-CBlN7eEn.mjs.map +1 -0
  153. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BvzFafUW.mjs +74 -0
  154. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BvzFafUW.mjs.map +1 -0
  155. package/fesm2022/sdcorejs-angular-modules-pattern-routes-C3uWi8JZ.mjs +165 -0
  156. package/fesm2022/sdcorejs-angular-modules-pattern-routes-C3uWi8JZ.mjs.map +1 -0
  157. package/fesm2022/sdcorejs-angular-modules-pattern-routes-C5ELCTEw.mjs +74 -0
  158. package/fesm2022/sdcorejs-angular-modules-pattern-routes-C5ELCTEw.mjs.map +1 -0
  159. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ClQwnO4h.mjs +50 -0
  160. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ClQwnO4h.mjs.map +1 -0
  161. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DTUxYZ6g.mjs +66 -0
  162. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DTUxYZ6g.mjs.map +1 -0
  163. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DpCuYBlL.mjs +99 -0
  164. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DpCuYBlL.mjs.map +1 -0
  165. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DwZWxmJf.mjs +45 -0
  166. package/fesm2022/sdcorejs-angular-modules-pattern-routes-DwZWxmJf.mjs.map +1 -0
  167. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ydOZduls.mjs +43 -0
  168. package/fesm2022/sdcorejs-angular-modules-pattern-routes-ydOZduls.mjs.map +1 -0
  169. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-D3B5I9hg.mjs +406 -0
  170. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-D3B5I9hg.mjs.map +1 -0
  171. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BW-i6BHg.mjs +317 -0
  172. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BW-i6BHg.mjs.map +1 -0
  173. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-By1mYFa_.mjs +132 -0
  174. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-By1mYFa_.mjs.map +1 -0
  175. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DwcyKb4j.mjs +143 -0
  176. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DwcyKb4j.mjs.map +1 -0
  177. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-BBR8360C.mjs +100 -0
  178. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-BBR8360C.mjs.map +1 -0
  179. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CAtqPgIH.mjs +357 -0
  180. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CAtqPgIH.mjs.map +1 -0
  181. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DjMChf6s.mjs +128 -0
  182. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DjMChf6s.mjs.map +1 -0
  183. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
  184. package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
  185. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
  186. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
  187. package/forms/chip/src/chip.component.d.ts +135 -19
  188. package/forms/chip/src/index.d.ts +0 -1
  189. package/i18n/src/en.d.ts +42 -0
  190. package/modules/layout/components/index.d.ts +2 -0
  191. package/modules/layout/components/page/page-form-leave.guard.d.ts +9 -0
  192. package/modules/layout/components/page/page.component.d.ts +38 -2
  193. package/modules/layout/components/page-list/page-list.component.d.ts +42 -0
  194. package/modules/layout/components/shared/context-switcher/context-switcher.component.d.ts +1 -1
  195. package/modules/pattern/README.md +76 -0
  196. package/modules/pattern/configurations/pattern.configuration.d.ts +30 -0
  197. package/modules/pattern/configurations/provide-sd-patterns.d.ts +19 -0
  198. package/modules/pattern/core/mock-api/mock-api.interceptor.d.ts +8 -0
  199. package/modules/pattern/core/mock-api/mock-api.model.d.ts +62 -0
  200. package/modules/pattern/core/mock-api/mock-api.state.d.ts +36 -0
  201. package/modules/pattern/core/mock-api/mock-backend.d.ts +18 -0
  202. package/modules/pattern/core/mock-api/mock-backend.factory.d.ts +3 -0
  203. package/modules/pattern/core/mock-api/prng.d.ts +4 -0
  204. package/modules/pattern/core/mock-api/resources/approval.resource.d.ts +14 -0
  205. package/modules/pattern/core/mock-api/resources/category.resource.d.ts +9 -0
  206. package/modules/pattern/core/mock-api/resources/customer.resource.d.ts +22 -0
  207. package/modules/pattern/core/mock-api/resources/index.d.ts +3 -0
  208. package/modules/pattern/core/mock-api/resources/names.d.ts +5 -0
  209. package/modules/pattern/core/mock-api/resources/order.resource.d.ts +44 -0
  210. package/modules/pattern/core/mock-api/resources/partner.resource.d.ts +16 -0
  211. package/modules/pattern/core/mock-api/resources/product.resource.d.ts +13 -0
  212. package/modules/pattern/core/mock-api/resources/settings.resource.d.ts +18 -0
  213. package/modules/pattern/core/pattern-shell/catalog/pattern-catalog.d.ts +22 -0
  214. package/modules/pattern/core/pattern-shell/index/index.component.d.ts +9 -0
  215. package/modules/pattern/core/pattern-shell/settings/pattern-settings.store.d.ts +57 -0
  216. package/modules/pattern/core/pattern-shell/settings/settings-button.component.d.ts +44 -0
  217. package/modules/pattern/core/pattern-shell/shell/pattern-source-viewer.d.ts +8 -0
  218. package/modules/pattern/core/pattern-shell/shell/shell.component.d.ts +13 -0
  219. package/modules/pattern/core/pattern-shell/source/pattern-source.generated.d.ts +1 -0
  220. package/modules/pattern/core/pattern-shell/source/source-drawer.component.d.ts +27 -0
  221. package/modules/pattern/core/pattern-shell/toolbar/toolbar.component.d.ts +24 -0
  222. package/modules/pattern/core/permission/pattern-permission.d.ts +15 -0
  223. package/modules/pattern/core/permission/pattern-role.store.d.ts +13 -0
  224. package/modules/pattern/core/session-state.d.ts +4 -0
  225. package/modules/pattern/docs/detail.md +237 -0
  226. package/modules/pattern/docs/drawer.md +484 -0
  227. package/modules/pattern/docs/flow.md +631 -0
  228. package/modules/pattern/docs/form.md +518 -0
  229. package/modules/pattern/docs/header-actions.md +342 -0
  230. package/modules/pattern/docs/list.md +247 -0
  231. package/modules/pattern/docs/relation.md +180 -0
  232. package/modules/pattern/docs/select.md +206 -0
  233. package/modules/pattern/docs/split.md +350 -0
  234. package/modules/pattern/docs/states.md +168 -0
  235. package/modules/pattern/features/approval/entity.resolver.d.ts +4 -0
  236. package/modules/pattern/features/approval/entity.resolver.ts +21 -0
  237. package/modules/pattern/features/approval/pages/detail/detail.component.d.ts +13 -0
  238. package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
  239. package/modules/pattern/features/approval/pages/list/approval-inbox.d.ts +7 -0
  240. package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
  241. package/modules/pattern/features/approval/pages/list/list.component.d.ts +26 -0
  242. package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
  243. package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
  244. package/modules/pattern/features/approval/routes.d.ts +3 -0
  245. package/modules/pattern/features/approval/routes.ts +30 -0
  246. package/modules/pattern/features/approval/services/approval.model.d.ts +37 -0
  247. package/modules/pattern/features/approval/services/approval.model.ts +38 -0
  248. package/modules/pattern/features/approval/services/approval.service.d.ts +12 -0
  249. package/modules/pattern/features/approval/services/approval.service.ts +23 -0
  250. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.d.ts +23 -0
  251. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +123 -0
  252. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.d.ts +20 -0
  253. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
  254. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.d.ts +23 -0
  255. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
  256. package/modules/pattern/features/category/entity.resolver.d.ts +6 -0
  257. package/modules/pattern/features/category/entity.resolver.ts +27 -0
  258. package/modules/pattern/features/category/pages/list/list.component.d.ts +17 -0
  259. package/modules/pattern/features/category/pages/list/list.component.html +20 -0
  260. package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
  261. package/modules/pattern/features/category/routes.d.ts +3 -0
  262. package/modules/pattern/features/category/routes.ts +42 -0
  263. package/modules/pattern/features/category/services/category.model.d.ts +34 -0
  264. package/modules/pattern/features/category/services/category.model.ts +39 -0
  265. package/modules/pattern/features/category/services/category.service.d.ts +17 -0
  266. package/modules/pattern/features/category/services/category.service.ts +36 -0
  267. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.d.ts +24 -0
  268. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +131 -0
  269. package/modules/pattern/features/customer/components/customer-select/customer-select.component.d.ts +20 -0
  270. package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
  271. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.d.ts +20 -0
  272. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
  273. package/modules/pattern/features/customer/components/debts-view/debts-view.component.d.ts +11 -0
  274. package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
  275. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.d.ts +20 -0
  276. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
  277. package/modules/pattern/features/customer/components/documents-view/documents-view.component.d.ts +14 -0
  278. package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
  279. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.d.ts +33 -0
  280. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
  281. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.d.ts +9 -0
  282. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
  283. package/modules/pattern/features/customer/components/orders-view/orders-view.component.d.ts +11 -0
  284. package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
  285. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.d.ts +22 -0
  286. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
  287. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.d.ts +24 -0
  288. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
  289. package/modules/pattern/features/customer/entity.resolver.d.ts +4 -0
  290. package/modules/pattern/features/customer/entity.resolver.ts +21 -0
  291. package/modules/pattern/features/customer/pages/list/list.component.d.ts +19 -0
  292. package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
  293. package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
  294. package/modules/pattern/features/customer/pages/profile/profile.component.d.ts +31 -0
  295. package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
  296. package/modules/pattern/features/customer/pipes/customer-detail.pipe.d.ts +14 -0
  297. package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
  298. package/modules/pattern/features/customer/routes.d.ts +6 -0
  299. package/modules/pattern/features/customer/routes.ts +59 -0
  300. package/modules/pattern/features/customer/services/customer.model.d.ts +77 -0
  301. package/modules/pattern/features/customer/services/customer.model.ts +87 -0
  302. package/modules/pattern/features/customer/services/customer.service.d.ts +24 -0
  303. package/modules/pattern/features/customer/services/customer.service.ts +79 -0
  304. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.d.ts +21 -0
  305. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
  306. package/modules/pattern/features/import/components/preview-view/preview-view.component.d.ts +10 -0
  307. package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
  308. package/modules/pattern/features/import/pages/flow/flow.component.d.ts +43 -0
  309. package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
  310. package/modules/pattern/features/import/routes.d.ts +2 -0
  311. package/modules/pattern/features/import/routes.ts +19 -0
  312. package/modules/pattern/features/import/services/import.model.d.ts +38 -0
  313. package/modules/pattern/features/import/services/import.model.ts +82 -0
  314. package/modules/pattern/features/import/services/import.service.d.ts +15 -0
  315. package/modules/pattern/features/import/services/import.service.ts +18 -0
  316. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.d.ts +9 -0
  317. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
  318. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.d.ts +22 -0
  319. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
  320. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.d.ts +30 -0
  321. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
  322. package/modules/pattern/features/order/components/lines-form/lines-form.component.d.ts +33 -0
  323. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +205 -0
  324. package/modules/pattern/features/order/components/lines-view/lines-view.component.d.ts +12 -0
  325. package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
  326. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.d.ts +25 -0
  327. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
  328. package/modules/pattern/features/order/entity.resolver.d.ts +9 -0
  329. package/modules/pattern/features/order/entity.resolver.ts +37 -0
  330. package/modules/pattern/features/order/pages/create/create.component.d.ts +16 -0
  331. package/modules/pattern/features/order/pages/create/create.component.ts +99 -0
  332. package/modules/pattern/features/order/pages/detail/detail.component.d.ts +26 -0
  333. package/modules/pattern/features/order/pages/detail/detail.component.ts +222 -0
  334. package/modules/pattern/features/order/pages/list/list.component.d.ts +29 -0
  335. package/modules/pattern/features/order/pages/list/list.component.html +38 -0
  336. package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
  337. package/modules/pattern/features/order/pages/update/update.component.d.ts +20 -0
  338. package/modules/pattern/features/order/pages/update/update.component.ts +119 -0
  339. package/modules/pattern/features/order/routes.d.ts +7 -0
  340. package/modules/pattern/features/order/routes.ts +54 -0
  341. package/modules/pattern/features/order/services/order.model.d.ts +106 -0
  342. package/modules/pattern/features/order/services/order.model.ts +109 -0
  343. package/modules/pattern/features/order/services/order.service.d.ts +25 -0
  344. package/modules/pattern/features/order/services/order.service.ts +63 -0
  345. package/modules/pattern/features/partner/pages/create/create.component.d.ts +41 -0
  346. package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
  347. package/modules/pattern/features/partner/routes.d.ts +2 -0
  348. package/modules/pattern/features/partner/routes.ts +20 -0
  349. package/modules/pattern/features/partner/services/partner.model.d.ts +30 -0
  350. package/modules/pattern/features/partner/services/partner.model.ts +30 -0
  351. package/modules/pattern/features/partner/services/partner.service.d.ts +13 -0
  352. package/modules/pattern/features/partner/services/partner.service.ts +17 -0
  353. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.d.ts +23 -0
  354. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
  355. package/modules/pattern/features/product/components/product-select/product-select.component.d.ts +20 -0
  356. package/modules/pattern/features/product/components/product-select/product-select.component.ts +65 -0
  357. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.d.ts +22 -0
  358. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
  359. package/modules/pattern/features/product/entity.resolver.d.ts +4 -0
  360. package/modules/pattern/features/product/entity.resolver.ts +21 -0
  361. package/modules/pattern/features/product/pages/create/create.component.d.ts +15 -0
  362. package/modules/pattern/features/product/pages/create/create.component.ts +85 -0
  363. package/modules/pattern/features/product/pages/detail/detail.component.d.ts +10 -0
  364. package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
  365. package/modules/pattern/features/product/pages/list/list.component.d.ts +15 -0
  366. package/modules/pattern/features/product/pages/list/list.component.html +30 -0
  367. package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
  368. package/modules/pattern/features/product/pages/update/update.component.d.ts +16 -0
  369. package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
  370. package/modules/pattern/features/product/pipes/product-detail.pipe.d.ts +14 -0
  371. package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
  372. package/modules/pattern/features/product/routes.d.ts +3 -0
  373. package/modules/pattern/features/product/routes.ts +48 -0
  374. package/modules/pattern/features/product/services/product.model.d.ts +34 -0
  375. package/modules/pattern/features/product/services/product.model.ts +38 -0
  376. package/modules/pattern/features/product/services/product.service.d.ts +17 -0
  377. package/modules/pattern/features/product/services/product.service.ts +48 -0
  378. package/modules/pattern/features/settings/pages/update/update.component.d.ts +26 -0
  379. package/modules/pattern/features/settings/pages/update/update.component.ts +227 -0
  380. package/modules/pattern/features/settings/routes.d.ts +3 -0
  381. package/modules/pattern/features/settings/routes.ts +24 -0
  382. package/modules/pattern/features/settings/services/settings.model.d.ts +17 -0
  383. package/modules/pattern/features/settings/services/settings.model.ts +18 -0
  384. package/modules/pattern/features/settings/services/settings.service.d.ts +10 -0
  385. package/modules/pattern/features/settings/services/settings.service.ts +15 -0
  386. package/modules/pattern/features/settings/settings.resolver.d.ts +4 -0
  387. package/modules/pattern/features/settings/settings.resolver.ts +8 -0
  388. package/modules/pattern/index.d.ts +3 -0
  389. package/modules/pattern/routes.d.ts +6 -0
  390. package/modules/pattern/services/base-api.service.d.ts +16 -0
  391. package/modules/pattern/utils/api-error.d.ts +4 -0
  392. package/modules/pattern/utils/focus-first-invalid.d.ts +5 -0
  393. package/modules/pattern/utils/form-api-errors.d.ts +16 -0
  394. package/modules/pattern/utils/resource-url.d.ts +2 -0
  395. package/package.json +13 -9
  396. package/services/unsaved-changes/src/unsaved-changes.adapters.d.ts +9 -0
  397. package/services/unsaved-changes/src/unsaved-changes.model.d.ts +2 -0
  398. package/forms/chip/src/pipes/index.d.ts +0 -1
  399. package/forms/chip/src/pipes/removable-chip.pipe.d.ts +0 -8
@@ -0,0 +1,518 @@
1
+ # Form
2
+
3
+ Tạo hoặc cập nhật một bản ghi trong một bước: `sd-page-form`. Route mẫu: `/pattern/product/create` và `/pattern/product/:id/update` (một section), `/pattern/order/create` và `/pattern/order/:id/update` (dòng hàng nhập trực tiếp, mục lục), `/pattern/settings` (một bản ghi, nhiều nhóm, trạng thái lưu ở footer).
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng khi form cần cả trang: nhiều nhóm, bảng dòng chi tiết, hoặc người dùng cần tập trung.
8
+ - Form ngắn sửa ngay trên danh sách: dùng drawer ([drawer](drawer.md)).
9
+ - Nhiều bước có điều kiện chuyển bước: dùng [flow](flow.md).
10
+
11
+ ## Code mẫu
12
+
13
+ Nhóm field nằm trong component `-form` dùng chung cho tạo và cập nhật; field Core tự đăng ký control qua `[form]` + `name`:
14
+
15
+ <!-- @source features/product/components/general-information-form/general-information-form.component.ts -->
16
+ ```ts
17
+ import { ChangeDetectionStrategy, Component, input } from '@angular/core';
18
+ import type { FormControl, FormGroup } from '@angular/forms';
19
+ import { SdSection } from '@sdcorejs/angular/components/section';
20
+ import { SdInput } from '@sdcorejs/angular/forms/input';
21
+ import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
22
+ import type { ProductSaveReq, ProductStatus } from '../../services/product.model';
23
+ import { ProductStatusSelectComponent } from '../product-status-select/product-status-select.component';
24
+
25
+ /** Các field Core tự đăng ký control qua `[form]` + `name`; page không khai báo trước control trùng tên. */
26
+ export type ProductForm = FormGroup<{
27
+ code?: FormControl<string>;
28
+ name?: FormControl<string>;
29
+ unit?: FormControl<string>;
30
+ price?: FormControl<number>;
31
+ status?: FormControl<ProductStatus>;
32
+ }>;
33
+
34
+ /** Giá trị form → request lưu. `code` truyền vào khi cập nhật (mã bị khoá). */
35
+ export function productSaveReq(form: ProductForm, code?: string): ProductSaveReq {
36
+ const value = form.getRawValue();
37
+ return {
38
+ code: code ?? value.code ?? '',
39
+ name: value.name ?? '',
40
+ unit: value.unit ?? '',
41
+ price: value.price ?? 0,
42
+ status: value.status ?? 'active',
43
+ };
44
+ }
45
+
46
+ /** Nhóm "Thông tin chung" của form sản phẩm, dùng chung cho tạo mới và cập nhật. */
47
+ @Component({
48
+ selector: 'general-information-form',
49
+ standalone: true,
50
+ imports: [SdInput, SdInputNumber, SdSection, ProductStatusSelectComponent],
51
+ changeDetection: ChangeDetectionStrategy.OnPush,
52
+ template: `<sd-section title="Thông tin chung">
53
+ <div class="row p-8">
54
+ <div class="col-12 col-md-6">
55
+ <sd-input
56
+ label="Mã sản phẩm"
57
+ name="code"
58
+ autoId="product-code"
59
+ [form]="form()"
60
+ [model]="seed().code"
61
+ [disabled]="editing()"
62
+ [inlineError]="errors()['code']"
63
+ maxlength="20"
64
+ required />
65
+ </div>
66
+ <div class="col-12 col-md-6">
67
+ <sd-input
68
+ label="Tên sản phẩm"
69
+ name="name"
70
+ autoId="product-name"
71
+ [form]="form()"
72
+ [model]="seed().name"
73
+ [inlineError]="errors()['name']"
74
+ maxlength="100"
75
+ required />
76
+ </div>
77
+ <div class="col-12 col-md-6">
78
+ <sd-input label="Đơn vị tính" name="unit" autoId="product-unit" [form]="form()" [model]="seed().unit" maxlength="20" />
79
+ </div>
80
+ <div class="col-12 col-md-6">
81
+ <sd-input-number
82
+ label="Giá bán (₫)"
83
+ name="price"
84
+ autoId="product-price"
85
+ type="positive"
86
+ [precision]="0"
87
+ [form]="form()"
88
+ [model]="seed().price"
89
+ [inlineError]="errors()['price']"
90
+ required />
91
+ </div>
92
+ <div class="col-12 col-md-6">
93
+ <product-status-select [form]="form()" [model]="seed().status" />
94
+ </div>
95
+ </div>
96
+ </sd-section>`,
97
+ })
98
+ export class GeneralInformationFormComponent {
99
+ readonly form = input.required<FormGroup>();
100
+ readonly seed = input.required<ProductSaveReq>();
101
+ readonly editing = input(false);
102
+ /** Lỗi theo field do API trả về. */
103
+ readonly errors = input<Readonly<Record<string, string>>>({});
104
+ }
105
+ ```
106
+
107
+ Trang tạo: Huỷ · Lưu ở `headerRight`, lưu lỗi thì focus field lỗi đầu tiên và gắn lỗi của API vào field, lưu xong sang chi tiết bằng `replaceUrl`:
108
+
109
+ <!-- @source features/product/pages/create/create.component.ts -->
110
+ ```ts
111
+ import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Injector, signal } from '@angular/core';
112
+ import { FormGroup } from '@angular/forms';
113
+ import { ActivatedRoute, Router } from '@angular/router';
114
+ import { firstValueFrom } from 'rxjs';
115
+ import { SdButton } from '@sdcorejs/angular/components/button';
116
+ import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
117
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
118
+ import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
119
+ import { apiErrorMessage } from '../../../../utils/api-error';
120
+ import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
121
+ import { formApiErrors } from '../../../../utils/form-api-errors';
122
+ import {
123
+ GeneralInformationFormComponent,
124
+ productSaveReq,
125
+ type ProductForm,
126
+ } from '../../components/general-information-form/general-information-form.component';
127
+ import { ProductService } from '../../services/product.service';
128
+ import type { ProductSaveReq } from '../../services/product.model';
129
+
130
+ @Component({
131
+ selector: 'create',
132
+ standalone: true,
133
+ changeDetection: ChangeDetectionStrategy.OnPush,
134
+ imports: [SdPageComponent, SdButton, GeneralInformationFormComponent],
135
+ template: `
136
+ <sd-page-form title="Tạo mới sản phẩm" [backLink]="['..']">
137
+ <div headerRight class="d-flex align-items-center gap-8">
138
+ <sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
139
+ <sd-button title="Lưu" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
140
+ </div>
141
+ <div class="py-16">
142
+ <general-information-form [form]="form" [seed]="seed" [errors]="apiErrors.errors()" />
143
+ </div>
144
+ </sd-page-form>
145
+ `,
146
+ })
147
+ export class CreateComponent {
148
+ readonly #productService = inject(ProductService);
149
+ readonly #notify = inject(SdNotifyService);
150
+ readonly #router = inject(Router);
151
+ readonly #route = inject(ActivatedRoute);
152
+ readonly #host: HTMLElement = inject(ElementRef).nativeElement;
153
+ readonly #injector = inject(Injector);
154
+ protected readonly seed: ProductSaveReq = { code: '', name: '', unit: 'Cái', price: 0, status: 'active' };
155
+ protected readonly form: ProductForm = new FormGroup({});
156
+ protected readonly saving = signal(false);
157
+ protected readonly apiErrors = formApiErrors(this.form);
158
+ // Dirty theo giá trị: gõ rồi xoá về như cũ thì rời trang không bị hỏi.
159
+ readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'product-create', dirty: 'value' });
160
+
161
+ constructor() {
162
+ inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
163
+ }
164
+
165
+ protected cancel(): void {
166
+ void this.#router.navigate(['..'], { relativeTo: this.#route });
167
+ }
168
+
169
+ protected async save(): Promise<void> {
170
+ if (this.saving()) return;
171
+ this.form.markAllAsTouched();
172
+ if (this.form.invalid) {
173
+ this.#focusFirstInvalid();
174
+ return;
175
+ }
176
+ this.saving.set(true);
177
+ try {
178
+ const product = await firstValueFrom(this.#productService.create(productSaveReq(this.form)));
179
+ this.#unsaved.markPristine();
180
+ this.#notify.success(`Đã tạo sản phẩm ${product.code}.`);
181
+ // replaceUrl: Back ở trang chi tiết về danh sách, không quay lại form tạo mới.
182
+ await this.#router.navigate(['..', product.id, 'detail'], { relativeTo: this.#route, replaceUrl: true });
183
+ } catch (error) {
184
+ // Lưu lỗi: giữ nguyên dữ liệu đã nhập; lỗi theo field hiện ngay trên field.
185
+ if (this.apiErrors.set(error)) this.#focusFirstInvalid();
186
+ else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
187
+ } finally {
188
+ this.saving.set(false);
189
+ }
190
+ }
191
+
192
+ #focusFirstInvalid(): void {
193
+ afterNextRender(() => focusFirstInvalid(this.#host), { injector: this.#injector });
194
+ }
195
+ }
196
+ ```
197
+
198
+ Trang cập nhật: mã bị khoá, dirty tính theo giá trị:
199
+
200
+ <!-- @source features/product/pages/update/update.component.ts -->
201
+ ```ts
202
+ import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Injector, signal } from '@angular/core';
203
+ import { toSignal } from '@angular/core/rxjs-interop';
204
+ import { FormGroup } from '@angular/forms';
205
+ import { ActivatedRoute, Router } from '@angular/router';
206
+ import { firstValueFrom, map } from 'rxjs';
207
+ import { SdButton } from '@sdcorejs/angular/components/button';
208
+ import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
209
+ import { SdNotifyService } from '@sdcorejs/angular/services/notify';
210
+ import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
211
+ import { apiErrorMessage } from '../../../../utils/api-error';
212
+ import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
213
+ import { formApiErrors } from '../../../../utils/form-api-errors';
214
+ import {
215
+ GeneralInformationFormComponent,
216
+ productSaveReq,
217
+ type ProductForm,
218
+ } from '../../components/general-information-form/general-information-form.component';
219
+ import { ProductService } from '../../services/product.service';
220
+ import type { ProductDto } from '../../services/product.model';
221
+
222
+ @Component({
223
+ selector: 'update',
224
+ standalone: true,
225
+ changeDetection: ChangeDetectionStrategy.OnPush,
226
+ imports: [SdPageComponent, SdButton, GeneralInformationFormComponent],
227
+ template: `
228
+ <sd-page-form [title]="'Cập nhật sản phẩm #' + entity().code" [backLink]="['../detail']">
229
+ <div headerRight class="d-flex align-items-center gap-8">
230
+ <sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
231
+ <sd-button title="Lưu" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
232
+ </div>
233
+ <div class="py-16">
234
+ <general-information-form [form]="form" [seed]="entity()" [editing]="true" [errors]="apiErrors.errors()" />
235
+ </div>
236
+ </sd-page-form>
237
+ `,
238
+ })
239
+ export class UpdateComponent {
240
+ readonly #productService = inject(ProductService);
241
+ readonly #notify = inject(SdNotifyService);
242
+ readonly #router = inject(Router);
243
+ readonly #route = inject(ActivatedRoute);
244
+ readonly #host: HTMLElement = inject(ElementRef).nativeElement;
245
+ readonly #injector = inject(Injector);
246
+ /** Sản phẩm do resolver tải; draft khởi tạo từ đây, sửa draft không đổi bản ghi trước khi lưu thành công. */
247
+ protected readonly entity = toSignal(this.#route.data.pipe(map(data => data['entity'] as ProductDto)), { requireSync: true });
248
+ protected readonly form: ProductForm = new FormGroup({});
249
+ protected readonly saving = signal(false);
250
+ protected readonly apiErrors = formApiErrors(this.form);
251
+ readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'product-update', dirty: 'value' });
252
+
253
+ constructor() {
254
+ inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
255
+ }
256
+
257
+ protected cancel(): void {
258
+ void this.#router.navigate(['../detail'], { relativeTo: this.#route });
259
+ }
260
+
261
+ protected async save(): Promise<void> {
262
+ if (this.saving()) return;
263
+ this.form.markAllAsTouched();
264
+ if (this.form.invalid) {
265
+ this.#focusFirstInvalid();
266
+ return;
267
+ }
268
+ this.saving.set(true);
269
+ try {
270
+ // Mã bị khoá sau khi tạo: gửi mã của bản ghi, không lấy từ form.
271
+ await firstValueFrom(this.#productService.update(this.entity().id, productSaveReq(this.form, this.entity().code)));
272
+ this.#unsaved.markPristine();
273
+ this.#notify.success('Đã cập nhật sản phẩm.');
274
+ await this.#router.navigate(['../detail'], { relativeTo: this.#route, replaceUrl: true });
275
+ } catch (error) {
276
+ // Lưu lỗi: giữ nguyên draft để sửa và thử lại.
277
+ if (this.apiErrors.set(error)) this.#focusFirstInvalid();
278
+ else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
279
+ } finally {
280
+ this.saving.set(false);
281
+ }
282
+ }
283
+
284
+ #focusFirstInvalid(): void {
285
+ afterNextRender(() => focusFirstInvalid(this.#host), { injector: this.#injector });
286
+ }
287
+ }
288
+ ```
289
+
290
+ Dòng hàng nhập trực tiếp, tổng tự tính, lỗi của API hiện trên đúng dòng:
291
+
292
+ <!-- @source features/order/components/lines-form/lines-form.component.ts -->
293
+ ```ts
294
+ import { ChangeDetectionStrategy, Component, computed, DestroyRef, effect, inject, input, signal, untracked } from '@angular/core';
295
+ import { FormArray, FormGroup } from '@angular/forms';
296
+ import { firstValueFrom } from 'rxjs';
297
+ import { SdButton } from '@sdcorejs/angular/components/button';
298
+ import { SdSection } from '@sdcorejs/angular/components/section';
299
+ import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
300
+ import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
301
+ import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
302
+ import { ProductService } from '../../../product/services/product.service';
303
+ import type { OrderLineDto } from '../../services/order.model';
304
+ import type { OrderForm } from '../general-information-form/general-information-form.component';
305
+
306
+ interface LineRow {
307
+ readonly key: number;
308
+ readonly group: FormGroup;
309
+ readonly seed: OrderLineDto;
310
+ }
311
+
312
+ /**
313
+ * Bảng dòng hàng nhập trực tiếp: mỗi dòng là một FormGroup trong `form.lines` (FormArray), các field Core tự đăng
314
+ * ký vào dòng. Chọn sản phẩm điền đơn giá; thành tiền và tổng tự tính. Lỗi API theo dòng (`lines.<i>.<field>`) hiện
315
+ * ngay trên ô của dòng đó.
316
+ */
317
+ @Component({
318
+ selector: 'lines-form',
319
+ standalone: true,
320
+ imports: [SdSection, SdButton, SdInputNumber, SdFormatNumberPipe, ProductSelectComponent],
321
+ changeDetection: ChangeDetectionStrategy.OnPush,
322
+ template: `
323
+ <sd-section title="Dòng hàng">
324
+ <div sdHeaderRight>
325
+ <sd-button title="Thêm dòng" prefixIcon="add" type="text" autoId="order-line-add" (click)="add()" />
326
+ </div>
327
+ <table class="lines">
328
+ <thead>
329
+ <tr>
330
+ <th scope="col">Sản phẩm</th>
331
+ <th scope="col" class="lines__number">Số lượng</th>
332
+ <th scope="col" class="lines__number">Đơn giá (₫)</th>
333
+ <th scope="col" class="lines__number">Thành tiền (₫)</th>
334
+ <th scope="col"><span class="sd-visually-hidden">Xoá dòng</span></th>
335
+ </tr>
336
+ </thead>
337
+ <tbody>
338
+ @for (row of rows(); track row.key; let index = $index) {
339
+ <tr [attr.data-line]="index">
340
+ <td>
341
+ <product-select
342
+ [label]="undefined"
343
+ [form]="row.group"
344
+ [model]="row.seed.productId || null"
345
+ [autoId]="'order-line-' + index + '-product'"
346
+ (modelChange)="pick(row, $event)"
347
+ required />
348
+ @if (errors()['lines.' + index + '.productId']; as error) {
349
+ <span class="lines__error" role="alert">{{ error }}</span>
350
+ }
351
+ </td>
352
+ <td class="lines__number">
353
+ <sd-input-number
354
+ name="quantity"
355
+ type="positive"
356
+ [precision]="0"
357
+ [form]="row.group"
358
+ [model]="row.seed.quantity"
359
+ [inlineError]="errors()['lines.' + index + '.quantity']"
360
+ [autoId]="'order-line-' + index + '-quantity'"
361
+ required />
362
+ </td>
363
+ <td class="lines__number">
364
+ <sd-input-number
365
+ name="unitPrice"
366
+ type="positive"
367
+ [precision]="0"
368
+ [form]="row.group"
369
+ [model]="row.seed.unitPrice"
370
+ required />
371
+ </td>
372
+ <td class="lines__number">{{ amounts()[index] | sdFormatNumber: 0 }}</td>
373
+ <td>
374
+ <sd-button
375
+ prefixIcon="delete"
376
+ type="text"
377
+ color="error"
378
+ tooltip="Xoá dòng"
379
+ [autoId]="'order-line-' + index + '-remove'"
380
+ [disabled]="rows().length === 1"
381
+ (click)="remove(row)" />
382
+ </td>
383
+ </tr>
384
+ }
385
+ </tbody>
386
+ <tfoot>
387
+ <tr>
388
+ <th scope="row" colspan="3" class="lines__number">Tổng tiền (₫)</th>
389
+ <td class="lines__number lines__total" data-autoid="order-total">{{ total() | sdFormatNumber: 0 }}</td>
390
+ <td></td>
391
+ </tr>
392
+ </tfoot>
393
+ </table>
394
+ </sd-section>
395
+ `,
396
+ styles: `
397
+ .lines {
398
+ width: 100%;
399
+ border-collapse: collapse;
400
+ }
401
+ .lines th,
402
+ .lines td {
403
+ padding: 4px 8px;
404
+ text-align: left;
405
+ vertical-align: top;
406
+ }
407
+ .lines thead th {
408
+ color: var(--sd-text-secondary);
409
+ font-size: 12px;
410
+ font-weight: 500;
411
+ border-bottom: 1px solid var(--sd-border);
412
+ }
413
+ .lines td:first-child {
414
+ min-width: 240px;
415
+ }
416
+ .lines__number {
417
+ width: 150px;
418
+ text-align: right !important;
419
+ }
420
+ .lines td.lines__number {
421
+ padding-top: 14px;
422
+ }
423
+ .lines tfoot th,
424
+ .lines tfoot td {
425
+ padding-top: 12px;
426
+ border-top: 1px solid var(--sd-border);
427
+ }
428
+ .lines__total {
429
+ font-weight: 500;
430
+ }
431
+ .lines__error {
432
+ color: var(--sd-error, currentColor);
433
+ font-size: 12px;
434
+ }
435
+ `,
436
+ })
437
+ export class LinesFormComponent {
438
+ readonly #productService = inject(ProductService);
439
+ readonly form = input.required<OrderForm>();
440
+ /** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
441
+ readonly seed = input.required<readonly OrderLineDto[]>();
442
+ /** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
443
+ readonly errors = input<Readonly<Record<string, string>>>({});
444
+ readonly #array = new FormArray<FormGroup>([]);
445
+ readonly #version = signal(0);
446
+ #nextKey = 0;
447
+ protected readonly rows = signal<readonly LineRow[]>([]);
448
+ protected readonly amounts = computed(() => {
449
+ this.#version();
450
+ return this.rows().map(
451
+ row => Number(row.group.get('quantity')?.value ?? row.seed.quantity) * Number(row.group.get('unitPrice')?.value ?? row.seed.unitPrice)
452
+ );
453
+ });
454
+ protected readonly total = computed(() => this.amounts().reduce((sum, amount) => sum + amount, 0));
455
+
456
+ constructor() {
457
+ const subscription = this.#array.valueChanges.subscribe(() => this.#version.update(version => version + 1));
458
+ inject(DestroyRef).onDestroy(() => subscription.unsubscribe());
459
+ // why: trang cập nhật được dùng lại khi chỉ đổi `:id`; dòng hàng phải theo đơn mới, không giữ dòng của đơn trước.
460
+ effect(() => {
461
+ const seed = this.seed();
462
+ untracked(() => this.#load(seed));
463
+ });
464
+ }
465
+
466
+ protected add(): void {
467
+ this.#push({ productId: '', quantity: 1, unitPrice: 0 });
468
+ }
469
+
470
+ protected remove(row: LineRow): void {
471
+ const index = this.rows().indexOf(row);
472
+ if (index < 0) return;
473
+ // why: đánh dấu đã sửa TRƯỚC khi gỡ, để dirty theo giá trị so với danh sách dòng lúc trước.
474
+ this.#array.markAsDirty();
475
+ this.#array.removeAt(index);
476
+ this.rows.update(rows => rows.filter(item => item !== row));
477
+ }
478
+
479
+ /** Chọn sản phẩm thì điền đơn giá hiện hành của sản phẩm. */
480
+ protected async pick(row: LineRow, productId: string | null | undefined): Promise<void> {
481
+ if (!productId) return;
482
+ const product = await firstValueFrom(this.#productService.cachedDetail(productId));
483
+ row.group.get('unitPrice')?.setValue(product.price);
484
+ }
485
+
486
+ #load(seed: readonly OrderLineDto[]): void {
487
+ this.#array.clear();
488
+ this.rows.set([]);
489
+ (seed.length ? seed : [{ productId: '', quantity: 1, unitPrice: 0 }]).forEach(line => this.#push(line));
490
+ if (this.form().get('lines') !== this.#array) this.form().setControl('lines', this.#array);
491
+ }
492
+
493
+ #push(seed: OrderLineDto): void {
494
+ const group = new FormGroup({});
495
+ this.#array.push(group);
496
+ this.rows.update(rows => [...rows, { key: this.#nextKey++, group, seed }]);
497
+ }
498
+ }
499
+ ```
500
+
501
+ ## Quy tắc
502
+
503
+ - MUST đặt Huỷ (outline) và Lưu (fill, primary) ở `headerRight` của `sd-page-form` (E3); không lặp nút lưu ở cuối thân.
504
+ - MUST đặt title "Tạo mới <entity>" hoặc "Cập nhật <entity> #<mã>" (E5).
505
+ - MUST bảo vệ thay đổi chưa lưu: `canDeactivate: [sdPageFormLeaveGuard]` trên route và `registerSdUnsavedChangesForm(..., { dirty: 'value' })` trong trang. Gõ rồi sửa về như cũ không bị hỏi; đóng tab trình duyệt khi còn thay đổi có hộp thoại của trình duyệt.
506
+ - MUST kiểm tra khi rời field và khi bấm Lưu (`markAllAsTouched`); lưu lỗi thì focus field lỗi đầu tiên (E13).
507
+ - MUST gắn lỗi theo field của API vào đúng field (`[inlineError]`), giữ nguyên dữ liệu đã nhập; field đổi giá trị thì bỏ lỗi cũ của nó.
508
+ - MUST lưu xong thì `markPristine()` trước khi điều hướng, sang chi tiết với `replaceUrl: true` để Back không quay lại form tạo mới.
509
+ - MUST không khai báo trước FormControl trùng tên với field Core tự đăng ký.
510
+ - SHOULD dùng `toc` khi form có từ ba nhóm trở lên; mục lục lấy các `sd-section` có title, cả section nằm trong component `-form` con.
511
+ - SHOULD giữ bản ghi một dòng (cài đặt) ở lại trang sau khi lưu: `form.markAsPristine()` làm giá trị vừa lưu thành mốc so sánh mới, footer báo trạng thái lưu.
512
+
513
+ ## Lỗi hay gặp
514
+
515
+ - Chụp giá trị ban đầu lúc khởi tạo form khi field Core chưa đăng ký: form vừa mở đã bị coi là có thay đổi. Dùng `dirty: 'value'` của `registerSdUnsavedChangesForm`.
516
+ - Bắt mọi lỗi lưu rồi báo chung "Không thể lưu": lỗi theo field của API mất chỗ hiện.
517
+ - Điều hướng sau khi lưu mà chưa `markPristine()`: guard hỏi "Rời trang khi chưa lưu?" ngay sau khi lưu xong.
518
+ - Bấm Lưu liên tiếp tạo hai request: chặn bằng cờ `saving` và trạng thái `loading` của nút.