@edsis/angular 22.1.6 → 22.2.10

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 (366) 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 +275 -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 +1319 -0
  69. package/fesm2022/edsis-angular-chart-line.mjs +544 -0
  70. package/fesm2022/edsis-angular-chart-pie.mjs +531 -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 +1 -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-D70Ju6_f.mjs +234 -0
  144. package/fesm2022/edsis-angular-navigation-navigation-dockbar-menu.component-BaFnh48V.mjs +834 -0
  145. package/fesm2022/edsis-angular-navigation-navigation-entry-grid.component-D39W0FQZ.mjs +823 -0
  146. package/fesm2022/edsis-angular-navigation-navigation-flyout-menu.component-CpmsY8hb.mjs +670 -0
  147. package/fesm2022/edsis-angular-navigation-navigation-horizontal.component-D35IfX6r.mjs +689 -0
  148. package/fesm2022/edsis-angular-navigation-navigation-item.component-X6JFy-ya.mjs +1522 -0
  149. package/fesm2022/edsis-angular-navigation-navigation-list.component-D6Ms8H5g.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 +1863 -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-on-fill.mjs +89 -0
  160. package/fesm2022/edsis-angular-theme-page-core.mjs +315 -0
  161. package/fesm2022/edsis-angular-theme-page-filter.mjs +409 -0
  162. package/fesm2022/edsis-angular-theme-page-overview.mjs +88 -0
  163. package/fesm2022/edsis-angular-theme-page-root.mjs +693 -0
  164. package/fesm2022/edsis-angular-theme-page-side.mjs +342 -0
  165. package/fesm2022/edsis-angular-theme-page-slots.mjs +258 -0
  166. package/fesm2022/edsis-angular-theme-page.mjs +7 -0
  167. package/fesm2022/edsis-angular-theme-shell-services.mjs +231 -0
  168. package/fesm2022/edsis-angular-theme-shell-types.mjs +102 -0
  169. package/fesm2022/edsis-angular-theme-shell.mjs +1352 -0
  170. package/fesm2022/edsis-angular-theme-styles.mjs +605 -0
  171. package/fesm2022/edsis-angular-theme.mjs +0 -0
  172. package/fesm2022/edsis-angular.mjs +5 -8
  173. package/navigation/README.md +576 -0
  174. package/package.json +481 -52
  175. package/sdk/README.md +212 -0
  176. package/sdk/schematics/collection.json +20 -0
  177. package/sdk/schematics/init/index.js +83 -0
  178. package/sdk/schematics/init/schema.json +19 -0
  179. package/sdk/schematics/ng-add/index.js +147 -0
  180. package/sdk/schematics/ng-add/schema.json +14 -0
  181. package/sdk/schematics/package.json +3 -0
  182. package/sdk/schematics/sdk/index.js +175 -0
  183. package/sdk/schematics/sdk/schema.json +19 -0
  184. package/sdk/sdk.config.example.json +24 -0
  185. package/sdk/src/config/loader.js +43 -0
  186. package/sdk/src/config/schema.js +59 -0
  187. package/sdk/src/emit/client.js +251 -0
  188. package/sdk/src/emit/metadata.js +310 -0
  189. package/sdk/src/emit/models.js +104 -0
  190. package/sdk/src/emit/navigation.js +56 -0
  191. package/sdk/src/emit/operations.js +118 -0
  192. package/sdk/src/emit/public-api.js +54 -0
  193. package/sdk/src/emit/services.js +110 -0
  194. package/sdk/src/engine.js +67 -0
  195. package/sdk/src/layout/per-domain.js +360 -0
  196. package/sdk/src/package.json +3 -0
  197. package/sdk/src/parser/bundle.js +25 -0
  198. package/sdk/src/parser/ir.js +429 -0
  199. package/sdk/src/parser/types.js +7 -0
  200. package/sdk/src/render/template.js +152 -0
  201. package/sdk/src/writer/index.js +286 -0
  202. package/theme/README.md +120 -0
  203. package/theme/component/settings/README.md +154 -0
  204. package/theme/layout/README.md +604 -0
  205. package/theme/page/README.md +505 -0
  206. package/theme/shell/README.md +344 -0
  207. package/theme/styles/README.md +251 -0
  208. package/theme/styles/css/base/components.css +577 -0
  209. package/theme/styles/css/base/index.css +14 -0
  210. package/theme/styles/css/base/on-fill.css +153 -0
  211. package/theme/styles/css/base/package.css +10 -0
  212. package/theme/styles/css/base/prefers-dark.css +81 -0
  213. package/theme/styles/css/base/print.css +62 -0
  214. package/theme/styles/css/base/status.css +38 -0
  215. package/theme/styles/css/base/tailwind.css +208 -0
  216. package/theme/styles/css/base/theme.css +306 -0
  217. package/theme/styles/css/base/tokens.css +388 -0
  218. package/theme/styles/css/color/amber.css +72 -0
  219. package/theme/styles/css/color/blue.css +72 -0
  220. package/theme/styles/css/color/brand.css +38 -0
  221. package/theme/styles/css/color/cyan.css +72 -0
  222. package/theme/styles/css/color/emerald.css +72 -0
  223. package/theme/styles/css/color/fuchsia.css +72 -0
  224. package/theme/styles/css/color/green.css +72 -0
  225. package/theme/styles/css/color/index.css +19 -0
  226. package/theme/styles/css/color/indigo.css +72 -0
  227. package/theme/styles/css/color/lime.css +72 -0
  228. package/theme/styles/css/color/orange.css +72 -0
  229. package/theme/styles/css/color/pink.css +72 -0
  230. package/theme/styles/css/color/purple.css +72 -0
  231. package/theme/styles/css/color/red.css +72 -0
  232. package/theme/styles/css/color/rose.css +72 -0
  233. package/theme/styles/css/color/sky.css +72 -0
  234. package/theme/styles/css/color/teal.css +72 -0
  235. package/theme/styles/css/color/violet.css +72 -0
  236. package/theme/styles/css/color/yellow.css +72 -0
  237. package/theme/styles/css/fonts.css +85 -0
  238. package/theme/styles/css/index.css +18 -0
  239. package/theme/styles/css/neutral/gray.css +63 -0
  240. package/theme/styles/css/neutral/index.css +11 -0
  241. package/theme/styles/css/neutral/mauve.css +63 -0
  242. package/theme/styles/css/neutral/mist.css +63 -0
  243. package/theme/styles/css/neutral/neutral.css +63 -0
  244. package/theme/styles/css/neutral/olive.css +63 -0
  245. package/theme/styles/css/neutral/slate.css +63 -0
  246. package/theme/styles/css/neutral/stone.css +63 -0
  247. package/theme/styles/css/neutral/taupe.css +63 -0
  248. package/theme/styles/css/neutral/zinc.css +63 -0
  249. package/theme/styles/css/radius/index.css +30 -0
  250. package/theme/styles/css/space/index.css +20 -0
  251. package/types/edsis-angular-chart-area.d.ts +139 -0
  252. package/types/edsis-angular-chart-bar.d.ts +291 -0
  253. package/types/edsis-angular-chart-core.d.ts +824 -0
  254. package/types/edsis-angular-chart-line.d.ts +148 -0
  255. package/types/edsis-angular-chart-pie.d.ts +207 -0
  256. package/types/edsis-angular-chart-primitives.d.ts +360 -0
  257. package/types/edsis-angular-chart-radar.d.ts +198 -0
  258. package/types/edsis-angular-chart-radial.d.ts +187 -0
  259. package/types/edsis-angular-chart-scatter.d.ts +181 -0
  260. package/types/edsis-angular-chart.d.ts +3 -0
  261. package/types/edsis-angular-component-accordion.d.ts +139 -0
  262. package/types/edsis-angular-component-alert-dialog.d.ts +288 -0
  263. package/types/edsis-angular-component-alert.d.ts +72 -0
  264. package/types/edsis-angular-component-aspect-ratio.d.ts +20 -0
  265. package/types/edsis-angular-component-avatar.d.ts +111 -0
  266. package/types/edsis-angular-component-badge.d.ts +36 -0
  267. package/types/edsis-angular-component-breadcrumb.d.ts +85 -0
  268. package/types/edsis-angular-component-button-group.d.ts +50 -0
  269. package/types/edsis-angular-component-button.d.ts +44 -0
  270. package/types/edsis-angular-component-calendar.d.ts +150 -0
  271. package/types/edsis-angular-component-card.d.ts +123 -0
  272. package/types/edsis-angular-component-carousel.d.ts +155 -0
  273. package/types/edsis-angular-component-checkbox.d.ts +100 -0
  274. package/types/edsis-angular-component-collapsible.d.ts +68 -0
  275. package/types/edsis-angular-component-combobox.d.ts +105 -0
  276. package/types/edsis-angular-component-command.d.ts +215 -0
  277. package/types/edsis-angular-component-composer.d.ts +190 -0
  278. package/types/edsis-angular-component-context-menu.d.ts +64 -0
  279. package/types/edsis-angular-component-date-picker.d.ts +199 -0
  280. package/types/edsis-angular-component-dialog.d.ts +231 -0
  281. package/types/edsis-angular-component-drawer.d.ts +2 -0
  282. package/types/edsis-angular-component-dropdown-menu.d.ts +370 -0
  283. package/types/edsis-angular-component-editor.d.ts +234 -0
  284. package/types/edsis-angular-component-empty.d.ts +85 -0
  285. package/types/edsis-angular-component-form.d.ts +223 -0
  286. package/types/edsis-angular-component-hover-card.d.ts +133 -0
  287. package/types/edsis-angular-component-icon.d.ts +90 -0
  288. package/types/edsis-angular-component-input-group.d.ts +98 -0
  289. package/types/edsis-angular-component-input-otp.d.ts +249 -0
  290. package/types/edsis-angular-component-input.d.ts +31 -0
  291. package/types/edsis-angular-component-item.d.ts +169 -0
  292. package/types/edsis-angular-component-kanban.d.ts +165 -0
  293. package/types/edsis-angular-component-kbd.d.ts +25 -0
  294. package/types/edsis-angular-component-label.d.ts +19 -0
  295. package/types/edsis-angular-component-menubar.d.ts +123 -0
  296. package/types/edsis-angular-component-native-select.d.ts +39 -0
  297. package/types/edsis-angular-component-navigation-menu.d.ts +163 -0
  298. package/types/edsis-angular-component-pagination.d.ts +83 -0
  299. package/types/edsis-angular-component-pillbox.d.ts +380 -0
  300. package/types/edsis-angular-component-popover.d.ts +96 -0
  301. package/types/edsis-angular-component-progress.d.ts +45 -0
  302. package/types/edsis-angular-component-radio.d.ts +137 -0
  303. package/types/edsis-angular-component-resizable.d.ts +166 -0
  304. package/types/edsis-angular-component-scroll-area.d.ts +37 -0
  305. package/types/edsis-angular-component-segmented-control.d.ts +102 -0
  306. package/types/edsis-angular-component-select.d.ts +138 -0
  307. package/types/edsis-angular-component-separator.d.ts +26 -0
  308. package/types/edsis-angular-component-sheet.d.ts +240 -0
  309. package/types/edsis-angular-component-skeleton.d.ts +13 -0
  310. package/types/edsis-angular-component-slider.d.ts +148 -0
  311. package/types/edsis-angular-component-spinner.d.ts +31 -0
  312. package/types/edsis-angular-component-switch.d.ts +101 -0
  313. package/types/edsis-angular-component-table.d.ts +109 -0
  314. package/types/edsis-angular-component-tabs.d.ts +183 -0
  315. package/types/edsis-angular-component-textarea.d.ts +27 -0
  316. package/types/edsis-angular-component-timeline.d.ts +146 -0
  317. package/types/edsis-angular-component-toast.d.ts +60 -0
  318. package/types/edsis-angular-component-toggle-group.d.ts +161 -0
  319. package/types/edsis-angular-component-toggle.d.ts +47 -0
  320. package/types/edsis-angular-component-tooltip.d.ts +233 -0
  321. package/types/edsis-angular-component-utils-core.d.ts +175 -0
  322. package/types/edsis-angular-component-utils-overlay.d.ts +17 -0
  323. package/types/edsis-angular-component-utils-scale.d.ts +27 -0
  324. package/types/edsis-angular-component-utils.d.ts +2 -0
  325. package/types/edsis-angular-component.d.ts +1 -0
  326. package/types/edsis-angular-navigation-core.d.ts +55 -0
  327. package/types/edsis-angular-navigation-icon.d.ts +9 -0
  328. package/types/edsis-angular-navigation-service.d.ts +121 -0
  329. package/types/edsis-angular-navigation-types.d.ts +185 -0
  330. package/types/edsis-angular-navigation.d.ts +862 -0
  331. package/types/edsis-angular-sdk.d.ts +87 -0
  332. package/types/edsis-angular-theme-component-settings.d.ts +205 -0
  333. package/types/edsis-angular-theme-layout-services.d.ts +143 -0
  334. package/types/edsis-angular-theme-layout-types.d.ts +36 -0
  335. package/types/edsis-angular-theme-layout-wrapper.d.ts +670 -0
  336. package/types/edsis-angular-theme-layout.d.ts +218 -0
  337. package/types/edsis-angular-theme-on-fill.d.ts +45 -0
  338. package/types/edsis-angular-theme-page-core.d.ts +151 -0
  339. package/types/edsis-angular-theme-page-filter.d.ts +127 -0
  340. package/types/edsis-angular-theme-page-overview.d.ts +28 -0
  341. package/types/edsis-angular-theme-page-root.d.ts +172 -0
  342. package/types/edsis-angular-theme-page-side.d.ts +90 -0
  343. package/types/edsis-angular-theme-page-slots.d.ts +61 -0
  344. package/types/edsis-angular-theme-page.d.ts +7 -0
  345. package/types/edsis-angular-theme-shell-services.d.ts +188 -0
  346. package/types/edsis-angular-theme-shell-types.d.ts +102 -0
  347. package/types/edsis-angular-theme-shell.d.ts +178 -0
  348. package/types/edsis-angular-theme-styles.d.ts +328 -0
  349. package/types/edsis-angular-theme.d.ts +1 -0
  350. package/types/edsis-angular.d.ts +5 -2
  351. package/fesm2022/edsis-angular-block-shell.mjs +0 -1329
  352. package/fesm2022/edsis-angular-block-shell.mjs.map +0 -1
  353. package/fesm2022/edsis-angular-block-themes.mjs +0 -1007
  354. package/fesm2022/edsis-angular-block-themes.mjs.map +0 -1
  355. package/fesm2022/edsis-angular-module-auth.mjs +0 -2582
  356. package/fesm2022/edsis-angular-module-auth.mjs.map +0 -1
  357. package/fesm2022/edsis-angular-platform-mfe.mjs +0 -329
  358. package/fesm2022/edsis-angular-platform-mfe.mjs.map +0 -1
  359. package/fesm2022/edsis-angular-services-runtime.mjs +0 -385
  360. package/fesm2022/edsis-angular-services-runtime.mjs.map +0 -1
  361. package/fesm2022/edsis-angular.mjs.map +0 -1
  362. package/types/edsis-angular-block-shell.d.ts +0 -190
  363. package/types/edsis-angular-block-themes.d.ts +0 -94
  364. package/types/edsis-angular-module-auth.d.ts +0 -533
  365. package/types/edsis-angular-platform-mfe.d.ts +0 -126
  366. package/types/edsis-angular-services-runtime.d.ts +0 -118
