@w3ux/hooks 1.3.1-beta.0 → 1.3.1-beta.1

package/cjs/index.d.ts

@@ -2,4 +2,4 @@ export * from "./useEffectIgnoreInitial";
 export * from "./useOnResize";
 export * from "./useOutsideAlerter";
 export * from "./useSize";
-export * from "./useTimeleft";
+export * from "./useTimeLeft";

package/cjs/index.js

@@ -18,7 +18,7 @@ __exportStar(require("./useEffectIgnoreInitial"), exports);
 __exportStar(require("./useOnResize"), exports);
 __exportStar(require("./useOutsideAlerter"), exports);
 __exportStar(require("./useSize"), exports);
-__exportStar(require("./useTimeleft"), exports);
+__exportStar(require("./useTimeLeft"), exports);
 
 //# sourceMappingURL=index.js.map
 

package/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAGA,2DAAyC;AACzC,gDAA8B;AAC9B,sDAAoC;AACpC,4CAA0B;AAC1B,gDAA8B","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from \"./useEffectIgnoreInitial\";\nexport * from \"./useOnResize\";\nexport * from \"./useOutsideAlerter\";\nexport * from \"./useSize\";\nexport * from \"./useTimeleft\";\n"]}
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAGA,2DAAyC;AACzC,gDAA8B;AAC9B,sDAAoC;AACpC,4CAA0B;AAC1B,gDAA8B","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from \"./useEffectIgnoreInitial\";\nexport * from \"./useOnResize\";\nexport * from \"./useOutsideAlerter\";\nexport * from \"./useSize\";\nexport * from \"./useTimeLeft\";\n"]}

package/cjs/{useTimeleft → useTimeLeft}/defaults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useTimeleft/defaults.ts"],"names":[],"mappings":";;;AAKa,QAAA,eAAe,GAAqB;IAC/C,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;CAClB,CAAC;AAEW,QAAA,sBAAsB,GAAG,EAAE,CAAC","file":"defaults.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { TimeleftDuration } from \"./types\";\n\nexport const defaultDuration: TimeleftDuration = {\n  days: 0,\n  hours: 0,\n  minutes: 0,\n  seconds: 0,\n  lastMinute: false,\n};\n\nexport const defaultRefreshInterval = 60;\n"]}
+{"version":3,"sources":["../src/useTimeLeft/defaults.ts"],"names":[],"mappings":";;;AAKa,QAAA,eAAe,GAAqB;IAC/C,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;CAClB,CAAC;AAEW,QAAA,sBAAsB,GAAG,EAAE,CAAC","file":"defaults.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { TimeleftDuration } from \"./types\";\n\nexport const defaultDuration: TimeleftDuration = {\n  days: 0,\n  hours: 0,\n  minutes: 0,\n  seconds: 0,\n  lastMinute: false,\n};\n\nexport const defaultRefreshInterval = 60;\n"]}

package/cjs/useTimeLeft/index.d.ts

@@ -0,0 +1,7 @@
+import type { TimeLeftAll, TimeleftDuration, UseTimeleftProps } from "./types";
+export declare const useTimeLeft: (props?: UseTimeleftProps) => {
+    setFromNow: (dateFrom: Date, dateTo: Date) => void;
+    timeleft: TimeLeftAll;
+    secondsFromNow: (seconds: number) => Date;
+    getDurationFromNow: (toDate: Date | null) => TimeleftDuration;
+};

package/cjs/{useTimeleft → useTimeLeft}/index.js

@@ -4,6 +4,8 @@ exports.useTimeLeft = void 0;
 const utils_1 = require("@w3ux/utils");
 const react_1 = require("react");
 const utils_2 = require("./utils");
+const defaults_1 = require("./defaults");
+const date_fns_1 = require("date-fns");
 const useTimeLeft = (props) => {
     const depsTimeleft = (props === null || props === void 0 ? void 0 : props.depsTimeleft) || [];
     const depsFormat = (props === null || props === void 0 ? void 0 : props.depsFormat) || [];
@@ -75,9 +77,42 @@ const useTimeLeft = (props) => {
         setTimeleft(getTimeleft((0, utils_2.getDuration)(dateFrom)));
         (0, utils_1.setStateWithRef)(dateTo, setTo, toRef);
     };
+    const secondsFromNow = (seconds) => {
+        const end = new Date();
+        end.setSeconds(end.getSeconds() + seconds);
+        return end;
+    };
+    const getDurationFromNow = (toDate) => {
+        if (!toDate) {
+            return defaults_1.defaultDuration;
+        }
+        if ((0, date_fns_1.getUnixTime)(toDate) <= (0, date_fns_1.getUnixTime)(new Date())) {
+            return defaults_1.defaultDuration;
+        }
+        toDate.setSeconds(toDate.getSeconds());
+        const d = (0, date_fns_1.intervalToDuration)({
+            start: Date.now(),
+            end: toDate,
+        });
+        const days = (0, date_fns_1.differenceInDays)(toDate, Date.now());
+        const hours = (d === null || d === void 0 ? void 0 : d.hours) || 0;
+        const minutes = (d === null || d === void 0 ? void 0 : d.minutes) || 0;
+        const seconds = (d === null || d === void 0 ? void 0 : d.seconds) || 0;
+        const lastHour = days === 0 && hours === 0;
+        const lastMinute = lastHour && minutes === 0;
+        return {
+            days,
+            hours,
+            minutes,
+            seconds,
+            lastMinute,
+        };
+    };
     return {
         setFromNow,
         timeleft,
+        secondsFromNow,
+        getDurationFromNow,
     };
 };
 exports.useTimeLeft = useTimeLeft;

