@sumaris-net/ngx-components 21.1.2 → 21.3.0

package/doc/changelog.md

@@ -2344,3 +2344,39 @@ enh: Environment: add useHash property to configure Angular router to use hash U
 
 ## 21.1.2
 - enh(public_api): export `*.icons` modules across app layers
+
+## 21.2.0
+
+### ⚠️ BREAKING CHANGES — migration to Ionic standalone components
+
+The library now uses the Ionic **standalone** build (`@ionic/angular/standalone`, recommended by Ionic 8), and **no longer** the lazy-loaded build (`IonicModule`). Both builds must NOT be mixed: it left Ionic custom elements (`ion-app`, `ion-modal`...) undefined in production builds (blank page).
+
+**Apps using the library MUST be migrated**:
+1. Use `provideIonicAngular({...})` (from `@ionic/angular/standalone`) instead of `IonicModule.forRoot({...})`
+2. Replace all imports from `@ionic/angular` by `@ionic/angular/standalone` - especially the controllers (`ModalController`, `AlertController`, `ToastController`, `PopoverController`, `LoadingController`, `ActionSheetController`) and services (`NavController`, `Platform`...): classes are NOT the same (DI injection errors otherwise)
+3. Replace `IonicModule` (in NgModules and standalone components) by `SharedIonicModule`, or by an app module that extends `SHARED_IONIC_COMPONENTS` with the other Ionic components used by the app (e.g. `IonTabs`, `IonTextarea`, `IonItemSliding`...). An Ionic tag whose component is not imported stays an inert element, without any error (especially with `CUSTOM_ELEMENTS_SCHEMA`)
+4. Icons: register icons using `SharedModule.forRoot({ icons: {...} })` (see `ION_ICONS`); remove any custom `addIcons()` workaround. Unregistered icons are loaded from the `svg/` assets folder (copy `node_modules/ionicons/dist/ionicons/svg` into `svg/`)
+5. Unit tests: replace `IonicModule.forRoot()` by `SharedIonicModule`, and add `provideIonicAngular()` in providers
+
+### Changes
+- refactor(ionic): migrate all modules and components to Ionic standalone components; import controllers and services from `@ionic/angular/standalone`; `AppModule` uses `provideIonicAngular()` only
+- enh(ionic): add `SharedIonicModule` and `SHARED_IONIC_COMPONENTS` (all Ionic standalone components used by the library, including `IonRouterLink` for `routerLink` on Ionic components), replacing `IonicModule`. Exported by `SharedModule` and `public_api`
+- enh(icons): register icons (`ION_ICONS`) using `addIcons()` at startup (`SharedModule.forRoot()`), with new functions `registerIonicIcons()` and `provideIonicIconsInitializer()`. Unregistered icons (e.g. names computed at runtime) are loaded from the `svg/` assets folder
+- enh(VersionUtils): add `parseVersion()` (`VersionUtils.parse`) that returns a `SemVersion` (major, minor, patch, prerelease, build) or `null`, and `isValidVersion()` (`VersionUtils.isValid`). Both support prerelease versions (e.g. `1.0.0-alpha`, `1.0.0-beta.2`, `21.0.0-rc16`) and partial versions (e.g. `14` => `14.0.0`)
+- fix(VersionUtils): `compareVersionNumbers()` now returns `NaN` (instead of throwing an error) for a `null` or non-string version, and ignores leading/trailing whitespaces
+- fix(network): `NetworkService.getAppVersion()` now ignores a `version.appup` content that is not a valid version (e.g. a web server returning `index.html` for an unknown file), that caused a useless page reload
+- fix(properties-form): replace the unknown `arrow-dropdown` icon (removed in ionicons 8) by `caret-down`
+- perf(app): faster startup of the demo app (production: 408 ms => 329 ms, with standalone components):
+  * use the `package.json` version as environment version (was not aligned with `manifest.json`, causing a page reload by the app version check)
+  * declare `*_TESTING_PAGES` in lightweight `*.testing.config.ts` files, so that the testing modules stay lazy loaded (still re-exported by the testing modules)
+  * do not import `public_api` from the named filter testing service (it pulled the whole library into the main bundle)
+- test(ionic): unit tests use `SharedIonicModule` and `provideIonicAngular()` instead of `IonicModule.forRoot()`
+- test(version): add unit tests for `parseVersion()`, `isValidVersion()` and `VersionUtils`
+
+## 21.3.0
+- enh(network): new environment option `startupConnectionTimeout`: max time to wait for the pod at startup, before starting in offline mode. The pod is still checked in background, and the app goes online as soon as it responds. Can depend on the connection type, e.g. `{ wifi: 3000, cellular: 10000 }` (a cellular network is slower). Default: `connectionTimeout` (the startup waits for the pod, as before)
+- enh(NetworkUtils): add `NetworkUtils.resolveTimeout()`, to resolve a timeout that depends on the connection type
+- fix(config): faster startup when the pod cannot be reached: `ConfigService` now waits the network to be started, before loading the pod configuration (it was loaded with retries, ~6s, before being restored from the local storage)
+- fix(home): the loading spinner was not visible (white on a white background), while waiting for the pod configuration
+- fix(select-peer): display a message ('NETWORK.PEER.SELECT_MODAL.NO_PEER', in danger color) when no network node has been found, and open the manual form (to set a peer URL) automatically
+- fix(text-popover): do not show the 'invalid value' error before the user changed the value (the focus trap marked the control as touched, as soon as the popover opens)