yummies 7.10.0 → 7.12.0

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  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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"}
+{"version":3,"file":"react.js","names":[],"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\n/**\n * Assigns the same value to multiple React refs, including callback refs.\n *\n * @template T Referenced value type.\n * @param value Value that should be written into every provided ref.\n * @param refs Target refs to update.\n *\n * @example\n * ```ts\n * attachRefs(node, localRef, forwardedRef);\n * ```\n *\n * @example\n * ```ts\n * attachRefs(null, inputRef, (value) => console.log(value));\n * ```\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 *\n * Unlike `useMemo`, this guarantees that the initializer is executed only once\n * for the component lifetime.\n *\n * @template T Value type.\n * @param defineValue Function that lazily creates the value.\n * @returns Stable value created on the first render.\n *\n * @example\n * ```ts\n * const id = useConstant(() => crypto.randomUUID());\n * ```\n *\n * @example\n * ```ts\n * const formatter = useConstant(() => new Intl.NumberFormat('en-US'));\n * ```\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\n/**\n * Creates a single `AbortController` instance for the component lifetime.\n *\n * The controller is aborted automatically during unmount.\n *\n * @returns Stable abort controller instance.\n *\n * @example\n * ```ts\n * const controller = useAbortController();\n * fetch('/api', { signal: controller.signal });\n * ```\n *\n * @example\n * ```ts\n * const controller = useAbortController();\n * controller.abort();\n * ```\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\n/**\n * Returns an `AbortSignal` tied to the component lifecycle.\n *\n * The signal is aborted automatically on unmount.\n *\n * @returns Lifecycle-bound abort signal.\n *\n * @example\n * ```ts\n * const signal = useAbortSignal();\n * fetch('/api/users', { signal });\n * ```\n *\n * @example\n * ```ts\n * const signal = useAbortSignal();\n * someAsyncTask({ signal });\n * ```\n */\nexport const useAbortSignal = () => {\n  return useAbortController().signal;\n};\n","import { useRef } from 'react';\n\n/**\n * Returns a ref whose `current` value is synchronized with the latest input\n * on every render.\n *\n * @template T Value type.\n * @param value Current value to expose through the ref.\n * @returns Ref containing the latest value.\n *\n * @example\n * ```ts\n * const latestHandler = useSyncRef(onSubmit);\n * latestHandler.current();\n * ```\n *\n * @example\n * ```ts\n * const latestValue = useSyncRef(props.value);\n * latestValue.current;\n * ```\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\n/**\n * Subscribes to a DOM event and keeps the latest handler without resubscribing\n * on every render.\n *\n * Supports optional debounce and custom effect dependencies.\n *\n * @template EventName DOM event name from `HTMLElementEventMap`.\n * @param config Event subscription configuration.\n *\n * @example\n * ```ts\n * useEventListener({\n *   event: 'click',\n *   handler: () => console.log('clicked'),\n * });\n * ```\n *\n * @example\n * ```ts\n * useEventListener({\n *   event: 'scroll',\n *   node: window,\n *   debounce: 100,\n *   handler: () => console.log('scroll'),\n * });\n * ```\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\n/**\n * Calls a handler when a pointer interaction happens outside the referenced element.\n *\n * @param input Target element ref, callback and event listener options.\n *\n * @example\n * ```ts\n * useClickOutside({\n *   contentRef: modalRef,\n *   onClick: () => closeModal(),\n * });\n * ```\n *\n * @example\n * ```ts\n * useClickOutside({\n *   contentRef: dropdownRef,\n *   onClick: hideDropdown,\n *   options: { capture: true },\n * });\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 * Creates a mutable ref whose value is initialized exactly once.\n *\n * @template T Ref value type.\n * @param defineFn Function that lazily creates the initial ref value.\n * @returns Mutable ref with a stable initialized value.\n *\n * @example\n * ```ts\n * const cacheRef = useDefineRef(() => new Map());\n * ```\n *\n * @example\n * ```ts\n * const observerRef = useDefineRef(() => new ResizeObserver(() => {}));\n * ```\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\n/**\n * Resolves an element once after mount and stores it in a ref.\n *\n * @template T Element type.\n * @param selector Function returning the target element.\n * @returns Ref containing the selected element.\n *\n * @example\n * ```ts\n * const buttonRef = useElementRef(() => document.getElementById('save') as HTMLButtonElement);\n * ```\n *\n * @example\n * ```ts\n * const modalRef = useElementRef(() => document.querySelector('.modal') as HTMLDivElement);\n * ```\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","import { useCallback, useLayoutEffect, useRef } from 'react';\nimport type { AnyFunction } from 'yummies/types';\n\n/**\n * Creates an event callback with a stable function identity and up-to-date logic.\n *\n * Borrowed from the `useEvent` RFC idea by React contributors.\n *\n * @template H Handler function type.\n * @param handler Latest callback implementation.\n * @returns Stable callback that always delegates to the latest handler.\n *\n * @example\n * ```ts\n * const onClick = useEvent(() => {\n *   console.log('clicked');\n * });\n * ```\n *\n * @example\n * ```ts\n * const onSubmit = useEvent((value: string) => save(value));\n * ```\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\n/**\n * Manages a reusable boolean flag object with stable helper methods.\n *\n * @param defaultValue Initial enabled state.\n * @returns Stable object exposing current state and mutators.\n *\n * @example\n * ```ts\n * const modal = useFlag();\n * modal.enable();\n * ```\n *\n * @example\n * ```ts\n * const loading = useFlag(true);\n * loading.disable();\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\n/**\n * Forces a component re-render by updating an internal dummy state.\n *\n * @returns Stable callback that triggers a re-render.\n *\n * @example\n * ```ts\n * const forceUpdate = useForceUpdate();\n * forceUpdate();\n * ```\n *\n * @example\n * ```ts\n * const rerender = useForceUpdate();\n * setTimeout(rerender, 1000);\n * ```\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\n/**\n * Captures an element's height the first time its ref becomes available.\n *\n * @template T Element type attached to the returned ref.\n * @returns Ref and the initial measured height.\n *\n * @example\n * ```ts\n * const { ref, initialHeight } = useInitialHeight<HTMLDivElement>();\n * ```\n *\n * @example\n * ```ts\n * const state = useInitialHeight<HTMLTextAreaElement>();\n * state.initialHeight;\n * ```\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\n/**\n * Builds a custom hook that creates an instance once and wires lifecycle helpers\n * such as an `AbortSignal` and optional extension data into the factory.\n *\n * @template TExtension Extra configuration injected into every factory call.\n * @param extension Optional static extension object merged into the factory config.\n * @returns Hook factory that creates stable instances from a supplied factory.\n *\n * @example\n * ```ts\n * const useStoreInstance = createUseInstanceHook({ api });\n * ```\n *\n * @example\n * ```ts\n * const useService = createUseInstanceHook({ logger });\n * const service = useService(({ logger, payload }) => new Service(logger, payload));\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 *\n * @example\n * ```ts\n * const service = useInstance(({ abortSignal }) => new UsersService({ abortSignal }));\n * ```\n *\n * @example\n * ```ts\n * const store = useInstance(\n *   ({ payload }) => new UserStore(payload),\n *   { payload: userId, onUpdate: (nextId) => console.log(nextId) },\n * );\n * ```\n */\nexport const useInstance = createUseInstanceHook();\n","import { useEffect, useState } from 'react';\n\n/**\n * Creates a single `IntersectionObserver` instance and disposes it on unmount.\n *\n * @param callback Observer callback invoked for intersection changes.\n * @param options Optional observer configuration.\n * @returns Stable `IntersectionObserver` instance.\n *\n * @example\n * ```ts\n * const observer = useIntersectionObserver((entries) => {\n *   console.log(entries[0]?.isIntersecting);\n * });\n * ```\n *\n * @example\n * ```ts\n * const observer = useIntersectionObserver(handleIntersect, { threshold: 0.5 });\n * observer.observe(element);\n * ```\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\n/**\n * Remembers and returns the last non-nullish value passed to the hook.\n *\n * @template T Value type.\n * @param value Current value that may be `null` or `undefined`.\n * @returns Current value when defined, otherwise the previous defined value.\n *\n * @example\n * ```ts\n * const title = useLastDefinedValue(props.title);\n * ```\n *\n * @example\n * ```ts\n * const user = useLastDefinedValue<User | null>(selectedUser);\n * ```\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\n/**\n * Returns a ref that always points to the last non-nullish value.\n *\n * @template T Value type.\n * @param value Current value that may temporarily become `null` or `undefined`.\n * @returns Ref containing the last defined value.\n *\n * @example\n * ```ts\n * const latestUserRef = useLastValueRef(user);\n * latestUserRef.current;\n * ```\n *\n * @example\n * ```ts\n * const latestNodeRef = useLastValueRef<HTMLDivElement | null>(node);\n * ```\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\n/**\n * Runs mount and unmount callbacks returned by a factory function.\n *\n * The latest factory is stored in a ref, while the effect itself is only\n * subscribed once.\n *\n * @param fn Factory returning optional `mount` and `unmount` handlers.\n *\n * @example\n * ```ts\n * useLifeCycle(() => ({\n *   mount: () => console.log('mounted'),\n *   unmount: () => console.log('unmounted'),\n * }));\n * ```\n *\n * @example\n * ```ts\n * useLifeCycle(() => ({\n *   mount: subscribe,\n *   unmount: unsubscribe,\n * }));\n * ```\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\n/**\n * Creates a stable `ResizeObserver` instance and disconnects it on unmount.\n *\n * @param callback Resize observer callback.\n * @returns Ref containing the observer instance.\n *\n * @example\n * ```ts\n * const observerRef = useResizeObserver((entries) => {\n *   console.log(entries[0]?.contentRect.width);\n * });\n * ```\n *\n * @example\n * ```ts\n * const resizeObserver = useResizeObserver(handleResize);\n * resizeObserver.current.observe(element);\n * ```\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\n/**\n * Manages a boolean state and returns helpers to toggle or set it directly.\n *\n * @param initialState Initial boolean value.\n * @returns Tuple with current state, toggle callback and raw setter.\n *\n * @example\n * ```ts\n * const [open, toggleOpen] = useToggle();\n * toggleOpen();\n * ```\n *\n * @example\n * ```ts\n * const [enabled, , setEnabled] = useToggle(true);\n * setEnabled(false);\n * ```\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\n/**\n * Wraps `useState` and returns the state value as an object with a `set` method.\n *\n * @template T State value type.\n * @param defaults Initial state value or lazy initializer.\n * @returns Object containing the current value and setter.\n *\n * @example\n * ```ts\n * const counter = useValue(0);\n * counter.set(1);\n * ```\n *\n * @example\n * ```ts\n * const user = useValue(() => ({ name: 'Ann' }));\n * user.value.name;\n * ```\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\n/**\n * Tracks `document.visibilityState` and updates when the page visibility changes.\n *\n * @returns Current document visibility state.\n *\n * @example\n * ```ts\n * const visibility = useVisibilityState();\n * ```\n *\n * @example\n * ```ts\n * const isHidden = useVisibilityState() === 'hidden';\n * ```\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"],"mappings":"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"}

