@wordpress/compose 7.39.1-next.v.202602111440.0 → 7.40.0

package/build-module/hooks/use-resize-observer/use-resize-observer.mjs

@@ -3,8 +3,8 @@ import { useRef } from "@wordpress/element";
 import useEvent from "../use-event/index.mjs";
 function useResizeObserver(callback, resizeObserverOptions = {}) {
   const callbackEvent = useEvent(callback);
-  const observedElementRef = useRef();
-  const resizeObserverRef = useRef();
+  const observedElementRef = useRef(null);
+  const resizeObserverRef = useRef(void 0);
   return useEvent((element) => {
     if (element === observedElementRef.current) {
       return;
@@ -14,7 +14,7 @@ function useResizeObserver(callback, resizeObserverOptions = {}) {
     if (observedElementRef.current) {
       resizeObserver.unobserve(observedElementRef.current);
     }
-    observedElementRef.current = element;
+    observedElementRef.current = element ?? null;
     if (element) {
       resizeObserver.observe(element, resizeObserverOptions);
     }

package/build-module/hooks/use-resize-observer/use-resize-observer.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/use-resize-observer/use-resize-observer.ts"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useRef } from '@wordpress/element';\n/**\n * Internal dependencies\n */\nimport useEvent from '../use-event';\n\n// This is the current implementation of `useResizeObserver`.\n//\n// The legacy implementation is still supported for backwards compatibility.\n// This is achieved by overloading the exported function with both signatures,\n// and detecting which API is being used at runtime.\nexport function useResizeObserver< T extends HTMLElement >(\n\tcallback: ResizeObserverCallback,\n\tresizeObserverOptions: ResizeObserverOptions = {}\n): ( element?: T | null ) => void {\n\tconst callbackEvent = useEvent( callback );\n\n\tconst observedElementRef = useRef< T | null >();\n\tconst resizeObserverRef = useRef< ResizeObserver >();\n\treturn useEvent( ( element?: T | null ) => {\n\t\tif ( element === observedElementRef.current ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Set up `ResizeObserver`.\n\t\tresizeObserverRef.current ??= new ResizeObserver( callbackEvent );\n\t\tconst { current: resizeObserver } = resizeObserverRef;\n\n\t\t// Unobserve previous element.\n\t\tif ( observedElementRef.current ) {\n\t\t\tresizeObserver.unobserve( observedElementRef.current );\n\t\t}\n\n\t\t// Observe new element.\n\t\tobservedElementRef.current = element;\n\t\tif ( element ) {\n\t\t\tresizeObserver.observe( element, resizeObserverOptions );\n\t\t}\n\t} );\n}\n"],
-  "mappings": ";AAGA,SAAS,cAAc;AAIvB,OAAO,cAAc;AAOd,SAAS,kBACf,UACA,wBAA+C,CAAC,GACf;AACjC,QAAM,gBAAgB,SAAU,QAAS;AAEzC,QAAM,qBAAqB,OAAmB;AAC9C,QAAM,oBAAoB,OAAyB;AACnD,SAAO,SAAU,CAAE,YAAwB;AAC1C,QAAK,YAAY,mBAAmB,SAAU;AAC7C;AAAA,IACD;AAGA,sBAAkB,YAAY,IAAI,eAAgB,aAAc;AAChE,UAAM,EAAE,SAAS,eAAe,IAAI;AAGpC,QAAK,mBAAmB,SAAU;AACjC,qBAAe,UAAW,mBAAmB,OAAQ;AAAA,IACtD;AAGA,uBAAmB,UAAU;AAC7B,QAAK,SAAU;AACd,qBAAe,QAAS,SAAS,qBAAsB;AAAA,IACxD;AAAA,EACD,CAAE;AACH;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useRef } from '@wordpress/element';\n/**\n * Internal dependencies\n */\nimport useEvent from '../use-event';\n\n// This is the current implementation of `useResizeObserver`.\n//\n// The legacy implementation is still supported for backwards compatibility.\n// This is achieved by overloading the exported function with both signatures,\n// and detecting which API is being used at runtime.\nexport function useResizeObserver< T extends HTMLElement >(\n\tcallback: ResizeObserverCallback,\n\tresizeObserverOptions: ResizeObserverOptions = {}\n): ( element?: T | null ) => void {\n\tconst callbackEvent = useEvent( callback );\n\n\tconst observedElementRef = useRef< T | null >( null );\n\tconst resizeObserverRef = useRef< ResizeObserver >( undefined );\n\treturn useEvent( ( element?: T | null ) => {\n\t\tif ( element === observedElementRef.current ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Set up `ResizeObserver`.\n\t\tresizeObserverRef.current ??= new ResizeObserver( callbackEvent );\n\t\tconst { current: resizeObserver } = resizeObserverRef;\n\n\t\t// Unobserve previous element.\n\t\tif ( observedElementRef.current ) {\n\t\t\tresizeObserver.unobserve( observedElementRef.current );\n\t\t}\n\n\t\t// Observe new element.\n\t\tobservedElementRef.current = element ?? null;\n\t\tif ( element ) {\n\t\t\tresizeObserver.observe( element, resizeObserverOptions );\n\t\t}\n\t} );\n}\n"],
+  "mappings": ";AAGA,SAAS,cAAc;AAIvB,OAAO,cAAc;AAOd,SAAS,kBACf,UACA,wBAA+C,CAAC,GACf;AACjC,QAAM,gBAAgB,SAAU,QAAS;AAEzC,QAAM,qBAAqB,OAAoB,IAAK;AACpD,QAAM,oBAAoB,OAA0B,MAAU;AAC9D,SAAO,SAAU,CAAE,YAAwB;AAC1C,QAAK,YAAY,mBAAmB,SAAU;AAC7C;AAAA,IACD;AAGA,sBAAkB,YAAY,IAAI,eAAgB,aAAc;AAChE,UAAM,EAAE,SAAS,eAAe,IAAI;AAGpC,QAAK,mBAAmB,SAAU;AACjC,qBAAe,UAAW,mBAAmB,OAAQ;AAAA,IACtD;AAGA,uBAAmB,UAAU,WAAW;AACxC,QAAK,SAAU;AACd,qBAAe,QAAS,SAAS,qBAAsB;AAAA,IACxD;AAAA,EACD,CAAE;AACH;",
   "names": []
 }

package/build-types/hooks/use-constrained-tabbing/index.d.ts

@@ -3,7 +3,7 @@ export default useConstrainedTabbing;
  * In Dialogs/modals, the tabbing must be constrained to the content of
  * the wrapper element. This hook adds the behavior to the returned ref.
  *
- * @return {import('react').RefCallback<Element>} Element Ref.
+ * @return {React.RefCallback<Element>} Element Ref.
  *
  * @example
  * ```js
@@ -20,5 +20,5 @@ export default useConstrainedTabbing;
  * }
  * ```
  */
-declare function useConstrainedTabbing(): import("react").RefCallback<Element>;
+declare function useConstrainedTabbing(): React.RefCallback<Element>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-constrained-tabbing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-constrained-tabbing/index.js"],"names":[],"mappings":";AAUA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,0CAjBY,OAAO,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CA2E/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-constrained-tabbing/index.js"],"names":[],"mappings":";AAUA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,0CAjBY,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CA2ErC"}

package/build-types/hooks/use-copy-on-click/index.d.ts

@@ -3,13 +3,13 @@
  *
  * @deprecated
  *
- * @param {import('react').RefObject<string | Element | NodeListOf<Element>>} ref       Reference with the element.
- * @param {string|Function}                                                   text      The text to copy.
- * @param {number}                                                            [timeout] Optional timeout to reset the returned
- *                                                                                      state. 4 seconds by default.
+ * @param {React.RefObject<string | Element | NodeListOf<Element>>} ref       Reference with the element.
+ * @param {string|Function}                                         text      The text to copy.
+ * @param {number}                                                  [timeout] Optional timeout to reset the returned
+ *                                                                            state. 4 seconds by default.
  *
  * @return {boolean} Whether or not the text has been copied. Resets after the
  *                   timeout.
  */
-export default function useCopyOnClick(ref: import("react").RefObject<string | Element | NodeListOf<Element>>, text: string | Function, timeout?: number): boolean;
+export default function useCopyOnClick(ref: React.RefObject<string | Element | NodeListOf<Element>>, text: string | Function, timeout?: number): boolean;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-copy-on-click/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-copy-on-click/index.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,4CARW,OAAO,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,QACjE,MAAM,WAAS,YACf,MAAM,GAGL,OAAO,CAqDlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-copy-on-click/index.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,4CARW,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,QACvD,MAAM,WAAS,YACf,MAAM,GAGL,OAAO,CAqDlB"}

package/build-types/hooks/use-copy-to-clipboard/index.d.ts

@@ -6,7 +6,7 @@
  *                                            already available and expensive to compute.
  * @param {Function}                onSuccess Called when to text is copied.
  *
- * @return {import('react').Ref<TElementType>} A ref to assign to the target element.
+ * @return {React.Ref<TElementType>} A ref to assign to the target element.
  */
-export default function useCopyToClipboard<TElementType extends HTMLElement>(text: string | (() => string), onSuccess: Function): import("react").Ref<TElementType>;
+export default function useCopyToClipboard<TElementType extends HTMLElement>(text: string | (() => string), onSuccess: Function): React.Ref<TElementType>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-copy-to-clipboard/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-copy-to-clipboard/index.js"],"names":[],"mappings":"AA4BA;;;;;;;;;GASG;AACH,2CAP2B,YAAY,SAAzB,WAAY,QACf,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,wBAItB,OAAO,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,CAgC5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-copy-to-clipboard/index.js"],"names":[],"mappings":"AA4BA;;;;;;;;;GASG;AACH,2CAP2B,YAAY,SAAzB,WAAY,QACf,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,wBAItB,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAgClC"}

package/build-types/hooks/use-disabled/index.d.ts

@@ -7,7 +7,7 @@
  *
  * @param {Object}   config            Configuration object.
  * @param {boolean=} config.isDisabled Whether the element should be disabled.
- * @return {import('react').RefCallback<HTMLElement>} Element Ref.
+ * @return {React.RefCallback<HTMLElement>} Element Ref.
  *
  * @example
  * ```js

package/build-types/hooks/use-dragging/index.d.ts

@@ -1,15 +1,15 @@
 /**
- * @param {Object}                                  props
- * @param {(e: import('react').MouseEvent) => void} props.onDragStart
- * @param {(e: MouseEvent) => void}                 props.onDragMove
- * @param {(e?: MouseEvent) => void}                props.onDragEnd
+ * @param {Object}                        props
+ * @param {(e: React.MouseEvent) => void} props.onDragStart
+ * @param {(e: MouseEvent) => void}       props.onDragMove
+ * @param {(e?: MouseEvent) => void}      props.onDragEnd
  */
 export default function useDragging({ onDragStart, onDragMove, onDragEnd }: {
-    onDragStart: (e: import("react").MouseEvent) => void;
+    onDragStart: (e: React.MouseEvent) => void;
     onDragMove: (e: MouseEvent) => void;
     onDragEnd: (e?: MouseEvent) => void;
 }): {
-    startDrag: (e: import("react").MouseEvent) => void;
+    startDrag: (e: React.MouseEvent) => void;
     endDrag: (e?: MouseEvent) => void;
     isDragging: boolean;
 };

package/build-types/hooks/use-dragging/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-dragging/index.js"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,4EAJG;IAAuD,WAAW,EAA1D,CAAC,CAAC,EAAE,OAAO,OAAO,EAAE,UAAU,KAAK,IAAI;IACQ,UAAU,EAAzD,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI;IACwB,SAAS,EAAxD,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI;CAClC;mBA+Be,OAAO,OAAO,EAAE,UAAU,KAAK,IAAI;kBATlC,UAAU,KAAK,IAAI;;EAkCnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-dragging/index.js"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,4EAJG;IAA6C,WAAW,EAAhD,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI;IACQ,UAAU,EAA/C,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI;IACc,SAAS,EAA9C,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI;CAClC;mBA+Be,KAAK,CAAC,UAAU,KAAK,IAAI;kBATxB,UAAU,KAAK,IAAI;;EAkCnC"}

package/build-types/hooks/use-drop-zone/index.d.ts

@@ -11,7 +11,7 @@
  * @param {(e: MouseEvent) => void} [props.onDragEnd]       Called when dragging has ended.
  * @param {(e: DragEvent) => void}  [props.onDrop]          Called when dropping in the zone.
  *
- * @return {import('react').RefCallback<HTMLElement>} Ref callback to be passed to the drop zone element.
+ * @return {React.RefCallback<HTMLElement>} Ref callback to be passed to the drop zone element.
  */
 export default function useDropZone({ dropZoneElement, isDisabled, onDrop: _onDrop, onDragStart: _onDragStart, onDragEnter: _onDragEnter, onDragLeave: _onDragLeave, onDragEnd: _onDragEnd, onDragOver: _onDragOver, }: {
     dropZoneElement?: HTMLElement | null | undefined;
@@ -22,5 +22,5 @@ export default function useDropZone({ dropZoneElement, isDisabled, onDrop: _onDr
     onDragLeave?: ((e: DragEvent) => void) | undefined;
     onDragEnd?: ((e: MouseEvent) => void) | undefined;
     onDrop?: ((e: DragEvent) => void) | undefined;
-}): import("react").RefCallback<HTMLElement>;
+}): React.RefCallback<HTMLElement>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-drop-zone/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-drop-zone/index.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,wNAXG;IAAwC,eAAe;IACf,UAAU;IACV,WAAW,QAAvC,SAAS,KAAK,IAAI;IACU,WAAW,QAAvC,SAAS,KAAK,IAAI;IACU,UAAU,QAAtC,SAAS,KAAK,IAAI;IACU,WAAW,QAAvC,SAAS,KAAK,IAAI;IACU,SAAS,QAArC,UAAU,KAAK,IAAI;IACS,MAAM,QAAlC,SAAS,KAAK,IAAI;CAE9B,GAAS,OAAO,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CAoMnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-drop-zone/index.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,wNAXG;IAAwC,eAAe;IACf,UAAU;IACV,WAAW,QAAvC,SAAS,KAAK,IAAI;IACU,WAAW,QAAvC,SAAS,KAAK,IAAI;IACU,UAAU,QAAtC,SAAS,KAAK,IAAI;IACU,WAAW,QAAvC,SAAS,KAAK,IAAI;IACU,SAAS,QAArC,UAAU,KAAK,IAAI;IACS,MAAM,QAAlC,SAAS,KAAK,IAAI;CAE9B,GAAS,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAoMzC"}

package/build-types/hooks/use-fixed-window-list/index.d.ts

@@ -16,13 +16,13 @@
  */
 /**
  *
- * @param {import('react').RefObject<HTMLElement>} elementRef Used to find the closest scroll container that contains element.
- * @param { number }                               itemHeight Fixed item height in pixels
- * @param { number }                               totalItems Total items in list
- * @param { WPFixedWindowListOptions }             [options]  Options object
+ * @param {React.RefObject<HTMLElement>} elementRef Used to find the closest scroll container that contains element.
+ * @param { number }                     itemHeight Fixed item height in pixels
+ * @param { number }                     totalItems Total items in list
+ * @param { WPFixedWindowListOptions }   [options]  Options object
  * @return {[ WPFixedWindowList, setFixedListWindow:(nextWindow:WPFixedWindowList)=>void]} Array with the fixed window list and setter
  */
-export default function useFixedWindowList(elementRef: import("react").RefObject<HTMLElement>, itemHeight: number, totalItems: number, options?: WPFixedWindowListOptions): [WPFixedWindowList, setFixedListWindow: (nextWindow: WPFixedWindowList) => void];
+export default function useFixedWindowList(elementRef: React.RefObject<HTMLElement>, itemHeight: number, totalItems: number, options?: WPFixedWindowListOptions): [WPFixedWindowList, setFixedListWindow: (nextWindow: WPFixedWindowList) => void];
 export type WPFixedWindowList = {
     /**
      * Items visible in the current viewport

package/build-types/hooks/use-fixed-window-list/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-fixed-window-list/index.js"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,uDANW,OAAO,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,cACrC,MAAM,cACN,MAAM,YACN,wBAAwB,GACxB,CAAE,iBAAiB,EAAE,kBAAkB,EAAC,CAAC,UAAU,EAAC,iBAAiB,KAAG,IAAI,CAAC,CA0JxF;;;;;kBA/Ka,MAAM;;;;WACN,MAAM;;;;SACN,MAAM;;;;gBACN,CAAC,KAAK,EAAC,MAAM,KAAG,OAAO;;;;;;;;;;;;;;;;;;oBASvB,GAAG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-fixed-window-list/index.js"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,uDANW,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,cAC3B,MAAM,cACN,MAAM,YACN,wBAAwB,GACxB,CAAE,iBAAiB,EAAE,kBAAkB,EAAC,CAAC,UAAU,EAAC,iBAAiB,KAAG,IAAI,CAAC,CA0JxF;;;;;kBA/Ka,MAAM;;;;WACN,MAAM;;;;SACN,MAAM;;;;gBACN,CAAC,KAAK,EAAC,MAAM,KAAG,OAAO;;;;;;;;;;;;;;;;;;oBASvB,GAAG"}

package/build-types/hooks/use-focus-on-mount/index.d.ts

@@ -2,7 +2,7 @@
  * Hook used to focus the first tabbable element on mount.
  *
  * @param {boolean | 'firstElement' | 'firstInputElement'} focusOnMount Focus on mount mode.
- * @return {import('react').RefCallback<HTMLElement>} Ref callback.
+ * @return {React.RefCallback<HTMLElement>} Ref callback.
  *
  * @example
  * ```js
@@ -19,5 +19,5 @@
  * }
  * ```
  */
-export default function useFocusOnMount(focusOnMount?: boolean | "firstElement" | "firstInputElement"): import("react").RefCallback<HTMLElement>;
+export default function useFocusOnMount(focusOnMount?: boolean | "firstElement" | "firstInputElement"): React.RefCallback<HTMLElement>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-focus-on-mount/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-focus-on-mount/index.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uDAlBW,OAAO,GAAG,cAAc,GAAG,mBAAmB,GAC7C,OAAO,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CA4FnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-focus-on-mount/index.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uDAlBW,OAAO,GAAG,cAAc,GAAG,mBAAmB,GAC7C,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CA4FzC"}

package/build-types/hooks/use-focus-return/index.d.ts

@@ -4,7 +4,7 @@ export default useFocusReturn;
  * previously as is expected for roles like menus or dialogs.
  *
  * @param {() => void} [onFocusReturn] Overrides the default return behavior.
- * @return {import('react').RefCallback<HTMLElement>} Element Ref.
+ * @return {React.RefCallback<HTMLElement>} Element Ref.
  *
  * @example
  * ```js
@@ -21,5 +21,5 @@ export default useFocusReturn;
  * }
  * ```
  */
-declare function useFocusReturn(onFocusReturn?: () => void): import("react").RefCallback<HTMLElement>;
+declare function useFocusReturn(onFocusReturn?: () => void): React.RefCallback<HTMLElement>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-focus-return/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-focus-return/index.js"],"names":[],"mappings":";AAQA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,gDAlBW,MAAM,IAAI,GACT,OAAO,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CAsEnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-focus-return/index.js"],"names":[],"mappings":";AAQA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,gDAlBW,MAAM,IAAI,GACT,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAsEzC"}

package/build-types/hooks/use-keyboard-shortcut/index.d.ts

@@ -18,26 +18,27 @@ export type WPKeyboardShortcutConfig = {
     /**
      * React reference to the DOM element used to catch the keyboard event.
      */
-    target?: import("react").RefObject<HTMLElement> | undefined;
+    target?: import("react").RefObject<HTMLElement | null> | undefined;
 };
 /**
  * A block selection object.
  *
  * @typedef {Object} WPKeyboardShortcutConfig
  *
- * @property {boolean}                                [bindGlobal] Handle keyboard events anywhere including inside textarea/input fields.
- * @property {string}                                 [eventName]  Event name used to trigger the handler, defaults to keydown.
- * @property {boolean}                                [isDisabled] Disables the keyboard handler if the value is true.
- * @property {import('react').RefObject<HTMLElement>} [target]     React reference to the DOM element used to catch the keyboard event.
+ * @property {boolean}                             [bindGlobal] Handle keyboard events anywhere including inside textarea/input fields.
+ * @property {string}                              [eventName]  Event name used to trigger the handler, defaults to keydown.
+ * @property {boolean}                             [isDisabled] Disables the keyboard handler if the value is true.
+ * @property {React.RefObject<HTMLElement | null>} [target]     React reference to the DOM element used to catch the keyboard event.
  */
 /**
  * Attach a keyboard shortcut handler.
  *
  * @see https://craig.is/killing/mice#api.bind for information about the `callback` parameter.
  *
- * @param {string[]|string}                                                       shortcuts Keyboard Shortcuts.
- * @param {(e: import('mousetrap').ExtendedKeyboardEvent, combo: string) => void} callback  Shortcut callback.
- * @param {WPKeyboardShortcutConfig}                                              options   Shortcut options.
+ * @param {string[]|string}                                             shortcuts Keyboard Shortcuts.
+ * @param {(e: Mousetrap.ExtendedKeyboardEvent, combo: string) => void} callback  Shortcut callback.
+ * @param {WPKeyboardShortcutConfig}                                    options   Shortcut options.
  */
-declare function useKeyboardShortcut(shortcuts: string[] | string, callback: (e: import("mousetrap").ExtendedKeyboardEvent, combo: string) => void, { bindGlobal, eventName, isDisabled, target, }?: WPKeyboardShortcutConfig): void;
+declare function useKeyboardShortcut(shortcuts: string[] | string, callback: (e: Mousetrap.ExtendedKeyboardEvent, combo: string) => void, { bindGlobal, eventName, isDisabled, target, }?: WPKeyboardShortcutConfig): void;
+import Mousetrap from 'mousetrap';
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-keyboard-shortcut/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-keyboard-shortcut/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAYA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,gDAJW,MAAM,EAAE,GAAC,MAAM,YACf,CAAC,CAAC,EAAE,OAAO,WAAW,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,mDACrE,wBAAwB,QAqElC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-keyboard-shortcut/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAYA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,gDAJW,MAAM,EAAE,GAAC,MAAM,YACf,CAAC,CAAC,EAAE,SAAS,CAAC,qBAAqB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,mDAC3D,wBAAwB,QAqElC;sBAhGqB,WAAW"}

package/build-types/hooks/use-merge-refs/index.d.ts

@@ -1,3 +1,4 @@
+import type { Ref, RefCallback } from 'react';
 /**
  * Merges refs into one ref callback.
  *
@@ -36,11 +37,8 @@
  * return <div ref={ mergedRefs } />;
  * ```
  *
