@rtorcato/js-common 2.8.2 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/AGENTS.md +114 -0
  2. package/CHANGELOG.md +23 -0
  3. package/CONTRIBUTORS.md +5 -0
  4. package/README.md +75 -26
  5. package/dist/abortController/index.d.ts +30 -0
  6. package/dist/abortController/index.d.ts.map +1 -1
  7. package/dist/arrays/arrays.test-d.js +1 -1
  8. package/dist/arrays/index.d.ts +0 -63
  9. package/dist/arrays/index.d.ts.map +1 -1
  10. package/dist/arrays/index.js +1 -1
  11. package/dist/boolean/index.d.ts +10 -33
  12. package/dist/boolean/index.d.ts.map +1 -1
  13. package/dist/boolean/index.js +1 -1
  14. package/dist/chunks/chunk-AVPQVYSA.js +1 -0
  15. package/dist/chunks/chunk-H7PB4TAW.js +1 -0
  16. package/dist/chunks/chunk-HUTZTT4Y.js +1 -0
  17. package/dist/chunks/chunk-RBXTRLWB.js +1 -0
  18. package/dist/chunks/chunk-UQBVI52L.js +1 -0
  19. package/dist/cli/catalog.js +131 -0
  20. package/dist/cli/cli.mjs +16 -109
  21. package/dist/colors/index.d.ts +23 -3
  22. package/dist/colors/index.d.ts.map +1 -1
  23. package/dist/console/index.d.ts +12 -0
  24. package/dist/console/index.d.ts.map +1 -1
  25. package/dist/crypto/index.d.ts +23 -0
  26. package/dist/crypto/index.d.ts.map +1 -1
  27. package/dist/currency/currencies.d.ts +1 -1
  28. package/dist/currency/currencies.d.ts.map +1 -1
  29. package/dist/currency/currencies.js +1 -1
  30. package/dist/currency/index.d.ts +0 -14
  31. package/dist/currency/index.d.ts.map +1 -1
  32. package/dist/currency/index.js +1 -1
  33. package/dist/date/index.d.ts +16 -0
  34. package/dist/date/index.d.ts.map +1 -1
  35. package/dist/datetime/index.d.ts +21 -9
  36. package/dist/datetime/index.d.ts.map +1 -1
  37. package/dist/datetime/index.js +1 -1
  38. package/dist/emails/index.d.ts +22 -0
  39. package/dist/emails/index.d.ts.map +1 -1
  40. package/dist/emails/index.js +1 -1
  41. package/dist/env/index.d.ts +24 -0
  42. package/dist/env/index.d.ts.map +1 -1
  43. package/dist/errors/index.d.ts +30 -2
  44. package/dist/errors/index.d.ts.map +1 -1
  45. package/dist/events/index.d.ts +25 -1
  46. package/dist/events/index.d.ts.map +1 -1
  47. package/dist/events/index.js +1 -1
  48. package/dist/fetch/index.d.ts +25 -0
  49. package/dist/fetch/index.d.ts.map +1 -1
  50. package/dist/file/index.d.ts +20 -0
  51. package/dist/file/index.d.ts.map +1 -1
  52. package/dist/functions/functions.test-d.d.ts +2 -0
  53. package/dist/functions/functions.test-d.d.ts.map +1 -0
  54. package/dist/functions/functions.test-d.js +1 -0
  55. package/dist/functions/index.d.ts +32 -2
  56. package/dist/functions/index.d.ts.map +1 -1
  57. package/dist/functions/index.js +1 -1
  58. package/dist/geometry/index.d.ts +21 -0
  59. package/dist/geometry/index.d.ts.map +1 -1
  60. package/dist/html/index.d.ts +38 -0
  61. package/dist/html/index.d.ts.map +1 -1
  62. package/dist/html/index.js +1 -1
  63. package/dist/i18n/index.d.ts +23 -7
  64. package/dist/i18n/index.d.ts.map +1 -1
  65. package/dist/i18n/index.js +1 -1
  66. package/dist/json/index.d.ts +27 -7
  67. package/dist/json/index.d.ts.map +1 -1
  68. package/dist/json/index.js +1 -1
  69. package/dist/logger/index.d.ts +16 -1
  70. package/dist/logger/index.d.ts.map +1 -1
  71. package/dist/logger/index.js +1 -1
  72. package/dist/logging/index.d.ts +19 -0
  73. package/dist/logging/index.d.ts.map +1 -1
  74. package/dist/maps/index.d.ts +21 -0
  75. package/dist/maps/index.d.ts.map +1 -1
  76. package/dist/mime-types/db.d.ts +5 -922
  77. package/dist/mime-types/db.d.ts.map +1 -1
  78. package/dist/mime-types/db.js +1 -1
  79. package/dist/mime-types/index.d.ts +20 -0
  80. package/dist/mime-types/index.d.ts.map +1 -1
  81. package/dist/mime-types/index.js +1 -1
  82. package/dist/node/index.d.ts +0 -9
  83. package/dist/node/index.d.ts.map +1 -1
  84. package/dist/node/index.js +1 -1
  85. package/dist/numbers/index.d.ts +28 -36
  86. package/dist/numbers/index.d.ts.map +1 -1
  87. package/dist/numbers/index.js +1 -1
  88. package/dist/objects/index.d.ts +23 -7
  89. package/dist/objects/index.d.ts.map +1 -1
  90. package/dist/objects/index.js +1 -1
  91. package/dist/objects/objects.test-d.js +1 -1
  92. package/dist/os/index.d.ts +18 -0
  93. package/dist/os/index.d.ts.map +1 -1
  94. package/dist/process/index.d.ts +18 -0
  95. package/dist/process/index.d.ts.map +1 -1
  96. package/dist/promises/index.d.ts +21 -26
  97. package/dist/promises/index.d.ts.map +1 -1
  98. package/dist/promises/index.js +1 -1
  99. package/dist/promises/promises.test-d.d.ts +2 -0
  100. package/dist/promises/promises.test-d.d.ts.map +1 -0
  101. package/dist/promises/promises.test-d.js +1 -0
  102. package/dist/random/index.d.ts +21 -0
  103. package/dist/random/index.d.ts.map +1 -1
  104. package/dist/regex/index.d.ts +23 -0
  105. package/dist/regex/index.d.ts.map +1 -1
  106. package/dist/security/index.d.ts +36 -4
  107. package/dist/security/index.d.ts.map +1 -1
  108. package/dist/security/index.js +1 -1
  109. package/dist/sleep/index.d.ts +20 -0
  110. package/dist/sleep/index.d.ts.map +1 -1
  111. package/dist/strings/index.d.ts +0 -75
  112. package/dist/strings/index.d.ts.map +1 -1
  113. package/dist/strings/index.js +1 -1
  114. package/dist/system/index.d.ts +18 -0
  115. package/dist/system/index.d.ts.map +1 -1
  116. package/dist/time/index.d.ts +23 -4
  117. package/dist/time/index.d.ts.map +1 -1
  118. package/dist/try/index.d.ts +52 -1
  119. package/dist/try/index.d.ts.map +1 -1
  120. package/dist/try/index.js +1 -1
  121. package/dist/try/trycatch.test-d.js +1 -1
  122. package/dist/types/index.d.ts +0 -1
  123. package/dist/url/index.d.ts +23 -0
  124. package/dist/url/index.d.ts.map +1 -1
  125. package/dist/url/index.js +1 -1
  126. package/dist/uuid/index.d.ts +5 -5
  127. package/dist/uuid/index.d.ts.map +1 -1
  128. package/dist/uuid/index.js +1 -1
  129. package/dist/validation/index.d.ts +25 -0
  130. package/dist/validation/index.d.ts.map +1 -1
  131. package/dist/validation/index.js +1 -1
  132. package/package.json +23 -37
  133. package/dist/chunks/chunk-5IA77ERW.js +0 -1
  134. package/dist/chunks/chunk-6J7HIWG6.js +0 -1
  135. package/dist/chunks/chunk-ARW46OJS.js +0 -1
  136. package/dist/chunks/chunk-W72HFHZY.js +0 -1
  137. package/dist/emails/banned/index.d.ts +0 -9
  138. package/dist/emails/banned/index.d.ts.map +0 -1
  139. package/dist/formatting/index.d.ts +0 -40
  140. package/dist/formatting/index.d.ts.map +0 -1
  141. package/dist/formatting/index.js +0 -1
  142. package/dist/interval/index.d.ts +0 -13
  143. package/dist/interval/index.d.ts.map +0 -1
  144. package/dist/interval/index.js +0 -1
  145. package/dist/logger/logger.d.ts +0 -7
  146. package/dist/logger/logger.d.ts.map +0 -1
  147. package/dist/logger/logger.js +0 -1
  148. package/dist/math/index.d.ts +0 -37
  149. package/dist/math/index.d.ts.map +0 -1
  150. package/dist/math/index.js +0 -1
  151. package/dist/sets/index.d.ts +0 -48
  152. package/dist/sets/index.d.ts.map +0 -1
  153. package/dist/sets/index.js +0 -1
  154. package/dist/try/attempt.d.ts +0 -8
  155. package/dist/try/attempt.d.ts.map +0 -1
  156. package/dist/try/attempt.js +0 -1
  157. package/dist/try/trycatch.d.ts +0 -29
  158. package/dist/try/trycatch.d.ts.map +0 -1
  159. package/dist/try/trycatch.js +0 -1
  160. /package/dist/chunks/{chunk-XAQ7VMV4.js → chunk-J4C2KNK5.js} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/mime-types/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0/Ib,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,aAAa,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAErD,KAAK,cAAc,GAAG,MAAM,CAC3B,QAAQ,EACR;IACC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,aAAa,EAAE,CAAA;IAC3B,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;CAC5B,CACD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAmC,cAAc,CAAA;AAEvE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAA"}