package/cjs/useTimeLeft/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useTimeLeft/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { setStateWithRef } from \"@w3ux/utils\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type {\n  TimeLeftAll,\n  TimeLeftRaw,\n  TimeleftDuration,\n  UseTimeleftProps,\n} from \"./types\";\nimport { getDuration } from \"./utils\";\nimport { defaultDuration } from \"./defaults\";\nimport { differenceInDays, getUnixTime, intervalToDuration } from \"date-fns\";\n\nexport const useTimeLeft = (props?: UseTimeleftProps) => {\n  const depsTimeleft = props?.depsTimeleft || [];\n  const depsFormat = props?.depsFormat || [];\n\n  // check whether timeleft is within a minute of finishing.\n  const inLastHour = () => {\n    const { days, hours } = getDuration(toRef.current);\n    return !days && !hours;\n  };\n\n  // get the amount of seconds left if timeleft is in the last minute.\n  const lastMinuteCountdown = () => {\n    const { seconds } = getDuration(toRef.current);\n    if (!inLastHour()) {\n      return 60;\n    }\n    return seconds;\n  };\n\n  // calculate resulting timeleft object from latest duration.\n  const getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n    const { days, hours, minutes, seconds } = c || getDuration(toRef.current);\n    const raw: TimeLeftRaw = {\n      days,\n      hours,\n      minutes,\n    };\n    if (!days && !hours) {\n      raw.seconds = seconds;\n    }\n    return {\n      raw,\n    };\n  };\n\n  // the end time as a date.\n  const [to, setTo] = useState<Date | null>(null);\n  const toRef = useRef(to);\n\n  // resulting timeleft object to be returned.\n  const [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft());\n\n  // timeleft refresh intervals.\n  const [minInterval, setMinInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const minIntervalRef = useRef(minInterval);\n\n  const [secInterval, setSecInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const secIntervalRef = useRef(secInterval);\n\n  // refresh effects.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n    if (inLastHour()) {\n      // refresh timeleft every second.\n      if (!secIntervalRef.current) {\n        const interval = setInterval(() => {\n          if (!inLastHour()) {\n            clearInterval(secIntervalRef.current);\n            setStateWithRef(undefined, setSecInterval, secIntervalRef);\n          }\n          setTimeleft(getTimeleft());\n        }, 1000);\n\n        setStateWithRef(interval, setSecInterval, secIntervalRef);\n      }\n    }\n    // refresh timeleft every minute.\n    else if (!minIntervalRef.current) {\n      const interval = setInterval(() => {\n        if (inLastHour()) {\n          clearInterval(minIntervalRef.current);\n          setStateWithRef(undefined, setMinInterval, minIntervalRef);\n        }\n        setTimeleft(getTimeleft());\n      }, 60000);\n      setStateWithRef(interval, setMinInterval, minIntervalRef);\n    }\n  }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);\n\n  // re-render the timeleft upon formatting changes.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n  }, [...depsFormat]);\n\n  // clear intervals on unmount\n  useEffect(\n    () => () => {\n      clearInterval(minInterval);\n      clearInterval(secInterval);\n    },\n    []\n  );\n\n  // Set the end time and calculate timeleft.\n  const setFromNow = (dateFrom: Date, dateTo: Date) => {\n    setTimeleft(getTimeleft(getDuration(dateFrom)));\n    setStateWithRef(dateTo, setTo, toRef);\n  };\n\n  // Helper: Adds `seconds` to the current time and returns the resulting date.\n  const secondsFromNow = (seconds: number): Date => {\n    const end = new Date();\n    end.setSeconds(end.getSeconds() + seconds);\n    return end;\n  };\n\n  // Helper: Calculates the duration between the current time and the provided date.\n  const getDurationFromNow = (toDate: Date | null): TimeleftDuration => {\n    if (!toDate) {\n      return defaultDuration;\n    }\n    if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n      return defaultDuration;\n    }\n\n    toDate.setSeconds(toDate.getSeconds());\n    const d = intervalToDuration({\n      start: Date.now(),\n      end: toDate,\n    });\n\n    const days = differenceInDays(toDate, Date.now());\n    const hours = d?.hours || 0;\n    const minutes = d?.minutes || 0;\n    const seconds = d?.seconds || 0;\n    const lastHour = days === 0 && hours === 0;\n    const lastMinute = lastHour && minutes === 0;\n\n    return {\n      days,\n      hours,\n      minutes,\n      seconds,\n      lastMinute,\n    };\n  };\n\n  return {\n    setFromNow,\n    timeleft,\n    secondsFromNow,\n    getDurationFromNow,\n  };\n};\n"]}

