@edsis/angular 22.1.3 → 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.
- package/LICENSE +21 -0
- package/README.md +87 -399
- package/SECURITY.md +18 -0
- package/SUPPORT.md +15 -0
- package/chart/README.md +272 -0
- package/component/README.md +89 -0
- package/component/accordion/README.md +195 -0
- package/component/alert/README.md +184 -0
- package/component/alert-dialog/README.md +255 -0
- package/component/aspect-ratio/README.md +116 -0
- package/component/avatar/README.md +182 -0
- package/component/badge/README.md +143 -0
- package/component/breadcrumb/README.md +223 -0
- package/component/button/README.md +141 -0
- package/component/button-group/README.md +214 -0
- package/component/calendar/README.md +125 -0
- package/component/card/README.md +232 -0
- package/component/carousel/README.md +276 -0
- package/component/checkbox/README.md +153 -0
- package/component/collapsible/README.md +216 -0
- package/component/combobox/README.md +202 -0
- package/component/command/README.md +287 -0
- package/component/composer/README.md +241 -0
- package/component/context-menu/README.md +268 -0
- package/component/date-picker/README.md +202 -0
- package/component/dialog/README.md +276 -0
- package/component/drawer/README.md +146 -0
- package/component/dropdown-menu/README.md +336 -0
- package/component/editor/README.md +152 -0
- package/component/empty/README.md +193 -0
- package/component/form/README.md +216 -0
- package/component/hover-card/README.md +150 -0
- package/component/icon/README.md +52 -0
- package/component/input/README.md +160 -0
- package/component/input-group/README.md +245 -0
- package/component/input-otp/README.md +331 -0
- package/component/item/README.md +254 -0
- package/component/kanban/README.md +81 -0
- package/component/kbd/README.md +141 -0
- package/component/label/README.md +137 -0
- package/component/menubar/README.md +270 -0
- package/component/native-select/README.md +176 -0
- package/component/navigation-menu/README.md +165 -0
- package/component/pagination/README.md +151 -0
- package/component/pillbox/README.md +68 -0
- package/component/popover/README.md +54 -0
- package/component/progress/README.md +160 -0
- package/component/radio/README.md +212 -0
- package/component/resizable/README.md +178 -0
- package/component/scroll-area/README.md +150 -0
- package/component/select/README.md +228 -0
- package/component/separator/README.md +175 -0
- package/component/sheet/README.md +190 -0
- package/component/skeleton/README.md +158 -0
- package/component/slider/README.md +207 -0
- package/component/spinner/README.md +160 -0
- package/component/switch/README.md +170 -0
- package/component/table/README.md +292 -0
- package/component/tabs/README.md +220 -0
- package/component/textarea/README.md +169 -0
- package/component/timeline/README.md +94 -0
- package/component/toast/README.md +173 -0
- package/component/toggle/README.md +133 -0
- package/component/toggle-group/README.md +234 -0
- package/component/tooltip/README.md +230 -0
- package/fesm2022/edsis-angular-chart-area.mjs +508 -0
- package/fesm2022/edsis-angular-chart-bar.mjs +946 -0
- package/fesm2022/edsis-angular-chart-core.mjs +1282 -0
- package/fesm2022/edsis-angular-chart-line.mjs +544 -0
- package/fesm2022/edsis-angular-chart-pie.mjs +524 -0
- package/fesm2022/edsis-angular-chart-primitives.mjs +1647 -0
- package/fesm2022/edsis-angular-chart-radar.mjs +693 -0
- package/fesm2022/edsis-angular-chart-radial.mjs +542 -0
- package/fesm2022/edsis-angular-chart-scatter.mjs +486 -0
- package/fesm2022/edsis-angular-chart.mjs +3 -0
- package/fesm2022/edsis-angular-component-accordion.mjs +513 -0
- package/fesm2022/edsis-angular-component-alert-dialog.mjs +1001 -0
- package/fesm2022/edsis-angular-component-alert.mjs +268 -0
- package/fesm2022/edsis-angular-component-aspect-ratio.mjs +80 -0
- package/fesm2022/edsis-angular-component-avatar.mjs +410 -0
- package/fesm2022/edsis-angular-component-badge.mjs +111 -0
- package/fesm2022/edsis-angular-component-breadcrumb.mjs +464 -0
- package/fesm2022/edsis-angular-component-button-group.mjs +252 -0
- package/fesm2022/edsis-angular-component-button.mjs +155 -0
- package/fesm2022/edsis-angular-component-calendar.mjs +835 -0
- package/fesm2022/edsis-angular-component-card.mjs +460 -0
- package/fesm2022/edsis-angular-component-carousel.mjs +700 -0
- package/fesm2022/edsis-angular-component-checkbox.mjs +398 -0
- package/fesm2022/edsis-angular-component-collapsible.mjs +305 -0
- package/fesm2022/edsis-angular-component-combobox.mjs +544 -0
- package/fesm2022/edsis-angular-component-command.mjs +815 -0
- package/fesm2022/edsis-angular-component-composer.mjs +840 -0
- package/fesm2022/edsis-angular-component-context-menu.mjs +197 -0
- package/fesm2022/edsis-angular-component-date-picker.mjs +798 -0
- package/fesm2022/edsis-angular-component-dialog.mjs +798 -0
- package/fesm2022/edsis-angular-component-drawer.mjs +2 -0
- package/fesm2022/edsis-angular-component-dropdown-menu.mjs +1259 -0
- package/fesm2022/edsis-angular-component-editor.mjs +1000 -0
- package/fesm2022/edsis-angular-component-empty.mjs +351 -0
- package/fesm2022/edsis-angular-component-form.mjs +821 -0
- package/fesm2022/edsis-angular-component-hover-card.mjs +486 -0
- package/fesm2022/edsis-angular-component-icon.mjs +253 -0
- package/fesm2022/edsis-angular-component-input-group.mjs +453 -0
- package/fesm2022/edsis-angular-component-input-otp.mjs +957 -0
- package/fesm2022/edsis-angular-component-input.mjs +87 -0
- package/fesm2022/edsis-angular-component-item.mjs +720 -0
- package/fesm2022/edsis-angular-component-kanban.mjs +812 -0
- package/fesm2022/edsis-angular-component-kbd.mjs +124 -0
- package/fesm2022/edsis-angular-component-label.mjs +82 -0
- package/fesm2022/edsis-angular-component-menubar.mjs +481 -0
- package/fesm2022/edsis-angular-component-native-select.mjs +168 -0
- package/fesm2022/edsis-angular-component-navigation-menu.mjs +685 -0
- package/fesm2022/edsis-angular-component-pagination.mjs +425 -0
- package/fesm2022/edsis-angular-component-pillbox.mjs +1679 -0
- package/fesm2022/edsis-angular-component-popover.mjs +292 -0
- package/fesm2022/edsis-angular-component-progress.mjs +184 -0
- package/fesm2022/edsis-angular-component-radio.mjs +491 -0
- package/fesm2022/edsis-angular-component-resizable.mjs +703 -0
- package/fesm2022/edsis-angular-component-scroll-area.mjs +133 -0
- package/fesm2022/edsis-angular-component-segmented-control.mjs +408 -0
- package/fesm2022/edsis-angular-component-select.mjs +743 -0
- package/fesm2022/edsis-angular-component-separator.mjs +102 -0
- package/fesm2022/edsis-angular-component-sheet.mjs +874 -0
- package/fesm2022/edsis-angular-component-skeleton.mjs +62 -0
- package/fesm2022/edsis-angular-component-slider.mjs +676 -0
- package/fesm2022/edsis-angular-component-spinner.mjs +157 -0
- package/fesm2022/edsis-angular-component-switch.mjs +361 -0
- package/fesm2022/edsis-angular-component-table.mjs +446 -0
- package/fesm2022/edsis-angular-component-tabs.mjs +592 -0
- package/fesm2022/edsis-angular-component-textarea.mjs +85 -0
- package/fesm2022/edsis-angular-component-timeline.mjs +619 -0
- package/fesm2022/edsis-angular-component-toast.mjs +231 -0
- package/fesm2022/edsis-angular-component-toggle-group.mjs +579 -0
- package/fesm2022/edsis-angular-component-toggle.mjs +189 -0
- package/fesm2022/edsis-angular-component-tooltip.mjs +804 -0
- package/fesm2022/edsis-angular-component-utils-core.mjs +181 -0
- package/fesm2022/edsis-angular-component-utils-overlay.mjs +54 -0
- package/fesm2022/edsis-angular-component-utils-scale.mjs +76 -0
- package/fesm2022/edsis-angular-component-utils.mjs +2 -0
- package/fesm2022/edsis-angular-component.mjs +0 -0
- package/fesm2022/edsis-angular-navigation-core.mjs +15 -0
- package/fesm2022/edsis-angular-navigation-icon.mjs +35 -0
- package/fesm2022/edsis-angular-navigation-navigation-badge-count.component-BWWWaUgy.mjs +234 -0
- package/fesm2022/edsis-angular-navigation-navigation-dockbar-menu.component-Bx2bxTID.mjs +834 -0
- package/fesm2022/edsis-angular-navigation-navigation-entry-grid.component-Duzt1ffz.mjs +823 -0
- package/fesm2022/edsis-angular-navigation-navigation-flyout-menu.component-cJ8Q1vM6.mjs +670 -0
- package/fesm2022/edsis-angular-navigation-navigation-horizontal.component-CDQ1wt2_.mjs +689 -0
- package/fesm2022/edsis-angular-navigation-navigation-item.component-C1VzerJp.mjs +1522 -0
- package/fesm2022/edsis-angular-navigation-navigation-list.component-BPYLfrID.mjs +346 -0
- package/fesm2022/edsis-angular-navigation-service.mjs +558 -0
- package/fesm2022/edsis-angular-navigation-types.mjs +151 -0
- package/fesm2022/edsis-angular-navigation.mjs +3338 -0
- package/fesm2022/edsis-angular-sdk.mjs +100 -0
- package/fesm2022/edsis-angular-theme-component-settings.mjs +1877 -0
- package/fesm2022/edsis-angular-theme-layout-services.mjs +252 -0
- package/fesm2022/edsis-angular-theme-layout-types.mjs +45 -0
- package/fesm2022/edsis-angular-theme-layout-wrapper.mjs +2568 -0
- package/fesm2022/edsis-angular-theme-layout.mjs +1089 -0
- package/fesm2022/edsis-angular-theme-page-core.mjs +315 -0
- package/fesm2022/edsis-angular-theme-page-filter.mjs +409 -0
- package/fesm2022/edsis-angular-theme-page-overview.mjs +88 -0
- package/fesm2022/edsis-angular-theme-page-root.mjs +693 -0
- package/fesm2022/edsis-angular-theme-page-side.mjs +342 -0
- package/fesm2022/edsis-angular-theme-page-slots.mjs +258 -0
- package/fesm2022/edsis-angular-theme-page.mjs +7 -0
- package/fesm2022/edsis-angular-theme-shell-services.mjs +231 -0
- package/fesm2022/edsis-angular-theme-shell-types.mjs +102 -0
- package/fesm2022/edsis-angular-theme-shell.mjs +1352 -0
- package/fesm2022/edsis-angular-theme-styles.mjs +572 -0
- package/fesm2022/edsis-angular-theme.mjs +0 -0
- package/fesm2022/edsis-angular.mjs +5 -8
- package/navigation/README.md +576 -0
- package/package.json +477 -52
- package/sdk/README.md +212 -0
- package/sdk/schematics/collection.json +20 -0
- package/sdk/schematics/init/index.js +83 -0
- package/sdk/schematics/init/schema.json +19 -0
- package/sdk/schematics/ng-add/index.js +147 -0
- package/sdk/schematics/ng-add/schema.json +14 -0
- package/sdk/schematics/package.json +3 -0
- package/sdk/schematics/sdk/index.js +175 -0
- package/sdk/schematics/sdk/schema.json +19 -0
- package/sdk/sdk.config.example.json +24 -0
- package/sdk/src/config/loader.js +43 -0
- package/sdk/src/config/schema.js +59 -0
- package/sdk/src/emit/client.js +251 -0
- package/sdk/src/emit/metadata.js +310 -0
- package/sdk/src/emit/models.js +104 -0
- package/sdk/src/emit/navigation.js +56 -0
- package/sdk/src/emit/operations.js +118 -0
- package/sdk/src/emit/public-api.js +54 -0
- package/sdk/src/emit/services.js +110 -0
- package/sdk/src/engine.js +67 -0
- package/sdk/src/layout/per-domain.js +360 -0
- package/sdk/src/package.json +3 -0
- package/sdk/src/parser/bundle.js +25 -0
- package/sdk/src/parser/ir.js +429 -0
- package/sdk/src/parser/types.js +7 -0
- package/sdk/src/render/template.js +152 -0
- package/sdk/src/writer/index.js +286 -0
- package/theme/README.md +120 -0
- package/theme/component/settings/README.md +154 -0
- package/theme/layout/README.md +604 -0
- package/theme/page/README.md +505 -0
- package/theme/shell/README.md +344 -0
- package/theme/styles/README.md +202 -0
- package/theme/styles/css/base/components.css +577 -0
- package/theme/styles/css/base/index.css +14 -0
- package/theme/styles/css/base/package.css +9 -0
- package/theme/styles/css/base/prefers-dark.css +86 -0
- package/theme/styles/css/base/print.css +62 -0
- package/theme/styles/css/base/status.css +38 -0
- package/theme/styles/css/base/tailwind.css +208 -0
- package/theme/styles/css/base/theme.css +353 -0
- package/theme/styles/css/base/tokens.css +388 -0
- package/theme/styles/css/color/amber.css +72 -0
- package/theme/styles/css/color/blue.css +72 -0
- package/theme/styles/css/color/brand.css +38 -0
- package/theme/styles/css/color/cyan.css +72 -0
- package/theme/styles/css/color/emerald.css +72 -0
- package/theme/styles/css/color/fuchsia.css +72 -0
- package/theme/styles/css/color/green.css +72 -0
- package/theme/styles/css/color/index.css +19 -0
- package/theme/styles/css/color/indigo.css +72 -0
- package/theme/styles/css/color/lime.css +72 -0
- package/theme/styles/css/color/orange.css +72 -0
- package/theme/styles/css/color/pink.css +72 -0
- package/theme/styles/css/color/purple.css +72 -0
- package/theme/styles/css/color/red.css +72 -0
- package/theme/styles/css/color/rose.css +72 -0
- package/theme/styles/css/color/sky.css +72 -0
- package/theme/styles/css/color/teal.css +72 -0
- package/theme/styles/css/color/violet.css +72 -0
- package/theme/styles/css/color/yellow.css +72 -0
- package/theme/styles/css/fonts.css +85 -0
- package/theme/styles/css/index.css +18 -0
- package/theme/styles/css/neutral/gray.css +63 -0
- package/theme/styles/css/neutral/index.css +11 -0
- package/theme/styles/css/neutral/mauve.css +63 -0
- package/theme/styles/css/neutral/mist.css +63 -0
- package/theme/styles/css/neutral/neutral.css +63 -0
- package/theme/styles/css/neutral/olive.css +63 -0
- package/theme/styles/css/neutral/slate.css +63 -0
- package/theme/styles/css/neutral/stone.css +63 -0
- package/theme/styles/css/neutral/taupe.css +63 -0
- package/theme/styles/css/neutral/zinc.css +63 -0
- package/theme/styles/css/radius/index.css +30 -0
- package/theme/styles/css/space/index.css +20 -0
- package/types/edsis-angular-chart-area.d.ts +139 -0
- package/types/edsis-angular-chart-bar.d.ts +291 -0
- package/types/edsis-angular-chart-core.d.ts +822 -0
- package/types/edsis-angular-chart-line.d.ts +148 -0
- package/types/edsis-angular-chart-pie.d.ts +202 -0
- package/types/edsis-angular-chart-primitives.d.ts +360 -0
- package/types/edsis-angular-chart-radar.d.ts +198 -0
- package/types/edsis-angular-chart-radial.d.ts +187 -0
- package/types/edsis-angular-chart-scatter.d.ts +181 -0
- package/types/edsis-angular-chart.d.ts +3 -0
- package/types/edsis-angular-component-accordion.d.ts +139 -0
- package/types/edsis-angular-component-alert-dialog.d.ts +288 -0
- package/types/edsis-angular-component-alert.d.ts +72 -0
- package/types/edsis-angular-component-aspect-ratio.d.ts +20 -0
- package/types/edsis-angular-component-avatar.d.ts +111 -0
- package/types/edsis-angular-component-badge.d.ts +36 -0
- package/types/edsis-angular-component-breadcrumb.d.ts +85 -0
- package/types/edsis-angular-component-button-group.d.ts +50 -0
- package/types/edsis-angular-component-button.d.ts +44 -0
- package/types/edsis-angular-component-calendar.d.ts +150 -0
- package/types/edsis-angular-component-card.d.ts +123 -0
- package/types/edsis-angular-component-carousel.d.ts +155 -0
- package/types/edsis-angular-component-checkbox.d.ts +100 -0
- package/types/edsis-angular-component-collapsible.d.ts +68 -0
- package/types/edsis-angular-component-combobox.d.ts +105 -0
- package/types/edsis-angular-component-command.d.ts +215 -0
- package/types/edsis-angular-component-composer.d.ts +190 -0
- package/types/edsis-angular-component-context-menu.d.ts +64 -0
- package/types/edsis-angular-component-date-picker.d.ts +199 -0
- package/types/edsis-angular-component-dialog.d.ts +231 -0
- package/types/edsis-angular-component-drawer.d.ts +2 -0
- package/types/edsis-angular-component-dropdown-menu.d.ts +370 -0
- package/types/edsis-angular-component-editor.d.ts +234 -0
- package/types/edsis-angular-component-empty.d.ts +85 -0
- package/types/edsis-angular-component-form.d.ts +223 -0
- package/types/edsis-angular-component-hover-card.d.ts +133 -0
- package/types/edsis-angular-component-icon.d.ts +90 -0
- package/types/edsis-angular-component-input-group.d.ts +98 -0
- package/types/edsis-angular-component-input-otp.d.ts +249 -0
- package/types/edsis-angular-component-input.d.ts +31 -0
- package/types/edsis-angular-component-item.d.ts +169 -0
- package/types/edsis-angular-component-kanban.d.ts +165 -0
- package/types/edsis-angular-component-kbd.d.ts +25 -0
- package/types/edsis-angular-component-label.d.ts +19 -0
- package/types/edsis-angular-component-menubar.d.ts +123 -0
- package/types/edsis-angular-component-native-select.d.ts +39 -0
- package/types/edsis-angular-component-navigation-menu.d.ts +163 -0
- package/types/edsis-angular-component-pagination.d.ts +83 -0
- package/types/edsis-angular-component-pillbox.d.ts +380 -0
- package/types/edsis-angular-component-popover.d.ts +96 -0
- package/types/edsis-angular-component-progress.d.ts +45 -0
- package/types/edsis-angular-component-radio.d.ts +137 -0
- package/types/edsis-angular-component-resizable.d.ts +166 -0
- package/types/edsis-angular-component-scroll-area.d.ts +37 -0
- package/types/edsis-angular-component-segmented-control.d.ts +102 -0
- package/types/edsis-angular-component-select.d.ts +138 -0
- package/types/edsis-angular-component-separator.d.ts +26 -0
- package/types/edsis-angular-component-sheet.d.ts +240 -0
- package/types/edsis-angular-component-skeleton.d.ts +13 -0
- package/types/edsis-angular-component-slider.d.ts +148 -0
- package/types/edsis-angular-component-spinner.d.ts +31 -0
- package/types/edsis-angular-component-switch.d.ts +101 -0
- package/types/edsis-angular-component-table.d.ts +109 -0
- package/types/edsis-angular-component-tabs.d.ts +183 -0
- package/types/edsis-angular-component-textarea.d.ts +27 -0
- package/types/edsis-angular-component-timeline.d.ts +146 -0
- package/types/edsis-angular-component-toast.d.ts +60 -0
- package/types/edsis-angular-component-toggle-group.d.ts +161 -0
- package/types/edsis-angular-component-toggle.d.ts +47 -0
- package/types/edsis-angular-component-tooltip.d.ts +233 -0
- package/types/edsis-angular-component-utils-core.d.ts +175 -0
- package/types/edsis-angular-component-utils-overlay.d.ts +17 -0
- package/types/edsis-angular-component-utils-scale.d.ts +27 -0
- package/types/edsis-angular-component-utils.d.ts +2 -0
- package/types/edsis-angular-component.d.ts +1 -0
- package/types/edsis-angular-navigation-core.d.ts +55 -0
- package/types/edsis-angular-navigation-icon.d.ts +9 -0
- package/types/edsis-angular-navigation-service.d.ts +121 -0
- package/types/edsis-angular-navigation-types.d.ts +185 -0
- package/types/edsis-angular-navigation.d.ts +862 -0
- package/types/edsis-angular-sdk.d.ts +87 -0
- package/types/edsis-angular-theme-component-settings.d.ts +205 -0
- package/types/edsis-angular-theme-layout-services.d.ts +143 -0
- package/types/edsis-angular-theme-layout-types.d.ts +36 -0
- package/types/edsis-angular-theme-layout-wrapper.d.ts +670 -0
- package/types/edsis-angular-theme-layout.d.ts +218 -0
- package/types/edsis-angular-theme-page-core.d.ts +151 -0
- package/types/edsis-angular-theme-page-filter.d.ts +127 -0
- package/types/edsis-angular-theme-page-overview.d.ts +28 -0
- package/types/edsis-angular-theme-page-root.d.ts +172 -0
- package/types/edsis-angular-theme-page-side.d.ts +90 -0
- package/types/edsis-angular-theme-page-slots.d.ts +61 -0
- package/types/edsis-angular-theme-page.d.ts +7 -0
- package/types/edsis-angular-theme-shell-services.d.ts +188 -0
- package/types/edsis-angular-theme-shell-types.d.ts +102 -0
- package/types/edsis-angular-theme-shell.d.ts +178 -0
- package/types/edsis-angular-theme-styles.d.ts +295 -0
- package/types/edsis-angular-theme.d.ts +1 -0
- package/types/edsis-angular.d.ts +5 -2
- package/fesm2022/edsis-angular-block-shell.mjs +0 -1329
- package/fesm2022/edsis-angular-block-shell.mjs.map +0 -1
- package/fesm2022/edsis-angular-block-themes.mjs +0 -1007
- package/fesm2022/edsis-angular-block-themes.mjs.map +0 -1
- package/fesm2022/edsis-angular-module-auth.mjs +0 -2582
- package/fesm2022/edsis-angular-module-auth.mjs.map +0 -1
- package/fesm2022/edsis-angular-platform-mfe.mjs +0 -329
- package/fesm2022/edsis-angular-platform-mfe.mjs.map +0 -1
- package/fesm2022/edsis-angular-services-runtime.mjs +0 -385
- package/fesm2022/edsis-angular-services-runtime.mjs.map +0 -1
- package/fesm2022/edsis-angular.mjs.map +0 -1
- package/types/edsis-angular-block-shell.d.ts +0 -190
- package/types/edsis-angular-block-themes.d.ts +0 -94
- package/types/edsis-angular-module-auth.d.ts +0 -533
- package/types/edsis-angular-platform-mfe.d.ts +0 -126
- 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
|
|
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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
|
10
|
+
bun add @edsis/angular
|
|
11
|
+
# or: npm install @edsis/angular
|
|
310
12
|
```
|
|
311
13
|
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
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
|
-
|
|
22
|
+
## Peer dependencies
|
|
325
23
|
|
|
326
|
-
|
|
327
|
-
|
|
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
|
-
|
|
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
|
|
35
|
+
bun add @angular/material
|
|
334
36
|
```
|
|
335
37
|
|
|
336
|
-
|
|
38
|
+
Every other component is built on the Angular CDK + Tailwind tokens and needs no
|
|
39
|
+
Material.
|
|
337
40
|
|
|
338
|
-
|
|
41
|
+
## Importing — `@edsis/angular/<lib>/<entry>`
|
|
339
42
|
|
|
340
|
-
|
|
341
|
-
|
|
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
|
-
|
|
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
|
-
|
|
52
|
+
// Charts
|
|
53
|
+
import { BarChart } from '@edsis/angular/chart/bar';
|
|
353
54
|
|
|
354
|
-
|
|
355
|
-
|
|
55
|
+
// Theme provider
|
|
56
|
+
import { provideUiTheme } from '@edsis/angular/theme/styles';
|
|
356
57
|
```
|
|
357
58
|
|
|
358
|
-
The
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
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
|
-
|
|
64
|
+
```ts
|
|
65
|
+
// ✗ Avoid in production — drags in the whole design system
|
|
66
|
+
import * as Ui from '@edsis/angular';
|
|
367
67
|
|
|
368
|
-
|
|
369
|
-
|
|
68
|
+
// ✓ Production — granular, tree-shakeable
|
|
69
|
+
import { Button } from '@edsis/angular/component/button';
|
|
370
70
|
```
|
|
371
71
|
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
```bash
|
|
375
|
-
bun run publish --dry-run --bump Y --yes
|
|
376
|
-
```
|
|
72
|
+
## Theme & Tailwind v4 setup
|
|
377
73
|
|
|
378
|
-
|
|
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
|
-
```
|
|
381
|
-
|
|
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
|
-
|
|
84
|
+
Then register the provider:
|
|
385
85
|
|
|
386
|
-
```
|
|
387
|
-
|
|
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
|
-
|
|
399
|
-
|
|
400
|
-
|
|
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
|
-
|
|
94
|
+
### Icons (Lucide)
|
|
406
95
|
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
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
|
-
|
|
100
|
+
```ts
|
|
101
|
+
import { LucideHouse, LucideSettings } from '@lucide/angular';
|
|
102
|
+
import { provideIcons } from '@edsis/angular/component/icon';
|
|
413
103
|
|
|
414
|
-
|
|
415
|
-
|
|
104
|
+
export const appConfig = {
|
|
105
|
+
providers: [provideIcons(LucideHouse, LucideSettings)],
|
|
106
|
+
};
|
|
416
107
|
```
|
|
417
108
|
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
```bash
|
|
421
|
-
bun run update:edsis 21.1.11
|
|
109
|
+
```html
|
|
110
|
+
<Icon name="house" [size]="20" />
|
|
422
111
|
```
|
|
423
112
|
|
|
424
|
-
|
|
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
|
-
|
|
116
|
+
## SDK schematics
|
|
427
117
|
|
|
428
118
|
```bash
|
|
429
|
-
|
|
119
|
+
ng add @edsis/angular
|
|
120
|
+
ng generate @edsis/angular:sdk
|
|
430
121
|
```
|
|
431
122
|
|
|
432
|
-
##
|
|
123
|
+
## Links
|
|
433
124
|
|
|
434
|
-
|
|
125
|
+
- Source: git+https://github.com/ojiepermana/angular.git
|
|
126
|
+
- Documentation: https://github.com/ojiepermana/angular#readme
|
|
435
127
|
|
|
436
|
-
|
|
128
|
+
## License
|
|
437
129
|
|
|
438
|
-
|
|
439
|
-
- manual `workflow_dispatch` runs with an npm tag and optional dry-run
|
|
130
|
+
MIT. See the bundled `LICENSE` file.
|
|
440
131
|
|
|
441
|
-
|
|
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
|
-
|
|
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.
|
|
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.
|