@edsis/angular 22.1.6 → 22.2.8

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 (363) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +87 -399
  3. package/SECURITY.md +18 -0
  4. package/SUPPORT.md +15 -0
  5. package/chart/README.md +272 -0
  6. package/component/README.md +89 -0
  7. package/component/accordion/README.md +195 -0
  8. package/component/alert/README.md +184 -0
  9. package/component/alert-dialog/README.md +255 -0
  10. package/component/aspect-ratio/README.md +116 -0
  11. package/component/avatar/README.md +182 -0
  12. package/component/badge/README.md +143 -0
  13. package/component/breadcrumb/README.md +223 -0
  14. package/component/button/README.md +141 -0
  15. package/component/button-group/README.md +214 -0
  16. package/component/calendar/README.md +125 -0
  17. package/component/card/README.md +232 -0
  18. package/component/carousel/README.md +276 -0
  19. package/component/checkbox/README.md +153 -0
  20. package/component/collapsible/README.md +216 -0
  21. package/component/combobox/README.md +202 -0
  22. package/component/command/README.md +287 -0
  23. package/component/composer/README.md +241 -0
  24. package/component/context-menu/README.md +268 -0
  25. package/component/date-picker/README.md +202 -0
  26. package/component/dialog/README.md +276 -0
  27. package/component/drawer/README.md +146 -0
  28. package/component/dropdown-menu/README.md +336 -0
  29. package/component/editor/README.md +152 -0
  30. package/component/empty/README.md +193 -0
  31. package/component/form/README.md +216 -0
  32. package/component/hover-card/README.md +150 -0
  33. package/component/icon/README.md +52 -0
  34. package/component/input/README.md +160 -0
  35. package/component/input-group/README.md +245 -0
  36. package/component/input-otp/README.md +331 -0
  37. package/component/item/README.md +254 -0
  38. package/component/kanban/README.md +81 -0
  39. package/component/kbd/README.md +141 -0
  40. package/component/label/README.md +137 -0
  41. package/component/menubar/README.md +270 -0
  42. package/component/native-select/README.md +176 -0
  43. package/component/navigation-menu/README.md +165 -0
  44. package/component/pagination/README.md +151 -0
  45. package/component/pillbox/README.md +68 -0
  46. package/component/popover/README.md +54 -0
  47. package/component/progress/README.md +160 -0
  48. package/component/radio/README.md +212 -0
  49. package/component/resizable/README.md +178 -0
  50. package/component/scroll-area/README.md +150 -0
  51. package/component/select/README.md +228 -0
  52. package/component/separator/README.md +175 -0
  53. package/component/sheet/README.md +190 -0
  54. package/component/skeleton/README.md +158 -0
  55. package/component/slider/README.md +207 -0
  56. package/component/spinner/README.md +160 -0
  57. package/component/switch/README.md +170 -0
  58. package/component/table/README.md +292 -0
  59. package/component/tabs/README.md +220 -0
  60. package/component/textarea/README.md +169 -0
  61. package/component/timeline/README.md +94 -0
  62. package/component/toast/README.md +173 -0
  63. package/component/toggle/README.md +133 -0
  64. package/component/toggle-group/README.md +234 -0
  65. package/component/tooltip/README.md +230 -0
  66. package/fesm2022/edsis-angular-chart-area.mjs +508 -0
  67. package/fesm2022/edsis-angular-chart-bar.mjs +946 -0
  68. package/fesm2022/edsis-angular-chart-core.mjs +1282 -0
  69. package/fesm2022/edsis-angular-chart-line.mjs +544 -0
  70. package/fesm2022/edsis-angular-chart-pie.mjs +524 -0
  71. package/fesm2022/edsis-angular-chart-primitives.mjs +1647 -0
  72. package/fesm2022/edsis-angular-chart-radar.mjs +693 -0
  73. package/fesm2022/edsis-angular-chart-radial.mjs +542 -0
  74. package/fesm2022/edsis-angular-chart-scatter.mjs +486 -0
  75. package/fesm2022/edsis-angular-chart.mjs +3 -0
  76. package/fesm2022/edsis-angular-component-accordion.mjs +513 -0
  77. package/fesm2022/edsis-angular-component-alert-dialog.mjs +1001 -0
  78. package/fesm2022/edsis-angular-component-alert.mjs +268 -0
  79. package/fesm2022/edsis-angular-component-aspect-ratio.mjs +80 -0
  80. package/fesm2022/edsis-angular-component-avatar.mjs +410 -0
  81. package/fesm2022/edsis-angular-component-badge.mjs +111 -0
  82. package/fesm2022/edsis-angular-component-breadcrumb.mjs +464 -0
  83. package/fesm2022/edsis-angular-component-button-group.mjs +252 -0
  84. package/fesm2022/edsis-angular-component-button.mjs +155 -0
  85. package/fesm2022/edsis-angular-component-calendar.mjs +835 -0
  86. package/fesm2022/edsis-angular-component-card.mjs +460 -0
  87. package/fesm2022/edsis-angular-component-carousel.mjs +700 -0
  88. package/fesm2022/edsis-angular-component-checkbox.mjs +398 -0
  89. package/fesm2022/edsis-angular-component-collapsible.mjs +305 -0
  90. package/fesm2022/edsis-angular-component-combobox.mjs +544 -0
  91. package/fesm2022/edsis-angular-component-command.mjs +815 -0
  92. package/fesm2022/edsis-angular-component-composer.mjs +840 -0
  93. package/fesm2022/edsis-angular-component-context-menu.mjs +197 -0
  94. package/fesm2022/edsis-angular-component-date-picker.mjs +798 -0
  95. package/fesm2022/edsis-angular-component-dialog.mjs +798 -0
  96. package/fesm2022/edsis-angular-component-drawer.mjs +2 -0
  97. package/fesm2022/edsis-angular-component-dropdown-menu.mjs +1259 -0
  98. package/fesm2022/edsis-angular-component-editor.mjs +1000 -0
  99. package/fesm2022/edsis-angular-component-empty.mjs +351 -0
  100. package/fesm2022/edsis-angular-component-form.mjs +821 -0
  101. package/fesm2022/edsis-angular-component-hover-card.mjs +486 -0
  102. package/fesm2022/edsis-angular-component-icon.mjs +253 -0
  103. package/fesm2022/edsis-angular-component-input-group.mjs +453 -0
  104. package/fesm2022/edsis-angular-component-input-otp.mjs +957 -0
  105. package/fesm2022/edsis-angular-component-input.mjs +87 -0
  106. package/fesm2022/edsis-angular-component-item.mjs +720 -0
  107. package/fesm2022/edsis-angular-component-kanban.mjs +812 -0
  108. package/fesm2022/edsis-angular-component-kbd.mjs +124 -0
  109. package/fesm2022/edsis-angular-component-label.mjs +82 -0
  110. package/fesm2022/edsis-angular-component-menubar.mjs +481 -0
  111. package/fesm2022/edsis-angular-component-native-select.mjs +168 -0
  112. package/fesm2022/edsis-angular-component-navigation-menu.mjs +685 -0
  113. package/fesm2022/edsis-angular-component-pagination.mjs +425 -0
  114. package/fesm2022/edsis-angular-component-pillbox.mjs +1679 -0
  115. package/fesm2022/edsis-angular-component-popover.mjs +292 -0
  116. package/fesm2022/edsis-angular-component-progress.mjs +184 -0
  117. package/fesm2022/edsis-angular-component-radio.mjs +491 -0
  118. package/fesm2022/edsis-angular-component-resizable.mjs +703 -0
  119. package/fesm2022/edsis-angular-component-scroll-area.mjs +133 -0
  120. package/fesm2022/edsis-angular-component-segmented-control.mjs +408 -0
  121. package/fesm2022/edsis-angular-component-select.mjs +743 -0
  122. package/fesm2022/edsis-angular-component-separator.mjs +102 -0
  123. package/fesm2022/edsis-angular-component-sheet.mjs +874 -0
  124. package/fesm2022/edsis-angular-component-skeleton.mjs +62 -0
  125. package/fesm2022/edsis-angular-component-slider.mjs +676 -0
  126. package/fesm2022/edsis-angular-component-spinner.mjs +157 -0
  127. package/fesm2022/edsis-angular-component-switch.mjs +361 -0
  128. package/fesm2022/edsis-angular-component-table.mjs +446 -0
  129. package/fesm2022/edsis-angular-component-tabs.mjs +592 -0
  130. package/fesm2022/edsis-angular-component-textarea.mjs +85 -0
  131. package/fesm2022/edsis-angular-component-timeline.mjs +619 -0
  132. package/fesm2022/edsis-angular-component-toast.mjs +231 -0
  133. package/fesm2022/edsis-angular-component-toggle-group.mjs +579 -0
  134. package/fesm2022/edsis-angular-component-toggle.mjs +189 -0
  135. package/fesm2022/edsis-angular-component-tooltip.mjs +804 -0
  136. package/fesm2022/edsis-angular-component-utils-core.mjs +181 -0
  137. package/fesm2022/edsis-angular-component-utils-overlay.mjs +54 -0
  138. package/fesm2022/edsis-angular-component-utils-scale.mjs +76 -0
  139. package/fesm2022/edsis-angular-component-utils.mjs +2 -0
  140. package/fesm2022/edsis-angular-component.mjs +0 -0
  141. package/fesm2022/edsis-angular-navigation-core.mjs +15 -0
  142. package/fesm2022/edsis-angular-navigation-icon.mjs +35 -0
  143. package/fesm2022/edsis-angular-navigation-navigation-badge-count.component-BWWWaUgy.mjs +234 -0
  144. package/fesm2022/edsis-angular-navigation-navigation-dockbar-menu.component-Bx2bxTID.mjs +834 -0
  145. package/fesm2022/edsis-angular-navigation-navigation-entry-grid.component-Duzt1ffz.mjs +823 -0
  146. package/fesm2022/edsis-angular-navigation-navigation-flyout-menu.component-cJ8Q1vM6.mjs +670 -0
  147. package/fesm2022/edsis-angular-navigation-navigation-horizontal.component-CDQ1wt2_.mjs +689 -0
  148. package/fesm2022/edsis-angular-navigation-navigation-item.component-C1VzerJp.mjs +1522 -0
  149. package/fesm2022/edsis-angular-navigation-navigation-list.component-BPYLfrID.mjs +346 -0
  150. package/fesm2022/edsis-angular-navigation-service.mjs +558 -0
  151. package/fesm2022/edsis-angular-navigation-types.mjs +151 -0
  152. package/fesm2022/edsis-angular-navigation.mjs +3338 -0
  153. package/fesm2022/edsis-angular-sdk.mjs +100 -0
  154. package/fesm2022/edsis-angular-theme-component-settings.mjs +1877 -0
  155. package/fesm2022/edsis-angular-theme-layout-services.mjs +252 -0
  156. package/fesm2022/edsis-angular-theme-layout-types.mjs +45 -0
  157. package/fesm2022/edsis-angular-theme-layout-wrapper.mjs +2568 -0
  158. package/fesm2022/edsis-angular-theme-layout.mjs +1089 -0
  159. package/fesm2022/edsis-angular-theme-page-core.mjs +315 -0
  160. package/fesm2022/edsis-angular-theme-page-filter.mjs +409 -0
  161. package/fesm2022/edsis-angular-theme-page-overview.mjs +88 -0
  162. package/fesm2022/edsis-angular-theme-page-root.mjs +693 -0
  163. package/fesm2022/edsis-angular-theme-page-side.mjs +342 -0
  164. package/fesm2022/edsis-angular-theme-page-slots.mjs +258 -0
  165. package/fesm2022/edsis-angular-theme-page.mjs +7 -0
  166. package/fesm2022/edsis-angular-theme-shell-services.mjs +231 -0
  167. package/fesm2022/edsis-angular-theme-shell-types.mjs +102 -0
  168. package/fesm2022/edsis-angular-theme-shell.mjs +1352 -0
  169. package/fesm2022/edsis-angular-theme-styles.mjs +572 -0
  170. package/fesm2022/edsis-angular-theme.mjs +0 -0
  171. package/fesm2022/edsis-angular.mjs +5 -8
  172. package/navigation/README.md +576 -0
  173. package/package.json +477 -52
  174. package/sdk/README.md +212 -0
  175. package/sdk/schematics/collection.json +20 -0
  176. package/sdk/schematics/init/index.js +83 -0
  177. package/sdk/schematics/init/schema.json +19 -0
  178. package/sdk/schematics/ng-add/index.js +147 -0
  179. package/sdk/schematics/ng-add/schema.json +14 -0
  180. package/sdk/schematics/package.json +3 -0
  181. package/sdk/schematics/sdk/index.js +175 -0
  182. package/sdk/schematics/sdk/schema.json +19 -0
  183. package/sdk/sdk.config.example.json +24 -0
  184. package/sdk/src/config/loader.js +43 -0
  185. package/sdk/src/config/schema.js +59 -0
  186. package/sdk/src/emit/client.js +251 -0
  187. package/sdk/src/emit/metadata.js +310 -0
  188. package/sdk/src/emit/models.js +104 -0
  189. package/sdk/src/emit/navigation.js +56 -0
  190. package/sdk/src/emit/operations.js +118 -0
  191. package/sdk/src/emit/public-api.js +54 -0
  192. package/sdk/src/emit/services.js +110 -0
  193. package/sdk/src/engine.js +67 -0
  194. package/sdk/src/layout/per-domain.js +360 -0
  195. package/sdk/src/package.json +3 -0
  196. package/sdk/src/parser/bundle.js +25 -0
  197. package/sdk/src/parser/ir.js +429 -0
  198. package/sdk/src/parser/types.js +7 -0
  199. package/sdk/src/render/template.js +152 -0
  200. package/sdk/src/writer/index.js +286 -0
  201. package/theme/README.md +120 -0
  202. package/theme/component/settings/README.md +154 -0
  203. package/theme/layout/README.md +604 -0
  204. package/theme/page/README.md +505 -0
  205. package/theme/shell/README.md +344 -0
  206. package/theme/styles/README.md +202 -0
  207. package/theme/styles/css/base/components.css +577 -0
  208. package/theme/styles/css/base/index.css +14 -0
  209. package/theme/styles/css/base/package.css +9 -0
  210. package/theme/styles/css/base/prefers-dark.css +86 -0
  211. package/theme/styles/css/base/print.css +62 -0
  212. package/theme/styles/css/base/status.css +38 -0
  213. package/theme/styles/css/base/tailwind.css +208 -0
  214. package/theme/styles/css/base/theme.css +353 -0
  215. package/theme/styles/css/base/tokens.css +388 -0
  216. package/theme/styles/css/color/amber.css +72 -0
  217. package/theme/styles/css/color/blue.css +72 -0
  218. package/theme/styles/css/color/brand.css +38 -0
  219. package/theme/styles/css/color/cyan.css +72 -0
  220. package/theme/styles/css/color/emerald.css +72 -0
  221. package/theme/styles/css/color/fuchsia.css +72 -0
  222. package/theme/styles/css/color/green.css +72 -0
  223. package/theme/styles/css/color/index.css +19 -0
  224. package/theme/styles/css/color/indigo.css +72 -0
  225. package/theme/styles/css/color/lime.css +72 -0
  226. package/theme/styles/css/color/orange.css +72 -0
  227. package/theme/styles/css/color/pink.css +72 -0
  228. package/theme/styles/css/color/purple.css +72 -0
  229. package/theme/styles/css/color/red.css +72 -0
  230. package/theme/styles/css/color/rose.css +72 -0
  231. package/theme/styles/css/color/sky.css +72 -0
  232. package/theme/styles/css/color/teal.css +72 -0
  233. package/theme/styles/css/color/violet.css +72 -0
  234. package/theme/styles/css/color/yellow.css +72 -0
  235. package/theme/styles/css/fonts.css +85 -0
  236. package/theme/styles/css/index.css +18 -0
  237. package/theme/styles/css/neutral/gray.css +63 -0
  238. package/theme/styles/css/neutral/index.css +11 -0
  239. package/theme/styles/css/neutral/mauve.css +63 -0
  240. package/theme/styles/css/neutral/mist.css +63 -0
  241. package/theme/styles/css/neutral/neutral.css +63 -0
  242. package/theme/styles/css/neutral/olive.css +63 -0
  243. package/theme/styles/css/neutral/slate.css +63 -0
  244. package/theme/styles/css/neutral/stone.css +63 -0
  245. package/theme/styles/css/neutral/taupe.css +63 -0
  246. package/theme/styles/css/neutral/zinc.css +63 -0
  247. package/theme/styles/css/radius/index.css +30 -0
  248. package/theme/styles/css/space/index.css +20 -0
  249. package/types/edsis-angular-chart-area.d.ts +139 -0
  250. package/types/edsis-angular-chart-bar.d.ts +291 -0
  251. package/types/edsis-angular-chart-core.d.ts +822 -0
  252. package/types/edsis-angular-chart-line.d.ts +148 -0
  253. package/types/edsis-angular-chart-pie.d.ts +202 -0
  254. package/types/edsis-angular-chart-primitives.d.ts +360 -0
  255. package/types/edsis-angular-chart-radar.d.ts +198 -0
  256. package/types/edsis-angular-chart-radial.d.ts +187 -0
  257. package/types/edsis-angular-chart-scatter.d.ts +181 -0
  258. package/types/edsis-angular-chart.d.ts +3 -0
  259. package/types/edsis-angular-component-accordion.d.ts +139 -0
  260. package/types/edsis-angular-component-alert-dialog.d.ts +288 -0
  261. package/types/edsis-angular-component-alert.d.ts +72 -0
  262. package/types/edsis-angular-component-aspect-ratio.d.ts +20 -0
  263. package/types/edsis-angular-component-avatar.d.ts +111 -0
  264. package/types/edsis-angular-component-badge.d.ts +36 -0
  265. package/types/edsis-angular-component-breadcrumb.d.ts +85 -0
  266. package/types/edsis-angular-component-button-group.d.ts +50 -0
  267. package/types/edsis-angular-component-button.d.ts +44 -0
  268. package/types/edsis-angular-component-calendar.d.ts +150 -0
  269. package/types/edsis-angular-component-card.d.ts +123 -0
  270. package/types/edsis-angular-component-carousel.d.ts +155 -0
  271. package/types/edsis-angular-component-checkbox.d.ts +100 -0
  272. package/types/edsis-angular-component-collapsible.d.ts +68 -0
  273. package/types/edsis-angular-component-combobox.d.ts +105 -0
  274. package/types/edsis-angular-component-command.d.ts +215 -0
  275. package/types/edsis-angular-component-composer.d.ts +190 -0
  276. package/types/edsis-angular-component-context-menu.d.ts +64 -0
  277. package/types/edsis-angular-component-date-picker.d.ts +199 -0
  278. package/types/edsis-angular-component-dialog.d.ts +231 -0
  279. package/types/edsis-angular-component-drawer.d.ts +2 -0
  280. package/types/edsis-angular-component-dropdown-menu.d.ts +370 -0
  281. package/types/edsis-angular-component-editor.d.ts +234 -0
  282. package/types/edsis-angular-component-empty.d.ts +85 -0
  283. package/types/edsis-angular-component-form.d.ts +223 -0
  284. package/types/edsis-angular-component-hover-card.d.ts +133 -0
  285. package/types/edsis-angular-component-icon.d.ts +90 -0
  286. package/types/edsis-angular-component-input-group.d.ts +98 -0
  287. package/types/edsis-angular-component-input-otp.d.ts +249 -0
  288. package/types/edsis-angular-component-input.d.ts +31 -0
  289. package/types/edsis-angular-component-item.d.ts +169 -0
  290. package/types/edsis-angular-component-kanban.d.ts +165 -0
  291. package/types/edsis-angular-component-kbd.d.ts +25 -0
  292. package/types/edsis-angular-component-label.d.ts +19 -0
  293. package/types/edsis-angular-component-menubar.d.ts +123 -0
  294. package/types/edsis-angular-component-native-select.d.ts +39 -0
  295. package/types/edsis-angular-component-navigation-menu.d.ts +163 -0
  296. package/types/edsis-angular-component-pagination.d.ts +83 -0
  297. package/types/edsis-angular-component-pillbox.d.ts +380 -0
  298. package/types/edsis-angular-component-popover.d.ts +96 -0
  299. package/types/edsis-angular-component-progress.d.ts +45 -0
  300. package/types/edsis-angular-component-radio.d.ts +137 -0
  301. package/types/edsis-angular-component-resizable.d.ts +166 -0
  302. package/types/edsis-angular-component-scroll-area.d.ts +37 -0
  303. package/types/edsis-angular-component-segmented-control.d.ts +102 -0
  304. package/types/edsis-angular-component-select.d.ts +138 -0
  305. package/types/edsis-angular-component-separator.d.ts +26 -0
  306. package/types/edsis-angular-component-sheet.d.ts +240 -0
  307. package/types/edsis-angular-component-skeleton.d.ts +13 -0
  308. package/types/edsis-angular-component-slider.d.ts +148 -0
  309. package/types/edsis-angular-component-spinner.d.ts +31 -0
  310. package/types/edsis-angular-component-switch.d.ts +101 -0
  311. package/types/edsis-angular-component-table.d.ts +109 -0
  312. package/types/edsis-angular-component-tabs.d.ts +183 -0
  313. package/types/edsis-angular-component-textarea.d.ts +27 -0
  314. package/types/edsis-angular-component-timeline.d.ts +146 -0
  315. package/types/edsis-angular-component-toast.d.ts +60 -0
  316. package/types/edsis-angular-component-toggle-group.d.ts +161 -0
  317. package/types/edsis-angular-component-toggle.d.ts +47 -0
  318. package/types/edsis-angular-component-tooltip.d.ts +233 -0
  319. package/types/edsis-angular-component-utils-core.d.ts +175 -0
  320. package/types/edsis-angular-component-utils-overlay.d.ts +17 -0
  321. package/types/edsis-angular-component-utils-scale.d.ts +27 -0
  322. package/types/edsis-angular-component-utils.d.ts +2 -0
  323. package/types/edsis-angular-component.d.ts +1 -0
  324. package/types/edsis-angular-navigation-core.d.ts +55 -0
  325. package/types/edsis-angular-navigation-icon.d.ts +9 -0
  326. package/types/edsis-angular-navigation-service.d.ts +121 -0
  327. package/types/edsis-angular-navigation-types.d.ts +185 -0
  328. package/types/edsis-angular-navigation.d.ts +862 -0
  329. package/types/edsis-angular-sdk.d.ts +87 -0
  330. package/types/edsis-angular-theme-component-settings.d.ts +205 -0
  331. package/types/edsis-angular-theme-layout-services.d.ts +143 -0
  332. package/types/edsis-angular-theme-layout-types.d.ts +36 -0
  333. package/types/edsis-angular-theme-layout-wrapper.d.ts +670 -0
  334. package/types/edsis-angular-theme-layout.d.ts +218 -0
  335. package/types/edsis-angular-theme-page-core.d.ts +151 -0
  336. package/types/edsis-angular-theme-page-filter.d.ts +127 -0
  337. package/types/edsis-angular-theme-page-overview.d.ts +28 -0
  338. package/types/edsis-angular-theme-page-root.d.ts +172 -0
  339. package/types/edsis-angular-theme-page-side.d.ts +90 -0
  340. package/types/edsis-angular-theme-page-slots.d.ts +61 -0
  341. package/types/edsis-angular-theme-page.d.ts +7 -0
  342. package/types/edsis-angular-theme-shell-services.d.ts +188 -0
  343. package/types/edsis-angular-theme-shell-types.d.ts +102 -0
  344. package/types/edsis-angular-theme-shell.d.ts +178 -0
  345. package/types/edsis-angular-theme-styles.d.ts +295 -0
  346. package/types/edsis-angular-theme.d.ts +1 -0
  347. package/types/edsis-angular.d.ts +5 -2
  348. package/fesm2022/edsis-angular-block-shell.mjs +0 -1329
  349. package/fesm2022/edsis-angular-block-shell.mjs.map +0 -1
  350. package/fesm2022/edsis-angular-block-themes.mjs +0 -1007
  351. package/fesm2022/edsis-angular-block-themes.mjs.map +0 -1
  352. package/fesm2022/edsis-angular-module-auth.mjs +0 -2582
  353. package/fesm2022/edsis-angular-module-auth.mjs.map +0 -1
  354. package/fesm2022/edsis-angular-platform-mfe.mjs +0 -329
  355. package/fesm2022/edsis-angular-platform-mfe.mjs.map +0 -1
  356. package/fesm2022/edsis-angular-services-runtime.mjs +0 -385
  357. package/fesm2022/edsis-angular-services-runtime.mjs.map +0 -1
  358. package/fesm2022/edsis-angular.mjs.map +0 -1
  359. package/types/edsis-angular-block-shell.d.ts +0 -190
  360. package/types/edsis-angular-block-themes.d.ts +0 -94
  361. package/types/edsis-angular-module-auth.d.ts +0 -533
  362. package/types/edsis-angular-platform-mfe.d.ts +0 -126
  363. package/types/edsis-angular-services-runtime.d.ts +0 -118
