@arsedizioni/ars-utils 22.5.28 → 22.5.32

package/README.md

@@ -27,7 +27,7 @@ di vita proprio vive nel suo entry point. Importare sempre dal path specifico.
 | L0.5 | `ui.shell` | `ShellService` (`info`, `error`, `busy*`, `wait`, `BusyTimer`), `ShellMessageComponent`, `ShellBusyComponent` | zero Material e zero CDK: e' quello che shell, interceptor, guard e app initializer possono permettersi sul percorso di boot |
 | L1 | `ui` | `FlexLayoutModule`, `MediaObserver`, `UIService`, tipi dei dialog | kernel: deve restare magro, e non importa nulla da Material |
 | L1 | `ui.paginator` | `PaginatorIntl` | isola `@angular/material/paginator`, che si porta dietro `mat-select` e `mat-option` |
-| L1.5 | `ui.dialogs` | `DialogService` (estende `ShellService`) + confirm, delete, toast, `open` | tutto cio' che chiede qualcosa all'utente, piu' il toast |
+| L1.5 | `ui.dialogs` | `DialogService` (estende `ShellService`) + confirm, delete, toast, `open`, e le aperture pigre dei dialog pesanti | tutto cio' che chiede qualcosa all'utente, piu' il toast |
 | L2 | `ui.dialogs.auth` | credentials, reset-password, recover-password, prompt-otp, `OtpInputComponent`, `PasswordStrengthComponent` | solo route di login/account |
 | L2 | `ui.dialogs.prompt` | prompt, prompt-date, prompt-time | porta `@angular/material/datepicker` |
 | L2 | `ui.dialogs.select` | select, select-tree, send-to | porta `mat-tree`, `mat-list`, `mat-chips` |
@@ -35,7 +35,6 @@ di vita proprio vive nel suo entry point. Importare sempre dal path specifico.
 | L2 | `ui.controls` | button-selector, button-toggle, chips-selector, tree-picker, calendar-empty-header | |
 | L2 | `ui.filters` | `FilterBarComponent` + modello `Filters` | |
 | L2 | `ui.navigation` | `NavigationBarComponent` + definizioni | shell applicativa |
-| L3 | `ui.application` | `ApplicationDialogService` | facade: carica i dialog pesanti con `import()` |
 
 ### Specifici ARS
 
@@ -69,24 +68,28 @@ ui.dialogs      <-- DialogService extends ShellService: dipende da `ui` E da `ui
  |         |                  |              |          |            |
  |   ui.dialogs.auth   ui.dialogs.prompt  ui.files   ui.help    ui.oauth
  |                                                   ui.notifications (+ support.common)
-ui.application  --- import() --->  ui.dialogs.{auth,prompt,select}, ui.files
- |
 clipper.ui  (+ clipper.common, ui.controls, ui.files, ui.dialogs.select)
+
+`ui.dialogs` --- import() --->  ui.dialogs.{auth,prompt,select}, ui.files
+Gli archi dinamici puntano all'insu' e sono l'unica ragione per cui quei quattro entry point
+restano fuori dal bundle iniziale. Regge finche' NESSUNO di loro importa `DialogService`: per
+`error()` e `busy()` iniettano `ShellService`.
 ```
 
 `evolution.common` e `support.common` dipendono solo da `core`.
 
 ### Regole da rispettare
 
-1. Il grafo tra entry point deve restare un DAG. Un entry point di livello L2 non puo'
-   importare `ui.application`, ne' un entry point puo' importare se stesso per package path
-   (ng-packagr lo segnala come `circular dependency on itself`).
+1. Il grafo **statico** tra entry point deve restare un DAG: `ui.dialogs` raggiunge i dialog
+   pesanti solo con `import()`, e quei quattro entry point non devono importare `DialogService`
+   in nessun modo — ng-packagr rifiuta la build con `circular dependency` al primo che lo fa.
+   Per messaggi e attesa iniettano `ShellService`, che sta sotto di loro nel grafo.
 2. I tipi condivisi fra il facade e i dialog pesanti stanno in `ui` (`dialog.definitions.ts`).
    Se un tipo servisse a entrambi e vivesse nel dialog, l'`import()` del facade tornerebbe statico.
 3. Il facade usa `import type` per i tipi dei componenti e `import()` per i valori: e' quello
    che tiene i dialog fuori dal bundle iniziale.
 4. Dopo una modifica, verificare che gli `import()` sopravvivano alla build:
-   `grep -o "import('@arsedizioni[^']*')" dist/ars-utils/fesm2022/*ui.application.mjs`
+   `grep -o "import('@arsedizioni[^']*')" dist/ars-utils/fesm2022/*ui.dialogs.mjs` deve stampare i nove.
 5. `ui.shell` non importa nulla da `@angular/material` ne' da `@angular/cdk`, e nemmeno da `ui`.
    E' l'unica ragione per cui esiste: se ci finisce dentro un solo simbolo di Material, la shell
    torna a pagare l'intero stack sul percorso di boot. Da verificare dopo ogni build:
@@ -125,14 +128,14 @@ significherebbe far dipendere tre entry point headless da uno di UI, cioe' rompe
 La conseguenza pratica per chi scrive l'applicazione:
 
 - shell, interceptor, guard, `provideAppInitializer` -> `ShellService` di `ui.shell`
-- componenti di rotta -> `DialogService` di `ui.dialogs`, e `ApplicationDialogService` di `ui.application` per i dialog pesanti
+- componenti di rotta -> `DialogService` di `ui.dialogs`, che apre anche i dialog pesanti
 
 I tre servizi sono una catena, non tre servizi diversi:
 
 ```
 ShellService                info, error, busy*, wait, busyTimer     ui.shell
-  └ DialogService           + open, confirm, delete, toast          ui.dialogs
-      └ ApplicationDialogService  + select, prompt, sendTo, ...     ui.application
+  └ DialogService           + open, confirm, delete, toast,         ui.dialogs
+                              select, prompt, sendTo, ... (pigri)
 ```
 
 Quindi chi inietta `DialogService` ha tutto quello che aveva prima: `info`, `error` e `busy` non
@@ -147,7 +150,7 @@ iniettato e nient'altro.
 
 - Nessun barrel radice: `@arsedizioni/ars-utils` esporta solo `ARS_UTILS_VERSION`.
 - `ui` non contiene piu' i dialog: `DialogService` sta in `ui.dialogs`.
-- `ui.application` resta il solo facade e non riesporta piu' componenti: i controlli sono in
+- `ui.application` non esiste piu': i nove metodi che apriva stanno in `DialogService`. I controlli sono in
   `ui.controls`, i file in `ui.files`, i filtri in `ui.filters`, la navigazione in `ui.navigation`.
 - `SystemUtils.markdownToHtml` non esiste piu': usare `MarkdownUtils.toHtml` da `core.markdown`.
 - `SelectableModel` espone `first` e `selectedAny` al posto di `selectedFirst` e `selectedAll`.