motion 12.18.1 → 12.19.0

package/dist/es/framer-motion/dist/es/motion/features/layout/MeasureLayout.mjs

@@ -1,135 +0,0 @@
-"use client";
-import { jsx } from 'react/jsx-runtime';
-import { useContext, Component } from 'react';
-import { usePresence } from '../../../components/AnimatePresence/use-presence.mjs';
-import { LayoutGroupContext } from '../../../context/LayoutGroupContext.mjs';
-import { SwitchLayoutGroupContext } from '../../../context/SwitchLayoutGroupContext.mjs';
-import { globalProjectionState } from '../../../projection/node/state.mjs';
-import { correctBorderRadius } from '../../../projection/styles/scale-border-radius.mjs';
-import { correctBoxShadow } from '../../../projection/styles/scale-box-shadow.mjs';
-import { addScaleCorrector } from '../../../projection/styles/scale-correction.mjs';
-import { frame } from '../../../../../../motion-dom/dist/es/frameloop/frame.mjs';
-import { microtask } from '../../../../../../motion-dom/dist/es/frameloop/microtask.mjs';
-
-class MeasureLayoutWithContext extends Component {
-    /**
-     * This only mounts projection nodes for components that
-     * need measuring, we might want to do it for all components
-     * in order to incorporate transforms
-     */
-    componentDidMount() {
-        const { visualElement, layoutGroup, switchLayoutGroup, layoutId } = this.props;
-        const { projection } = visualElement;
-        addScaleCorrector(defaultScaleCorrectors);
-        if (projection) {
-            if (layoutGroup.group)
-                layoutGroup.group.add(projection);
-            if (switchLayoutGroup && switchLayoutGroup.register && layoutId) {
-                switchLayoutGroup.register(projection);
-            }
-            projection.root.didUpdate();
-            projection.addEventListener("animationComplete", () => {
-                this.safeToRemove();
-            });
-            projection.setOptions({
-                ...projection.options,
-                onExitComplete: () => this.safeToRemove(),
-            });
-        }
-        globalProjectionState.hasEverUpdated = true;
-    }
-    getSnapshotBeforeUpdate(prevProps) {
-        const { layoutDependency, visualElement, drag, isPresent } = this.props;
-        const { projection } = visualElement;
-        if (!projection)
-            return null;
-        /**
-         * TODO: We use this data in relegate to determine whether to
-         * promote a previous element. There's no guarantee its presence data
-         * will have updated by this point - if a bug like this arises it will
-         * have to be that we markForRelegation and then find a new lead some other way,
-         * perhaps in didUpdate
-         */
-        projection.isPresent = isPresent;
-        if (drag ||
-            prevProps.layoutDependency !== layoutDependency ||
-            layoutDependency === undefined ||
-            prevProps.isPresent !== isPresent) {
-            projection.willUpdate();
-        }
-        else {
-            this.safeToRemove();
-        }
-        if (prevProps.isPresent !== isPresent) {
-            if (isPresent) {
-                projection.promote();
-            }
-            else if (!projection.relegate()) {
-                /**
-                 * If there's another stack member taking over from this one,
-                 * it's in charge of the exit animation and therefore should
-                 * be in charge of the safe to remove. Otherwise we call it here.
-                 */
-                frame.postRender(() => {
-                    const stack = projection.getStack();
-                    if (!stack || !stack.members.length) {
-                        this.safeToRemove();
-                    }
-                });
-            }
-        }
-        return null;
-    }
-    componentDidUpdate() {
-        const { projection } = this.props.visualElement;
-        if (projection) {
-            projection.root.didUpdate();
-            microtask.postRender(() => {
-                if (!projection.currentAnimation && projection.isLead()) {
-                    this.safeToRemove();
-                }
-            });
-        }
-    }
-    componentWillUnmount() {
-        const { visualElement, layoutGroup, switchLayoutGroup: promoteContext, } = this.props;
-        const { projection } = visualElement;
-        if (projection) {
-            projection.scheduleCheckAfterUnmount();
-            if (layoutGroup && layoutGroup.group)
-                layoutGroup.group.remove(projection);
-            if (promoteContext && promoteContext.deregister)
-                promoteContext.deregister(projection);
-        }
-    }
-    safeToRemove() {
-        const { safeToRemove } = this.props;
-        safeToRemove && safeToRemove();
-    }
-    render() {
-        return null;
-    }
-}
-function MeasureLayout(props) {
-    const [isPresent, safeToRemove] = usePresence();
-    const layoutGroup = useContext(LayoutGroupContext);
-    return (jsx(MeasureLayoutWithContext, { ...props, layoutGroup: layoutGroup, switchLayoutGroup: useContext(SwitchLayoutGroupContext), isPresent: isPresent, safeToRemove: safeToRemove }));
-}
-const defaultScaleCorrectors = {
-    borderRadius: {
-        ...correctBorderRadius,
-        applyTo: [
-            "borderTopLeftRadius",
-            "borderTopRightRadius",
-            "borderBottomLeftRadius",
-            "borderBottomRightRadius",
-        ],
-    },
-    borderTopLeftRadius: correctBorderRadius,
-    borderTopRightRadius: correctBorderRadius,
-    borderBottomLeftRadius: correctBorderRadius,
-    borderBottomRightRadius: correctBorderRadius,
-    boxShadow: correctBoxShadow,
-};
-
-export { MeasureLayout };

