@arsedizioni/ars-utils 22.5.38 → 22.5.39

package/README.md

@@ -1,179 +1,185 @@
-# ARS Utils
-
-Common tools and standalone components shared among ARS Edizioni Angular based web applications.
-
-Rispetto alla versione monolitica precedente adotta la struttura a entry point
-introdotta con `@fabio.buscaroli/scm-utils`: code splitting e tree shaking sono il criterio di
-ripartizione dei simboli, non un effetto collaterale.
-
-## Platform
-
-Angular 22 + Material
-
-## Entry points
-
-La libreria non espone un barrel unico: l'entry point secondario e' l'unica unita' di
-code splitting riconosciuta da ng-packagr, quindi ogni gruppo di simboli che ha un ciclo
-di vita proprio vive nel suo entry point. Importare sempre dal path specifico.
-
-### Nucleo condiviso
-
-| Livello | Entry point | Contenuto | Note |
-|---|---|---|---|
-| L0 | `core` | `SystemUtils`, models, definitions, pipe, direttive validator, servizi (broadcast, screen, theme, splash, environment), `LoginOAuthType` | nessuna dipendenza da Angular Material |
-| L0 | `core.date` | `provideArsDateFns`, `provideArsLocalDates`, `MAT_DATE_FNS_FORMATS`, `arsLocalDateInterceptor`, `ARS_TIME_ZONE` | isola `@angular/material/core` + `datepicker` |
-| L0 | `core.markdown` | `MarkdownUtils`, `FormatMarkdownPipe` | parser markdown, fuori dal percorso comune |
-| L0 | `core.validators` | direttive validator per i form template-driven (`ValidatorDirective`, `ValidIfDirective`, `EqualsValidatorDirective`, `PasswordValidatorDirective`, `EmailsValidatorDirective`, ...) | isola `@angular/forms` (53 KB): `core` sta sul percorso di boot e non deve trascinarselo |
-| 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`, 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` |
-| L2 | `ui.files` | file-input, file-preview, select-file, select-picture | |
-| 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 |
-
-### Specifici ARS
-
-| Livello | Entry point | Contenuto | Dipendenze pesanti |
-|---|---|---|---|
-| L0.5 | `support.common` | `SupportService`, notifiche, definitions, messages | - |
-| L0.5 | `evolution.common` | `EvolutionService`, account, compliance, login, interceptor auth | - |
-| L2 | `ui.oauth` | `LoginOAuthComponent`, `LoginOAuthOkMSComponent` | `@azure/msal-angular`, `@azure/msal-browser` |
-| L2 | `ui.help` | `HelpService`, `HelpViewerComponent`, modello dei capitoli | - |
-| L2 | `ui.tinymce` | `TinymceEditorDirective`, `TinymceLoaderService`, `TinymceUtils`, `TinyMceEditorComponent`, `langs/it.js` | `tinymce` (caricato a runtime) |
-| L2 | `ui.notifications` | `NotificationsBrowserComponent` (ex `support.ui`) | - |
-| L2 | `clipper.common` | `ClipperService`, documents, login, canali e contatori non letti, interceptor auth | solo il necessario a consultare i documenti |
-| L4 | `clipper.ui` | browser, document, references, search-* e `ClipperDocumentUtilsService` | `clipper.scss` |
-
-I peer dependency opzionali (`@azure/msal-*`, `tinymce`) servono
-solo a chi importa rispettivamente `ui.oauth` e `ui.tinymce`: sono dichiarati in
-`peerDependenciesMeta.optional` proprio perche' nessun altro entry point li aggancia.
-
-### Grafo delle dipendenze statiche
-
-```
-core          core.date        core.markdown        core.validators        ui.paginator
- |    \
- |     ui.shell
- |        |
- ui ------|-----------------------------------------------------------
- |        |   |            |            |                  |          |
- |        | ui.controls ui.filters ui.navigation  ui.dialogs.select  clipper.common
- |        |
-ui.dialogs      <-- DialogService extends ShellService: dipende da `ui` E da `ui.shell`
- |         |                  |              |          |            |
- |   ui.dialogs.auth   ui.dialogs.prompt  ui.files   ui.help    ui.oauth
- |                                                   ui.notifications (+ support.common)
-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 **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.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:
-   `grep -oE "@angular/(material|cdk)[^'\"]*" dist/ars-utils/fesm2022/*ui.shell.mjs` non deve
-   stampare nulla.
-7. Le sovrapposizioni di `ui.shell` stanno nel **top layer** del browser, non nello stack del CDK.
-   Da Angular CDK 22 ogni overlay viene aperto come `popover="manual"`, quindi un dialog Material
-   non sta piu' a z-index 1000: sta nel top layer, che viene disegnato sopra tutta la pagina
-   qualunque cosa dica lo z-index della pagina. Un numero, per quanto alto, non ci arriva sopra:
-   per questo `ShellService` promuove anche i suoi due overlay con `showPopover()`.
-   Nel top layer l'ordine e' quello di promozione, l'ultimo promosso sta sopra. Da qui le tre
-   regole esplicite: `setBusy()` ripromuove il messaggio dopo aver alzato il busy,
-   `DialogService.open()` chiama `raiseMessage()` dopo aver aperto un dialog, e chiama
-   `clearBusy(true)` senza periodo di grazia. La coppia `--ars-shell-dialog-z-index`/`--ars-shell-busy-z-index`
-   (1100/1090) resta valida e serve ancora: e' quello che ordina gli overlay sui browser senza
-   Popover API, dove nemmeno il CDK la usa. Se un'applicazione avesse bisogno del vecchio
-   comportamento puo' spegnere la Popover API del CDK con
-   `{ provide: OVERLAY_DEFAULT_CONFIG, useValue: { usePopover: false } }`.
-6. `ui` non importa valori da Material. `PaginatorIntl` e' uscito da li' proprio per questo: era
-   l'unico simbolo che ne dipendeva, e faceva pagare `mat-paginator` + `mat-select` + `mat-option`
-   a chiunque toccasse `ui.dialogs`. Restano due eccezioni, entrambe volute:
-   `MatFormFieldAppearance` in `dialog.definitions.ts`, che e' un `import type` e quindi sparisce
-   in compilazione, e `@angular/cdk/layout` (1 KB) di cui `MediaObserver` ha bisogno.
-
-### Da dove parte un'applicazione
-
-`core` + `ui.shell`. Sono i due entry point che una applicazione ARS carica comunque prima di
-avere una rotta, e gli unici due che non costano Material. `core` porta `SystemUtils`, i modelli,
-`BroadcastService`, `SplashService`, `EnvironmentService`, `ThemeService`; `ui.shell` porta il modo
-di dire all'utente che la sessione e' scaduta o che l'API non risponde.
-
-Non sono un entry point solo, e non devono diventarlo: `core` e' L0 e ci dipendono anche
-`clipper.common`, `evolution.common` e `support.common`, che di interfaccia non ne hanno. Fonderli
-significherebbe far dipendere tre entry point headless da uno di UI, cioe' rompere la regola 1.
-
-La conseguenza pratica per chi scrive l'applicazione:
-
-- shell, interceptor, guard, `provideAppInitializer` -> `ShellService` di `ui.shell`
-- 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
-                              select, prompt, sendTo, ... (pigri)
-```
-
-Quindi chi inietta `DialogService` ha tutto quello che aveva prima: `info`, `error` e `busy` non
-sono spariti, sono ereditati. E non esistono in due copie — c'e' una implementazione sola, quella
-senza Material.
-
-`ShellService.info()` e `ShellService.error()` hanno gli stessi parametri, nello stesso ordine,
-delle omonime di `DialogService`: spostare una chiamata dall'una all'altra e' un cambio di servizio
-iniettato e nient'altro.
-
-## Differenze rispetto alla versione precedente (22.1.x monolitica)
-
-- Nessun barrel radice: `@arsedizioni/ars-utils` esporta solo `ARS_UTILS_VERSION`.
-- `ui` non contiene piu' i dialog: `DialogService` sta in `ui.dialogs`.
-- `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`.
-- `support.ui` si chiama `ui.notifications`, `help` si chiama `ui.help`, `tinymce` si chiama `ui.tinymce`.
-- `PaginatorIntl` non sta piu' in `ui`: sta in `ui.paginator`.
-- `ui.tinymce` non dipende piu' da `@tinymce/tinymce-angular`: l'editor e' la direttiva
-  `[tinymceEditor]` su una `<textarea>`, e TinyMCE viene caricato a runtime da
-  `TinymceLoaderService`. Il componente `<editor>` non esiste piu'.
-- Le direttive validator non stanno piu' in `core`: stanno in `core.validators`, che e' l'unico
-  entry point del nucleo a dipendere da `@angular/forms`.
-- I token CSS della shell stanno tutti sotto `--ars-shell-dialog-*` e `--ars-shell-busy-*`: prima
-  erano `--ars-dialog-*`, `--ars-scrim-color`, `--ars-busy-*` e `--ars-progress-track-color`, che si
-  confondevano con `--ars-dialog-item-*`, cioe' i dialog Material veri. Un'applicazione che ne
-  sovrascriveva qualcuno deve rinominarlo.
-- La shell non deve piu' iniettare `DialogService` per mostrare un errore: c'e' `ShellService` in `ui.shell`.
-- `info`, `error`, `busy`, `busySpinner`, `busyHourglass`, `wait`, `busyTimer` e `clearBusy` sono
-  passati a `ShellService`. `DialogService` li eredita, quindi nessuna chiamata cambia.
-- `info()` e `error()` restituiscono `ShellMessageRef` invece di `MatDialogRef<InfoDialogComponent>`.
-  In myARS nessun chiamante usava quel valore; controllare nelle altre applicazioni.
-- `clearBusy()` accetta `immediate`: `clearBusy(true)` non aspetta i 500 ms di grazia.
-- `BusyTimer` si importa da `ui.shell`, non piu' da `ui.dialogs`.
-- `InfoDialogComponent` e `BusyDialogComponent` non esistono piu': li sostituiscono
-  `ShellMessageComponent` e `ShellBusyComponent`, senza Material.
-
-## Authors
-Fabio Buscaroli, Alberto Doria
+# ARS Utils
+
+Common tools and standalone components shared among ARS Edizioni Angular based web applications.
+
+Rispetto alla versione monolitica precedente adotta la struttura a entry point
+introdotta con `@fabio.buscaroli/scm-utils`: code splitting e tree shaking sono il criterio di
+ripartizione dei simboli, non un effetto collaterale.
+
+## Platform
+
+Angular 22 + Material
+
+## Entry points
+
+La libreria non espone un barrel unico: l'entry point secondario e' l'unica unita' di
+code splitting riconosciuta da ng-packagr, quindi ogni gruppo di simboli che ha un ciclo
+di vita proprio vive nel suo entry point. Importare sempre dal path specifico.
+
+### Nucleo condiviso
+
+| Livello | Entry point | Contenuto | Note |
+|---|---|---|---|
+| L0 | `core` | `SystemUtils`, models, definitions, pipe, direttive validator, servizi (broadcast, screen, theme, splash, environment), `LoginOAuthType` | nessuna dipendenza da Angular Material |
+| L0 | `core.date` | `provideArsDateFns`, `provideArsLocalDates`, `MAT_DATE_FNS_FORMATS`, `arsLocalDateInterceptor`, `ARS_TIME_ZONE` | isola `@angular/material/core` + `datepicker` |
+| L0 | `core.markdown` | `MarkdownUtils`, `FormatMarkdownPipe` | parser markdown, fuori dal percorso comune |
+| L0 | `core.validators` | direttive validator per i form template-driven (`ValidatorDirective`, `ValidIfDirective`, `EqualsValidatorDirective`, `PasswordValidatorDirective`, `EmailsValidatorDirective`, ...) | isola `@angular/forms` (53 KB): `core` sta sul percorso di boot e non deve trascinarselo |
+| 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`, 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` |
+| L2 | `ui.files` | file-input, file-preview, select-file, select-picture | |
+| L2 | `ui.controls` | button-selector, button-toggle, chips-selector | base Material comune: button, icon, form-field |
+| L2 | `ui.controls.date` | `MatDatepickerParseErrorFixDirective`, `CalendarEmptyHeader` | isola `@angular/material/datepicker`: `ui.dialogs.prompt` aggancia solo questo |
+| L2 | `ui.controls.tree` | `TreePickerComponent` | isola `mat-tree`, `mat-tabs`, `mat-input`, `mat-checkbox`, che nessun altro controllo usa |
+| L2 | `ui.filters` | `FilterBarComponent` + modello `Filters` | |
+| L2 | `ui.navigation` | `NavigationBarComponent` + definizioni | shell applicativa |
+
+### Specifici ARS
+
+| Livello | Entry point | Contenuto | Dipendenze pesanti |
+|---|---|---|---|
+| L0.5 | `support.common` | `SupportService`, notifiche, definitions, messages | - |
+| L0.5 | `evolution.common` | `EvolutionService`, account, compliance, login, interceptor auth | - |
+| L2 | `ui.oauth` | `LoginOAuthComponent`, `LoginOAuthOkMSComponent` | `@azure/msal-angular`, `@azure/msal-browser` |
+| L2 | `ui.help` | `HelpService`, `HelpViewerComponent`, modello dei capitoli | - |
+| L2 | `ui.tinymce` | `TinymceEditorDirective`, `TinymceLoaderService`, `TinymceUtils`, `TinyMceEditorComponent`, `langs/it.js` | `tinymce` (caricato a runtime) |
+| L2 | `ui.notifications` | `NotificationsBrowserComponent` (ex `support.ui`) | - |
+| L2 | `clipper.common` | `ClipperService`, documents, login, canali e contatori non letti, interceptor auth | solo il necessario a consultare i documenti |
+| L4 | `clipper.ui` | browser, document, references, search-* e `ClipperDocumentUtilsService` | `clipper.scss` |
+
+I peer dependency opzionali (`@azure/msal-*`, `tinymce`) servono
+solo a chi importa rispettivamente `ui.oauth` e `ui.tinymce`: sono dichiarati in
+`peerDependenciesMeta.optional` proprio perche' nessun altro entry point li aggancia.
+
+### Grafo delle dipendenze statiche
+
+```
+core        core.date        core.markdown        core.validators        ui.paginator        ui.controls.date
+ |    \
+ |     ui.shell
+ |        |
+ ui ------|-----------------------------------------------------------
+ |        |      |               |             |             |                 |               |
+ |        | ui.controls  ui.controls.tree  ui.filters  ui.navigation  ui.dialogs.select  clipper.common
+ |        |
+ui.dialogs      <-- DialogService extends ShellService: dipende da `ui` E da `ui.shell`
+ |         |                  |              |          |            |
+ |   ui.dialogs.auth   ui.dialogs.prompt  ui.files   ui.help    ui.oauth
+ |                                                   ui.notifications (+ support.common)
+clipper.ui  (+ clipper.common, ui.controls, ui.controls.date, 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`.
+
+`ui.controls.date` non dipende da nulla della libreria (solo `@angular/core` e
+`@angular/material/datepicker`): e' cio' che permette al chunk di `ui.dialogs.prompt` di
+agganciare la direttiva senza linkare il file di `ui.controls`.
+```
+
+`evolution.common` e `support.common` dipendono solo da `core`.
+
+### Regole da rispettare
+
+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.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:
+   `grep -oE "@angular/(material|cdk)[^'\"]*" dist/ars-utils/fesm2022/*ui.shell.mjs` non deve
+   stampare nulla.
+7. Le sovrapposizioni di `ui.shell` stanno nel **top layer** del browser, non nello stack del CDK.
+   Da Angular CDK 22 ogni overlay viene aperto come `popover="manual"`, quindi un dialog Material
+   non sta piu' a z-index 1000: sta nel top layer, che viene disegnato sopra tutta la pagina
+   qualunque cosa dica lo z-index della pagina. Un numero, per quanto alto, non ci arriva sopra:
+   per questo `ShellService` promuove anche i suoi due overlay con `showPopover()`.
+   Nel top layer l'ordine e' quello di promozione, l'ultimo promosso sta sopra. Da qui le tre
+   regole esplicite: `setBusy()` ripromuove il messaggio dopo aver alzato il busy,
+   `DialogService.open()` chiama `raiseMessage()` dopo aver aperto un dialog, e chiama
+   `clearBusy(true)` senza periodo di grazia. La coppia `--ars-shell-dialog-z-index`/`--ars-shell-busy-z-index`
+   (1100/1090) resta valida e serve ancora: e' quello che ordina gli overlay sui browser senza
+   Popover API, dove nemmeno il CDK la usa. Se un'applicazione avesse bisogno del vecchio
+   comportamento puo' spegnere la Popover API del CDK con
+   `{ provide: OVERLAY_DEFAULT_CONFIG, useValue: { usePopover: false } }`.
+6. `ui` non importa valori da Material. `PaginatorIntl` e' uscito da li' proprio per questo: era
+   l'unico simbolo che ne dipendeva, e faceva pagare `mat-paginator` + `mat-select` + `mat-option`
+   a chiunque toccasse `ui.dialogs`. Restano due eccezioni, entrambe volute:
+   `MatFormFieldAppearance` in `dialog.definitions.ts`, che e' un `import type` e quindi sparisce
+   in compilazione, e `@angular/cdk/layout` (1 KB) di cui `MediaObserver` ha bisogno.
+
+### Da dove parte un'applicazione
+
+`core` + `ui.shell`. Sono i due entry point che una applicazione ARS carica comunque prima di
+avere una rotta, e gli unici due che non costano Material. `core` porta `SystemUtils`, i modelli,
+`BroadcastService`, `SplashService`, `EnvironmentService`, `ThemeService`; `ui.shell` porta il modo
+di dire all'utente che la sessione e' scaduta o che l'API non risponde.
+
+Non sono un entry point solo, e non devono diventarlo: `core` e' L0 e ci dipendono anche
+`clipper.common`, `evolution.common` e `support.common`, che di interfaccia non ne hanno. Fonderli
+significherebbe far dipendere tre entry point headless da uno di UI, cioe' rompere la regola 1.
+
+La conseguenza pratica per chi scrive l'applicazione:
+
+- shell, interceptor, guard, `provideAppInitializer` -> `ShellService` di `ui.shell`
+- 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
+                              select, prompt, sendTo, ... (pigri)
+```
+
+Quindi chi inietta `DialogService` ha tutto quello che aveva prima: `info`, `error` e `busy` non
+sono spariti, sono ereditati. E non esistono in due copie — c'e' una implementazione sola, quella
+senza Material.
+
+`ShellService.info()` e `ShellService.error()` hanno gli stessi parametri, nello stesso ordine,
+delle omonime di `DialogService`: spostare una chiamata dall'una all'altra e' un cambio di servizio
+iniettato e nient'altro.
+
+## Differenze rispetto alla versione precedente (22.1.x monolitica)
+
+- Nessun barrel radice: `@arsedizioni/ars-utils` esporta solo `ARS_UTILS_VERSION`.
+- `ui` non contiene piu' i dialog: `DialogService` sta in `ui.dialogs`.
+- `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`.
+- `support.ui` si chiama `ui.notifications`, `help` si chiama `ui.help`, `tinymce` si chiama `ui.tinymce`.
+- `PaginatorIntl` non sta piu' in `ui`: sta in `ui.paginator`.
+- `ui.tinymce` non dipende piu' da `@tinymce/tinymce-angular`: l'editor e' la direttiva
+  `[tinymceEditor]` su una `<textarea>`, e TinyMCE viene caricato a runtime da
+  `TinymceLoaderService`. Il componente `<editor>` non esiste piu'.
+- Le direttive validator non stanno piu' in `core`: stanno in `core.validators`, che e' l'unico
+  entry point del nucleo a dipendere da `@angular/forms`.
+- I token CSS della shell stanno tutti sotto `--ars-shell-dialog-*` e `--ars-shell-busy-*`: prima
+  erano `--ars-dialog-*`, `--ars-scrim-color`, `--ars-busy-*` e `--ars-progress-track-color`, che si
+  confondevano con `--ars-dialog-item-*`, cioe' i dialog Material veri. Un'applicazione che ne
+  sovrascriveva qualcuno deve rinominarlo.
+- La shell non deve piu' iniettare `DialogService` per mostrare un errore: c'e' `ShellService` in `ui.shell`.
+- `info`, `error`, `busy`, `busySpinner`, `busyHourglass`, `wait`, `busyTimer` e `clearBusy` sono
+  passati a `ShellService`. `DialogService` li eredita, quindi nessuna chiamata cambia.
+- `info()` e `error()` restituiscono `ShellMessageRef` invece di `MatDialogRef<InfoDialogComponent>`.
+  In myARS nessun chiamante usava quel valore; controllare nelle altre applicazioni.
+- `clearBusy()` accetta `immediate`: `clearBusy(true)` non aspetta i 500 ms di grazia.
+- `BusyTimer` si importa da `ui.shell`, non piu' da `ui.dialogs`.
+- `InfoDialogComponent` e `BusyDialogComponent` non esistono piu': li sostituiscono
+  `ShellMessageComponent` e `ShellBusyComponent`, senza Material.
+
+## Authors
+Fabio Buscaroli, Alberto Doria

package/fesm2022/arsedizioni-ars-utils-clipper.common.mjs

@@ -2618,10 +2618,10 @@ class ClipperLoginService {
     clear(clearOAuthToken = true) {
         this.core.clear(clearOAuthToken);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperLoginService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
-    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.3", ngImport: i0, type: ClipperLoginService }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperLoginService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.4", ngImport: i0, type: ClipperLoginService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperLoginService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperLoginService, decorators: [{
             type: Service
         }] });
 
@@ -2901,10 +2901,10 @@ class ClipperCoreService {
             .pipe(catchError$1(() => { return EMPTY; }))
             .subscribe();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperCoreService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
-    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.3", ngImport: i0, type: ClipperCoreService }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperCoreService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.4", ngImport: i0, type: ClipperCoreService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperCoreService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperCoreService, decorators: [{
             type: Service
         }] });
 
@@ -2950,10 +2950,10 @@ class ClipperAccountService {
         }
         this.broadcastService.sendMessage(ClipperMessages.COMMAND_DASHBOARD_UPDATED);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperAccountService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
-    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.3", ngImport: i0, type: ClipperAccountService }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperAccountService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.4", ngImport: i0, type: ClipperAccountService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperAccountService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperAccountService, decorators: [{
             type: Service
         }] });
 
@@ -3295,10 +3295,10 @@ class ClipperDocumentsService {
         return this.httpClient
             .post(this.core.serviceUri + '/documents/searches/delete', { id: id });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperDocumentsService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
-    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.3", ngImport: i0, type: ClipperDocumentsService }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperDocumentsService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.4", ngImport: i0, type: ClipperDocumentsService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperDocumentsService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperDocumentsService, decorators: [{
             type: Service
         }] });
 
@@ -3384,10 +3384,10 @@ class ClipperService {
     ping() {
         this.core.ping();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
-    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.3", ngImport: i0, type: ClipperService }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.4", ngImport: i0, type: ClipperService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ClipperService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: ClipperService, decorators: [{
             type: Service
         }] });