package/cjs/{useTimeleft → useTimeLeft}/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useTimeleft/types.ts"],"names":[],"mappings":"","file":"types.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport interface UseTimeleftProps {\n  // Dependencies to trigger re-calculation of timeleft.\n  depsTimeleft: unknown[];\n  // Dependencies to trigger re-render of timeleft, e.g. if language switching occurs.\n  depsFormat: unknown[];\n}\n\nexport interface TimeleftDuration {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds: number;\n  lastMinute: boolean;\n}\n\nexport interface TimeLeftRaw {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds?: number;\n}\n\nexport interface TimeLeftFormatted {\n  days: [number, string];\n  hours: [number, string];\n  minutes: [number, string];\n  seconds?: [number, string];\n}\n\nexport interface TimeLeftAll {\n  raw: TimeLeftRaw;\n}\n\nexport interface TimeleftHookProps {\n  refreshInterval: number;\n}\n"]}
+{"version":3,"sources":["../src/useTimeLeft/types.ts"],"names":[],"mappings":"","file":"types.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport interface UseTimeleftProps {\n  // Dependencies to trigger re-calculation of timeleft.\n  depsTimeleft: unknown[];\n  // Dependencies to trigger re-render of timeleft, e.g. if language switching occurs.\n  depsFormat: unknown[];\n}\n\nexport interface TimeleftDuration {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds: number;\n  lastMinute: boolean;\n}\n\nexport interface TimeLeftRaw {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds?: number;\n}\n\nexport interface TimeLeftFormatted {\n  days: [number, string];\n  hours: [number, string];\n  minutes: [number, string];\n  seconds?: [number, string];\n}\n\nexport interface TimeLeftAll {\n  raw: TimeLeftRaw;\n}\n\nexport interface TimeleftHookProps {\n  refreshInterval: number;\n}\n"]}

package/cjs/{useTimeleft → useTimeLeft}/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useTimeleft/utils.ts"],"names":[],"mappings":";;;AAGA,uCAA6E;AAC7E,yCAA6C;AAItC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAoB,EAAE;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,0BAAe,CAAC;IACzB,CAAC;IACD,IAAI,IAAA,sBAAW,EAAC,MAAM,CAAC,IAAI,IAAA,sBAAW,EAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,0BAAe,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,IAAA,6BAAkB,EAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAA,2BAAgB,EAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,KAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC;IAE7C,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;AA5BW,QAAA,WAAW,eA4BtB","file":"utils.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { differenceInDays, getUnixTime, intervalToDuration } from \"date-fns\";\nimport { defaultDuration } from \"./defaults\";\nimport type { TimeleftDuration } from \"./types\";\n\n// calculates the current timeleft duration.\nexport const getDuration = (toDate: Date | null): TimeleftDuration => {\n  if (!toDate) {\n    return defaultDuration;\n  }\n  if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n    return defaultDuration;\n  }\n\n  toDate.setSeconds(toDate.getSeconds());\n  const d = intervalToDuration({\n    start: Date.now(),\n    end: toDate,\n  });\n\n  const days = differenceInDays(toDate, Date.now());\n  const hours = d?.hours || 0;\n  const minutes = d?.minutes || 0;\n  const seconds = d?.seconds || 0;\n  const lastHour = days === 0 && hours === 0;\n  const lastMinute = lastHour && minutes === 0;\n\n  return {\n    days,\n    hours,\n    minutes,\n    seconds,\n    lastMinute,\n  };\n};\n"]}
+{"version":3,"sources":["../src/useTimeLeft/utils.ts"],"names":[],"mappings":";;;AAGA,uCAA6E;AAC7E,yCAA6C;AAItC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAoB,EAAE;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,0BAAe,CAAC;IACzB,CAAC;IACD,IAAI,IAAA,sBAAW,EAAC,MAAM,CAAC,IAAI,IAAA,sBAAW,EAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,0BAAe,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,IAAA,6BAAkB,EAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAA,2BAAgB,EAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,KAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC;IAE7C,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;AA5BW,QAAA,WAAW,eA4BtB","file":"utils.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { differenceInDays, getUnixTime, intervalToDuration } from \"date-fns\";\nimport { defaultDuration } from \"./defaults\";\nimport type { TimeleftDuration } from \"./types\";\n\n// calculates the current timeleft duration.\nexport const getDuration = (toDate: Date | null): TimeleftDuration => {\n  if (!toDate) {\n    return defaultDuration;\n  }\n  if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n    return defaultDuration;\n  }\n\n  toDate.setSeconds(toDate.getSeconds());\n  const d = intervalToDuration({\n    start: Date.now(),\n    end: toDate,\n  });\n\n  const days = differenceInDays(toDate, Date.now());\n  const hours = d?.hours || 0;\n  const minutes = d?.minutes || 0;\n  const seconds = d?.seconds || 0;\n  const lastHour = days === 0 && hours === 0;\n  const lastMinute = lastHour && minutes === 0;\n\n  return {\n    days,\n    hours,\n    minutes,\n    seconds,\n    lastMinute,\n  };\n};\n"]}