package/dist/es/framer-motion/dist/es/motion/features/layout.mjs

@@ -1,11 +0,0 @@
-import { HTMLProjectionNode } from '../../projection/node/HTMLProjectionNode.mjs';
-import { MeasureLayout } from './layout/MeasureLayout.mjs';
-
-const layout = {
-    layout: {
-        ProjectionNode: HTMLProjectionNode,
-        MeasureLayout,
-    },
-};
-
-export { layout };

package/dist/es/framer-motion/dist/es/motion/features/load-features.mjs

@@ -1,12 +0,0 @@
-import { featureDefinitions } from './definitions.mjs';
-
-function loadFeatures(features) {
-    for (const key in features) {
-        featureDefinitions[key] = {
-            ...featureDefinitions[key],
-            ...features[key],
-        };
-    }
-}
-
-export { loadFeatures };

package/dist/es/framer-motion/dist/es/motion/features/viewport/index.mjs

@@ -1,72 +0,0 @@
-import { Feature } from '../Feature.mjs';
-import { observeIntersection } from './observers.mjs';
-
-const thresholdNames = {
-    some: 0,
-    all: 1,
-};
-class InViewFeature extends Feature {
-    constructor() {
-        super(...arguments);
-        this.hasEnteredView = false;
-        this.isInView = false;
-    }
-    startObserver() {
-        this.unmount();
-        const { viewport = {} } = this.node.getProps();
-        const { root, margin: rootMargin, amount = "some", once } = viewport;
-        const options = {
-            root: root ? root.current : undefined,
-            rootMargin,
-            threshold: typeof amount === "number" ? amount : thresholdNames[amount],
-        };
-        const onIntersectionUpdate = (entry) => {
-            const { isIntersecting } = entry;
-            /**
-             * If there's been no change in the viewport state, early return.
-             */
-            if (this.isInView === isIntersecting)
-                return;
-            this.isInView = isIntersecting;
-            /**
-             * Handle hasEnteredView. If this is only meant to run once, and
-             * element isn't visible, early return. Otherwise set hasEnteredView to true.
-             */
-            if (once && !isIntersecting && this.hasEnteredView) {
-                return;
-            }
-            else if (isIntersecting) {
-                this.hasEnteredView = true;
-            }
-            if (this.node.animationState) {
-                this.node.animationState.setActive("whileInView", isIntersecting);
-            }
-            /**
-             * Use the latest committed props rather than the ones in scope
-             * when this observer is created
-             */
-            const { onViewportEnter, onViewportLeave } = this.node.getProps();
-            const callback = isIntersecting ? onViewportEnter : onViewportLeave;
-            callback && callback(entry);
-        };
-        return observeIntersection(this.node.current, options, onIntersectionUpdate);
-    }
-    mount() {
-        this.startObserver();
-    }
-    update() {
-        if (typeof IntersectionObserver === "undefined")
-            return;
-        const { props, prevProps } = this.node;
-        const hasOptionsChanged = ["amount", "margin", "root"].some(hasViewportOptionChanged(props, prevProps));
-        if (hasOptionsChanged) {
-            this.startObserver();
-        }
-    }
-    unmount() { }
-}
-function hasViewportOptionChanged({ viewport = {} }, { viewport: prevViewport = {} } = {}) {
-    return (name) => viewport[name] !== prevViewport[name];
-}
-
-export { InViewFeature };

