@dxos/react-hooks 0.8.4-main.5ad4a44 → 0.8.4-main.66e292d

package/dist/types/src/useControlledState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useControlledState.d.ts","sourceRoot":"","sources":["../../../src/useControlledState.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAuB,MAAM,OAAO,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,iBAAiB,CAAC,EAClB,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC7B,GAAG,MAAM,GAAG,EAAE,KACb,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAajC,CAAC"}
+{"version":3,"file":"useControlledState.d.ts","sourceRoot":"","sources":["../../../src/useControlledState.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAA4C,MAAM,OAAO,CAAC;AAIrG;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,YAAY,CAAC,EACb,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAC5B,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAkBjC,CAAC"}

package/dist/types/src/useDynamicRef.d.ts

@@ -1,10 +1,10 @@
-import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
+import { type Dispatch, type RefObject, type SetStateAction } from 'react';
 /**
  * Like `useState` but with an additional dynamic value.
  */
-export declare const useStateWithRef: <T>(valueParam: T) => [T, Dispatch<SetStateAction<T>>, MutableRefObject<T>];
+export declare const useStateWithRef: <T>(valueParam: T) => [T, Dispatch<SetStateAction<T>>, RefObject<T>];
 /**
  * Ref that is updated by a dependency.
  */
-export declare const useDynamicRef: <T>(value: T) => MutableRefObject<T>;
+export declare const useDynamicRef: <T>(value: T) => RefObject<T>;
 //# sourceMappingURL=useDynamicRef.d.ts.map

package/dist/types/src/useDynamicRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDynamicRef.d.ts","sourceRoot":"","sources":["../../../src/useDynamicRef.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAA+B,MAAM,OAAO,CAAC;AAE/G;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,YAAY,CAAC,KAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAgBtG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,gBAAgB,CAAC,CAAC,CAO7D,CAAC"}
+{"version":3,"file":"useDynamicRef.d.ts","sourceRoot":"","sources":["../../../src/useDynamicRef.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAA4C,MAAM,OAAO,CAAC;AAErH;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,YAAY,CAAC,KAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAgB/F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,SAAS,CAAC,CAAC,CAOtD,CAAC"}

package/dist/types/src/useForwardedRef.d.ts

@@ -1,7 +1,27 @@
-import { type ForwardedRef } from 'react';
+import { type ForwardedRef, type Ref, type RefCallback } from 'react';
 /**
  * Combines a possibly undefined forwarded ref with a locally defined ref.
- * @deprecated Use `useComposedRefs` from @radix-ui/react-compose-refs
+ * Returns a stable ref object that synchronizes with the forwarded ref.
+ *
+ * Best practice: This hook creates a stable local ref and synchronizes it with the forwarded ref.
+ * The returned ref object is stable across renders, preventing infinite loops caused by ref identity changes.
+ *
+ * NOTE: This pattern doesn't update refs once they are set. If this is required, use `useMergeRefs`.
  */
-export declare const useForwardedRef: <T>(ref: ForwardedRef<T>) => import("react").RefObject<T | null>;
+export declare const useForwardedRef: <T>(forwardedRef: ForwardedRef<T>) => import("react").RefObject<T>;
+/**
+ * Sets a value on a React ref, handling both callback refs and ref objects.
+ * Returns a cleanup function if the ref is a callback ref.
+ */
+export declare function setRef<T>(ref: Ref<T> | undefined | null, value: T | null): ReturnType<RefCallback<T>>;
+/**
+ * Merges multiple refs into a single ref callback.
+ * Returns a ref callback that synchronizes all provided refs and handles cleanup.
+ */
+export declare const mergeRefs: <T>(refs: (Ref<T> | undefined)[]) => Ref<T>;
+/**
+ * Hook that merges multiple refs into a single stable ref callback.
+ * The returned ref is memoized and only changes when the refs array changes.
+ */
+export declare const useMergeRefs: <T>(refs: (Ref<T> | undefined)[]) => Ref<T>;
 //# sourceMappingURL=useForwardedRef.d.ts.map

package/dist/types/src/useForwardedRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useForwardedRef.d.ts","sourceRoot":"","sources":["../../../src/useForwardedRef.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,OAAO,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,wCAetD,CAAC"}
+{"version":3,"file":"useForwardedRef.d.ts","sourceRoot":"","sources":["../../../src/useForwardedRef.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,GAAG,EAAE,KAAK,WAAW,EAA8B,MAAM,OAAO,CAAC;AAElG;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,iCAO/D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAMrG;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,KAAG,GAAG,CAAC,CAAC,CAYhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,KAAG,GAAG,CAAC,CAAC,CAEnE,CAAC"}

package/dist/types/src/useMediaQuery.d.ts

@@ -3,7 +3,7 @@ export type UseMediaQueryOptions = {
     ssr?: boolean;
 };
 /**
- * React hook that tracks state of a CSS media query
+ * React hook that tracks state of a CSS media query.
  *
  * @param query the media query to match, or a recognized breakpoint token
  * @param options the media query options { fallback, ssr }

package/dist/types/src/useMediaQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../../src/useMediaQuery.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAWF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,MAAM,EAAE,EAAE,UAAS,oBAAyB,KAAG,OAAO,EA0DnG,CAAC"}
+{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../../src/useMediaQuery.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,MAAM,EAAE,EAAE,UAAS,oBAAyB,KAAG,OAAO,EA0DnG,CAAC"}

package/dist/types/src/useSignals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSignals.d.ts","sourceRoot":"","sources":["../../../src/useSignals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAAsB,MAAM,OAAO,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,cAAc,SAQpF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,OAAO,cAAc,MAEnE,CAAC"}
+{"version":3,"file":"useSignals.d.ts","sourceRoot":"","sources":["../../../src/useSignals.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAA8B,MAAM,OAAO,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,cAAc,SAQpF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,OAAO,cAAc,MAEnE,CAAC"}

package/dist/types/src/useViewportResize.d.ts

@@ -0,0 +1,3 @@
+import { useLayoutEffect } from 'react';
+export declare const useViewportResize: (handler: (event?: Event) => void, deps?: Parameters<typeof useLayoutEffect>[1], delay?: number) => void;
+//# sourceMappingURL=useViewportResize.d.ts.map

package/dist/types/src/useViewportResize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewportResize.d.ts","sourceRoot":"","sources":["../../../src/useViewportResize.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAW,MAAM,OAAO,CAAC;AAEjD,eAAO,MAAM,iBAAiB,GAC5B,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,EAChC,OAAM,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAM,EAChD,QAAO,MAAY,SAiBpB,CAAC"}