ts-data-forge 5.0.1 → 5.1.1

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 (539) hide show
  1. package/README.md +101 -50
  2. package/dist/array/impl/array-utils-creation.d.mts +14 -0
  3. package/dist/array/impl/array-utils-creation.d.mts.map +1 -1
  4. package/dist/array/impl/array-utils-creation.mjs +12 -0
  5. package/dist/array/impl/array-utils-creation.mjs.map +1 -1
  6. package/dist/array/impl/array-utils-element-access.d.mts +10 -0
  7. package/dist/array/impl/array-utils-element-access.d.mts.map +1 -1
  8. package/dist/array/impl/array-utils-element-access.mjs +6 -0
  9. package/dist/array/impl/array-utils-element-access.mjs.map +1 -1
  10. package/dist/array/impl/array-utils-modification.d.mts +14 -0
  11. package/dist/array/impl/array-utils-modification.d.mts.map +1 -1
  12. package/dist/array/impl/array-utils-modification.mjs.map +1 -1
  13. package/dist/array/impl/array-utils-reducing-value.d.mts +34 -10
  14. package/dist/array/impl/array-utils-reducing-value.d.mts.map +1 -1
  15. package/dist/array/impl/array-utils-reducing-value.mjs.map +1 -1
  16. package/dist/array/impl/array-utils-search.d.mts +34 -4
  17. package/dist/array/impl/array-utils-search.d.mts.map +1 -1
  18. package/dist/array/impl/array-utils-search.mjs.map +1 -1
  19. package/dist/array/impl/array-utils-set-op.d.mts +20 -7
  20. package/dist/array/impl/array-utils-set-op.d.mts.map +1 -1
  21. package/dist/array/impl/array-utils-set-op.mjs +20 -7
  22. package/dist/array/impl/array-utils-set-op.mjs.map +1 -1
  23. package/dist/array/impl/array-utils-size.d.mts +5 -2
  24. package/dist/array/impl/array-utils-size.d.mts.map +1 -1
  25. package/dist/array/impl/array-utils-size.mjs +5 -2
  26. package/dist/array/impl/array-utils-size.mjs.map +1 -1
  27. package/dist/array/impl/array-utils-slice-clamped.d.mts +2 -0
  28. package/dist/array/impl/array-utils-slice-clamped.d.mts.map +1 -1
  29. package/dist/array/impl/array-utils-slice-clamped.mjs.map +1 -1
  30. package/dist/array/impl/array-utils-slicing.d.mts +17 -2
  31. package/dist/array/impl/array-utils-slicing.d.mts.map +1 -1
  32. package/dist/array/impl/array-utils-slicing.mjs +9 -2
  33. package/dist/array/impl/array-utils-slicing.mjs.map +1 -1
  34. package/dist/array/impl/array-utils-transformation.d.mts +27 -0
  35. package/dist/array/impl/array-utils-transformation.d.mts.map +1 -1
  36. package/dist/array/impl/array-utils-transformation.mjs +6 -0
  37. package/dist/array/impl/array-utils-transformation.mjs.map +1 -1
  38. package/dist/array/impl/array-utils-validation.d.mts +35 -18
  39. package/dist/array/impl/array-utils-validation.d.mts.map +1 -1
  40. package/dist/array/impl/array-utils-validation.mjs +25 -14
  41. package/dist/array/impl/array-utils-validation.mjs.map +1 -1
  42. package/dist/collections/imap-mapped.mjs.map +1 -1
  43. package/dist/collections/imap.d.mts +35 -15
  44. package/dist/collections/imap.d.mts.map +1 -1
  45. package/dist/collections/imap.mjs +5 -3
  46. package/dist/collections/imap.mjs.map +1 -1
  47. package/dist/collections/iset-mapped.d.mts +46 -19
  48. package/dist/collections/iset-mapped.d.mts.map +1 -1
  49. package/dist/collections/iset-mapped.mjs +9 -2
  50. package/dist/collections/iset-mapped.mjs.map +1 -1
  51. package/dist/collections/iset.d.mts +48 -19
  52. package/dist/collections/iset.d.mts.map +1 -1
  53. package/dist/collections/iset.mjs +9 -2
  54. package/dist/collections/iset.mjs.map +1 -1
  55. package/dist/collections/queue.d.mts +65 -25
  56. package/dist/collections/queue.d.mts.map +1 -1
  57. package/dist/collections/queue.mjs +13 -5
  58. package/dist/collections/queue.mjs.map +1 -1
  59. package/dist/collections/stack.d.mts +60 -25
  60. package/dist/collections/stack.d.mts.map +1 -1
  61. package/dist/collections/stack.mjs +12 -5
  62. package/dist/collections/stack.mjs.map +1 -1
  63. package/dist/entry-point.mjs +1 -1
  64. package/dist/functional/match.d.mts +1 -1
  65. package/dist/functional/match.d.mts.map +1 -1
  66. package/dist/functional/match.mjs.map +1 -1
  67. package/dist/functional/optional/impl/optional-expect-to-be.d.mts +3 -2
  68. package/dist/functional/optional/impl/optional-expect-to-be.d.mts.map +1 -1
  69. package/dist/functional/optional/impl/optional-expect-to-be.mjs.map +1 -1
  70. package/dist/functional/optional/impl/optional-filter.d.mts +3 -0
  71. package/dist/functional/optional/impl/optional-filter.d.mts.map +1 -1
  72. package/dist/functional/optional/impl/optional-filter.mjs.map +1 -1
  73. package/dist/functional/optional/impl/optional-flat-map.d.mts +2 -0
  74. package/dist/functional/optional/impl/optional-flat-map.d.mts.map +1 -1
  75. package/dist/functional/optional/impl/optional-flat-map.mjs.map +1 -1
  76. package/dist/functional/optional/impl/optional-from-nullable.d.mts +2 -0
  77. package/dist/functional/optional/impl/optional-from-nullable.d.mts.map +1 -1
  78. package/dist/functional/optional/impl/optional-from-nullable.mjs +2 -0
  79. package/dist/functional/optional/impl/optional-from-nullable.mjs.map +1 -1
  80. package/dist/functional/optional/impl/optional-is-none.d.mts +1 -1
  81. package/dist/functional/optional/impl/optional-is-none.mjs +1 -1
  82. package/dist/functional/optional/impl/optional-is-optional.d.mts +4 -2
  83. package/dist/functional/optional/impl/optional-is-optional.d.mts.map +1 -1
  84. package/dist/functional/optional/impl/optional-is-optional.mjs +4 -2
  85. package/dist/functional/optional/impl/optional-is-optional.mjs.map +1 -1
  86. package/dist/functional/optional/impl/optional-is-some.d.mts +2 -1
  87. package/dist/functional/optional/impl/optional-is-some.d.mts.map +1 -1
  88. package/dist/functional/optional/impl/optional-is-some.mjs +2 -1
  89. package/dist/functional/optional/impl/optional-is-some.mjs.map +1 -1
  90. package/dist/functional/optional/impl/optional-map.d.mts +2 -0
  91. package/dist/functional/optional/impl/optional-map.d.mts.map +1 -1
  92. package/dist/functional/optional/impl/optional-map.mjs.map +1 -1
  93. package/dist/functional/optional/impl/optional-none.d.mts +4 -2
  94. package/dist/functional/optional/impl/optional-none.d.mts.map +1 -1
  95. package/dist/functional/optional/impl/optional-none.mjs +4 -2
  96. package/dist/functional/optional/impl/optional-none.mjs.map +1 -1
  97. package/dist/functional/optional/impl/optional-or-else.d.mts +4 -0
  98. package/dist/functional/optional/impl/optional-or-else.d.mts.map +1 -1
  99. package/dist/functional/optional/impl/optional-or-else.mjs.map +1 -1
  100. package/dist/functional/optional/impl/optional-some.d.mts +5 -3
  101. package/dist/functional/optional/impl/optional-some.d.mts.map +1 -1
  102. package/dist/functional/optional/impl/optional-some.mjs +4 -2
  103. package/dist/functional/optional/impl/optional-some.mjs.map +1 -1
  104. package/dist/functional/optional/impl/optional-to-nullable.d.mts +4 -2
  105. package/dist/functional/optional/impl/optional-to-nullable.d.mts.map +1 -1
  106. package/dist/functional/optional/impl/optional-to-nullable.mjs +4 -2
  107. package/dist/functional/optional/impl/optional-to-nullable.mjs.map +1 -1
  108. package/dist/functional/optional/impl/optional-unwrap-or.d.mts +7 -4
  109. package/dist/functional/optional/impl/optional-unwrap-or.d.mts.map +1 -1
  110. package/dist/functional/optional/impl/optional-unwrap-or.mjs.map +1 -1
  111. package/dist/functional/optional/impl/optional-unwrap-throw.d.mts +2 -1
  112. package/dist/functional/optional/impl/optional-unwrap-throw.d.mts.map +1 -1
  113. package/dist/functional/optional/impl/optional-unwrap-throw.mjs +2 -1
  114. package/dist/functional/optional/impl/optional-unwrap-throw.mjs.map +1 -1
  115. package/dist/functional/optional/impl/optional-unwrap.d.mts +4 -2
  116. package/dist/functional/optional/impl/optional-unwrap.d.mts.map +1 -1
  117. package/dist/functional/optional/impl/optional-unwrap.mjs.map +1 -1
  118. package/dist/functional/optional/impl/optional-zip.d.mts +3 -1
  119. package/dist/functional/optional/impl/optional-zip.d.mts.map +1 -1
  120. package/dist/functional/optional/impl/optional-zip.mjs +3 -1
  121. package/dist/functional/optional/impl/optional-zip.mjs.map +1 -1
  122. package/dist/functional/pipe.d.mts +2 -2
  123. package/dist/functional/result/impl/result-err.d.mts +4 -2
  124. package/dist/functional/result/impl/result-err.d.mts.map +1 -1
  125. package/dist/functional/result/impl/result-err.mjs +3 -1
  126. package/dist/functional/result/impl/result-err.mjs.map +1 -1
  127. package/dist/functional/result/impl/result-expect-to-be.d.mts +3 -2
  128. package/dist/functional/result/impl/result-expect-to-be.d.mts.map +1 -1
  129. package/dist/functional/result/impl/result-expect-to-be.mjs.map +1 -1
  130. package/dist/functional/result/impl/result-flat-map.d.mts +5 -0
  131. package/dist/functional/result/impl/result-flat-map.d.mts.map +1 -1
  132. package/dist/functional/result/impl/result-flat-map.mjs.map +1 -1
  133. package/dist/functional/result/impl/result-fold.d.mts +4 -0
  134. package/dist/functional/result/impl/result-fold.d.mts.map +1 -1
  135. package/dist/functional/result/impl/result-fold.mjs.map +1 -1
  136. package/dist/functional/result/impl/result-from-promise.d.mts +4 -1
  137. package/dist/functional/result/impl/result-from-promise.d.mts.map +1 -1
  138. package/dist/functional/result/impl/result-from-promise.mjs +4 -1
  139. package/dist/functional/result/impl/result-from-promise.mjs.map +1 -1
  140. package/dist/functional/result/impl/result-from-throwable.d.mts +3 -1
  141. package/dist/functional/result/impl/result-from-throwable.d.mts.map +1 -1
  142. package/dist/functional/result/impl/result-from-throwable.mjs +3 -1
  143. package/dist/functional/result/impl/result-from-throwable.mjs.map +1 -1
  144. package/dist/functional/result/impl/result-is-err.d.mts +4 -2
  145. package/dist/functional/result/impl/result-is-err.d.mts.map +1 -1
  146. package/dist/functional/result/impl/result-is-err.mjs +4 -2
  147. package/dist/functional/result/impl/result-is-err.mjs.map +1 -1
  148. package/dist/functional/result/impl/result-is-ok.d.mts +4 -2
  149. package/dist/functional/result/impl/result-is-ok.d.mts.map +1 -1
  150. package/dist/functional/result/impl/result-is-ok.mjs +4 -2
  151. package/dist/functional/result/impl/result-is-ok.mjs.map +1 -1
  152. package/dist/functional/result/impl/result-is-result.d.mts +7 -3
  153. package/dist/functional/result/impl/result-is-result.d.mts.map +1 -1
  154. package/dist/functional/result/impl/result-is-result.mjs +7 -3
  155. package/dist/functional/result/impl/result-is-result.mjs.map +1 -1
  156. package/dist/functional/result/impl/result-map-err.d.mts +3 -0
  157. package/dist/functional/result/impl/result-map-err.d.mts.map +1 -1
  158. package/dist/functional/result/impl/result-map-err.mjs.map +1 -1
  159. package/dist/functional/result/impl/result-map.d.mts +4 -0
  160. package/dist/functional/result/impl/result-map.d.mts.map +1 -1
  161. package/dist/functional/result/impl/result-map.mjs.map +1 -1
  162. package/dist/functional/result/impl/result-ok.d.mts +4 -2
  163. package/dist/functional/result/impl/result-ok.d.mts.map +1 -1
  164. package/dist/functional/result/impl/result-ok.mjs +3 -1
  165. package/dist/functional/result/impl/result-ok.mjs.map +1 -1
  166. package/dist/functional/result/impl/result-or-else.d.mts +4 -0
  167. package/dist/functional/result/impl/result-or-else.d.mts.map +1 -1
  168. package/dist/functional/result/impl/result-or-else.mjs.map +1 -1
  169. package/dist/functional/result/impl/result-swap.d.mts +2 -0
  170. package/dist/functional/result/impl/result-swap.d.mts.map +1 -1
  171. package/dist/functional/result/impl/result-swap.mjs +2 -0
  172. package/dist/functional/result/impl/result-swap.mjs.map +1 -1
  173. package/dist/functional/result/impl/result-to-optional.d.mts +2 -0
  174. package/dist/functional/result/impl/result-to-optional.d.mts.map +1 -1
  175. package/dist/functional/result/impl/result-to-optional.mjs +2 -0
  176. package/dist/functional/result/impl/result-to-optional.mjs.map +1 -1
  177. package/dist/functional/result/impl/result-unwrap-err-or.d.mts +7 -4
  178. package/dist/functional/result/impl/result-unwrap-err-or.d.mts.map +1 -1
  179. package/dist/functional/result/impl/result-unwrap-err-or.mjs.map +1 -1
  180. package/dist/functional/result/impl/result-unwrap-err-throw.d.mts +3 -1
  181. package/dist/functional/result/impl/result-unwrap-err-throw.d.mts.map +1 -1
  182. package/dist/functional/result/impl/result-unwrap-err-throw.mjs +3 -1
  183. package/dist/functional/result/impl/result-unwrap-err-throw.mjs.map +1 -1
  184. package/dist/functional/result/impl/result-unwrap-err.d.mts +3 -2
  185. package/dist/functional/result/impl/result-unwrap-err.d.mts.map +1 -1
  186. package/dist/functional/result/impl/result-unwrap-err.mjs +3 -2
  187. package/dist/functional/result/impl/result-unwrap-err.mjs.map +1 -1
  188. package/dist/functional/result/impl/result-unwrap-ok-or.d.mts +7 -4
  189. package/dist/functional/result/impl/result-unwrap-ok-or.d.mts.map +1 -1
  190. package/dist/functional/result/impl/result-unwrap-ok-or.mjs.map +1 -1
  191. package/dist/functional/result/impl/result-unwrap-ok.d.mts +3 -2
  192. package/dist/functional/result/impl/result-unwrap-ok.d.mts.map +1 -1
  193. package/dist/functional/result/impl/result-unwrap-ok.mjs.map +1 -1
  194. package/dist/functional/result/impl/result-unwrap-throw.d.mts +3 -1
  195. package/dist/functional/result/impl/result-unwrap-throw.d.mts.map +1 -1
  196. package/dist/functional/result/impl/result-unwrap-throw.mjs +3 -1
  197. package/dist/functional/result/impl/result-unwrap-throw.mjs.map +1 -1
  198. package/dist/functional/result/impl/result-zip.d.mts +3 -1
  199. package/dist/functional/result/impl/result-zip.d.mts.map +1 -1
  200. package/dist/functional/result/impl/result-zip.mjs +3 -1
  201. package/dist/functional/result/impl/result-zip.mjs.map +1 -1
  202. package/dist/functional/ternary-result/impl/ternary-result-err.d.mts +3 -2
  203. package/dist/functional/ternary-result/impl/ternary-result-err.d.mts.map +1 -1
  204. package/dist/functional/ternary-result/impl/ternary-result-err.mjs +2 -1
  205. package/dist/functional/ternary-result/impl/ternary-result-err.mjs.map +1 -1
  206. package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.d.mts +1 -0
  207. package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.d.mts.map +1 -1
  208. package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.mjs.map +1 -1
  209. package/dist/functional/ternary-result/impl/ternary-result-flat-map.d.mts +4 -0
  210. package/dist/functional/ternary-result/impl/ternary-result-flat-map.d.mts.map +1 -1
  211. package/dist/functional/ternary-result/impl/ternary-result-flat-map.mjs.map +1 -1
  212. package/dist/functional/ternary-result/impl/ternary-result-fold.d.mts +2 -0
  213. package/dist/functional/ternary-result/impl/ternary-result-fold.d.mts.map +1 -1
  214. package/dist/functional/ternary-result/impl/ternary-result-fold.mjs.map +1 -1
  215. package/dist/functional/ternary-result/impl/ternary-result-from-promise.d.mts +3 -1
  216. package/dist/functional/ternary-result/impl/ternary-result-from-promise.d.mts.map +1 -1
  217. package/dist/functional/ternary-result/impl/ternary-result-from-promise.mjs +3 -1
  218. package/dist/functional/ternary-result/impl/ternary-result-from-promise.mjs.map +1 -1
  219. package/dist/functional/ternary-result/impl/ternary-result-from-throwable.d.mts +3 -1
  220. package/dist/functional/ternary-result/impl/ternary-result-from-throwable.d.mts.map +1 -1
  221. package/dist/functional/ternary-result/impl/ternary-result-from-throwable.mjs +3 -1
  222. package/dist/functional/ternary-result/impl/ternary-result-from-throwable.mjs.map +1 -1
  223. package/dist/functional/ternary-result/impl/ternary-result-is-ok.d.mts +1 -0
  224. package/dist/functional/ternary-result/impl/ternary-result-is-ok.d.mts.map +1 -1
  225. package/dist/functional/ternary-result/impl/ternary-result-is-ok.mjs +1 -0
  226. package/dist/functional/ternary-result/impl/ternary-result-is-ok.mjs.map +1 -1
  227. package/dist/functional/ternary-result/impl/ternary-result-is-ternary-result.d.mts +7 -3
  228. package/dist/functional/ternary-result/impl/ternary-result-is-ternary-result.d.mts.map +1 -1
  229. package/dist/functional/ternary-result/impl/ternary-result-is-ternary-result.mjs +7 -3
  230. package/dist/functional/ternary-result/impl/ternary-result-is-ternary-result.mjs.map +1 -1
  231. package/dist/functional/ternary-result/impl/ternary-result-is-warn.d.mts +1 -0
  232. package/dist/functional/ternary-result/impl/ternary-result-is-warn.d.mts.map +1 -1
  233. package/dist/functional/ternary-result/impl/ternary-result-is-warn.mjs +1 -0
  234. package/dist/functional/ternary-result/impl/ternary-result-is-warn.mjs.map +1 -1
  235. package/dist/functional/ternary-result/impl/ternary-result-map-err.d.mts +3 -0
  236. package/dist/functional/ternary-result/impl/ternary-result-map-err.d.mts.map +1 -1
  237. package/dist/functional/ternary-result/impl/ternary-result-map-err.mjs.map +1 -1
  238. package/dist/functional/ternary-result/impl/ternary-result-map-warn.d.mts +3 -0
  239. package/dist/functional/ternary-result/impl/ternary-result-map-warn.d.mts.map +1 -1
  240. package/dist/functional/ternary-result/impl/ternary-result-map-warn.mjs.map +1 -1
  241. package/dist/functional/ternary-result/impl/ternary-result-map.d.mts +6 -0
  242. package/dist/functional/ternary-result/impl/ternary-result-map.d.mts.map +1 -1
  243. package/dist/functional/ternary-result/impl/ternary-result-map.mjs.map +1 -1
  244. package/dist/functional/ternary-result/impl/ternary-result-ok.d.mts +1 -1
  245. package/dist/functional/ternary-result/impl/ternary-result-ok.d.mts.map +1 -1
  246. package/dist/functional/ternary-result/impl/ternary-result-ok.mjs.map +1 -1
  247. package/dist/functional/ternary-result/impl/ternary-result-or-else.d.mts +2 -0
  248. package/dist/functional/ternary-result/impl/ternary-result-or-else.d.mts.map +1 -1
  249. package/dist/functional/ternary-result/impl/ternary-result-or-else.mjs.map +1 -1
  250. package/dist/functional/ternary-result/impl/ternary-result-to-optional.d.mts +2 -0
  251. package/dist/functional/ternary-result/impl/ternary-result-to-optional.d.mts.map +1 -1
  252. package/dist/functional/ternary-result/impl/ternary-result-to-optional.mjs +2 -0
  253. package/dist/functional/ternary-result/impl/ternary-result-to-optional.mjs.map +1 -1
  254. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-or.d.mts +2 -0
  255. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-or.d.mts.map +1 -1
  256. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-or.mjs.map +1 -1
  257. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-throw.d.mts +1 -0
  258. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-throw.d.mts.map +1 -1
  259. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-throw.mjs +1 -0
  260. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err-throw.mjs.map +1 -1
  261. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err.d.mts +2 -0
  262. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err.d.mts.map +1 -1
  263. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err.mjs +2 -0
  264. package/dist/functional/ternary-result/impl/ternary-result-unwrap-err.mjs.map +1 -1
  265. package/dist/functional/ternary-result/impl/ternary-result-unwrap-ok-or.d.mts +2 -0
  266. package/dist/functional/ternary-result/impl/ternary-result-unwrap-ok-or.d.mts.map +1 -1
  267. package/dist/functional/ternary-result/impl/ternary-result-unwrap-ok-or.mjs.map +1 -1
  268. package/dist/functional/ternary-result/impl/ternary-result-unwrap-ok.d.mts +2 -0
  269. package/dist/functional/ternary-result/impl/ternary-result-unwrap-ok.d.mts.map +1 -1
  270. package/dist/functional/ternary-result/impl/ternary-result-unwrap-ok.mjs.map +1 -1
  271. package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.d.mts +1 -0
  272. package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.d.mts.map +1 -1
  273. package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.mjs +1 -0
  274. package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.mjs.map +1 -1
  275. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-or.d.mts +2 -0
  276. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-or.d.mts.map +1 -1
  277. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-or.mjs.map +1 -1
  278. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-throw.d.mts +1 -0
  279. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-throw.d.mts.map +1 -1
  280. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-throw.mjs +1 -0
  281. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn-throw.mjs.map +1 -1
  282. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn.d.mts +2 -0
  283. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn.d.mts.map +1 -1
  284. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn.mjs +2 -0
  285. package/dist/functional/ternary-result/impl/ternary-result-unwrap-warn.mjs.map +1 -1
  286. package/dist/functional/ternary-result/impl/ternary-result-warn.d.mts +1 -1
  287. package/dist/functional/ternary-result/impl/ternary-result-warn.d.mts.map +1 -1
  288. package/dist/functional/ternary-result/impl/ternary-result-warn.mjs.map +1 -1
  289. package/dist/functional/ternary-result/impl/ternary-result-zip.d.mts +4 -0
  290. package/dist/functional/ternary-result/impl/ternary-result-zip.d.mts.map +1 -1
  291. package/dist/functional/ternary-result/impl/ternary-result-zip.mjs +4 -0
  292. package/dist/functional/ternary-result/impl/ternary-result-zip.mjs.map +1 -1
  293. package/dist/globals.d.mts +12 -1
  294. package/dist/guard/has-key.d.mts +6 -3
  295. package/dist/guard/has-key.d.mts.map +1 -1
  296. package/dist/guard/has-key.mjs +2 -2
  297. package/dist/guard/index.mjs +1 -1
  298. package/dist/guard/is-record.d.mts +31 -0
  299. package/dist/guard/is-record.d.mts.map +1 -1
  300. package/dist/guard/is-record.mjs +32 -1
  301. package/dist/guard/is-record.mjs.map +1 -1
  302. package/dist/guard/is-type.d.mts +3 -0
  303. package/dist/guard/is-type.d.mts.map +1 -1
  304. package/dist/guard/is-type.mjs +3 -0
  305. package/dist/guard/is-type.mjs.map +1 -1
  306. package/dist/guard/key-is-in.d.mts +3 -2
  307. package/dist/guard/key-is-in.d.mts.map +1 -1
  308. package/dist/guard/key-is-in.mjs +3 -2
  309. package/dist/guard/key-is-in.mjs.map +1 -1
  310. package/dist/index.mjs +1 -1
  311. package/dist/iterator/range.d.mts +4 -0
  312. package/dist/iterator/range.d.mts.map +1 -1
  313. package/dist/iterator/range.mjs +1 -0
  314. package/dist/iterator/range.mjs.map +1 -1
  315. package/dist/json/json.d.mts +42 -21
  316. package/dist/json/json.d.mts.map +1 -1
  317. package/dist/json/json.mjs +42 -21
  318. package/dist/json/json.mjs.map +1 -1
  319. package/dist/number/branded-types/int.d.mts +33 -19
  320. package/dist/number/branded-types/int.d.mts.map +1 -1
  321. package/dist/number/branded-types/int.mjs +33 -19
  322. package/dist/number/branded-types/int.mjs.map +1 -1
  323. package/dist/number/branded-types/non-zero-safe-int.mjs +2 -2
  324. package/dist/number/branded-types/positive-int.d.mts +34 -20
  325. package/dist/number/branded-types/positive-int.d.mts.map +1 -1
  326. package/dist/number/branded-types/positive-int.mjs +34 -20
  327. package/dist/number/branded-types/positive-int.mjs.map +1 -1
  328. package/dist/number/branded-types/positive-safe-int.d.mts +47 -26
  329. package/dist/number/branded-types/positive-safe-int.d.mts.map +1 -1
  330. package/dist/number/branded-types/positive-safe-int.mjs +48 -27
  331. package/dist/number/branded-types/positive-safe-int.mjs.map +1 -1
  332. package/dist/number/branded-types/safe-int.d.mts +48 -27
  333. package/dist/number/branded-types/safe-int.d.mts.map +1 -1
  334. package/dist/number/branded-types/safe-int.mjs +50 -29
  335. package/dist/number/branded-types/safe-int.mjs.map +1 -1
  336. package/dist/number/branded-types/safe-uint.mjs +1 -1
  337. package/dist/number/branded-types/uint.d.mts +31 -19
  338. package/dist/number/branded-types/uint.d.mts.map +1 -1
  339. package/dist/number/branded-types/uint.mjs +31 -19
  340. package/dist/number/branded-types/uint.mjs.map +1 -1
  341. package/dist/number/num.d.mts +29 -20
  342. package/dist/number/num.d.mts.map +1 -1
  343. package/dist/number/num.mjs +24 -17
  344. package/dist/number/num.mjs.map +1 -1
  345. package/dist/number/refined-number-utils.d.mts +33 -11
  346. package/dist/number/refined-number-utils.d.mts.map +1 -1
  347. package/dist/number/refined-number-utils.mjs +33 -11
  348. package/dist/number/refined-number-utils.mjs.map +1 -1
  349. package/dist/object/object.d.mts +12 -3
  350. package/dist/object/object.d.mts.map +1 -1
  351. package/dist/object/object.mjs +10 -3
  352. package/dist/object/object.mjs.map +1 -1
  353. package/dist/others/map-nullable.mjs.map +1 -1
  354. package/dist/others/tuple.d.mts +14 -3
  355. package/dist/others/tuple.d.mts.map +1 -1
  356. package/dist/others/tuple.mjs +14 -3
  357. package/dist/others/tuple.mjs.map +1 -1
  358. package/dist/others/unknown-to-string.d.mts.map +1 -1
  359. package/dist/others/unknown-to-string.mjs.map +1 -1
  360. package/dist/promise/promise.d.mts +8 -4
  361. package/dist/promise/promise.d.mts.map +1 -1
  362. package/dist/promise/promise.mjs +8 -4
  363. package/dist/promise/promise.mjs.map +1 -1
  364. package/package.json +26 -28
  365. package/src/array/impl/array-utils-creation.mts +20 -0
  366. package/src/array/impl/array-utils-creation.test.mts +72 -1
  367. package/src/array/impl/array-utils-element-access.mts +13 -0
  368. package/src/array/impl/array-utils-element-access.test.mts +36 -15
  369. package/src/array/impl/array-utils-iterators.test.mts +17 -0
  370. package/src/array/impl/array-utils-modification.mts +78 -19
  371. package/src/array/impl/array-utils-modification.test.mts +75 -0
  372. package/src/array/impl/array-utils-overload-type-error.test.mts +19 -0
  373. package/src/array/impl/array-utils-reducing-value.mts +61 -16
  374. package/src/array/impl/array-utils-reducing-value.test.mts +107 -25
  375. package/src/array/impl/array-utils-search.mts +57 -4
  376. package/src/array/impl/array-utils-search.test.mts +61 -10
  377. package/src/array/impl/array-utils-set-op.mts +26 -7
  378. package/src/array/impl/array-utils-set-op.test.mts +129 -13
  379. package/src/array/impl/array-utils-size.mts +5 -2
  380. package/src/array/impl/array-utils-size.test.mts +1 -0
  381. package/src/array/impl/array-utils-slice-clamped.mts +7 -0
  382. package/src/array/impl/array-utils-slice-clamped.test.mts +20 -0
  383. package/src/array/impl/array-utils-slicing.mts +29 -2
  384. package/src/array/impl/array-utils-slicing.test.mts +57 -0
  385. package/src/array/impl/array-utils-transformation.mts +58 -0
  386. package/src/array/impl/array-utils-transformation.test.mts +115 -3
  387. package/src/array/impl/array-utils-validation.mts +41 -18
  388. package/src/array/impl/array-utils-validation.test.mts +176 -78
  389. package/src/array/impl/array.test.mts +18 -6
  390. package/src/collections/imap-mapped.mts +11 -0
  391. package/src/collections/imap-mapped.test.mts +86 -18
  392. package/src/collections/imap.mts +47 -15
  393. package/src/collections/imap.test.mts +137 -31
  394. package/src/collections/iset-mapped.mts +54 -19
  395. package/src/collections/iset-mapped.test.mts +163 -52
  396. package/src/collections/iset.mts +53 -19
  397. package/src/collections/iset.test.mts +323 -130
  398. package/src/collections/queue.mts +78 -25
  399. package/src/collections/queue.test.mts +65 -35
  400. package/src/collections/stack.mts +67 -25
  401. package/src/collections/stack.test.mts +59 -15
  402. package/src/functional/match.mts +17 -1
  403. package/src/functional/match.test.mts +2 -0
  404. package/src/functional/optional/impl/optional-expect-to-be.mts +5 -2
  405. package/src/functional/optional/impl/optional-filter.mts +6 -0
  406. package/src/functional/optional/impl/optional-flat-map.mts +4 -0
  407. package/src/functional/optional/impl/optional-from-nullable.mts +2 -0
  408. package/src/functional/optional/impl/optional-is-none.mts +1 -1
  409. package/src/functional/optional/impl/optional-is-optional.mts +4 -2
  410. package/src/functional/optional/impl/optional-is-some.mts +2 -1
  411. package/src/functional/optional/impl/optional-map.mts +5 -0
  412. package/src/functional/optional/impl/optional-none.mts +4 -2
  413. package/src/functional/optional/impl/optional-or-else.mts +6 -0
  414. package/src/functional/optional/impl/optional-some.mts +5 -3
  415. package/src/functional/optional/impl/optional-to-nullable.mts +4 -2
  416. package/src/functional/optional/impl/optional-unwrap-or.mts +9 -4
  417. package/src/functional/optional/impl/optional-unwrap-throw.mts +2 -1
  418. package/src/functional/optional/impl/optional-unwrap.mts +4 -2
  419. package/src/functional/optional/impl/optional-zip.mts +3 -1
  420. package/src/functional/optional.test.mts +126 -54
  421. package/src/functional/pipe.mts +2 -2
  422. package/src/functional/pipe.test.mts +7 -4
  423. package/src/functional/result/impl/result-err.mts +4 -2
  424. package/src/functional/result/impl/result-expect-to-be.mts +5 -2
  425. package/src/functional/result/impl/result-flat-map.mts +7 -0
  426. package/src/functional/result/impl/result-fold.mts +6 -0
  427. package/src/functional/result/impl/result-from-promise.mts +4 -1
  428. package/src/functional/result/impl/result-from-throwable.mts +5 -1
  429. package/src/functional/result/impl/result-is-err.mts +4 -2
  430. package/src/functional/result/impl/result-is-ok.mts +4 -2
  431. package/src/functional/result/impl/result-is-result.mts +7 -3
  432. package/src/functional/result/impl/result-map-err.mts +5 -0
  433. package/src/functional/result/impl/result-map.mts +6 -0
  434. package/src/functional/result/impl/result-ok.mts +4 -2
  435. package/src/functional/result/impl/result-or-else.mts +6 -0
  436. package/src/functional/result/impl/result-swap.mts +2 -0
  437. package/src/functional/result/impl/result-to-optional.mts +2 -0
  438. package/src/functional/result/impl/result-unwrap-err-or.mts +9 -4
  439. package/src/functional/result/impl/result-unwrap-err-throw.mts +3 -1
  440. package/src/functional/result/impl/result-unwrap-err.mts +3 -2
  441. package/src/functional/result/impl/result-unwrap-ok-or.mts +9 -4
  442. package/src/functional/result/impl/result-unwrap-ok.mts +4 -2
  443. package/src/functional/result/impl/result-unwrap-throw.mts +3 -1
  444. package/src/functional/result/impl/result-zip.mts +3 -1
  445. package/src/functional/result.test.mts +182 -152
  446. package/src/functional/ternary-result/impl/ternary-result-err.mts +3 -2
  447. package/src/functional/ternary-result/impl/ternary-result-expect-to-be.mts +4 -0
  448. package/src/functional/ternary-result/impl/ternary-result-flat-map.mts +7 -0
  449. package/src/functional/ternary-result/impl/ternary-result-fold.mts +5 -0
  450. package/src/functional/ternary-result/impl/ternary-result-from-promise.mts +3 -1
  451. package/src/functional/ternary-result/impl/ternary-result-from-throwable.mts +4 -1
  452. package/src/functional/ternary-result/impl/ternary-result-is-ok.mts +1 -0
  453. package/src/functional/ternary-result/impl/ternary-result-is-ternary-result.mts +7 -3
  454. package/src/functional/ternary-result/impl/ternary-result-is-warn.mts +1 -0
  455. package/src/functional/ternary-result/impl/ternary-result-map-err.mts +6 -0
  456. package/src/functional/ternary-result/impl/ternary-result-map-warn.mts +6 -0
  457. package/src/functional/ternary-result/impl/ternary-result-map.mts +9 -0
  458. package/src/functional/ternary-result/impl/ternary-result-ok.mts +1 -1
  459. package/src/functional/ternary-result/impl/ternary-result-or-else.mts +5 -0
  460. package/src/functional/ternary-result/impl/ternary-result-to-optional.mts +2 -0
  461. package/src/functional/ternary-result/impl/ternary-result-unwrap-err-or.mts +5 -0
  462. package/src/functional/ternary-result/impl/ternary-result-unwrap-err-throw.mts +1 -0
  463. package/src/functional/ternary-result/impl/ternary-result-unwrap-err.mts +2 -0
  464. package/src/functional/ternary-result/impl/ternary-result-unwrap-ok-or.mts +5 -0
  465. package/src/functional/ternary-result/impl/ternary-result-unwrap-ok.mts +3 -0
  466. package/src/functional/ternary-result/impl/ternary-result-unwrap-throw.mts +1 -0
  467. package/src/functional/ternary-result/impl/ternary-result-unwrap-warn-or.mts +5 -0
  468. package/src/functional/ternary-result/impl/ternary-result-unwrap-warn-throw.mts +1 -0
  469. package/src/functional/ternary-result/impl/ternary-result-unwrap-warn.mts +2 -0
  470. package/src/functional/ternary-result/impl/ternary-result-warn.mts +4 -1
  471. package/src/functional/ternary-result/impl/ternary-result-zip.mts +4 -0
  472. package/src/functional/ternary-result.test.mts +99 -8
  473. package/src/globals.d.mts +12 -1
  474. package/src/guard/has-key.mts +8 -5
  475. package/src/guard/has-key.test.mts +9 -5
  476. package/src/guard/is-error.test.mts +143 -0
  477. package/src/guard/is-non-empty-string.test.mts +44 -24
  478. package/src/guard/is-non-null-object.test.mts +45 -26
  479. package/src/guard/is-primitive.test.mts +51 -28
  480. package/src/guard/is-record.mts +34 -0
  481. package/src/guard/is-record.test.mts +28 -7
  482. package/src/guard/is-type.mts +3 -0
  483. package/src/guard/is-type.test.mts +285 -155
  484. package/src/guard/key-is-in.mts +3 -2
  485. package/src/guard/key-is-in.test.mts +2 -2
  486. package/src/iterator/range.mts +9 -0
  487. package/src/json/json.mts +50 -21
  488. package/src/json/json.test.mts +224 -176
  489. package/src/number/branded-types/finite-number.test.mts +51 -11
  490. package/src/number/branded-types/int.mts +33 -19
  491. package/src/number/branded-types/int.test.mts +56 -14
  492. package/src/number/branded-types/int16.test.mts +63 -16
  493. package/src/number/branded-types/int32.test.mts +63 -16
  494. package/src/number/branded-types/non-negative-finite-number.test.mts +52 -12
  495. package/src/number/branded-types/non-negative-int16.test.mts +59 -16
  496. package/src/number/branded-types/non-negative-int32.test.mts +59 -16
  497. package/src/number/branded-types/non-zero-finite-number.test.mts +65 -14
  498. package/src/number/branded-types/non-zero-int.test.mts +72 -19
  499. package/src/number/branded-types/non-zero-int16.test.mts +60 -16
  500. package/src/number/branded-types/non-zero-int32.test.mts +60 -16
  501. package/src/number/branded-types/non-zero-safe-int.mts +2 -2
  502. package/src/number/branded-types/non-zero-safe-int.test.mts +85 -23
  503. package/src/number/branded-types/non-zero-uint16.test.mts +53 -16
  504. package/src/number/branded-types/non-zero-uint32.test.mts +53 -16
  505. package/src/number/branded-types/positive-finite-number.test.mts +59 -14
  506. package/src/number/branded-types/positive-int.mts +34 -20
  507. package/src/number/branded-types/positive-int.test.mts +64 -17
  508. package/src/number/branded-types/positive-int16.test.mts +50 -15
  509. package/src/number/branded-types/positive-int32.test.mts +50 -15
  510. package/src/number/branded-types/positive-safe-int.mts +48 -27
  511. package/src/number/branded-types/positive-safe-int.test.mts +68 -19
  512. package/src/number/branded-types/positive-uint16.test.mts +53 -16
  513. package/src/number/branded-types/positive-uint32.test.mts +53 -16
  514. package/src/number/branded-types/safe-int.mts +50 -29
  515. package/src/number/branded-types/safe-int.test.mts +70 -18
  516. package/src/number/branded-types/safe-uint.mts +1 -1
  517. package/src/number/branded-types/safe-uint.test.mts +65 -17
  518. package/src/number/branded-types/uint.mts +31 -19
  519. package/src/number/branded-types/uint.test.mts +58 -15
  520. package/src/number/branded-types/uint16.test.mts +56 -15
  521. package/src/number/branded-types/uint32.test.mts +56 -15
  522. package/src/number/enum/int8.test.mts +7 -1
  523. package/src/number/enum/uint8.test.mts +7 -1
  524. package/src/number/num.mts +32 -21
  525. package/src/number/num.test.mts +88 -26
  526. package/src/number/refined-number-utils.mts +38 -13
  527. package/src/object/object.mts +19 -3
  528. package/src/object/object.test.mts +16 -6
  529. package/src/others/cast-mutable.test.mts +8 -1
  530. package/src/others/cast-readonly.test.mts +21 -4
  531. package/src/others/if-then.test.mts +40 -24
  532. package/src/others/map-nullable.mts +3 -0
  533. package/src/others/map-nullable.test.mts +27 -0
  534. package/src/others/memoize-function.test.mts +41 -0
  535. package/src/others/tuple.mts +14 -3
  536. package/src/others/unknown-to-string.mts +2 -0
  537. package/src/others/unknown-to-string.test.mts +10 -0
  538. package/src/promise/promise.mts +8 -4
  539. package/src/promise/promise.test.mts +8 -13
