@rtorcato/js-common 2.8.2 → 4.0.0

package/dist/functions/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function o(n){let t=!1,e;return function(...r){return t||(t=!0,e=n.apply(this,r)),e}}function T(n,t){let e;return function(...r){clearTimeout(e),e=setTimeout(()=>n.apply(this,r),t)}}function u(n,t){let e=0;return function(...r){let a=Date.now();a-e>=t&&(e=a,n.apply(this,r))}}function i(...n){return t=>n.reduceRight((e,r)=>r(e),t)}function s(...n){return t=>n.reduce((e,r)=>r(e),t)}export{i as compose,T as debounce,o as once,s as pipe,u as throttle};
+import{a,b,c,d,e}from"../chunks/chunk-RBXTRLWB.js";import"../chunks/chunk-ANN5UYCF.js";export{d as compose,b as debounce,a as once,e as pipe,c as throttle};

package/dist/geometry/index.d.ts

@@ -1,5 +1,12 @@
 /**
  * Calculates the distance between two points in 2D space.
+ *
+ * @example
+ * ```typescript
+ * distance2D(0, 0, 3, 4) // 5
+ * distance2D(1, 1, 1, 1) // 0
+ * ```
+ *
  * @param x1 X coordinate of first point.
  * @param y1 Y coordinate of first point.
  * @param x2 X coordinate of second point.
@@ -9,6 +16,13 @@
 export declare function distance2D(x1: number, y1: number, x2: number, y2: number): number;
 /**
  * Calculates the midpoint between two points in 2D space.
+ *
+ * @example
+ * ```typescript
+ * midpoint2D(0, 0, 4, 6) // [2, 3]
+ * midpoint2D(-2, 5, 2, 5) // [0, 5]
+ * ```
+ *
  * @param x1 X coordinate of first point.
  * @param y1 Y coordinate of first point.
  * @param x2 X coordinate of second point.
@@ -18,6 +32,13 @@ export declare function distance2D(x1: number, y1: number, x2: number, y2: numbe
 export declare function midpoint2D(x1: number, y1: number, x2: number, y2: number): [number, number];
 /**
  * Calculates the angle (in radians) between two points in 2D space.
+ *
+ * @example
+ * ```typescript
+ * angle2D(0, 0, 1, 0) // 0
+ * angle2D(0, 0, 0, 1) // 1.5707963267948966 (Math.PI / 2)
+ * ```
+ *
  * @param x1 X coordinate of first point.
  * @param y1 Y coordinate of first point.
  * @param x2 X coordinate of second point.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3F;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAY9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAY9D"}

package/dist/html/index.d.ts

@@ -1,17 +1,50 @@
 /**
  * Escapes special HTML characters in a string to prevent XSS attacks.
+ *
+ * @example
+ * ```typescript
+ * escapeHtml('<script>alert("x")</script>')
+ * // '&lt;script&gt;alert(&quot;x&quot;)&lt;/script&gt;'
+ * escapeHtml("Tom & Jerry's") // 'Tom &amp; Jerry&#39;s'
+ * ```
+ *
  * @param str The string to escape.
  * @returns The escaped string.
  */
 export declare function escapeHtml(str: string): string;
 /**
  * Unescapes HTML entities in a string.
+ *
+ * @example
+ * ```typescript
+ * unescapeHtml('&lt;b&gt;hi&lt;/b&gt;') // '<b>hi</b>'
+ * unescapeHtml('Tom &amp; Jerry') // 'Tom & Jerry'
+ * unescapeHtml('a&#x2F;b&nbsp;c') // 'a/b c'
+ * ```
+ *
  * @param str The string to unescape.
  * @returns The unescaped string.
  */
 export declare function unescapeHtml(str: string): string;
 /**
  * Strips all HTML tags from a string.
+ *
+ * @example
+ * ```typescript
+ * stripHtmlTags('<p>Hello <b>world</b></p>') // 'Hello world'
+ * stripHtmlTags('plain text') // 'plain text'
+ *
+ * // Strips `<…>` spans, so ragged input leaves residue — not a sanitizer.
+ * stripHtmlTags('<<a>script>') // 'script>'
+ * stripHtmlTags('<scr<x>ipt>') // 'ipt>'
+ * ```
+ *
+ * Removes `<…>` spans and nothing else: it does not decode entities and does
+ * not understand attributes or quoting, so ragged or nested markup leaves
+ * attacker-controlled residue behind rather than a safe string. Not a
+ * substitute for a real sanitizer such as DOMPurify when rendering untrusted
+ * HTML — this produces display text, it does not make untrusted markup safe.
+ *
  * @param str The string to strip tags from.
  * @returns The plain text string.
  */
