@flemo/core 2.3.1 → 2.4.0

package/dist/core/engine/__tests__/createSwipeController.declaredSwipe.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/createSwipeController.decoratorReplacement.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/riderSwipe.d.ts

@@ -2,6 +2,18 @@ import { VariantMotion } from '../../transition/variantMotion';
 export interface RiderSwipe {
     /** Whether anything is actually being driven. */
     readonly active: boolean;
+    /**
+     * Whether any element this staged has left the document.
+     *
+     * A gesture stages against the elements that exist when it begins, and a
+     * drag's own wake can REPLACE one of them a frame later — a covered screen's
+     * dim moves between its container and the layer host as that screen's
+     * `<Layer>` slots unmount and re-mount (see resolvePrevDecorator in
+     * createSwipeController). The animations stay on the node that left, so the
+     * one on screen never moves. Reported for the hook-driven dim; the same wake
+     * reaches a pose-only one, which is what this is for.
+     */
+    readonly stale: boolean;
     /** Move every rider to this fraction of its travel (0 → 1). */
     scrub: (progress: number) => void;
     /**
@@ -12,8 +24,14 @@ export interface RiderSwipe {
      * pose — the contract the swipe already applies to the screen and the dim.
      * Otherwise they run backwards and the compiled rest rule takes them over
      * again.
+     *
+     * RESOLVES WHEN THE LANDING HAS LANDED. A caller that commits a navigation
+     * off the back of a release has to wait for it: the screens are staged
+     * animations now, so committing while they still play removes the screen
+     * mid-flight and it vanishes rather than leaving. Device-reported the first
+     * time the declarative path shipped without this.
      */
-    settle: (commit: boolean, seconds: number) => void;
+    settle: (commit: boolean, seconds: number) => Promise<void>;
 }
 export interface RiderMotion {
     readonly element: HTMLElement;
@@ -24,5 +42,13 @@ export interface RiderMotion {
  * nothing to drive, so a gesture over chrome that declares no motion costs
  * nothing.
  */
-export declare const beginRiderSwipe: (riders: readonly RiderMotion[]) => RiderSwipe | null;
+export declare const beginRiderSwipe: (riders: readonly RiderMotion[], options?: {
+    /**
+     * The writer staking the landed pose this hands back (see the note in
+     * `settle`). A caller whose own cleanup is owner-scoped — the swipe's
+     * riding bars are — has to be the one on the lease, or its clear will not
+     * release what was written here.
+     */
+    writer?: symbol;
+}) => RiderSwipe | null;
 export default beginRiderSwipe;

package/dist/index.d.ts

@@ -61,6 +61,8 @@ export { default as computeBarRiding, sharedBarsMatch, type BarRidingInput } fro
 export { animHoldKey, scheduleAnimHoldRelease, createAnimHoldCoordinator, eagerlyDecodeImages, ANIM_HOLD_RELEASE_BACKSTOP_MS, type AnimHoldInput, type AnimHoldCoordinator } from './screen/animStartAnchor';
 export { detectBlinkEngine, isDesktopBlink, isLegacyAndroidBlink } from './platform/engineProbes';
 export { steadySixtyDesktopProfile } from './platform/steadySixtyCadence';
+export { resolveSwipeOptions, DEFAULT_COMMIT_FRACTION, DEFAULT_COMMIT_VELOCITY, type ResolvedSwipe } from './transition/resolveSwipeOptions';
+export type { SwipeOptions, SwipeStop } from './transition/typing';
 export { swipeSettleSeconds, MIN_SETTLE_SECONDS, type SwipeSettleInput } from './transition/swipeSettle';
 export { default as observeBarHeight } from './screen/observeBarHeight';
 export { default as publishRideBox } from './screen/publishRideBox';