@herowcode/utils 1.0.2 → 1.1.1

package/dist/files/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./compress-image";
+export * from "./download-url";
+export * from "./format-bytes";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA"}

package/dist/files/index.esm.js

@@ -0,0 +1,3 @@
+export * from "./compress-image";
+export * from "./download-url";
+export * from "./format-bytes";

package/dist/files/index.js

@@ -0,0 +1,3 @@
+export * from "./compress-image";
+export * from "./download-url";
+export * from "./format-bytes";

package/dist/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,iDAA8B;AAC9B,iDAA8B"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./array/index.js";
 export * from "./date/index.js";
+export * from "./files/index.js";
 export * from "./function/index.js";
-export { randomInt } from "./number.js";
 export * from "./string/index.js";
+export * from "./youtube/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist/index.esm.js

@@ -1,10 +1,6 @@
-// Date utilities
-// Array utilities
-export * from "./array/index.js";
-export * from "./date/index.js";
-// Function utilities
-export * from "./function/index.js";
-// Number utilities
-export { randomInt } from "./number.js";
-// String utilities
-export * from "./string/index.js";
+export * from "./array/index.js"; // Array utilities
+export * from "./date/index.js"; // Date utilities
+export * from "./files/index.js"; // Files utilities
+export * from "./function/index.js"; // Function utilities
+export * from "./string/index.js"; // String utilities
+export * from "./youtube/index.js"; // YouTube utilities

package/dist/index.js

@@ -1,10 +1,6 @@
-// Date utilities
-// Array utilities
-export * from "./array/index.js";
-export * from "./date/index.js";
-// Function utilities
-export * from "./function/index.js";
-// Number utilities
-export { randomInt } from "./number.js";
-// String utilities
-export * from "./string/index.js";
+export * from "./array/index.js"; // Array utilities
+export * from "./date/index.js"; // Date utilities
+export * from "./files/index.js"; // Files utilities
+export * from "./function/index.js"; // Function utilities
+export * from "./string/index.js"; // String utilities
+export * from "./youtube/index.js"; // YouTube utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,iBAAiB;;;;;;;;;;;;;;;;;AAEjB,kBAAkB;AAClB,mDAAgC;AAChC,kDAA+B;AAC/B,qBAAqB;AACrB,sDAAmC;AACnC,mBAAmB;AACnB,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAClB,mBAAmB;AACnB,oDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC,CAAC,kBAAkB;AACnD,kDAA+B,CAAC,iBAAiB;AACjD,mDAAgC,CAAC,kBAAkB;AACnD,sDAAmC,CAAC,qBAAqB;AACzD,oDAAiC,CAAC,mBAAmB;AACrD,qDAAkC,CAAC,oBAAoB"}

package/dist/string/format-hms-to-seconds.d.ts

@@ -0,0 +1,2 @@
+export declare const formatHMSToSeconds: (val?: number | string) => number | null;
+//# sourceMappingURL=format-hms-to-seconds.d.ts.map

package/dist/string/format-hms-to-seconds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-hms-to-seconds.d.ts","sourceRoot":"","sources":["../../src/string/format-hms-to-seconds.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,GAAG,MAAM,KAAG,MAAM,GAAG,IAoBnE,CAAA"}

package/dist/string/format-hms-to-seconds.esm.js

@@ -0,0 +1,25 @@
+export const formatHMSToSeconds = (val) => {
+    if (val == null || val === "")
+        return null;
+    if (typeof val === "number")
+        return Number.isFinite(val) ? Math.max(0, Math.floor(val)) : null;
+    const s = String(val).trim();
+    // purely numeric string
+    if (/^\d+$/.test(s))
+        return Math.max(0, Number.parseInt(s, 10));
+    // hh:mm:ss or mm:ss
+    if (/^\d{1,2}(:\d{1,2}){1,2}$/.test(s)) {
+        const parts = s.split(":").map((p) => Number.parseInt(p, 10));
+        if (parts.some((n) => Number.isNaN(n)))
+            return null;
+        let seconds = 0;
+        if (parts.length === 3) {
+            seconds = parts[0] * 3600 + parts[1] * 60 + parts[2];
+        }
+        else {
+            seconds = parts[0] * 60 + parts[1];
+        }
+        return Math.max(0, seconds);
+    }
+    return null;
+};

package/dist/string/format-hms-to-seconds.js