- * @template {import('react').Ref<any>} TRef
- * @param {Array<TRef>} refs The refs to be merged.
- *
- * @return {import('react').RefCallback<TypeFromRef<TRef>>} The merged ref callback.
+ * @param refs The refs to be merged.
+ * @return The merged ref callback.
  */
-export default function useMergeRefs<TRef extends import("react").Ref<any>>(refs: Array<TRef>): import("react").RefCallback<TypeFromRef<TRef>>;
-export type TypeFromRef<T> = T extends import("react").Ref<infer R> ? R : never;
+export default function useMergeRefs<T>(refs: Ref<T>[]): RefCallback<T>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/hooks/use-merge-refs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-merge-refs/index.js"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qCALwC,IAAI,SAA/B,OAAQ,OAAO,EAAE,GAAG,CAAC,GAAG,CAAE,QAC5B,KAAK,CAAC,IAAI,CAAC,GAEV,OAAO,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CA6DzD;wBAxHY,CAAC,IACD,CAAC,SAAS,OAAO,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-merge-refs/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,GAAG,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAUhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAE,CAAC,EACtC,IAAI,EAAE,GAAG,CAAE,CAAC,CAAE,EAAE,GACd,WAAW,CAAE,CAAC,CAAE,CA0DlB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/compose",
-	"version": "7.39.1-next.v.202602111440.0+a307a2e35",
+	"version": "7.40.0",
 	"description": "WordPress higher-order components (HOCs).",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -47,13 +47,13 @@
 	"sideEffects": false,
 	"dependencies": {
 		"@types/mousetrap": "^1.6.8",
-		"@wordpress/deprecated": "^4.39.1-next.v.202602111440.0+a307a2e35",
-		"@wordpress/dom": "^4.39.1-next.v.202602111440.0+a307a2e35",
-		"@wordpress/element": "^6.39.1-next.v.202602111440.0+a307a2e35",
-		"@wordpress/is-shallow-equal": "^5.39.1-next.v.202602111440.0+a307a2e35",
-		"@wordpress/keycodes": "^4.39.1-next.v.202602111440.0+a307a2e35",
-		"@wordpress/priority-queue": "^3.39.1-next.v.202602111440.0+a307a2e35",
-		"@wordpress/undo-manager": "^1.39.1-next.v.202602111440.0+a307a2e35",
+		"@wordpress/deprecated": "^4.40.0",
+		"@wordpress/dom": "^4.40.0",
+		"@wordpress/element": "^6.40.0",
+		"@wordpress/is-shallow-equal": "^5.40.0",
+		"@wordpress/keycodes": "^4.40.0",
+		"@wordpress/priority-queue": "^3.40.0",
+		"@wordpress/undo-manager": "^1.40.0",
 		"change-case": "^4.1.2",
 		"clipboard": "^2.0.11",
 		"mousetrap": "^1.6.5",
@@ -68,5 +68,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "e0a2324a9690e55f4101d61113f4bbbf240b55ed"
+	"gitHead": "376124aa10dbc2cc0c81c964ec00b99fcfee5382"
 }

