@siberiacancode/reactuse 0.3.15 → 0.3.17

package/dist/esm/hooks/useField/useField.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useField.mjs","sources":["../../../../src/hooks/useField/useField.ts"],"sourcesContent":["import type { RefObject } from 'react';\n\nimport { useRef, useState } from 'react';\n\nimport { useRerender } from '../useRerender/useRerender';\n\n/** The use field params type */\nexport interface UseFieldOptions {\n  /** The auto focus */\n  autoFocus?: boolean;\n  /** The initial touched */\n  initialTouched?: boolean;\n  /** The validate on blur */\n  validateOnBlur?: boolean;\n  /** The validate on mount */\n  validateOnChange?: boolean;\n  /** The validate on mount */\n  validateOnMount?: boolean;\n}\n\n/** The use field register params type */\nexport interface UseFieldRegisterParams {\n  /** The min value validation */\n  max?: {\n    value: number;\n    message: string;\n  };\n  /** The max length validation */\n  maxLength?: {\n    value: number;\n    message: string;\n  };\n  /** The max value validation */\n  min?: {\n    value: number;\n    message: string;\n  };\n  /** The min length validation */\n  minLength?: {\n    value: number;\n    message: string;\n  };\n  /** The pattern validation */\n  pattern?: {\n    value: RegExp;\n    message: string;\n  };\n  /** The required validation */\n  required?: string;\n  /** The custom validation */\n  validate?: (value: string) => Promise<string | true>;\n}\n\n/** The use field return type */\nexport interface UseFieldReturn<Value> {\n  /** The dirty state */\n  dirty: boolean;\n  /** The error state */\n  error?: string;\n  /** The input ref */\n  ref: RefObject<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null>;\n  /** The set error function */\n  touched: boolean;\n  /** The set error function */\n  clearError: () => void;\n  /** The focus function */\n  focus: () => void;\n  /** The get value function */\n  getValue: () => Value;\n  /** The register function */\n  register: (params?: UseFieldRegisterParams) => {\n    onBlur: () => void;\n    onChange: () => void;\n    ref: (\n      node: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | undefined\n    ) => void;\n  };\n  /** The reset function */\n  reset: () => void;\n  /** The set error function */\n  setError: (error: string) => void;\n  /** The  set value function */\n  setValue: (value: Value) => void;\n  /** The watch function */\n  watch: () => Value;\n}\n\n/**\n * @name useField\n * @description - Hook to manage a form field\n * @category State\n * @usage medium\n *\n * @template Value The input value\n * @template Type The input value type\n * @param {Value} [params.initialValue = \"\"] Initial value\n * @param {boolean} [params.initialTouched=false] Initial touched state\n * @param {boolean} [params.autoFocus=false] Auto focus\n * @param {boolean} [params.validateOnChange=false] Validate on change\n * @param {boolean} [params.validateOnBlur=false] Validate on blur\n * @param {boolean} [params.validateOnMount=false] Validate on mount\n * @returns {UseFieldReturn<Value>} An object containing input information\n *\n * @example\n * const { register, getValue, setValue, reset, dirty, error, setError, clearError, touched, focus, watch } = useField();\n */\nexport const useField = <\n  Value extends boolean | number | string = string,\n  Type = Value extends string ? string : Value extends boolean ? boolean : number\n>(\n  initialValue: Value = '' as Value,\n  options?: UseFieldOptions\n): UseFieldReturn<Type> => {\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const watchingRef = useRef(false);\n  const rerender = useRerender();\n\n  const [dirty, setDirty] = useState(false);\n  const [touched, setTouched] = useState(options?.initialTouched ?? false);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  const getValue = () => {\n    if (inputRef.current?.type === 'radio' || inputRef.current?.type === 'checkbox')\n      return inputRef.current.checked as Type;\n    return (inputRef.current?.value ?? initialValue) as Type;\n  };\n\n  const setValue = (value: Type) => {\n    if (inputRef.current?.type === 'radio' || inputRef.current?.type === 'checkbox') {\n      inputRef.current.checked = value as boolean;\n      if (watchingRef.current) return rerender();\n      return;\n    }\n\n    inputRef.current!.value = value as string;\n    if (watchingRef.current) return rerender();\n  };\n\n  const reset = () => {\n    setValue(initialValue as unknown as Type);\n    setDirty(false);\n    setTouched(false);\n    setError(undefined);\n  };\n\n  const focus = () => inputRef.current!.focus();\n\n  const validate = (params: UseFieldRegisterParams) => {\n    if (params.required && !inputRef.current!.value) {\n      return setError(params.required);\n    }\n\n    if (params.minLength && inputRef.current!.value.length < params.minLength.value) {\n      return setError(params.minLength.message);\n    }\n\n    if (params.maxLength && inputRef.current!.value.length > params.maxLength.value) {\n      return setError(params.maxLength.message);\n    }\n\n    if (params.min && Number(inputRef.current!.value) < params.min.value) {\n      return setError(params.min.message);\n    }\n\n    if (params.max && Number(inputRef.current!.value) > params.max.value) {\n      return setError(params.max.message);\n    }\n\n    if (params.pattern && !params.pattern.value.test(inputRef.current!.value)) {\n      return setError(params.pattern.message);\n    }\n\n    if (params.validate) {\n      const error = params.validate(inputRef.current!.value);\n      if (typeof error === 'string') return setError(error);\n    }\n\n    setError(undefined);\n  };\n\n  const register = (registerParams?: UseFieldRegisterParams) => ({\n    ref: (node: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | undefined) => {\n      if (!inputRef.current && node) {\n        if (options?.autoFocus) node.focus();\n        inputRef.current = node as HTMLInputElement;\n        if (inputRef.current.type === 'radio') {\n          inputRef.current.defaultChecked = initialValue === node.value;\n          return;\n        }\n        if (inputRef.current.type === 'checkbox') {\n          inputRef.current.defaultChecked = !!initialValue;\n          return;\n        }\n        inputRef.current.defaultValue = String(initialValue);\n\n        if (registerParams && options?.validateOnMount) validate(registerParams);\n      }\n    },\n    onChange: async () => {\n      if (watchingRef.current) return rerender();\n      if (inputRef.current!.value !== initialValue) setDirty(true);\n      if (dirty && inputRef.current!.value === initialValue) setDirty(false);\n      if (registerParams && options?.validateOnChange) await validate(registerParams);\n      if (registerParams && options?.validateOnBlur) setError(undefined);\n    },\n    onBlur: async () => {\n      if (registerParams && options?.validateOnBlur) await validate(registerParams);\n      setTouched(true);\n    }\n  });\n\n  const watch = () => {\n    watchingRef.current = true;\n    return getValue();\n  };\n\n  const clearError = () => setError(undefined);\n\n  return {\n    register,\n    dirty,\n    touched,\n    error,\n    setError,\n    clearError,\n    getValue,\n    setValue,\n    reset,\n    watch,\n    focus,\n    ref: inputRef\n  };\n};\n"],"names":["useField","initialValue","options","inputRef","useRef","watchingRef","rerender","useRerender","dirty","setDirty","useState","touched","setTouched","error","setError","getValue","setValue","value","reset","focus","validate","params","registerParams","node"],"mappings":";;AA0GO,MAAMA,IAAW,CAItBC,IAAsB,IACtBC,MACyB;AACzB,QAAMC,IAAWC,EAAgC,IAAI,GAC/CC,IAAcD,EAAO,EAAK,GAC1BE,IAAWC,EAAA,GAEX,CAACC,GAAOC,CAAQ,IAAIC,EAAS,EAAK,GAClC,CAACC,GAASC,CAAU,IAAIF,EAASR,GAAS,kBAAkB,EAAK,GACjE,CAACW,GAAOC,CAAQ,IAAIJ,EAA6B,MAAS,GAE1DK,IAAW,MACXZ,EAAS,SAAS,SAAS,WAAWA,EAAS,SAAS,SAAS,aAC5DA,EAAS,QAAQ,UAClBA,EAAS,SAAS,SAASF,GAG/Be,IAAW,CAACC,MAAgB;AAChC,QAAId,EAAS,SAAS,SAAS,WAAWA,EAAS,SAAS,SAAS;AAEnE,aADAA,EAAS,QAAQ,UAAUc,GACvBZ,EAAY,UAAgBC,EAAA,IAChC;AAIF,QADAH,EAAS,QAAS,QAAQc,GACtBZ,EAAY,QAAS,QAAOC,EAAA;AAAA,EAAS,GAGrCY,IAAQ,MAAM;AAClB,IAAAF,EAASf,CAA+B,GACxCQ,EAAS,EAAK,GACdG,EAAW,EAAK,GAChBE,EAAS,MAAS;AAAA,EAAA,GAGdK,IAAQ,MAAMhB,EAAS,QAAS,MAAA,GAEhCiB,IAAW,CAACC,MAAmC;AACnD,QAAIA,EAAO,YAAY,CAAClB,EAAS,QAAS;AACxC,aAAOW,EAASO,EAAO,QAAQ;AAGjC,QAAIA,EAAO,aAAalB,EAAS,QAAS,MAAM,SAASkB,EAAO,UAAU;AACxE,aAAOP,EAASO,EAAO,UAAU,OAAO;AAG1C,QAAIA,EAAO,aAAalB,EAAS,QAAS,MAAM,SAASkB,EAAO,UAAU;AACxE,aAAOP,EAASO,EAAO,UAAU,OAAO;AAG1C,QAAIA,EAAO,OAAO,OAAOlB,EAAS,QAAS,KAAK,IAAIkB,EAAO,IAAI;AAC7D,aAAOP,EAASO,EAAO,IAAI,OAAO;AAGpC,QAAIA,EAAO,OAAO,OAAOlB,EAAS,QAAS,KAAK,IAAIkB,EAAO,IAAI;AAC7D,aAAOP,EAASO,EAAO,IAAI,OAAO;AAGpC,QAAIA,EAAO,WAAW,CAACA,EAAO,QAAQ,MAAM,KAAKlB,EAAS,QAAS,KAAK;AACtE,aAAOW,EAASO,EAAO,QAAQ,OAAO;AAGxC,QAAIA,EAAO,UAAU;AACnB,YAAMR,IAAQQ,EAAO,SAASlB,EAAS,QAAS,KAAK;AACrD,UAAI,OAAOU,KAAU,SAAU,QAAOC,EAASD,CAAK;AAAA,IAAA;AAGtD,IAAAC,EAAS,MAAS;AAAA,EAAA;AAyCpB,SAAO;AAAA,IACL,UAvCe,CAACQ,OAA6C;AAAA,MAC7D,KAAK,CAACC,MAAwF;AAC5F,YAAI,CAACpB,EAAS,WAAWoB,GAAM;AAG7B,cAFIrB,GAAS,aAAWqB,EAAK,MAAA,GAC7BpB,EAAS,UAAUoB,GACfpB,EAAS,QAAQ,SAAS,SAAS;AACrC,YAAAA,EAAS,QAAQ,iBAAiBF,MAAiBsB,EAAK;AACxD;AAAA,UAAA;AAEF,cAAIpB,EAAS,QAAQ,SAAS,YAAY;AACxC,YAAAA,EAAS,QAAQ,iBAAiB,CAAC,CAACF;AACpC;AAAA,UAAA;AAEF,UAAAE,EAAS,QAAQ,eAAe,OAAOF,CAAY,GAE/CqB,KAAkBpB,GAAS,mBAAiBkB,EAASE,CAAc;AAAA,QAAA;AAAA,MACzE;AAAA,MAEF,UAAU,YAAY;AACpB,YAAIjB,EAAY,QAAS,QAAOC,EAAA;AAChC,QAAIH,EAAS,QAAS,UAAUF,OAAuB,EAAI,GACvDO,KAASL,EAAS,QAAS,UAAUF,OAAuB,EAAK,GACjEqB,KAAkBpB,GAAS,oBAAkB,MAAMkB,EAASE,CAAc,GAC1EA,KAAkBpB,GAAS,kBAAgBY,EAAS,MAAS;AAAA,MAAA;AAAA,MAEnE,QAAQ,YAAY;AAClB,QAAIQ,KAAkBpB,GAAS,kBAAgB,MAAMkB,EAASE,CAAc,GAC5EV,EAAW,EAAI;AAAA,MAAA;AAAA,IACjB;AAAA,IAYA,OAAAJ;AAAA,IACA,SAAAG;AAAA,IACA,OAAAE;AAAA,IACA,UAAAC;AAAA,IACA,YARiB,MAAMA,EAAS,MAAS;AAAA,IASzC,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,OAAAE;AAAA,IACA,OAjBY,OACZb,EAAY,UAAU,IACfU,EAAA;AAAA,IAgBP,OAAAI;AAAA,IACA,KAAKhB;AAAA,EAAA;AAET;"}
+{"version":3,"file":"useField.mjs","names":[],"sources":["../../../../src/hooks/useField/useField.ts"],"sourcesContent":["import type { RefObject } from 'react';\n\nimport { useRef, useState } from 'react';\n\nimport { useRerender } from '../useRerender/useRerender';\n\n/** The use field params type */\nexport interface UseFieldOptions {\n  /** The auto focus */\n  autoFocus?: boolean;\n  /** The initial touched */\n  initialTouched?: boolean;\n  /** The validate on blur */\n  validateOnBlur?: boolean;\n  /** The validate on mount */\n  validateOnChange?: boolean;\n  /** The validate on mount */\n  validateOnMount?: boolean;\n}\n\n/** The use field register params type */\nexport interface UseFieldRegisterParams {\n  /** The min value validation */\n  max?: {\n    value: number;\n    message: string;\n  };\n  /** The max length validation */\n  maxLength?: {\n    value: number;\n    message: string;\n  };\n  /** The max value validation */\n  min?: {\n    value: number;\n    message: string;\n  };\n  /** The min length validation */\n  minLength?: {\n    value: number;\n    message: string;\n  };\n  /** The pattern validation */\n  pattern?: {\n    value: RegExp;\n    message: string;\n  };\n  /** The required validation */\n  required?: string;\n  /** The custom validation */\n  validate?: (value: string) => string | true | Promise<string | true>;\n}\n\n/** The use field return type */\nexport interface UseFieldReturn<Value> {\n  /** The dirty state */\n  dirty: boolean;\n  /** The error state */\n  error?: string;\n  /** The input ref */\n  ref: RefObject<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null>;\n  /** The set error function */\n  touched: boolean;\n  /** The set error function */\n  clearError: () => void;\n  /** The focus function */\n  focus: () => void;\n  /** The get value function */\n  getValue: () => Value;\n  /** The register function */\n  register: (params?: UseFieldRegisterParams) => {\n    onBlur: () => void;\n    onChange: () => void;\n    ref: (\n      node: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | undefined\n    ) => void;\n  };\n  /** The reset function */\n  reset: () => void;\n  /** The set error function */\n  setError: (error: string) => void;\n  /** The  set value function */\n  setValue: (value: Value) => void;\n  /** The watch function */\n  watch: () => Value;\n}\n\n/**\n * @name useField\n * @description - Hook to manage a form field\n * @category State\n * @usage medium\n *\n * @template Value The input value\n * @template Type The input value type\n * @param {Value} [params.initialValue = \"\"] Initial value\n * @param {boolean} [params.initialTouched=false] Initial touched state\n * @param {boolean} [params.autoFocus=false] Auto focus\n * @param {boolean} [params.validateOnChange=false] Validate on change\n * @param {boolean} [params.validateOnBlur=false] Validate on blur\n * @param {boolean} [params.validateOnMount=false] Validate on mount\n * @returns {UseFieldReturn<Value>} An object containing input information\n *\n * @example\n * const { register, getValue, setValue, reset, dirty, error, setError, clearError, touched, focus, watch } = useField();\n */\nexport const useField = <\n  Value extends boolean | number | string | unknown = string,\n  Type = Value extends string ? string : Value extends boolean ? boolean : number\n>(\n  initialValue = '' as Value,\n  options?: UseFieldOptions\n): UseFieldReturn<Type> => {\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const watchingRef = useRef(false);\n  const rerender = useRerender();\n\n  const [dirty, setDirty] = useState(false);\n  const [touched, setTouched] = useState(options?.initialTouched ?? false);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  const getValue = () => {\n    if (inputRef.current?.type === 'radio' || inputRef.current?.type === 'checkbox')\n      return inputRef.current.checked as Type;\n    return (inputRef.current?.value ?? initialValue) as Type;\n  };\n\n  const setValue = (value: Type) => {\n    if (inputRef.current?.type === 'radio' || inputRef.current?.type === 'checkbox') {\n      inputRef.current.checked = value as boolean;\n      if (watchingRef.current) return rerender();\n      return;\n    }\n\n    inputRef.current!.value = value as string;\n    if (watchingRef.current) return rerender();\n  };\n\n  const reset = () => {\n    setValue(initialValue as unknown as Type);\n    setDirty(false);\n    setTouched(false);\n    setError(undefined);\n  };\n\n  const focus = () => inputRef.current!.focus();\n\n  const validate = (params: UseFieldRegisterParams) => {\n    if (params.required && !inputRef.current!.value) {\n      return setError(params.required);\n    }\n\n    if (params.min && Number(inputRef.current!.value) < params.min.value) {\n      return setError(params.min.message);\n    }\n\n    if (params.max && Number(inputRef.current!.value) > params.max.value) {\n      return setError(params.max.message);\n    }\n\n    if (params.minLength && inputRef.current!.value.length < params.minLength.value) {\n      return setError(params.minLength.message);\n    }\n\n    if (params.maxLength && inputRef.current!.value.length > params.maxLength.value) {\n      return setError(params.maxLength.message);\n    }\n\n    if (params.pattern && !params.pattern.value.test(inputRef.current!.value)) {\n      return setError(params.pattern.message);\n    }\n\n    if (params.validate) {\n      const error = params.validate(inputRef.current!.value);\n      if (typeof error === 'string') return setError(error);\n    }\n\n    setError(undefined);\n  };\n\n  const register = (registerParams?: UseFieldRegisterParams) => ({\n    ref: (node: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | undefined) => {\n      if (!inputRef.current && node) {\n        if (options?.autoFocus) node.focus();\n        inputRef.current = node as HTMLInputElement;\n        if (inputRef.current.type === 'radio') {\n          inputRef.current.defaultChecked = initialValue === node.value;\n          return;\n        }\n        if (inputRef.current.type === 'checkbox') {\n          inputRef.current.defaultChecked = !!initialValue;\n          return;\n        }\n        inputRef.current.defaultValue = String(initialValue);\n\n        if (registerParams && options?.validateOnMount) validate(registerParams);\n      }\n    },\n    onChange: async () => {\n      if (watchingRef.current) return rerender();\n      if (inputRef.current!.value !== initialValue) setDirty(true);\n      if (inputRef.current!.value === initialValue) setDirty(false);\n      if (registerParams && options?.validateOnChange) await validate(registerParams);\n      if (registerParams && options?.validateOnBlur) setError(undefined);\n    },\n    onBlur: async () => {\n      if (registerParams && options?.validateOnBlur) await validate(registerParams);\n      setTouched(true);\n    }\n  });\n\n  const watch = () => {\n    watchingRef.current = true;\n    return getValue();\n  };\n\n  const clearError = () => setError(undefined);\n\n  return {\n    register,\n    dirty,\n    touched,\n    error,\n    setError,\n    clearError,\n    getValue,\n    setValue,\n    reset,\n    watch,\n    focus,\n    ref: inputRef\n  };\n};\n"],"mappings":";;;AA0GA,IAAa,KAIX,IAAe,IACf,MACyB;CACzB,IAAM,IAAW,EAAgC,KAAK,EAChD,IAAc,EAAO,GAAM,EAC3B,IAAW,GAAa,EAExB,CAAC,GAAO,KAAY,EAAS,GAAM,EACnC,CAAC,GAAS,KAAc,EAAS,GAAS,kBAAkB,GAAM,EAClE,CAAC,GAAO,KAAY,EAA6B,KAAA,EAAU,EAE3D,UACA,EAAS,SAAS,SAAS,WAAW,EAAS,SAAS,SAAS,aAC5D,EAAS,QAAQ,UAClB,EAAS,SAAS,SAAS,GAG/B,KAAY,MAAgB;AAChC,MAAI,EAAS,SAAS,SAAS,WAAW,EAAS,SAAS,SAAS,WAGnE,QAFA,EAAS,QAAQ,UAAU,GACvB,EAAY,UAAgB,GAAU,GAC1C;AAIF,MADA,EAAS,QAAS,QAAQ,GACtB,EAAY,QAAS,QAAO,GAAU;IAGtC,UAAc;AAIlB,EAHA,EAAS,EAAgC,EACzC,EAAS,GAAM,EACf,EAAW,GAAM,EACjB,EAAS,KAAA,EAAU;IAGf,UAAc,EAAS,QAAS,OAAO,EAEvC,KAAY,MAAmC;AACnD,MAAI,EAAO,YAAY,CAAC,EAAS,QAAS,MACxC,QAAO,EAAS,EAAO,SAAS;AAGlC,MAAI,EAAO,OAAO,OAAO,EAAS,QAAS,MAAM,GAAG,EAAO,IAAI,MAC7D,QAAO,EAAS,EAAO,IAAI,QAAQ;AAGrC,MAAI,EAAO,OAAO,OAAO,EAAS,QAAS,MAAM,GAAG,EAAO,IAAI,MAC7D,QAAO,EAAS,EAAO,IAAI,QAAQ;AAGrC,MAAI,EAAO,aAAa,EAAS,QAAS,MAAM,SAAS,EAAO,UAAU,MACxE,QAAO,EAAS,EAAO,UAAU,QAAQ;AAG3C,MAAI,EAAO,aAAa,EAAS,QAAS,MAAM,SAAS,EAAO,UAAU,MACxE,QAAO,EAAS,EAAO,UAAU,QAAQ;AAG3C,MAAI,EAAO,WAAW,CAAC,EAAO,QAAQ,MAAM,KAAK,EAAS,QAAS,MAAM,CACvE,QAAO,EAAS,EAAO,QAAQ,QAAQ;AAGzC,MAAI,EAAO,UAAU;GACnB,IAAM,IAAQ,EAAO,SAAS,EAAS,QAAS,MAAM;AACtD,OAAI,OAAO,KAAU,SAAU,QAAO,EAAS,EAAM;;AAGvD,IAAS,KAAA,EAAU;;AAyCrB,QAAO;EACL,WAvCgB,OAA6C;GAC7D,MAAM,MAAwF;AAC5F,QAAI,CAAC,EAAS,WAAW,GAAM;AAG7B,SAFI,GAAS,aAAW,EAAK,OAAO,EACpC,EAAS,UAAU,GACf,EAAS,QAAQ,SAAS,SAAS;AACrC,QAAS,QAAQ,iBAAiB,MAAiB,EAAK;AACxD;;AAEF,SAAI,EAAS,QAAQ,SAAS,YAAY;AACxC,QAAS,QAAQ,iBAAiB,CAAC,CAAC;AACpC;;AAIF,KAFA,EAAS,QAAQ,eAAe,OAAO,EAAa,EAEhD,KAAkB,GAAS,mBAAiB,EAAS,EAAe;;;GAG5E,UAAU,YAAY;AACpB,QAAI,EAAY,QAAS,QAAO,GAAU;AAI1C,IAHI,EAAS,QAAS,UAAU,KAAc,EAAS,GAAK,EACxD,EAAS,QAAS,UAAU,KAAc,EAAS,GAAM,EACzD,KAAkB,GAAS,oBAAkB,MAAM,EAAS,EAAe,EAC3E,KAAkB,GAAS,kBAAgB,EAAS,KAAA,EAAU;;GAEpE,QAAQ,YAAY;AAElB,IADI,KAAkB,GAAS,kBAAgB,MAAM,EAAS,EAAe,EAC7E,EAAW,GAAK;;GAEnB;EAWC;EACA;EACA;EACA;EACA,kBARuB,EAAS,KAAA,EAAU;EAS1C;EACA;EACA;EACA,cAhBA,EAAY,UAAU,IACf,GAAU;EAgBjB;EACA,KAAK;EACN"}

