@ezez/utils 2.1.0 → 3.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 (157) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/index.d.ts +4 -0
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +4 -0
  5. package/dist/index.js.map +1 -1
  6. package/dist/replace.d.ts.map +1 -1
  7. package/dist/replace.js.map +1 -1
  8. package/dist/safe.d.ts.map +1 -1
  9. package/dist/safe.js.map +1 -1
  10. package/dist/sample.d.ts +3 -0
  11. package/dist/sample.d.ts.map +1 -0
  12. package/dist/sample.js +8 -0
  13. package/dist/sample.js.map +1 -0
  14. package/dist/samples.d.ts +3 -0
  15. package/dist/samples.d.ts.map +1 -0
  16. package/dist/samples.js +28 -0
  17. package/dist/samples.js.map +1 -0
  18. package/dist/shuffle.d.ts +3 -0
  19. package/dist/shuffle.d.ts.map +1 -0
  20. package/dist/shuffle.js +9 -0
  21. package/dist/shuffle.js.map +1 -0
  22. package/dist/toggle.d.ts +3 -0
  23. package/dist/toggle.d.ts.map +1 -0
  24. package/dist/toggle.js +15 -0
  25. package/dist/toggle.js.map +1 -0
  26. package/dist/waitFor.d.ts +7 -1
  27. package/dist/waitFor.d.ts.map +1 -1
  28. package/dist/waitFor.js +35 -10
  29. package/dist/waitFor.js.map +1 -1
  30. package/docs/assets/search.js +1 -1
  31. package/docs/functions/cap.html +9 -5
  32. package/docs/functions/capitalize.html +9 -5
  33. package/docs/functions/coalesce.html +9 -5
  34. package/docs/functions/compareArrays.html +9 -5
  35. package/docs/functions/compareProps.html +9 -5
  36. package/docs/functions/deserialize.html +9 -5
  37. package/docs/functions/ensureArray.html +9 -5
  38. package/docs/functions/ensureDate.html +9 -5
  39. package/docs/functions/ensureError.html +9 -5
  40. package/docs/functions/ensurePrefix.html +9 -5
  41. package/docs/functions/ensureSuffix.html +9 -5
  42. package/docs/functions/ensureTimestamp.html +9 -5
  43. package/docs/functions/escapeRegExp.html +9 -5
  44. package/docs/functions/formatDate.html +9 -5
  45. package/docs/functions/get.html +9 -5
  46. package/docs/functions/getMultiple.html +9 -5
  47. package/docs/functions/insertSeparator.html +9 -5
  48. package/docs/functions/isEmpty.html +9 -5
  49. package/docs/functions/isNumericString.html +9 -5
  50. package/docs/functions/isPlainObject.html +9 -5
  51. package/docs/functions/last.html +9 -5
  52. package/docs/functions/later-1.html +9 -5
  53. package/docs/functions/mapAsync.html +9 -5
  54. package/docs/functions/mapValues.html +9 -5
  55. package/docs/functions/match.html +9 -5
  56. package/docs/functions/merge.html +17 -13
  57. package/docs/functions/mostFrequent.html +9 -5
  58. package/docs/functions/noop.html +9 -5
  59. package/docs/functions/occurrences.html +9 -5
  60. package/docs/functions/omit.html +9 -5
  61. package/docs/functions/pick.html +9 -5
  62. package/docs/functions/pull.html +9 -5
  63. package/docs/functions/remove.html +9 -5
  64. package/docs/functions/removeCommonProperties.html +9 -5
  65. package/docs/functions/replace.html +9 -5
  66. package/docs/functions/replaceDeep.html +9 -5
  67. package/docs/functions/rethrow.html +9 -5
  68. package/docs/functions/round.html +9 -5
  69. package/docs/functions/safe.html +10 -6
  70. package/docs/functions/sample.html +146 -0
  71. package/docs/functions/samples.html +156 -0
  72. package/docs/functions/scale.html +9 -5
  73. package/docs/functions/seq.html +9 -5
  74. package/docs/functions/seqEarlyBreak.html +9 -5
  75. package/docs/functions/serialize.html +9 -5
  76. package/docs/functions/set.html +9 -5
  77. package/docs/functions/setImmutable.html +9 -5
  78. package/docs/functions/shuffle.html +146 -0
  79. package/docs/functions/sortBy.html +9 -5
  80. package/docs/functions/sortProps.html +9 -5
  81. package/docs/functions/stripPrefix.html +9 -5
  82. package/docs/functions/stripSuffix.html +9 -5
  83. package/docs/functions/throttle.html +9 -5
  84. package/docs/functions/toggle.html +151 -0
  85. package/docs/functions/truthy.html +9 -5
  86. package/docs/functions/unique.html +9 -5
  87. package/docs/functions/wait.html +9 -5
  88. package/docs/functions/waitFor.html +20 -18
  89. package/docs/functions/waitSync.html +9 -5
  90. package/docs/index.html +8 -4
  91. package/docs/interfaces/ComparePropsOptions.html +6 -6
  92. package/docs/interfaces/GetMultipleSource.html +9 -5
  93. package/docs/interfaces/GetSource.html +9 -5
  94. package/docs/interfaces/IsNumericStringOptions.html +9 -9
  95. package/docs/interfaces/OccurencesOptions.html +6 -6
  96. package/docs/interfaces/SetImmutableSource.html +9 -5
  97. package/docs/interfaces/SetSource.html +9 -5
  98. package/docs/interfaces/ThrottleOptions.html +7 -7
  99. package/docs/interfaces/ThrottledFunctionExtras.html +7 -7
  100. package/docs/modules.html +12 -4
  101. package/docs/pages/CHANGELOG.html +86 -46
  102. package/docs/pages/Introduction.html +8 -4
  103. package/docs/types/CustomDeserializers.html +9 -5
  104. package/docs/types/CustomSerializers.html +9 -5
  105. package/docs/types/Later.html +9 -5
  106. package/docs/types/MapValuesFn.html +9 -5
  107. package/docs/types/MatchCallback.html +9 -5
  108. package/docs/types/SeqEarlyBreaker.html +9 -5
  109. package/docs/types/SeqFn.html +9 -5
  110. package/docs/types/SeqFunctions.html +9 -5
  111. package/docs/types/SetImmutablePath.html +9 -5
  112. package/docs/types/ThrottledFunction.html +9 -5
  113. package/docs/variables/mapValuesUNSET.html +9 -5
  114. package/docs/variables/mergeUNSET.html +9 -5
  115. package/esm/index.d.ts +4 -0
  116. package/esm/index.d.ts.map +1 -1
  117. package/esm/index.js +4 -0
  118. package/esm/index.js.map +1 -1
  119. package/esm/replace.d.ts.map +1 -1
  120. package/esm/replace.js.map +1 -1
  121. package/esm/safe.d.ts.map +1 -1
  122. package/esm/safe.js.map +1 -1
  123. package/esm/sample.d.ts +3 -0
  124. package/esm/sample.d.ts.map +1 -0
  125. package/esm/sample.js +5 -0
  126. package/esm/sample.js.map +1 -0
  127. package/esm/samples.d.ts +3 -0
  128. package/esm/samples.d.ts.map +1 -0
  129. package/esm/samples.js +25 -0
  130. package/esm/samples.js.map +1 -0
  131. package/esm/shuffle.d.ts +3 -0
  132. package/esm/shuffle.d.ts.map +1 -0
  133. package/esm/shuffle.js +6 -0
  134. package/esm/shuffle.js.map +1 -0
  135. package/esm/toggle.d.ts +3 -0
  136. package/esm/toggle.d.ts.map +1 -0
  137. package/esm/toggle.js +12 -0
  138. package/esm/toggle.js.map +1 -0
  139. package/esm/waitFor.d.ts +7 -1
  140. package/esm/waitFor.d.ts.map +1 -1
  141. package/esm/waitFor.js +35 -10
  142. package/esm/waitFor.js.map +1 -1
  143. package/package.json +4 -4
  144. package/pnpm-lock.yaml +1162 -986
  145. package/src/index.ts +4 -0
  146. package/src/replace.ts +0 -1
  147. package/src/safe.ts +0 -1
  148. package/src/sample.spec.ts +31 -0
  149. package/src/sample.ts +11 -0
  150. package/src/samples.spec.ts +50 -0
  151. package/src/samples.ts +41 -0
  152. package/src/shuffle.spec.ts +39 -0
  153. package/src/shuffle.ts +13 -0
  154. package/src/toggle.spec.ts +43 -0
  155. package/src/toggle.ts +22 -0
  156. package/src/waitFor.spec.ts +141 -0
  157. package/src/waitFor.ts +69 -18
