@sdcorejs/angular 20.3.3 → 20.3.5

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 (152) hide show
  1. package/components/modal/index.d.ts +6 -1
  2. package/components/query-bar/index.d.ts +154 -13
  3. package/components/table/index.d.ts +448 -29
  4. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +5 -5
  5. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  6. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +1 -1
  7. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  8. package/fesm2022/sdcorejs-angular-components-modal.mjs +46 -10
  9. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  10. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +520 -82
  11. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  12. package/fesm2022/sdcorejs-angular-components-table.mjs +6277 -3396
  13. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  14. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +1 -1
  15. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  16. package/fesm2022/sdcorejs-angular-forms-select.mjs +23 -4
  17. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  18. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  19. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  20. package/fesm2022/sdcorejs-angular-i18n.mjs +330 -5
  21. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  22. package/fesm2022/sdcorejs-angular-modules-layout.mjs +97 -11
  23. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  24. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-BubUwgBK.mjs → sdcorejs-angular-modules-pattern-base-api.service-okZVmcd5.mjs} +2 -2
  25. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-BubUwgBK.mjs.map → sdcorejs-angular-modules-pattern-base-api.service-okZVmcd5.mjs.map} +1 -1
  26. package/fesm2022/{sdcorejs-angular-modules-pattern-create-side-drawer.component-s7ZXoakT.mjs → sdcorejs-angular-modules-pattern-create-side-drawer.component-CB4F9cBe.mjs} +18 -4
  27. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CB4F9cBe.mjs.map +1 -0
  28. package/fesm2022/{sdcorejs-angular-modules-pattern-create-side-drawer.component-C9WQdsEi.mjs → sdcorejs-angular-modules-pattern-create-side-drawer.component-CowdEzyv.mjs} +18 -4
  29. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CowdEzyv.mjs.map +1 -0
  30. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-BxfQux1Q.mjs → sdcorejs-angular-modules-pattern-create.component-2-dyjvCH.mjs} +19 -5
  31. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-2-dyjvCH.mjs.map +1 -0
  32. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-DlYVJqHo.mjs → sdcorejs-angular-modules-pattern-create.component-BCoG3bVV.mjs} +36 -12
  33. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BCoG3bVV.mjs.map +1 -0
  34. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-D4GrcahQ.mjs → sdcorejs-angular-modules-pattern-create.component-LPUj7MqG.mjs} +2 -2
  35. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-D4GrcahQ.mjs.map → sdcorejs-angular-modules-pattern-create.component-LPUj7MqG.mjs.map} +1 -1
  36. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-Bfx6_CmA.mjs → sdcorejs-angular-modules-pattern-customer.service-Caua6Xto.mjs} +2 -2
  37. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-Bfx6_CmA.mjs.map → sdcorejs-angular-modules-pattern-customer.service-Caua6Xto.mjs.map} +1 -1
  38. package/fesm2022/{sdcorejs-angular-modules-pattern-detail-side-drawer.component-3PUIy1Vi.mjs → sdcorejs-angular-modules-pattern-detail-side-drawer.component-Bu6E63bN.mjs} +2 -2
  39. package/fesm2022/{sdcorejs-angular-modules-pattern-detail-side-drawer.component-3PUIy1Vi.mjs.map → sdcorejs-angular-modules-pattern-detail-side-drawer.component-Bu6E63bN.mjs.map} +1 -1
  40. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-c__NdSt3.mjs → sdcorejs-angular-modules-pattern-detail.component-B2Y0PbbC.mjs} +27 -10
  41. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B2Y0PbbC.mjs.map +1 -0
  42. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CbYMo3D1.mjs → sdcorejs-angular-modules-pattern-detail.component-_c_4slgf.mjs} +2 -2
  43. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CbYMo3D1.mjs.map → sdcorejs-angular-modules-pattern-detail.component-_c_4slgf.mjs.map} +1 -1
  44. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-Bjvq6wJz.mjs → sdcorejs-angular-modules-pattern-flow.component-C_HziBQN.mjs} +2 -2
  45. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-Bjvq6wJz.mjs.map → sdcorejs-angular-modules-pattern-flow.component-C_HziBQN.mjs.map} +1 -1
  46. package/fesm2022/{sdcorejs-angular-modules-pattern-general-information-form.component-pqT7lnS6.mjs → sdcorejs-angular-modules-pattern-general-information-form.component-BttbZ_yr.mjs} +3 -3
  47. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BttbZ_yr.mjs.map +1 -0
  48. package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-DZXPZuM4.mjs → sdcorejs-angular-modules-pattern-index.component-B2dNqckm.mjs} +4 -4
  49. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-B2dNqckm.mjs.map +1 -0
  50. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-Dq8Q8Vfm.mjs +812 -0
  51. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-Dq8Q8Vfm.mjs.map +1 -0
  52. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-DkVrMSPZ.mjs → sdcorejs-angular-modules-pattern-list.component-B3-th1z4.mjs} +2 -2
  53. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-DkVrMSPZ.mjs.map → sdcorejs-angular-modules-pattern-list.component-B3-th1z4.mjs.map} +1 -1
  54. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-Bf9QWXBp.mjs → sdcorejs-angular-modules-pattern-list.component-Bs9hhMr7.mjs} +2 -2
  55. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-Bf9QWXBp.mjs.map → sdcorejs-angular-modules-pattern-list.component-Bs9hhMr7.mjs.map} +1 -1
  56. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CuDjsIzi.mjs → sdcorejs-angular-modules-pattern-list.component-CRttQEXa.mjs} +2 -2
  57. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CuDjsIzi.mjs.map → sdcorejs-angular-modules-pattern-list.component-CRttQEXa.mjs.map} +1 -1
  58. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-DkxheDVz.mjs → sdcorejs-angular-modules-pattern-list.component-CeX57FPi.mjs} +3 -3
  59. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-DkxheDVz.mjs.map → sdcorejs-angular-modules-pattern-list.component-CeX57FPi.mjs.map} +1 -1
  60. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-E8rkFCkK.mjs → sdcorejs-angular-modules-pattern-list.component-DS8A17mM.mjs} +2 -2
  61. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-E8rkFCkK.mjs.map → sdcorejs-angular-modules-pattern-list.component-DS8A17mM.mjs.map} +1 -1
  62. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-DgmM-wTI.mjs → sdcorejs-angular-modules-pattern-mock-backend.factory-Dfil91qL.mjs} +2 -2
  63. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-DgmM-wTI.mjs.map → sdcorejs-angular-modules-pattern-mock-backend.factory-Dfil91qL.mjs.map} +1 -1
  64. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs → sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs} +9 -2
  65. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +1 -0
  66. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs → sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs} +21 -19
  67. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +1 -0
  68. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-C3coYwmZ.mjs → sdcorejs-angular-modules-pattern-product.service-PaIGZ1ve.mjs} +2 -2
  69. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-C3coYwmZ.mjs.map → sdcorejs-angular-modules-pattern-product.service-PaIGZ1ve.mjs.map} +1 -1
  70. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-YsWsrKWJ.mjs → sdcorejs-angular-modules-pattern-profile.component-B8j8cieu.mjs} +2 -2
  71. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-YsWsrKWJ.mjs.map → sdcorejs-angular-modules-pattern-profile.component-B8j8cieu.mjs.map} +1 -1
  72. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-BfpsCkim.mjs → sdcorejs-angular-modules-pattern-routes-0Vh73aXL.mjs} +3 -3
  73. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-BfpsCkim.mjs.map → sdcorejs-angular-modules-pattern-routes-0Vh73aXL.mjs.map} +1 -1
  74. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-dBuQqYkO.mjs → sdcorejs-angular-modules-pattern-routes-BoB2usST.mjs} +3 -3
  75. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-dBuQqYkO.mjs.map → sdcorejs-angular-modules-pattern-routes-BoB2usST.mjs.map} +1 -1
  76. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-CGeqkySv.mjs → sdcorejs-angular-modules-pattern-routes-CFLETqYK.mjs} +5 -5
  77. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-CGeqkySv.mjs.map → sdcorejs-angular-modules-pattern-routes-CFLETqYK.mjs.map} +1 -1
  78. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-C7b5dRrJ.mjs → sdcorejs-angular-modules-pattern-routes-CFT9DyKj.mjs} +9 -9
  79. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-C7b5dRrJ.mjs.map → sdcorejs-angular-modules-pattern-routes-CFT9DyKj.mjs.map} +1 -1
  80. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-9ujH01cX.mjs → sdcorejs-angular-modules-pattern-routes-CZusLcS3.mjs} +7 -7
  81. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-9ujH01cX.mjs.map → sdcorejs-angular-modules-pattern-routes-CZusLcS3.mjs.map} +1 -1
  82. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-rR-MpQFh.mjs → sdcorejs-angular-modules-pattern-routes-Cq4BqjE9.mjs} +5 -5
  83. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-rR-MpQFh.mjs.map → sdcorejs-angular-modules-pattern-routes-Cq4BqjE9.mjs.map} +1 -1
  84. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-quSIwMOx.mjs → sdcorejs-angular-modules-pattern-routes-Cw9uJySU.mjs} +3 -3
  85. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-quSIwMOx.mjs.map → sdcorejs-angular-modules-pattern-routes-Cw9uJySU.mjs.map} +1 -1
  86. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DoBxGoRE.mjs → sdcorejs-angular-modules-pattern-routes-nrxSHE-O.mjs} +4 -4
  87. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DoBxGoRE.mjs.map → sdcorejs-angular-modules-pattern-routes-nrxSHE-O.mjs.map} +1 -1
  88. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-LQNpFSmN.mjs → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-CJ6hUHjk.mjs} +12 -12
  89. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-LQNpFSmN.mjs.map → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-CJ6hUHjk.mjs.map} +1 -1
  90. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-CcmrUIvP.mjs → sdcorejs-angular-modules-pattern-shell.component-C_AFK_9X.mjs} +4 -4
  91. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-CcmrUIvP.mjs.map → sdcorejs-angular-modules-pattern-shell.component-C_AFK_9X.mjs.map} +1 -1
  92. package/fesm2022/{sdcorejs-angular-modules-pattern-update-side-drawer.component-Cq72tG9h.mjs → sdcorejs-angular-modules-pattern-update-side-drawer.component-C74EEboR.mjs} +4 -4
  93. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-C74EEboR.mjs.map +1 -0
  94. package/fesm2022/{sdcorejs-angular-modules-pattern-update-side-drawer.component-xFbutFLY.mjs → sdcorejs-angular-modules-pattern-update-side-drawer.component-Dj9lvkCP.mjs} +4 -4
  95. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-Dj9lvkCP.mjs.map +1 -0
  96. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-DYPI_CRD.mjs → sdcorejs-angular-modules-pattern-update.component-B7H9pp-R.mjs} +5 -5
  97. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-B7H9pp-R.mjs.map +1 -0
  98. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-CsfGgGJb.mjs → sdcorejs-angular-modules-pattern-update.component-Dhfba-qx.mjs} +22 -12
  99. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Dhfba-qx.mjs.map +1 -0
  100. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-lHmdUXWT.mjs → sdcorejs-angular-modules-pattern-update.component-hRTu79uE.mjs} +12 -10
  101. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-hRTu79uE.mjs.map +1 -0
  102. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +1 -1
  103. package/fesm2022/sdcorejs-angular-services-api.mjs +11 -11
  104. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  105. package/fesm2022/sdcorejs-angular-services-cache.mjs +7 -5
  106. package/fesm2022/sdcorejs-angular-services-cache.mjs.map +1 -1
  107. package/fesm2022/sdcorejs-angular-services-excel.mjs +34 -0
  108. package/fesm2022/sdcorejs-angular-services-excel.mjs.map +1 -1
  109. package/fesm2022/sdcorejs-angular-services-storage.mjs +6 -4
  110. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  111. package/i18n/index.d.ts +66 -1
  112. package/modules/pattern/docs/drawer.md +1 -1
  113. package/modules/pattern/docs/form.md +445 -148
  114. package/modules/pattern/docs/header-actions.md +14 -12
  115. package/modules/pattern/docs/select.md +9 -1
  116. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +8 -1
  117. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +1 -1
  118. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +8 -1
  119. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +1 -1
  120. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +1 -1
  121. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +124 -147
  122. package/modules/pattern/features/order/components/lines-form/order-lines.ts +101 -0
  123. package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.ts +196 -0
  124. package/modules/pattern/features/order/pages/create/create.component.ts +18 -4
  125. package/modules/pattern/features/order/pages/detail/detail.component.ts +14 -12
  126. package/modules/pattern/features/order/pages/update/update.component.ts +11 -4
  127. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +1 -1
  128. package/modules/pattern/features/product/components/product-select/product-select.component.ts +9 -1
  129. package/modules/pattern/features/product/pages/create/create.component.ts +8 -1
  130. package/modules/pattern/features/product/pages/update/update.component.ts +1 -1
  131. package/modules/pattern/features/settings/pages/update/update.component.ts +5 -4
  132. package/package.json +1 -1
  133. package/services/api/index.d.ts +5 -5
  134. package/services/cache/index.d.ts +4 -2
  135. package/services/excel/index.d.ts +59 -0
  136. package/services/storage/index.d.ts +3 -1
  137. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-C9WQdsEi.mjs.map +0 -1
  138. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-s7ZXoakT.mjs.map +0 -1
  139. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BxfQux1Q.mjs.map +0 -1
  140. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DlYVJqHo.mjs.map +0 -1
  141. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-c__NdSt3.mjs.map +0 -1
  142. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-pqT7lnS6.mjs.map +0 -1
  143. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-DZXPZuM4.mjs.map +0 -1
  144. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BjMOON6K.mjs +0 -522
  145. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BjMOON6K.mjs.map +0 -1
  146. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +0 -1
  147. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +0 -1
  148. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-Cq72tG9h.mjs.map +0 -1
  149. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-xFbutFLY.mjs.map +0 -1
  150. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CsfGgGJb.mjs.map +0 -1
  151. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DYPI_CRD.mjs.map +0 -1
  152. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-lHmdUXWT.mjs.map +0 -1
