@ojiepermana/angular 22.0.27 → 22.0.31

package/README.md

@@ -1,64 +1,100 @@
-# Angular
+# @ojiepermana/angular
 
-This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 22.0.0.
-
-## Code scaffolding
-
-Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+Umbrella meta-package for the `@ojiepermana/*` design system (Angular v22+).
+Installing it pulls in the whole suite in one command; you then import from the
+per-feature **subpath entry points** that make up the public API.
 
 ```bash
-ng generate component component-name
+bun add @ojiepermana/angular
+# or: npm install @ojiepermana/angular
 ```
 
-For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+This single install resolves all five libraries as direct dependencies:
 
-```bash
-ng generate --help
-```
+| Package                          | What it provides                                        |
+| -------------------------------- | ------------------------------------------------------- |
+| `@ojiepermana/component` | UI components (button, dialog, table, …) + `icon` utils |
+| `@ojiepermana/chart`     | Chart families built on `d3-scale`/`d3-shape`           |
+| `@ojiepermana/navigation`| App shell / navigation container                        |
+| `@ojiepermana/theme`     | Theme provider, tokens, and Tailwind v4 CSS             |
+| `@ojiepermana/sdk`       | OpenAPI → Angular SDK generator (schematics)            |
 
-## Building
+## Peer dependencies
 
-To build the library, run:
+You must already have Angular v22+ in your app (`@angular/common`, `@angular/core`,
+and for some libraries `@angular/forms`, `@angular/router`, `@angular/platform-browser`).
+`@angular/cdk` is pulled in automatically (it is a direct dependency of
+`-component`).
+
+**`@angular/material` is optional.** Only three components wrap Material and
+therefore require it: **`select`**, **`date-picker`**, and **`calendar`**. Install
+it *only* if you import one of those:
 
 ```bash
-ng build angular
+bun add @angular/material
 ```
 
-This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+Every other component is built on the Angular CDK + Tailwind tokens and needs no
+Material.
 
-### Publishing the Library
+## Importing — use the subpaths
 
-Once the project is built, you can publish your library by following these steps:
+The package roots (`@ojiepermana/angular`, `@ojiepermana/angular/component`,
+`@ojiepermana/angular/theme`) are intentionally **empty barrels**: re-exporting
+~60 components from one root would defeat tree-shaking. Import each component from
+its own entry point instead:
 
-1. Navigate to the `dist` directory:
+```ts
+// Components — one entry point per component
+import { Button } from '@ojiepermana/component/button';
+import { Card } from '@ojiepermana/component/card';
+import { Dialog } from '@ojiepermana/component/dialog';
 
-   ```bash
-   cd dist/angular
-   ```
+// Charts
+import { BarChart } from '@ojiepermana/chart/bar';
 
-2. Run the `npm publish` command to publish your library to the npm registry:
-   ```bash
-   npm publish
-   ```
+// Theme provider
+import { provideUiTheme } from '@ojiepermana/theme/styles';
+```
 
-## Running unit tests
+> The `@ojiepermana/angular/<lib>` subpaths exist as a convenience mirror, but the
+> canonical, fully tree-shakeable imports are the `@ojiepermana/<lib>/<name>`
+> entry points shown above.
 
-To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
+## Theme & Tailwind v4 setup
 
-```bash
-ng test
+Add the theme tokens, Tailwind, and the Tailwind token mapping to your global
+stylesheet (the CSS ships inside the package and is reachable by name):
+
+```css
+/* styles.css */
+@import '@ojiepermana/theme/theme.css';                              /* base tokens + component styles */
+@import 'tailwindcss';
+@import '@ojiepermana/theme/styles/css/seasonal/base/tailwind.css';  /* maps tokens → bg-primary, text-foreground, … */
 ```
 
-## Running end-to-end tests
+Then register the provider:
 
-For end-to-end (e2e) testing, run:
+```ts
+import { provideUiTheme } from '@ojiepermana/theme/styles';
 
-```bash
-ng e2e
+export const appConfig = {
+  providers: [provideUiTheme({ mode: 'light', season: 'base' })],
+};
+```
+
+### Material Symbols icons (opt-in)
+
+By default `provideUiTheme()` makes **no external network request**. To preload the
+Material Symbols font from Google Fonts, opt in explicitly:
+
+```ts
+provideUiTheme({ icons: { materialSymbols: true } });
 ```
 
-Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+For privacy / offline / strict-CSP setups, leave it off and self-host the font in
+your own stylesheet instead.
 
-## Additional Resources
+## License
 
-For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
+See the repository for license details.

package/fesm2022/ojiepermana-angular-chart.mjs

@@ -1,11 +1,10 @@
-export * from '@ojiepermana/angular-chart';
+export * from '@ojiepermana/chart';
 
 /*
  * Public API of @ojiepermana/angular/chart
- * Re-exports the independent @ojiepermana/angular-chart package.
+ * Re-exports the independent @ojiepermana/chart package.
  */
 
 /**
  * Generated bundle index. Do not edit.
- */
-//# sourceMappingURL=ojiepermana-angular-chart.mjs.map
+ */

