@rtorcato/js-common 2.8.2 → 3.0.0

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

package/dist/mime-types/index.d.ts

@@ -15,15 +15,35 @@ import type { FileExtension, MimeType } from './db.js';
 export * from './db.js';
 /**
  * Map from `MimeType` to its associated file extensions, populated from the database.
+ *
+ * @example
+ * ```typescript
+ * extensions['application/json'] // ['json', 'map']
+ * extensions['text/html'] // ['html', 'htm', 'shtml']
+ * ```
  */
 export declare const extensions: Record<MimeType, FileExtension[]>;
 /**
  * Map from `FileExtension` to its canonical `MimeType`, populated from the database.
+ *
+ * @example
+ * ```typescript
+ * types['json'] // 'application/json'
+ * types['png'] // 'image/png'
+ * ```
  */
 export declare const types: Record<FileExtension, MimeType>;
 /**
  * Lookup the MIME type for a file path/extension.
  *
+ * @example
+ * ```typescript
+ * lookup('json') // 'application/json'
+ * lookup('.png') // 'image/png'
+ * lookup('/path/to/report.pdf') // 'application/pdf'
+ * lookup('nope') // false
+ * ```
+ *
  * @param {string} path
  * @return {boolean|string}
  */

package/dist/mime-types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mime-types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAOtD,cAAc,SAAS,CAAA;AAOvB;;GAEG;AACH,eAAO,MAAM,UAAU,EAAS,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,KAAK,EAAS,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AAK1D;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,swzBAalC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mime-types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAOtD,cAAc,SAAS,CAAA;AAOvB;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAS,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAA;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,EAAS,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AAK1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,swzBAalC"}

package/dist/node/index.d.ts

@@ -40,13 +40,4 @@ export declare const isNode: () => boolean;
  * const optionalModule = requireOptional('some-module');
  */
 export declare function requireOptional(moduleName: string): any | undefined;
-/**
- * Returns the process uptime in seconds.
- *
- * @returns The number of seconds the current Node.js process has been running.
- *
- * @example
- * const uptime = getProcessUptime();
- */
-export declare const getProcessUptime: () => number;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,IAMtD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAEtC,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;;;;;GAQG;AAEH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAOnE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAEnC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,IAMtD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAEtC,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;;;;;GAQG;AAEH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAOnE"}

package/dist/node/index.js

@@ -1 +1 @@
-import{a as r}from"../chunks/chunk-ANN5UYCF.js";var n=e=>{o()<e&&(console.log("Please update Node to run this app"),process.exit(1))},o=()=>Number(process.version.match(/^v(\d+)/)?.[1]||0),t=()=>typeof process<"u"&&process.release?.name==="node";function s(e){try{return r(e)}catch{return}}var i=()=>process.uptime();export{o as getNodeMajorVersion,i as getProcessUptime,t as isNode,n as nodeVersionCheck,s as requireOptional};
+import{a as r}from"../chunks/chunk-ANN5UYCF.js";var n=e=>{o()<e&&(console.log("Please update Node to run this app"),process.exit(1))},o=()=>Number(process.version.match(/^v(\d+)/)?.[1]||0),t=()=>typeof process<"u"&&process.release?.name==="node";function s(e){try{return r(e)}catch{return}}export{o as getNodeMajorVersion,t as isNode,n as nodeVersionCheck,s as requireOptional};

package/dist/numbers/index.d.ts

