@sdcorejs/angular 22.3.3 → 22.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 (136) hide show
  1. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +489 -42
  2. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  3. package/fesm2022/sdcorejs-angular-components-table.mjs +1258 -114
  4. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  5. package/fesm2022/sdcorejs-angular-i18n.mjs +140 -5
  6. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  7. package/fesm2022/sdcorejs-angular-modules-layout.mjs +87 -5
  8. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  9. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-Cfmr0L_5.mjs → sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs} +2 -2
  10. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-Cfmr0L_5.mjs.map → sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs.map} +1 -1
  11. package/fesm2022/{sdcorejs-angular-modules-pattern-create-side-drawer.component-CxgmaNod.mjs → sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs} +18 -4
  12. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs.map +1 -0
  13. package/fesm2022/{sdcorejs-angular-modules-pattern-create-side-drawer.component-C7-itJqB.mjs → sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs} +18 -4
  14. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs.map +1 -0
  15. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-C2GdGhkJ.mjs → sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs} +19 -5
  16. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs.map +1 -0
  17. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-DIivNX4o.mjs → sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs} +2 -2
  18. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-DIivNX4o.mjs.map → sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs.map} +1 -1
  19. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-CzJh4LMR.mjs → sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs} +36 -12
  20. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs.map +1 -0
  21. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-B0nhFd_M.mjs → sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs} +2 -2
  22. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-B0nhFd_M.mjs.map → sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs.map} +1 -1
  23. package/fesm2022/{sdcorejs-angular-modules-pattern-detail-side-drawer.component-D1dqsKX0.mjs → sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs} +2 -2
  24. package/fesm2022/{sdcorejs-angular-modules-pattern-detail-side-drawer.component-D1dqsKX0.mjs.map → sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs.map} +1 -1
  25. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-WK0AcxNJ.mjs → sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs} +2 -2
  26. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-WK0AcxNJ.mjs.map → sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs.map} +1 -1
  27. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-Dkmm0a2Y.mjs → sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs} +28 -11
  28. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs.map +1 -0
  29. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-BvhEMUgY.mjs → sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs} +2 -2
  30. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-BvhEMUgY.mjs.map → sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs.map} +1 -1
  31. package/fesm2022/{sdcorejs-angular-modules-pattern-general-information-form.component-cxNRkeRU.mjs → sdcorejs-angular-modules-pattern-general-information-form.component-BJaYcNzf.mjs} +3 -3
  32. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BJaYcNzf.mjs.map +1 -0
  33. package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-D1zWXyN6.mjs → sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs} +4 -4
  34. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs.map +1 -0
  35. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs +836 -0
  36. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs.map +1 -0
  37. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CaXgC8wK.mjs → sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs} +2 -2
  38. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CaXgC8wK.mjs.map → sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs.map} +1 -1
  39. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-1Xn1WaAP.mjs → sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs} +3 -3
  40. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-1Xn1WaAP.mjs.map → sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs.map} +1 -1
  41. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-Bv_l7vnz.mjs → sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs} +2 -2
  42. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-Bv_l7vnz.mjs.map → sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs.map} +1 -1
  43. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-ChwTb4BU.mjs → sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs} +2 -2
  44. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-ChwTb4BU.mjs.map → sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs.map} +1 -1
  45. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-B6Ndq542.mjs → sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs} +2 -2
  46. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-B6Ndq542.mjs.map → sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs.map} +1 -1
  47. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-DKK3NmbN.mjs → sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs} +2 -2
  48. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-DKK3NmbN.mjs.map → sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs.map} +1 -1
  49. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs → sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs} +9 -2
  50. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +1 -0
  51. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs → sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs} +21 -19
  52. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +1 -0
  53. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-GSlXwL2Z.mjs → sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs} +2 -2
  54. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-GSlXwL2Z.mjs.map → sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs.map} +1 -1
  55. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-DPBwMafn.mjs → sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs} +2 -2
  56. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-DPBwMafn.mjs.map → sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs.map} +1 -1
  57. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B6z9lJYB.mjs → sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs} +3 -3
  58. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B6z9lJYB.mjs.map → sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs.map} +1 -1
  59. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-h66efEeH.mjs → sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs} +7 -7
  60. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-h66efEeH.mjs.map → sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs.map} +1 -1
  61. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DeThmv4f.mjs → sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs} +4 -4
  62. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DeThmv4f.mjs.map → sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs.map} +1 -1
  63. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-t3O2L2J5.mjs → sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs} +3 -3
  64. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-t3O2L2J5.mjs.map → sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs.map} +1 -1
  65. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-D1fsRfRB.mjs → sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs} +5 -5
  66. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-D1fsRfRB.mjs.map → sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs.map} +1 -1
  67. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DdCFCwxY.mjs → sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs} +3 -3
  68. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DdCFCwxY.mjs.map → sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs.map} +1 -1
  69. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-1kifjm82.mjs → sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs} +5 -5
  70. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-1kifjm82.mjs.map → sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs.map} +1 -1
  71. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-bQpdxKlY.mjs → sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs} +9 -9
  72. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-bQpdxKlY.mjs.map → sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs.map} +1 -1
  73. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-B6w4N6wo.mjs → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs} +12 -12
  74. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-B6w4N6wo.mjs.map → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs.map} +1 -1
  75. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-BIYHlzVQ.mjs → sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs} +4 -4
  76. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-BIYHlzVQ.mjs.map → sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs.map} +1 -1
  77. package/fesm2022/{sdcorejs-angular-modules-pattern-update-side-drawer.component-nnldn2cz.mjs → sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs} +4 -4
  78. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs.map +1 -0
  79. package/fesm2022/{sdcorejs-angular-modules-pattern-update-side-drawer.component-DKgmhJT2.mjs → sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs} +4 -4
  80. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs.map +1 -0
  81. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-p9R5-eou.mjs → sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs} +5 -5
  82. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs.map +1 -0
  83. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-C0Bewuwz.mjs → sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs} +22 -12
  84. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs.map +1 -0
  85. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-Qlh3Lm2p.mjs → sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs} +12 -10
  86. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs.map +1 -0
  87. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +1 -1
  88. package/fesm2022/sdcorejs-angular-services-api.mjs +11 -11
  89. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  90. package/fesm2022/sdcorejs-angular-services-cache.mjs +7 -5
  91. package/fesm2022/sdcorejs-angular-services-cache.mjs.map +1 -1
  92. package/fesm2022/sdcorejs-angular-services-storage.mjs +6 -4
  93. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  94. package/modules/pattern/docs/drawer.md +1 -1
  95. package/modules/pattern/docs/form.md +445 -148
  96. package/modules/pattern/docs/header-actions.md +14 -12
  97. package/modules/pattern/docs/select.md +9 -1
  98. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +8 -1
  99. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +1 -1
  100. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +8 -1
  101. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +1 -1
  102. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +1 -1
  103. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +124 -147
  104. package/modules/pattern/features/order/components/lines-form/order-lines.ts +101 -0
  105. package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.ts +196 -0
  106. package/modules/pattern/features/order/pages/create/create.component.ts +18 -4
  107. package/modules/pattern/features/order/pages/detail/detail.component.ts +14 -12
  108. package/modules/pattern/features/order/pages/update/update.component.ts +11 -4
  109. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +1 -1
  110. package/modules/pattern/features/product/components/product-select/product-select.component.ts +9 -1
  111. package/modules/pattern/features/product/pages/create/create.component.ts +8 -1
  112. package/modules/pattern/features/product/pages/update/update.component.ts +1 -1
  113. package/modules/pattern/features/settings/pages/update/update.component.ts +5 -4
  114. package/package.json +1 -1
  115. package/types/sdcorejs-angular-components-query-bar.d.ts +126 -11
  116. package/types/sdcorejs-angular-components-table.d.ts +174 -13
  117. package/types/sdcorejs-angular-i18n.d.ts +28 -1
  118. package/types/sdcorejs-angular-services-api.d.ts +5 -5
  119. package/types/sdcorejs-angular-services-cache.d.ts +4 -2
  120. package/types/sdcorejs-angular-services-storage.d.ts +3 -1
  121. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-C7-itJqB.mjs.map +0 -1
  122. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CxgmaNod.mjs.map +0 -1
  123. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-C2GdGhkJ.mjs.map +0 -1
  124. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CzJh4LMR.mjs.map +0 -1
  125. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-Dkmm0a2Y.mjs.map +0 -1
  126. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-cxNRkeRU.mjs.map +0 -1
  127. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-D1zWXyN6.mjs.map +0 -1
  128. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BK__9Mzb.mjs +0 -541
  129. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BK__9Mzb.mjs.map +0 -1
  130. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +0 -1
  131. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +0 -1
  132. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DKgmhJT2.mjs.map +0 -1
  133. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-nnldn2cz.mjs.map +0 -1
  134. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-C0Bewuwz.mjs.map +0 -1
  135. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Qlh3Lm2p.mjs.map +0 -1
  136. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-p9R5-eou.mjs.map +0 -1
