dash-ui-kit 1.0.94 → 2.1.0-dev

package/dist/react/hooks/useDebounce.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.esm.js","sources":["../../../src/react/hooks/useDebounce.ts"],"sourcesContent":["import { useState, useEffect, useRef, useCallback } from 'react'\n\ninterface UseDebounceOptions<T> {\n  /**\n   * Delay in milliseconds\n   */\n  delay: number\n  /**\n   * Callback called when debounced value changes\n   */\n  callback?: (value: T) => void\n  /**\n   * If true, the value will be set immediately on first call\n   */\n  immediate?: boolean\n}\n\ninterface UseDebounceReturn<T> {\n  /**\n   * Current debounced value\n   */\n  debouncedValue: T\n  /**\n   * Function to force flush debounce and immediately update value\n   */\n  flush: () => void\n  /**\n   * Function to cancel current pending debounce\n   */\n  cancel: () => void\n  /**\n   * Whether there's a pending change\n   */\n  isPending: boolean\n}\n\n/**\n * Hook for debouncing values with extended functionality\n * \n * @param value - Value to debounce\n * @param options - Configuration options\n * @returns Object with debounced value and control methods\n */\nconst useDebounce = <T>(\n  value: T, \n  options: UseDebounceOptions<T> | number\n): UseDebounceReturn<T> => {\n  // Backward compatibility support - if number is passed, it's delay\n  const config: UseDebounceOptions<T> = typeof options === 'number' \n    ? { delay: options }\n    : options\n\n  const { delay, callback, immediate = false } = config\n  \n  const [debouncedValue, setDebouncedValue] = useState<T>(value)\n  const [isPending, setIsPending] = useState(false)\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null)\n  const isFirstRun = useRef(true)\n\n  const cancel = useCallback(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current)\n      timeoutRef.current = null\n      setIsPending(false)\n    }\n  }, [])\n\n  const flush = useCallback(() => {\n    cancel()\n    setDebouncedValue(value)\n    callback?.(value)\n    setIsPending(false)\n  }, [value, callback, cancel])\n\n  useEffect(() => {\n    // If immediate === true and this is first run, set value immediately\n    if (immediate && isFirstRun.current) {\n      setDebouncedValue(value)\n      callback?.(value)\n      isFirstRun.current = false\n      return\n    }\n\n    isFirstRun.current = false\n    setIsPending(true)\n\n    const handler = setTimeout(() => {\n      setDebouncedValue(value)\n      callback?.(value)\n      setIsPending(false)\n      timeoutRef.current = null\n    }, delay)\n\n    timeoutRef.current = handler\n\n    return () => {\n      clearTimeout(handler)\n      setIsPending(false)\n    }\n  }, [value, delay, callback, immediate])\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current)\n      }\n    }\n  }, [])\n\n  return {\n    debouncedValue,\n    flush,\n    cancel,\n    isPending\n  }\n}\n\n// Export for backward compatibility\nexport default useDebounce\n\n// Named export for new API\nexport { useDebounce } "],"names":["useDebounce","value","options","config","delay","callback","immediate","debouncedValue","setDebouncedValue","useState","isPending","setIsPending","timeoutRef","useRef","isFirstRun","cancel","useCallback","current","clearTimeout","flush","useEffect","handler","setTimeout"],"mappings":";;;;AAoCA;;;;;;AAMG;AACH,MAAMA,WAAW,GAAGA,CAClBC,KAAQ,EACRC,OAAuC,KACf;AACxB;AACA,EAAA,MAAMC,MAAM,GAA0B,OAAOD,OAAO,KAAK,QAAQ,GAC7D;AAAEE,IAAAA,KAAK,EAAEF;AAAS,GAAA,GAClBA,OAAO;EAEX,MAAM;IAAEE,KAAK;IAAEC,QAAQ;AAAEC,IAAAA,SAAS,GAAG;AAAK,GAAE,GAAGH,MAAM;EAErD,MAAM,CAACI,cAAc,EAAEC,iBAAiB,CAAC,GAAGC,QAAQ,CAAIR,KAAK,CAAC;EAC9D,MAAM,CAACS,SAAS,EAAEC,YAAY,CAAC,GAAGF,QAAQ,CAAC,KAAK,CAAC;AACjD,EAAA,MAAMG,UAAU,GAAGC,MAAM,CAAwB,IAAI,CAAC;AACtD,EAAA,MAAMC,UAAU,GAAGD,MAAM,CAAC,IAAI,CAAC;AAE/B,EAAA,MAAME,MAAM,GAAGC,WAAW,CAAC,MAAK;IAC9B,IAAIJ,UAAU,CAACK,OAAO,EAAE;AACtBC,MAAAA,YAAY,CAACN,UAAU,CAACK,OAAO,CAAC;MAChCL,UAAU,CAACK,OAAO,GAAG,IAAI;MACzBN,YAAY,CAAC,KAAK,CAAC;AACrB;GACD,EAAE,EAAE,CAAC;AAEN,EAAA,MAAMQ,KAAK,GAAGH,WAAW,CAAC,MAAK;AAC7BD,IAAAA,MAAM,EAAE;IACRP,iBAAiB,CAACP,KAAK,CAAC;AACxBI,IAAAA,QAAQ,aAARA,QAAQ,KAAA,MAAA,GAAA,MAAA,GAARA,QAAQ,CAAGJ,KAAK,CAAC;IACjBU,YAAY,CAAC,KAAK,CAAC;GACpB,EAAE,CAACV,KAAK,EAAEI,QAAQ,EAAEU,MAAM,CAAC,CAAC;AAE7BK,EAAAA,SAAS,CAAC,MAAK;AACb;AACA,IAAA,IAAId,SAAS,IAAIQ,UAAU,CAACG,OAAO,EAAE;MACnCT,iBAAiB,CAACP,KAAK,CAAC;AACxBI,MAAAA,QAAQ,aAARA,QAAQ,KAAA,MAAA,GAAA,MAAA,GAARA,QAAQ,CAAGJ,KAAK,CAAC;MACjBa,UAAU,CAACG,OAAO,GAAG,KAAK;AAC1B,MAAA;AACF;IAEAH,UAAU,CAACG,OAAO,GAAG,KAAK;IAC1BN,YAAY,CAAC,IAAI,CAAC;AAElB,IAAA,MAAMU,OAAO,GAAGC,UAAU,CAAC,MAAK;MAC9Bd,iBAAiB,CAACP,KAAK,CAAC;AACxBI,MAAAA,QAAQ,aAARA,QAAQ,KAAA,MAAA,GAAA,MAAA,GAARA,QAAQ,CAAGJ,KAAK,CAAC;MACjBU,YAAY,CAAC,KAAK,CAAC;MACnBC,UAAU,CAACK,OAAO,GAAG,IAAI;KAC1B,EAAEb,KAAK,CAAC;IAETQ,UAAU,CAACK,OAAO,GAAGI,OAAO;AAE5B,IAAA,OAAO,MAAK;MACVH,YAAY,CAACG,OAAO,CAAC;MACrBV,YAAY,CAAC,KAAK,CAAC;KACpB;GACF,EAAE,CAACV,KAAK,EAAEG,KAAK,EAAEC,QAAQ,EAAEC,SAAS,CAAC,CAAC;AAEvC;AACAc,EAAAA,SAAS,CAAC,MAAK;AACb,IAAA,OAAO,MAAK;MACV,IAAIR,UAAU,CAACK,OAAO,EAAE;AACtBC,QAAAA,YAAY,CAACN,UAAU,CAACK,OAAO,CAAC;AAClC;KACD;GACF,EAAE,EAAE,CAAC;EAEN,OAAO;IACLV,cAAc;IACdY,KAAK;IACLJ,MAAM;AACNL,IAAAA;GACD;AACH;;;;"}