1
+ {"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/mime-types/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAymHb,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,aAAa,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAErD,KAAK,cAAc,GAAG,MAAM,CAC3B,QAAQ,EACR;IACC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,aAAa,EAAE,CAAA;CAC3B,CACD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAmC,cAAc,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAA"}
@@ -1 +1 @@
1
- import{a}from"../chunks/chunk-W72HFHZY.js";import"../chunks/chunk-ANN5UYCF.js";export{a as mimeTypes};
1
+ import{a}from"../chunks/chunk-H7PB4TAW.js";import"../chunks/chunk-ANN5UYCF.js";export{a as mimeTypes};
@@ -15,15 +15,35 @@ import type { FileExtension, MimeType } from './db.js';
15
15
  export * from './db.js';
16
16
  /**
17
17
  * Map from `MimeType` to its associated file extensions, populated from the database.
18
+ *
19
+ * @example
20
+ * ```typescript
21
+ * extensions['application/json'] // ['json', 'map']
22
+ * extensions['text/html'] // ['html', 'htm', 'shtml']
23
+ * ```
18
24
  */
19
25
  export declare const extensions: Record<MimeType, FileExtension[]>;
20
26
  /**
21
27
  * Map from `FileExtension` to its canonical `MimeType`, populated from the database.
28
+ *
29
+ * @example
30
+ * ```typescript
31
+ * types['json'] // 'application/json'
32
+ * types['png'] // 'image/png'
33
+ * ```
22
34
  */