package/mjs/index.d.ts

@@ -2,4 +2,4 @@ export * from "./useEffectIgnoreInitial";
 export * from "./useOnResize";
 export * from "./useOutsideAlerter";
 export * from "./useSize";
-export * from "./useTimeleft";
+export * from "./useTimeLeft";

package/mjs/index.js

@@ -2,7 +2,7 @@ export * from "./useEffectIgnoreInitial";
 export * from "./useOnResize";
 export * from "./useOutsideAlerter";
 export * from "./useSize";
-export * from "./useTimeleft";
+export * from "./useTimeLeft";
 
 //# sourceMappingURL=index.js.map
 

package/mjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"AAGA,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from \"./useEffectIgnoreInitial\";\nexport * from \"./useOnResize\";\nexport * from \"./useOutsideAlerter\";\nexport * from \"./useSize\";\nexport * from \"./useTimeleft\";\n"]}
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"AAGA,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from \"./useEffectIgnoreInitial\";\nexport * from \"./useOnResize\";\nexport * from \"./useOutsideAlerter\";\nexport * from \"./useSize\";\nexport * from \"./useTimeLeft\";\n"]}

package/mjs/{useTimeleft → useTimeLeft}/defaults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useTimeleft/defaults.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC","file":"defaults.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { TimeleftDuration } from \"./types\";\n\nexport const defaultDuration: TimeleftDuration = {\n  days: 0,\n  hours: 0,\n  minutes: 0,\n  seconds: 0,\n  lastMinute: false,\n};\n\nexport const defaultRefreshInterval = 60;\n"]}
+{"version":3,"sources":["../src/useTimeLeft/defaults.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC","file":"defaults.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { TimeleftDuration } from \"./types\";\n\nexport const defaultDuration: TimeleftDuration = {\n  days: 0,\n  hours: 0,\n  minutes: 0,\n  seconds: 0,\n  lastMinute: false,\n};\n\nexport const defaultRefreshInterval = 60;\n"]}

package/mjs/useTimeLeft/index.d.ts

@@ -0,0 +1,7 @@
+import type { TimeLeftAll, TimeleftDuration, UseTimeleftProps } from "./types";
+export declare const useTimeLeft: (props?: UseTimeleftProps) => {
+    setFromNow: (dateFrom: Date, dateTo: Date) => void;
+    timeleft: TimeLeftAll;
+    secondsFromNow: (seconds: number) => Date;
+    getDurationFromNow: (toDate: Date | null) => TimeleftDuration;
+};

package/mjs/{useTimeleft → useTimeLeft}/index.js

@@ -1,6 +1,8 @@
 import { setStateWithRef } from "@w3ux/utils";
 import { useEffect, useRef, useState } from "react";
 import { getDuration } from "./utils";
+import { defaultDuration } from "./defaults";
+import { differenceInDays, getUnixTime, intervalToDuration } from "date-fns";
 export const useTimeLeft = (props) => {
     const depsTimeleft = props?.depsTimeleft || [];
     const depsFormat = props?.depsFormat || [];
@@ -72,9 +74,42 @@ export const useTimeLeft = (props) => {
         setTimeleft(getTimeleft(getDuration(dateFrom)));
         setStateWithRef(dateTo, setTo, toRef);
     };
+    const secondsFromNow = (seconds) => {
+        const end = new Date();
+        end.setSeconds(end.getSeconds() + seconds);
+        return end;
+    };
+    const getDurationFromNow = (toDate) => {
+        if (!toDate) {
+            return defaultDuration;
+        }
+        if (getUnixTime(toDate) <= getUnixTime(new Date())) {
+            return defaultDuration;
+        }
+        toDate.setSeconds(toDate.getSeconds());
+        const d = intervalToDuration({
+            start: Date.now(),
+            end: toDate,
+        });
+        const days = differenceInDays(toDate, Date.now());
+        const hours = d?.hours || 0;
+        const minutes = d?.minutes || 0;
+        const seconds = d?.seconds || 0;
+        const lastHour = days === 0 && hours === 0;
+        const lastMinute = lastHour && minutes === 0;
+        return {
+            days,
+            hours,
+            minutes,
+            seconds,
+            lastMinute,
+        };
+    };
     return {
         setFromNow,
         timeleft,
+        secondsFromNow,
+        getDurationFromNow,
     };
 };
 