@@ -1,12 +1,13 @@
-/**
- * Returns a random integer between min and max (inclusive).
- * @param min The minimum value (inclusive).
- * @param max The maximum value (inclusive).
- * @returns A random integer.
- */
-export declare function getRandomInt(min: number, max: number): number;
 /**
  * Clamps a number between a minimum and maximum value.
+ *
+ * @example
+ * ```typescript
+ * clamp(15, 0, 10) // 10
+ * clamp(-5, 0, 10) // 0
+ * clamp(5, 0, 10) // 5
+ * ```
+ *
  * @param value The number to clamp.
  * @param min The minimum value.
  * @param max The maximum value.
@@ -15,6 +16,14 @@ export declare function getRandomInt(min: number, max: number): number;
 export declare function clamp(value: number, min: number, max: number): number;
 /**
  * Rounds a number to a specified number of decimal places.
+ *
+ * @example
+ * ```typescript
+ * roundTo(3.14159) // 3.14
+ * roundTo(3.14159, 3) // 3.142
+ * roundTo(1234.5, 0) // 1235
+ * ```
+ *
  * @param value The number to round.
  * @param decimals The number of decimal places. Defaults to 2.
  * @returns The rounded number.
@@ -27,12 +36,19 @@ export declare function roundTo(value: number, decimals?: number): number;
  */
 export declare function isFiniteNumber(value: unknown): value is number;
 /**
- * Generates a random float between min (inclusive) and max (exclusive).
- * @param min The minimum value (inclusive).
- * @param max The maximum value (exclusive).
- * @returns A random float.
+ * Formats a number as a percentage string.
+ *
+ * @example
+ * ```typescript
+ * formatPercent(0.25) // '25%'
+ * formatPercent(0.1234, 1) // '12.3%'
+ * ```
+ *
+ * @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 getRandomFloat(min: number, max: number): number;
+export declare function formatPercent(value: number, fractionDigits?: number): string;
 /**
  * Checks if a value is an integer.
  * @param value The value to check.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/numbers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,OAAO,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/numbers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,OAAO,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C"}

package/dist/numbers/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function o(n,r){return Math.floor(Math.random()*(r-n+1))+n}function m(n,r,e){return Math.max(r,Math.min(e,n))}function b(n,r=2){let e=10**r;return Math.round(n*e)/e}function i(n){return typeof n=="number"&&Number.isFinite(n)}function a(n,r){return Math.random()*(r-n)+n}function c(n){return typeof n=="number"&&Number.isInteger(n)}function f(n,r,e,t=!0){return t?n>=r&&n<=e:n>r&&n<e}function u(n){return n.reduce((r,e)=>r+e,0)}function p(n){return n.length===0?0:u(n)/n.length}function x(n,r){return(n%r+r)%r}function h(n){return Math.min(...n)}function d(n){return Math.max(...n)}export{p as average,f as between,m as clamp,a as getRandomFloat,o as getRandomInt,i as isFiniteNumber,c as isInteger,d as max,h as min,x as mod,b as roundTo,u as sum};
+import"../chunks/chunk-ANN5UYCF.js";function o(n,r,e){return Math.max(r,Math.min(e,n))}function m(n,r=2){let e=10**r;return Math.round(n*e)/e}function b(n){return typeof n=="number"&&Number.isFinite(n)}function i(n,r=0){return`${(n*100).toFixed(r)}%`}function c(n){return typeof n=="number"&&Number.isInteger(n)}function f(n,r,e,t=!0){return t?n>=r&&n<=e:n>r&&n<e}function u(n){return n.reduce((r,e)=>r+e,0)}function p(n){return n.length===0?0:u(n)/n.length}function x(n,r){return(n%r+r)%r}function a(n){return Math.min(...n)}function h(n){return Math.max(...n)}export{p as average,f as between,o as clamp,i as formatPercent,b as isFiniteNumber,c as isInteger,h as max,a as min,x as mod,m as roundTo,u as sum};

package/dist/objects/index.d.ts

@@ -1,11 +1,27 @@
 /**
  * Returns true if the value is a plain object (not null, not array, not function).
+ *
+ * @example
+ * ```typescript
+ * isPlainObject({ a: 1 }) // true
+ * isPlainObject([1, 2]) // false
+ * isPlainObject(null) // false
+ * isPlainObject(new Date()) // false
+ * ```
+ *
  * @param value The value to check.
  * @returns {boolean}
  */
 export declare function isPlainObject(value: any): value is Record<string, any>;
 /**
  * Deeply merges two objects. Does not mutate inputs.
+ *
+ * @example
+ * ```typescript
+ * deepMerge({ a: 1, nested: { x: 1, y: 2 } }, { nested: { y: 9 }, b: 2 })
+ * // { a: 1, nested: { x: 1, y: 9 }, b: 2 }
+ * ```
+ *
  * @param target The target object.
  * @param source The source object.
  * @returns {object} The merged object.
@@ -13,6 +29,13 @@ export declare function isPlainObject(value: any): value is Record<string, any>;
 export declare function deepMerge<T extends object, U extends object>(target: T, source: U): T & U;
 /**
  * Returns a shallow copy of an object with the given keys omitted.
+ *
+ * @example
+ * ```typescript
+ * omit({ id: 1, name: 'Ada', password: 'x' }, ['password'])
+ * // { id: 1, name: 'Ada' }
+ * ```
+ *
  * @param obj The source object.
  * @param keys Keys to omit.
  * @returns {object}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/objects/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAUzF;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMvF;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQvF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/objects/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAUzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMvF;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQvF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC"}

package/dist/os/index.d.ts

@@ -1,15 +1,33 @@
 /**
  * Returns the current operating system platform (Node.js only).
+ *
+ * @example
+ * ```typescript
+ * getOsPlatform() // 'darwin' on macOS, 'win32' on Windows, undefined in a browser
+ * ```
+ *
  * @returns {string | undefined} The platform (e.g., 'darwin', 'win32', 'linux').
  */
 export declare function getOsPlatform(): string | undefined;
 /**
  * Returns the OS release/version (Node.js only).
+ *
+ * @example
+ * ```typescript
+ * getOsRelease() // 'node'
+ * ```
+ *
  * @returns {string | undefined}
  */
 export declare function getOsRelease(): string | undefined;
 /**
  * Returns the OS architecture (Node.js only).
+ *
+ * @example
+ * ```typescript
+ * getOsArch() // 'arm64' on Apple silicon, 'x64' on Intel
+ * ```
+ *
  * @returns {string | undefined}
  */
 export declare function getOsArch(): string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/os/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAGlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAIjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAG9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAM/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAO9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/os/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAGlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAIjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAG9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAM/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAO9C"}