package/dist/es/framer-motion/dist/es/motion/features/viewport/observers.mjs

@@ -1,49 +0,0 @@
-/**
- * Map an IntersectionHandler callback to an element. We only ever make one handler for one
- * element, so even though these handlers might all be triggered by different
- * observers, we can keep them in the same map.
- */
-const observerCallbacks = new WeakMap();
-/**
- * Multiple observers can be created for multiple element/document roots. Each with
- * different settings. So here we store dictionaries of observers to each root,
- * using serialised settings (threshold/margin) as lookup keys.
- */
-const observers = new WeakMap();
-const fireObserverCallback = (entry) => {
-    const callback = observerCallbacks.get(entry.target);
-    callback && callback(entry);
-};
-const fireAllObserverCallbacks = (entries) => {
-    entries.forEach(fireObserverCallback);
-};
-function initIntersectionObserver({ root, ...options }) {
-    const lookupRoot = root || document;
-    /**
-     * If we don't have an observer lookup map for this root, create one.
-     */
-    if (!observers.has(lookupRoot)) {
-        observers.set(lookupRoot, {});
-    }
-    const rootObservers = observers.get(lookupRoot);
-    const key = JSON.stringify(options);
-    /**
-     * If we don't have an observer for this combination of root and settings,
-     * create one.
-     */
-    if (!rootObservers[key]) {
-        rootObservers[key] = new IntersectionObserver(fireAllObserverCallbacks, { root, ...options });
-    }
-    return rootObservers[key];
-}
-function observeIntersection(element, options, callback) {
-    const rootInteresectionObserver = initIntersectionObserver(options);
-    observerCallbacks.set(element, callback);
-    rootInteresectionObserver.observe(element);
-    return () => {
-        observerCallbacks.delete(element);
-        rootInteresectionObserver.unobserve(element);
-    };
-}
-
-export { observeIntersection };

package/dist/es/framer-motion/dist/es/motion/index.mjs