@@ -24,6 +57,11 @@ export declare function stripHtmlTags(str: string): string;
 export declare function textToHtml(str: string): string;
 /**
  * Checks if a string contains any HTML tags.
+ *
+ * A heuristic for "does this look like markup", not a security gate: it only
+ * looks for a non-empty `<…>` span, so `'a<b'` and `'<>'` are both false. Do
+ * not use it to decide whether untrusted input is safe to render.
+ *
  * @param str The string to check.
  * @returns True if the string contains HTML tags, false otherwise.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAehD;AAkBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMjD"}

package/dist/html/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function t(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function r(e){return e.replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/&amp;/g,"&")}function n(e){return e.replace(/<[^>]*>/g,"")}function g(e){return e.replace(/\n/g,"<br>")}function p(e){return/<[^>]+>/.test(e)}export{p as containsHtml,t as escapeHtml,n as stripHtmlTags,g as textToHtml,r as unescapeHtml};
+import"../chunks/chunk-ANN5UYCF.js";function o(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function c(e){let n={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&#x27;":"'","&#x2F;":"/","&nbsp;":" "};return e.replace(/&(?:amp|lt|gt|quot|#39|#x27|#x2F|nbsp);/g,t=>n[t]??t)}function l(e,n){let t=e.indexOf("<",n);if(t===-1)return null;let r=e.indexOf(">",t+1);return r===-1?null:{open:t,close:r}}function i(e){let n="",t=0;for(let r=l(e,t);r;r=l(e,t))n+=e.slice(t,r.open),t=r.close+1;return n+e.slice(t)}function s(e){return e.replace(/\n/g,"<br>")}function g(e){for(let n=l(e,0);n;n=l(e,n.close+1))if(n.close>n.open+1)return!0;return!1}export{g as containsHtml,o as escapeHtml,i as stripHtmlTags,s as textToHtml,c as unescapeHtml};

package/dist/i18n/index.d.ts

@@ -1,10 +1,25 @@
 /**
  * Detects the user's preferred language from the browser or Node.js environment.
+ *
+ * @example
+ * ```typescript
+ * detectLanguage() // 'en' (from navigator.language 'en-GB' or LANG 'en_US.UTF-8')
+ * detectLanguage('fr') // 'fr' when nothing can be detected
+ * ```
+ *
  * @returns {string} The language code (e.g., 'en', 'fr').
  */
 export declare function detectLanguage(defaultLang?: string): string;
 /**
  * Formats a number as a localized string.
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234.5, 'en-US') // '1,234.5'
+ * formatNumber(1234.5, 'de-DE') // '1.234,5'
+ * formatNumber(0.42, 'en-US', { style: 'percent' }) // '42%'
+ * ```
+ *
  * @param value The number to format.
  * @param locale The locale code (e.g., 'en-US').
  * @param options Intl.NumberFormat options.
@@ -13,6 +28,14 @@ export declare function detectLanguage(defaultLang?: string): string;
 export declare function formatNumber(value: number, locale?: string, options?: Intl.NumberFormatOptions): string;
 /**
  * Formats a date as a localized string.
+ *
+ * @example
+ * ```typescript
+ * const d = new Date('2026-08-11T12:00:00Z')
+ * formatDateI18n(d, 'en-US', { timeZone: 'UTC' }) // '8/11/2026'
+ * formatDateI18n(d, 'en-GB', { timeZone: 'UTC' }) // '11/08/2026'
+ * ```
+ *
  * @param date The date to format.
  * @param locale The locale code (e.g., 'en-US').
  * @param options Intl.DateTimeFormat options.
@@ -27,11 +50,4 @@ export declare function formatDateI18n(date: Date, locale?: string, options?: In
  * @returns {string}
  */
 export declare function t(key: string, dict: Record<string, Record<string, string>>, lang?: string): string;
-/**
- * Pluralizes a word based on a count (basic English only).
- * @param word The word to pluralize.
- * @param count The count.
- * @returns {string}
- */
-export declare function pluralize(word: string, count: number): string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAAa,GAAG,MAAM,CAQjE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAChC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,CAAC,CAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAAa,GAAG,MAAM,CAQjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAChC,MAAM,CAER;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,CAAC,CAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAGR"}