@@ -11,37 +11,49 @@ describe('NonNegativeInt32 test', () => {
11
11
  describe(asNonNegativeInt32, () => {
12
12
  test('accepts valid non-negative int32 values', () => {
13
13
  expect(() => asNonNegativeInt32(0)).not.toThrow();
14
+
14
15
  expect(() => asNonNegativeInt32(1)).not.toThrow();
16
+
15
17
  expect(() => asNonNegativeInt32(1000)).not.toThrow();
18
+
16
19
  expect(() => asNonNegativeInt32(2_147_483_647)).not.toThrow(); // 2^31 - 1
17
20
  });
18
21
 
19
22
  test('rejects negative integers', () => {
20
23
  expect(() => asNonNegativeInt32(-1)).toThrow(TypeError);
24
+
21
25
  expect(() => asNonNegativeInt32(-42)).toThrow(TypeError);
26
+
22
27
  expect(() => asNonNegativeInt32(-2_147_483_648)).toThrow(TypeError);
23
28
  });
24
29
 
25
30
  test('rejects values outside int32 range', () => {
26
31
  expect(() => asNonNegativeInt32(2_147_483_648)).toThrow(TypeError); // 2^31
32
+
27
33
  expect(() => asNonNegativeInt32(4_294_967_296)).toThrow(TypeError);
28
34
  });
29
35
 
30
36
  test('rejects non-integers', () => {
31
37
  expect(() => asNonNegativeInt32(Number.NaN)).toThrow(TypeError);
38
+
32
39
  expect(() => asNonNegativeInt32(Number.POSITIVE_INFINITY)).toThrow(
33
40
  TypeError,
34
41
  );
42
+
35
43
  expect(() => asNonNegativeInt32(Number.NEGATIVE_INFINITY)).toThrow(
36
44
  TypeError,
37
45
  );
46
+
38
47
  expect(() => asNonNegativeInt32(1.2)).toThrow(TypeError);
48
+
39
49
  expect(() => asNonNegativeInt32(-3.4)).toThrow(TypeError);
40
50
  });
41
51
 
42
52
  test('returns the same value for valid inputs', () => {
43
53
  expect(asNonNegativeInt32(0)).toBe(0);
54
+
44
55
  expect(asNonNegativeInt32(5)).toBe(5);
56
+
45
57
  expect(asNonNegativeInt32(2_147_483_647)).toBe(2_147_483_647);
46
58
  });
47
59
 
@@ -67,36 +79,48 @@ describe('NonNegativeInt32 test', () => {
67
79
 
68
80
  describe(isNonNegativeInt32, () => {
69
81
  test('correctly identifies non-negative int32 values', () => {
70
- expect(isNonNegativeInt32(0)).toBe(true);
71
- expect(isNonNegativeInt32(1)).toBe(true);
72
- expect(isNonNegativeInt32(1000)).toBe(true);
73
- expect(isNonNegativeInt32(2_147_483_647)).toBe(true);
82
+ assert.isTrue(isNonNegativeInt32(0));
83
+
84
+ assert.isTrue(isNonNegativeInt32(1));
85
+
86
+ assert.isTrue(isNonNegativeInt32(1000));
87
+
88
+ assert.isTrue(isNonNegativeInt32(2_147_483_647));
74
89
  });
75
90
 
76
91
  test('correctly identifies negative integers', () => {
77
- expect(isNonNegativeInt32(-1)).toBe(false);
78
- expect(isNonNegativeInt32(-42)).toBe(false);
79
- expect(isNonNegativeInt32(-2_147_483_648)).toBe(false);
92
+ assert.isFalse(isNonNegativeInt32(-1));
93
+
94
+ assert.isFalse(isNonNegativeInt32(-42));
95
+
96
+ assert.isFalse(isNonNegativeInt32(-2_147_483_648));
80
97
  });
81
98
 
82
99
  test('correctly identifies values outside int32 range', () => {
83
- expect(isNonNegativeInt32(2_147_483_648)).toBe(false);
84
- expect(isNonNegativeInt32(4_294_967_296)).toBe(false);
100
+ assert.isFalse(isNonNegativeInt32(2_147_483_648));
101
+
102
+ assert.isFalse(isNonNegativeInt32(4_294_967_296));
85
103
  });
86
104
 
87
105
  test('correctly identifies non-integers', () => {
88
- expect(isNonNegativeInt32(Number.NaN)).toBe(false);
89
- expect(isNonNegativeInt32(Number.POSITIVE_INFINITY)).toBe(false);
90
- expect(isNonNegativeInt32(Number.NEGATIVE_INFINITY)).toBe(false);
91
- expect(isNonNegativeInt32(1.2)).toBe(false);
92
- expect(isNonNegativeInt32(-3.4)).toBe(false);
106
+ assert.isFalse(isNonNegativeInt32(Number.NaN));
107
+
108
+ assert.isFalse(isNonNegativeInt32(Number.POSITIVE_INFINITY));
109
+
110
+ assert.isFalse(isNonNegativeInt32(Number.NEGATIVE_INFINITY));
111
+
112
+ assert.isFalse(isNonNegativeInt32(1.2));
113
+
114
+ assert.isFalse(isNonNegativeInt32(-3.4));
93
115
  });
94
116
  });
95
117
 
96
118
  describe('NonNegativeInt32.is', () => {
97
119
  test('same as isNonNegativeInt32 function', () => {
98
120
  expect(NonNegativeInt32.is(5)).toBe(isNonNegativeInt32(5));
121
+
99
122
  expect(NonNegativeInt32.is(0)).toBe(isNonNegativeInt32(0));
123
+
100
124
  expect(NonNegativeInt32.is(-1)).toBe(isNonNegativeInt32(-1));
101
125
  });
102
126
  });
@@ -104,19 +128,25 @@ describe('NonNegativeInt32 test', () => {
104
128
  describe('constants', () => {
105
129
  test('MIN_VALUE and MAX_VALUE', () => {
106
130
  expect(NonNegativeInt32.MIN_VALUE).toBe(0);
131
+
107
132
  expect(NonNegativeInt32.MAX_VALUE).toBe(2_147_483_647);
108
133
  });
109
134
  });
110
135
 
111
136
  describe('mathematical operations', () => {
112
137
  const a = asNonNegativeInt32(1_000_000);
138
+
113
139
  const b = asNonNegativeInt32(500_000);
140
+
114
141
  const c = asNonNegativeInt32(0);
115
142
 
116
143
  test('min and max', () => {
117
144
  expect(NonNegativeInt32.min(a, b)).toBe(500_000);
145
+
118
146
  expect(NonNegativeInt32.max(a, b)).toBe(1_000_000);
147
+
119
148
  expect(NonNegativeInt32.min(a, c)).toBe(0);
149
+
120
150
  expect(NonNegativeInt32.max(a, c)).toBe(1_000_000);
121
151
  });
122
152
 
@@ -127,12 +157,15 @@ describe('NonNegativeInt32 test', () => {
127
157
  );
128
158
 
129
159
  expect(result).toBe(2_147_483_647); // clamped to max
160
+
130
161
  expect(NonNegativeInt32.add(a, b)).toBe(1_500_000);
131
162
  });
132
163
 
133
164
  test('sub (never goes below 0)', () => {
134
165
  expect(NonNegativeInt32.sub(a, b)).toBe(500_000);
166
+
135
167
  expect(NonNegativeInt32.sub(b, a)).toBe(0); // clamped to 0
168
+
136
169
  expect(NonNegativeInt32.sub(c, a)).toBe(0); // clamped to 0
137
170
  });
138
171
 
@@ -143,6 +176,7 @@ describe('NonNegativeInt32 test', () => {
143
176
  );
144
177
 
145
178
  expect(result).toBe(2_147_483_647); // clamped to max
179
+
146
180
  expect(
147
181
  NonNegativeInt32.mul(asNonNegativeInt32(1000), asNonNegativeInt32(5)),
148
182
  ).toBe(5000);
@@ -150,9 +184,11 @@ describe('NonNegativeInt32 test', () => {
150
184
 
151
185
  test('div (floor division, never goes below 0)', () => {
152
186
  expect(NonNegativeInt32.div(a, asPositiveInt32(500_000))).toBe(2);
187
+
153
188
  expect(
154
189
  NonNegativeInt32.div(asNonNegativeInt32(7), asPositiveInt32(3)),
155
190
  ).toBe(2);
191
+
156
192
  expect(
157
193
  NonNegativeInt32.div(
158
194
  asNonNegativeInt32(500_000),
@@ -168,6 +204,7 @@ describe('NonNegativeInt32 test', () => {
168
204
  );
169
205
 
170
206
  expect(result).toBe(2_147_483_647); // clamped to max
207
+
171
208
  expect(
172
209
  NonNegativeInt32.pow(asNonNegativeInt32(2), asNonNegativeInt32(3)),
173
210
  ).toBe(8);
@@ -177,15 +214,20 @@ describe('NonNegativeInt32 test', () => {
177
214
  describe('random', () => {
178
215
  test('generates non-negative int32 values within specified range', () => {
179
216
  const min = 0;
217
+
180
218
  const max = 20;
181
219
 
182
220
  for (const _ of range(10)) {
183
221
  const result = NonNegativeInt32.random(min, max);
184
222
 
185
223
  expect(result).toBeGreaterThanOrEqual(min);
224
+
186
225
  expect(result).toBeLessThanOrEqual(max);
187
- expect(NonNegativeInt32.is(result)).toBe(true);
188
- expect(Number.isInteger(result)).toBe(true);
226
+
227
+ assert.isTrue(NonNegativeInt32.is(result));
228
+
229
+ assert.isTrue(Number.isInteger(result));
230
+
189
231
  expect(result).toBeGreaterThanOrEqual(0);
190
232
  }
191
233
  });
@@ -195,6 +237,7 @@ describe('NonNegativeInt32 test', () => {
195
237
  const result = NonNegativeInt32.random(0, 30);
196
238
 
197
239
  expect(result).toBeGreaterThanOrEqual(0);
240
+
198
241
  expect(result).toBeLessThanOrEqual(2_147_483_647);
199
242
  }
200
243
  });
@@ -10,25 +10,35 @@ describe('NonZeroFiniteNumber test', () => {
10
10
  describe(asNonZeroFiniteNumber, () => {
11
11
  test('accepts valid non-zero finite numbers', () => {
12
12
  expect(() => asNonZeroFiniteNumber(1)).not.toThrow();
13
+
13
14
  expect(() => asNonZeroFiniteNumber(-1)).not.toThrow();
15
+
14
16
  expect(() => asNonZeroFiniteNumber(3.14)).not.toThrow();
17
+
15
18
  expect(() => asNonZeroFiniteNumber(-2.5)).not.toThrow();
19
+
16
20
  expect(() => asNonZeroFiniteNumber(0.001)).not.toThrow();
21
+
17
22
  expect(() => asNonZeroFiniteNumber(-0.001)).not.toThrow();
23
+
18
24
  expect(() => asNonZeroFiniteNumber(Number.MAX_VALUE)).not.toThrow();
25
+
19
26
  expect(() => asNonZeroFiniteNumber(-Number.MAX_VALUE)).not.toThrow();
20
27
  });
21
28
 
22
29
  test('rejects zero', () => {
23
30
  expect(() => asNonZeroFiniteNumber(0)).toThrow(TypeError);
31
+
24
32
  expect(() => asNonZeroFiniteNumber(-0)).toThrow(TypeError);
25
33
  });
26
34
 
27
35
  test('rejects non-finite numbers', () => {
28
36
  expect(() => asNonZeroFiniteNumber(Number.NaN)).toThrow(TypeError);
37
+
29
38
  expect(() => asNonZeroFiniteNumber(Number.POSITIVE_INFINITY)).toThrow(
30
39
  TypeError,
31
40
  );
41
+
32
42
  expect(() => asNonZeroFiniteNumber(Number.NEGATIVE_INFINITY)).toThrow(
33
43
  TypeError,
34
44
  );
@@ -36,7 +46,9 @@ describe('NonZeroFiniteNumber test', () => {
36
46
 
37
47
  test('returns the same value for valid inputs', () => {
38
48
  expect(asNonZeroFiniteNumber(5.5)).toBe(5.5);
49
+
39
50
  expect(asNonZeroFiniteNumber(-10)).toBe(-10);
51
+
40
52
  expect(asNonZeroFiniteNumber(1)).toBe(1);
41
53
  });
42
54
 
@@ -57,78 +69,104 @@ describe('NonZeroFiniteNumber test', () => {
57
69
 
58
70
  describe(isNonZeroFiniteNumber, () => {
59
71
  test('correctly identifies non-zero finite numbers', () => {
60
- expect(isNonZeroFiniteNumber(1)).toBe(true);
61
- expect(isNonZeroFiniteNumber(-1)).toBe(true);
62
- expect(isNonZeroFiniteNumber(3.14)).toBe(true);
63
- expect(isNonZeroFiniteNumber(-2.5)).toBe(true);
64
- expect(isNonZeroFiniteNumber(0.001)).toBe(true);
65
- expect(isNonZeroFiniteNumber(-0.001)).toBe(true);
72
+ assert.isTrue(isNonZeroFiniteNumber(1));
73
+
74
+ assert.isTrue(isNonZeroFiniteNumber(-1));
75
+
76
+ assert.isTrue(isNonZeroFiniteNumber(3.14));
77
+
78
+ assert.isTrue(isNonZeroFiniteNumber(-2.5));
79
+
80
+ assert.isTrue(isNonZeroFiniteNumber(0.001));
81
+
82
+ assert.isTrue(isNonZeroFiniteNumber(-0.001));
66
83
  });
67
84
 
68
85
  test('correctly identifies zero', () => {
69
- expect(isNonZeroFiniteNumber(0)).toBe(false);
70
- expect(isNonZeroFiniteNumber(-0)).toBe(false);
86
+ assert.isFalse(isNonZeroFiniteNumber(0));
87
+
88
+ assert.isFalse(isNonZeroFiniteNumber(-0));
71
89
  });
72
90
 
73
91
  test('correctly identifies non-finite numbers', () => {
74
- expect(isNonZeroFiniteNumber(Number.NaN)).toBe(false);
75
- expect(isNonZeroFiniteNumber(Number.POSITIVE_INFINITY)).toBe(false);
76
- expect(isNonZeroFiniteNumber(Number.NEGATIVE_INFINITY)).toBe(false);
92
+ assert.isFalse(isNonZeroFiniteNumber(Number.NaN));
93
+
94
+ assert.isFalse(isNonZeroFiniteNumber(Number.POSITIVE_INFINITY));
95
+
96
+ assert.isFalse(isNonZeroFiniteNumber(Number.NEGATIVE_INFINITY));
77
97
  });
78
98
  });
79
99
 
80
100
  describe('NonZeroFiniteNumber.is', () => {
81
101
  test('same as isNonZeroFiniteNumber function', () => {
82
102
  expect(NonZeroFiniteNumber.is(5)).toBe(isNonZeroFiniteNumber(5));
103
+
83
104
  expect(NonZeroFiniteNumber.is(0)).toBe(isNonZeroFiniteNumber(0));
105
+
84
106
  expect(NonZeroFiniteNumber.is(-1)).toBe(isNonZeroFiniteNumber(-1));
85
107
  });
86
108
  });
87
109
 
88
110
  describe('mathematical operations', () => {
89
111
  const a = asNonZeroFiniteNumber(5.5);
112
+
90
113
  const b = asNonZeroFiniteNumber(2.5);
114
+
91
115
  const c = asNonZeroFiniteNumber(-3.5);
92
116
 
93
117
  test('abs', () => {
94
118
  expect(NonZeroFiniteNumber.abs(a)).toBe(5.5);
119
+
95
120
  expect(NonZeroFiniteNumber.abs(c)).toBe(3.5);
121
+
96
122
  expect(NonZeroFiniteNumber.abs(asNonZeroFiniteNumber(-1))).toBe(1);
97
123
  });
98
124
 
99
125
  test('min and max', () => {
100
126
  expect(NonZeroFiniteNumber.min(a, b)).toBe(2.5);
127
+
101
128
  expect(NonZeroFiniteNumber.max(a, b)).toBe(5.5);
129
+
102
130
  expect(NonZeroFiniteNumber.min(a, c)).toBe(-3.5);
131
+
103
132
  expect(NonZeroFiniteNumber.max(a, c)).toBe(5.5);
104
133
  });
105
134
 
106
135
  test('floor, ceil, round', () => {
107
136
  expect(NonZeroFiniteNumber.floor(a)).toBe(5);
137
+
108
138
  expect(NonZeroFiniteNumber.ceil(a)).toBe(6);
139
+
109
140
  expect(NonZeroFiniteNumber.round(a)).toBe(6);
141
+
110
142
  expect(NonZeroFiniteNumber.floor(c)).toBe(-4);
143
+
111
144
  expect(NonZeroFiniteNumber.ceil(c)).toBe(-3);
145
+
112
146
  expect(NonZeroFiniteNumber.round(c)).toBe(-3);
113
147
  });
114
148
 
115
149
  test('add', () => {
116
150
  expect(NonZeroFiniteNumber.add(a, b)).toBe(8);
151
+
117
152
  expect(NonZeroFiniteNumber.add(a, c)).toBe(2);
118
153
  });
119
154
 
120
155
  test('sub', () => {
121
156
  expect(NonZeroFiniteNumber.sub(a, b)).toBe(3);
157
+
122
158
  expect(NonZeroFiniteNumber.sub(a, c)).toBe(9);
123
159
  });
124
160
 
125
161
  test('mul', () => {
126
162
  expect(NonZeroFiniteNumber.mul(a, b)).toBe(13.75);
163
+
127
164
  expect(NonZeroFiniteNumber.mul(a, c)).toBe(-19.25);
128
165
  });
129
166
 
130
167
  test('div', () => {
131
168
  expect(NonZeroFiniteNumber.div(a, b)).toBe(2.2);
169
+
132
170
  expect(NonZeroFiniteNumber.div(a, asNonZeroFiniteNumber(2))).toBe(2.75);
133
171
  });
134
172
 
@@ -139,6 +177,7 @@ describe('NonZeroFiniteNumber test', () => {
139
177
  asNonZeroFiniteNumber(3),
140
178
  ),
141
179
  ).toBe(8);
180
+
142
181
  expect(
143
182
  NonZeroFiniteNumber.pow(
144
183
  asNonZeroFiniteNumber(3),
@@ -151,42 +190,54 @@ describe('NonZeroFiniteNumber test', () => {
151
190
  describe('random', () => {
152
191
  test('generates non-zero numbers within specified range (positive range)', () => {
153
192
  const min = asNonZeroFiniteNumber(1.5);
193
+
154
194
  const max = asNonZeroFiniteNumber(10.3);
155
195
 
156
196
  for (const _ of range(10)) {
157
197
  const result = NonZeroFiniteNumber.random(min, max);
158
198
 
159
199
  expect(result).toBeGreaterThanOrEqual(min);
200
+
160
201
  expect(result).toBeLessThanOrEqual(max);
161
- expect(NonZeroFiniteNumber.is(result)).toBe(true);
202
+
203
+ assert.isTrue(NonZeroFiniteNumber.is(result));
204
+
162
205
  expect(result).not.toBe(0);
163
206
  }
164
207
  });
165
208
 
166
209
  test('generates non-zero numbers within specified range (negative range)', () => {
167
210
  const min = asNonZeroFiniteNumber(-10.3);
211
+
168
212
  const max = asNonZeroFiniteNumber(-1.5);
169
213
 
170
214
  for (const _ of range(10)) {
171
215
  const result = NonZeroFiniteNumber.random(min, max);
172
216
 
173
217
  expect(result).toBeGreaterThanOrEqual(min);
218
+
174
219
  expect(result).toBeLessThanOrEqual(max);
175
- expect(NonZeroFiniteNumber.is(result)).toBe(true);
220
+
221
+ assert.isTrue(NonZeroFiniteNumber.is(result));
222
+
176
223
  expect(result).not.toBe(0);
177
224
  }
178
225
  });
179
226
 
180
227
  test('generates non-zero numbers within range that spans zero', () => {
181
228
  const min = asNonZeroFiniteNumber(-5.5);
229
+
182
230
  const max = asNonZeroFiniteNumber(5.5);
183
231
 
184
232
  for (const _ of range(10)) {
185
233
  const result = NonZeroFiniteNumber.random(min, max);
186
234
 
187
235
  expect(result).toBeGreaterThanOrEqual(min);
236
+
188
237
  expect(result).toBeLessThanOrEqual(max);
189
- expect(NonZeroFiniteNumber.is(result)).toBe(true);
238
+
239
+ assert.isTrue(NonZeroFiniteNumber.is(result));
240
+
190
241
  expect(result).not.toBe(0);
191
242
  }
192
243
  });
@@ -6,29 +6,41 @@ describe('NonZeroInt test', () => {
6
6
  describe(asNonZeroInt, () => {
7
7
  test('accepts valid non-zero integers', () => {
8
8
  expect(() => asNonZeroInt(1)).not.toThrow();
9
+
9
10
  expect(() => asNonZeroInt(-1)).not.toThrow();
11
+
10
12
  expect(() => asNonZeroInt(42)).not.toThrow();
13
+
11
14
  expect(() => asNonZeroInt(-42)).not.toThrow();
15
+
12
16
  expect(() => asNonZeroInt(Number.MAX_SAFE_INTEGER)).not.toThrow();
17
+
13
18
  expect(() => asNonZeroInt(Number.MIN_SAFE_INTEGER)).not.toThrow();
14
19
  });
15
20
 
16
21
  test('rejects zero', () => {
17
22
  expect(() => asNonZeroInt(0)).toThrow(TypeError);
23
+
18
24
  expect(() => asNonZeroInt(-0)).toThrow(TypeError);
19
25
  });
20
26
 
21
27
  test('rejects non-integers', () => {
22
28
  expect(() => asNonZeroInt(Number.NaN)).toThrow(TypeError);
29
+
23
30
  expect(() => asNonZeroInt(Number.POSITIVE_INFINITY)).toThrow(TypeError);
31
+
24
32
  expect(() => asNonZeroInt(Number.NEGATIVE_INFINITY)).toThrow(TypeError);
33
+
25
34
  expect(() => asNonZeroInt(1.2)).toThrow(TypeError);
35
+
26
36
  expect(() => asNonZeroInt(-3.4)).toThrow(TypeError);
27
37
  });
28
38
 
29
39
  test('returns the same value for valid inputs', () => {
30
40
  expect(asNonZeroInt(5)).toBe(5);
41
+
31
42
  expect(asNonZeroInt(-10)).toBe(-10);
43
+
32
44
  expect(asNonZeroInt(1)).toBe(1);
33
45
  });
34
46
 
@@ -48,78 +60,104 @@ describe('NonZeroInt test', () => {
48
60
 
49
61
  describe(isNonZeroInt, () => {
50
62
  test('correctly identifies non-zero integers', () => {
51
- expect(isNonZeroInt(1)).toBe(true);
52
- expect(isNonZeroInt(-1)).toBe(true);
53
- expect(isNonZeroInt(42)).toBe(true);
54
- expect(isNonZeroInt(-42)).toBe(true);
55
- expect(isNonZeroInt(Number.MAX_SAFE_INTEGER)).toBe(true);
56
- expect(isNonZeroInt(Number.MIN_SAFE_INTEGER)).toBe(true);
63
+ assert.isTrue(isNonZeroInt(1));
64
+
65
+ assert.isTrue(isNonZeroInt(-1));
66
+
67
+ assert.isTrue(isNonZeroInt(42));
68
+
69
+ assert.isTrue(isNonZeroInt(-42));
70
+
71
+ assert.isTrue(isNonZeroInt(Number.MAX_SAFE_INTEGER));
72
+
73
+ assert.isTrue(isNonZeroInt(Number.MIN_SAFE_INTEGER));
57
74
  });
58
75
 
59
76
  test('correctly identifies zero', () => {
60
- expect(isNonZeroInt(0)).toBe(false);
61
- expect(isNonZeroInt(-0)).toBe(false);
77
+ assert.isFalse(isNonZeroInt(0));
78
+
79
+ assert.isFalse(isNonZeroInt(-0));
62
80
  });
63
81
 
64
82
  test('correctly identifies non-integers', () => {
65
- expect(isNonZeroInt(Number.NaN)).toBe(false);
66
- expect(isNonZeroInt(Number.POSITIVE_INFINITY)).toBe(false);
67
- expect(isNonZeroInt(Number.NEGATIVE_INFINITY)).toBe(false);
68
- expect(isNonZeroInt(1.2)).toBe(false);
69
- expect(isNonZeroInt(-3.4)).toBe(false);
83
+ assert.isFalse(isNonZeroInt(Number.NaN));
84
+
85
+ assert.isFalse(isNonZeroInt(Number.POSITIVE_INFINITY));
86
+
87
+ assert.isFalse(isNonZeroInt(Number.NEGATIVE_INFINITY));
88
+
89
+ assert.isFalse(isNonZeroInt(1.2));
90
+
91
+ assert.isFalse(isNonZeroInt(-3.4));
70
92
  });
71
93
  });
72
94
 
73
95
  describe('NonZeroInt.is', () => {
74
96
  test('same as isNonZeroInt function', () => {
75
97
  expect(NonZeroInt.is(5)).toBe(isNonZeroInt(5));
98
+
76
99
  expect(NonZeroInt.is(0)).toBe(isNonZeroInt(0));
100
+
77
101
  expect(NonZeroInt.is(-10)).toBe(isNonZeroInt(-10));
78
102
  });
79
103
  });
80
104
 
81
105
  describe('mathematical operations', () => {
82
106
  const a = asNonZeroInt(5);
107
+
83
108
  const b = asNonZeroInt(2);
109
+
84
110
  const c = asNonZeroInt(-3);
85
111
 
86
112
  test('abs', () => {
87
113
  expect(NonZeroInt.abs(a)).toBe(5);
114
+
88
115
  expect(NonZeroInt.abs(c)).toBe(3);
116
+
89
117
  expect(NonZeroInt.abs(asNonZeroInt(-1))).toBe(1);
90
118
  });
91
119
 
92
120
  test('min and max', () => {
93
121
  expect(NonZeroInt.min(a, b)).toBe(2);
122
+
94
123
  expect(NonZeroInt.max(a, b)).toBe(5);
124
+
95
125
  expect(NonZeroInt.min(a, c)).toBe(-3);
126
+
96
127
  expect(NonZeroInt.max(a, c)).toBe(5);
97
128
  });
98
129
 
99
130
  test('add', () => {
100
131
  expect(NonZeroInt.add(a, b)).toBe(7);
132
+
101
133
  expect(NonZeroInt.add(a, c)).toBe(2);
102
134
  });
103
135
 
104
136
  test('sub', () => {
105
137
  expect(NonZeroInt.sub(a, b)).toBe(3);
138
+
106
139
  expect(NonZeroInt.sub(a, c)).toBe(8);
107
140
  });
108
141
 
109
142
  test('mul', () => {
110
143
  expect(NonZeroInt.mul(a, b)).toBe(10);
144
+
111
145
  expect(NonZeroInt.mul(a, c)).toBe(-15);
112
146
  });
113
147
 
114
148
  test('div (floor division)', () => {
115
149
  expect(NonZeroInt.div(a, b)).toBe(2);
150
+
116
151
  expect(NonZeroInt.div(asNonZeroInt(7), asNonZeroInt(3))).toBe(2);
152
+
117
153
  expect(NonZeroInt.div(asNonZeroInt(-7), asNonZeroInt(3))).toBe(-3);
118
154
  });
119
155
 
120
156
  test('pow', () => {
121
157
  expect(NonZeroInt.pow(asNonZeroInt(2), asNonZeroInt(3))).toBe(8);
158
+
122
159
  expect(NonZeroInt.pow(asNonZeroInt(3), asNonZeroInt(2))).toBe(9);
160
+
123
161
  expect(NonZeroInt.pow(asNonZeroInt(-2), asNonZeroInt(3))).toBe(-8);
124
162
  });
125
163
  });
@@ -127,45 +165,60 @@ describe('NonZeroInt test', () => {
127
165
  describe('random', () => {
128
166
  test('generates non-zero integers within specified range (positive range)', () => {
129
167
  const min = 1;
168
+
130
169
  const max = 10;
131
170
 
132
171
  for (const _ of range(10)) {
133
172
  const result = NonZeroInt.random(min, max);
134
173
 
135
174
  expect(result).toBeGreaterThanOrEqual(min);
175
+
136
176
  expect(result).toBeLessThanOrEqual(max);
137
- expect(NonZeroInt.is(result)).toBe(true);
138
- expect(Number.isInteger(result)).toBe(true);
177
+
178
+ assert.isTrue(NonZeroInt.is(result));
179
+
180
+ assert.isTrue(Number.isInteger(result));
181
+
139
182
  expect(result).not.toBe(0);
140
183
  }
141
184
  });
142
185
 
143
186
  test('generates non-zero integers within specified range (negative range)', () => {
144
187
  const min = -10;
188
+
145
189
  const max = -1;
146
190
 
147
191
  for (const _ of range(10)) {
148
192
  const result = NonZeroInt.random(min, max);
149
193
 
150
194
  expect(result).toBeGreaterThanOrEqual(min);
195
+
151
196
  expect(result).toBeLessThanOrEqual(max);
152
- expect(NonZeroInt.is(result)).toBe(true);
153
- expect(Number.isInteger(result)).toBe(true);
197
+
198
+ assert.isTrue(NonZeroInt.is(result));
199
+
200
+ assert.isTrue(Number.isInteger(result));
201
+
154
202
  expect(result).not.toBe(0);
155
203
  }
156
204
  });
157
205
 
158
206
  test('generates non-zero integers within range that spans zero', () => {
159
207
  const min = -5;
208
+
160
209
  const max = 5;
161
210
 
162
211
  for (const _ of range(10)) {
163
212
  const result = NonZeroInt.random(min, max);
164
213
 
165
214
  expect(result).toBeGreaterThanOrEqual(min);
215
+
166
216
  expect(result).toBeLessThanOrEqual(max);
167
- expect(NonZeroInt.is(result)).toBe(true);
168
- expect(Number.isInteger(result)).toBe(true);
217
+
218
+ assert.isTrue(NonZeroInt.is(result));
219
+
220
+ assert.isTrue(Number.isInteger(result));
221
+
169
222
  expect(result).not.toBe(0);
170
223
  }
171
224
  });