package/mjs/useTimeLeft/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useTimeLeft/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAOpD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAwB,EAAE,EAAE;IACtD,MAAM,YAAY,GAAG,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,EAAE,CAAC;IAG3C,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;IACzB,CAAC,CAAC;IAGF,MAAM,mBAAmB,GAAG,GAAG,EAAE;QAC/B,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAGF,MAAM,WAAW,GAAG,CAAC,CAAoB,EAAe,EAAE;QACxD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAgB;YACvB,IAAI;YACJ,KAAK;YACL,OAAO;SACR,CAAC;QACF,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;QACxB,CAAC;QACD,OAAO;YACL,GAAG;SACJ,CAAC;IACJ,CAAC,CAAC;IAGF,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAc,IAAI,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAGzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAc,WAAW,EAAE,CAAC,CAAC;IAGrE,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAE5C,SAAS,CAAC,CAAC;IACb,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAE3C,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAE5C,SAAS,CAAC,CAAC;IACb,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAG3C,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3B,IAAI,UAAU,EAAE,EAAE,CAAC;YAEjB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;oBAChC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;wBAClB,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;wBACtC,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;oBAC7D,CAAC;oBACD,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC7B,CAAC,EAAE,IAAI,CAAC,CAAC;gBAET,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;aAEI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;gBAChC,IAAI,UAAU,EAAE,EAAE,CAAC;oBACjB,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;oBACtC,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;gBAC7D,CAAC;gBACD,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7B,CAAC,EAAE,KAAK,CAAC,CAAC;YACV,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,mBAAmB,EAAE,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAG/D,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAGpB,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,aAAa,CAAC,WAAW,CAAC,CAAC;QAC3B,aAAa,CAAC,WAAW,CAAC,CAAC;IAC7B,CAAC,EACD,EAAE,CACH,CAAC;IAGF,MAAM,UAAU,GAAG,CAAC,QAAc,EAAE,MAAY,EAAE,EAAE;QAClD,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChD,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC;IAGF,MAAM,cAAc,GAAG,CAAC,OAAe,EAAQ,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAGF,MAAM,kBAAkB,GAAG,CAAC,MAAmB,EAAoB,EAAE;QACnE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YACnD,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,kBAAkB,CAAC;YAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;YACjB,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC;QAE7C,OAAO;YACL,IAAI;YACJ,KAAK;YACL,OAAO;YACP,OAAO;YACP,UAAU;SACX,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,UAAU;QACV,QAAQ;QACR,cAAc;QACd,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { setStateWithRef } from \"@w3ux/utils\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type {\n  TimeLeftAll,\n  TimeLeftRaw,\n  TimeleftDuration,\n  UseTimeleftProps,\n} from \"./types\";\nimport { getDuration } from \"./utils\";\nimport { defaultDuration } from \"./defaults\";\nimport { differenceInDays, getUnixTime, intervalToDuration } from \"date-fns\";\n\nexport const useTimeLeft = (props?: UseTimeleftProps) => {\n  const depsTimeleft = props?.depsTimeleft || [];\n  const depsFormat = props?.depsFormat || [];\n\n  // check whether timeleft is within a minute of finishing.\n  const inLastHour = () => {\n    const { days, hours } = getDuration(toRef.current);\n    return !days && !hours;\n  };\n\n  // get the amount of seconds left if timeleft is in the last minute.\n  const lastMinuteCountdown = () => {\n    const { seconds } = getDuration(toRef.current);\n    if (!inLastHour()) {\n      return 60;\n    }\n    return seconds;\n  };\n\n  // calculate resulting timeleft object from latest duration.\n  const getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n    const { days, hours, minutes, seconds } = c || getDuration(toRef.current);\n    const raw: TimeLeftRaw = {\n      days,\n      hours,\n      minutes,\n    };\n    if (!days && !hours) {\n      raw.seconds = seconds;\n    }\n    return {\n      raw,\n    };\n  };\n\n  // the end time as a date.\n  const [to, setTo] = useState<Date | null>(null);\n  const toRef = useRef(to);\n\n  // resulting timeleft object to be returned.\n  const [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft());\n\n  // timeleft refresh intervals.\n  const [minInterval, setMinInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const minIntervalRef = useRef(minInterval);\n\n  const [secInterval, setSecInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const secIntervalRef = useRef(secInterval);\n\n  // refresh effects.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n    if (inLastHour()) {\n      // refresh timeleft every second.\n      if (!secIntervalRef.current) {\n        const interval = setInterval(() => {\n          if (!inLastHour()) {\n            clearInterval(secIntervalRef.current);\n            setStateWithRef(undefined, setSecInterval, secIntervalRef);\n          }\n          setTimeleft(getTimeleft());\n        }, 1000);\n\n        setStateWithRef(interval, setSecInterval, secIntervalRef);\n      }\n    }\n    // refresh timeleft every minute.\n    else if (!minIntervalRef.current) {\n      const interval = setInterval(() => {\n        if (inLastHour()) {\n          clearInterval(minIntervalRef.current);\n          setStateWithRef(undefined, setMinInterval, minIntervalRef);\n        }\n        setTimeleft(getTimeleft());\n      }, 60000);\n      setStateWithRef(interval, setMinInterval, minIntervalRef);\n    }\n  }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);\n\n  // re-render the timeleft upon formatting changes.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n  }, [...depsFormat]);\n\n  // clear intervals on unmount\n  useEffect(\n    () => () => {\n      clearInterval(minInterval);\n      clearInterval(secInterval);\n    },\n    []\n  );\n\n  // Set the end time and calculate timeleft.\n  const setFromNow = (dateFrom: Date, dateTo: Date) => {\n    setTimeleft(getTimeleft(getDuration(dateFrom)));\n    setStateWithRef(dateTo, setTo, toRef);\n  };\n\n  // Helper: Adds `seconds` to the current time and returns the resulting date.\n  const secondsFromNow = (seconds: number): Date => {\n    const end = new Date();\n    end.setSeconds(end.getSeconds() + seconds);\n    return end;\n  };\n\n  // Helper: Calculates the duration between the current time and the provided date.\n  const getDurationFromNow = (toDate: Date | null): TimeleftDuration => {\n    if (!toDate) {\n      return defaultDuration;\n    }\n    if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n      return defaultDuration;\n    }\n\n    toDate.setSeconds(toDate.getSeconds());\n    const d = intervalToDuration({\n      start: Date.now(),\n      end: toDate,\n    });\n\n    const days = differenceInDays(toDate, Date.now());\n    const hours = d?.hours || 0;\n    const minutes = d?.minutes || 0;\n    const seconds = d?.seconds || 0;\n    const lastHour = days === 0 && hours === 0;\n    const lastMinute = lastHour && minutes === 0;\n\n    return {\n      days,\n      hours,\n      minutes,\n      seconds,\n      lastMinute,\n    };\n  };\n\n  return {\n    setFromNow,\n    timeleft,\n    secondsFromNow,\n    getDurationFromNow,\n  };\n};\n"]}

