@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,180 @@
1
+ # Relation
2
+
3
+ Hiện bản ghi liên quan theo ID bằng pipe `<entity>Detail` của feature sở hữu entity. Mẫu: `customerDetail` (điện thoại khách trên chi tiết đơn hàng), `productDetail` (tên sản phẩm trên dòng hàng).
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng khi bản ghi chỉ có ID của entity khác và màn cần tên, mã hay field khác của entity đó.
8
+ - Response đã có tên (chứng từ giữ snapshot tên khách lúc lập đơn): hiện snapshot, không tra lại tên hiện tại.
9
+
10
+ ## Code mẫu
11
+
12
+ <!-- @source features/customer/pipes/customer-detail.pipe.ts -->
13
+ ```ts
14
+ import { inject, Pipe, type PipeTransform } from '@angular/core';
15
+ import { of, type Observable } from 'rxjs';
16
+ import { CustomerService } from '../services/customer.service';
17
+ import type { CustomerDto } from '../services/customer.model';
18
+
19
+ /**
20
+ * Relation khách hàng theo ID: `@let customer = order.customerId | customerDetail | async;`.
21
+ * CustomerService cache và chia sẻ request theo ID; nơi dùng pipe phải có CustomerService trong injector.
22
+ */
23
+ @Pipe({ name: 'customerDetail', standalone: true })
24
+ export class CustomerDetailPipe implements PipeTransform {
25
+ readonly #customerService = inject(CustomerService);
26
+
27
+ transform(id: CustomerDto['id'] | null | undefined): Observable<CustomerDto | null> {
28
+ if (id === null || id === undefined || id === '') return of(null);
29
+ return this.#customerService.cachedDetail(id);
30
+ }
31
+ }
32
+ ```
33
+
34
+ Service sở hữu cache và chia sẻ request theo ID; lỗi tra cứu không được cache:
35
+
36
+ <!-- @source features/customer/services/customer.service.ts -->
37
+ ```ts
38
+ import { HttpParams } from '@angular/common/http';
39
+ import { Injectable, signal } from '@angular/core';
40
+ import { shareReplay, tap, type Observable } from 'rxjs';
41
+ import type { Filter, PagingRes } from '@sdcorejs/utils/models';
42
+ import { BaseApiService } from '../../../services/base-api.service';
43
+ import type {
44
+ CustomerCounts,
45
+ CustomerDebtDto,
46
+ CustomerDocumentDto,
47
+ CustomerDto,
48
+ CustomerListReq,
49
+ CustomerListRes,
50
+ CustomerOrderDto,
51
+ CustomerSaveReq,
52
+ } from './customer.model';
53
+
54
+ @Injectable()
55
+ export class CustomerService extends BaseApiService {
56
+ readonly #details = new Map<string, Observable<CustomerDto>>();
57
+ readonly #changes = signal(0);
58
+ /** Tăng sau mỗi lần tạo, cập nhật hoặc xoá thành công: danh sách chỉ tải lại khi có thay đổi. */
59
+ readonly changes = this.#changes.asReadonly();
60
+
61
+ list(req: CustomerListReq): Observable<CustomerListRes> {
62
+ return this.http.get<CustomerListRes>(this.apiUrl('customers'), { params: this.buildPagingReq(req) });
63
+ }
64
+
65
+ /** Số khách theo nhóm cho score card, theo cùng bộ lọc của danh sách. */
66
+ counts(filters: Filter<CustomerDto>[]): Observable<CustomerCounts> {
67
+ return this.http.get<CustomerCounts>(this.apiUrl('customers', 'counts'), {
68
+ params: new HttpParams().set('filters', JSON.stringify(filters)),
69
+ });
70
+ }
71
+
72
+ detail(id: string): Observable<CustomerDto> {
73
+ return this.http.get<CustomerDto>(this.apiUrl('customers', id));
74
+ }
75
+
76
+ /** `detail(id)` có cache, cho relation (`customerDetail`) và giá trị đã chọn của `customer-select`. */
77
+ cachedDetail(id: string): Observable<CustomerDto> {
78
+ let detail = this.#details.get(id);
79
+ if (!detail) {
80
+ detail = this.detail(id).pipe(shareReplay({ bufferSize: 1, refCount: false }));
81
+ this.#details.set(id, detail);
82
+ // Lỗi tra cứu không được cache: lần gọi sau hỏi lại.
83
+ detail.subscribe({ error: () => this.#details.delete(id) });
84
+ }
85
+ return detail;
86
+ }
87
+
88
+ create(req: CustomerSaveReq): Observable<CustomerDto> {
89
+ return this.http.post<CustomerDto>(this.apiUrl('customers'), req).pipe(tap(() => this.#changed()));
90
+ }
91
+
92
+ update(id: string, req: CustomerSaveReq): Observable<CustomerDto> {
93
+ return this.http.put<CustomerDto>(this.apiUrl('customers', id), req).pipe(tap(() => this.#changed(id)));
94
+ }
95
+
96
+ delete(id: string): Observable<void> {
97
+ return this.http.delete<void>(this.apiUrl('customers', id)).pipe(tap(() => this.#changed(id)));
98
+ }
99
+
100
+ orders(id: string): Observable<PagingRes<CustomerOrderDto>> {
101
+ return this.http.get<PagingRes<CustomerOrderDto>>(this.apiUrl('customers', id, 'orders'));
102
+ }
103
+
104
+ debts(id: string): Observable<PagingRes<CustomerDebtDto>> {
105
+ return this.http.get<PagingRes<CustomerDebtDto>>(this.apiUrl('customers', id, 'debts'));
106
+ }
107
+
108
+ documents(id: string): Observable<PagingRes<CustomerDocumentDto>> {
109
+ return this.http.get<PagingRes<CustomerDocumentDto>>(this.apiUrl('customers', id, 'documents'));
110
+ }
111
+
112
+ #changed(id?: string): void {
113
+ if (id) this.#details.delete(id);
114
+ this.#changes.update(count => count + 1);
115
+ }
116
+ }
117
+ ```
118
+
119
+ Dùng trong template:
120
+
121
+ <!-- @source features/order/components/lines-view/lines-view.component.ts -->
122
+ ```ts
123
+ import { AsyncPipe } from '@angular/common';
124
+ import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
125
+ import { SdSection } from '@sdcorejs/angular/components/section';
126
+ import { SdTable, SdTableCellDefDirective, type SdTableOption } from '@sdcorejs/angular/components/table';
127
+ import { ProductDetailPipe } from '../../../product/pipes/product-detail.pipe';
128
+ import type { OrderLineDto } from '../../services/order.model';
129
+
130
+ /** Dòng hàng chỉ đọc; tên sản phẩm lấy qua relation `productDetail`, không hiện ID thô. */
131
+ @Component({
132
+ selector: 'lines-view',
133
+ standalone: true,
134
+ imports: [AsyncPipe, SdSection, SdTable, SdTableCellDefDirective, ProductDetailPipe],
135
+ changeDetection: ChangeDetectionStrategy.OnPush,
136
+ template: `
137
+ <sd-section title="Dòng hàng">
138
+ <sd-table autoId="order-lines" [option]="option()">
139
+ <ng-template sdTableCellDef="productId" let-line="item">
140
+ @let product = line.productId | productDetail | async;
141
+ {{ product?.name ?? '…' }}
142
+ </ng-template>
143
+ </sd-table>
144
+ </sd-section>
145
+ `,
146
+ })
147
+ export class LinesViewComponent {
148
+ readonly lines = input.required<readonly OrderLineDto[]>();
149
+ protected readonly option = computed<SdTableOption<OrderLineDto & { amount: number }>>(() => {
150
+ const items = this.lines().map(line => ({ ...line, amount: line.quantity * line.unitPrice }));
151
+ return {
152
+ type: 'local',
153
+ items: () => items,
154
+ paginate: { pageSize: 50 },
155
+ filter: { hideInlineFilter: 'auto' },
156
+ columns: [
157
+ { field: 'productId', title: 'Sản phẩm', type: 'string', minWidth: '200px' },
158
+ { field: 'quantity', title: 'Số lượng', type: 'number', width: '110px', align: 'right' },
159
+ { field: 'unitPrice', title: 'Đơn giá (₫)', type: 'number', width: '140px', align: 'right' },
160
+ { field: 'amount', title: 'Thành tiền (₫)', type: 'number', width: '150px', align: 'right' },
161
+ ],
162
+ };
163
+ });
164
+ }
165
+ ```
166
+
167
+ ## Quy tắc
168
+
169
+ - MUST đặt pipe trong `pipes/<entity>-detail.pipe.ts` của feature sở hữu entity; tên template `<entity>Detail`, trả object có kiểu của entity, không trả chuỗi.
170
+ - MUST gọi service của đúng entity; pipe không tự gọi HTTP.
171
+ - MUST trả `null` không gọi API khi ID rỗng.
172
+ - MUST để service chia sẻ request theo ID; nhiều dòng cùng ID chỉ một request.
173
+ - MUST cấp service của entity ở route nơi pipe chạy.
174
+ - SHOULD hiện placeholder của Core (`sdEmpty`, `sd-view`) khi giá trị rỗng; không tự viết `--`.
175
+
176
+ ## Lỗi hay gặp
177
+
178
+ - Gọi hàm tra tên trong template: chạy lại mỗi lần change detection, mỗi lần một request.
179
+ - Bắt lỗi tra cứu rồi trả `null` như thành công: người dùng thấy `--` thay vì biết là lỗi.
180
+ - Hiện ID thô thay cho tên.
@@ -0,0 +1,214 @@
1
+ # Select
2
+
3
+ Chọn entity hoặc enum qua wrapper của feature sở hữu entity. Mẫu: `product-select` và `customer-select` (dòng đơn hàng, đầu đơn hàng), `product-status-select`, `customer-type-select`.
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng wrapper mỗi khi một màn chọn entity của feature khác, hoặc chọn một enum của entity.
8
+ - Danh sách lựa chọn cố định chỉ dùng một lần trong chính feature (kênh bán của đơn hàng): `sd-select` với hằng số trong `<entity>.model.ts` là đủ.
9
+
10
+ ## Code mẫu
11
+
12
+ Entity: lựa chọn mới chỉ gồm bản ghi đang hoạt động (`SEARCH`); giá trị đã chọn tải theo ID (`VALUE`) nên bản ghi đã ngừng vẫn hiện khi cập nhật. Option hai dòng có avatar:
13
+
14
+ <!-- @source features/customer/components/customer-select/customer-select.component.ts -->
15
+ ```ts
16
+ import { booleanAttribute, ChangeDetectionStrategy, Component, inject, input, model } from '@angular/core';
17
+ import type { FormGroup } from '@angular/forms';
18
+ import { firstValueFrom } from 'rxjs';
19
+ import { SdAvatar } from '@sdcorejs/angular/components/avatar';
20
+ import { SdItemDefDefDirective } from '@sdcorejs/angular/forms/directives';
21
+ import type { SdSearchReq } from '@sdcorejs/angular/forms/models';
22
+ import { SdSelect } from '@sdcorejs/angular/forms/select';
23
+ import type { Filter } from '@sdcorejs/utils/models';
24
+ import { CustomerService } from '../../services/customer.service';
25
+ import type { CustomerDto } from '../../services/customer.model';
26
+
27
+ /**
28
+ * Chọn khách hàng cho màn khác (đơn hàng). Lựa chọn mới chỉ gồm khách đang hoạt động; giá trị đã chọn tải theo ID
29
+ * (`VALUE`) nên khách đã ngừng vẫn hiện khi cập nhật. Option hai dòng có avatar: tên · mã · điện thoại.
30
+ */
31
+ @Component({
32
+ selector: 'customer-select',
33
+ standalone: true,
34
+ imports: [SdSelect, SdItemDefDefDirective, SdAvatar],
35
+ changeDetection: ChangeDetectionStrategy.OnPush,
36
+ template: `<sd-select
37
+ [label]="label()"
38
+ [name]="name()"
39
+ [form]="form()"
40
+ [(model)]="model"
41
+ [items]="search"
42
+ valueField="id"
43
+ displayField="name"
44
+ [required]="required()"
45
+ [autoId]="autoId()">
46
+ <ng-template sdItemDef let-item="item">
47
+ <div class="d-flex align-items-center gap-8">
48
+ <sd-avatar [src]="null" [name]="item.name" [size]="28" />
49
+ <div class="d-flex flex-column">
50
+ <span>{{ item.name }}</span>
51
+ <small class="text-secondary"
52
+ >{{ item.code }} · {{ item.phone }}{{ item.status === 'inactive' ? ' · Ngừng hoạt động' : '' }}</small
53
+ >
54
+ </div>
55
+ </div>
56
+ </ng-template>
57
+ </sd-select>`,
58
+ })
59
+ export class CustomerSelectComponent {
60
+ readonly #customerService = inject(CustomerService);
61
+ readonly form = input<FormGroup>();
62
+ readonly name = input('customerId');
63
+ readonly label = input<string | undefined>('Khách hàng');
64
+ readonly required = input(false, { transform: booleanAttribute });
65
+ readonly autoId = input<string>();
66
+ readonly model = model<string | null | undefined>();
67
+
68
+ protected readonly search = async (req: SdSearchReq): Promise<CustomerDto[]> => {
69
+ if (req.type === 'VALUE') {
70
+ const ids = (Array.isArray(req.value) ? req.value : [req.value]).filter((id): id is string => !!id);
71
+ return Promise.all(ids.map(id => firstValueFrom(this.#customerService.cachedDetail(id))));
72
+ }
73
+ const filters: Filter<CustomerDto>[] = [{ field: 'status', operator: 'EQUAL', data: 'active' }];
74
+ if (req.searchText) {
75
+ filters.push({
76
+ operator: 'OR',
77
+ data: [
78
+ { field: 'name', operator: 'CONTAIN', data: req.searchText },
79
+ { field: 'code', operator: 'CONTAIN', data: req.searchText },
80
+ { field: 'phone', operator: 'CONTAIN', data: req.searchText },
81
+ ],
82
+ });
83
+ }
84
+ const res = await firstValueFrom(this.#customerService.list({ pageNumber: 0, pageSize: 20, filters }));
85
+ return res.items;
86
+ };
87
+ }
88
+ ```
89
+
90
+ <!-- @source features/product/components/product-select/product-select.component.ts -->
91
+ ```ts
92
+ import { booleanAttribute, ChangeDetectionStrategy, Component, inject, input, model } from '@angular/core';
93
+ import type { FormGroup } from '@angular/forms';
94
+ import { firstValueFrom } from 'rxjs';
95
+ import { SdItemDefDefDirective } from '@sdcorejs/angular/forms/directives';
96
+ import type { SdSearchReq } from '@sdcorejs/angular/forms/models';
97
+ import { SdSelect } from '@sdcorejs/angular/forms/select';
98
+ import type { Filter, Size } from '@sdcorejs/utils/models';
99
+ import { ProductService } from '../../services/product.service';
100
+ import type { ProductDto } from '../../services/product.model';
101
+
102
+ /**
103
+ * Chọn sản phẩm cho màn khác (dòng đơn hàng). Lựa chọn mới chỉ gồm sản phẩm đang hoạt động; giá trị đã chọn
104
+ * được tải theo ID (`VALUE`) nên sản phẩm đã ngừng vẫn hiển thị khi cập nhật. Option hai dòng: tên · mã · đơn vị.
105
+ * `size`, `hideInlineError` và `inlineError` chuyển thẳng xuống `sd-select`, để dùng được trong ô của bảng.
106
+ */
107
+ @Component({
108
+ selector: 'product-select',
109
+ standalone: true,
110
+ imports: [SdSelect, SdItemDefDefDirective],
111
+ changeDetection: ChangeDetectionStrategy.OnPush,
112
+ template: `<sd-select
113
+ [label]="label()"
114
+ [name]="name()"
115
+ [form]="form()"
116
+ [(model)]="model"
117
+ [items]="search"
118
+ valueField="id"
119
+ displayField="name"
120
+ [required]="required()"
121
+ [size]="size()"
122
+ [hideInlineError]="hideInlineError()"
123
+ [inlineError]="inlineError()"
124
+ [autoId]="autoId()">
125
+ <ng-template sdItemDef let-item="item">
126
+ <div class="d-flex flex-column">
127
+ <span>{{ item.name }}</span>
128
+ <small class="text-secondary">{{ item.code }} · {{ item.unit }}{{ item.status === 'inactive' ? ' · Ngừng hoạt động' : '' }}</small>
129
+ </div>
130
+ </ng-template>
131
+ </sd-select>`,
132
+ })
133
+ export class ProductSelectComponent {
134
+ readonly #productService = inject(ProductService);
135
+ readonly form = input<FormGroup>();
136
+ readonly name = input('productId');
137
+ readonly label = input<string | undefined>('Sản phẩm');
138
+ readonly required = input(false, { transform: booleanAttribute });
139
+ readonly size = input<Size>('md');
140
+ readonly hideInlineError = input(false, { transform: booleanAttribute });
141
+ /** Lỗi của API cho field này (vd `lines.0.productId`). */
142
+ readonly inlineError = input<string>();
143
+ readonly autoId = input<string>();
144
+ readonly model = model<string | null | undefined>();
145
+
146
+ protected readonly search = async (req: SdSearchReq): Promise<ProductDto[]> => {
147
+ if (req.type === 'VALUE') {
148
+ const ids = (Array.isArray(req.value) ? req.value : [req.value]).filter((id): id is string => !!id);
149
+ return Promise.all(ids.map(id => firstValueFrom(this.#productService.cachedDetail(id))));
150
+ }
151
+ const filters: Filter<ProductDto>[] = [{ field: 'status', operator: 'EQUAL', data: 'active' }];
152
+ if (req.searchText) {
153
+ filters.push({
154
+ operator: 'OR',
155
+ data: [
156
+ { field: 'name', operator: 'CONTAIN', data: req.searchText },
157
+ { field: 'code', operator: 'CONTAIN', data: req.searchText },
158
+ ],
159
+ });
160
+ }
161
+ const res = await firstValueFrom(this.#productService.list({ pageNumber: 0, pageSize: 20, filters }));
162
+ return res.items;
163
+ };
164
+ }
165
+ ```
166
+
167
+ Enum: options và label thuộc model của feature:
168
+
169
+ <!-- @source features/product/components/product-status-select/product-status-select.component.ts -->
170
+ ```ts
171
+ import { ChangeDetectionStrategy, Component, input, model } from '@angular/core';
172
+ import type { FormGroup } from '@angular/forms';
173
+ import { SdSelect } from '@sdcorejs/angular/forms/select';
174
+ import { PRODUCT_STATUS_OPTIONS, type ProductStatus } from '../../services/product.model';
175
+
176
+ /** Dropdown trạng thái sản phẩm: options và label thuộc feature, nơi dùng chỉ bind model/form. */
177
+ @Component({
178
+ selector: 'product-status-select',
179
+ standalone: true,
180
+ imports: [SdSelect],
181
+ changeDetection: ChangeDetectionStrategy.OnPush,
182
+ template: `<sd-select
183
+ [label]="label()"
184
+ [name]="name()"
185
+ [form]="form()"
186
+ [(model)]="model"
187
+ [items]="options"
188
+ valueField="id"
189
+ displayField="name"
190
+ [required]="required()"
191
+ [clearable]="false" />`,
192
+ })
193
+ export class ProductStatusSelectComponent {
194
+ readonly form = input<FormGroup>();
195
+ readonly name = input('status');
196
+ readonly label = input('Trạng thái');
197
+ readonly required = input(true);
198
+ readonly model = model<ProductStatus | null | undefined>();
199
+ protected readonly options = PRODUCT_STATUS_OPTIONS;
200
+ }
201
+ ```
202
+
203
+ ## Quy tắc
204
+
205
+ - MUST đặt wrapper trong `components/` của feature sở hữu entity; màn dùng nó (đơn hàng) không tự gọi API của entity khác, không khai báo lại `items`, `valueField`, `displayField`.
206
+ - MUST tách lựa chọn mới (`SEARCH`, có điều kiện như đang hoạt động) với giá trị đã chọn (`VALUE`, tải theo ID kể cả bản ghi đã ngừng).
207
+ - MUST cấp service của entity ở route của màn dùng wrapper (`providers` của route đơn hàng có `CustomerService`, `ProductService`).
208
+ - MUST giữ option tối đa hai dòng: dòng đầu là tên, dòng hai là mã và thông tin phân biệt; trong bảng nhập liệu, giá trị đã chọn chỉ hiện gọn trong ô.
209
+ - SHOULD mở input của wrapper chỉ cho thứ nơi dùng cần (`form`, `name`, `model`, `required`, `label`).
210
+
211
+ ## Lỗi hay gặp
212
+
213
+ - Lọc bản ghi đang hoạt động ở client cho cả giá trị đã chọn: đơn của khách đã ngừng mở ra ô trống.
214
+ - Gọi `detail(id)` cho từng option: dùng kết quả tìm kiếm cho danh sách, chỉ tải theo ID cho giá trị đã chọn.