@flemo/core 2.3.0 → 2.4.0

package/dist/core/__tests__/adoptEntryIdentity.test.d.ts

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

package/dist/core/createRouterScope.d.ts

@@ -31,7 +31,29 @@ export interface CreateRouterScopeInput {
     browserDriver: HistoryDriver | null;
     hostedScope: FlemoStores | null;
     persistKey?: string;
+    deferEntryAdoption?: boolean;
     routerKey?: string;
     zoneEntryId?: string;
 }
 export default function createRouterScope(input: CreateRouterScopeInput): FlemoStores;
+/**
+ * Adopt the identity of the browser entry this scope was seeded on, after the
+ * fact — the deferred half of `deferEntryAdoption`.
+ *
+ * A binding that hydrates calls this once hydration is over, and the store's
+ * root frame stops being the generic "root" and becomes the entry it is
+ * actually sitting on. That matters for exactly the reason the construction
+ * path adopts at all: a traversal back onto this entry has to match it by id
+ * rather than collide with every other scope's "root".
+ *
+ * Every guard below is a refusal to overwrite something real:
+ *
+ *   - a scope that already navigated has a stack this is not the seed of, and
+ *     rewriting its first frame's id would rename an entry the user has since
+ *     left,
+ *   - a seed that is no longer "root" was adopted already (a re-run, a strict
+ *     mode double effect),
+ *   - a memory scope has no browser entry to adopt, and
+ *   - an entry with no frame of its own has no identity to take.
+ */
+export declare function adoptEntryIdentity(scope: FlemoStores): void;

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

@@ -10,7 +10,7 @@ export { default as createNavigateStore, type NavigateStatus, type NavigateStore
 export { markSelfInducedPop, consumeSelfInducedPop, createSelfPopGuard, type SelfPopGuard } from './navigate/selfPopGuard';
 export { default as createNavigationController, type NavigationControllerDeps, type DistanceOptions, type NavigateOptions, type PopOptions } from './navigate/createNavigationController';
 export { default as createStepController, readStepParams, appendParamsQuery, subscribeStepParamsRestore, type StepControllerDeps } from './navigate/createStepController';
-export { default as createRouterScope, type FlemoStores, type CreateRouterScopeInput } from './core/createRouterScope';
+export { default as createRouterScope, adoptEntryIdentity, type FlemoStores, type CreateRouterScopeInput } from './core/createRouterScope';
 export { default as createScreenStore, type ScreenStore, type ScreenStoreApi, type SharedBarPresence, type SharedBarId, type SharedBarMetadata, type SharedBarsMetadata, type ScreenSurface } from './screen/store';
 export { default as createScreenSelector, type ScreenSelection } from './screen/createScreenSelector';
 export { default as computeScreenFreeze, computeScreenFreezeMode, type ScreenFreezeInput, type ScreenFreezeMode } from './screen/computeScreenFreeze';
@@ -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';