framer-motion 12.24.2 → 12.24.4

package/dist/cjs/client.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var featureBundle = require('./feature-bundle-DBjkFz2c.js');
+var featureBundle = require('./feature-bundle-BwaqZAbT.js');
 require('react');
 require('motion-dom');
 require('motion-utils');

package/dist/cjs/{feature-bundle-DBjkFz2c.js → feature-bundle-BwaqZAbT.js}

@@ -4103,11 +4103,26 @@ function isRefObject(ref) {
         Object.prototype.hasOwnProperty.call(ref, "current"));
 }
 
+/**
+ * Set a given ref to a given value
+ * This utility takes care of different types of refs: callback refs and RefObject(s)
+ * Returns a cleanup function if the ref callback returns one (React 19 feature)
+ */
+function setRef(ref, value) {
+    if (typeof ref === "function") {
+        return ref(value);
+    }
+    else if (isRefObject(ref)) {
+        ref.current = value;
+    }
+}
 /**
  * Creates a ref function that, when called, hydrates the provided
  * external ref and VisualElement.
  */
 function useMotionRef(visualState, visualElement, externalRef) {
+    // Store the cleanup function from external ref if it returns one
+    const externalRefCleanupRef = React.useRef(null);
     return React.useCallback((instance) => {
         if (instance) {
             visualState.onMount && visualState.onMount(instance);
@@ -4121,19 +4136,30 @@ function useMotionRef(visualState, visualElement, externalRef) {
             }
         }
         if (externalRef) {
-            if (typeof externalRef === "function") {
-                externalRef(instance);
+            if (instance) {
+                // Mount: call the external ref and store any cleanup function
+                const cleanup = setRef(externalRef, instance);
+                if (typeof cleanup === "function") {
+                    externalRefCleanupRef.current = cleanup;
+                }
             }
-            else if (isRefObject(externalRef)) {
-                externalRef.current = instance;
+            else {
+                // Unmount: call stored cleanup function if available, otherwise call ref with null
+                if (externalRefCleanupRef.current) {
+                    externalRefCleanupRef.current();
+                    externalRefCleanupRef.current = null;
+                }
+                else {
+                    // Fallback to React <19 behavior for refs that don't return cleanup
+                    setRef(externalRef, instance);
+                }
             }
         }
     }, 
     /**
-     * Include externalRef in dependencies to ensure the callback updates
-     * when the ref changes, allowing proper ref forwarding.
+     * Include all dependencies to ensure the callback updates correctly
      */
-    [visualElement]);
+    [visualElement, visualState, externalRef]);
 }
 
 /**
@@ -6325,4 +6351,4 @@ exports.useIsPresent = useIsPresent;
 exports.useIsomorphicLayoutEffect = useIsomorphicLayoutEffect;
 exports.usePresence = usePresence;
 exports.visualElementStore = visualElementStore;
-//# sourceMappingURL=feature-bundle-DBjkFz2c.js.map
+//# sourceMappingURL=feature-bundle-BwaqZAbT.js.map