yummies 7.8.1 → 7.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "7.8.1",
+  "version": "7.9.0",
   "keywords": [
     "javascript",
     "typescript",

package/react.cjs

@@ -37,13 +37,28 @@ const useEventListener = ({
   handler,
   options,
   deps = [],
+  debounce,
   node = document
 }) => {
   const handlerRef = useSyncRef(handler);
   react.useEffect(() => {
-    const handleEvent = (e) => handlerRef.current(e);
+    let timerId;
+    const handleEvent = (e) => {
+      if (debounce == null) {
+        handlerRef.current(e);
+      } else {
+        clearTimeout(timerId);
+        timerId = setTimeout(() => {
+          handlerRef.current(e);
+          timerId = void 0;
+        }, debounce);
+      }
+    };
     node.addEventListener(event, handleEvent, options);
-    return () => node.removeEventListener(event, handleEvent, options);
+    return () => {
+      node.removeEventListener(event, handleEvent, options);
+      clearTimeout(timerId);
+    };
   }, deps);
 };
 const useClickOutside = ({

package/react.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.cjs","sources":["../src/react/attach-refs.ts","../src/react/hooks/use-constant.ts","../src/react/hooks/use-abort-controller.ts","../src/react/hooks/use-abort-signal.ts","../src/react/hooks/use-sync-ref.ts","../src/react/hooks/use-event-listener.ts","../src/react/hooks/use-click-outside.ts","../src/react/hooks/use-define-ref.ts","../src/react/hooks/use-element-ref.ts","../src/react/hooks/use-event.ts","../src/react/hooks/use-flag.ts","../src/react/hooks/use-force-update.ts","../src/react/hooks/use-initial-height.ts","../src/react/hooks/use-instance.ts","../src/react/hooks/use-intersection-observer.ts","../src/react/hooks/use-last-defined-value.ts","../src/react/hooks/use-last-value-ref.ts","../src/react/hooks/use-life-cycle.ts","../src/react/hooks/use-resize-observer.ts","../src/react/hooks/use-toggle.ts","../src/react/hooks/use-value.ts","../src/react/hooks/use-visibility-state.ts"],"sourcesContent":["import type { LegacyRef, RefObject } from 'react';\nimport type { Maybe } from 'yummies/types';\n\nexport const attachRefs = <T>(\n  value: T | null,\n  ...refs: Maybe<RefObject<T> | RefObject<T | null> | LegacyRef<T>>[]\n) =>\n  refs.forEach((ref) => {\n    if (typeof ref === 'function') {\n      ref(value);\n    } else if (ref && typeof ref !== 'string') {\n      // @ts-expect-error\n      ref.current = value;\n    }\n  });\n","import { useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineValue Function which returns defined value.\n */\nexport const useConstant = <T>(defineValue: () => T): T => {\n  const ref = useRef<{ value: T }>();\n\n  if (!ref.current) {\n    ref.current = { value: defineValue() };\n  }\n\n  return ref.current.value;\n};\n","import { useEffect } from 'react';\n\nimport { useConstant } from './use-constant.js';\n\nexport const useAbortController = () => {\n  const controller = useConstant(() => new AbortController());\n\n  useEffect(() => {\n    return () => {\n      controller.abort();\n    };\n  }, []);\n\n  return controller;\n};\n","import { useAbortController } from './use-abort-controller.js';\n\nexport const useAbortSignal = () => {\n  return useAbortController().signal;\n};\n","import { useRef } from 'react';\n\nexport const useSyncRef = <T>(value: T) => {\n  const ref = useRef(value);\n  ref.current = value;\n  return ref;\n};\n","/* eslint-disable @typescript-eslint/ban-ts-comment */\nimport { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useEventListener = <EventName extends keyof HTMLElementEventMap>({\n  event,\n  handler,\n  options,\n  deps = [],\n  node = document,\n}: {\n  event: EventName;\n  handler: (e: HTMLElementEventMap[EventName]) => void;\n  options?: boolean | AddEventListenerOptions;\n  deps?: unknown[];\n  node?: HTMLElement | Document | Window;\n}) => {\n  const handlerRef = useSyncRef(handler);\n\n  useEffect(() => {\n    const handleEvent = (e: HTMLElementEventMap[EventName]) =>\n      handlerRef.current(e);\n\n    // @ts-expect-error\n    node.addEventListener(event, handleEvent, options);\n    // @ts-expect-error\n    return () => node.removeEventListener(event, handleEvent, options);\n  }, deps);\n};\n","import type { MutableRefObject } from 'react';\nimport { useEventListener } from './use-event-listener.js';\n\ntype ClickOutsideInput = {\n  contentRef: MutableRefObject<HTMLElement | null>;\n  onClick: VoidFunction;\n  options?: AddEventListenerOptions;\n};\n\nexport const useClickOutside = ({\n  contentRef,\n  onClick,\n  options,\n}: ClickOutsideInput) => {\n  useEventListener({\n    event: 'mousedown',\n    handler: (event) => {\n      if (\n        contentRef.current &&\n        !contentRef.current.contains(event.target as Node)\n      ) {\n        onClick();\n      }\n    },\n    options,\n  });\n};\n","import { type MutableRefObject, useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineFn Function which returns defined value.\n */\nexport const useDefineRef = <T>(defineFn: () => T): MutableRefObject<T> => {\n  const ref = useRef<T>(void 0 as T);\n\n  if (!ref.current) {\n    ref.current = defineFn();\n  }\n\n  return ref;\n};\n","import { useLayoutEffect, useRef } from 'react';\n\nexport const useElementRef = <T extends HTMLElement>(selector: () => T) => {\n  const ref = useRef<T>();\n\n  useLayoutEffect(() => {\n    ref.current = selector();\n  }, []);\n\n  return ref;\n};\n","/**\n * A Hook to define an event handler with an always-stable function identity.\n *\n * borrowed from @gaeron\n * https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md\n */\nimport { useCallback, useLayoutEffect, useRef } from 'react';\nimport type { AnyFunction } from 'yummies/types';\n\nexport const useEvent = <H extends AnyFunction>(handler: H): H => {\n  const handlerRef = useRef<H>(handler);\n\n  // In a real implementation, this would run before layout effects\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  return useCallback((...args: unknown[]) => {\n    // In a real implementation, this would throw if called during render\n    const fn = handlerRef.current as AnyFunction;\n    return fn(...args);\n  }, []) as unknown as H;\n};\n","import { useCallback, useRef, useState } from 'react';\n\nexport interface FlagHook {\n  enabled: boolean;\n  toggle: VoidFunction;\n  enable: VoidFunction;\n  disable: VoidFunction;\n}\n\nexport const useFlag = (defaultValue = false): FlagHook => {\n  const [enabled, setEnabled] = useState(defaultValue);\n\n  const toggle = useCallback(() => setEnabled((value) => !value), []);\n  const enable = useCallback(() => setEnabled(true), []);\n  const disable = useCallback(() => setEnabled(false), []);\n\n  const flagObjRef = useRef<FlagHook>({\n    enabled,\n    toggle,\n    enable,\n    disable,\n  });\n\n  flagObjRef.current.enabled = enabled;\n\n  return flagObjRef.current;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useForceUpdate = () => {\n  const [, setState] = useState<unknown>(null);\n\n  return useCallback(() => {\n    setState({});\n  }, []);\n};\n","import { useEffect, useRef, useState } from 'react';\n\nexport const useInitialHeight = <T extends HTMLElement>() => {\n  const ref = useRef<T | null>(null);\n  const [initialHeight, setInitialHeight] = useState<number | undefined>(\n    undefined,\n  );\n\n  useEffect(() => {\n    if (ref.current && !initialHeight) {\n      setInitialHeight(ref.current.offsetHeight);\n    }\n  }, [initialHeight]);\n\n  return { ref, initialHeight };\n};\n","import { useLayoutEffect } from 'react';\nimport { useAbortSignal } from './use-abort-signal.js';\nimport { useConstant } from './use-constant.js';\n\nexport type InstanceCreateConfig<TPayload, TExtension = {}> = TExtension & {\n  abortSignal: AbortSignal;\n  payload: TPayload;\n};\n\nexport const createUseInstanceHook =\n  <TExtension = {}>(extension?: TExtension) =>\n  <TInstance, TPayload>(\n    factory: (\n      config: InstanceCreateConfig<NoInfer<TPayload>, TExtension>,\n    ) => TInstance,\n    config?: {\n      payload?: TPayload;\n      onUpdate?: (payload: TPayload) => void;\n    },\n  ) => {\n    const abortSignal = useAbortSignal();\n\n    const instance = useConstant(() =>\n      factory({\n        ...(extension as TExtension),\n        abortSignal,\n        payload: config?.payload as any,\n      }),\n    );\n\n    useLayoutEffect(() => {\n      config?.onUpdate?.(config.payload!);\n    }, [config?.payload]);\n\n    return instance;\n  };\n\n/**\n * The `useInstance` hook is used to create and manage an instance of an object\n * that requires access to the root store and an abort signal.\n *\n * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need\n * to provide some specific data\n *\n * @param factory - A factory function that takes a configuration and returns an instance.\n * @param config - An optional configuration containing additional input parameters and an update function.\n * @returns An instance created by the factory function.\n */\nexport const useInstance = createUseInstanceHook();\n","import { useEffect, useState } from 'react';\n\nexport const useIntersectionObserver = (\n  callback: IntersectionObserverCallback,\n  options?: IntersectionObserverInit,\n) => {\n  const [intersectionObserver] = useState(\n    () => new IntersectionObserver(callback, options),\n  );\n\n  useEffect(() => {\n    return () => {\n      intersectionObserver.disconnect();\n    };\n  }, []);\n\n  return intersectionObserver;\n};\n","import { useRef } from 'react';\n\nexport const useLastDefinedValue = <T>(value: T) => {\n  const ref = useRef(value);\n  if (value != null) {\n    ref.current = value;\n  }\n  return ref.current;\n};\n","import { useRef } from 'react';\n\nexport const useLastValueRef = <T>(value: T | null | undefined) => {\n  const ref = useRef(value);\n\n  if (value != null) {\n    ref.current = value;\n  }\n\n  return ref;\n};\n","import { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useLifeCycle = (\n  fn: () => {\n    mount?: VoidFunction;\n    unmount?: VoidFunction;\n  },\n) => {\n  const fnRef = useSyncRef(fn);\n\n  useEffect(() => {\n    const fnOperation = fnRef.current();\n    fnOperation.mount?.();\n    return fnOperation.unmount?.();\n  }, []);\n};\n","import { useLayoutEffect } from 'react';\nimport { useDefineRef } from './use-define-ref.js';\n\nexport const useResizeObserver = (callback: ResizeObserverCallback) => {\n  const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));\n\n  useLayoutEffect(() => {\n    return () => {\n      resizeObserverRef.current.disconnect();\n    };\n  }, []);\n\n  return resizeObserverRef;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useToggle = (initialState?: boolean) => {\n  const [toggled, setToggled] = useState(!!initialState);\n\n  const toggle = useCallback(() => setToggled((toggled) => !toggled), []);\n\n  return [toggled, toggle, setToggled] as const;\n};\n","import { useState } from 'react';\n\nexport const useValue = <T>(defaults: T | (() => T)) => {\n  const [value, setValue] = useState<T>(defaults);\n\n  return {\n    value,\n    set: setValue,\n  };\n};\n","import { useEffect, useState } from 'react';\n\nexport const useVisibilityState = () => {\n  const [state, setState] = useState<DocumentVisibilityState>();\n\n  useEffect(() => {\n    const handleVisibilityChange = () => {\n      setState(document.visibilityState);\n    };\n\n    document.addEventListener('visibilitychange', handleVisibilityChange);\n\n    return () => {\n      document.removeEventListener('visibilitychange', handleVisibilityChange);\n    };\n  }, []);\n\n  return state;\n};\n"],"names":["useRef","useEffect","useLayoutEffect","useCallback","useState","toggled"],"mappings":";;;AAGO,MAAM,aAAa,CACxB,UACG,SAEH,KAAK,QAAQ,CAAC,QAAQ;AACpB,MAAI,OAAO,QAAQ,YAAY;AAC7B,QAAI,KAAK;AAAA,EACX,WAAW,OAAO,OAAO,QAAQ,UAAU;AAEzC,QAAI,UAAU;AAAA,EAChB;AACF,CAAC;ACLI,MAAM,cAAc,CAAI,gBAA4B;AACzD,QAAM,MAAMA,MAAAA,OAAA;AAEZ,MAAI,CAAC,IAAI,SAAS;AAChB,QAAI,UAAU,EAAE,OAAO,YAAA,EAAY;AAAA,EACrC;AAEA,SAAO,IAAI,QAAQ;AACrB;ACbO,MAAM,qBAAqB,MAAM;AACtC,QAAM,aAAa,YAAY,MAAM,IAAI,iBAAiB;AAE1DC,QAAAA,UAAU,MAAM;AACd,WAAO,MAAM;AACX,iBAAW,MAAA;AAAA,IACb;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,SAAO;AACT;ACZO,MAAM,iBAAiB,MAAM;AAClC,SAAO,qBAAqB;AAC9B;ACFO,MAAM,aAAa,CAAI,UAAa;AACzC,QAAM,MAAMD,MAAAA,OAAO,KAAK;AACxB,MAAI,UAAU;AACd,SAAO;AACT;ACFO,MAAM,mBAAmB,CAA8C;AAAA,EAC5E;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO,CAAA;AAAA,EACP,OAAO;AACT,MAMM;AACJ,QAAM,aAAa,WAAW,OAAO;AAErCC,QAAAA,UAAU,MAAM;AACd,UAAM,cAAc,CAAC,MACnB,WAAW,QAAQ,CAAC;AAGtB,SAAK,iBAAiB,OAAO,aAAa,OAAO;AAEjD,WAAO,MAAM,KAAK,oBAAoB,OAAO,aAAa,OAAO;AAAA,EACnE,GAAG,IAAI;AACT;ACnBO,MAAM,kBAAkB,CAAC;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AACF,MAAyB;AACvB,mBAAiB;AAAA,IACf,OAAO;AAAA,IACP,SAAS,CAAC,UAAU;AAClB,UACE,WAAW,WACX,CAAC,WAAW,QAAQ,SAAS,MAAM,MAAc,GACjD;AACA,gBAAA;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,EAAA,CACD;AACH;ACjBO,MAAM,eAAe,CAAI,aAA2C;AACzE,QAAM,MAAMD,MAAAA,OAAU,MAAW;AAEjC,MAAI,CAAC,IAAI,SAAS;AAChB,QAAI,UAAU,SAAA;AAAA,EAChB;AAEA,SAAO;AACT;ACfO,MAAM,gBAAgB,CAAwB,aAAsB;AACzE,QAAM,MAAMA,MAAAA,OAAA;AAEZE,QAAAA,gBAAgB,MAAM;AACpB,QAAI,UAAU,SAAA;AAAA,EAChB,GAAG,CAAA,CAAE;AAEL,SAAO;AACT;ACDO,MAAM,WAAW,CAAwB,YAAkB;AAChE,QAAM,aAAaF,MAAAA,OAAU,OAAO;AAGpCE,QAAAA,gBAAgB,MAAM;AACpB,eAAW,UAAU;AAAA,EACvB,CAAC;AAED,SAAOC,MAAAA,YAAY,IAAI,SAAoB;AAEzC,UAAM,KAAK,WAAW;AACtB,WAAO,GAAG,GAAG,IAAI;AAAA,EACnB,GAAG,CAAA,CAAE;AACP;ACbO,MAAM,UAAU,CAAC,eAAe,UAAoB;AACzD,QAAM,CAAC,SAAS,UAAU,IAAIC,MAAAA,SAAS,YAAY;AAEnD,QAAM,SAASD,MAAAA,YAAY,MAAM,WAAW,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE;AAClE,QAAM,SAASA,MAAAA,YAAY,MAAM,WAAW,IAAI,GAAG,CAAA,CAAE;AACrD,QAAM,UAAUA,MAAAA,YAAY,MAAM,WAAW,KAAK,GAAG,CAAA,CAAE;AAEvD,QAAM,aAAaH,MAAAA,OAAiB;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AAED,aAAW,QAAQ,UAAU;AAE7B,SAAO,WAAW;AACpB;ACxBO,MAAM,iBAAiB,MAAM;AAClC,QAAM,GAAG,QAAQ,IAAII,MAAAA,SAAkB,IAAI;AAE3C,SAAOD,MAAAA,YAAY,MAAM;AACvB,aAAS,CAAA,CAAE;AAAA,EACb,GAAG,CAAA,CAAE;AACP;ACNO,MAAM,mBAAmB,MAA6B;AAC3D,QAAM,MAAMH,MAAAA,OAAiB,IAAI;AACjC,QAAM,CAAC,eAAe,gBAAgB,IAAII,MAAAA;AAAAA,IACxC;AAAA,EAAA;AAGFH,QAAAA,UAAU,MAAM;AACd,QAAI,IAAI,WAAW,CAAC,eAAe;AACjC,uBAAiB,IAAI,QAAQ,YAAY;AAAA,IAC3C;AAAA,EACF,GAAG,CAAC,aAAa,CAAC;AAElB,SAAO,EAAE,KAAK,cAAA;AAChB;ACNO,MAAM,wBACX,CAAkB,cAClB,CACE,SAGA,WAIG;AACH,QAAM,cAAc,eAAA;AAEpB,QAAM,WAAW;AAAA,IAAY,MAC3B,QAAQ;AAAA,MACN,GAAI;AAAA,MACJ;AAAA,MACA,SAAS,QAAQ;AAAA,IAAA,CAClB;AAAA,EAAA;AAGHC,QAAAA,gBAAgB,MAAM;AACpB,YAAQ,WAAW,OAAO,OAAQ;AAAA,EACpC,GAAG,CAAC,QAAQ,OAAO,CAAC;AAEpB,SAAO;AACT;AAaK,MAAM,cAAc,sBAAA;AC9CpB,MAAM,0BAA0B,CACrC,UACA,YACG;AACH,QAAM,CAAC,oBAAoB,IAAIE,MAAAA;AAAAA,IAC7B,MAAM,IAAI,qBAAqB,UAAU,OAAO;AAAA,EAAA;AAGlDH,QAAAA,UAAU,MAAM;AACd,WAAO,MAAM;AACX,2BAAqB,WAAA;AAAA,IACvB;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,SAAO;AACT;ACfO,MAAM,sBAAsB,CAAI,UAAa;AAClD,QAAM,MAAMD,MAAAA,OAAO,KAAK;AACxB,MAAI,SAAS,MAAM;AACjB,QAAI,UAAU;AAAA,EAChB;AACA,SAAO,IAAI;AACb;ACNO,MAAM,kBAAkB,CAAI,UAAgC;AACjE,QAAM,MAAMA,MAAAA,OAAO,KAAK;AAExB,MAAI,SAAS,MAAM;AACjB,QAAI,UAAU;AAAA,EAChB;AAEA,SAAO;AACT;ACPO,MAAM,eAAe,CAC1B,OAIG;AACH,QAAM,QAAQ,WAAW,EAAE;AAE3BC,QAAAA,UAAU,MAAM;AACd,UAAM,cAAc,MAAM,QAAA;AAC1B,gBAAY,QAAA;AACZ,WAAO,YAAY,UAAA;AAAA,EACrB,GAAG,CAAA,CAAE;AACP;ACbO,MAAM,oBAAoB,CAAC,aAAqC;AACrE,QAAM,oBAAoB,aAAa,MAAM,IAAI,eAAe,QAAQ,CAAC;AAEzEC,QAAAA,gBAAgB,MAAM;AACpB,WAAO,MAAM;AACX,wBAAkB,QAAQ,WAAA;AAAA,IAC5B;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,SAAO;AACT;ACXO,MAAM,YAAY,CAAC,iBAA2B;AACnD,QAAM,CAAC,SAAS,UAAU,IAAIE,MAAAA,SAAS,CAAC,CAAC,YAAY;AAErD,QAAM,SAASD,MAAAA,YAAY,MAAM,WAAW,CAACE,aAAY,CAACA,QAAO,GAAG,EAAE;AAEtE,SAAO,CAAC,SAAS,QAAQ,UAAU;AACrC;ACNO,MAAM,WAAW,CAAI,aAA4B;AACtD,QAAM,CAAC,OAAO,QAAQ,IAAID,MAAAA,SAAY,QAAQ;AAE9C,SAAO;AAAA,IACL;AAAA,IACA,KAAK;AAAA,EAAA;AAET;ACPO,MAAM,qBAAqB,MAAM;AACtC,QAAM,CAAC,OAAO,QAAQ,IAAIA,eAAA;AAE1BH,QAAAA,UAAU,MAAM;AACd,UAAM,yBAAyB,MAAM;AACnC,eAAS,SAAS,eAAe;AAAA,IACnC;AAEA,aAAS,iBAAiB,oBAAoB,sBAAsB;AAEpE,WAAO,MAAM;AACX,eAAS,oBAAoB,oBAAoB,sBAAsB;AAAA,IACzE;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,SAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"react.cjs","sources":["../src/react/attach-refs.ts","../src/react/hooks/use-constant.ts","../src/react/hooks/use-abort-controller.ts","../src/react/hooks/use-abort-signal.ts","../src/react/hooks/use-sync-ref.ts","../src/react/hooks/use-event-listener.ts","../src/react/hooks/use-click-outside.ts","../src/react/hooks/use-define-ref.ts","../src/react/hooks/use-element-ref.ts","../src/react/hooks/use-event.ts","../src/react/hooks/use-flag.ts","../src/react/hooks/use-force-update.ts","../src/react/hooks/use-initial-height.ts","../src/react/hooks/use-instance.ts","../src/react/hooks/use-intersection-observer.ts","../src/react/hooks/use-last-defined-value.ts","../src/react/hooks/use-last-value-ref.ts","../src/react/hooks/use-life-cycle.ts","../src/react/hooks/use-resize-observer.ts","../src/react/hooks/use-toggle.ts","../src/react/hooks/use-value.ts","../src/react/hooks/use-visibility-state.ts"],"sourcesContent":["import type { LegacyRef, RefObject } from 'react';\nimport type { Maybe } from 'yummies/types';\n\nexport const attachRefs = <T>(\n  value: T | null,\n  ...refs: Maybe<RefObject<T> | RefObject<T | null> | LegacyRef<T>>[]\n) =>\n  refs.forEach((ref) => {\n    if (typeof ref === 'function') {\n      ref(value);\n    } else if (ref && typeof ref !== 'string') {\n      // @ts-expect-error\n      ref.current = value;\n    }\n  });\n","import { useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineValue Function which returns defined value.\n */\nexport const useConstant = <T>(defineValue: () => T): T => {\n  const ref = useRef<{ value: T }>();\n\n  if (!ref.current) {\n    ref.current = { value: defineValue() };\n  }\n\n  return ref.current.value;\n};\n","import { useEffect } from 'react';\n\nimport { useConstant } from './use-constant.js';\n\nexport const useAbortController = () => {\n  const controller = useConstant(() => new AbortController());\n\n  useEffect(() => {\n    return () => {\n      controller.abort();\n    };\n  }, []);\n\n  return controller;\n};\n","import { useAbortController } from './use-abort-controller.js';\n\nexport const useAbortSignal = () => {\n  return useAbortController().signal;\n};\n","import { useRef } from 'react';\n\nexport const useSyncRef = <T>(value: T) => {\n  const ref = useRef(value);\n  ref.current = value;\n  return ref;\n};\n","/* eslint-disable @typescript-eslint/ban-ts-comment */\nimport { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useEventListener = <EventName extends keyof HTMLElementEventMap>({\n  event,\n  handler,\n  options,\n  deps = [],\n  debounce,\n  node = document,\n}: {\n  event: EventName;\n  handler: (e: HTMLElementEventMap[EventName]) => void;\n  options?: boolean | AddEventListenerOptions;\n  deps?: unknown[];\n  debounce?: number;\n  node?: HTMLElement | Document | Window;\n}) => {\n  const handlerRef = useSyncRef(handler);\n\n  useEffect(() => {\n    let timerId: ReturnType<typeof setTimeout> | undefined;\n\n    const handleEvent = (e: HTMLElementEventMap[EventName]) => {\n      if (debounce == null) {\n        handlerRef.current(e);\n      } else {\n        clearTimeout(timerId);\n        timerId = setTimeout(() => {\n          handlerRef.current(e);\n          timerId = undefined;\n        }, debounce);\n      }\n    };\n\n    // @ts-expect-error\n    node.addEventListener(event, handleEvent, options);\n    return () => {\n      // @ts-expect-error\n      node.removeEventListener(event, handleEvent, options);\n      clearTimeout(timerId);\n    };\n  }, deps);\n};\n","import type { MutableRefObject } from 'react';\nimport { useEventListener } from './use-event-listener.js';\n\ntype ClickOutsideInput = {\n  contentRef: MutableRefObject<HTMLElement | null>;\n  onClick: VoidFunction;\n  options?: AddEventListenerOptions;\n};\n\nexport const useClickOutside = ({\n  contentRef,\n  onClick,\n  options,\n}: ClickOutsideInput) => {\n  useEventListener({\n    event: 'mousedown',\n    handler: (event) => {\n      if (\n        contentRef.current &&\n        !contentRef.current.contains(event.target as Node)\n      ) {\n        onClick();\n      }\n    },\n    options,\n  });\n};\n","import { type MutableRefObject, useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineFn Function which returns defined value.\n */\nexport const useDefineRef = <T>(defineFn: () => T): MutableRefObject<T> => {\n  const ref = useRef<T>(void 0 as T);\n\n  if (!ref.current) {\n    ref.current = defineFn();\n  }\n\n  return ref;\n};\n","import { useLayoutEffect, useRef } from 'react';\n\nexport const useElementRef = <T extends HTMLElement>(selector: () => T) => {\n  const ref = useRef<T>();\n\n  useLayoutEffect(() => {\n    ref.current = selector();\n  }, []);\n\n  return ref;\n};\n","/**\n * A Hook to define an event handler with an always-stable function identity.\n *\n * borrowed from @gaeron\n * https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md\n */\nimport { useCallback, useLayoutEffect, useRef } from 'react';\nimport type { AnyFunction } from 'yummies/types';\n\nexport const useEvent = <H extends AnyFunction>(handler: H): H => {\n  const handlerRef = useRef<H>(handler);\n\n  // In a real implementation, this would run before layout effects\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  return useCallback((...args: unknown[]) => {\n    // In a real implementation, this would throw if called during render\n    const fn = handlerRef.current as AnyFunction;\n    return fn(...args);\n  }, []) as unknown as H;\n};\n","import { useCallback, useRef, useState } from 'react';\n\nexport interface FlagHook {\n  enabled: boolean;\n  toggle: VoidFunction;\n  enable: VoidFunction;\n  disable: VoidFunction;\n}\n\nexport const useFlag = (defaultValue = false): FlagHook => {\n  const [enabled, setEnabled] = useState(defaultValue);\n\n  const toggle = useCallback(() => setEnabled((value) => !value), []);\n  const enable = useCallback(() => setEnabled(true), []);\n  const disable = useCallback(() => setEnabled(false), []);\n\n  const flagObjRef = useRef<FlagHook>({\n    enabled,\n    toggle,\n    enable,\n    disable,\n  });\n\n  flagObjRef.current.enabled = enabled;\n\n  return flagObjRef.current;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useForceUpdate = () => {\n  const [, setState] = useState<unknown>(null);\n\n  return useCallback(() => {\n    setState({});\n  }, []);\n};\n","import { useEffect, useRef, useState } from 'react';\n\nexport const useInitialHeight = <T extends HTMLElement>() => {\n  const ref = useRef<T | null>(null);\n  const [initialHeight, setInitialHeight] = useState<number | undefined>(\n    undefined,\n  );\n\n  useEffect(() => {\n    if (ref.current && !initialHeight) {\n      setInitialHeight(ref.current.offsetHeight);\n    }\n  }, [initialHeight]);\n\n  return { ref, initialHeight };\n};\n","import { useLayoutEffect } from 'react';\nimport { useAbortSignal } from './use-abort-signal.js';\nimport { useConstant } from './use-constant.js';\n\nexport type InstanceCreateConfig<TPayload, TExtension = {}> = TExtension & {\n  abortSignal: AbortSignal;\n  payload: TPayload;\n};\n\nexport const createUseInstanceHook =\n  <TExtension = {}>(extension?: TExtension) =>\n  <TInstance, TPayload>(\n    factory: (\n      config: InstanceCreateConfig<NoInfer<TPayload>, TExtension>,\n    ) => TInstance,\n    config?: {\n      payload?: TPayload;\n      onUpdate?: (payload: TPayload) => void;\n    },\n  ) => {\n    const abortSignal = useAbortSignal();\n\n    const instance = useConstant(() =>\n      factory({\n        ...(extension as TExtension),\n        abortSignal,\n        payload: config?.payload as any,\n      }),\n    );\n\n    useLayoutEffect(() => {\n      config?.onUpdate?.(config.payload!);\n    }, [config?.payload]);\n\n    return instance;\n  };\n\n/**\n * The `useInstance` hook is used to create and manage an instance of an object\n * that requires access to the root store and an abort signal.\n *\n * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need\n * to provide some specific data\n *\n * @param factory - A factory function that takes a configuration and returns an instance.\n * @param config - An optional configuration containing additional input parameters and an update function.\n * @returns An instance created by the factory function.\n */\nexport const useInstance = createUseInstanceHook();\n","import { useEffect, useState } from 'react';\n\nexport const useIntersectionObserver = (\n  callback: IntersectionObserverCallback,\n  options?: IntersectionObserverInit,\n) => {\n  const [intersectionObserver] = useState(\n    () => new IntersectionObserver(callback, options),\n  );\n\n  useEffect(() => {\n    return () => {\n      intersectionObserver.disconnect();\n    };\n  }, []);\n\n  return intersectionObserver;\n};\n","import { useRef } from 'react';\n\nexport const useLastDefinedValue = <T>(value: T) => {\n  const ref = useRef(value);\n  if (value != null) {\n    ref.current = value;\n  }\n  return ref.current;\n};\n","import { useRef } from 'react';\n\nexport const useLastValueRef = <T>(value: T | null | undefined) => {\n  const ref = useRef(value);\n\n  if (value != null) {\n    ref.current = value;\n  }\n\n  return ref;\n};\n","import { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useLifeCycle = (\n  fn: () => {\n    mount?: VoidFunction;\n    unmount?: VoidFunction;\n  },\n) => {\n  const fnRef = useSyncRef(fn);\n\n  useEffect(() => {\n    const fnOperation = fnRef.current();\n    fnOperation.mount?.();\n    return fnOperation.unmount?.();\n  }, []);\n};\n","import { useLayoutEffect } from 'react';\nimport { useDefineRef } from './use-define-ref.js';\n\nexport const useResizeObserver = (callback: ResizeObserverCallback) => {\n  const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));\n\n  useLayoutEffect(() => {\n    return () => {\n      resizeObserverRef.current.disconnect();\n    };\n  }, []);\n\n  return resizeObserverRef;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useToggle = (initialState?: boolean) => {\n  const [toggled, setToggled] = useState(!!initialState);\n\n  const toggle = useCallback(() => setToggled((toggled) => !toggled), []);\n\n  return [toggled, toggle, setToggled] as const;\n};\n","import { useState } from 'react';\n\nexport const useValue = <T>(defaults: T | (() => T)) => {\n  const [value, setValue] = useState<T>(defaults);\n\n  return {\n    value,\n    set: setValue,\n  };\n};\n","import { useEffect, useState } from 'react';\n\nexport const useVisibilityState = () => {\n  const [state, setState] = useState<DocumentVisibilityState>();\n\n  useEffect(() => {\n    const handleVisibilityChange = () => {\n      setState(document.visibilityState);\n    };\n\n    document.addEventListener('visibilitychange', handleVisibilityChange);\n\n    return () => {\n      document.removeEventListener('visibilitychange', handleVisibilityChange);\n    };\n  }, []);\n\n  return state;\n};\n"],"names":["useRef","useEffect","useLayoutEffect","useCallback","useState","toggled"],"mappings":"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"}

package/react.d.ts

@@ -37,11 +37,12 @@ declare const useElementRef: <T extends HTMLElement>(selector: () => T) => react
 
 declare const useEvent: <H extends AnyFunction>(handler: H) => H;
 
-declare const useEventListener: <EventName extends keyof HTMLElementEventMap>({ event, handler, options, deps, node, }: {
+declare const useEventListener: <EventName extends keyof HTMLElementEventMap>({ event, handler, options, deps, debounce, node, }: {
     event: EventName;
     handler: (e: HTMLElementEventMap[EventName]) => void;
     options?: boolean | AddEventListenerOptions;
     deps?: unknown[];
+    debounce?: number;
     node?: HTMLElement | Document | Window;
 }) => void;
 

package/react.js

@@ -35,13 +35,28 @@ const useEventListener = ({
   handler,
   options,
   deps = [],
+  debounce,
   node = document
 }) => {
   const handlerRef = useSyncRef(handler);
   useEffect(() => {
-    const handleEvent = (e) => handlerRef.current(e);
+    let timerId;
+    const handleEvent = (e) => {
+      if (debounce == null) {
+        handlerRef.current(e);
+      } else {
+        clearTimeout(timerId);
+        timerId = setTimeout(() => {
+          handlerRef.current(e);
+          timerId = void 0;
+        }, debounce);
+      }
+    };
     node.addEventListener(event, handleEvent, options);
-    return () => node.removeEventListener(event, handleEvent, options);
+    return () => {
+      node.removeEventListener(event, handleEvent, options);
+      clearTimeout(timerId);
+    };
   }, deps);
 };
 const useClickOutside = ({

package/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sources":["../src/react/attach-refs.ts","../src/react/hooks/use-constant.ts","../src/react/hooks/use-abort-controller.ts","../src/react/hooks/use-abort-signal.ts","../src/react/hooks/use-sync-ref.ts","../src/react/hooks/use-event-listener.ts","../src/react/hooks/use-click-outside.ts","../src/react/hooks/use-define-ref.ts","../src/react/hooks/use-element-ref.ts","../src/react/hooks/use-event.ts","../src/react/hooks/use-flag.ts","../src/react/hooks/use-force-update.ts","../src/react/hooks/use-initial-height.ts","../src/react/hooks/use-instance.ts","../src/react/hooks/use-intersection-observer.ts","../src/react/hooks/use-last-defined-value.ts","../src/react/hooks/use-last-value-ref.ts","../src/react/hooks/use-life-cycle.ts","../src/react/hooks/use-resize-observer.ts","../src/react/hooks/use-toggle.ts","../src/react/hooks/use-value.ts","../src/react/hooks/use-visibility-state.ts"],"sourcesContent":["import type { LegacyRef, RefObject } from 'react';\nimport type { Maybe } from 'yummies/types';\n\nexport const attachRefs = <T>(\n  value: T | null,\n  ...refs: Maybe<RefObject<T> | RefObject<T | null> | LegacyRef<T>>[]\n) =>\n  refs.forEach((ref) => {\n    if (typeof ref === 'function') {\n      ref(value);\n    } else if (ref && typeof ref !== 'string') {\n      // @ts-expect-error\n      ref.current = value;\n    }\n  });\n","import { useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineValue Function which returns defined value.\n */\nexport const useConstant = <T>(defineValue: () => T): T => {\n  const ref = useRef<{ value: T }>();\n\n  if (!ref.current) {\n    ref.current = { value: defineValue() };\n  }\n\n  return ref.current.value;\n};\n","import { useEffect } from 'react';\n\nimport { useConstant } from './use-constant.js';\n\nexport const useAbortController = () => {\n  const controller = useConstant(() => new AbortController());\n\n  useEffect(() => {\n    return () => {\n      controller.abort();\n    };\n  }, []);\n\n  return controller;\n};\n","import { useAbortController } from './use-abort-controller.js';\n\nexport const useAbortSignal = () => {\n  return useAbortController().signal;\n};\n","import { useRef } from 'react';\n\nexport const useSyncRef = <T>(value: T) => {\n  const ref = useRef(value);\n  ref.current = value;\n  return ref;\n};\n","/* eslint-disable @typescript-eslint/ban-ts-comment */\nimport { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useEventListener = <EventName extends keyof HTMLElementEventMap>({\n  event,\n  handler,\n  options,\n  deps = [],\n  node = document,\n}: {\n  event: EventName;\n  handler: (e: HTMLElementEventMap[EventName]) => void;\n  options?: boolean | AddEventListenerOptions;\n  deps?: unknown[];\n  node?: HTMLElement | Document | Window;\n}) => {\n  const handlerRef = useSyncRef(handler);\n\n  useEffect(() => {\n    const handleEvent = (e: HTMLElementEventMap[EventName]) =>\n      handlerRef.current(e);\n\n    // @ts-expect-error\n    node.addEventListener(event, handleEvent, options);\n    // @ts-expect-error\n    return () => node.removeEventListener(event, handleEvent, options);\n  }, deps);\n};\n","import type { MutableRefObject } from 'react';\nimport { useEventListener } from './use-event-listener.js';\n\ntype ClickOutsideInput = {\n  contentRef: MutableRefObject<HTMLElement | null>;\n  onClick: VoidFunction;\n  options?: AddEventListenerOptions;\n};\n\nexport const useClickOutside = ({\n  contentRef,\n  onClick,\n  options,\n}: ClickOutsideInput) => {\n  useEventListener({\n    event: 'mousedown',\n    handler: (event) => {\n      if (\n        contentRef.current &&\n        !contentRef.current.contains(event.target as Node)\n      ) {\n        onClick();\n      }\n    },\n    options,\n  });\n};\n","import { type MutableRefObject, useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineFn Function which returns defined value.\n */\nexport const useDefineRef = <T>(defineFn: () => T): MutableRefObject<T> => {\n  const ref = useRef<T>(void 0 as T);\n\n  if (!ref.current) {\n    ref.current = defineFn();\n  }\n\n  return ref;\n};\n","import { useLayoutEffect, useRef } from 'react';\n\nexport const useElementRef = <T extends HTMLElement>(selector: () => T) => {\n  const ref = useRef<T>();\n\n  useLayoutEffect(() => {\n    ref.current = selector();\n  }, []);\n\n  return ref;\n};\n","/**\n * A Hook to define an event handler with an always-stable function identity.\n *\n * borrowed from @gaeron\n * https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md\n */\nimport { useCallback, useLayoutEffect, useRef } from 'react';\nimport type { AnyFunction } from 'yummies/types';\n\nexport const useEvent = <H extends AnyFunction>(handler: H): H => {\n  const handlerRef = useRef<H>(handler);\n\n  // In a real implementation, this would run before layout effects\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  return useCallback((...args: unknown[]) => {\n    // In a real implementation, this would throw if called during render\n    const fn = handlerRef.current as AnyFunction;\n    return fn(...args);\n  }, []) as unknown as H;\n};\n","import { useCallback, useRef, useState } from 'react';\n\nexport interface FlagHook {\n  enabled: boolean;\n  toggle: VoidFunction;\n  enable: VoidFunction;\n  disable: VoidFunction;\n}\n\nexport const useFlag = (defaultValue = false): FlagHook => {\n  const [enabled, setEnabled] = useState(defaultValue);\n\n  const toggle = useCallback(() => setEnabled((value) => !value), []);\n  const enable = useCallback(() => setEnabled(true), []);\n  const disable = useCallback(() => setEnabled(false), []);\n\n  const flagObjRef = useRef<FlagHook>({\n    enabled,\n    toggle,\n    enable,\n    disable,\n  });\n\n  flagObjRef.current.enabled = enabled;\n\n  return flagObjRef.current;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useForceUpdate = () => {\n  const [, setState] = useState<unknown>(null);\n\n  return useCallback(() => {\n    setState({});\n  }, []);\n};\n","import { useEffect, useRef, useState } from 'react';\n\nexport const useInitialHeight = <T extends HTMLElement>() => {\n  const ref = useRef<T | null>(null);\n  const [initialHeight, setInitialHeight] = useState<number | undefined>(\n    undefined,\n  );\n\n  useEffect(() => {\n    if (ref.current && !initialHeight) {\n      setInitialHeight(ref.current.offsetHeight);\n    }\n  }, [initialHeight]);\n\n  return { ref, initialHeight };\n};\n","import { useLayoutEffect } from 'react';\nimport { useAbortSignal } from './use-abort-signal.js';\nimport { useConstant } from './use-constant.js';\n\nexport type InstanceCreateConfig<TPayload, TExtension = {}> = TExtension & {\n  abortSignal: AbortSignal;\n  payload: TPayload;\n};\n\nexport const createUseInstanceHook =\n  <TExtension = {}>(extension?: TExtension) =>\n  <TInstance, TPayload>(\n    factory: (\n      config: InstanceCreateConfig<NoInfer<TPayload>, TExtension>,\n    ) => TInstance,\n    config?: {\n      payload?: TPayload;\n      onUpdate?: (payload: TPayload) => void;\n    },\n  ) => {\n    const abortSignal = useAbortSignal();\n\n    const instance = useConstant(() =>\n      factory({\n        ...(extension as TExtension),\n        abortSignal,\n        payload: config?.payload as any,\n      }),\n    );\n\n    useLayoutEffect(() => {\n      config?.onUpdate?.(config.payload!);\n    }, [config?.payload]);\n\n    return instance;\n  };\n\n/**\n * The `useInstance` hook is used to create and manage an instance of an object\n * that requires access to the root store and an abort signal.\n *\n * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need\n * to provide some specific data\n *\n * @param factory - A factory function that takes a configuration and returns an instance.\n * @param config - An optional configuration containing additional input parameters and an update function.\n * @returns An instance created by the factory function.\n */\nexport const useInstance = createUseInstanceHook();\n","import { useEffect, useState } from 'react';\n\nexport const useIntersectionObserver = (\n  callback: IntersectionObserverCallback,\n  options?: IntersectionObserverInit,\n) => {\n  const [intersectionObserver] = useState(\n    () => new IntersectionObserver(callback, options),\n  );\n\n  useEffect(() => {\n    return () => {\n      intersectionObserver.disconnect();\n    };\n  }, []);\n\n  return intersectionObserver;\n};\n","import { useRef } from 'react';\n\nexport const useLastDefinedValue = <T>(value: T) => {\n  const ref = useRef(value);\n  if (value != null) {\n    ref.current = value;\n  }\n  return ref.current;\n};\n","import { useRef } from 'react';\n\nexport const useLastValueRef = <T>(value: T | null | undefined) => {\n  const ref = useRef(value);\n\n  if (value != null) {\n    ref.current = value;\n  }\n\n  return ref;\n};\n","import { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useLifeCycle = (\n  fn: () => {\n    mount?: VoidFunction;\n    unmount?: VoidFunction;\n  },\n) => {\n  const fnRef = useSyncRef(fn);\n\n  useEffect(() => {\n    const fnOperation = fnRef.current();\n    fnOperation.mount?.();\n    return fnOperation.unmount?.();\n  }, []);\n};\n","import { useLayoutEffect } from 'react';\nimport { useDefineRef } from './use-define-ref.js';\n\nexport const useResizeObserver = (callback: ResizeObserverCallback) => {\n  const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));\n\n  useLayoutEffect(() => {\n    return () => {\n      resizeObserverRef.current.disconnect();\n    };\n  }, []);\n\n  return resizeObserverRef;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useToggle = (initialState?: boolean) => {\n  const [toggled, setToggled] = useState(!!initialState);\n\n  const toggle = useCallback(() => setToggled((toggled) => !toggled), []);\n\n  return [toggled, toggle, setToggled] as const;\n};\n","import { useState } from 'react';\n\nexport const useValue = <T>(defaults: T | (() => T)) => {\n  const [value, setValue] = useState<T>(defaults);\n\n  return {\n    value,\n    set: setValue,\n  };\n};\n","import { useEffect, useState } from 'react';\n\nexport const useVisibilityState = () => {\n  const [state, setState] = useState<DocumentVisibilityState>();\n\n  useEffect(() => {\n    const handleVisibilityChange = () => {\n      setState(document.visibilityState);\n    };\n\n    document.addEventListener('visibilitychange', handleVisibilityChange);\n\n    return () => {\n      document.removeEventListener('visibilitychange', handleVisibilityChange);\n    };\n  }, []);\n\n  return state;\n};\n"],"names":["toggled"],"mappings":"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"}
+{"version":3,"file":"react.js","sources":["../src/react/attach-refs.ts","../src/react/hooks/use-constant.ts","../src/react/hooks/use-abort-controller.ts","../src/react/hooks/use-abort-signal.ts","../src/react/hooks/use-sync-ref.ts","../src/react/hooks/use-event-listener.ts","../src/react/hooks/use-click-outside.ts","../src/react/hooks/use-define-ref.ts","../src/react/hooks/use-element-ref.ts","../src/react/hooks/use-event.ts","../src/react/hooks/use-flag.ts","../src/react/hooks/use-force-update.ts","../src/react/hooks/use-initial-height.ts","../src/react/hooks/use-instance.ts","../src/react/hooks/use-intersection-observer.ts","../src/react/hooks/use-last-defined-value.ts","../src/react/hooks/use-last-value-ref.ts","../src/react/hooks/use-life-cycle.ts","../src/react/hooks/use-resize-observer.ts","../src/react/hooks/use-toggle.ts","../src/react/hooks/use-value.ts","../src/react/hooks/use-visibility-state.ts"],"sourcesContent":["import type { LegacyRef, RefObject } from 'react';\nimport type { Maybe } from 'yummies/types';\n\nexport const attachRefs = <T>(\n  value: T | null,\n  ...refs: Maybe<RefObject<T> | RefObject<T | null> | LegacyRef<T>>[]\n) =>\n  refs.forEach((ref) => {\n    if (typeof ref === 'function') {\n      ref(value);\n    } else if (ref && typeof ref !== 'string') {\n      // @ts-expect-error\n      ref.current = value;\n    }\n  });\n","import { useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineValue Function which returns defined value.\n */\nexport const useConstant = <T>(defineValue: () => T): T => {\n  const ref = useRef<{ value: T }>();\n\n  if (!ref.current) {\n    ref.current = { value: defineValue() };\n  }\n\n  return ref.current.value;\n};\n","import { useEffect } from 'react';\n\nimport { useConstant } from './use-constant.js';\n\nexport const useAbortController = () => {\n  const controller = useConstant(() => new AbortController());\n\n  useEffect(() => {\n    return () => {\n      controller.abort();\n    };\n  }, []);\n\n  return controller;\n};\n","import { useAbortController } from './use-abort-controller.js';\n\nexport const useAbortSignal = () => {\n  return useAbortController().signal;\n};\n","import { useRef } from 'react';\n\nexport const useSyncRef = <T>(value: T) => {\n  const ref = useRef(value);\n  ref.current = value;\n  return ref;\n};\n","/* eslint-disable @typescript-eslint/ban-ts-comment */\nimport { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useEventListener = <EventName extends keyof HTMLElementEventMap>({\n  event,\n  handler,\n  options,\n  deps = [],\n  debounce,\n  node = document,\n}: {\n  event: EventName;\n  handler: (e: HTMLElementEventMap[EventName]) => void;\n  options?: boolean | AddEventListenerOptions;\n  deps?: unknown[];\n  debounce?: number;\n  node?: HTMLElement | Document | Window;\n}) => {\n  const handlerRef = useSyncRef(handler);\n\n  useEffect(() => {\n    let timerId: ReturnType<typeof setTimeout> | undefined;\n\n    const handleEvent = (e: HTMLElementEventMap[EventName]) => {\n      if (debounce == null) {\n        handlerRef.current(e);\n      } else {\n        clearTimeout(timerId);\n        timerId = setTimeout(() => {\n          handlerRef.current(e);\n          timerId = undefined;\n        }, debounce);\n      }\n    };\n\n    // @ts-expect-error\n    node.addEventListener(event, handleEvent, options);\n    return () => {\n      // @ts-expect-error\n      node.removeEventListener(event, handleEvent, options);\n      clearTimeout(timerId);\n    };\n  }, deps);\n};\n","import type { MutableRefObject } from 'react';\nimport { useEventListener } from './use-event-listener.js';\n\ntype ClickOutsideInput = {\n  contentRef: MutableRefObject<HTMLElement | null>;\n  onClick: VoidFunction;\n  options?: AddEventListenerOptions;\n};\n\nexport const useClickOutside = ({\n  contentRef,\n  onClick,\n  options,\n}: ClickOutsideInput) => {\n  useEventListener({\n    event: 'mousedown',\n    handler: (event) => {\n      if (\n        contentRef.current &&\n        !contentRef.current.contains(event.target as Node)\n      ) {\n        onClick();\n      }\n    },\n    options,\n  });\n};\n","import { type MutableRefObject, useRef } from 'react';\n\n/**\n * React hook for creating a value exactly once.\n * useMemo doesn't give this guarantee unfortunately -\n * https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n * https://reactjs.org/docs/hooks-reference.html#usememo\n * @param defineFn Function which returns defined value.\n */\nexport const useDefineRef = <T>(defineFn: () => T): MutableRefObject<T> => {\n  const ref = useRef<T>(void 0 as T);\n\n  if (!ref.current) {\n    ref.current = defineFn();\n  }\n\n  return ref;\n};\n","import { useLayoutEffect, useRef } from 'react';\n\nexport const useElementRef = <T extends HTMLElement>(selector: () => T) => {\n  const ref = useRef<T>();\n\n  useLayoutEffect(() => {\n    ref.current = selector();\n  }, []);\n\n  return ref;\n};\n","/**\n * A Hook to define an event handler with an always-stable function identity.\n *\n * borrowed from @gaeron\n * https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md\n */\nimport { useCallback, useLayoutEffect, useRef } from 'react';\nimport type { AnyFunction } from 'yummies/types';\n\nexport const useEvent = <H extends AnyFunction>(handler: H): H => {\n  const handlerRef = useRef<H>(handler);\n\n  // In a real implementation, this would run before layout effects\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  return useCallback((...args: unknown[]) => {\n    // In a real implementation, this would throw if called during render\n    const fn = handlerRef.current as AnyFunction;\n    return fn(...args);\n  }, []) as unknown as H;\n};\n","import { useCallback, useRef, useState } from 'react';\n\nexport interface FlagHook {\n  enabled: boolean;\n  toggle: VoidFunction;\n  enable: VoidFunction;\n  disable: VoidFunction;\n}\n\nexport const useFlag = (defaultValue = false): FlagHook => {\n  const [enabled, setEnabled] = useState(defaultValue);\n\n  const toggle = useCallback(() => setEnabled((value) => !value), []);\n  const enable = useCallback(() => setEnabled(true), []);\n  const disable = useCallback(() => setEnabled(false), []);\n\n  const flagObjRef = useRef<FlagHook>({\n    enabled,\n    toggle,\n    enable,\n    disable,\n  });\n\n  flagObjRef.current.enabled = enabled;\n\n  return flagObjRef.current;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useForceUpdate = () => {\n  const [, setState] = useState<unknown>(null);\n\n  return useCallback(() => {\n    setState({});\n  }, []);\n};\n","import { useEffect, useRef, useState } from 'react';\n\nexport const useInitialHeight = <T extends HTMLElement>() => {\n  const ref = useRef<T | null>(null);\n  const [initialHeight, setInitialHeight] = useState<number | undefined>(\n    undefined,\n  );\n\n  useEffect(() => {\n    if (ref.current && !initialHeight) {\n      setInitialHeight(ref.current.offsetHeight);\n    }\n  }, [initialHeight]);\n\n  return { ref, initialHeight };\n};\n","import { useLayoutEffect } from 'react';\nimport { useAbortSignal } from './use-abort-signal.js';\nimport { useConstant } from './use-constant.js';\n\nexport type InstanceCreateConfig<TPayload, TExtension = {}> = TExtension & {\n  abortSignal: AbortSignal;\n  payload: TPayload;\n};\n\nexport const createUseInstanceHook =\n  <TExtension = {}>(extension?: TExtension) =>\n  <TInstance, TPayload>(\n    factory: (\n      config: InstanceCreateConfig<NoInfer<TPayload>, TExtension>,\n    ) => TInstance,\n    config?: {\n      payload?: TPayload;\n      onUpdate?: (payload: TPayload) => void;\n    },\n  ) => {\n    const abortSignal = useAbortSignal();\n\n    const instance = useConstant(() =>\n      factory({\n        ...(extension as TExtension),\n        abortSignal,\n        payload: config?.payload as any,\n      }),\n    );\n\n    useLayoutEffect(() => {\n      config?.onUpdate?.(config.payload!);\n    }, [config?.payload]);\n\n    return instance;\n  };\n\n/**\n * The `useInstance` hook is used to create and manage an instance of an object\n * that requires access to the root store and an abort signal.\n *\n * You can create YOUR OWN CUSTOM `useInstance` hook using `createUseInstanceHook` if you need\n * to provide some specific data\n *\n * @param factory - A factory function that takes a configuration and returns an instance.\n * @param config - An optional configuration containing additional input parameters and an update function.\n * @returns An instance created by the factory function.\n */\nexport const useInstance = createUseInstanceHook();\n","import { useEffect, useState } from 'react';\n\nexport const useIntersectionObserver = (\n  callback: IntersectionObserverCallback,\n  options?: IntersectionObserverInit,\n) => {\n  const [intersectionObserver] = useState(\n    () => new IntersectionObserver(callback, options),\n  );\n\n  useEffect(() => {\n    return () => {\n      intersectionObserver.disconnect();\n    };\n  }, []);\n\n  return intersectionObserver;\n};\n","import { useRef } from 'react';\n\nexport const useLastDefinedValue = <T>(value: T) => {\n  const ref = useRef(value);\n  if (value != null) {\n    ref.current = value;\n  }\n  return ref.current;\n};\n","import { useRef } from 'react';\n\nexport const useLastValueRef = <T>(value: T | null | undefined) => {\n  const ref = useRef(value);\n\n  if (value != null) {\n    ref.current = value;\n  }\n\n  return ref;\n};\n","import { useEffect } from 'react';\nimport { useSyncRef } from './use-sync-ref.js';\n\nexport const useLifeCycle = (\n  fn: () => {\n    mount?: VoidFunction;\n    unmount?: VoidFunction;\n  },\n) => {\n  const fnRef = useSyncRef(fn);\n\n  useEffect(() => {\n    const fnOperation = fnRef.current();\n    fnOperation.mount?.();\n    return fnOperation.unmount?.();\n  }, []);\n};\n","import { useLayoutEffect } from 'react';\nimport { useDefineRef } from './use-define-ref.js';\n\nexport const useResizeObserver = (callback: ResizeObserverCallback) => {\n  const resizeObserverRef = useDefineRef(() => new ResizeObserver(callback));\n\n  useLayoutEffect(() => {\n    return () => {\n      resizeObserverRef.current.disconnect();\n    };\n  }, []);\n\n  return resizeObserverRef;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useToggle = (initialState?: boolean) => {\n  const [toggled, setToggled] = useState(!!initialState);\n\n  const toggle = useCallback(() => setToggled((toggled) => !toggled), []);\n\n  return [toggled, toggle, setToggled] as const;\n};\n","import { useState } from 'react';\n\nexport const useValue = <T>(defaults: T | (() => T)) => {\n  const [value, setValue] = useState<T>(defaults);\n\n  return {\n    value,\n    set: setValue,\n  };\n};\n","import { useEffect, useState } from 'react';\n\nexport const useVisibilityState = () => {\n  const [state, setState] = useState<DocumentVisibilityState>();\n\n  useEffect(() => {\n    const handleVisibilityChange = () => {\n      setState(document.visibilityState);\n    };\n\n    document.addEventListener('visibilitychange', handleVisibilityChange);\n\n    return () => {\n      document.removeEventListener('visibilitychange', handleVisibilityChange);\n    };\n  }, []);\n\n  return state;\n};\n"],"names":["toggled"],"mappings":"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"}