autoHideOnPageTransition property

Whether the tab bar's platform view is hidden from Flutter's scene while the enclosing route is animating in or out (e.g. during a CupertinoPageRoute push or pop). Default: true.

When a page containing a UiKitView is animated by Flutter, the PlatformViewLayer overlay can occlude Flutter content elsewhere on the page — most visibly, parts of header/text widgets become briefly invisible mid-transition (Issue #29 follow-up). This is a Flutter hybrid-composition limitation and not something the Swift side can fix.

When this is true, CNTabBar listens to its enclosing ModalRoute.secondaryAnimation and wraps the platform view in an IndexedStack while the route is animating (forward / reverse) — the platform view stays MOUNTED (so the native UITabBar is not destroyed, preserving its state for the return) but isn't painted, so its PlatformViewLayer doesn't enter the scene and trigger the occlusion artifact. When the animation settles the IndexedStack switches to paint the platform view again — instant, no recreate animation (Issue #35 fix).

Set to false to skip the IndexedStack wrap entirely. The platform view will be painted continuously through transitions; this can re-introduce the page-wide occlusion artifact for content above the tab bar.