origin 2.1.0

Interactive hero transitions framework for Flutter with composable gesture physics.

2.1.0

Release/settle physics is now pluggable. Decay and rubber-back motion are driven by [Simulation]s, with velocity continuity across the decay→settle boundary. dismiss() is spring-driven, so the configured settle visibly shapes return-to-origin motion.

Breaking

• DecelerateConfig → DecayConfig (and Bounds.decelerate → .decay).
• DecayConfig slots: Friction? → Decay?. Use .imageViewer(), .iosScroll(), .exponential(x), etc.
• DecayConfig.settle: Friction? → Settle?. Use .attract().
• FrictionCurve → SimulationCurve (accepts any [Simulation]).

Added

• Decay abstract class + ExponentialDecay with const presets (.iosScroll, .iosFast, .imageViewer, .none) and parameterized factories (.halfLife, .perFrame).
• Settle abstract class + AttractSettle({stiffness}) — critically-damped spring back to target.
• copyWith on FrictionConfig and DecayConfig.

Fixed

• Cropper handles wired to the wrong corners under RTL locale.
• Spurious huge fling velocity on simultaneous two-finger lift.
• Active-drag friction triggered everywhere on zoomed-in rects (past-display zone now picked correctly for rects larger than display).

2.0.0

Large refactor of the gesture, release, and physics layers and a built-in cropper tool. Spans 15 commits since 1.5.2; many public APIs changed shape.

Breaking