package/dist/i18n/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function i(n="en"){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0]||n:typeof process<"u"&&process.env.LANG&&(process.env.LANG??"en").split("_")[0]||n}function o(n,t,r){return new Intl.NumberFormat(t,r).format(n)}function s(n,t,r){return new Intl.DateTimeFormat(t,r).format(n)}function a(n,t,r){let e=r||i();return t[e]?.[n]||t.en?.[n]||n}function g(n,t){return t===1?n:`${n}s`}export{i as detectLanguage,s as formatDateI18n,o as formatNumber,g as pluralize,a as t};
+import"../chunks/chunk-ANN5UYCF.js";function i(n="en"){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0]||n:typeof process<"u"&&process.env.LANG&&(process.env.LANG??"en").split("_")[0]||n}function o(n,t,r){return new Intl.NumberFormat(t,r).format(n)}function s(n,t,r){return new Intl.DateTimeFormat(t,r).format(n)}function a(n,t,r){let e=r||i();return t[e]?.[n]||t.en?.[n]||n}export{i as detectLanguage,s as formatDateI18n,o as formatNumber,a as t};

package/dist/json/index.d.ts

@@ -1,5 +1,13 @@
 /**
  * Safely parses a JSON string, returning a fallback value if parsing fails.
+ *
+ * @example
+ * ```typescript
+ * safeJsonParse('{"a":1}') // { a: 1 }
+ * safeJsonParse('{oops') // null
+ * safeJsonParse('{oops', {}) // {}
+ * ```
+ *
  * @param {string} str - The JSON string to parse.
  * @param {any} [fallback=null] - The value to return if parsing fails.
  * @returns The parsed object or the fallback value.
@@ -7,6 +15,17 @@
 export declare function safeJsonParse<T = any>(str: string, fallback?: T | null): T | null;
 /**
  * Safely stringifies a value to JSON, returning a fallback value if stringification fails.
+ *
+ * @example
+ * ```typescript
+ * safeJsonStringify({ a: 1 }) // '{"a":1}'
+ *
+ * const circular: any = {}
+ * circular.self = circular
+ * safeJsonStringify(circular) // null
+ * safeJsonStringify(circular, '{}') // '{}'
+ * ```
+ *
  * @param {any} value - The value to stringify.
  * @param {string} [fallback=null] - The value to return if stringification fails.
  * @returns The JSON string or the fallback value.
@@ -14,15 +33,16 @@ export declare function safeJsonParse<T = any>(str: string, fallback?: T | null)
 export declare function safeJsonStringify(value: any, fallback?: string | null): string | null;
 /**
  * Checks if a string is valid JSON.
+ *
+ * @example
+ * ```typescript
+ * isValidJson('{"a":1}') // true
+ * isValidJson('[1,2]') // true
+ * isValidJson('{oops') // false
+ * ```
+ *
  * @param {string} str - The string to check.
  * @returns {boolean} True if the string is valid JSON, false otherwise.
  */
 export declare function isValidJson(str: string): boolean;
-/**
- * Deep clones a value using JSON serialization.
- * Note: Only works for JSON-safe values (no functions, undefined, etc).
- * @param {T} value - The value to clone.
- * @returns {T} The deep-cloned value.
- */
-export declare function deepCloneJson<T>(value: T): T;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,IAAW,GAAG,CAAC,GAAG,IAAI,CAMvF;AAED;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,GAAG,IAAI,CAM3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,IAAW,GAAG,CAAC,GAAG,IAAI,CAMvF;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,GAAG,IAAI,CAM3F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD"}

package/dist/json/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function t(n,r=null){try{return JSON.parse(n)}catch{return r}}function e(n,r=null){try{return JSON.stringify(n)}catch{return r}}function s(n){try{return JSON.parse(n),!0}catch{return!1}}function u(n){return JSON.parse(JSON.stringify(n))}export{u as deepCloneJson,s as isValidJson,t as safeJsonParse,e as safeJsonStringify};
+import"../chunks/chunk-ANN5UYCF.js";function t(n,r=null){try{return JSON.parse(n)}catch{return r}}function e(n,r=null){try{return JSON.stringify(n)}catch{return r}}function s(n){try{return JSON.parse(n),!0}catch{return!1}}export{s as isValidJson,t as safeJsonParse,e as safeJsonStringify};

package/dist/logger/index.d.ts

