framer-motion 12.24.3 → 12.24.4

package/dist/cjs/index.js

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

package/dist/cjs/m.js

@@ -856,11 +856,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);
@@ -874,19 +889,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]);
 }
 
 /**