@dxos/react-hooks 0.8.4-main.c85a9c8dae → 0.8.4-main.d05539e30a

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,8 +1,105 @@
1
- MIT License
2
- Copyright (c) 2022 DXOS
1
+ # Functional Source License, Version 1.1, ALv2 Future License
3
2
 
4
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
3
+ ## Abbreviation
5
4
 
6
- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
5
+ FSL-1.1-Apache-2.0
7
6
 
8
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
7
+ ## Notice
8
+
9
+ Copyright 2026 DXOS
10
+
11
+ ## Terms and Conditions
12
+
13
+ ### Licensor ("We")
14
+
15
+ The party offering the Software under these Terms and Conditions.
16
+
17
+ ### The Software
18
+
19
+ The "Software" is each version of the software that we make available under
20
+ these Terms and Conditions, as indicated by our inclusion of these Terms and
21
+ Conditions with the Software.
22
+
23
+ ### License Grant
24
+
25
+ Subject to your compliance with this License Grant and the Patents,
26
+ Redistribution and Trademark clauses below, we hereby grant you the right to
27
+ use, copy, modify, create derivative works, publicly perform, publicly display
28
+ and redistribute the Software for any Permitted Purpose identified below.
29
+
30
+ ### Permitted Purpose
31
+
32
+ A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
33
+ means making the Software available to others in a commercial product or
34
+ service that:
35
+
36
+ 1. substitutes for the Software;
37
+
38
+ 2. substitutes for any other product or service we offer using the Software
39
+ that exists as of the date we make the Software available; or
40
+
41
+ 3. offers the same or substantially similar functionality as the Software.
42
+
43
+ Permitted Purposes specifically include using the Software:
44
+
45
+ 1. for your internal use and access;
46
+
47
+ 2. for non-commercial education;
48
+
49
+ 3. for non-commercial research; and
50
+
51
+ 4. in connection with professional services that you provide to a licensee
52
+ using the Software in accordance with these Terms and Conditions.
53
+
54
+ ### Patents
55
+
56
+ To the extent your use for a Permitted Purpose would necessarily infringe our
57
+ patents, the license grant above includes a license under our patents. If you
58
+ make a claim against any party that the Software infringes or contributes to
59
+ the infringement of any patent, then your patent license to the Software ends
60
+ immediately.
61
+
62
+ ### Redistribution
63
+
64
+ The Terms and Conditions apply to all copies, modifications and derivatives of
65
+ the Software.
66
+
67
+ If you redistribute any copies, modifications or derivatives of the Software,
68
+ you must include a copy of or a link to these Terms and Conditions and not
69
+ remove any copyright notices provided in or with the Software.
70
+
71
+ ### Disclaimer
72
+
73
+ THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
74
+ IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
75
+ PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
76
+
77
+ IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
78
+ SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
79
+ EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
80
+
81
+ ### Trademarks
82
+
83
+ Except for displaying the License Details and identifying us as the origin of
84
+ the Software, you have no right under these Terms and Conditions to use our
85
+ trademarks, trade names, service marks or product names.
86
+
87
+ ## Grant of Future License
88
+
89
+ We hereby irrevocably grant you an additional license to use the Software under
90
+ the Apache License, Version 2.0 that is effective on the second anniversary of
91
+ the date we make the Software available. On or after that date, you may use the
92
+ Software under the Apache License, Version 2.0, in which case the following
93
+ will apply:
94
+
95
+ Licensed under the Apache License, Version 2.0 (the "License"); you may not use
96
+ this file except in compliance with the License.
97
+
98
+ You may obtain a copy of the License at
99
+
100
+ http://www.apache.org/licenses/LICENSE-2.0
101
+
102
+ Unless required by applicable law or agreed to in writing, software distributed
103
+ under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
104
+ CONDITIONS OF ANY KIND, either express or implied. See the License for the
105
+ specific language governing permissions and limitations under the License.
@@ -1,3 +1,7 @@
1
+ // src/index.ts
2
+ import { useComposedRefs } from "@radix-ui/react-compose-refs";
3
+ import { useSize, useScroller } from "mini-virtual-list";
4
+
1
5
  // src/useAsyncEffect.ts
2
6
  import { useEffect } from "react";
3
7
  var useAsyncEffect = (cb, deps) => {
@@ -17,10 +21,28 @@ var useAsyncEffect = (cb, deps) => {
17
21
  }, deps ?? []);
18
22
  };
19
23
 
24
+ // src/useAtomState.ts
25
+ import { Atom, useAtomSet, useAtomValue } from "@effect-atom/atom-react";
26
+ import { useMemo, useState } from "react";
27
+ var useAtomState = (initialValue) => {
28
+ const [atom] = useState(() => Atom.make(initialValue));
29
+ const value = useAtomValue(atom);
30
+ const set = useAtomSet(atom);
31
+ return useMemo(() => ({
32
+ atom,
33
+ value,
34
+ set
35
+ }), [
36
+ atom,
37
+ value,
38
+ set
39
+ ]);
40
+ };
41
+
20
42
  // src/useAsyncState.ts
