@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
@@ -38,6 +38,10 @@ import { isObservable } from 'rxjs';
38
38
  import { SdInput } from '@sdcorejs/angular/forms';
39
39
 
40
40
  const SD_PAGE_MAX_BADGES = 2;
41
+ /** Section có mép trên cách mép trên vùng cuộn không quá số px này được coi là đã chạm đỉnh. */
42
+ const SD_PAGE_TOC_TOP_TOLERANCE = 8;
43
+ /** Không có sự kiện scroll trong khoảng này thì coi như cú cuộn do bấm mục lục đã dừng. */
44
+ const SD_PAGE_TOC_SCROLL_IDLE_MS = 150;
41
45
  // why: một component cho cả ba selector, mặc định khác nhau theo tên thẻ host.
42
46
  const SD_PAGE_DEFAULT_WIDTH = {
43
47
  'sd-page': 'full',
@@ -74,6 +78,11 @@ class SdPageComponent {
74
78
  // nên danh sách tính lại sau mỗi lần render chứ không tính ngay trong computed.
75
79
  tocItems = signal([], ...(ngDevMode ? [{ debugName: "tocItems" }] : []));
76
80
  activeTocIndex = signal(0, ...(ngDevMode ? [{ debugName: "activeTocIndex" }] : []));
81
+ // why: cuộn mượt tới section vừa bấm đi ngang các section ở giữa; giữ mục vừa bấm tới khi cuộn dừng thay vì
82
+ // để mục lục nháy qua từng mục. Lưu phần tử, không lưu chỉ số, vì danh sách có thể đổi trong lúc cuộn.
83
+ #clickTarget = null;
84
+ #clickScrollTimer;
85
+ #tocResize = null;
77
86
  // why: fallback của slot headerLeft chỉ render khi không có headerLeft/sdHeaderLeft, nên vắng nó nghĩa là
78
87
  // vùng trái đã bị thay và backLink không có chỗ hiện.
79
88
  titleBlock = viewChild('titleBlock', ...(ngDevMode ? [{ debugName: "titleBlock" }] : []));
@@ -87,14 +96,37 @@ class SdPageComponent {
87
96
  effect(() => {
88
97
  const enabled = this.toc();
89
98
  const entries = this.#sections().map(entry => ({ title: entry.section.title(), el: entry.el }));
90
- afterNextRender(() => this.tocItems.set(enabled ? this.#collectToc(entries) : []), { injector: this.#injector });
99
+ afterNextRender(() => {
100
+ this.tocItems.set(enabled ? this.#collectToc(entries) : []);
101
+ this.#observeTocLayout();
102
+ // why: thêm/bớt section làm chỉ số cũ trỏ sai mục (hoặc ra ngoài danh sách) mà không có sự kiện scroll nào.
103
+ this.#syncActiveToc();
104
+ }, { injector: this.#injector });
91
105
  });
92
106
  afterNextRender(() => {
93
107
  const wrapper = this.wrapper().nativeElement;
94
- const onScroll = () => this.#syncActiveToc();
108
+ const onScroll = () => {
109
+ if (this.#clickTarget)
110
+ this.#armClickScrollEnd();
111
+ this.#syncActiveToc();
112
+ };
113
+ const onScrollEnd = () => {
114
+ if (this.#clickTarget)
115
+ this.#endClickScroll();
116
+ };
95
117
  // why: scroll bắn liên tục; chỉ signal đổi mới cần render lại, không cần chạy change detection mỗi lần.
96
- this.#zone.runOutsideAngular(() => wrapper.addEventListener('scroll', onScroll, { passive: true }));
97
- this.#destroyRef.onDestroy(() => wrapper.removeEventListener('scroll', onScroll));
118
+ this.#zone.runOutsideAngular(() => {
119
+ wrapper.addEventListener('scroll', onScroll, { passive: true });
120
+ wrapper.addEventListener('scrollend', onScrollEnd);
121
+ });
122
+ this.#destroyRef.onDestroy(() => {
123
+ wrapper.removeEventListener('scroll', onScroll);
124
+ wrapper.removeEventListener('scrollend', onScrollEnd);
125
+ });
126
+ });
127
+ this.#destroyRef.onDestroy(() => {
128
+ this.#tocResize?.disconnect();
129
+ clearTimeout(this.#clickScrollTimer);
98
130
  });
99
131
  if (isDevMode()) {
100
132
  effect(() => {
@@ -123,6 +155,8 @@ class SdPageComponent {
123
155
  if (!item)
124
156
  return;
125
157
  this.activeTocIndex.set(index);
158
+ this.#clickTarget = item.el;
159
+ this.#armClickScrollEnd();
126
160
  const reduceMotion = typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
127
161
  item.el.scrollIntoView({ block: 'start', behavior: reduceMotion ? 'auto' : 'smooth' });
128
162
  }
@@ -137,10 +171,58 @@ class SdPageComponent {
137
171
  .filter((entry) => !!entry.title && !!content?.contains(entry.el))
138
172
  .sort((left, right) => (left.el.compareDocumentPosition(right.el) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1));
139
173
  }
174
+ // why: section đổi chiều cao (bảng tải xong, section mở ra hay thu lại) hay khung cuộn đổi cỡ làm section đổi chỗ mà
175
+ // không có sự kiện scroll. `.c-page-content` không giãn theo nội dung nên phải theo dõi chính các section. Trang
176
+ // không có mục lục thì không giữ observer nào.
177
+ #observeTocLayout() {
178
+ this.#tocResize?.disconnect();
179
+ const items = this.tocItems();
180
+ if (!items.length || typeof ResizeObserver === 'undefined')
181
+ return;
182
+ this.#tocResize ??= this.#zone.runOutsideAngular(() => new ResizeObserver(() => this.#syncActiveToc()));
183
+ this.#tocResize.observe(this.wrapper().nativeElement);
184
+ for (const item of items)
185
+ this.#tocResize.observe(item.el);
186
+ }
187
+ // why: `scrollend` chưa có ở mọi trình duyệt. Hẹn giờ lại sau mỗi sự kiện scroll nên cú cuộn coi như dừng khi
188
+ // không còn sự kiện nào, kể cả khi section đã ở sẵn vị trí và không cuộn chút nào.
189
+ #armClickScrollEnd() {
190
+ clearTimeout(this.#clickScrollTimer);
191
+ this.#zone.runOutsideAngular(() => {
192
+ this.#clickScrollTimer = setTimeout(() => this.#endClickScroll(), SD_PAGE_TOC_SCROLL_IDLE_MS);
193
+ });
194
+ }
195
+ #endClickScroll() {
196
+ clearTimeout(this.#clickScrollTimer);
197
+ const target = this.#clickTarget;
198
+ this.#clickTarget = null;
199
+ if (!target)
200
+ return;
201
+ const index = this.tocItems().findIndex(item => item.el === target);
202
+ const area = this.wrapper().nativeElement.getBoundingClientRect();
203
+ const top = target.getBoundingClientRect().top;
204
+ // why: section gần cuối trang không cuộn lên tới mép trên được; còn nằm trong vùng nhìn thì giữ mục vừa bấm.
205
+ // Người dùng đã cuộn đi chỗ khác trong lúc đó thì tính lại theo vị trí cuộn.
206
+ if (index >= 0 && top >= area.top - SD_PAGE_TOC_TOP_TOLERANCE && top < area.bottom) {
207
+ this.activeTocIndex.set(index);
208
+ return;
209
+ }
210
+ this.#syncActiveToc();
211
+ }
140
212
  #syncActiveToc() {
141
213
  const items = this.tocItems();
142
214
  if (!items.length)
143
215
  return;
216
+ if (this.#clickTarget) {
217
+ const clicked = items.findIndex(item => item.el === this.#clickTarget);
218
+ if (clicked >= 0) {
219
+ this.activeTocIndex.set(clicked);
220
+ return;
221
+ }
222
+ // why: section vừa bấm đã bị gỡ khỏi trang; thôi giữ nó và tính theo vị trí cuộn.
223
+ this.#clickTarget = null;
224
+ clearTimeout(this.#clickScrollTimer);
225
+ }
144
226
  const wrapper = this.wrapper().nativeElement;
145
227
  // why: cuộn tới đáy thì section cuối có thể không bao giờ chạm mép trên; khi đó nó là section đang đọc.
146
228
  if (wrapper.scrollTop + wrapper.clientHeight >= wrapper.scrollHeight - 1) {
@@ -150,7 +232,7 @@ class SdPageComponent {
150
232
  const top = wrapper.getBoundingClientRect().top;
151
233
  let active = 0;
152
234
  items.forEach((item, index) => {
153
- if (item.el.getBoundingClientRect().top - top <= 8)
235
+ if (item.el.getBoundingClientRect().top - top <= SD_PAGE_TOC_TOP_TOLERANCE)
154
236
  active = index;
155
237
  });
156
238
  this.activeTocIndex.set(active);
@@ -1770,7 +1852,6 @@ function initialOf(title) {
1770
1852
 
1771
1853
  class SdLayoutUserMenuComponent {
1772
1854
  #configuration = inject(SD_LAYOUT_CONFIGURATION, { optional: true });
1773
- #destroyRef = inject(DestroyRef);
1774
1855
  #document = inject(DOCUMENT);
1775
1856
  #host = inject(ElementRef);
1776
1857
  trigger = viewChild('trigger', ...(ngDevMode ? [{ debugName: "trigger" }] : []));
@@ -1841,11 +1922,16 @@ class SdLayoutUserMenuComponent {
1841
1922
  return;
1842
1923
  this.close(false);
1843
1924
  };
1844
- this.#document.addEventListener('keydown', onDocumentKeydown);
1845
- this.#document.addEventListener('pointerdown', onDocumentPointerDown);
1846
- this.#destroyRef.onDestroy(() => {
1847
- this.#document.removeEventListener('keydown', onDocumentKeydown);
1848
- this.#document.removeEventListener('pointerdown', onDocumentPointerDown);
1925
+ effect(onCleanup => {
1926
+ if (!this.isOpen())
1927
+ return;
1928
+ // why: menu đóng không cần xử lý các phím và click của toàn trang.
1929
+ this.#document.addEventListener('keydown', onDocumentKeydown);
1930
+ this.#document.addEventListener('pointerdown', onDocumentPointerDown);
1931
+ onCleanup(() => {
1932
+ this.#document.removeEventListener('keydown', onDocumentKeydown);
1933
+ this.#document.removeEventListener('pointerdown', onDocumentPointerDown);
1934
+ });
1849
1935
  });
1850
1936
  }
1851
1937
  open() {