@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
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ojie Permana
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,450 +1,138 @@
1
1
  # @edsis/angular
2
2
 
3
- Angular library package for Edsis shared application features.
3
+ Accessible, tree-shakable Angular 22 design system from Edsis: UI components, charts, navigation shells, theme tokens, and an OpenAPI SDK generator.
4
4
 
5
- Published entry points:
6
-
7
- - `@edsis/angular`
8
- - `@edsis/angular/services/runtime`
9
- - `@edsis/angular/module/auth`
10
- - `@edsis/angular/platform/mfe`
11
-
12
- The generated API SDK is published separately as `@edsis/sdk`.
13
-
14
- ## `module/auth`: persistent cookie session
15
-
16
- Configure the module once at application bootstrap. `provideEdsisAuth()` runs
17
- `AuthService.initialize()` through `provideAppInitializer`, before initial
18
- navigation and route guards. It restores a session with the HttpOnly refresh
19
- cookie, while the access token is kept only in the running application's
20
- memory.
21
-
22
- ```ts
23
- provideEdsisAuth({
24
- apiUrl: environment.apiUrl,
25
- appUrl: environment.appUrl,
26
- });
27
- ```
28
-
29
- Use `AuthService` for password login/logout and its `user`, `accessToken`, and
30
- `isAuthenticated` signals for UI state. The library calls the configured
31
- `/v1/auth/*` endpoints with credentials.
32
- The interceptor adds `withCredentials` and the in-memory bearer token to API
33
- requests, coalesces concurrent 401 refreshes, retries once, and redirects to
34
- the configured login route when refresh fails. It never writes authentication
35
- tokens to `sessionStorage`, `localStorage`, or `document.cookie`.
36
-
37
- For optional native notification badges, call
38
- `setAuthNotificationBadge(unreadCount)`; it is a no-op in a normal browser
39
- and uses the bundled Tauri API when a native host is present.
40
-
41
- The persistent cookie belongs to the browser/WebView origin. Therefore a
42
- production, development, and local build must use distinct origins; keeping an
43
- origin and its WebView data directory stable preserves the session across a
44
- Tauri restart or update.
45
-
46
- ## `services/runtime`: desktop, tablet, and browser context
47
-
48
- Register `provideEdsisRuntime()` before rendering the structural shell. It
49
- validates a schema V2 `window.EDSIS_RUNTIME`, falls back to the `runtime_context`
50
- Tauri command and `edsis:runtime-ready` event, then safely resolves a responsive
51
- web context in an ordinary browser. Trusted schema V1 payloads are accepted and
52
- normalized to V2 during migration. V2 adds the canonical `deviceType` value:
53
- `browser`, `windows`, `macos`, `android`, or `ipados`.
54
-
55
- `RuntimeContextService` exposes `deviceType` plus signals for desktop, iPadOS,
56
- Android tablet, and the shell capability list without using the User-Agent. It
57
- also writes the resolved host/platform/device/device-type/profile to
58
- `data-edsis-*` attributes on the document root. `browser` is reserved for a
59
- non-Tauri host; an invalid native response fails initialization instead of being
60
- silently mislabeled as a browser.
61
-
62
- When the consumer also uses `provideUiTheme()`, register the opt-in bridge so UI
63
- components and CSS receive the same resolved device:
64
-
65
- ```ts
66
- import { provideRuntimeThemeDevice } from '@edsis/angular/block/themes';
67
- import { provideEdsisRuntime } from '@edsis/angular/services/runtime';
68
- import { provideUiTheme } from '@edsis/theme/styles';
69
-
70
- providers: [provideUiTheme(), provideEdsisRuntime(), provideRuntimeThemeDevice()];
71
- ```
72
-
73
- The bridge waits for runtime initialization and then updates
74
- `ThemeDeviceService` once. This keeps the base runtime entry point independent
75
- from the optional theme package.
76
-
77
- `TabletViewportService` reports landscape and the 600 CSS pixel minimum. The
78
- consumer decides where to render its blocking view and must gate it with
79
- `RuntimeContextService.isTabletShell()` so narrow browser windows are not
80
- blocked.
81
-
82
- ## `module/auth`: Magic-link destination
83
-
84
- When the login form is submitted, the auth module sends the origin derived
85
- from `appUrl` as `frontend_url`. This lets the backend keep only the route path
86
- in its environment configuration:
87
-
88
- ```env
89
- AUTH_SERVICE_MAGIC_LINK_VERIFY_URL=/verify
90
- ```
91
-
92
- For example, an app configured with `appUrl: 'https://edsis.dev'` submits
93
- `frontend_url: 'https://edsis.dev'`; the backend creates the final destination
94
- `https://edsis.dev/verify#token=...`. An absolute backend verify URL remains a
95
- supported fallback for older deployments.
96
-
97
- ## `module/auth`: Google Sign-In
98
-
99
- `@edsis/angular/module/auth` ships two discriminated Google Sign-In modes. The
100
- existing direct authorization-code mode remains backward compatible and stays
101
- disabled until a client ID is configured:
102
-
103
- ```ts
104
- provideEdsisAuth({
105
- apiUrl: environment.apiUrl,
106
- appUrl: environment.appUrl,
107
- oauth: {
108
- google: { clientId: environment.google.clientId },
109
- nativeGoogle: { apiUrl: '/api' },
110
- },
111
- });
112
- ```
113
-
114
- On desktop/browser the existing authorization-code redirect remains
115
- unchanged. A tablet runtime advertising `google-native-sign-in` instead asks
116
- the same-origin challenge endpoint, invokes the native Google adapter, and
117
- posts its short-lived ID token to `/api/v1/auth/google/native`. Refresh, user,
118
- and logout requests then stay on `/api` so the host-only HttpOnly cookie is
119
- first-party. A tablet never falls back to the browser OAuth redirect: when the
120
- native capability/plugin is unavailable, Google Sign-In is disabled with an
121
- explicit error. Access, refresh, and Google ID tokens are never persisted by
122
- JavaScript.
123
-
124
- - `redirectUri` is **not** configurable; the library derives it from `appUrl`
125
- as `${appUrl}/auth/google/callback` and `authRoutes` serves that path with
126
- `AuthGoogleCallbackPage`. Register exactly this URI in the Google Cloud
127
- Console.
128
- - An empty `clientId` is treated as "not configured", so a build-time injected
129
- environment value can be passed through as-is.
130
- - Clicking the Google button stores a crypto-random `state` in sessionStorage
131
- (`auth-google-state`) and performs a full-page redirect to
132
- `https://accounts.google.com/o/oauth2/v2/auth` with
133
- `client_id`, `redirect_uri`, `response_type=code`,
134
- `scope=openid email profile`, and `state`.
135
- - Microsoft and Apple remain placeholders.
136
-
137
- ### Central Auth Gateway mode for MFEs
138
-
139
- An MFE does not need its own Google client configuration. Select `gateway`
140
- mode with the lower-kebab `mfeId` (maximum 64 characters) registered in the
141
- central Gateway allowlist:
142
-
143
- ```ts
144
- provideEdsisAuth({
145
- apiUrl: environment.apiUrl,
146
- appUrl: environment.appUrl,
147
- oauth: {
148
- google: {
149
- mode: 'gateway',
150
- mfeId: 'developer-guide',
151
- // Optional. Omit `gateway` to use `apiUrl` and the default endpoints.
152
- gateway: {
153
- baseUrl: `${environment.apiUrl}/auth-gateway`,
154
- // Optional; these are the defaults:
155
- startEndpoint: '/v1/auth/google/start',
156
- handoffEndpoint: '/v1/auth/google/handoff',
157
- },
158
- },
159
- },
160
- });
161
- ```
162
-
163
- The library derives the exact MFE `returnUrl` from `appUrl` as
164
- `${appUrl}/auth/google/callback`. Register that pair with `mfeId` on the
165
- Gateway. Only the Gateway callback is registered with Google. `gateway` and
166
- `gateway.baseUrl` are optional and default to `apiUrl`. An explicit `baseUrl`
167
- may use a different path, but its origin (scheme, host, and port) must exactly
168
- match `apiUrl`; configuration fails immediately otherwise. This keeps the
169
- handoff, refresh, current-user, and logout requests on one cookie origin.
170
- `baseUrl` must use HTTPS; plain HTTP is accepted only for exact loopback hosts
171
- (`localhost`, `127.0.0.1`, and `[::1]`) during local development. The browser
172
- supplies the trusted `Origin`; the Gateway requires it to equal the origin of
173
- `returnUrl`.
174
-
175
- The application origin must also be schemeful same-site with this cookie
176
- origin, or route auth through an application-owned same-origin BFF. CORS plus
177
- `SameSite=None` is not sufficient on browsers that block third-party cookies;
178
- cross-site deployments must not be promoted until login, reload/refresh, and
179
- logout pass with third-party cookies blocked.
180
-
181
- The browser flow is:
182
-
183
- 1. create a 256-bit PKCE verifier and S256 challenge;
184
- 2. `POST {gateway.baseUrl}{startEndpoint}` with `{ mfeId, returnUrl,
185
- codeChallenge, codeChallengeMethod: 'S256' }`;
186
- 3. accept only an authorization URL on the exact trusted Google
187
- `https://accounts.google.com/o/oauth2/v2/auth` endpoint, then redirect;
188
- 4. receive only `handoffCode` at the MFE callback, scrub all callback query
189
- parameters, and consume the verifier once;
190
- 5. `POST {gateway.baseUrl}{handoffEndpoint}` with credentials and
191
- `{ mfeId, returnUrl, handoffCode, codeVerifier }`;
192
- 6. pass the session response to `AuthService.acceptTokenResponse()` and keep
193
- its access token in memory. Refresh, current-user, and logout then use the
194
- central Gateway's HttpOnly refresh cookie.
195
-
196
- `sessionStorage` contains only `auth-google-gateway-session`: the PKCE verifier,
197
- `mfeId`, `returnUrl`, and expiry metadata. It never contains an access token,
198
- refresh token, Google token, authorization URL, or handoff code. The record is
199
- removed before every success/error handoff branch so reload and replay fail
200
- closed. A failed start or handoff returns the UI to a retryable error state.
201
-
202
- ### Backend contract
203
-
204
- The code exchange happens on the backend so the client secret never reaches
205
- the frontend. The callback page calls the generated SDK method
206
- `AuthSessionService.exchangeGoogleCode(...)` from `@edsis/sdk/auth` (no raw
207
- `HttpClient`, consistent with `verifyMagicLink`/`refreshAuthToken`), which maps
208
- to:
209
-
210
- ```http
211
- POST {apiUrl}/v1/auth/google
212
- Body: { "code": string, "redirectUri": string }
213
- ```
214
-
215
- Because the path lives under `/v1/auth/`, `edsisAuthInterceptor` sends it with
216
- cookie credentials automatically. The endpoint:
217
-
218
- 1. exchanges `code` at Google's token endpoint using the server-side client
219
- secret and the received `redirectUri`;
220
- 2. sets the refresh-token cookie, exactly like magic-link verify does;
221
- 3. responds with a session payload **identical** to `POST /v1/auth/verify`
222
- (`{ status, message, data: { access_token, user_id, role, name } }`).
223
-
224
- On success the callback page passes the response to `AuthService`, which keeps
225
- the access token only in memory, then redirects to `authenticatedHomePath`; on
226
- failure it shows the backend `message` when one is provided (with a retry link
227
- back to `loginPath`).
228
-
229
- The endpoint definition comes from `openapi.bundle.yaml`; regenerate the SDK in
230
- `library/sdk` after spec changes with `bun run gen:sdk` (driven by
231
- `config/sdk.config.json`, generator: `@ojiepermana/angular-sdk`).
232
-
233
- ## `platform/mfe`: standalone profile and hybrid contract
234
-
235
- Every MFE registry entry declares `standaloneProfile: 'mfe-standalone'`; the
236
- remote contract does not duplicate that registry-owned value. The named profile
237
- centralizes the current Developer standalone defaults: desktop/compact theme,
238
- base/horizontal/full layout, and horizontal/flyout/top navigation. Hosted
239
- routes/components inherit the shell singletons and must not register standalone
240
- providers again.
241
-
242
- ```ts
243
- import { defineMfe, provideStandaloneMfe, readMfeContract } from '@edsis/angular/platform/mfe';
244
-
245
- export const mfe = defineMfe({
246
- contractVersion: 1,
247
- id: 'developer-guide',
248
- displayName: 'Developer Guide',
249
- featureRoutes,
250
- navigation,
251
- capabilities,
252
- exposures,
253
- });
254
-
255
- bootstrapApplication(App, {
256
- providers: [
257
- provideStandaloneMfe({
258
- standaloneProfile: registration.standaloneProfile,
259
- auth: environment.auth,
260
- runtime: environment.runtime,
261
- }),
262
- ],
263
- });
264
- ```
265
-
266
- `provideStandaloneMfe()` owns runtime, theme, profile preferences, navigation
267
- defaults, and auth bootstrap for standalone mode. Shared Edsis components own
268
- their accessibility behavior; no parallel per-MFE a11y singleton is required.
269
-
270
- Federation hosts load the remote namespace through the public boundary helper:
271
-
272
- ```ts
273
- const contract = readMfeContract(remoteModule, {
274
- id: registration.id,
275
- supportedContractVersions: registration.supportedContractVersions,
276
- });
277
- ```
278
-
279
- The helper requires the exact named `mfe` export, validates the complete V1
280
- shape first, then checks registry ID and supported contract majors. Shape
281
- failures throw `MfeContractValidationError` with diagnostic `issues`; namespace
282
- and registry-expectation failures use the same error class with an empty issue
283
- array and a boundary-specific message.
284
-
285
- ## Generate and build
286
-
287
- Use the root workspace scripts so SDK generation and library packaging stay in sync:
288
-
289
- ```bash
290
- bun run build:library
291
- ```
292
-
293
- That command builds the UI package, then the SDK, and finally packages this library:
294
-
295
- ```bash
296
- bun run build:ui
297
- bun run gen:sdk
298
- bunx ng build sdk
299
- bunx ng build library
300
- ```
301
-
302
- The packaged output is written to `dist/library`, including the reusable `@edsis/angular/module/auth` entry point.
303
-
304
- ## Full release
305
-
306
- Run the guarded release flow with:
5
+ The Edsis design system for Angular v22.2+, published as **one package**.
6
+ Components, charts, navigation shells, theme tokens, and the OpenAPI SDK
7
+ generator all live behind subpath entry points of this single install.
307
8
 