21
- import { useEffect as useEffect2, useState } from "react";
43
+ import { useEffect as useEffect2, useState as useState2 } from "react";
22
44
  var useAsyncState = (cb, deps = []) => {
23
- const [value, setValue] = useState();
45
+ const [value, setValue] = useState2();
24
46
  useEffect2(() => {
25
47
  let disposed = false;
26
48
  const t = setTimeout(async () => {
@@ -41,12 +63,12 @@ var useAsyncState = (cb, deps = []) => {
41
63
  };
42
64
 
43
65
  // src/useControlledState.ts
44
- import { useCallback as useCallback2, useEffect as useEffect4, useRef as useRef2, useState as useState3 } from "react";
66
+ import { useCallback as useCallback2, useEffect as useEffect4, useRef as useRef2, useState as useState4 } from "react";
45
67
 
46
68
  // src/useDynamicRef.ts
47
- import { useCallback, useEffect as useEffect3, useRef, useState as useState2 } from "react";
69
+ import { useCallback, useEffect as useEffect3, useRef, useState as useState3 } from "react";
48
70
  var useStateWithRef = (valueProp) => {
49
- const [value, setValue] = useState2(valueProp);
71
+ const [value, setValue] = useState3(valueProp);
50
72
  const valueRef = useRef(valueProp);
51
73
  const setter = useCallback((value2) => {
52
74
  if (typeof value2 === "function") {
@@ -77,7 +99,7 @@ var useDynamicRef = (value) => {
77
99
 
78
100
  // src/useControlledState.ts
79
101
  var useControlledState = (valueProp, onChange) => {
80
- const [value, setControlledValue] = useState3(valueProp);
102
+ const [value, setControlledValue] = useState4(valueProp);
81
103
  useEffect4(() => {
82
104
  setControlledValue(valueProp);
83
105
  }, [
@@ -105,7 +127,6 @@ function isFunction(value) {
105
127
  // src/useDebugDeps.ts
106
128
  import { useEffect as useEffect5, useRef as useRef3 } from "react";
107
129
  import { log } from "@dxos/log";
108
- var __dxlog_file = "/__w/dxos/dxos/packages/ui/react-primitives/react-hooks/src/useDebugDeps.ts";
109
130
  var useDebugDeps = (deps = [], label = "useDebugDeps", active = true) => {
110
131
  const lastDeps = useRef3([]);
111
132
  useEffect5(() => {
@@ -122,12 +143,7 @@ var useDebugDeps = (deps = [], label = "useDebugDeps", active = true) => {
122
143
  }
123
144
  }
124
145
  if (Object.keys(diff).length > 0) {
125
- log.warn(`Updated: ${label} [${lastDeps.current.length}/${deps.length}]`, diff, {
126
- F: __dxlog_file,
127
- L: 30,
128
- S: void 0,
129
- C: (f, a) => f(...a)
130
- });
146
+ log.warn(`Updated: ${label} [${lastDeps.current.length}/${deps.length}]`, diff);
131
147
  }
132
148
  lastDeps.current = deps;
133
149
  }, [
@@ -137,10 +153,10 @@ var useDebugDeps = (deps = [], label = "useDebugDeps", active = true) => {
137
153
  };
138
154
 
139
155
  // src/useDefaultValue.ts
140
- import { useEffect as useEffect6, useMemo, useState as useState4 } from "react";
156
+ import { useEffect as useEffect6, useMemo as useMemo2, useState as useState5 } from "react";
141
157
  var useDefaultValue = (reactiveValue, getDefaultValue) => {
142
- const stableDefaultValue = useMemo(getDefaultValue, []);
143
- const [value, setValue] = useState4(reactiveValue ?? stableDefaultValue);
158
+ const stableDefaultValue = useMemo2(getDefaultValue, []);
159
+ const [value, setValue] = useState5(reactiveValue ?? stableDefaultValue);
144
160
  useEffect6(() => {
145
161
  setValue(reactiveValue ?? stableDefaultValue);
146
162
  }, [
@@ -152,18 +168,18 @@ var useDefaultValue = (reactiveValue, getDefaultValue) => {
152
168
 
153
169
  // src/useDefaults.ts
154
170
  import defaultsDeep from "lodash.defaultsdeep";
155
- import { useMemo as useMemo2 } from "react";
171
+ import { useMemo as useMemo3 } from "react";
156
172
  var useDefaults = (value, defaults) => {
157
- return useMemo2(() => defaultsDeep({}, defaults, value), [
173
+ return useMemo3(() => defaultsDeep({}, defaults, value), [
158
174
  value,
159
175
  defaults
160
176
  ]);
161
177
  };
162
178
 
163
179
  // src/useFileDownload.ts
164
- import { useMemo as useMemo3 } from "react";
180
+ import { useMemo as useMemo4 } from "react";
165
181
  var useFileDownload = () => {
166
- return useMemo3(() => (data, filename) => {
182
+ return useMemo4(() => (data, filename) => {
167
183
  const url = typeof data === "string" ? data : URL.createObjectURL(data);
168
184
  const element = document.createElement("a");
169
185
  element.setAttribute("href", url);
@@ -174,7 +190,7 @@ var useFileDownload = () => {
174
190
  };
175
191
 
176
192
  // src/useForwardedRef.ts
177
- import { useEffect as useEffect7, useMemo as useMemo4, useRef as useRef4 } from "react";
193
+ import { useEffect as useEffect7, useMemo as useMemo5, useRef as useRef4 } from "react";
178
194
  var useForwardedRef = (forwardedRef) => {
179
195
  const localRef = useRef4(null);
180
196
  useEffect7(() => {
@@ -199,33 +215,35 @@ var mergeRefs = (refs) => {
199
215
  cleanups.push(typeof cleanup === "function" ? cleanup : () => setRef(ref, null));
200
216
  }
201
217
  return () => {
202
- for (const cleanup of cleanups) cleanup();
218
+ for (const cleanup of cleanups) {
219
+ cleanup();
220
+ }
203
221
  };
204
222
  };
205
223
  };
206
224
  var useMergeRefs = (refs) => {
207
- return useMemo4(() => mergeRefs(refs), [
225
+ return useMemo5(() => mergeRefs(refs), [
208
226
  ...refs
209
227
  ]);
210
228
  };
211
229
 
212
230
  // src/useId.ts
213
231
  import alea from "alea";
214
- import { useMemo as useMemo5 } from "react";
232
+ import { useMemo as useMemo6 } from "react";
215
233
  var Alea = alea;
216
234
  var prng = new Alea("@dxos/react-hooks");
217
235
  var randomString = (n = 4) => prng().toString(16).slice(2, n + 2);
218
236
  var useId = (namespace, propsId, opts) => {
219
- return useMemo5(() => makeId(namespace, propsId, opts), [
237
+ return useMemo6(() => makeId(namespace, propsId, opts), [
220
238
  propsId
221
239
  ]);
222
240
  };
223
241
  var makeId = (namespace, propsId, opts) => propsId ?? `${namespace}-${randomString(opts?.n ?? 4)}`;
224
242
 
225
243
  // src/useIsFocused.ts
226
- import { useEffect as useEffect8, useRef as useRef5, useState as useState5 } from "react";
244
+ import { useEffect as useEffect8, useRef as useRef5, useState as useState6 } from "react";
227
245
  var useIsFocused = (inputRef) => {
228
- const [isFocused, setIsFocused] = useState5(void 0);
246
+ const [isFocused, setIsFocused] = useState6(void 0);
229
247
  const isFocusedRef = useRef5(isFocused);
230
248
  isFocusedRef.current = isFocused;
231
249
  useEffect8(() => {
@@ -252,7 +270,7 @@ var useIsFocused = (inputRef) => {
252
270
  };
253
271
 
254
272
  // src/useMediaQuery.ts
255
- import { useEffect as useEffect9, useState as useState6 } from "react";
273
+ import { useEffect as useEffect9, useState as useState7 } from "react";
256
274
  var breakpointMediaQueries = {
257
275
  sm: "(min-width: 640px)",
258
276
  md: "(min-width: 768px)",
@@ -269,7 +287,7 @@ var useMediaQuery = (query, options = {}) => {
269
287
  fallback
270
288
  ];
271
289
  fallbackValues = fallbackValues.filter((v) => v != null);
272
- const [value, setValue] = useState6(() => {
290
+ const [value, setValue] = useState7(() => {
273
291
  return queries.map((query2, index) => ({
274
292
  media: query2,
275
293
  matches: ssr ? !!fallbackValues[index] : document.defaultView?.matchMedia(query2).matches
@@ -317,9 +335,9 @@ var useMediaQuery = (query, options = {}) => {
317
335
  };
318
336
 
319
337
  // src/useMulticastObservable.ts
320
- import { useMemo as useMemo6, useSyncExternalStore } from "react";
338
+ import { useMemo as useMemo7, useSyncExternalStore } from "react";
321
339
  var useMulticastObservable = (observable) => {
322
- const subscribeFn = useMemo6(() => (listener) => {
340
+ const subscribeFn = useMemo7(() => (listener) => {
323
341
  const subscription = observable.subscribe(listener);
324
342
  return () => subscription.unsubscribe();
325
343
  }, [
@@ -329,9 +347,9 @@ var useMulticastObservable = (observable) => {
329
347
  };
330
348
 
331
349
  // src/useRefCallback.ts
332
- import { useState as useState7 } from "react";
350
+ import { useState as useState8 } from "react";
333
351
  var useRefCallback = () => {
334
- const [value, setValue] = useState7(null);
352
+ const [value, setValue] = useState8(null);
335
353
  return {
336
354
  refCallback: (value2) => setValue(value2),
337
355
  value
@@ -339,15 +357,26 @@ var useRefCallback = () => {
339
357
  };
340
358
 
341
359
  // src/useViewportResize.ts
342
- import { useLayoutEffect, useMemo as useMemo7 } from "react";
360
+ import { useLayoutEffect, useMemo as useMemo8 } from "react";
343
361
  var useViewportResize = (cb, deps = [], delay = 800) => {
344
- const debouncedHandler = useMemo7(() => {
362
+ const { handler: debouncedHandler, cancel } = useMemo8(() => {
345
363
  let timeout;
346
- return (event) => {
347
- clearTimeout(timeout);
348
- timeout = setTimeout(() => {
349
- cb(event);
350
- }, delay);
364
+ return {
365
+ handler: (event) => {
366
+ if (timeout !== void 0) {
367
+ clearTimeout(timeout);
368
+ }
369
+ timeout = setTimeout(() => {
370
+ timeout = void 0;
371
+ cb(event);
372
+ }, delay);
373
+ },
374
+ cancel: () => {
375
+ if (timeout !== void 0) {
376
+ clearTimeout(timeout);
377
+ timeout = void 0;
378
+ }
379
+ }
351
380
  };
352
381
  }, [
353
382
  cb,
@@ -356,9 +385,13 @@ var useViewportResize = (cb, deps = [], delay = 800) => {
356
385
  return useLayoutEffect(() => {
357
386
  window.visualViewport?.addEventListener("resize", debouncedHandler);
358
387
  debouncedHandler();
359
- return () => window.visualViewport?.removeEventListener("resize", debouncedHandler);
388
+ return () => {
389
+ window.visualViewport?.removeEventListener("resize", debouncedHandler);
390
+ cancel();
391
+ };
360
392
  }, [
361
393
  debouncedHandler,
394
+ cancel,
362
395
  ...deps
363
396
  ]);
364
397
  };
@@ -408,12 +441,12 @@ var useInterval = (callback, delay = 0, deps = []) => {
408
441
  };
409
442
 
410
443
  // src/useTransitions.ts
411
- import { useEffect as useEffect11, useRef as useRef7, useState as useState8 } from "react";
444
+ import { useEffect as useEffect11, useRef as useRef7, useState as useState9 } from "react";
412
445
  var isFunction2 = (functionToCheck) => {
413
446
  return functionToCheck instanceof Function;
414
447
  };
415
448
  var useDidTransition = (currentValue, fromValue, toValue) => {
416
- const [hasTransitioned, setHasTransitioned] = useState8(false);
449
+ const [hasTransitioned, setHasTransitioned] = useState9(false);
417
450
  const previousValue = useRef7(currentValue);
418
451
  useEffect11(() => {
419
452
  const toValueValid = isFunction2(toValue) ? toValue(currentValue) : toValue === currentValue;
@@ -452,9 +485,6 @@ var useOnTransition = (currentValue, fromValue, toValue, callback) => {
452
485
  callback
453
486
  ]);
454
487
  };
455
-
456
- // src/index.ts
457
- import { useSize, useScroller } from "mini-virtual-list";
458
488
  export {
459
489
  makeId,
460
490
  mergeRefs,
@@ -462,6 +492,8 @@ export {
462
492
  setRef,
463
493
  useAsyncEffect,
464
494
  useAsyncState,
495
+ useAtomState,
496
+ useComposedRefs,
465
497
  useControlledState,
466
498
  useDebugDeps,
467
499
  useDefaultValue,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
- "sources": ["../../../src/useAsyncEffect.ts", "../../../src/useAsyncState.ts", "../../../src/useControlledState.ts", "../../../src/useDynamicRef.ts", "../../../src/useDebugDeps.ts", "../../../src/useDefaultValue.ts", "../../../src/useDefaults.ts", "../../../src/useFileDownload.ts", "../../../src/useForwardedRef.ts", "../../../src/useId.ts", "../../../src/useIsFocused.ts", "../../../src/useMediaQuery.ts", "../../../src/useMulticastObservable.ts", "../../../src/useRefCallback.ts", "../../../src/useViewportResize.ts", "../../../src/useTimeout.ts", "../../../src/useTransitions.ts", "../../../src/index.ts"],
4
- "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport { type DependencyList, type EffectCallback, useEffect } from 'react';\n\n/**\n * Async version of useEffect.\n * The `AbortController` can be used to detect if the component has been unmounted and\n * can be used to propagate abort signals to downstream async operations (e.g., `fetch`).\n */\nexport const useAsyncEffect = (\n cb: (controller: AbortController) => Promise<EffectCallback | void>,\n deps?: DependencyList,\n) => {\n useEffect(() => {\n const controller = new AbortController();\n let cleanup: EffectCallback | void;\n // NOTE: Timeout enables us to immediately cancel. if the component is unmounted.\n const t = setTimeout(async () => {\n if (!controller.signal.aborted) {\n cleanup = await cb(controller);\n }\n });\n\n return () => {\n clearTimeout(t);\n controller.abort();\n cleanup?.();\n };\n }, deps ?? []);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Dispatch, type SetStateAction, useEffect, useState } from 'react';\n\n/**\n * NOTE: Use with care and when necessary to be able to cancel an async operation when unmounting.\n */\nexport const useAsyncState = <T>(\n cb: () => Promise<T | undefined>,\n deps: any[] = [],\n): [T | undefined, Dispatch<SetStateAction<T | undefined>>] => {\n const [value, setValue] = useState<T | undefined>();\n useEffect(() => {\n let disposed = false;\n const t = setTimeout(async () => {\n const data = await cb();\n if (!disposed) {\n setValue(data);\n }\n });\n\n return () => {\n disposed = true;\n clearTimeout(t);\n };\n }, deps);\n\n return [value, setValue];\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Dispatch, type SetStateAction, useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useDynamicRef } from './useDynamicRef';\n\n/**\n * A stateful hook with a controlled value.\n * NOTE: Consider using Radix's `useControllableState`.\n */\nexport const useControlledState = <T>(\n valueProp: T,\n onChange?: (value: T) => void,\n): [T, Dispatch<SetStateAction<T>>] => {\n const [value, setControlledValue] = useState(valueProp);\n useEffect(() => {\n setControlledValue(valueProp);\n }, [valueProp]);\n\n const onChangeRef = useRef(onChange);\n const valueRef = useDynamicRef(valueProp);\n const setValue = useCallback<Dispatch<SetStateAction<T>>>(\n (nextValue) => {\n const value = isFunction(nextValue) ? nextValue(valueRef.current) : nextValue;\n setControlledValue(value);\n onChangeRef.current?.(value);\n },\n [valueRef, onChangeRef],\n );\n\n return [value, setValue];\n};\n\nfunction isFunction(value: unknown): value is (...args: any[]) => any {\n return typeof value === 'function';\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Dispatch, type RefObject, type SetStateAction, useCallback, useEffect, useRef, useState } from 'react';\n\n/**\n * Like `useState` but with an additional dynamic value.\n */\nexport const useStateWithRef = <T>(valueProp: T): [T, Dispatch<SetStateAction<T>>, RefObject<T>] => {\n const [value, setValue] = useState<T>(valueProp);\n const valueRef = useRef<T>(valueProp);\n const setter = useCallback<Dispatch<SetStateAction<T>>>((value) => {\n if (typeof value === 'function') {\n setValue((current) => {\n valueRef.current = (value as Function)(current);\n return valueRef.current;\n });\n } else {\n valueRef.current = value;\n setValue(value);\n }\n }, []);\n\n return [value, setter, valueRef];\n};\n\n/**\n * Ref that is updated by a dependency.\n */\nexport const useDynamicRef = <T>(value: T): RefObject<T> => {\n const valueRef = useRef<T>(value);\n useEffect(() => {\n valueRef.current = value;\n }, [value]);\n\n return valueRef;\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type DependencyList, useEffect, useRef } from 'react';\n\nimport { log } from '@dxos/log';\n\n/**\n * Util to log deps that have changed.\n */\nexport const useDebugDeps = (deps: DependencyList = [], label = 'useDebugDeps', active = true) => {\n const lastDeps = useRef<DependencyList>([]);\n useEffect(() => {\n if (!active) {\n return;\n }\n\n const diff: Record<number, { previous: any; current: any }> = {};\n for (let i = 0; i < Math.max(lastDeps.current.length ?? 0, deps.length ?? 0); i++) {\n if (lastDeps.current[i] !== deps[i] || i > lastDeps.current.length) {\n diff[i] = {\n previous: lastDeps.current[i],\n current: deps[i],\n };\n }\n }\n\n if (Object.keys(diff).length > 0) {\n log.warn(`Updated: ${label} [${lastDeps.current.length}/${deps.length}]`, diff);\n }\n\n lastDeps.current = deps;\n }, [...deps, active]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useMemo, useState } from 'react';\n\n/**\n * A custom React hook that provides a stable default value for a potentially undefined reactive value.\n * The defaultValue is memoized upon component mount and remains unchanged until the component unmounts,\n * ensuring stability across all re-renders, even if the defaultValue prop changes.\n *\n * Note: The defaultValue is not reactive. It retains the same value from the component's mount to unmount.\n *\n * @param reactiveValue - The value that may change over time.\n * @param defaultValue - The initial value used when the reactiveValue is undefined. This value is not reactive.\n * @returns - The reactiveValue if it's defined, otherwise the defaultValue.\n */\nexport const useDefaultValue = <T>(reactiveValue: T | undefined | null, getDefaultValue: () => T): T => {\n // Memoize defaultValue with an empty dependency array.\n // This ensures that the defaultValue instance remains stable across all re-renders,\n // regardless of whether the defaultValue changes.\n const stableDefaultValue = useMemo(getDefaultValue, []);\n const [value, setValue] = useState(reactiveValue ?? stableDefaultValue);\n useEffect(() => {\n setValue(reactiveValue ?? stableDefaultValue);\n }, [reactiveValue, stableDefaultValue]);\n\n return value;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport defaultsDeep from 'lodash.defaultsdeep';\nimport { useMemo } from 'react';\n\n/**\n * Returns a memo-ized deep-merged object of the default and value.\n * If value is undefined or null, then returns the default.\n */\nexport const useDefaults = <T>(value: T | undefined | null, defaults: T): T => {\n return useMemo(() => defaultsDeep({}, defaults, value), [value, defaults]);\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\n/**\n * File download anchor.\n *\n * ```\n * const download = useDownload();\n * const handleDownload = (data: string) => {\n * download(new Blob([data], { type: 'text/plain' }), 'test.txt');\n * };\n * ```\n */\nexport const useFileDownload = (): ((data: Blob | string, filename: string) => void) => {\n return useMemo(\n () => (data: Blob | string, filename: string) => {\n const url = typeof data === 'string' ? data : URL.createObjectURL(data);\n const element = document.createElement('a');\n element.setAttribute('href', url);\n element.setAttribute('download', filename);\n element.setAttribute('target', 'download');\n element.click();\n },\n [],\n );\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { type ForwardedRef, type Ref, type RefCallback, useEffect, useMemo, useRef } from 'react';\n\n/**\n * Combines a possibly undefined forwarded ref with a locally defined ref.\n * Returns a stable ref object that synchronizes with the forwarded ref.\n *\n * Best practice: This hook creates a stable local ref and synchronizes it with the forwarded ref.\n * The returned ref object is stable across renders, preventing infinite loops caused by ref identity changes.\n *\n * NOTE: This pattern doesn't update refs once they are set. If this is required, use `useMergeRefs`.\n */\nexport const useForwardedRef = <T>(forwardedRef: ForwardedRef<T>) => {\n const localRef = useRef<T>(null as T);\n useEffect(() => {\n setRef(forwardedRef, localRef.current);\n }, [forwardedRef]);\n\n return localRef;\n};\n\n/**\n * Sets a value on a React ref, handling both callback refs and ref objects.\n * Returns a cleanup function if the ref is a callback ref.\n */\nexport function setRef<T>(ref: Ref<T> | undefined | null, value: T | null): ReturnType<RefCallback<T>> {\n if (typeof ref === 'function') {\n return ref(value);\n } else if (ref) {\n ref.current = value;\n }\n}\n\n/**\n * Merges multiple refs into a single ref callback.\n * Returns a ref callback that synchronizes all provided refs and handles cleanup.\n */\nexport const mergeRefs = <T>(refs: (Ref<T> | undefined)[]): Ref<T> => {\n return (value: T | null) => {\n const cleanups: (() => void)[] = [];\n for (const ref of refs) {\n const cleanup = setRef(ref, value);\n cleanups.push(typeof cleanup === 'function' ? cleanup : () => setRef(ref, null));\n }\n\n return () => {\n for (const cleanup of cleanups) cleanup();\n };\n };\n};\n\n/**\n * Hook that merges multiple refs into a single stable ref callback.\n * The returned ref is memoized and only changes when the refs array changes.\n */\nexport const useMergeRefs = <T>(refs: (Ref<T> | undefined)[]): Ref<T> => {\n return useMemo(() => mergeRefs(refs), [...refs]);\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport alea from 'alea';\nimport { useMemo } from 'react';\n\ninterface PrngFactory {\n new (seed?: string): () => number;\n}\n\nconst Alea: PrngFactory = alea as unknown as PrngFactory;\n\nconst prng = new Alea('@dxos/react-hooks');\n\n// TODO(burdon): Replace with PublicKey.random().\nexport const randomString = (n = 4) =>\n prng()\n .toString(16)\n .slice(2, n + 2);\n\nexport const useId = (namespace: string, propsId?: string, opts?: Partial<{ n: number }>) => {\n return useMemo(() => makeId(namespace, propsId, opts), [propsId]);\n};\n\nexport const makeId = (namespace: string, propsId?: string, opts?: Partial<{ n: number }>) =>\n propsId ?? `${namespace}-${randomString(opts?.n ?? 4)}`;\n", "//\n// Copyright 2022 DXOS.org\n//\n\n// Based upon the useIsFocused hook which is part of the `rci` project:\n/// https://github.com/leonardodino/rci/blob/main/packages/use-w-focused\n\nimport { type RefObject, useEffect, useRef, useState } from 'react';\n\nexport const useIsFocused = (inputRef: RefObject<HTMLInputElement | null>) => {\n const [isFocused, setIsFocused] = useState<boolean | undefined>(undefined);\n const isFocusedRef = useRef<boolean | undefined>(isFocused);\n\n isFocusedRef.current = isFocused;\n\n useEffect(() => {\n const input = inputRef.current;\n if (!input) {\n return;\n }\n\n const onFocus = () => setIsFocused(true);\n const onBlur = () => setIsFocused(false);\n input.addEventListener('focus', onFocus);\n input.addEventListener('blur', onBlur);\n\n if (isFocusedRef.current === undefined) {\n setIsFocused(document.activeElement === input);\n }\n\n return () => {\n input.removeEventListener('focus', onFocus);\n input.removeEventListener('blur', onBlur);\n };\n }, [inputRef, setIsFocused]);\n\n return isFocused;\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\n// This hook is based on Chakra UI’s `useMediaQuery`: https://github.com/chakra-ui/chakra-ui/blob/main/packages/components/media-query/src/use-media-query.ts\n\nimport { useEffect, useState } from 'react';\n\n// TODO(thure): This should be derived from the same source of truth as the Tailwind theme config.\nconst breakpointMediaQueries: Record<string, string> = {\n sm: '(min-width: 640px)',\n md: '(min-width: 768px)',\n lg: '(min-width: 1024px)',\n xl: '(min-width: 1280px)',\n '2xl': '(min-width: 1536px)',\n};\n\nexport type UseMediaQueryOptions = {\n fallback?: boolean | boolean[];\n ssr?: boolean;\n};\n\n/**\n * React hook that tracks state of a CSS media query.\n *\n * @param query the media query to match, or a recognized breakpoint token\n * @param options the media query options { fallback, ssr }\n *\n * @see Docs https://chakra-ui.com/docs/hooks/use-media-query\n */\nexport const useMediaQuery = (query: string | string[], options: UseMediaQueryOptions = {}): boolean[] => {\n const { ssr = false, fallback } = options;\n\n const queries = (Array.isArray(query) ? query : [query]).map((query) =>\n query in breakpointMediaQueries ? breakpointMediaQueries[query] : query,\n );\n\n let fallbackValues = Array.isArray(fallback) ? fallback : [fallback];\n fallbackValues = fallbackValues.filter((v) => v != null) as boolean[];\n\n const [value, setValue] = useState(() => {\n return queries.map((query, index) => ({\n media: query,\n matches: ssr ? !!fallbackValues[index] : document.defaultView?.matchMedia(query).matches,\n }));\n });\n\n useEffect(() => {\n setValue(\n queries.map((query) => ({\n media: query,\n matches: document.defaultView?.matchMedia(query).matches,\n })),\n );\n\n const mql = queries.map((query) => document.defaultView?.matchMedia(query));\n\n const handler = (evt: MediaQueryListEvent) => {\n setValue((prev) => {\n return prev.slice().map((item) => {\n if (item.media === evt.media) {\n return { ...item, matches: evt.matches };\n }\n return item;\n });\n });\n };\n\n mql.forEach((mql) => {\n if (typeof mql?.addListener === 'function') {\n mql?.addListener(handler);\n } else {\n mql?.addEventListener('change', handler);\n }\n });\n\n return () => {\n mql.forEach((mql) => {\n if (typeof mql?.removeListener === 'function') {\n mql?.removeListener(handler);\n } else {\n mql?.removeEventListener('change', handler);\n }\n });\n };\n }, [document.defaultView]);\n\n return value.map((item) => !!item.matches);\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useMemo, useSyncExternalStore } from 'react';\n\nimport { type MulticastObservable } from '@dxos/async';\n\n/**\n * Subscribe to a MulticastObservable and return the latest value.\n * @param observable the observable to subscribe to. Will resubscribe if the observable changes.\n */\n// TODO(burdon): Move to react-hooks.\nexport const useMulticastObservable = <T>(observable: MulticastObservable<T>): T => {\n // Make sure useSyncExternalStore is stable in respect to the observable.\n const subscribeFn = useMemo(\n () => (listener: () => void) => {\n const subscription = observable.subscribe(listener);\n return () => subscription.unsubscribe();\n },\n [observable],\n );\n\n // useSyncExternalStore will resubscribe to the observable and update the value if the subscribeFn changes.\n return useSyncExternalStore(subscribeFn, () => observable.get());\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type RefCallback, useState } from 'react';\n\n/**\n * Custom React Hook that creates a ref callback and a state variable.\n * The ref callback sets the state variable when the ref changes.\n *\n * @returns An object containing the ref callback and the current value of the ref.\n */\nexport const useRefCallback = <T = any>(): { refCallback: RefCallback<T>; value: T | null } => {\n const [value, setValue] = useState<T | null>(null);\n return { refCallback: (value: T) => setValue(value), value };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useLayoutEffect, useMemo } from 'react';\n\nexport const useViewportResize = (\n cb: (event?: Event) => void,\n deps: Parameters<typeof useLayoutEffect>[1] = [],\n delay: number = 800,\n) => {\n const debouncedHandler = useMemo(() => {\n let timeout: ReturnType<typeof setTimeout>;\n return (event?: Event) => {\n clearTimeout(timeout);\n timeout = setTimeout(() => {\n cb(event);\n }, delay);\n };\n }, [cb, delay]);\n\n return useLayoutEffect(() => {\n window.visualViewport?.addEventListener('resize', debouncedHandler);\n debouncedHandler();\n return () => window.visualViewport?.removeEventListener('resize', debouncedHandler);\n }, [debouncedHandler, ...deps]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useRef } from 'react';\n\nexport const useTimeout = (callback?: () => Promise<void>, delay = 0, deps: any[] = []) => {\n const callbackRef = useRef(callback);\n useEffect(() => {\n callbackRef.current = callback;\n }, [callback]);\n\n useEffect(() => {\n if (delay == null) {\n return;\n }\n\n const t = setTimeout(() => callbackRef.current?.(), delay);\n return () => clearTimeout(t);\n }, [delay, ...deps]);\n};\n\nexport const useInterval = (\n callback?: (() => Promise<void | boolean>) | (() => void | boolean),\n delay = 0,\n deps: any[] = [],\n) => {\n const callbackRef = useRef(callback);\n useEffect(() => {\n callbackRef.current = callback;\n }, [callback]);\n\n useEffect(() => {\n if (delay == null) {\n return;\n }\n\n const i = setInterval(async () => {\n const result = await callbackRef.current?.();\n if (result === false) {\n clearInterval(i);\n }\n }, delay);\n return () => clearInterval(i);\n }, [delay, ...deps]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useRef, useState } from 'react';\n\nconst isFunction = <T>(functionToCheck: any): functionToCheck is (value: T) => boolean => {\n return functionToCheck instanceof Function;\n};\n\n/**\n * This is an internal custom hook that checks if a value has transitioned from a specified 'from' value to a 'to' value.\n *\n * @param currentValue - The value that is being monitored for transitions.\n * @param fromValue - The *from* value or a predicate function that determines the start of the transition.\n * @param toValue - The *to* value or a predicate function that determines the end of the transition.\n * @returns A boolean indicating whether the transition from *fromValue* to *toValue* has occurred.\n *\n * @internal Consider using `useOnTransition` for handling transitions instead of this hook.\n */\nexport const useDidTransition = <T>(\n currentValue: T,\n fromValue: T | ((value: T) => boolean),\n toValue: T | ((value: T) => boolean),\n) => {\n const [hasTransitioned, setHasTransitioned] = useState(false);\n const previousValue = useRef<T>(currentValue);\n\n useEffect(() => {\n const toValueValid = isFunction<T>(toValue) ? toValue(currentValue) : toValue === currentValue;\n const fromValueValid = isFunction<T>(fromValue)\n ? fromValue(previousValue.current)\n : fromValue === previousValue.current;\n\n if (fromValueValid && toValueValid && !hasTransitioned) {\n setHasTransitioned(true);\n } else if ((!fromValueValid || !toValueValid) && hasTransitioned) {\n setHasTransitioned(false);\n }\n\n previousValue.current = currentValue;\n }, [currentValue, fromValue, toValue, hasTransitioned]);\n\n return hasTransitioned;\n};\n\n/**\n * Executes a callback function when a specified transition occurs in a value.\n *\n * This function utilizes the `useDidTransition` hook to monitor changes in `currentValue`.\n * When `currentValue` transitions from `fromValue` to `toValue`, the provided `callback` function is executed.\n */\n// TODO(wittjosiah): Seems overwrought.\nexport const useOnTransition = <T>(\n currentValue: T,\n fromValue: T | ((value: T) => boolean),\n toValue: T | ((value: T) => boolean),\n callback: () => void,\n) => {\n const dirty = useRef(false);\n const hasTransitioned = useDidTransition(currentValue, fromValue, toValue);\n\n useEffect(() => {\n dirty.current = false;\n }, [currentValue, dirty]);\n\n useEffect(() => {\n if (hasTransitioned && !dirty.current) {\n callback();\n dirty.current = true;\n }\n }, [hasTransitioned, dirty, callback]);\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nexport * from './useAsyncEffect';\nexport * from './useAsyncState';\nexport * from './useControlledState';\nexport * from './useDebugDeps';\nexport * from './useDefaultValue';\nexport * from './useDefaults';\nexport * from './useDynamicRef';\nexport * from './useFileDownload';\nexport * from './useForwardedRef';\nexport * from './useId';\nexport * from './useIsFocused';\nexport * from './useMediaQuery';\nexport * from './useMulticastObservable';\nexport * from './useRefCallback';\nexport * from './useViewportResize';\nexport * from './useTimeout';\nexport * from './useTransitions';\n\nexport { useSize, useScroller } from 'mini-virtual-list';\n"],
5
- "mappings": "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",
6
- "names": ["useEffect", "useAsyncEffect", "cb", "deps", "useEffect", "controller", "AbortController", "cleanup", "t", "setTimeout", "signal", "aborted", "clearTimeout", "abort", "useEffect", "useState", "useAsyncState", "cb", "deps", "value", "setValue", "useState", "useEffect", "disposed", "t", "setTimeout", "data", "clearTimeout", "useCallback", "useEffect", "useRef", "useState", "useCallback", "useEffect", "useRef", "useState", "useStateWithRef", "valueProp", "value", "setValue", "useState", "valueRef", "useRef", "setter", "useCallback", "current", "useDynamicRef", "useEffect", "useControlledState", "valueProp", "onChange", "value", "setControlledValue", "useState", "useEffect", "onChangeRef", "useRef", "valueRef", "useDynamicRef", "setValue", "useCallback", "nextValue", "isFunction", "current", "useEffect", "useRef", "log", "useDebugDeps", "deps", "label", "active", "lastDeps", "diff", "i", "Math", "max", "current", "length", "previous", "Object", "keys", "warn", "useEffect", "useMemo", "useState", "useDefaultValue", "reactiveValue", "getDefaultValue", "stableDefaultValue", "useMemo", "value", "setValue", "useState", "useEffect", "defaultsDeep", "useMemo", "useDefaults", "value", "defaults", "useMemo", "defaultsDeep", "useMemo", "useFileDownload", "useMemo", "data", "filename", "url", "URL", "createObjectURL", "element", "document", "createElement", "setAttribute", "click", "useEffect", "useMemo", "useRef", "useForwardedRef", "forwardedRef", "localRef", "useRef", "useEffect", "setRef", "current", "ref", "value", "mergeRefs", "refs", "cleanups", "cleanup", "push", "useMergeRefs", "useMemo", "alea", "useMemo", "Alea", "alea", "prng", "randomString", "n", "toString", "slice", "useId", "namespace", "propsId", "opts", "useMemo", "makeId", "useEffect", "useRef", "useState", "useIsFocused", "inputRef", "isFocused", "setIsFocused", "useState", "undefined", "isFocusedRef", "useRef", "current", "useEffect", "input", "onFocus", "onBlur", "addEventListener", "document", "activeElement", "removeEventListener", "useEffect", "useState", "breakpointMediaQueries", "sm", "md", "lg", "xl", "useMediaQuery", "query", "options", "ssr", "fallback", "queries", "Array", "isArray", "map", "fallbackValues", "filter", "v", "value", "setValue", "useState", "index", "media", "matches", "document", "defaultView", "matchMedia", "useEffect", "mql", "handler", "evt", "prev", "slice", "item", "forEach", "addListener", "addEventListener", "removeListener", "removeEventListener", "useMemo", "useSyncExternalStore", "useMulticastObservable", "observable", "subscribeFn", "useMemo", "listener", "subscription", "subscribe", "unsubscribe", "useSyncExternalStore", "get", "useState", "useRefCallback", "value", "setValue", "useState", "refCallback", "useLayoutEffect", "useMemo", "useViewportResize", "cb", "deps", "delay", "debouncedHandler", "useMemo", "timeout", "event", "clearTimeout", "setTimeout", "useLayoutEffect", "window", "visualViewport", "addEventListener", "removeEventListener", "useEffect", "useRef", "useTimeout", "callback", "delay", "deps", "callbackRef", "useRef", "useEffect", "current", "t", "setTimeout", "clearTimeout", "useInterval", "i", "setInterval", "result", "clearInterval", "useEffect", "useRef", "useState", "isFunction", "functionToCheck", "Function", "useDidTransition", "currentValue", "fromValue", "toValue", "hasTransitioned", "setHasTransitioned", "useState", "previousValue", "useRef", "useEffect", "toValueValid", "fromValueValid", "current", "useOnTransition", "callback", "dirty", "useSize", "useScroller"]
3
+ "sources": ["../../../src/index.ts", "../../../src/useAsyncEffect.ts", "../../../src/useAtomState.ts", "../../../src/useAsyncState.ts", "../../../src/useControlledState.ts", "../../../src/useDynamicRef.ts", "../../../src/useDebugDeps.ts", "../../../src/useDefaultValue.ts", "../../../src/useDefaults.ts", "../../../src/useFileDownload.ts", "../../../src/useForwardedRef.ts", "../../../src/useId.ts", "../../../src/useIsFocused.ts", "../../../src/useMediaQuery.ts", "../../../src/useMulticastObservable.ts", "../../../src/useRefCallback.ts", "../../../src/useViewportResize.ts", "../../../src/useTimeout.ts", "../../../src/useTransitions.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nexport { useComposedRefs } from '@radix-ui/react-compose-refs';\nexport { useSize, useScroller } from 'mini-virtual-list';\n\nexport * from './useAsyncEffect';\nexport * from './useAtomState';\nexport * from './useAsyncState';\nexport * from './useControlledState';\nexport * from './useDebugDeps';\nexport * from './useDefaultValue';\nexport * from './useDefaults';\nexport * from './useDynamicRef';\nexport * from './useFileDownload';\nexport * from './useForwardedRef';\nexport * from './useId';\nexport * from './useIsFocused';\nexport * from './useMediaQuery';\nexport * from './useMulticastObservable';\nexport * from './useRefCallback';\nexport * from './useViewportResize';\nexport * from './useTimeout';\nexport * from './useTransitions';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { type DependencyList, type EffectCallback, useEffect } from 'react';\n\n/**\n * Async version of useEffect.\n * The `AbortController` can be used to detect if the component has been unmounted and\n * can be used to propagate abort signals to downstream async operations (e.g., `fetch`).\n */\nexport const useAsyncEffect = (\n cb: (controller: AbortController) => Promise<EffectCallback | void>,\n deps?: DependencyList,\n) => {\n useEffect(() => {\n const controller = new AbortController();\n let cleanup: EffectCallback | void;\n // NOTE: Timeout enables us to immediately cancel. if the component is unmounted.\n const t = setTimeout(async () => {\n if (!controller.signal.aborted) {\n cleanup = await cb(controller);\n }\n });\n\n return () => {\n clearTimeout(t);\n controller.abort();\n cleanup?.();\n };\n }, deps ?? []);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Atom, useAtomSet, useAtomValue } from '@effect-atom/atom-react';\nimport { useMemo, useState } from 'react';\n\nexport type AtomState<T> = {\n atom: Atom.Writable<T>;\n value: T;\n set: (value: T | ((value: T) => T)) => void;\n};\n\n/**\n * Wraps a writable atom together with its current value and setter.\n * The atom is created once on first render; `initialValue` is only used to seed it.\n */\nexport const useAtomState = <T>(initialValue: T): AtomState<T> => {\n const [atom] = useState(() => Atom.make(initialValue));\n const value = useAtomValue(atom);\n const set = useAtomSet(atom);\n return useMemo(() => ({ atom, value, set }), [atom, value, set]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Dispatch, type SetStateAction, useEffect, useState } from 'react';\n\n/**\n * NOTE: Use with care and when necessary to be able to cancel an async operation when unmounting.\n */\nexport const useAsyncState = <T>(\n cb: () => Promise<T | undefined>,\n deps: any[] = [],\n): [T | undefined, Dispatch<SetStateAction<T | undefined>>] => {\n const [value, setValue] = useState<T | undefined>();\n useEffect(() => {\n let disposed = false;\n const t = setTimeout(async () => {\n const data = await cb();\n if (!disposed) {\n setValue(data);\n }\n });\n\n return () => {\n disposed = true;\n clearTimeout(t);\n };\n }, deps);\n\n return [value, setValue];\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Dispatch, type SetStateAction, useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useDynamicRef } from './useDynamicRef';\n\n/**\n * A stateful hook with a controlled value.\n * NOTE: Consider using Radix's `useControllableState`.\n */\nexport const useControlledState = <T>(\n valueProp: T,\n onChange?: (value: T) => void,\n): [T, Dispatch<SetStateAction<T>>] => {\n const [value, setControlledValue] = useState(valueProp);\n useEffect(() => {\n setControlledValue(valueProp);\n }, [valueProp]);\n\n const onChangeRef = useRef(onChange);\n const valueRef = useDynamicRef(valueProp);\n const setValue = useCallback<Dispatch<SetStateAction<T>>>(\n (nextValue) => {\n const value = isFunction(nextValue) ? nextValue(valueRef.current) : nextValue;\n setControlledValue(value);\n onChangeRef.current?.(value);\n },\n [valueRef, onChangeRef],\n );\n\n return [value, setValue];\n};\n\nfunction isFunction(value: unknown): value is (...args: any[]) => any {\n return typeof value === 'function';\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Dispatch, type RefObject, type SetStateAction, useCallback, useEffect, useRef, useState } from 'react';\n\n/**\n * Like `useState` but with an additional dynamic value.\n */\nexport const useStateWithRef = <T>(valueProp: T): [T, Dispatch<SetStateAction<T>>, RefObject<T>] => {\n const [value, setValue] = useState<T>(valueProp);\n const valueRef = useRef<T>(valueProp);\n const setter = useCallback<Dispatch<SetStateAction<T>>>((value) => {\n if (typeof value === 'function') {\n setValue((current) => {\n valueRef.current = (value as Function)(current);\n return valueRef.current;\n });\n } else {\n valueRef.current = value;\n setValue(value);\n }\n }, []);\n\n return [value, setter, valueRef];\n};\n\n/**\n * Ref that is updated by a dependency.\n */\nexport const useDynamicRef = <T>(value: T): RefObject<T> => {\n const valueRef = useRef<T>(value);\n useEffect(() => {\n valueRef.current = value;\n }, [value]);\n\n return valueRef;\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type DependencyList, useEffect, useRef } from 'react';\n\nimport { log } from '@dxos/log';\n\n/**\n * Util to log deps that have changed.\n */\nexport const useDebugDeps = (deps: DependencyList = [], label = 'useDebugDeps', active = true) => {\n const lastDeps = useRef<DependencyList>([]);\n useEffect(() => {\n if (!active) {\n return;\n }\n\n const diff: Record<number, { previous: any; current: any }> = {};\n for (let i = 0; i < Math.max(lastDeps.current.length ?? 0, deps.length ?? 0); i++) {\n if (lastDeps.current[i] !== deps[i] || i > lastDeps.current.length) {\n diff[i] = {\n previous: lastDeps.current[i],\n current: deps[i],\n };\n }\n }\n\n if (Object.keys(diff).length > 0) {\n log.warn(`Updated: ${label} [${lastDeps.current.length}/${deps.length}]`, diff);\n }\n\n lastDeps.current = deps;\n }, [...deps, active]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useMemo, useState } from 'react';\n\n/**\n * A custom React hook that provides a stable default value for a potentially undefined reactive value.\n * The defaultValue is memoized upon component mount and remains unchanged until the component unmounts,\n * ensuring stability across all re-renders, even if the defaultValue prop changes.\n *\n * Note: The defaultValue is not reactive. It retains the same value from the component's mount to unmount.\n *\n * @param reactiveValue - The value that may change over time.\n * @param defaultValue - The initial value used when the reactiveValue is undefined. This value is not reactive.\n * @returns - The reactiveValue if it's defined, otherwise the defaultValue.\n */\nexport const useDefaultValue = <T>(reactiveValue: T | undefined | null, getDefaultValue: () => T): T => {\n // Memoize defaultValue with an empty dependency array.\n // This ensures that the defaultValue instance remains stable across all re-renders,\n // regardless of whether the defaultValue changes.\n const stableDefaultValue = useMemo(getDefaultValue, []);\n const [value, setValue] = useState(reactiveValue ?? stableDefaultValue);\n useEffect(() => {\n setValue(reactiveValue ?? stableDefaultValue);\n }, [reactiveValue, stableDefaultValue]);\n\n return value;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport defaultsDeep from 'lodash.defaultsdeep';\nimport { useMemo } from 'react';\n\n/**\n * Returns a memo-ized deep-merged object of the default and value.\n * If value is undefined or null, then returns the default.\n */\nexport const useDefaults = <T>(value: T | undefined | null, defaults: T): T => {\n return useMemo(() => defaultsDeep({}, defaults, value), [value, defaults]);\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\n/**\n * File download anchor.\n *\n * ```\n * const download = useDownload();\n * const handleDownload = (data: string) => {\n * download(new Blob([data], { type: 'text/plain' }), 'test.txt');\n * };\n * ```\n */\nexport const useFileDownload = (): ((data: Blob | string, filename: string) => void) => {\n return useMemo(\n () => (data: Blob | string, filename: string) => {\n const url = typeof data === 'string' ? data : URL.createObjectURL(data);\n const element = document.createElement('a');\n element.setAttribute('href', url);\n element.setAttribute('download', filename);\n element.setAttribute('target', 'download');\n element.click();\n },\n [],\n );\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { type ForwardedRef, type Ref, type RefCallback, useEffect, useMemo, useRef } from 'react';\n\n/**\n * Combines a possibly undefined forwarded ref with a locally defined ref.\n * Returns a stable ref object that synchronizes with the forwarded ref.\n *\n * Best practice: This hook creates a stable local ref and synchronizes it with the forwarded ref.\n * The returned ref object is stable across renders, preventing infinite loops caused by ref identity changes.\n *\n * NOTE: This pattern doesn't update refs once they are set. If this is required, use `useMergeRefs`.\n */\nexport const useForwardedRef = <T>(forwardedRef: ForwardedRef<T>) => {\n const localRef = useRef<T>(null as T);\n useEffect(() => {\n setRef(forwardedRef, localRef.current);\n }, [forwardedRef]);\n\n return localRef;\n};\n\n/**\n * Sets a value on a React ref, handling both callback refs and ref objects.\n * Returns a cleanup function if the ref is a callback ref.\n */\nexport function setRef<T>(ref: Ref<T> | undefined | null, value: T | null): ReturnType<RefCallback<T>> {\n if (typeof ref === 'function') {\n return ref(value);\n } else if (ref) {\n ref.current = value;\n }\n}\n\n/**\n * Merges multiple refs into a single ref callback.\n * Returns a ref callback that synchronizes all provided refs and handles cleanup.\n */\nexport const mergeRefs = <T>(refs: (Ref<T> | undefined)[]): Ref<T> => {\n return (value: T | null) => {\n const cleanups: (() => void)[] = [];\n for (const ref of refs) {\n const cleanup = setRef(ref, value);\n cleanups.push(typeof cleanup === 'function' ? cleanup : () => setRef(ref, null));\n }\n\n return () => {\n for (const cleanup of cleanups) {\n cleanup();\n }\n };\n };\n};\n\n/**\n * Hook that merges multiple refs into a single stable ref callback.\n * The returned ref is memoized and only changes when the refs array changes.\n */\nexport const useMergeRefs = <T>(refs: (Ref<T> | undefined)[]): Ref<T> => {\n return useMemo(() => mergeRefs(refs), [...refs]);\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport alea from 'alea';\nimport { useMemo } from 'react';\n\ninterface PrngFactory {\n new (seed?: string): () => number;\n}\n\nconst Alea: PrngFactory = alea as unknown as PrngFactory;\n\nconst prng = new Alea('@dxos/react-hooks');\n\n// TODO(burdon): Replace with PublicKey.random().\nexport const randomString = (n = 4) =>\n prng()\n .toString(16)\n .slice(2, n + 2);\n\nexport const useId = (namespace: string, propsId?: string, opts?: Partial<{ n: number }>) => {\n return useMemo(() => makeId(namespace, propsId, opts), [propsId]);\n};\n\nexport const makeId = (namespace: string, propsId?: string, opts?: Partial<{ n: number }>) =>\n propsId ?? `${namespace}-${randomString(opts?.n ?? 4)}`;\n", "//\n// Copyright 2022 DXOS.org\n//\n\n// Based upon the useIsFocused hook which is part of the `rci` project:\n/// https://github.com/leonardodino/rci/blob/main/packages/use-w-focused\n\nimport { type RefObject, useEffect, useRef, useState } from 'react';\n\nexport const useIsFocused = (inputRef: RefObject<HTMLInputElement | null>) => {\n const [isFocused, setIsFocused] = useState<boolean | undefined>(undefined);\n const isFocusedRef = useRef<boolean | undefined>(isFocused);\n\n isFocusedRef.current = isFocused;\n\n useEffect(() => {\n const input = inputRef.current;\n if (!input) {\n return;\n }\n\n const onFocus = () => setIsFocused(true);\n const onBlur = () => setIsFocused(false);\n input.addEventListener('focus', onFocus);\n input.addEventListener('blur', onBlur);\n\n if (isFocusedRef.current === undefined) {\n setIsFocused(document.activeElement === input);\n }\n\n return () => {\n input.removeEventListener('focus', onFocus);\n input.removeEventListener('blur', onBlur);\n };\n }, [inputRef, setIsFocused]);\n\n return isFocused;\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\n// This hook is based on Chakra UI’s `useMediaQuery`: https://github.com/chakra-ui/chakra-ui/blob/main/packages/components/media-query/src/use-media-query.ts\n\nimport { useEffect, useState } from 'react';\n\n// TODO(thure): This should be derived from the same source of truth as the Tailwind theme config.\nconst breakpointMediaQueries: Record<string, string> = {\n sm: '(min-width: 640px)',\n md: '(min-width: 768px)',\n lg: '(min-width: 1024px)',\n xl: '(min-width: 1280px)',\n '2xl': '(min-width: 1536px)',\n};\n\nexport type UseMediaQueryOptions = {\n fallback?: boolean | boolean[];\n ssr?: boolean;\n};\n\n/**\n * React hook that tracks state of a CSS media query.\n *\n * @param query the media query to match, or a recognized breakpoint token\n * @param options the media query options { fallback, ssr }\n *\n * @see Docs https://chakra-ui.com/docs/hooks/use-media-query\n */\nexport const useMediaQuery = (query: string | string[], options: UseMediaQueryOptions = {}): boolean[] => {\n const { ssr = false, fallback } = options;\n\n const queries = (Array.isArray(query) ? query : [query]).map((query) =>\n query in breakpointMediaQueries ? breakpointMediaQueries[query] : query,\n );\n\n let fallbackValues = Array.isArray(fallback) ? fallback : [fallback];\n fallbackValues = fallbackValues.filter((v) => v != null) as boolean[];\n\n const [value, setValue] = useState(() => {\n return queries.map((query, index) => ({\n media: query,\n matches: ssr ? !!fallbackValues[index] : document.defaultView?.matchMedia(query).matches,\n }));\n });\n\n useEffect(() => {\n setValue(\n queries.map((query) => ({\n media: query,\n matches: document.defaultView?.matchMedia(query).matches,\n })),\n );\n\n const mql = queries.map((query) => document.defaultView?.matchMedia(query));\n\n const handler = (evt: MediaQueryListEvent) => {\n setValue((prev) => {\n return prev.slice().map((item) => {\n if (item.media === evt.media) {\n return { ...item, matches: evt.matches };\n }\n return item;\n });\n });\n };\n\n mql.forEach((mql) => {\n if (typeof mql?.addListener === 'function') {\n mql?.addListener(handler);\n } else {\n mql?.addEventListener('change', handler);\n }\n });\n\n return () => {\n mql.forEach((mql) => {\n if (typeof mql?.removeListener === 'function') {\n mql?.removeListener(handler);\n } else {\n mql?.removeEventListener('change', handler);\n }\n });\n };\n }, [document.defaultView]);\n\n return value.map((item) => !!item.matches);\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useMemo, useSyncExternalStore } from 'react';\n\nimport { type MulticastObservable } from '@dxos/async';\n\n/**\n * Subscribe to a MulticastObservable and return the latest value.\n * @param observable the observable to subscribe to. Will resubscribe if the observable changes.\n */\n// TODO(burdon): Move to react-hooks.\nexport const useMulticastObservable = <T>(observable: MulticastObservable<T>): T => {\n // Make sure useSyncExternalStore is stable in respect to the observable.\n const subscribeFn = useMemo(\n () => (listener: () => void) => {\n const subscription = observable.subscribe(listener);\n return () => subscription.unsubscribe();\n },\n [observable],\n );\n\n // useSyncExternalStore will resubscribe to the observable and update the value if the subscribeFn changes.\n return useSyncExternalStore(subscribeFn, () => observable.get());\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type RefCallback, useState } from 'react';\n\n/**\n * Custom React Hook that creates a ref callback and a state variable.\n * The ref callback sets the state variable when the ref changes.\n *\n * @returns An object containing the ref callback and the current value of the ref.\n */\nexport const useRefCallback = <T = any>(): { refCallback: RefCallback<T>; value: T | null } => {\n const [value, setValue] = useState<T | null>(null);\n return { refCallback: (value: T) => setValue(value), value };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useLayoutEffect, useMemo } from 'react';\n\nexport const useViewportResize = (\n cb: (event?: Event) => void,\n deps: Parameters<typeof useLayoutEffect>[1] = [],\n delay: number = 800,\n) => {\n // The cleanup must cancel the pending debounce timeout. Otherwise, if the\n // component unmounts during the `delay` window (common in jsdom/happy-dom\n // test teardown), the callback fires against a torn-down DOM and surfaces\n // as `ReferenceError: getComputedStyle is not defined`.\n const { handler: debouncedHandler, cancel } = useMemo(() => {\n let timeout: ReturnType<typeof setTimeout> | undefined;\n return {\n handler: (event?: Event) => {\n if (timeout !== undefined) {\n clearTimeout(timeout);\n }\n timeout = setTimeout(() => {\n timeout = undefined;\n cb(event);\n }, delay);\n },\n cancel: () => {\n if (timeout !== undefined) {\n clearTimeout(timeout);\n timeout = undefined;\n }\n },\n };\n }, [cb, delay]);\n\n return useLayoutEffect(() => {\n window.visualViewport?.addEventListener('resize', debouncedHandler);\n debouncedHandler();\n return () => {\n window.visualViewport?.removeEventListener('resize', debouncedHandler);\n cancel();\n };\n }, [debouncedHandler, cancel, ...deps]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useRef } from 'react';\n\nexport const useTimeout = (callback?: () => Promise<void>, delay = 0, deps: any[] = []) => {\n const callbackRef = useRef(callback);\n useEffect(() => {\n callbackRef.current = callback;\n }, [callback]);\n\n useEffect(() => {\n if (delay == null) {\n return;\n }\n\n const t = setTimeout(() => callbackRef.current?.(), delay);\n return () => clearTimeout(t);\n }, [delay, ...deps]);\n};\n\nexport const useInterval = (\n callback?: (() => Promise<void | boolean>) | (() => void | boolean),\n delay = 0,\n deps: any[] = [],\n) => {\n const callbackRef = useRef(callback);\n useEffect(() => {\n callbackRef.current = callback;\n }, [callback]);\n\n useEffect(() => {\n if (delay == null) {\n return;\n }\n\n const i = setInterval(async () => {\n const result = await callbackRef.current?.();\n if (result === false) {\n clearInterval(i);\n }\n }, delay);\n return () => clearInterval(i);\n }, [delay, ...deps]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useRef, useState } from 'react';\n\nconst isFunction = <T>(functionToCheck: any): functionToCheck is (value: T) => boolean => {\n return functionToCheck instanceof Function;\n};\n\n/**\n * This is an internal custom hook that checks if a value has transitioned from a specified 'from' value to a 'to' value.\n *\n * @param currentValue - The value that is being monitored for transitions.\n * @param fromValue - The *from* value or a predicate function that determines the start of the transition.\n * @param toValue - The *to* value or a predicate function that determines the end of the transition.\n * @returns A boolean indicating whether the transition from *fromValue* to *toValue* has occurred.\n *\n * @internal Consider using `useOnTransition` for handling transitions instead of this hook.\n */\nexport const useDidTransition = <T>(\n currentValue: T,\n fromValue: T | ((value: T) => boolean),\n toValue: T | ((value: T) => boolean),\n) => {\n const [hasTransitioned, setHasTransitioned] = useState(false);\n const previousValue = useRef<T>(currentValue);\n\n useEffect(() => {\n const toValueValid = isFunction<T>(toValue) ? toValue(currentValue) : toValue === currentValue;\n const fromValueValid = isFunction<T>(fromValue)\n ? fromValue(previousValue.current)\n : fromValue === previousValue.current;\n\n if (fromValueValid && toValueValid && !hasTransitioned) {\n setHasTransitioned(true);\n } else if ((!fromValueValid || !toValueValid) && hasTransitioned) {\n setHasTransitioned(false);\n }\n\n previousValue.current = currentValue;\n }, [currentValue, fromValue, toValue, hasTransitioned]);\n\n return hasTransitioned;\n};\n\n/**\n * Executes a callback function when a specified transition occurs in a value.\n *\n * This function utilizes the `useDidTransition` hook to monitor changes in `currentValue`.\n * When `currentValue` transitions from `fromValue` to `toValue`, the provided `callback` function is executed.\n */\n// TODO(wittjosiah): Seems overwrought.\nexport const useOnTransition = <T>(\n currentValue: T,\n fromValue: T | ((value: T) => boolean),\n toValue: T | ((value: T) => boolean),\n callback: () => void,\n) => {\n const dirty = useRef(false);\n const hasTransitioned = useDidTransition(currentValue, fromValue, toValue);\n\n useEffect(() => {\n dirty.current = false;\n }, [currentValue, dirty]);\n\n useEffect(() => {\n if (hasTransitioned && !dirty.current) {\n callback();\n dirty.current = true;\n }\n }, [hasTransitioned, dirty, callback]);\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["useComposedRefs", "useSize", "useScroller", "useEffect", "useAsyncEffect", "cb", "deps", "controller", "AbortController", "cleanup", "t", "setTimeout", "signal", "aborted", "clearTimeout", "abort", "Atom", "useAtomSet", "useAtomValue", "useMemo", "useState", "useAtomState", "initialValue", "atom", "make", "value", "set", "useEffect", "useState", "useAsyncState", "cb", "deps", "value", "setValue", "disposed", "t", "setTimeout", "data", "clearTimeout", "useCallback", "useEffect", "useRef", "useState", "useCallback", "useEffect", "useRef", "useState", "useStateWithRef", "valueProp", "value", "setValue", "valueRef", "setter", "current", "useDynamicRef", "useControlledState", "valueProp", "onChange", "value", "setControlledValue", "useState", "useEffect", "onChangeRef", "useRef", "valueRef", "useDynamicRef", "setValue", "useCallback", "nextValue", "isFunction", "current", "useEffect", "useRef", "log", "useDebugDeps", "deps", "label", "active", "lastDeps", "diff", "i", "Math", "max", "current", "length", "previous", "Object", "keys", "warn", "useEffect", "useMemo", "useState", "useDefaultValue", "reactiveValue", "getDefaultValue", "stableDefaultValue", "value", "setValue", "defaultsDeep", "useMemo", "useDefaults", "value", "defaults", "useMemo", "useFileDownload", "data", "filename", "url", "URL", "createObjectURL", "element", "document", "createElement", "setAttribute", "click", "useEffect", "useMemo", "useRef", "useForwardedRef", "forwardedRef", "localRef", "setRef", "current", "ref", "value", "mergeRefs", "refs", "cleanups", "cleanup", "push", "useMergeRefs", "alea", "useMemo", "Alea", "prng", "randomString", "n", "toString", "slice", "useId", "namespace", "propsId", "opts", "makeId", "useEffect", "useRef", "useState", "useIsFocused", "inputRef", "isFocused", "setIsFocused", "undefined", "isFocusedRef", "current", "input", "onFocus", "onBlur", "addEventListener", "document", "activeElement", "removeEventListener", "useEffect", "useState", "breakpointMediaQueries", "sm", "md", "lg", "xl", "useMediaQuery", "query", "options", "ssr", "fallback", "queries", "Array", "isArray", "map", "fallbackValues", "filter", "v", "value", "setValue", "index", "media", "matches", "document", "defaultView", "matchMedia", "mql", "handler", "evt", "prev", "slice", "item", "forEach", "addListener", "addEventListener", "removeListener", "removeEventListener", "useMemo", "useSyncExternalStore", "useMulticastObservable", "observable", "subscribeFn", "listener", "subscription", "subscribe", "unsubscribe", "get", "useState", "useRefCallback", "value", "setValue", "refCallback", "useLayoutEffect", "useMemo", "useViewportResize", "cb", "deps", "delay", "handler", "debouncedHandler", "cancel", "timeout", "event", "undefined", "clearTimeout", "setTimeout", "window", "visualViewport", "addEventListener", "removeEventListener", "useEffect", "useRef", "useTimeout", "callback", "delay", "deps", "callbackRef", "current", "t", "setTimeout", "clearTimeout", "useInterval", "i", "setInterval", "result", "clearInterval", "useEffect", "useRef", "useState", "isFunction", "functionToCheck", "Function", "useDidTransition", "currentValue", "fromValue", "toValue", "hasTransitioned", "setHasTransitioned", "previousValue", "toValueValid", "fromValueValid", "current", "useOnTransition", "callback", "dirty"]
7
7
  }