@@ -0,0 +1,25 @@
+export const formatHMSToSeconds = (val) => {
+    if (val == null || val === "")
+        return null;
+    if (typeof val === "number")
+        return Number.isFinite(val) ? Math.max(0, Math.floor(val)) : null;
+    const s = String(val).trim();
+    // purely numeric string
+    if (/^\d+$/.test(s))
+        return Math.max(0, Number.parseInt(s, 10));
+    // hh:mm:ss or mm:ss
+    if (/^\d{1,2}(:\d{1,2}){1,2}$/.test(s)) {
+        const parts = s.split(":").map((p) => Number.parseInt(p, 10));
+        if (parts.some((n) => Number.isNaN(n)))
+            return null;
+        let seconds = 0;
+        if (parts.length === 3) {
+            seconds = parts[0] * 3600 + parts[1] * 60 + parts[2];
+        }
+        else {
+            seconds = parts[0] * 60 + parts[1];
+        }
+        return Math.max(0, seconds);
+    }
+    return null;
+};

package/dist/string/format-hms-to-seconds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-hms-to-seconds.js","sourceRoot":"","sources":["../../src/string/format-hms-to-seconds.ts"],"names":[],"mappings":";;;AAAO,MAAM,kBAAkB,GAAG,CAAC,GAAqB,EAAiB,EAAE;IACzE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACnE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5B,wBAAwB;IACxB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IAC/D,oBAAoB;IACpB,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAC7D,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;QACnD,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACtD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AApBY,QAAA,kBAAkB,sBAoB9B"}

package/dist/string/format-seconds-to-fragment.d.ts

@@ -0,0 +1,3 @@
+/** convert seconds to "1h2m3s" or "42s" style for fragment */
+export declare const formatSecondsToFragment: (secs: number) => string;
+//# sourceMappingURL=format-seconds-to-fragment.d.ts.map

package/dist/string/format-seconds-to-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-seconds-to-fragment.d.ts","sourceRoot":"","sources":["../../src/string/format-seconds-to-fragment.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAUtD,CAAA"}

package/dist/string/format-seconds-to-fragment.esm.js

@@ -0,0 +1,15 @@
+/** convert seconds to "1h2m3s" or "42s" style for fragment */
+export const formatSecondsToFragment = (secs) => {
+    const parsedSecs = Math.max(0, Math.floor(secs));
+    const h = Math.floor(parsedSecs / 3600);
+    const m = Math.floor((parsedSecs % 3600) / 60);
+    const s = parsedSecs % 60;
+    let out = "";
+    if (h > 0)
+        out += `${h}h`;
+    if (m > 0)
+        out += `${m}m`;
+    if (s > 0 || out === "")
+        out += `${s}s`;
+    return out;
+};

package/dist/string/format-seconds-to-fragment.js

@@ -0,0 +1,15 @@
+/** convert seconds to "1h2m3s" or "42s" style for fragment */
+export const formatSecondsToFragment = (secs) => {
+    const parsedSecs = Math.max(0, Math.floor(secs));
+    const h = Math.floor(parsedSecs / 3600);
+    const m = Math.floor((parsedSecs % 3600) / 60);
+    const s = parsedSecs % 60;
+    let out = "";
+    if (h > 0)
+        out += `${h}h`;
+    if (m > 0)
+        out += `${m}m`;
+    if (s > 0 || out === "")
+        out += `${s}s`;
+    return out;
+};

package/dist/string/format-seconds-to-fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-seconds-to-fragment.js","sourceRoot":"","sources":["../../src/string/format-seconds-to-fragment.ts"],"names":[],"mappings":";;;AAAA,8DAA8D;AACvD,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAU,EAAE;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,UAAU,GAAG,EAAE,CAAA;IACzB,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,IAAI,CAAC,GAAG,CAAC;QAAE,GAAG,IAAI,GAAG,CAAC,GAAG,CAAA;IACzB,IAAI,CAAC,GAAG,CAAC;QAAE,GAAG,IAAI,GAAG,CAAC,GAAG,CAAA;IACzB,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,EAAE;QAAE,GAAG,IAAI,GAAG,CAAC,GAAG,CAAA;IACvC,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAVY,QAAA,uBAAuB,2BAUnC"}

package/dist/string/format-seconds-to-hms.d.ts

@@ -0,0 +1,2 @@
+export declare function formatSecondsToHMS(totalSeconds: number): string;
+//# sourceMappingURL=format-seconds-to-hms.d.ts.map

package/dist/string/format-seconds-to-hms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-seconds-to-hms.d.ts","sourceRoot":"","sources":["../../src/string/format-seconds-to-hms.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAc/D"}

package/dist/string/format-seconds-to-hms.esm.js

@@ -0,0 +1,13 @@
+export function formatSecondsToHMS(totalSeconds) {
+    const rounded = Math.max(0, Math.round(totalSeconds));
+    const hours = Math.floor(rounded / 3600);
+    const minutes = Math.floor((rounded % 3600) / 60);
+    const seconds = rounded % 60;
+    const hh = String(hours).padStart(2, "0");
+    const mm = String(minutes).padStart(2, "0");
+    const ss = String(seconds).padStart(2, "0");
+    if (hours === 0) {
+        return `${mm}:${ss}`;
+    }
+    return `${hh}:${mm}:${ss}`;
+}