308
9
  ```bash
309
- bun run release:library
10
+ bun add @edsis/angular
11
+ # or: npm install @edsis/angular
310
12
  ```
311
13
 
312
- The script will:
313
-
314
- - reject the release if the git worktree is dirty
315
- - reject the release if the current branch still has commits that are not pushed, is behind, or is diverged from its upstream branch
316
- - ask for a version bump using `X`, `Y`, or `Z`
317
- - map `X` to major, `Y` to minor, and `Z` to patch, then increment the current version automatically
318
- - ask for a final confirmation before continuing
319
- - run `bun run build:library`
320
- - commit the version bump and generated SDK updates with `update version ke {{version}}`
321
- - push the commit
322
- - publish `dist/library` to the public npm registry
14
+ | Subpath | What it provides |
15
+ | ---------------------------- | ------------------------------------------------------- |
16
+ | `@edsis/angular/component` | UI components (button, dialog, table, …) + `icon` utils |
17
+ | `@edsis/angular/chart` | Chart families built on `d3-scale`/`d3-shape` |
18
+ | `@edsis/angular/navigation` | App shell / navigation container |
19
+ | `@edsis/angular/theme` | Theme provider, tokens, and Tailwind v4 CSS |
20
+ | `@edsis/angular/sdk` | OpenAPI → Angular SDK generator (schematics) |
323
21
 