@@ -1,101 +0,0 @@
-"use client";
-import { jsxs, jsx } from 'react/jsx-runtime';
-import { forwardRef, useContext } from 'react';
-import { LayoutGroupContext } from '../context/LayoutGroupContext.mjs';
-import { LazyContext } from '../context/LazyContext.mjs';
-import { MotionConfigContext } from '../context/MotionConfigContext.mjs';
-import { MotionContext } from '../context/MotionContext/index.mjs';
-import { useCreateMotionContext } from '../context/MotionContext/create.mjs';
-import { isBrowser } from '../utils/is-browser.mjs';
-import { featureDefinitions } from './features/definitions.mjs';
-import { loadFeatures } from './features/load-features.mjs';
-import { motionComponentSymbol } from './utils/symbol.mjs';
-import { useMotionRef } from './utils/use-motion-ref.mjs';
-import { useVisualElement } from './utils/use-visual-element.mjs';
-import { warning, invariant } from '../../../../motion-utils/dist/es/errors.mjs';
-
-/**
- * Create a `motion` component.
- *
- * This function accepts a Component argument, which can be either a string (ie "div"
- * for `motion.div`), or an actual React component.
- *
- * Alongside this is a config option which provides a way of rendering the provided
- * component "offline", or outside the React render cycle.
- */
-function createRendererMotionComponent({ preloadedFeatures, createVisualElement, useRender, useVisualState, Component, }) {
-    preloadedFeatures && loadFeatures(preloadedFeatures);
-    function MotionComponent(props, externalRef) {
-        /**
-         * If we need to measure the element we load this functionality in a
-         * separate class component in order to gain access to getSnapshotBeforeUpdate.
-         */
-        let MeasureLayout;
-        const configAndProps = {
-            ...useContext(MotionConfigContext),
-            ...props,
-            layoutId: useLayoutId(props),
-        };
-        const { isStatic } = configAndProps;
-        const context = useCreateMotionContext(props);
-        const visualState = useVisualState(props, isStatic);
-        if (!isStatic && isBrowser) {
-            useStrictMode(configAndProps, preloadedFeatures);
-            const layoutProjection = getProjectionFunctionality(configAndProps);
-            MeasureLayout = layoutProjection.MeasureLayout;
-            /**
-             * Create a VisualElement for this component. A VisualElement provides a common
-             * interface to renderer-specific APIs (ie DOM/Three.js etc) as well as
-             * providing a way of rendering to these APIs outside of the React render loop
-             * for more performant animations and interactions
-             */
-            context.visualElement = useVisualElement(Component, visualState, configAndProps, createVisualElement, layoutProjection.ProjectionNode);
-        }
-        /**
-         * The mount order and hierarchy is specific to ensure our element ref
-         * is hydrated by the time features fire their effects.
-         */
-        return (jsxs(MotionContext.Provider, { value: context, children: [MeasureLayout && context.visualElement ? (jsx(MeasureLayout, { visualElement: context.visualElement, ...configAndProps })) : null, useRender(Component, props, useMotionRef(visualState, context.visualElement, externalRef), visualState, isStatic, context.visualElement)] }));
-    }
-    MotionComponent.displayName = `motion.${typeof Component === "string"
-        ? Component
-        : `create(${Component.displayName ?? Component.name ?? ""})`}`;
-    const ForwardRefMotionComponent = forwardRef(MotionComponent);
-    ForwardRefMotionComponent[motionComponentSymbol] = Component;
-    return ForwardRefMotionComponent;
-}
-function useLayoutId({ layoutId }) {
-    const layoutGroupId = useContext(LayoutGroupContext).id;
-    return layoutGroupId && layoutId !== undefined
-        ? layoutGroupId + "-" + layoutId
-        : layoutId;
-}
-function useStrictMode(configAndProps, preloadedFeatures) {
-    const isStrict = useContext(LazyContext).strict;
-    /**
-     * If we're in development mode, check to make sure we're not rendering a motion component
-     * as a child of LazyMotion, as this will break the file-size benefits of using it.
-     */
-    if (process.env.NODE_ENV !== "production" &&
-        preloadedFeatures &&
-        isStrict) {
-        const strictMessage = "You have rendered a `motion` component within a `LazyMotion` component. This will break tree shaking. Import and render a `m` component instead.";
-        configAndProps.ignoreStrict
-            ? warning(false, strictMessage)
-            : invariant(false, strictMessage);
-    }
-}
-function getProjectionFunctionality(props) {
-    const { drag, layout } = featureDefinitions;
-    if (!drag && !layout)
-        return {};
-    const combined = { ...drag, ...layout };
-    return {
-        MeasureLayout: drag?.isEnabled(props) || layout?.isEnabled(props)
-            ? combined.MeasureLayout
-            : undefined,
-        ProjectionNode: combined.ProjectionNode,
-    };
-}
-
-export { createRendererMotionComponent };

package/dist/es/framer-motion/dist/es/motion/utils/is-forced-motion-value.mjs

@@ -1,11 +0,0 @@
-import { scaleCorrectors } from '../../projection/styles/scale-correction.mjs';
-import { transformProps } from '../../../../../motion-dom/dist/es/render/utils/keys-transform.mjs';
-
-function isForcedMotionValue(key, { layout, layoutId }) {
-    return (transformProps.has(key) ||
-        key.startsWith("origin") ||
-        ((layout || layoutId !== undefined) &&
-            (!!scaleCorrectors[key] || key === "opacity")));
-}
-
-export { isForcedMotionValue };

package/dist/es/framer-motion/dist/es/motion/utils/is-motion-component.mjs