@@ -1,2 +1,17 @@
-export * from './logger';
+import pino from 'pino';
+/**
+ * Pre-configured Pino logger — pretty-printed with colors in development (when
+ * `pino-pretty` is installed), plain JSON at `info` level in production.
+ *
+ * @example
+ * ```typescript
+ * logger.info('server started')
+ * // dev:  14:03:27 INFO: server started
+ * // prod: {"level":30,"msg":"server started"}
+ *
+ * logger.error({ err }, 'upload failed')
+ * logger.debug('only visible in development')
+ * ```
+ */
+export declare const logger: pino.Logger<never, boolean>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAA;AAgBvB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,6BA0BQ,CAAA"}

package/dist/logger/index.js

@@ -1 +1 @@
-import{a as o}from"../chunks/chunk-6J7HIWG6.js";import"../chunks/chunk-FBDKWWIQ.js";import"../chunks/chunk-ANN5UYCF.js";export{o as logger};
+import{b as e}from"../chunks/chunk-FBDKWWIQ.js";import"../chunks/chunk-ANN5UYCF.js";import{createRequire as t}from"node:module";import r from"pino";function o(){try{return t(import.meta.url).resolve("pino-pretty"),!0}catch{return!1}}var s=e()&&o()?r({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"}}}):r({level:"info"});export{s as logger};

package/dist/logging/index.d.ts

@@ -1,16 +1,35 @@
 /**
  * Logs a message with a timestamp.
+ *
+ * @example
+ * ```typescript
+ * logWithTimestamp('server started') // [2026-08-11T14:03:27.913Z] server started
+ * logWithTimestamp('disk almost full', 'warn') // via console.warn
+ * ```
+ *
  * @param message The message to log.
  * @param level The log level (default: 'info').
  */
 export declare function logWithTimestamp(message: string, level?: 'info' | 'warn' | 'error'): void;
 /**
  * Logs a warning message.
+ *
+ * @example
+ * ```typescript
+ * warn('deprecated option') // [WARN] deprecated option
+ * ```
+ *
  * @param message The warning message.
  */
 export declare function warn(message: string): void;
 /**
  * Logs an error message.
+ *
+ * @example
+ * ```typescript
+ * error('upload failed') // [ERROR] upload failed
+ * ```
+ *
  * @param message The error message.
  */
 export declare function error(message: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,OAAgB,GAAG,IAAI,CAIjG;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5D;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACxD,MAAM,IAAI,CAgBZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,OAAgB,GAAG,IAAI,CAIjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5D;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACxD,MAAM,IAAI,CAgBZ"}

package/dist/maps/index.d.ts

@@ -1,11 +1,25 @@
 /**
  * Inverts a Map (swaps keys and values). If duplicate values exist, later keys overwrite earlier ones.
+ *
+ * @example
+ * ```typescript
+ * invertMap(new Map([['a', 1], ['b', 2]]))
+ * // Map { 1 => 'a', 2 => 'b' }
+ * ```
+ *
  * @param map The map to invert.
  * @returns {Map<any, any>} The inverted map.
  */
 export declare function invertMap<K, V>(map: Map<K, V>): Map<V, K>;
 /**
  * Maps the values of a Map using a function.
+ *
+ * @example
+ * ```typescript
+ * mapValues(new Map([['a', 1], ['b', 2]]), (v) => v * 10)
+ * // Map { 'a' => 10, 'b' => 20 }
+ * ```
+ *
  * @param map The map to map over.
  * @param fn The function to apply to each value.
  * @returns {Map<K, U>} A new map with mapped values.
@@ -13,6 +27,13 @@ export declare function invertMap<K, V>(map: Map<K, V>): Map<V, K>;
 export declare function mapValues<K, V, U>(map: Map<K, V>, fn: (value: V, key: K) => U): Map<K, U>;
 /**
  * Merges two or more maps. Later maps overwrite earlier keys.
+ *
+ * @example
+ * ```typescript
+ * mergeMaps(new Map([['a', 1]]), new Map([['a', 9], ['b', 2]]))
+ * // Map { 'a' => 9, 'b' => 2 }
+ * ```
+ *
  * @param maps The maps to merge.
  * @returns {Map<K, V>} The merged map.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/maps/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAQ/D;AAED;;;;GAIG;AAEH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAMrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/maps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAMzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAMzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAQ/D;AAED;;;;GAIG;AAEH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAMrE"}