@@ -1,6 +1,6 @@
1
1
  # Form
2
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).
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; thêm `?lines=sd-table` để xem cùng bảng dựng bằng `sd-table`), `/pattern/settings` (một bản ghi, nhiều nhóm, trạng thái lưu ở footer).
4
4
 
5
5
  ## Khi nào dùng / khi nào không
6
6
 
@@ -10,7 +10,7 @@ Tạo hoặc cập nhật một bản ghi trong một bước: `sd-page-form`. R
10
10
 
11
11
  ## Code mẫu
12
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`:
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`. Thân section là `row px-16 pt-16 pb-8`: field thẳng lề 16px với title của section; dưới hàng cuối còn chỗ dành cho lỗi của field, nên đáy chỉ cần 8px:
14
14
 
15
15
  <!-- @source features/product/components/general-information-form/general-information-form.component.ts -->
16
16
  ```ts
@@ -50,7 +50,7 @@ export function productSaveReq(form: ProductForm, code?: string): ProductSaveReq
50
50
  imports: [SdInput, SdInputNumber, SdSection, ProductStatusSelectComponent],
51
51
  changeDetection: ChangeDetectionStrategy.OnPush,
52
52
  template: `<sd-section title="Thông tin chung">
53
- <div class="row p-8">
53
+ <div class="row px-16 pt-16 pb-8">
54
54
  <div class="col-12 col-md-6">
