@herowcode/utils 1.1.0 → 1.1.1

package/dist/youtube/generate-youtube-url.js

@@ -0,0 +1,81 @@
+import { formatHMSToSeconds, formatSecondsToFragment } from "../string";
+import { extractYouTubeId } from "./extract-youtube-video-id";
+export const generateYoutubeURL = (opts) => {
+    const { videoURL, start, end, embed = false, short = false, useFragment = false, autoplay, controls, rel, loop, mute, modestbranding, origin, playlist, params = {}, } = opts;
+    const videoId = extractYouTubeId(videoURL);
+    if (!videoId)
+        return null;
+    const startSec = formatHMSToSeconds(start);
+    const endSec = formatHMSToSeconds(end);
+    // base url
+    const base = embed
+        ? `https://www.youtube.com/embed/${videoId}`
+        : short
+            ? `https://youtu.be/${videoId}`
+            : "https://www.youtube.com/watch";
+    const search = new URLSearchParams();
+    // Add video ID for watch URLs
+    if (!embed && !short) {
+        search.set("v", videoId);
+    }
+    // Standard param names for watch/embed
+    if (!useFragment) {
+        if (startSec != null) {
+            // youtu.be historically uses "t" as a query param, but "start" is widely supported.
+            // Use "t" for short links, otherwise "start".
+            search.set(short ? "t" : "start", String(startSec));
+        }
+        if (endSec != null) {
+            search.set("end", String(endSec));
+        }
+    }
+    // embed / player related params
+    if (typeof autoplay !== "undefined")
+        search.set("autoplay", autoplay ? "1" : "0");
+    if (typeof controls !== "undefined")
+        search.set("controls", String(controls));
+    if (typeof rel !== "undefined")
+        search.set("rel", String(rel));
+    if (typeof modestbranding !== "undefined")
+        search.set("modestbranding", String(modestbranding));
+    if (typeof origin !== "undefined")
+        search.set("origin", origin);
+    if (typeof mute !== "undefined")
+        search.set("mute", mute ? "1" : "0");
+    // loop requires playlist param when embedding a single video
+    if (loop) {
+        search.set("loop", "1");
+        if (playlist) {
+            search.set("playlist", playlist);
+        }
+        else if (embed) {
+            // for embed+loop, YouTube expects &playlist=VIDEO_ID
+            search.set("playlist", videoId);
+        }
+    }
+    else if (playlist) {
+        search.set("playlist", playlist);
+    }
+    // merge custom params (allow overriding)
+    Object.entries(params).forEach(([k, v]) => {
+        if (v === false)
+            search.set(k, "0");
+        else if (v === true)
+            search.set(k, "1");
+        else
+            search.set(k, String(v));
+    });
+    const qs = search.toString() ? `?${search.toString()}` : "";
+    // fragment handling (e.g. #t=1m2s)
+    let fragment = "";
+    if (useFragment && startSec != null) {
+        fragment = `#t=${formatSecondsToFragment(startSec)}`;
+    }
+    // For short links, people often prefer the short host and start as query or fragment.
+    if (short) {
+        // prefer fragment if requested, otherwise use search params (t)
+        return `${base}${qs}${fragment}`;
+    }
+    // watch/embed links
+    return `${base}${qs}${fragment}`;
+};

package/dist/youtube/generate-youtube-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-youtube-url.js","sourceRoot":"","sources":["../../src/youtube/generate-youtube-url.ts"],"names":[],"mappings":"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"}

package/dist/youtube/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./extract-youtube-video-id";
+export * from "./generate-youtube-url";
+export * from "./use-get-video-duration";
+export * from "./validate-youtube-link";
+//# sourceMappingURL=index.d.ts.map

package/dist/youtube/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/youtube/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA"}

package/dist/youtube/index.esm.js

@@ -0,0 +1,4 @@
+export * from "./extract-youtube-video-id";
+export * from "./generate-youtube-url";
+export * from "./use-get-video-duration";
+export * from "./validate-youtube-link";

package/dist/youtube/index.js

@@ -0,0 +1,4 @@
+export * from "./extract-youtube-video-id";
+export * from "./generate-youtube-url";
+export * from "./use-get-video-duration";
+export * from "./validate-youtube-link";