package/src/hooks/use-constrained-tabbing/index.js

@@ -12,7 +12,7 @@ import useRefEffect from '../use-ref-effect';
  * In Dialogs/modals, the tabbing must be constrained to the content of
  * the wrapper element. This hook adds the behavior to the returned ref.
  *
- * @return {import('react').RefCallback<Element>} Element Ref.
+ * @return {React.RefCallback<Element>} Element Ref.
  *
  * @example
  * ```js

package/src/hooks/use-copy-on-click/index.js

@@ -14,10 +14,10 @@ import deprecated from '@wordpress/deprecated';
  *
  * @deprecated
  *
- * @param {import('react').RefObject<string | Element | NodeListOf<Element>>} ref       Reference with the element.
- * @param {string|Function}                                                   text      The text to copy.
- * @param {number}                                                            [timeout] Optional timeout to reset the returned
- *                                                                                      state. 4 seconds by default.
+ * @param {React.RefObject<string | Element | NodeListOf<Element>>} ref       Reference with the element.
+ * @param {string|Function}                                         text      The text to copy.
+ * @param {number}                                                  [timeout] Optional timeout to reset the returned
+ *                                                                            state. 4 seconds by default.
  *
  * @return {boolean} Whether or not the text has been copied. Resets after the
  *                   timeout.
@@ -28,8 +28,8 @@ export default function useCopyOnClick( ref, text, timeout = 4000 ) {
 		alternative: 'wp.compose.useCopyToClipboard',
 	} );
 
-	/** @type {import('react').MutableRefObject<Clipboard | undefined>} */
-	const clipboardRef = useRef();
+	/** @type {React.MutableRefObject<Clipboard | undefined>} */
+	const clipboardRef = useRef( undefined );
 	const [ hasCopied, setHasCopied ] = useState( false );
 
 	useEffect( () => {

package/src/hooks/use-copy-to-clipboard/index.js

@@ -16,7 +16,7 @@ import useRefEffect from '../use-ref-effect';
 /**
  * @template T
  * @param {T} value
- * @return {import('react').RefObject<T>} The updated ref
+ * @return {React.RefObject<T>} The updated ref
  */
 function useUpdatedRef( value ) {
 	const ref = useRef( value );
@@ -34,7 +34,7 @@ function useUpdatedRef( value ) {
  *                                            already available and expensive to compute.
  * @param {Function}                onSuccess Called when to text is copied.
  *
- * @return {import('react').Ref<TElementType>} A ref to assign to the target element.
+ * @return {React.Ref<TElementType>} A ref to assign to the target element.
  */
 export default function useCopyToClipboard( text, onSuccess ) {
 	// Store the dependencies as refs and continuously update them so they're

package/src/hooks/use-dialog/index.ts

@@ -66,7 +66,7 @@ type useDialogReturn = [
  * @param options Dialog Options.
  */
 function useDialog( options: DialogOptions ): useDialogReturn {
-	const currentOptions = useRef< DialogOptions | undefined >();
+	const currentOptions = useRef< DialogOptions >( undefined );
 	const { constrainTabbing = options.focusOnMount !== false } = options;
 	useEffect( () => {
 		currentOptions.current = options;

package/src/hooks/use-disabled/index.ts

@@ -13,7 +13,7 @@ import useRefEffect from '../use-ref-effect';
  *
  * @param {Object}   config            Configuration object.
  * @param {boolean=} config.isDisabled Whether the element should be disabled.
- * @return {import('react').RefCallback<HTMLElement>} Element Ref.
+ * @return {React.RefCallback<HTMLElement>} Element Ref.
  *
  * @example
  * ```js