package/fesm2022/ojiepermana-angular-component.mjs

@@ -1,11 +1,10 @@
-export * from '@ojiepermana/angular-component';
+export * from '@ojiepermana/component';
 
 /*
  * Public API of @ojiepermana/angular/component
- * Re-exports the independent @ojiepermana/angular-component package.
+ * Re-exports the independent @ojiepermana/component package.
  */
 
 /**
  * Generated bundle index. Do not edit.
- */
-//# sourceMappingURL=ojiepermana-angular-component.mjs.map
+ */

package/fesm2022/ojiepermana-angular-navigation.mjs

@@ -1,11 +1,10 @@
-export * from '@ojiepermana/angular-navigation';
+export * from '@ojiepermana/navigation';
 
 /*
  * Public API of @ojiepermana/angular/navigation
- * Re-exports the independent @ojiepermana/angular-navigation package.
+ * Re-exports the independent @ojiepermana/navigation package.
  */
 
 /**
  * Generated bundle index. Do not edit.
- */
-//# sourceMappingURL=ojiepermana-angular-navigation.mjs.map
+ */

package/fesm2022/ojiepermana-angular-sdk.mjs

@@ -1,11 +1,10 @@
-export * from '@ojiepermana/angular-sdk';
+export * from '@ojiepermana/sdk';
 
 /*
  * Public API of @ojiepermana/angular/sdk
- * Re-exports the independent @ojiepermana/angular-sdk package.
+ * Re-exports the independent @ojiepermana/sdk package.
  */
 
 /**
  * Generated bundle index. Do not edit.
- */
-//# sourceMappingURL=ojiepermana-angular-sdk.mjs.map
+ */

package/fesm2022/ojiepermana-angular-theme.mjs

@@ -1,11 +1,10 @@
-export * from '@ojiepermana/angular-theme';
+export * from '@ojiepermana/theme';
 
 /*
  * Public API of @ojiepermana/angular/theme
- * Re-exports the independent @ojiepermana/angular-theme package.
+ * Re-exports the independent @ojiepermana/theme package.
  */
 
 /**
  * Generated bundle index. Do not edit.
- */
-//# sourceMappingURL=ojiepermana-angular-theme.mjs.map
+ */

package/fesm2022/ojiepermana-angular.mjs