324
- For a non-interactive release, provide the bump and confirmation flags explicitly:
22
+ ## Peer dependencies
325
23
 
326
- ```bash
327
- bun run release:library --bump Z --yes
328
- ```
24
+ You must already have Angular v22.2+ in your app (`@angular/common`, `@angular/core`,
25
+ plus `@angular/router` and `rxjs`) and `@lucide/angular` (>=1.61.0 <2.0.0), which draws
26
+ every icon. `@angular/cdk`, `@angular/forms`, and
27
+ `@angular/platform-browser` are optional peers: install them when you use the
28
+ surfaces that need them.
329
29
 
330
- Preview the release plan without changing files:
30
+ **`@angular/material` is optional.** The **`select`** skin requires it. Calendar
31
+ and DatePicker use the library's own controls and do not require Material. Install
32
+ it when you import Select:
331
33
 
332
34
  ```bash
333
- bun run release:library:dry-run --bump Y --yes
35
+ bun add @angular/material
334
36
  ```
335
37
 
336
- ## Versioning
38
+ Every other component is built on the Angular CDK + Tailwind tokens and needs no
39
+ Material.
337
40
 
338
- Update the publishable package version in `library/angular/package.json` with:
41
+ ## Importing — `@edsis/angular/<lib>/<entry>`
339
42
 
