@rtorcato/js-common 2.8.1 → 3.0.0

package/dist/strings/index.d.ts

@@ -95,13 +95,6 @@ export declare function padStart(str: string, targetLength: number, padString?:
  * @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
@@ -109,12 +102,6 @@ export declare const randomString: (length: number, chars: string) => string;
  * @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 +158,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;;;;;;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,aAAa,GAAI,KAAK,MAAM,EAAE,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,MAEhF,CAAA;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(r){return r.replace(/\w\S*/g,e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase())}function o(r){return r.length===0?"":(r[0]?.toUpperCase()??"")+r.slice(1)}function g(r){return r.replace(/[-_\s]+(.)?/g,(e,t)=>t?t.toUpperCase():"").replace(/^(.)/,e=>e.toLowerCase())}function a(r){return r.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[_\s]+/g,"-").toLowerCase()}function c(r){return r.replace(/([a-z])([A-Z])/g,"$1_$2").replace(/[-\s]+/g,"_").toLowerCase()}function u(r,e){return r.length>e?`${r.slice(0,e-1)}\u2026`:r}function p(r,e,t=" "){return r.padStart(e,t)}function l(r,e,t=" "){return r.padEnd(e,t)}var f=(r,e,t)=>r.replace(new RegExp(e,"g"),t);function x(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 b(r){return r.replace(/([a-z])([A-Z])/g,"$1 $2").replace(/[-_]+/g," ").trim().split(/\s+/).filter(Boolean)}function m(r){let e=r.trim();return e===""?0:e.split(/\s+/).length}function w(r,e,t){return e===1?r:t??`${r}s`}function C(r){let e=Math.abs(r),t=e%100,n=e%10;if(t>=11&&t<=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 h(r){return r.trim().length===0}function d(r,e,t,n="*"){if(e<0&&(e=0),t>r.length&&(t=r.length),e>=t)return r;let i=n.repeat(t-e);return r.slice(0,e)+i+r.slice(t)}function z(r,e){return r.replace(/\$\{(\w+)\}/g,(t,n)=>Object.hasOwn(e,n)?String(e[n]):t)}export{g as camelCase,o as capitalize,h as isBlank,a as kebabCase,d as mask,C as ordinalize,l as padEnd,p as padStart,w as pluralize,f as replaceString,x as reverse,$ as slugify,c as snakeCase,z as template,s as titleCase,u as truncate,m as wordCount,b 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/trycatch.d.ts

@@ -15,15 +15,39 @@ export type Failure<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=trycatch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"trycatch.d.ts","sourceRoot":"","sources":["../../src/try/trycatch.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;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE1D;;GAEG;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;;;GAGG;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"}
+{"version":3,"file":"trycatch.d.ts","sourceRoot":"","sources":["../../src/try/trycatch.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/trycatch.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trycatch.test-d.d.ts.map

package/dist/try/trycatch.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trycatch.test-d.d.ts","sourceRoot":"","sources":["../../src/try/trycatch.test-d.ts"],"names":[],"mappings":""}

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

@@ -0,0 +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()})});

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,6 +1,11 @@
 /**
  * Generates a UUID v4 string.
  * @returns {string} A new UUID v4 string.
+ *
+ * @example
+ * ```typescript
+ * getUUID() // 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
+ * ```
  */
 export declare const getUUID: () => string;
 /**
@@ -17,6 +22,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":"AAaA;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,QAAO,MAE1B,CAAA;AAED;;;;;;;;;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/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.1",
+  "version": "3.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",
@@ -40,12 +41,17 @@
     "test": "vitest",
     "test:watch": "vitest --watch",
     "coverage": "vitest run --coverage",
+    "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",
@@ -117,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"
@@ -157,10 +159,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"
@@ -242,28 +240,31 @@
     }
   },
   "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.9.1",
+    "@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": "^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": "^13.0.3",
     "typescript": "^6.0.2",
     "vitest": "^4.0.17"
   },
@@ -273,16 +274,17 @@
     "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-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/formatting/index.d.ts

@@ -1,40 +0,0 @@
-/**
- * Pads a string or number with leading zeros to a given length.
- * @param value The value to pad.
- * @param length The desired length.
- * @returns The padded string.
- */
-export declare function padZero(value: string | number, length?: number): string;
-/**
- * Formats a number with thousands separators.
- * @param num The number to format.
- * @param locale Optional locale string (default: 'en-US').
- * @returns The formatted string.
- */
-export declare function formatNumber(num: number, locale?: string): string;
-/**
- * Formats a number as a percentage string.
- * @param value The value to format (e.g. 0.25 for 25%).
- * @param fractionDigits Number of decimal places (default: 0).
- * @returns The formatted percentage string.
- */
-export declare function formatPercent(value: number, fractionDigits?: number): string;
-/**
- * Formats a Date as YYYY-MM-DD.
- * @param date The date to format.
- * @returns The formatted date string.
- */
-export declare function formatDate(date: Date): string;
-/**
- * Formats a Date as HH:MM:SS.
- * @param date The date to format.
- * @returns The formatted time string.
- */
-export declare function formatTime(date: Date): string;
-/**
- * Formats a Date as YYYY-MM-DD HH:MM:SS.
- * @param date The date to format.
- * @returns The formatted date-time string.
- */
-export declare function formatDateTime(date: Date): string;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEjD"}

package/dist/formatting/index.js

@@ -1 +0,0 @@
-import"../chunks/chunk-ANN5UYCF.js";function n(t,r=2){return String(t).padStart(r,"0")}function i(t,r="en-US"){return t.toLocaleString(r)}function u(t,r=0){return`${(t*100).toFixed(r)}%`}function e(t){return`${t.getFullYear()}-${n(t.getMonth()+1)}-${n(t.getDate())}`}function o(t){return`${n(t.getHours())}:${n(t.getMinutes())}:${n(t.getSeconds())}`}function g(t){return`${e(t)} ${o(t)}`}export{e as formatDate,g as formatDateTime,i as formatNumber,u as formatPercent,o as formatTime,n as padZero};

package/dist/math/index.d.ts

@@ -1,37 +0,0 @@
-/**
- * Add two numbers.
- * For example, 1 + 2 = 3.
- *
- * @param {number} a
- * @param {number} b
- * @returns {number} number
- */
-export declare const add: (a: number, b: number) => number;
-/**
- * Subtract two numbers.
- * For example, 2 - 1 = 1.
- *
- * @param {number} a
- * @param {number} b
- * @returns {number} number
- */
-export declare const subtract: (a: number, b: number) => number;
-/**
- * Multiply two numbers.
- * For example, 2 * 2 = 4.
- *
- * @param {number} a
- * @param {number} b
- * @returns {number} number
- */
-export declare const multiply: (a: number, b: number) => number;
-/**
- * Divide two numbers.
- * For example, 4 / 2 = 2.
- *
- * @param {number} a
- * @param {number} b
- * @returns {number} number
- */
-export declare const divide: (a: number, b: number) => number;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAe,CAAA;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAe,CAAA;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAe,CAAA;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAe,CAAA"}

package/dist/math/index.js

@@ -1 +0,0 @@
-import"../chunks/chunk-ANN5UYCF.js";var n=(e,r)=>e+r,u=(e,r)=>e-r,b=(e,r)=>e*r,m=(e,r)=>e/r;export{n as add,m as divide,b as multiply,u as subtract};

package/dist/try/attempt.d.ts

@@ -1,8 +0,0 @@
-type AttemptSuccess<T> = readonly [null, T];
-type AttemptFailure<E> = readonly [E, null];
-type AttemptResult<E, T> = AttemptSuccess<T> | AttemptFailure<E>;
-type AttemptResultAsync<E, T> = Promise<AttemptResult<E, T>>;
-export declare function attempt<E = Error, T = Promise<any>>(operation: T): AttemptResultAsync<E, T>;
-export declare function attempt<E = Error, T = any>(operation: () => T): AttemptResult<E, T>;
-export {};
-//# sourceMappingURL=attempt.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../src/try/attempt.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AAC3C,KAAK,cAAc,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAC3C,KAAK,aAAa,CAAC,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;AAChE,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAE5D,wBAAgB,OAAO,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5F,wBAAgB,OAAO,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/dist/try/attempt.js

@@ -1 +0,0 @@
-import"../chunks/chunk-ANN5UYCF.js";function r(e){if(e instanceof Promise)return e.then(t=>[null,t]).catch(t=>[t,null]);try{return[null,e()]}catch(t){return[t,null]}}export{r as attempt};