yummies 4.12.2 → 4.14.0

package/mobx/apply-observable.d.ts

@@ -0,0 +1,4 @@
+import type { AnyObject } from '../utils/types.js';
+export type ObservableAnnotationsArray = [string, any][];
+export declare const applyObservable: (context: AnyObject, annotationsArray: ObservableAnnotationsArray, useDecorators?: boolean) => void;
+//# sourceMappingURL=apply-observable.d.ts.map

package/mobx/apply-observable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-observable.d.ts","sourceRoot":"","sources":["../../src/mobx/apply-observable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;AAEzD,eAAO,MAAM,eAAe,GAC1B,SAAS,SAAS,EAClB,kBAAkB,0BAA0B,EAC5C,gBAAgB,OAAO,SAWxB,CAAC"}

package/mobx/apply-observable.js

@@ -0,0 +1,12 @@
+import { makeObservable } from 'mobx';
+export const applyObservable = (context, annotationsArray, useDecorators) => {
+    if (useDecorators) {
+        annotationsArray.forEach(([field, annotation]) => {
+            annotation(context, field);
+        });
+        makeObservable(context);
+    }
+    else {
+        makeObservable(context, Object.fromEntries(annotationsArray));
+    }
+};

package/mobx/deep-observable-struct.js

@@ -49,7 +49,7 @@ export class DeepObservableStruct {
         }
         Object.keys(newData).forEach((newDataKey) => {
             if (!this.data[newDataKey]) {
-                // @ts-ignore
+                // @ts-expect-error
                 this.data[newDataKey] = newData[newDataKey];
             }
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "4.12.2",
+  "version": "4.14.0",
   "keywords": [],
   "author": "js2me",
   "license": "MIT",
@@ -15,11 +15,15 @@
     "url": "git://github.com/js2me/yummies"
   },
   "peerDependencies": {
-    "mobx": "^6.12.4"
+    "mobx": "^6.12.4",
+    "react": "^18 || ^19"
   },
   "peerDependenciesMeta": {
     "mobx": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -32,10 +36,11 @@
     "tailwind-merge": "^3.3.1"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.2.2",
     "@changesets/changelog-github": "^0.5.1",
     "@changesets/cli": "^2.29.5",
-    "@biomejs/biome": "2.1.4",
     "@types/node": "^20.17.30",
+    "@types/react": "^18",
     "@vitejs/plugin-react-swc": "^3.9.0",
     "@vitest/coverage-istanbul": "^3.1.2",
     "commitfmt": "^1.0.4",
@@ -194,6 +199,11 @@
       "default": "./media.js",
       "types": "./media.d.ts"
     },
+    "./mobx/apply-observable": {
+      "import": "./mobx/apply-observable.js",
+      "default": "./mobx/apply-observable.js",
+      "types": "./mobx/apply-observable.d.ts"
+    },
     "./mobx/deep-observable-struct.test": {
       "import": "./mobx/deep-observable-struct.test.js",
       "default": "./mobx/deep-observable-struct.test.js",
@@ -269,6 +279,121 @@
       "default": "./random.js",
       "types": "./random.d.ts"
     },
+    "./react/hooks": {
+      "import": "./react/hooks/index.js",
+      "default": "./react/hooks/index.js",
+      "types": "./react/hooks/index.d.ts"
+    },
+    "./react/hooks/use-abort-controller": {
+      "import": "./react/hooks/use-abort-controller.js",
+      "default": "./react/hooks/use-abort-controller.js",
+      "types": "./react/hooks/use-abort-controller.d.ts"
+    },
+    "./react/hooks/use-abort-signal": {
+      "import": "./react/hooks/use-abort-signal.js",
+      "default": "./react/hooks/use-abort-signal.js",
+      "types": "./react/hooks/use-abort-signal.d.ts"
+    },
+    "./react/hooks/use-click-outside": {
+      "import": "./react/hooks/use-click-outside.js",
+      "default": "./react/hooks/use-click-outside.js",
+      "types": "./react/hooks/use-click-outside.d.ts"
+    },
+    "./react/hooks/use-constant": {
+      "import": "./react/hooks/use-constant.js",
+      "default": "./react/hooks/use-constant.js",
+      "types": "./react/hooks/use-constant.d.ts"
+    },
+    "./react/hooks/use-define-ref": {
+      "import": "./react/hooks/use-define-ref.js",
+      "default": "./react/hooks/use-define-ref.js",
+      "types": "./react/hooks/use-define-ref.d.ts"
+    },
+    "./react/hooks/use-element-ref": {
+      "import": "./react/hooks/use-element-ref.js",
+      "default": "./react/hooks/use-element-ref.js",
+      "types": "./react/hooks/use-element-ref.d.ts"
+    },
+    "./react/hooks/use-event-listener": {
+      "import": "./react/hooks/use-event-listener.js",
+      "default": "./react/hooks/use-event-listener.js",
+      "types": "./react/hooks/use-event-listener.d.ts"
+    },
+    "./react/hooks/use-event": {
+      "import": "./react/hooks/use-event.js",
+      "default": "./react/hooks/use-event.js",
+      "types": "./react/hooks/use-event.d.ts"
+    },
+    "./react/hooks/use-flag": {
+      "import": "./react/hooks/use-flag.js",
+      "default": "./react/hooks/use-flag.js",
+      "types": "./react/hooks/use-flag.d.ts"
+    },
+    "./react/hooks/use-force-update": {
+      "import": "./react/hooks/use-force-update.js",
+      "default": "./react/hooks/use-force-update.js",
+      "types": "./react/hooks/use-force-update.d.ts"
+    },
+    "./react/hooks/use-initial-height": {
+      "import": "./react/hooks/use-initial-height.js",
+      "default": "./react/hooks/use-initial-height.js",
+      "types": "./react/hooks/use-initial-height.d.ts"
+    },
+    "./react/hooks/use-instance": {
+      "import": "./react/hooks/use-instance.js",
+      "default": "./react/hooks/use-instance.js",
+      "types": "./react/hooks/use-instance.d.ts"
+    },
+    "./react/hooks/use-intersection-observer": {
+      "import": "./react/hooks/use-intersection-observer.js",
+      "default": "./react/hooks/use-intersection-observer.js",
+      "types": "./react/hooks/use-intersection-observer.d.ts"
+    },
+    "./react/hooks/use-last-defined-value": {
+      "import": "./react/hooks/use-last-defined-value.js",
+      "default": "./react/hooks/use-last-defined-value.js",
+      "types": "./react/hooks/use-last-defined-value.d.ts"
+    },
+    "./react/hooks/use-last-value-ref": {
+      "import": "./react/hooks/use-last-value-ref.js",
+      "default": "./react/hooks/use-last-value-ref.js",
+      "types": "./react/hooks/use-last-value-ref.d.ts"
+    },
+    "./react/hooks/use-life-cycle": {
+      "import": "./react/hooks/use-life-cycle.js",
+      "default": "./react/hooks/use-life-cycle.js",
+      "types": "./react/hooks/use-life-cycle.d.ts"
+    },
+    "./react/hooks/use-resize-observer": {
+      "import": "./react/hooks/use-resize-observer.js",
+      "default": "./react/hooks/use-resize-observer.js",
+      "types": "./react/hooks/use-resize-observer.d.ts"
+    },
+    "./react/hooks/use-sync-ref": {
+      "import": "./react/hooks/use-sync-ref.js",
+      "default": "./react/hooks/use-sync-ref.js",
+      "types": "./react/hooks/use-sync-ref.d.ts"
+    },
+    "./react/hooks/use-toggle": {
+      "import": "./react/hooks/use-toggle.js",
+      "default": "./react/hooks/use-toggle.js",
+      "types": "./react/hooks/use-toggle.d.ts"
+    },
+    "./react/hooks/use-value": {
+      "import": "./react/hooks/use-value.js",
+      "default": "./react/hooks/use-value.js",
+      "types": "./react/hooks/use-value.d.ts"
+    },
+    "./react/hooks/use-visibility-state": {
+      "import": "./react/hooks/use-visibility-state.js",
+      "default": "./react/hooks/use-visibility-state.js",
+      "types": "./react/hooks/use-visibility-state.d.ts"
+    },
+    "./react": {
+      "import": "./react/index.js",
+      "default": "./react/index.js",
+      "types": "./react/index.d.ts"
+    },
     "./sound": {
       "import": "./sound.js",
       "default": "./sound.js",

package/react/hooks/index.d.ts

@@ -0,0 +1,22 @@
+export * from './use-abort-controller.js';
+export * from './use-abort-signal.js';
+export * from './use-click-outside.js';
+export * from './use-constant.js';
+export * from './use-define-ref.js';
+export * from './use-element-ref.js';
+export * from './use-event.js';
+export * from './use-event-listener.js';
+export * from './use-flag.js';
+export * from './use-force-update.js';
+export * from './use-initial-height.js';
+export * from './use-instance.js';
+export * from './use-intersection-observer.js';
+export * from './use-last-defined-value.js';
+export * from './use-last-value-ref.js';
+export * from './use-life-cycle.js';
+export * from './use-resize-observer.js';
+export * from './use-sync-ref.js';
+export * from './use-toggle.js';
+export * from './use-value.js';
+export * from './use-visibility-state.js';
+//# sourceMappingURL=index.d.ts.map

package/react/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC"}

package/react/hooks/index.js

@@ -0,0 +1,21 @@
+export * from './use-abort-controller.js';
+export * from './use-abort-signal.js';
+export * from './use-click-outside.js';
+export * from './use-constant.js';
+export * from './use-define-ref.js';
+export * from './use-element-ref.js';
+export * from './use-event.js';
+export * from './use-event-listener.js';
+export * from './use-flag.js';
+export * from './use-force-update.js';
+export * from './use-initial-height.js';
+export * from './use-instance.js';
+export * from './use-intersection-observer.js';
+export * from './use-last-defined-value.js';
+export * from './use-last-value-ref.js';
+export * from './use-life-cycle.js';
+export * from './use-resize-observer.js';
+export * from './use-sync-ref.js';
+export * from './use-toggle.js';
+export * from './use-value.js';
+export * from './use-visibility-state.js';

package/react/hooks/use-abort-controller.d.ts

@@ -0,0 +1,2 @@
+export declare const useAbortController: () => AbortController;
+//# sourceMappingURL=use-abort-controller.d.ts.map

package/react/hooks/use-abort-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-abort-controller.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-abort-controller.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,uBAU9B,CAAC"}

package/react/hooks/use-abort-controller.js

@@ -0,0 +1,11 @@
+import { useEffect } from 'react';
+import { useConstant } from './use-constant.js';
+export const useAbortController = () => {
+    const controller = useConstant(() => new AbortController());
+    useEffect(() => {
+        return () => {
+            controller.abort();
+        };
+    }, []);
+    return controller;
+};

package/react/hooks/use-abort-signal.d.ts

@@ -0,0 +1,2 @@
+export declare const useAbortSignal: () => AbortSignal;
+//# sourceMappingURL=use-abort-signal.d.ts.map

package/react/hooks/use-abort-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-abort-signal.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-abort-signal.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,mBAE1B,CAAC"}

package/react/hooks/use-abort-signal.js

@@ -0,0 +1,4 @@
+import { useAbortController } from './use-abort-controller.js';
+export const useAbortSignal = () => {
+    return useAbortController().signal;
+};

package/react/hooks/use-click-outside.d.ts

@@ -0,0 +1,9 @@
+import type { MutableRefObject } from 'react';
+type ClickOutsideInput = {
+    contentRef: MutableRefObject<HTMLElement | null>;
+    onClick: VoidFunction;
+    options?: AddEventListenerOptions;
+};
+export declare const useClickOutside: ({ contentRef, onClick, options, }: ClickOutsideInput) => void;
+export {};
+//# sourceMappingURL=use-click-outside.d.ts.map

package/react/hooks/use-click-outside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-click-outside.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-click-outside.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAG9C,KAAK,iBAAiB,GAAG;IACvB,UAAU,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,mCAI7B,iBAAiB,SAanB,CAAC"}

package/react/hooks/use-click-outside.js

@@ -0,0 +1,13 @@
+import { useEventListener } from './use-event-listener.js';
+export const useClickOutside = ({ contentRef, onClick, options, }) => {
+    useEventListener({
+        event: 'mousedown',
+        handler: (event) => {
+            if (contentRef.current &&
+                !contentRef.current.contains(event.target)) {
+                onClick();
+            }
+        },
+        options,
+    });
+};

package/react/hooks/use-constant.d.ts

@@ -0,0 +1,9 @@
+/**
+ * React hook for creating a value exactly once.
+ * useMemo doesn't give this guarantee unfortunately -
+ * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily
+ * https://reactjs.org/docs/hooks-reference.html#usememo
+ * @param defineValue Function which returns defined value.
+ */
+export declare const useConstant: <T>(defineValue: () => T) => T;
+//# sourceMappingURL=use-constant.d.ts.map

package/react/hooks/use-constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-constant.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-constant.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,aAAa,MAAM,CAAC,KAAG,CAQrD,CAAC"}

package/react/hooks/use-constant.js

@@ -0,0 +1,15 @@
+import { useRef } from 'react';
+/**
+ * React hook for creating a value exactly once.
+ * useMemo doesn't give this guarantee unfortunately -
+ * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily
+ * https://reactjs.org/docs/hooks-reference.html#usememo
+ * @param defineValue Function which returns defined value.
+ */
+export const useConstant = (defineValue) => {
+    const ref = useRef();
+    if (!ref.current) {
+        ref.current = { value: defineValue() };
+    }
+    return ref.current.value;
+};

package/react/hooks/use-define-ref.d.ts

@@ -0,0 +1,10 @@
+import { type MutableRefObject } from 'react';
+/**
+ * React hook for creating a value exactly once.
+ * useMemo doesn't give this guarantee unfortunately -
+ * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily
+ * https://reactjs.org/docs/hooks-reference.html#usememo
+ * @param defineFn Function which returns defined value.
+ */
+export declare const useDefineRef: <T>(defineFn: () => T) => MutableRefObject<T>;
+//# sourceMappingURL=use-define-ref.d.ts.map

package/react/hooks/use-define-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-define-ref.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-define-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAU,MAAM,OAAO,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,UAAU,MAAM,CAAC,KAAG,gBAAgB,CAAC,CAAC,CAQrE,CAAC"}

package/react/hooks/use-define-ref.js

@@ -0,0 +1,15 @@
+import { useRef } from 'react';
+/**
+ * React hook for creating a value exactly once.
+ * useMemo doesn't give this guarantee unfortunately -
+ * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily
+ * https://reactjs.org/docs/hooks-reference.html#usememo
+ * @param defineFn Function which returns defined value.
+ */
+export const useDefineRef = (defineFn) => {
+    const ref = useRef(void 0);
+    if (!ref.current) {
+        ref.current = defineFn();
+    }
+    return ref;
+};

package/react/hooks/use-element-ref.d.ts

@@ -0,0 +1,2 @@
+export declare const useElementRef: <T extends HTMLElement>(selector: () => T) => import("react").MutableRefObject<T | undefined>;
+//# sourceMappingURL=use-element-ref.d.ts.map

package/react/hooks/use-element-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-element-ref.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-element-ref.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,WAAW,EAAE,UAAU,MAAM,CAAC,oDAQrE,CAAC"}

package/react/hooks/use-element-ref.js

@@ -0,0 +1,8 @@
+import { useLayoutEffect, useRef } from 'react';
+export const useElementRef = (selector) => {
+    const ref = useRef();
+    useLayoutEffect(() => {
+        ref.current = selector();
+    }, []);
+    return ref;
+};

package/react/hooks/use-event-listener.d.ts

@@ -0,0 +1,8 @@
+export declare const useEventListener: <EventName extends keyof HTMLElementEventMap>({ event, handler, options, deps, node, }: {
+    event: EventName;
+    handler: (e: HTMLElementEventMap[EventName]) => void;
+    options?: boolean | AddEventListenerOptions;
+    deps?: unknown[];
+    node?: HTMLElement | Document | Window;
+}) => void;
+//# sourceMappingURL=use-event-listener.d.ts.map

package/react/hooks/use-event-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-listener.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-event-listener.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,GAAI,SAAS,SAAS,MAAM,mBAAmB,EAAE,0CAM3E;IACD,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,CAAC,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IAC5C,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC,SAYA,CAAC"}

package/react/hooks/use-event-listener.js

@@ -0,0 +1,13 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+import { useEffect } from 'react';
+import { useSyncRef } from './use-sync-ref.js';
+export const useEventListener = ({ event, handler, options, deps = [], node = document, }) => {
+    const handlerRef = useSyncRef(handler);
+    useEffect(() => {
+        const handleEvent = (e) => handlerRef.current(e);
+        // @ts-expect-error
+        node.addEventListener(event, handleEvent, options);
+        // @ts-expect-error
+        return () => node.removeEventListener(event, handleEvent, options);
+    }, deps);
+};

package/react/hooks/use-event.d.ts

@@ -0,0 +1,3 @@
+import type { AnyFunction } from '../../utils/types.js';
+export declare const useEvent: <H extends AnyFunction>(handler: H) => H;
+//# sourceMappingURL=use-event.d.ts.map

package/react/hooks/use-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-event.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,WAAW,EAAE,SAAS,CAAC,KAAG,CAa5D,CAAC"}

package/react/hooks/use-event.js

@@ -0,0 +1,19 @@
+/**
+ * A Hook to define an event handler with an always-stable function identity.
+ *
+ * borrowed from @gaeron
+ * https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md
+ */
+import { useCallback, useLayoutEffect, useRef } from 'react';
+export const useEvent = (handler) => {
+    const handlerRef = useRef(handler);
+    // In a real implementation, this would run before layout effects
+    useLayoutEffect(() => {
+        handlerRef.current = handler;
+    });
+    return useCallback((...args) => {
+        // In a real implementation, this would throw if called during render
+        const fn = handlerRef.current;
+        return fn(...args);
+    }, []);
+};

package/react/hooks/use-flag.d.ts

@@ -0,0 +1,8 @@
+export interface FlagHook {
+    enabled: boolean;
+    toggle: VoidFunction;
+    enable: VoidFunction;
+    disable: VoidFunction;
+}
+export declare const useFlag: (defaultValue?: boolean) => FlagHook;
+//# sourceMappingURL=use-flag.d.ts.map

package/react/hooks/use-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-flag.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-flag.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,eAAO,MAAM,OAAO,GAAI,sBAAoB,KAAG,QAiB9C,CAAC"}

package/react/hooks/use-flag.js

@@ -0,0 +1,15 @@
+import { useCallback, useRef, useState } from 'react';
+export const useFlag = (defaultValue = false) => {
+    const [enabled, setEnabled] = useState(defaultValue);
+    const toggle = useCallback(() => setEnabled((value) => !value), []);
+    const enable = useCallback(() => setEnabled(true), []);
+    const disable = useCallback(() => setEnabled(false), []);
+    const flagObjRef = useRef({
+        enabled,
+        toggle,
+        enable,
+        disable,
+    });
+    flagObjRef.current.enabled = enabled;
+    return flagObjRef.current;
+};

package/react/hooks/use-force-update.d.ts

@@ -0,0 +1,2 @@
+export declare const useForceUpdate: () => () => void;
+//# sourceMappingURL=use-force-update.d.ts.map

package/react/hooks/use-force-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-force-update.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-force-update.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,kBAM1B,CAAC"}

package/react/hooks/use-force-update.js

@@ -0,0 +1,7 @@
+import { useCallback, useState } from 'react';
+export const useForceUpdate = () => {
+    const [, setState] = useState(null);
+    return useCallback(() => {
+        setState({});
+    }, []);
+};

package/react/hooks/use-initial-height.d.ts

@@ -0,0 +1,5 @@
+export declare const useInitialHeight: <T extends HTMLElement>() => {
+    ref: import("react").MutableRefObject<T | null>;
+    initialHeight: number | undefined;
+};
+//# sourceMappingURL=use-initial-height.d.ts.map

package/react/hooks/use-initial-height.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-initial-height.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-initial-height.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,WAAW;;;CAarD,CAAC"}

package/react/hooks/use-initial-height.js

@@ -0,0 +1,11 @@
+import { useEffect, useRef, useState } from 'react';
+export const useInitialHeight = () => {
+    const ref = useRef(null);
+    const [initialHeight, setInitialHeight] = useState(undefined);
+    useEffect(() => {
+        if (ref.current && !initialHeight) {
+            setInitialHeight(ref.current.offsetHeight);
+        }
+    }, [initialHeight]);
+    return { ref, initialHeight };
+};

package/react/hooks/use-instance.d.ts

@@ -0,0 +1,27 @@
+export type InstanceCreateConfig<TPayload, TExtension = {}> = TExtension & {
+    abortSignal: AbortSignal;
+    payload: TPayload;
+};
+export declare const createUseInstanceHook: <TExtension = {}>(extension?: TExtension) => <TInstance, TPayload>(factory: (config: InstanceCreateConfig<NoInfer<TPayload>, TExtension>) => TInstance, config?: {
+    payload?: TPayload;
+    onUpdate?: (payload: TPayload) => void;
+}) => TInstance;
+/**
+ * The `useInstance` hook is used to create and manage an instance of an object
+ * that requires access to the root store and an abort signal.
+ *
+ * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need
+ * to provide some specific data
+ *
+ * @param factory - A factory function that takes a configuration and returns an instance.
+ * @param config - An optional configuration containing additional input parameters and an update function.
+ * @returns An instance created by the factory function.
+ */
+export declare const useInstance: <TInstance, TPayload>(factory: (config: {
+    abortSignal: AbortSignal;
+    payload: NoInfer<TPayload>;
+}) => TInstance, config?: {
+    payload?: TPayload | undefined;
+    onUpdate?: ((payload: TPayload) => void) | undefined;
+} | undefined) => TInstance;
+//# sourceMappingURL=use-instance.d.ts.map

package/react/hooks/use-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-instance.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-instance.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,CAAC,QAAQ,EAAE,UAAU,GAAG,EAAE,IAAI,UAAU,GAAG;IACzE,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAC/B,UAAU,GAAG,EAAE,EAAE,YAAY,UAAU,MACvC,SAAS,EAAE,QAAQ,EAClB,SAAS,CACP,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,KACxD,SAAS,EACd,SAAS;IACP,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CACxC,cAiBF,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GArCrB,SAAS,EAAE,QAAQ;iBANP,WAAW;;;;uCAYc,IAAI;2BA+BM,CAAC"}

package/react/hooks/use-instance.js

@@ -0,0 +1,27 @@
+import { useLayoutEffect } from 'react';
+import { useAbortSignal } from './use-abort-signal.js';
+import { useConstant } from './use-constant.js';
+export const createUseInstanceHook = (extension) => (factory, config) => {
+    const abortSignal = useAbortSignal();
+    const instance = useConstant(() => factory({
+        ...extension,
+        abortSignal,
+        payload: config?.payload,
+    }));
+    useLayoutEffect(() => {
+        config?.onUpdate?.(config.payload);
+    }, [config?.payload]);
+    return instance;
+};
+/**
+ * The `useInstance` hook is used to create and manage an instance of an object
+ * that requires access to the root store and an abort signal.
+ *
+ * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need
+ * to provide some specific data
+ *
+ * @param factory - A factory function that takes a configuration and returns an instance.
+ * @param config - An optional configuration containing additional input parameters and an update function.
+ * @returns An instance created by the factory function.
+ */
+export const useInstance = createUseInstanceHook();

package/react/hooks/use-intersection-observer.d.ts

@@ -0,0 +1,2 @@
+export declare const useIntersectionObserver: (callback: IntersectionObserverCallback, options?: IntersectionObserverInit) => IntersectionObserver;
+//# sourceMappingURL=use-intersection-observer.d.ts.map

package/react/hooks/use-intersection-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-intersection-observer.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-intersection-observer.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,GAClC,UAAU,4BAA4B,EACtC,UAAU,wBAAwB,yBAanC,CAAC"}

package/react/hooks/use-intersection-observer.js

@@ -0,0 +1,10 @@
+import { useEffect, useState } from 'react';
+export const useIntersectionObserver = (callback, options) => {
+    const [intersectionObserver] = useState(() => new IntersectionObserver(callback, options));
+    useEffect(() => {
+        return () => {
+            intersectionObserver.disconnect();
+        };
+    }, []);
+    return intersectionObserver;
+};

package/react/hooks/use-last-defined-value.d.ts

@@ -0,0 +1,2 @@
+export declare const useLastDefinedValue: <T>(value: T) => T;
+//# sourceMappingURL=use-last-defined-value.d.ts.map

package/react/hooks/use-last-defined-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-last-defined-value.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-last-defined-value.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,OAAO,CAAC,MAM9C,CAAC"}

package/react/hooks/use-last-defined-value.js

@@ -0,0 +1,8 @@
+import { useRef } from 'react';
+export const useLastDefinedValue = (value) => {
+    const ref = useRef(value);
+    if (value != null) {
+        ref.current = value;
+    }
+    return ref.current;
+};

package/react/hooks/use-last-value-ref.d.ts

@@ -0,0 +1,2 @@
+export declare const useLastValueRef: <T>(value: T | null | undefined) => import("react").MutableRefObject<T | null | undefined>;
+//# sourceMappingURL=use-last-value-ref.d.ts.map

package/react/hooks/use-last-value-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-last-value-ref.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-last-value-ref.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,2DAQ7D,CAAC"}

package/react/hooks/use-last-value-ref.js

@@ -0,0 +1,8 @@
+import { useRef } from 'react';
+export const useLastValueRef = (value) => {
+    const ref = useRef(value);
+    if (value != null) {
+        ref.current = value;
+    }
+    return ref;
+};

package/react/hooks/use-life-cycle.d.ts

@@ -0,0 +1,5 @@
+export declare const useLifeCycle: (fn: () => {
+    mount?: VoidFunction;
+    unmount?: VoidFunction;
+}) => void;
+//# sourceMappingURL=use-life-cycle.d.ts.map

package/react/hooks/use-life-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-life-cycle.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-life-cycle.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,GACvB,IAAI,MAAM;IACR,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,SASF,CAAC"}

package/react/hooks/use-life-cycle.js

@@ -0,0 +1,10 @@
+import { useEffect } from 'react';
+import { useSyncRef } from './use-sync-ref.js';
+export const useLifeCycle = (fn) => {
+    const fnRef = useSyncRef(fn);
+    useEffect(() => {
+        const fnOperation = fnRef.current();
+        fnOperation.mount?.();
+        return fnOperation.unmount?.();
+    }, []);
+};

package/react/hooks/use-resize-observer.d.ts

@@ -0,0 +1,2 @@
+export declare const useResizeObserver: (callback: ResizeObserverCallback) => import("react").MutableRefObject<ResizeObserver>;
+//# sourceMappingURL=use-resize-observer.d.ts.map

package/react/hooks/use-resize-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-resize-observer.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-resize-observer.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,GAAI,UAAU,sBAAsB,qDAUjE,CAAC"}

package/react/hooks/use-resize-observer.js

@@ -0,0 +1,11 @@
+import { useLayoutEffect } from 'react';
+import { useDefineRef } from './use-define-ref.js';
+export const useResizeObserver = (callback) => {
+    const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));
+    useLayoutEffect(() => {
+        return () => {
+            resizeObserverRef.current.disconnect();
+        };
+    }, []);
+    return resizeObserverRef;
+};

