framer-motion 12.40.0 → 12.41.0

package/dist/framer-motion.dev.js

@@ -158,7 +158,7 @@
     }
 
     /*#__NO_SIDE_EFFECTS__*/
-    const noop$1 = (any) => any;
+    const noop = (any) => any;
 
     /**
      * Pipe
@@ -295,7 +295,7 @@
     function cubicBezier(mX1, mY1, mX2, mY2) {
         // If this is a linear gradient, return linear easing
         if (mX1 === mY1 && mX2 === mY2)
-            return noop$1;
+            return noop;
         const getTForX = (aX) => binarySubdivide(aX, 0, 1, mX1, mX2);
         // If animation is at start/end, return t without easing
         return (t) => t === 0 || t === 1 ? t : calcBezier(getTForX(t), mY1, mY2);
@@ -356,7 +356,7 @@
     const isBezierDefinition = (easing) => Array.isArray(easing) && typeof easing[0] === "number";
 
     const easingLookup = {
-        linear: noop$1,
+        linear: noop,
         easeIn,
         easeInOut,
         easeOut,
@@ -397,12 +397,7 @@
         "postRender", // Compute
     ];
 
-    const statsBuffer = {
-        value: null,
-        addProjectionMetrics: null,
-    };
-
-    function createRenderStep(runNextFrame, stepName) {
+    function createRenderStep(runNextFrame) {
         /**
          * We create and reuse two queues, one to queue jobs for the current frame
          * and one for the next. We reuse to avoid triggering GC after x frames.
@@ -424,13 +419,11 @@
             timestamp: 0.0,
             isProcessing: false,
         };
-        let numCalls = 0;
         function triggerCallback(callback) {
             if (toKeepAlive.has(callback)) {
                 step.schedule(callback);
                 runNextFrame();
             }
-            numCalls++;
             callback(latestFrameData);
         }
         const step = {
@@ -473,13 +466,6 @@
                 nextFrame = prevFrame;
                 // Execute this frame
                 thisFrame.forEach(triggerCallback);
-                /**
-                 * If we're recording stats then
-                 */
-                if (stepName && statsBuffer.value) {
-                    statsBuffer.value.frameloop[stepName].push(numCalls);
-                }
-                numCalls = 0;
                 // Clear the frame so no callbacks remain. This is to avoid
                 // memory leaks should this render step not run for a while.
                 thisFrame.clear();
@@ -504,7 +490,7 @@
         };
         const flagRunNextFrame = () => (runNextFrame = true);
         const steps = stepsOrder.reduce((acc, key) => {
-            acc[key] = createRenderStep(flagRunNextFrame, allowKeepAlive ? key : undefined);
+            acc[key] = createRenderStep(flagRunNextFrame);
             return acc;
         }, {});
         const { setup, read, resolveKeyframes, preUpdate, update, preRender, render, postRender, } = steps;
@@ -560,7 +546,7 @@
         return { schedule, cancel, state, steps };
     }
 
-    const { schedule: frame, cancel: cancelFrame, state: frameData, steps: frameSteps, } = /* @__PURE__ */ createRenderBatcher(typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : noop$1, true);
+    const { schedule: frame, cancel: cancelFrame, state: frameData, steps: frameSteps, } = /* @__PURE__ */ createRenderBatcher(typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : noop, true);
 
     let now;
     function clearTime() {
@@ -589,12 +575,6 @@
         },
     };
 
-    const activeAnimations = {
-        layout: 0,
-        mainThread: 0,
-        waapi: 0,
-    };
-
     const checkStringStartsWith = (token) => (key) => typeof key === "string" && key.startsWith(token);
     const isCSSVariableName = 
     /*@__PURE__*/ checkStringStartsWith("--");
@@ -1582,7 +1562,7 @@
         for (let i = 0; i < numMixers; i++) {
             let mixer = mixerFactory(output[i], output[i + 1]);
             if (ease) {
-                const easingFunction = Array.isArray(ease) ? ease[i] || noop$1 : ease;
+                const easingFunction = Array.isArray(ease) ? ease[i] || noop : ease;
                 mixer = pipe(easingFunction, mixer);
             }
             mixers.push(mixer);
@@ -1796,7 +1776,6 @@
                 this.teardown();
                 this.options.onStop?.();
             };
-            activeAnimations.mainThread++;
             this.options = options;
             this.initAnimation();
             this.play();
@@ -2101,7 +2080,6 @@
             this.state = "idle";
             this.stopDriver();
             this.startTime = this.holdTime = null;
-            activeAnimations.mainThread--;
         }
         stopDriver() {
             if (!this.driver)
@@ -2513,9 +2491,6 @@
          */
         if (Array.isArray(easing))
             keyframeOptions.easing = easing;
-        if (statsBuffer.value) {
-            activeAnimations.waapi++;
-        }
         const options = {
             delay,
             duration,
@@ -2526,13 +2501,7 @@
         };
         if (pseudoElement)
             options.pseudoElement = pseudoElement;
-        const animation = element.animate(keyframeOptions, options);
-        if (statsBuffer.value) {
-            animation.finished.finally(() => {
-                activeAnimations.waapi--;
-            });
-        }
-        return animation;
+        return element.animate(keyframeOptions, options);
     }
 
     function isGenerator(type) {
@@ -2711,7 +2680,7 @@
                     this.animation.rangeStart = rangeStart;
                 if (rangeEnd)
                     this.animation.rangeEnd = rangeEnd;
-                return noop$1;
+                return noop;
             }
             else {
                 return observe(this);
@@ -3064,7 +3033,7 @@
             }
             animation.finished.then(() => {
                 this.notifyFinished();
-            }).catch(noop$1);
+            }).catch(noop);
             if (this.pendingTimeline) {
                 this.stopTimeline = animation.attachTimeline(this.pendingTimeline);
                 this.pendingTimeline = undefined;
@@ -5242,9 +5211,16 @@
                 claimedPointerDownEvents.add(startEvent);
             }
             const onPressEnd = onPressStart(target, startEvent);