package/mjs/{useTimeleft → useTimeLeft}/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useTimeleft/types.ts"],"names":[],"mappings":"","file":"types.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport interface UseTimeleftProps {\n  // Dependencies to trigger re-calculation of timeleft.\n  depsTimeleft: unknown[];\n  // Dependencies to trigger re-render of timeleft, e.g. if language switching occurs.\n  depsFormat: unknown[];\n}\n\nexport interface TimeleftDuration {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds: number;\n  lastMinute: boolean;\n}\n\nexport interface TimeLeftRaw {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds?: number;\n}\n\nexport interface TimeLeftFormatted {\n  days: [number, string];\n  hours: [number, string];\n  minutes: [number, string];\n  seconds?: [number, string];\n}\n\nexport interface TimeLeftAll {\n  raw: TimeLeftRaw;\n}\n\nexport interface TimeleftHookProps {\n  refreshInterval: number;\n}\n"]}
+{"version":3,"sources":["../src/useTimeLeft/types.ts"],"names":[],"mappings":"","file":"types.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport interface UseTimeleftProps {\n  // Dependencies to trigger re-calculation of timeleft.\n  depsTimeleft: unknown[];\n  // Dependencies to trigger re-render of timeleft, e.g. if language switching occurs.\n  depsFormat: unknown[];\n}\n\nexport interface TimeleftDuration {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds: number;\n  lastMinute: boolean;\n}\n\nexport interface TimeLeftRaw {\n  days: number;\n  hours: number;\n  minutes: number;\n  seconds?: number;\n}\n\nexport interface TimeLeftFormatted {\n  days: [number, string];\n  hours: [number, string];\n  minutes: [number, string];\n  seconds?: [number, string];\n}\n\nexport interface TimeLeftAll {\n  raw: TimeLeftRaw;\n}\n\nexport interface TimeleftHookProps {\n  refreshInterval: number;\n}\n"]}

