@cripty2001/utils 0.0.38 → 0.0.40

package/dist/react-whispr.d.ts

@@ -56,3 +56,10 @@ export declare function useDebounced<T>(value: T): T;
  * @type O Output for the async function
  */
 export declare function useAsync<I, O>(f: (input: I, setProgress: (p: number) => void, signal: AbortSignal) => Promise<O>, data: I, debouce?: number): Dispatcher<I, O>;
+/**
+ * Format a timestamp into a relative time string (e.g. "5 minutes ago", "in 2 hours"), using the browser locale.
+ * The refreshed time is reactive.
+ * @param refresh The refresh interval, in milliseconds. Default to 1000ms.
+ * @returns A callback (reactive, will change on refresh) that formats a given timestamp into a relative time string.
+ */
+export declare function useRelTime(refresh?: number): (ts: Date | number) => string;

package/dist/react-whispr.js

@@ -6,6 +6,7 @@ exports.useOnWhispr = useOnWhispr;
 exports.useCurrentTimestamp = useCurrentTimestamp;
 exports.useDebounced = useDebounced;
 exports.useAsync = useAsync;
+exports.useRelTime = useRelTime;
 const whispr_1 = require("@cripty2001/whispr");
 const react_1 = require("react");
 const lodash_1 = require("lodash");
@@ -118,3 +119,21 @@ function useAsync(f, data, debouce = 200) {
     // Returning dispatcher
     return dispatcher;
 }
+/**
+ * Format a timestamp into a relative time string (e.g. "5 minutes ago", "in 2 hours"), using the browser locale.
+ * The refreshed time is reactive.
+ * @param refresh The refresh interval, in milliseconds. Default to 1000ms.
+ * @returns A callback (reactive, will change on refresh) that formats a given timestamp into a relative time string.
+ */
+function useRelTime(refresh = 1000) {
+    const currTs = useCurrentTimestamp(refresh);
+    const rtf = (0, react_1.useRef)(new Intl.RelativeTimeFormat(navigator.language, { numeric: "auto" })).current;
+    const cb = (0, react_1.useCallback)((ts) => {
+        const now = currTs;
+        const then = ts instanceof Date ? ts.getTime() : ts;
+        const delta = then - now;
+        const seconds = Math.round(delta / 1000);
+        return rtf.format(seconds, "second");
+    }, [currTs, rtf]);
+    return cb;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cripty2001/utils",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "Internal Set of utils. If you need them use them, otherwise go to the next package ;)",
   "homepage": "https://github.com/cripty2001/utils#readme",
   "bugs": {
@@ -29,7 +29,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@cripty2001/whispr": "^0.1.0",
+    "@cripty2001/whispr": "^0.2.0",
     "@types/lodash": "^4.17.20",
     "lodash": "^4.17.21"
   },