@@ -1,12 +0,0 @@
-import { motionComponentSymbol } from './symbol.mjs';
-
-/**
- * Checks if a component is a `motion` component.
- */
-function isMotionComponent(component) {
-    return (component !== null &&
-        typeof component === "object" &&
-        motionComponentSymbol in component);
-}
-
-export { isMotionComponent };

package/dist/es/framer-motion/dist/es/motion/utils/symbol.mjs

@@ -1,3 +0,0 @@
-const motionComponentSymbol = Symbol.for("motionComponentSymbol");
-
-export { motionComponentSymbol };

package/dist/es/framer-motion/dist/es/motion/utils/unwrap-motion-component.mjs

@@ -1,17 +0,0 @@
-import { isMotionComponent } from './is-motion-component.mjs';
-import { motionComponentSymbol } from './symbol.mjs';
-
-/**
- * Unwraps a `motion` component and returns either a string for `motion.div` or
- * the React component for `motion(Component)`.
- *
- * If the component is not a `motion` component it returns undefined.
- */
-function unwrapMotionComponent(component) {
-    if (isMotionComponent(component)) {
-        return component[motionComponentSymbol];
-    }
-    return undefined;
-}
-
-export { unwrapMotionComponent };

package/dist/es/framer-motion/dist/es/motion/utils/use-motion-ref.mjs

@@ -1,38 +0,0 @@
-import { useCallback } from 'react';
-import { isRefObject } from '../../utils/is-ref-object.mjs';
-
-/**
- * Creates a ref function that, when called, hydrates the provided
- * external ref and VisualElement.
- */
-function useMotionRef(visualState, visualElement, externalRef) {
-    return useCallback((instance) => {
-        if (instance) {
-            visualState.onMount && visualState.onMount(instance);
-        }
-        if (visualElement) {
-            if (instance) {
-                visualElement.mount(instance);
-            }
-            else {
-                visualElement.unmount();
-            }
-        }
-        if (externalRef) {
-            if (typeof externalRef === "function") {
-                externalRef(instance);
-            }
-            else if (isRefObject(externalRef)) {
-                externalRef.current = instance;
-            }
-        }
-    }, 
-    /**
-     * Only pass a new ref callback to React if we've received a visual element
-     * factory. Otherwise we'll be mounting/remounting every time externalRef
-     * or other dependencies change.
-     */
-    [visualElement]);
-}
-
-export { useMotionRef };

package/dist/es/framer-motion/dist/es/motion/utils/use-visual-element.mjs