package/dist/esm/hooks/useFileDialog/useFileDialog.mjs

@@ -1,33 +1,35 @@
-import { useState as g, useRef as f, useEffect as k } from "react";
-const i = {
-  multiple: !0,
-  accept: "*",
-  reset: !1
-}, R = ((...r) => {
-  const u = typeof r[0] == "function" ? r[0] : void 0, n = u ? r[0] : r[1], [a, o] = g(null), e = f(null), l = f(u);
-  l.current = u;
-  const s = () => {
-    o(null), l.current?.(null), e.current && (e.current.value = "");
-  }, m = (t) => {
-    if (!e.current) return;
-    e.current.multiple = t?.multiple ?? n?.multiple ?? i.multiple, e.current.accept = t?.accept ?? n?.accept ?? i.accept;
-    const c = t?.capture ?? n?.capture;
-    c && (e.current.capture = c), (t?.reset ?? n?.reset ?? i.reset) && s(), e.current.click();
-  };
-  return k(() => {
-    const t = () => {
-      const c = document.createElement("input");
-      return c.type = "file", c.onchange = (v) => {
-        const { files: p } = v.target;
-        o(p), l.current?.(p);
-      }, c;
-    };
-    return e.current = t(), () => {
-      e.current && e.current.remove();
-    };
-  }, []), { value: a, open: m, reset: s };
+import { useEffect as e, useRef as t, useState as n } from "react";
+//#region src/hooks/useFileDialog/useFileDialog.ts
+var r = {
+	multiple: !0,
+	accept: "*",
+	reset: !1
+}, i = ((...i) => {
+	let a = typeof i[0] == "function" ? i[0] : void 0, o = a ? i[0] : i[1], [s, c] = n(null), l = t(null), u = t(a);
+	u.current = a;
+	let d = () => {
+		c(null), u.current?.(null), l.current && (l.current.value = "");
+	};
+	return e(() => (l.current = (() => {
+		let e = document.createElement("input");
+		return e.type = "file", e.onchange = (e) => {
+			let { files: t } = e.target;
+			c(t), u.current?.(t);
+		}, e;
+	})(), () => {
+		l.current && l.current.remove();
+	}), []), {
+		value: s,
+		open: (e) => {
+			if (!l.current) return;
+			l.current.multiple = e?.multiple ?? o?.multiple ?? r.multiple, l.current.accept = e?.accept ?? o?.accept ?? r.accept;
+			let t = e?.capture ?? o?.capture;
+			t && (l.current.capture = t), (e?.reset ?? o?.reset ?? r.reset) && d(), l.current.click();
+		},
+		reset: d
+	};
 });
-export {
-  R as useFileDialog
-};
-//# sourceMappingURL=useFileDialog.mjs.map
+//#endregion
+export { i as useFileDialog };
+
+//# sourceMappingURL=useFileDialog.mjs.map

package/dist/esm/hooks/useFileDialog/useFileDialog.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useFileDialog.mjs","sources":["../../../../src/hooks/useFileDialog/useFileDialog.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useRef, useState } from 'react';\n\n/* The use file dialog options */\nexport interface UseFileDialogOptions extends Pick<ComponentProps<'input'>, 'accept' | 'multiple'> {\n  /** The capture value */\n  capture?: string;\n  /** The reset value */\n  reset?: boolean;\n}\n\nconst DEFAULT_OPTIONS = {\n  multiple: true,\n  accept: '*',\n  reset: false\n} satisfies UseFileDialogOptions;\n\n/* The use file dialog return type */\nexport interface UseFileDialogReturn {\n  /** The selected files */\n  value: FileList | null;\n  /** The open function */\n  open: (openParams?: UseFileDialogOptions) => void;\n  /** The reset function */\n  reset: () => void;\n}\n\nexport interface UseFileDialog {\n  (\n    callback?: (value: FileList | null) => void,\n    options?: UseFileDialogOptions\n  ): UseFileDialogReturn;\n\n  (options?: UseFileDialogOptions, callback?: never): UseFileDialogReturn;\n}\n\n/**\n * @name useFileDialog\n * @description - Hook to handle file input\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {(value: FileList | null) => void} callback The callback to execute when a file is selected\n * @param {boolean} [options.multiple=true] Whether multiple files can be selected\n * @param {string} [options.accept='*'] The accepted file types\n * @param {boolean} [options.reset=false] Whether the input should be reset when the callback is called\n * @param {string} [options.capture] The capture value\n * @returns {UseFileDialogReturn} An object containing the selected files\n *\n * @example\n * const { values, open, reset } = useFileDialog((value) => console.log(value));\n *\n * @overload\n * @param {boolean} [options.multiple=true] Whether multiple files can be selected\n * @param {string} [options.accept='*'] The accepted file types\n * @param {boolean} [options.reset=false] Whether the input should be reset when the callback is called\n * @param {string} [options.capture] The capture value\n * @returns {UseFileDialogReturn} An object containing the selected files\n *\n * @example\n * const { values, open, reset } = useFileDialog({ accept: 'image/*' });\n */\nexport const useFileDialog = ((...params: any[]) => {\n  const callback = (typeof params[0] === 'function' ? params[0] : undefined) as\n    | ((value: FileList | null) => void)\n    | undefined;\n  const options = (callback ? params[0] : params[1]) as UseFileDialogOptions | undefined;\n\n  const [value, setValue] = useState<FileList | null>(null);\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  const reset = () => {\n    setValue(null);\n    internalCallbackRef.current?.(null);\n    if (inputRef.current) inputRef.current.value = '';\n  };\n\n  const open = (openParams?: UseFileDialogOptions) => {\n    if (!inputRef.current) return;\n\n    inputRef.current.multiple =\n      openParams?.multiple ?? options?.multiple ?? DEFAULT_OPTIONS.multiple;\n    inputRef.current.accept = openParams?.accept ?? options?.accept ?? DEFAULT_OPTIONS.accept;\n\n    const capture = openParams?.capture ?? options?.capture;\n    if (capture) inputRef.current.capture = capture;\n\n    if (openParams?.reset ?? options?.reset ?? DEFAULT_OPTIONS.reset) reset();\n\n    inputRef.current.click();\n  };\n\n  useEffect(() => {\n    const init = () => {\n      const input = document.createElement('input');\n      input.type = 'file';\n\n      input.onchange = (event: Event) => {\n        const { files } = event.target as HTMLInputElement;\n        setValue(files);\n        internalCallbackRef.current?.(files);\n      };\n      return input;\n    };\n\n    inputRef.current = init();\n    return () => {\n      if (!inputRef.current) return;\n      inputRef.current.remove();\n    };\n  }, []);\n\n  return { value, open, reset };\n}) as UseFileDialog;\n"],"names":["DEFAULT_OPTIONS","useFileDialog","params","callback","options","value","setValue","useState","inputRef","useRef","internalCallbackRef","reset","open","openParams","capture","useEffect","init","input","event","files"],"mappings":";AAYA,MAAMA,IAAkB;AAAA,EACtB,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AACT,GAgDaC,KAAiB,IAAIC,MAAkB;AAClD,QAAMC,IAAY,OAAOD,EAAO,CAAC,KAAM,aAAaA,EAAO,CAAC,IAAI,QAG1DE,IAAWD,IAAWD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAE1C,CAACG,GAAOC,CAAQ,IAAIC,EAA0B,IAAI,GAClDC,IAAWC,EAAgC,IAAI,GAC/CC,IAAsBD,EAAON,CAAQ;AAC3C,EAAAO,EAAoB,UAAUP;AAE9B,QAAMQ,IAAQ,MAAM;AAClB,IAAAL,EAAS,IAAI,GACbI,EAAoB,UAAU,IAAI,GAC9BF,EAAS,YAASA,EAAS,QAAQ,QAAQ;AAAA,EAAA,GAG3CI,IAAO,CAACC,MAAsC;AAClD,QAAI,CAACL,EAAS,QAAS;AAEvB,IAAAA,EAAS,QAAQ,WACfK,GAAY,YAAYT,GAAS,YAAYJ,EAAgB,UAC/DQ,EAAS,QAAQ,SAASK,GAAY,UAAUT,GAAS,UAAUJ,EAAgB;AAEnF,UAAMc,IAAUD,GAAY,WAAWT,GAAS;AAChD,IAAIU,MAASN,EAAS,QAAQ,UAAUM,KAEpCD,GAAY,SAAST,GAAS,SAASJ,EAAgB,UAAOW,EAAA,GAElEH,EAAS,QAAQ,MAAA;AAAA,EAAM;AAGzB,SAAAO,EAAU,MAAM;AACd,UAAMC,IAAO,MAAM;AACjB,YAAMC,IAAQ,SAAS,cAAc,OAAO;AAC5C,aAAAA,EAAM,OAAO,QAEbA,EAAM,WAAW,CAACC,MAAiB;AACjC,cAAM,EAAE,OAAAC,MAAUD,EAAM;AACxB,QAAAZ,EAASa,CAAK,GACdT,EAAoB,UAAUS,CAAK;AAAA,MAAA,GAE9BF;AAAA,IAAA;AAGT,WAAAT,EAAS,UAAUQ,EAAA,GACZ,MAAM;AACX,MAAKR,EAAS,WACdA,EAAS,QAAQ,OAAA;AAAA,IAAO;AAAA,EAC1B,GACC,EAAE,GAEE,EAAE,OAAAH,GAAO,MAAAO,GAAM,OAAAD,EAAA;AACxB;"}
+{"version":3,"file":"useFileDialog.mjs","names":[],"sources":["../../../../src/hooks/useFileDialog/useFileDialog.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useRef, useState } from 'react';\n\n/* The use file dialog options */\nexport interface UseFileDialogOptions extends Pick<ComponentProps<'input'>, 'accept' | 'multiple'> {\n  /** The capture value */\n  capture?: string;\n  /** The reset value */\n  reset?: boolean;\n}\n\nconst DEFAULT_OPTIONS = {\n  multiple: true,\n  accept: '*',\n  reset: false\n} satisfies UseFileDialogOptions;\n\n/* The use file dialog return type */\nexport interface UseFileDialogReturn {\n  /** The selected files */\n  value: FileList | null;\n  /** The open function */\n  open: (openParams?: UseFileDialogOptions) => void;\n  /** The reset function */\n  reset: () => void;\n}\n\nexport interface UseFileDialog {\n  (\n    callback?: (value: FileList | null) => void,\n    options?: UseFileDialogOptions\n  ): UseFileDialogReturn;\n\n  (options?: UseFileDialogOptions, callback?: never): UseFileDialogReturn;\n}\n\n/**\n * @name useFileDialog\n * @description - Hook to handle file input\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {(value: FileList | null) => void} callback The callback to execute when a file is selected\n * @param {boolean} [options.multiple=true] Whether multiple files can be selected\n * @param {string} [options.accept='*'] The accepted file types\n * @param {boolean} [options.reset=false] Whether the input should be reset when the callback is called\n * @param {string} [options.capture] The capture value\n * @returns {UseFileDialogReturn} An object containing the selected files\n *\n * @example\n * const { values, open, reset } = useFileDialog((value) => console.log(value));\n *\n * @overload\n * @param {boolean} [options.multiple=true] Whether multiple files can be selected\n * @param {string} [options.accept='*'] The accepted file types\n * @param {boolean} [options.reset=false] Whether the input should be reset when the callback is called\n * @param {string} [options.capture] The capture value\n * @returns {UseFileDialogReturn} An object containing the selected files\n *\n * @example\n * const { values, open, reset } = useFileDialog({ accept: 'image/*' });\n */\nexport const useFileDialog = ((...params: any[]) => {\n  const callback = (typeof params[0] === 'function' ? params[0] : undefined) as\n    | ((value: FileList | null) => void)\n    | undefined;\n  const options = (callback ? params[0] : params[1]) as UseFileDialogOptions | undefined;\n\n  const [value, setValue] = useState<FileList | null>(null);\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  const reset = () => {\n    setValue(null);\n    internalCallbackRef.current?.(null);\n    if (inputRef.current) inputRef.current.value = '';\n  };\n\n  const open = (openParams?: UseFileDialogOptions) => {\n    if (!inputRef.current) return;\n\n    inputRef.current.multiple =\n      openParams?.multiple ?? options?.multiple ?? DEFAULT_OPTIONS.multiple;\n    inputRef.current.accept = openParams?.accept ?? options?.accept ?? DEFAULT_OPTIONS.accept;\n\n    const capture = openParams?.capture ?? options?.capture;\n    if (capture) inputRef.current.capture = capture;\n\n    if (openParams?.reset ?? options?.reset ?? DEFAULT_OPTIONS.reset) reset();\n\n    inputRef.current.click();\n  };\n\n  useEffect(() => {\n    const init = () => {\n      const input = document.createElement('input');\n      input.type = 'file';\n\n      input.onchange = (event: Event) => {\n        const { files } = event.target as HTMLInputElement;\n        setValue(files);\n        internalCallbackRef.current?.(files);\n      };\n      return input;\n    };\n\n    inputRef.current = init();\n    return () => {\n      if (!inputRef.current) return;\n      inputRef.current.remove();\n    };\n  }, []);\n\n  return { value, open, reset };\n}) as UseFileDialog;\n"],"mappings":";;AAYA,IAAM,IAAkB;CACtB,UAAU;CACV,QAAQ;CACR,OAAO;CACR,EAgDY,MAAkB,GAAG,MAAkB;CAClD,IAAM,IAAY,OAAO,EAAO,MAAO,aAAa,EAAO,KAAK,KAAA,GAG1D,IAAW,IAAW,EAAO,KAAK,EAAO,IAEzC,CAAC,GAAO,KAAY,EAA0B,KAAK,EACnD,IAAW,EAAgC,KAAK,EAChD,IAAsB,EAAO,EAAS;AAC5C,GAAoB,UAAU;CAE9B,IAAM,UAAc;AAGlB,EAFA,EAAS,KAAK,EACd,EAAoB,UAAU,KAAK,EAC/B,EAAS,YAAS,EAAS,QAAQ,QAAQ;;AAsCjD,QApBA,SAaE,EAAS,iBAZU;EACjB,IAAM,IAAQ,SAAS,cAAc,QAAQ;AAQ7C,SAPA,EAAM,OAAO,QAEb,EAAM,YAAY,MAAiB;GACjC,IAAM,EAAE,aAAU,EAAM;AAExB,GADA,EAAS,EAAM,EACf,EAAoB,UAAU,EAAM;KAE/B;KAGgB,QACZ;AACN,IAAS,WACd,EAAS,QAAQ,QAAQ;KAE1B,EAAE,CAAC,EAEC;EAAE;EAAO,OAnCF,MAAsC;AAClD,OAAI,CAAC,EAAS,QAAS;AAIvB,GAFA,EAAS,QAAQ,WACf,GAAY,YAAY,GAAS,YAAY,EAAgB,UAC/D,EAAS,QAAQ,SAAS,GAAY,UAAU,GAAS,UAAU,EAAgB;GAEnF,IAAM,IAAU,GAAY,WAAW,GAAS;AAKhD,GAJI,MAAS,EAAS,QAAQ,UAAU,KAEpC,GAAY,SAAS,GAAS,SAAS,EAAgB,UAAO,GAAO,EAEzE,EAAS,QAAQ,OAAO;;EAuBJ;EAAO"}

package/dist/esm/hooks/useFileSystemAccess/useFileSystemAccess.mjs

@@ -0,0 +1,59 @@
+import { useRef as e, useState as t } from "react";
+//#region src/hooks/useFileSystemAccess/useFileSystemAccess.ts
+var n = ((n = {}) => {
+	let r = typeof window < "u" && "showOpenFilePicker" in window && "showSaveFilePicker" in window && typeof window.showOpenFilePicker == "function" && typeof window.showSaveFilePicker == "function", i = n.dataType ?? "Text", a = e(void 0), [o, s] = t(), [c, l] = t(), u = async () => {
+		let e = a.current;
+		if (!e) return;
+		let t = await e.getFile();
+		if (l(t), i === "Text") return s(await t.text());
+		if (i === "ArrayBuffer") return s(await t.arrayBuffer());
+		if (i === "Blob") return s(t);
+		throw Error(`Invalid data type: ${i}`);
+	}, d = async (e) => {
+		if (!r) return;
+		let [t] = await window.showOpenFilePicker({
+			...n,
+			...e
+		});
+		a.current = t, await u();
+	}, f = async (e = {}) => {
+		r && (a.current = await window.showSaveFilePicker({
+			...n,
+			...e
+		}), s(void 0), await u());
+	}, p = async (e) => {
+		if (!r) return;
+		a.current = await window.showSaveFilePicker({
+			...n,
+			...e
+		});
+		let t = await a.current.createWritable();
+		await t.write(o), await t.close(), await u();
+	};
+	return {
+		supported: r,
+		data: o,
+		file: c,
+		name: c?.name ?? "",
+		type: c?.type ?? "",
+		size: c?.size ?? 0,
+		lastModified: c?.lastModified ?? 0,
+		open: d,
+		set: (e) => s(e),
+		create: f,
+		save: async (e) => {
+			if (!r) return;
+			if (!a.current) return p(e);
+			let t = await a.current.createWritable();
+			await t.write(o), await t.close(), await u();
+		},
+		saveAs: p,
+		update: async () => {
+			await u();
+		}
+	};
+});
+//#endregion
+export { n as useFileSystemAccess };
+
+//# sourceMappingURL=useFileSystemAccess.mjs.map

package/dist/esm/hooks/useFileSystemAccess/useFileSystemAccess.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileSystemAccess.mjs","names":[],"sources":["../../../../src/hooks/useFileSystemAccess/useFileSystemAccess.ts"],"sourcesContent":["import { useRef, useState } from 'react';\n\nexport interface FileSystemAccessShowOpenFileOptions {\n  excludeAcceptAllOption?: boolean;\n  multiple?: boolean;\n  types?: Array<{\n    description?: string;\n    accept: Record<string, string[]>;\n  }>;\n}\n\nexport interface FileSystemAccessShowSaveFileOptions {\n  excludeAcceptAllOption?: boolean;\n  suggestedName?: string;\n  types?: Array<{\n    description?: string;\n    accept: Record<string, string[]>;\n  }>;\n}\n\nexport interface FileSystemFileHandle {\n  createWritable: () => Promise<FileSystemWritableFileStream>;\n  getFile: () => Promise<File>;\n}\n\nexport interface FileSystemWritableFileStream extends WritableStream {\n  write: FileSystemWritableFileStreamWrite;\n  seek: (position: number) => Promise<void>;\n  truncate: (size: number) => Promise<void>;\n}\n\nexport interface FileSystemWritableFileStreamWrite {\n  (data: string | Blob | BufferSource): Promise<void>;\n  (options: { type: 'write'; position: number; data: string | Blob | BufferSource }): Promise<void>;\n  (options: { type: 'seek'; position: number }): Promise<void>;\n  (options: { type: 'truncate'; size: number }): Promise<void>;\n}\n\ndeclare global {\n  interface Window {\n    readonly showOpenFilePicker: (\n      options?: FileSystemAccessShowOpenFileOptions\n    ) => Promise<FileSystemFileHandle[]>;\n    readonly showSaveFilePicker: (\n      options?: FileSystemAccessShowSaveFileOptions\n    ) => Promise<FileSystemFileHandle>;\n  }\n}\n\n/** The use file system access common options type */\nexport type UseFileSystemAccessCommonOptions = Pick<\n  FileSystemAccessShowOpenFileOptions,\n  'excludeAcceptAllOption' | 'types'\n>;\n\n/** The use file system access show save options type */\nexport type UseFileSystemAccessShowSaveOptions = Pick<\n  FileSystemAccessShowSaveFileOptions,\n  'suggestedName'\n>;\n\n/** The use file system access options type */\nexport type UseFileSystemAccessOptions = UseFileSystemAccessCommonOptions & {\n  dataType?: 'ArrayBuffer' | 'Blob' | 'Text';\n};\n\n/** The use file system access return type */\nexport interface UseFileSystemAccessReturn<Data = string | ArrayBuffer | Blob> {\n  /** Last read data */\n  data?: Data;\n  /** Current file */\n  file?: File;\n  /** Last modified timestamp */\n  lastModified: number;\n  /** File base name */\n  name: string;\n  /** Size in bytes */\n  size: number;\n  /** Whether the File System Access API is available */\n  supported: boolean;\n  /** MIME type */\n  type: string;\n  /** Create a new file via save picker */\n  create: (createOptions?: UseFileSystemAccessShowSaveOptions) => Promise<void>;\n  /** Open an existing file */\n  open: (openOptions?: UseFileSystemAccessCommonOptions) => Promise<void>;\n  /** Save to the current handle, or prompt with {@link saveAs} if none */\n  save: (saveOptions?: UseFileSystemAccessShowSaveOptions) => Promise<void>;\n  /** Always prompt for a file path then save */\n  saveAs: (saveOptions?: UseFileSystemAccessShowSaveOptions) => Promise<void>;\n  /** Set the data */\n  set: (data: Data) => void;\n  /** Re-read data from the current handle using `dataType` */\n  update: () => Promise<void>;\n}\n\nexport interface UseFileSystemAccess {\n  (): UseFileSystemAccessReturn<string | ArrayBuffer | Blob>;\n  (\n    options: UseFileSystemAccessOptions & { dataType: 'ArrayBuffer' }\n  ): UseFileSystemAccessReturn<ArrayBuffer>;\n  (options: UseFileSystemAccessOptions & { dataType: 'Blob' }): UseFileSystemAccessReturn<Blob>;\n  (options: UseFileSystemAccessOptions & { dataType: 'Text' }): UseFileSystemAccessReturn<string>;\n  (options?: UseFileSystemAccessOptions): UseFileSystemAccessReturn<string | ArrayBuffer | Blob>;\n}\n\n/**\n * @name useFileSystemAccess\n * @description - Hook for reading and writing local files via the File System Access API\n * @category Browser\n * @usage low\n *\n * @browserapi File System Access API https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API\n *\n * @overload\n * @returns {UseFileSystemAccessReturn<string | ArrayBuffer | Blob>}\n *\n * @overload\n * @param {UseFileSystemAccessOptions} [options]\n * @returns {UseFileSystemAccessReturn}\n *\n * @example\n * const fileSystemAccess = useFileSystemAccess({ dataType: 'Text' });\n */\nexport const useFileSystemAccess = ((\n  options: UseFileSystemAccessOptions = {}\n): UseFileSystemAccessReturn<string | ArrayBuffer | Blob> => {\n  const supported =\n    typeof window !== 'undefined' &&\n    'showOpenFilePicker' in window &&\n    'showSaveFilePicker' in window &&\n    typeof window.showOpenFilePicker === 'function' &&\n    typeof window.showSaveFilePicker === 'function';\n\n  const dataType = options.dataType ?? 'Text';\n\n  const handleRef = useRef<FileSystemFileHandle>(undefined);\n\n  const [data, setData] = useState<string | ArrayBuffer | Blob>();\n  const [file, setFile] = useState<File>();\n\n  const load = async () => {\n    const handle = handleRef.current;\n    if (!handle) return;\n    const file = await handle.getFile();\n    setFile(file);\n\n    if (dataType === 'Text') return setData(await file.text());\n    if (dataType === 'ArrayBuffer') return setData(await file.arrayBuffer());\n    if (dataType === 'Blob') return setData(file);\n    throw new Error(`Invalid data type: ${dataType}`);\n  };\n\n  const open = async (params?: UseFileSystemAccessCommonOptions) => {\n    if (!supported) return;\n    const [handle] = await window.showOpenFilePicker({\n      ...options,\n      ...params\n    });\n    handleRef.current = handle;\n    await load();\n  };\n\n  const create = async (params: UseFileSystemAccessShowSaveOptions = {}) => {\n    if (!supported) return;\n    handleRef.current = await window.showSaveFilePicker({\n      ...options,\n      ...params\n    });\n    setData(undefined);\n    await load();\n  };\n\n  const saveAs = async (params?: UseFileSystemAccessShowSaveOptions) => {\n    if (!supported) return;\n\n    handleRef.current = await window.showSaveFilePicker({\n      ...options,\n      ...params\n    });\n\n    const writable = await handleRef.current.createWritable();\n    await writable.write(data as Blob | BufferSource);\n    await writable.close();\n\n    await load();\n  };\n\n  const save = async (params?: UseFileSystemAccessShowSaveOptions) => {\n    if (!supported) return;\n\n    if (!handleRef.current) return saveAs(params);\n\n    const writable = await handleRef.current.createWritable();\n    await writable.write(data as Blob | BufferSource);\n    await writable.close();\n\n    await load();\n  };\n\n  const update = async () => {\n    await load();\n  };\n\n  const set = (data: string | ArrayBuffer | Blob) => setData(data);\n\n  return {\n    supported,\n    data,\n    file,\n    name: file?.name ?? '',\n    type: file?.type ?? '',\n    size: file?.size ?? 0,\n    lastModified: file?.lastModified ?? 0,\n    open,\n    set,\n    create,\n    save,\n    saveAs,\n    update\n  };\n}) as UseFileSystemAccess;\n"],"mappings":";;AA4HA,IAAa,MACX,IAAsC,EAAE,KACmB;CAC3D,IAAM,IACJ,OAAO,SAAW,OAClB,wBAAwB,UACxB,wBAAwB,UACxB,OAAO,OAAO,sBAAuB,cACrC,OAAO,OAAO,sBAAuB,YAEjC,IAAW,EAAQ,YAAY,QAE/B,IAAY,EAA6B,KAAA,EAAU,EAEnD,CAAC,GAAM,KAAW,GAAuC,EACzD,CAAC,GAAM,KAAW,GAAgB,EAElC,IAAO,YAAY;EACvB,IAAM,IAAS,EAAU;AACzB,MAAI,CAAC,EAAQ;EACb,IAAM,IAAO,MAAM,EAAO,SAAS;AAGnC,MAFA,EAAQ,EAAK,EAET,MAAa,OAAQ,QAAO,EAAQ,MAAM,EAAK,MAAM,CAAC;AAC1D,MAAI,MAAa,cAAe,QAAO,EAAQ,MAAM,EAAK,aAAa,CAAC;AACxE,MAAI,MAAa,OAAQ,QAAO,EAAQ,EAAK;AAC7C,QAAU,MAAM,sBAAsB,IAAW;IAG7C,IAAO,OAAO,MAA8C;AAChE,MAAI,CAAC,EAAW;EAChB,IAAM,CAAC,KAAU,MAAM,OAAO,mBAAmB;GAC/C,GAAG;GACH,GAAG;GACJ,CAAC;AAEF,EADA,EAAU,UAAU,GACpB,MAAM,GAAM;IAGR,IAAS,OAAO,IAA6C,EAAE,KAAK;AACnE,QACL,EAAU,UAAU,MAAM,OAAO,mBAAmB;GAClD,GAAG;GACH,GAAG;GACJ,CAAC,EACF,EAAQ,KAAA,EAAU,EAClB,MAAM,GAAM;IAGR,IAAS,OAAO,MAAgD;AACpE,MAAI,CAAC,EAAW;AAEhB,IAAU,UAAU,MAAM,OAAO,mBAAmB;GAClD,GAAG;GACH,GAAG;GACJ,CAAC;EAEF,IAAM,IAAW,MAAM,EAAU,QAAQ,gBAAgB;AAIzD,EAHA,MAAM,EAAS,MAAM,EAA4B,EACjD,MAAM,EAAS,OAAO,EAEtB,MAAM,GAAM;;AAqBd,QAAO;EACL;EACA;EACA;EACA,MAAM,GAAM,QAAQ;EACpB,MAAM,GAAM,QAAQ;EACpB,MAAM,GAAM,QAAQ;EACpB,cAAc,GAAM,gBAAgB;EACpC;EACA,MAXW,MAAsC,EAAQ,EAAK;EAY9D;EACA,MA7BW,OAAO,MAAgD;AAClE,OAAI,CAAC,EAAW;AAEhB,OAAI,CAAC,EAAU,QAAS,QAAO,EAAO,EAAO;GAE7C,IAAM,IAAW,MAAM,EAAU,QAAQ,gBAAgB;AAIzD,GAHA,MAAM,EAAS,MAAM,EAA4B,EACjD,MAAM,EAAS,OAAO,EAEtB,MAAM,GAAM;;EAqBZ;EACA,QAnBa,YAAY;AACzB,SAAM,GAAM;;EAmBb"}

package/dist/esm/hooks/useFocus/useFocus.mjs

@@ -1,35 +1,44 @@
-import { useState as R, useRef as F, useEffect as g } from "react";
-import { useRefState as L } from "../useRefState/useRefState.mjs";
-import { isTarget as l } from "../../utils/helpers/isTarget.mjs";
-const S = ((...e) => {
-  const t = l(e[0]) ? e[0] : void 0, o = t ? typeof e[1] == "object" ? e[1] : { onFocus: e[1] } : typeof e[0] == "object" ? e[0] : { onFocus: e[0] }, b = o?.enabled ?? !0, d = o?.initialValue ?? !1, [a, u] = R(d), c = L(), f = F(o);
-  f.current = o;
-  const r = F(null), i = () => {
-    r.current && (r.current.focus(), u(!0));
-  }, v = () => {
-    r.current && (r.current.blur(), u(!1));
-  };
-  return g(() => {
-    if (!b || !t && !c.state) return;
-    const n = t ? l.getElement(t) : c.current;
-    if (!n) return;
-    r.current = n;
-    const E = (s) => {
-      f.current?.onFocus?.(s), (!i || s.target.matches?.(":focus-visible")) && u(!0);
-    }, m = (s) => {
-      f.current?.onBlur?.(s), u(!1);
-    };
-    return d && n.focus(), n.addEventListener("focus", E), n.addEventListener("blur", m), () => {
-      n.removeEventListener("focus", E), n.removeEventListener("blur", m);
-    };
-  }, [t && l.getRawElement(t), c.state, b]), t ? { focus: i, blur: v, focused: a } : {
-    ref: c,
-    focus: i,
-    blur: v,
-    focused: a
-  };
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useRef as r, useState as i } from "react";
+//#region src/hooks/useFocus/useFocus.ts
+var a = ((...a) => {
+	let o = e(a[0]) ? a[0] : void 0, s = o ? typeof a[1] == "object" ? a[1] : { onFocus: a[1] } : typeof a[0] == "object" ? a[0] : { onFocus: a[0] }, c = s?.enabled ?? !0, l = s?.initialValue ?? !1, [u, d] = i(l), f = t(), p = r(s);
+	p.current = s;
+	let m = r(null), h = () => {
+		m.current && (m.current.focus(), d(!0));
+	}, g = () => {
+		m.current && (m.current.blur(), d(!1));
+	};
+	return n(() => {
+		if (!c || !o && !f.state) return;
+		let t = o ? e.getElement(o) : f.current;
+		if (!t) return;
+		m.current = t;
+		let n = (e) => {
+			p.current?.onFocus?.(e), (!h || e.target.matches?.(":focus-visible")) && d(!0);
+		}, r = (e) => {
+			p.current?.onBlur?.(e), d(!1);
+		};
+		return l && t.focus(), t.addEventListener("focus", n), t.addEventListener("blur", r), () => {
+			t.removeEventListener("focus", n), t.removeEventListener("blur", r);
+		};
+	}, [
+		o && e.getRawElement(o),
+		f.state,
+		c
+	]), o ? {
+		focus: h,
+		blur: g,
+		focused: u
+	} : {
+		ref: f,
+		focus: h,
+		blur: g,
+		focused: u
+	};
 });
-export {
-  S as useFocus
-};
-//# sourceMappingURL=useFocus.mjs.map
+//#endregion
+export { a as useFocus };
+
+//# sourceMappingURL=useFocus.mjs.map

package/dist/esm/hooks/useFocus/useFocus.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useFocus.mjs","sources":["../../../../src/hooks/useFocus/useFocus.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use focus options type */\nexport interface UseFocusOptions {\n  /** The enabled state of the focus hook */\n  enabled?: boolean;\n  /** The initial focus state of the target */\n  initialValue?: boolean;\n  /** The on blur callback */\n  onBlur?: (event: FocusEvent) => void;\n  /** The on focus callback */\n  onFocus?: (event: FocusEvent) => void;\n}\n\n/** The use focus return type */\nexport interface UseFocusReturn {\n  /** The boolean state value of the target */\n  focused: boolean;\n  /** Blur the target */\n  blur: () => void;\n  /** Focus the target */\n  focus: () => void;\n}\n\nexport interface UseFocus {\n  (target: HookTarget, callback?: (event: FocusEvent) => void): UseFocusReturn;\n\n  (target: HookTarget, options?: UseFocusOptions): UseFocusReturn;\n\n  <Target extends Element>(\n    callback?: (event: FocusEvent) => void,\n    target?: never\n  ): UseFocusReturn & { ref: StateRef<Target> };\n\n  <Target extends Element>(\n    options?: UseFocusOptions,\n    target?: never\n  ): UseFocusReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useFocus\n * @description - Hook that allows you to focus on a specific element\n * @category Elements\n * @usage medium\n *\n * @overload\n * @param {HookTarget} target The target element to focus\n * @param {(event: FocusEvent) => void} [callback] The callback function to be invoked on focus\n * @returns {UseFocusReturn} An object with focus state and methods\n *\n * @example\n * const { focus, blur, focused } = useFocus(ref, () => console.log('focused'));\n *\n * @overload\n * @param {HookTarget} target The target element to focus\n * @param {boolean} [options.enabled=true] The enabled state of the focus hook\n * @param {boolean} [options.initialValue=false] The initial focus state of the target\n * @param {(event: FocusEvent) => void} [options.onFocus] The callback function to be invoked on focus\n * @param {(event: FocusEvent) => void} [options.onBlur] The callback function to be invoked on blur\n * @returns {UseFocusReturn} An object with focus state and methods\n *\n * @example\n * const { focus, blur, focused } = useFocus(ref);\n *\n * @overload\n * @template Target The target element\n * @param {(event: FocusEvent) => void} [callback] The callback function to be invoked on focus\n * @returns {UseFocusReturn & { ref: StateRef<Target> }} An object with focus state, methods and ref\n *\n * @example\n * const { ref, focus, blur, focused } = useFocus(() => console.log('focused'));\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The enabled state of the focus hook\n * @param {boolean} [options.initialValue=false] The initial focus state of the target\n * @param {(event: FocusEvent) => void} [options.onFocus] The callback function to be invoked on focus\n * @param {(event: FocusEvent) => void} [options.onBlur] The callback function to be invoked on blur\n * @returns {UseFocusReturn & { ref: StateRef<Target> }} An object with focus state, methods and ref\n *\n * @example\n * const { ref, focus, blur, focused } = useFocus();\n */\nexport const useFocus = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onFocus: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onFocus: params[0] }\n  ) as UseFocusOptions | undefined;\n  const enabled = options?.enabled ?? true;\n  const initialValue = options?.initialValue ?? false;\n\n  const [focused, setFocused] = useState(initialValue);\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  const elementRef = useRef<HTMLElement | null>(null);\n\n  const focus = () => {\n    if (!elementRef.current) return;\n    elementRef.current.focus();\n    setFocused(true);\n  };\n\n  const blur = () => {\n    if (!elementRef.current) return;\n    elementRef.current.blur();\n    setFocused(false);\n  };\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n    const element = (target ? isTarget.getElement(target) : internalRef.current) as HTMLElement;\n    if (!element) return;\n\n    elementRef.current = element;\n\n    const onFocus = (event: FocusEvent) => {\n      internalOptionsRef.current?.onFocus?.(event);\n      if (!focus || (event.target as HTMLElement).matches?.(':focus-visible')) setFocused(true);\n    };\n\n    const onBlur = (event: FocusEvent) => {\n      internalOptionsRef.current?.onBlur?.(event);\n      setFocused(false);\n    };\n\n    if (initialValue) element.focus();\n\n    element.addEventListener('focus', onFocus);\n    element.addEventListener('blur', onBlur);\n\n    return () => {\n      element.removeEventListener('focus', onFocus);\n      element.removeEventListener('blur', onBlur);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state, enabled]);\n\n  if (target) return { focus, blur, focused };\n  return {\n    ref: internalRef,\n    focus,\n    blur,\n    focused\n  };\n}) as UseFocus;\n"],"names":["useFocus","params","target","isTarget","options","enabled","initialValue","focused","setFocused","useState","internalRef","useRefState","internalOptionsRef","useRef","elementRef","focus","blur","useEffect","element","onFocus","event","onBlur"],"mappings":";;;AA4FO,MAAMA,KAAY,IAAIC,MAAkB;AAC7C,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAE5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,SAASA,EAAO,CAAC,EAAA,IACrB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,SAASA,EAAO,CAAC,EAAA,GAErBI,IAAUD,GAAS,WAAW,IAC9BE,IAAeF,GAAS,gBAAgB,IAExC,CAACG,GAASC,CAAU,IAAIC,EAASH,CAAY,GAC7CI,IAAcC,EAAA,GACdC,IAAqBC,EAAOT,CAAO;AACzC,EAAAQ,EAAmB,UAAUR;AAE7B,QAAMU,IAAaD,EAA2B,IAAI,GAE5CE,IAAQ,MAAM;AAClB,IAAKD,EAAW,YAChBA,EAAW,QAAQ,MAAA,GACnBN,EAAW,EAAI;AAAA,EAAA,GAGXQ,IAAO,MAAM;AACjB,IAAKF,EAAW,YAChBA,EAAW,QAAQ,KAAA,GACnBN,EAAW,EAAK;AAAA,EAAA;AA+BlB,SA5BAS,EAAU,MAAM;AACd,QAAI,CAACZ,KAAY,CAACH,KAAU,CAACQ,EAAY,MAAQ;AACjD,UAAMQ,IAAWhB,IAASC,EAAS,WAAWD,CAAM,IAAIQ,EAAY;AACpE,QAAI,CAACQ,EAAS;AAEd,IAAAJ,EAAW,UAAUI;AAErB,UAAMC,IAAU,CAACC,MAAsB;AACrC,MAAAR,EAAmB,SAAS,UAAUQ,CAAK,IACvC,CAACL,KAAUK,EAAM,OAAuB,UAAU,gBAAgB,QAAc,EAAI;AAAA,IAAA,GAGpFC,IAAS,CAACD,MAAsB;AACpC,MAAAR,EAAmB,SAAS,SAASQ,CAAK,GAC1CZ,EAAW,EAAK;AAAA,IAAA;AAGlB,WAAIF,OAAsB,MAAA,GAE1BY,EAAQ,iBAAiB,SAASC,CAAO,GACzCD,EAAQ,iBAAiB,QAAQG,CAAM,GAEhC,MAAM;AACX,MAAAH,EAAQ,oBAAoB,SAASC,CAAO,GAC5CD,EAAQ,oBAAoB,QAAQG,CAAM;AAAA,IAAA;AAAA,EAC5C,GACC,CAACnB,KAAUC,EAAS,cAAcD,CAAM,GAAGQ,EAAY,OAAOL,CAAO,CAAC,GAErEH,IAAe,EAAE,OAAAa,GAAO,MAAAC,GAAM,SAAAT,EAAA,IAC3B;AAAA,IACL,KAAKG;AAAA,IACL,OAAAK;AAAA,IACA,MAAAC;AAAA,IACA,SAAAT;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useFocus.mjs","names":[],"sources":["../../../../src/hooks/useFocus/useFocus.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use focus options type */\nexport interface UseFocusOptions {\n  /** The enabled state of the focus hook */\n  enabled?: boolean;\n  /** The initial focus state of the target */\n  initialValue?: boolean;\n  /** The on blur callback */\n  onBlur?: (event: FocusEvent) => void;\n  /** The on focus callback */\n  onFocus?: (event: FocusEvent) => void;\n}\n\n/** The use focus return type */\nexport interface UseFocusReturn {\n  /** The boolean state value of the target */\n  focused: boolean;\n  /** Blur the target */\n  blur: () => void;\n  /** Focus the target */\n  focus: () => void;\n}\n\nexport interface UseFocus {\n  (target: HookTarget, callback?: (event: FocusEvent) => void): UseFocusReturn;\n\n  (target: HookTarget, options?: UseFocusOptions): UseFocusReturn;\n\n  <Target extends Element>(\n    callback?: (event: FocusEvent) => void,\n    target?: never\n  ): UseFocusReturn & { ref: StateRef<Target> };\n\n  <Target extends Element>(\n    options?: UseFocusOptions,\n    target?: never\n  ): UseFocusReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useFocus\n * @description - Hook that allows you to focus on a specific element\n * @category Elements\n * @usage medium\n *\n * @overload\n * @param {HookTarget} target The target element to focus\n * @param {(event: FocusEvent) => void} [callback] The callback function to be invoked on focus\n * @returns {UseFocusReturn} An object with focus state and methods\n *\n * @example\n * const { focus, blur, focused } = useFocus(ref, () => console.log('focused'));\n *\n * @overload\n * @param {HookTarget} target The target element to focus\n * @param {boolean} [options.enabled=true] The enabled state of the focus hook\n * @param {boolean} [options.initialValue=false] The initial focus state of the target\n * @param {(event: FocusEvent) => void} [options.onFocus] The callback function to be invoked on focus\n * @param {(event: FocusEvent) => void} [options.onBlur] The callback function to be invoked on blur\n * @returns {UseFocusReturn} An object with focus state and methods\n *\n * @example\n * const { focus, blur, focused } = useFocus(ref);\n *\n * @overload\n * @template Target The target element\n * @param {(event: FocusEvent) => void} [callback] The callback function to be invoked on focus\n * @returns {UseFocusReturn & { ref: StateRef<Target> }} An object with focus state, methods and ref\n *\n * @example\n * const { ref, focus, blur, focused } = useFocus(() => console.log('focused'));\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The enabled state of the focus hook\n * @param {boolean} [options.initialValue=false] The initial focus state of the target\n * @param {(event: FocusEvent) => void} [options.onFocus] The callback function to be invoked on focus\n * @param {(event: FocusEvent) => void} [options.onBlur] The callback function to be invoked on blur\n * @returns {UseFocusReturn & { ref: StateRef<Target> }} An object with focus state, methods and ref\n *\n * @example\n * const { ref, focus, blur, focused } = useFocus();\n */\nexport const useFocus = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onFocus: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onFocus: params[0] }\n  ) as UseFocusOptions | undefined;\n  const enabled = options?.enabled ?? true;\n  const initialValue = options?.initialValue ?? false;\n\n  const [focused, setFocused] = useState(initialValue);\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  const elementRef = useRef<HTMLElement | null>(null);\n\n  const focus = () => {\n    if (!elementRef.current) return;\n    elementRef.current.focus();\n    setFocused(true);\n  };\n\n  const blur = () => {\n    if (!elementRef.current) return;\n    elementRef.current.blur();\n    setFocused(false);\n  };\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n    const element = (target ? isTarget.getElement(target) : internalRef.current) as HTMLElement;\n    if (!element) return;\n\n    elementRef.current = element;\n\n    const onFocus = (event: FocusEvent) => {\n      internalOptionsRef.current?.onFocus?.(event);\n      if (!focus || (event.target as HTMLElement).matches?.(':focus-visible')) setFocused(true);\n    };\n\n    const onBlur = (event: FocusEvent) => {\n      internalOptionsRef.current?.onBlur?.(event);\n      setFocused(false);\n    };\n\n    if (initialValue) element.focus();\n\n    element.addEventListener('focus', onFocus);\n    element.addEventListener('blur', onBlur);\n\n    return () => {\n      element.removeEventListener('focus', onFocus);\n      element.removeEventListener('blur', onBlur);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state, enabled]);\n\n  if (target) return { focus, blur, focused };\n  return {\n    ref: internalRef,\n    focus,\n    blur,\n    focused\n  };\n}) as UseFocus;\n"],"mappings":";;;;AA4FA,IAAa,MAAa,GAAG,MAAkB;CAC7C,IAAM,IAAU,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAE5C,IACJ,IACI,OAAO,EAAO,MAAO,WACnB,EAAO,KACP,EAAE,SAAS,EAAO,IAAI,GACxB,OAAO,EAAO,MAAO,WACnB,EAAO,KACP,EAAE,SAAS,EAAO,IAAI,EAExB,IAAU,GAAS,WAAW,IAC9B,IAAe,GAAS,gBAAgB,IAExC,CAAC,GAAS,KAAc,EAAS,EAAa,EAC9C,IAAc,GAAsB,EACpC,IAAqB,EAAO,EAAQ;AAC1C,GAAmB,UAAU;CAE7B,IAAM,IAAa,EAA2B,KAAK,EAE7C,UAAc;AACb,IAAW,YAChB,EAAW,QAAQ,OAAO,EAC1B,EAAW,GAAK;IAGZ,UAAa;AACZ,IAAW,YAChB,EAAW,QAAQ,MAAM,EACzB,EAAW,GAAM;;AAgCnB,QA7BA,QAAgB;AACd,MAAI,CAAC,KAAY,CAAC,KAAU,CAAC,EAAY,MAAQ;EACjD,IAAM,IAAW,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACpE,MAAI,CAAC,EAAS;AAEd,IAAW,UAAU;EAErB,IAAM,KAAW,MAAsB;AAErC,GADA,EAAmB,SAAS,UAAU,EAAM,GACxC,CAAC,KAAU,EAAM,OAAuB,UAAU,iBAAiB,KAAE,EAAW,GAAK;KAGrF,KAAU,MAAsB;AAEpC,GADA,EAAmB,SAAS,SAAS,EAAM,EAC3C,EAAW,GAAM;;AAQnB,SALI,KAAc,EAAQ,OAAO,EAEjC,EAAQ,iBAAiB,SAAS,EAAQ,EAC1C,EAAQ,iBAAiB,QAAQ,EAAO,QAE3B;AAEX,GADA,EAAQ,oBAAoB,SAAS,EAAQ,EAC7C,EAAQ,oBAAoB,QAAQ,EAAO;;IAE5C;EAAC,KAAU,EAAS,cAAc,EAAO;EAAE,EAAY;EAAO;EAAQ,CAAC,EAEtE,IAAe;EAAE;EAAO;EAAM;EAAS,GACpC;EACL,KAAK;EACL;EACA;EACA;EACD"}

