@flemo/core 2.2.2 → 2.3.1

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.releaseTravel.test.d.ts

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

package/dist/dom/attributes.d.ts

@@ -163,6 +163,22 @@ export declare const MORPH_ROLE: {
  * different morph choreography per element. Absent means the default preset.
  */
 export declare const MORPH_NAME_ATTR = "data-flemo-morph-name";
+/**
+ * The PAIRING KEY (`layoutId`), written out so the pairing is observable.
+ *
+ * The runtime keeps the key in its own registry and never needed it in the DOM,
+ * which made the single most common morph failure — two ends that never paired
+ * — invisible to everything outside the runtime: the element simply does not
+ * fly, and nothing on the page says why. Four separate investigations began by
+ * rebuilding a private tracer to answer "did these two find each other".
+ *
+ * With the key on the element, an inspector (and `@flemo/devtools`) can group
+ * the ends itself and report a pairable set that never flew. Written once and
+ * only when it changes — a morph is re-registered on every status change, and
+ * an attribute write invalidates that element's style (see the ownership note
+ * in attachMorph, where two such writes were device-measured as judder).
+ */
+export declare const MORPH_ID_ATTR = "data-flemo-morph-id";
 /**
  * The per-Router FLIGHT LAYER: the box a shared element is staged in while it
  * travels. Rendered by the binding (a Router knows which box bounds its
@@ -304,4 +320,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-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-warm", "data-flemo-gpu-prewarm", "data-flemo-image-src", "data-flemo-devtools-panel"];

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { default as TaskManger, default as TaskManager } from './core/TaskManger';
+export { default as TaskManger, default as TaskManager } from './core/TaskManager';
 export { default as createHistoryStore, type History, type HistoryStore, type HistoryStoreApi } from './history/store';
 export { default as seedInitialHistory } from './history/seedInitialHistory';
 export { default as ensureWindowHistoryState } from './history/ensureWindowHistoryState';
@@ -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';
@@ -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_LAYER_ATTR, MORPH_NAME_ATTR, MORPH_ROLE, MORPH_SLOT_ATTR, MORPH_SHEET_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, WARM_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';