@@ -0,0 +1,576 @@
1
+ # Navigation
2
+
3
+ `@edsis/angular/navigation` renders input-driven navigation with configurable types and instance-aware state.
4
+
5
+ ```ts
6
+ import {
7
+ NavigationContainerComponent,
8
+ NavigationSidebarComponent, // type: NavigationDockbar/Minidock/Navbar/FlyoutComponent
9
+ NavigationHeaderComponent,
10
+ NavigationContentComponent,
11
+ NavigationFooterComponent,
12
+ type NavigationItem,
13
+ } from '@edsis/angular/navigation';
14
+ import { NavigationService } from '@edsis/angular/navigation/service';
15
+
16
+ const items: NavigationItem[] = [
17
+ { id: 'dashboard', title: 'Dashboard', link: '/dashboard', icon: 'dashboard' },
18
+ {
19
+ id: 'reports',
20
+ title: 'Reports',
21
+ type: 'collapsible',
22
+ children: [{ id: 'monthly', title: 'Monthly', link: '/reports/monthly' }],
23
+ },
24
+ ];
25
+ ```
26
+
27
+ ```html
28
+ <Navigation id="erp-sidebar" [data]="items" class="h-full">
29
+ <NavigationSidebar>
30
+ <NavigationHeader class="px-1" [toggle]="true">
31
+ <div class="text-sm font-semibold">Workspace</div>
32
+ </NavigationHeader>
33
+
34
+ <NavigationContent />
35
+
36
+ <NavigationFooter class="p-3">
37
+ <button type="button">Sign out</button>
38
+ </NavigationFooter>
39
+ </NavigationSidebar>
40
+ </Navigation>
41
+
42
+ <Navigation id="erp-topbar" [data]="items">
43
+ <NavigationNavbar />
44
+ </Navigation>
45
+ ```
46
+
47
+ Type dipilih lewat komponen anak deklaratif (`NavigationSidebar`, `NavigationDockbar`, `NavigationMinidock`, `NavigationNavbar`, atau `NavigationFlyout`), satu type hidup per `<Navigation>`. Di dalam type, `NavigationHeader` dan `NavigationFooter` opsional, sedangkan `NavigationContent` selalu dirender (otomatis dibuat bila tidak diproyeksikan).
48
+
49
+ ## API Notes
50
+
51
+ - `data` is the source of navigation data.
52
+ - Type is declared by the child component: `NavigationSidebar`/`NavigationDockbar`/`NavigationMinidock` (vertical), `NavigationNavbar`/`NavigationFlyout` (horizontal). Orientation is implied by the type child.
53
+ - `id` identifies a navigation instance so multiple navs can keep distinct service state.
54
+ - `data-id` optionally publishes the input data under a different registry id. This lets a
55
+ mobile mirror use isolated state (`id="main-mobile"`) while exposing the same data contract
56
+ as the desktop navigation (`data-id="main"`).
57
+ - `position` on `NavigationSidebar`/`NavigationDockbar`/`NavigationMinidock` accepts `left` or `right` (vertical).
58
+ - `collapsed` on `NavigationSidebar` controls the icon-only sidebar state.
59
+ - `mode` on `NavigationDockbar` accepts `sticky` or `drawer`.
60
+ - `dockbar-route-context` on `NavigationDockbar` opts into Router-aware header, rail deduplication,
61
+ and sticky-panel restore behavior. Pass `true` for the default Angular Router adapter or a
62
+ `NavigationDockbarRouteConfig` to override URL, metadata, or the fallback icon.
63
+ - `badge-context` on `Navigation` supplies one reactive badge registry for every navigation type, keyed by
64
+ `NavigationItem.badge.source` (and route `data.navigationBadge` for the dockbar header).
65
+ `NavigationDockbar` also accepts `badge-context`; its legacy `dockbar-badge` input remains supported.
66
+ - `ariaLabel` overrides the host navigation label and defaults to `Primary navigation`.
67
+ - `label` on `NavigationFlyout` sets the single trigger label and defaults to `Menu`.
68
+ - `icon` on `NavigationFlyout` renders a Lucide icon on the trigger (the name must be registered with `provideIcons()`); `icon-position` (`start`/`end`) sets its placement and `icon-only` hides the label visually while keeping it as the accessible name (compact mode is always icon-only and falls back to the `menu` icon).
69
+ - `nav-position` on `NavigationNavbar`/`NavigationFlyout` accepts `top` (default) or `bottom`. With `bottom`, the navbar grid panel opens upward with squared bottom corners, and the flyout panel anchors to the container's bottom edge with the tab row docked at the bottom — seamless for bars placed below the content.
70
+ - `nav-appearance` on `NavigationNavbar`/`NavigationFlyout` accepts `flat` or `border-rail` (same vocabulary as the layout's `layout-appearance`). `border-rail` squares the panel (no rounding), frames entry icons with dimmed blueprint-style rail lines plus dashed center cross lines (instead of rounded boxes), renders the nested-collapse rail dashed, and replaces hover/active backgrounds with primary-colored text. `flat` keeps the current visuals.
71
+ - The `navbar` type renders root items inline immediately; clicking a group (hover does not open it) opens a full-width grid panel below the bar with the same flyout-style entries, responsive columns, and nested collapse. Root group triggers intentionally render without a chevron; open state remains available through the trigger styling and `aria-expanded`.
72
+ - The `flyout` type renders one trigger button that opens a floating panel overlaying the parent container exactly (same top position and width, covering the trigger with no visible gap; `display: contents` wrappers are skipped when measuring the container). A `trigger-floating` popover keeps the 22rem / 85vw default through `--nav-flyout-floating-width` and `--nav-flyout-floating-max-width`, while `--nav-flyout-floating-radius` can align its card with a containing shell. Use `trigger-class` only for the floating host/placement and `trigger-button-class` for trigger-specific styling; the latter never leaks into panel items. Add `panel-viewport` when window chrome needs the floating panel fixed to `top: 0` and both viewport edges; these options let desktop chrome place and shape the same interaction without changing the global default. The panel explicitly opts out of native window drag regions so its controls remain clickable inside desktop chrome. Root items with children become the horizontal navigation inside the panel (their `icon` renders in the row), their children render as title/subtitle entries in a responsive grid (1 column on mobile, 2 from `sm`, 3 from `md`, 4 from `lg` and up; `columns` caps the maximum at 1–4), and deeper children render as a vertical collapse below their entry — expanded by default every time the panel opens, collapsible per entry via the chevron, with the child icons aligned on the same vertical line as the parent entry icon. The panel closes on `Escape`, outside clicks, the close button, or leaf selection.
73
+ - Items with children render a `chevron_right` icon pinned at the right edge and vertically centered: it points right by default and rotates down (in place, no layout shift) only while open — hover does not move it. This applies to flyout tabs and entries plus collapsible items; navbar root branch triggers are the deliberate exception.
74
+ - Angular Router is supported for internal links through `link`, `queryParams`, `fragment`, `exactMatch`, and `isActiveMatchOptions`.
75
+ - External links can use `href` or `link` with `externalLink: true`.
76
+ - `activeIds` lets consumers force active state by nav id or normalized key.
77
+ - `activeUrl` lets consumers drive active matching without relying on the current router URL.
78
+ - `openedIds` owns collapsible state and supports two-way binding.
79
+ - `previewExpanded` on `NavigationSidebar` forces a collapsed sidebar instance to render in expanded-preview mode.
80
+ - `itemSelected` emits for action, router, and external items.
81
+ - `class` applies classes to the host `nav` element.
82
+ - `itemClass` applies shared classes to rendered items.
83
+ - `nav-group-class` (`groupClass`) applies Tailwind classes to the container of each horizontal group — the flyout tab `<li>` and the navbar group `<li>` — so consumers can tune height, padding, or borders of the group container. Per-group control is also available via `item.classes.container`.
84
+ - `compact` is still supported as a compatibility alias for collapsed vertical sidebars.
85
+ - `nav-sidebar-collapse` on `NavigationSidebar` enables hover-preview behavior for collapsed vertical sidebars.
86
+ - `collapse-tree` accepts `stairs` or `straight` for nested collapsible connector styling.
87
+ - `NavigationHeader` is optional, accepts Tailwind classes through `class`, and can render a built-in collapse toggle with `[toggle]="true"`.
88
+ - `NavigationFooter` is optional and accepts Tailwind classes through `class`.
89
+ - `NavigationContent` wraps the active navigation renderer and owns the scrollable region between the optional header and footer slots. It is rendered automatically by the type component when not projected, and accepts `class` when used explicitly.
90
+
91
+ ## Nav Inputs And Outputs
92
+
93
+ Inputs pada `<Navigation>` (container):
94
+
95
+ `[badge-context]` accepts `NavigationBadgeContext | null` and defaults to the type registry or an empty registry.
96
+
97
+ | API | Type | Notes |
98
+ | ----------------- | -------------------------------------------------- | ------------------------------------------------------------------------------- |
99
+ | `id` | `string` | Navigation instance id. `main` is the only id persisted to `localStorage`. |
100
+ | `data-id` | `string \| null` | Optional data registry id; defaults to the normalized navigation `id`. |
101
+ | `data` | `readonly NavigationItem[]` | Source of navigation items. |
102
+ | `ariaLabel` | `string` | Accessible label on the host navigation landmark. |
103
+ | `compact` | `boolean` | Compatibility alias for collapsed-rail item layout. |
104
+ | `collapse-tree` | `stairs \| straight` | Controls nested connector styling for collapsible items. |
105
+ | `class` | `string` | Extra classes for the host `nav`. |
106
+ | `itemClass` | `string` | Shared classes applied to rendered nav items. |
107
+ | `nav-group-class` | `string` | Classes for each horizontal group container (flyout tab / navbar group `<li>`). |
108
+ | `activeIds` | `ReadonlySet<string> \| readonly string[] \| null` | Explicit active state override by item id or normalized key. |
109
+ | `activeUrl` | `string \| null` | Explicit URL used during active matching. |
110
+ | `openedIds` | `readonly string[]` | Two-way bound open state for collapsible items. |
111
+ | `itemSelected` | `NavigationSelection` | Emits when a leaf item is selected. |
112
+
113
+ Inputs pada komponen type:
114
+
115
+ | Component | API | Type | Notes |
116
+ | -------------------- | ----------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------- |
117
+ | `NavigationSidebar` | `position` | `left \| right \| null` | Side the rail docks to. |
118
+ | `NavigationSidebar` | `collapsed` | `boolean \| null` | Controls collapsed vertical sidebar state. |
119
+ | `NavigationSidebar` | `nav-sidebar-collapse` | `boolean` | Enables hover-driven preview expansion on collapsed sidebars. |
120
+ | `NavigationSidebar` | `previewExpanded` | `boolean` | Forces a collapsed sidebar to render expanded for preview. |
121
+ | `NavigationDockbar` | `mode` | `sticky \| drawer \| null` | Docked aside beside the rail, or overlay drawer. |
122
+ | `NavigationDockbar` | `position` | `left \| right \| null` | Side the rail docks to. |
123
+ | `NavigationDockbar` | `dockbar-route-context` | `boolean \| NavigationDockbarRouteConfig \| null` | Opt-in Router context and optional overrides. |
124
+ | `NavigationDockbar` | `dockbar-badge` | `NavigationBadgeContext` | Reactive badge sources keyed by item or route metadata. |
125
+ | `NavigationMinidock` | `position` | `left \| right \| null` | Side the rail docks to. The separating border is set through `class`. |
126
+ | `NavigationNavbar` | `nav-appearance` | `flat \| border-rail` | Style variant. `border-rail` = squared panel, dashed icon rails, no hover bg. |
127
+ | `NavigationFlyout` | `label` | `string` | Trigger label. Defaults to `Menu`. |
128
+ | `NavigationFlyout` | `nav-appearance` | `flat \| border-rail` | Style variant. `border-rail` = squared panel, dashed icon rails, no hover bg. |
129
+
130
+ Semua type juga menerima `class` untuk kelas tambahan pada elemen shell-nya.
131
+
132
+ ## NavigationItem
133
+
134
+ `NavigationItem` supports deeper trees, mixed item kinds, and both router and external navigation.
135
+
136
+ | Field | Type | Notes |
137
+ | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
138
+ | `id` | `string` | Stable item id. Reused for active/open state when present. |
139
+ | `type` | `item \| basic \| aside \| group \| collapsible \| collapsable \| mega \| divider \| spacer` | `collapsable` is accepted as a compatibility alias of `collapsible`. |
140
+ | `title`, `subtitle`, `tooltip` | `string` | Primary labels and optional compact tooltip. |
141
+ | `active`, `disabled` | `boolean` | Explicit active and disabled flags. |
142
+ | `icon` | `string` | Rendered through the default icon slot unless overridden. |
143
+ | `badge` | `{ title?: string; classes?: string; source?: string }` | Static item label plus an optional shared badge-source key. |
144
+ | `classes` | `{ wrapper?, container?, icon?, title?, subtitle? }` | Per-item class overrides. `container` targets the horizontal group `<li>` wrapper. |
145
+ | `meta` | `Record<string, unknown>` | Consumer-owned metadata bag. |
146
+ | `isHidden` | `(item) => boolean` | Filters items at normalization time. |
147
+ | `link` | `string \| readonly unknown[] \| UrlTree` | Angular Router link target. |
148
+ | `href` | `string` | Direct external URL. |
149
+ | `queryParams`, `queryParamsHandling`, `fragment`, `preserveFragment` | Router options | Extra Angular Router navigation options. |
150
+ | `externalLink`, `target`, `rel` | link options | External navigation behavior. A `rel` is unioned with `noopener noreferrer` on `_blank`/external links, never replacing it. |
151
+ | `exactMatch`, `isActiveMatchOptions` | Router match options | Control how router activity is resolved. |
152
+ | `action` | `(item) => void` | Callback for action-driven leaf items. |
153
+ | `columns` | `number` | Column count for `mega` style items. |
154
+ | `children` | `readonly NavigationItem[]` | Nested items. Trees can be deeper than one level. |
155
+
156
+ ## Minidock
157
+
158
+ `NavigationMinidock` is a permanent vertical icon rail. It renders exactly like a collapsed
159
+ sidebar (`--layout-sidebar-collapsed-width`, `--nav-rail-item-size`, a tooltip per item, a two
160
+ letter fallback for items without an icon), but it never expands: there is no `collapsed` input,
161
+ no `nav-sidebar-collapse`, no hover or focus preview, no header toggle, and
162
+ `NavigationService.toggleCollapsed()` does nothing for it. Its stored `nav-type-mode` is always
163
+ `default`.
164
+
165
+ ```html
166
+ <Navigation id="app-rail" [data]="items" class="h-full">
167
+ <NavigationMinidock class="border-r border-border" />
168
+ </Navigation>
169
+ ```
170
+
171
+ The data contract is strict. Minidock only accepts `basic`, `item`, or untyped items without
172
+ children, plus `divider` and `spacer`. Any `group`, `collapsible`, `collapsable`, `mega`, or
173
+ `aside` item, or any item with non empty `children` (hidden items included), throws an `Error`
174
+ in development **and production**. The error reaches Angular's `ErrorHandler` and names the item
175
+ index, its title, and the rejected type, for example
176
+ `Item [2] "Component" bertipe "group".`
177
+
178
+ Flatten grouped data with `toMinidockItems()` from `@edsis/angular/navigation/types`.
179
+ It is a pure function whose output always passes that check, and it is the safe path for data
180
+ that comes from a backend:
181
+
182
+ ```ts
183
+ import { toMinidockItems } from '@edsis/angular/navigation/types';
184
+
185
+ protected readonly railItems = computed(() => toMinidockItems(this.items()));
186
+ ```
187
+
188
+ - Leaves are kept as the same object, unless a parent's `isHidden` has to be merged in.
189
+ - `group` and `mega` (at any level) become a divider boundary and their content is flattened;
190
+ an empty group adds no divider.
191
+ - `collapsible`, `collapsable`, and `aside` are dropped as parents; their children are lifted.
192
+ - Leading, trailing, and repeated dividers are compacted; `spacer` survives only at the top level.
193
+ - A leaf whose `id` repeats is kept once (first occurrence wins).
194
+ - A lifted leaf is hidden when any of its parents is hidden, and a group's boundary divider hides
195
+ with that group.
196
+
197
+ A `spacer` pushes every item after it to the bottom of the rail. `LayoutWrapperDefault` offers
198
+ the type as `nav-type="minidock"` on a vertical layout: it renders `LayoutNavMinidock` with
199
+ `toMinidockItems(data())` under the data id `main-minidock`, and keeps publishing the full
200
+ `data()` under `main`.
201
+
202
+ Adding `'minidock'` widens `NavigationVerticalType` (and so `NavigationType`). The change is
203
+ additive, but a consumer `switch` that is exhaustive over `NavigationType` needs a `minidock`
204
+ branch before it compiles again.
205
+
206
+ ## Route-aware dockbar
207
+
208
+ The feature is opt-in so existing dockbar, sidebar, navbar, and flyout consumers keep their
209
+ current rendering. Once enabled, the library resolves the active root entry from the Angular
210
+ Router URL: either the root entry's own link or any nested descendant link can match.
211
+
212
+ ```ts
213
+ import { signal } from '@angular/core';
214
+ import type {
215
+ NavigationBadgeContext,
216
+ NavigationItem,
217
+ NavigationRouteData,
218
+ } from '@edsis/angular/navigation';
219
+
220
+ export const notificationsRoute = {
221
+ path: 'notifications',
222
+ loadComponent: () => import('./notifications.page').then((module) => module.NotificationsPage),
223
+ data: {
224
+ navigationIcon: 'notifications',
225
+ navigationBadge: 'unreadNotifications',
226
+ navigationLabel: 'Notifications',
227
+ } satisfies NavigationRouteData,
228
+ };
229
+
230
+ export class AppNavigation {
231
+ readonly unreadNotifications = signal(0);
232
+
233
+ readonly badgeContext: NavigationBadgeContext = {
234
+ unreadNotifications: {
235
+ value: this.unreadNotifications,
236
+ ariaLabel: (count) => `${count} unread notifications`,
237
+ },
238
+ };
239
+
240
+ readonly items: readonly NavigationItem[] = [
241
+ {
242
+ id: 'permission',
243
+ title: 'Permission',
244
+ icon: 'admin_panel_settings',
245
+ children: [{ id: 'permission-groups', title: 'Groups', link: '/permission/group' }],
246
+ },
247
+ ];
248
+ }
249
+ ```
250
+
251
+ ```html
252
+ <Navigation id="main" [data]="items">
253
+ <NavigationDockbar [dockbar-route-context]="true" [dockbar-badge]="badgeContext" />
254
+ </Navigation>
255
+ ```
256
+
257
+ When a navigation root is active, the header uses that root's icon (or
258
+ `NAVIGATION_DOCKBAR_FALLBACK_ICON` when the root has no icon). When no navigation root matches,
259
+ it uses the deepest active route's `navigationIcon`, then the library fallback. When the built-in
260
+ route header is visible, its active root entry is structurally removed from the rail, preserving
261
+ every other entry's order without CSS hiding or an empty slot. Route metadata can still provide a
262
+ badge for an active navigation group when the item itself has no `badge.source`.
263
+
264
+ In sticky mode, clicking another root group opens that group's aside without changing the URL.
265
+ Moving the pointer anywhere inside the rail, header, aside, or footer keeps it open. Leaving the
266
+ complete dockbar restores the route's active group; if the route has no navigation group, it
267
+ closes the aside. Drawer Escape, backdrop, close-button, and focus-return behavior are unchanged.
268
+
269
+ `NavigationBadgeSource.value` accepts a number, Angular `Signal`, RxJS `Observable`, or callback.
270
+ Zero and invalid values are hidden, `1` through `99` render unchanged, and larger counts render
271
+ as `99+` while the configured accessible label receives the real count. Badge keys and labels are
272
+ domain-neutral.
273
+
274
+ A projected `NavigationHeader` continues to take precedence over the built-in route header. In
275
+ that case the library leaves the rail intact because it cannot infer whether custom projected
276
+ content renders the active icon. `LayoutNavDockbar` and `LayoutWrapperDefault` expose the same
277
+ `dockbar-route-context` and `dockbar-badge` pass-through inputs; enabling them replaces the compact
278
+ brand header with the built-in route header.
279
+
280
+ ## Public Shell APIs
281
+
282
+ - `NavigationHeader` exposes `[toggle]` and `class`.
283
+ - `NavigationFooter` exposes `class`.
284
+ - `NavigationContent` exposes `class` and renders the active type menu; declare it explicitly to control slot order, or omit it for the automatic default.
285
+ - `[NavigationCollapseRoot]` adjusts layout for collapsible shell content when the sidebar rail is collapsed.
286
+ - `[NavigationCollapseExpanded]` only renders its template while the vertical shell is not in collapsed display mode.
287
+
288
+ ```html
289
+ <div NavigationCollapseRoot class="flex items-center gap-3 px-3">
290
+ <Icon name="work" />
291
+
292
+ <span *NavigationCollapseExpanded>Workspace</span>
293
+ </div>
294
+ ```
295
+
296
+ ## Nav Service
297
+
298
+ `@edsis/angular/navigation/service` exposes `NavigationService` as a singleton registry for navigation type and overlay state.
299
+
300
+ ```ts
301
+ import { NavigationService } from '@edsis/angular/navigation/service';
302
+
303
+ const nav = inject(NavigationService);
304
+
305
+ nav.setType('erp-sidebar', 'dockbar');
306
+ nav.setCollapsed('erp-sidebar', true);
307
+ nav.toggleCollapsed('erp-sidebar');
308
+ nav.setPosition('erp-sidebar', 'right');
309
+ nav.setDockbarMode('erp-sidebar', 'drawer');
310
+ nav.openDrawer('erp-sidebar');
311
+ nav.closeDrawer('erp-sidebar');
312
+ ```
313
+
314
+ Available service helpers include:
315
+
316
+ - `register`, `unregister`, `state`, `currentState`, and `update` for instance lifecycle and state access.
317
+ - `setType`, `setPosition`, `setCollapsed`, `toggleCollapsed`, and `setDockbarMode` for instance configuration.
318
+ - `currentPanelKey`, `isPanelOpen`, `openPanel`, `togglePanel`, and `closePanel` for flyout or mega-panel state.
319
+ - `isDrawerOpen`, `openDrawer`, `toggleDrawer`, and `closeDrawer` for drawer dockbar mode.
320
+ - `exactMatchOptions` and `subsetMatchOptions` for router matching defaults.
321
+ - `routeContext` for the current Router URL plus deepest `navigationIcon`, `navigationBadge`, and
322
+ `navigationLabel` metadata.
323
+
324
+ Panel methods accept exactly one of these forms: `openPanel(item)` for the default navigation,
325
+ or `openPanel(navId, item)` for an explicit instance. The same overload contract applies to
326
+ `isPanelOpen` and `togglePanel`; a string without an item is rejected at compile time and throws
327
+ a diagnostic error for untyped runtime callers.
328
+
329
+ Data publication is owner-aware. If desktop and mobile navigation publish the same `data-id`,
330
+ destroying an older publisher cannot clear the newer one; when the newest publisher is destroyed,
331
+ the registry falls back to the most recent remaining live publisher.
332
+
333
+ Navigation UI depends on the `NAVIGATION_ADAPTER` contract, not directly on the
334
+ service class. The default token factory uses `NavigationService`; an application
335
+ can override the token with a compatible adapter to change persistence or state
336
+ ownership without replacing the components.
337
+
338
+ Router metadata is supplied through the separate `NAVIGATION_ROUTE_CONTEXT_ADAPTER` token. This
339
+ keeps existing custom `NavigationAdapter` implementations source-compatible; override the route
340
+ token only when the application uses a nonstandard Router/state host. Its matcher must recursively
341
+ compare only item links against the supplied URL (never `item.active` or `activeIds`) and honor the
342
+ item's complete `IsActiveMatchOptions` contract.
343
+
344
+ ```ts
345
+ interface NavigationRouteContextAdapter {
346
+ readonly routeContext: Signal<NavigationResolvedRouteContext>;
347
+ isItemRouteActive(
348
+ item: NavigationNormalizedItem,
349
+ explicitActiveUrl: string | null,
350
+ relativeTo?: ActivatedRoute | null,
351
+ ): boolean;
352
+ }
353
+ ```
354
+
355
+ ```ts
356
+ import {
357
+ NAVIGATION_ADAPTER,
358
+ NAVIGATION_ROUTE_CONTEXT_ADAPTER,
359
+ } from '@edsis/angular/navigation/core';
360
+
361
+ const providers = [
362
+ { provide: NAVIGATION_ADAPTER, useExisting: WorkspaceNavigationAdapter },
363
+ { provide: NAVIGATION_ROUTE_CONTEXT_ADAPTER, useExisting: WorkspaceRouteContextAdapter },
364
+ ];
365
+ ```
366
+
367
+ Only the primary sidebar navigation (`id="main"`) persists preferences in `localStorage` under:
368
+
369
+ - `nav-orientation`
370
+ - `nav-type`
371
+ - `nav-position`
372
+ - `nav-type-mode`
373
+
374
+ `nav-type-mode` depends on the active vertical type:
375
+
376
+ - sidebar: `default` or `collapsed`
377
+ - dockbar: `sticky` or `drawer`
378
+
379
+ Any other navigation id, such as `erp-navbar`, only keeps its state in memory for the active instance. Consumers should provide those values explicitly at usage time or rely on the built-in defaults.
380
+
381
+ ## Icons
382
+
383
+ Saat `item.icon` tersedia, `nav` merender ikon Lucide secara default melalui `@edsis/angular/component/icon`. `item.icon` adalah nama kebab Lucide (misalnya `layout-dashboard`) dan harus didaftarkan lewat `provideIcons()` di aplikasi; ikon tetap milik komponen navigasi (toggle header, chevron, tombol tutup dockbar, ikon rute fallback `route`) didaftarkan oleh komponennya sendiri. Nama yang tidak terdaftar tidak merender ikon dan menulis satu warning di dev mode.
384
+
385
+ ```html
386
+ <Navigation [data]="items">
387
+ <NavigationSidebar />
388
+ </Navigation>
389
+ ```
390
+
391
+ Gunakan template `NavigationIcon` hanya bila consumer ingin override renderer bawaan.
392
+
393
+ ```html
394
+ <Navigation [data]="items">
395
+ <NavigationSidebar />
396
+
397
+ <ng-template NavigationIcon let-icon let-item="item" let-active="active" let-level="level">
398
+ <Icon [name]="icon" class="text-primary" />
399
+ </ng-template>
400
+ </Navigation>
401
+ ```
402
+
403
+ `NavigationIcon` template context exposes:
404
+
405
+ - `$implicit` and `icon`: resolved icon name.
406
+ - `item`: source `NavigationItem`.
407
+ - `active`: current active state.
408
+ - `orientation`: current nav orientation.
409
+ - `level`: current nesting depth.
410
+
411
+ ## Boundaries
412
+
413
+ Entry point ini tetap extensible di layer consumer. Type defaults, instance registration, overlay state, dan affordance icon bawaan dikelola di library, sementara consumer masih bisa mengganti renderer icon dan komposisi layout sesuai kebutuhan.
414
+
415
+ ## Bundle / performance
416
+
417
+ `NavigationContent` me-render renderer sesuai type aktif. Renderer yang lebih jarang
418
+ dipakai — **flyout**, **horizontal/navbar**, dan **dockbar** — dibungkus `@defer (on immediate)`
419
+ sehingga bundler aplikasi memecahnya menjadi lazy chunk: aplikasi yang hanya memakai
420
+ **sidebar** (vertical list, renderer default yang tetap eager) tidak ikut membundel ketiga
421
+ renderer tersebut. Tidak ada perubahan API — komposisi `<Navigation><NavigationSidebar>…`
422
+ tetap sama; hanya distribusi chunk di sisi consumer yang lebih ringan.
423
+
424
+ ## Support and security
425
+
426
+ Angular 22.2–22.x CSR/browser usage is supported; SSR, prerendering, and hydration are not. See the
427
+ bundled `SUPPORT.md`. Report suspected vulnerabilities privately using the instructions in the
428
+ bundled `SECURITY.md`. This package is MIT licensed; see the bundled `LICENSE`.
429
+
430
+ ## Shared reactive badge counts
431
+
432
+ All navigation types use the same `NavigationBadgeContext`. Bind it to `[badge-context]` on
433
+ `Navigation`. Items only carry a source key, so updating a Signal or Observable does not rebuild
434
+ the navigation tree. The registry belongs to the consumer, with no global or per-type registry.
435
+ The library performs no fetching, polling, authentication, sockets, or business counting.
436
+
437
+ ```ts
438
+ import { signal } from '@angular/core';
439
+ import { BehaviorSubject } from 'rxjs';
440
+ import type { NavigationBadgeContext, NavigationItem } from '@edsis/angular/navigation';
441
+
442
+ // Members of the consumer component:
443
+ readonly taskCount = signal(3);
444
+ readonly reviewCount$ = new BehaviorSubject<number | null>(10);
445
+ readonly navigation: readonly NavigationItem[] = [
446
+ { id: 'tasks', title: 'Tugas', icon: 'circle-check-big', link: '/my/tasks', badge: { source: 'tasks' } },
447
+ { id: 'reviews', title: 'Review', icon: 'file', link: '/my/reviews', badge: { source: 'reviews' } },
448
+ { id: 'guide', title: 'Panduan', link: '/guide', badge: { title: 'New' } },
449
+ ];
450
+ readonly badgeContext: NavigationBadgeContext = {
451
+ tasks: { value: this.taskCount, ariaLabel: count => `${count} tugas` },
452
+ reviews: { value: this.reviewCount$, ariaLabel: count => `${count} review` },
453
+ };
454
+
455
+ // Run these in consumer event handlers after updating consumer data:
456
+ // this.taskCount.set(120);
457
+ // this.reviewCount$.next(99);
458
+ ```
459
+
460
+ ```html
461
+ <Navigation id="main" [data]="navigation" [badge-context]="badgeContext">
462
+ <NavigationSidebar />
463
+ </Navigation>
464
+ ```
465
+
466
+ Replace the type child with `NavigationMinidock`, `NavigationDockbar`, `NavigationNavbar`, or
467
+ `NavigationFlyout` without changing the registry. Minidock still requires flat navigation items;
468
+ use `toMinidockItems()` for a tree. Register icon names with `provideIcons()` as usual. Multiple
469
+ `Navigation` instances can bind the same registry and react together.
470
+
471
+ `NavigationBadgeSource.value` accepts `number | null | undefined`, `Signal`, `Observable`, or a
472
+ zero-argument reader returning that count. Reader functions are evaluated during Angular checks;
473
+ reading signals inside them tracks those signals. A plain external variable needs an Angular change
474
+ notification, so prefer Signal or Observable for asynchronous updates.
475
+
476
+ Finite numeric values are truncated toward zero before display and accessible labeling. Zero,
477
+ negative values, null, undefined, NaN, Infinity, and unknown source keys hide the badge. Values
478
+ 1–99 display their number; values above 99 display `99+`. The `ariaLabel` callback receives the
479
+ normalized, uncapped count. A string can supply a complete accessible label; without a label the
480
+ fallback is `<count> items`. Keep the actual count in consumer labels, including when capped.
481
+ Source keys are resolved as own registry properties. When `source` is present it takes precedence
482
+ over `title`, even when that source is missing or hidden. Text-only `badge.title` remains supported.
483
+
484
+ Observable errors hide the badge. Source replacement unsubscribes the previous Observable and
485
+ never renders its cached count for the replacement. Destroying a badge view unsubscribes it.
486
+ Changing a sidebar between labelled, collapsed, hover, and keyboard preview layouts keeps the same
487
+ badge view and subscription, including the last emission from a non-replaying Observable.
488
+ Within one `Navigation`, badges share one upstream subscription per Observable identity, including
489
+ parent totals and child badges. Sources referenced by the visible normalized navigation tree or
490
+ built-in route header stay subscribed while their data remains available, including while panels
491
+ are closed or an active root moves between rail and header. Unreferenced registry keys are ignored.
492
+ Removing the last data and view reference discards its cached replay, including completed cold
493
+ Observables, so restoring navigation data reads fresh counts. Replacing sources unsubscribes the
494
+ old stream, and destroying the navigation releases all subscriptions. Sources that remain in use
495
+ retain their last emission when another descendant changes. Separate `Navigation` instances have separate lifetimes;
496
+ use `shareReplay({ bufferSize: 1, refCount: true })` in the consumer to share work across instances.
497
+
498
+ Labelled items reserve space at the right for a nonshrinking red pill. Count badges use
499
+ `destructive` / `destructive-foreground`, 20px minimum width and height, 10px type, and 4px inline
500
+ padding at normal density. Collapsed sidebar, minidock, and dockbar rails show a smaller 16px badge
501
+ over the icon corner, without changing the item hit area. A sidebar hover or keyboard preview uses
502
+ the labelled version, with one badge per item. Geometry follows the theme space axis through
503
+ `--nav-count-height`, `--nav-count-compact-height`, `--nav-count-padding`, and `--nav-count-offset`;
504
+ font size uses `--nav-count-font-size`. Static text badges retain their existing styling.
505
+
506
+ ### Parent totals
507
+
508
+ Parents without their own badge automatically sum the unique `badge.source` keys anywhere in their
509
+ visible descendant tree, after `isHidden` filtering. A hidden branch contributes nothing, including
510
+ its children. Missing keys and invalid counts contribute zero. Each count is normalized before
511
+ addition, so negative or fractional invalid values cannot cancel other sources. A total of zero
512
+ hides the badge. A total of 120 displays `99+` with the accessible label `120 items`.
513
+
514
+ ```ts
515
+ readonly taskCount = signal(3);
516
+ readonly reviewCount = signal(5);
517
+ readonly badgeContext: NavigationBadgeContext = {
518
+ tasks: { value: this.taskCount, ariaLabel: count => `${count} tugas` },
519
+ reviews: { value: this.reviewCount }, // Observable and callback readers work here too.
520
+ management: { value: 4 },
521
+ };
522
+ readonly navigation: readonly NavigationItem[] = [{
523
+ id: 'management', title: 'Manajemen', icon: 'folder',
524
+ children: [
525
+ { title: 'Tugas', badge: { source: 'tasks' }, link: '/tasks' },
526
+ { title: 'Review', badge: { source: 'reviews' }, link: '/reviews' },
527
+ { title: 'Tugas lainnya', badge: { source: 'tasks' }, link: '/other-tasks' },
528
+ ],
529
+ }];
530
+ // Manajemen displays 8, counting tasks once.
531
+ // this.reviewCount.set(0) changes the total to 3.
532
+ // this.reviewCount.set(117) changes it to 99+ (accessible label: 120 items).
533
+ ```
534
+
535
+ Priority applies independently at each parent:
536
+
537
+ 1. `badge: { source: 'management' }` displays only that source, here `4`, without adding children.
538
+ A missing or zero own source hides the badge; it does not fall back to descendants.
539
+ 2. `badge: { title: 'New' }` keeps the existing static text badge instead of replacing it with a total.
540
+ 3. Otherwise, descendant source keys produce the automatic total. Ancestors still collect source
541
+ keys throughout their descendant tree, rather than summing already accumulated parent badges.
542
+
543
+ Automatic totals use the shared red count pill and the default `<total> items` accessible label;
544
+ child labels and source style overrides do not override the aggregate label or color. To supply a
545
+ custom aggregate label or business total, compute it in the consumer and bind it as the parent's own
546
+ source. The consumer continues to own data fetching and updates; the library does no requests or polling.
547
+
548
+ Expanded sidebar, navbar, and flyout parents place the count after their label, including submenu
549
+ triggers. Collapsed sidebar and dockbar group triggers place it over the icon corner. Opening a
550
+ dockbar panel keeps each child's own badge. With `dockbar-route-context`, an active group keeps its
551
+ total when its icon moves from the rail to the built-in route header. Existing explicit route metadata
552
+ badge keys keep their fallback priority in that header. Minidock accepts flat items only, so it never renders
553
+ parent totals. `toMinidockItems()` preserves individual leaf badges without copying parent totals.
554
+
555
+ Sidebar items with `type: 'group'` are section headings and never display count badges, including
556
+ their own `badge.source` or an automatic descendant total. Their children keep individual counts,
557
+ and a text-only `badge.title` on the heading still displays. Sidebar collapsible parents and group
558
+ items in dockbar, navbar, and flyout retain the count behavior described above. Toggle **Group heading**
559
+ in the showcase's **Parent totals** example to compare these cases.
560
+
561
+ ### Migration
562
+
563
+ Existing `<NavigationDockbar [dockbar-badge]="registry" />` continues to work, including its
564
+ route-context header and aside. Prefer moving the binding to its parent:
565
+
566
+ ```html
567
+ <Navigation [data]="navigation" [badge-context]="registry">
568
+ <NavigationDockbar [dockbar-route-context]="true" />
569
+ </Navigation>
570
+ ```
571
+
572
+ For a dockbar-only assembly, `[badge-context]` is also accepted on `NavigationDockbar`.
573
+ If both old and new dockbar inputs are bound, its generic input wins. A registry on `Navigation`
574
+ takes precedence over the type-level registry as a whole (including an explicit empty object).
575
+ `LayoutWrapperDefault` also accepts `[badge-context]` for every desktop navigation type and its
576
+ mobile sidebar; `[dockbar-badge]` remains its fallback for compatibility.