340
- ```bash
341
- bun run version:library patch
342
- bun run version:library minor
343
- bun run version:library 1.2.3
344
- bun run version:library prerelease --preid beta
345
- ```
346
-
347
- The version script only updates the source package manifest. The built package in
348
- `dist/library` picks up the version on the next `bun run build:library`.
43
+ Every component, chart, and service is reached through a nested subpath. Each
44
+ subpath is its own entry point and is fully tree-shakeable.
349
45
 
350
- ## Pack and publish locally
46
+ ```ts
47
+ // Components — one entry point per component
48
+ import { Button } from '@edsis/angular/component/button';
49
+ import { Card } from '@edsis/angular/component/card';
50
+ import { Dialog } from '@edsis/angular/component/dialog';
351
51
 
352
- Run the interactive local publish workflow with:
52
+ // Charts
53
+ import { BarChart } from '@edsis/angular/chart/bar';
353
54
 
354
- ```bash
355
- bun run publish
55
+ // Theme provider
56
+ import { provideUiTheme } from '@edsis/angular/theme/styles';
356
57
  ```
357
58
 
358
- The script will:
359
-
360
- - verify the active npm login against the public npm registry
361
- - ask for a version bump using `X`, `Y`, or `Z`
362
- - update `library/sdk/package.json`, `config/sdk.config.json`, and `library/angular/package.json`
363
- - run `bun run build:library`, which builds the UI package, then the SDK, and finally the library
364
- - publish `dist/sdk` and then `dist/library` to npm public with `--access public`
59
+ **Subpaths only in production.** The bare `@edsis/angular` root barrel
60
+ re-exports the _entire_ design system (chart + component + navigation + sdk +
61
+ theme). Importing from it pulls everything into your bundle, so reserve it for
62
+ tests, demos, or prototypes:
365
63
 
366
- For a non-interactive publish, provide the bump and confirmation flags explicitly:
64
+ ```ts
65
+ // ✗ Avoid in production — drags in the whole design system
66
+ import * as Ui from '@edsis/angular';
367
67
 