+            /**
+             * End listeners run in the capture phase so a descendant calling
+             * stopPropagation() in its own pointerup handler can't prevent the
+             * press gesture from ending. This also keeps the gesture-end
+             * ordering consistent with the drag gesture. See #2794.
+             */
+            const endEventOptions = { ...eventOptions, capture: true };
             const onPointerEnd = (endEvent, success) => {
-                window.removeEventListener("pointerup", onPointerUp);
-                window.removeEventListener("pointercancel", onPointerCancel);
+                window.removeEventListener("pointerup", onPointerUp, endEventOptions);
+                window.removeEventListener("pointercancel", onPointerCancel, endEventOptions);
                 if (isPressing.has(target)) {
                     isPressing.delete(target);
                 }
@@ -5264,8 +5240,8 @@
             const onPointerCancel = (cancelEvent) => {
                 onPointerEnd(cancelEvent, false);
             };
-            window.addEventListener("pointerup", onPointerUp, eventOptions);
-            window.addEventListener("pointercancel", onPointerCancel, eventOptions);
+            window.addEventListener("pointerup", onPointerUp, endEventOptions);
+            window.addEventListener("pointercancel", onPointerCancel, endEventOptions);
         };
         targets.forEach((target) => {
             const pointerDownTarget = options.useGlobalTarget ? window : target;
@@ -5404,116 +5380,34 @@
         return () => cancelFrame(onFrame);
     }
 
-    function record() {
-        const { value } = statsBuffer;
-        if (value === null) {
-            cancelFrame(record);
-            return;
-        }
-        value.frameloop.rate.push(frameData.delta);
-        value.animations.mainThread.push(activeAnimations.mainThread);
-        value.animations.waapi.push(activeAnimations.waapi);
-        value.animations.layout.push(activeAnimations.layout);
-    }
-    function mean(values) {
-        return values.reduce((acc, value) => acc + value, 0) / values.length;
-    }
-    function summarise(values, calcAverage = mean) {
-        if (values.length === 0) {
-            return {
-                min: 0,
-                max: 0,
-                avg: 0,
-            };
-        }
-        return {
-            min: Math.min(...values),
-            max: Math.max(...values),
-            avg: calcAverage(values),
-        };
-    }
-    const msToFps = (ms) => Math.round(1000 / ms);
+    const statsBuffer = {
+        value: null,
+        addProjectionMetrics: null,
+    };
+
     function clearStatsBuffer() {
         statsBuffer.value = null;
         statsBuffer.addProjectionMetrics = null;
     }
-    function reportStats() {
-        const { value } = statsBuffer;
-        if (!value) {
-            throw new Error("Stats are not being measured");
-        }
-        clearStatsBuffer();
-        cancelFrame(record);
-        const summary = {
-            frameloop: {
-                setup: summarise(value.frameloop.setup),
-                rate: summarise(value.frameloop.rate),
-                read: summarise(value.frameloop.read),
-                resolveKeyframes: summarise(value.frameloop.resolveKeyframes),
-                preUpdate: summarise(value.frameloop.preUpdate),
-                update: summarise(value.frameloop.update),
-                preRender: summarise(value.frameloop.preRender),
-                render: summarise(value.frameloop.render),
-                postRender: summarise(value.frameloop.postRender),
-            },
-            animations: {
-                mainThread: summarise(value.animations.mainThread),
-                waapi: summarise(value.animations.waapi),
-                layout: summarise(value.animations.layout),
-            },
-            layoutProjection: {
-                nodes: summarise(value.layoutProjection.nodes),
-                calculatedTargetDeltas: summarise(value.layoutProjection.calculatedTargetDeltas),
-                calculatedProjections: summarise(value.layoutProjection.calculatedProjections),
-            },
-        };
-        /**
-         * Convert the rate to FPS
-         */
-        const { rate } = summary.frameloop;
-        rate.min = msToFps(rate.min);
-        rate.max = msToFps(rate.max);
-        rate.avg = msToFps(rate.avg);
-        [rate.min, rate.max] = [rate.max, rate.min];
-        return summary;
-    }
     function recordStats() {
         if (statsBuffer.value) {
             clearStatsBuffer();
             throw new Error("Stats are already being measured");
         }
-        const newStatsBuffer = statsBuffer;
-        newStatsBuffer.value = {
-            frameloop: {
-                setup: [],
-                rate: [],
-                read: [],
-                resolveKeyframes: [],
-                preUpdate: [],
-                update: [],
-                preRender: [],
-                render: [],
-                postRender: [],
-            },
-            animations: {
-                mainThread: [],
-                waapi: [],
-                layout: [],
-            },
+        const buffer = statsBuffer;
+        buffer.value = {
             layoutProjection: {
                 nodes: [],
                 calculatedTargetDeltas: [],
                 calculatedProjections: [],
             },
         };
-        newStatsBuffer.addProjectionMetrics = (metrics) => {
-            const { layoutProjection } = newStatsBuffer.value;
+        buffer.addProjectionMetrics = (metrics) => {
+            const { layoutProjection } = buffer.value;
             layoutProjection.nodes.push(metrics.nodes);
             layoutProjection.calculatedTargetDeltas.push(metrics.calculatedTargetDeltas);
             layoutProjection.calculatedProjections.push(metrics.calculatedProjections);
         };
-        frame.postRender(record, true);
-        return reportStats;
     }
 
     /**
@@ -5799,14 +5693,126 @@
      */
     const findValueType = (v) => valueTypes.find(testValueType(v));
 
+    let nameCount = 0;
+    /**
+     * Generated names live in their own namespace so we can tell a name we own
+     * (and must clean up) from an author-defined one - and so a stale generated
+     * name left behind by an interrupted transition is re-owned, not mistaken for
+     * the author's and leaked.
+     */
+    const generatedName = () => `motion-view-${nameCount++}`;
+    const isGeneratedName = (name) => name.startsWith("motion-view-");
+    /**
+     * Tag a captured element with a `view-transition-class` so authors can target
+     * its generated layer from CSS (e.g. `::view-transition-group(.hero)`) without
+     * the opaque generated name. Tracked in `classed` - separate from the generated
+     * names in `assigned` - so cleanup removes the class without ever stripping an
+     * author's own inline `view-transition-name`.
+     */
+    function tagClass(element, className, classed) {
+        if (!className)
+            return;
+        element.style?.setProperty("view-transition-class", className);
+        classed.push(element);
+    }
+    /**
+     * Resolve a selector/Element to elements and ensure each one carries a
+     * `view-transition-name` we can target from script.
+     *
+     * Author-defined names are reused as-is. Elements that are unnamed (or use
+     * the browser's `auto`/`match-element`, whose generated name is not exposed
+     * to script) are given a unique generated name, set inline so it's captured,
+     * and tracked in `assigned` for later cleanup.
+     *
+     * `registry` maps each Element to its name so the same element keeps its name
+     * across both captures (before and after the update), which is what allows a
+     * persistent element to animate as a single `group` layer.
+     */
+    function assignViewTransitionNames(definition, registry, assigned, forcedNames, className, classed = []) {
+        const elements = resolveElements(definition);
+        /**
+         * The new end of a paired morph: give each element the matching name from
+         * the old end (by index) so the two share one layer and morph. If the new
+         * end resolves to *more* elements than the old end named, the extras have no
+         * counterpart - give them a fresh name so they animate as newcomers rather
+         * than being silently left unnamed. We return the names actually assigned
+         * (sized to the resolved elements), not the raw `forcedNames`, so stagger
+         * totals and the layer set stay in step with what's on the page.
+         */
+        if (forcedNames) {
+            return elements.map((element, i) => {
+                const existing = registry.get(element);
+                if (existing)
+                    return existing;
+                const name = forcedNames[i] ?? generatedName();
+                element.style?.setProperty("view-transition-name", name);
+                assigned.push(element);
+                registry.set(element, name);
+                tagClass(element, className, classed);
+                return name;
+            });
+        }
+        /**
+         * Read every current name up front, before assigning any. Interleaving the
+         * reads with the inline `setProperty` writes below would dirty styles
+         * between reads and force a style recalc per element; batching the reads
+         * keeps it to one. Elements already in the registry keep their name and
+         * need no read.
+         */
+        const currentNames = elements.map((element) => registry.has(element)
+            ? undefined
+            : getComputedStyle(element).getPropertyValue("view-transition-name"));
+        return elements.map((element, i) => {
+            const existing = registry.get(element);
+            if (existing)
+                return existing;
+            const current = currentNames[i];
+            let name;
+            if (current &&
+                current !== "none" &&
+                current !== "auto" &&
+                current !== "match-element" &&
+                !isGeneratedName(current)) {
+                /**
+                 * The author already named this layer - target it as-is and leave
+                 * it to them to clean up. `auto`/`match-element` are overridden
+                 * because their generated name is not exposed to script, and a
+                 * stale `motion-view-*` (e.g. left by an interrupted transition) is
+                 * re-owned rather than adopted as an author name and leaked.
+                 */
+                name = current;
+            }
+            else {
+                name = generatedName();
+                element.style?.setProperty("view-transition-name", name);
+                assigned.push(element);
+            }
+            registry.set(element, name);
+            tagClass(element, className, classed);
+            return name;
+        });
+    }
+    /**
+     * Remove the `view-transition-name`s we generated and the
+     * `view-transition-class`es we applied. Author-defined names are never touched
+     * (they're not in `assigned`). Safe to call more than once (e.g. on both a
+     * finished and an interrupted transition).
+     */
+    function releaseViewTransitionNames(assigned, classed = []) {
+        for (const element of assigned) {
+            element.style?.removeProperty("view-transition-name");
+        }
+        for (const element of classed) {
+            element.style?.removeProperty("view-transition-class");
+        }
+    }
+
     function chooseLayerType(valueName) {
         if (valueName === "layout")
             return "group";
         if (valueName === "enter" || valueName === "new")
             return "new";
-        if (valueName === "exit" || valueName === "old")
-            return "old";
-        return "group";
+        return "old";
     }
 
     let pendingRules = {};
@@ -5841,21 +5847,21 @@
     };
 
     function getViewAnimationLayerInfo(pseudoElement) {
-        const match = pseudoElement.match(/::view-transition-(old|new|group|image-pair)\((.*?)\)/);
+        const match = pseudoElement.match(
+        // `group-children` (nested transitions) before `group` so it wins.
+        /::view-transition-(old|new|group-children|group|image-pair)\((.*?)\)/);
         if (!match)
             return null;
         return { layer: match[2], type: match[1] };
     }
 
-    function filterViewAnimations(animation) {
-        const { effect } = animation;
-        if (!effect)
-            return false;
-        return (effect.target === document.documentElement &&
-            effect.pseudoElement?.startsWith("::view-transition"));
-    }
     function getViewAnimations() {
-        return document.getAnimations().filter(filterViewAnimations);
+        return document.getAnimations().filter((animation) => {
+            const { effect } = animation;
+            return (!!effect &&
+                effect.target === document.documentElement &&
+                effect.pseudoElement?.startsWith("::view-transition"));
+        });
     }
 
     function hasTarget(target, targets) {
@@ -5863,87 +5869,370 @@
     }
 
     const definitionNames = ["layout", "enter", "exit", "new", "old"];
+    /**
+     * The `ViewTransitionTarget` buckets driving each generated layer type, in
+     * priority order - the inverse of `chooseLayerType`. The new view is driven by
+     * `new`/`enter`, the old by `old`/`exit`. `group-children`/`image-pair` have no
+     * bucket; they follow the default layout timing.
+     */
+    const typeBuckets = {
+        group: ["layout"],
+        new: ["new", "enter"],
+        old: ["old", "exit"],
+    };
+    /**
+     * Default "absent" origin for a single-value keyframe, by pseudo type, so e.g.
+     * `enter({ scale: 1 })` grows in from 0.85 and `exit({ opacity: 0 })` fades
+     * from 1. `enter` prefers the matching `exit` value over these (see below).
+     */
+    const ORIGIN_DEFAULTS = {
+        new: { opacity: 0, scale: 0.85 },
+        old: { opacity: 1, scale: 1 },
+    };
+    const cornerProps = [
+        "borderTopLeftRadius",
+        "borderTopRightRadius",
+        "borderBottomRightRadius",
+        "borderBottomLeftRadius",
+    ];
     function startViewAnimation(builder) {
-        const { update, targets, options: defaultOptions } = builder;
+        const { update, targets, resolveDefs, noCrop, pairs, classNames, options: defaultOptions, } = builder;
         if (!document.startViewTransition) {
-            return new Promise(async (resolve) => {
+            // An async IIFE (not `new Promise(async …)`) so a throwing/rejecting
+            // update rejects this promise rather than leaving it unsettled.
+            return (async () => {
                 await update();
-                resolve(new GroupAnimation([]));
-            });
+                return new GroupAnimation([]);
+            })();
         }
-        // TODO: Go over existing targets and ensure they all have ids
         /**
-         * If we don't have any animations defined for the root target,
-         * remove it from being captured.
+         * Resolve any selector/Element targets to layer names, assigning a
+         * `view-transition-name` to each element as we go. We run this before the
+         * update (so the elements are captured in the old snapshot) and again
+         * after it (for the new snapshot). An element present in both keeps the
+         * same name and animates as a single `group` layer.
+         */
+        const nameRegistry = new Map();
+        const assigned = [];
+        /**
+         * Elements we tagged with a `view-transition-class` (via `.class()`),
+         * tracked separately from `assigned` so cleanup removes the class without
+         * ever stripping an author's own inline `view-transition-name`.
+         */
+        const classed = [];
+        const layerTargets = new Map();
+        const croppedNames = new Set();
+        /**
+         * Each layer's stagger position (index + total) within its subject, per
+         * snapshot. Resolving against the snapshot the layer belongs to keeps
+         * stagger correct when `update()` replaces the matched elements, and lets
+         * us skip a layer that's absent from a snapshot (e.g. an exited element
+         * has no `new` pseudo-element).
          */
-        if (!hasTarget("root", targets)) {
-            css.set(":root", {
-                "view-transition-name": "none",
+        const layerStagger = new Map();
+        /**
+         * Names allocated for a paired subject in the old snapshot, replayed onto
+         * its new-snapshot target so both ends share a layer and morph.
+         */
+        const pairNames = new Map();
+        /**
+         * The old (`from`) elements of each paired subject, so their names can be
+         * transferred off before the new (`to`) elements inherit them.
+         */
+        const pairFrom = new Map();
+        const resolveLayers = (phase) => {
+            targets.forEach((target, definition) => {
+                const className = classNames.get(definition);
+                let names;
+                if (definition === "root" || !resolveDefs.has(definition)) {
+                    names = [definition];
+                }
+                else if (pairs.has(definition)) {
+                    /**
+                     * Paired morph: name the old target in the old snapshot, then
+                     * force the same name(s) onto the new target in the new one, so
+                     * two different elements morph as a single layer.
+                     */
+                    if (phase === "old") {
+                        pairFrom.set(definition, resolveElements(definition));
+                        names = assignViewTransitionNames(definition, nameRegistry, assigned, undefined, className, classed);
+                        pairNames.set(definition, names);
+                    }
+                    else {
+                        /**
+                         * Transfer the name(s) off the `from` elements before the
+                         * `to` elements inherit them. A `from` that survives into
+                         * the new snapshot (e.g. hidden with `visibility: hidden`
+                         * rather than removed) would otherwise keep the name and
+                         * collide - "duplicate view-transition-name".
+                         */
+                        for (const el of pairFrom.get(definition) ?? []) {
+                            el.style?.removeProperty("view-transition-name");
+                            /**
+                             * Drop the old end from the registry too, so the new
+                             * end alone supplies this name's `new` crop radii - we
+                             * neither re-measure nor get ordered by a stale element.
+                             */
+                            nameRegistry.delete(el);
+                        }
+                        names = assignViewTransitionNames(pairs.get(definition), nameRegistry, assigned, pairNames.get(definition), className, classed);
+                    }
+                }
+                else {
+                    names = assignViewTransitionNames(definition, nameRegistry, assigned, undefined, className, classed);
+                }
+                const cropped = definition !== "root" && !noCrop.has(definition);
+                names.forEach((name, index) => {
+                    /**
+                     * If two subjects resolve to the same element, merge their
+                     * definitions so neither subject's animations are dropped.
+                     */
+                    const existing = layerTargets.get(name);
+                    layerTargets.set(name, existing && existing !== target
+                        ? { ...existing, ...target }
+                        : target);
+                    if (cropped)
+                        croppedNames.add(name);
+                    const stagger = layerStagger.get(name) ?? {};
+                    stagger[phase] = [index, names.length];
+                    layerStagger.set(name, stagger);
+                });
             });
-        }
+        };
         /**
-         * Set the timing curve to linear for all view transition layers.
-         * This gets baked into the keyframes, which can't be changed
-         * without breaking the generated animation.
+         * The stagger index/total for a layer, resolved against the snapshot it
+         * belongs to. Returns index -1 when the layer is absent from that snapshot
+         * so the caller can skip a pseudo-element that doesn't exist.
+         */
+        const staggerPosition = (name, type) => {
+            const stagger = layerStagger.get(name);
+            const position = type === "old"
+                ? stagger?.old
+                : type === "new"
+                    ? stagger?.new
+                    : // group / group-children / image-pair persist across both.
+                        stagger?.new ?? stagger?.old;
+            return position ?? [-1, 1];
+        };
+        /**
+         * Merge default + per-layer transition options for a generated layer and
+         * resolve any stagger/delay function against this element's position. Used
+         * by both the morph-retiming and crop corner-radius passes.
+         */
+        const resolveLayerTransition = (target, type, transitionName, index, total) => {
+            const transition = mergeTransition(getValueTransition$1(defaultOptions, transitionName), getValueTransition$1((layerOptions(target, type) ?? {}), transitionName));
+            if (typeof transition.delay === "function") {
+                transition.delay = transition.delay(index, total);
+            }
+            return transition;
+        };
+        /**
+         * Measured corner radii per cropped layer, so the clip can animate each
+         * corner between the old and new elements. Per-corner (rather than the
+         * shorthand) so mismatched/individual radii interpolate cleanly.
+         */
+        const cropRadii = new Map();
+        const recordRadii = (style, name, phase) => {
+            const corners = {};
+            for (const corner of cornerProps)
+                corners[corner] = style[corner];
+            const entry = cropRadii.get(name) ?? {};
+            entry[phase] = corners;
+            cropRadii.set(name, entry);
+        };
+        /**
+         * Cropped layers all come from `.add()`, so their elements are in the
+         * registry - read each one's corner radii directly. For a paired morph both
+         * ends share a name; the new-snapshot element is registered last, so it
+         * wins the `new` reading (and the old end the `old` reading).
+         */
+        const measureCrop = (phase) => {
+            if (!croppedNames.size)
+                return;
+            nameRegistry.forEach((name, element) => {
+                if (croppedNames.has(name)) {
+                    recordRadii(getComputedStyle(element), name, phase);
+                }
+            });
+        };
+        /**
+         * Write the persistent view-transition CSS: suppress root capture when the
+         * root has no animations of its own; force linear timing (baked into the
+         * keyframes, so we can retime later via updateTiming); and clip +
+         * object-fit: cover every cropped morph (the UA default overflows on
+         * aspect-ratio change), with an animated border-radius added below.
          *
-         * This allows us to set easing via updateTiming - which can be changed.
+         * `css.commit` replaces rather than appends, so we re-set the full rule set
+         * each call - the second call (in the update callback) then picks up cropped
+         * layers that only exist in the new snapshot.
          */
-        css.set("::view-transition-group(*), ::view-transition-old(*), ::view-transition-new(*)", { "animation-timing-function": "linear !important" });
-        css.commit(); // Write
-        const transition = document.startViewTransition(async () => {
-            await update();
-            // TODO: Go over new targets and ensure they all have ids
-        });
-        transition.finished.finally(() => {
+        const commitViewCSS = () => {
+            if (!hasTarget("root", targets)) {
+                css.set(":root", { "view-transition-name": "none" });
+            }
+            css.set("::view-transition-group(*), ::view-transition-old(*), ::view-transition-new(*)", { "animation-timing-function": "linear !important" });
+            croppedNames.forEach((name) => {
+                css.set(`::view-transition-group(${name})`, { overflow: "clip" });
+                css.set(`::view-transition-old(${name}), ::view-transition-new(${name})`, { width: "100%", height: "100%", "object-fit": "cover" });
+            });
+            css.commit(); // Write
+        };
+        const cleanup = () => {
+            releaseViewTransitionNames(assigned, classed);
             css.remove(); // Write
-        });
-        return new Promise((resolve) => {
-            transition.ready.then(() => {
+        };
+        const callback = async () => {
+            await update();
+            /**
+             * Re-resolve so elements created by the update are named for the new
+             * snapshot, then measure the cropped layers' new border-radius.
+             */
+            const croppedBefore = croppedNames.size;
+            resolveLayers("new");
+            measureCrop("new");
+            /**
+             * Re-commit the crop CSS only if the new snapshot introduced cropped
+             * layers, so a layer that exists only in the new snapshot is clipped
+             * too - without forcing a redundant style write on the common path.
+             */
+            if (croppedNames.size > croppedBefore)
+                commitViewCSS();
+        };
+        let transition;
+        try {
+            resolveLayers("old");
+            measureCrop("old");
+            commitViewCSS();
+            transition = document.startViewTransition(callback);
+        }
+        catch (error) {
+            /**
+             * The prelude writes inline names before the transition exists. If it
+             * throws (e.g. startViewTransition rejects in a bad UA state), release
+             * them so we neither leak DOM state nor stall the queue on a promise
+             * that never settles - hand back a rejection it can advance past.
+             */
+            cleanup();
+            return Promise.reject(error);
+        }
+        transition.finished.finally(cleanup);
+        return new Promise((resolve, reject) => {
+            transition.ready
+                .then(() => {
                 const generatedViewAnimations = getViewAnimations();
                 const animations = [];
                 /**
                  * Create animations for each of our explicitly-defined subjects.
+                 * `opacityAnimated` additionally tracks which `${name}:${type}`
+                 * we faded, so we can keep the UA `plus-lighter` blend only for a
+                 * genuine opacity crossfade (both sides fading) and drop it for a
+                 * slide/transform, where additive compositing would flash bright.
                  */
-                targets.forEach((definition, target) => {
-                    // TODO: If target is not "root", resolve elements
-                    // and iterate over each
+                const explicitlyAnimated = new Set();
+                const opacityAnimated = new Set();
+                layerTargets.forEach((target, name) => {
+                    const stagger = layerStagger.get(name);
+                    /**
+                     * Presence: `enter` only fires for a pure newcomer (a new
+                     * view with no old), `exit` only for a pure leaver. A
+                     * survivor (both) gets neither - it just morphs.
+                     */
+                    const enterApplies = !!stagger?.new && !stagger?.old;
+                    const exitApplies = !!stagger?.old && !stagger?.new;
                     for (const key of definitionNames) {
-                        if (!definition[key])
+                        if (!target[key])
                             continue;
-                        const { keyframes, options } = definition[key];
+                        if (key === "enter" && !enterApplies)
+                            continue;
+                        if (key === "exit" && !exitApplies)
+                            continue;
+                        const type = chooseLayerType(key);
+                        const [index, total] = staggerPosition(name, type);
+                        // Skip a layer absent from its snapshot.
+                        if (index === -1)
+                            continue;
+                        const { keyframes, options } = target[key];
                         for (let [valueName, valueKeyframes] of Object.entries(keyframes)) {
-                            if (!valueKeyframes)
+                            // Skip only missing values - `0` (e.g. opacity: 0)
+                            // is valid and must reach the from-value inference.
+                            if (valueKeyframes == null)
                                 continue;
-                            const valueOptions = {
-                                ...getValueTransition$1(defaultOptions, valueName),
-                                ...getValueTransition$1(options, valueName),
-                            };
-                            const type = chooseLayerType(key);
                             /**
-                             * If this is an opacity animation, and keyframes are not an array,
-                             * we need to convert them into an array and set an initial value.
+                             * The view path hands keyframes straight to WAAPI,
+                             * so Motion's `x`/`y` shorthands (compiled to
+                             * `transform` only via the value pipeline) have no
+                             * effect. Warn and skip - use `transform`/`translate`.
+                             */
+                            if (valueName === "x" || valueName === "y") {
+                                warnOnce(false, `animateView() animates view-transition layers with CSS properties; the "${valueName}" shorthand has no effect - use transform, e.g. { transform: "translateX(40px)" }.`);
+                                continue;
+                            }
+                            /**
+                             * enter/exit win over new/old on a shared property -
+                             * skip it here when the gated bucket also defines it.
+                             */
+                            if (key === "new" &&
+                                enterApplies &&
+                                target.enter?.keyframes[valueName] != null) {
+                                continue;
+                            }
+                            if (key === "old" &&
+                                exitApplies &&
+                                target.exit?.keyframes[valueName] != null) {
+                                continue;
+                            }
+                            const valueOptions = mergeTransition(getValueTransition$1(defaultOptions, valueName), getValueTransition$1(options, valueName));
+                            /**
+                             * Infer an origin for a single-value keyframe. An
+                             * `enter` mirrors the matching `exit` value (a
+                             * defined exit reverses into the enter for free);
+                             * otherwise the per-type default (opacity 0/1, scale
+                             * 0.85). No default -> left as-is (animates from the
+                             * live value).
+                             *
+                             * `new`/`old` fire for survivors too, where only the
+                             * opacity crossfade default applies - a transform
+                             * default like scale 0.85 would pop a persisting
+                             * element, so gate it on the layer actually
+                             * entering/leaving.
                              */
-                            if (valueName === "opacity" &&
-                                !Array.isArray(valueKeyframes)) {
-                                const initialValue = type === "new" ? 0 : 1;
-                                valueKeyframes = [initialValue, valueKeyframes];
+                            if (!Array.isArray(valueKeyframes)) {
+                                const exitValue = key === "enter"
+                                    ? target.exit?.keyframes[valueName]
+                                    : undefined;
+                                const allowDefault = valueName === "opacity" ||
+                                    (type === "new" ? enterApplies : exitApplies);
+                                const from = exitValue != null
+                                    ? Array.isArray(exitValue)
+                                        ? exitValue[exitValue.length - 1]
+                                        : exitValue
+                                    : allowDefault
+                                        ? ORIGIN_DEFAULTS[type]?.[valueName]
+                                        : undefined;
+                                if (from !== undefined) {
+                                    valueKeyframes = [from, valueKeyframes];
+                                }
                             }
                             /**
-                             * Resolve stagger function if provided.
+                             * Resolve stagger function if provided, per element
+                             * across this subject's resolved layers.
                              */
                             if (typeof valueOptions.delay === "function") {
-                                valueOptions.delay = valueOptions.delay(0, 1);
+                                valueOptions.delay = valueOptions.delay(index, total);
                             }
                             valueOptions.duration && (valueOptions.duration = secondsToMilliseconds(valueOptions.duration));
                             valueOptions.delay && (valueOptions.delay = secondsToMilliseconds(valueOptions.delay));
-                            const animation = new NativeAnimation({
+                            animations.push(new NativeAnimation({
                                 ...valueOptions,
                                 element: document.documentElement,
                                 name: valueName,
-                                pseudoElement: `::view-transition-${type}(${target})`,
+                                pseudoElement: `::view-transition-${type}(${name})`,
                                 keyframes: valueKeyframes,
-                            });
-                            animations.push(animation);
+                            }));
+                            explicitlyAnimated.add(`${name}:${type}`);
+                            if (valueName === "opacity") {
+                                opacityAnimated.add(`${name}:${type}`);
+                            }
                         }
                     }
                 });
@@ -5962,45 +6251,161 @@
                     const name = getViewAnimationLayerInfo(pseudoElement);
                     if (!name)
                         continue;
-                    const targetDefinition = targets.get(name.layer);
-                    if (!targetDefinition) {
-                        /**
-                         * If transition name is group then update the timing of the animation
-                         * whereas if it's old or new then we could possibly replace it using
-                         * the above method.
-                         */
-                        const transitionName = name.type === "group" ? "layout" : "";
-                        let animationTransition = {
-                            ...getValueTransition$1(defaultOptions, transitionName),
-                        };
-                        animationTransition.duration && (animationTransition.duration = secondsToMilliseconds(animationTransition.duration));
-                        animationTransition =
-                            applyGeneratorOptions(animationTransition);
-                        const easing = mapEasingToNativeEasing(animationTransition.ease, animationTransition.duration);
-                        effect.updateTiming({
-                            delay: secondsToMilliseconds(animationTransition.delay ?? 0),
-                            duration: animationTransition.duration,
-                            easing,
-                        });
-                        animations.push(new NativeAnimationWrapper(animation));
-                    }
-                    else if (hasOpacity(targetDefinition, "enter") &&
-                        hasOpacity(targetDefinition, "exit") &&
-                        effect
-                            .getKeyframes()
-                            .some((keyframe) => keyframe.mixBlendMode)) {
-                        animations.push(new NativeAnimationWrapper(animation));
-                    }
-                    else {
-                        animation.cancel();
+                    const targetDefinition = layerTargets.get(name.layer);
+                    /**
+                     * We built our own animation for this layer, so drop the
+                     * browser-generated fade we're replacing. The UA
+                     * `plus-lighter` blend is a *separate* generated animation on
+                     * the same pseudo (it sets `mix-blend-mode` in its keyframes):
+                     * keep it *only* for a true opacity crossfade - both sides
+                     * fading - so a symmetric crossfade composites without
+                     * darkening, but a slide/transform (where both layers stay
+                     * opaque and overlap) doesn't flash bright from the addition.
+                     */
+                    if (explicitlyAnimated.has(`${name.layer}:${name.type}`)) {
+                        const isCrossfade = opacityAnimated.has(`${name.layer}:new`) &&
+                            opacityAnimated.has(`${name.layer}:old`);
+                        if (isCrossfade &&
+                            effect
+                                .getKeyframes()
+                                .some((keyframe) => keyframe.mixBlendMode)) {
+                            animations.push(new NativeAnimationWrapper(animation));
+                        }
+                        else {
+                            animation.cancel();
+                        }
+                        continue;
                     }
+                    /**
+                     * Otherwise retime the browser-generated animation to
+                     * Motion's timing. This auto-enables the layout (group)
+                     * morph for any resolved/named target, and applies the
+                     * default timing to old/new layers we haven't explicitly
+                     * overridden.
+                     *
+                     * group + group-children both follow the layout timing so
+                     * the nesting container stays in sync with the morph.
+                     */
+                    /**
+                     * A survivor's old + new are the two halves of one
+                     * `plus-lighter` crossfade. They must share identical timing
+                     * (so their opacities stay mirrored and sum to 1 - else the
+                     * additive blend flashes bright wherever both are partly
+                     * visible) and fade linearly (the bounce belongs on the
+                     * group's geometry, not the opacity). So time them as the
+                     * group, rather than via their own - potentially staggered,
+                     * or enter/exit-derived - old/new options.
+                     */
+                    const stagger = layerStagger.get(name.layer);
+                    const isMorphCrossfade = (name.type === "old" || name.type === "new") &&
+                        !!stagger?.old &&
+                        !!stagger?.new;
+                    const timingType = name.type.startsWith("group") || isMorphCrossfade
+                        ? "group"
+                        : name.type;
+                    const [index, total] = staggerPosition(name.layer, timingType);
+                    const transitionName = timingType === "group" ? "layout" : "";
+                    let animationTransition = resolveLayerTransition(targetDefinition, timingType, transitionName, index === -1 ? 0 : index, total);
+                    /**
+                     * The crossfade should resolve at the spring's *perceptual*
+                     * (visual) duration - the geometry can keep bouncing, but the
+                     * opacity shouldn't drag through the settle. So capture
+                     * `visualDuration` before `applyGeneratorOptions` replaces it
+                     * with the full overshoot duration, and use it for the fade.
+                     */
+                    const visualDuration = animationTransition.visualDuration;
+                    animationTransition.duration && (animationTransition.duration = secondsToMilliseconds(animationTransition.duration));
+                    animationTransition =
+                        applyGeneratorOptions(animationTransition);
+                    const duration = isMorphCrossfade && visualDuration !== undefined
+                        ? secondsToMilliseconds(visualDuration)
+                        : animationTransition.duration;
+                    const easing = isMorphCrossfade
+                        ? "linear"
+                        : mapEasingToNativeEasing(animationTransition.ease, animationTransition.duration);
+                    effect.updateTiming({
+                        delay: secondsToMilliseconds(animationTransition.delay ?? 0),
+                        duration,
+                        easing,
+                    });
+                    animations.push(new NativeAnimationWrapper(animation));
                 }
+                /**
+                 * Animate each cropped layer's clip corners between the old and
+                 * new elements, so a cropped morph keeps rounded corners
+                 * (handling individual per-corner radii).
+                 */
+                cropRadii.forEach((radii, name) => {
+                    if (!radii.old && !radii.new)
+                        return;
+                    const target = layerTargets.get(name);
+                    const [index, total] = staggerPosition(name, "group");
+                    const radiusOptions = resolveLayerTransition(target, "group", "layout", index === -1 ? 0 : index, total);
+                    radiusOptions.duration && (radiusOptions.duration = secondsToMilliseconds(radiusOptions.duration));
+                    radiusOptions.delay && (radiusOptions.delay = secondsToMilliseconds(radiusOptions.delay));
+                    for (const corner of cornerProps) {
+                        // `||` (not `??`) so an empty measurement (e.g. an
+                        // un-rendered element) falls back rather than producing
+                        // an invalid keyframe.
+                        const from = radii.old?.[corner] || radii.new?.[corner] || "0px";
+                        const to = radii.new?.[corner] || radii.old?.[corner] || "0px";
+                        // Skip square corners - nothing to round.
+                        if (parseFloat(from) === 0 && parseFloat(to) === 0) {
+                            continue;
+                        }
+                        animations.push(new NativeAnimation({
+                            ...radiusOptions,
+                            element: document.documentElement,
+                            name: corner,
+                            pseudoElement: `::view-transition-group(${name})`,
+                            keyframes: [from, to],
+                        }));
+                    }
+                });
                 resolve(new GroupAnimation(animations));
-            });
+            })
+                .catch(() => 
+            /**
+             * `ready` rejects when the transition is skipped - no visual
+             * change, or superseded by an interrupting transition. The DOM
+             * update still applied, so settle with no animations rather than
+             * surfacing it as an error to an awaiting caller. A genuine
+             * failure in `update()` rejects `updateCallbackDone` (already
+             * settled by now), so propagate that instead.
+             */
+            transition.updateCallbackDone.then(() => resolve(new GroupAnimation([])), reject));
         });
     }
-    function hasOpacity(target, key) {
-        return target?.[key]?.keyframes.opacity;
+    /**
+     * The options that should time a given generated layer type, so a retimed
+     * group/old/new picks up any per-target transition the user provided. Checks
+     * the type's buckets in priority order (e.g. `new` before `enter`).
+     */
+    function layerOptions(target, type) {
+        for (const bucket of typeBuckets[type] ?? []) {
+            const options = target?.[bucket]?.options;
+            if (options)
+                return options;
+        }
+    }
+    /**
+     * Merge a base transition (e.g. the default `options`) with a per-layer/value
+     * override. An explicit `duration` on the override must win over an inherited
+     * generator's own timing: a spring prefers `visualDuration`, and
+     * `spring.applyToOptions` overwrites `duration` with the computed settle time -
+     * so without this the override is silently discarded. Dropping the inherited
+     * `type`/`visualDuration` makes the layer a plain tween of that duration, unless
+     * it asked for its own generator `type`/`visualDuration`.
+     */
+    function mergeTransition(base, override) {
+        const merged = { ...base, ...override };
+        if (override.duration !== undefined) {
+            if (override.visualDuration === undefined)
+                delete merged.visualDuration;
+            if (override.type === undefined)
+                delete merged.type;
+        }
+        return merged;
     }
 
     let builders = [];
@@ -6014,10 +6419,16 @@
     function start(builder) {
         removeItem(builders, builder);
         current = builder;
-        startViewAnimation(builder).then((animation) => {
+        startViewAnimation(builder)
+            .then((animation) => {
             builder.notifyReady(animation);
-            animation.finished.finally(next);
-        });
+            return animation.finished;
+        })
+            // A genuinely failed transition (a throwing update) rejects the
+            // builder; a skipped/interrupted one resolves with no animations (see
+            // start.ts). Either way, advance the queue - else later transitions hang.
+            .catch((error) => builder.notifyReject(error))
+            .finally(next);
     }
     function processQueue() {
         /**
@@ -6054,31 +6465,96 @@
         constructor(update, options = {}) {
             this.currentSubject = "root";
             this.targets = new Map();
-            this.notifyReady = noop$1;
-            this.readyPromise = new Promise((resolve) => {
+            /**
+             * Definitions that must be resolved to elements (and assigned a
+             * `view-transition-name`) rather than treated as pre-named layers.
+             */
+            this.resolveDefs = new Set();
+            /**
+             * Subjects opted out of the default crop (clip + object-fit: cover +
+             * animated corner radii) via `.crop(false)`.
+             */
+            this.noCrop = new Set();
+            /**
+             * Subjects paired with a different new-snapshot target (the second `.add()`
+             * argument), so two distinct elements share one name and morph into each
+             * other - a shared-element transition.
+             */
+            this.pairs = new Map();
+            /**
+             * A `view-transition-class` to apply to each subject's resolved elements,
+             * so authors can target the generated layers from CSS by class rather than
+             * the opaque generated name.
+             */
+            this.classNames = new Map();
+            this.notifyReady = noop;
+            this.notifyReject = noop;
+            this.readyPromise = new Promise((resolve, reject) => {
                 this.notifyReady = resolve;
+                this.notifyReject = reject;
             });
             this.update = update;
             this.options = {
                 interrupt: "wait",
                 ...options,
             };
+            // Avoid an unhandled rejection when a failed transition has no
+            // `.then(_, reject)` handler attached (e.g. fire-and-forget).
+            this.readyPromise.catch(noop);
             addToQueue(this);
         }
-        get(subject) {
+        /**
+         * Target elements resolved from a selector or Element, each assigned a
+         * `view-transition-name` automatically.
+         *
+         * Passing a second target pairs them: the first is resolved in the old
+         * snapshot and the second in the new, sharing one name so two *different*
+         * elements morph into each other (e.g. `.add(card, ".modal")`). Symmetric -
+         * pass them the other way round to morph back.
+         */
+        add(subject, newSubject) {
             this.currentSubject = subject;
+            this.resolveDefs.add(subject);
+            if (newSubject !== undefined)
+                this.pairs.set(subject, newSubject);
+            // Register the subject so it participates (and gets an automatic
+            // layout/morph animation) even without an explicit enter/exit/layout.
+            if (!this.targets.has(subject))
+                this.targets.set(subject, {});
             return this;
         }
-        layout(keyframes, options) {
-            this.updateTarget("layout", keyframes, options);
+        /**
+         * Morphs are clipped + `object-fit: cover` (and their corners animate)
+         * by default. Call `.crop(false)` to opt this subject out and fall back
+         * to the browser default (which overflows on aspect-ratio change).
+         */
+        crop(enabled = true) {
+            enabled
+                ? this.noCrop.delete(this.currentSubject)
+                : this.noCrop.add(this.currentSubject);
             return this;
         }
-        new(keyframes, options) {
-            this.updateTarget("new", keyframes, options);
+        /**
+         * Tag this subject's generated layers with a `view-transition-class`, so
+         * they can be targeted from CSS - `::view-transition-group(.name)`,
+         * `::view-transition-old/new(.name)`, `::view-transition-image-pair(.name)`
+         * - without the opaque generated `view-transition-name`. Because `.add()`
+         * can match many elements, a shared class targets them all at once (and,
+         * for a pair, both ends). The escape hatch for z-index / custom keyframes
+         * on a morph layer.
+         */
+        class(name) {
+            this.classNames.set(this.currentSubject, name);
             return this;
         }
-        old(keyframes, options) {
-            this.updateTarget("old", keyframes, options);
+        /**
+         * Set the transition for this subject's morph. The morph is enabled
+         * automatically by `.add()`; this just customises its timing (duration,
+         * easing, a `delay`/`stagger`, …). On the implicit `root` subject it also
+         * opts the page into the transition (the root crossfade).
+         */
+        layout(options = {}) {
+            this.updateTarget("layout", {}, options);
             return this;
         }
         enter(keyframes, options) {
@@ -6089,9 +6565,21 @@
             this.updateTarget("exit", keyframes, options);
             return this;
         }
-        crossfade(options) {
-            this.updateTarget("enter", { opacity: 1 }, options);
-            this.updateTarget("exit", { opacity: 0 }, options);
+        /**
+         * Animate the new view directly, whether the element is appearing or
+         * persisting (unlike `.enter()`, which only fires for a pure newcomer).
+         * Pair with `.old()` for a crossfade or slide-through.
+         */
+        new(keyframes, options) {
+            this.updateTarget("new", keyframes, options);
+            return this;
+        }
+        /**
+         * Animate the old view directly, whether the element is leaving or
+         * persisting (unlike `.exit()`, which only fires for a pure leaver).
+         */
+        old(keyframes, options) {
+            this.updateTarget("old", keyframes, options);
             return this;
         }
         updateTarget(target, keyframes, options = {}) {
@@ -6106,8 +6594,8 @@
             return this.readyPromise.then(resolve, reject);
         }
     }
-    function animateView(update, defaultOptions = {}) {
-        return new ViewTransitionBuilder(update, defaultOptions);
+    function animateView(update, options = {}) {
+        return new ViewTransitionBuilder(update, options);
     }
 
     const createAxisDelta = () => ({
@@ -8207,7 +8695,7 @@
             : values.borderRadius;
     }
     const easeCrossfadeIn = /*@__PURE__*/ compress(0, 0.5, circOut);
-    const easeCrossfadeOut = /*@__PURE__*/ compress(0.5, 0.95, noop$1);
+    const easeCrossfadeOut = /*@__PURE__*/ compress(0.5, 0.95, noop);
     function compress(min, max, easing) {
         return (p) => {
             // Could replace ifs with clamp
@@ -8227,7 +8715,7 @@
 
     function addDomEvent(target, eventName, handler, options = { passive: true }) {
         target.addEventListener(eventName, handler, options);
-        return () => target.removeEventListener(eventName, handler);
+        return () => target.removeEventListener(eventName, handler, options);
     }
 
     const compareByDepth = (a, b) => a.depth - b.depth;
@@ -9497,7 +9985,6 @@
                  */
                 this.pendingAnimation = frame.update(() => {
                     globalProjectionState.hasAnimatedSinceResize = true;
-                    activeAnimations.layout++;
                     this.motionValue || (this.motionValue = motionValue(0));
                     this.motionValue.jump(0, false);
                     this.currentAnimation = animateSingleValue(this.motionValue, [0, 1000], {
@@ -9508,11 +9995,7 @@
                             this.mixTargetDelta(latest);
                             options.onUpdate && options.onUpdate(latest);
                         },
-                        onStop: () => {
-                            activeAnimations.layout--;
-                        },
                         onComplete: () => {
-                            activeAnimations.layout--;
                             options.onComplete && options.onComplete();
                             this.completeAnimation();
                         },
@@ -10027,7 +10510,7 @@
      */
     const roundPoint = userAgentContains("applewebkit/") && !userAgentContains("chrome/")
         ? Math.round
-        : noop$1;
+        : noop;
     function roundAxis(axis) {
         // Round to the nearest .5 pixels to support subpixel layouts
         axis.min = roundPoint(axis.min);
@@ -10101,39 +10584,221 @@
         checkIsScrollRoot: (instance) => Boolean(window.getComputedStyle(instance).position === "fixed"),
     });
 
-    const layoutSelector = "[data-layout], [data-layout-id]";
-    const noop = () => { };
-    function snapshotFromTarget(projection) {
-        const target = projection.targetWithTransforms || projection.target;
-        if (!target)
-            return undefined;
-        const measuredBox = createBox();
-        const layoutBox = createBox();
-        copyBoxInto(measuredBox, target);
-        copyBoxInto(layoutBox, target);
+    const layoutSelector = "[data-layout],[data-layout-id]";
+    /**
+     * All imperatively-created projection nodes live in one persistent tree,
+     * shared across animateLayout() calls (and with any React-created nodes,
+     * via the singleton document root). Keyed by element for reuse.
+     */
+    const layoutNodes = new WeakMap();
+    /**
+     * Builders created within the same synchronous tick are flushed together
+     * as a single "commit": every node is snapshotted before any updateDom
+     * runs, mirroring React batching renders from different parts of the tree.
+     */
+    let pendingBuilders;
+    function collectLayoutElements(scope) {
+        const elements = [];
+        if (scope instanceof HTMLElement && scope.matches(layoutSelector)) {
+            elements.push(scope);
+        }
+        scope.querySelectorAll(layoutSelector).forEach((element) => {
+            if (element instanceof HTMLElement)
+                elements.push(element);
+        });
+        return elements;
+    }
+    /**
+     * Process any work scheduled on the frameloop now. A previous animation
+     * may have been seeked while paused (controls.time = x) without a frame
+     * having rendered it - we must materialise that state into the DOM
+     * before taking snapshots.
+     */
+    function flushPendingFrame() {
+        if (frameData.isProcessing)
+            return;
+        const now = time.now();
+        frameData.delta = clamp(0, 1000 / 60, now - frameData.timestamp);
+        frameData.timestamp = now;
+        frameData.isProcessing = true;
+        frameSteps.update.process(frameData);
+        frameSteps.preRender.process(frameData);
+        frameSteps.render.process(frameData);
+        frameData.isProcessing = false;
+    }
+    function getProjectionParent(element) {
+        let ancestor = element.parentElement;
+        while (ancestor) {
+            const node = layoutNodes.get(ancestor);
+            if (node && node.instance)
+                return node;
+            ancestor = ancestor.parentElement;
+        }
+        return undefined;
+    }
+    function createVisualElement() {
+        return new HTMLVisualElement({
+            props: {},
+            presenceContext: null,
+            visualState: {
+                latestValues: {},
+                renderState: {
+                    transform: {},
+                    transformOrigin: {},
+                    style: {},
+                    vars: {},
+                },
+            },
+        }, { allowProjection: true });
+    }
+    function readNodeOptions(element, transition) {
+        const layoutAttr = element.getAttribute("data-layout");
+        const layoutId = element.getAttribute("data-layout-id") ?? undefined;
         return {
-            animationId: projection.root?.animationId ?? 0,
-            measuredBox,
-            layoutBox,
-            latestValues: projection.animationValues || projection.latestValues || {},
-            source: projection.id,
+            layoutId,
+            layout: layoutAttr !== null ? true : undefined,
+            animationType: (!layoutAttr || layoutAttr === "true"
+                ? "both"
+                : layoutAttr),
+            transition,
+        };
+    }
+    function prepareNode(element, transition) {
+        let node = layoutNodes.get(element);
+        if (!node) {
+            let visualElement = visualElementStore.get(element);
+            if (!visualElement)
+                visualElement = createVisualElement();
+            /**
+             * A first-time element may carry a projection transform in its
+             * inline style (e.g. it was cloned from an element mid-animation).
+             * That transform isn't tracked in latestValues so the engine can't
+             * reset it before measuring - clear it now so the first layout
+             * measurement isn't inflated.
+             */
+            if (element.style.transform &&
+                !hasTransform(visualElement.latestValues)) {
+                element.style.transform = "";
+            }
+            node = new HTMLProjectionNode(visualElement.latestValues, getProjectionParent(element));
+            visualElement.projection = node;
+            node.setOptions({
+                ...readNodeOptions(element, transition),
+                visualElement,
+            });
+            node.mount(element);
+            layoutNodes.set(element, node);
+        }
+        else {
+            node.setOptions(readNodeOptions(element, transition));
+        }
+        node.isPresent = true;
+        if (node.options.onExitComplete) {
+            node.setOptions({ onExitComplete: undefined });
+        }
+        return node;
+    }
+    function sortDocumentOrder(elements) {
+        return [...elements].sort((a, b) => a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1);
+    }
+    function dropNode(element, node) {
+        node.setOptions({ onExitComplete: undefined });
+        /**
+         * Stop any lingering animation so it can't leak into future updates.
+         * A follow node can share its currentAnimation with a surviving lead
+         * (via resumingFrom), in which case it isn't ours to stop.
+         */
+        const stack = node.getStack();
+        if (!stack || node.isLead())
+            node.currentAnimation?.stop();
+        node.unmount();
+        layoutNodes.delete(element);
+    }
+    function flushPendingBuilders() {
+        const builders = pendingBuilders;
+        pendingBuilders = undefined;
+        flushPendingFrame();
+        /**
+         * Discover and mount every node across all builders before snapshotting
+         * any of them. Mounting during an active update flags isLayoutDirty,
+         * which would make that node's own willUpdate skip its snapshot.
+         * Document order guarantees ancestors mount before descendants, even
+         * when they're discovered by different builders.
+         */
+        const targets = new Map();
+        for (const builder of builders) {
+            for (const element of builder.collectTargets()) {
+                const owners = targets.get(element);
+                owners ? owners.push(builder) : targets.set(element, [builder]);
+            }
+        }
+        const union = new Map();
+        for (const element of sortDocumentOrder(targets.keys())) {
+            const owners = targets.get(element);
+            const node = prepareNode(element, owners[owners.length - 1].transitionFor(element));
+            for (const owner of owners)
+                owner.adopt(element, node);
+            union.set(element, node);
+        }
+        union.forEach((node) => {
+            node.isLayoutDirty = false;
+            node.willUpdate();
+        });
+        const updatePromises = [];
+        for (const builder of builders) {
+            const result = builder.runUpdate();
+            if (result)
+                updatePromises.push(result);
+        }
+        const commit = () => {
+            /**
+             * Process all additions before any removals so that, even across
+             * builders, a removed member knows whether a replacement with the
+             * same layoutId was added in this commit.
+             */
+            const newMemberIds = new Set();
+            for (const builder of builders) {
+                builder.reconcileAdditions(newMemberIds);
+            }
+            for (const builder of builders) {
+                builder.reconcileRemovals(newMemberIds);
+            }
+            let root;
+            union.forEach((node) => (root || (root = node.root)));
+            for (const builder of builders)
+                root || (root = builder.getRoot());
+            root?.didUpdate();
+            /**
+             * The root flushes the update on a microtask, synchronously
+             * processing the frame that creates the layout animations. Collect
+             * them in a later microtask step of the same pass.
+             */
+            microtask.render(() => {
+                for (const builder of builders)
+                    builder.finalize();
+            });
         };
+        updatePromises.length ? Promise.all(updatePromises).then(commit) : commit();
     }
     class LayoutAnimationBuilder {
         constructor(scope, updateDom, defaultOptions) {
-            this.sharedTransitions = new Map();
-            this.notifyReady = noop;
-            this.rejectReady = noop;
             this.scope = scope;
             this.updateDom = updateDom;
             this.defaultOptions = defaultOptions;
+            this.sharedTransitions = new Map();
+            this.notifyReady = () => { };
+            this.rejectReady = () => { };
+            this.tracked = new Map();
+            this.restorePoints = new Map();
             this.readyPromise = new Promise((resolve, reject) => {
                 this.notifyReady = resolve;
                 this.rejectReady = reject;
             });
-            frame.postRender(() => {
-                this.start().then(this.notifyReady).catch(this.rejectReady);
-            });
+            if (!pendingBuilders) {
+                pendingBuilders = [];
+                queueMicrotask(flushPendingBuilders);
+            }
+            pendingBuilders.push(this);
         }
         shared(id, transition) {
             this.sharedTransitions.set(id, transition);
@@ -10142,114 +10807,107 @@
         then(resolve, reject) {
             return this.readyPromise.then(resolve, reject);
         }
-        async start() {
-            const beforeElements = collectLayoutElements(this.scope);
-            const beforeRecords = this.buildRecords(beforeElements);
-            beforeRecords.forEach(({ projection }) => {
-                const hasCurrentAnimation = Boolean(projection.currentAnimation);
-                const isSharedLayout = Boolean(projection.options.layoutId);
-                if (hasCurrentAnimation && isSharedLayout) {
-                    const snapshot = snapshotFromTarget(projection);
-                    if (snapshot) {
-                        projection.snapshot = snapshot;
-                    }
-                    else if (projection.snapshot) {
-                        projection.snapshot = undefined;
-                    }
-                }
-                else if (projection.snapshot &&
-                    (projection.currentAnimation || projection.isProjecting())) {
-                    projection.snapshot = undefined;
-                }
-                projection.isPresent = true;
-                projection.willUpdate();
+        transitionFor(element) {
+            const layoutId = element.getAttribute("data-layout-id");
+            return ((layoutId && this.sharedTransitions.get(layoutId)) ||
+                this.defaultOptions);
+        }
+        adopt(element, node) {
+            this.tracked.set(element, node);
+            this.restorePoints.set(element, {
+                parent: element.parentElement,
+                next: element.nextSibling,
             });
-            await this.updateDom();
-            const afterElements = collectLayoutElements(this.scope);
-            const afterRecords = this.buildRecords(afterElements);
-            this.handleExitingElements(beforeRecords, afterRecords);
-            afterRecords.forEach(({ projection }) => {
-                const instance = projection.instance;
-                const resumeFromInstance = projection.resumeFrom
-                    ?.instance;
-                if (!instance || !resumeFromInstance)
-                    return;
-                if (!("style" in instance))
-                    return;
-                const currentTransform = instance.style.transform;
-                const resumeFromTransform = resumeFromInstance.style.transform;
-                if (currentTransform &&
-                    resumeFromTransform &&
-                    currentTransform === resumeFromTransform) {
-                    instance.style.transform = "";
-                    instance.style.transformOrigin = "";
+        }
+        collectTargets() {
+            return collectLayoutElements(this.scope);
+        }
+        runUpdate() {
+            try {
+                const result = this.updateDom();
+                if (result && typeof result.then === "function") {
+                    return result.then(undefined, (error) => {
+                        this.updateError = error;
+                    });
                 }
-            });
-            afterRecords.forEach(({ projection }) => {
-                projection.isPresent = true;
-            });
-            const root = getProjectionRoot(afterRecords, beforeRecords);
-            root?.didUpdate();
-            await new Promise((resolve) => {
-                frame.postRender(() => resolve());
-            });
-            const animations = collectAnimations(afterRecords);
-            const animation = new GroupAnimation(animations);
-            return animation;
+            }
+            catch (error) {
+                this.updateError = error;
+            }
+            return undefined;
         }
-        buildRecords(elements) {
-            const records = [];
-            const recordMap = new Map();
-            for (const element of elements) {
-                const parentRecord = findParentRecord(element, recordMap, this.scope);
-                const { layout, layoutId } = readLayoutAttributes(element);
-                const override = layoutId
-                    ? this.sharedTransitions.get(layoutId)
-                    : undefined;
-                const transition = override || this.defaultOptions;
-                const record = getOrCreateRecord(element, parentRecord?.projection, {
-                    layout,
-                    layoutId,
-                    animationType: typeof layout === "string" ? layout : "both",
-                    transition: transition,
-                });
-                recordMap.set(element, record);
-                records.push(record);
+        reconcileAdditions(newMemberIds) {
+            for (const element of collectLayoutElements(this.scope)) {
+                if (this.tracked.has(element))
+                    continue;
+                const node = prepareNode(element, this.transitionFor(element));
+                this.adopt(element, node);
+                node.options.layoutId && newMemberIds.add(node.options.layoutId);
             }
-            return records;
         }
-        handleExitingElements(beforeRecords, afterRecords) {
-            const afterElementsSet = new Set(afterRecords.map((record) => record.element));
-            beforeRecords.forEach((record) => {
-                if (afterElementsSet.has(record.element))
+        reconcileRemovals(newMemberIds) {
+            this.tracked.forEach((node, element) => {
+                if (element.isConnected)
                     return;
-                // For shared layout elements, relegate to set up resumeFrom
-                // so the remaining element animates from this position
-                if (record.projection.options.layoutId) {
-                    record.projection.isPresent = false;
-                    record.projection.relegate();
+                const restore = this.restorePoints.get(element);
+                this.restorePoints.delete(element);
+                const { layoutId } = node.options;
+                const stack = node.getStack();
+                const hasSurvivor = stack &&
+                    stack.members.some((member) => member !== node &&
+                        member.instance
+                            ?.isConnected);
+                /**
+                 * A removed lead with a surviving stack member - and no
+                 * replacement member added this commit - runs an exit
+                 * crossfade: restore the element to its old position in the
+                 * DOM, relegate it and let the survivor take over. It's
+                 * removed again once the animation completes.
+                 */
+                if (layoutId &&
+                    node.isLead() &&
+                    hasSurvivor &&
+                    !newMemberIds.has(layoutId)) {
+                    if (restore && restore.parent.isConnected) {
+                        restore.parent.insertBefore(element, restore.next && restore.next.parentNode === restore.parent
+                            ? restore.next
+                            : null);
+                        node.isPresent = false;
+                        node.setOptions({
+                            onExitComplete: () => {
+                                element.remove();
+                                dropNode(element, node);
+                            },
+                        });
+                        if (node.relegate())
+                            return;
+                        element.remove();
+                    }
                 }
-                record.visualElement.unmount();
-                visualElementStore.delete(record.element);
+                dropNode(element, node);
+                this.tracked.delete(element);
             });
-            // Clear resumeFrom on EXISTING nodes that point to unmounted projections
-            // This prevents crossfade animation when the source element was removed entirely
-            // But preserve resumeFrom for NEW nodes so they can animate from the old position
-            // Also preserve resumeFrom for lead nodes that were just promoted via relegate
-            const beforeElementsSet = new Set(beforeRecords.map((record) => record.element));
-            afterRecords.forEach(({ element, projection }) => {
-                if (beforeElementsSet.has(element) &&
-                    projection.resumeFrom &&
-                    !projection.resumeFrom.instance &&
-                    !projection.isLead()) {
-                    projection.resumeFrom = undefined;
-                    projection.snapshot = undefined;
+        }
+        getRoot() {
+            let root;
+            this.tracked.forEach((node) => (root || (root = node.root)));
+            return root;
+        }
+        finalize() {
+            if (this.updateError) {
+                this.rejectReady(this.updateError);
+                return;
+            }
+            const animations = new Set();
+            this.tracked.forEach((node) => {
+                if (node.instance && node.currentAnimation) {
+                    animations.add(node.currentAnimation);
                 }
             });
+            this.notifyReady(new GroupAnimation([...animations]));
         }
     }
     function parseAnimateLayoutArgs(scopeOrUpdateDom, updateDomOrOptions, options) {
-        // animateLayout(updateDom)
         if (typeof scopeOrUpdateDom === "function") {
             return {
                 scope: document,
@@ -10257,107 +10915,15 @@
                 defaultOptions: updateDomOrOptions,
             };
         }
-        // animateLayout(scope, updateDom, options?)
-        const elements = resolveElements(scopeOrUpdateDom);
-        const scope = elements[0] || document;
+        const scope = scopeOrUpdateDom instanceof Document
+            ? scopeOrUpdateDom
+            : resolveElements(scopeOrUpdateDom)[0] ?? document;
         return {
             scope,
             updateDom: updateDomOrOptions,
             defaultOptions: options,
         };
     }
-    function collectLayoutElements(scope) {
-        const elements = Array.from(scope.querySelectorAll(layoutSelector));
-        if (scope instanceof Element && scope.matches(layoutSelector)) {
-            if (!elements.includes(scope)) {
-                elements.unshift(scope);
-            }
-        }
-        return elements;
-    }
-    function readLayoutAttributes(element) {
-        const layoutId = element.getAttribute("data-layout-id") || undefined;
-        const rawLayout = element.getAttribute("data-layout");
-        let layout;
-        if (rawLayout === "" || rawLayout === "true") {
-            layout = true;
-        }
-        else if (rawLayout) {
-            layout = rawLayout;
-        }
-        return {
-            layout,
-            layoutId,
-        };
-    }
-    function createVisualState() {
-        return {
-            latestValues: {},
-            renderState: {
-                transform: {},
-                transformOrigin: {},
-                style: {},
-                vars: {},
-            },
-        };
-    }
-    function getOrCreateRecord(element, parentProjection, projectionOptions) {
-        const existing = visualElementStore.get(element);
-        const visualElement = existing ??
-            new HTMLVisualElement({
-                props: {},
-                presenceContext: null,
-                visualState: createVisualState(),
-            }, { allowProjection: true });
-        if (!existing || !visualElement.projection) {
-            visualElement.projection = new HTMLProjectionNode(visualElement.latestValues, parentProjection);
-        }
-        visualElement.projection.setOptions({
-            ...projectionOptions,
-            visualElement,
-        });
-        if (!visualElement.current) {
-            visualElement.mount(element);
-        }
-        else if (!visualElement.projection.instance) {
-            // Mount projection if VisualElement is already mounted but projection isn't
-            // This happens when animate() was called before animateLayout()
-            visualElement.projection.mount(element);
-        }
-        if (!existing) {
-            visualElementStore.set(element, visualElement);
-        }
-        return {
-            element,
-            visualElement,
-            projection: visualElement.projection,
-        };
-    }
-    function findParentRecord(element, recordMap, scope) {
-        let parent = element.parentElement;
-        while (parent) {
-            const record = recordMap.get(parent);
-            if (record)
-                return record;
-            if (parent === scope)
-                break;
-            parent = parent.parentElement;
-        }
-        return undefined;
-    }
-    function getProjectionRoot(afterRecords, beforeRecords) {
-        const record = afterRecords[0] || beforeRecords[0];
-        return record?.projection.root;
-    }
-    function collectAnimations(afterRecords) {
-        const animations = new Set();
-        afterRecords.forEach((record) => {
-            const animation = record.projection.currentAnimation;
-            if (animation)
-                animations.add(animation);
-        });
-        return Array.from(animations);
-    }
 
     /**
      * @deprecated
@@ -10546,6 +11112,14 @@
     const PresenceChild = ({ children, initial, isPresent, onExitComplete, custom, presenceAffectsLayout, mode, anchorX, anchorY, root }) => {
         const presenceChildren = useConstant(newChildrenMap);
         const id = React$1.useId();
+        // Written in a layout effect (not render) so discarded concurrent
+        // renders can't leave the refs pointing at uncommitted state.
+        const isPresentRef = React$1.useRef(isPresent);
+        const onExitCompleteRef = React$1.useRef(onExitComplete);
+        useIsomorphicLayoutEffect(() => {
+            isPresentRef.current = isPresent;
+            onExitCompleteRef.current = onExitComplete;
+        });
         let isReusedContext = true;
         let context = React$1.useMemo(() => {
             isReusedContext = false;
@@ -10564,7 +11138,12 @@
                 },
                 register: (childId) => {
                     presenceChildren.set(childId, false);
-                    return () => presenceChildren.delete(childId);
+                    return () => {
+                        presenceChildren.delete(childId);
+                        !isPresentRef.current &&
+                            !presenceChildren.size &&
+                            onExitCompleteRef.current?.();
+                    };
                 },
             };
         }, [isPresent, presenceChildren, onExitComplete]);
@@ -12041,7 +12620,11 @@
             const { onSessionStart } = handlers;
             onSessionStart &&
                 onSessionStart(event, getPanInfo(initialInfo, this.history));
-            this.removeListeners = pipe(addPointerEvent(this.contextWindow, "pointermove", this.handlePointerMove), addPointerEvent(this.contextWindow, "pointerup", this.handlePointerUp), addPointerEvent(this.contextWindow, "pointercancel", this.handlePointerUp));
+            // Listen in the capture phase so a descendant calling
+            // stopPropagation() (e.g. in its own pointerup handler) can't
+            // prevent the gesture from ending. See #2794.
+            const eventOptions = { passive: true, capture: true };
+            this.removeListeners = pipe(addPointerEvent(this.contextWindow, "pointermove", this.handlePointerMove, eventOptions), addPointerEvent(this.contextWindow, "pointerup", this.handlePointerUp, eventOptions), addPointerEvent(this.contextWindow, "pointercancel", this.handlePointerUp, eventOptions));
             // Start scroll tracking if element provided
             if (element) {
                 this.startScrollTracking(element);
@@ -12885,8 +13468,8 @@
     class DragGesture extends Feature {
         constructor(node) {
             super(node);
-            this.removeGroupControls = noop$1;
-            this.removeListeners = noop$1;
+            this.removeGroupControls = noop;
+            this.removeListeners = noop;
             this.controls = new VisualElementDragControls(node);
         }
         mount() {
@@ -12896,7 +13479,7 @@
             if (dragControls) {
                 this.removeGroupControls = dragControls.subscribe(this.controls);
             }
-            this.removeListeners = this.controls.addListeners() || noop$1;
+            this.removeListeners = this.controls.addListeners() || noop;
         }
         update() {
             const { dragControls } = this.node.getProps();
@@ -12935,7 +13518,7 @@
     class PanGesture extends Feature {
         constructor() {
             super(...arguments);
-            this.removePointerDownListener = noop$1;
+            this.removePointerDownListener = noop;
         }
         onPointerDown(pointerDownEvent) {
             this.session = new PanSession(pointerDownEvent, this.createPanHandlers(), {
@@ -14722,7 +15305,7 @@
     const getEventTarget = (element) => element === document.scrollingElement ? window : element;
     function scrollInfo(onScroll, { container = document.scrollingElement, trackContentSize = false, ...options } = {}) {
         if (!container)
-            return noop$1;
+            return noop;
         let containerHandlers = onScrollHandlers.get(container);
         /**
          * Get the onScroll handlers for this container.
@@ -15006,7 +15589,7 @@
 
     function scroll(onScroll, { axis = "y", container = document.scrollingElement, ...options } = {}) {
         if (!container)
-            return noop$1;
+            return noop;
         const optionsWithDefaults = { axis, container, ...options };
         return typeof onScroll === "function"
             ? attachToFunction(onScroll, optionsWithDefaults)
@@ -16177,7 +16760,7 @@
         };
         appearComplete.set(id, false);
         if (readyAnimation.ready) {
-            readyAnimation.ready.then(startAnimation).catch(noop$1);
+            readyAnimation.ready.then(startAnimation).catch(noop);
         }
         else {
             startAnimation();
@@ -16334,7 +16917,6 @@
     exports.VisualElement = VisualElement;
     exports.WillChangeMotionValue = WillChangeMotionValue;
     exports.acceleratedValues = acceleratedValues;
-    exports.activeAnimations = activeAnimations;
     exports.addAttrValue = addAttrValue;
     exports.addDomEvent = addDomEvent;
     exports.addPointerEvent = addPointerEvent;
@@ -16549,7 +17131,7 @@
     exports.motionValue = motionValue;
     exports.moveItem = moveItem;
     exports.nodeGroup = nodeGroup;
-    exports.noop = noop$1;
+    exports.noop = noop;
     exports.number = number;
     exports.numberValueTypes = numberValueTypes;
     exports.observeTimeline = observeTimeline;