@herowcode/utils 1.1.0 → 1.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @herowcode/utils
 
-A lightweight collection of utility functions for everyday JavaScript/TypeScript development. Built with dayjs for powerful date manipulation.
+A lightweight collection of utility functions for everyday JavaScript/TypeScript development. Built with dayjs for powerful date manipulation and React hooks for YouTube integration.
 
 ## Features
 
@@ -10,6 +10,7 @@ A lightweight collection of utility functions for everyday JavaScript/TypeScript
 - 📱 **Universal** - Works in Node.js and browsers
 - 🎯 **Tree-shakable** - Only import what you need
 - 📂 **Scoped exports** - Import from specific modules
+- 🎥 **YouTube utilities** - Extract video IDs, generate URLs, and get video durations
 
 ## Installation
 
@@ -23,7 +24,7 @@ yarn add @herowcode/utils
 
 ### Import everything:
 ```typescript
-import { formatDate, capitalize, debounce } from '@herowcode/utils';
+import { formatDate, capitalize, debounce, extractYouTubeId } from '@herowcode/utils';
 ```
 
 ### Import by scope:
@@ -32,6 +33,7 @@ import { formatDate, addDays } from '@herowcode/utils/date';
 import { capitalize, camelCase } from '@herowcode/utils/string';
 import { randomInt } from '@herowcode/utils/number';
 import { debounce, throttle } from '@herowcode/utils/function';
+import { extractYouTubeId, generateYoutubeURL } from '@herowcode/utils/youtube';
 ```
 
 ### Examples:
@@ -47,6 +49,14 @@ console.log(kebabCase('helloWorld')); // "hello-world"
 
 // Function utilities
 const debouncedFn = debounce(() => console.log('Called!'), 300);
+
+// YouTube utilities
+const videoId = extractYouTubeId('https://youtu.be/dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+const embedUrl = generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  embed: true, 
+  autoplay: true 
+}); // "https://www.youtube.com/embed/abc123?autoplay=1"
 ```
 
 ## API Reference
@@ -167,6 +177,41 @@ Capitalizes the first letter and lowercases the rest.
 capitalize('hELLO'); // "Hello"
 ```
 
+#### `formatHMSToSeconds(val?: number | string): number | null`
+Converts HMS time format or numeric strings to seconds. Supports formats like "90", "01:30", "1:02:03".
+
+```typescript
+formatHMSToSeconds("1:30"); // 90
+formatHMSToSeconds("1:02:03"); // 3723
+formatHMSToSeconds(120); // 120
+```
+
+#### `formatSecondsToFragment(secs: number): string`
+Converts seconds to YouTube-style fragment format (e.g., "1h2m3s").
+
+```typescript
+formatSecondsToFragment(3723); // "1h2m3s"
+formatSecondsToFragment(90); // "1m30s"
+formatSecondsToFragment(42); // "42s"
+```
+
+#### `formatSecondsToHMS(totalSeconds: number): string`
+Formats a number of seconds into an HH:MM:SS string, rounding and clamping negatives to zero.
+
+```typescript
+formatSecondsToHMS(3661); // "01:01:01"
+formatSecondsToHMS(5); // "00:05"
+```
+
+#### `formatStringToTime(str: string): string`
+Parses a numeric time string (or a string containing digits) into MM:SS or HH:MM:SS format. Non-digits are removed before formatting. Short inputs are zero-padded.
+
+```typescript
+formatStringToTime('123'); // "01:23"
+formatStringToTime('12345'); // "01:23:45"
+formatStringToTime(' 12:34 '); // "12:34"
+```
+
 #### `kebabCase(str: string): string`
 Converts a string to kebab-case.
 
@@ -209,6 +254,94 @@ Truncates a string to a specified length, appending a suffix if truncated.
 truncate('Hello world', 5); // "He..."
 ```
 
