@sumaris-net/ngx-components 21.1.1 → 21.2.0

package/doc/changelog.md

@@ -2341,3 +2341,34 @@ enh: Environment: add useHash property to configure Angular router to use hash U
 - fix(menu) Account page should close the left menu (mobile)
 - fix(account-page) Account page should not have the close button, when back button is already visible (e.g. when routed from the home page)
 - fix(toolbar) Add new slot `data-slot` to avoid conflict with Ionic `ion-toolbar` reserved slot `end`
+
+## 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`