package/sound.cjs

@@ -1,12 +1,17 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const playSound = async (file, { volume = 1 } = {}) => {
-  let audio = new Audio(file);
-  audio.volume = volume;
-  audio.muted = !volume;
-  await audio.play();
-  audio.remove();
-  audio = null;
+//#region src/sound.ts
+/**
+* Plays a sound from a file.
+*/
+var playSound = async (file, { volume = 1 } = {}) => {
+	let audio = new Audio(file);
+	audio.volume = volume;
+	audio.muted = !volume;
+	await audio.play();
+	audio.remove();
+	audio = null;
 };
+//#endregion
 exports.playSound = playSound;
-//# sourceMappingURL=sound.cjs.map
+
+//# sourceMappingURL=sound.cjs.map

package/sound.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sound.cjs","sources":["../src/sound.ts"],"sourcesContent":["/**\n * Воспроизводит звук из файла\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"names":[],"mappings":";;AAGO,MAAM,YAAY,OACvB,MACA,EAAE,SAAS,EAAA,IAA2B,CAAA,MACnC;AACH,MAAI,QAAQ,IAAI,MAAM,IAAI;AAC1B,QAAM,SAAS;AACf,QAAM,QAAQ,CAAC;AACf,QAAM,MAAM,KAAA;AACZ,QAAM,OAAA;AAEN,UAAQ;AACV;;"}
+{"version":3,"file":"sound.cjs","names":[],"sources":["../src/sound.ts"],"sourcesContent":["/**\n * Plays a sound from a file.\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"mappings":";;;;;AAGA,IAAa,YAAY,OACvB,MACA,EAAE,SAAS,MAA2B,EAAE,KACrC;CACH,IAAI,QAAQ,IAAI,MAAM,KAAK;AAC3B,OAAM,SAAS;AACf,OAAM,QAAQ,CAAC;AACf,OAAM,MAAM,MAAM;AAClB,OAAM,QAAQ;AAEd,SAAQ"}

package/sound.d.ts

@@ -1,5 +1,5 @@
 /**
- * Воспроизводит звук из файла
+ * Plays a sound from a file.
  */
 declare const playSound: (file: string, { volume }?: {
     volume?: number;

package/sound.js

@@ -1,12 +1,16 @@
-const playSound = async (file, { volume = 1 } = {}) => {
-  let audio = new Audio(file);
-  audio.volume = volume;
-  audio.muted = !volume;
-  await audio.play();
-  audio.remove();
-  audio = null;
+//#region src/sound.ts
+/**
+* Plays a sound from a file.
+*/
+var playSound = async (file, { volume = 1 } = {}) => {
+	let audio = new Audio(file);
+	audio.volume = volume;
+	audio.muted = !volume;
+	await audio.play();
+	audio.remove();
+	audio = null;
 };
-export {
-  playSound
-};
-//# sourceMappingURL=sound.js.map
+//#endregion
+export { playSound };
+
+//# sourceMappingURL=sound.js.map

package/sound.js.map

@@ -1 +1 @@
-{"version":3,"file":"sound.js","sources":["../src/sound.ts"],"sourcesContent":["/**\n * Воспроизводит звук из файла\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"names":[],"mappings":"AAGO,MAAM,YAAY,OACvB,MACA,EAAE,SAAS,EAAA,IAA2B,CAAA,MACnC;AACH,MAAI,QAAQ,IAAI,MAAM,IAAI;AAC1B,QAAM,SAAS;AACf,QAAM,QAAQ,CAAC;AACf,QAAM,MAAM,KAAA;AACZ,QAAM,OAAA;AAEN,UAAQ;AACV;"}
+{"version":3,"file":"sound.js","names":[],"sources":["../src/sound.ts"],"sourcesContent":["/**\n * Plays a sound from a file.\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"mappings":";;;;AAGA,IAAa,YAAY,OACvB,MACA,EAAE,SAAS,MAA2B,EAAE,KACrC;CACH,IAAI,QAAQ,IAAI,MAAM,KAAK;AAC3B,OAAM,SAAS;AACf,OAAM,QAAQ,CAAC;AACf,OAAM,MAAM,MAAM;AAClB,OAAM,QAAQ;AAEd,SAAQ"}

package/storage.cjs

@@ -1,58 +1,57 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const storages = {
-  session: sessionStorage,
-  local: localStorage
+//#region src/storage.ts
+var storages = {
+	session: sessionStorage,
+	local: localStorage
 };
-const createKey = (prefix, key, namespace) => `${prefix}${namespace ? `/${namespace}` : ""}/${key}`;
-const parseStorageValue = (value) => {
-  if (typeof value !== "string") {
-    return value;
-  }
-  try {
-    const parsed = JSON.parse(value);
-    return parsed;
-  } catch {
-    return null;
-  }
+/**
+* Builds a storage key from a prefix, optional namespace and key.
+*
+* @example
+* ```ts
+* createKey('app', 'token', 'auth'); // 'app/auth/token'
+* ```
+*/
+var createKey = (prefix, key, namespace) => `${prefix}${namespace ? `/${namespace}` : ""}/${key}`;
+var parseStorageValue = (value) => {
+	if (typeof value !== "string") return value;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return null;
+	}
 };
-const formatValueToStorage = (value) => {
-  return JSON.stringify(value);
+var formatValueToStorage = (value) => {
+	return JSON.stringify(value);
 };
+/**
+* Creates an interface for working with storage (`localStorage`, `sessionStorage`).
+*/
 function createStorage(storageConfig) {
-  return {
-    set: (cfg) => {
-      const config = cfg;
-      const storageType = config.type ?? storageConfig.type;
-      const storagePrefix = config.prefix ?? storageConfig.prefix;
-      const storage = storages[storageType];
-      storage.setItem(
-        createKey(storagePrefix, config.key, config.namespace),
-        formatValueToStorage(config.value)
-      );
-    },
-    unset: (cfg) => {
-      const config = cfg;
-      const storageType = config.type ?? storageConfig.type;
-      const storagePrefix = config.prefix ?? storageConfig.prefix;
-      const storage = storages[storageType];
-      storage.removeItem(
-        createKey(storagePrefix, config.key, config.namespace)
-      );
-    },
-    get: (cfg) => {
-      const config = cfg;
-      const storageType = config.type ?? storageConfig.type;
-      const storagePrefix = config.prefix ?? storageConfig.prefix;
-      const storage = storages[storageType];
-      return parseStorageValue(
-        storage.getItem(
-          createKey(storagePrefix, config.key, config.namespace)
-        )
-      ) ?? config.fallback ?? null;
-    }
-  };
+	return {
+		set: (cfg) => {
+			const config = cfg;
+			const storageType = config.type ?? storageConfig.type;
+			const storagePrefix = config.prefix ?? storageConfig.prefix;
+			storages[storageType].setItem(createKey(storagePrefix, config.key, config.namespace), formatValueToStorage(config.value));
+		},
+		unset: (cfg) => {
+			const config = cfg;
+			const storageType = config.type ?? storageConfig.type;
+			const storagePrefix = config.prefix ?? storageConfig.prefix;
+			storages[storageType].removeItem(createKey(storagePrefix, config.key, config.namespace));
+		},
+		get: (cfg) => {
+			const config = cfg;
+			const storageType = config.type ?? storageConfig.type;
+			const storagePrefix = config.prefix ?? storageConfig.prefix;
+			const storage = storages[storageType];
+			return parseStorageValue(storage.getItem(createKey(storagePrefix, config.key, config.namespace))) ?? config.fallback ?? null;
+		}
+	};
 }
+//#endregion
 exports.createKey = createKey;
 exports.createStorage = createStorage;
-//# sourceMappingURL=storage.cjs.map
+
+//# sourceMappingURL=storage.cjs.map

package/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.cjs","sources":["../src/storage.ts"],"sourcesContent":["export type StorageType = 'session' | 'local';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Ключ по которому можно получить значение из хранилища (имя ключа не полное, оно дополняется неймпспейсом проекта)\n   */\n  key: string;\n  /**\n   * Тип хранилища\n   */\n  type: StorageType;\n  /**\n   * дефолтное значение, которое будет использоваться если значения нет в хранилище\n   */\n  fallback?: V;\n  /**\n   * Доп. делитель в ключ/utils/types'е\n   */\n  namespace?: string;\n  /**\n   * Доп. делитель\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Создает интерфейс для работы с хранилищем (localStorage, sessionStorage)\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"names":[],"mappings":";;AAEA,MAAM,WAAyC;AAAA,EAC7C,SAAS;AAAA,EACT,OAAO;AACT;AAEO,MAAM,YAAY,CAAC,QAAgB,KAAa,cACrD,GAAG,MAAM,GAAG,YAAY,IAAI,SAAS,KAAK,EAAE,IAAI,GAAG;AAErD,MAAM,oBAAoB,CAAI,UAA6B;AACzD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,MAAM,uBAAuB,CAAC,UAA2B;AACvD,SAAO,KAAK,UAAU,KAAK;AAC7B;AA4FO,SAAS,cACd,eACwB;AACxB,SAAO;AAAA,IACL,KAAK,CAAQ,QAAsD;AACjE,YAAM,SAAS;AACf,YAAM,cAAe,OAAO,QAAQ,cAAc;AAClD,YAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtD,YAAM,UAAU,SAAS,WAAW;AAEpC,cAAQ;AAAA,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS;AAAA,QACrD,qBAAqB,OAAO,KAAK;AAAA,MAAA;AAAA,IAErC;AAAA,IACA,OAAO,CAAQ,QAAmD;AAChE,YAAM,SAAS;AACf,YAAM,cAAe,OAAO,QAAQ,cAAc;AAClD,YAAM,gBAAiB,OAAO,UAAU,cAAc;AACtD,YAAM,UAAU,SAAS,WAAW;AAEpC,cAAQ;AAAA,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS;AAAA,MAAA;AAAA,IAEzD;AAAA,IACA,KAAK,CAAQ,QAAwD;AACnE,YAAM,SAAS;AACf,YAAM,cAAe,OAAO,QAAQ,cAAc;AAClD,YAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtD,YAAM,UAAU,SAAS,WAAW;AAEpC,aACE;AAAA,QACE,QAAQ;AAAA,UACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS;AAAA,QAAA;AAAA,MACvD,KAEF,OAAO,YACP;AAAA,IAEJ;AAAA,EAAA;AAEJ;;;"}
+{"version":3,"file":"storage.cjs","names":[],"sources":["../src/storage.ts"],"sourcesContent":["export type StorageType = 'session' | 'local';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\n/**\n * Builds a storage key from a prefix, optional namespace and key.\n *\n * @example\n * ```ts\n * createKey('app', 'token', 'auth'); // 'app/auth/token'\n * ```\n */\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Storage key used to retrieve the value.\n   * The full key is extended with the project namespace.\n   */\n  key: string;\n  /**\n   * Storage type.\n   */\n  type: StorageType;\n  /**\n   * Default value used when there is no value in storage.\n   */\n  fallback?: V;\n  /**\n   * Optional namespace segment used in the generated key.\n   */\n  namespace?: string;\n  /**\n   * Optional key prefix.\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Creates an interface for working with storage (`localStorage`, `sessionStorage`).\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"mappings":";;AAEA,IAAM,WAAyC;CAC7C,SAAS;CACT,OAAO;CACR;;;;;;;;;AAUD,IAAa,aAAa,QAAgB,KAAa,cACrD,GAAG,SAAS,YAAY,IAAI,cAAc,GAAG,GAAG;AAElD,IAAM,qBAAwB,UAA6B;AACzD,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI;AAEF,SADe,KAAK,MAAM,MAAM;SAE1B;AACN,SAAO;;;AAIX,IAAM,wBAAwB,UAA2B;AACvD,QAAO,KAAK,UAAU,MAAM;;;;;AA8F9B,SAAgB,cACd,eACwB;AACxB,QAAO;EACL,MAAa,QAAsD;GACjE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtC,YAAS,aAEjB,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,EACtD,qBAAqB,OAAO,MAAM,CACnC;;EAEH,QAAe,QAAmD;GAChE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AACtC,YAAS,aAEjB,WACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD;;EAEH,MAAa,QAAwD;GACnE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAEtD,MAAM,UAAU,SAAS;AAEzB,UACE,kBACE,QAAQ,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD,CACF,IACD,OAAO,YACP;;EAGL"}

package/storage.d.ts

@@ -1,4 +1,12 @@
 type StorageType = 'session' | 'local';
+/**
+ * Builds a storage key from a prefix, optional namespace and key.
+ *
+ * @example
+ * ```ts
+ * createKey('app', 'token', 'auth'); // 'app/auth/token'
+ * ```
+ */
 declare const createKey: (prefix: string, key: string, namespace?: string) => string;
 interface SetToStorageConfig<V> extends Omit<GetFromStorageConfig<V>, 'fallback'> {
     value: V;
@@ -7,23 +15,24 @@ interface UnsetFromStorageConfig extends Omit<GetFromStorageConfig<any>, 'fallba
 }
 interface GetFromStorageConfig<V> {
     /**
-     * Ключ по которому можно получить значение из хранилища (имя ключа не полное, оно дополняется неймпспейсом проекта)
+     * Storage key used to retrieve the value.
+     * The full key is extended with the project namespace.
      */
     key: string;
     /**
-     * Тип хранилища
+     * Storage type.
      */
     type: StorageType;
     /**
-     * дефолтное значение, которое будет использоваться если значения нет в хранилище
+     * Default value used when there is no value in storage.
      */
     fallback?: V;
     /**
-     * Доп. делитель в ключ/utils/types'е
+     * Optional namespace segment used in the generated key.
      */
     namespace?: string;
     /**
-     * Доп. делитель
+     * Optional key prefix.
      */
     prefix?: string;
 }
@@ -37,7 +46,7 @@ interface StorageApi<BaseConfig extends StorageConfigBase> {
     get<Value>(config: GetFromStorageWrappedConfig<Value, BaseConfig>): Value | null;
 }
 /**
- * Создает интерфейс для работы с хранилищем (localStorage, sessionStorage)
+ * Creates an interface for working with storage (`localStorage`, `sessionStorage`).
  */
 declare function createStorage<BaseConfig extends StorageConfigBase>(storageConfig: BaseConfig): StorageApi<BaseConfig>;
 

package/storage.js

@@ -1,58 +1,55 @@
-const storages = {
-  session: sessionStorage,
-  local: localStorage
+//#region src/storage.ts
+var storages = {
+	session: sessionStorage,
+	local: localStorage
 };
-const createKey = (prefix, key, namespace) => `${prefix}${namespace ? `/${namespace}` : ""}/${key}`;
-const parseStorageValue = (value) => {
-  if (typeof value !== "string") {
-    return value;
-  }
-  try {
-    const parsed = JSON.parse(value);
-    return parsed;
-  } catch {
-    return null;
-  }
+/**
+* Builds a storage key from a prefix, optional namespace and key.
+*
+* @example
+* ```ts
+* createKey('app', 'token', 'auth'); // 'app/auth/token'
+* ```
+*/
+var createKey = (prefix, key, namespace) => `${prefix}${namespace ? `/${namespace}` : ""}/${key}`;
+var parseStorageValue = (value) => {
+	if (typeof value !== "string") return value;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return null;
+	}
 };
-const formatValueToStorage = (value) => {
-  return JSON.stringify(value);
+var formatValueToStorage = (value) => {
+	return JSON.stringify(value);
 };
+/**
+* Creates an interface for working with storage (`localStorage`, `sessionStorage`).
+*/
 function createStorage(storageConfig) {
-  return {
-    set: (cfg) => {
-      const config = cfg;
-      const storageType = config.type ?? storageConfig.type;
-      const storagePrefix = config.prefix ?? storageConfig.prefix;
-      const storage = storages[storageType];
-      storage.setItem(
-        createKey(storagePrefix, config.key, config.namespace),
-        formatValueToStorage(config.value)
-      );
-    },
-    unset: (cfg) => {
-      const config = cfg;
-      const storageType = config.type ?? storageConfig.type;
-      const storagePrefix = config.prefix ?? storageConfig.prefix;
-      const storage = storages[storageType];
-      storage.removeItem(
-        createKey(storagePrefix, config.key, config.namespace)
-      );
-    },
-    get: (cfg) => {
-      const config = cfg;
-      const storageType = config.type ?? storageConfig.type;
-      const storagePrefix = config.prefix ?? storageConfig.prefix;
-      const storage = storages[storageType];
-      return parseStorageValue(
-        storage.getItem(
-          createKey(storagePrefix, config.key, config.namespace)
-        )
-      ) ?? config.fallback ?? null;
-    }
-  };
+	return {
+		set: (cfg) => {
+			const config = cfg;
+			const storageType = config.type ?? storageConfig.type;
+			const storagePrefix = config.prefix ?? storageConfig.prefix;
+			storages[storageType].setItem(createKey(storagePrefix, config.key, config.namespace), formatValueToStorage(config.value));
+		},
+		unset: (cfg) => {
+			const config = cfg;
+			const storageType = config.type ?? storageConfig.type;
+			const storagePrefix = config.prefix ?? storageConfig.prefix;
+			storages[storageType].removeItem(createKey(storagePrefix, config.key, config.namespace));
+		},
+		get: (cfg) => {
+			const config = cfg;
+			const storageType = config.type ?? storageConfig.type;
+			const storagePrefix = config.prefix ?? storageConfig.prefix;
+			const storage = storages[storageType];
+			return parseStorageValue(storage.getItem(createKey(storagePrefix, config.key, config.namespace))) ?? config.fallback ?? null;
+		}
+	};
 }
-export {
-  createKey,
-  createStorage
-};
-//# sourceMappingURL=storage.js.map
+//#endregion
+export { createKey, createStorage };
+
+//# sourceMappingURL=storage.js.map

package/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sources":["../src/storage.ts"],"sourcesContent":["export type StorageType = 'session' | 'local';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Ключ по которому можно получить значение из хранилища (имя ключа не полное, оно дополняется неймпспейсом проекта)\n   */\n  key: string;\n  /**\n   * Тип хранилища\n   */\n  type: StorageType;\n  /**\n   * дефолтное значение, которое будет использоваться если значения нет в хранилище\n   */\n  fallback?: V;\n  /**\n   * Доп. делитель в ключ/utils/types'е\n   */\n  namespace?: string;\n  /**\n   * Доп. делитель\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Создает интерфейс для работы с хранилищем (localStorage, sessionStorage)\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"names":[],"mappings":"AAEA,MAAM,WAAyC;AAAA,EAC7C,SAAS;AAAA,EACT,OAAO;AACT;AAEO,MAAM,YAAY,CAAC,QAAgB,KAAa,cACrD,GAAG,MAAM,GAAG,YAAY,IAAI,SAAS,KAAK,EAAE,IAAI,GAAG;AAErD,MAAM,oBAAoB,CAAI,UAA6B;AACzD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,MAAM,uBAAuB,CAAC,UAA2B;AACvD,SAAO,KAAK,UAAU,KAAK;AAC7B;AA4FO,SAAS,cACd,eACwB;AACxB,SAAO;AAAA,IACL,KAAK,CAAQ,QAAsD;AACjE,YAAM,SAAS;AACf,YAAM,cAAe,OAAO,QAAQ,cAAc;AAClD,YAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtD,YAAM,UAAU,SAAS,WAAW;AAEpC,cAAQ;AAAA,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS;AAAA,QACrD,qBAAqB,OAAO,KAAK;AAAA,MAAA;AAAA,IAErC;AAAA,IACA,OAAO,CAAQ,QAAmD;AAChE,YAAM,SAAS;AACf,YAAM,cAAe,OAAO,QAAQ,cAAc;AAClD,YAAM,gBAAiB,OAAO,UAAU,cAAc;AACtD,YAAM,UAAU,SAAS,WAAW;AAEpC,cAAQ;AAAA,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS;AAAA,MAAA;AAAA,IAEzD;AAAA,IACA,KAAK,CAAQ,QAAwD;AACnE,YAAM,SAAS;AACf,YAAM,cAAe,OAAO,QAAQ,cAAc;AAClD,YAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtD,YAAM,UAAU,SAAS,WAAW;AAEpC,aACE;AAAA,QACE,QAAQ;AAAA,UACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS;AAAA,QAAA;AAAA,MACvD,KAEF,OAAO,YACP;AAAA,IAEJ;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"storage.js","names":[],"sources":["../src/storage.ts"],"sourcesContent":["export type StorageType = 'session' | 'local';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\n/**\n * Builds a storage key from a prefix, optional namespace and key.\n *\n * @example\n * ```ts\n * createKey('app', 'token', 'auth'); // 'app/auth/token'\n * ```\n */\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Storage key used to retrieve the value.\n   * The full key is extended with the project namespace.\n   */\n  key: string;\n  /**\n   * Storage type.\n   */\n  type: StorageType;\n  /**\n   * Default value used when there is no value in storage.\n   */\n  fallback?: V;\n  /**\n   * Optional namespace segment used in the generated key.\n   */\n  namespace?: string;\n  /**\n   * Optional key prefix.\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Creates an interface for working with storage (`localStorage`, `sessionStorage`).\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"mappings":";AAEA,IAAM,WAAyC;CAC7C,SAAS;CACT,OAAO;CACR;;;;;;;;;AAUD,IAAa,aAAa,QAAgB,KAAa,cACrD,GAAG,SAAS,YAAY,IAAI,cAAc,GAAG,GAAG;AAElD,IAAM,qBAAwB,UAA6B;AACzD,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI;AAEF,SADe,KAAK,MAAM,MAAM;SAE1B;AACN,SAAO;;;AAIX,IAAM,wBAAwB,UAA2B;AACvD,QAAO,KAAK,UAAU,MAAM;;;;;AA8F9B,SAAgB,cACd,eACwB;AACxB,QAAO;EACL,MAAa,QAAsD;GACjE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtC,YAAS,aAEjB,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,EACtD,qBAAqB,OAAO,MAAM,CACnC;;EAEH,QAAe,QAAmD;GAChE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AACtC,YAAS,aAEjB,WACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD;;EAEH,MAAa,QAAwD;GACnE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAEtD,MAAM,UAAU,SAAS;AAEzB,UACE,kBACE,QAAQ,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD,CACF,IACD,OAAO,YACP;;EAGL"}

package/text.cjs

@@ -1,38 +1,55 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const declension = (count, txt, cases = [2, 0, 1, 1, 1, 2]) => txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];
-const splitTextByLines = (text, lineLingth = 60) => {
-  const words = text.split(/\s+/).filter((word) => word !== "");
-  const lines = [];
-  let currentLine = "";
-  for (const word of words) {
-    if (word.length > lineLingth) {
-      if (currentLine !== "") {
-        lines.push(currentLine);
-        currentLine = "";
-      }
-      let start = 0;
-      while (start < word.length) {
-        const chunk = word.slice(start, start + lineLingth);
-        lines.push(chunk);
-        start += lineLingth;
-      }
-      continue;
-    }
-    if (currentLine === "") {
-      currentLine = word;
-    } else if (currentLine.length + 1 + word.length <= lineLingth) {
-      currentLine += ` ${word}`;
-    } else {
-      lines.push(currentLine);
-      currentLine = word;
-    }
-  }
-  if (currentLine !== "" || lines.length === 0) {
-    lines.push(currentLine);
-  }
-  return lines;
+//#region src/text.ts
+/**
+* Returns the correct word form based on the provided count.
+* @example
+* declension(1, ['slovo', 'slova', 'slov']) // 'slovo'
+* @example
+* declension(2, ['slovo', 'slova', 'slov']) // 'slova'
+* @example
+* declension(5, ['slovo', 'slova', 'slov']) // 'slov'
+*/
+var declension = (count, txt, cases = [
+	2,
+	0,
+	1,
+	1,
+	1,
+	2
+]) => txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];
+/**
+* Splits text into lines with a maximum line length.
+*/
+var splitTextByLines = (text, lineLingth = 60) => {
+	const words = text.split(/\s+/).filter((word) => word !== "");
+	const lines = [];
+	let currentLine = "";
+	for (const word of words) {
+		if (word.length > lineLingth) {
+			if (currentLine !== "") {
+				lines.push(currentLine);
+				currentLine = "";
+			}
+			let start = 0;
+			while (start < word.length) {
+				const chunk = word.slice(start, start + lineLingth);
+				lines.push(chunk);
+				start += lineLingth;
+			}
+			continue;
+		}
+		if (currentLine === "") currentLine = word;
+		else if (currentLine.length + 1 + word.length <= lineLingth) currentLine += ` ${word}`;
+		else {
+			lines.push(currentLine);
+			currentLine = word;
+		}
+	}
+	if (currentLine !== "" || lines.length === 0) lines.push(currentLine);
+	return lines;
 };
+//#endregion
 exports.declension = declension;
 exports.splitTextByLines = splitTextByLines;
-//# sourceMappingURL=text.cjs.map
+
+//# sourceMappingURL=text.cjs.map