es-toolkit 1.17.0 → 1.18.0-dev.573

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 (221) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +1 -1
  3. package/dist/_chunk/{index-CoqN5B.js → index-BGZDR9.js} +4 -1
  4. package/dist/_chunk/{isTypedArray-BBEkFl.js → isTypedArray-Dsrnb1.js} +1 -11
  5. package/dist/_chunk/{isFunction-aCEz9d.js → isWeakSet-BerD1A.js} +12 -2
  6. package/dist/_chunk/rest-CXt9w3.js +182 -0
  7. package/dist/_chunk/{toMerged-BGwYW5.js → toMerged-DN1PPP.js} +1 -1
  8. package/dist/_chunk/{initial-Ci2bn_.js → zipWith-CYaH1Y.js} +46 -70
  9. package/dist/array/countBy.d.mts +10 -0
  10. package/dist/array/countBy.d.ts +10 -0
  11. package/dist/array/fill.d.mts +55 -2
  12. package/dist/array/fill.d.ts +55 -2
  13. package/dist/array/flatMapDeep.d.mts +18 -0
  14. package/dist/array/flatMapDeep.d.ts +18 -0
  15. package/dist/array/flatMapDeep.mjs +7 -0
  16. package/dist/array/flattenDeep.d.mts +1 -1
  17. package/dist/array/flattenDeep.d.ts +1 -1
  18. package/dist/array/head.d.mts +14 -3
  19. package/dist/array/head.d.ts +14 -3
  20. package/dist/array/index.d.mts +9 -8
  21. package/dist/array/index.d.ts +9 -8
  22. package/dist/array/index.js +87 -58
  23. package/dist/array/index.mjs +9 -8
  24. package/dist/array/last.d.mts +23 -1
  25. package/dist/array/last.d.ts +23 -1
  26. package/dist/array/maxBy.d.mts +13 -1
  27. package/dist/array/maxBy.d.ts +13 -1
  28. package/dist/array/minBy.d.mts +13 -1
  29. package/dist/array/minBy.d.ts +13 -1
  30. package/dist/array/toFilled.d.mts +59 -2
  31. package/dist/array/toFilled.d.ts +59 -2
  32. package/dist/array/zip.d.mts +65 -7
  33. package/dist/array/zip.d.ts +65 -7
  34. package/dist/array/zipObject.d.mts +2 -4
  35. package/dist/array/zipObject.d.ts +2 -4
  36. package/dist/array/zipWith.d.mts +39 -6
  37. package/dist/array/zipWith.d.ts +39 -6
  38. package/dist/browser.global.js +1 -1
  39. package/dist/browser.global.js.map +1 -1
  40. package/dist/compat/_internal/compareValues.mjs +30 -5
  41. package/dist/compat/_internal/normalizeForCase.mjs +9 -0
  42. package/dist/compat/array/castArray.d.mts +29 -0
  43. package/dist/compat/array/castArray.d.ts +29 -0
  44. package/dist/compat/array/castArray.mjs +8 -0
  45. package/dist/compat/array/difference.d.mts +19 -0
  46. package/dist/compat/array/difference.d.ts +19 -0
  47. package/dist/compat/array/fill.d.mts +55 -2
  48. package/dist/compat/array/fill.d.ts +55 -2
  49. package/dist/compat/array/findLastIndex.d.mts +66 -0
  50. package/dist/compat/array/findLastIndex.d.ts +66 -0
  51. package/dist/compat/array/findLastIndex.mjs +33 -0
  52. package/dist/compat/array/join.d.mts +16 -0
  53. package/dist/compat/array/join.d.ts +16 -0
  54. package/dist/compat/array/join.mjs +5 -0
  55. package/dist/compat/array/orderBy.d.mts +6 -6
  56. package/dist/compat/array/orderBy.d.ts +6 -6
  57. package/dist/compat/array/orderBy.mjs +26 -18
  58. package/dist/compat/array/some.d.mts +86 -0
  59. package/dist/compat/array/some.d.ts +86 -0
  60. package/dist/compat/array/some.mjs +36 -0
  61. package/dist/compat/array/sortBy.d.mts +34 -0
  62. package/dist/compat/array/sortBy.d.ts +34 -0
  63. package/dist/compat/array/sortBy.mjs +7 -0
  64. package/dist/compat/function/ary.d.mts +11 -1
  65. package/dist/compat/function/ary.d.ts +11 -1
  66. package/dist/compat/function/attempt.d.mts +33 -0
  67. package/dist/compat/function/attempt.d.ts +33 -0
  68. package/dist/compat/function/attempt.mjs +10 -0
  69. package/dist/compat/function/bindKey.d.mts +45 -0
  70. package/dist/compat/function/bindKey.d.ts +45 -0
  71. package/dist/compat/function/bindKey.mjs +27 -0
  72. package/dist/compat/function/rearg.d.mts +18 -0
  73. package/dist/compat/function/rearg.d.ts +18 -0
  74. package/dist/compat/function/rearg.mjs +14 -0
  75. package/dist/compat/function/spread.d.mts +47 -0
  76. package/dist/compat/function/spread.d.ts +47 -0
  77. package/dist/compat/function/spread.mjs +16 -0
  78. package/dist/compat/index.d.mts +31 -10
  79. package/dist/compat/index.d.ts +31 -10
  80. package/dist/compat/index.js +401 -143
  81. package/dist/compat/index.mjs +32 -11
  82. package/dist/compat/math/max.d.mts +16 -5
  83. package/dist/compat/math/max.d.ts +16 -5
  84. package/dist/compat/math/min.d.mts +16 -4
  85. package/dist/compat/math/min.d.ts +16 -4
  86. package/dist/compat/math/parseInt.d.mts +20 -0
  87. package/dist/compat/math/parseInt.d.ts +20 -0
  88. package/dist/compat/math/parseInt.mjs +8 -0
  89. package/dist/compat/object/fromPairs.d.mts +29 -0
  90. package/dist/compat/object/fromPairs.d.ts +29 -0
  91. package/dist/compat/object/fromPairs.mjs +14 -0
  92. package/dist/compat/predicate/conforms.d.mts +22 -0
  93. package/dist/compat/predicate/conforms.d.ts +22 -0
  94. package/dist/compat/predicate/conforms.mjs +11 -0
  95. package/dist/compat/predicate/conformsTo.d.mts +29 -0
  96. package/dist/compat/predicate/conformsTo.d.ts +29 -0
  97. package/dist/compat/predicate/conformsTo.mjs +18 -0
  98. package/dist/compat/predicate/isObject.d.mts +26 -0
  99. package/dist/compat/predicate/isObject.d.ts +26 -0
  100. package/dist/compat/predicate/isObject.mjs +5 -0
  101. package/dist/compat/predicate/isRegExp.d.mts +7 -0
  102. package/dist/compat/predicate/isRegExp.d.ts +7 -0
  103. package/dist/compat/predicate/isTypedArray.d.mts +10 -0
  104. package/dist/compat/predicate/isTypedArray.d.ts +10 -0
  105. package/dist/compat/predicate/isWeakMap.d.mts +23 -0
  106. package/dist/compat/predicate/isWeakMap.d.ts +23 -0
  107. package/dist/compat/predicate/isWeakMap.mjs +7 -0
  108. package/dist/compat/predicate/isWeakSet.d.mts +23 -0
  109. package/dist/compat/predicate/isWeakSet.d.ts +23 -0
  110. package/dist/compat/predicate/isWeakSet.mjs +7 -0
  111. package/dist/compat/string/camelCase.d.mts +18 -0
  112. package/dist/compat/string/camelCase.d.ts +18 -0
  113. package/dist/compat/string/camelCase.mjs +8 -0
  114. package/dist/compat/string/endsWith.d.mts +1 -1
  115. package/dist/compat/string/endsWith.d.ts +1 -1
  116. package/dist/compat/string/endsWith.mjs +2 -2
  117. package/dist/compat/string/repeat.d.mts +17 -0
  118. package/dist/compat/string/repeat.d.ts +17 -0
  119. package/dist/compat/string/repeat.mjs +5 -0
  120. package/dist/compat/string/startsWith.d.mts +1 -1
  121. package/dist/compat/string/startsWith.d.ts +1 -1
  122. package/dist/compat/string/startsWith.mjs +2 -2
  123. package/dist/function/after.d.mts +1 -1
  124. package/dist/function/after.d.ts +1 -1
  125. package/dist/function/after.mjs +2 -2
  126. package/dist/function/before.d.mts +1 -1
  127. package/dist/function/before.d.ts +1 -1
  128. package/dist/function/before.mjs +2 -2
  129. package/dist/function/debounce.d.mts +3 -3
  130. package/dist/function/debounce.d.ts +3 -3
  131. package/dist/function/index.d.mts +1 -0
  132. package/dist/function/index.d.ts +1 -0
  133. package/dist/function/index.js +22 -180
  134. package/dist/function/index.mjs +1 -0
  135. package/dist/function/memoize.d.mts +37 -1
  136. package/dist/function/memoize.d.ts +37 -1
  137. package/dist/function/negate.d.mts +7 -1
  138. package/dist/function/negate.d.ts +7 -1
  139. package/dist/function/spread.d.mts +19 -0
  140. package/dist/function/spread.d.ts +19 -0
  141. package/dist/function/spread.mjs +7 -0
  142. package/dist/function/unary.d.mts +7 -0
  143. package/dist/function/unary.d.ts +7 -0
  144. package/dist/index.d.mts +16 -8
  145. package/dist/index.d.ts +16 -8
  146. package/dist/index.js +89 -80
  147. package/dist/index.mjs +16 -8
  148. package/dist/math/clamp.d.mts +14 -3
  149. package/dist/math/clamp.d.ts +14 -3
  150. package/dist/math/random.d.mts +13 -2
  151. package/dist/math/random.d.ts +13 -2
  152. package/dist/math/randomInt.d.mts +11 -3
  153. package/dist/math/randomInt.d.ts +11 -3
  154. package/dist/math/range.d.mts +25 -0
  155. package/dist/math/range.d.ts +25 -0
  156. package/dist/object/index.js +1 -1
  157. package/dist/object/invert.d.mts +2 -4
  158. package/dist/object/invert.d.ts +2 -4
  159. package/dist/predicate/index.d.mts +2 -0
  160. package/dist/predicate/index.d.ts +2 -0
  161. package/dist/predicate/index.js +11 -9
  162. package/dist/predicate/index.mjs +2 -0
  163. package/dist/predicate/isNotNil.mjs +1 -1
  164. package/dist/predicate/isPrimitive.d.mts +14 -0
  165. package/dist/predicate/isPrimitive.d.ts +14 -0
  166. package/dist/predicate/isRegExp.d.mts +8 -1
  167. package/dist/predicate/isRegExp.d.ts +8 -1
  168. package/dist/predicate/isSymbol.d.mts +15 -0
  169. package/dist/predicate/isSymbol.d.ts +15 -0
  170. package/dist/predicate/isTypedArray.d.mts +10 -0
  171. package/dist/predicate/isTypedArray.d.ts +10 -0
  172. package/dist/predicate/isTypedArray.mjs +1 -11
  173. package/dist/predicate/isWeakMap.d.mts +23 -0
  174. package/dist/predicate/isWeakMap.d.ts +23 -0
  175. package/dist/predicate/isWeakMap.mjs +5 -0
  176. package/dist/predicate/isWeakSet.d.mts +23 -0
  177. package/dist/predicate/isWeakSet.d.ts +23 -0
  178. package/dist/predicate/isWeakSet.mjs +5 -0
  179. package/dist/promise/delay.mjs +4 -1
  180. package/dist/promise/index.js +1 -1
  181. package/dist/promise/timeout.d.mts +7 -0
  182. package/dist/promise/timeout.d.ts +7 -0
  183. package/dist/string/capitalize.d.mts +1 -1
  184. package/dist/string/capitalize.d.ts +1 -1
  185. package/dist/string/capitalize.mjs +2 -2
  186. package/dist/string/deburr.mjs +5 -5
  187. package/dist/string/escape.d.mts +16 -0
  188. package/dist/string/escape.d.ts +16 -0
  189. package/dist/string/escape.mjs +12 -0
  190. package/dist/string/escapeRegExp.d.mts +14 -0
  191. package/dist/string/escapeRegExp.d.ts +14 -0
  192. package/dist/string/escapeRegExp.mjs +5 -0
  193. package/dist/string/index.d.mts +4 -0
  194. package/dist/string/index.d.ts +4 -0
  195. package/dist/string/index.js +53 -19
  196. package/dist/string/index.mjs +4 -0
  197. package/dist/string/kebabCase.d.mts +1 -1
  198. package/dist/string/kebabCase.d.ts +1 -1
  199. package/dist/string/kebabCase.mjs +2 -2
  200. package/dist/string/lowerCase.d.mts +1 -1
  201. package/dist/string/lowerCase.d.ts +1 -1
  202. package/dist/string/lowerCase.mjs +2 -2
  203. package/dist/string/lowerFirst.d.mts +1 -1
  204. package/dist/string/lowerFirst.d.ts +1 -1
  205. package/dist/string/lowerFirst.mjs +2 -2
  206. package/dist/string/pad.d.mts +19 -0
  207. package/dist/string/pad.d.ts +19 -0
  208. package/dist/string/pad.mjs +5 -0
  209. package/dist/string/pascalCase.d.mts +1 -1
  210. package/dist/string/pascalCase.d.ts +1 -1
  211. package/dist/string/pascalCase.mjs +2 -2
  212. package/dist/string/snakeCase.d.mts +1 -1
  213. package/dist/string/snakeCase.d.ts +1 -1
  214. package/dist/string/snakeCase.mjs +2 -2
  215. package/dist/string/unescape.d.mts +16 -0
  216. package/dist/string/unescape.d.ts +16 -0
  217. package/dist/string/unescape.mjs +12 -0
  218. package/dist/string/upperFirst.d.mts +1 -1
  219. package/dist/string/upperFirst.d.ts +1 -1
  220. package/dist/string/upperFirst.mjs +2 -2
  221. package/package.json +7 -2
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Converts the HTML entities `&`, `<`, `>`, `"`, and `'` in `str` to their corresponding characters.
3
+ * It is the inverse of `escape`.
4
+ *
5
+ * @param {string} str The string to unescape.
6
+ * @returns {string} Returns the unescaped string.
7
+ *
8
+ * @example
9
+ * unescape('This is a &lt;div&gt; element.'); // returns 'This is a <div> element.'
10
+ * unescape('This is a &quot;quote&quot;'); // returns 'This is a "quote"'
11
+ * unescape('This is a &#39;quote&#39;'); // returns 'This is a 'quote''
12
+ * unescape('This is a &amp; symbol'); // returns 'This is a & symbol'
13
+ */
14
+ declare function unescape(str: string): string;
15
+
16
+ export { unescape };
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Converts the HTML entities `&amp;`, `&lt;`, `&gt;`, `&quot;`, and `&#39;` in `str` to their corresponding characters.
3
+ * It is the inverse of `escape`.
4
+ *
5
+ * @param {string} str The string to unescape.
6
+ * @returns {string} Returns the unescaped string.
7
+ *
8
+ * @example
9
+ * unescape('This is a &lt;div&gt; element.'); // returns 'This is a <div> element.'
10
+ * unescape('This is a &quot;quote&quot;'); // returns 'This is a "quote"'
11
+ * unescape('This is a &#39;quote&#39;'); // returns 'This is a 'quote''
12
+ * unescape('This is a &amp; symbol'); // returns 'This is a & symbol'
13
+ */
14
+ declare function unescape(str: string): string;
15
+
16
+ export { unescape };
@@ -0,0 +1,12 @@
1
+ const htmlUnescapes = {
2
+ '&amp;': '&',
3
+ '&lt;': '<',
4
+ '&gt;': '>',
5
+ '&quot;': '"',
6
+ '&#39;': "'",
7
+ };
8
+ function unescape(str) {
9
+ return str.replace(/&(?:amp|lt|gt|quot|#(0+)?39);/g, match => htmlUnescapes[match] || "'");
10
+ }
11
+
12
+ export { unescape };
@@ -9,6 +9,6 @@
9
9
  * const convertedStr2 = upperCase('Fred') // returns 'Fred'
10
10
  * const convertedStr3 = upperCase('FRED') // returns 'FRED'
11
11
  */
12
- declare const upperFirst: (str: string) => string;
12
+ declare function upperFirst(str: string): string;
13
13
 
14
14
  export { upperFirst };
@@ -9,6 +9,6 @@
9
9
  * const convertedStr2 = upperCase('Fred') // returns 'Fred'
10
10
  * const convertedStr3 = upperCase('FRED') // returns 'FRED'
11
11
  */
12
- declare const upperFirst: (str: string) => string;
12
+ declare function upperFirst(str: string): string;
13
13
 
14
14
  export { upperFirst };
@@ -1,5 +1,5 @@
1
- const upperFirst = (str) => {
1
+ function upperFirst(str) {
2
2
  return str.substring(0, 1).toUpperCase() + str.substring(1);
3
- };
3
+ }
4
4
 
5
5
  export { upperFirst };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "es-toolkit",
3
3
  "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
4
- "version": "1.17.0",
4
+ "version": "1.18.0-dev.573+72589819",
5
5
  "homepage": "https://es-toolkit.slash.page",
6
6
  "bugs": "https://github.com/toss/es-toolkit/issues",
7
7
  "repository": {
@@ -220,6 +220,7 @@
220
220
  "@rollup/plugin-typescript": "^11.1.6",
221
221
  "@types/broken-link-checker": "^0",
222
222
  "@types/eslint": "^9",
223
+ "@types/jscodeshift": "^0.11.11",
223
224
  "@types/node": "^20.12.11",
224
225
  "@types/tar": "^6.1.13",
225
226
  "@vitest/coverage-istanbul": "^1.5.2",
@@ -227,13 +228,16 @@
227
228
  "eslint": "^9.9.0",
228
229
  "eslint-config-prettier": "^9.1.0",
229
230
  "eslint-plugin-jsdoc": "^50.2.2",
231
+ "eslint-plugin-vue": "^9.28.0",
230
232
  "execa": "^9.3.0",
231
233
  "globals": "^15.9.0",
234
+ "jscodeshift": "^17.0.0",
232
235
  "prettier": "^3.2.5",
233
236
  "rollup": "^4.19.0",
234
237
  "rollup-plugin-dts": "^6.1.1",
235
238
  "tar": "^6",
236
239
  "tslib": "^2.6.3",
240
+ "tsx": "^4.19.0",
237
241
  "typescript": "^5.4.5",
238
242
  "typescript-eslint": "^8.1.0",
239
243
  "vitest": "^1.5.2"
@@ -245,7 +249,8 @@
245
249
  "test": "vitest run --coverage --typecheck",
246
250
  "bench": "vitest bench",
247
251
  "lint": "eslint --config eslint.config.mjs",
248
- "format": "prettier --write ."
252
+ "format": "prettier --write .",
253
+ "transform": "jscodeshift -t ./.scripts/tests/transform-lodash-test.ts $0 && prettier --write $0"
249
254
  },
250
255
  "main": "./dist/index.js",
251
256
  "browser": "./dist/browser.global.js",