@flemo/core 2.3.1 → 2.5.0

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/dom/attributes.d.ts

@@ -293,12 +293,6 @@ export declare const DESK_HEAD_ATTR = "data-flemo-desk-head";
  * the old off-screen head rather than showing a ghost.
  */
 export declare const PARK_HEAD_ATTR = "data-flemo-park-head";
-/**
- * The compositor warm-up element. Its VALUE says whether the warm-up is
- * currently forcing frames (`"on"`) or resident but idle (`"idle"`) — the
- * element outlives every hold, so its presence alone no longer answers that.
- */
-export declare const WARM_ATTR = "data-flemo-warm";
 /** The one-shot GPU pipeline prewarm element. */
 export declare const GPU_PREWARM_ATTR = "data-flemo-gpu-prewarm";
 /**
@@ -320,4 +314,4 @@ export declare const attrValueSelector: (attribute: string, value: string) => st
  * a devtools build can assert against the shipped set instead of a hand-kept
  * copy — the drift this module exists to end.
  */
-export declare const FLEMO_ATTRIBUTES: readonly ["data-flemo-screen", "data-flemo-status", "data-flemo-active", "data-flemo-transition", "data-flemo-router", "data-flemo-skip-animation", "data-flemo-bar", "data-flemo-bar-active", "data-flemo-bar-status", "data-flemo-bar-riding", "data-flemo-bar-id", "data-flemo-bar-id-type", "data-flemo-bar-transition", "data-flemo-bar-spacer", "data-flemo-decorator", "data-flemo-decorator-name", "data-flemo-decorator-owner", "data-flemo-layer-host", "data-flemo-layer-owner", "data-flemo-layer-slot", "data-flemo-part-name", "data-flemo-part-layer", "data-flemo-part-home", "data-flemo-part-stand-in", "data-flemo-morph", "data-flemo-morph-camera", "data-flemo-morph-ghost", "data-flemo-morph-id", "data-flemo-morph-layer", "data-flemo-morph-name", "data-flemo-morph-slot", "data-flemo-morph-stand-in", "data-flemo-morph-sheet", "data-flemo-anim-hold", "data-flemo-held-arrival", "data-flemo-img-hold", "data-flemo-governed", "data-flemo-creep", "data-flemo-desk-head", "data-flemo-park-head", "data-flemo-warm", "data-flemo-gpu-prewarm", "data-flemo-image-src", "data-flemo-devtools-panel"];
+export declare const FLEMO_ATTRIBUTES: readonly ["data-flemo-screen", "data-flemo-status", "data-flemo-active", "data-flemo-transition", "data-flemo-router", "data-flemo-skip-animation", "data-flemo-bar", "data-flemo-bar-active", "data-flemo-bar-status", "data-flemo-bar-riding", "data-flemo-bar-id", "data-flemo-bar-id-type", "data-flemo-bar-transition", "data-flemo-bar-spacer", "data-flemo-decorator", "data-flemo-decorator-name", "data-flemo-decorator-owner", "data-flemo-layer-host", "data-flemo-layer-owner", "data-flemo-layer-slot", "data-flemo-part-name", "data-flemo-part-layer", "data-flemo-part-home", "data-flemo-part-stand-in", "data-flemo-morph", "data-flemo-morph-camera", "data-flemo-morph-ghost", "data-flemo-morph-id", "data-flemo-morph-layer", "data-flemo-morph-name", "data-flemo-morph-slot", "data-flemo-morph-stand-in", "data-flemo-morph-sheet", "data-flemo-anim-hold", "data-flemo-held-arrival", "data-flemo-img-hold", "data-flemo-governed", "data-flemo-creep", "data-flemo-desk-head", "data-flemo-park-head", "data-flemo-gpu-prewarm", "data-flemo-image-src", "data-flemo-devtools-panel"];

package/dist/index.d.ts

@@ -51,7 +51,7 @@ export { default as createTransitionEngine } from './core/engine/createTransitio
 export { governedCompiledActive } from './platform/governedCompiled';
 export { startFlemoRuntime } from './runtime/flemoRuntime';
 export { resolvePlatformProfile, type PlatformProfile, type PlatformProfileInput } from './platform/profile';
