foldable 1.0.2

iPhone Duo hinge angle, fold posture and fold/camera regions for Flutter. Apple foldable iPhone support that stays safe on every non-foldable device.

1.0.2

• Fixed: a stale fold after laying the device flat. Reserved regions lag the hinge: inside the update handler the fold division still carries its pre-move isActive, and because the view's bounds do not change, no layout pass or further hinge update follows to correct it. With DisplayFeatureBridgeMode.full that left a 40pt postureFlat fold splitting every dialog on a flat device, and FoldInfo.spansDivision stayed true.
• The posture now decides: a fold is only published, and FoldInfo only reports a division, while the hinge reads partiallyOpen.
• The iOS plugin re-reads the regions after a hinge update until they agree with the hinge, for up to two seconds, and emits again, so FoldableData.regions settles too. Measured on the iPhone Duo simulator: flattening clears isActive 3 to 14 ms after the handler, folding sets it about a second later.
• Fixed: FoldableProvider inserted its MediaQuery only while it had display features to publish. That changed the shape of the widget tree, so each fold and unfold in full mode, and each change of bridgeMode, remounted everything below the provider and discarded scroll positions and State. The MediaQuery is now always present.
• Docs: the inactive division keeps its 40pt frame rather than collapsing to zero width.

Reported by @erkamyaman.

1.0.1

• Adds pub.dev screenshots: a still of the example app on a partially folded iPhone Duo, which becomes the package thumbnail, and the fold/unfold recording. No code changes.

1.0.0

First stable release. The native layer is now written against the real iOS 27.1 SDK headers and both code paths are verified on the iPhone Duo simulator, so the API is settled enough to commit to: anything breaking from here waits for 2.0.0.

The hinge APIs shipped differently from what the Tech Talks implied, so the native layer was rewritten against the real headers.

• Fixed: the runtime path never worked. UIHingeInteraction.init is unavailable, the only initialiser is initWithUpdateHandler:, the hinge arrives on the update rather than the interaction, and UIHingeStatus raw values start at 1. Reserved regions take a UIViewReservedRegionKind object, not an enum. All four are corrected and confirmed on device.
• hinge.angle is documented as radians and reads 0 when folded shut, so angleUnitVerified now reports true.
• Both code paths are exercised on the simulator and report identical readings: the Objective-C runtime path, and the typed path behind FOLDABLE_NATIVE_API now that the real types exist.
• A device reports the absence of a hinge only through an update, so supportLevel can legitimately be unknown for a moment. Dart keeps the stream open until the answer settles rather than closing on the first snapshot.
• Breaking for the platform interface only: HingeSource.hasHinge is now Bool?. The Dart API is unchanged.
• Minimum deployment target is now iOS 15.0, the lowest Xcode 27.1 accepts.
• README documents the two Flutter 3.44 / Xcode 27.1 build problems and their workarounds, and the measured inner display geometry: 951x669pt with a 40pt fold division.

0.2.0

Adds the iOS size class bridge, and corrects the reserved-region documentation against Apple's published Tech Talk material.

• New: SizeClass (compact / regular / unspecified), bridged from traitCollection and exposed through FoldableData.horizontalSizeClass, DuoMediaQuery.horizontalSizeClassOf, and FoldInfo.isRegularWidth. This is the signal iOS lays out from, and unlike a width breakpoint it tracks Split View, where the class changes without the device folding. Reported on every iOS device, so it is useful when isFoldable is false.
• FoldableProvider now re-reads the snapshot when the window changes shape, so size classes stay current without a hinge to drive the event stream.
• DuoMediaQuery gains a sizeClass aspect, so posture readers are not rebuilt when only the size class changes.
• Docs: an occlusion region is active only while that camera is in use, and the fold division only while the device is folded. Both were already handled correctly in code through isActive; only the documentation was misleading.
• Docs: an app must be built against the iOS 27.1 SDK for reserved regions to exist at all. Hinge angle and posture are unaffected.
• Docs: note Apple's iOS 27.1 Arrangements API and why this package does not mirror it.

No breaking changes. Hinge readings remain unverified against physical hardware; FoldableCapabilities.angleUnitVerified still reports false.

0.1.0

First release, published ahead of the iPhone Duo's 23 October 2026 launch.

• Foldable.isFoldable, hingeAngleStream (degrees), hingeStatusStream, hingeStatus, snapshot, changes and capabilities.
• HingeStatus: closed / partiallyOpen / fullyOpen / unknown, following Apple's own terminology.
• FoldableProvider + DuoMediaQuery (an InheritedModel, so the posture and the continuously changing angle rebuild independently) and FoldAwareBuilder.
• Opt-in MediaQuery.displayFeatures bridging via DisplayFeatureBridgeMode, off by default, with invariants that prevent an accidental layout split. See flutter/flutter#192515.
• iOS implementation resolves the iOS 27.1 hinge APIs through the Objective-C runtime, so the package compiles on older SDKs at an iOS 13.0 deployment target and no-ops safely on devices without a hinge.
• Foldable.debugDumpNativeApi() for confirming the real API shape on hardware.

Hinge readings have not been verified against a physical device; FoldableCapabilities.angleUnitVerified reports false until they are.