package/mjs/{useTimeleft → useTimeLeft}/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useTimeleft/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAoB,EAAE;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,kBAAkB,CAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC;IAE7C,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC,CAAC","file":"utils.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { differenceInDays, getUnixTime, intervalToDuration } from \"date-fns\";\nimport { defaultDuration } from \"./defaults\";\nimport type { TimeleftDuration } from \"./types\";\n\n// calculates the current timeleft duration.\nexport const getDuration = (toDate: Date | null): TimeleftDuration => {\n  if (!toDate) {\n    return defaultDuration;\n  }\n  if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n    return defaultDuration;\n  }\n\n  toDate.setSeconds(toDate.getSeconds());\n  const d = intervalToDuration({\n    start: Date.now(),\n    end: toDate,\n  });\n\n  const days = differenceInDays(toDate, Date.now());\n  const hours = d?.hours || 0;\n  const minutes = d?.minutes || 0;\n  const seconds = d?.seconds || 0;\n  const lastHour = days === 0 && hours === 0;\n  const lastMinute = lastHour && minutes === 0;\n\n  return {\n    days,\n    hours,\n    minutes,\n    seconds,\n    lastMinute,\n  };\n};\n"]}
+{"version":3,"sources":["../src/useTimeLeft/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAoB,EAAE;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,kBAAkB,CAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC;IAE7C,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC,CAAC","file":"utils.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { differenceInDays, getUnixTime, intervalToDuration } from \"date-fns\";\nimport { defaultDuration } from \"./defaults\";\nimport type { TimeleftDuration } from \"./types\";\n\n// calculates the current timeleft duration.\nexport const getDuration = (toDate: Date | null): TimeleftDuration => {\n  if (!toDate) {\n    return defaultDuration;\n  }\n  if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n    return defaultDuration;\n  }\n\n  toDate.setSeconds(toDate.getSeconds());\n  const d = intervalToDuration({\n    start: Date.now(),\n    end: toDate,\n  });\n\n  const days = differenceInDays(toDate, Date.now());\n  const hours = d?.hours || 0;\n  const minutes = d?.minutes || 0;\n  const seconds = d?.seconds || 0;\n  const lastHour = days === 0 && hours === 0;\n  const lastMinute = lastHour && minutes === 0;\n\n  return {\n    days,\n    hours,\n    minutes,\n    seconds,\n    lastMinute,\n  };\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w3ux/hooks",
-  "version": "1.3.1-beta.0",
+  "version": "1.3.1-beta.1",
   "license": "GPL-3.0-only",
   "dependencies": {
     "@w3ux/utils": "^1.1.1-beta.9",

package/cjs/useTimeleft/index.d.ts

@@ -1,5 +0,0 @@
-import type { TimeLeftAll, UseTimeleftProps } from "./types";
-export declare const useTimeLeft: (props?: UseTimeleftProps) => {
-    setFromNow: (dateFrom: Date, dateTo: Date) => void;
-    timeleft: TimeLeftAll;
-};

package/cjs/useTimeleft/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useTimeleft/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { setStateWithRef } from \"@w3ux/utils\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type {\n  TimeLeftAll,\n  TimeLeftRaw,\n  TimeleftDuration,\n  UseTimeleftProps,\n} from \"./types\";\nimport { getDuration } from \"./utils\";\n\nexport const useTimeLeft = (props?: UseTimeleftProps) => {\n  const depsTimeleft = props?.depsTimeleft || [];\n  const depsFormat = props?.depsFormat || [];\n\n  // check whether timeleft is within a minute of finishing.\n  const inLastHour = () => {\n    const { days, hours } = getDuration(toRef.current);\n    return !days && !hours;\n  };\n\n  // get the amount of seconds left if timeleft is in the last minute.\n  const lastMinuteCountdown = () => {\n    const { seconds } = getDuration(toRef.current);\n    if (!inLastHour()) {\n      return 60;\n    }\n    return seconds;\n  };\n\n  // calculate resulting timeleft object from latest duration.\n  const getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n    const { days, hours, minutes, seconds } = c || getDuration(toRef.current);\n    const raw: TimeLeftRaw = {\n      days,\n      hours,\n      minutes,\n    };\n    if (!days && !hours) {\n      raw.seconds = seconds;\n    }\n    return {\n      raw,\n    };\n  };\n\n  // the end time as a date.\n  const [to, setTo] = useState<Date | null>(null);\n  const toRef = useRef(to);\n\n  // resulting timeleft object to be returned.\n  const [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft());\n\n  // timeleft refresh intervals.\n  const [minInterval, setMinInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const minIntervalRef = useRef(minInterval);\n\n  const [secInterval, setSecInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const secIntervalRef = useRef(secInterval);\n\n  // refresh effects.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n    if (inLastHour()) {\n      // refresh timeleft every second.\n      if (!secIntervalRef.current) {\n        const interval = setInterval(() => {\n          if (!inLastHour()) {\n            clearInterval(secIntervalRef.current);\n            setStateWithRef(undefined, setSecInterval, secIntervalRef);\n          }\n          setTimeleft(getTimeleft());\n        }, 1000);\n\n        setStateWithRef(interval, setSecInterval, secIntervalRef);\n      }\n    }\n    // refresh timeleft every minute.\n    else if (!minIntervalRef.current) {\n      const interval = setInterval(() => {\n        if (inLastHour()) {\n          clearInterval(minIntervalRef.current);\n          setStateWithRef(undefined, setMinInterval, minIntervalRef);\n        }\n        setTimeleft(getTimeleft());\n      }, 60000);\n      setStateWithRef(interval, setMinInterval, minIntervalRef);\n    }\n  }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);\n\n  // re-render the timeleft upon formatting changes.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n  }, [...depsFormat]);\n\n  // clear intervals on unmount\n  useEffect(\n    () => () => {\n      clearInterval(minInterval);\n      clearInterval(secInterval);\n    },\n    []\n  );\n\n  const setFromNow = (dateFrom: Date, dateTo: Date) => {\n    setTimeleft(getTimeleft(getDuration(dateFrom)));\n    setStateWithRef(dateTo, setTo, toRef);\n  };\n\n  return {\n    setFromNow,\n    timeleft,\n  };\n};\n"]}

package/mjs/useTimeleft/index.d.ts

@@ -1,5 +0,0 @@
-import type { TimeLeftAll, UseTimeleftProps } from "./types";
-export declare const useTimeLeft: (props?: UseTimeleftProps) => {
-    setFromNow: (dateFrom: Date, dateTo: Date) => void;
-    timeleft: TimeLeftAll;
-};

package/mjs/useTimeleft/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useTimeleft/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { setStateWithRef } from \"@w3ux/utils\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type {\n  TimeLeftAll,\n  TimeLeftRaw,\n  TimeleftDuration,\n  UseTimeleftProps,\n} from \"./types\";\nimport { getDuration } from \"./utils\";\n\nexport const useTimeLeft = (props?: UseTimeleftProps) => {\n  const depsTimeleft = props?.depsTimeleft || [];\n  const depsFormat = props?.depsFormat || [];\n\n  // check whether timeleft is within a minute of finishing.\n  const inLastHour = () => {\n    const { days, hours } = getDuration(toRef.current);\n    return !days && !hours;\n  };\n\n  // get the amount of seconds left if timeleft is in the last minute.\n  const lastMinuteCountdown = () => {\n    const { seconds } = getDuration(toRef.current);\n    if (!inLastHour()) {\n      return 60;\n    }\n    return seconds;\n  };\n\n  // calculate resulting timeleft object from latest duration.\n  const getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n    const { days, hours, minutes, seconds } = c || getDuration(toRef.current);\n    const raw: TimeLeftRaw = {\n      days,\n      hours,\n      minutes,\n    };\n    if (!days && !hours) {\n      raw.seconds = seconds;\n    }\n    return {\n      raw,\n    };\n  };\n\n  // the end time as a date.\n  const [to, setTo] = useState<Date | null>(null);\n  const toRef = useRef(to);\n\n  // resulting timeleft object to be returned.\n  const [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft());\n\n  // timeleft refresh intervals.\n  const [minInterval, setMinInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const minIntervalRef = useRef(minInterval);\n\n  const [secInterval, setSecInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined);\n  const secIntervalRef = useRef(secInterval);\n\n  // refresh effects.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n    if (inLastHour()) {\n      // refresh timeleft every second.\n      if (!secIntervalRef.current) {\n        const interval = setInterval(() => {\n          if (!inLastHour()) {\n            clearInterval(secIntervalRef.current);\n            setStateWithRef(undefined, setSecInterval, secIntervalRef);\n          }\n          setTimeleft(getTimeleft());\n        }, 1000);\n\n        setStateWithRef(interval, setSecInterval, secIntervalRef);\n      }\n    }\n    // refresh timeleft every minute.\n    else if (!minIntervalRef.current) {\n      const interval = setInterval(() => {\n        if (inLastHour()) {\n          clearInterval(minIntervalRef.current);\n          setStateWithRef(undefined, setMinInterval, minIntervalRef);\n        }\n        setTimeleft(getTimeleft());\n      }, 60000);\n      setStateWithRef(interval, setMinInterval, minIntervalRef);\n    }\n  }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);\n\n  // re-render the timeleft upon formatting changes.\n  useEffect(() => {\n    setTimeleft(getTimeleft());\n  }, [...depsFormat]);\n\n  // clear intervals on unmount\n  useEffect(\n    () => () => {\n      clearInterval(minInterval);\n      clearInterval(secInterval);\n    },\n    []\n  );\n\n  const setFromNow = (dateFrom: Date, dateTo: Date) => {\n    setTimeleft(getTimeleft(getDuration(dateFrom)));\n    setStateWithRef(dateTo, setTo, toRef);\n  };\n\n  return {\n    setFromNow,\n    timeleft,\n  };\n};\n"]}