55
55
  <sd-input
56
56
  label="Mã sản phẩm"
@@ -104,7 +104,7 @@ export class GeneralInformationFormComponent {
104
104
  }
105
105
  ```
106
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`:
107
+ Trang tạo: Huỷ · Tạo sản phẩm ở `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
108
 
109
109
  <!-- @source features/product/pages/create/create.component.ts -->
110
110
  ```ts
@@ -136,7 +136,14 @@ import type { ProductSaveReq } from '../../services/product.model';
136
136
  <sd-page-form title="Tạo mới sản phẩm" [backLink]="['..']">
137
137
  <div headerRight class="d-flex align-items-center gap-8">
138
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()" />
139
+ <sd-button
140
+ title="Tạo sản phẩm"
141
+ prefixIcon="save"
142
+ type="fill"
143
+ color="primary"
144
+ autoId="product-save"
145
+ [loading]="saving()"
146
+ (click)="save()" />
140
147
  </div>
141
148
  <div class="py-16">
142
149
  <general-information-form [form]="form" [seed]="seed" [errors]="apiErrors.errors()" />
@@ -228,7 +235,7 @@ import type { ProductDto } from '../../services/product.model';
228
235
  <sd-page-form [title]="'Cập nhật sản phẩm #' + entity().code" [backLink]="['../detail']">
229
236
  <div headerRight class="d-flex align-items-center gap-8">
230
237
  <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()" />
238
+ <sd-button title="Lưu" prefixIcon="save" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
232
239
  </div>
233
240
  <div class="py-16">
234
241
  <general-information-form [form]="form" [seed]="entity()" [editing]="true" [errors]="apiErrors.errors()" />
@@ -287,32 +294,132 @@ export class UpdateComponent {
287
294
  }
288
295
  ```
289
296
 
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:
297
+ Dòng hàng nhập trực tiếp: trạng thái của dòng (FormArray `form.lines`, thành tiền, tổng, chọn sản phẩm thì điền đơn giá) nằm trong một hàm dùng chung cho hai cách dựng bảng bên dưới:
291
298
 
292
- <!-- @source features/order/components/lines-form/lines-form.component.ts -->
299
+ <!-- @source features/order/components/lines-form/order-lines.ts -->
293
300
  ```ts
294
- import { ChangeDetectionStrategy, Component, computed, DestroyRef, effect, inject, input, signal, untracked } from '@angular/core';
301
+ import { computed, DestroyRef, effect, inject, signal, untracked, type Signal } from '@angular/core';
295
302
  import { FormArray, FormGroup } from '@angular/forms';
296
303
  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
304
  import { ProductService } from '../../../product/services/product.service';
303
305
  import type { OrderLineDto } from '../../services/order.model';
304
306
  import type { OrderForm } from '../general-information-form/general-information-form.component';
305
307
 