package/dist/process/index.d.ts

@@ -1,15 +1,33 @@
 /**
  * Returns the current process ID (Node.js only).
+ *
+ * @example
+ * ```typescript
+ * getProcessId() // 48213 (undefined in a browser)
+ * ```
+ *
  * @returns {number | undefined}
  */
 export declare function getProcessId(): number | undefined;
 /**
  * Returns the current process uptime in seconds (Node.js only).
+ *
+ * @example
+ * ```typescript
+ * getProcessUptime() // 12.482
+ * ```
+ *
  * @returns {number | undefined}
  */
 export declare function getProcessUptime(): number | undefined;
 /**
  * Returns the current working directory (Node.js only).
+ *
+ * @example
+ * ```typescript
+ * getCwd() // '/Users/ada/projects/app'
+ * ```
+ *
  * @returns {string | undefined}
  */
 export declare function getCwd(): string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAIrD;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,MAAM,GAAG,SAAS,CAG3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAGvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAS9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAIrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,IAAI,MAAM,GAAG,SAAS,CAG3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAGvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAS9B"}

package/dist/promises/index.d.ts

@@ -1,17 +1,44 @@
 /**
  * Returns a promise that resolves after a given delay (ms).
+ *
+ * @example
+ * ```typescript
+ * const started = Date.now()
+ * await delay(100)
+ * Date.now() - started >= 100 // true
+ * ```
+ *
  * @param ms Milliseconds to wait.
  * @returns {Promise<void>}
  */
 export declare function delay(ms: number): Promise<void>;
 /**
  * Wraps a promise and returns a tuple [error, result].
+ * The error slot is `unknown` — narrow it at the call site before touching its properties.
+ *
+ * @example
+ * ```typescript
+ * const [err, value] = await to(Promise.resolve(42))
+ * // err = null, value = 42
+ *
+ * const [err2, value2] = await to(Promise.reject(new Error('boom')))
+ * const message = err2 instanceof Error ? err2.message : String(err2)
+ * // message = 'boom', value2 = undefined
+ * ```
+ *
  * @param promise The promise to wrap.
- * @returns {Promise<[any, T | undefined]>}
+ * @returns {Promise<[unknown, T | undefined]>}
  */
