@develia/commons 0.4.23 → 0.4.25

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 (354) hide show
  1. package/dist/array.d.ts.map +1 -0
  2. package/dist/array.js.map +1 -0
  3. package/dist/async-pool-executor.d.ts.map +1 -0
  4. package/dist/async-pool-executor.js.map +1 -0
  5. package/dist/browser/form-utilities.d.ts.map +1 -0
  6. package/dist/browser/form-utilities.js.map +1 -0
  7. package/dist/browser/geo-location.d.ts.map +1 -0
  8. package/dist/browser/geo-location.js.map +1 -0
  9. package/dist/browser/index.d.ts.map +1 -0
  10. package/dist/browser/index.js.map +1 -0
  11. package/dist/browser/native-bridge.d.ts.map +1 -0
  12. package/dist/browser/native-bridge.js.map +1 -0
  13. package/dist/cancellable-promise.d.ts.map +1 -0
  14. package/dist/cancellable-promise.js.map +1 -0
  15. package/dist/clean-url-search-params.d.ts.map +1 -0
  16. package/dist/clean-url-search-params.js.map +1 -0
  17. package/dist/collections/cache-dictionary.d.ts.map +1 -0
  18. package/dist/collections/cache-dictionary.js.map +1 -0
  19. package/dist/collections/default-map.d.ts.map +1 -0
  20. package/dist/collections/default-map.js.map +1 -0
  21. package/dist/collections/default-weak-map.d.ts.map +1 -0
  22. package/dist/collections/default-weak-map.js.map +1 -0
  23. package/dist/collections/from.d.ts.map +1 -0
  24. package/dist/collections/from.js.map +1 -0
  25. package/dist/collections/index.d.ts.map +1 -0
  26. package/dist/collections/index.js.map +1 -0
  27. package/dist/debouncer.d.ts +60 -0
  28. package/dist/debouncer.d.ts.map +1 -0
  29. package/dist/debouncer.js +118 -0
  30. package/dist/debouncer.js.map +1 -0
  31. package/dist/draft.d.ts.map +1 -0
  32. package/dist/draft.js.map +1 -0
  33. package/dist/event-bus.d.ts.map +1 -0
  34. package/dist/event-bus.js.map +1 -0
  35. package/dist/{types/functions.d.ts → functions.d.ts} +5 -35
  36. package/dist/functions.d.ts.map +1 -0
  37. package/dist/{esm/functions.js → functions.js} +0 -85
  38. package/dist/functions.js.map +1 -0
  39. package/dist/{types/index.d.ts → index.d.ts} +4 -0
  40. package/dist/index.d.ts.map +1 -0
  41. package/dist/{web/index.js → index.js} +2 -0
  42. package/dist/index.js.map +1 -0
  43. package/dist/key-value-pair.d.ts.map +1 -0
  44. package/dist/key-value-pair.js.map +1 -0
  45. package/dist/keyed-debouncer.d.ts +56 -0
  46. package/dist/keyed-debouncer.d.ts.map +1 -0
  47. package/dist/keyed-debouncer.js +109 -0
  48. package/dist/keyed-debouncer.js.map +1 -0
  49. package/dist/lazy.d.ts.map +1 -0
  50. package/dist/lazy.js.map +1 -0
  51. package/dist/math.d.ts.map +1 -0
  52. package/dist/math.js.map +1 -0
  53. package/dist/order.d.ts.map +1 -0
  54. package/dist/order.js.map +1 -0
  55. package/dist/parse.d.ts.map +1 -0
  56. package/dist/parse.js.map +1 -0
  57. package/dist/patch.d.ts.map +1 -0
  58. package/dist/patch.js.map +1 -0
  59. package/dist/range.d.ts.map +1 -0
  60. package/dist/range.js.map +1 -0
  61. package/dist/result.d.ts.map +1 -0
  62. package/dist/result.js.map +1 -0
  63. package/dist/stopwatch.d.ts.map +1 -0
  64. package/dist/stopwatch.js.map +1 -0
  65. package/dist/string.d.ts.map +1 -0
  66. package/dist/string.js.map +1 -0
  67. package/dist/timer.d.ts.map +1 -0
  68. package/dist/timer.js.map +1 -0
  69. package/dist/timespan.d.ts.map +1 -0
  70. package/dist/timespan.js.map +1 -0
  71. package/dist/triggers.d.ts.map +1 -0
  72. package/dist/triggers.js.map +1 -0
  73. package/dist/type-code.d.ts.map +1 -0
  74. package/dist/type-code.js.map +1 -0
  75. package/dist/type.d.ts.map +1 -0
  76. package/dist/type.js.map +1 -0
  77. package/dist/types.d.ts.map +1 -0
  78. package/dist/types.js.map +1 -0
  79. package/dist/{types/utilities.d.ts → utilities.d.ts} +8 -3
  80. package/dist/utilities.d.ts.map +1 -0
  81. package/dist/{web/utilities.js → utilities.js} +27 -4
  82. package/dist/utilities.js.map +1 -0
  83. package/package.json +13 -62
  84. package/src/debouncer.ts +135 -0
  85. package/src/functions.ts +5 -114
  86. package/src/index.ts +4 -0
  87. package/src/keyed-debouncer.ts +121 -0
  88. package/src/utilities.ts +30 -4
  89. package/dist/cjs/array.js +0 -106
  90. package/dist/cjs/array.js.map +0 -1
  91. package/dist/cjs/async-pool-executor.js +0 -79
  92. package/dist/cjs/async-pool-executor.js.map +0 -1
  93. package/dist/cjs/browser/form-utilities.js +0 -162
  94. package/dist/cjs/browser/form-utilities.js.map +0 -1
  95. package/dist/cjs/browser/geo-location.js +0 -78
  96. package/dist/cjs/browser/geo-location.js.map +0 -1
  97. package/dist/cjs/browser/index.js +0 -99
  98. package/dist/cjs/browser/index.js.map +0 -1
  99. package/dist/cjs/browser/native-bridge.js +0 -81
  100. package/dist/cjs/browser/native-bridge.js.map +0 -1
  101. package/dist/cjs/cancellable-promise.js +0 -81
  102. package/dist/cjs/cancellable-promise.js.map +0 -1
  103. package/dist/cjs/clean-url-search-params.js +0 -34
  104. package/dist/cjs/clean-url-search-params.js.map +0 -1
  105. package/dist/cjs/collections/cache-dictionary.js +0 -102
  106. package/dist/cjs/collections/cache-dictionary.js.map +0 -1
  107. package/dist/cjs/collections/default-map.js +0 -45
  108. package/dist/cjs/collections/default-map.js.map +0 -1
  109. package/dist/cjs/collections/default-weak-map.js +0 -46
  110. package/dist/cjs/collections/default-weak-map.js.map +0 -1
  111. package/dist/cjs/collections/from.js +0 -778
  112. package/dist/cjs/collections/from.js.map +0 -1
  113. package/dist/cjs/collections/index.js +0 -15
  114. package/dist/cjs/collections/index.js.map +0 -1
  115. package/dist/cjs/draft.js +0 -225
  116. package/dist/cjs/draft.js.map +0 -1
  117. package/dist/cjs/event-bus.js +0 -71
  118. package/dist/cjs/event-bus.js.map +0 -1
  119. package/dist/cjs/functions.js +0 -348
  120. package/dist/cjs/functions.js.map +0 -1
  121. package/dist/cjs/index.js +0 -80
  122. package/dist/cjs/index.js.map +0 -1
  123. package/dist/cjs/key-value-pair.js +0 -22
  124. package/dist/cjs/key-value-pair.js.map +0 -1
  125. package/dist/cjs/lazy.js +0 -29
  126. package/dist/cjs/lazy.js.map +0 -1
  127. package/dist/cjs/math.js +0 -37
  128. package/dist/cjs/math.js.map +0 -1
  129. package/dist/cjs/order.js +0 -9
  130. package/dist/cjs/order.js.map +0 -1
  131. package/dist/cjs/parse.js +0 -174
  132. package/dist/cjs/parse.js.map +0 -1
  133. package/dist/cjs/patch.js +0 -52
  134. package/dist/cjs/patch.js.map +0 -1
  135. package/dist/cjs/range.js +0 -154
  136. package/dist/cjs/range.js.map +0 -1
  137. package/dist/cjs/result.js +0 -3
  138. package/dist/cjs/result.js.map +0 -1
  139. package/dist/cjs/stopwatch.js +0 -46
  140. package/dist/cjs/stopwatch.js.map +0 -1
  141. package/dist/cjs/string.js +0 -154
  142. package/dist/cjs/string.js.map +0 -1
  143. package/dist/cjs/timer.js +0 -57
  144. package/dist/cjs/timer.js.map +0 -1
  145. package/dist/cjs/timespan.js +0 -367
  146. package/dist/cjs/timespan.js.map +0 -1
  147. package/dist/cjs/triggers.js +0 -103
  148. package/dist/cjs/triggers.js.map +0 -1
  149. package/dist/cjs/type-code.js +0 -18
  150. package/dist/cjs/type-code.js.map +0 -1
  151. package/dist/cjs/type.js +0 -296
  152. package/dist/cjs/type.js.map +0 -1
  153. package/dist/cjs/types.js +0 -3
  154. package/dist/cjs/types.js.map +0 -1
  155. package/dist/cjs/utilities.js +0 -598
  156. package/dist/cjs/utilities.js.map +0 -1
  157. package/dist/esm/array.js.map +0 -1
  158. package/dist/esm/async-pool-executor.js.map +0 -1
  159. package/dist/esm/browser/form-utilities.js.map +0 -1
  160. package/dist/esm/browser/geo-location.js.map +0 -1
  161. package/dist/esm/browser/index.js.map +0 -1
  162. package/dist/esm/browser/native-bridge.js.map +0 -1
  163. package/dist/esm/cancellable-promise.js.map +0 -1
  164. package/dist/esm/clean-url-search-params.js.map +0 -1
  165. package/dist/esm/collections/cache-dictionary.js.map +0 -1
  166. package/dist/esm/collections/default-map.js.map +0 -1
  167. package/dist/esm/collections/default-weak-map.js.map +0 -1
  168. package/dist/esm/collections/from.js.map +0 -1
  169. package/dist/esm/collections/index.js.map +0 -1
  170. package/dist/esm/draft.js.map +0 -1
  171. package/dist/esm/event-bus.js.map +0 -1
  172. package/dist/esm/functions.js.map +0 -1
  173. package/dist/esm/index.js +0 -38
  174. package/dist/esm/index.js.map +0 -1
  175. package/dist/esm/key-value-pair.js.map +0 -1
  176. package/dist/esm/lazy.js.map +0 -1
  177. package/dist/esm/math.js.map +0 -1
  178. package/dist/esm/order.js.map +0 -1
  179. package/dist/esm/parse.js.map +0 -1
  180. package/dist/esm/patch.js.map +0 -1
  181. package/dist/esm/range.js.map +0 -1
  182. package/dist/esm/result.js.map +0 -1
  183. package/dist/esm/stopwatch.js.map +0 -1
  184. package/dist/esm/string.js.map +0 -1
  185. package/dist/esm/timer.js.map +0 -1
  186. package/dist/esm/timespan.js.map +0 -1
  187. package/dist/esm/triggers.js.map +0 -1
  188. package/dist/esm/type-code.js.map +0 -1
  189. package/dist/esm/type.js.map +0 -1
  190. package/dist/esm/types.js.map +0 -1
  191. package/dist/esm/utilities.js +0 -567
  192. package/dist/esm/utilities.js.map +0 -1
  193. package/dist/types/array.d.ts.map +0 -1
  194. package/dist/types/async-pool-executor.d.ts.map +0 -1
  195. package/dist/types/browser/form-utilities.d.ts.map +0 -1
  196. package/dist/types/browser/geo-location.d.ts.map +0 -1
  197. package/dist/types/browser/index.d.ts.map +0 -1
  198. package/dist/types/browser/native-bridge.d.ts.map +0 -1
  199. package/dist/types/cancellable-promise.d.ts.map +0 -1
  200. package/dist/types/clean-url-search-params.d.ts.map +0 -1
  201. package/dist/types/collections/cache-dictionary.d.ts.map +0 -1
  202. package/dist/types/collections/default-map.d.ts.map +0 -1
  203. package/dist/types/collections/default-weak-map.d.ts.map +0 -1
  204. package/dist/types/collections/from.d.ts.map +0 -1
  205. package/dist/types/collections/index.d.ts.map +0 -1
  206. package/dist/types/draft.d.ts.map +0 -1
  207. package/dist/types/event-bus.d.ts.map +0 -1
  208. package/dist/types/functions.d.ts.map +0 -1
  209. package/dist/types/index.d.ts.map +0 -1
  210. package/dist/types/key-value-pair.d.ts.map +0 -1
  211. package/dist/types/lazy.d.ts.map +0 -1
  212. package/dist/types/math.d.ts.map +0 -1
  213. package/dist/types/order.d.ts.map +0 -1
  214. package/dist/types/parse.d.ts.map +0 -1
  215. package/dist/types/patch.d.ts.map +0 -1
  216. package/dist/types/range.d.ts.map +0 -1
  217. package/dist/types/result.d.ts.map +0 -1
  218. package/dist/types/stopwatch.d.ts.map +0 -1
  219. package/dist/types/string.d.ts.map +0 -1
  220. package/dist/types/timer.d.ts.map +0 -1
  221. package/dist/types/timespan.d.ts.map +0 -1
  222. package/dist/types/triggers.d.ts.map +0 -1
  223. package/dist/types/type-code.d.ts.map +0 -1
  224. package/dist/types/type.d.ts.map +0 -1
  225. package/dist/types/types.d.ts.map +0 -1
  226. package/dist/types/utilities.d.ts.map +0 -1
  227. package/dist/web/array.js +0 -98
  228. package/dist/web/array.js.map +0 -1
  229. package/dist/web/async-pool-executor.js +0 -76
  230. package/dist/web/async-pool-executor.js.map +0 -1
  231. package/dist/web/browser/form-utilities.js +0 -155
  232. package/dist/web/browser/form-utilities.js.map +0 -1
  233. package/dist/web/browser/geo-location.js +0 -75
  234. package/dist/web/browser/geo-location.js.map +0 -1
  235. package/dist/web/browser/index.js +0 -75
  236. package/dist/web/browser/index.js.map +0 -1
  237. package/dist/web/browser/native-bridge.js +0 -78
  238. package/dist/web/browser/native-bridge.js.map +0 -1
  239. package/dist/web/cancellable-promise.js +0 -78
  240. package/dist/web/cancellable-promise.js.map +0 -1
  241. package/dist/web/clean-url-search-params.js +0 -31
  242. package/dist/web/clean-url-search-params.js.map +0 -1
  243. package/dist/web/collections/cache-dictionary.js +0 -99
  244. package/dist/web/collections/cache-dictionary.js.map +0 -1
  245. package/dist/web/collections/default-map.js +0 -42
  246. package/dist/web/collections/default-map.js.map +0 -1
  247. package/dist/web/collections/default-weak-map.js +0 -43
  248. package/dist/web/collections/default-weak-map.js.map +0 -1
  249. package/dist/web/collections/from.js +0 -770
  250. package/dist/web/collections/from.js.map +0 -1
  251. package/dist/web/collections/index.js +0 -5
  252. package/dist/web/collections/index.js.map +0 -1
  253. package/dist/web/draft.js +0 -222
  254. package/dist/web/draft.js.map +0 -1
  255. package/dist/web/event-bus.js +0 -66
  256. package/dist/web/event-bus.js.map +0 -1
  257. package/dist/web/functions.js +0 -336
  258. package/dist/web/functions.js.map +0 -1
  259. package/dist/web/index.js.map +0 -1
  260. package/dist/web/key-value-pair.js +0 -19
  261. package/dist/web/key-value-pair.js.map +0 -1
  262. package/dist/web/lazy.js +0 -26
  263. package/dist/web/lazy.js.map +0 -1
  264. package/dist/web/math.js +0 -33
  265. package/dist/web/math.js.map +0 -1
  266. package/dist/web/order.js +0 -7
  267. package/dist/web/order.js.map +0 -1
  268. package/dist/web/parse.js +0 -169
  269. package/dist/web/parse.js.map +0 -1
  270. package/dist/web/patch.js +0 -48
  271. package/dist/web/patch.js.map +0 -1
  272. package/dist/web/range.js +0 -151
  273. package/dist/web/range.js.map +0 -1
  274. package/dist/web/result.js +0 -2
  275. package/dist/web/result.js.map +0 -1
  276. package/dist/web/stopwatch.js +0 -40
  277. package/dist/web/stopwatch.js.map +0 -1
  278. package/dist/web/string.js +0 -142
  279. package/dist/web/string.js.map +0 -1
  280. package/dist/web/timer.js +0 -54
  281. package/dist/web/timer.js.map +0 -1
  282. package/dist/web/timespan.js +0 -365
  283. package/dist/web/timespan.js.map +0 -1
  284. package/dist/web/triggers.js +0 -99
  285. package/dist/web/triggers.js.map +0 -1
  286. package/dist/web/type-code.js +0 -16
  287. package/dist/web/type-code.js.map +0 -1
  288. package/dist/web/type.js +0 -292
  289. package/dist/web/type.js.map +0 -1
  290. package/dist/web/types.js +0 -2
  291. package/dist/web/types.js.map +0 -1
  292. package/dist/web/utilities.js.map +0 -1
  293. /package/dist/{types/array.d.ts → array.d.ts} +0 -0
  294. /package/dist/{esm/array.js → array.js} +0 -0
  295. /package/dist/{types/async-pool-executor.d.ts → async-pool-executor.d.ts} +0 -0
  296. /package/dist/{esm/async-pool-executor.js → async-pool-executor.js} +0 -0
  297. /package/dist/{types/browser → browser}/form-utilities.d.ts +0 -0
  298. /package/dist/{esm/browser → browser}/form-utilities.js +0 -0
  299. /package/dist/{types/browser → browser}/geo-location.d.ts +0 -0
  300. /package/dist/{esm/browser → browser}/geo-location.js +0 -0
  301. /package/dist/{types/browser → browser}/index.d.ts +0 -0
  302. /package/dist/{esm/browser → browser}/index.js +0 -0
  303. /package/dist/{types/browser → browser}/native-bridge.d.ts +0 -0
  304. /package/dist/{esm/browser → browser}/native-bridge.js +0 -0
  305. /package/dist/{types/cancellable-promise.d.ts → cancellable-promise.d.ts} +0 -0
  306. /package/dist/{esm/cancellable-promise.js → cancellable-promise.js} +0 -0
  307. /package/dist/{types/clean-url-search-params.d.ts → clean-url-search-params.d.ts} +0 -0
  308. /package/dist/{esm/clean-url-search-params.js → clean-url-search-params.js} +0 -0
  309. /package/dist/{types/collections → collections}/cache-dictionary.d.ts +0 -0
  310. /package/dist/{esm/collections → collections}/cache-dictionary.js +0 -0
  311. /package/dist/{types/collections → collections}/default-map.d.ts +0 -0
  312. /package/dist/{esm/collections → collections}/default-map.js +0 -0
  313. /package/dist/{types/collections → collections}/default-weak-map.d.ts +0 -0
  314. /package/dist/{esm/collections → collections}/default-weak-map.js +0 -0
  315. /package/dist/{types/collections → collections}/from.d.ts +0 -0
  316. /package/dist/{esm/collections → collections}/from.js +0 -0
  317. /package/dist/{types/collections → collections}/index.d.ts +0 -0
  318. /package/dist/{esm/collections → collections}/index.js +0 -0
  319. /package/dist/{types/draft.d.ts → draft.d.ts} +0 -0
  320. /package/dist/{esm/draft.js → draft.js} +0 -0
  321. /package/dist/{types/event-bus.d.ts → event-bus.d.ts} +0 -0
  322. /package/dist/{esm/event-bus.js → event-bus.js} +0 -0
  323. /package/dist/{types/key-value-pair.d.ts → key-value-pair.d.ts} +0 -0
  324. /package/dist/{esm/key-value-pair.js → key-value-pair.js} +0 -0
  325. /package/dist/{types/lazy.d.ts → lazy.d.ts} +0 -0
  326. /package/dist/{esm/lazy.js → lazy.js} +0 -0
  327. /package/dist/{types/math.d.ts → math.d.ts} +0 -0
  328. /package/dist/{esm/math.js → math.js} +0 -0
  329. /package/dist/{types/order.d.ts → order.d.ts} +0 -0
  330. /package/dist/{esm/order.js → order.js} +0 -0
  331. /package/dist/{types/parse.d.ts → parse.d.ts} +0 -0
  332. /package/dist/{esm/parse.js → parse.js} +0 -0
  333. /package/dist/{types/patch.d.ts → patch.d.ts} +0 -0
  334. /package/dist/{esm/patch.js → patch.js} +0 -0
  335. /package/dist/{types/range.d.ts → range.d.ts} +0 -0
  336. /package/dist/{esm/range.js → range.js} +0 -0
  337. /package/dist/{types/result.d.ts → result.d.ts} +0 -0
  338. /package/dist/{esm/result.js → result.js} +0 -0
  339. /package/dist/{types/stopwatch.d.ts → stopwatch.d.ts} +0 -0
  340. /package/dist/{esm/stopwatch.js → stopwatch.js} +0 -0
  341. /package/dist/{types/string.d.ts → string.d.ts} +0 -0
  342. /package/dist/{esm/string.js → string.js} +0 -0
  343. /package/dist/{types/timer.d.ts → timer.d.ts} +0 -0
  344. /package/dist/{esm/timer.js → timer.js} +0 -0
  345. /package/dist/{types/timespan.d.ts → timespan.d.ts} +0 -0
  346. /package/dist/{esm/timespan.js → timespan.js} +0 -0
  347. /package/dist/{types/triggers.d.ts → triggers.d.ts} +0 -0
  348. /package/dist/{esm/triggers.js → triggers.js} +0 -0
  349. /package/dist/{types/type-code.d.ts → type-code.d.ts} +0 -0
  350. /package/dist/{esm/type-code.js → type-code.js} +0 -0
  351. /package/dist/{types/type.d.ts → type.d.ts} +0 -0
  352. /package/dist/{esm/type.js → type.js} +0 -0
  353. /package/dist/{types/types.d.ts → types.d.ts} +0 -0
  354. /package/dist/{esm/types.js → types.js} +0 -0