23
35
  export declare const types: Record<FileExtension, MimeType>;
24
36
  /**
25
37
  * Lookup the MIME type for a file path/extension.
26
38
  *
39
+ * @example
40
+ * ```typescript
41
+ * lookup('json') // 'application/json'
42
+ * lookup('.png') // 'image/png'
43
+ * lookup('/path/to/report.pdf') // 'application/pdf'
44
+ * lookup('nope') // false
45
+ * ```
46
+ *
27
47
  * @param {string} path
28
48
  * @return {boolean|string}
29
49
  */
@@ -1 +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"}
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;;;;;;;;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"}
@@ -1,4 +1,4 @@
1
- import{a as t}from"../chunks/chunk-W72HFHZY.js";import"../chunks/chunk-ANN5UYCF.js";function m(n){let e=n.lastIndexOf(".");return e<0?"":n.substring(e)}var p={},a={};u(p,a);function d(n){if(!n||typeof n!="string")return!1;let e=m(`x.${n}`).toLowerCase().substring(1);return e&&a[e]||!1}function u(n,e){let r=["nginx","apache",void 0,"iana"];for(let i of Object.keys(t)){let c=t[i],s=c.extensions;if(s?.length){n[i]=s;for(let o of s){if(e[o]){let f=r.indexOf(t[e[o]].source),x=r.indexOf(c.source);if(e[o]!=="application/octet-stream"&&(f>x||f===x&&e[o].startsWith("application/")))continue}e[o]=i}}}}export{p as extensions,d as lookup,t as mimeTypes,a as types};
1
+ import{a as t}from"../chunks/chunk-H7PB4TAW.js";import"../chunks/chunk-ANN5UYCF.js";function m(n){let e=n.lastIndexOf(".");return e<0?"":n.substring(e)}var p={},a={};u(p,a);function d(n){if(!n||typeof n!="string")return!1;let e=m(`x.${n}`).toLowerCase().substring(1);return e&&a[e]||!1}function u(n,e){let r=["nginx","apache",void 0,"iana"];for(let i of Object.keys(t)){let c=t[i],s=c.extensions;if(s?.length){n[i]=s;for(let o of s){if(e[o]){let f=r.indexOf(t[e[o]].source),x=r.indexOf(c.source);if(e[o]!=="application/octet-stream"&&(f>x||f===x&&e[o].startsWith("application/")))continue}e[o]=i}}}}export{p as extensions,d as lookup,t as mimeTypes,a as types};
2
2
  /*!
3
3
  * mime-types
4
4
  * Copyright(c) 2014 Jonathan Ong
@@ -40,13 +40,4 @@ export declare const isNode: () => boolean;
40
40
  * const optionalModule = requireOptional('some-module');
41
41
  */