package/esm/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,OAAO,WAAY,MAAM,cAAc,OAAO,MAAM,EAAE,MAAM,CAAC,WAQlE,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
1
+ {"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,OAAO,WAAY,MAAM,cAAc,OAAO,MAAM,EAAE,MAAM,CAAC,WAOlE,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"replace.js","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkC,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACnB,OAAO,MAAM,CAAC;KACjB;IAED,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
1
+ {"version":3,"file":"replace.js","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkC,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACnB,OAAO,MAAM,CAAC;KACjB;IACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
package/esm/safe.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,iBAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAC7C,iBAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAqBhD,OAAO,EAAE,IAAI,EAAE,CAAC"}
1
+ {"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,iBAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAC7C,iBAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAoBhD,OAAO,EAAE,IAAI,EAAE,CAAC"}
package/esm/safe.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"safe.js","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAYA,SAAS,IAAI,CAAO,EAAW,EAAE,GAAO;IAEpC,IAAI;QACA,OAAO,EAAE,EAAE,CAAC;KACf;IACD,MAAM;QACF,OAAO,GAAG,CAAC;KACd;AACL,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}
1
+ {"version":3,"file":"safe.js","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAYA,SAAS,IAAI,CAAO,EAAW,EAAE,GAAO;IACpC,IAAI;QACA,OAAO,EAAE,EAAE,CAAC;KACf;IACD,MAAM;QACF,OAAO,GAAG,CAAC;KACd;AACL,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}
@@ -0,0 +1,3 @@
1
+ declare const sample: <T>(array: T[]) => T;
2
+ export { sample, };
3
+ //# sourceMappingURL=sample.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../src/sample.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,MAAM,sBAEX,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}
package/esm/sample.js ADDED
@@ -0,0 +1,5 @@
1
+ const sample = (array) => {
2
+ return array[Math.floor(Math.random() * array.length)];
3
+ };
4
+ export { sample, };
5
+ //# sourceMappingURL=sample.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sample.js","sourceRoot":"","sources":["../src/sample.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG,CAAI,KAAU,EAAK,EAAE;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAE,CAAC;AAC5D,CAAC,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}
@@ -0,0 +1,3 @@
1
+ declare const samples: <T>(array: T[], elementsToPick: number, allowShuffle?: boolean) => T[];
2
+ export { samples, };
3
+ //# sourceMappingURL=samples.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../src/samples.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,OAAO,kCAAmC,MAAM,gCA0BrD,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
package/esm/samples.js ADDED
@@ -0,0 +1,25 @@
1
+ const samples = (array, elementsToPick, allowShuffle = false) => {
2
+ if (elementsToPick < 0) {
3
+ throw new Error("elementsToPick must be a positive number");
4
+ }
5
+ if (elementsToPick === 0) {
6
+ return [];
7
+ }
8
+ if (!allowShuffle && elementsToPick >= array.length) {
9
+ return array;
10
+ }
11
+ const keys = Object.keys(array);
12
+ let picked = 0;
13
+ const result = [];
14
+ while (picked < elementsToPick) {
15
+ const indexOfKey = Math.floor(Math.random() * keys.length);
16
+ const indexOfArray = Number(keys[indexOfKey]);
17
+ const element = array[indexOfArray];
18
+ result.push(element);
19
+ keys.splice(indexOfKey, 1);
20
+ picked++;
21
+ }
22
+ return result;
23
+ };
24
+ export { samples, };
25
+ //# sourceMappingURL=samples.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"samples.js","sourceRoot":"","sources":["../src/samples.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,GAAG,CAAI,KAAU,EAAE,cAAsB,EAAE,YAAY,GAAG,KAAK,EAAO,EAAE;IACjF,IAAI,cAAc,GAAG,CAAC,EAAE;QACpB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;KAC/D;IACD,IAAI,cAAc,KAAK,CAAC,EAAE;QACtB,OAAO,EAAE,CAAC;KACb;IAED,IAAI,CAAC,YAAY,IAAI,cAAc,IAAI,KAAK,CAAC,MAAM,EAAE;QACjD,OAAO,KAAK,CAAC;KAChB;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,OAAO,MAAM,GAAG,cAAc,EAAE;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC3B,MAAM,EAAE,CAAC;KACZ;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
@@ -0,0 +1,3 @@
1
+ declare const shuffle: <T>(array: T[]) => T[];
2
+ export { shuffle, };
3
+ //# sourceMappingURL=shuffle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../src/shuffle.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,OAAO,wBAEZ,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
package/esm/shuffle.js ADDED
@@ -0,0 +1,6 @@
1
+ import { samples } from "./samples.js";
2
+ const shuffle = (array) => {
3
+ return samples(array, array.length, true);
4
+ };
5
+ export { shuffle, };
6
+ //# sourceMappingURL=shuffle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../src/shuffle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAMvC,MAAM,OAAO,GAAG,CAAI,KAAU,EAAO,EAAE;IACnC,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
@@ -0,0 +1,3 @@
1
+ declare const toggle: <T>(array: T[], item: T) => T[];
2
+ export { toggle, };
3
+ //# sourceMappingURL=toggle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../src/toggle.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,MAAM,iCAUX,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}
package/esm/toggle.js ADDED
@@ -0,0 +1,12 @@
1
+ const toggle = (array, item) => {
2
+ const index = array.findIndex((i) => Object.is(i, item));
3
+ if (index === -1) {
4
+ array.push(item);
5
+ }
6
+ else {
7
+ array.splice(index, 1);
8
+ }
9
+ return array;
10
+ };
11
+ export { toggle, };
12
+ //# sourceMappingURL=toggle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toggle.js","sourceRoot":"","sources":["../src/toggle.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,GAAG,CAAI,KAAU,EAAE,IAAO,EAAO,EAAE;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAEzD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACpB;SACI;QACD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KAC1B;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}
package/esm/waitFor.d.ts CHANGED
@@ -1,3 +1,9 @@
1
- declare const waitFor: <T>(fn: () => T, interval?: number, timeout?: number) => Promise<T>;
1
+ type MaybePromise<T> = T | Promise<T>;
2
+ type Options = {
3
+ interval?: number;
4
+ timeout?: number;
5
+ maxTries?: number;
6
+ };
7
+ declare const waitFor: <T>(fn: () => MaybePromise<T>, options?: Options) => Promise<T>;
2
8
  export { waitFor };
3
9
  //# sourceMappingURL=waitFor.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"waitFor.d.ts","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAcA,QAAA,MAAM,OAAO,qEA8BZ,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
1
+ {"version":3,"file":"waitFor.d.ts","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,KAAK,OAAO,GAAG;IAIX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAqBF,QAAA,MAAM,OAAO,2CAA2C,OAAO,eAsD9D,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
package/esm/waitFor.js CHANGED
@@ -1,30 +1,55 @@
1
+ import { noop } from "./noop.js";
1
2
  const DEFAULT_INTERVAL = 50;
2
- const waitFor = (fn, interval = DEFAULT_INTERVAL, timeout = Infinity) => {
3
+ const defaultOptions = {
4
+ interval: DEFAULT_INTERVAL,
5
+ timeout: Infinity,
6
+ maxTries: Infinity,
7
+ };
8
+ const waitFor = (fn, options = defaultOptions) => {
3
9
  return new Promise((resolve, reject) => {
4
10
  let intervalTimer, failTimer;
5
- if (isFinite(timeout)) {
11
+ const opts = { ...defaultOptions, ...options };
12
+ if (typeof opts.maxTries === "number" && opts.maxTries < 1) {
13
+ reject(new TypeError("[waitFor] maxTries must be greater than 0"));
14
+ return;
15
+ }
16
+ if (Number.isFinite(opts.timeout)) {
6
17
  failTimer = setTimeout(() => {
7
18
  reject(new Error("[waitFor] Timeout"));
8
- clearInterval(intervalTimer);
9
- }, timeout);
19
+ clearTimeout(intervalTimer);
20
+ }, opts.timeout);
10
21
  }
11
- intervalTimer = setInterval(() => {
22
+ let tries = 0;
23
+ const tryFn = (async () => {
12
24
  try {
13
- const result = fn();
14
- if (result) {
25
+ tries++;
26
+ const result = await fn();
27
+ if (result != null && result !== false) {
15
28
  clearTimeout(failTimer);
16
- clearInterval(intervalTimer);
29
+ clearTimeout(intervalTimer);
17
30
  resolve(result);
18
31
  }
32
+ else {
33
+ if (Number.isFinite(opts.maxTries) && tries >= opts.maxTries) {
34
+ clearTimeout(failTimer);
35
+ clearTimeout(intervalTimer);
36
+ reject(new Error("[waitFor] Max tries reached"));
37
+ return;
38
+ }
39
+ setTimeout(() => {
40
+ tryFn().catch(noop);
41
+ }, options.interval);
42
+ }
19
43
  }
20
44
  catch (error) {
21
45
  clearTimeout(failTimer);
22
- clearInterval(intervalTimer);
46
+ clearTimeout(intervalTimer);
23
47
  const e = new Error("[waitFor] check function threw an error");
24
48
  e.details = { error };
25
49
  reject(e);
26
50
  }
27
- }, interval);
51
+ });
52
+ tryFn().catch(noop);
28
53
  });
29
54
  };
30
55
  export { waitFor };
@@ -1 +1 @@
1
- {"version":3,"file":"waitFor.js","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAc5B,MAAM,OAAO,GAAG,CAAI,EAAW,EAAE,QAAQ,GAAG,gBAAgB,EAAE,OAAO,GAAG,QAAQ,EAAE,EAAE;IAChF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,aAAwB,EAAE,SAAmB,CAAC;QAElD,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE;YACnB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACvC,aAAa,CAAC,aAAa,CAAC,CAAC;YACjC,CAAC,EAAE,OAAO,CAAC,CAAC;SACf;QAED,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI;gBACA,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;gBACpB,IAAI,MAAM,EAAE;oBACR,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;iBACnB;aACJ;YACD,OAAO,KAAc,EAAE;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,aAAa,CAAC,aAAa,CAAC,CAAC;gBAE7B,MAAM,CAAC,GAAkC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBAC9F,CAAC,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,CAAC,CAAC,CAAC;aACb;QACL,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
1
+ {"version":3,"file":"waitFor.js","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAoB5B,MAAM,cAAc,GAAsB;IACtC,QAAQ,EAAE,gBAAgB;IAC1B,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;CACrB,CAAC;AAeF,MAAM,OAAO,GAAG,CAAI,EAAyB,EAAE,UAAmB,cAAc,EAAE,EAAE;IAChF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,aAAuB,EAAE,SAAmB,CAAC;QAEjD,MAAM,IAAI,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;QAC/C,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE;YACxD,MAAM,CAAC,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC,CAAC;YACnE,OAAO;SACV;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAC/B,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACvC,YAAY,CAAC,aAAa,CAAC,CAAC;YAChC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SACpB;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QAGd,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,IAAI;gBACA,KAAK,EAAE,CAAC;gBACR,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;gBAE1B,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE;oBACpC,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,YAAY,CAAC,aAAa,CAAC,CAAC;oBAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;iBACnB;qBACI;oBACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;wBAC1D,YAAY,CAAC,SAAS,CAAC,CAAC;wBACxB,YAAY,CAAC,aAAa,CAAC,CAAC;wBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;wBACjD,OAAO;qBACV;oBAED,UAAU,CAAC,GAAG,EAAE;wBACZ,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACxB,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;iBACxB;aACJ;YACD,OAAO,KAAc,EAAE;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAE5B,MAAM,CAAC,GAAkC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBAC9F,CAAC,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,CAAC,CAAC,CAAC;aACb;QACL,CAAC,CAAC,CAAC;QACH,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ezez/utils",
3
- "version": "2.1.0",
3
+ "version": "3.0.0",
4
4
  "repository": "https://github.com/dzek69/bottom-line.git",
5
5
  "author": "Jacek Nowacki @dzek69 <git-public@dzek.eu>",
6
6
  "license": "MIT",
@@ -35,9 +35,9 @@
35
35
  "module": "./esm/index.js",
36
36
  "type": "module",
37
37
  "devDependencies": {
38
- "@babel/core": "^7.22.20",
39
- "@babel/preset-env": "^7.22.20",
40
- "@babel/preset-typescript": "^7.22.15",
38
+ "@babel/core": "^7.24.3",
39
+ "@babel/preset-env": "^7.24.3",
40
+ "@babel/preset-typescript": "^7.24.1",
41
41
  "@dzek69/eslint-config-base": "^2.5.0",
42
42
  "@dzek69/eslint-config-import": "^1.3.0",
43
43
  "@dzek69/eslint-config-import-typescript": "^1.0.1",