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

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 → useTimeLeft}/index.js.map

@@ -1 +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\";\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"]}
+{"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  // 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  return {\n    setFromNow,\n    timeleft,\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/utils.d.ts

@@ -0,0 +1,4 @@
+import type { TimeleftDuration } from "./types";
+export declare const getDuration: (toDate: Date | null) => TimeleftDuration;
+export declare const secondsFromNow: (seconds: number) => Date;
+export declare const getDurationFromNow: (toDate: Date | null) => TimeleftDuration;

package/cjs/useTimeLeft/utils.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDurationFromNow = exports.secondsFromNow = exports.getDuration = void 0;
+const date_fns_1 = require("date-fns");
+const defaults_1 = require("./defaults");
+const getDuration = (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,
+    };
+};
+exports.getDuration = getDuration;
+const secondsFromNow = (seconds) => {
+    const end = new Date();
+    end.setSeconds(end.getSeconds() + seconds);
+    return end;
+};
+exports.secondsFromNow = secondsFromNow;
+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,
+    };
+};
+exports.getDurationFromNow = getDurationFromNow;
+
+//# sourceMappingURL=utils.js.map
+
+//# sourceMappingURL=utils.js.map

package/cjs/useTimeLeft/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useTimeLeft/utils.ts"],"names":[],"mappings":"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","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\n// Helper: Adds `seconds` to the current time and returns the resulting date.\nexport 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.\nexport 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"]}

package/cjs/util.js

@@ -0,0 +1,5 @@
+
+
+//# sourceMappingURL=util.js.map
+
+//# sourceMappingURL=util.js.map

package/cjs/util.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util.ts"],"names":[],"mappings":"","file":"util.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\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 → useTimeLeft}/index.js.map

@@ -1 +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\";\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"]}
+{"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  // 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  return {\n    setFromNow,\n    timeleft,\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/utils.d.ts

@@ -0,0 +1,4 @@
+import type { TimeleftDuration } from "./types";
+export declare const getDuration: (toDate: Date | null) => TimeleftDuration;
+export declare const secondsFromNow: (seconds: number) => Date;
+export declare const getDurationFromNow: (toDate: Date | null) => TimeleftDuration;

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

@@ -26,6 +26,37 @@ export const getDuration = (toDate) => {
         lastMinute,
     };
 };
+export const secondsFromNow = (seconds) => {
+    const end = new Date();
+    end.setSeconds(end.getSeconds() + seconds);
+    return end;
+};
+export 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,
+    };
+};
 
 //# sourceMappingURL=utils.js.map
 

package/mjs/useTimeLeft/utils.js.map

@@ -0,0 +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;AAGF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAQ,EAAE;IACtD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAGF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAmB,EAAoB,EAAE;IAC1E,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\n// Helper: Adds `seconds` to the current time and returns the resulting date.\nexport 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.\nexport 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"]}

package/mjs/util.js

@@ -0,0 +1,5 @@
+
+
+//# sourceMappingURL=util.js.map
+
+//# sourceMappingURL=util.js.map

package/mjs/util.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util.ts"],"names":[],"mappings":"","file":"util.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w3ux/hooks",
-  "version": "1.3.1-beta.0",
+  "version": "1.3.1-beta.2",
   "license": "GPL-3.0-only",
   "dependencies": {
     "@w3ux/utils": "^1.1.1-beta.9",
@@ -12,6 +12,10 @@
     ".": {
       "import": "./mjs/index.js",
       "require": "./cjs/index.js"
+    },
+    "./utils": {
+      "import": "./mjs/utils/index.js",
+      "require": "./cjs/utils/index.js"
     }
   },
   "peerDependencies": {

package/cjs/useTimeleft/utils.d.ts

@@ -1,2 +0,0 @@
-import type { TimeleftDuration } from "./types";
-export declare const getDuration: (toDate: Date | null) => TimeleftDuration;

package/cjs/useTimeleft/utils.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDuration = void 0;
-const date_fns_1 = require("date-fns");
-const defaults_1 = require("./defaults");
-const getDuration = (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,
-    };
-};
-exports.getDuration = getDuration;
-
-//# sourceMappingURL=utils.js.map
-
-//# sourceMappingURL=utils.js.map

package/cjs/useTimeleft/utils.js.map

@@ -1 +0,0 @@
-{"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/useTimeleft/utils.d.ts

@@ -1,2 +0,0 @@
-import type { TimeleftDuration } from "./types";
-export declare const getDuration: (toDate: Date | null) => TimeleftDuration;

package/mjs/useTimeleft/utils.js.map

@@ -1 +0,0 @@
-{"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"]}