[rdlabo]

Problem

Plain HTML consumers of @rdlabo/capacitor-native-ui/core install Ionic, Stencil and ionicons because the required utils dependency declares Ionic as a non-optional peer.

Mark the Ionic peer optional while retaining its supported version range. Ionic consumers must continue providing Ionic; CLI and non-Ionic consumers no longer acquire it transitively. Document this boundary and add one packed-package installation regression test to the existing CLI test suite.

Related: rdlabo-dev/ionic-theme-ios27#306

Validation

• New regression test fails before the fix and passes afterward.
• CLI tests: 10 passed; unit tests: 16 passed.
• Build, packed ESM verification, formatting and lint passed.
• Actual packed Native UI consumer: baseline installs Ionic/Stencil/ionicons; overriding utils with the patched local archive installs none of them, and /core imports successfully.
• Installing Ionic explicitly in that consumer preserves Native UI adapter and shared popover animation imports.

After a utils release, update the pinned dependency in Native UI, the iOS 27 theme, and the monorepo root development dependencies, together with their lockfiles. The theme still requires Ionic for its own functionality. This upstream fix alone does not resolve the issue for published Native UI consumers.

[github-actions]

npm beta published

CI passed for the merge commit 63dab021b477. Install the immutable version with:

npm install @rdlabo/ionic-theme-utils@0.1.4-beta.pr11.sha63dab021b477