package/dist/esm/hooks/useFocusTrap/useFocusTrap.mjs

@@ -1,37 +1,52 @@
-import { useState as p } from "react";
-import { useIsomorphicLayoutEffect as v } from "../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs";
-import { useRefState as h } from "../useRefState/useRefState.mjs";
-import { isTarget as l } from "../../utils/helpers/isTarget.mjs";
-const S = "a, input, select, textarea, button, object, [tabindex]", g = (t) => Array.from(t.querySelectorAll(S)).filter((o) => {
-  const n = o;
-  return n.tabIndex !== -1 && !n.hidden && n.style.display !== "none";
-}), w = (t) => {
-  const e = t.querySelector("[data-autofocus]");
-  if (e) return e.focus();
-  const o = g(t);
-  o.length && o[0].focus();
-}, T = ((...t) => {
-  const e = l(t[0]) ? t[0] : void 0, o = e ? t[1] : t[0], [n, c] = p(o), u = h(), i = () => c(!0), f = () => c(!1), a = () => c((r) => !r);
-  return v(() => {
-    if (!n) return;
-    const r = e ? l.getElement(e) : u.current;
-    if (!r) return;
-    const m = r;
-    w(m);
-    const E = (s) => {
-      if (s.key !== "Tab") return;
-      const [d, ...y] = g(m);
-      if (!y.length) return;
-      const b = y.at(-1);
-      s.shiftKey && document.activeElement === d && (s.preventDefault(), b.focus()), document.activeElement === b && (s.preventDefault(), d.focus());
-    };
-    return document.addEventListener("keydown", E), () => {
-      document.removeEventListener("keydown", E);
-    };
-  }, [n, e && l.getRawElement(e), u.state]), e ? { active: n, enable: i, disable: f, toggle: a } : { active: n, enable: i, disable: f, toggle: a, ref: u };
+import { useIsomorphicLayoutEffect as e } from "../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs";
+import { isTarget as t } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as n } from "../useRefState/useRefState.mjs";
+import { useState as r } from "react";
+//#region src/hooks/useFocusTrap/useFocusTrap.ts
+var i = "a, input, select, textarea, button, object, [tabindex]", a = (e) => Array.from(e.querySelectorAll(i)).filter((e) => {
+	let t = e;
+	return t.tabIndex !== -1 && !t.hidden && t.style.display !== "none";
+}), o = (e) => {
+	let t = e.querySelector("[data-autofocus]");
+	if (t) return t.focus();
+	let n = a(e);
+	n.length && n[0].focus();
+}, s = ((...i) => {
+	let s = t(i[0]) ? i[0] : void 0, [c, l] = r(s ? i[1] : i[0]), u = n(), d = () => l(!0), f = () => l(!1), p = () => l((e) => !e);
+	return e(() => {
+		if (!c) return;
+		let e = s ? t.getElement(s) : u.current;
+		if (!e) return;
+		let n = e;
+		o(n);
+		let r = (e) => {
+			if (e.key !== "Tab") return;
+			let [t, ...r] = a(n);
+			if (!r.length) return;
+			let i = r.at(-1);
+			e.shiftKey && document.activeElement === t && (e.preventDefault(), i.focus()), document.activeElement === i && (e.preventDefault(), t.focus());
+		};
+		return document.addEventListener("keydown", r), () => {
+			document.removeEventListener("keydown", r);
+		};
+	}, [
+		c,
+		s && t.getRawElement(s),
+		u.state
+	]), s ? {
+		active: c,
+		enable: d,
+		disable: f,
+		toggle: p
+	} : {
+		active: c,
+		enable: d,
+		disable: f,
+		toggle: p,
+		ref: u
+	};
 });
-export {
-  S as FOCUS_SELECTOR,
-  T as useFocusTrap
-};
-//# sourceMappingURL=useFocusTrap.mjs.map
+//#endregion
+export { i as FOCUS_SELECTOR, s as useFocusTrap };
+
+//# sourceMappingURL=useFocusTrap.mjs.map

package/dist/esm/hooks/useFocusTrap/useFocusTrap.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useFocusTrap.mjs","sources":["../../../../src/hooks/useFocusTrap/useFocusTrap.ts"],"sourcesContent":["import { useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect';\nimport { useRefState } from '../useRefState/useRefState';\n\nexport const FOCUS_SELECTOR = 'a, input, select, textarea, button, object, [tabindex]';\n\nconst getFocusableElements = (element: HTMLElement) => {\n  const elements = Array.from(element.querySelectorAll(FOCUS_SELECTOR));\n  return elements.filter((element) => {\n    const htmlEl = element as HTMLElement;\n    return htmlEl.tabIndex !== -1 && !htmlEl.hidden && htmlEl.style.display !== 'none';\n  }) as HTMLElement[];\n};\n\nconst focusElement = (element: HTMLElement) => {\n  const autofocusElement = element.querySelector('[data-autofocus]') as HTMLElement;\n  if (autofocusElement) return autofocusElement.focus();\n  const focusableElements = getFocusableElements(element);\n  if (focusableElements.length) focusableElements[0].focus();\n};\n\n/** The use focus trap return type */\nexport interface UseFocusTrapReturn {\n  /** Whether focus trap is active */\n  active: boolean;\n  /** Disable focus trap */\n  disable: () => void;\n  /** Enable focus trap */\n  enable: () => void;\n  /** Toggle focus trap */\n  toggle: () => void;\n}\n\nexport interface UseFocusTrap {\n  (target: HookTarget, active?: boolean): UseFocusTrapReturn;\n\n  <Target extends HTMLElement>(\n    active?: boolean,\n    target?: never\n  ): UseFocusTrapReturn & {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useFocusTrap\n * @description - Hook that traps focus within a given element\n * @category Elements\n * @usage medium\n *\n * @overload\n * @param {HookTarget} target The target element for focus trap\n * @param {boolean} [active=true] Whether focus trap is active\n * @returns {UseFocusTrapReturn} Object with the focus trap state and methods\n *\n * @example\n * const { active, disable, toggle, enable } = useFocusTrap(ref, true);\n *\n * @overload\n * @template Target The target element type\n * @param {boolean} [active=true] Whether focus trap is active\n * @returns {UseFocusTrapReturn & { ref: StateRef<Target> }} Object with the focus trap state and methods\n *\n * @example\n * const { ref, active, disable, toggle, enable } = useFocusTrap(true);\n */\nexport const useFocusTrap = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const initialActive = target ? params[1] : params[0];\n\n  const [active, setActive] = useState(initialActive);\n  const internalRef = useRefState<HTMLElement>();\n\n  const enable = () => setActive(true);\n  const disable = () => setActive(false);\n  const toggle = () => setActive((prevActive: boolean) => !prevActive);\n\n  useIsomorphicLayoutEffect(() => {\n    if (!active) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const htmlElement = element as HTMLElement;\n    focusElement(htmlElement);\n\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.key !== 'Tab') return;\n\n      const [firstElement, ...restElements] = getFocusableElements(htmlElement);\n      if (!restElements.length) return;\n\n      const lastElement = restElements.at(-1)!;\n\n      if (event.shiftKey && document.activeElement === firstElement) {\n        event.preventDefault();\n        lastElement.focus();\n      }\n\n      if (document.activeElement === lastElement) {\n        event.preventDefault();\n        firstElement.focus();\n      }\n    };\n\n    document.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      document.removeEventListener('keydown', onKeyDown);\n    };\n  }, [active, target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return { active, enable, disable, toggle };\n  return { active, enable, disable, toggle, ref: internalRef };\n}) as UseFocusTrap;\n"],"names":["FOCUS_SELECTOR","getFocusableElements","element","htmlEl","focusElement","autofocusElement","focusableElements","useFocusTrap","params","target","isTarget","initialActive","active","setActive","useState","internalRef","useRefState","enable","disable","toggle","prevActive","useIsomorphicLayoutEffect","htmlElement","onKeyDown","event","firstElement","restElements","lastElement"],"mappings":";;;;AAWO,MAAMA,IAAiB,0DAExBC,IAAuB,CAACC,MACX,MAAM,KAAKA,EAAQ,iBAAiBF,CAAc,CAAC,EACpD,OAAO,CAACE,MAAY;AAClC,QAAMC,IAASD;AACf,SAAOC,EAAO,aAAa,MAAM,CAACA,EAAO,UAAUA,EAAO,MAAM,YAAY;AAAA,CAC7E,GAGGC,IAAe,CAACF,MAAyB;AAC7C,QAAMG,IAAmBH,EAAQ,cAAc,kBAAkB;AACjE,MAAIG,EAAkB,QAAOA,EAAiB,MAAA;AAC9C,QAAMC,IAAoBL,EAAqBC,CAAO;AACtD,EAAII,EAAkB,UAAQA,EAAkB,CAAC,EAAE,MAAA;AACrD,GA+CaC,KAAgB,IAAIC,MAAkB;AACjD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAgBF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAE7C,CAACI,GAAQC,CAAS,IAAIC,EAASH,CAAa,GAC5CI,IAAcC,EAAA,GAEdC,IAAS,MAAMJ,EAAU,EAAI,GAC7BK,IAAU,MAAML,EAAU,EAAK,GAC/BM,IAAS,MAAMN,EAAU,CAACO,MAAwB,CAACA,CAAU;AAqCnE,SAnCAC,EAA0B,MAAM;AAC9B,QAAI,CAACT,EAAQ;AAEb,UAAMV,IAAUO,IAASC,EAAS,WAAWD,CAAM,IAAIM,EAAY;AACnE,QAAI,CAACb,EAAS;AAEd,UAAMoB,IAAcpB;AACpB,IAAAE,EAAakB,CAAW;AAExB,UAAMC,IAAY,CAACC,MAAyB;AAC1C,UAAIA,EAAM,QAAQ,MAAO;AAEzB,YAAM,CAACC,GAAc,GAAGC,CAAY,IAAIzB,EAAqBqB,CAAW;AACxE,UAAI,CAACI,EAAa,OAAQ;AAE1B,YAAMC,IAAcD,EAAa,GAAG,EAAE;AAEtC,MAAIF,EAAM,YAAY,SAAS,kBAAkBC,MAC/CD,EAAM,eAAA,GACNG,EAAY,MAAA,IAGV,SAAS,kBAAkBA,MAC7BH,EAAM,eAAA,GACNC,EAAa,MAAA;AAAA,IACf;AAGF,oBAAS,iBAAiB,WAAWF,CAAS,GAEvC,MAAM;AACX,eAAS,oBAAoB,WAAWA,CAAS;AAAA,IAAA;AAAA,EACnD,GACC,CAACX,GAAQH,KAAUC,EAAS,cAAcD,CAAM,GAAGM,EAAY,KAAK,CAAC,GAEpEN,IAAe,EAAE,QAAAG,GAAQ,QAAAK,GAAQ,SAAAC,GAAS,QAAAC,EAAA,IACvC,EAAE,QAAAP,GAAQ,QAAAK,GAAQ,SAAAC,GAAS,QAAAC,GAAQ,KAAKJ,EAAA;AACjD;"}
+{"version":3,"file":"useFocusTrap.mjs","names":[],"sources":["../../../../src/hooks/useFocusTrap/useFocusTrap.ts"],"sourcesContent":["import { useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect';\nimport { useRefState } from '../useRefState/useRefState';\n\nexport const FOCUS_SELECTOR = 'a, input, select, textarea, button, object, [tabindex]';\n\nconst getFocusableElements = (element: HTMLElement) => {\n  const elements = Array.from(element.querySelectorAll(FOCUS_SELECTOR));\n  return elements.filter((element) => {\n    const htmlEl = element as HTMLElement;\n    return htmlEl.tabIndex !== -1 && !htmlEl.hidden && htmlEl.style.display !== 'none';\n  }) as HTMLElement[];\n};\n\nconst focusElement = (element: HTMLElement) => {\n  const autofocusElement = element.querySelector('[data-autofocus]') as HTMLElement;\n  if (autofocusElement) return autofocusElement.focus();\n  const focusableElements = getFocusableElements(element);\n  if (focusableElements.length) focusableElements[0].focus();\n};\n\n/** The use focus trap return type */\nexport interface UseFocusTrapReturn {\n  /** Whether focus trap is active */\n  active: boolean;\n  /** Disable focus trap */\n  disable: () => void;\n  /** Enable focus trap */\n  enable: () => void;\n  /** Toggle focus trap */\n  toggle: () => void;\n}\n\nexport interface UseFocusTrap {\n  (target: HookTarget, active?: boolean): UseFocusTrapReturn;\n\n  <Target extends HTMLElement>(\n    active?: boolean,\n    target?: never\n  ): UseFocusTrapReturn & {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useFocusTrap\n * @description - Hook that traps focus within a given element\n * @category Elements\n * @usage medium\n *\n * @overload\n * @param {HookTarget} target The target element for focus trap\n * @param {boolean} [active=true] Whether focus trap is active\n * @returns {UseFocusTrapReturn} Object with the focus trap state and methods\n *\n * @example\n * const { active, disable, toggle, enable } = useFocusTrap(ref, true);\n *\n * @overload\n * @template Target The target element type\n * @param {boolean} [active=true] Whether focus trap is active\n * @returns {UseFocusTrapReturn & { ref: StateRef<Target> }} Object with the focus trap state and methods\n *\n * @example\n * const { ref, active, disable, toggle, enable } = useFocusTrap(true);\n */\nexport const useFocusTrap = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const initialActive = target ? params[1] : params[0];\n\n  const [active, setActive] = useState(initialActive);\n  const internalRef = useRefState<HTMLElement>();\n\n  const enable = () => setActive(true);\n  const disable = () => setActive(false);\n  const toggle = () => setActive((prevActive: boolean) => !prevActive);\n\n  useIsomorphicLayoutEffect(() => {\n    if (!active) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const htmlElement = element as HTMLElement;\n    focusElement(htmlElement);\n\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.key !== 'Tab') return;\n\n      const [firstElement, ...restElements] = getFocusableElements(htmlElement);\n      if (!restElements.length) return;\n\n      const lastElement = restElements.at(-1)!;\n\n      if (event.shiftKey && document.activeElement === firstElement) {\n        event.preventDefault();\n        lastElement.focus();\n      }\n\n      if (document.activeElement === lastElement) {\n        event.preventDefault();\n        firstElement.focus();\n      }\n    };\n\n    document.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      document.removeEventListener('keydown', onKeyDown);\n    };\n  }, [active, target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return { active, enable, disable, toggle };\n  return { active, enable, disable, toggle, ref: internalRef };\n}) as UseFocusTrap;\n"],"mappings":";;;;;AAWA,IAAa,IAAiB,0DAExB,KAAwB,MACX,MAAM,KAAK,EAAQ,iBAAiB,EAAe,CAAC,CACrD,QAAQ,MAAY;CAClC,IAAM,IAAS;AACf,QAAO,EAAO,aAAa,MAAM,CAAC,EAAO,UAAU,EAAO,MAAM,YAAY;EAC5E,EAGE,KAAgB,MAAyB;CAC7C,IAAM,IAAmB,EAAQ,cAAc,mBAAmB;AAClE,KAAI,EAAkB,QAAO,EAAiB,OAAO;CACrD,IAAM,IAAoB,EAAqB,EAAQ;AACvD,CAAI,EAAkB,UAAQ,EAAkB,GAAG,OAAO;GAgD/C,MAAiB,GAAG,MAAkB;CACjD,IAAM,IAAU,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAG5C,CAAC,GAAQ,KAAa,EAFN,IAAS,EAAO,KAAK,EAAO,GAEC,EAC7C,IAAc,GAA0B,EAExC,UAAe,EAAU,GAAK,EAC9B,UAAgB,EAAU,GAAM,EAChC,UAAe,GAAW,MAAwB,CAAC,EAAW;AAsCpE,QApCA,QAAgC;AAC9B,MAAI,CAAC,EAAQ;EAEb,IAAM,IAAU,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACnE,MAAI,CAAC,EAAS;EAEd,IAAM,IAAc;AACpB,IAAa,EAAY;EAEzB,IAAM,KAAa,MAAyB;AAC1C,OAAI,EAAM,QAAQ,MAAO;GAEzB,IAAM,CAAC,GAAc,GAAG,KAAgB,EAAqB,EAAY;AACzE,OAAI,CAAC,EAAa,OAAQ;GAE1B,IAAM,IAAc,EAAa,GAAG,GAAG;AAOvC,GALI,EAAM,YAAY,SAAS,kBAAkB,MAC/C,EAAM,gBAAgB,EACtB,EAAY,OAAO,GAGjB,SAAS,kBAAkB,MAC7B,EAAM,gBAAgB,EACtB,EAAa,OAAO;;AAMxB,SAFA,SAAS,iBAAiB,WAAW,EAAU,QAElC;AACX,YAAS,oBAAoB,WAAW,EAAU;;IAEnD;EAAC;EAAQ,KAAU,EAAS,cAAc,EAAO;EAAE,EAAY;EAAM,CAAC,EAErE,IAAe;EAAE;EAAQ;EAAQ;EAAS;EAAQ,GAC/C;EAAE;EAAQ;EAAQ;EAAS;EAAQ,KAAK;EAAa"}

package/dist/esm/hooks/useFps/useFps.mjs

@@ -1,23 +1,19 @@
-import { useState as i, useEffect as u } from "react";
-const p = () => {
-  const [s, m] = i(0);
-  return u(() => {
-    let e = 0, n = performance.now(), t;
-    const r = () => {
-      e += 1;
-      const o = performance.now(), a = o - n;
-      if (a >= 1e3) {
-        const c = Math.round(e * 1e3 / a);
-        m(c), e = 0, n = o;
-      }
-      t = requestAnimationFrame(r);
-    };
-    return t = requestAnimationFrame(r), () => {
-      cancelAnimationFrame(t);
-    };
-  }, []), s;
+import { useEffect as e, useState as t } from "react";
+//#region src/hooks/useFps/useFps.ts
+var n = () => {
+	let [n, r] = t(0);
+	return e(() => {
+		let e = 0, t = performance.now(), n, i = () => {
+			e += 1;
+			let a = performance.now(), o = a - t;
+			o >= 1e3 && (r(Math.round(e * 1e3 / o)), e = 0, t = a), n = requestAnimationFrame(i);
+		};
+		return n = requestAnimationFrame(i), () => {
+			cancelAnimationFrame(n);
+		};
+	}, []), n;
 };
-export {
-  p as useFps
-};
-//# sourceMappingURL=useFps.mjs.map
+//#endregion
+export { n as useFps };
+
+//# sourceMappingURL=useFps.mjs.map

package/dist/esm/hooks/useFps/useFps.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useFps.mjs","sources":["../../../../src/hooks/useFps/useFps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * @name useFps\n * @description - Hook that measures frames per second\n * @category Browser\n * @usage low\n *\n * @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\n *\n * @returns {number} A number which determines frames per second\n *\n * @example\n * const fps = useFps();\n */\nexport const useFps = () => {\n  const [fps, setFps] = useState(0);\n\n  useEffect(() => {\n    let frameCount = 0;\n    let startTime = performance.now();\n    let rafId: number;\n\n    const onRequestAnimationFrame = () => {\n      frameCount += 1;\n      const currentTime = performance.now();\n      const elapsedTime = currentTime - startTime;\n\n      if (elapsedTime >= 1000) {\n        const calculatedFps = Math.round((frameCount * 1000) / elapsedTime);\n        setFps(calculatedFps);\n        frameCount = 0;\n        startTime = currentTime;\n      }\n\n      rafId = requestAnimationFrame(onRequestAnimationFrame);\n    };\n\n    rafId = requestAnimationFrame(onRequestAnimationFrame);\n\n    return () => {\n      cancelAnimationFrame(rafId);\n    };\n  }, []);\n\n  return fps;\n};\n"],"names":["useFps","fps","setFps","useState","useEffect","frameCount","startTime","rafId","onRequestAnimationFrame","currentTime","elapsedTime","calculatedFps"],"mappings":";AAeO,MAAMA,IAAS,MAAM;AAC1B,QAAM,CAACC,GAAKC,CAAM,IAAIC,EAAS,CAAC;AAEhC,SAAAC,EAAU,MAAM;AACd,QAAIC,IAAa,GACbC,IAAY,YAAY,IAAA,GACxBC;AAEJ,UAAMC,IAA0B,MAAM;AACpC,MAAAH,KAAc;AACd,YAAMI,IAAc,YAAY,IAAA,GAC1BC,IAAcD,IAAcH;AAElC,UAAII,KAAe,KAAM;AACvB,cAAMC,IAAgB,KAAK,MAAON,IAAa,MAAQK,CAAW;AAClE,QAAAR,EAAOS,CAAa,GACpBN,IAAa,GACbC,IAAYG;AAAA,MAAA;AAGd,MAAAF,IAAQ,sBAAsBC,CAAuB;AAAA,IAAA;AAGvD,WAAAD,IAAQ,sBAAsBC,CAAuB,GAE9C,MAAM;AACX,2BAAqBD,CAAK;AAAA,IAAA;AAAA,EAC5B,GACC,EAAE,GAEEN;AACT;"}
+{"version":3,"file":"useFps.mjs","names":[],"sources":["../../../../src/hooks/useFps/useFps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * @name useFps\n * @description - Hook that measures frames per second\n * @category Browser\n * @usage low\n *\n * @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\n *\n * @returns {number} A number which determines frames per second\n *\n * @example\n * const fps = useFps();\n */\nexport const useFps = () => {\n  const [fps, setFps] = useState(0);\n\n  useEffect(() => {\n    let frameCount = 0;\n    let startTime = performance.now();\n    let rafId: number;\n\n    const onRequestAnimationFrame = () => {\n      frameCount += 1;\n      const currentTime = performance.now();\n      const elapsedTime = currentTime - startTime;\n\n      if (elapsedTime >= 1000) {\n        const calculatedFps = Math.round((frameCount * 1000) / elapsedTime);\n        setFps(calculatedFps);\n        frameCount = 0;\n        startTime = currentTime;\n      }\n\n      rafId = requestAnimationFrame(onRequestAnimationFrame);\n    };\n\n    rafId = requestAnimationFrame(onRequestAnimationFrame);\n\n    return () => {\n      cancelAnimationFrame(rafId);\n    };\n  }, []);\n\n  return fps;\n};\n"],"mappings":";;AAeA,IAAa,UAAe;CAC1B,IAAM,CAAC,GAAK,KAAU,EAAS,EAAE;AA6BjC,QA3BA,QAAgB;EACd,IAAI,IAAa,GACb,IAAY,YAAY,KAAK,EAC7B,GAEE,UAAgC;AACpC,QAAc;GACd,IAAM,IAAc,YAAY,KAAK,EAC/B,IAAc,IAAc;AASlC,GAPI,KAAe,QAEjB,EADsB,KAAK,MAAO,IAAa,MAAQ,EAAY,CAC9C,EACrB,IAAa,GACb,IAAY,IAGd,IAAQ,sBAAsB,EAAwB;;AAKxD,SAFA,IAAQ,sBAAsB,EAAwB,QAEzC;AACX,wBAAqB,EAAM;;IAE5B,EAAE,CAAC,EAEC"}

package/dist/esm/hooks/useFul/useFul.mjs

@@ -1,8 +1,9 @@
 import { useEffect as e } from "react";
-const r = (o) => (e(() => {
-  console.warn("Warning: You forgot to delete the 'useFul' hook.");
-}, []), o);
-export {
-  r as useFul
-};
-//# sourceMappingURL=useFul.mjs.map
+//#region src/hooks/useFul/useFul.ts
+var t = (t) => (e(() => {
+	console.warn("Warning: You forgot to delete the 'useFul' hook.");
+}, []), t);
+//#endregion
+export { t as useFul };
+
+//# sourceMappingURL=useFul.mjs.map

package/dist/esm/hooks/useFul/useFul.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useFul.mjs","sources":["../../../../src/hooks/useFul/useFul.ts"],"sourcesContent":["import { useEffect } from 'react';\n\n/**\n * @name useFul\n * @description - Hook that can be so useful\n * @category Humor\n * @usage low\n *\n * @warning - This hook is a joke. Please do not use it in production code!\n *\n * @template Value The type of the value\n * @param {Value} [value] The value to be returned\n * @returns {Value} The value passed to the hook\n *\n * @example\n * const value = useFul(state);\n */\nexport const useFul = <Value>(value?: Value) => {\n  useEffect(() => {\n    console.warn(\"Warning: You forgot to delete the 'useFul' hook.\");\n  }, []);\n\n  return value;\n};\n"],"names":["useFul","value","useEffect"],"mappings":";AAiBO,MAAMA,IAAS,CAAQC,OAC5BC,EAAU,MAAM;AACd,UAAQ,KAAK,kDAAkD;AAAA,GAC9D,EAAE,GAEED;"}
+{"version":3,"file":"useFul.mjs","names":[],"sources":["../../../../src/hooks/useFul/useFul.ts"],"sourcesContent":["import { useEffect } from 'react';\n\n/**\n * @name useFul\n * @description - Hook that can be so useful\n * @category Humor\n * @usage low\n *\n * @warning - This hook is a joke. Please do not use it in production code!\n *\n * @template Value The type of the value\n * @param {Value} [value] The value to be returned\n * @returns {Value} The value passed to the hook\n *\n * @example\n * const value = useFul(state);\n */\nexport const useFul = <Value>(value?: Value) => {\n  useEffect(() => {\n    console.warn(\"Warning: You forgot to delete the 'useFul' hook.\");\n  }, []);\n\n  return value;\n};\n"],"mappings":";;AAiBA,IAAa,KAAiB,OAC5B,QAAgB;AACd,SAAQ,KAAK,mDAAmD;GAC/D,EAAE,CAAC,EAEC"}