@@ -1,336 +0,0 @@
1
- /**
2
- * Return the received value unchanged.
3
- * Useful as a default mapper, placeholder callback, or neutral transform in a pipeline.
4
- *
5
- * @example
6
- * ```ts
7
- * identity(5); // 5
8
- *
9
- * const value = {name: "commons"};
10
- * identity(value) === value; // true
11
- * ```
12
- */
13
- export function identity(value) {
14
- return value;
15
- }
16
- /**
17
- * Create a function that always returns the same value.
18
- *
19
- * @example
20
- * ```ts
21
- * const getAnswer = constant(42);
22
- *
23
- * getAnswer(); // 42
24
- * getAnswer(); // 42
25
- * ```
26
- */
27
- export function constant(value) {
28
- return () => value;
29
- }
30
- /**
31
- * Do nothing and return undefined.
32
- * Useful as a safe default callback.
33
- *
34
- * @example
35
- * ```ts
36
- * const onComplete = options.onComplete ?? noop;
37
- * onComplete();
38
- * ```
39
- */
40
- export function noop() {
41
- // Intentionally empty.
42
- }
43
- /**
44
- * Create a function that can be executed only once.
45
- * Later calls return the result from the first execution without calling the original function again.
46
- *
47
- * @example
48
- * ```ts
49
- * const initialize = once(() => ({connected: true}));
50
- *
51
- * const first = initialize();
52
- * const second = initialize();
53
- * first === second; // true
54
- * ```
55
- */
56
- export function once(fn) {
57
- let called = false;
58
- let result;
59
- return function (...args) {
60
- if (!called) {
61
- called = true;
62
- result = fn.apply(this, args);
63
- }
64
- return result;
65
- };
66
- }
67
- /**
68
- * Cache the result of a function and reuse it for calls with the same resolved key.
69
- * By default, the first argument is used as the cache key.
70
- *
71
- * @example
72
- * ```ts
73
- * const double = memoize((value: number) => value * 2);
74
- *
75
- * double(4); // 8, computed
76
- * double(4); // 8, read from cache
77
- * double.has(4); // true
78
- * ```
79
- *
80
- * @example
81
- * ```ts
82
- * const sum = memoize(
83
- * (left: number, right: number) => left + right,
84
- * (left, right) => `${left}:${right}`,
85
- * );
86
- *
87
- * sum(2, 3); // 5
88
- * sum.delete(2, 3); // true
89
- * sum.clear();
90
- * ```
91
- */
92
- export function memoize(fn, resolver, cache = new Map()) {
93
- const resolveKey = (...args) => {
94
- if (resolver)
95
- return resolver(...args);
96
- return args[0];
97
- };
98
- const memoized = function (...args) {
99
- const key = resolveKey(...args);
100
- if (cache.has(key)) {
101
- return cache.get(key);
102
- }
103
- const value = fn.apply(this, args);
104
- cache.set(key, value);
105
- return value;
106
- };
107
- Object.defineProperty(memoized, "cache", {
108
- value: cache,
109
- enumerable: false,
110
- });
111
- memoized.clear = () => cache.clear();
112
- memoized.delete = (...args) => cache.delete(resolveKey(...args));
113
- memoized.has = (...args) => cache.has(resolveKey(...args));
114
- return memoized;
115
- }
116
- /**
117
- * Delay a function until no calls have been made for the configured wait time.
118
- * The latest arguments and this-context are used for the trailing execution.
119
- *
120
- * @example
121
- * ```ts
122
- * const search = debounce((query: string) => {
123
- * console.log(query);
124
- * }, 300);
125
- *
126
- * search("com");
127
- * search("commons"); // only this value is printed after 300 ms
128
- * ```
129
- *
130
- * @example
131
- * ```ts
132
- * const track = debounce(sendAnalytics, 1000, {leading: true, trailing: false});
133
- *
134
- * track("open"); // executed immediately
135
- * track.cancel(); // cancel the pending debounce window
136
- * ```
137
- */
138
- export function debounce(fn, wait, options = {}) {
139
- const delay = normalizeDelay(wait);
140
- const leading = options.leading ?? false;
141
- const trailing = options.trailing ?? true;
142
- let timer;
143
- let lastArgs;
144
- let lastThis;
145
- let result;
146
- const invoke = () => {
147
- const args = lastArgs;
148
- const context = lastThis;
149
- lastArgs = undefined;
150
- lastThis = undefined;
151
- result = fn.apply(context, args);
152
- return result;
153
- };
154
- const expire = () => {
155
- timer = undefined;
156
- if (trailing && lastArgs) {
157
- invoke();
158
- }
159
- else {
160
- lastArgs = undefined;
161
- lastThis = undefined;
162
- }
163
- };
164
- const start = () => {
165
- timer = setTimeout(expire, delay);
166
- };
167
- const debounced = function (...args) {
168
- const invokeLeading = leading && timer === undefined;
169
- lastArgs = args;
170
- lastThis = this;
171
- if (timer !== undefined) {
172
- clearTimeout(timer);
173
- }
174
- start();
175
- if (invokeLeading) {
176
- return invoke();
177
- }
178
- return result;
179
- };
180
- debounced.cancel = () => {
181
- if (timer !== undefined) {
182
- clearTimeout(timer);
183
- }
184
- timer = undefined;
185
- lastArgs = undefined;
186
- lastThis = undefined;
187
- };
188
- debounced.flush = () => {
189
- if (timer !== undefined) {
190
- clearTimeout(timer);
191
- timer = undefined;
192
- if (lastArgs && trailing) {
193
- return invoke();
194
- }
195
- }
196
- return result;
197
- };
198
- debounced.pending = () => timer !== undefined;
199
- return debounced;
200
- }
201
- /**
202
- * Limit how often a function can run during a time window.
203
- * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.
204
- *
205
- * @example
206
- * ```ts
207
- * const onScroll = throttle(() => {
208
- * console.log(window.scrollY);
209
- * }, 100);
210
- *
211
- * window.addEventListener("scroll", onScroll);
212
- * ```
213
- *
214
- * @example
215
- * ```ts
216
- * const refresh = throttle(loadData, 500, {leading: false});
217
- *
218
- * refresh(); // scheduled instead of executed immediately
219
- * refresh.flush(); // execute the scheduled call now
220
- * ```
221
- */
222
- export function throttle(fn, wait, options = {}) {
223
- const delay = normalizeDelay(wait);
224
- const leading = options.leading ?? true;
225
- const trailing = options.trailing ?? true;
226
- let timer;
227
- let lastArgs;
228
- let lastThis;
229
- let lastInvokeTime = 0;
230
- let hasInvoked = false;
231
- let result;
232
- const invoke = (time) => {
233
- const args = lastArgs;
234
- const context = lastThis;
235
- lastArgs = undefined;
236
- lastThis = undefined;
237
- hasInvoked = true;
238
- lastInvokeTime = time;
239
- result = fn.apply(context, args);
240
- return result;
241
- };
242
- const expire = () => {
243
- timer = undefined;
244
- if (trailing && lastArgs) {
245
- invoke(Date.now());
246
- }
247
- else {
248
- lastArgs = undefined;
249
- lastThis = undefined;
250
- }
251
- };
252
- const throttled = function (...args) {
253
- const now = Date.now();
254
- lastArgs = args;
255
- lastThis = this;
256
- if (!hasInvoked) {
257
- if (leading) {
258
- return invoke(now);
259
- }
260
- hasInvoked = true;
261
- lastInvokeTime = now;
262
- }
263
- const remaining = delay - (now - lastInvokeTime);
264
- if (remaining <= 0 || remaining > delay) {
265
- if (timer !== undefined) {
266
- clearTimeout(timer);
267
- timer = undefined;
268
- }
269
- return invoke(now);
270
- }
271
- if (timer === undefined && trailing) {
272
- timer = setTimeout(expire, remaining);
273
- }
274
- return result;
275
- };
276
- throttled.cancel = () => {
277
- if (timer !== undefined) {
278
- clearTimeout(timer);
279
- }
280
- timer = undefined;
281
- lastArgs = undefined;
282
- lastThis = undefined;
283
- lastInvokeTime = 0;
284
- hasInvoked = false;
285
- };
286
- throttled.flush = () => {
287
- if (timer !== undefined) {
288
- clearTimeout(timer);
289
- timer = undefined;
290
- if (lastArgs && trailing) {
291
- return invoke(Date.now());
292
- }
293
- }
294
- return result;
295
- };
296
- throttled.pending = () => timer !== undefined;
297
- return throttled;
298
- }
299
- /**
300
- * Create a function with one or more arguments already provided.
301
- * Later arguments are appended after the preset arguments.
302
- *
303
- * @example
304
- * ```ts
305
- * const sum = (a: number, b: number, c: number) => a + b + c;
306
- * const addFive = partial(sum, 2, 3);
307
- *
308
- * addFive(4); // 9
309
- * ```
310
- */
311
- export function partial(fn, ...presetArgs) {
312
- return function (...laterArgs) {
313
- return fn.apply(this, [...presetArgs, ...laterArgs]);
314
- };
315
- }
316
- export function pipe(...fns) {
317
- return createFlow(fns);
318
- }
319
- export function compose(...fns) {
320
- return createFlow(fns.slice().reverse());
321
- }
322
- function createFlow(fns) {
323
- if (fns.length === 0)
324
- return identity;
325
- return function (...args) {
326
- let result = fns[0].apply(this, args);
327
- for (let i = 1; i < fns.length; i++) {
328
- result = fns[i].call(this, result);
329
- }
330
- return result;
331
- };
332
- }
333
- function normalizeDelay(wait) {
334
- return Number.isFinite(wait) ? Math.max(0, wait) : 0;
335
- }
336
- //# sourceMappingURL=functions.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/functions.ts"],"names":[],"mappings":"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","sourcesContent":["type AnyFunction = (this: any, ...args: any[]) => any;\ntype TimerHandle = ReturnType<typeof setTimeout>;\n\n/** Options that control when a debounced function is executed. */\nexport interface DebounceOptions {\n /** Execute on the first call in a debounce window. Defaults to false. */\n leading?: boolean;\n /** Execute after the debounce window using the latest arguments. Defaults to true. */\n trailing?: boolean;\n}\n\n/** Options that control when a throttled function is executed. */\nexport interface ThrottleOptions {\n /** Execute immediately on the first call in a throttle window. Defaults to true. */\n leading?: boolean;\n /** Execute once more at the end of the throttle window using the latest arguments. Defaults to true. */\n trailing?: boolean;\n}\n\n/**\n * A delayed function returned by {@link debounce} or {@link throttle}.\n *\n * @example\n * ```ts\n * const saveLater = debounce(save, 250);\n * saveLater();\n *\n * if (saveLater.pending()) {\n * saveLater.flush();\n * }\n * ```\n */\nexport type DeferredFunction<F extends AnyFunction> = ((\n this: ThisParameterType<F>,\n ...args: Parameters<F>\n) => ReturnType<F> | undefined) & {\n /** Cancel the scheduled call and forget the latest arguments. */\n cancel(): void;\n /** Execute the scheduled trailing call immediately, when one exists. */\n flush(): ReturnType<F> | undefined;\n /** Return true while a trailing call is scheduled. */\n pending(): boolean;\n};\n\n/**\n * A memoized function with helpers for inspecting and invalidating its cache.\n *\n * @example\n * ```ts\n * const getUser = memoize((id: string) => fetchUser(id));\n *\n * getUser(\"42\");\n * getUser.has(\"42\"); // true\n * getUser.delete(\"42\");\n * ```\n */\nexport type MemoizedFunction<F extends AnyFunction, K> = ((\n this: ThisParameterType<F>,\n ...args: Parameters<F>\n) => ReturnType<F>) & {\n /** The backing cache used by the memoized function. */\n readonly cache: Map<K, ReturnType<F>>;\n /** Remove every cached value. */\n clear(): void;\n /** Remove the cached value for the key resolved from the provided arguments. */\n delete(...args: Parameters<F>): boolean;\n /** Return true when a cached value exists for the key resolved from the provided arguments. */\n has(...args: Parameters<F>): boolean;\n};\n\ntype Unary<T, R> = (arg: T) => R;\n\n/**\n * Return the received value unchanged.\n * Useful as a default mapper, placeholder callback, or neutral transform in a pipeline.\n *\n * @example\n * ```ts\n * identity(5); // 5\n *\n * const value = {name: \"commons\"};\n * identity(value) === value; // true\n * ```\n */\nexport function identity<T>(value: T): T {\n return value;\n}\n\n/**\n * Create a function that always returns the same value.\n *\n * @example\n * ```ts\n * const getAnswer = constant(42);\n *\n * getAnswer(); // 42\n * getAnswer(); // 42\n * ```\n */\nexport function constant<T>(value: T): () => T {\n return () => value;\n}\n\n/**\n * Do nothing and return undefined.\n * Useful as a safe default callback.\n *\n * @example\n * ```ts\n * const onComplete = options.onComplete ?? noop;\n * onComplete();\n * ```\n */\nexport function noop(): void {\n // Intentionally empty.\n}\n\n/**\n * Create a function that can be executed only once.\n * Later calls return the result from the first execution without calling the original function again.\n *\n * @example\n * ```ts\n * const initialize = once(() => ({connected: true}));\n *\n * const first = initialize();\n * const second = initialize();\n * first === second; // true\n * ```\n */\nexport function once<F extends AnyFunction>(fn: F): F {\n let called = false;\n let result: ReturnType<F>;\n\n return function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n if (!called) {\n called = true;\n result = fn.apply(this, args);\n }\n return result;\n } as F;\n}\n\n/**\n * Cache the result of a function and reuse it for calls with the same resolved key.\n * By default, the first argument is used as the cache key.\n *\n * @example\n * ```ts\n * const double = memoize((value: number) => value * 2);\n *\n * double(4); // 8, computed\n * double(4); // 8, read from cache\n * double.has(4); // true\n * ```\n *\n * @example\n * ```ts\n * const sum = memoize(\n * (left: number, right: number) => left + right,\n * (left, right) => `${left}:${right}`,\n * );\n *\n * sum(2, 3); // 5\n * sum.delete(2, 3); // true\n * sum.clear();\n * ```\n */\nexport function memoize<F extends AnyFunction, K = Parameters<F>[0]>(\n fn: F,\n resolver?: (...args: Parameters<F>) => K,\n cache: Map<K, ReturnType<F>> = new Map<K, ReturnType<F>>()\n): MemoizedFunction<F, K> {\n const resolveKey = (...args: Parameters<F>): K => {\n if (resolver) return resolver(...args);\n return args[0] as K;\n };\n\n const memoized = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n const key = resolveKey(...args);\n if (cache.has(key)) {\n return cache.get(key)!;\n }\n\n const value = fn.apply(this, args);\n cache.set(key, value);\n return value;\n } as MemoizedFunction<F, K>;\n\n Object.defineProperty(memoized, \"cache\", {\n value: cache,\n enumerable: false,\n });\n\n memoized.clear = () => cache.clear();\n memoized.delete = (...args: Parameters<F>) => cache.delete(resolveKey(...args));\n memoized.has = (...args: Parameters<F>) => cache.has(resolveKey(...args));\n\n return memoized;\n}\n\n/**\n * Delay a function until no calls have been made for the configured wait time.\n * The latest arguments and this-context are used for the trailing execution.\n *\n * @example\n * ```ts\n * const search = debounce((query: string) => {\n * console.log(query);\n * }, 300);\n *\n * search(\"com\");\n * search(\"commons\"); // only this value is printed after 300 ms\n * ```\n *\n * @example\n * ```ts\n * const track = debounce(sendAnalytics, 1000, {leading: true, trailing: false});\n *\n * track(\"open\"); // executed immediately\n * track.cancel(); // cancel the pending debounce window\n * ```\n */\nexport function debounce<F extends AnyFunction>(\n fn: F,\n wait: number,\n options: DebounceOptions = {}\n): DeferredFunction<F> {\n const delay = normalizeDelay(wait);\n const leading = options.leading ?? false;\n const trailing = options.trailing ?? true;\n\n let timer: TimerHandle | undefined;\n let lastArgs: Parameters<F> | undefined;\n let lastThis: ThisParameterType<F> | undefined;\n let result: ReturnType<F> | undefined;\n\n const invoke = (): ReturnType<F> => {\n const args = lastArgs!;\n const context = lastThis!;\n lastArgs = undefined;\n lastThis = undefined;\n result = fn.apply(context, args);\n return result as ReturnType<F>;\n };\n\n const expire = (): void => {\n timer = undefined;\n if (trailing && lastArgs) {\n invoke();\n } else {\n lastArgs = undefined;\n lastThis = undefined;\n }\n };\n\n const start = (): void => {\n timer = setTimeout(expire, delay);\n };\n\n const debounced = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> | undefined {\n const invokeLeading = leading && timer === undefined;\n lastArgs = args;\n lastThis = this;\n\n if (timer !== undefined) {\n clearTimeout(timer);\n }\n start();\n\n if (invokeLeading) {\n return invoke();\n }\n\n return result;\n } as DeferredFunction<F>;\n\n debounced.cancel = (): void => {\n if (timer !== undefined) {\n clearTimeout(timer);\n }\n timer = undefined;\n lastArgs = undefined;\n lastThis = undefined;\n };\n\n debounced.flush = (): ReturnType<F> | undefined => {\n if (timer !== undefined) {\n clearTimeout(timer);\n timer = undefined;\n if (lastArgs && trailing) {\n return invoke();\n }\n }\n return result;\n };\n\n debounced.pending = (): boolean => timer !== undefined;\n\n return debounced;\n}\n\n/**\n * Limit how often a function can run during a time window.\n * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.\n *\n * @example\n * ```ts\n * const onScroll = throttle(() => {\n * console.log(window.scrollY);\n * }, 100);\n *\n * window.addEventListener(\"scroll\", onScroll);\n * ```\n *\n * @example\n * ```ts\n * const refresh = throttle(loadData, 500, {leading: false});\n *\n * refresh(); // scheduled instead of executed immediately\n * refresh.flush(); // execute the scheduled call now\n * ```\n */\nexport function throttle<F extends AnyFunction>(\n fn: F,\n wait: number,\n options: ThrottleOptions = {}\n): DeferredFunction<F> {\n const delay = normalizeDelay(wait);\n const leading = options.leading ?? true;\n const trailing = options.trailing ?? true;\n\n let timer: TimerHandle | undefined;\n let lastArgs: Parameters<F> | undefined;\n let lastThis: ThisParameterType<F> | undefined;\n let lastInvokeTime = 0;\n let hasInvoked = false;\n let result: ReturnType<F> | undefined;\n\n const invoke = (time: number): ReturnType<F> => {\n const args = lastArgs!;\n const context = lastThis!;\n lastArgs = undefined;\n lastThis = undefined;\n hasInvoked = true;\n lastInvokeTime = time;\n result = fn.apply(context, args);\n return result as ReturnType<F>;\n };\n\n const expire = (): void => {\n timer = undefined;\n if (trailing && lastArgs) {\n invoke(Date.now());\n } else {\n lastArgs = undefined;\n lastThis = undefined;\n }\n };\n\n const throttled = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> | undefined {\n const now = Date.now();\n lastArgs = args;\n lastThis = this;\n\n if (!hasInvoked) {\n if (leading) {\n return invoke(now);\n }\n hasInvoked = true;\n lastInvokeTime = now;\n }\n\n const remaining = delay - (now - lastInvokeTime);\n if (remaining <= 0 || remaining > delay) {\n if (timer !== undefined) {\n clearTimeout(timer);\n timer = undefined;\n }\n return invoke(now);\n }\n\n if (timer === undefined && trailing) {\n timer = setTimeout(expire, remaining);\n }\n\n return result;\n } as DeferredFunction<F>;\n\n throttled.cancel = (): void => {\n if (timer !== undefined) {\n clearTimeout(timer);\n }\n timer = undefined;\n lastArgs = undefined;\n lastThis = undefined;\n lastInvokeTime = 0;\n hasInvoked = false;\n };\n\n throttled.flush = (): ReturnType<F> | undefined => {\n if (timer !== undefined) {\n clearTimeout(timer);\n timer = undefined;\n if (lastArgs && trailing) {\n return invoke(Date.now());\n }\n }\n return result;\n };\n\n throttled.pending = (): boolean => timer !== undefined;\n\n return throttled;\n}\n\n/**\n * Create a function with one or more arguments already provided.\n * Later arguments are appended after the preset arguments.\n *\n * @example\n * ```ts\n * const sum = (a: number, b: number, c: number) => a + b + c;\n * const addFive = partial(sum, 2, 3);\n *\n * addFive(4); // 9\n * ```\n */\nexport function partial<F extends AnyFunction>(\n fn: F,\n ...presetArgs: unknown[]\n): (...laterArgs: unknown[]) => ReturnType<F> {\n return function (this: ThisParameterType<F>, ...laterArgs: unknown[]): ReturnType<F> {\n return fn.apply(this, [...presetArgs, ...laterArgs] as Parameters<F>);\n };\n}\n\n/**\n * Compose unary functions from left to right.\n * The first function receives the original arguments, and each next function receives the previous result.\n *\n * @example\n * ```ts\n * const transform = pipe(\n * (value: number) => value + 1,\n * (value: number) => value * 2,\n * );\n *\n * transform(2); // 6\n * ```\n */\nexport function pipe<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function pipe<A, B, C>(ab: Unary<A, B>, bc: Unary<B, C>): Unary<A, C>;\nexport function pipe<A, B, C, D>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): Unary<A, D>;\nexport function pipe<A, B, C, D, E>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): Unary<A, E>;\nexport function pipe(...fns: AnyFunction[]): AnyFunction {\n return createFlow(fns);\n}\n\n/**\n * Compose unary functions from right to left.\n * The rightmost function receives the original arguments, and each function to its left receives the previous result.\n *\n * @example\n * ```ts\n * const transform = compose(\n * (value: number) => value + 1,\n * (value: number) => value * 2,\n * );\n *\n * transform(2); // 5\n * ```\n */\nexport function compose<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function compose<A, B, C>(bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, C>;\nexport function compose<A, B, C, D>(cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, D>;\nexport function compose<A, B, C, D, E>(de: Unary<D, E>, cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, E>;\nexport function compose(...fns: AnyFunction[]): AnyFunction {\n return createFlow(fns.slice().reverse());\n}\n\nfunction createFlow(fns: AnyFunction[]): AnyFunction {\n if (fns.length === 0) return identity;\n\n return function (this: any, ...args: any[]): unknown {\n let result = fns[0].apply(this, args);\n for (let i = 1; i < fns.length; i++) {\n result = fns[i].call(this, result);\n }\n return result;\n };\n}\n\nfunction normalizeDelay(wait: number): number {\n return Number.isFinite(wait) ? Math.max(0, wait) : 0;\n}"]}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,wDAAwD;AACxD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAEnD,wDAAwD;AACxD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAEvE,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AACxD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,qDAAqD;AACrD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAIxF,wDAAwD;AACxD,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport type {Result} from './result.js';\nexport {TimeTrigger, CountTrigger} from './triggers.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated */\nexport * from './array.js';\n/** @deprecated */\nexport * from './collections/index.js';"]}
@@ -1,19 +0,0 @@
1
- /**
2
- * Represents a pair of key and value.
3
- *
4
- * @template TKey The type of the key.
5
- * @template TValue The type of the value.
6
- */
7
- export default class KeyValuePair {
8
- get value() {
9
- return this._value;
10
- }
11
- get key() {
12
- return this._key;
13
- }
14
- constructor(key, value) {
15
- this._key = key;
16
- this._value = value;
17
- }
18
- }
19
- //# sourceMappingURL=key-value-pair.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"key-value-pair.js","sourceRoot":"","sources":["../../src/key-value-pair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,GAAG;QACH,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAKD,YAAY,GAAS,EAAE,KAAa;QAChC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;CAGJ","sourcesContent":["/**\n * Represents a pair of key and value.\n *\n * @template TKey The type of the key.\n * @template TValue The type of the value.\n */\nexport default class KeyValuePair<TKey, TValue> {\n get value(): TValue {\n return this._value;\n }\n\n get key(): TKey {\n return this._key;\n }\n\n private readonly _key: TKey;\n private readonly _value: TValue;\n\n constructor(key: TKey, value: TValue) {\n this._key = key;\n this._value = value;\n }\n\n\n}"]}
package/dist/web/lazy.js DELETED
@@ -1,26 +0,0 @@
1
- /**
2
- * Represents a lazy value that is created only when it is accessed for the first time.
3
- * @template T The type of the lazy value.
4
- */
5
- export default class Lazy {
6
- constructor(getter) {
7
- this._valueCreated = false;
8
- this._value = null;
9
- this._factoryMethod = getter;
10
- }
11
- get valueCreated() {
12
- return this._valueCreated;
13
- }
14
- get value() {
15
- if (!this._valueCreated) {
16
- this._value = this._factoryMethod();
17
- this._valueCreated = true;
18
- }
19
- return this._value;
20
- }
21
- reset() {
22
- this._valueCreated = false;
23
- this._value = null;
24
- }
25
- }
26
- //# sourceMappingURL=lazy.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/lazy.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IAKrB,YAAY,MAAmB;QAJvB,kBAAa,GAAG,KAAK,CAAC;QACtB,WAAM,GAAgB,IAAI,CAAC;QAI/B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IACjC,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,IAAW,KAAK;QACZ,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,MAAW,CAAC;IAC5B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;CACJ","sourcesContent":["import type {Nullable, Supplier} from \"./types.js\";\n\n\n/**\n * Represents a lazy value that is created only when it is accessed for the first time.\n * @template T The type of the lazy value.\n */\nexport default class Lazy<T> {\n private _valueCreated = false;\n private _value: Nullable<T> = null;\n private readonly _factoryMethod: Supplier<T>;\n\n constructor(getter: Supplier<T>) {\n this._factoryMethod = getter;\n }\n\n get valueCreated(): boolean {\n return this._valueCreated;\n }\n\n public get value(): T {\n if (!this._valueCreated) {\n this._value = this._factoryMethod();\n this._valueCreated = true;\n }\n return this._value as T;\n }\n\n reset(): void {\n this._valueCreated = false;\n this._value = null;\n }\n}"]}
package/dist/web/math.js DELETED
@@ -1,33 +0,0 @@
1
- /**
2
- * Linearly interpolates a number between two ranges.
3
- *
4
- * @param {number} n - The number to interpolate.
5
- * @param {number} inMin - The minimum value of the input range.
6
- * @param {number} inMax - The maximum value of the input range.
7
- * @param {number} outMin - The minimum value of the output range.
8
- * @param {number} outMax - The maximum value of the output range.
9
- *
10
- * @return {number} - The interpolated value.
11
- */
12
- export function lerp(n, inMin, inMax, outMin, outMax) {
13
- if (inMax === inMin) {
14
- throw new Error("Input range cannot be zero");
15
- }
16
- return outMin + (outMax - outMin) * ((n - inMin) / (inMax - inMin));
17
- }
18
- /**
19
- * Clamps a number between a minimum and maximum value.
20
- *
21
- * @param {number} n - The value to be clamped.
22
- * @param {number} min - The minimum value.
23
- * @param {number} max - The maximum value.
24
- * @return {number} The clamped value.
25
- */
26
- export function clamp(n, min, max) {
27
- if (n <= min)
28
- return min;
29
- if (n >= max)
30
- return max;
31
- return n;
32
- }
33
- //# sourceMappingURL=math.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS,EAAE,KAAa,EAAE,KAAa,EAAE,MAAc,EAAE,MAAc;IACxF,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW;IACrD,IAAI,CAAC,IAAI,GAAG;QACR,OAAO,GAAG,CAAC;IACf,IAAI,CAAC,IAAI,GAAG;QACR,OAAO,GAAG,CAAC;IACf,OAAO,CAAC,CAAA;AACZ,CAAC","sourcesContent":["/**\n * Linearly interpolates a number between two ranges.\n *\n * @param {number} n - The number to interpolate.\n * @param {number} inMin - The minimum value of the input range.\n * @param {number} inMax - The maximum value of the input range.\n * @param {number} outMin - The minimum value of the output range.\n * @param {number} outMax - The maximum value of the output range.\n *\n * @return {number} - The interpolated value.\n */\nexport function lerp(n: number, inMin: number, inMax: number, outMin: number, outMax: number): number {\n if (inMax === inMin) {\n throw new Error(\"Input range cannot be zero\");\n }\n return outMin + (outMax - outMin) * ((n - inMin) / (inMax - inMin))\n}\n\n/**\n * Clamps a number between a minimum and maximum value.\n *\n * @param {number} n - The value to be clamped.\n * @param {number} min - The minimum value.\n * @param {number} max - The maximum value.\n * @return {number} The clamped value.\n */\nexport function clamp(n: number, min: number, max: number): number {\n if (n <= min)\n return min;\n if (n >= max)\n return max;\n return n\n}\n"]}
package/dist/web/order.js DELETED
@@ -1,7 +0,0 @@
1
- var Order;
2
- (function (Order) {
3
- Order["Ascending"] = "asc";
4
- Order["Descending"] = "desc";
5
- })(Order || (Order = {}));
6
- export default Order;
7
- //# sourceMappingURL=order.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/order.ts"],"names":[],"mappings":"AAAA,IAAK,KAGJ;AAHD,WAAK,KAAK;IACN,0BAAiB,CAAA;IACjB,4BAAmB,CAAA;AACvB,CAAC,EAHI,KAAK,KAAL,KAAK,QAGT;AAED,eAAe,KAAK,CAAC","sourcesContent":["enum Order {\n Ascending = \"asc\",\n Descending = \"desc\"\n}\n\nexport default Order;"]}
package/dist/web/parse.js DELETED
@@ -1,169 +0,0 @@
1
- // ============================================
2
- // HELPERS
3
- // ============================================
4
- function stripThousands(value, separator) {
5
- if (!separator)
6
- return value;
7
- return value.split(separator).join("");
8
- }
9
- function isValidInteger(value, radix) {
10
- if (!Number.isInteger(radix) || radix < 2 || radix > 36)
11
- return false;
12
- const signless = value.replace(/^[+-]/, "");
13
- if (signless === "")
14
- return false;
15
- const digits = "0123456789abcdefghijklmnopqrstuvwxyz".slice(0, radix);
16
- return [...signless.toLowerCase()].every((char) => digits.includes(char));
17
- }
18
- // ============================================
19
- // parseInteger
20
- // ============================================
21
- /**
22
- * Safely parses a value into an integer.
23
- * Returns `null` if the value cannot be parsed.
24
- *
25
- * - `null` or `undefined` → `null`
26
- * - `number` → returned as-is (floats are truncated)
27
- * - `string` → parsed with the given options
28
- *
29
- * @param value - The value to parse.
30
- * @param options - Optional parsing configuration.
31
- * @returns The parsed integer, or `null` on failure.
32
- *
33
- * @example
34
- * ```ts
35
- * parseInteger(42) // 42
36
- * parseInteger(3.7) // 3
37
- * parseInteger(null) // null
38
- * parseInteger(undefined) // null
39
- * parseInteger("42") // 42
40
- * parseInteger("1.234.567", { thousandsSeparator: "." }) // 1234567
41
- * parseInteger("FF", { radix: 16 }) // 255
42
- * parseInteger("abc") // null
43
- * ```
44
- */
45
- export function parseInteger(value, options = {}) {
46
- if (value === null || value === undefined)
47
- return null;
48
- if (typeof value === "number") {
49
- return Number.isFinite(value) ? Math.trunc(value) : null;
50
- }
51
- const { radix = 10, thousandsSeparator } = options;
52
- const cleaned = stripThousands(value.trim(), thousandsSeparator);
53
- if (cleaned === "")
54
- return null;
55
- if (!isValidInteger(cleaned, radix))
56
- return null;
57
- const parsed = Number.parseInt(cleaned, radix);
58
- return Number.isNaN(parsed) ? null : parsed;
59
- }
60
- // ============================================
61
- // parseDecimal
62
- // ============================================
63
- /**
64
- * Safely parses a value into a floating-point number.
65
- * Returns `null` if the value cannot be parsed.
66
- *
67
- * - `null` or `undefined` → `null`
68
- * - `number` → returned as-is (if finite)
69
- * - `string` → parsed with the given options
70
- *
71
- * Supports custom decimal and thousands separators, making it suitable
72
- * for both US (`1,234.56`) and EU (`1.234,56`) number formats.
73
- *
74
- * @param value - The value to parse.
75
- * @param options - Optional parsing configuration.
76
- * @returns The parsed float, or `null` on failure.
77
- *
78
- * @example
79
- * ```ts
80
- * parseDecimal(3.14) // 3.14
81
- * parseDecimal(null) // null
82
- * parseDecimal(undefined) // null
83
- * parseDecimal("3.14") // 3.14
84
- * parseDecimal("3,14", { decimalSeparator: "," }) // 3.14
85
- * parseDecimal("1.234,56", { decimalSeparator: ",", thousandsSeparator: "." }) // 1234.56
86
- * parseDecimal("abc") // null
87
- * ```
88
- */
89
- export function parseDecimal(value, options = {}) {
90
- if (value === null || value === undefined)
91
- return null;
92
- if (typeof value === "number") {
93
- return Number.isFinite(value) ? value : null;
94
- }
95
- const { decimalSeparator = ".", thousandsSeparator } = options;
96
- let cleaned = stripThousands(value.trim(), thousandsSeparator);
97
- if (cleaned === "")
98
- return null;
99
- if (decimalSeparator === ",") {
100
- const commaCount = (cleaned.match(/,/g) || []).length;
101
- if (commaCount > 1)
102
- return null;
103
- cleaned = cleaned.replace(",", ".");
104
- }
105
- if (!/^[+-]?\d+(\.\d+)?$/.test(cleaned))
106
- return null;
107
- const parsed = Number.parseFloat(cleaned);
108
- return Number.isNaN(parsed) || !Number.isFinite(parsed) ? null : parsed;
109
- }
110
- // ============================================
111
- // parseBoolean
112
- // ============================================
113
- const DEFAULT_TRUTHY = ["true", "1", "yes", "si", "sí", "on"];
114
- const DEFAULT_FALSY = ["false", "0", "no", "off"];
115
- /**
116
- * Safely parses a value into a boolean.
117
- * Returns `null` if the value cannot be interpreted as boolean.
118
- *
119
- * - `null` or `undefined` → `null`
120
- * - `boolean` → returned as-is
121
- * - `number` → `0` is `false`, any other finite number is `true`
122
- * - `string` → matched case-insensitively against known truthy/falsy values
123
- *
124
- * Default truthy: `"true"`, `"1"`, `"yes"`, `"si"`, `"sí"`, `"on"`
125
- * Default falsy: `"false"`, `"0"`, `"no"`, `"off"`
126
- *
127
- * @param value - The value to parse.
128
- * @param options - Optional parsing configuration.
129
- * @returns The parsed boolean, or `null` on failure.
130
- *
131
- * @example
132
- * ```ts
133
- * parseBoolean(true) // true
134
- * parseBoolean(false) // false
135
- * parseBoolean(1) // true
136
- * parseBoolean(0) // false
137
- * parseBoolean(null) // null
138
- * parseBoolean(undefined) // null
139
- * parseBoolean("yes") // true
140
- * parseBoolean("no") // false
141
- * parseBoolean("sí") // true
142
- * parseBoolean("TRUE") // true
143
- * parseBoolean("oui") // null
144
- * parseBoolean("oui", { extraTruthy: ["oui"] }) // true
145
- * parseBoolean("nein", { extraFalsy: ["nein"] }) // false
146
- * parseBoolean("whatever") // null
147
- * ```
148
- */
149
- export function parseBoolean(value, options = {}) {
150
- if (value === null || value === undefined)
151
- return null;
152
- if (typeof value === "boolean")
153
- return value;
154
- if (typeof value === "number") {
155
- return Number.isFinite(value) ? value !== 0 : null;
156
- }
157
- const { extraTruthy = [], extraFalsy = [] } = options;
158
- const normalized = value.trim().toLowerCase();
159
- if (normalized === "")
160
- return null;
161
- const truthy = [...DEFAULT_TRUTHY, ...extraTruthy.map((s) => s.toLowerCase())];
162
- const falsy = [...DEFAULT_FALSY, ...extraFalsy.map((s) => s.toLowerCase())];
163
- if (truthy.includes(normalized))
164
- return true;
165
- if (falsy.includes(normalized))
166
- return false;
167
- return null;
168
- }
169
- //# sourceMappingURL=parse.js.map