42
42
  export declare function requireOptional(moduleName: string): any | undefined;
43
- /**
44
- * Returns the process uptime in seconds.
45
- *
46
- * @returns The number of seconds the current Node.js process has been running.
47
- *
48
- * @example
49
- * const uptime = getProcessUptime();
50
- */
51
- export declare const getProcessUptime: () => number;
52
43
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
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"}
@@ -1 +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};
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}}export{o as getNodeMajorVersion,t as isNode,n as nodeVersionCheck,s as requireOptional};
@@ -1,12 +1,13 @@
1
- /**
2
- * Returns a random integer between min and max (inclusive).
3
- * @param min The minimum value (inclusive).
4
- * @param max The maximum value (inclusive).
5
- * @returns A random integer.
6
- */
7
- export declare function getRandomInt(min: number, max: number): number;
8
1
  /**
9
2
  * Clamps a number between a minimum and maximum value.
3
+ *
4
+ * @example
5
+ * ```typescript
6
+ * clamp(15, 0, 10) // 10
7
+ * clamp(-5, 0, 10) // 0
8
+ * clamp(5, 0, 10) // 5
9
+ * ```
10
+ *
10
11
  * @param value The number to clamp.
11
12
  * @param min The minimum value.
12
13
  * @param max The maximum value.
@@ -15,30 +16,33 @@ export declare function getRandomInt(min: number, max: number): number;
15
16
  export declare function clamp(value: number, min: number, max: number): number;
16
17
  /**
17
18
  * Rounds a number to a specified number of decimal places.
19
+ *
20
+ * @example
21
+ * ```typescript
22
+ * roundTo(3.14159) // 3.14
23
+ * roundTo(3.14159, 3) // 3.142
24
+ * roundTo(1234.5, 0) // 1235
25
+ * ```
26
+ *
18
27
  * @param value The number to round.
19
28
  * @param decimals The number of decimal places. Defaults to 2.
20
29
  * @returns The rounded number.
21
30
  */
22
31
  export declare function roundTo(value: number, decimals?: number): number;
23
32
  /**
24
- * Checks if a value is a finite number.
25
- * @param value The value to check.
26
- * @returns True if the value is a finite number, false otherwise.
27
- */
28
- export declare function isFiniteNumber(value: unknown): value is number;
29
- /**
30
- * Generates a random float between min (inclusive) and max (exclusive).
31
- * @param min The minimum value (inclusive).
32
- * @param max The maximum value (exclusive).
33
- * @returns A random float.
34
- */
35
- export declare function getRandomFloat(min: number, max: number): number;
36
- /**
37
- * Checks if a value is an integer.
38
- * @param value The value to check.
39
- * @returns True if the value is an integer, false otherwise.
33
+ * Formats a number as a percentage string.
34
+ *
35
+ * @example
36
+ * ```typescript
37
+ * formatPercent(0.25) // '25%'
38
+ * formatPercent(0.1234, 1) // '12.3%'
39
+ * ```
40
+ *
41
+ * @param value The value to format (e.g. 0.25 for 25%).
42
+ * @param fractionDigits Number of decimal places (default: 0).
43
+ * @returns The formatted percentage string.
40
44
  */
41
- export declare function isInteger(value: unknown): value is number;
45
+ export declare function formatPercent(value: number, fractionDigits?: number): string;
42
46
  /**
43
47
  * Checks if a number is between two values.
44
48
  * @param value The number to check.
@@ -67,16 +71,4 @@ export declare function average(numbers: number[]): number;
67
71
  * @returns The modulus result.
68
72
  */
