magewire-hyva-checkout-backwards-compatibility

Migrate Hyvä Checkout v1 components to Magewire v3 by installing a backwards-compatibility layer that provides runtime JS shims and PHP features. This layer rewrites wire directives and proxies component state to preserve v2 behavior inside v3.

You need a backwards-compatibility layer when upgrading to Magewire v3 while maintaining Hyvä Checkout v1 components. It bridges v2 and v3 behavior automatically for any component rendered inside the hyva-checkout-main container.

Yes, Magewire v3 backwards compatibility requires the magewire-backwards-compatibility and magewire-theming modules to be installed and active within your Hyvä theme environment to function correctly.

Yes, you can opt out of the Magewire backwards compatibility layer for specific components by applying the #[HandleBackwardsCompatibility] attribute or using DI-based configuration for advanced custom usage.

The best way to preserve Magewire $wire behavior is using a theme-scoped compatibility layer with JS templates that proxy component state. This aligns v2 and v3 behavior without requiring manual component rewrites.

Magewire directives break after upgrading to v3 because v2 behavior is not natively supported. A compatibility layer applies JS templates and PHP features to rewrite directives and proxy $wire, restoring expected functionality.