package/dist/string/format-seconds-to-hms.js

@@ -0,0 +1,13 @@
+export function formatSecondsToHMS(totalSeconds) {
+    const rounded = Math.max(0, Math.round(totalSeconds));
+    const hours = Math.floor(rounded / 3600);
+    const minutes = Math.floor((rounded % 3600) / 60);
+    const seconds = rounded % 60;
+    const hh = String(hours).padStart(2, "0");
+    const mm = String(minutes).padStart(2, "0");
+    const ss = String(seconds).padStart(2, "0");
+    if (hours === 0) {
+        return `${mm}:${ss}`;
+    }
+    return `${hh}:${mm}:${ss}`;
+}

package/dist/string/format-seconds-to-hms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-seconds-to-hms.js","sourceRoot":"","sources":["../../src/string/format-seconds-to-hms.ts"],"names":[],"mappings":";;AAAA,gDAcC;AAdD,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,OAAO,GAAG,EAAE,CAAA;IAC5B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACzC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC3C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAE3C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,CAAA;IACtB,CAAC;IAED,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAA;AAC5B,CAAC"}

package/dist/string/format-string-to-time.d.ts

@@ -0,0 +1,2 @@
+export declare const formatStringToTime: (str: string) => string;
+//# sourceMappingURL=format-string-to-time.d.ts.map

package/dist/string/format-string-to-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-string-to-time.d.ts","sourceRoot":"","sources":["../../src/string/format-string-to-time.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,WAU7C,CAAA"}

package/dist/string/format-string-to-time.esm.js

@@ -0,0 +1,10 @@
+export const formatStringToTime = (str) => {
+    const stringCleaned = Number(str.replace(/\D/g, "")).toString();
+    if (stringCleaned.length > 4) {
+        return stringCleaned
+            .padStart(6, "0")
+            .slice(0, 6)
+            .replace(/(\d{2})(\d{2})(\d{2})/, "$1:$2:$3");
+    }
+    return stringCleaned.padStart(4, "0").replace(/(\d{2})(\d{2})/, "$1:$2");
+};

package/dist/string/format-string-to-time.js

@@ -0,0 +1,10 @@
+export const formatStringToTime = (str) => {
+    const stringCleaned = Number(str.replace(/\D/g, "")).toString();
+    if (stringCleaned.length > 4) {
+        return stringCleaned
+            .padStart(6, "0")
+            .slice(0, 6)
+            .replace(/(\d{2})(\d{2})(\d{2})/, "$1:$2:$3");
+    }
+    return stringCleaned.padStart(4, "0").replace(/(\d{2})(\d{2})/, "$1:$2");
+};

package/dist/string/format-string-to-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-string-to-time.js","sourceRoot":"","sources":["../../src/string/format-string-to-time.ts"],"names":[],"mappings":";;;AAAO,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,EAAE;IAChD,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC/D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,aAAa;aACjB,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;aAChB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,OAAO,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;AAC1E,CAAC,CAAA;AAVY,QAAA,kBAAkB,sBAU9B"}

package/dist/string/index.d.ts

@@ -1,5 +1,9 @@
 export * from "./camel-case";
 export * from "./capitalize";
+export * from "./format-hms-to-seconds";
+export * from "./format-seconds-to-fragment";
+export * from "./format-seconds-to-hms";
+export * from "./format-string-to-time";
 export * from "./kebab-case";
 export * from "./remove-html-tags";
 export * from "./slugify";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA"}

package/dist/string/index.esm.js

@@ -1,5 +1,9 @@
 export * from "./camel-case";
 export * from "./capitalize";
+export * from "./format-hms-to-seconds";
+export * from "./format-seconds-to-fragment";
+export * from "./format-seconds-to-hms";
+export * from "./format-string-to-time";
 export * from "./kebab-case";
 export * from "./remove-html-tags";
 export * from "./slugify";

package/dist/string/index.js

@@ -1,5 +1,9 @@
 export * from "./camel-case";
 export * from "./capitalize";
+export * from "./format-hms-to-seconds";
+export * from "./format-seconds-to-fragment";
+export * from "./format-seconds-to-hms";
+export * from "./format-string-to-time";
 export * from "./kebab-case";
 export * from "./remove-html-tags";
 export * from "./slugify";

package/dist/string/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,+CAA4B;AAC5B,+CAA4B;AAC5B,qDAAkC;AAClC,4CAAyB;AACzB,+CAA4B;AAC5B,qDAAkC;AAClC,6CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,+CAA4B;AAC5B,0DAAuC;AACvC,+DAA4C;AAC5C,0DAAuC;AACvC,0DAAuC;AACvC,+CAA4B;AAC5B,qDAAkC;AAClC,4CAAyB;AACzB,+CAA4B;AAC5B,qDAAkC;AAClC,6CAA0B"}