package/dist/youtube/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/youtube/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA0C;AAC1C,yDAAsC;AACtC,2DAAwC;AACxC,0DAAuC"}

package/dist/youtube/use-get-video-duration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useGetYoutubeVideoDuration
+ * Returns a function that accepts a YouTube URL (full or short) and returns a Promise
+ * resolving to the video duration formatted as "HH:MM:SS" or null on failure.
+ */
+export declare function useGetYoutubeVideoDuration(): (videoUrl: string) => Promise<string | null>;
+//# sourceMappingURL=use-get-video-duration.d.ts.map

package/dist/youtube/use-get-video-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-get-video-duration.d.ts","sourceRoot":"","sources":["../../src/youtube/use-get-video-duration.ts"],"names":[],"mappings":"AAwCA;;;;GAIG;AACH,wBAAgB,0BAA0B,eAErB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0GnD"}

package/dist/youtube/use-get-video-duration.esm.js

@@ -0,0 +1,150 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Window is any */
+import { useCallback } from "react";
+import { formatSecondsToHMS } from "../string";
+import { extractYouTubeId } from "./extract-youtube-video-id";
+import { validateYoutubeLink } from "./validate-youtube-link";
+let YtApiLoading = null;
+function loadYouTubeIFrameAPI() {
+    var _a;
+    if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player)
+        return Promise.resolve();
+    if (YtApiLoading)
+        return YtApiLoading;
+    YtApiLoading = new Promise((resolve) => {
+        const existing = document.querySelector('script[src="https://www.youtube.com/iframe_api"]');
+        if (existing) {
+            // Poll until the API is ready
+            const poll = setInterval(() => {
+                var _a;
+                if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player) {
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 50);
+            return;
+        }
+        const tag = document.createElement("script");
+        tag.src = "https://www.youtube.com/iframe_api";
+        tag.async = true;
+        document.body.appendChild(tag);
+        window.onYouTubeIframeAPIReady = () => {
+            resolve();
+        };
+    });
+    return YtApiLoading;
+}
+/**
+ * useGetYoutubeVideoDuration
+ * Returns a function that accepts a YouTube URL (full or short) and returns a Promise
+ * resolving to the video duration formatted as "HH:MM:SS" or null on failure.
+ */
+export function useGetYoutubeVideoDuration() {
+    const getYoutubeVideoDuration = useCallback(async (videoUrl) => {
+        const videoId = extractYouTubeId(videoUrl);
+        if (!videoId)
+            return null;
+        const videoIsValid = await validateYoutubeLink(videoUrl);
+        if (!videoIsValid)
+            return null;
+        try {
+            await loadYouTubeIFrameAPI();
+        }
+        catch (_a) {
+            return null;
+        }
+        return await new Promise((resolve) => {
+            const iframeId = `yt-duration-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+            const iframe = document.createElement("iframe");
+            // create a minimal offscreen iframe for the player
+            iframe.id = iframeId;
+            iframe.style.position = "fixed";
+            iframe.style.left = "-9999px";
+            iframe.style.width = "1px";
+            iframe.style.height = "1px";
+            iframe.style.opacity = "0";
+            iframe.style.pointerEvents = "none";
+            // embed URL with enablejsapi so we can construct YT.Player
+            const origin = window.location.origin;
+            iframe.src = `https://www.youtube.com/embed/${encodeURIComponent(videoId)}?enablejsapi=1&origin=${encodeURIComponent(origin)}`;
+            let resolved = false;
+            let player = null;
+            let cleanupTimeout = null;
+            function cleanupAndResolve(result) {
+                if (resolved)
+                    return;
+                resolved = true;
+                try {
+                    if (player && typeof player.destroy === "function")
+                        player.destroy();
+                }
+                catch (_a) {
+                    /* ignore */
+                }
+                try {
+                    if (iframe.parentNode)
+                        iframe.parentNode.removeChild(iframe);
+                }
+                catch (_b) {
+                    /* ignore */
+                }
+                if (cleanupTimeout)
+                    window.clearTimeout(cleanupTimeout);
+                resolve(result);
+            }
+            // timeout fallback
+            cleanupTimeout = window.setTimeout(() => {
+                cleanupAndResolve(null);
+            }, 10000); // 10s timeout
+            document.body.appendChild(iframe);
+            // Construct player
+            try {
+                player = new window.YT.Player(iframeId, {
+                    events: {
+                        onReady: (e) => {
+                            try {
+                                let duration = e.target.getDuration();
+                                if (!duration || duration === 0) {
+                                    // Sometimes duration is 0 immediately; try a few short retries
+                                    let attempts = 0;
+                                    const tryInterval = setInterval(() => {
+                                        attempts += 1;
+                                        try {
+                                            duration = e.target.getDuration();
+                                            if (duration && duration > 0) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(formatSecondsToHMS(duration));
+                                            }
+                                            else if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                        catch (_a) {
+                                            if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                    }, 300);
+                                }
+                                else {
+                                    cleanupAndResolve(formatSecondsToHMS(duration));
+                                }
+                            }
+                            catch (_a) {
+                                cleanupAndResolve(null);
+                            }
+                        },
+                        onError: () => {
+                            cleanupAndResolve(null);
+                        },
+                    },
+                });
+            }
+            catch (_a) {
+                cleanupAndResolve(null);
+            }
+        });
+    }, []);
+    return getYoutubeVideoDuration;
+}

package/dist/youtube/use-get-video-duration.js

@@ -0,0 +1,150 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Window is any */
+import { useCallback } from "react";
+import { formatSecondsToHMS } from "../string";
+import { extractYouTubeId } from "./extract-youtube-video-id";
+import { validateYoutubeLink } from "./validate-youtube-link";
+let YtApiLoading = null;
+function loadYouTubeIFrameAPI() {
+    var _a;
+    if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player)
+        return Promise.resolve();
+    if (YtApiLoading)
+        return YtApiLoading;
+    YtApiLoading = new Promise((resolve) => {
+        const existing = document.querySelector('script[src="https://www.youtube.com/iframe_api"]');
+        if (existing) {
+            // Poll until the API is ready
+            const poll = setInterval(() => {
+                var _a;
+                if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player) {
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 50);
+            return;
+        }
+        const tag = document.createElement("script");
+        tag.src = "https://www.youtube.com/iframe_api";
+        tag.async = true;
+        document.body.appendChild(tag);
+        window.onYouTubeIframeAPIReady = () => {
+            resolve();
+        };
+    });
+    return YtApiLoading;
+}
+/**
+ * useGetYoutubeVideoDuration
+ * Returns a function that accepts a YouTube URL (full or short) and returns a Promise
+ * resolving to the video duration formatted as "HH:MM:SS" or null on failure.
+ */
+export function useGetYoutubeVideoDuration() {
+    const getYoutubeVideoDuration = useCallback(async (videoUrl) => {
+        const videoId = extractYouTubeId(videoUrl);
+        if (!videoId)
+            return null;
+        const videoIsValid = await validateYoutubeLink(videoUrl);
+        if (!videoIsValid)
+            return null;
+        try {
+            await loadYouTubeIFrameAPI();
+        }
+        catch (_a) {
+            return null;
+        }
+        return await new Promise((resolve) => {
+            const iframeId = `yt-duration-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+            const iframe = document.createElement("iframe");
+            // create a minimal offscreen iframe for the player
+            iframe.id = iframeId;
+            iframe.style.position = "fixed";
+            iframe.style.left = "-9999px";
+            iframe.style.width = "1px";
+            iframe.style.height = "1px";
+            iframe.style.opacity = "0";
+            iframe.style.pointerEvents = "none";
+            // embed URL with enablejsapi so we can construct YT.Player
+            const origin = window.location.origin;
+            iframe.src = `https://www.youtube.com/embed/${encodeURIComponent(videoId)}?enablejsapi=1&origin=${encodeURIComponent(origin)}`;
+            let resolved = false;
+            let player = null;
+            let cleanupTimeout = null;
+            function cleanupAndResolve(result) {
+                if (resolved)
+                    return;
+                resolved = true;
+                try {
+                    if (player && typeof player.destroy === "function")
+                        player.destroy();
+                }
+                catch (_a) {
+                    /* ignore */
+                }
+                try {
+                    if (iframe.parentNode)
+                        iframe.parentNode.removeChild(iframe);
+                }
+                catch (_b) {
+                    /* ignore */
+                }
+                if (cleanupTimeout)
+                    window.clearTimeout(cleanupTimeout);
+                resolve(result);
+            }
+            // timeout fallback
+            cleanupTimeout = window.setTimeout(() => {
+                cleanupAndResolve(null);
+            }, 10000); // 10s timeout
+            document.body.appendChild(iframe);
+            // Construct player
+            try {
+                player = new window.YT.Player(iframeId, {
+                    events: {
+                        onReady: (e) => {
+                            try {
+                                let duration = e.target.getDuration();
+                                if (!duration || duration === 0) {
+                                    // Sometimes duration is 0 immediately; try a few short retries
+                                    let attempts = 0;
+                                    const tryInterval = setInterval(() => {
+                                        attempts += 1;
+                                        try {
+                                            duration = e.target.getDuration();
+                                            if (duration && duration > 0) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(formatSecondsToHMS(duration));
+                                            }
+                                            else if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                        catch (_a) {
+                                            if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                    }, 300);
+                                }
+                                else {
+                                    cleanupAndResolve(formatSecondsToHMS(duration));
+                                }
+                            }
+                            catch (_a) {
+                                cleanupAndResolve(null);
+                            }
+                        },
+                        onError: () => {
+                            cleanupAndResolve(null);
+                        },
+                    },
+                });
+            }
+            catch (_a) {
+                cleanupAndResolve(null);
+            }
+        });
+    }, []);
+    return getYoutubeVideoDuration;
+}

package/dist/youtube/use-get-video-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-get-video-duration.js","sourceRoot":"","sources":["../../src/youtube/use-get-video-duration.ts"],"names":[],"mappings":"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"}

package/dist/youtube/validate-youtube-link.d.ts

@@ -0,0 +1,2 @@
+export declare function validateYoutubeLink(videoUrl: string): Promise<boolean>;
+//# sourceMappingURL=validate-youtube-link.d.ts.map

package/dist/youtube/validate-youtube-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-youtube-link.d.ts","sourceRoot":"","sources":["../../src/youtube/validate-youtube-link.ts"],"names":[],"mappings":"AAAA,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0C5E"}

package/dist/youtube/validate-youtube-link.esm.js

@@ -0,0 +1,40 @@
+export async function validateYoutubeLink(videoUrl) {
+    const { extractYouTubeId } = await import("./extract-youtube-video-id");
+    const videoId = extractYouTubeId(videoUrl);
+    if (!videoId)
+        return false;
+    // Try loading YouTube thumbnail images — avoids CORS problems because
+    // creating an Image and listening for load/error is not blocked by CORS.
+    const thumbs = [
+        `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/hqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/mqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/default.jpg`,
+    ];
+    const loadImage = (src) => new Promise((resolve) => {
+        const img = new Image();
+        img.onload = () => resolve(true);
+        img.onerror = () => resolve(false);
+        img.src = src;
+    });
+    for (const url of thumbs) {
+        try {
+            const ok = await loadImage(url);
+            if (ok)
+                return true;
+        }
+        catch (_a) {
+            // ignore and try next thumbnail
+        }
+    }
+    // Fallback: try oEmbed endpoint (may be subject to CORS in some environments)
+    try {
+        const watchUrl = `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
+        const oembedUrl = `https://www.youtube.com/oembed?url=${encodeURIComponent(watchUrl)}&format=json`;
+        const res = await fetch(oembedUrl, { method: "GET" });
+        return res.ok;
+    }
+    catch (_b) {
+        return false;
+    }
+}

package/dist/youtube/validate-youtube-link.js

@@ -0,0 +1,40 @@
+export async function validateYoutubeLink(videoUrl) {
+    const { extractYouTubeId } = await import("./extract-youtube-video-id");
+    const videoId = extractYouTubeId(videoUrl);
+    if (!videoId)
+        return false;
+    // Try loading YouTube thumbnail images — avoids CORS problems because
+    // creating an Image and listening for load/error is not blocked by CORS.
+    const thumbs = [
+        `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/hqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/mqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/default.jpg`,
+    ];
+    const loadImage = (src) => new Promise((resolve) => {
+        const img = new Image();
+        img.onload = () => resolve(true);
+        img.onerror = () => resolve(false);
+        img.src = src;
+    });
+    for (const url of thumbs) {
+        try {
+            const ok = await loadImage(url);
+            if (ok)
+                return true;
+        }
+        catch (_a) {
+            // ignore and try next thumbnail
+        }
+    }
+    // Fallback: try oEmbed endpoint (may be subject to CORS in some environments)
+    try {
+        const watchUrl = `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
+        const oembedUrl = `https://www.youtube.com/oembed?url=${encodeURIComponent(watchUrl)}&format=json`;
+        const res = await fetch(oembedUrl, { method: "GET" });
+        return res.ok;
+    }
+    catch (_b) {
+        return false;
+    }
+}

package/dist/youtube/validate-youtube-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-youtube-link.js","sourceRoot":"","sources":["../../src/youtube/validate-youtube-link.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDA0CC;AA1CM,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,4BAA4B,GAAC,CAAA;IACvE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAE1B,sEAAsE;IACtE,yEAAyE;IACzE,MAAM,MAAM,GAAG;QACb,8BAA8B,OAAO,oBAAoB;QACzD,8BAA8B,OAAO,gBAAgB;QACrD,8BAA8B,OAAO,gBAAgB;QACrD,8BAA8B,OAAO,cAAc;KACpD,CAAA;IAED,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE,CAChC,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;QACvB,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChC,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAClC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACf,CAAC,CAAC,CAAA;IAEJ,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;YAC/B,IAAI,EAAE;gBAAE,OAAO,IAAI,CAAA;QACrB,CAAC;QAAC,WAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mCAAmC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAA;QACjF,MAAM,SAAS,GAAG,sCAAsC,kBAAkB,CACxE,QAAQ,CACT,cAAc,CAAA;QACf,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;QACrD,OAAO,GAAG,CAAC,EAAE,CAAA;IACf,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herowcode/utils",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A lightweight collection of utility functions for everyday JavaScript/TypeScript development",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -35,6 +35,11 @@
       "types": "./dist/function.d.ts",
       "import": "./dist/function.esm.js",
       "require": "./dist/function.js"
+    },
+    "./youtube": {
+      "types": "./dist/youtube.d.ts",
+      "import": "./dist/youtube.esm.js",
+      "require": "./dist/youtube.js"
     }
   },
   "files": [
@@ -47,14 +52,15 @@
     "build:types": "tsc --project tsconfig.types.json",
     "lint": "biome check --write --unsafe",
     "clean": "rm -rf dist",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "prepare": "yarn build",
-    "prepublishOnly": "yarn lint && yarn test && yarn build",
-    "version:patch": "yarn lint && yarn test && yarn build && npm version patch && git push && git push --tags",
-    "version:minor": "yarn lint && yarn test && yarn build && npm version minor && git push && git push --tags",
-    "version:major": "yarn lint && yarn test && yarn build && npm version major && git push && git push --tags"
+    "prepublishOnly": "yarn lint && yarn test:run && yarn build",
+    "version:patch": "yarn lint && yarn test:run && yarn build && npm version patch && git push && git push --tags",
+    "version:minor": "yarn lint && yarn test:run && yarn build && npm version minor && git push && git push --tags",
+    "version:major": "yarn lint && yarn test:run && yarn build && npm version major && git push && git push --tags"
   },
   "keywords": [
     "utils",
@@ -72,15 +78,24 @@
   },
   "license": "MIT",
   "dependencies": {
-    "dayjs": "^1.11.10"
+    "dayjs": "^1.11.10",
+    "react": "19.1.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.3",
-    "@types/jest": "^29.5.5",
-    "jest": "^29.7.0",
+    "@testing-library/dom": "10.4.1",
+    "@testing-library/jest-dom": "6.8.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/react-hooks": "8.0.1",
+    "@types/react": "19.1.12",
+    "@types/react-dom": "19.1.9",
+    "@vitest/coverage-v8": "3.2.4",
+    "@vitest/ui": "3.2.4",
     "jest-environment-jsdom": "30.1.2",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.2.2"
+    "jsdom": "26.1.0",
+    "react-dom": "19.1.1",
+    "typescript": "^5.2.2",
+    "vitest": "3.2.4"
   },
   "repository": {
     "type": "git",