306
- interface LineRow {
308
+ /** Một dòng đang nhập: field Core của dòng tự đăng ký vào `group`; `seed` là giá trị ban đầu của dòng. */
309
+ export interface OrderLineRow {
307
310
  readonly key: number;
308
311
  readonly group: FormGroup;
309
312
  readonly seed: OrderLineDto;
310
313
  }
311
314
 
315
+ export interface OrderLines {
316
+ readonly rows: Signal<readonly OrderLineRow[]>;
317
+ /** Thành tiền theo thứ tự của `rows`. */
318
+ readonly amounts: Signal<readonly number[]>;
319
+ readonly total: Signal<number>;
320
+ add(): void;
321
+ remove(row: OrderLineRow): void;
322
+ /** Chọn sản phẩm thì điền đơn giá hiện hành của sản phẩm. */
323
+ pick(row: OrderLineRow, productId: string | null | undefined): Promise<void>;
324
+ /** Gắn `form.lines` vào form khi field của các dòng vừa nạp đã đăng ký; gọi lại khi đã gắn thì không làm gì. */
325
+ attach(): void;
326
+ }
327
+
312
328
  /**
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 đó.
329
+ * Dòng hàng của form đơn: mỗi dòng là một FormGroup trong `form.lines` (FormArray). Thành tiền và tổng tính lại khi
330
+ * giá trị đổi. `lines-form` (bảng HTML) và `lines-table-form` (`sd-table`) dùng chung, chỉ khác phần hiển thị.
331
+ * Gọi trong injection context của component.
332
+ *
333
+ * `registerSdUnsavedChangesForm(..., { dirty: 'value' })` lấy giá trị của một control lúc nó vào form làm giá trị đã
334
+ * lưu, nên `form.lines` chỉ vào form khi field của các dòng đã đăng ký; vào sớm hơn thì form vừa mở đã bị coi là có
335
+ * thay đổi. `<table>` vẽ dòng ngay trong lượt change detection đó (`attach: 'now'`); `sd-table` vẽ dòng sau lần đọc
336
+ * đầu, nên `lines-table-form` dùng `attach: 'manual'` rồi gọi `attach()` khi bảng đã vẽ.
337
+ */
338
+ export function orderLines(
339
+ form: Signal<OrderForm>,
340
+ seed: Signal<readonly OrderLineDto[]>,
341
+ options: { readonly attach: 'now' | 'manual' } = { attach: 'now' }
342
+ ): OrderLines {
343
+ const productService = inject(ProductService);
344
+ const array = new FormArray<FormGroup>([]);
345
+ const version = signal(0);
346
+ const rows = signal<readonly OrderLineRow[]>([]);
347
+ let nextKey = 0;
348
+
349
+ const attach = (): void => {
350
+ if (form().get('lines') !== array) form().setControl('lines', array);
351
+ };
352
+ const push = (line: OrderLineDto): void => {
353
+ const group = new FormGroup({});
354
+ array.push(group);
355
+ rows.update(items => [...items, { key: nextKey++, group, seed: line }]);
356
+ };
357
+ const load = (lines: readonly OrderLineDto[]): void => {
358
+ // why: gỡ ra rồi gắn lại, để giá trị đã lưu của `lines` là các dòng mới chứ không phải dòng của đơn trước.
359
+ if (form().get('lines') === array) form().removeControl('lines');
360
+ array.clear();
361
+ rows.set([]);
362
+ (lines.length ? lines : [{ productId: '', quantity: 1, unitPrice: 0 }]).forEach(push);
363
+ if (options.attach === 'now') attach();
364
+ };
365
+
366
+ const subscription = array.valueChanges.subscribe(() => version.update(value => value + 1));
367
+ inject(DestroyRef).onDestroy(() => subscription.unsubscribe());
368
+ // 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.
369
+ effect(() => {
370
+ const lines = seed();
371
+ untracked(() => load(lines));
372
+ });
373
+
374
+ const amounts = computed(() => {
375
+ version();
376
+ return rows().map(
377
+ row => Number(row.group.get('quantity')?.value ?? row.seed.quantity) * Number(row.group.get('unitPrice')?.value ?? row.seed.unitPrice)
378
+ );
379
+ });
380
+
381
+ return {
382
+ rows: rows.asReadonly(),
383
+ amounts,
384
+ total: computed(() => amounts().reduce((sum, amount) => sum + amount, 0)),
385
+ add: () => push({ productId: '', quantity: 1, unitPrice: 0 }),
386
+ remove: row => {
387
+ const index = rows().indexOf(row);
388
+ if (index < 0) return;
389
+ // 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.
390
+ array.markAsDirty();
391
+ array.removeAt(index);
392
+ rows.update(items => items.filter(item => item !== row));
393
+ },
394
+ pick: async (row, productId) => {
395
+ if (!productId) return;
396
+ const product = await firstValueFrom(productService.cachedDetail(productId));
397
+ row.group.get('unitPrice')?.setValue(product.price);
398
+ },
399
+ attach,
400
+ };
401
+ }
402
+ ```
403
+
404
+ Bảng dựng bằng `<table>`: field trong ô dùng `size="sm"` và `hideInlineError`, mọi ô căn giữa theo chiều dọc, lỗi của API là icon kèm tooltip trên đúng ô nên dòng không cao thêm:
405
+
406
+ <!-- @source features/order/components/lines-form/lines-form.component.ts -->
407
+ ```ts
408
+ import { ChangeDetectionStrategy, Component, input } from '@angular/core';
409
+ import { SdButton } from '@sdcorejs/angular/components/button';
410
+ import { SdSection } from '@sdcorejs/angular/components/section';
411
+ import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
412
+ import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
413
+ import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
414
+ import type { OrderLineDto } from '../../services/order.model';
415
+ import type { OrderForm } from '../general-information-form/general-information-form.component';
416
+ import { orderLines } from './order-lines';
417
+
418
+ /**
419
+ * Bảng dòng hàng nhập trực tiếp, dựng bằng `<table>`: mỗi dòng là một FormGroup trong `form.lines` (FormArray, do
420
+ * `orderLines()` quản lý), các field Core tự đăng ký vào dòng. Chọn sản phẩm điền đơn giá; thành tiền và tổng tự
421
+ * tính. Field trong ô dùng `size="sm"` và `hideInlineError`: lỗi, kể cả lỗi API theo dòng (`lines.<i>.<field>`), là
422
+ * icon kèm tooltip ngay trên ô đó, dòng không cao thêm. Cùng bảng dựng bằng `sd-table`: `lines-table-form`.
316
423
  */
317
424
  @Component({
318
425
  selector: 'lines-form',
@@ -322,87 +429,129 @@ interface LineRow {
322
429
  template: `
323
430
  <sd-section title="Dòng hàng">
324
431
  <div sdHeaderRight>
325
- <sd-button title="Thêm dòng" prefixIcon="add" type="text" autoId="order-line-add" (click)="add()" />
432
+ <sd-button title="Thêm dòng" prefixIcon="add" type="text" autoId="order-line-add" (click)="lines.add()" />
326
433
  </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>
434
+ <div class="lines-scroll">
435
+ <table class="lines">
436
+ <colgroup>
437
+ <col />
438
+ <col class="lines__quantity" />
439
+ <col class="lines__money" />
440
+ <col class="lines__money" />
441
+ <col class="lines__action" />
442
+ </colgroup>
443
+ <thead>
444
+ <tr>
445
+ <th scope="col">Sản phẩm <span class="text-error" aria-hidden="true">*</span></th>
446
+ <th scope="col" class="lines__number">Số lượng <span class="text-error" aria-hidden="true">*</span></th>
447
+ <th scope="col" class="lines__number">Đơn giá (₫) <span class="text-error" aria-hidden="true">*</span></th>
448
+ <th scope="col" class="lines__number">Thành tiền (₫)</th>
449
+ <th scope="col" class="lines__action"><span class="sd-visually-hidden">Xoá dòng</span></th>
383
450
  </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>
451
+ </thead>
452
+ <tbody>
453
+ @for (row of lines.rows(); track row.key; let index = $index) {
454
+ <tr [attr.data-line]="index">
455
+ <td>
456
+ <product-select
457
+ size="sm"
458
+ hideInlineError
459
+ [label]="undefined"
460
+ [form]="row.group"
461
+ [model]="row.seed.productId || null"
462
+ [inlineError]="errors()['lines.' + index + '.productId']"
463
+ [autoId]="'order-line-' + index + '-product'"
464
+ (modelChange)="lines.pick(row, $event)"
465
+ required />
466
+ </td>
467
+ <td class="lines__number">
468
+ <sd-input-number
469
+ name="quantity"
470
+ size="sm"
471
+ hideInlineError
472
+ type="positive"
473
+ [precision]="0"
474
+ [form]="row.group"
475
+ [model]="row.seed.quantity"
476
+ [inlineError]="errors()['lines.' + index + '.quantity']"
477
+ [autoId]="'order-line-' + index + '-quantity'"
478
+ required />
479
+ </td>
480
+ <td class="lines__number">
481
+ <sd-input-number
482
+ name="unitPrice"
483
+ size="sm"
484
+ hideInlineError
485
+ type="positive"
486
+ [precision]="0"
487
+ [form]="row.group"
488
+ [model]="row.seed.unitPrice"
489
+ [inlineError]="errors()['lines.' + index + '.unitPrice']"
490
+ [autoId]="'order-line-' + index + '-unit-price'"
491
+ required />
492
+ </td>
493
+ <td class="lines__number" [attr.data-autoid]="'order-line-' + index + '-amount'">
494
+ {{ lines.amounts()[index] | sdFormatNumber: 0 }}
495
+ </td>
496
+ <td class="lines__action">
497
+ <sd-button
498
+ prefixIcon="delete"
499
+ type="text"
500
+ color="error"
501
+ tooltip="Xoá dòng"
502
+ [autoId]="'order-line-' + index + '-remove'"
503
+ [disabled]="lines.rows().length === 1"
504
+ (click)="lines.remove(row)" />
505
+ </td>
506
+ </tr>
507
+ }
508
+ </tbody>
509
+ <tfoot>
510
+ <tr>
511
+ <th scope="row" colspan="3" class="lines__number">Tổng tiền (₫)</th>
512
+ <td class="lines__number lines__total" data-autoid="order-total">{{ lines.total() | sdFormatNumber: 0 }}</td>
513
+ <td class="lines__action"></td>
514
+ </tr>
515
+ </tfoot>
516
+ </table>
517
+ </div>
394
518
  </sd-section>
395
519
  `,
396
520
  styles: `
521
+ /* Màn hẹp thì cuộn ngang trong section thay vì bóp cột sản phẩm. */
522
+ .lines-scroll {
523
+ overflow-x: auto;
524
+ }
525
+ /* Cột cố định, sản phẩm lấy phần còn lại: vừa thân 576px của sd-page-form. */
397
526
  .lines {
398
527
  width: 100%;
528
+ min-width: 544px;
399
529
  border-collapse: collapse;
530
+ table-layout: fixed;
531
+ }
532
+ .lines__quantity {
533
+ width: 88px;
534
+ }
535
+ .lines__money {
536
+ width: 120px;
537
+ }
538
+ .lines__action {
539
+ width: 48px;
400
540
  }
401
541
  .lines th,
402
542
  .lines td {
403
- padding: 4px 8px;
543
+ padding: 8px;
404
544
  text-align: left;
405
- vertical-align: top;
545
+ vertical-align: middle;
546
+ }
547
+ /* Cột đầu và cuối thẳng lề 16px với title và nút "Thêm dòng" của section. */
548
+ .lines th:first-child,
549
+ .lines td:first-child {
550
+ padding-left: 16px;
551
+ }
552
+ .lines th:last-child,
553
+ .lines td:last-child {
554
+ padding-right: 16px;
406
555
  }
407
556
  .lines thead th {
408
557
  color: var(--sd-text-secondary);
@@ -410,103 +559,249 @@ interface LineRow {
410
559
  font-weight: 500;
411
560
  border-bottom: 1px solid var(--sd-border);
412
561
  }
413
- .lines td:first-child {
414
- min-width: 240px;
562
+ .lines tbody tr:first-child td {
563
+ padding-top: 12px;
564
+ }
565
+ .lines tbody tr:last-child td {
566
+ padding-bottom: 12px;
415
567
  }
416
568
  .lines__number {
417
- width: 150px;
418
569
  text-align: right !important;
419
570
  }
420
- .lines td.lines__number {
421
- padding-top: 14px;
422
- }
423
571
  .lines tfoot th,
424
572
  .lines tfoot td {
425
573
  padding-top: 12px;
574
+ padding-bottom: 12px;
426
575
  border-top: 1px solid var(--sd-border);
427
576
  }
428
577
  .lines__total {
429
578
  font-weight: 500;
430
579
  }
431
- .lines__error {
432
- color: var(--sd-error, currentColor);
433
- font-size: 12px;
434
- }
435
580
  `,
436
581
  })
437
582
  export class LinesFormComponent {
438
- readonly #productService = inject(ProductService);
439
583
  readonly form = input.required<OrderForm>();
440
584
  /** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
441
585
  readonly seed = input.required<readonly OrderLineDto[]>();
442
586
  /** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
443
587
  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
- }
588
+ protected readonly lines = orderLines(this.form, this.seed);
589
+ }
590
+ ```
469
591
 
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
- }
592
+ Cùng dòng hàng dựng bằng `sd-table` (`/pattern/order/create?lines=sd-table`): nút thêm dòng ở header cột command (`sdTableCommandHeaderDef`), xoá dòng là command của bảng, số dòng và tổng tiền dưới bảng. Dòng đổi thì `reload()` bảng; `rowKey` giữ view của các dòng còn lại nên giá trị đang nhập không mất. `sd-table` vẽ dòng sau lần đọc đầu, nên `form.lines` chỉ vào form khi bảng đã vẽ (`attach: 'manual'` rồi `attach()` từ `reload.onReload`):
478
593
 
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
- }
594
+ <!-- @source features/order/components/lines-table-form/lines-table-form.component.ts -->
595
+ ```ts
596
+ import { afterNextRender, ChangeDetectionStrategy, Component, effect, inject, Injector, input, untracked, viewChild } from '@angular/core';
597
+ import { SdButton } from '@sdcorejs/angular/components/button';
598
+ import { SdSection } from '@sdcorejs/angular/components/section';
599
+ import {
600
+ SdTable,
601
+ SdTableCellDefDirective,
602
+ SdTableCommandHeaderDefDirective,
603
+ SdTableTitleDefDirective,
604
+ type SdTableOption,
605
+ } from '@sdcorejs/angular/components/table';
606
+ import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
607
+ import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
608
+ import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
609
+ import type { OrderLineDto } from '../../services/order.model';
610
+ import type { OrderForm } from '../general-information-form/general-information-form.component';
611
+ import { orderLines, type OrderLineRow } from '../lines-form/order-lines';
612
+
613
+ /** Dòng của `sd-table`: dòng form cộng tên các cột. Ô của mọi cột vẽ bằng `sdTableCellDef` từ `group`/`seed`. */
614
+ interface LineItem extends OrderLineRow {
615
+ readonly productId?: string;
616
+ readonly quantity?: number;
617
+ readonly unitPrice?: number;
618
+ readonly amount?: number;
619
+ }
485
620
 
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
- }
621
+ /**
622
+ * Dòng hàng nhập trực tiếp, dựng bằng `sd-table` thay cho `<table>` của `lines-form`; trạng thái dòng vẫn là
623
+ * `orderLines()`. Bảng local, không phân trang, không lọc. Nút thêm dòng nằm ở header cột command
624
+ * (`sdTableCommandHeaderDef`), ngay trên nút xoá của từng dòng; field trong ô dùng `size="sm"` và `hideInlineError`,
625
+ * cột bắt buộc có `*` ở title; số dòng và tổng tiền ở dưới bảng. Dòng đổi thì `reload()` bảng; `rowKey` giữ view
626
+ * của các dòng còn lại nên giá trị đang nhập không mất. `form.lines` chỉ vào form khi bảng đã vẽ dòng (`attach`).
627
+ */
628
+ @Component({
629
+ selector: 'lines-table-form',
630
+ standalone: true,
631
+ imports: [
632
+ SdSection,
633
+ SdButton,
634
+ SdTable,
635
+ SdTableCellDefDirective,
636
+ SdTableCommandHeaderDefDirective,
637
+ SdTableTitleDefDirective,
638
+ SdInputNumber,
639
+ SdFormatNumberPipe,
640
+ ProductSelectComponent,
641
+ ],
642
+ changeDetection: ChangeDetectionStrategy.OnPush,
643
+ template: `
644
+ <sd-section title="Dòng hàng">
645
+ <sd-table autoId="order-lines" [option]="option">
646
+ <ng-template sdTableCommandHeaderDef>
647
+ <sd-button
648
+ tooltip="Thêm dòng"
649
+ prefixIcon="add"
650
+ size="sm"
651
+ type="light"
652
+ color="primary"
653
+ autoId="order-line-add"
654
+ (click)="lines.add()" />
655
+ </ng-template>
656
+ <ng-template sdTableTitleDef="productId">Sản phẩm <span class="text-error" aria-hidden="true">*</span></ng-template>
657
+ <ng-template sdTableTitleDef="quantity">Số lượng <span class="text-error" aria-hidden="true">*</span></ng-template>
658
+ <ng-template sdTableTitleDef="unitPrice">Đơn giá (₫) <span class="text-error" aria-hidden="true">*</span></ng-template>
659
+ <ng-template sdTableCellDef="productId" let-row="item">
660
+ @let index = lines.rows().indexOf(row);
661
+ <product-select
662
+ class="lines-table__input"
663
+ size="sm"
664
+ hideInlineError
665
+ [label]="undefined"
666
+ [form]="row.group"
667
+ [model]="row.seed.productId || null"
668
+ [inlineError]="errors()['lines.' + index + '.productId']"
669
+ [autoId]="'order-line-' + index + '-product'"
670
+ (modelChange)="lines.pick(row, $event)"
671
+ required />
672
+ </ng-template>
673
+ <ng-template sdTableCellDef="quantity" let-row="item">
674
+ @let index = lines.rows().indexOf(row);
675
+ <sd-input-number
676
+ class="lines-table__input"
677
+ name="quantity"
678
+ size="sm"
679
+ hideInlineError
680
+ type="positive"
681
+ [precision]="0"
682
+ [form]="row.group"
683
+ [model]="row.seed.quantity"
684
+ [inlineError]="errors()['lines.' + index + '.quantity']"
685
+ [autoId]="'order-line-' + index + '-quantity'"
686
+ required />
687
+ </ng-template>
688
+ <ng-template sdTableCellDef="unitPrice" let-row="item">
689
+ @let index = lines.rows().indexOf(row);
690
+ <sd-input-number
691
+ class="lines-table__input"
692
+ name="unitPrice"
693
+ size="sm"
694
+ hideInlineError
695
+ type="positive"
696
+ [precision]="0"
697
+ [form]="row.group"
698
+ [model]="row.seed.unitPrice"
699
+ [inlineError]="errors()['lines.' + index + '.unitPrice']"
700
+ [autoId]="'order-line-' + index + '-unit-price'"
701
+ required />
702
+ </ng-template>
703
+ <ng-template sdTableCellDef="amount" let-row="item">
704
+ @let index = lines.rows().indexOf(row);
705
+ <strong class="lines-table__amount" [attr.data-autoid]="'order-line-' + index + '-amount'">
706
+ {{ lines.amounts()[index] | sdFormatNumber: 0 }}
707
+ </strong>
708
+ </ng-template>
709
+ </sd-table>
710
+ <div class="lines-table__summary">
711
+ <span>{{ lines.rows().length }} dòng hàng</span>
712
+ <strong
713
+ >Tổng tiền: <span data-autoid="order-total">{{ lines.total() | sdFormatNumber: 0 }}</span> ₫</strong
714
+ >
715
+ </div>
716
+ </sd-section>
717
+ `,
718
+ styles: `
719
+ /* Field trong dòng: 6px trên dưới để dòng 44px vẫn thoáng. */
720
+ .lines-table__input {
721
+ display: block;
722
+ padding-block: 6px;
723
+ }
724
+ .lines-table__amount {
725
+ display: block;
726
+ text-align: right;
727
+ font-variant-numeric: tabular-nums;
728
+ }
729
+ .lines-table__summary {
730
+ display: flex;
731
+ justify-content: space-between;
732
+ gap: 8px;
733
+ padding: 12px 16px;
734
+ color: var(--sd-text-secondary);
735
+ }
736
+ .lines-table__summary strong {
737
+ color: var(--sd-text);
738
+ }
739
+ `,
740
+ })
741
+ export class LinesTableFormComponent {
742
+ readonly form = input.required<OrderForm>();
743
+ /** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
744
+ readonly seed = input.required<readonly OrderLineDto[]>();
745
+ /** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
746
+ readonly errors = input<Readonly<Record<string, string>>>({});
747
+ readonly #injector = inject(Injector);
748
+ private readonly table = viewChild(SdTable<LineItem>);
749
+ protected readonly lines = orderLines(this.form, this.seed, { attach: 'manual' });
750
+ protected readonly option: SdTableOption<LineItem> = {
751
+ type: 'local',
752
+ items: () => [...this.lines.rows()],
753
+ rowKey: 'key',
754
+ filter: { disabled: true },
755
+ paginate: { hidden: true, pageSize: 200 },
756
+ reload: {
757
+ visible: false,
758
+ // why: sd-table vẽ dòng sau lần đọc; field trong ô đăng ký xong thì mới gắn `form.lines` (xem `orderLines`).
759
+ onReload: () => {
760
+ afterNextRender(() => this.lines.attach(), { injector: this.#injector });
761
+ },
762
+ },
763
+ config: { visible: false },
764
+ columns: [
765
+ { field: 'productId', title: 'Sản phẩm', type: 'string', minWidth: '180px' },
766
+ { field: 'quantity', title: 'Số lượng', type: 'number', width: '88px' },
767
+ { field: 'unitPrice', title: 'Đơn giá (₫)', type: 'number', width: '120px' },
768
+ { field: 'amount', title: 'Thành tiền (₫)', type: 'number', width: '120px', align: 'right' },
769
+ ],
770
+ command: {
771
+ commands: [
772
+ {
773
+ title: 'Xoá dòng',
774
+ icon: 'delete',
775
+ color: 'error',
776
+ disabled: () => this.lines.rows().length === 1,
777
+ click: row => this.lines.remove(row),
778
+ },
779
+ ],
780
+ },
781
+ };
492
782
 
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 }]);
783
+ constructor() {
784
+ // why: bảng local chỉ đọc `items` khi tải; thêm, xoá dòng hay nạp đơn khác đều phải `reload()` để vẽ lại. Gọi sau
785
+ // lượt render, khi `option` của bảng đã được gán.
786
+ effect(() => {
787
+ this.lines.rows();
788
+ untracked(() => afterNextRender(() => void this.table()?.reload(), { injector: this.#injector }));
789
+ });
497
790
  }
498
791
  }
499
792
  ```
500
793
 
501
794
  ## Quy tắc
502
795
 
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.
796
+ - MUST đặt Huỷ (outline) và nút lưu (fill, primary) ở `headerRight` của `sd-page-form` (E3); không lặp nút lưu ở cuối thân.
797
+ - SHOULD cho nút lưu icon `save`; trang tạo ghi rõ hành động ("Tạo đơn hàng"), trang cập nhật ghi "Lưu".
504
798
  - MUST đặt title "Tạo mới <entity>" hoặc "Cập nhật <entity> #<mã>" (E5).
505
799
  - 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
800
  - 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
801
  - 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
802
  - 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
803
  - MUST không khai báo trước FormControl trùng tên với field Core tự đăng ký.
804
+ - MUST dùng `size="sm"` và `hideInlineError` cho field trong ô của bảng dòng, dù bảng là `<table>` hay `sd-table`; field trong ô không có label, cột bắt buộc có `*` màu error sau title.
510
805
  - 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
806
  - 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
807
 
@@ -516,3 +811,5 @@ export class LinesFormComponent {
516
811
  - 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
812
  - Đ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
813
  - 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.
814
+ - Gắn FormArray dòng hàng vào form trước khi field của các dòng đăng ký xong (`sd-table` vẽ dòng sau lần đọc đầu): `dirty: 'value'` lấy dòng còn trống làm giá trị đã lưu, form vừa mở đã hỏi "Rời trang khi chưa lưu?".
815
+ - Để field trong ô bảng ở cỡ `md` và lỗi hiện dưới field: ô số và select cao khác nhau, dòng có lỗi cao hơn các dòng khác, cột thành tiền và nút xoá lệch dòng.