@@ -0,0 +1,344 @@
1
+ # @edsis/angular/theme/shell
2
+
3
+ The application shell root. Where `@edsis/angular/theme/layout` arranges an
4
+ app _inside_ a page, `shell` owns the whole surface — a browser tab, an **OS
5
+ window**, a tablet, a phone — and bridges it to Tauri (or Electron, or any other
6
+ desktop runtime).
7
+
8
+ A `<Shell>` holds the app directly, plus a titlebar it renders itself when there
9
+ is window chrome to draw:
10
+
11
+ ```html
12
+ <Shell mode="desktop" device="macos" color="sync">
13
+ <button shellBarStart type="button">Menu</button>
14
+ <span shellBarTitle>Acme Studio</span>
15
+ <app-sync-badge shellBarEnd />
16
+
17
+ <Layout>
18
+ <LayoutVertical>
19
+ <LayoutNavigation><Navigation … /></LayoutNavigation>
20
+ <LayoutContent><router-outlet /></LayoutContent>
21
+ </LayoutVertical>
22
+ </Layout>
23
+ </Shell>
24
+ ```
25
+
26
+ `<Layout>` is a direct child — there is no container element. Inside a shell it
27
+ grows into whatever the titlebar left over (`--layout-viewport-height` becomes
28
+ `auto` plus a zero flex-basis) instead of measuring the viewport and overflowing
29
+ by the height of the bar.
30
+
31
+ ## Entry points
32
+
33
+ ```ts
34
+ import {
35
+ ShellComponent,
36
+ ShellService,
37
+ provideShellWindowBridge,
38
+ provideTauriShellWindowBridge,
39
+ isTauriRuntime,
40
+ type ShellMode,
41
+ type ShellDevice,
42
+ type ShellWindowBridge,
43
+ } from '@edsis/angular/theme/shell';
44
+ ```
45
+
46
+ The secondary entry points stay available for explicit imports:
47
+
48
+ ```ts
49
+ import { ShellService } from '@edsis/angular/theme/shell/services';
50
+ import { SHELL_MODES, SHELL_MODE_DEVICES } from '@edsis/angular/theme/shell/types';
51
+ ```
52
+
53
+ `ShellBarComponent` is deliberately **not** exported. When a titlebar exists is
54
+ `<Shell>`'s decision, not the consumer's — configure it through `<Shell>` and its
55
+ slots.
56
+
57
+ ## The four axes
58
+
59
+ | Input | Values | Storage key |
60
+ | -------- | ---------------------------------------------------------------- | -------------- |
61
+ | `mode` | `web`, `desktop`, `tablet`, `mobile` | `shell-mode` |
62
+ | `device` | `browser`, `macos`, `windows`, `linux`, `ipad`, `android`, `ios` | `shell-device` |
63
+ | `color` | `sync`, `default` | `shell-color` |
64
+ | `frame` | `classic`, `modern` | `shell-frame` |
65
+
66
+ Every axis is optional and falls back rather than demanding a value:
67
+
68
+ - **`mode`** — the input, else the stored `shell-mode`, else `desktop` when a
69
+ desktop runtime is registered (a Tauri window _is_ a desktop shell), else `web`.
70
+ - **`device`** — the input, else the stored `shell-device`, else whatever the
71
+ window bridge reports, else the mode's default device.
72
+ - **`color`** — the input, else the stored `shell-color`, else `sync`.
73
+ - **`frame`** — the input, else the stored `shell-frame`, else `classic`; only
74
+ `desktop` can be `modern`.
75
+
76
+ ### Driving the axes from localStorage
77
+
78
+ Because all four are storage-backed, a delivery target can be flipped **without a
79
+ rebuild** — useful for trying a native look, or for reproducing a tablet report on
80
+ a desktop machine. Set the keys and reload:
81
+
82
+ ```js
83
+ localStorage.setItem('shell-mode', 'desktop');
84
+ localStorage.setItem('shell-device', 'macos');
85
+ localStorage.setItem('shell-color', 'default');
86
+ localStorage.setItem('shell-frame', 'modern');
87
+ ```
88
+
89
+ An unrecognized value is ignored rather than throwing, so a stale or hand-typo'd
90
+ key degrades to the axis default.
91
+
92
+ At runtime, go through `ShellService` — each setter writes its own key:
93
+
94
+ ```ts
95
+ const shell = inject(ShellService);
96
+
97
+ shell.setMode('desktop'); // a user choice — persists to shell-mode
98
+ shell.setDevice('macos'); // …to shell-device
99
+ shell.setColor('default'); // …to shell-color
100
+ shell.setFrame('modern'); // …to shell-frame
101
+
102
+ shell.registerMode('desktop'); // a default — yields to a stored choice
103
+ ```
104
+
105
+ Pass `{ persist: false }` to any setter to change the axis for this session only.
106
+
107
+ Inputs, by contrast, are **host declarations, not user preferences**: they outrank
108
+ storage and never write to it, so `<Shell mode="desktop">` in a Tauri build cannot
109
+ be knocked over by a stale key — and pinning an input does not destroy the choice
110
+ underneath it.
111
+
112
+ ### Modes and their devices
113
+
114
+ | Mode | Devices | Chrome |
115
+ | --------- | --------------------------- | -------------------------- |
116
+ | `web` | `browser` | none — the browser drew it |
117
+ | `desktop` | `macos`, `windows`, `linux` | its own titlebar |
118
+ | `tablet` | `ipad`, `android` | none |
119
+ | `mobile` | `ios`, `android` | none |
120
+
121
+ `android` deliberately belongs to both `tablet` and `mobile`: the same OS ships on
122
+ both form factors, and only `mode` can tell them apart.
123
+
124
+ `mode` and `device` are always resolved as a **coherent pair**. A device belonging
125
+ to another form factor (`mode="desktop" device="ipad"`) is corrected to the mode's
126
+ default, so `data-shell-device` never describes something the mode cannot be. The
127
+ stored preference itself is left alone, so a temporary `mode="web"` does not erase
128
+ a stored `macos`.
129
+
130
+ ### Mode locks the layout width
131
+
132
+ `mode` is the one axis that constrains another package. On `desktop`, `tablet`, and
133
+ `mobile` the app _is_ the surface, so there is no page for the layout frame to be
134
+ inset within — `LayoutService.widthLocked()` becomes `true` and `width()` reports
135
+ `full`, outranking even `<Layout>`'s own `width` input.
136
+
137
+ The user's choice is not destroyed: it stays in `LayoutService.preferredWidth()` (and
138
+ in `localStorage`), so returning to `web` restores it. `ThemeSettings` reflects this
139
+ by disabling every width but `full` and explaining why.
140
+
141
+ Switch the axes at runtime through `ThemeSettings`
142
+ (`@edsis/angular/theme/component/settings`), which exposes all four in a
143
+ **Shell** section directly below Theme.
144
+
145
+ ## Chrome color
146
+
147
+ `color="sync"` (the default) promotes the selected **Theme color** to the shell
148
+ background through `--primary`. Its title and controls use `--primary-foreground`,
149
+ so named accents and the consumer's `brand` color keep the same readable semantic
150
+ pair in light and dark modes.
151
+
152
+ `color="default"` paints the native chrome of the active `device` instead — for an
153
+ app that wants to disappear into its OS. Each desktop device has a light and dark
154
+ palette, applied through `--shell-bar-background` / `-foreground` / `-border`
155
+ under `[data-shell-color='default'][data-shell-device='…']`.
156
+
157
+ ## Frame
158
+
159
+ `frame` decides how the app sits inside its window. Only a desktop window has a
160
+ frame to shape, so this collapses to `classic` on every other mode.
161
+
162
+ **`classic`** (the default) is the traditional desktop arrangement: the app is flush
163
+ to the window edge, with a bordered titlebar stacked on top of it.
164
+
165
+ **`modern`** insets the app instead. It gains `mx-3 mb-3 mt-0`
166
+ (`--shell-frame-inset`, which rides `--spacing-base`), so it floats as a panel free
167
+ of the window on three sides and meets the titlebar on the fourth. The titlebar then
168
+ drops its bottom border and takes the **same background token as the surround**, so
169
+ the bar and the margin around the panel read as one continuous frame rather than two
170
+ stacked surfaces.
171
+
172
+ The inset is margin on the layout, never padding on `<Shell>`: the titlebar is the
173
+ shell's other flex child, and padding would indent it too, breaking the full-bleed
174
+ drag region and pulling the macOS traffic lights off the window corner. The margin
175
+ also releases the layout's width — while it kept `width: 100%` the margins only
176
+ _shifted_ a full-width panel, overflowing the trailing edge into the shell's
177
+ `overflow-hidden` and leaving a gap on the leading side alone.
178
+
179
+ ### Panel edge
180
+
181
+ Inside a desktop window the app gets a panel edge: `modern` is rounded to
182
+ `--shell-frame-radius` (**12px**) and outlined 1px in `--shell-frame-border`, the
183
+ full-strength structural border tier.
184
+
185
+ `modern` rounds and closes all four sides, since it is a free-floating panel — its
186
+ titlebar drops the divider, so the panel's own top edge is what closes it. `classic`
187
+ keeps the entire layout square and flush to the window edge. Its top edge meets the
188
+ titlebar, which already draws that seam with its own `border-b`; outlining it again
189
+ would double the line, and rounding any edge would cut notches of chrome into the
190
+ full-bleed window join. No other mode has a window to shape.
191
+
192
+ The radius is a fixed 12px rather than riding `--radius-base`: this is window
193
+ geometry, matching what the OS rounds its own windows to, not a component-styling
194
+ choice the `theme-radius` axis should retune.
195
+
196
+ On `color="sync"`, the bar and surround both use the active `--primary`, while the
197
+ inset app panel remains on `--background`; the selected Theme color therefore makes
198
+ the frame visible without introducing another palette. `color="default"` keeps the
199
+ same composition but uses the active device's native chrome instead.
200
+
201
+ ## Window buttons
202
+
203
+ Buttons follow the **device**, not the runtime:
204
+
205
+ | Device | Controls |
206
+ | ----------------- | ------------------------------------------------------------------------- |
207
+ | `macos` | traffic lights on the **leading** edge — close, minimize, zoom |
208
+ | `windows`/`linux` | square glyph buttons on the **trailing** edge — minimize, maximize, close |
209
+
210
+ The macOS lights are drawn by the shell, not the OS. That is deliberate: a
211
+ `decorations: false` window has no OS buttons at all, so without them the window
212
+ could not be closed. Their fills are macOS's own constants rather than theme tokens
213
+ — a traffic light that recoloured with the accent would stop reading as one — and
214
+ each is a real button with an `aria-label`, so colour is never the only way to tell
215
+ them apart.
216
+
217
+ They sit at `--shell-traffic-light-size` (~13.1px), a little over the 12px the OS
218
+ draws: the app's own lights are in a titlebar the user can mis-click, so they get a
219
+ slightly larger target. Each takes a `cursor: pointer`, and on hover it darkens to
220
+ its **own** pressed shade — the per-light shift macOS uses, so the feedback reads as
221
+ "this specific control" rather than a generic highlight. The glyph inside appears on
222
+ hover and on keyboard focus, so the hover state never rests on colour alone.
223
+
224
+ Set `nativeWindowControls` when the runtime still draws its own decorations — Tauri's
225
+ macOS `titleBarStyle: 'Overlay'`. macOS then reserves `--shell-traffic-light-inset`
226
+ on the leading edge for the OS lights and draws none of its own; Windows and Linux
227
+ draw nothing either.
228
+
229
+ Whether those buttons _do_ anything is the bridge's business; the shape of the
230
+ chrome is the device's. Every button carries an `aria-label` (`minimizeLabel`,
231
+ `maximizeLabel`, `restoreLabel`, `closeLabel` are `<Shell>` inputs, for
232
+ localization), and the maximize/zoom button reports `aria-pressed` so the maximized
233
+ state is announced.
234
+
235
+ ## Desktop navigation flyout
236
+
237
+ When `LayoutWrapperDefault` uses `nav-type="desktop"`, it publishes its primary
238
+ navigation data to the titlebar instead of rendering a second navigation region
239
+ inside the layout. `<Shell>` then adds the same icon-only `NavigationFlyout`
240
+ pattern used by an empty-layout `<Page>`, adapted to desktop chrome as a
241
+ window-width popover:
242
+
243
+ - macOS — after consumer `[shellBarEnd]` content, at the far right opposite the
244
+ traffic lights;
245
+ - Windows and Linux — before consumer `[shellBarStart]` content, at the far left
246
+ opposite the window controls.
247
+
248
+ The trigger is rendered only when desktop navigation data exists. On an `empty`
249
+ layout, `LayoutWrapperDefault` publishes that data under `main` for the `Page`
250
+ launcher instead, so the titlebar does not add a duplicate button. Other layouts
251
+ keep their titlebar navigation, and minidock items remain independent.
252
+ The trigger keeps a real
253
+ button, `aria-haspopup="menu"`, an explicit accessible name, visible keyboard
254
+ focus, and the established semantic shell/navigation tokens. Its surface stays
255
+ transparent, including hover and open states, while the icon inherits the exact
256
+ `--shell-bar-foreground` color used by the titlebar text. The open panel is fixed
257
+ at the viewport origin (`top: 0; left: 0`) and spans the full window width instead
258
+ of using a fixed content cap. Its lower corners use the desktop-only
259
+ `--shell-frame-radius` while the upper edge stays square like the classic window
260
+ frame. Set
261
+ `[navigationFlyout]="false"` to suppress it, or localize/customize it through
262
+ `navigationFlyoutLabel` and `navigationFlyoutIcon`.
263
+
264
+ ## Window dragging
265
+
266
+ Declarative, so nothing runs on pointer-down. In desktop mode `<Shell>` becomes
267
+ Electron's ancestor `shell-drag-region` (`-webkit-app-region: drag`) and paints a
268
+ transparent Tauri frame layer at `z-index: 0` with `data-tauri-drag-region`. The
269
+ titlebar also carries the direct Tauri marker; it deliberately does not create a
270
+ second Electron drag rectangle above the flyout.
271
+
272
+ Application foregrounds such as `<Layout>` sit at `z-index: 10` and opt out through
273
+ `app-region: no-drag`; the titlebar sits at `z-index: 20`, and its open flyout
274
+ panel stays at `z-index: 50` with an explicit no-drag region. Consequently the
275
+ exposed window surround—including the modern-frame gaps—moves the window, while
276
+ buttons, fields, routed content, and every flyout menu item keep normal pointer
277
+ interaction. Electron's ancestor drag region is suspended while the flyout is
278
+ mounted because native app-region hit testing is independent of ordinary DOM
279
+ stacking; it resumes automatically as soon as the panel closes.
280
+
281
+ Turn the bar into pure UI with `[drag]="false"`. Runtimes that need an explicit
282
+ call can use `ShellService.startDragging()`. Disabling drag removes both the
283
+ frame-wide layer and the titlebar markers.
284
+
285
+ ## Bridging to Tauri
286
+
287
+ The theme package never imports a desktop SDK. Everything the shell needs from a
288
+ window sits behind `ShellWindowBridge`, so a browser build pays nothing.
289
+
290
+ For a Tauri app with `app.withGlobalTauri = true`:
291
+
292
+ ```ts
293
+ import { provideTauriShellWindowBridge } from '@edsis/angular/theme/shell';
294
+
295
+ export const appConfig: ApplicationConfig = {
296
+ // The bridge reports the OS, so mode and device both resolve on their own.
297
+ providers: [provideTauriShellWindowBridge()],
298
+ };
299
+ ```
300
+
301
+ Without the global, hand it the modules instead — they stay dynamic imports, so a
302
+ web build never pulls them in:
303
+
304
+ ```ts
305
+ provideTauriShellWindowBridge({
306
+ currentWindow: () => import('@tauri-apps/api/window').then((m) => m.getCurrentWindow()),
307
+ platform: () => import('@tauri-apps/plugin-os').then((m) => m.platform()),
308
+ });
309
+ ```
310
+
311
+ This is safe to register unconditionally: outside a Tauri webview the bridge
312
+ resolves no window and every command becomes a no-op. Use `isTauriRuntime()` if you
313
+ need to branch yourself.
314
+
315
+ For any other runtime, implement `ShellWindowBridge` and register it with
316
+ `provideShellWindowBridge()`. With no bridge at all, `ShellService` falls back to an
317
+ inert web bridge — which is what keeps `<Shell>` renderable in a browser tab, in a
318
+ unit test, and under SSR.
319
+
320
+ ## Tokens
321
+
322
+ Geometry rides `--spacing-base`, so window chrome tracks the `theme-space` density
323
+ axis:
324
+
325
+ | Token | Purpose |
326
+ | ----------------------------- | ---------------------------------------------- |
327
+ | `--shell-bar-height` | Titlebar thickness — the single geometry knob. |
328
+ | `--shell-bar-inline` | Titlebar inline padding. |
329
+ | `--shell-bar-gap` | Gap between items in the titlebar. |
330
+ | `--shell-control-size` | Window button hit area. |
331
+ | `--shell-traffic-light-inset` | Leading run reserved for macOS traffic lights. |
332
+ | `--shell-traffic-light-size` | Diameter of one traffic light (~13.1px). |
333
+ | `--shell-bar-background` | Shell chrome background; see **Chrome color**. |
334
+ | `--shell-bar-foreground` | Titlebar text and glyphs. |
335
+ | `--shell-bar-border` | Titlebar bottom divider (`classic` only). |
336
+ | `--shell-frame-inset` | `modern`: gap between the app and the window. |
337
+ | `--shell-frame-radius` | Corner radius of the app in a desktop window. |
338
+
339
+ ## Host attributes
340
+
341
+ `<Shell>` reflects its resolved state so consumer CSS and tests can key off it:
342
+ `data-shell-root`, `data-shell-mode`, `data-shell-device`, `data-shell-color`,
343
+ `data-shell-platform`, `data-shell-window`. The titlebar adds
344
+ `data-shell-focused` — an unfocused window recedes, per OS convention.
@@ -0,0 +1,251 @@
1
+ # Theme
2
+
3
+ `@edsis/angular/theme/styles` menyediakan provider untuk mode, warna (accent +
4
+ neutral, gaya FluxUI), brand color, dan preload aset tema global.
5
+
6
+ ```ts
7
+ import { provideUiTheme } from '@edsis/angular/theme/styles';
8
+
9
+ export const appConfig = {
10
+ providers: [
11
+ provideUiTheme({
12
+ mode: 'light',
13
+ color: 'base', // accent: base, red…rose, brand
14
+ neutral: 'base', // gray family: base, slate, gray, zinc, …
15
+ radius: 'md', // corner radius: none, xs, sm, md, xl, full
16
+ space: 'normal', // spacing density: compact, normal
17
+ brand: '221 83% 53%', // warna brand consumer (HSL triplet, atau { color, foreground })
18
+ }),
19
+ ],
20
+ };
21
+ ```
22
+
23
+ ## API Notes
24
+
25
+ - `mode` mem-bootstrap `ThemeModeService` dan default mode yang disimpan di storage.
26
+ - `color` mem-bootstrap `ThemeColorService`; accent palette awal (`<html theme-color>`).
27
+ - `neutral` keluarga neutral awal (`<html theme-neutral>`); berkomposisi dengan accent.
28
+ - `radius` mem-bootstrap `ThemeRadiusService`; preset corner radius awal (`<html theme-radius>`).
29
+ Menggerakkan knob `--radius-base` sehingga seluruh skala `--radius-*` dan utility `rounded-*` ikut.
30
+ Nilainya mengikuti Tailwind: `none`, `xs`, `sm`, `md` (default), `xl`, dan `full`.
31
+ - `space` mem-bootstrap `ThemeSpaceService`; preset spacing density awal (`<html theme-space>`).
32
+ Menggerakkan knob `--spacing-base` sehingga setiap utility `p-*`/`m-*`/`gap-*`/`w-*`/`h-*` ikut.
33
+ - `brand` mem-bootstrap `ThemeBrandService`; set `--brand` / utility `bg-brand` dan preset
34
+ accent `theme-color='brand'`. Menerima string HSL triplet atau `{ color, foreground }`.
35
+ Bisa diubah runtime via `setBrand()`, persist di storage.
36
+ - Pilihan yang dipersist (`theme-color` / `theme-neutral` / `theme-radius` / `theme-space` /
37
+ `theme-brand`) menang atas default.
38
+
39
+ ## Default Behavior
40
+
41
+ - `provideUiTheme()` tidak melakukan request jaringan eksternal apa pun dan tidak memuat font ikon:
42
+ ikon adalah SVG Lucide dari peer `@lucide/angular`, didaftarkan lewat `provideIcons()` dari
43
+ `@edsis/angular/component/icon`. Tema hanya menyediakan token `--icon-size` (default `1.5rem`)
44
+ dan `--icon-stroke-width` (default `2`) yang dibaca komponen `<Icon>`.
45
+ - Opsi `icons` di `provideUiTheme()` (`icons.materialSymbols`) sudah dihapus bersama Material Symbols;
46
+ hapus opsi itu dari konfigurasi Anda.
47
+
48
+ ## Font
49
+
50
+ Token `--theme-font-sans` (`'Inter', …`) dan `--theme-font-mono` (`'JetBrains Mono', …`) hanya
51
+ menamai font; tema tidak memuat file font apa pun dan paket tidak membawa biner font. Tanpa langkah
52
+ di bawah, teks memakai font yang kebetulan terpasang di mesin pengunjung.
53
+
54
+ Untuk memuatnya, impor lembar opsional setelah tema dan sajikan file woff2 dari origin Anda sendiri:
55
+
56
+ ```css
57
+ @import '@edsis/angular/theme/theme.css';
58
+ @import '@edsis/angular/theme/styles/css/fonts.css';
59
+ ```
60
+
61
+ - `fonts.css` mendeklarasikan `@font-face` untuk `/fonts/inter/InterVariable.woff2` (dan varian
62
+ italic) serta `/fonts/jetbrains-mono/JetBrainsMono-{Regular,Medium,Bold}.woff2`, semuanya
63
+ `font-display: swap`. Ambil file dari rilis resmi [Inter](https://github.com/rsms/inter) dan
64
+ [JetBrains Mono](https://github.com/JetBrains/JetBrainsMono) (keduanya SIL OFL 1.1). Path lain?
65
+ Salin `fonts.css` dan ubah `url()`-nya.
66
+ - Lembar itu juga menambahkan face `Inter Fallback` (Arial lokal dengan metrik Inter) ke
67
+ `--theme-font-sans`, sehingga pergantian ke Inter tidak menggeser layout.
68
+ - Preload hanya file Inter tegak:
69
+ `<link rel="preload" href="/fonts/inter/InterVariable.woff2" as="font" type="font/woff2" crossorigin>`.
70
+ Browser hanya mengunduh face lain (italic, mono 500/700) saat halaman benar-benar memakainya.
71
+ - Showcase memakai persis susunan ini (`apps/showcase/public/fonts/`), dan CSP `font-src 'self'`
72
+ sudah mengizinkannya.
73
+
74
+ ## Token Semantik Status
75
+
76
+ Selain palet accent dan neutral, tema mengemit tiga token status semantik beserta
77
+ pasangan foregroundnya. Semuanya digenerate oleh `scripts/generators/gen-theme-colors.mjs` ke
78
+ `css/base/status.css`, jadi jangan diedit tangan.
79
+
80
+ | Token | Pasangan foreground | Seed | Dipakai oleh |
81
+ | ----------- | ---------------------- | ----------- | ------------------------------------ |
82
+ | `--success` | `--success-foreground` | green (142) | `bg-success text-success-foreground` |
83
+ | `--warning` | `--warning-foreground` | amber (38) | `bg-warning text-warning-foreground` |
84
+ | `--info` | `--info-foreground` | sky (199) | `bg-info text-info-foreground` |
85
+
86
+ `--destructive` tetap ditulis tangan di `css/base/theme.css` karena tidak berasal
87
+ dari seed accent, tapi generator ikut memvalidasi kontrasnya.
88
+
89
+ ## Jaminan Kontras
90
+
91
+ Generator mengukur kontras setiap pasangan token teks yang diemitnya dengan rumus
92
+ WCAG, bukan menebak dari rentang hue. Aturannya:
93
+
94
+ - pasangan teks (`primary`, `accent`, `secondary`, `muted`, `surface`, `card`,
95
+ `popover`, dan `foreground` terhadap `background`) wajib minimal 4.5 banding 1;
96
+ - `--ring` diemit terpisah dari `--primary` dan wajib minimal 3 banding 1 terhadap
97
+ `--background`, jadi indikator fokus selalu terlihat;
98
+ - foreground yang meleset digeser lightnessnya sekecil mungkin sampai lolos. Hue dan
99
+ saturation tidak pernah bergeser, sehingga identitas warna palet tetap;
100
+ - bila tidak ada nilai yang bisa lolos, generator gagal dan tidak menulis apa pun.
101
+
102
+ A brand the consumer picks at runtime is held to the same rules, and split the
103
+ same way. `ThemeBrandService.setBrand()` measures it with the same WCAG formula
104
+ (`theme-contrast.ts`, a port of `scripts/generators/theme-contrast.mjs`) before storing it:
105
+
106
+ - `--brand` itself is never moved. Like a generated `--primary`, the fill keeps
107
+ the lightness it was chosen with, so `theme-color='brand'` ships the colour the
108
+ consumer asked for;
109
+ - `--brand-foreground` follows the foreground-on-fill contract below: without a
110
+ `foreground`, or with one that is not a triplet, it is `foregroundFor(color,
111
+ 'light')`; an explicit triplet that clears 4.5 to 1 is kept as given, and one
112
+ that fails is replaced by `foregroundFor(color, 'light')`, never nudged to an
113
+ arbitrary grey;
114
+ - the focus ring is solved separately, once per mode, into `--brand-ring-light`
115
+ and `--brand-ring-dark`. `css/color/brand.css` maps `--ring` to
116
+ `var(--brand-ring, var(--brand))` and picks the right one per `data-mode`, so
117
+ the ring clears 3 to 1 against that mode's `--background` without dragging the
118
+ fill down with it.
119
+
120
+ Every HSL form CSS accepts is normalised first — space or comma separated, a hue
121
+ written with `deg`/`grad`/`rad`/`turn`, a hue outside 0..360 — so none of them can
122
+ paint while skipping the measurement. Hex is accepted and converted too, since
123
+ that is what a native colour picker returns. A value with nothing to measure in
124
+ it (`var(--consumer-brand)`, say) is passed through as given with the given
125
+ foreground (white by default), and forfeits the guarantee.
126
+
127
+ ## Kontrak Foreground di Atas Fill
128
+
129
+ Setiap warna latar solid di library mendapat warna teks dari satu aturan
130
+ ([spec 0011](../../../../docs/specs/0011-kontrak-foreground-fill/index.md)): putih atau
131
+ tinta tema (`0 0% 12%` di light, `0 0% 10%` di dark), mana yang rasio WCAG-nya lebih
132
+ tinggi. Kalau keduanya belum mencapai 4.5 banding 1, tinta digelapkan bertahap (hue dan
133
+ saturasi tetap) sampai lolos. Fill itu sendiri tidak pernah diubah.
134
+
135
+ Aturan yang sama tersedia untuk warna dari data konsumen:
136
+
137
+ ```ts
138
+ import { ON_FILL_INK, foregroundFor } from '@edsis/angular/theme/styles';
139
+
140
+ foregroundFor('48 96% 89%'); // '0 0% 12%' (tinta tema)
141
+ foregroundFor('#1e3a8a', 'dark'); // '0 0% 100%'
142
+ foregroundFor('var(--x)'); // null, tidak bisa diukur
143
+ ```
144
+
145
+ `foregroundFor(fill, mode = 'light')` menerima HSL triplet atau hex, lalu mengembalikan
146
+ HSL triplet atau `null`. Untuk elemen template, directive `[OnFill]` dari
147
+ `@edsis/angular/theme/on-fill` memasang `background-color` dan `color` sekaligus,
148
+ dan mengikuti `data-mode` pada `<html>` tanpa menulis apa pun ke sana:
149
+
150
+ ```html
151
+ <span [OnFill]="tag.color">{{ tag.label }}</span>
152
+ ```
153
+
154
+ Pasangan statis digenerate ke `css/base/on-fill.css` (jangan diedit tangan):
155
+
156
+ | Token | Keterangan |
157
+ | ----------------------------------------------------------- | ------------------------------------------------------------------------ |
158
+ | `--chart-1` … `--chart-5` | fill seri chart, per mode; `--chart-1` mengikuti `--primary` |
159
+ | `--chart-1-foreground` … `--chart-5-foreground` | teks di atas fill chart; `--chart-1-foreground` = `--primary-foreground` |
160
+ | `--timeline-indicator-<warna>` dan `-foreground` (17 warna) | indikator timeline, fill sama di kedua mode, foreground per mode |
161
+
162
+ `--theme-chart-N` dan `--theme-chart-N-foreground` menimpa fill dan foreground satu seri.
163
+ Timpa keduanya berpasangan: build tidak bisa memeriksa CSS milik konsumen.
164
+
165
+ `node scripts/generators/gen-theme-colors.mjs --check` memeriksa semua pasangan teks di
166
+ atas fill di CSS base (`:root`, `[data-mode='dark']`, `:root[data-mode='dark']` di
167
+ `theme.css`, `tokens.css`, `status.css`, `on-fill.css`) di kedua mode, setelah `var()`
168
+ dan default `var(--theme-*, d)` di-resolve. Daftarnya `ON_FILL_PAIRS` di generator; token
169
+ `-foreground` baru di CSS base yang belum didaftarkan membuat `--check` gagal sampai
170
+ didaftarkan bersama fill-nya.
171
+
172
+ Jalankan `node scripts/generators/gen-theme-colors.mjs --check` untuk memastikan CSS yang
173
+ ter commit masih cocok dengan seed. Cek ini juga berjalan di `verify:libs` dan CI.
174
+
175
+ ## Standar Token Geometri
176
+
177
+ Setiap nilai geometri di `packages/angular/` wajib turun dari token tema, bukan angka mati.
178
+ Aturan ini yang membuat sumbu `theme-space` dan `theme-radius` benar benar
179
+ menjangkau seluruh library, bukan hanya komponen yang kebetulan memakai utility
180
+ Tailwind. Keputusan lengkapnya di
181
+ [spec 0003](../../../../docs/specs/0003-jangkauan-sumbu-space-radius/index.md).
182
+
183
+ **Pola kanonik**:
184
+
185
+ ```css
186
+ /* Jarak di CSS komponen: selalu turun dari unit spacing */
187
+ .panel {
188
+ padding: calc(var(--spacing-base) * 3);
189
+ gap: calc(var(--spacing-base) * 2);
190
+ }
191
+
192
+ /* Sudut: pakai skala radius */
193
+ .panel {
194
+ border-radius: var(--radius-md);
195
+ }
196
+ ```
197
+
198
+ ```html
199
+ <!-- Template: pakai skala utility, yang sudah turun dari --spacing -->
200
+ <div class="gap-2 p-3">
201
+ <!-- Sudut -->
202
+ <div class="rounded-md">
203
+ <!-- Tinggi kontrol: satu knop bernama, bukan literal tinggi -->
204
+ <button class="h-control-md"></button>
205
+ </div>
206
+ </div>
207
+ ```
208
+
209
+ **Jangkauan sumbu**: jarak (padding, margin, gap, ukuran) plus tinggi kontrol ikut
210
+ `theme-space`. Tipografi, ukuran ikon, dan tebal garis **tidak** ikut. Bentuk pil
211
+ semantik (`rounded-full` pada avatar, switch, radio, progress, spinner, dan track
212
+ slider) dikunci sebagai bentuk, jadi sumbu radius tidak menyentuhnya.
213
+
214
+ **Penegakan**: `node scripts/checks/check-geometry-tokens.mjs` (`bun run check:libs:geometry`)
215
+ memindai `packages/angular/**/*.ts` dan `packages/angular/**/*.css`, lalu menggagalkan build saat
216
+ menemukan pelanggaran. Cek ini berjalan di `verify:libs` dan di CI pada tiap PR dan
217
+ push ke `main`. Yang ditolak:
218
+
219
+ | Jenis | Ditolak | Contoh |
220
+ | -------------- | -------------------------------------------------------------------------------- | --------------------- |
221
+ | Panjang | properti jarak dan ukuran dengan nilai `px`, `rem`, atau `em` mentah | `padding: 12px` |
222
+ | Radius | `border-radius` dengan panjang mentah | `border-radius: 10px` |
223
+ | Nilai arbitrer | utility jarak, ukuran, dan `rounded-*` yang kurung sikunya berisi panjang mentah | `min-w-[8rem]` |
224
+
225
+ Yang **tidak** ditolak, dan memang begitu adanya:
226
+
227
+ - nilai yang membaca token, termasuk `calc(var(--spacing-base) * 3)`,
228
+ `rounded-[var(--radius-base)]`, dan `rounded-[inherit]`;
229
+ - `border-radius: inherit` serta kata kunci tanpa besaran seperti `auto` dan `fit-content`;
230
+ - `0` dan persen, karena keduanya bukan besaran yang punya skala;
231
+ - tebal border dan outline, karena garis rambut tidak boleh ikut skala;
232
+ - ekspresi `calc()`, `min()`, `clamp()` di dalam kurung siku utility, dan satuan
233
+ viewport seperti `85vh`. Guard mempercayainya; kalau isinya ternyata angka mati,
234
+ itu yang lolos dari jaring ini;
235
+ - berkas `*.spec.ts`, karena test hanya mencerminkan class string komponennya. Satu
236
+ nilai diperbaiki di komponennya, bukan di dua tempat;
237
+ - `packages/angular/theme/styles/css/` yang justru tempat token didefinisikan.
238
+
239
+ **Pengecualian**: tinggal di
240
+ [`scripts/checks/geometry-token-exceptions.json`](../../../../scripts/checks/geometry-token-exceptions.json).
241
+ Tiap baris wajib membawa `pattern`, `files`, dan `reason`; baris tanpa alasan
242
+ tertulis ditolak oleh guard itu sendiri, jadi daftar ini tidak bisa dipakai sebagai
243
+ tempat buang. `wave` bernilai `null` untuk pengecualian permanen, atau angka 2
244
+ sampai 5 untuk utang sementara yang dihapus oleh gelombang itu sendiri. Guard
245
+ mencetak sisa utang per gelombang tiap kali dijalankan, sehingga yang belum
246
+ dibereskan selalu berupa angka, bukan perasaan.
247
+
248
+ **Entry point baru**: tambahkan barisnya ke tabel inventaris sumbu di
249
+ [rationale spec 0003](../../../../docs/specs/0003-jangkauan-sumbu-space-radius/rationale.md),
250
+ sebutkan sumbu mana yang berlaku dan seberapa jauh sudah tersambung. Tabel itu
251
+ rujukan tunggal soal sudut mana yang sengaja dikunci dan mana yang kelupaan.