• GestureBounds replaces Map<DragBound, DragBounds> everywhere bounds: is used. Convenience constructors: .vertical, .horizontal, .symmetric, .all, plus per-side .top / .bottom / .left / .right.
• ScaleResponse uses two ScaleRamp zones (end + curve only) — consecutive ramps auto-stitch from 1.0 (or prior zone's end) so they can't be made discontinuous.
• FrictionConfig ships three named constructors: .uniform, .byDirection, .byZone. Per-slot default constructor still works.
• CropConfig: single ratio: Ratio? replaced with minAspectRatio: double? + maxAspectRatio: double? (equal values = locked aspect).
• RectExt.cropBoundaries / moveSide / moveCorner take double? aspectRatio (or named min/max on cropBoundaries) instead of Ratio?.
• AxisState collapses extending + pastDisplay into a single DragDirectionState enum mirroring FrictionConfig's four slots.
• Per-axis drag-update helpers reorganized — dragScaleFactor removed; computeDragRect / applyDragTransform are the supported entry points.
• axisStateX / axisStateY return shape changed to use DragDirectionState.

Added

• Built-in Cropper widget with CropConfig — dim/grid/handles, aspect-range support, mid-mode crop-drag with pinned-edge image follow, chrome cross-fade on entry/dismiss.
• Mode system on Origin — modes: {key: DisplayConfig} switched via Stage.setMode(key). Per-mode merge over the Origin's default displayConfig field-by-field. Mode transitions animate rect + crop rect in parallel.
• Stage transition signals: transitionProgressMin / Mean / Max (ValueListenable<double>) — aggregated progress across the rect/crop animation controllers, gated by openingOrDismissing || changingMode. Plus Stage.changingMode flag.
• Hybrid pointer merger — Origin and Stage cooperate during a single gesture when pointers cross between their hit regions.
• Arena-based gesture cascade — drag/scale resolution via priority cascade (per-gesture → DisplayConfig → Stage → default).
• Decomposed per-axis release plan with adaptive rubber settle — velocity-driven decay phases per axis followed by a snap-back simulation.
• Drag → scale promotion cascade — DragGesture.promote / DisplayConfig.dragPromote / Stage.dragPromote.
• Scale-velocity translation cancel — scaleVelocityCancel cascade damps residual pan velocity proportional to pinch velocity at release.
• Skia-based cropImageBytes + displayRectToSourceRect helpers for consumers that want to apply the crop rect to source bytes.
• Stage.animateWidth({to, height?}) — optional height lets the height tween target a value other than to / aspectRatio (smooth aspect transitions during animateRect).
• Origin.aspectRatio — explicit aspect override (falls back to context.size!.aspectRatio).
• Per-axis primitives boundForX/Y, directionStateForX/Y for consumers building custom routing.
• Opt-in tap recognizers — onTap / onDoubleTap register only when a handler is supplied; without one, deeper GestureDetectors win the arena without kDoubleTapTimeout latency.

1.5.2

• Send overlays now clip against the origin container, matching the main overlay's clipping during reorder.
• Container expansion tracks per-frame drag deltas (monotonic — only grows during drag). Animated shrink back to origin container on dismiss, synced with the rect animation.

1.5.1

• Only reject multi-pointer when the recognizer has explicit gestures. Keeps pinch working on Stage's root recognizer.

1.5.0

• Breaking: dismiss signature changed from dismiss([Object? tag]) to dismiss({Object? tag, Object? except}). except skips the given tag from the return-all loop (for preserving swap targets).
• Breaking: unregister now requires the OriginEntry instance. Identity-aware unregister only removes the tag from the registry if the stored entry matches, preventing transient duplicates during keyed-children reorders.
• register no longer asserts on duplicate tags — transient duplicates are tolerated and later resolved via identity-aware unregister.
• _displace now returns other parked/sending items to home on hover change, cleaning up stale displacements proactively.
• StageScaleRecognizer rejects the arena when a second pointer joins a single-pointer-only recognizer — releases pointers so nested Origins with multi-pointer gestures can claim them.

1.4.0

• onEnd accepts FutureOr<void> and is awaited before reset().
• dismiss() returns all active sends to .returning state.

1.3.1

• Guard dismiss(tag) to prevent stale tag states when tag has no active send.

1.3.0

• Swap support: swapTags and onSwap on Origin for drag-to-reorder between Origins.
• _SendLayer animates displaced items to target and back.
• TagState enum (idle, sending, parked, returning) tracks displacement state.
• Stage.stateOf(context, tag) and Stage.isActiveOf(context, tag) accessors.
• displace, release, captureEntry on StageData.
• isTagOf now returns true for displaced tags (not just the active tag). Use isActiveOf for the previous behavior.

1.2.1

• Fix sendEntry using stale origin rect instead of measured position.

1.2.0

• Container computed in Stage via ValueNotifier<OriginRect?>, expand-only during interaction, shrinks on dismiss.
• Stage.isDismissingOf(context) aspect-based accessor.
• dismissing field on StageData.
• Dismiss drag anchors rect to pointer — content stays pinned under finger while scaling.

1.1.0

• Breaking: itemGesturing / setItemGesturing replaced by locked / setLocked. Stage defaults to locked, unlocks after animateToBase completes, relocks on reset.
• Breaking: origin, originContainer, display, displayContainer, aspectRatio on StageData changed from ValueNotifier to plain values with setters.
• Breaking: originContainer and displayContainer are now nullable. null means full screen (no container clip).
• Container clipping: overlay clips content to an animated container rect using ClipPath. Container expands from originContainer toward displayContainer as the item moves.
• Stage.isLockedOf(context) static accessor.
• containerTag no longer falls back to widget.tag — only explicit container tags are measured.

1.0.0

• Breaking: OriginDisplay + OriginScope merged into Stage.
• Breaking: OriginItem replaced by Origin.
• Breaking: triggerEntry split into openEntry and sendEntry.
• Breaking: effectTransform replaced by Rotation class with toMatrix4.
• InheritedModel aspects: widgetOf, hasWidgetOf, tagOf, isTagOf.
• originToBaseProgress notifier for border radius and scrim interpolation.
• Configurable backgroundColor scrim on Stage.
• onEnd overridable via setOnEnd or sendEntry optional parameter.
• perspective on Rotation class and runEffect.

0.3.0

• Breaking: OriginItem.builder signature changed from WidgetBuilder? to Widget Function(BuildContext, Widget)? — receives the child widget as second parameter.
• Breaking: OriginItem.builder now acts as the gesture builder in the overlay. If no OriginGesture.builder is provided, the item's builder is used instead.
• OriginItem.builder no longer replaces the overlay widget — widget.child is always used. The builder wraps the clipped child in the overlay.
• Overlay blocks gestures on content beneath when active (absorbs pointers between content and overlay layer).

0.2.0

• Breaking: OriginScope.registerItem callback changed from VoidCallback to Future<void> Function([Rect Function(Rect)?]).
• Breaking: OriginScope.triggerItem accepts optional send callback for programmatic dismiss to a computed rect.
• Breaking: Scope maps moved from widget instance to display state, fixing registration loss on rebuild.
• OriginItem.onTap replaces tap, provides OriginTapEvent with animateToBase and runEffect.
• OriginItem.onEnd callback fires after dismiss animation, before reset.
• OriginItem.perspective field with fallback chain: runEffect param → item → 0.
• OriginRect.copyWith method.
• Gesture builder on OriginGesture applied in overlay outside ClipRRect.
• runEffect with individual params, back-and-forth animation.
• Effect transform uses Matrix4? with null check.
• Removed OriginEffect class.

0.1.0

• Custom gesture recognizer for arena control.
• GlobalKey state preservation across overlay.
• Vertical shrink dismiss, multi-finger zoom.
• Early gesture acceptance, reduced slop.

0.0.3

• Add stackBuilder for showing builder on top of child.

0.0.2

• Add tag, visibility, dismiss, animateToBase.
• InheritedModel with aspect-based rebuilds.
• ClipRRect and borderRadius animation on items.
• Safe controller resets.

0.0.1

• Initial release.