-export declare function to<T>(promise: Promise<T>): Promise<[any, T | undefined]>;
+export declare function to<T>(promise: Promise<T>): Promise<[unknown, T | undefined]>;
 /**
  * Returns a promise that rejects after a timeout if the input promise does not resolve.
+ *
+ * @example
+ * ```typescript
+ * await withTimeout(delay(10).then(() => 'fast'), 100) // 'fast'
+ * await withTimeout(delay(500), 100) // rejects with Error('Timeout')
+ * ```
+ *
  * @param promise The promise to race.
  * @param ms Timeout in milliseconds.
  * @param error Optional error to throw on timeout.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/promises/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;GAIG;AAEH,wBAAsB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAO9E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,GAA0B,GAC/B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAExF;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/promises/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAsB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAOlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,GAA0B,GAC/B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAExF;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1D"}

package/dist/promises/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function n(e){return new Promise(r=>setTimeout(r,e))}async function s(e){try{return[null,await e]}catch(r){return[r,void 0]}}function u(e,r,t=new Error("Timeout")){return Promise.race([e,new Promise((i,o)=>setTimeout(()=>o(t),r))])}function m(e){return Promise.all(e)}function T(e){return Promise.allSettled(e)}function P(e){return Promise.race(e)}export{m as all,T as allSettled,n as delay,P as race,s as to,u as withTimeout};
+import{a,b,c,d,e,f}from"../chunks/chunk-7JQSIREC.js";import"../chunks/chunk-ANN5UYCF.js";export{d as all,e as allSettled,a as delay,f as race,b as to,c as withTimeout};

package/dist/promises/promises.test-d.d.ts

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

package/dist/promises/promises.test-d.d.ts.map

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

package/dist/promises/promises.test-d.js

@@ -0,0 +1 @@
+import{b as t,c as r,d as i,e as s,f as l}from"../chunks/chunk-7JQSIREC.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as m,expectTypeOf as e,it as o}from"vitest";m("promises \u2014 types",()=>{o("withTimeout preserves the awaited type",()=>{e(r(Promise.resolve(42),10)).toEqualTypeOf(),e(r(Promise.resolve({id:1}),10)).toEqualTypeOf()}),o("to returns an [error, value] tuple with the value widened to undefined",()=>{e(t(Promise.resolve("x"))).toEqualTypeOf()}),o("all/allSettled/race preserve the element type",()=>{e(i([Promise.resolve(1)])).toEqualTypeOf(),e(s([Promise.resolve("a")])).toEqualTypeOf(),e(l([Promise.resolve(!0)])).toEqualTypeOf()})});

package/dist/random/index.d.ts

@@ -1,5 +1,12 @@
 /**
  * Returns a random integer between min (inclusive) and max (inclusive).
+ *
+ * @example
+ * ```typescript
+ * randomInt(1, 6) // 3 (any integer from 1 to 6)
+ * randomInt(5, 5) // 5
+ * ```
+ *
  * @param min Minimum integer value.
  * @param max Maximum integer value.
  * @returns {number} Random integer between min and max.
@@ -7,6 +14,13 @@
 export declare function randomInt(min: number, max: number): number;
 /**
  * Returns a random float between min (inclusive) and max (exclusive).
+ *
+ * @example
+ * ```typescript
+ * randomFloat(0, 1) // 0.7342119...
+ * randomFloat(10, 20) // 14.028...
+ * ```
+ *
  * @param min Minimum float value.
  * @param max Maximum float value.
  * @returns {number} Random float between min and max.
@@ -14,6 +28,13 @@ export declare function randomInt(min: number, max: number): number;
 export declare function randomFloat(min: number, max: number): number;
 /**
  * Returns a random boolean value.
+ *
+ * @example
+ * ```typescript
+ * randomBool() // true
+ * randomBool() // false
+ * ```
+ *
  * @returns {boolean}
  */
 export declare function randomBool(): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/random/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAyE,GAC9E,MAAM,CAMR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/random/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAyE,GAC9E,MAAM,CAMR"}

