@design-edito/tools 0.4.5 → 0.4.11

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 (421) hide show
  1. package/TODO.md +269 -0
  2. package/agnostic/arrays/dedupe/index.js +9 -7
  3. package/agnostic/arrays/dedupe/index.test.js +24 -0
  4. package/agnostic/arrays/find-duplicates/index.js +34 -22
  5. package/agnostic/arrays/find-duplicates/index.test.js +31 -0
  6. package/agnostic/arrays/index.d.ts +2 -2
  7. package/agnostic/arrays/index.js +2 -2
  8. package/agnostic/arrays/is-array-of/index.js +28 -26
  9. package/agnostic/arrays/is-array-of/index.test.js +56 -0
  10. package/agnostic/arrays/make/index.d.ts +1 -1
  11. package/agnostic/arrays/make/index.js +11 -6
  12. package/agnostic/arrays/make/index.test.js +10 -0
  13. package/agnostic/arrays/random-pick/index.js +38 -22
  14. package/agnostic/arrays/random-pick/index.test.js +23 -0
  15. package/agnostic/arrays/shuffle/index.js +15 -11
  16. package/agnostic/arrays/shuffle/index.test.js +14 -0
  17. package/agnostic/booleans/is-falsy/index.js +24 -15
  18. package/agnostic/booleans/is-falsy/index.test.js +26 -0
  19. package/agnostic/colors/channels/index.js +139 -936
  20. package/agnostic/colors/channels/index.test.js +64 -0
  21. package/agnostic/colors/contrast/index.js +24 -643
  22. package/agnostic/colors/contrast/index.test.js +21 -0
  23. package/agnostic/colors/convert/index.js +811 -837
  24. package/agnostic/colors/convert/index.test.js +98 -0
  25. package/agnostic/colors/cssColorsMap.js +153 -0
  26. package/agnostic/colors/distance/index.js +66 -538
  27. package/agnostic/colors/distance/index.test.js +21 -0
  28. package/agnostic/colors/grayscale/index.js +95 -872
  29. package/agnostic/colors/grayscale/index.test.js +34 -0
  30. package/agnostic/colors/index.d.ts +4 -4
  31. package/agnostic/colors/index.js +4 -4
  32. package/agnostic/colors/invert/index.js +34 -719
  33. package/agnostic/colors/invert/index.test.js +31 -0
  34. package/agnostic/colors/lerp/index.js +75 -804
  35. package/agnostic/colors/lerp/index.test.js +55 -0
  36. package/agnostic/colors/luminance/index.js +17 -625
  37. package/agnostic/colors/luminance/index.test.js +30 -0
  38. package/agnostic/colors/palette/index.js +83 -917
  39. package/agnostic/colors/palette/index.test.js +35 -0
  40. package/agnostic/colors/rotate/index.js +35 -835
  41. package/agnostic/colors/rotate/index.test.js +45 -0
  42. package/agnostic/colors/tidy/index.js +79 -530
  43. package/agnostic/colors/tidy/index.test.js +45 -0
  44. package/agnostic/colors/typechecks/index.js +188 -250
  45. package/agnostic/colors/typechecks/index.test.js +113 -0
  46. package/agnostic/colors/types.js +1 -0
  47. package/agnostic/css/bem/index.js +134 -171
  48. package/agnostic/css/clss/index.js +64 -29
  49. package/agnostic/css/clss/index.test.js +60 -0
  50. package/agnostic/css/generate-nice-color/index.js +26 -71
  51. package/agnostic/css/generate-nice-color/index.test.js +8 -0
  52. package/agnostic/css/index.d.ts +2 -2
  53. package/agnostic/css/index.js +2 -2
  54. package/agnostic/css/is-valid-css-class-name/index.js +14 -8
  55. package/agnostic/css/is-valid-css-class-name/index.test.js +36 -0
  56. package/agnostic/css/scale/index.d.ts +46 -16
  57. package/agnostic/css/scale/index.js +70 -54
  58. package/agnostic/css/scale/index.test.js +88 -0
  59. package/agnostic/css/styles-set/index.js +151 -178
  60. package/agnostic/errors/index.d.ts +1 -1
  61. package/agnostic/errors/index.js +1 -1
  62. package/agnostic/errors/register/index.js +45 -49
  63. package/agnostic/errors/unknown-to-string/index.js +17 -10
  64. package/agnostic/errors/unknown-to-string/index.test.js +35 -0
  65. package/agnostic/html/get-node-ancestors/index.js +29 -29
  66. package/agnostic/html/get-node-ancestors/index.test.js +58 -0
  67. package/agnostic/html/get-position-inside-parent/index.js +13 -8
  68. package/agnostic/html/get-position-inside-parent/index.test.js +56 -0
  69. package/agnostic/html/hyper-json/cast/index.js +128 -2931
  70. package/agnostic/html/hyper-json/index.js +23 -2954
  71. package/agnostic/html/hyper-json/method/index.js +10 -14
  72. package/agnostic/html/hyper-json/serialize/index.js +88 -222
  73. package/agnostic/html/hyper-json/smart-tags/coalesced/add/index.js +14 -2938
  74. package/agnostic/html/hyper-json/smart-tags/coalesced/addclass/index.js +27 -2937
  75. package/agnostic/html/hyper-json/smart-tags/coalesced/and/index.js +13 -2938
  76. package/agnostic/html/hyper-json/smart-tags/coalesced/append/index.js +34 -2938
  77. package/agnostic/html/hyper-json/smart-tags/coalesced/at/index.js +42 -2935
  78. package/agnostic/html/hyper-json/smart-tags/coalesced/call/index.js +47 -2937
  79. package/agnostic/html/hyper-json/smart-tags/coalesced/clone/index.js +10 -2939
  80. package/agnostic/html/hyper-json/smart-tags/coalesced/deleteproperties/index.js +45 -2936
  81. package/agnostic/html/hyper-json/smart-tags/coalesced/equals/index.js +22 -2938
  82. package/agnostic/html/hyper-json/smart-tags/coalesced/getattribute/index.js +26 -2938
  83. package/agnostic/html/hyper-json/smart-tags/coalesced/getproperties/index.js +19 -2938
  84. package/agnostic/html/hyper-json/smart-tags/coalesced/getproperty/index.js +67 -2935
  85. package/agnostic/html/hyper-json/smart-tags/coalesced/hjparse/index.js +21 -2937
  86. package/agnostic/html/hyper-json/smart-tags/coalesced/hjstringify/index.js +89 -2938
  87. package/agnostic/html/hyper-json/smart-tags/coalesced/if/index.js +20 -2938
  88. package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts +11 -11
  89. package/agnostic/html/hyper-json/smart-tags/coalesced/index.js +11 -11
  90. package/agnostic/html/hyper-json/smart-tags/coalesced/initialize/index.js +37 -2938
  91. package/agnostic/html/hyper-json/smart-tags/coalesced/join/index.js +16 -2938
  92. package/agnostic/html/hyper-json/smart-tags/coalesced/length/index.js +21 -2938
  93. package/agnostic/html/hyper-json/smart-tags/coalesced/map/index.js +31 -2938
  94. package/agnostic/html/hyper-json/smart-tags/coalesced/negate/index.js +10 -2939
  95. package/agnostic/html/hyper-json/smart-tags/coalesced/notrailing/index.js +33 -2938
  96. package/agnostic/html/hyper-json/smart-tags/coalesced/or/index.js +13 -2938
  97. package/agnostic/html/hyper-json/smart-tags/coalesced/pickrandom/index.js +17 -2938
  98. package/agnostic/html/hyper-json/smart-tags/coalesced/populate/index.js +59 -2938
  99. package/agnostic/html/hyper-json/smart-tags/coalesced/print/index.js +23 -2938
  100. package/agnostic/html/hyper-json/smart-tags/coalesced/push/index.js +10 -2939
  101. package/agnostic/html/hyper-json/smart-tags/coalesced/pusheach/index.js +26 -2938
  102. package/agnostic/html/hyper-json/smart-tags/coalesced/recordtoarray/index.js +10 -2939
  103. package/agnostic/html/hyper-json/smart-tags/coalesced/removeattribute/index.js +53 -2935
  104. package/agnostic/html/hyper-json/smart-tags/coalesced/removeclass/index.js +27 -2937
  105. package/agnostic/html/hyper-json/smart-tags/coalesced/renameproperty/index.js +31 -2937
  106. package/agnostic/html/hyper-json/smart-tags/coalesced/replace/index.js +55 -2940
  107. package/agnostic/html/hyper-json/smart-tags/coalesced/select/index.js +29 -2935
  108. package/agnostic/html/hyper-json/smart-tags/coalesced/set/index.js +29 -2938
  109. package/agnostic/html/hyper-json/smart-tags/coalesced/setattribute/index.js +53 -2935
  110. package/agnostic/html/hyper-json/smart-tags/coalesced/setproperty/index.js +232 -2936
  111. package/agnostic/html/hyper-json/smart-tags/coalesced/sorton/index.js +89 -2936
  112. package/agnostic/html/hyper-json/smart-tags/coalesced/split/index.js +20 -2938
  113. package/agnostic/html/hyper-json/smart-tags/coalesced/spread/index.js +23 -2939
  114. package/agnostic/html/hyper-json/smart-tags/coalesced/toarray/index.js +11 -2939
  115. package/agnostic/html/hyper-json/smart-tags/coalesced/toboolean/index.js +11 -2939
  116. package/agnostic/html/hyper-json/smart-tags/coalesced/toelement/index.js +17 -2938
  117. package/agnostic/html/hyper-json/smart-tags/coalesced/toggleclass/index.js +27 -2937
  118. package/agnostic/html/hyper-json/smart-tags/coalesced/tonodelist/index.js +11 -2939
  119. package/agnostic/html/hyper-json/smart-tags/coalesced/tonull/index.js +10 -2939
  120. package/agnostic/html/hyper-json/smart-tags/coalesced/tonumber/index.js +11 -2939
  121. package/agnostic/html/hyper-json/smart-tags/coalesced/torecord/index.js +11 -2939
  122. package/agnostic/html/hyper-json/smart-tags/coalesced/toref/index.js +11 -2939
  123. package/agnostic/html/hyper-json/smart-tags/coalesced/tostring/index.js +11 -2939
  124. package/agnostic/html/hyper-json/smart-tags/coalesced/totext/index.js +11 -2939
  125. package/agnostic/html/hyper-json/smart-tags/coalesced/transformselected/index.js +84 -2938
  126. package/agnostic/html/hyper-json/smart-tags/coalesced/trim/index.js +14 -2938
  127. package/agnostic/html/hyper-json/smart-tags/index.js +28 -181
  128. package/agnostic/html/hyper-json/smart-tags/isolated/any/index.js +12 -195
  129. package/agnostic/html/hyper-json/smart-tags/isolated/array/index.js +12 -195
  130. package/agnostic/html/hyper-json/smart-tags/isolated/boolean/index.js +12 -2939
  131. package/agnostic/html/hyper-json/smart-tags/isolated/element/index.js +24 -2938
  132. package/agnostic/html/hyper-json/smart-tags/isolated/get/index.js +18 -2938
  133. package/agnostic/html/hyper-json/smart-tags/isolated/guess/index.js +56 -2937
  134. package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts +2 -2
  135. package/agnostic/html/hyper-json/smart-tags/isolated/index.js +2 -2
  136. package/agnostic/html/hyper-json/smart-tags/isolated/nodelist/index.js +18 -2938
  137. package/agnostic/html/hyper-json/smart-tags/isolated/null/index.js +9 -193
  138. package/agnostic/html/hyper-json/smart-tags/isolated/number/index.js +16 -2938
  139. package/agnostic/html/hyper-json/smart-tags/isolated/record/index.js +12 -2938
  140. package/agnostic/html/hyper-json/smart-tags/isolated/ref/index.js +40 -2935
  141. package/agnostic/html/hyper-json/smart-tags/isolated/string/index.js +16 -2938
  142. package/agnostic/html/hyper-json/smart-tags/isolated/text/index.js +18 -2938
  143. package/agnostic/html/hyper-json/transformer/index.js +112 -148
  144. package/agnostic/html/hyper-json/tree/index.js +411 -2928
  145. package/agnostic/html/hyper-json/types/index.js +27 -18
  146. package/agnostic/html/hyper-json/utils/index.js +497 -2921
  147. package/agnostic/html/index.d.ts +2 -2
  148. package/agnostic/html/index.js +2 -2
  149. package/agnostic/html/insert-node/index.js +27 -16
  150. package/agnostic/html/insert-node/index.test.js +73 -0
  151. package/agnostic/html/placeholders/index.js +26 -29
  152. package/agnostic/html/replace-in-element/index.js +31 -48
  153. package/agnostic/html/replace-in-element/index.test.js +80 -0
  154. package/agnostic/html/selector-to-element/index.js +53 -39
  155. package/agnostic/html/selector-to-element/index.test.js +69 -0
  156. package/agnostic/html/string-to-nodes/index.js +24 -25
  157. package/agnostic/html/string-to-nodes/index.test.js +54 -0
  158. package/agnostic/index.d.ts +4 -4
  159. package/agnostic/index.js +4 -4
  160. package/agnostic/misc/assert/index.js +60 -66
  161. package/agnostic/misc/cast/index.js +123 -57
  162. package/agnostic/misc/cast/index.test.js +134 -0
  163. package/agnostic/misc/connection/index.js +55 -36
  164. package/agnostic/misc/connection/index.test.js +143 -0
  165. package/agnostic/misc/crawler/index.js +68 -46
  166. package/agnostic/misc/crawler/index.test.js +56 -0
  167. package/agnostic/misc/crossenv/detect-runtime/index.js +41 -13
  168. package/agnostic/misc/crossenv/detect-runtime/index.test.js +24 -0
  169. package/agnostic/misc/crossenv/types.js +21 -14
  170. package/agnostic/misc/crossenv/window/index.js +45 -24
  171. package/agnostic/misc/crossenv/window/index.test.js +24 -0
  172. package/agnostic/misc/data-size/index.js +182 -294
  173. package/agnostic/misc/data-size/index.test.js +100 -0
  174. package/agnostic/misc/data-size/types.js +1 -0
  175. package/agnostic/misc/index.d.ts +5 -5
  176. package/agnostic/misc/index.js +5 -5
  177. package/agnostic/misc/is-constructor-function/index.js +12 -6
  178. package/agnostic/misc/is-constructor-function/index.test.js +36 -0
  179. package/agnostic/misc/is-nullish/index.js +24 -11
  180. package/agnostic/misc/is-nullish/index.test.js +44 -0
  181. package/agnostic/misc/logs/index.d.ts +1 -1
  182. package/agnostic/misc/logs/index.js +1 -1
  183. package/agnostic/misc/logs/logger/index.js +115 -140
  184. package/agnostic/misc/logs/make-text-block/index.js +13 -13
  185. package/agnostic/misc/logs/styles/index.js +29 -48
  186. package/agnostic/misc/lorem-ipsum/index.js +51 -201
  187. package/agnostic/misc/lorem-ipsum/index.test.js +49 -0
  188. package/agnostic/misc/normalize-extension/index.js +99 -88
  189. package/agnostic/misc/normalize-extension/index.test.js +40 -0
  190. package/agnostic/misc/outcome/index.js +20 -14
  191. package/agnostic/misc/outcome/index.test.js +40 -0
  192. package/agnostic/numbers/absolute-modulo/index.js +9 -6
  193. package/agnostic/numbers/absolute-modulo/index.test.js +23 -0
  194. package/agnostic/numbers/approximate-rational/index.js +86 -69
  195. package/agnostic/numbers/approximate-rational/index.test.js +90 -0
  196. package/agnostic/numbers/clamp/index.js +12 -8
  197. package/agnostic/numbers/clamp/index.test.js +24 -0
  198. package/agnostic/numbers/geometric-progressions/index.js +25 -16
  199. package/agnostic/numbers/geometric-progressions/index.test.js +45 -0
  200. package/agnostic/numbers/index.d.ts +2 -2
  201. package/agnostic/numbers/index.js +2 -2
  202. package/agnostic/numbers/interpolate/index.js +25 -10
  203. package/agnostic/numbers/interpolate/index.test.js +40 -0
  204. package/agnostic/numbers/round/index.js +30 -15
  205. package/agnostic/numbers/round/index.test.js +56 -0
  206. package/agnostic/objects/deep-get-property/index.js +30 -27
  207. package/agnostic/objects/deep-get-property/index.test.js +59 -0
  208. package/agnostic/objects/enums/is-in-enum/index.js +17 -11
  209. package/agnostic/objects/enums/is-in-enum/index.test.js +100 -0
  210. package/agnostic/objects/flatten-getters/index.js +15 -14
  211. package/agnostic/objects/flatten-getters/index.test.js +78 -0
  212. package/agnostic/objects/index.d.ts +4 -4
  213. package/agnostic/objects/index.js +4 -4
  214. package/agnostic/objects/is-object/index.js +16 -9
  215. package/agnostic/objects/is-object/index.test.js +60 -0
  216. package/agnostic/objects/is-record/index.js +12 -7
  217. package/agnostic/objects/is-record/index.test.js +48 -0
  218. package/agnostic/objects/record-format/index.js +18 -12
  219. package/agnostic/objects/record-format/index.test.js +92 -0
  220. package/agnostic/objects/record-map/index.js +16 -11
  221. package/agnostic/objects/record-map/index.test.js +56 -0
  222. package/agnostic/objects/sort-keys/index.js +15 -11
  223. package/agnostic/objects/sort-keys/index.test.js +37 -0
  224. package/agnostic/objects/validation/index.js +21 -8
  225. package/agnostic/objects/validation/index.test.js +72 -0
  226. package/agnostic/optim/memoize/index.js +24 -16
  227. package/agnostic/optim/memoize/index.test.js +30 -0
  228. package/agnostic/optim/throttle-debounce/index.js +120 -102
  229. package/agnostic/optim/throttle-debounce/index.test.js +44 -0
  230. package/agnostic/optim/throttle-debounce/types.js +1 -0
  231. package/agnostic/random/hex-char/index.js +8 -10
  232. package/agnostic/random/hex-char/index.test.js +20 -0
  233. package/agnostic/random/index.d.ts +1 -1
  234. package/agnostic/random/index.js +1 -1
  235. package/agnostic/random/random/index.js +17 -14
  236. package/agnostic/random/random/index.test.js +73 -0
  237. package/agnostic/random/uuid/index.js +28 -20
  238. package/agnostic/random/uuid/index.test.js +45 -0
  239. package/agnostic/regexps/index.js +126 -84
  240. package/agnostic/regexps/index.test.js +108 -0
  241. package/agnostic/sanitization/file-name/index.js +24 -8
  242. package/agnostic/sanitization/file-name/index.test.js +23 -0
  243. package/agnostic/sanitization/html/index.js +172 -122
  244. package/agnostic/sanitization/index.d.ts +1 -1
  245. package/agnostic/sanitization/index.js +1 -1
  246. package/agnostic/sanitization/path/index.js +23 -15
  247. package/agnostic/sanitization/path/index.test.js +18 -0
  248. package/agnostic/sanitization/types.js +1 -0
  249. package/agnostic/sanitization/user-input/index.js +36 -24
  250. package/agnostic/sanitization/user-input/index.test.js +31 -0
  251. package/agnostic/strings/char-codes/index.js +123 -55
  252. package/agnostic/strings/index.d.ts +1 -1
  253. package/agnostic/strings/index.js +1 -1
  254. package/agnostic/strings/matches/index.js +35 -16
  255. package/agnostic/strings/normalize-indent/index.js +34 -16
  256. package/agnostic/strings/parse-table/index.js +153 -86
  257. package/agnostic/strings/replace-all/index.js +36 -15
  258. package/agnostic/strings/to-alphanum/index.js +23 -8
  259. package/agnostic/strings/trim/index.js +22 -9
  260. package/agnostic/time/dates/format-date/index.js +140 -72
  261. package/agnostic/time/duration/index.js +106 -140
  262. package/agnostic/time/timeout/index.js +24 -16
  263. package/agnostic/time/transitions/index.js +200 -158
  264. package/agnostic/time/wait/index.js +10 -8
  265. package/agnostic/typescript/types.js +1 -0
  266. package/components/BeforeAfter/index.controlled.js +95 -0
  267. package/components/BeforeAfter/index.js +54 -189
  268. package/components/BeforeAfter/utils.js +9 -0
  269. package/components/Disclaimer/index.js +50 -110
  270. package/components/Drawer/index.js +81 -196
  271. package/components/EventListener/index.js +29 -80
  272. package/components/Gallery/index.js +146 -221
  273. package/components/Gallery/utils.js +12 -0
  274. package/components/Image/index.js +66 -293
  275. package/components/IntersectionObserver/index.js +62 -110
  276. package/components/Overlayer/index.js +59 -103
  277. package/components/Paginator/index.js +124 -155
  278. package/components/ResizeObserver/index.js +66 -119
  279. package/components/ResizeObserver/style.module.css +0 -0
  280. package/components/Scrllgngn/index.js +171 -468
  281. package/components/ScrollListener/index.js +97 -276
  282. package/components/ScrollListener/utils.js +51 -0
  283. package/components/Sequencer/index.controlled.js +67 -0
  284. package/components/Sequencer/index.js +105 -262
  285. package/components/ShadowRoot/index.js +42 -96
  286. package/components/Subtitles/index.js +107 -244
  287. package/components/Subtitles/types.js +1 -0
  288. package/components/Subtitles/utils.js +102 -0
  289. package/components/Theatre/index.js +88 -136
  290. package/components/UIModule/index.js +156 -199
  291. package/components/Video/index.js +292 -857
  292. package/components/Video/utils.js +137 -0
  293. package/components/_WIP_AudioQuote/index.js +1 -0
  294. package/components/_WIP_Icon/index.js +1 -0
  295. package/components/index.d.ts +4 -4
  296. package/components/index.js +4 -4
  297. package/components/public-classnames.js +18 -0
  298. package/components/utils/index.js +11 -11
  299. package/components/utils/types.js +1 -0
  300. package/index.d.ts +1 -1
  301. package/index.js +1 -1
  302. package/node/@aws-s3/index.test.js +6 -0
  303. package/node/@aws-s3/storage/directory/copy-dir/index.js +66 -72
  304. package/node/@aws-s3/storage/directory/index.d.ts +1 -1
  305. package/node/@aws-s3/storage/directory/index.js +1 -1
  306. package/node/@aws-s3/storage/directory/list/index.js +32 -42
  307. package/node/@aws-s3/storage/directory/move-dir/index.js +68 -86
  308. package/node/@aws-s3/storage/directory/remove-dir/index.js +56 -67
  309. package/node/@aws-s3/storage/file/copy/index.js +41 -53
  310. package/node/@aws-s3/storage/file/download/index.js +29 -40
  311. package/node/@aws-s3/storage/file/exists/index.js +35 -43
  312. package/node/@aws-s3/storage/file/index.d.ts +1 -1
  313. package/node/@aws-s3/storage/file/index.js +1 -1
  314. package/node/@aws-s3/storage/file/move/index.js +57 -63
  315. package/node/@aws-s3/storage/file/remove/index.js +35 -43
  316. package/node/@aws-s3/storage/file/stat/index.js +33 -47
  317. package/node/@aws-s3/storage/file/upload/index.js +52 -63
  318. package/node/@design-edito/index.js +1 -0
  319. package/node/@express/@multer/index.js +61 -55
  320. package/node/@google-cloud/storage/bucket/get-metadata/index.js +25 -29
  321. package/node/@google-cloud/storage/directory/copy-dir/index.js +35 -41
  322. package/node/@google-cloud/storage/directory/index.d.ts +1 -1
  323. package/node/@google-cloud/storage/directory/index.js +1 -1
  324. package/node/@google-cloud/storage/directory/list/index.js +28 -35
  325. package/node/@google-cloud/storage/directory/move-dir/index.js +43 -42
  326. package/node/@google-cloud/storage/directory/remove-dir/index.js +34 -38
  327. package/node/@google-cloud/storage/file/copy/index.js +35 -40
  328. package/node/@google-cloud/storage/file/download/index.js +27 -34
  329. package/node/@google-cloud/storage/file/exists/index.js +25 -31
  330. package/node/@google-cloud/storage/file/generate-signed-url/index.js +33 -35
  331. package/node/@google-cloud/storage/file/get-metadata/index.js +28 -31
  332. package/node/@google-cloud/storage/file/get-permissions/index.js +25 -31
  333. package/node/@google-cloud/storage/file/index.d.ts +3 -3
  334. package/node/@google-cloud/storage/file/index.js +3 -3
  335. package/node/@google-cloud/storage/file/move/index.js +38 -42
  336. package/node/@google-cloud/storage/file/remove/index.js +34 -35
  337. package/node/@google-cloud/storage/file/revoke-signed-urls/index.js +32 -95
  338. package/node/@google-cloud/storage/file/stat/index.js +34 -38
  339. package/node/@google-cloud/storage/file/update-metadata/index.js +30 -31
  340. package/node/@google-cloud/storage/file/upload/index.js +44 -46
  341. package/node/@google-cloud/storage/index.d.ts +1 -1
  342. package/node/@google-cloud/storage/index.js +1 -1
  343. package/node/cloud-storage/clients/index.js +35 -15
  344. package/node/cloud-storage/operations/copy-dir/index.js +30 -203
  345. package/node/cloud-storage/operations/copy-file/index.js +30 -152
  346. package/node/cloud-storage/operations/download-file/index.js +30 -103
  347. package/node/cloud-storage/operations/exists-file/index.js +30 -103
  348. package/node/cloud-storage/operations/index.d.ts +2 -2
  349. package/node/cloud-storage/operations/index.js +2 -2
  350. package/node/cloud-storage/operations/list-dir/index.js +29 -98
  351. package/node/cloud-storage/operations/move-dir/index.js +30 -169
  352. package/node/cloud-storage/operations/move-file/index.js +30 -157
  353. package/node/cloud-storage/operations/remove-dir/index.js +29 -159
  354. package/node/cloud-storage/operations/remove-file/index.js +29 -121
  355. package/node/cloud-storage/operations/stat-file/index.js +29 -124
  356. package/node/cloud-storage/operations/upload-file/index.js +30 -162
  357. package/node/encryption/@aes-256-gcm/buffer/index.js +31 -72
  358. package/node/encryption/@aes-256-gcm/uint8-array/index.js +55 -55
  359. package/node/encryption/key/index.js +19 -12
  360. package/node/files/index.d.ts +1 -1
  361. package/node/files/index.js +1 -1
  362. package/node/files/is-in-directory/index.js +11 -8
  363. package/node/files/read-write/index.js +11 -15
  364. package/node/files/subpaths/index.js +156 -121
  365. package/node/ftps/directory/copy-dir/index.js +55 -62
  366. package/node/ftps/directory/list/index.js +24 -29
  367. package/node/ftps/directory/move-dir/index.js +38 -38
  368. package/node/ftps/directory/remove-dir/index.js +39 -42
  369. package/node/ftps/file/copy/index.js +42 -47
  370. package/node/ftps/file/download/index.js +29 -34
  371. package/node/ftps/file/exists/index.js +38 -36
  372. package/node/ftps/file/index.d.ts +2 -2
  373. package/node/ftps/file/index.js +2 -2
  374. package/node/ftps/file/move/index.js +46 -44
  375. package/node/ftps/file/remove/index.js +36 -39
  376. package/node/ftps/file/stat/index.js +30 -38
  377. package/node/ftps/file/upload/index.js +40 -44
  378. package/node/images/create/index.js +10 -562
  379. package/node/images/format/index.js +264 -815
  380. package/node/images/metadata/index.js +10 -571
  381. package/node/images/transform/index.js +169 -1022
  382. package/node/images/transform/operations/blur/index.js +11 -24
  383. package/node/images/transform/operations/brighten/index.js +11 -24
  384. package/node/images/transform/operations/extend/index.js +25 -589
  385. package/node/images/transform/operations/extract/index.js +15 -28
  386. package/node/images/transform/operations/flatten/index.js +20 -584
  387. package/node/images/transform/operations/flip/index.js +2 -6
  388. package/node/images/transform/operations/flop/index.js +2 -6
  389. package/node/images/transform/operations/hue/index.js +13 -26
  390. package/node/images/transform/operations/index.d.ts +3 -3
  391. package/node/images/transform/operations/index.js +3 -3
  392. package/node/images/transform/operations/level/index.js +14 -30
  393. package/node/images/transform/operations/lighten/index.js +13 -26
  394. package/node/images/transform/operations/normalize/index.js +14 -27
  395. package/node/images/transform/operations/overlay/index.js +89 -673
  396. package/node/images/transform/operations/resize/index.js +46 -610
  397. package/node/images/transform/operations/rotate/index.js +20 -584
  398. package/node/images/transform/operations/saturate/index.js +14 -27
  399. package/node/images/types.js +34 -31
  400. package/node/images/utils/index.js +84 -568
  401. package/node/index.d.ts +2 -2
  402. package/node/index.js +2 -2
  403. package/node/process/on-exit/index.js +45 -26
  404. package/node/process/prompt-continue/index.js +29 -14
  405. package/node/process/spawner/index.js +104 -134
  406. package/node/sftp/directory/copy-dir/index.js +52 -60
  407. package/node/sftp/directory/index.d.ts +1 -1
  408. package/node/sftp/directory/index.js +1 -1
  409. package/node/sftp/directory/list/index.js +22 -29
  410. package/node/sftp/directory/move-dir/index.js +35 -35
  411. package/node/sftp/directory/remove-dir/index.js +39 -42
  412. package/node/sftp/file/copy/index.js +37 -45
  413. package/node/sftp/file/download/index.js +26 -32
  414. package/node/sftp/file/exists/index.js +29 -29
  415. package/node/sftp/file/index.d.ts +2 -2
  416. package/node/sftp/file/index.js +2 -2
  417. package/node/sftp/file/move/index.js +39 -38
  418. package/node/sftp/file/remove/index.js +31 -34
  419. package/node/sftp/file/stat/index.js +26 -37
  420. package/node/sftp/file/upload/index.js +34 -38
  421. package/package.json +1 -1
