@rtorcato/js-common 2.8.2 → 4.0.0

package/dist/sleep/index.d.ts

@@ -1,5 +1,13 @@
 /**
  * Returns a promise that resolves after the specified number of milliseconds.
+ *
+ * @example
+ * ```typescript
+ * const started = Date.now()
+ * await sleep(200)
+ * Date.now() - started >= 200 // true
+ * ```
+ *
  * @param ms Number of milliseconds to sleep.
  * @returns Promise that resolves after ms milliseconds.
  */
@@ -7,11 +15,23 @@ export declare const sleep: (ms: number) => Promise<void>;
 /**
  * Blocks the event loop for the specified number of milliseconds (synchronous sleep).
  * Not recommended for production use, but useful for scripts or tests.
+ *
+ * @example
+ * ```typescript
+ * sleepSync(50) // blocks the event loop for ~50ms, no await needed
+ * ```
+ *
  * @param ms Number of milliseconds to block.
  */
 export declare function sleepSync(ms: number): void;
 /**
  * Returns a promise that resolves after a random delay between min and max milliseconds.
+ *
+ * @example
+ * ```typescript
+ * await sleepRandom(100, 500) // resolves after 100–500ms — handy for jittered retries
+ * ```
+ *
  * @param min Minimum milliseconds to sleep.
  * @param max Maximum milliseconds to sleep.
  * @returns Promise that resolves after a random delay.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sleep/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACG,CAAA;AAElD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sleep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACG,CAAA;AAElD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9E"}

package/dist/strings/index.d.ts

@@ -79,42 +79,6 @@ export declare function snakeCase(str: string): string;
  * @returns The truncated string.
  */
 export declare function truncate(str: string, maxLength: number): string;
-/**
- * Pads the start of a string to a given length.
- * @param str The string to pad.
- * @param targetLength The target length.
- * @param padString The string to pad with.
- * @returns The padded string.
- */
-export declare function padStart(str: string, targetLength: number, padString?: string): string;
-/**
- * Pads the end of a string to a given length.
- * @param str The string to pad.
- * @param targetLength The target length.
- * @param padString The string to pad with.
- * @returns The padded string.
- */
-export declare function padEnd(str: string, targetLength: number, padString?: string): string;
-/**
- * get a random string
- * var rStr= randomString(32,'0123456789abcdefghijklmn');
- * @param  {number} length
- * @param  {string} chars
- */
-export declare const randomString: (length: number, chars: string) => string;
-/**
- * replace all items in a string using regex
- * @param  {string} str
- * @param  {string} search
- * @param  {string} replacement
- */
-export declare const replaceString: (str: string, search: string, replacement: string) => string;
-/**
- * Sanitizes a string by removing script tags and event handlers.
- * @param str The string to sanitize.
- * @returns The sanitized string.
- */
-export declare function sanitizeString(str: string): string;
 /**
  * Reverses a string.
  *
@@ -171,45 +135,6 @@ export declare function words(str: string): string[];
  * @returns The word count
  */
 export declare function wordCount(str: string): number;