package/dist/youtube/extract-youtube-video-id.d.ts

@@ -0,0 +1,2 @@
+export declare function extractYouTubeId(urlString: string | null): string | null;
+//# sourceMappingURL=extract-youtube-video-id.d.ts.map

package/dist/youtube/extract-youtube-video-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-youtube-video-id.d.ts","sourceRoot":"","sources":["../../src/youtube/extract-youtube-video-id.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA4BxE"}

package/dist/youtube/extract-youtube-video-id.esm.js

@@ -0,0 +1,26 @@
+export function extractYouTubeId(urlString) {
+    if (!urlString)
+        return null;
+    try {
+        const url = new URL(urlString);
+        const hostname = url.hostname.toLowerCase();
+        const pathname = url.pathname;
+        if (hostname.includes("youtu.be")) {
+            const id = pathname.replace(/^\/+/, "").split(/[?&#]/)[0];
+            return id || null;
+        }
+        if (hostname.includes("youtube.com")) {
+            if (url.searchParams.has("v")) {
+                return url.searchParams.get("v");
+            }
+            const parts = pathname.split("/").filter(Boolean);
+            const last = parts[parts.length - 1];
+            if (last)
+                return last.split(/[?&#]/)[0] || null;
+        }
+    }
+    catch (_a) { }
+    const regex = /(?:v=|\/embed\/|\/shorts\/|youtu\.be\/)([0-9A-Za-z_-]{6,})/i;
+    const match = urlString.match(regex);
+    return match ? match[1] : null;
+}

package/dist/youtube/extract-youtube-video-id.js

@@ -0,0 +1,26 @@
+export function extractYouTubeId(urlString) {
+    if (!urlString)
+        return null;
+    try {
+        const url = new URL(urlString);
+        const hostname = url.hostname.toLowerCase();
+        const pathname = url.pathname;
+        if (hostname.includes("youtu.be")) {
+            const id = pathname.replace(/^\/+/, "").split(/[?&#]/)[0];
+            return id || null;
+        }
+        if (hostname.includes("youtube.com")) {
+            if (url.searchParams.has("v")) {
+                return url.searchParams.get("v");
+            }
+            const parts = pathname.split("/").filter(Boolean);
+            const last = parts[parts.length - 1];
+            if (last)
+                return last.split(/[?&#]/)[0] || null;
+        }
+    }
+    catch (_a) { }
+    const regex = /(?:v=|\/embed\/|\/shorts\/|youtu\.be\/)([0-9A-Za-z_-]{6,})/i;
+    const match = urlString.match(regex);
+    return match ? match[1] : null;
+}

package/dist/youtube/extract-youtube-video-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-youtube-video-id.js","sourceRoot":"","sources":["../../src/youtube/extract-youtube-video-id.ts"],"names":[],"mappings":";;AAAA,4CA4BC;AA5BD,SAAgB,gBAAgB,CAAC,SAAwB;IACvD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IAE3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;QAE9B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAA;QAE7B,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;YACzD,OAAO,EAAE,IAAI,IAAI,CAAA;QACnB,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAClC,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YACpC,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;QACjD,CAAC;IACH,CAAC;IAAC,WAAM,CAAC,CAAA,CAAC;IAEV,MAAM,KAAK,GAAG,6DAA6D,CAAA;IAC3E,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChC,CAAC"}

package/dist/youtube/generate-youtube-url.d.ts

@@ -0,0 +1,20 @@
+type TCreateYoutubeLinkOptions = {
+    videoURL: string;
+    start?: number | string;
+    end?: number | string;
+    embed?: boolean;
+    short?: boolean;
+    useFragment?: boolean;
+    autoplay?: boolean;
+    controls?: 0 | 1;
+    rel?: 0 | 1;
+    loop?: boolean;
+    mute?: boolean;
+    modestbranding?: 0 | 1;
+    origin?: string;
+    playlist?: string;
+    params?: Record<string, string | number | boolean>;
+};
+export declare const generateYoutubeURL: (opts: TCreateYoutubeLinkOptions) => string | null;
+export {};
+//# sourceMappingURL=generate-youtube-url.d.ts.map

package/dist/youtube/generate-youtube-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-youtube-url.d.ts","sourceRoot":"","sources":["../../src/youtube/generate-youtube-url.ts"],"names":[],"mappings":"AAGA,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAEhB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAErB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IAChB,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACX,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CACnD,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,MAAM,yBAAyB,KAC9B,MAAM,GAAG,IAiGX,CAAA"}

package/dist/youtube/generate-youtube-url.esm.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

@@ -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"}