package/dist/regex/index.d.ts

@@ -1,11 +1,27 @@
 /**
  * Escapes special regex characters in a string so it can be used in a RegExp.
+ *
+ * @example
+ * ```typescript
+ * escapeRegExp('1 + 1 = 2?') // '1 \\+ 1 = 2\\?'
+ * new RegExp(escapeRegExp('a.b')).test('a.b') // true
+ * new RegExp(escapeRegExp('a.b')).test('axb') // false
+ * ```
+ *
  * @param str The string to escape.
  * @returns The escaped string.
  */
 export declare function escapeRegExp(str: string): string;
 /**
  * Tests if a string matches a given regex pattern.
+ *
+ * @example
+ * ```typescript
+ * testRegex('hello world', /world/) // true
+ * testRegex('hello world', '^hello') // true
+ * testRegex('hello', /bye/) // false
+ * ```
+ *
  * @param str The string to test.
  * @param pattern The regex pattern (string or RegExp).
  * @returns True if the string matches, false otherwise.
@@ -13,6 +29,13 @@ export declare function escapeRegExp(str: string): string;
 export declare function testRegex(str: string, pattern: string | RegExp): boolean;
 /**
  * Returns all matches of a regex pattern in a string.
+ *
+ * @example
+ * ```typescript
+ * matchAll('a1 b2 c3', /[a-z](\d)/).map((m) => m[1]) // ['1', '2', '3']
+ * matchAll('nothing here', /\d/) // []
+ * ```
+ *
  * @param str The string to search.
  * @param pattern The regex pattern (string or RegExp).
  * @returns An array of matches, or an empty array if none found.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/regex/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,EAAE,CASlF;AAED;;;;;;GAMG;AAEH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACnE,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAG5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/regex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAGxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,EAAE,CASlF;AAED;;;;;;GAMG;AAEH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACnE,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAG5E"}

package/dist/security/index.d.ts

@@ -1,17 +1,49 @@
 /**
- * Sanitizes a string by removing script tags and event handlers.
- * @param str The string to sanitize.
- * @returns The sanitized string.
+ * Removes `<script>` blocks and inline `on*=` event-handler attributes from a string.
+ *
+ * **Not a sanitizer, and deliberately not named like one.** It is a blocklist over
+ * two shapes, so anything it does not name survives, and a single pass can be
+ * defeated by nesting the pattern inside itself. Use it as defence in depth on
+ * markup you already trust. For untrusted input, escape with `html.escapeHtml`,
+ * or run a real sanitizer such as DOMPurify when the markup must survive.
+ *
+ * @example
+ * ```typescript
+ * stripScriptish('<p onclick="steal()">hi</p><script>bad()</script>')
+ * // '<p>hi</p>'
+ *
+ * // Bypassable by construction — this is XSS it does not name, so it survives:
+ * stripScriptish('<a href="javascript:alert(1)">x</a>')
+ * // '<a href="javascript:alert(1)">x</a>'
+ * ```
+ *
+ * @param str The string to strip.
+ * @returns The string with script blocks and inline handlers removed.
  */