@@ -1,133 +0,0 @@
-import { useContext, useRef, useInsertionEffect, useEffect } from 'react';
-import { optimizedAppearDataAttribute } from '../../animation/optimized-appear/data-id.mjs';
-import { LazyContext } from '../../context/LazyContext.mjs';
-import { MotionConfigContext } from '../../context/MotionConfigContext.mjs';
-import { MotionContext } from '../../context/MotionContext/index.mjs';
-import { PresenceContext } from '../../context/PresenceContext.mjs';
-import { SwitchLayoutGroupContext } from '../../context/SwitchLayoutGroupContext.mjs';
-import { isRefObject } from '../../utils/is-ref-object.mjs';
-import { useIsomorphicLayoutEffect } from '../../utils/use-isomorphic-effect.mjs';
-import { microtask } from '../../../../../motion-dom/dist/es/frameloop/microtask.mjs';
-
-function useVisualElement(Component, visualState, props, createVisualElement, ProjectionNodeConstructor) {
-    const { visualElement: parent } = useContext(MotionContext);
-    const lazyContext = useContext(LazyContext);
-    const presenceContext = useContext(PresenceContext);
-    const reducedMotionConfig = useContext(MotionConfigContext).reducedMotion;
-    const visualElementRef = useRef(null);
-    /**
-     * If we haven't preloaded a renderer, check to see if we have one lazy-loaded
-     */
-    createVisualElement = createVisualElement || lazyContext.renderer;
-    if (!visualElementRef.current && createVisualElement) {
-        visualElementRef.current = createVisualElement(Component, {
-            visualState,
-            parent,
-            props,
-            presenceContext,
-            blockInitialAnimation: presenceContext
-                ? presenceContext.initial === false
-                : false,
-            reducedMotionConfig,
-        });
-    }
-    const visualElement = visualElementRef.current;
-    /**
-     * Load Motion gesture and animation features. These are rendered as renderless
-     * components so each feature can optionally make use of React lifecycle methods.
-     */
-    const initialLayoutGroupConfig = useContext(SwitchLayoutGroupContext);
-    if (visualElement &&
-        !visualElement.projection &&
-        ProjectionNodeConstructor &&
-        (visualElement.type === "html" || visualElement.type === "svg")) {
-        createProjectionNode(visualElementRef.current, props, ProjectionNodeConstructor, initialLayoutGroupConfig);
-    }
-    const isMounted = useRef(false);
-    useInsertionEffect(() => {
-        /**
-         * Check the component has already mounted before calling
-         * `update` unnecessarily. This ensures we skip the initial update.
-         */
-        if (visualElement && isMounted.current) {
-            visualElement.update(props, presenceContext);
-        }
-    });
-    /**
-     * Cache this value as we want to know whether HandoffAppearAnimations
-     * was present on initial render - it will be deleted after this.
-     */
-    const optimisedAppearId = props[optimizedAppearDataAttribute];
-    const wantsHandoff = useRef(Boolean(optimisedAppearId) &&
-        !window.MotionHandoffIsComplete?.(optimisedAppearId) &&
-        window.MotionHasOptimisedAnimation?.(optimisedAppearId));
-    useIsomorphicLayoutEffect(() => {
-        if (!visualElement)
-            return;
-        isMounted.current = true;
-        window.MotionIsMounted = true;
-        visualElement.updateFeatures();
-        microtask.render(visualElement.render);
-        /**
-         * Ideally this function would always run in a useEffect.
-         *
-         * However, if we have optimised appear animations to handoff from,
-         * it needs to happen synchronously to ensure there's no flash of
-         * incorrect styles in the event of a hydration error.
-         *
-         * So if we detect a situtation where optimised appear animations
-         * are running, we use useLayoutEffect to trigger animations.
-         */
-        if (wantsHandoff.current && visualElement.animationState) {
-            visualElement.animationState.animateChanges();
-        }
-    });
-    useEffect(() => {
-        if (!visualElement)
-            return;
-        if (!wantsHandoff.current && visualElement.animationState) {
-            visualElement.animationState.animateChanges();
-        }
-        if (wantsHandoff.current) {
-            // This ensures all future calls to animateChanges() in this component will run in useEffect
-            queueMicrotask(() => {
-                window.MotionHandoffMarkAsComplete?.(optimisedAppearId);
-            });
-            wantsHandoff.current = false;
-        }
-    });
-    return visualElement;
-}
-function createProjectionNode(visualElement, props, ProjectionNodeConstructor, initialPromotionConfig) {
-    const { layoutId, layout, drag, dragConstraints, layoutScroll, layoutRoot, layoutCrossfade, } = props;
-    visualElement.projection = new ProjectionNodeConstructor(visualElement.latestValues, props["data-framer-portal-id"]
-        ? undefined
-        : getClosestProjectingNode(visualElement.parent));
-    visualElement.projection.setOptions({
-        layoutId,
-        layout,
-        alwaysMeasureLayout: Boolean(drag) || (dragConstraints && isRefObject(dragConstraints)),
-        visualElement,
-        /**
-         * TODO: Update options in an effect. This could be tricky as it'll be too late
-         * to update by the time layout animations run.
-         * We also need to fix this safeToRemove by linking it up to the one returned by usePresence,
-         * ensuring it gets called if there's no potential layout animations.
-         *
-         */
-        animationType: typeof layout === "string" ? layout : "both",
-        initialPromotionConfig,
-        crossfade: layoutCrossfade,
-        layoutScroll,
-        layoutRoot,
-    });
-}
-function getClosestProjectingNode(visualElement) {
-    if (!visualElement)
-        return undefined;
-    return visualElement.options.allowProjection !== false
-        ? visualElement.projection
-        : getClosestProjectingNode(visualElement.parent);
-}
-
-export { useVisualElement };