@flemo/core 2.2.1 → 2.3.0

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

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

package/dist/core/engine/__tests__/createTransitionEngine.cameraSpan.test.d.ts

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

package/dist/dom/attributes.d.ts

@@ -49,6 +49,21 @@ export declare const BAR_SPACER_ATTR = "data-flemo-bar-spacer";
 export declare const DECORATOR_ATTR = "data-flemo-decorator";
 /** The decorator definition's name, for its own compiled rules. */
 export declare const DECORATOR_NAME_ATTR = "data-flemo-decorator-name";
+/**
+ * The screen a decorator belongs to, on every copy of it.
+ *
+ * A decorator is not one element. A screen with a `<Layer>` slot renders its
+ * dim TWICE — once in its own container, once portalled into the layer host so
+ * the dim also covers what the overlay carried out of the screen — and the
+ * copy is the one that paints on top. Everything that has to reach "this
+ * screen's dim" was reaching the in-container one by a ref or an own-child
+ * query, so the copy, which is what the eye is on, was reached by nothing: a
+ * swipe drove the original under it while the visible one stood still.
+ *
+ * The id is the screen's, so a lookup names the OWNER rather than a position,
+ * and finds however many copies that owner rendered.
+ */
+export declare const DECORATOR_OWNER_ATTR = "data-flemo-decorator-owner";
 /**
  * The HOST: one childless box per screen chain, rendered by the OUTERMOST
  * screen's container and inherited by every screen nested inside it. Outermost
@@ -148,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
@@ -289,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-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/dom/staging.d.ts

@@ -22,4 +22,13 @@ export interface PreserveAnimationsOptions {
  * Runs `move` — the re-parent — and carries the subtree's animation clocks
  * across it.
  */
-export declare function preserveAnimations(root: Element, move: () => void, options?: PreserveAnimationsOptions): void;
+/**
+ * Move an element without restarting the animations inside it.
+ *
+ * Returns HOW MANY it had to carry, because asking is the expensive half: each
+ * `getAnimations({ subtree: true })` forces a style recalculation, and a flight
+ * lands with every one of its participants asking twice in the same frame.
+ * Measured on the reference grid, that frame ran 75ms. A caller that already
+ * knows the answer is zero can skip the question entirely.
+ */
+export declare function preserveAnimations(root: Element, move: () => void, options?: PreserveAnimationsOptions): number;

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';
@@ -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';