368
- ```bash
369
- bun run publish --bump Z --yes
68
+ // ✓ Production — granular, tree-shakeable
69
+ import { Button } from '@edsis/angular/component/button';
370
70
  ```
371
71
 
372
- Preview the publish plan without changing files:
373
-
374
- ```bash
375
- bun run publish --dry-run --bump Y --yes
376
- ```
72
+ ## Theme & Tailwind v4 setup
377
73
 
378
- Publish only the SDK package:
74
+ Add the theme tokens, Tailwind, and the Tailwind token mapping to your global
75
+ stylesheet (the CSS ships inside the package and is reachable by name):
379
76
 
380
- ```bash
381
- bun run publish --sdk --bump Z --yes
77
+ ```css
78
+ /* styles.css */
79
+ @import '@edsis/angular/theme/styles/css/index.css'; /* base + all color + neutral palettes */
80
+ @import 'tailwindcss';
81
+ @import '@edsis/angular/theme/styles/css/base/tailwind.css'; /* maps tokens → bg-primary, bg-brand, text-foreground, … */
382
82
  ```
383
83
 
384
- Publish only the library package:
84
+ Then register the provider:
385
85
 
386
- ```bash
387
- bun run publish --lib --bump Z --yes
388
- ```
389
-
390
- Preview the npm tarball:
391
-
392
- ```bash
393
- bun run pack:library
394
- ```
395
-
396
- Publish to npm:
86
+ ```ts
87
+ import { provideUiTheme } from '@edsis/angular/theme/styles';
397
88
 
398
- ```bash
399
- bun run publish
400
- bun run publish --tag next
401
- bun run publish:sdk
402
- bun run publish:library
89
+ export const appConfig = {
90
+ providers: [provideUiTheme({ mode: 'light', color: 'base', neutral: 'base' })],
91
+ };
403
92
  ```
404
93
 
405
- Run a local publish dry-run:
94
+ ### Icons (Lucide)
406
95
 