-export declare function sanitizeString(str: string): string;
+export declare function stripScriptish(str: string): string;
 /**
  * Checks if a password is strong (min 8 chars, upper, lower, number, special char).
+ *
+ * @example
+ * ```typescript
+ * isStrongPassword('Str0ng!pass') // true
+ * isStrongPassword('password') // false
+ * isStrongPassword('Sh0rt!') // false (under 8 characters)
+ * ```
+ *
  * @param password The password to check.
  * @returns True if the password is strong, false otherwise.
  */
 export declare function isStrongPassword(password: string): boolean;
 /**
  * Generates a cryptographically secure random token (hex string).
+ *
+ * @example
+ * ```typescript
+ * generateSecureToken() // 64 hex chars (32 bytes)
+ * generateSecureToken(8) // 'c1f0a4e29b73d518'
+ * ```
+ *
  * @param length The number of bytes (not hex chars).
  * @returns A random hex string.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAK,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBlD;AAgDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAK,GAAG,MAAM,CAEvD"}

package/dist/security/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";import{randomBytes as t}from"node:crypto";function e(r){return r.replace(/<script.*?>.*?<\/script>/gi,"").replace(/on\w+\s*=\s*(['"]).*?\1/gi,"")}function i(r){return/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]).{8,}$/.test(r)}function o(r=32){return t(r).toString("hex")}export{o as generateSecureToken,i as isStrongPassword,e as sanitizeString};
+import"../chunks/chunk-ANN5UYCF.js";import{randomBytes as a}from"node:crypto";function u(t){let e=d(t),n;do n=e,e=e.replace(/[\s/]on\w+\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]*)/gi,"");while(e!==n);return e}function d(t){let e=t.toLowerCase(),n="",i=0,s=0;for(;;){let r=e.indexOf("<script",s);if(r===-1)break;let o=e[r+7];if(o!==void 0&&o!==">"&&o!=="/"&&!/\s/.test(o)){s=r+7;continue}let c=e.indexOf(">",r);if(c===-1)break;let f=e.indexOf("</script",c);if(f===-1)break;let l=e.indexOf(">",f);if(l===-1)break;n+=t.slice(i,r),i=l+1,s=i}return n+t.slice(i)}function g(t){return/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]).{8,}$/.test(t)}function x(t=32){return a(t).toString("hex")}export{x as generateSecureToken,g as isStrongPassword,u as stripScriptish};

package/dist/sets/index.d.ts

@@ -1,5 +1,11 @@
 /**
  * Returns the union of two sets.
+ *
+ * @example
+ * ```typescript
+ * union(new Set([1, 2]), new Set([2, 3])) // Set { 1, 2, 3 }
+ * ```
+ *
  * @param a First set.
  * @param b Second set.
  * @returns {Set<T>} Union of a and b.
@@ -7,6 +13,13 @@
 export declare function union<T>(a: Set<T>, b: Set<T>): Set<T>;
 /**
  * Returns the intersection of two sets.
+ *
+ * @example
+ * ```typescript
+ * intersection(new Set([1, 2, 3]), new Set([2, 3, 4])) // Set { 2, 3 }
+ * intersection(new Set([1]), new Set([2])) // Set {}
+ * ```
+ *
  * @param a First set.
  * @param b Second set.
  * @returns {Set<T>} Intersection of a and b.
@@ -14,6 +27,12 @@ export declare function union<T>(a: Set<T>, b: Set<T>): Set<T>;
 export declare function intersection<T>(a: Set<T>, b: Set<T>): Set<T>;
 /**
  * Returns the difference of two sets (elements in a not in b).
+ *
+ * @example
+ * ```typescript
+ * difference(new Set([1, 2, 3]), new Set([2])) // Set { 1, 3 }
+ * ```
+ *
  * @param a First set.
  * @param b Second set.
  * @returns {Set<T>} Difference of a and b.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sets/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAE9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAErD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAE5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAE9C"}

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