yummies 7.11.0 → 7.12.0

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.
Files changed (146) hide show
  1. package/async.cjs +162 -48
  2. package/async.cjs.map +1 -1
  3. package/async.d.ts +108 -7
  4. package/async.js +163 -54
  5. package/async.js.map +1 -1
  6. package/chunk-CVq3Gv4J.cjs +50 -0
  7. package/chunk-YKewjYmz.js +37 -0
  8. package/common.cjs +48 -8
  9. package/common.cjs.map +1 -1
  10. package/common.d.ts +35 -2
  11. package/common.js +49 -11
  12. package/common.js.map +1 -1
  13. package/complex.cjs +275 -128
  14. package/complex.cjs.map +1 -1
  15. package/complex.js +275 -133
  16. package/complex.js.map +1 -1
  17. package/cookie.cjs +17 -7
  18. package/cookie.cjs.map +1 -1
  19. package/cookie.d.ts +8 -0
  20. package/cookie.js +18 -9
  21. package/cookie.js.map +1 -1
  22. package/css.cjs +147 -39
  23. package/css.cjs.map +1 -1
  24. package/css.d.ts +98 -6
  25. package/css.js +143 -41
  26. package/css.js.map +1 -1
  27. package/data.cjs +90 -55
  28. package/data.cjs.map +1 -1
  29. package/data.d.ts +32 -0
  30. package/data.js +91 -61
  31. package/data.js.map +1 -1
  32. package/date-time.cjs +578 -412
  33. package/date-time.cjs.map +1 -1
  34. package/date-time.d.ts +88 -0
  35. package/date-time.js +575 -421
  36. package/date-time.js.map +1 -1
  37. package/device.cjs +48 -23
  38. package/device.cjs.map +1 -1
  39. package/device.d.ts +32 -0
  40. package/device.js +49 -31
  41. package/device.js.map +1 -1
  42. package/encodings.cjs +275 -266
  43. package/encodings.cjs.map +1 -1
  44. package/encodings.d.ts +8 -0
  45. package/encodings.js +276 -268
  46. package/encodings.js.map +1 -1
  47. package/errors.cjs +20 -18
  48. package/errors.cjs.map +1 -1
  49. package/errors.js +19 -19
  50. package/errors.js.map +1 -1
  51. package/file.cjs +42 -24
  52. package/file.cjs.map +1 -1
  53. package/file.d.ts +16 -0
  54. package/file.js +43 -27
  55. package/file.js.map +1 -1
  56. package/format.cjs +125 -83
  57. package/format.cjs.map +1 -1
  58. package/format.js +118 -82
  59. package/format.js.map +1 -1
  60. package/html.cjs +226 -137
  61. package/html.cjs.map +1 -1
  62. package/html.d.ts +64 -0
  63. package/html.js +223 -150
  64. package/html.js.map +1 -1
  65. package/id.cjs +74 -17
  66. package/id.cjs.map +1 -1
  67. package/id.js +73 -24
  68. package/id.js.map +1 -1
  69. package/imports.cjs +41 -29
  70. package/imports.cjs.map +1 -1
  71. package/imports.d.ts +8 -0
  72. package/imports.js +40 -31
  73. package/imports.js.map +1 -1
  74. package/math.cjs +32 -6
  75. package/math.cjs.map +1 -1
  76. package/math.d.ts +16 -0
  77. package/math.js +33 -10
  78. package/math.js.map +1 -1
  79. package/media.cjs +275 -84
  80. package/media.cjs.map +1 -1
  81. package/media.d.ts +188 -2
  82. package/media.js +274 -93
  83. package/media.js.map +1 -1
  84. package/mobx.cjs +353 -193
  85. package/mobx.cjs.map +1 -1
  86. package/mobx.d.ts +7 -0
  87. package/mobx.js +351 -200
  88. package/mobx.js.map +1 -1
  89. package/ms.cjs +21 -10
  90. package/ms.cjs.map +1 -1
  91. package/ms.js +22 -13
  92. package/ms.js.map +1 -1
  93. package/number.cjs +13 -7
  94. package/number.cjs.map +1 -1
  95. package/number.js +14 -9
  96. package/number.js.map +1 -1
  97. package/package.json +10 -2
  98. package/parser.cjs +117 -64
  99. package/parser.cjs.map +1 -1
  100. package/parser.js +111 -64
  101. package/parser.js.map +1 -1
  102. package/price.cjs +24 -18
  103. package/price.cjs.map +1 -1
  104. package/price.d.ts +8 -0
  105. package/price.js +25 -20
  106. package/price.js.map +1 -1
  107. package/random.cjs +79 -13
  108. package/random.cjs.map +1 -1
  109. package/random.d.ts +64 -0
  110. package/random.js +80 -22
  111. package/random.js.map +1 -1
  112. package/react.cjs +673 -214
  113. package/react.cjs.map +1 -1
  114. package/react.d.ts +21 -0
  115. package/react.js +674 -239
  116. package/react.js.map +1 -1
  117. package/sound.cjs +14 -9
  118. package/sound.cjs.map +1 -1
  119. package/sound.js +15 -11
  120. package/sound.js.map +1 -1
  121. package/storage.cjs +49 -50
  122. package/storage.cjs.map +1 -1
  123. package/storage.d.ts +8 -0
  124. package/storage.js +50 -53
  125. package/storage.js.map +1 -1
  126. package/text.cjs +51 -34
  127. package/text.cjs.map +1 -1
  128. package/text.js +52 -37
  129. package/text.js.map +1 -1
  130. package/type-guard.cjs +292 -72
  131. package/type-guard.cjs.map +1 -1
  132. package/type-guard.js +288 -73
  133. package/type-guard.js.map +1 -1
  134. package/types.cjs +0 -2
  135. package/types.global.cjs +0 -2
  136. package/types.global.js +0 -2
  137. package/types.js +0 -2
  138. package/vibrate.cjs +31 -6
  139. package/vibrate.cjs.map +1 -1
  140. package/vibrate.d.ts +23 -1
  141. package/vibrate.js +32 -8
  142. package/vibrate.js.map +1 -1
  143. package/types.cjs.map +0 -1
  144. package/types.global.cjs.map +0 -1
  145. package/types.global.js.map +0 -1
  146. package/types.js.map +0 -1