-export { FLEMO_ATTR_PREFIX, FLEMO_ATTRIBUTES, attrSelector, attrValueSelector, ANIM_HOLD, ANIM_HOLD_ATTR, ANIM_HOLD_PAUSED_VALUES, ACTIVE_ATTR, BAR_ACTIVE_ATTR, BAR_ATTR, BAR_ID_ATTR, BAR_ID_TYPE_ATTR, BAR_RIDING_ATTR, BAR_SPACER_ATTR, BAR_STATUS_ATTR, BAR_TRANSITION_ATTR, CREEP_ATTR, DECORATOR_ATTR, DECORATOR_NAME_ATTR, DESK_HEAD_ATTR, DEVTOOLS_PANEL_ATTR, GOVERNED_ATTR, GPU_PREWARM_ATTR, HELD_ARRIVAL_ATTR, IMAGE_HOLD_ATTR, LAYER_HOST_ATTR, LAYER_OWNER_ATTR, LAYER_SLOT_ATTR, MORPH_ATTR, MORPH_CAMERA_ATTR, MORPH_GHOST_ATTR, MORPH_ID_ATTR, MORPH_LAYER_ATTR, MORPH_NAME_ATTR, MORPH_ROLE, MORPH_SLOT_ATTR, MORPH_SHEET_ATTR, MORPH_STAND_IN_ATTR, PARK_HEAD_ATTR, PART_HOME_ATTR, PART_LAYER_ATTR, PART_NAME_ATTR, ROUTER_ATTR, SCREEN_ATTR, STATUS_ATTR, TRANSITION_ATTR, WARM_ATTR } from './dom/attributes';
+export { FLEMO_ATTR_PREFIX, FLEMO_ATTRIBUTES, attrSelector, attrValueSelector, ANIM_HOLD, ANIM_HOLD_ATTR, ANIM_HOLD_PAUSED_VALUES, ACTIVE_ATTR, BAR_ACTIVE_ATTR, BAR_ATTR, BAR_ID_ATTR, BAR_ID_TYPE_ATTR, BAR_RIDING_ATTR, BAR_SPACER_ATTR, BAR_STATUS_ATTR, BAR_TRANSITION_ATTR, CREEP_ATTR, DECORATOR_ATTR, DECORATOR_NAME_ATTR, DESK_HEAD_ATTR, DEVTOOLS_PANEL_ATTR, GOVERNED_ATTR, GPU_PREWARM_ATTR, HELD_ARRIVAL_ATTR, IMAGE_HOLD_ATTR, LAYER_HOST_ATTR, LAYER_OWNER_ATTR, LAYER_SLOT_ATTR, MORPH_ATTR, MORPH_CAMERA_ATTR, MORPH_GHOST_ATTR, MORPH_ID_ATTR, MORPH_LAYER_ATTR, MORPH_NAME_ATTR, MORPH_ROLE, MORPH_SLOT_ATTR, MORPH_SHEET_ATTR, MORPH_STAND_IN_ATTR, PARK_HEAD_ATTR, PART_HOME_ATTR, PART_LAYER_ATTR, PART_NAME_ATTR, ROUTER_ATTR, SCREEN_ATTR, STATUS_ATTR, TRANSITION_ATTR } from './dom/attributes';
 export { OVERLAY_LEVEL, SCREEN_STACKING_ORDER, UNNUMBERED_LEVEL } from './dom/stacking';
 export { TRANSITIONAL_STATUS_VALUES } from './navigate/store';
 export { SKIP_ANIMATION_ATTR, type TransitionEngine, type TransitionEngineDeps, type ScreenLifecycleInput } from './core/engine/types';
@@ -61,12 +61,13 @@ 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';
 export { percentRatio, resolveRideTarget, rideLength, RIDE_HEIGHT_VAR } from './transition/rideOffset';
 export { default as observeViewportScrollHeight } from './screen/observeViewportScrollHeight';
-export { default as holdCompositorWarm } from './core/engine/compositorWarmUp';
 export { default as ensureGpuPipelinePrewarm } from './core/engine/gpuPipelinePrewarm';
 export { default as ensureImageDecodeOffloader, createImageDecodeOffloader, shouldOffloadImage, OVERSIZE_AREA_RATIO, OFFLOADED_SRC_ATTR, type OversizeInput } from './core/engine/imageDecodeOffloader';
 export type { RegisterTransition, TransitionName, TransitionVariant, TransitionVariantValue, TransitionOptions, BaseTransition, Transition, SwipeInfo, SwipeAnimate } from './transition/typing';