package/src/hooks/use-dragging/index.js

@@ -11,10 +11,10 @@ import useIsomorphicLayoutEffect from '../use-isomorphic-layout-effect';
 // Event handlers that are triggered from `document` listeners accept a MouseEvent,
 // while those triggered from React listeners accept a React.MouseEvent.
 /**
- * @param {Object}                                  props
- * @param {(e: import('react').MouseEvent) => void} props.onDragStart
- * @param {(e: MouseEvent) => void}                 props.onDragMove
- * @param {(e?: MouseEvent) => void}                props.onDragEnd
+ * @param {Object}                        props
+ * @param {(e: React.MouseEvent) => void} props.onDragStart
+ * @param {(e: MouseEvent) => void}       props.onDragMove
+ * @param {(e?: MouseEvent) => void}      props.onDragEnd
  */
 export default function useDragging( { onDragStart, onDragMove, onDragEnd } ) {
 	const [ isDragging, setIsDragging ] = useState( false );
@@ -46,7 +46,7 @@ export default function useDragging( { onDragStart, onDragMove, onDragEnd } ) {
 		document.removeEventListener( 'mouseup', endDrag );
 		setIsDragging( false );
 	}, [] );
-	/** @type {(e: import('react').MouseEvent) => void} */
+	/** @type {(e: React.MouseEvent) => void} */
 	const startDrag = useCallback( ( event ) => {
 		if ( eventsRef.current.onDragStart ) {
 			eventsRef.current.onDragStart( event );

package/src/hooks/use-drop-zone/index.js

@@ -17,7 +17,7 @@ import useEvent from '../use-event';
  * @param {(e: MouseEvent) => void} [props.onDragEnd]       Called when dragging has ended.
  * @param {(e: DragEvent) => void}  [props.onDrop]          Called when dropping in the zone.
  *
- * @return {import('react').RefCallback<HTMLElement>} Ref callback to be passed to the drop zone element.
+ * @return {React.RefCallback<HTMLElement>} Ref callback to be passed to the drop zone element.
  */
 export default function useDropZone( {
 	dropZoneElement,

package/src/hooks/use-fixed-window-list/index.js

@@ -32,10 +32,10 @@ const DEFAULT_INIT_WINDOW_SIZE = 30;
 
 /**
  *
- * @param {import('react').RefObject<HTMLElement>} elementRef Used to find the closest scroll container that contains element.
- * @param { number }                               itemHeight Fixed item height in pixels
- * @param { number }                               totalItems Total items in list
- * @param { WPFixedWindowListOptions }             [options]  Options object
+ * @param {React.RefObject<HTMLElement>} elementRef Used to find the closest scroll container that contains element.
+ * @param { number }                     itemHeight Fixed item height in pixels
+ * @param { number }                     totalItems Total items in list
+ * @param { WPFixedWindowListOptions }   [options]  Options object
  * @return {[ WPFixedWindowList, setFixedListWindow:(nextWindow:WPFixedWindowList)=>void]} Array with the fixed window list and setter
  */
 export default function useFixedWindowList(

package/src/hooks/use-focus-on-mount/index.js

@@ -13,7 +13,7 @@ import useRefEffect from '../use-ref-effect';
  * Hook used to focus the first tabbable element on mount.
  *
  * @param {boolean | 'firstElement' | 'firstInputElement'} focusOnMount Focus on mount mode.
- * @return {import('react').RefCallback<HTMLElement>} Ref callback.
+ * @return {React.RefCallback<HTMLElement>} Ref callback.
  *
  * @example
  * ```js
@@ -48,8 +48,8 @@ export default function useFocusOnMount( focusOnMount = 'firstElement' ) {
 		} );
 	};
 
-	/** @type {import('react').MutableRefObject<ReturnType<setTimeout> | undefined>} */
-	const timerIdRef = useRef();
+	/** @type {React.MutableRefObject<ReturnType<setTimeout> | undefined>} */
+	const timerIdRef = useRef( undefined );
 
 	useEffect( () => {
 		focusOnMountRef.current = focusOnMount;

package/src/hooks/use-focus-outside/index.native.js

@@ -41,7 +41,7 @@ function isFocusNormalizedButton( eventTarget ) {
 }
 
 /**
- * @typedef {import('react').SyntheticEvent} SyntheticEvent
+ * @typedef {React.SyntheticEvent} SyntheticEvent
  */
 
 /**
@@ -55,7 +55,7 @@ function isFocusNormalizedButton( eventTarget ) {
  */
 
 /**
- * @typedef {import('react').MutableRefObject<FocusOutsideReactElement | undefined>} FocusOutsideRef
+ * @typedef {React.MutableRefObject<FocusOutsideReactElement | undefined>} FocusOutsideRef
  */
 
 /**
@@ -88,7 +88,7 @@ export default function useFocusOutside( onFocusOutside ) {
 	const preventBlurCheck = useRef( false );
 
 	/**
-	 * @type {import('react').MutableRefObject<number | undefined>}
+	 * @type {React.MutableRefObject<number | undefined>}
 	 */
 	const blurCheckTimeoutId = useRef();
 

package/src/hooks/use-focus-outside/index.ts

@@ -78,7 +78,7 @@ export default function useFocusOutside(
 
 	const preventBlurCheckRef = useRef( false );
 
-	const blurCheckTimeoutIdRef = useRef< number | undefined >();
+	const blurCheckTimeoutIdRef = useRef< number >( undefined );
 
 	/**
 	 * Cancel a blur check timeout.

package/src/hooks/use-focus-return/index.js

@@ -11,7 +11,7 @@ let origin = null;
  * previously as is expected for roles like menus or dialogs.
  *
  * @param {() => void} [onFocusReturn] Overrides the default return behavior.
- * @return {import('react').RefCallback<HTMLElement>} Element Ref.
+ * @return {React.RefCallback<HTMLElement>} Element Ref.
  *
  * @example
  * ```js
@@ -29,9 +29,9 @@ let origin = null;
  * ```
  */
 function useFocusReturn( onFocusReturn ) {
-	/** @type {import('react').MutableRefObject<null | HTMLElement>} */
+	/** @type {React.MutableRefObject<null | HTMLElement>} */
 	const ref = useRef( null );
-	/** @type {import('react').MutableRefObject<null | Element>} */
+	/** @type {React.MutableRefObject<null | Element>} */
 	const focusedBeforeMount = useRef( null );
 	const onFocusReturnRef = useRef( onFocusReturn );
 	useEffect( () => {

package/src/hooks/use-keyboard-shortcut/index.js

@@ -15,10 +15,10 @@ import { isAppleOS } from '@wordpress/keycodes';
  *
  * @typedef {Object} WPKeyboardShortcutConfig
  *
- * @property {boolean}                                [bindGlobal] Handle keyboard events anywhere including inside textarea/input fields.
- * @property {string}                                 [eventName]  Event name used to trigger the handler, defaults to keydown.
- * @property {boolean}                                [isDisabled] Disables the keyboard handler if the value is true.
- * @property {import('react').RefObject<HTMLElement>} [target]     React reference to the DOM element used to catch the keyboard event.
+ * @property {boolean}                             [bindGlobal] Handle keyboard events anywhere including inside textarea/input fields.
+ * @property {string}                              [eventName]  Event name used to trigger the handler, defaults to keydown.
+ * @property {boolean}                             [isDisabled] Disables the keyboard handler if the value is true.
+ * @property {React.RefObject<HTMLElement | null>} [target]     React reference to the DOM element used to catch the keyboard event.
  */
 
 /**
@@ -26,9 +26,9 @@ import { isAppleOS } from '@wordpress/keycodes';
  *
  * @see https://craig.is/killing/mice#api.bind for information about the `callback` parameter.
  *
- * @param {string[]|string}                                                       shortcuts Keyboard Shortcuts.
- * @param {(e: import('mousetrap').ExtendedKeyboardEvent, combo: string) => void} callback  Shortcut callback.
- * @param {WPKeyboardShortcutConfig}                                              options   Shortcut options.
+ * @param {string[]|string}                                             shortcuts Keyboard Shortcuts.
+ * @param {(e: Mousetrap.ExtendedKeyboardEvent, combo: string) => void} callback  Shortcut callback.
+ * @param {WPKeyboardShortcutConfig}                                    options   Shortcut options.
  */
 function useKeyboardShortcut(
 	shortcuts,