package/react.js CHANGED
@@ -1,240 +1,675 @@
1
- import { useRef, useEffect, useLayoutEffect, useCallback, useState } from "react";
2
- const attachRefs = (value, ...refs) => refs.forEach((ref) => {
3
- if (typeof ref === "function") {
4
- ref(value);
5
- } else if (ref && typeof ref !== "string") {
6
- ref.current = value;
7
- }
1
+ import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
2
+ //#region src/react/attach-refs.ts
3
+ /**
4
+ * Assigns the same value to multiple React refs, including callback refs.
5
+ *
6
+ * @template T Referenced value type.
7
+ * @param value Value that should be written into every provided ref.
8
+ * @param refs Target refs to update.
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * attachRefs(node, localRef, forwardedRef);
13
+ * ```
14
+ *
15
+ * @example
16
+ * ```ts
17
+ * attachRefs(null, inputRef, (value) => console.log(value));
18
+ * ```
19
+ */
20
+ var attachRefs = (value, ...refs) => refs.forEach((ref) => {
21
+ if (typeof ref === "function") ref(value);
22
+ else if (ref && typeof ref !== "string") ref.current = value;
8
23
  });
9
- const useConstant = (defineValue) => {
10
- const ref = useRef();
11
- if (!ref.current) {
12
- ref.current = { value: defineValue() };
13
- }
14
- return ref.current.value;
15
- };
16
- const useAbortController = () => {
17
- const controller = useConstant(() => new AbortController());
18
- useEffect(() => {
19
- return () => {
20
- controller.abort();
21
- };
22
- }, []);
23
- return controller;
24
- };
25
- const useAbortSignal = () => {
26
- return useAbortController().signal;
27
- };
28
- const useSyncRef = (value) => {
29
- const ref = useRef(value);
30
- ref.current = value;
31
- return ref;
32
- };
33
- const useEventListener = ({
34
- event,
35
- handler,
36
- options,
37
- deps = [],
38
- debounce,
39
- node = document
40
- }) => {
41
- const handlerRef = useSyncRef(handler);
42
- useEffect(() => {
43
- let timerId;
44
- const handleEvent = (e) => {
45
- if (debounce == null) {
46
- handlerRef.current(e);
47
- } else {
48
- clearTimeout(timerId);
49
- timerId = setTimeout(() => {
50
- handlerRef.current(e);
51
- timerId = void 0;
52
- }, debounce);
53
- }
54
- };
55
- node.addEventListener(event, handleEvent, options);
56
- return () => {
57
- node.removeEventListener(event, handleEvent, options);
58
- clearTimeout(timerId);
59
- };
60
- }, deps);
61
- };
62
- const useClickOutside = ({
63
- contentRef,
64
- onClick,
65
- options
66
- }) => {
67
- useEventListener({
68
- event: "mousedown",
69
- handler: (event) => {
70
- if (contentRef.current && !contentRef.current.contains(event.target)) {
71
- onClick();
72
- }
73
- },
74
- options
75
- });
76
- };
77
- const useDefineRef = (defineFn) => {
78
- const ref = useRef(void 0);
79
- if (!ref.current) {
80
- ref.current = defineFn();
81
- }
82
- return ref;
83
- };
84
- const useElementRef = (selector) => {
85
- const ref = useRef();
86
- useLayoutEffect(() => {
87
- ref.current = selector();
88
- }, []);
89
- return ref;
90
- };
91
- const useEvent = (handler) => {
92
- const handlerRef = useRef(handler);
93
- useLayoutEffect(() => {
94
- handlerRef.current = handler;
95
- });
96
- return useCallback((...args) => {
97
- const fn = handlerRef.current;
98
- return fn(...args);
99
- }, []);
100
- };
101
- const useFlag = (defaultValue = false) => {
102
- const [enabled, setEnabled] = useState(defaultValue);
103
- const toggle = useCallback(() => setEnabled((value) => !value), []);
104
- const enable = useCallback(() => setEnabled(true), []);
105
- const disable = useCallback(() => setEnabled(false), []);
106
- const flagObjRef = useRef({
107
- enabled,
108
- toggle,
109
- enable,
110
- disable
111
- });
112
- flagObjRef.current.enabled = enabled;
113
- return flagObjRef.current;
114
- };
115
- const useForceUpdate = () => {
116
- const [, setState] = useState(null);
117
- return useCallback(() => {
118
- setState({});
119
- }, []);
120
- };
121
- const useInitialHeight = () => {
122
- const ref = useRef(null);
123
- const [initialHeight, setInitialHeight] = useState(
124
- void 0
125
- );
126
- useEffect(() => {
127
- if (ref.current && !initialHeight) {
128
- setInitialHeight(ref.current.offsetHeight);
129
- }
130
- }, [initialHeight]);
131
- return { ref, initialHeight };
132
- };
133
- const createUseInstanceHook = (extension) => (factory, config) => {
134
- const abortSignal = useAbortSignal();
135
- const instance = useConstant(
136
- () => factory({
137
- ...extension,
138
- abortSignal,
139
- payload: config?.payload
140
- })
141
- );
142
- useLayoutEffect(() => {
143
- config?.onUpdate?.(config.payload);
144
- }, [config?.payload]);
145
- return instance;
146
- };
147
- const useInstance = createUseInstanceHook();
148
- const useIntersectionObserver = (callback, options) => {
149
- const [intersectionObserver] = useState(
150
- () => new IntersectionObserver(callback, options)
151
- );
152
- useEffect(() => {
153
- return () => {
154
- intersectionObserver.disconnect();
155
- };
156
- }, []);
157
- return intersectionObserver;
158
- };
159
- const useLastDefinedValue = (value) => {
160
- const ref = useRef(value);
161
- if (value != null) {
162
- ref.current = value;
163
- }
164
- return ref.current;
165
- };
166
- const useLastValueRef = (value) => {
167
- const ref = useRef(value);
168
- if (value != null) {
169
- ref.current = value;
170
- }
171
- return ref;
172
- };
173
- const useLifeCycle = (fn) => {
174
- const fnRef = useSyncRef(fn);
175
- useEffect(() => {
176
- const fnOperation = fnRef.current();
177
- fnOperation.mount?.();
178
- return fnOperation.unmount?.();
179
- }, []);
180
- };
181
- const useResizeObserver = (callback) => {
182
- const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));
183
- useLayoutEffect(() => {
184
- return () => {
185
- resizeObserverRef.current.disconnect();
186
- };
187
- }, []);
188
- return resizeObserverRef;
189
- };
190
- const useToggle = (initialState) => {
191
- const [toggled, setToggled] = useState(!!initialState);
192
- const toggle = useCallback(() => setToggled((toggled2) => !toggled2), []);
193
- return [toggled, toggle, setToggled];
194
- };
195
- const useValue = (defaults) => {
196
- const [value, setValue] = useState(defaults);
197
- return {
198
- value,
199
- set: setValue
200
- };
201
- };
202
- const useVisibilityState = () => {
203
- const [state, setState] = useState();
204
- useEffect(() => {
205
- const handleVisibilityChange = () => {
206
- setState(document.visibilityState);
207
- };
208
- document.addEventListener("visibilitychange", handleVisibilityChange);
209
- return () => {
210
- document.removeEventListener("visibilitychange", handleVisibilityChange);
211
- };
212
- }, []);
213
- return state;
214
- };
215
- export {
216
- attachRefs,
217
- createUseInstanceHook,
218
- useAbortController,
219
- useAbortSignal,
220
- useClickOutside,
221
- useConstant,
222
- useDefineRef,
223
- useElementRef,
224
- useEvent,
225
- useEventListener,
226
- useFlag,
227
- useForceUpdate,
228
- useInitialHeight,
229
- useInstance,
230
- useIntersectionObserver,
231
- useLastDefinedValue,
232
- useLastValueRef,
233
- useLifeCycle,
234
- useResizeObserver,
235
- useSyncRef,
236
- useToggle,
237
- useValue,
238
- useVisibilityState
239
- };
240
- //# sourceMappingURL=react.js.map
24
+ //#endregion
25
+ //#region src/react/hooks/use-constant.ts
26
+ /**
27
+ * React hook for creating a value exactly once.
28
+ *
29
+ * Unlike `useMemo`, this guarantees that the initializer is executed only once
30
+ * for the component lifetime.
31
+ *
32
+ * @template T Value type.
33
+ * @param defineValue Function that lazily creates the value.
34
+ * @returns Stable value created on the first render.
35
+ *
36
+ * @example
37
+ * ```ts
38
+ * const id = useConstant(() => crypto.randomUUID());
39
+ * ```
40
+ *
41
+ * @example
42
+ * ```ts
43
+ * const formatter = useConstant(() => new Intl.NumberFormat('en-US'));
44
+ * ```
45
+ */
46
+ var useConstant = (defineValue) => {
47
+ const ref = useRef();
48
+ if (!ref.current) ref.current = { value: defineValue() };
49
+ return ref.current.value;
50
+ };
51
+ //#endregion
52
+ //#region src/react/hooks/use-abort-controller.ts
53
+ /**
54
+ * Creates a single `AbortController` instance for the component lifetime.
55
+ *
56
+ * The controller is aborted automatically during unmount.
57
+ *
58
+ * @returns Stable abort controller instance.
59
+ *
60
+ * @example
61
+ * ```ts
62
+ * const controller = useAbortController();
63
+ * fetch('/api', { signal: controller.signal });
64
+ * ```
65
+ *
66
+ * @example
67
+ * ```ts
68
+ * const controller = useAbortController();
69
+ * controller.abort();
70
+ * ```
71
+ */
72
+ var useAbortController = () => {
73
+ const controller = useConstant(() => new AbortController());
74
+ useEffect(() => {
75
+ return () => {
76
+ controller.abort();
77
+ };
78
+ }, []);
79
+ return controller;
80
+ };
81
+ //#endregion
82
+ //#region src/react/hooks/use-abort-signal.ts
83
+ /**
84
+ * Returns an `AbortSignal` tied to the component lifecycle.
85
+ *
86
+ * The signal is aborted automatically on unmount.
87
+ *
88
+ * @returns Lifecycle-bound abort signal.
89
+ *
90
+ * @example
91
+ * ```ts
92
+ * const signal = useAbortSignal();
93
+ * fetch('/api/users', { signal });
94
+ * ```
95
+ *
96
+ * @example
97
+ * ```ts
98
+ * const signal = useAbortSignal();
99
+ * someAsyncTask({ signal });
100
+ * ```
101
+ */
102
+ var useAbortSignal = () => {
103
+ return useAbortController().signal;
104
+ };
105
+ //#endregion
106
+ //#region src/react/hooks/use-sync-ref.ts
107
+ /**
108
+ * Returns a ref whose `current` value is synchronized with the latest input
109
+ * on every render.
110
+ *
111
+ * @template T Value type.
112
+ * @param value Current value to expose through the ref.
113
+ * @returns Ref containing the latest value.
114
+ *
115
+ * @example
116
+ * ```ts
117
+ * const latestHandler = useSyncRef(onSubmit);
118
+ * latestHandler.current();
119
+ * ```
120
+ *
121
+ * @example
122
+ * ```ts
123
+ * const latestValue = useSyncRef(props.value);
124
+ * latestValue.current;
125
+ * ```
126
+ */
127
+ var useSyncRef = (value) => {
128
+ const ref = useRef(value);
129
+ ref.current = value;
130
+ return ref;
131
+ };
132
+ //#endregion
133
+ //#region src/react/hooks/use-event-listener.ts
134
+ /**
135
+ * Subscribes to a DOM event and keeps the latest handler without resubscribing
136
+ * on every render.
137
+ *
138
+ * Supports optional debounce and custom effect dependencies.
139
+ *
140
+ * @template EventName DOM event name from `HTMLElementEventMap`.
141
+ * @param config Event subscription configuration.
142
+ *
143
+ * @example
144
+ * ```ts
145
+ * useEventListener({
146
+ * event: 'click',
147
+ * handler: () => console.log('clicked'),
148
+ * });
149
+ * ```
150
+ *
151
+ * @example
152
+ * ```ts
153
+ * useEventListener({
154
+ * event: 'scroll',
155
+ * node: window,
156
+ * debounce: 100,
157
+ * handler: () => console.log('scroll'),
158
+ * });
159
+ * ```
160
+ */
161
+ var useEventListener = ({ event, handler, options, deps = [], debounce, node = document }) => {
162
+ const handlerRef = useSyncRef(handler);
163
+ useEffect(() => {
164
+ let timerId;
165
+ const handleEvent = (e) => {
166
+ if (debounce == null) handlerRef.current(e);
167
+ else {
168
+ clearTimeout(timerId);
169
+ timerId = setTimeout(() => {
170
+ handlerRef.current(e);
171
+ timerId = void 0;
172
+ }, debounce);
173
+ }
174
+ };
175
+ node.addEventListener(event, handleEvent, options);
176
+ return () => {
177
+ node.removeEventListener(event, handleEvent, options);
178
+ clearTimeout(timerId);
179
+ };
180
+ }, deps);
181
+ };
182
+ //#endregion
183
+ //#region src/react/hooks/use-click-outside.ts
184
+ /**
185
+ * Calls a handler when a pointer interaction happens outside the referenced element.
186
+ *
187
+ * @param input Target element ref, callback and event listener options.
188
+ *
189
+ * @example
190
+ * ```ts
191
+ * useClickOutside({
192
+ * contentRef: modalRef,
193
+ * onClick: () => closeModal(),
194
+ * });
195
+ * ```
196
+ *
197
+ * @example
198
+ * ```ts
199
+ * useClickOutside({
200
+ * contentRef: dropdownRef,
201
+ * onClick: hideDropdown,
202
+ * options: { capture: true },
203
+ * });
204
+ * ```
205
+ */
206
+ var useClickOutside = ({ contentRef, onClick, options }) => {
207
+ useEventListener({
208
+ event: "mousedown",
209
+ handler: (event) => {
210
+ if (contentRef.current && !contentRef.current.contains(event.target)) onClick();
211
+ },
212
+ options
213
+ });
214
+ };
215
+ //#endregion
216
+ //#region src/react/hooks/use-define-ref.ts
217
+ /**
218
+ * Creates a mutable ref whose value is initialized exactly once.
219
+ *
220
+ * @template T Ref value type.
221
+ * @param defineFn Function that lazily creates the initial ref value.
222
+ * @returns Mutable ref with a stable initialized value.
223
+ *
224
+ * @example
225
+ * ```ts
226
+ * const cacheRef = useDefineRef(() => new Map());
227
+ * ```
228
+ *
229
+ * @example
230
+ * ```ts
231
+ * const observerRef = useDefineRef(() => new ResizeObserver(() => {}));
232
+ * ```
233
+ */
234
+ var useDefineRef = (defineFn) => {
235
+ const ref = useRef(void 0);
236
+ if (!ref.current) ref.current = defineFn();
237
+ return ref;
238
+ };
239
+ //#endregion
240
+ //#region src/react/hooks/use-element-ref.ts
241
+ /**
242
+ * Resolves an element once after mount and stores it in a ref.
243
+ *
244
+ * @template T Element type.
245
+ * @param selector Function returning the target element.
246
+ * @returns Ref containing the selected element.
247
+ *
248
+ * @example
249
+ * ```ts
250
+ * const buttonRef = useElementRef(() => document.getElementById('save') as HTMLButtonElement);
251
+ * ```
252
+ *
253
+ * @example
254
+ * ```ts
255
+ * const modalRef = useElementRef(() => document.querySelector('.modal') as HTMLDivElement);
256
+ * ```
257
+ */
258
+ var useElementRef = (selector) => {
259
+ const ref = useRef();
260
+ useLayoutEffect(() => {
261
+ ref.current = selector();
262
+ }, []);
263
+ return ref;
264
+ };
265
+ //#endregion
266
+ //#region src/react/hooks/use-event.ts
267
+ /**
268
+ * Creates an event callback with a stable function identity and up-to-date logic.
269
+ *
270
+ * Borrowed from the `useEvent` RFC idea by React contributors.
271
+ *
272
+ * @template H Handler function type.
273
+ * @param handler Latest callback implementation.
274
+ * @returns Stable callback that always delegates to the latest handler.
275
+ *
276
+ * @example
277
+ * ```ts
278
+ * const onClick = useEvent(() => {
279
+ * console.log('clicked');
280
+ * });
281
+ * ```
282
+ *
283
+ * @example
284
+ * ```ts
285
+ * const onSubmit = useEvent((value: string) => save(value));
286
+ * ```
287
+ */
288
+ var useEvent = (handler) => {
289
+ const handlerRef = useRef(handler);
290
+ useLayoutEffect(() => {
291
+ handlerRef.current = handler;
292
+ });
293
+ return useCallback((...args) => {
294
+ const fn = handlerRef.current;
295
+ return fn(...args);
296
+ }, []);
297
+ };
298
+ //#endregion
299
+ //#region src/react/hooks/use-flag.ts
300
+ /**
301
+ * Manages a reusable boolean flag object with stable helper methods.
302
+ *
303
+ * @param defaultValue Initial enabled state.
304
+ * @returns Stable object exposing current state and mutators.
305
+ *
306
+ * @example
307
+ * ```ts
308
+ * const modal = useFlag();
309
+ * modal.enable();
310
+ * ```
311
+ *
312
+ * @example
313
+ * ```ts
314
+ * const loading = useFlag(true);
315
+ * loading.disable();
316
+ * ```
317
+ */
318
+ var useFlag = (defaultValue = false) => {
319
+ const [enabled, setEnabled] = useState(defaultValue);
320
+ const flagObjRef = useRef({
321
+ enabled,
322
+ toggle: useCallback(() => setEnabled((value) => !value), []),
323
+ enable: useCallback(() => setEnabled(true), []),
324
+ disable: useCallback(() => setEnabled(false), [])
325
+ });
326
+ flagObjRef.current.enabled = enabled;
327
+ return flagObjRef.current;
328
+ };
329
+ //#endregion
330
+ //#region src/react/hooks/use-force-update.ts
331
+ /**
332
+ * Forces a component re-render by updating an internal dummy state.
333
+ *
334
+ * @returns Stable callback that triggers a re-render.
335
+ *
336
+ * @example
337
+ * ```ts
338
+ * const forceUpdate = useForceUpdate();
339
+ * forceUpdate();
340
+ * ```
341
+ *
342
+ * @example
343
+ * ```ts
344
+ * const rerender = useForceUpdate();
345
+ * setTimeout(rerender, 1000);
346
+ * ```
347
+ */
348
+ var useForceUpdate = () => {
349
+ const [, setState] = useState(null);
350
+ return useCallback(() => {
351
+ setState({});
352
+ }, []);
353
+ };
354
+ //#endregion
355
+ //#region src/react/hooks/use-initial-height.ts
356
+ /**
357
+ * Captures an element's height the first time its ref becomes available.
358
+ *
359
+ * @template T Element type attached to the returned ref.
360
+ * @returns Ref and the initial measured height.
361
+ *
362
+ * @example
363
+ * ```ts
364
+ * const { ref, initialHeight } = useInitialHeight<HTMLDivElement>();
365
+ * ```
366
+ *
367
+ * @example
368
+ * ```ts
369
+ * const state = useInitialHeight<HTMLTextAreaElement>();
370
+ * state.initialHeight;
371
+ * ```
372
+ */
373
+ var useInitialHeight = () => {
374
+ const ref = useRef(null);
375
+ const [initialHeight, setInitialHeight] = useState(void 0);
376
+ useEffect(() => {
377
+ if (ref.current && !initialHeight) setInitialHeight(ref.current.offsetHeight);
378
+ }, [initialHeight]);
379
+ return {
380
+ ref,
381
+ initialHeight
382
+ };
383
+ };
384
+ //#endregion
385
+ //#region src/react/hooks/use-instance.ts
386
+ /**
387
+ * Builds a custom hook that creates an instance once and wires lifecycle helpers
388
+ * such as an `AbortSignal` and optional extension data into the factory.
389
+ *
390
+ * @template TExtension Extra configuration injected into every factory call.
391
+ * @param extension Optional static extension object merged into the factory config.
392
+ * @returns Hook factory that creates stable instances from a supplied factory.
393
+ *
394
+ * @example
395
+ * ```ts
396
+ * const useStoreInstance = createUseInstanceHook({ api });
397
+ * ```
398
+ *
399
+ * @example
400
+ * ```ts
401
+ * const useService = createUseInstanceHook({ logger });
402
+ * const service = useService(({ logger, payload }) => new Service(logger, payload));
403
+ * ```
404
+ */
405
+ var createUseInstanceHook = (extension) => (factory, config) => {
406
+ const abortSignal = useAbortSignal();
407
+ const instance = useConstant(() => factory({
408
+ ...extension,
409
+ abortSignal,
410
+ payload: config?.payload
411
+ }));
412
+ useLayoutEffect(() => {
413
+ config?.onUpdate?.(config.payload);
414
+ }, [config?.payload]);
415
+ return instance;
416
+ };
417
+ /**
418
+ * The `useInstance` hook is used to create and manage an instance of an object
419
+ * that requires access to the root store and an abort signal.
420
+ *
421
+ * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need
422
+ * to provide some specific data
423
+ *
424
+ * @param factory - A factory function that takes a configuration and returns an instance.
425
+ * @param config - An optional configuration containing additional input parameters and an update function.
426
+ * @returns An instance created by the factory function.
427
+ *
428
+ * @example
429
+ * ```ts
430
+ * const service = useInstance(({ abortSignal }) => new UsersService({ abortSignal }));
431
+ * ```
432
+ *
433
+ * @example
434
+ * ```ts
435
+ * const store = useInstance(
436
+ * ({ payload }) => new UserStore(payload),
437
+ * { payload: userId, onUpdate: (nextId) => console.log(nextId) },
438
+ * );
439
+ * ```
440
+ */
441
+ var useInstance = createUseInstanceHook();
442
+ //#endregion
443
+ //#region src/react/hooks/use-intersection-observer.ts
444
+ /**
445
+ * Creates a single `IntersectionObserver` instance and disposes it on unmount.
446
+ *
447
+ * @param callback Observer callback invoked for intersection changes.
448
+ * @param options Optional observer configuration.
449
+ * @returns Stable `IntersectionObserver` instance.
450
+ *
451
+ * @example
452
+ * ```ts
453
+ * const observer = useIntersectionObserver((entries) => {
454
+ * console.log(entries[0]?.isIntersecting);
455
+ * });
456
+ * ```
457
+ *
458
+ * @example
459
+ * ```ts
460
+ * const observer = useIntersectionObserver(handleIntersect, { threshold: 0.5 });
461
+ * observer.observe(element);
462
+ * ```
463
+ */
464
+ var useIntersectionObserver = (callback, options) => {
465
+ const [intersectionObserver] = useState(() => new IntersectionObserver(callback, options));
466
+ useEffect(() => {
467
+ return () => {
468
+ intersectionObserver.disconnect();
469
+ };
470
+ }, []);
471
+ return intersectionObserver;
472
+ };
473
+ //#endregion
474
+ //#region src/react/hooks/use-last-defined-value.ts
475
+ /**
476
+ * Remembers and returns the last non-nullish value passed to the hook.
477
+ *
478
+ * @template T Value type.
479
+ * @param value Current value that may be `null` or `undefined`.
480
+ * @returns Current value when defined, otherwise the previous defined value.
481
+ *
482
+ * @example
483
+ * ```ts
484
+ * const title = useLastDefinedValue(props.title);
485
+ * ```
486
+ *
487
+ * @example
488
+ * ```ts
489
+ * const user = useLastDefinedValue<User | null>(selectedUser);
490
+ * ```
491
+ */
492
+ var useLastDefinedValue = (value) => {
493
+ const ref = useRef(value);
494
+ if (value != null) ref.current = value;
495
+ return ref.current;
496
+ };
497
+ //#endregion
498
+ //#region src/react/hooks/use-last-value-ref.ts
499
+ /**
500
+ * Returns a ref that always points to the last non-nullish value.
501
+ *
502
+ * @template T Value type.
503
+ * @param value Current value that may temporarily become `null` or `undefined`.
504
+ * @returns Ref containing the last defined value.
505
+ *
506
+ * @example
507
+ * ```ts
508
+ * const latestUserRef = useLastValueRef(user);
509
+ * latestUserRef.current;
510
+ * ```
511
+ *
512
+ * @example
513
+ * ```ts
514
+ * const latestNodeRef = useLastValueRef<HTMLDivElement | null>(node);
515
+ * ```
516
+ */
517
+ var useLastValueRef = (value) => {
518
+ const ref = useRef(value);
519
+ if (value != null) ref.current = value;
520
+ return ref;
521
+ };
522
+ //#endregion
523
+ //#region src/react/hooks/use-life-cycle.ts
524
+ /**
525
+ * Runs mount and unmount callbacks returned by a factory function.
526
+ *
527
+ * The latest factory is stored in a ref, while the effect itself is only
528
+ * subscribed once.
529
+ *
530
+ * @param fn Factory returning optional `mount` and `unmount` handlers.
531
+ *
532
+ * @example
533
+ * ```ts
534
+ * useLifeCycle(() => ({
535
+ * mount: () => console.log('mounted'),
536
+ * unmount: () => console.log('unmounted'),
537
+ * }));
538
+ * ```
539
+ *
540
+ * @example
541
+ * ```ts
542
+ * useLifeCycle(() => ({
543
+ * mount: subscribe,
544
+ * unmount: unsubscribe,
545
+ * }));
546
+ * ```
547
+ */
548
+ var useLifeCycle = (fn) => {
549
+ const fnRef = useSyncRef(fn);
550
+ useEffect(() => {
551
+ const fnOperation = fnRef.current();
552
+ fnOperation.mount?.();
553
+ return fnOperation.unmount?.();
554
+ }, []);
555
+ };
556
+ //#endregion
557
+ //#region src/react/hooks/use-resize-observer.ts
558
+ /**
559
+ * Creates a stable `ResizeObserver` instance and disconnects it on unmount.
560
+ *
561
+ * @param callback Resize observer callback.
562
+ * @returns Ref containing the observer instance.
563
+ *
564
+ * @example
565
+ * ```ts
566
+ * const observerRef = useResizeObserver((entries) => {
567
+ * console.log(entries[0]?.contentRect.width);
568
+ * });
569
+ * ```
570
+ *
571
+ * @example
572
+ * ```ts
573
+ * const resizeObserver = useResizeObserver(handleResize);
574
+ * resizeObserver.current.observe(element);
575
+ * ```
576
+ */
577
+ var useResizeObserver = (callback) => {
578
+ const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));
579
+ useLayoutEffect(() => {
580
+ return () => {
581
+ resizeObserverRef.current.disconnect();
582
+ };
583
+ }, []);
584
+ return resizeObserverRef;
585
+ };
586
+ //#endregion
587
+ //#region src/react/hooks/use-toggle.ts
588
+ /**
589
+ * Manages a boolean state and returns helpers to toggle or set it directly.
590
+ *
591
+ * @param initialState Initial boolean value.
592
+ * @returns Tuple with current state, toggle callback and raw setter.
593
+ *
594
+ * @example
595
+ * ```ts
596
+ * const [open, toggleOpen] = useToggle();
597
+ * toggleOpen();
598
+ * ```
599
+ *
600
+ * @example
601
+ * ```ts
602
+ * const [enabled, , setEnabled] = useToggle(true);
603
+ * setEnabled(false);
604
+ * ```
605
+ */
606
+ var useToggle = (initialState) => {
607
+ const [toggled, setToggled] = useState(!!initialState);
608
+ return [
609
+ toggled,
610
+ useCallback(() => setToggled((toggled) => !toggled), []),
611
+ setToggled
612
+ ];
613
+ };
614
+ //#endregion
615
+ //#region src/react/hooks/use-value.ts
616
+ /**
617
+ * Wraps `useState` and returns the state value as an object with a `set` method.
618
+ *
619
+ * @template T State value type.
620
+ * @param defaults Initial state value or lazy initializer.
621
+ * @returns Object containing the current value and setter.
622
+ *
623
+ * @example
624
+ * ```ts
625
+ * const counter = useValue(0);
626
+ * counter.set(1);
627
+ * ```
628
+ *
629
+ * @example
630
+ * ```ts
631
+ * const user = useValue(() => ({ name: 'Ann' }));
632
+ * user.value.name;
633
+ * ```
634
+ */
635
+ var useValue = (defaults) => {
636
+ const [value, setValue] = useState(defaults);
637
+ return {
638
+ value,
639
+ set: setValue
640
+ };
641
+ };
642
+ //#endregion
643
+ //#region src/react/hooks/use-visibility-state.ts
644
+ /**
645
+ * Tracks `document.visibilityState` and updates when the page visibility changes.
646
+ *
647
+ * @returns Current document visibility state.
648
+ *
649
+ * @example
650
+ * ```ts
651
+ * const visibility = useVisibilityState();
652
+ * ```
653
+ *
654
+ * @example
655
+ * ```ts
656
+ * const isHidden = useVisibilityState() === 'hidden';
657
+ * ```
658
+ */
659
+ var useVisibilityState = () => {
660
+ const [state, setState] = useState();
661
+ useEffect(() => {
662
+ const handleVisibilityChange = () => {
663
+ setState(document.visibilityState);
664
+ };
665
+ document.addEventListener("visibilitychange", handleVisibilityChange);
666
+ return () => {
667
+ document.removeEventListener("visibilitychange", handleVisibilityChange);
668
+ };
669
+ }, []);
670
+ return state;
671
+ };
672
+ //#endregion
673
+ export { attachRefs, createUseInstanceHook, useAbortController, useAbortSignal, useClickOutside, useConstant, useDefineRef, useElementRef, useEvent, useEventListener, useFlag, useForceUpdate, useInitialHeight, useInstance, useIntersectionObserver, useLastDefinedValue, useLastValueRef, useLifeCycle, useResizeObserver, useSyncRef, useToggle, useValue, useVisibilityState };
674
+
675
+ //# sourceMappingURL=react.js.map