@@ -1,22 +1,20 @@
-export * from '@ojiepermana/angular-chart';
-export * from '@ojiepermana/angular-component';
-export * from '@ojiepermana/angular-navigation';
-export * from '@ojiepermana/angular-sdk';
-export * from '@ojiepermana/angular-theme';
+export * from '@ojiepermana/chart';
+export * from '@ojiepermana/component';
+export * from '@ojiepermana/navigation';
+export * from '@ojiepermana/sdk';
+export * from '@ojiepermana/theme';
 
 /*
  * Public API of @ojiepermana/angular
  *
- * Umbrella wrapper around the independent @ojiepermana/angular-* packages.
- * Prefer the dedicated subpaths for precise imports, e.g.:
- *   import { ... } from '@ojiepermana/angular/chart';
- *   import { ... } from '@ojiepermana/angular/component';
- *   import { ... } from '@ojiepermana/angular/navigation';
- *   import { ... } from '@ojiepermana/angular/sdk';
- *   import { ... } from '@ojiepermana/angular/theme';
+ * Umbrella wrapper around the independent @ojiepermana/* packages.
+ * Prefer the dedicated package subpaths for precise, tree-shakeable imports, e.g.:
+ *   import { BarChart } from '@ojiepermana/chart/bar';
+ *   import { Button } from '@ojiepermana/component/button';
+ *   import { provideUiTheme } from '@ojiepermana/theme/styles';
+ * (The @ojiepermana/angular/<lib> subpaths below are a convenience mirror.)
  */
 
 /**
  * Generated bundle index. Do not edit.
- */
-//# sourceMappingURL=ojiepermana-angular.mjs.map
+ */

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@ojiepermana/angular",
-  "version": "22.0.27",
+  "version": "22.0.31",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
-    "@angular/core": "^22.0.0",
-    "@ojiepermana/angular-chart": "^22.0.27",
-    "@ojiepermana/angular-component": "^22.0.27",
-    "@ojiepermana/angular-navigation": "^22.0.27",
-    "@ojiepermana/angular-sdk": "^22.0.27",
-    "@ojiepermana/angular-theme": "^22.0.27"
+    "@angular/core": "^22.0.0"
   },
   "dependencies": {
+    "@ojiepermana/chart": "^22.0.31",
+    "@ojiepermana/component": "^22.0.31",
+    "@ojiepermana/navigation": "^22.0.31",
+    "@ojiepermana/sdk": "^22.0.31",
+    "@ojiepermana/theme": "^22.0.31",
     "tslib": "^2.3.0"
   },
   "publishConfig": {

package/types/ojiepermana-angular-chart.d.ts

@@ -1 +1 @@
-export * from '@ojiepermana/angular-chart';
+export * from '@ojiepermana/chart';

package/types/ojiepermana-angular-component.d.ts

@@ -1 +1 @@
-export * from '@ojiepermana/angular-component';
+export * from '@ojiepermana/component';

package/types/ojiepermana-angular-navigation.d.ts

@@ -1 +1 @@
-export * from '@ojiepermana/angular-navigation';
+export * from '@ojiepermana/navigation';

package/types/ojiepermana-angular-sdk.d.ts

@@ -1 +1 @@
-export * from '@ojiepermana/angular-sdk';
+export * from '@ojiepermana/sdk';

package/types/ojiepermana-angular-theme.d.ts

@@ -1 +1 @@
-export * from '@ojiepermana/angular-theme';
+export * from '@ojiepermana/theme';

package/types/ojiepermana-angular.d.ts

@@ -1,5 +1,5 @@
-export * from '@ojiepermana/angular-chart';
-export * from '@ojiepermana/angular-component';
-export * from '@ojiepermana/angular-navigation';
-export * from '@ojiepermana/angular-sdk';
-export * from '@ojiepermana/angular-theme';
+export * from '@ojiepermana/chart';
+export * from '@ojiepermana/component';
+export * from '@ojiepermana/navigation';
+export * from '@ojiepermana/sdk';
+export * from '@ojiepermana/theme';

package/fesm2022/ojiepermana-angular-chart.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ojiepermana-angular-chart.mjs","sources":["../../../../library/angular/chart/public-api.ts","../../../../library/angular/chart/ojiepermana-angular-chart.ts"],"sourcesContent":["/*\n * Public API of @ojiepermana/angular/chart\n * Re-exports the independent @ojiepermana/angular-chart package.\n */\n\nexport * from '@ojiepermana/angular-chart';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAAA;;;AAGG;;ACHH;;AAEG"}

package/fesm2022/ojiepermana-angular-component.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ojiepermana-angular-component.mjs","sources":["../../../../library/angular/component/public-api.ts","../../../../library/angular/component/ojiepermana-angular-component.ts"],"sourcesContent":["/*\n * Public API of @ojiepermana/angular/component\n * Re-exports the independent @ojiepermana/angular-component package.\n */\n\nexport * from '@ojiepermana/angular-component';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAAA;;;AAGG;;ACHH;;AAEG"}

package/fesm2022/ojiepermana-angular-navigation.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ojiepermana-angular-navigation.mjs","sources":["../../../../library/angular/navigation/public-api.ts","../../../../library/angular/navigation/ojiepermana-angular-navigation.ts"],"sourcesContent":["/*\n * Public API of @ojiepermana/angular/navigation\n * Re-exports the independent @ojiepermana/angular-navigation package.\n */\n\nexport * from '@ojiepermana/angular-navigation';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAAA;;;AAGG;;ACHH;;AAEG"}

package/fesm2022/ojiepermana-angular-sdk.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ojiepermana-angular-sdk.mjs","sources":["../../../../library/angular/sdk/public-api.ts","../../../../library/angular/sdk/ojiepermana-angular-sdk.ts"],"sourcesContent":["/*\n * Public API of @ojiepermana/angular/sdk\n * Re-exports the independent @ojiepermana/angular-sdk package.\n */\n\nexport * from '@ojiepermana/angular-sdk';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAAA;;;AAGG;;ACHH;;AAEG"}

package/fesm2022/ojiepermana-angular-theme.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ojiepermana-angular-theme.mjs","sources":["../../../../library/angular/theme/public-api.ts","../../../../library/angular/theme/ojiepermana-angular-theme.ts"],"sourcesContent":["/*\n * Public API of @ojiepermana/angular/theme\n * Re-exports the independent @ojiepermana/angular-theme package.\n */\n\nexport * from '@ojiepermana/angular-theme';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAAA;;;AAGG;;ACHH;;AAEG"}

package/fesm2022/ojiepermana-angular.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ojiepermana-angular.mjs","sources":["../../../../library/angular/src/public-api.ts","../../../../library/angular/src/ojiepermana-angular.ts"],"sourcesContent":["/*\n * Public API of @ojiepermana/angular\n *\n * Umbrella wrapper around the independent @ojiepermana/angular-* packages.\n * Prefer the dedicated subpaths for precise imports, e.g.:\n *   import { ... } from '@ojiepermana/angular/chart';\n *   import { ... } from '@ojiepermana/angular/component';\n *   import { ... } from '@ojiepermana/angular/navigation';\n *   import { ... } from '@ojiepermana/angular/sdk';\n *   import { ... } from '@ojiepermana/angular/theme';\n */\n\nexport * from '@ojiepermana/angular-chart';\nexport * from '@ojiepermana/angular-component';\nexport * from '@ojiepermana/angular-navigation';\nexport * from '@ojiepermana/angular-sdk';\nexport * from '@ojiepermana/angular-theme';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;AAUG;;ACVH;;AAEG"}