-/**
- * Escapes HTML special characters to prevent XSS.
- *
- * @example
- * ```typescript
- * escapeHtml('<div>Hello & "World"</div>') // '&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;'
- * escapeHtml("It's <script>") // "It&#39;s &lt;script&gt;"
- * ```
- *
- * @param str The string to escape
- * @returns The escaped string
- */
-export declare function escapeHtml(str: string): string;
-/**
- * Unescapes HTML entities back to their original characters.
- *
- * @example
- * ```typescript
- * unescapeHtml('&lt;div&gt;') // '<div>'
- * unescapeHtml('&amp;&quot;&#39;') // '&"''
- * ```
- *
- * @param str The string to unescape
- * @returns The unescaped string
- */
-export declare function unescapeHtml(str: string): string;
-/**
- * Removes all HTML tags from a string.
- *
- * @example
- * ```typescript
- * stripHtml('<p>Hello <b>World</b></p>') // 'Hello World'
- * stripHtml('<script>alert(1)</script>Text') // 'Text'
- * ```
- *
- * @param str The string to strip HTML from
- * @returns The string without HTML tags
- */
-export declare function stripHtml(str: string): string;
 /**
  * Returns the plural form of a word based on count.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAEnF;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAEjF;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAM5D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,MAEhF,CAAA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAehD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAOhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAI3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAOhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAI3E"}

package/dist/strings/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function s(r){return r.replace(/\w\S*/g,t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase())}function o(r){return r.length===0?"":(r[0]?.toUpperCase()??"")+r.slice(1)}function g(r){return r.replace(/[-_\s]+(.)?/g,(t,e)=>e?e.toUpperCase():"").replace(/^(.)/,t=>t.toLowerCase())}function a(r){return r.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase()}function p(r){return r.replace(/([a-z])([A-Z])/g,"$1_$2").replace(/[-\s]+/g,"_").toLowerCase()}function c(r,t){return r.length>t?`${r.slice(0,t-1)}\u2026`:r}function u(r,t,e=" "){return r.padStart(t,e)}function l(r,t,e=" "){return r.padEnd(t,e)}var f=(r,t)=>{let e="";for(let n=r;n>0;--n)e+=t[Math.floor(Math.random()*t.length)];return e},x=(r,t,e)=>r.replace(new RegExp(t,"g"),e);function m(r){return r.replace(/<script.*?>.*?<\/script>/gi,"").replace(/on\w+\s*=\s*(['"]).*?\1/gi,"")}function b(r){return[...r].reverse().join("")}function $(r){return r.normalize("NFD").replace(/[\u0300-\u036f]/g,"").toLowerCase().trim().replace(/[^a-z0-9\s-]/g,"").replace(/[\s_]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")}function h(r){return r.replace(/([a-z])([A-Z])/g,"$1 $2").replace(/[-_]+/g," ").trim().split(/\s+/).filter(Boolean)}function w(r){let t=r.trim();return t===""?0:t.split(/\s+/).length}function d(r){let t={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"};return r.replace(/[&<>"']/g,e=>t[e]??e)}function C(r){let t={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&#x27;":"'","&#x2F;":"/","&nbsp;":" "};return r.replace(/&(?:amp|lt|gt|quot|#39|#x27|#x2F|nbsp);/g,e=>t[e]??e)}function z(r){return r.replace(/<[^>]*>/g,"")}function S(r,t,e){return t===1?r:e??`${r}s`}function _(r){let t=Math.abs(r),e=t%100,n=t%10;if(e>=11&&e<=13)return`${r}th`;switch(n){case 1:return`${r}st`;case 2:return`${r}nd`;case 3:return`${r}rd`;default:return`${r}th`}}function k(r){return r.trim().length===0}function A(r,t,e,n="*"){if(t<0&&(t=0),e>r.length&&(e=r.length),t>=e)return r;let i=n.repeat(e-t);return r.slice(0,t)+i+r.slice(e)}function E(r,t){return r.replace(/\$\{(\w+)\}/g,(e,n)=>Object.hasOwn(t,n)?String(t[n]):e)}export{g as camelCase,o as capitalize,d as escapeHtml,k as isBlank,a as kebabCase,A as mask,_ as ordinalize,l as padEnd,u as padStart,S as pluralize,f as randomString,x as replaceString,b as reverse,m as sanitizeString,$ as slugify,p as snakeCase,z as stripHtml,E as template,s as titleCase,c as truncate,C as unescapeHtml,w as wordCount,h as words};
+import"../chunks/chunk-ANN5UYCF.js";function s(e){return e.replace(/\w\S*/g,r=>r.charAt(0).toUpperCase()+r.slice(1).toLowerCase())}function o(e){return e.length===0?"":(e[0]?.toUpperCase()??"")+e.slice(1)}function a(e){return e.replace(/[-_\s]+(.)?/g,(r,t)=>t?t.toUpperCase():"").replace(/^(.)/,r=>r.toLowerCase())}function g(e){return e.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase()}function c(e){return e.replace(/([a-z])([A-Z])/g,"$1_$2").replace(/[-\s]+/g,"_").toLowerCase()}function u(e,r){return e.length>r?`${e.slice(0,r-1)}\u2026`:e}function l(e){return[...e].reverse().join("")}function p(e){return e.normalize("NFD").replace(/[\u0300-\u036f]/g,"").toLowerCase().trim().replace(/[^a-z0-9\s-]/g,"").replace(/[\s_]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")}function f(e){return e.replace(/([a-z])([A-Z])/g,"$1 $2").replace(/[-_]+/g," ").trim().split(/\s+/).filter(Boolean)}function $(e){let r=e.trim();return r===""?0:r.split(/\s+/).length}function x(e,r,t){return r===1?e:t??`${e}s`}function C(e){let r=Math.abs(e),t=r%100,n=r%10;if(t>=11&&t<=13)return`${e}th`;switch(n){case 1:return`${e}st`;case 2:return`${e}nd`;case 3:return`${e}rd`;default:return`${e}th`}}function b(e){return e.trim().length===0}function w(e,r,t,n="*"){if(r<0&&(r=0),t>e.length&&(t=e.length),r>=t)return e;let i=n.repeat(t-r);return e.slice(0,r)+i+e.slice(t)}function h(e,r){return e.replace(/\$\{(\w+)\}/g,(t,n)=>Object.hasOwn(r,n)?String(r[n]):t)}export{a as camelCase,o as capitalize,b as isBlank,g as kebabCase,w as mask,C as ordinalize,x as pluralize,l as reverse,p as slugify,c as snakeCase,h as template,s as titleCase,u as truncate,$ as wordCount,f as words};

package/dist/system/index.d.ts

@@ -1,15 +1,33 @@
 /**
  * Checks if the current OS is macOS.
+ *
+ * @example
+ * ```typescript
+ * isMacOs() // true on macOS (via process.platform in Node, userAgent in the browser)
+ * ```
+ *
  * @returns {boolean} True if macOS, false otherwise.
  */
 export declare function isMacOs(): boolean;
 /**
  * Checks if the current OS is Windows.
+ *
+ * @example
+ * ```typescript
+ * isWindows() // true when process.platform === 'win32'
+ * ```
+ *
  * @returns {boolean} True if Windows, false otherwise.
  */
 export declare function isWindows(): boolean;
 /**
  * Checks if the current OS is Linux.
+ *
+ * @example
+ * ```typescript
+ * isLinux() // true when process.platform === 'linux'
+ * ```
+ *
  * @returns {boolean} True if Linux, false otherwise.
  */
 export declare function isLinux(): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAQnC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAQnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC"}

package/dist/time/index.d.ts

@@ -1,16 +1,35 @@
 /**
- * Returns the current time as HH:MM:SS string.
+ * Returns the current time as an `HH:MM:SS` string.
+ *
+ * @example
+ * ```typescript
+ * nowTime() // '14:03:27'
+ * ```
+ *
  * @returns {string}
  */
 export declare function nowTime(): string;
 /**
- * Parses a time string (HH:MM or HH:MM:SS) into a Date object (today's date).
+ * Parses a time string (`HH:MM` or `HH:MM:SS`) into a Date object (today's date).
+ *
+ * @example
+ * ```typescript
+ * parseTime('09:30').getHours() // 9
+ * parseTime('09:30:15').getSeconds() // 15
+ * ```
+ *
  * @param timeStr The time string.
  * @returns {Date}
  */
 export declare function parseTime(timeStr: string): Date;
 /**
- * Formats a Date object as HH:MM:SS.
+ * Formats a Date object as `HH:MM:SS`.
+ *
+ * @example
+ * ```typescript
+ * formatTime(new Date(2026, 7, 11, 9, 5, 3)) // '09:05:03'
+ * ```
+ *
  * @param date The Date object.
  * @returns {string}
  */
@@ -23,7 +42,7 @@ export declare function formatTime(date: Date): string;
  */
 export declare function secondsBetween(t1: string | Date, t2: string | Date): number;
 /**
- * Pads a number to two digits (e.g., 5 -> '05').
+ * Pads a number to two digits (e.g. `5` → `'05'`).
  * @param n The number.
  * @returns {string}
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAGhC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAGhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}

package/dist/try/index.d.ts

@@ -1,2 +1,53 @@
-export * from './trycatch.js';
+/**
+ * Successful branch of a `Result` — carries the value and a `null` error.
+ */
+export type Success<T> = {
+    data: T;
+    error: null;
+};
+/**
+ * Error branch of a `Result` — carries a `null` value and an error of type `E`.
+ */
+export type Failure<E> = {
+    data: null;
+    error: E;
+};
+/**
+ * Go-style discriminated union representing either a `Success<T>` or a `Failure<E>`,
+ * for async code that prefers explicit error returns over thrown exceptions.
+ *
+ * @example
+ * ```typescript
+ * const ok: Result<number> = { data: 42, error: null }
+ * const bad: Result<number> = { data: null, error: new Error('boom') }
+ * ```
+ */
+export type Result<T, E = Error> = Success<T> | Failure<E>;
+/**
+ * Type guard that narrows a `Result` to its `Success` branch when the error is `null`.
+ *
+ * @example
+ * ```typescript
+ * const result = await tryCatch(async () => 42)
+ * if (isSuccess(result)) {
+ * 	result.data // 42, narrowed to number
+ * }
+ * ```
+ */
+export declare function isSuccess<T, E>(result: Result<T, E>): result is Success<T>;
+/**
+ * Run an async function and capture any thrown error into a `Result`, eliminating
+ * try/catch at the call site.
+ *
+ * @example
+ * ```typescript
+ * const { data, error } = await tryCatch(() => fetch('/api/user').then((r) => r.json()))
+ * // success: { data: { id: 1 }, error: null }
+ * // failure: { data: null, error: Error }
+ *
+ * if (error) return console.error(error)
+ * console.log(data.id)
+ * ```
+ */
+export declare function tryCatch<T, E = Error>(fn: () => Promise<T>): Promise<Result<T, E>>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/try/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/try/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAA;AAEjD;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAEjD;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAOxF"}

package/dist/try/index.js

@@ -1 +1 @@
-import{a as o,b as r}from"../chunks/chunk-XAQ7VMV4.js";import"../chunks/chunk-ANN5UYCF.js";export{o as isSuccess,r as tryCatch};
+import{a,b}from"../chunks/chunk-J4C2KNK5.js";import"../chunks/chunk-ANN5UYCF.js";export{a as isSuccess,b as tryCatch};

package/dist/try/trycatch.test-d.js

@@ -1 +1 @@
-import{a as u,b as t}from"../chunks/chunk-XAQ7VMV4.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as l,expectTypeOf as e,it as s}from"vitest";l("try \u2014 types",()=>{s("Result<T,E> is the union of Success<T> and Failure<E>",()=>{e().toEqualTypeOf(),e().toEqualTypeOf()}),s("isSuccess narrows Result to Success in the true branch",()=>{let r={data:1,error:null};u(r)?(e(r).toEqualTypeOf(),e(r.data).toEqualTypeOf(),e(r.error).toEqualTypeOf()):e(r).toEqualTypeOf()}),s("tryCatch returns Promise<Result<T, E>> with the resolved type",async()=>{let r=t(async()=>42);e(r).toEqualTypeOf();let o=t(async()=>"x");e(o).toEqualTypeOf()})});
+import{a as u,b as t}from"../chunks/chunk-J4C2KNK5.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as l,expectTypeOf as e,it as s}from"vitest";l("try \u2014 types",()=>{s("Result<T,E> is the union of Success<T> and Failure<E>",()=>{e().toEqualTypeOf(),e().toEqualTypeOf()}),s("isSuccess narrows Result to Success in the true branch",()=>{let r={data:1,error:null};u(r)?(e(r).toEqualTypeOf(),e(r.data).toEqualTypeOf(),e(r.error).toEqualTypeOf()):e(r).toEqualTypeOf()}),s("tryCatch returns Promise<Result<T, E>> with the resolved type",async()=>{let r=t(async()=>42);e(r).toEqualTypeOf();let o=t(async()=>"x");e(o).toEqualTypeOf()})});

package/dist/types/index.d.ts

@@ -1,3 +1,2 @@
 export * from './common'
-// export * from './api'
 export * from './env'

package/dist/url/index.d.ts

@@ -1,17 +1,40 @@
 /**
  * Checks if a string is a valid URL.
+ *
+ * @example
+ * ```typescript
+ * isValidUrl('https://example.com/a?b=1') // true
+ * isValidUrl('example.com') // false (no protocol)
+ * ```
+ *
  * @param str The string to check.
  * @returns True if valid URL, false otherwise.
  */
 export declare function isValidUrl(str: string): boolean;
 /**
  * Gets the query parameters from a URL as an object.
+ *
+ * @example
+ * ```typescript
+ * getQueryParams('https://example.com/s?q=cats&page=2') // { q: 'cats', page: '2' }
+ * getQueryParams('not a url') // {}
+ * ```
+ *
  * @param url The URL string.
  * @returns An object of query parameters.
  */
 export declare function getQueryParams(url: string): Record<string, string>;
 /**
  * Adds or updates a query parameter in a URL.
+ *
+ * @example
+ * ```typescript
+ * setQueryParam('https://example.com/s?q=cats', 'page', '2')
+ * // 'https://example.com/s?q=cats&page=2'
+ * setQueryParam('https://example.com/s?q=cats', 'q', 'dogs')
+ * // 'https://example.com/s?q=dogs'
+ * ```
+ *
  * @param url The URL string.
  * @param key The query parameter key.
  * @param value The query parameter value.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjE;AAgBD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/url/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function a(r){try{return new URL(r),!0}catch{return!1}}function i(r){try{let n=new URL(r).searchParams,t={};return n.forEach((e,s)=>{t[s]=e}),t}catch{return{}}}function o(r,n,t){try{let e=new URL(r);return e.searchParams.set(n,t),e.toString()}catch{return r}}function c(r,n){try{let t=new URL(r);return t.searchParams.delete(n),t.toString()}catch{return r}}function u(...r){return r.map((n,t)=>t===0?n.replace(/\/+$/,""):n.replace(/^\/+|\/+$/g,"")).filter(Boolean).join("/")}function g(r){try{return new URL(r).hostname}catch{return""}}export{g as getHostname,i as getQueryParams,a as isValidUrl,u as joinUrl,c as removeQueryParam,o as setQueryParam};
+import"../chunks/chunk-ANN5UYCF.js";function o(r){try{return new URL(r),!0}catch{return!1}}function a(r){try{let e=new URL(r).searchParams,t={};return e.forEach((n,s)=>{t[s]=n}),t}catch{return{}}}function c(r,e,t){try{let n=new URL(r);return n.searchParams.set(e,t),n.toString()}catch{return r}}function g(r,e){try{let t=new URL(r);return t.searchParams.delete(e),t.toString()}catch{return r}}function i(r,e){let t=0,n=r.length;if(e)for(;t<n&&r[t]==="/";)t++;for(;n>t&&r[n-1]==="/";)n--;return r.slice(t,n)}function u(...r){return r.map((e,t)=>i(e,t>0)).filter(Boolean).join("/")}function l(r){try{return new URL(r).hostname}catch{return""}}export{l as getHostname,a as getQueryParams,o as isValidUrl,u as joinUrl,g as removeQueryParam,c as setQueryParam};

package/dist/uuid/index.d.ts

@@ -1,8 +1,3 @@
-/**
- * Generates a UUID v4 string.
- * @returns {string} A new UUID v4 string.
- */
-export declare const getUUID: () => string;
 /**
  * Generates a UUID v7 string (time-ordered).
  * UUID v7 embeds a Unix timestamp, making them sortable and ideal for database primary keys.
@@ -17,6 +12,11 @@ export declare const getUUIDv7: () => string;
 /**
  * Generates a short UUID string using short-uuid.
  * @returns {string} A new short UUID string.
+ *
+ * @example
+ * ```typescript
+ * getShortUUID() // 'mhvXdrZT4jP5T8vBxuvm75'
+ * ```
  */
 export declare const getShortUUID: () => string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uuid/index.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAO,MAE1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,QAAO,MAE5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,MAE/B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAE1C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAE7C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,KAAG,OAA2B,CAAA;AAE/D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,OAAoD,CAAA;AAE1F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,OAA0B,CAAA;AAEjE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAK3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,MAAkB,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,UAA2B,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,MAA8B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uuid/index.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,QAAO,MAE5B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,QAAO,MAE/B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAE1C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAE7C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,KAAG,OAA2B,CAAA;AAE/D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,OAAoD,CAAA;AAE1F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,OAA0B,CAAA;AAEjE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAK3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,MAAkB,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,UAA2B,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,MAA8B,CAAA"}

package/dist/uuid/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";import{createTranslator as e}from"short-uuid";import{NIL as n,parse as i,stringify as U,validate as r,version as s,v4 as a,v7 as g}from"uuid";var o=e(),p=()=>a(),D=()=>g(),c=()=>o.generate(),x=t=>o.fromUUID(t),l=t=>o.toUUID(t),v=t=>r(t),d=t=>r(t)&&s(t)===4,f=t=>t===n,m=t=>{if(!r(t))throw new Error("Invalid UUID");return s(t)},y=()=>n,b=t=>i(t),h=t=>U(t);export{h as bytesToUUID,l as fromShortUUID,y as getNilUUID,c as getShortUUID,p as getUUID,m as getUUIDVersion,D as getUUIDv7,f as isNilUUID,v as isUUID,d as isUUIDv4,x as toShortUUID,b as uuidToBytes};
+import"../chunks/chunk-ANN5UYCF.js";import{createTranslator as e}from"short-uuid";import{NIL as n,parse as i,stringify as U,validate as r,version as s,v7 as a}from"uuid";var o=e(),I=()=>a(),p=()=>o.generate(),D=t=>o.fromUUID(t),c=t=>o.toUUID(t),x=t=>r(t),l=t=>r(t)&&s(t)===4,d=t=>t===n,f=t=>{if(!r(t))throw new Error("Invalid UUID");return s(t)},m=()=>n,v=t=>i(t),y=t=>U(t);export{y as bytesToUUID,c as fromShortUUID,m as getNilUUID,p as getShortUUID,f as getUUIDVersion,I as getUUIDv7,d as isNilUUID,x as isUUID,l as isUUIDv4,D as toShortUUID,v as uuidToBytes};

package/dist/validation/index.d.ts

@@ -1,17 +1,42 @@
 /**
  * Checks if a value is defined (not null or undefined).
+ *
+ * @example
+ * ```typescript
+ * isDefined(0) // true
+ * isDefined('') // true
+ * isDefined(null) // false
+ * isDefined(undefined) // false
+ * ```
+ *
  * @param value The value to check.
  * @returns {boolean}
  */
 export declare function isDefined<T>(value: T | null | undefined): value is T;
 /**
  * Check if a value is a string.
+ *
+ * @example
+ * ```typescript
+ * isString('hi') // true
+ * isString(42) // false
+ * isString(new String('hi')) // false (boxed, not a primitive)
+ * ```
+ *
  * @param value - The value to check.
  * @returns `true` if the value is a string, `false` otherwise.
  */
 export declare function isString(value: unknown): value is string;
 /**
  * Checks if a value is a number (and not NaN).
+ *
+ * @example
+ * ```typescript
+ * isNumber(42) // true
+ * isNumber(Number.NaN) // false
+ * isNumber('42') // false
+ * ```
+ *
  * @param value The value to check.
  * @returns {boolean}
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEpE;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;GAIG;AAEH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEpE;AAED;;;;;;;;;;;;GAYG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;;;;;;;;;GAYG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;GAIG;AAEH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI5C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO1C"}

package/dist/validation/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function r(n){return n!=null}function e(n){return typeof n=="string"}function t(n){return typeof n=="number"&&!Number.isNaN(n)}function o(n){return typeof n=="boolean"}function u(n){return Array.isArray(n)}function i(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function s(n){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(n)}function a(n){try{return new URL(n),!0}catch{return!1}}export{u as isArray,o as isBoolean,r as isDefined,s as isEmail,t as isNumber,i as isObject,e as isString,a as isUrl};
+import"../chunks/chunk-ANN5UYCF.js";function r(n){return n!=null}function e(n){return typeof n=="string"}function t(n){return typeof n=="number"&&!Number.isNaN(n)}function o(n){return typeof n=="boolean"}function u(n){return Array.isArray(n)}function i(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function s(n){return/^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/.test(n)}function a(n){try{return new URL(n),!0}catch{return!1}}export{u as isArray,o as isBoolean,r as isDefined,s as isEmail,t as isNumber,i as isObject,e as isString,a as isUrl};

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@rtorcato/js-common",
-  "version": "2.8.2",
+  "version": "4.0.0",
   "description": "JavaScript and TypeScript common code",
   "type": "module",
+  "packageManager": "pnpm@11.17.0",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,10 +44,14 @@
     "size": "size-limit",
     "benchmark": "node scripts/benchmark.mjs",
     "docs:generate": "node scripts/generate-module-docs.mjs",
+    "sync:agents": "node scripts/sync-agents.mjs",
+    "check:readme": "node scripts/check-readme-exports.mjs --check",
     "commit": "cz",
+    "verify": "pnpm typecheck && pnpm check && pnpm exec vitest run",
     "================================================": ""
   },
   "files": [
+    "AGENTS.md",
     "CHANGELOG.md",
     "CONTRIBUTORS.md",
     "dist",
@@ -118,10 +123,6 @@
       "import": "./dist/file/index.js",
       "types": "./dist/file/index.d.ts"
     },
-    "./formatting": {
-      "import": "./dist/formatting/index.js",
-      "types": "./dist/formatting/index.d.ts"
-    },
     "./functions": {
       "import": "./dist/functions/index.js",
       "types": "./dist/functions/index.d.ts"
@@ -138,10 +139,6 @@
       "import": "./dist/i18n/index.js",
       "types": "./dist/i18n/index.d.ts"
     },
-    "./interval": {
-      "import": "./dist/interval/index.js",
-      "types": "./dist/interval/index.d.ts"
-    },
     "./json": {
       "import": "./dist/json/index.js",
       "types": "./dist/json/index.d.ts"
@@ -158,10 +155,6 @@
       "import": "./dist/maps/index.js",
       "types": "./dist/maps/index.d.ts"
     },
-    "./math": {
-      "import": "./dist/math/index.js",
-      "types": "./dist/math/index.d.ts"
-    },
     "./mime-types": {
       "import": "./dist/mime-types/index.js",
       "types": "./dist/mime-types/index.d.ts"
@@ -202,10 +195,6 @@
       "import": "./dist/security/index.js",
       "types": "./dist/security/index.d.ts"
     },
-    "./sets": {
-      "import": "./dist/sets/index.js",
-      "types": "./dist/sets/index.d.ts"
-    },
     "./sleep": {
       "import": "./dist/sleep/index.js",
       "types": "./dist/sleep/index.d.ts"
@@ -243,50 +232,47 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.0",
-    "@commitlint/cli": "^20.1.0",
-    "@commitlint/config-conventional": "^20.3.1",
-    "@rtorcato/js-tooling": "^1.0.9",
-    "@semantic-release/changelog": "^6.0.3",
+    "@biomejs/biome": "^2.5.0",
+    "@commitlint/cli": "^21.2.1",
+    "@commitlint/config-conventional": "^21.2.0",
+    "@rtorcato/repo-tooling": "^3.11.0",
+    "@semantic-release/changelog": "^7.0.0",
     "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/git": "^11.0.1",
     "@semantic-release/github": "^12.0.0",
     "@semantic-release/npm": "^13.1.1",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@size-limit/preset-small-lib": "^12.1.0",
+    "@size-limit/preset-small-lib": "^13.0.3",
     "@types/chalk-animation": "^1.6.3",
     "@types/figlet": "^1.7.0",
-    "@types/luxon": "^3.7.1",
-    "@types/node": "^24.9.1",
-    "@vitest/coverage-istanbul": "^4.0.17",
+    "@types/node": "^26.1.2",
+    "@vitest/coverage-v8": "^4.0.17",
     "cross-env": "^10.1.0",
-    "esbuild": "^0.27.4",
+    "esbuild": "^0.28.1",
     "fast-check": "^4.8.0",
     "husky": "^9.1.7",
-    "jsdom": "^29.0.1",
+    "jsdom": "^30.0.1",
     "knip": "^6.14.2",
     "rimraf": "^6.0.1",
     "semantic-release": "^25.0.1",
-    "size-limit": "^12.1.0",
+    "size-limit": "^13.0.3",
     "typescript": "^6.0.2",
     "vitest": "^4.0.17"
   },
   "dependencies": {
-    "date-fns": "^4.1.0",
-    "date-fns-tz": "^3.2.0",
-    "luxon": "^3.7.2",
     "pino": "^10.1.0",
     "short-uuid": "^6.0.3",
-    "uuid": "^13.0.0",
+    "uuid": "^14.0.1",
     "zod": "^4.1.12"
   },
   "optionalDependencies": {
     "@inquirer/prompts": "^8.5.0",
-    "chalk": "^5.6.2",
+    "chalk": "^6.0.0",
     "chalk-animation": "^2.0.3",
-    "commander": "^14.0.1",
+    "commander": "^15.0.0",
     "figlet": "^1.9.3",
-    "gradient-string": "^3.0.0"
+    "gradient-string": "^3.0.0",
+    "pino-pretty": "^13.0.0"
   },
   "config": {
     "commitizen": {

package/dist/chunks/chunk-5IA77ERW.js

@@ -1 +0,0 @@
-function u(n){return n[0]}function T(n){return n.length?n[n.length-1]:void 0}function f(n){return Array.from(new Set(n))}function i(n){return n.flat()}function l(n,e){if(e<1)throw new Error("Chunk size must be at least 1");let t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function s(n){return n.filter(Boolean)}function c(n){let e=n.slice();for(let t=e.length-1;t>0;t--){let r=Math.floor(Math.random()*(t+1));[e[t],e[r]]=[e[r],e[t]]}return e}function h(n,e){return n.reduce((t,r)=>{let o=e(r);return t[o]||(t[o]=[]),t[o].push(r),t},{})}export{u as a,T as b,f as c,i as d,l as e,s as f,c as g,h};

package/dist/chunks/chunk-6J7HIWG6.js

@@ -1 +0,0 @@
-import{b as e}from"./chunk-FBDKWWIQ.js";import o from"pino";var i=e()?o({level:"debug",transport:{target:"pino-pretty",options:{colorize:!0,ignore:"pid,hostname,time",levelFirst:!1,singleLine:!0,customColors:"err:red,info:blue",translateTime:"HH:MM:ss"}}}):o({level:"info"});export{i as a};

package/dist/chunks/chunk-ARW46OJS.js

@@ -1 +0,0 @@
-function r(n){return Object.prototype.toString.call(n)==="[object Object]"}function s(n,o){let t={...n};for(let e in o)r(o[e])&&r(t[e])?t[e]=s(t[e],o[e]):t[e]=o[e];return t}function c(n,o){let t={...n};for(let e of o)delete t[e];return t}function i(n,o){let t={};for(let e of o)e in n&&(t[e]=n[e]);return t}function T(n){return structuredClone(n)}export{r as a,s as b,c,i as d,T as e};