ngrx-entity-crud 19.2.6 → 19.4.0-beta.5

package/README.md

@@ -4,7 +4,7 @@ Commands for code generation:
  - `store`: Generates a feature set containing an `entity`, `actions`, `reducer`, ... file.
  - `section`: Generates a new Angular CRUD page containing an `list`, `detail`, `search`, ... file.
  - `auth`: Generates a boilerplate for authentication implementation containing an `store section` and `components` file.
- - `auth0`: Generates Auth0 implementation containing an `store section` and `components` file.
+ - `lazy-report`: Scans the project and reports which stores are good candidates to become lazy.
 
 # How to use it?
 To create your first project, follow this [guide](https://github.com/jucasoft/ngrx-entity-crud-prime-ng-boilerplate).
@@ -49,8 +49,28 @@ Store type:
   - Enum: `"CRUD-PLURAL", "CRUD-SINGULAR", "CRUD+GRAPHQL", "BASE"`
   - Default: `false`
 
+Store registration strategy:
+  - `eager`: the store is declared in the application `RootStoreModule` (historical behavior); reducers/effects are loaded at startup.
+  - `lazy`: the store is **not** registered in the root; the view feature module is responsible for importing `<Clazz>StoreModule`, so reducers/effects are loaded only when the section is opened.
+
+- `--registration`
+  - Type: `string`
+  - Enum: `"eager", "lazy"`
+  - Optional. If omitted, the schematic asks interactively. In non-interactive runs (CI/scripts) it falls back to `eager`, so existing pipelines keep working unchanged.
+
+> **Lazy mode notes**
+> - With `--registration=lazy` nothing registers the store automatically: you must import `<Clazz>StoreModule` in the feature module generated for the view (e.g. `coin.module.ts`).
+> - The generated slice is declared as **optional** in `root-store/state.ts`, because it does not exist in the runtime state until the section is loaded.
+> - `root-store/selectors.ts` exposes the global loading/error selectors (`selectIsLoading`, `selectError`, `selectLoadingNames`) in a **store-agnostic** way: they scan the root state using the `EntityCrudBaseState` convention (every CRUD slice exposes `isLoading`/`error` at the top level), so lazily-registered stores contribute to the global loading/error state without coupling the root to any specific domain.
+
 #### Examples
 
+```sh
+ng generate ngrx-entity-crud:store --name=coin --clazz=Coin --type=CRUD-PLURAL --registration=lazy
+```
+With `--registration=lazy` the store is not added to `RootStoreModule`; remember to import `CoinStoreModule` in the view feature module.
+
+
 ```sh
 ng generate ngrx-entity-crud:store --name=coin --clazz=Coin --type=CRUD-PLURAL
 ```
@@ -242,50 +262,162 @@ UPDATE src/app/root-store/__clazz@dasherize__.state.ts (184 bytes)
 UPDATE src/app/root-store/root-store.module.ts (1051 bytes)
 ```
 
-## auth0
+## lazy-report
 
 ---
 
 ### Overview
 
-Generates a boilerplate for authentication implementation containing an `store section` and `components` file.
+Read-only analysis command. It scans the project and produces a report that maps each store to
+the sections that use it, then suggests which stores are good candidates to be registered as
+**lazy** (see the `--registration` option of the `store` command). Nothing is modified except the
+generated report file: you decide what to convert.
+
+How a store is classified:
+- **candidato lazy**: used by exactly one section, and that section is on a lazy route (`loadChildren`).
+- **multi-sezione**: used by more than one section (evaluate a shared lazy module).
+- **tieni eager (usato dalla shell)**: referenced by the app shell (`core/`, `main/components`, `app.component`) — must stay eager.
+- **sezione non lazy-routed**: its only section is loaded eagerly, so going lazy gives little benefit.
+- **infra (eager)**: infrastructure store (e.g. `router-store`), excluded from candidates.
+- **orfano**: not referenced by any section.
+
+The scan is static and relies on the naming convention (`XxxStoreActions/Selectors/State/Module`).
+Paths are read from `ngrx-entity-crud.conf.json` when present, otherwise defaults are used
+(`src/app/root-store`, `src/app/main/views`, `src/app`).
 
 ### Command
 
 ```sh
-ng generate ngrx-entity-crud:auth0
+ng generate ngrx-entity-crud:lazy-report [options]
 ```
 
+### Options
+
+Report file to write (relative to the workspace root); empty string = console only.
+- `--output`
+  - Type: `string`
+  - Default: `lazy-report.md`
+
+Format of the written report.
+- `--format`
+  - Type: `string`
+  - Enum: `"md", "json"`
+  - Default: `md`
+
+Infrastructure stores excluded from lazy candidates (folder names).
+- `--infra-stores`
+  - Type: `string[]`
+  - Default: `["router-store"]`
+
+Include detected persistence providers (localStorage/IndexedDB) from `package.json` in the report.
+- `--storage`
+  - Type: `boolean`
+  - Default: `true`
+
+The JSON report (`--format=json`) also includes a top-level `generatedAt` (ISO timestamp, for
+staleness detection) and, per store, the structured booleans `lazyRoute` and `isLazyCandidate`
+(so tools can correlate without parsing the textual `verdict`). When `--storage` is enabled it
+adds a `storage` object `{ providers, source }`. The `{ paths, stores }` shape is unchanged
+(additive, backward-compatible).
+
 #### Examples
 
 ```sh
-ng generate ngrx-entity-crud:auth0
+ng generate ngrx-entity-crud:lazy-report
+ng generate ngrx-entity-crud:lazy-report --format=json --output=lazy-report.json
+ng generate ngrx-entity-crud:lazy-report --output=        # solo console
+```
+
+Example output (excerpt):
+
+```md
+| store | clazz | type | sezioni | n | lazy route | shell | verdetto |
+|---|---|---|---|---|---|---|---|
+| coin-store | Coin | CRUD-PLURAL | coin | 1 | si | no | candidato lazy |
+| currency-store | Currency | CRUD-PLURAL | coin, invoice | 2 | si | no | multi-sezione (2) -> valuta modulo condiviso |
+| menu-store | Menu | CRUD-PLURAL | - | 0 | - | si | tieni eager (usato dalla shell) |
 ```
 
-#### Files generated/changed by the “:auth0” command
+## dashboard
+
+---
+
+### Overview
+
+Scaffolds a **project dashboard** view with three runtime summaries: localStorage usage,
+IndexedDB usage (agnostic to the persistence library you use), and NgRx stores + lazy-loading
+candidates. The generated module is a thin PrimeNG wrapper that hosts `<nec-dashboard>`, the
+standalone component exported by the secondary entry-point `ngrx-entity-crud/devtools`; all the
+diagnostic logic lives in the library (versioned and tested), not in generated code.
+
+By default it also generates `src/assets/lazy-report.json` (reusing `lazy-report --format=json`),
+which the dashboard reads at runtime to correlate the loaded/lazy state of each store.
+
+The dashboard can run in **production**: by default it shows only keys, sizes and counts — never
+raw values. Value reveal is opt-in (`[allowRevealValues]="true"`) and always masks sensitive
+patterns (token/JWT/email/secret); keys that look sensitive are flagged.
+
+### Command
 
 ```sh
-CREATE src/app/root-store/auth-store/__clazz@dasherize__.actions.ts (776 bytes)
-CREATE src/app/root-store/auth-store/auth-store.module.ts (1044 bytes)
-CREATE src/app/root-store/auth-store/auth.guard.ts (1359 bytes)
-CREATE src/app/root-store/auth-store/authentication.service.ts (675 bytes)
-CREATE src/app/root-store/auth-store/conf.ts (75 bytes)
-CREATE src/app/root-store/auth-store/__clazz@dasherize__.effects.ts (1754 bytes)
-CREATE src/app/root-store/auth-store/index.d.ts (271 bytes)
-CREATE src/app/root-store/auth-store/index.ts (271 bytes)
-CREATE src/app/root-store/auth-store/login.component.ts (2117 bytes)
-CREATE src/app/root-store/auth-store/__clazz@dasherize__.names.ts (47 bytes)
-CREATE src/app/root-store/auth-store/profile.ts (224 bytes)
-CREATE src/app/root-store/auth-store/__clazz@dasherize__.reducer.ts (475 bytes)
-CREATE src/app/root-store/auth-store/__clazz@dasherize__.selectors.ts (699 bytes)
-CREATE src/app/root-store/auth-store/__clazz@dasherize__.state.ts (192 bytes)
+ng generate ngrx-entity-crud:dashboard [options]
+```
 
-UPDATE src/app/root-store/index.ts (309 bytes)
-UPDATE src/app/root-store/index.d.ts (309 bytes)
-UPDATE src/app/root-store/__clazz@dasherize__.state.ts (184 bytes)
-UPDATE src/app/root-store/root-store.module.ts (1051 bytes)
+### Options
+
+Feature name (drives the lazy route and the generated file names).
+- `--clazz`
+  - Type: `string`
+  - Default: `Dashboard`
+
+Generate the lazy-report JSON read by the dashboard.
+- `--include-lazy-report`
+  - Type: `boolean`
+  - Default: `true`
+
+Path of the generated lazy-report JSON.
+- `--lazy-report-output`
+  - Type: `string`
+  - Default: `src/assets/lazy-report.json`
+
+The name of the project.
+- `--project`
+  - Type: `string`
+
+#### Using the standalone component directly
+
+If you prefer not to scaffold, import the component from the secondary entry-point and mount it
+anywhere (e.g. behind a dev-only route):
+
+```ts
+import { NecDashboardComponent } from 'ngrx-entity-crud/devtools';
+
+@Component({
+  standalone: true,
+  imports: [NecDashboardComponent],
+  template: `<nec-dashboard
+    lazyReportUrl="assets/lazy-report.json"
+    [idbDatabaseNames]="['NgRxStateStore']"
+    [allowRevealValues]="false"
+    [pollingMs]="0"></nec-dashboard>`,
+})
+export class DevPanelComponent {}
 ```
 
+Inputs: `blacklist` / `whitelist` (`string[]`, filter store slices), `lazyReportUrl`
+(default `assets/lazy-report.json`; empty string disables the static correlation),
+`idbDatabaseNames` (`string[]`, DB names to inspect where `indexedDB.databases()` is unsupported —
+Firefox / older Safari), `pollingMs` (`number`, auto-refresh; `0` = manual), `allowRevealValues`
+(`boolean`, opt-in masked value reveal).
+
+Notes:
+- IndexedDB is introspected **agnostically** via native APIs (`indexedDB.databases()` + `count()`),
+  with an optional `NEC_IDB_ADAPTER` injection token for custom providers. Byte sizes per
+  record/store are not measurable; only record counts and the aggregate origin quota
+  (`navigator.storage.estimate()`) are shown.
+- `<nec-dashboard>` requires Angular 17+ on the consumer (standalone component + control flow);
+  the main entry-point keeps the wider peer range.
+
 ## Running unit tests
 Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
 

package/devtools/agnostic-selectors.d.ts

@@ -0,0 +1,32 @@
+import { MemoizedSelector } from '@ngrx/store';
+/**
+ * Versione FACTORY (parametrizzabile) dei selettori agnostici di loading/error che il
+ * template `ng-add` installa in `root-store/selectors.ts`.
+ *
+ * Il template resta invariato (retro-compatibilità): qui la logica è IDENTICA ma con
+ * `rootSelector`/`blacklist`/`whitelist` resi parametri invece che costanti hardcoded, così
+ * è riutilizzabile dal pacchetto npm (entry-point `ngrx-entity-crud/devtools`).
+ *
+ * Scandisce lo stato sfruttando la convenzione `EntityCrudBaseState`: ogni slice CRUD espone
+ * `isLoading: boolean` ed `error: string | null` al livello top.
+ */
+export interface AgnosticLoadingSelectorsOptions {
+    /** Selettore della radice da scandire (default: l'intero stato root). */
+    rootSelector?: (state: any) => Record<string, any>;
+    /** Chiavi di slice da escludere dallo scan. */
+    blacklist?: ReadonlyArray<string>;
+    /** Se valorizzata, considera SOLO queste chiavi (precede la blacklist). */
+    whitelist?: ReadonlyArray<string>;
+}
+export interface AgnosticLoadingSelectors {
+    /** Nomi delle slice attualmente in caricamento (`isLoading === true`). */
+    selectLoadingNames: MemoizedSelector<any, string[]>;
+    /** `true` se almeno una slice CRUD è in caricamento. */
+    selectIsLoading: MemoizedSelector<any, boolean>;
+    /** Elenco degli errori non vuoti presenti nelle slice CRUD. */
+    selectErrors: MemoizedSelector<any, string[]>;
+    /** Concatenazione degli errori non vuoti (stringa vuota se non ce ne sono). */
+    selectError: MemoizedSelector<any, string>;
+}
+export declare function createAgnosticLoadingSelectors(options?: AgnosticLoadingSelectorsOptions): AgnosticLoadingSelectors;
+//# sourceMappingURL=agnostic-selectors.d.ts.map

package/devtools/agnostic-selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agnostic-selectors.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/agnostic-selectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,+BAA+B;IAC9C,yEAAyE;IACzE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,kBAAkB,EAAE,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,wDAAwD;IACxD,eAAe,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChD,+DAA+D;IAC/D,YAAY,EAAE,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,+EAA+E;IAC/E,WAAW,EAAE,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;CAC5C;AAOD,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CAoC1B"}

package/devtools/idb-adapter.token.d.ts

@@ -0,0 +1,11 @@
+import { InjectionToken } from '@angular/core';
+import { NecIdbAdapter } from './models';
+/**
+ * Adapter IndexedDB OPZIONALE, agnostico rispetto alla libreria di persistenza.
+ *
+ * Fornendolo, il `NecIndexedDbProbeService` lo usa con priorità per enumerare i database
+ * (utile quando la libreria del consumer nasconde i nomi DB o su browser senza
+ * `indexedDB.databases()`, es. Firefox). Quando NON fornito, il probe usa solo le API native.
+ */
+export declare const NEC_IDB_ADAPTER: InjectionToken<NecIdbAdapter>;
+//# sourceMappingURL=idb-adapter.token.d.ts.map

package/devtools/idb-adapter.token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-adapter.token.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/idb-adapter.token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,+BAAuD,CAAC"}

package/devtools/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="ngrx-entity-crud/devtools" />
+export * from './public-api';
+//# sourceMappingURL=ngrx-entity-crud-devtools.d.ts.map

package/devtools/mask.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility di privacy per la dashboard: poiché può girare anche in PRODUZIONE, i valori non
+ * vengono mai mostrati di default e — quando il consumer abilita esplicitamente il reveal —
+ * vengono comunque mascherati i pattern sensibili (token/JWT/email/segreti).
+ */
+/** `true` se il nome chiave suggerisce un contenuto sensibile (token, password, ecc.). */
+export declare function looksSensitiveKey(key: string): boolean;
+/** Redige nel testo i pattern sensibili comuni (JWT, email, token/hex lunghi). */
+export declare function redactSensitive(value: string): string;
+/**
+ * Valore "sicuro da mostrare": se la chiave è sensibile, nasconde tutto (mostra solo la
+ * lunghezza); altrimenti redige i pattern sensibili e tronca a `maxLength`.
+ */
+export declare function maskValue(key: string, value: string, maxLength?: number): string;
+//# sourceMappingURL=mask.d.ts.map

package/devtools/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/mask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAS7E"}

package/devtools/models.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Modelli dei report prodotti dai probe della dashboard (`ngrx-entity-crud/devtools`).
+ *
+ * Sono volutamente indipendenti dai tipi del main entry-point: i probe leggono lo stato
+ * per CONVENZIONE (vedi `EntityCrudBaseState` in `src/lib/models.ts`), non per tipo, così
+ * il sotto-modulo `devtools` resta autonomo e agnostico rispetto alla persistenza usata.
+ */
+export interface NecStorageEntry {
+    key: string;
+    /** Byte verso la quota (UTF-16): `(key.length + value.length) * 2`. Metrica primaria. */
+    bytesUtf16: number;
+    /** Byte della serializzazione UTF-8 (`TextEncoder`/`Blob`). Metrica secondaria. */
+    bytesUtf8: number;
+}
+export interface NecStorageReport {
+    available: boolean;
+    type: 'local' | 'session';
+    entries: NecStorageEntry[];
+    count: number;
+    totalBytesUtf16: number;
+    totalBytesUtf8: number;
+}
+/** Stima quota AGGREGATA per-origine (localStorage + IndexedDB + Cache), non scorporabile. */
+export interface NecQuotaEstimate {
+    available: boolean;
+    usage?: number;
+    quota?: number;
+    /** Non-standard (solo Chromium): byte per area. Assente su Firefox/Safari. */
+    usageDetails?: Record<string, number>;
+}
+export interface NecIdbStoreReport {
+    name: string;
+    /** Numero record (`objectStore.count()`); `null` se non determinabile. */
+    count: number | null;
+}
+export interface NecIdbDbReport {
+    name: string;
+    version: number | null;
+    stores: NecIdbStoreReport[];
+    note?: string;
+}
+export interface NecIdbReport {
+    available: boolean;
+    /** `false` se non è stato possibile elencare i database (es. Firefox senza nomi forniti). */
+    enumerable: boolean;
+    /** Nome dell'adapter usato: `'native'`, il nome di un `NecIdbAdapter`, o `null`. */
+    adapter: string | null;
+    databases: NecIdbDbReport[];
+    note?: string;
+}
+/**
+ * Punto di estensione agnostico: il consumer può fornire un adapter esplicito (via
+ * `NEC_IDB_ADAPTER`) per conteggi accurati quando la sua libreria di persistenza nasconde
+ * i nomi DB. Quando assente, il probe usa solo le API native.
+ */
+export interface NecIdbAdapter {
+    name: string;
+    isAvailable(): boolean;
+    listDatabases(): Promise<NecIdbDbReport[]>;
+}
+export type NecSliceKind = 'plural' | 'singular' | 'unknown';
+export interface NecStoreSlice {
+    key: string;
+    kind: NecSliceKind;
+    isLoading: boolean;
+    isLoaded: boolean;
+    error: string | null;
+    /** Numero entità (solo slice `plural`). */
+    entityCount?: number;
+    responsesCount: number;
+}
+export type NecRuntimeStatus = 'loaded' | 'lazy-not-loaded' | 'unknown';
+export interface NecLazyEntry {
+    name: string;
+    clazz?: string;
+    type?: string;
+    verdict?: string;
+    isLazyCandidate: boolean;
+    lazyRoute?: boolean;
+    sections: string[];
+    usedByShell: boolean;
+    runtimeStatus: NecRuntimeStatus;
+}
+export interface NecStoreReport {
+    slices: NecStoreSlice[];
+    loadingNames: string[];
+    errors: string[];
+    /** Presente solo se è stato fornito un `lazyReportUrl` e il fetch è riuscito. */
+    lazy?: NecLazyEntry[];
+    /** Timestamp ISO di generazione del `lazy-report.json` (per segnalare snapshot stantii). */
+    lazyReportGeneratedAt?: string;
+}
+//# sourceMappingURL=models.d.ts.map

package/devtools/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,6FAA6F;IAC7F,UAAU,EAAE,OAAO,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC5C;AAMD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iFAAiF;IACjF,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,4FAA4F;IAC5F,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/devtools/nec-dashboard.component.d.ts

@@ -0,0 +1,46 @@
+import { OnDestroy, OnInit } from '@angular/core';
+import { NecIdbReport, NecQuotaEstimate, NecStorageReport, NecStoreReport } from './models';
+import * as i0 from "@angular/core";
+/**
+ * `<nec-dashboard>` — dashboard di gestione progetto plug-and-play.
+ *
+ * Standalone, OnPush, template HTML inline (nessun PrimeNG → importabile ovunque). Tre
+ * pannelli: localStorage, IndexedDB (agnostico), store NgRx + sezioni lazy. Per privacy
+ * mostra SOLO chiavi/dimensioni/conteggi, mai i valori grezzi. Refresh manuale di default;
+ * polling opt-in via `pollingMs`. Pensato per essere usabile anche in produzione.
+ */
+export declare class NecDashboardComponent implements OnInit, OnDestroy {
+    private readonly localStorageProbe;
+    private readonly indexedDbProbe;
+    private readonly storeProbe;
+    /** Chiavi di slice da escludere dallo scan dello store. */
+    blacklist: string[];
+    /** Se valorizzata, considera SOLO queste chiavi di slice (precede la blacklist). */
+    whitelist: string[];
+    /** URL del report statico (`lazy-report --format=json`); `null`/'' per disattivarlo. */
+    lazyReportUrl: string | null;
+    /** Nomi DB IndexedDB da ispezionare dove `databases()` non è supportato (es. Firefox). */
+    idbDatabaseNames: string[];
+    /** Intervallo di auto-refresh in ms; 0 = solo manuale (default). */
+    pollingMs: number;
+    /** Abilita il reveal opt-in dei valori localStorage (sempre mascherati). Default: false. */
+    allowRevealValues: boolean;
+    readonly busy: import("@angular/core").WritableSignal<boolean>;
+    readonly lastUpdated: import("@angular/core").WritableSignal<string>;
+    readonly storage: import("@angular/core").WritableSignal<NecStorageReport>;
+    readonly quota: import("@angular/core").WritableSignal<NecQuotaEstimate>;
+    readonly idb: import("@angular/core").WritableSignal<NecIdbReport>;
+    readonly storeReport: import("@angular/core").WritableSignal<NecStoreReport>;
+    readonly revealed: import("@angular/core").WritableSignal<Record<string, string>>;
+    private timer;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    refresh(): Promise<void>;
+    /** Reveal opt-in di un valore localStorage, sempre passato per `maskValue` (privacy). */
+    reveal(key: string): void;
+    isSensitive(key: string): boolean;
+    formatBytes(n: number | undefined | null): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NecDashboardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NecDashboardComponent, "nec-dashboard", never, { "blacklist": { "alias": "blacklist"; "required": false; }; "whitelist": { "alias": "whitelist"; "required": false; }; "lazyReportUrl": { "alias": "lazyReportUrl"; "required": false; }; "idbDatabaseNames": { "alias": "idbDatabaseNames"; "required": false; }; "pollingMs": { "alias": "pollingMs"; "required": false; }; "allowRevealValues": { "alias": "allowRevealValues"; "required": false; }; }, {}, never, never, true, never>;
+}
+//# sourceMappingURL=nec-dashboard.component.d.ts.map

package/devtools/nec-dashboard.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nec-dashboard.component.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/nec-dashboard.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,SAAS,EACT,MAAM,EAEP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAC,MAAM,UAAU,CAAC;;AAM1F;;;;;;;GAOG;AACH,qBAsRa,qBAAsB,YAAW,MAAM,EAAE,SAAS;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAE3D,2DAA2D;IAClD,SAAS,EAAE,MAAM,EAAE,CAAM;IAClC,oFAAoF;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAM;IAClC,wFAAwF;IAC/E,aAAa,EAAE,MAAM,GAAG,IAAI,CAA6B;IAClE,0FAA0F;IACjF,gBAAgB,EAAE,MAAM,EAAE,CAAM;IACzC,oEAAoE;IAC3D,SAAS,SAAK;IACvB,4FAA4F;IACnF,iBAAiB,UAAS;IAEnC,QAAQ,CAAC,IAAI,kDAAiB;IAC9B,QAAQ,CAAC,WAAW,iDAA+B;IACnD,QAAQ,CAAC,OAAO,2DAAyC;IACzD,QAAQ,CAAC,KAAK,2DAAyC;IACvD,QAAQ,CAAC,GAAG,uDAAqC;IACjD,QAAQ,CAAC,WAAW,yDAAuC;IAC3D,QAAQ,CAAC,QAAQ,iEAAsC;IAEvD,OAAO,CAAC,KAAK,CAA+C;IAE5D,QAAQ,IAAI,IAAI;IAOhB,WAAW,IAAI,IAAI;IAOb,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB9B,yFAAyF;IACzF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM;yCA3EtC,qBAAqB;2CAArB,qBAAqB;CAuFjC"}

package/devtools/ngrx-entity-crud-devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngrx-entity-crud-devtools.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/ngrx-entity-crud-devtools.ts"],"names":[],"mappings":"AAAA;;GAEG;;AAEH,cAAc,cAAc,CAAC"}

package/devtools/package.json

@@ -0,0 +1,3 @@
+{
+  "module": "../fesm2022/ngrx-entity-crud-devtools.mjs"
+}

package/devtools/probes/nec-indexeddb-probe.service.d.ts

@@ -0,0 +1,25 @@
+import { NecIdbAdapter, NecIdbReport } from '../models';
+import * as i0 from "@angular/core";
+/**
+ * Riepilogo IndexedDB AGNOSTICO rispetto alla libreria di persistenza.
+ *
+ * Priorità reale: (1) `NEC_IDB_ADAPTER` esplicito, (2) API native
+ * (`indexedDB.databases()` + `open()` + `count()`). NESSUN import di librerie di
+ * persistenza. Mostra il numero di record per object store; i byte per-store NON sono
+ * misurabili e non vengono promessi (solo la quota aggregata, altrove).
+ */
+export declare class NecIndexedDbProbeService {
+    private readonly adapter;
+    constructor(adapter: NecIdbAdapter | null);
+    /**
+     * @param fallbackDatabaseNames nomi DB da ispezionare quando `indexedDB.databases()` non
+     *   è supportato (Firefox / Safari vecchi). Passa qui i nomi noti della tua persistenza.
+     * @param openTimeoutMs timeout per ogni `open()` (default 3000ms).
+     */
+    read(fallbackDatabaseNames?: string[], openTimeoutMs?: number): Promise<NecIdbReport>;
+    private listDatabaseNames;
+    private inspectDatabase;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NecIndexedDbProbeService, [{ optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NecIndexedDbProbeService>;
+}
+//# sourceMappingURL=nec-indexeddb-probe.service.d.ts.map

package/devtools/probes/nec-indexeddb-probe.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nec-indexeddb-probe.service.d.ts","sourceRoot":"","sources":["../../../../libs/ngrx-entity-crud/devtools/probes/nec-indexeddb-probe.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,EAAkB,YAAY,EAAoB,MAAM,WAAW,CAAC;;AAGzF;;;;;;;GAOG;AACH,qBACa,wBAAwB;IACc,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa,GAAG,IAAI;IAE/F;;;;OAIG;IACG,IAAI,CAAC,qBAAqB,GAAE,MAAM,EAAO,EAAE,aAAa,SAAO,GAAG,OAAO,CAAC,YAAY,CAAC;YA2C/E,iBAAiB;IAkB/B,OAAO,CAAC,eAAe;yCArEZ,wBAAwB;6CAAxB,wBAAwB;CA0KpC"}

package/devtools/probes/nec-local-storage-probe.service.d.ts

@@ -0,0 +1,27 @@
+import { NecQuotaEstimate, NecStorageReport } from '../models';
+import * as i0 from "@angular/core";
+/**
+ * Riepilogo di `localStorage` / `sessionStorage`.
+ *
+ * Sincrono per la lettura delle chiavi. NON espone i valori: solo chiavi e dimensioni
+ * (privacy). La metrica primaria verso la quota è UTF-16 `(key.length + value.length) * 2`,
+ * perché è ciò che conta verso il limite ~5-10MB; la metrica UTF-8 è secondaria.
+ */
+export declare class NecLocalStorageProbeService {
+    read(type?: 'local' | 'session'): NecStorageReport;
+    /**
+     * Legge ON-DEMAND il valore grezzo di una singola chiave (per il reveal esplicito in UI).
+     * Non viene mai incluso nel report: la dashboard lo richiede solo su azione dell'utente e lo
+     * maschera tramite `maskValue`.
+     */
+    readValue(key: string, type?: 'local' | 'session'): string | null;
+    /**
+     * Stima quota AGGREGATA per-origine (include anche IndexedDB e Cache): NON è scorporabile
+     * per area. Può essere assente (Safari/contesto non sicuro) o arrotondata (anti-fingerprint).
+     */
+    estimate(): Promise<NecQuotaEstimate>;
+    private utf8Bytes;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NecLocalStorageProbeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NecLocalStorageProbeService>;
+}
+//# sourceMappingURL=nec-local-storage-probe.service.d.ts.map

package/devtools/probes/nec-local-storage-probe.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nec-local-storage-probe.service.d.ts","sourceRoot":"","sources":["../../../../libs/ngrx-entity-crud/devtools/probes/nec-local-storage-probe.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAmB,gBAAgB,EAAC,MAAM,WAAW,CAAC;;AAE9E;;;;;;GAMG;AACH,qBACa,2BAA2B;IACtC,IAAI,CAAC,IAAI,GAAE,OAAO,GAAG,SAAmB,GAAG,gBAAgB;IA0D3D;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,GAAG,SAAmB,GAAG,MAAM,GAAG,IAAI;IAY1E;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsB3C,OAAO,CAAC,SAAS;yCAtGN,2BAA2B;6CAA3B,2BAA2B;CAuHvC"}

package/devtools/probes/nec-store-probe.service.d.ts

@@ -0,0 +1,30 @@
+import { NecStoreReport } from '../models';
+import * as i0 from "@angular/core";
+interface ProbeOptions {
+    blacklist?: string[];
+    whitelist?: string[];
+}
+/**
+ * Riepilogo degli store NgRx a runtime.
+ *
+ * Enumera le slice CRUD montate per CONVENZIONE (`typeof value.isLoading === 'boolean'`,
+ * vedi `EntityCrudBaseState`), senza dipendere dai selettori per-dominio. Una slice lazy non
+ * ancora caricata semplicemente non ha la chiave nello stato root.
+ */
+export declare class NecStoreProbeService {
+    private readonly store;
+    /** Lettura sincrona dello stato root (NgRx emette il valore corrente all'iscrizione). */
+    read(opts?: ProbeOptions): NecStoreReport;
+    /** Come `read()`, ma correla con l'inventario statico di `lazy-report.json` (se raggiungibile). */
+    readWithLazyReport(url: string, opts?: ProbeOptions): Promise<NecStoreReport>;
+    private fetchLazyReport;
+    /**
+     * Best-effort: il root state usa `strings.underscore(name)` come chiave di slice, mentre il
+     * report usa il nome dasherizzato. (Fase 1: far emettere a `lazy-report` la feature key reale.)
+     */
+    private toSliceKey;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NecStoreProbeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NecStoreProbeService>;
+}
+export {};
+//# sourceMappingURL=nec-store-probe.service.d.ts.map

package/devtools/probes/nec-store-probe.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nec-store-probe.service.d.ts","sourceRoot":"","sources":["../../../../libs/ngrx-entity-crud/devtools/probes/nec-store-probe.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,cAAc,EAAgB,MAAM,WAAW,CAAC;;AAEpF,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IAEvC,yFAAyF;IACzF,IAAI,CAAC,IAAI,GAAE,YAAiB,GAAG,cAAc;IA4D7C,mGAAmG;IAC7F,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;YASzE,eAAe;IA6C7B;;;OAGG;IACH,OAAO,CAAC,UAAU;yCA3HP,oBAAoB;6CAApB,oBAAoB;CA8HhC"}

package/devtools/public-api.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Secondary entry-point `ngrx-entity-crud/devtools`.
+ *
+ * Dashboard di gestione progetto: riepiloghi runtime di localStorage, IndexedDB (agnostico)
+ * e store NgRx + sezioni promovibili al lazy loading. Tree-shakable: chi non lo importa non
+ * lo paga nel bundle. Vedi `ngrx-entity-crud-dashboard-plan.md`.
+ */
+export * from './models';
+export * from './idb-adapter.token';
+export * from './agnostic-selectors';
+export * from './mask';
+export * from './probes/nec-local-storage-probe.service';
+export * from './probes/nec-indexeddb-probe.service';
+export * from './probes/nec-store-probe.service';
+export * from './nec-dashboard.component';
+//# sourceMappingURL=public-api.d.ts.map

package/devtools/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../../libs/ngrx-entity-crud/devtools/public-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC"}