69
73
  export declare function mod(n: number, m: number): number;
70
- /**
71
- * Returns the smallest value in an array of numbers.
72
- * @param numbers The array of numbers.
73
- * @returns The minimum value.
74
- */
75
- export declare function min(numbers: number[]): number;
76
- /**
77
- * Returns the largest value in an array of numbers.
78
- * @param numbers The array of numbers.
79
- * @returns The maximum value.
80
- */
81
- export declare function max(numbers: number[]): number;
82
74
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
1
+ {"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;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAEvE;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"}
@@ -1 +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};
1
+ import"../chunks/chunk-ANN5UYCF.js";function o(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 m(n,r=0){return`${(n*100).toFixed(r)}%`}function c(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 f(n){return n.length===0?0:u(n)/n.length}function i(n,r){return(n%r+r)%r}export{f as average,c as between,o as clamp,m as formatPercent,i as mod,b as roundTo,u as sum};
@@ -1,11 +1,27 @@
1
1
  /**
2
2
  * Returns true if the value is a plain object (not null, not array, not function).
3
+ *
4
+ * @example
5
+ * ```typescript
6
+ * isPlainObject({ a: 1 }) // true
7
+ * isPlainObject([1, 2]) // false
8
+ * isPlainObject(null) // false
9
+ * isPlainObject(new Date()) // false
10
+ * ```
11
+ *
3
12
  * @param value The value to check.
4
13
  * @returns {boolean}
5
14
  */
6
15
  export declare function isPlainObject(value: any): value is Record<string, any>;
7
16
  /**
8
17
  * Deeply merges two objects. Does not mutate inputs.
18
+ *
19
+ * @example
20
+ * ```typescript
21
+ * deepMerge({ a: 1, nested: { x: 1, y: 2 } }, { nested: { y: 9 }, b: 2 })
22
+ * // { a: 1, nested: { x: 1, y: 9 }, b: 2 }
23
+ * ```
24
+ *
9
25
  * @param target The target object.
10
26
  * @param source The source object.
11
27
  * @returns {object} The merged object.
@@ -13,6 +29,13 @@ export declare function isPlainObject(value: any): value is Record<string, any>;
13
29
  export declare function deepMerge<T extends object, U extends object>(target: T, source: U): T & U;
14
30
  /**
15
31
  * Returns a shallow copy of an object with the given keys omitted.
32
+ *
33
+ * @example
34
+ * ```typescript
35
+ * omit({ id: 1, name: 'Ada', password: 'x' }, ['password'])
36
+ * // { id: 1, name: 'Ada' }
37
+ * ```
38
+ *
16
39
  * @param obj The source object.
17
40
  * @param keys Keys to omit.
18
41
  * @returns {object}
@@ -25,11 +48,4 @@ export declare function omit<T extends object, K extends keyof T>(obj: T, keys:
25
48
  * @returns {object}
26
49
  */
27
50
  export declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
28
- /**
29
- * Deep clones a value using the native structuredClone algorithm.
30
- * Correctly handles Date, Map, Set, ArrayBuffer, and circular references.
31
- * @param obj The value to clone.
32
- * @returns A deep clone of the value.
33
- */
34
- export declare function deepClone<T>(obj: T): T;
35
51
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
1
+ {"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"}
@@ -1 +1 @@
1
- import{a,b,c,d,e}from"../chunks/chunk-ARW46OJS.js";import"../chunks/chunk-ANN5UYCF.js";export{e as deepClone,b as deepMerge,a as isPlainObject,c as omit,d as pick};
1
+ import{a,b,c,d}from"../chunks/chunk-HUTZTT4Y.js";import"../chunks/chunk-ANN5UYCF.js";export{b as deepMerge,a as isPlainObject,c as omit,d as pick};
@@ -1 +1 @@
1
- import{b as n,c,d as p,e as a}from"../chunks/chunk-ARW46OJS.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as i,expectTypeOf as t,it as o}from"vitest";i("objects \u2014 types",()=>{o("pick narrows to the selected keys",()=>{let e=p({a:1,b:"two",c:!0},["a","c"]);t(e).toEqualTypeOf(),e.b}),o("omit drops the listed keys",()=>{let e=c({a:1,b:"two",c:!0},["b"]);t(e).toEqualTypeOf(),e.b}),o("deepMerge yields the intersection type",()=>{let b=n({x:1},{y:"two"});t(b).toEqualTypeOf()}),o("deepClone is identity over the input type",()=>{t(a({nested:{id:1}})).toEqualTypeOf()})});
1
+ import{b as s,c as b,d as r}from"../chunks/chunk-HUTZTT4Y.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as p,expectTypeOf as t,it as o}from"vitest";p("objects \u2014 types",()=>{o("pick narrows to the selected keys",()=>{let e=r({a:1,b:"two",c:!0},["a","c"]);t(e).toEqualTypeOf(),e.b}),o("omit drops the listed keys",()=>{let e=b({a:1,b:"two",c:!0},["b"]);t(e).toEqualTypeOf(),e.b}),o("deepMerge yields the intersection type",()=>{let n=s({x:1},{y:"two"});t(n).toEqualTypeOf()})});
@@ -1,15 +1,33 @@
1
1
  /**
2
2
  * Returns the current operating system platform (Node.js only).
3
+ *
4
+ * @example
5
+ * ```typescript
6
+ * getOsPlatform() // 'darwin' on macOS, 'win32' on Windows, undefined in a browser
7
+ * ```
8
+ *
3
9
  * @returns {string | undefined} The platform (e.g., 'darwin', 'win32', 'linux').
4
10
  */
5
11
  export declare function getOsPlatform(): string | undefined;
6
12
  /**
7
13
  * Returns the OS release/version (Node.js only).
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * getOsRelease() // 'node'
18
+ * ```
19
+ *
8
20
  * @returns {string | undefined}
9
21
  */
10
22
  export declare function getOsRelease(): string | undefined;
11
23
  /**
12
24
  * Returns the OS architecture (Node.js only).
25
+ *
26
+ * @example
27
+ * ```typescript
28
+ * getOsArch() // 'arm64' on Apple silicon, 'x64' on Intel
29
+ * ```
30
+ *
13
31
  * @returns {string | undefined}
14
32
  */
15
33
  export declare function getOsArch(): string | undefined;
@@ -1 +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"}
1
+ {"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"}
@@ -1,15 +1,33 @@
1
1
  /**
2
2
  * Returns the current process ID (Node.js only).
3
+ *
4
+ * @example
5
+ * ```typescript
6
+ * getProcessId() // 48213 (undefined in a browser)
7
+ * ```
8
+ *
3
9
  * @returns {number | undefined}
4
10
  */
5
11
  export declare function getProcessId(): number | undefined;
6
12
  /**
7
13
  * Returns the current process uptime in seconds (Node.js only).
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * getProcessUptime() // 12.482
18
+ * ```
19
+ *
8
20
  * @returns {number | undefined}
9
21
  */
10
22
  export declare function getProcessUptime(): number | undefined;
11
23
  /**
12
24
  * Returns the current working directory (Node.js only).
25
+ *
26
+ * @example
27
+ * ```typescript
28
+ * getCwd() // '/Users/ada/projects/app'
29
+ * ```
30
+ *
13
31
  * @returns {string | undefined}
14
32
  */
15
33
  export declare function getCwd(): string | undefined;
@@ -1 +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"}
1
+ {"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"}
@@ -1,39 +1,34 @@
1
- /**
2
- * Returns a promise that resolves after a given delay (ms).
3
- * @param ms Milliseconds to wait.
4
- * @returns {Promise<void>}
5
- */
6
- export declare function delay(ms: number): Promise<void>;
7
1
  /**
8
2
  * Wraps a promise and returns a tuple [error, result].
3
+ * The error slot is `unknown` — narrow it at the call site before touching its properties.
4
+ *
5
+ * @example
6
+ * ```typescript
7
+ * const [err, value] = await to(Promise.resolve(42))
8
+ * // err = null, value = 42
9
+ *
10
+ * const [err2, value2] = await to(Promise.reject(new Error('boom')))
11
+ * const message = err2 instanceof Error ? err2.message : String(err2)
12
+ * // message = 'boom', value2 = undefined
13
+ * ```
14
+ *
9
15
  * @param promise The promise to wrap.
10
- * @returns {Promise<[any, T | undefined]>}
16
+ * @returns {Promise<[unknown, T | undefined]>}
11
17
  */
12
- export declare function to<T>(promise: Promise<T>): Promise<[any, T | undefined]>;
18
+ export declare function to<T>(promise: Promise<T>): Promise<[unknown, T | undefined]>;
13
19
  /**
14
20
  * Returns a promise that rejects after a timeout if the input promise does not resolve.
21
+ *
22
+ * @example
23
+ * ```typescript
24
+ * await withTimeout(delay(10).then(() => 'fast'), 100) // 'fast'
25
+ * await withTimeout(delay(500), 100) // rejects with Error('Timeout')
26
+ * ```
27
+ *
15
28
  * @param promise The promise to race.
16
29
  * @param ms Timeout in milliseconds.
17
30
  * @param error Optional error to throw on timeout.
18
31
  * @returns {Promise<T>}
19
32
  */
20
33
  export declare function withTimeout<T>(promise: Promise<T>, ms: number, error?: any): Promise<T>;
21
- /**
22
- * Returns a promise that resolves when all promises resolve, or rejects on the first rejection (like Promise.all).
23
- * @param promises Array of promises.
24
- * @returns {Promise<T[]>}
25
- */
26
- export declare function all<T>(promises: Promise<T>[]): Promise<T[]>;
27
- /**
28
- * Returns a promise that resolves when all promises settle (like Promise.allSettled).
29
- * @param promises Array of promises.
30
- * @returns {Promise<PromiseSettledResult<T>[]>}
31
- */
32
- export declare function allSettled<T>(promises: Promise<T>[]): Promise<PromiseSettledResult<T>[]>;
33
- /**
34
- * Returns a promise that resolves or rejects as soon as one of the promises resolves or rejects (like Promise.race).
35
- * @param promises Array of promises.
36
- * @returns {Promise<T>}
37
- */
38
- export declare function race<T>(promises: Promise<T>[]): Promise<T>;
39
34
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/promises/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;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"}
@@ -1 +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};
1
+ import{a,b}from"../chunks/chunk-AVPQVYSA.js";import"../chunks/chunk-ANN5UYCF.js";export{a as to,b as withTimeout};
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=promises.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promises.test-d.d.ts","sourceRoot":"","sources":["../../src/promises/promises.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1 @@
1
+ import{a as o,b as e}from"../chunks/chunk-AVPQVYSA.js";import"../chunks/chunk-ANN5UYCF.js";import{describe as t,expectTypeOf as r,it as i}from"vitest";t("promises \u2014 types",()=>{i("withTimeout preserves the awaited type",()=>{r(e(Promise.resolve(42),10)).toEqualTypeOf(),r(e(Promise.resolve({id:1}),10)).toEqualTypeOf()}),i("to returns an [error, value] tuple with the value widened to undefined",()=>{r(o(Promise.resolve("x"))).toEqualTypeOf()})});
@@ -1,5 +1,12 @@
1
1
  /**
2
2
  * Returns a random integer between min (inclusive) and max (inclusive).
3
+ *
4
+ * @example
5
+ * ```typescript
6
+ * randomInt(1, 6) // 3 (any integer from 1 to 6)
7
+ * randomInt(5, 5) // 5
8
+ * ```
9
+ *
3
10
  * @param min Minimum integer value.
4
11
  * @param max Maximum integer value.
5
12
  * @returns {number} Random integer between min and max.
@@ -7,6 +14,13 @@
7
14
  export declare function randomInt(min: number, max: number): number;
8
15
  /**
9
16
  * Returns a random float between min (inclusive) and max (exclusive).
17
+ *
18
+ * @example
19
+ * ```typescript
20
+ * randomFloat(0, 1) // 0.7342119...
21
+ * randomFloat(10, 20) // 14.028...
22
+ * ```
23
+ *
10
24
  * @param min Minimum float value.
11
25
  * @param max Maximum float value.
12
26
  * @returns {number} Random float between min and max.
@@ -14,6 +28,13 @@ export declare function randomInt(min: number, max: number): number;
14
28
  export declare function randomFloat(min: number, max: number): number;
15
29
  /**
16
30
  * Returns a random boolean value.
31
+ *
32
+ * @example
33
+ * ```typescript
34
+ * randomBool() // true
35
+ * randomBool() // false
36
+ * ```
37
+ *
17
38
  * @returns {boolean}
18
39
  */
19
40
  export declare function randomBool(): boolean;
@@ -1 +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"}
1
+ {"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"}
@@ -1,11 +1,27 @@
1
1
  /**
2
2
  * Escapes special regex characters in a string so it can be used in a RegExp.
3
+ *
4
+ * @example
5
+ * ```typescript
6
+ * escapeRegExp('1 + 1 = 2?') // '1 \\+ 1 = 2\\?'
7
+ * new RegExp(escapeRegExp('a.b')).test('a.b') // true
8
+ * new RegExp(escapeRegExp('a.b')).test('axb') // false
9
+ * ```
10
+ *
3
11
  * @param str The string to escape.
4
12
  * @returns The escaped string.
5
13
  */
6
14
  export declare function escapeRegExp(str: string): string;
7
15
  /**
8
16
  * Tests if a string matches a given regex pattern.
17
+ *
18
+ * @example
19
+ * ```typescript
20
+ * testRegex('hello world', /world/) // true
21
+ * testRegex('hello world', '^hello') // true
22
+ * testRegex('hello', /bye/) // false
23
+ * ```
24
+ *
9
25
  * @param str The string to test.
10
26
  * @param pattern The regex pattern (string or RegExp).
11
27
  * @returns True if the string matches, false otherwise.
@@ -13,6 +29,13 @@ export declare function escapeRegExp(str: string): string;
13
29
  export declare function testRegex(str: string, pattern: string | RegExp): boolean;
14
30
  /**
15
31
  * Returns all matches of a regex pattern in a string.
32
+ *
33
+ * @example
34
+ * ```typescript
35
+ * matchAll('a1 b2 c3', /[a-z](\d)/).map((m) => m[1]) // ['1', '2', '3']
36
+ * matchAll('nothing here', /\d/) // []
37
+ * ```
38
+ *
16
39
  * @param str The string to search.
17
40
  * @param pattern The regex pattern (string or RegExp).
18
41
  * @returns An array of matches, or an empty array if none found.
@@ -1 +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"}
1
+ {"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"}
@@ -1,17 +1,49 @@
1
1
  /**
2
- * Sanitizes a string by removing script tags and event handlers.
3
- * @param str The string to sanitize.
4
- * @returns The sanitized string.
2
+ * Removes `<script>` blocks and inline `on*=` event-handler attributes from a string.
3
+ *
4
+ * **Not a sanitizer, and deliberately not named like one.** It is a blocklist over
5
+ * two shapes, so anything it does not name survives, and a single pass can be
6
+ * defeated by nesting the pattern inside itself. Use it as defence in depth on
7
+ * markup you already trust. For untrusted input, escape with `html.escapeHtml`,
8
+ * or run a real sanitizer such as DOMPurify when the markup must survive.
9
+ *
10
+ * @example
11
+ * ```typescript
12
+ * stripScriptish('<p onclick="steal()">hi</p><script>bad()</script>')
13
+ * // '<p>hi</p>'
14
+ *
15
+ * // Bypassable by construction — this is XSS it does not name, so it survives:
16
+ * stripScriptish('<a href="javascript:alert(1)">x</a>')
17
+ * // '<a href="javascript:alert(1)">x</a>'
18
+ * ```
19
+ *
20
+ * @param str The string to strip.
21
+ * @returns The string with script blocks and inline handlers removed.
5
22
  */
6
- export declare function sanitizeString(str: string): string;
23
+ export declare function stripScriptish(str: string): string;
7
24
  /**
8
25
  * Checks if a password is strong (min 8 chars, upper, lower, number, special char).
26
+ *
27
+ * @example
28
+ * ```typescript
29
+ * isStrongPassword('Str0ng!pass') // true
30
+ * isStrongPassword('password') // false
31
+ * isStrongPassword('Sh0rt!') // false (under 8 characters)
32
+ * ```
33
+ *
9
34
  * @param password The password to check.
10
35
  * @returns True if the password is strong, false otherwise.
11
36
  */
12
37
  export declare function isStrongPassword(password: string): boolean;
13
38
  /**
14
39
  * Generates a cryptographically secure random token (hex string).
40
+ *
41
+ * @example
42
+ * ```typescript
43
+ * generateSecureToken() // 64 hex chars (32 bytes)
44
+ * generateSecureToken(8) // 'c1f0a4e29b73d518'
45
+ * ```
46
+ *
15
47
  * @param length The number of bytes (not hex chars).
16
48
  * @returns A random hex string.
17
49
  */
@@ -1 +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"}
1
+ {"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"}
@@ -1 +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};
1
+ 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};