+### YouTube Utilities
+
+#### `extractYouTubeId(urlString: string | null): string | null`
+Extracts the video ID from various YouTube URL formats.
+
+```typescript
+extractYouTubeId('https://youtu.be/dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+extractYouTubeId('https://www.youtube.com/watch?v=dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+extractYouTubeId('https://www.youtube.com/embed/dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+extractYouTubeId('invalid-url'); // null
+```
+
+#### `generateYoutubeURL(options: TCreateYoutubeLinkOptions): string | null`
+Generates YouTube URLs with various options for watch, embed, or short formats.
+
+```typescript
+// Basic watch URL
+generateYoutubeURL({ videoURL: 'https://youtu.be/abc123' });
+// "https://www.youtube.com/watch?v=abc123"
+
+// Embed URL with autoplay
+generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  embed: true, 
+  autoplay: true 
+});
+// "https://www.youtube.com/embed/abc123?autoplay=1"
+
+// Short URL with timestamp
+generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  short: true, 
+  start: "1:30" 
+});
+// "https://youtu.be/abc123?t=90"
+
+// URL with fragment timestamp
+generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  start: "1:30", 
+  useFragment: true 
+});
+// "https://www.youtube.com/watch?v=abc123#t=1m30s"
+```
+
+**Options:**
+- `videoURL` (required): YouTube URL to process
+- `start`/`end`: Start/end times as seconds (number) or HMS strings ("90", "01:30", "1:02:03")
+- `embed`: Generate embed URL format
+- `short`: Generate youtu.be short URL format
+- `useFragment`: Use #t=1m2s style fragment for timestamps
+- `autoplay`, `controls`, `rel`, `loop`, `mute`, `modestbranding`: Player options
+- `origin`, `playlist`: Additional parameters
+- `params`: Custom query parameters
+
+#### `useGetYoutubeVideoDuration(): (videoUrl: string) => Promise<string | null>`
+React hook that returns a function to get YouTube video duration using the YouTube IFrame API.
+
+```typescript
+import { useGetYoutubeVideoDuration } from '@herowcode/utils/youtube';
+
+function VideoComponent() {
+  const getVideoDuration = useGetYoutubeVideoDuration();
+  
+  const handleGetDuration = async () => {
+    const duration = await getVideoDuration('https://youtu.be/dQw4w9WgXcQ');
+    console.log(duration); // "03:32" or null if failed
+  };
+  
+  return <button onClick={handleGetDuration}>Get Duration</button>;
+}
+```
+
+**Features:**
+- Automatically loads YouTube IFrame API if not present
+- Creates offscreen iframe for duration detection
+- Handles retry logic for videos that don't immediately report duration
+- 10-second timeout with automatic cleanup
+- Returns formatted duration string (HH:MM:SS) or null on failure
+
+#### `validateYoutubeLink(videoUrl: string): Promise<boolean>`
+Checks whether a YouTube video exists by probing thumbnails and falling back to the oEmbed endpoint. Returns `true` for found/public videos and `false` otherwise.
+
+```typescript
+const ok = await validateYoutubeLink('https://youtu.be/dQw4w9WgXcQ');
+// true | false
+```
+
 ## Browser Support
 
 This library supports all modern browsers and Node.js environments. It uses ES2018 features and requires:
@@ -216,6 +349,8 @@ This library supports all modern browsers and Node.js environments. It uses ES20
 - Node.js 10+
 - Modern browsers (Chrome 63+, Firefox 58+, Safari 12+, Edge 79+)
 
+The YouTube utilities require a browser environment with DOM support.
+
 ## Development
 
 ```bash

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export * from "./date/index.js";
 export * from "./files/index.js";
 export * from "./function/index.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":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,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

@@ -3,3 +3,4 @@ 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

@@ -3,3 +3,4 @@ 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,mDAAgC,CAAC,kBAAkB;AACnD,kDAA+B,CAAC,iBAAiB;AACjD,mDAAgC,CAAC,kBAAkB;AACnD,sDAAmC,CAAC,qBAAqB;AACzD,oDAAiC,CAAC,mBAAmB"}
+{"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}`;
+};