407
- ```bash
408
- bun run publish:sdk:dry-run
409
- bun run publish:library:dry-run
410
- ```
96
+ Icons are [Lucide](https://lucide.dev/icons/) SVGs from the required `@lucide/angular`
97
+ peer, so nothing is fetched at runtime (no icon font, no third-party host). Register the
98
+ icons you name as strings with `provideIcons()`; only those reach your bundle:
411
99
 
412
- When updating `@ojiepermana/angular`, use the helper below instead of a plain `bun update` so the version pin, patch mapping, install step, and SDK build verification stay in sync:
100
+ ```ts
101
+ import { LucideHouse, LucideSettings } from '@lucide/angular';
102
+ import { provideIcons } from '@edsis/angular/component/icon';
413
103
 
414
- ```bash
415
- bun run update:edsis
104
+ export const appConfig = {
105
+ providers: [provideIcons(LucideHouse, LucideSettings)],
106
+ };
416
107
  ```
417
108
 
418
- If a specific version needs to be tested:
419
-
420
- ```bash
421
- bun run update:edsis 21.1.11
109
+ ```html
110
+ <Icon name="house" [size]="20" />
422
111
  ```
423
112
 
424
- `publish` publishes `@edsis/sdk` before `@edsis/angular`. `publish:sdk` and `publish:library` use the same helper with `--sdk` or `--lib` and force `--access public`.
113
+ Library components register their own fixed icons, so navigation and the theme settings
114
+ drawer work without extra setup. Navigation `item.icon` values are Lucide names you register.
425
115
 
426
- For local publishes, the script does not add `--provenance` by default because npm provenance generation is not supported outside compatible CI providers. If you need provenance in a supported CI environment, pass it explicitly:
116
+ ## SDK schematics
427
117
 
428
118
  ```bash
429
- bun run publish --provenance
119
+ ng add @edsis/angular
120
+ ng generate @edsis/angular:sdk
430
121
  ```
431
122
 
432
- ## GitHub publish workflow
123
+ ## Links
433
124
 
434
- The repository includes `.github/workflows/publish-library.yml`.
125
+ - Source: git+https://github.com/ojiepermana/angular.git
126
+ - Documentation: https://github.com/ojiepermana/angular#readme
435
127
 
436
- It supports:
128
+ ## License
437
129
 
438
- - pushing a tag named `library-vX.Y.Z`
439
- - manual `workflow_dispatch` runs with an npm tag and optional dry-run
130
+ MIT. See the bundled `LICENSE` file.
440
131
 
441
- The workflow uses npm trusted publishing via GitHub Actions OIDC, so it does
442
- not require a repository `NPM_TOKEN` secret. The npm package must be configured
443
- to trust this repository workflow as a publisher. On tag pushes, the tag
444
- version must match `library/angular/package.json`.
132
+ ## Support and security
445
133
 
446
- Recommended local release flow:
134
+ Angular 22.2–22.x CSR/browser usage is supported; SSR, prerendering, and hydration are not. See the
135
+ bundled `SUPPORT.md`. Report suspected vulnerabilities privately using the instructions in the
136
+ bundled `SECURITY.md`.
447
137
 
448
- 1. Run `bun run release:library`.
449
- 2. Select `X`, `Y`, or `Z`, then confirm the computed version.
450
- 3. Let the script build, commit, push, and publish the package.
138
+ Supported Node versions: ^22.22.3 || ^24.15.0 || >=26.0.0 <27.0.0. Apps on Angular 22.1 must upgrade. Angular peers require >=22.2.0 <23.0.0; optional peers remain optional.
package/SECURITY.md ADDED
@@ -0,0 +1,18 @@
1
+ # Security Policy
2
+
3
+ ## Supported versions
4
+
5
+ Only the latest published Angular 22 release of the `@ojiepermana/*` package suite receives
6
+ security fixes. Older releases should be upgraded before a report is investigated.
7
+
8
+ ## Reporting a vulnerability
9
+
10
+ Do not open a public issue for a suspected vulnerability. Email `me@ojiepermana.com` with:
11
+
12
+ - the affected package and version;
13
+ - a minimal reproduction or proof of concept;
14
+ - the expected impact; and
15
+ - any suggested mitigation, if known.
16
+
17
+ Do not include production credentials, personal data, or third-party secrets. Reports are
18
+ acknowledged and handled privately before a coordinated fix is published.
package/SUPPORT.md ADDED
@@ -0,0 +1,15 @@
1
+ # Runtime Support
2
+
3
+ The published `@ojiepermana/*` UI packages support Angular 22.2 or newer applications running in a
4
+ modern browser with client-side rendering (CSR).
5
+
6
+ | Runtime | Support |
7
+ | -------------------------------------------------------------- | ------------------------------------------------------ |
8
+ | Angular 22.2–22.x CSR in current Chromium, Firefox, and WebKit | Supported |
9
+ | Angular 22.1 or earlier | Unsupported |
10
+ | Angular 23 or later | Unsupported until a matching package major is released |
11
+ | Server-side rendering, prerendering, and hydration | Unsupported |
12
+
13
+ DOM observers, browser locale/timezone, generated client IDs, and chart style injection are browser
14
+ runtime contracts only. The SDK package is a Node-based schematic/code-generation tool and follows
15
+ the Node engine range declared in its package manifest.