@@ -0,0 +1,196 @@
1
+ import { afterNextRender, ChangeDetectionStrategy, Component, effect, inject, Injector, input, untracked, viewChild } from '@angular/core';
2
+ import { SdButton } from '@sdcorejs/angular/components/button';
3
+ import { SdSection } from '@sdcorejs/angular/components/section';
4
+ import {
5
+ SdTable,
6
+ SdTableCellDefDirective,
7
+ SdTableCommandHeaderDefDirective,
8
+ SdTableTitleDefDirective,
9
+ type SdTableOption,
10
+ } from '@sdcorejs/angular/components/table';
11
+ import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
12
+ import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
13
+ import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
14
+ import type { OrderLineDto } from '../../services/order.model';
15
+ import type { OrderForm } from '../general-information-form/general-information-form.component';
16
+ import { orderLines, type OrderLineRow } from '../lines-form/order-lines';
17
+
18
+ /** 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`. */
19
+ interface LineItem extends OrderLineRow {
20
+ readonly productId?: string;
21
+ readonly quantity?: number;
22
+ readonly unitPrice?: number;
23
+ readonly amount?: number;
24
+ }
25
+
26
+ /**
27
+ * 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à
28
+ * `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
29
+ * (`sdTableCommandHeaderDef`), ngay trên nút xoá của từng dòng; field trong ô dùng `size="sm"` và `hideInlineError`,
30
+ * 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
31
+ * 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`).
32
+ */
33
+ @Component({
34
+ selector: 'lines-table-form',
35
+ standalone: true,
36
+ imports: [
37
+ SdSection,
38
+ SdButton,
39
+ SdTable,
40
+ SdTableCellDefDirective,
41
+ SdTableCommandHeaderDefDirective,
42
+ SdTableTitleDefDirective,
43
+ SdInputNumber,
44
+ SdFormatNumberPipe,
45
+ ProductSelectComponent,
46
+ ],
47
+ changeDetection: ChangeDetectionStrategy.OnPush,
48
+ template: `
49
+ <sd-section title="Dòng hàng">
50
+ <sd-table autoId="order-lines" [option]="option">
51
+ <ng-template sdTableCommandHeaderDef>
52
+ <sd-button
53
+ tooltip="Thêm dòng"
54
+ prefixIcon="add"
55
+ size="sm"
56
+ type="light"
57
+ color="primary"
58
+ autoId="order-line-add"
59
+ (click)="lines.add()" />
60
+ </ng-template>
61
+ <ng-template sdTableTitleDef="productId">Sản phẩm <span class="text-error" aria-hidden="true">*</span></ng-template>
62
+ <ng-template sdTableTitleDef="quantity">Số lượng <span class="text-error" aria-hidden="true">*</span></ng-template>
63
+ <ng-template sdTableTitleDef="unitPrice">Đơn giá (₫) <span class="text-error" aria-hidden="true">*</span></ng-template>
64
+ <ng-template sdTableCellDef="productId" let-row="item">
65
+ @let index = lines.rows().indexOf(row);
66
+ <product-select
67
+ class="lines-table__input"
68
+ size="sm"
69
+ hideInlineError
70
+ [label]="undefined"
71
+ [form]="row.group"
72
+ [model]="row.seed.productId || null"
73
+ [inlineError]="errors()['lines.' + index + '.productId']"
74
+ [autoId]="'order-line-' + index + '-product'"
75
+ (modelChange)="lines.pick(row, $event)"
76
+ required />
77
+ </ng-template>
78
+ <ng-template sdTableCellDef="quantity" let-row="item">
79
+ @let index = lines.rows().indexOf(row);
80
+ <sd-input-number
81
+ class="lines-table__input"
82
+ name="quantity"
83
+ size="sm"
84
+ hideInlineError
85
+ type="positive"
86
+ [precision]="0"
87
+ [form]="row.group"
88
+ [model]="row.seed.quantity"
89
+ [inlineError]="errors()['lines.' + index + '.quantity']"
90
+ [autoId]="'order-line-' + index + '-quantity'"
91
+ required />
92
+ </ng-template>
93
+ <ng-template sdTableCellDef="unitPrice" let-row="item">
94
+ @let index = lines.rows().indexOf(row);
95
+ <sd-input-number
96
+ class="lines-table__input"
97
+ name="unitPrice"
98
+ size="sm"
99
+ hideInlineError
100
+ type="positive"
101
+ [precision]="0"
102
+ [form]="row.group"
103
+ [model]="row.seed.unitPrice"
104
+ [inlineError]="errors()['lines.' + index + '.unitPrice']"
105
+ [autoId]="'order-line-' + index + '-unit-price'"
106
+ required />
107
+ </ng-template>
108
+ <ng-template sdTableCellDef="amount" let-row="item">
109
+ @let index = lines.rows().indexOf(row);
110
+ <strong class="lines-table__amount" [attr.data-autoid]="'order-line-' + index + '-amount'">
111
+ {{ lines.amounts()[index] | sdFormatNumber: 0 }}
112
+ </strong>
113
+ </ng-template>
114
+ </sd-table>
115
+ <div class="lines-table__summary">
116
+ <span>{{ lines.rows().length }} dòng hàng</span>
117
+ <strong
118
+ >Tổng tiền: <span data-autoid="order-total">{{ lines.total() | sdFormatNumber: 0 }}</span> ₫</strong
119
+ >
120
+ </div>
121
+ </sd-section>
122
+ `,
123
+ styles: `
124
+ /* Field trong dòng: 6px trên dưới để dòng 44px vẫn thoáng. */
125
+ .lines-table__input {
126
+ display: block;
127
+ padding-block: 6px;
128
+ }
129
+ .lines-table__amount {
130
+ display: block;
131
+ text-align: right;
132
+ font-variant-numeric: tabular-nums;
133
+ }
134
+ .lines-table__summary {
135
+ display: flex;
136
+ justify-content: space-between;
137
+ gap: 8px;
138
+ padding: 12px 16px;
139
+ color: var(--sd-text-secondary);
140
+ }
141
+ .lines-table__summary strong {
142
+ color: var(--sd-text);
143
+ }
144
+ `,
145
+ })
146
+ export class LinesTableFormComponent {
147
+ readonly form = input.required<OrderForm>();
148
+ /** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
149
+ readonly seed = input.required<readonly OrderLineDto[]>();
150
+ /** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
151
+ readonly errors = input<Readonly<Record<string, string>>>({});
152
+ readonly #injector = inject(Injector);
153
+ private readonly table = viewChild(SdTable<LineItem>);
154
+ protected readonly lines = orderLines(this.form, this.seed, { attach: 'manual' });
155
+ protected readonly option: SdTableOption<LineItem> = {
156
+ type: 'local',
157
+ items: () => [...this.lines.rows()],
158
+ rowKey: 'key',
159
+ filter: { disabled: true },
160
+ paginate: { hidden: true, pageSize: 200 },
161
+ reload: {
162
+ visible: false,
163
+ // why: sd-table vẽ dòng sau lần đọc; field trong ô đăng ký xong thì mới gắn `form.lines` (xem `orderLines`).
164
+ onReload: () => {
165
+ afterNextRender(() => this.lines.attach(), { injector: this.#injector });
166
+ },
167
+ },
168
+ config: { visible: false },
169
+ columns: [
170
+ { field: 'productId', title: 'Sản phẩm', type: 'string', minWidth: '180px' },
171
+ { field: 'quantity', title: 'Số lượng', type: 'number', width: '88px' },
172
+ { field: 'unitPrice', title: 'Đơn giá (₫)', type: 'number', width: '120px' },
173
+ { field: 'amount', title: 'Thành tiền (₫)', type: 'number', width: '120px', align: 'right' },
174
+ ],
175
+ command: {
176
+ commands: [
177
+ {
178
+ title: 'Xoá dòng',
179
+ icon: 'delete',
180
+ color: 'error',
181
+ disabled: () => this.lines.rows().length === 1,
182
+ click: row => this.lines.remove(row),
183
+ },
184
+ ],
185
+ },
186
+ };
187
+
188
+ constructor() {
189
+ // 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
190
+ // lượt render, khi `option` của bảng đã được gán.
191
+ effect(() => {
192
+ this.lines.rows();
193
+ untracked(() => afterNextRender(() => void this.table()?.reload(), { injector: this.#injector }));
194
+ });
195
+ }
196
+ }
@@ -17,6 +17,7 @@ import {
17
17
  type OrderForm,
18
18
  } from '../../components/general-information-form/general-information-form.component';
19
19
  import { LinesFormComponent } from '../../components/lines-form/lines-form.component';
20
+ import { LinesTableFormComponent } from '../../components/lines-table-form/lines-table-form.component';
20
21
  import { OrderService } from '../../services/order.service';
21
22
  import { ORDER_CHANNELS, ORDER_PAYMENTS, ORDER_WAREHOUSES, type OrderSaveReq } from '../../services/order.model';
22
23
 
@@ -24,19 +25,30 @@ import { ORDER_CHANNELS, ORDER_PAYMENTS, ORDER_WAREHOUSES, type OrderSaveReq } f
24
25
  @Component({
25
26
  selector: 'create',
26
27
  standalone: true,
27
- imports: [SdPageComponent, SdButton, SdSection, SdTextarea, GeneralInformationFormComponent, LinesFormComponent],
28
+ imports: [SdPageComponent, SdButton, SdSection, SdTextarea, GeneralInformationFormComponent, LinesFormComponent, LinesTableFormComponent],
28
29
  changeDetection: ChangeDetectionStrategy.OnPush,
29
30
  template: `
30
31
  <sd-page-form title="Tạo mới đơn hàng" [backLink]="['..']" toc>
31
32
  <div headerRight class="d-flex align-items-center gap-8">
32
33
  <sd-button title="Huỷ" type="outline" autoId="order-cancel" (click)="cancel()" />
33
- <sd-button title="Lưu" type="fill" color="primary" autoId="order-save" [loading]="saving()" (click)="save()" />
34
+ <sd-button
35
+ title="Tạo đơn hàng"
36
+ prefixIcon="save"
37
+ type="fill"
38
+ color="primary"
39
+ autoId="order-save"
40
+ [loading]="saving()"
41
+ (click)="save()" />
34
42
  </div>
35
43
  <div class="d-flex flex-column gap-16 py-16">
36
44
  <general-information-form [form]="form" [seed]="seed" />
37
- <lines-form [form]="form" [seed]="seed.lines" [errors]="apiErrors.errors()" />
45
+ @if (linesTable) {
46
+ <lines-table-form [form]="form" [seed]="seed.lines" [errors]="apiErrors.errors()" />
47
+ } @else {
48
+ <lines-form [form]="form" [seed]="seed.lines" [errors]="apiErrors.errors()" />
49
+ }
38
50
  <sd-section title="Ghi chú">
39
- <div class="p-16">
51
+ <div class="px-16 pt-16 pb-8">
40
52
  <sd-textarea label="Ghi chú nội bộ" name="note" [form]="form" [model]="seed.note" maxlength="500" />
41
53
  </div>
42
54
  </sd-section>
@@ -49,6 +61,8 @@ export class CreateComponent {
49
61
  readonly #notify = inject(SdNotifyService);
50
62
  readonly #router = inject(Router);
51
63
  readonly #route = inject(ActivatedRoute);
64
+ /** `?lines=sd-table`: dòng hàng dựng bằng `sd-table` (`lines-table-form`) để so với `<table>`. Màn thật chọn một. */
65
+ protected readonly linesTable = this.#route.snapshot.queryParamMap.get('lines') === 'sd-table';
52
66
  readonly #host: HTMLElement = inject(ElementRef).nativeElement;
53
67
  readonly #injector = inject(Injector);
54
68
  protected readonly seed: OrderSaveReq = {
@@ -18,14 +18,7 @@ import { CustomerDetailPipe } from '../../../customer/pipes/customer-detail.pipe
18
18
  import { ApprovalStepsComponent } from '../../components/approval-steps/approval-steps.component';
19
19
  import { LinesViewComponent } from '../../components/lines-view/lines-view.component';
20
20
  import { OrderService } from '../../services/order.service';
21
- import {
22
- canUpdateOrder,
23
- ORDER_APPROVAL_OPTIONS,
24
- orderApprovalBadge,
25
- orderStatusBadge,
26
- type OrderAction,
27
- type OrderDto,
28
- } from '../../services/order.model';
21
+ import { canUpdateOrder, orderApprovalBadge, orderStatusBadge, type OrderAction, type OrderDto } from '../../services/order.model';
29
22
 
30
23
  /**
31
24
  * Chi tiết đơn (`:id/detail`, route con của danh sách). Mở trong drawer 600px hoặc trang `sd-page-detail` theo
@@ -113,7 +106,13 @@ import {
113
106
  <sd-section-item label="Thanh toán">{{ order.payment }}</sd-section-item>
114
107
  <sd-section-item label="Ngày tạo">{{ order.createdAt | sdFormatDatetime }}</sd-section-item>
115
108
  <sd-section-item label="Tổng tiền (₫)">{{ order.total | sdFormatNumber: 0 }}</sd-section-item>
116
- <sd-section-item label="Trạng thái">{{ statusBadge().title }} · {{ approvalName() }}</sd-section-item>
109
+ <sd-section-item label="Trạng thái">
110
+ <div class="d-flex align-items-center gap-8 flex-wrap">
111
+ @for (badge of badges(); track $index) {
112
+ <sd-badge [type]="badge.type" [title]="badge.title" [color]="badge.color" />
113
+ }
114
+ </div>
115
+ </sd-section-item>
117
116
  </sd-section>
118
117
  <div sdFooterRight class="d-flex align-items-center gap-8 flex-wrap">
119
118
  <ng-container [ngTemplateOutlet]="actions" />
@@ -143,7 +142,9 @@ import {
143
142
  </sd-section>
144
143
  <lines-view [lines]="order.lines" />
145
144
  <sd-section title="Thông tin phê duyệt">
146
- <sd-section-item label="Trạng thái duyệt">{{ approvalName() }}</sd-section-item>
145
+ <sd-section-item label="Trạng thái duyệt">
146
+ <sd-badge [type]="approvalBadge().type" [title]="approvalBadge().title" [color]="approvalBadge().color" />
147
+ </sd-section-item>
147
148
  <sd-section-item label="Người gửi duyệt">{{ submitted()?.by | sdEmpty }}</sd-section-item>
148
149
  <sd-section-item label="Người duyệt">{{ decided()?.by | sdEmpty }}</sd-section-item>
149
150
  <sd-section-item label="Lý do từ chối">{{ decided()?.reason | sdEmpty }}</sd-section-item>
@@ -168,8 +169,9 @@ export class DetailComponent {
168
169
  protected readonly entity = linkedSignal(() => this.#resolved());
169
170
  protected readonly pending = signal(false);
170
171
  protected readonly statusBadge = computed(() => orderStatusBadge(this.entity().status));
171
- protected readonly badges = computed(() => [this.statusBadge(), orderApprovalBadge(this.entity().approval)]);
172
- protected readonly approvalName = computed(() => ORDER_APPROVAL_OPTIONS.find(option => option.id === this.entity().approval)?.name);
172
+ protected readonly approvalBadge = computed(() => orderApprovalBadge(this.entity().approval));
173
+ /** Trạng thái đơn và trạng thái duyệt: title của trang, dòng "Trạng thái" của drawer. */
174
+ protected readonly badges = computed(() => [this.statusBadge(), this.approvalBadge()]);
173
175
  protected readonly editable = computed(() => canUpdateOrder(this.entity()));
174
176
  protected readonly submitted = computed(() => [...this.entity().approvalHistory].reverse().find(step => step.action === 'submit'));
175
177
  protected readonly decided = computed(() =>
@@ -29,6 +29,7 @@ import {
29
29
  type OrderForm,
30
30
  } from '../../components/general-information-form/general-information-form.component';
31
31
  import { LinesFormComponent } from '../../components/lines-form/lines-form.component';
32
+ import { LinesTableFormComponent } from '../../components/lines-table-form/lines-table-form.component';
32
33
  import { OrderService } from '../../services/order.service';
33
34
  import type { OrderDto } from '../../services/order.model';
34
35
 
@@ -39,19 +40,23 @@ import type { OrderDto } from '../../services/order.model';
39
40
  @Component({
40
41
  selector: 'update',
41
42
  standalone: true,
42
- imports: [SdPageComponent, SdButton, SdSection, SdTextarea, GeneralInformationFormComponent, LinesFormComponent],
43
+ imports: [SdPageComponent, SdButton, SdSection, SdTextarea, GeneralInformationFormComponent, LinesFormComponent, LinesTableFormComponent],
43
44
  changeDetection: ChangeDetectionStrategy.OnPush,
44
45
  template: `
45
46
  <sd-page-form [title]="'Cập nhật đơn hàng #' + entity().code" [backLink]="['../detail']" toc>
46
47
  <div headerRight class="d-flex align-items-center gap-8">
47
48
  <sd-button title="Huỷ" type="outline" autoId="order-cancel" (click)="cancel()" />
48
- <sd-button title="Lưu" type="fill" color="primary" autoId="order-save" [loading]="saving()" (click)="save()" />
49
+ <sd-button title="Lưu" prefixIcon="save" type="fill" color="primary" autoId="order-save" [loading]="saving()" (click)="save()" />
49
50
  </div>
50
51
  <div class="d-flex flex-column gap-16 py-16">
51
52
  <general-information-form [form]="form" [seed]="entity()" />
52
- <lines-form [form]="form" [seed]="entity().lines" [errors]="apiErrors.errors()" />
53
+ @if (linesTable) {
54
+ <lines-table-form [form]="form" [seed]="entity().lines" [errors]="apiErrors.errors()" />
55
+ } @else {
56
+ <lines-form [form]="form" [seed]="entity().lines" [errors]="apiErrors.errors()" />
57
+ }
53
58
  <sd-section title="Ghi chú">
54
- <div class="p-16">
59
+ <div class="px-16 pt-16 pb-8">
55
60
  <sd-textarea label="Ghi chú nội bộ" name="note" [form]="form" [model]="entity().note" maxlength="500" />
56
61
  </div>
57
62
  </sd-section>
@@ -64,6 +69,8 @@ export class UpdateComponent {
64
69
  readonly #notify = inject(SdNotifyService);
65
70
  readonly #router = inject(Router);
66
71
  readonly #route = inject(ActivatedRoute);
72
+ /** `?lines=sd-table`: dòng hàng dựng bằng `sd-table` (`lines-table-form`) để so với `<table>`. Màn thật chọn một. */
73
+ protected readonly linesTable = this.#route.snapshot.queryParamMap.get('lines') === 'sd-table';
67
74
  readonly #host: HTMLElement = inject(ElementRef).nativeElement;
68
75
  readonly #injector = inject(Injector);
69
76
  /** Đơn do resolver tải; draft khởi tạo từ đây. */
@@ -34,7 +34,7 @@ export function productSaveReq(form: ProductForm, code?: string): ProductSaveReq
34
34
  imports: [SdInput, SdInputNumber, SdSection, ProductStatusSelectComponent],
35
35
  changeDetection: ChangeDetectionStrategy.OnPush,
36
36
  template: `<sd-section title="Thông tin chung">
37
- <div class="row p-8">
37
+ <div class="row px-16 pt-16 pb-8">
38
38
  <div class="col-12 col-md-6">
39
39
  <sd-input
40
40
  label="Mã sản phẩm"
@@ -4,13 +4,14 @@ import { firstValueFrom } from 'rxjs';
4
4
  import { SdItemDefDefDirective } from '@sdcorejs/angular/forms/directives';
5
5
  import type { SdSearchReq } from '@sdcorejs/angular/forms/models';
6
6
  import { SdSelect } from '@sdcorejs/angular/forms/select';
7
- import type { Filter } from '@sdcorejs/utils/models';
7
+ import type { Filter, Size } from '@sdcorejs/utils/models';
8
8
  import { ProductService } from '../../services/product.service';
9
9
  import type { ProductDto } from '../../services/product.model';
10
10
 
11
11
  /**
12
12
  * 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
13
13
  * đượ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ị.
14
+ * `size`, `hideInlineError` và `inlineError` chuyển thẳng xuống `sd-select`, để dùng được trong ô của bảng.
14
15
  */
15
16
  @Component({
16
17
  selector: 'product-select',
@@ -26,6 +27,9 @@ import type { ProductDto } from '../../services/product.model';
26
27
  valueField="id"
27
28
  displayField="name"
28
29
  [required]="required()"
30
+ [size]="size()"
31
+ [hideInlineError]="hideInlineError()"
32
+ [inlineError]="inlineError()"
29
33
  [autoId]="autoId()">
30
34
  <ng-template sdItemDef let-item="item">
31
35
  <div class="d-flex flex-column">
@@ -41,6 +45,10 @@ export class ProductSelectComponent {
41
45
  readonly name = input('productId');
42
46
  readonly label = input<string | undefined>('Sản phẩm');
43
47
  readonly required = input(false, { transform: booleanAttribute });
48
+ readonly size = input<Size>('md');
49
+ readonly hideInlineError = input(false, { transform: booleanAttribute });
50
+ /** Lỗi của API cho field này (vd `lines.0.productId`). */
51
+ readonly inlineError = input<string>();
44
52
  readonly autoId = input<string>();
45
53
  readonly model = model<string | null | undefined>();
46
54
 
@@ -26,7 +26,14 @@ import type { ProductSaveReq } from '../../services/product.model';
26
26
  <sd-page-form title="Tạo mới sản phẩm" [backLink]="['..']">
27
27
  <div headerRight class="d-flex align-items-center gap-8">
28
28
  <sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
29
- <sd-button title="Lưu" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
29
+ <sd-button
30
+ title="Tạo sản phẩm"
31
+ prefixIcon="save"
32
+ type="fill"
33
+ color="primary"
34
+ autoId="product-save"
35
+ [loading]="saving()"
36
+ (click)="save()" />
30
37
  </div>
31
38
  <div class="py-16">
32
39
  <general-information-form [form]="form" [seed]="seed" [errors]="apiErrors.errors()" />
@@ -27,7 +27,7 @@ import type { ProductDto } from '../../services/product.model';
27
27
  <sd-page-form [title]="'Cập nhật sản phẩm #' + entity().code" [backLink]="['../detail']">
28
28
  <div headerRight class="d-flex align-items-center gap-8">
29
29
  <sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
30
- <sd-button title="Lưu" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
30
+ <sd-button title="Lưu" prefixIcon="save" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
31
31
  </div>
32
32
  <div class="py-16">
33
33
  <general-information-form [form]="form" [seed]="entity()" [editing]="true" [errors]="apiErrors.errors()" />
@@ -52,6 +52,7 @@ const CURRENCIES = [
52
52
  headerRight
53
53
  *sdPermission="'PATTERN_SETTINGS_U_UPDATE'"
54
54
  title="Lưu"
55
+ prefixIcon="save"
55
56
  type="fill"
56
57
  color="primary"
57
58
  autoId="settings-save"
@@ -59,7 +60,7 @@ const CURRENCIES = [
59
60
  (click)="save()" />
60
61
  <div class="d-flex flex-column gap-16 py-16">
61
62
  <sd-section title="Thông tin cửa hàng">
62
- <div class="row p-8">
63
+ <div class="row px-16 pt-16 pb-8">
63
64
  <div class="col-12 col-md-6">
64
65
  <sd-input
65
66
  label="Tên cửa hàng"
@@ -80,7 +81,7 @@ const CURRENCIES = [
80
81
  </div>
81
82
  </sd-section>
82
83
  <sd-section title="Bán hàng">
83
- <div class="row p-8">
84
+ <div class="row px-16 pt-16 pb-8">
84
85
  <div class="col-12 col-md-6">
85
86
  <sd-select
86
87
  label="Tiền tệ"
@@ -126,7 +127,7 @@ const CURRENCIES = [
126
127
  </div>
127
128
  </sd-section>
128
129
  <sd-section title="Thông báo">
129
- <div class="row p-8">
130
+ <div class="row px-16 pt-16 pb-8">
130
131
  <div class="col-12 col-md-6 d-flex align-items-center">
131
132
  <sd-switch
132
133
  label="Gửi email"
@@ -152,7 +153,7 @@ const CURRENCIES = [
152
153
  </div>
153
154
  </sd-section>
154
155
  <sd-section title="Bảo mật">
155
- <div class="row p-8">
156
+ <div class="row px-16 pt-16 pb-8">
156
157
  <div class="col-12 col-md-6">
157
158
  <sd-input-number
158
159
  label="Hết phiên sau (phút)"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sdcorejs/angular",
3
- "version": "20.3.3",
3
+ "version": "20.3.5",
4
4
  "description": "Angular component library: data table, query bar/builder, 20+ signal-based form controls, layout, auth and workflow services. Standalone, OnPush, signals-first. Published in parallel lines for Angular 19, 20, 21 and 22.",
5
5
  "keywords": [
6
6
  "angular",
@@ -72,9 +72,9 @@ interface SdApiHandler {
72
72
  interface ISdApiConfiguration {
73
73
  handlers?: SdApiHandler[];
74
74
  }
75
- declare const SD_API_CONFIG: InjectionToken<ISdApiConfiguration>;
76
- /** @deprecated Use `SD_API_CONFIG`. This is the same injection token. */
77
75
  declare const SD_API_CONFIGURATION: InjectionToken<ISdApiConfiguration>;
76
+ /** @deprecated Use `SD_API_CONFIGURATION`. This is the same injection token. */
77
+ declare const SD_API_CONFIG: InjectionToken<ISdApiConfiguration>;
78
78
  /**
79
79
  * Lỗi nghiệp vụ: HTTP 200 nhưng body envelope báo thất bại (`{ ok: false, ... }`).
80
80
  *
@@ -94,13 +94,13 @@ declare class SdApiError<TBody = unknown> extends Error {
94
94
  * Handler API đăng ký lúc runtime, sống ở root injector.
95
95
  *
96
96
  * why: `SdHttpInterceptor` được đăng ký qua `HTTP_INTERCEPTORS` ở ROOT, nên
97
- * `inject(SD_API_CONFIG)` của nó chỉ thấy provider ở root. Library nào khai
98
- * `{ provide: SD_API_CONFIG, multi: true }` trong NgModule mà shell nạp bằng
97
+ * `inject(SD_API_CONFIGURATION)` của nó chỉ thấy provider ở root. Library nào khai
98
+ * `{ provide: SD_API_CONFIGURATION, multi: true }` trong NgModule mà shell nạp bằng
99
99
  * `loadChildren` thì provider nằm ở child injector của lazy route — interceptor không
100
100
  * bao giờ thấy, nên mất `intercept` / `beforeRemote` / `afterRemote` trong im lặng.
101
101
  * Registry này là điểm hẹn ở root mà mọi scope (root, eager, lazy) đều ghi vào được.
102
102
  *
103
- * Registry tự nhặt `SD_API_CONFIG` khai trong injector của lazy route (`Route.providers`,
103
+ * Registry tự nhặt `SD_API_CONFIGURATION` khai trong injector của lazy route (`Route.providers`,
104
104
  * NgModule của `loadChildren`) trong chính navigation Router tạo injector đó — trước guard,
105
105
  * resolver và component — và gỡ khi injector bị huỷ;
106
106
  * library giữ nguyên cách khai multi provider, không cần biết shell mount nó eager hay lazy.
@@ -45,7 +45,7 @@ type SdCacheGetCallback = (key: string, option?: SdCacheOption<unknown>) => Prom
45
45
  type SdCacheRemoveCallback = (key: string, option?: SdCacheOption<unknown>) => Promise<void> | void;
46
46
  /**
47
47
  * Số entry `type: 'memory'` tối đa được giữ trước khi LRU đẩy entry cũ nhất ra.
48
- * Ghi đè bằng `maxMemoryEntries` trên `SD_CACHE_CONFIG`.
48
+ * Ghi đè bằng `maxMemoryEntries` trên `SD_CACHE_CONFIGURATION`.
49
49
  */
50
50
  declare const SD_CACHE_DEFAULT_MAX_MEMORY_ENTRIES = 500;
51
51
  interface ISdCacheConfiguration {
@@ -63,6 +63,8 @@ interface ISdCacheConfiguration {
63
63
  get?: SdCacheGetCallback;
64
64
  remove?: SdCacheRemoveCallback;
65
65
  }
66
+ declare const SD_CACHE_CONFIGURATION: InjectionToken<ISdCacheConfiguration>;
67
+ /** @deprecated Use `SD_CACHE_CONFIGURATION`. This is the same injection token. */
66
68
  declare const SD_CACHE_CONFIG: InjectionToken<ISdCacheConfiguration>;
67
69
  interface SdLegacyCacheCallbacks<T> {
68
70
  matches: (key: string, option?: SdCacheOption<unknown>) => boolean;
@@ -85,5 +87,5 @@ declare class SdCacheService {
85
87
  static ɵprov: i0.ɵɵInjectableDeclaration<SdCacheService>;
86
88
  }
87
89
 
88
- export { SD_CACHE_CONFIG, SD_CACHE_DEFAULT_MAX_MEMORY_ENTRIES, SdCacheService, adaptLegacySdCacheCallbacks };
90
+ export { SD_CACHE_CONFIG, SD_CACHE_CONFIGURATION, SD_CACHE_DEFAULT_MAX_MEMORY_ENTRIES, SdCacheService, adaptLegacySdCacheCallbacks };
89
91
  export type { ISdCacheConfiguration, SdCache, SdCacheGetCallback, SdCacheOption, SdCacheRemoveCallback, SdCacheSetCallback, SdCacheSnapshot, SdCacheStoredValue, SdCacheWithDefault, SdLegacyCacheCallbacks };
@@ -10,6 +10,35 @@ interface SdExcelColumn {
10
10
  title: string;
11
11
  description?: string;
12
12
  width?: string;
13
+ /**
14
+ * Excel number-format code for numeric or `Date` data cells written by
15
+ * {@link SdExcelService.export}, for example `'dd/mm/yyyy'`,
16
+ * `'dd/mm/yyyy hh:mm:ss'`, `'hh:mm:ss'` or `'0.00'`.
17
+ *
18
+ * Defaults to no override: omitted, `undefined` and `''` preserve the existing
19
+ * writer behavior. Any nonempty string is passed to ExcelJS without semantic
20
+ * validation; use Excel format codes, not DateUtilities formatting tokens.
21
+ * Formatting changes display only, never the value or timezone. Strings are
22
+ * kept as text (with the usual formula neutralization), even if they look like
23
+ * dates. Headers, descriptions, additional sheets, `generateTemplate()` and
24
+ * `exportCSV()` ignore this property.
25
+ *
26
+ * For a time without a date, supply seconds since midnight divided by 86400.
27
+ * Calendar serials use the Excel 1900 date system, including its leap-year
28
+ * compatibility rule. The caller owns calendar conversion and valid ranges;
29
+ * this service does not parse date strings or convert configured timezones.
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * import { SdExcelColumn } from '@sdcorejs/angular/services/excel';
34
+ * const column: SdExcelColumn = {
35
+ * field: 'day', title: 'Day', numFmt: 'dd/mm/yyyy',
36
+ * };
37
+ * // With excel.export({ columns: [column], items: [{ day: 46323 }] }),
38
+ * // Excel displays 28/10/2026 as a date. The string '28/10/2026' stays text.
39
+ * ```
40
+ */
41
+ numFmt?: string;
13
42
  }
14
43
  interface SdExcelTemplateColumn extends SdExcelColumn {
15
44
  required?: boolean;
@@ -37,6 +66,36 @@ declare class SdExcelService {
37
66
  constructor();
38
67
  generateTemplate: (template: SdExcelTemplate) => Promise<void>;
39
68
  exportCSV: (option: SdExcelExportOption) => Promise<void>;
69
+ /**
70
+ * Serializes tabular values to an XLSX workbook and starts a browser download.
71
+ * The main `data` sheet contains field keys, titles, optional descriptions,
72
+ * then data. This browser API lazily loads ExcelJS; it does not mutate rows or
73
+ * column options and does not convert application timezones.
74
+ *
75
+ * @param option Columns, rows, optional filename and additional sheets. Each
76
+ * column requires a nonempty field and title. Empty columns/rows are allowed.
77
+ * A nonempty `column.numFmt` applies only to number/Date data cells in the main
78
+ * sheet; omitted or empty formats preserve existing behavior. Strings stay
79
+ * text and are neutralized for spreadsheet formula injection. Nullish data
80
+ * values remain blank. ExcelJS handles Date serialization in the 1900 system;
81
+ * the caller owns valid serials, date ranges and timezone conversion.
82
+ * @returns A promise resolving after serialization and the download trigger,
83
+ * not after the user saves the file. There is no cancellation or timeout API.
84
+ * @throws Rejects if a column lacks its field/title, or if loading ExcelJS,
85
+ * serialization or the browser download helper fails.
86
+ * @example
87
+ * ```ts
88
+ * import { inject } from '@angular/core';
89
+ * import { SdExcelService } from '@sdcorejs/angular/services/excel';
90
+ * // Inside an Angular injection context:
91
+ * const excel = inject(SdExcelService);
92
+ * await excel.export({
93
+ * columns: [{ field: 'day', title: 'Day', numFmt: 'dd/mm/yyyy' }],
94
+ * items: [{ day: 46323 }],
95
+ * fileName: 'dates.xlsx',
96
+ * }); // Excel displays a date cell as 28/10/2026.
97
+ * ```
98
+ */
40
99
  export: (option: SdExcelExportOption) => Promise<void>;
41
100
  upload: () => Promise<{
42
101
  items: Record<string, any>[];
@@ -41,6 +41,8 @@ interface ISdStorageConfiguration {
41
41
  serializer?: SdPersistenceSerializer;
42
42
  identityCanonicalizer?: SdPersistenceIdentityCanonicalizer;
43
43
  }
44
+ declare const SD_STORAGE_CONFIGURATION: InjectionToken<ISdStorageConfiguration>;
45
+ /** @deprecated Use `SD_STORAGE_CONFIGURATION`. This is the same injection token. */
44
46
  declare const SD_STORAGE_CONFIG: InjectionToken<ISdStorageConfiguration>;
45
47
 
46
48
  declare class SdStorageService {
@@ -54,5 +56,5 @@ declare class SdStorageService {
54
56
  static ɵprov: i0.ɵɵInjectableDeclaration<SdStorageService>;
55
57
  }
56
58
 
57
- export { SD_STORAGE_CONFIG, SdStorageService };
59
+ export { SD_STORAGE_CONFIG, SD_STORAGE_CONFIGURATION, SdStorageService };
58
60
  export type { ISdStorageConfiguration, SdStorage, SdStorageOption, SdStorageWithDefault };