package/react/hooks/use-sync-ref.d.ts

@@ -0,0 +1,2 @@
+export declare const useSyncRef: <T>(value: T) => import("react").MutableRefObject<T>;
+//# sourceMappingURL=use-sync-ref.d.ts.map

package/react/hooks/use-sync-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sync-ref.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-sync-ref.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,CAAC,wCAIrC,CAAC"}

package/react/hooks/use-sync-ref.js

@@ -0,0 +1,6 @@
+import { useRef } from 'react';
+export const useSyncRef = (value) => {
+    const ref = useRef(value);
+    ref.current = value;
+    return ref;
+};

package/react/hooks/use-toggle.d.ts

@@ -0,0 +1,2 @@
+export declare const useToggle: (initialState?: boolean) => readonly [boolean, () => void, import("react").Dispatch<import("react").SetStateAction<boolean>>];
+//# sourceMappingURL=use-toggle.d.ts.map

package/react/hooks/use-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-toggle.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-toggle.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,GAAI,eAAe,OAAO,sGAM/C,CAAC"}

package/react/hooks/use-toggle.js

@@ -0,0 +1,6 @@
+import { useCallback, useState } from 'react';
+export const useToggle = (initialState) => {
+    const [toggled, setToggled] = useState(!!initialState);
+    const toggle = useCallback(() => setToggled((toggled) => !toggled), []);
+    return [toggled, toggle, setToggled];
+};