@@ -1,68 +1,136 @@
1
- // src/agnostic/strings/char-codes/index.ts
2
- function charCodeToB36(charCode) {
3
- if (charCode === null) return "\0";
4
- return charCode.toString(36);
1
+ // CharCode to/from B36CharCode
2
+ /**
3
+ * Converts a Unicode character code to a base-36 string.
4
+ * @param charCode - The character code to convert.
5
+ * @returns Base-36 encoded character code.
6
+ */
7
+ export function charCodeToB36(charCode) {
8
+ if (charCode === null)
9
+ return '\x00';
10
+ return charCode.toString(36);
5
11
  }
6
- function b36CharCodeToCharCode(b36CharCode) {
7
- if (b36CharCode === null) return 0;
8
- const charCode = parseInt(b36CharCode, 36);
9
- if (!Number.isInteger(charCode)) return 0;
10
- return charCode;
12
+ /**
13
+ * Converts a base-36 character code string back to a Unicode character code.
14
+ * @param b36CharCode - Base-36 encoded character code.
15
+ * @returns Unicode character code.
16
+ */
17
+ export function b36CharCodeToCharCode(b36CharCode) {
18
+ if (b36CharCode === null)
19
+ return 0;
20
+ const charCode = parseInt(b36CharCode, 36);
21
+ if (!Number.isInteger(charCode))
22
+ return 0;
23
+ return charCode;
11
24
  }
12
- function charToCharCode(char) {
13
- const charCode = char.charCodeAt(0);
14
- if (!Number.isInteger(charCode)) return 0;
15
- return charCode;
25
+ // Char to
26
+ /**
27
+ * Converts a single character to its Unicode character code.
28
+ * @param char - The character to convert.
29
+ * @returns Unicode character code.
30
+ */
31
+ export function charToCharCode(char) {
32
+ const charCode = char.charCodeAt(0);
33
+ if (!Number.isInteger(charCode))
34
+ return 0;
35
+ return charCode;
16
36
  }
17
- function charToB36CharCode(char) {
18
- const charCode = charToCharCode(char);
19
- return charCodeToB36(charCode);
37
+ /**
38
+ * Converts a single character to its base-36 encoded character code.
39
+ * @param char - The character to convert.
40
+ * @returns Base-36 character code.
41
+ */
42
+ export function charToB36CharCode(char) {
43
+ const charCode = charToCharCode(char);
44
+ return charCodeToB36(charCode);
20
45
  }
21
- function charFromCharCode(charCode) {
22
- return String.fromCharCode(charCode);
46
+ // Char from
47
+ /**
48
+ * Returns the character corresponding to a Unicode character code.
49
+ * @param charCode - Unicode character code.
50
+ * @returns Single-character string.
51
+ */
52
+ export function charFromCharCode(charCode) {
53
+ return String.fromCharCode(charCode);
23
54
  }
24
- function charFromB36CharCode(b36CharCode) {
25
- const charCode = parseInt(b36CharCode, 36);
26
- if (!Number.isInteger(charCode)) return "\0";
27
- return charFromCharCode(charCode);
55
+ /**
56
+ * Returns the character corresponding to a base-36 encoded character code.
57
+ * @param b36CharCode - Base-36 character code.
58
+ * @returns Single-character string.
59
+ */
60
+ export function charFromB36CharCode(b36CharCode) {
61
+ const charCode = parseInt(b36CharCode, 36);
62
+ if (!Number.isInteger(charCode))
63
+ return '\x00';
64
+ return charFromCharCode(charCode);
28
65
  }
29
- function toCharCodes(string) {
30
- const chars = string.split("");
31
- return chars.map(charToCharCode);
66
+ // String to
67
+ /**
68
+ * Converts a string into an array of Unicode character codes.
69
+ * @param string - Input string.
70
+ * @returns Array of character codes.
71
+ */
72
+ export function toCharCodes(string) {
73
+ const chars = string.split('');
74
+ return chars.map(charToCharCode);
32
75
  }
33
- function toB36CharCodes(string) {
34
- const chars = string.split("");
35
- return chars.map(charToB36CharCode);
76
+ /**
77
+ * Converts a string into an array of base-36 encoded character codes.
78
+ * @param string - Input string.
79
+ * @returns Array of base-36 character codes.
80
+ */
81
+ export function toB36CharCodes(string) {
82
+ const chars = string.split('');
83
+ return chars.map(charToB36CharCode);
36
84
  }
37
- function fromCharCodes(charCodes) {
38
- return charCodes.map(charFromCharCode).map((char) => char ?? "\0").join("");
85
+ // String from
86
+ /**
87
+ * Converts an array of Unicode character codes back to a string.
88
+ * @param charCodes - Array of character codes.
89
+ * @returns Reconstructed string.
90
+ */
91
+ export function fromCharCodes(charCodes) {
92
+ return charCodes
93
+ .map(charFromCharCode)
94
+ .map(char => char ?? '\x00')
95
+ .join('');
39
96
  }
40
- function fromB36CharCodes(b36CharCodes) {
41
- return b36CharCodes.map(charFromB36CharCode).map((char) => char ?? "\0").join("");
97
+ /**
98
+ * Converts an array of base-36 encoded character codes back to a string.
99
+ * @param b36CharCodes - Array of base-36 character codes.
100
+ * @returns Reconstructed string.
101
+ */
102
+ export function fromB36CharCodes(b36CharCodes) {
103
+ return b36CharCodes
104
+ .map(charFromB36CharCode)
105
+ .map(char => char ?? '\x00')
106
+ .join('');
42
107
  }
43
- function serialize(charCodes) {
44
- return charCodes.map((c) => typeof c === "string" ? c : charCodeToB36(c)).join(",");
108
+ // Serialization
109
+ /**
110
+ * Serializes an array of character codes (Unicode or base-36) into a string.
111
+ * @param charCodes - Array of character codes to serialize.
112
+ * @returns Serialized string representation.
113
+ */
114
+ export function serialize(charCodes) {
115
+ return charCodes
116
+ .map(c => typeof c === 'string' ? c : charCodeToB36(c))
117
+ .join(',');
45
118
  }
46
- function deserialize(serializedCharCodes) {
47
- const b36CharCodes = serializedCharCodes.split("");
48
- return b36CharCodes.map(b36CharCodeToCharCode);
119
+ /**
120
+ * Deserializes a string of base-36 character codes into an array of Unicode character codes.
121
+ * @param serializedCharCodes - Serialized string.
122
+ * @returns Array of Unicode character codes.
123
+ */
124
+ export function deserialize(serializedCharCodes) {
125
+ const b36CharCodes = serializedCharCodes.split('');
126
+ return b36CharCodes.map(b36CharCodeToCharCode);
49
127
  }
50
- function fromSerialized(serializedCharCodes) {
51
- const charCodes = deserialize(serializedCharCodes);
52
- return fromCharCodes(charCodes);
128
+ /**
129
+ * Deserializes a string of base-36 character codes and reconstructs the original string.
130
+ * @param serializedCharCodes - Serialized string.
131
+ * @returns Original string.
132
+ */
133
+ export function fromSerialized(serializedCharCodes) {
134
+ const charCodes = deserialize(serializedCharCodes);
135
+ return fromCharCodes(charCodes);
53
136
  }
54
- export {
55
- b36CharCodeToCharCode,
56
- charCodeToB36,
57
- charFromB36CharCode,
58
- charFromCharCode,
59
- charToB36CharCode,
60
- charToCharCode,
61
- deserialize,
62
- fromB36CharCodes,
63
- fromCharCodes,
64
- fromSerialized,
65
- serialize,
66
- toB36CharCodes,
67
- toCharCodes
68
- };
@@ -1,7 +1,7 @@
1
- export * as charCodes from './char-codes/index.js'
2
1
  export * as matches from './matches/index.js'
3
2
  export * as normalizeIndent from './normalize-indent/index.js'
4
3
  export * as parseTable from './parse-table/index.js'
5
4
  export * as replaceAll from './replace-all/index.js'
6
5
  export * as toAlphanum from './to-alphanum/index.js'
7
6
  export * as trim from './trim/index.js'
7
+ export * as charCodes from './char-codes/index.js'
@@ -1,7 +1,7 @@
1
- export * as charCodes from './char-codes/index.js'
2
1
  export * as matches from './matches/index.js'
3
2
  export * as normalizeIndent from './normalize-indent/index.js'
4
3
  export * as parseTable from './parse-table/index.js'
5
4
  export * as replaceAll from './replace-all/index.js'
6
5
  export * as toAlphanum from './to-alphanum/index.js'
7
6
  export * as trim from './trim/index.js'
7
+ export * as charCodes from './char-codes/index.js'
@@ -1,19 +1,38 @@
1
- // src/agnostic/strings/matches/index.ts
2
- function matches(input, matcher) {
3
- if (typeof matcher === "string") return input === matcher;
4
- if (typeof matcher === "function") return matcher(input);
5
- return input.match(matcher) !== null;
1
+ /**
2
+ * Checks whether a string matches a single matcher.
3
+ *
4
+ * @param input - The string to test.
5
+ * @param matcher - The matcher to test against.
6
+ * @returns `true` if the input matches, otherwise `false`.
7
+ */
8
+ export function matches(input, matcher) {
9
+ if (typeof matcher === 'string')
10
+ return input === matcher;
11
+ if (typeof matcher === 'function')
12
+ return matcher(input);
13
+ return input.match(matcher) !== null;
6
14
  }
7
- function matchesSome(input, matchers) {
8
- if (!Array.isArray(matchers)) return matches(input, matchers);
9
- return matchers.some((matcher) => matches(input, matcher));
15
+ /**
16
+ * Checks whether a string matches at least one matcher in a list (or a single matcher).
17
+ *
18
+ * @param input - The string to test.
19
+ * @param matchers - A matcher or array of matchers.
20
+ * @returns `true` if the input matches at least one matcher, otherwise `false`.
21
+ */
22
+ export function matchesSome(input, matchers) {
23
+ if (!Array.isArray(matchers))
24
+ return matches(input, matchers);
25
+ return matchers.some(matcher => matches(input, matcher));
10
26
  }
11
- function matchesEvery(input, matchers) {
12
- if (!Array.isArray(matchers)) return matches(input, matchers);
13
- return matchers.every((matcher) => matches(input, matcher));
27
+ /**
28
+ * Checks whether a string matches every matcher in a list (or a single matcher).
29
+ *
30
+ * @param input - The string to test.
31
+ * @param matchers - A matcher or array of matchers.
32
+ * @returns `true` if the input matches all matchers, otherwise `false`.
33
+ */
34
+ export function matchesEvery(input, matchers) {
35
+ if (!Array.isArray(matchers))
36
+ return matches(input, matchers);
37
+ return matchers.every(matcher => matches(input, matcher));
14
38
  }
15
- export {
16
- matches,
17
- matchesEvery,
18
- matchesSome
19
- };
@@ -1,17 +1,35 @@
1
- // src/agnostic/strings/normalize-indent/index.ts
2
- function normalizeIndent(input, indentLevel = 0) {
3
- const indent = " ".repeat(indentLevel);
4
- const lines = input.split("\n");
5
- const noIndentLines = lines.map((line) => line.replace(/^\s*/igm, ""));
6
- const pipeReplacedLines = noIndentLines.map((line) => {
7
- const nbPipeCharsOnLineStart = line.match(/^\|+/igm)?.[0].length ?? 0;
8
- const noPipeLine = line.slice(nbPipeCharsOnLineStart);
9
- const replacedPipes = " ".repeat(nbPipeCharsOnLineStart);
10
- return replacedPipes + noPipeLine;
11
- });
12
- const normalizedLines = pipeReplacedLines.map((line) => indent + line);
13
- return normalizedLines.join("\n");
1
+ /**
2
+ * Normalizes the indentation of a multi-line string.
3
+ *
4
+ * Removes all existing leading whitespace, replaces leading `|` characters with spaces,
5
+ * and applies a uniform indentation to all lines.
6
+ *
7
+ * @param input - The multi-line string to normalize.
8
+ * @param indentLevel - The number of spaces to prepend to each line after normalization. Defaults to `0`.
9
+ * @returns The input string with normalized indentation.
10
+ *
11
+ * @example
12
+ * const str = `
13
+ * |function test() {
14
+ * | console.log('hi')
15
+ * |}`;
16
+ *
17
+ * console.log(normalizeIndent(str, 2));
18
+ * // Output:
19
+ * // " function test() {
20
+ * // console.log('hi')
21
+ * // }"
22
+ */
23
+ export function normalizeIndent(input, indentLevel = 0) {
24
+ const indent = (' ').repeat(indentLevel);
25
+ const lines = input.split('\n');
26
+ const noIndentLines = lines.map(line => line.replace(/^\s*/igm, ''));
27
+ const pipeReplacedLines = noIndentLines.map(line => {
28
+ const nbPipeCharsOnLineStart = line.match(/^\|+/igm)?.[0].length ?? 0;
29
+ const noPipeLine = line.slice(nbPipeCharsOnLineStart);
30
+ const replacedPipes = (' ').repeat(nbPipeCharsOnLineStart);
31
+ return replacedPipes + noPipeLine;
32
+ });
33
+ const normalizedLines = pipeReplacedLines.map(line => indent + line);
34
+ return normalizedLines.join('\n');
14
35
  }
15
- export {
16
- normalizeIndent
17
- };
@@ -1,89 +1,156 @@
1
- // src/agnostic/misc/outcome/index.ts
2
- function makeSuccess(payload) {
3
- return { success: true, payload };
4
- }
5
- function makeFailure(error) {
6
- return { success: false, error };
7
- }
8
-
9
- // src/agnostic/strings/parse-table/index.ts
10
- var defaultLineModeOptions = {
11
- mode: "line",
12
- splitLines: (i) => i.split("\n"),
13
- headerPos: 0,
14
- splitHeaderCells: (h) => h.split(" "),
15
- bodyBounds: [1, Infinity],
16
- splitBodyCells: (i) => i.split(" "),
17
- schema: (i) => i
1
+ import * as Outcome from '../../misc/outcome/index.js';
2
+ const defaultLineModeOptions = {
3
+ mode: 'line',
4
+ splitLines: i => i.split('\n'),
5
+ headerPos: 0,
6
+ splitHeaderCells: h => h.split('\t'),
7
+ bodyBounds: [1, Infinity],
8
+ splitBodyCells: i => i.split('\t'),
9
+ schema: i => i
18
10
  };
19
- var defaultColumnModeOptions = {
20
- mode: "column",
21
- splitLines: (i) => i.split("\n"),
22
- headerPos: 0,
23
- bodyBounds: [1, Infinity],
24
- columns: [],
25
- headerCellRefine: (h) => h,
26
- bodyCellRefine: (v) => v,
27
- schema: (i) => i
11
+ const defaultColumnModeOptions = {
12
+ mode: 'column',
13
+ splitLines: i => i.split('\n'),
14
+ headerPos: 0,
15
+ bodyBounds: [1, Infinity],
16
+ columns: [],
17
+ headerCellRefine: h => h,
18
+ bodyCellRefine: v => v,
19
+ schema: i => i
28
20
  };
29
- function parseTable(table, _options) {
30
- const inferredMode = "mode" in _options && _options.mode !== void 0 ? _options.mode : "columns" in _options ? "column" : "splitHeaderCells" in _options ? "line" : "line";
31
- const options = inferredMode === "column" ? { ...defaultColumnModeOptions, ..._options, mode: "column" } : { ...defaultLineModeOptions, ..._options, mode: "line" };
32
- const lines = options.splitLines(table);
33
- const headLine = lines.at(options.headerPos);
34
- if (headLine === void 0) return makeFailure(`Header line not found at position ${options.headerPos}`);
35
- if (options.mode === "line" && "splitHeaderCells" in options) {
36
- const headers = options.splitHeaderCells(headLine);
37
- const [bodyStart, bodyEnd] = options.bodyBounds;
38
- const bodyLines = lines.slice(bodyStart, bodyEnd);
39
- const bodyLinesSplit = bodyLines.map(options.splitBodyCells);
40
- const rows = [];
41
- bodyLinesSplit.forEach((lineCells) => {
42
- const row = {};
43
- const cellCount = Math.min(lineCells.length, headers.length);
44
- for (let cellPos = 0; cellPos < cellCount; cellPos++) {
45
- const cellName = headers[cellPos];
46
- const cellValue = lineCells[cellPos];
47
- if (cellName !== void 0 && cellValue !== void 0) {
48
- row[cellName] = cellValue;
49
- }
50
- }
51
- const validated = options.schema(row);
52
- if (validated !== void 0) rows.push(validated);
53
- });
54
- return makeSuccess(rows);
55
- }
56
- if (options.mode === "column" && "columns" in options) {
57
- const { columns, headerCellRefine, bodyCellRefine } = options;
58
- if (columns.length === 0) return makeFailure("Column mode requires at least one column position");
59
- const colBounds = columns.map((colStartPos, colIndex) => {
60
- const nextColStartPos = columns[colIndex + 1];
61
- return [colStartPos, nextColStartPos ?? Infinity];
62
- });
63
- const headers = colBounds.map(([start, end]) => {
64
- const rawHeader = headLine.slice(start, end);
65
- return headerCellRefine(rawHeader);
66
- });
67
- const [bodyStart, bodyEnd] = options.bodyBounds;
68
- const bodyLines = lines.slice(bodyStart, bodyEnd);
69
- const rows = [];
70
- bodyLines.forEach((line) => {
71
- const row = {};
72
- colBounds.forEach(([start, end], colIndex) => {
73
- const header = headers[colIndex];
74
- if (header !== void 0) {
75
- const rawValue = line.slice(start, end);
76
- const refinedValue = bodyCellRefine(rawValue);
77
- row[header] = refinedValue;
78
- }
79
- });
80
- const validated = options.schema(row);
81
- if (validated !== void 0) rows.push(validated);
82
- });
83
- return makeSuccess(rows);
84
- }
85
- return makeFailure("Invalid parsing mode configuration");
21
+ /**
22
+ * Parses a tabular string input into an array of typed objects.
23
+ *
24
+ * Supports two parsing modes:
25
+ * 1. **Delimiter-based** (`mode: 'line'` or when `columns` is not provided): Splits rows and cells using delimiter functions
26
+ * 2. **Fixed-width columns** (`mode: 'column'` or when `columns` is provided): Slices text at fixed character positions
27
+ *
28
+ * @template T - The type of objects in the resulting array, extending `Record<string, string>`.
29
+ * @param {string} table - The string representation of the table to parse.
30
+ * @param {Partial<ParseTableOptions<T>> & { schema: (obj: unknown) => T | undefined }} options - Configuration options.
31
+ * @param {function(unknown): T | undefined} options.schema - **Required.** Validates and transforms each row. Return `undefined` to skip invalid rows.
32
+ * @param {'line' | 'column'} [options.mode] - Parsing mode. If omitted, inferred from presence of `columns` property.
33
+ * @param {function(string): string[]} [options.splitLines] - How to split input into lines.
34
+ * @param {number} [options.headerPos=0] - Index of the header line.
35
+ * @param {[number, number]} [options.bodyBounds=[1, Infinity]] - Range of lines to parse as body rows `[start, end)`.
36
+ *
37
+ * **Delimiter-based mode options:**
38
+ * @param {function(string): string[]} [options.splitHeaderCells] - How to split header line into column names.
39
+ * @param {function(string): string[]} [options.splitBodyCells] - How to split body lines into cell values.
40
+ *
41
+ * **Fixed-width column mode options:**
42
+ * @param {number[]} [options.columns] - Starting positions for each column.
43
+ * @param {function(string): string} [options.headerCellRefine] - Clean/normalize header names.
44
+ * @param {function(string): string} [options.bodyCellRefine] - Clean/normalize cell values.
45
+ *
46
+ * @returns {Outcome.Either<T[], string>}
47
+ * - On success: `{ success: true, payload: T[] }` containing parsed rows.
48
+ * - On failure: `{ success: false, payload: string }` containing error message.
49
+ *
50
+ * @example
51
+ * // Delimiter-based parsing (TSV)
52
+ * const tsvTable = 'name\tage\nAlice\t30\nBob\t25';
53
+ * const result = parseTable(tsvTable, { schema: row => row });
54
+ * // result.payload = [{ name: 'Alice', age: '30' }, { name: 'Bob', age: '25' }]
55
+ *
56
+ * @example
57
+ * // Fixed-width column parsing
58
+ * const fixedTable = 'Name Age\nAlice 30 \nBob 25 ';
59
+ * const result = parseTable(fixedTable, {
60
+ * mode: 'column',
61
+ * columns: [0, 10],
62
+ * headerCellRefine: h => h.trim().toLowerCase(),
63
+ * bodyCellRefine: v => v.trim(),
64
+ * schema: row => row
65
+ * });
66
+ * // result.payload = [{ name: 'Alice', age: '30' }, { name: 'Bob', age: '25' }]
67
+ *
68
+ * @example
69
+ * // With schema validation
70
+ * type Person = { name: string; age: string };
71
+ * const validatePerson = (obj: unknown): Person | undefined => {
72
+ * if (typeof obj !== 'object' || obj === null) return undefined;
73
+ * const { name, age } = obj as any;
74
+ * if (typeof name !== 'string' || typeof age !== 'string') return undefined;
75
+ * return { name, age };
76
+ * };
77
+ * const result = parseTable(tsvTable, { schema: validatePerson });
78
+ */
79
+ export function parseTable(table, _options) {
80
+ // Determine mode: explicit mode, presence of 'columns', or presence of 'splitHeaderCells'
81
+ const inferredMode = 'mode' in _options && _options.mode !== undefined
82
+ ? _options.mode
83
+ : 'columns' in _options
84
+ ? 'column'
85
+ : 'splitHeaderCells' in _options
86
+ ? 'line'
87
+ : 'line'; // default to line mode
88
+ const options = inferredMode === 'column'
89
+ ? { ...defaultColumnModeOptions, ..._options, mode: 'column' }
90
+ : { ...defaultLineModeOptions, ..._options, mode: 'line' };
91
+ const lines = options.splitLines(table);
92
+ const headLine = lines.at(options.headerPos);
93
+ if (headLine === undefined)
94
+ return Outcome.makeFailure(`Header line not found at position ${options.headerPos}`);
95
+ // Delimiter-based mode (line mode)
96
+ if (options.mode === 'line' && 'splitHeaderCells' in options) {
97
+ const headers = options.splitHeaderCells(headLine);
98
+ const [bodyStart, bodyEnd] = options.bodyBounds;
99
+ const bodyLines = lines.slice(bodyStart, bodyEnd);
100
+ const bodyLinesSplit = bodyLines.map(options.splitBodyCells);
101
+ const rows = [];
102
+ bodyLinesSplit.forEach(lineCells => {
103
+ const row = {};
104
+ const cellCount = Math.min(lineCells.length, headers.length);
105
+ for (let cellPos = 0; cellPos < cellCount; cellPos++) {
106
+ const cellName = headers[cellPos];
107
+ const cellValue = lineCells[cellPos];
108
+ if (cellName !== undefined
109
+ && cellValue !== undefined) {
110
+ row[cellName] = cellValue;
111
+ }
112
+ }
113
+ const validated = options.schema(row);
114
+ if (validated !== undefined)
115
+ rows.push(validated);
116
+ });
117
+ return Outcome.makeSuccess(rows);
118
+ }
119
+ // Fixed-width column mode
120
+ if (options.mode === 'column' && 'columns' in options) {
121
+ const { columns, headerCellRefine, bodyCellRefine } = options;
122
+ if (columns.length === 0)
123
+ return Outcome.makeFailure('Column mode requires at least one column position');
124
+ // Build column boundaries: [start, end) for each column
125
+ const colBounds = columns.map((colStartPos, colIndex) => {
126
+ const nextColStartPos = columns[colIndex + 1];
127
+ return [colStartPos, nextColStartPos ?? Infinity];
128
+ });
129
+ // Extract and refine headers
130
+ const headers = colBounds.map(([start, end]) => {
131
+ const rawHeader = headLine.slice(start, end);
132
+ return headerCellRefine(rawHeader);
133
+ });
134
+ // Parse body rows
135
+ const [bodyStart, bodyEnd] = options.bodyBounds;
136
+ const bodyLines = lines.slice(bodyStart, bodyEnd);
137
+ const rows = [];
138
+ bodyLines.forEach(line => {
139
+ const row = {};
140
+ colBounds.forEach(([start, end], colIndex) => {
141
+ const header = headers[colIndex];
142
+ if (header !== undefined) {
143
+ const rawValue = line.slice(start, end);
144
+ const refinedValue = bodyCellRefine(rawValue);
145
+ row[header] = refinedValue;
146
+ }
147
+ });
148
+ const validated = options.schema(row);
149
+ if (validated !== undefined)
150
+ rows.push(validated);
151
+ });
152
+ return Outcome.makeSuccess(rows);
153
+ }
154
+ // This should never happen due to type constraints, but provides safety
155
+ return Outcome.makeFailure('Invalid parsing mode configuration');
86
156
  }
87
- export {
88
- parseTable
89
- };
@@ -1,16 +1,37 @@
1
- // src/agnostic/strings/replace-all/index.ts
2
- function replaceAll(input, pattern, replacer) {
3
- console.warn("[DEPRECATED] Use String.replaceAll instead");
4
- const found = Array.from(input.match(pattern) ?? []);
5
- const foundReplaced = typeof replacer === "string" ? found.map(() => replacer) : found.map((e) => replacer(e));
6
- const splitted = input.split(pattern);
7
- const replaced = splitted.map((chunk, chunkPos) => {
8
- const isLast = chunkPos === splitted.length - 1;
9
- if (isLast) return [chunk];
10
- return [chunk, foundReplaced[chunkPos] ?? ""];
11
- }).flat().join("");
12
- return replaced;
1
+ // [WIP] 1/ this function seem not to work all the time
2
+ // [WIP] 2/ this function is obsolete now that String.replaceAll is widely supported
3
+ /**
4
+ * Replaces all occurrences of a pattern in a string.
5
+ *
6
+ * **Deprecated:** This function is mostly obsolete now that `String.prototype.replaceAll` is widely supported.
7
+ *
8
+ * @param input - The string to operate on.
9
+ * @param pattern - The string or RegExp pattern to replace.
10
+ * @param replacer - The replacement string or a function that returns a replacement for each match.
11
+ * @returns The resulting string with all matches replaced.
12
+ *
13
+ * @deprecated Use `String.prototype.replaceAll` instead.
14
+ *
15
+ * @example
16
+ * replaceAll('foo bar foo', 'foo', 'baz')
17
+ * // => 'baz bar baz'
18
+ *
19
+ * @example
20
+ * replaceAll('abc 123 abc', /abc/g, match => match.toUpperCase())
21
+ * // => 'ABC 123 ABC'
22
+ */
23
+ export function replaceAll(input, pattern, replacer) {
24
+ console.warn('[DEPRECATED] Use String.replaceAll instead');
25
+ const found = Array.from(input.match(pattern) ?? []);
26
+ const foundReplaced = typeof replacer === 'string'
27
+ ? found.map(() => replacer)
28
+ : found.map(e => replacer(e));
29
+ const splitted = input.split(pattern);
30
+ const replaced = splitted.map((chunk, chunkPos) => {
31
+ const isLast = chunkPos === splitted.length - 1;
32
+ if (isLast)
33
+ return [chunk];
34
+ return [chunk, foundReplaced[chunkPos] ?? ''];
35
+ }).flat().join('');
36
+ return replaced;
13
37
  }
14
- export {
15
- replaceAll
16
- };