@anarchitects/auth-angular 0.1.6 → 0.3.0

package/README.md

@@ -1,25 +1,38 @@
 # @anarchitects/auth-angular
 
-Angular bricks for the Anarchitecture auth domain. The library is organized into standalone feature slices (config, data-access, feature, state, util, ui) that compose together to provide implementation-aligned authentication flows for Angular applications.
+Angular domain libraries for the Anarchitecture auth domain. The package is organized into standalone slices (config, data-access, feature, state, util, ui) that compose implementation-aligned authentication flows for Angular applications.
+
+## Developer + AI Agent Start Here
+
+- Read this README before generating integration code for `@anarchitects/auth-angular`.
+- Use public entry points only (`config`, `data-access`, `feature`, `state`, `util`, `ui`); do not import internal files.
+- Register providers and state explicitly via `provideAuthConfig`, `provideAuthDataAccess`, and `provideAuthState`.
+- Keep policy and ability behavior aligned with contracts from `@anarchitects/auth-ts`.
+- Preserve Angular layering and keep orchestration out of UI components.
 
 ## Features
 
 - `config`: DI tokens and provider helpers (API base URL, defaults)
 - `data-access`: generated OpenAPI clients plus adapters over the Nest API
-- `state`: signal-based store that drives login/logout, token refresh, and ability hydration
-- `feature`: router policy guard that consumes the shared ability
+- `state`: signal-based store plus explicit provider helper for login/logout, token refresh, and ability hydration
+- `feature`: router policy guard and orchestration components that delegate rendering to auth UI components
 - `util`: CASL ability helpers (`createAppAbility`, `AppAbility`)
-- `ui`: presentational components (reserved for future expansions)
+- `ui`: presentational auth domain form components built on `AnarchitectsUiForm`
 
 ## Installation
 
 ```bash
-npm install @anarchitects/auth-angular
+npm install @anarchitects/auth-angular @angular/common @angular/core @angular/router @ngrx/operators @ngrx/signals rxjs
 # or
-yarn add @anarchitects/auth-angular
+yarn add @anarchitects/auth-angular @angular/common @angular/core @angular/router @ngrx/operators @ngrx/signals rxjs
 ```
 
-Peer dependencies: Angular v20+, `@ngrx/signals`, `@sinclair/typebox`, and the sibling packages `@anarchitects/auth-ts` & `@anarchitects/auth-nest` (for end-to-end flows).
+Peer requirements:
+
+- `@angular/common`, `@angular/core`, `@angular/router`
+- `@ngrx/operators`, `@ngrx/signals`, `rxjs`
+
+The internal `@anarchitects/auth-ts`, `@anarchitects/forms-angular`, `@anarchitects/forms-ts`, and shared layout packages are installed transitively. Runtime utilities such as `jwt-decode` and `@casl/ability` are bundled as direct dependencies of this package.
 
 ## Usage
 
@@ -30,6 +43,7 @@ Peer dependencies: Angular v20+, `@ngrx/signals`, `@sinclair/typebox`, and the s
 import { ApplicationConfig } from '@angular/core';
 import { provideAuthConfig } from '@anarchitects/auth-angular/config';
 import { provideAuthDataAccess } from '@anarchitects/auth-angular/data-access';
+import { provideAuthState } from '@anarchitects/auth-angular/state';
 
 export const appConfig: ApplicationConfig = {
   providers: [
@@ -37,6 +51,7 @@ export const appConfig: ApplicationConfig = {
       apiBaseUrl: 'https://api.anarchitects.dev',
     }),
     provideAuthDataAccess(),
+    provideAuthState(),
   ],
 };
 ```
@@ -72,21 +87,22 @@ export const routes: Routes = [
     path: 'admin',
     canMatch: [policyGuard],
     data: { action: 'manage', subject: 'admin-section' },
-    loadComponent: () => import('./admin.component').then((m) => m.AdminComponent),
+    loadComponent: () =>
+      import('./admin.component').then((m) => m.AdminComponent),
   },
 ];
 ```
 
-### Secondary entry points
+## Entry points
 
-| Import path                              | Description                              |
-| ---------------------------------------- | ---------------------------------------- |
-| `@anarchitects/auth-angular/config`      | DI tokens and providers                  |
-| `@anarchitects/auth-angular/data-access` | Generated API clients and HTTP adapters  |
-| `@anarchitects/auth-angular/state`       | Signal store and CASL ability sync       |
-| `@anarchitects/auth-angular/feature`     | Router policy guard                      |
-| `@anarchitects/auth-angular/util`        | CASL ability factory and typings         |
-| `@anarchitects/auth-angular/ui`          | Presentational components (if available) |
+| Import path                              | Description                             |
+| ---------------------------------------- | --------------------------------------- |
+| `@anarchitects/auth-angular/config`      | DI tokens and providers                 |
+| `@anarchitects/auth-angular/data-access` | Generated API clients and HTTP adapters |
+| `@anarchitects/auth-angular/state`       | Signal store and CASL ability sync      |
+| `@anarchitects/auth-angular/feature`     | Router policy guard                     |
+| `@anarchitects/auth-angular/ui`          | Auth domain form UI components          |
+| `@anarchitects/auth-angular/util`        | CASL ability factory and typings        |
 
 ## Nx scripts
 

package/feature/README.md

@@ -1,6 +1,6 @@
 # @anarchitects/auth-angular/feature
 
-Feature layer for the Angular auth brick. It ships route guards plus standalone form-based feature components that orchestrate auth actions via `AuthStore`.
+Feature-level orchestration for Angular auth. It ships route guards plus standalone feature components that orchestrate auth actions via `AuthStore` and delegate rendering to `@anarchitects/auth-angular/ui`.
 
 ## Exports
 
@@ -32,7 +32,7 @@ export const routes: Routes = [
 ];
 ```
 
-The guard reads the `AuthStore` ability snapshot. Ensure the state layer is providing abilities by wiring the data-access and util modules in your application bootstrap.
+The guard reads the `AuthStore` ability snapshot. Ensure the state layer is explicitly provided in your app/route providers by wiring `provideAuthState()` from `@anarchitects/auth-angular/state`.
 
 ### Token-driven actions