package/react/hooks/use-value.d.ts

@@ -0,0 +1,5 @@
+export declare const useValue: <T>(defaults: T | (() => T)) => {
+    value: T;
+    set: import("react").Dispatch<import("react").SetStateAction<T>>;
+};
+//# sourceMappingURL=use-value.d.ts.map

package/react/hooks/use-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-value.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-value.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;;;CAOlD,CAAC"}

package/react/hooks/use-value.js

@@ -0,0 +1,8 @@
+import { useState } from 'react';
+export const useValue = (defaults) => {
+    const [value, setValue] = useState(defaults);
+    return {
+        value,
+        set: setValue,
+    };
+};

package/react/hooks/use-visibility-state.d.ts

@@ -0,0 +1,2 @@
+export declare const useVisibilityState: () => DocumentVisibilityState | undefined;
+//# sourceMappingURL=use-visibility-state.d.ts.map

package/react/hooks/use-visibility-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visibility-state.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-visibility-state.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,2CAgB9B,CAAC"}

package/react/hooks/use-visibility-state.js

@@ -0,0 +1,14 @@
+import { useEffect, useState } from 'react';
+export const useVisibilityState = () => {
+    const [state, setState] = useState();
+    useEffect(() => {
+        const handleVisibilityChange = () => {
+            setState(document.visibilityState);
+        };
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        return () => {
+            document.removeEventListener('visibilitychange', handleVisibilityChange);
+        };
+    }, []);
+    return state;
+};

package/react/index.d.ts

@@ -0,0 +1,2 @@
+export * from './hooks/index.js';
+//# sourceMappingURL=index.d.ts.map

package/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/react/index.js

@@ -0,0 +1 @@
+export * from './hooks/index.js';

package/sound.js

@@ -7,6 +7,6 @@ export const playSound = async (file, { volume = 1 } = {}) => {
     audio.muted = !volume;
     await audio.play();
     audio.remove();
-    // @ts-ignore
+    // @ts-expect-error
     audio = null;
 };

package/type-guard/_exports.js

@@ -22,7 +22,7 @@ function getType(value) {
         return Type.Null;
     }
     // handle DOM elements
-    // @ts-ignore
+    // @ts-expect-error
     if (value && (value.nodeType === 1 || value.nodeType === 9)) {
         return Type.Element;
     }