@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,1026 +1,173 @@
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/errors/unknown-to-string/index.ts
10
- function unknownToString(unk, encoding) {
11
- if (unk instanceof Error) return unk.message;
12
- if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
13
- if (typeof unk === "string") return unk;
14
- if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
15
- return `${unk}`;
16
- }
17
-
18
- // src/agnostic/objects/is-object/index.ts
19
- function isObject(unk) {
20
- return typeof unk === "object";
21
- }
22
- function isNonNullObject(unk) {
23
- return unk !== null && isObject(unk);
24
- }
25
-
26
- // src/node/images/utils/index.ts
27
- import { readFile } from "node:fs/promises";
28
- import sharp from "sharp";
29
-
30
- // src/agnostic/numbers/absolute-modulo/index.ts
31
- function absoluteModulo(nbr, modulo) {
32
- return (nbr % modulo + modulo) % modulo;
33
- }
34
-
35
- // src/agnostic/colors/cssColorsMap.ts
36
- var cssColors = {
37
- aliceblue: { r: 240, g: 248, b: 255 },
38
- antiquewhite: { r: 250, g: 235, b: 215 },
39
- aqua: { r: 0, g: 255, b: 255 },
40
- aquamarine: { r: 127, g: 255, b: 212 },
41
- azure: { r: 240, g: 255, b: 255 },
42
- beige: { r: 245, g: 245, b: 220 },
43
- bisque: { r: 255, g: 228, b: 196 },
44
- black: { r: 0, g: 0, b: 0 },
45
- blanchedalmond: { r: 255, g: 235, b: 205 },
46
- blue: { r: 0, g: 0, b: 255 },
47
- blueviolet: { r: 138, g: 43, b: 226 },
48
- brown: { r: 165, g: 42, b: 42 },
49
- burlywood: { r: 222, g: 184, b: 135 },
50
- cadetblue: { r: 95, g: 158, b: 160 },
51
- chartreuse: { r: 127, g: 255, b: 0 },
52
- chocolate: { r: 210, g: 105, b: 30 },
53
- coral: { r: 255, g: 127, b: 80 },
54
- cornflowerblue: { r: 100, g: 149, b: 237 },
55
- cornsilk: { r: 255, g: 248, b: 220 },
56
- crimson: { r: 220, g: 20, b: 60 },
57
- cyan: { r: 0, g: 255, b: 255 },
58
- darkblue: { r: 0, g: 0, b: 139 },
59
- darkcyan: { r: 0, g: 139, b: 139 },
60
- darkgoldenrod: { r: 184, g: 134, b: 11 },
61
- darkgray: { r: 169, g: 169, b: 169 },
62
- darkgreen: { r: 0, g: 100, b: 0 },
63
- darkgrey: { r: 169, g: 169, b: 169 },
64
- darkkhaki: { r: 189, g: 183, b: 107 },
65
- darkmagenta: { r: 139, g: 0, b: 139 },
66
- darkolivegreen: { r: 85, g: 107, b: 47 },
67
- darkorange: { r: 255, g: 140, b: 0 },
68
- darkorchid: { r: 153, g: 50, b: 204 },
69
- darkred: { r: 139, g: 0, b: 0 },
70
- darksalmon: { r: 233, g: 150, b: 122 },
71
- darkseagreen: { r: 143, g: 188, b: 143 },
72
- darkslateblue: { r: 72, g: 61, b: 139 },
73
- darkslategray: { r: 47, g: 79, b: 79 },
74
- darkslategrey: { r: 47, g: 79, b: 79 },
75
- darkturquoise: { r: 0, g: 206, b: 209 },
76
- darkviolet: { r: 148, g: 0, b: 211 },
77
- deeppink: { r: 255, g: 20, b: 147 },
78
- deepskyblue: { r: 0, g: 191, b: 255 },
79
- dimgray: { r: 105, g: 105, b: 105 },
80
- dimgrey: { r: 105, g: 105, b: 105 },
81
- dodgerblue: { r: 30, g: 144, b: 255 },
82
- firebrick: { r: 178, g: 34, b: 34 },
83
- floralwhite: { r: 255, g: 250, b: 240 },
84
- forestgreen: { r: 34, g: 139, b: 34 },
85
- fuchsia: { r: 255, g: 0, b: 255 },
86
- gainsboro: { r: 220, g: 220, b: 220 },
87
- ghostwhite: { r: 248, g: 248, b: 255 },
88
- gold: { r: 255, g: 215, b: 0 },
89
- goldenrod: { r: 218, g: 165, b: 32 },
90
- gray: { r: 128, g: 128, b: 128 },
91
- green: { r: 0, g: 128, b: 0 },
92
- greenyellow: { r: 173, g: 255, b: 47 },
93
- grey: { r: 128, g: 128, b: 128 },
94
- honeydew: { r: 240, g: 255, b: 240 },
95
- hotpink: { r: 255, g: 105, b: 180 },
96
- indianred: { r: 205, g: 92, b: 92 },
97
- indigo: { r: 75, g: 0, b: 130 },
98
- ivory: { r: 255, g: 255, b: 240 },
99
- khaki: { r: 240, g: 230, b: 140 },
100
- lavender: { r: 230, g: 230, b: 250 },
101
- lavenderblush: { r: 255, g: 240, b: 245 },
102
- lawngreen: { r: 124, g: 252, b: 0 },
103
- lemonchiffon: { r: 255, g: 250, b: 205 },
104
- lightblue: { r: 173, g: 216, b: 230 },
105
- lightcoral: { r: 240, g: 128, b: 128 },
106
- lightcyan: { r: 224, g: 255, b: 255 },
107
- lightgoldenrodyellow: { r: 250, g: 250, b: 210 },
108
- lightgray: { r: 211, g: 211, b: 211 },
109
- lightgreen: { r: 144, g: 238, b: 144 },
110
- lightgrey: { r: 211, g: 211, b: 211 },
111
- lightpink: { r: 255, g: 182, b: 193 },
112
- lightsalmon: { r: 255, g: 160, b: 122 },
113
- lightseagreen: { r: 32, g: 178, b: 170 },
114
- lightskyblue: { r: 135, g: 206, b: 250 },
115
- lightslategray: { r: 119, g: 136, b: 153 },
116
- lightslategrey: { r: 119, g: 136, b: 153 },
117
- lightsteelblue: { r: 176, g: 196, b: 222 },
118
- lightyellow: { r: 255, g: 255, b: 224 },
119
- lime: { r: 0, g: 255, b: 0 },
120
- limegreen: { r: 50, g: 205, b: 50 },
121
- linen: { r: 250, g: 240, b: 230 },
122
- magenta: { r: 255, g: 0, b: 255 },
123
- maroon: { r: 128, g: 0, b: 0 },
124
- mediumaquamarine: { r: 102, g: 205, b: 170 },
125
- mediumblue: { r: 0, g: 0, b: 205 },
126
- mediumorchid: { r: 186, g: 85, b: 211 },
127
- mediumpurple: { r: 147, g: 112, b: 219 },
128
- mediumseagreen: { r: 60, g: 179, b: 113 },
129
- mediumslateblue: { r: 123, g: 104, b: 238 },
130
- mediumspringgreen: { r: 0, g: 250, b: 154 },
131
- mediumturquoise: { r: 72, g: 209, b: 204 },
132
- mediumvioletred: { r: 199, g: 21, b: 133 },
133
- midnightblue: { r: 25, g: 25, b: 112 },
134
- mintcream: { r: 245, g: 255, b: 250 },
135
- mistyrose: { r: 255, g: 228, b: 225 },
136
- moccasin: { r: 255, g: 228, b: 181 },
137
- navajowhite: { r: 255, g: 222, b: 173 },
138
- navy: { r: 0, g: 0, b: 128 },
139
- oldlace: { r: 253, g: 245, b: 230 },
140
- olive: { r: 128, g: 128, b: 0 },
141
- olivedrab: { r: 107, g: 142, b: 35 },
142
- orange: { r: 255, g: 165, b: 0 },
143
- orangered: { r: 255, g: 69, b: 0 },
144
- orchid: { r: 218, g: 112, b: 214 },
145
- palegoldenrod: { r: 238, g: 232, b: 170 },
146
- palegreen: { r: 152, g: 251, b: 152 },
147
- paleturquoise: { r: 175, g: 238, b: 238 },
148
- palevioletred: { r: 219, g: 112, b: 147 },
149
- papayawhip: { r: 255, g: 239, b: 213 },
150
- peachpuff: { r: 255, g: 218, b: 185 },
151
- peru: { r: 205, g: 133, b: 63 },
152
- pink: { r: 255, g: 192, b: 203 },
153
- plum: { r: 221, g: 160, b: 221 },
154
- powderblue: { r: 176, g: 224, b: 230 },
155
- purple: { r: 128, g: 0, b: 128 },
156
- rebeccapurple: { r: 102, g: 51, b: 153 },
157
- red: { r: 255, g: 0, b: 0 },
158
- rosybrown: { r: 188, g: 143, b: 143 },
159
- royalblue: { r: 65, g: 105, b: 225 },
160
- saddlebrown: { r: 139, g: 69, b: 19 },
161
- salmon: { r: 250, g: 128, b: 114 },
162
- sandybrown: { r: 244, g: 164, b: 96 },
163
- seagreen: { r: 46, g: 139, b: 87 },
164
- seashell: { r: 255, g: 245, b: 238 },
165
- sienna: { r: 160, g: 82, b: 45 },
166
- silver: { r: 192, g: 192, b: 192 },
167
- skyblue: { r: 135, g: 206, b: 235 },
168
- slateblue: { r: 106, g: 90, b: 205 },
169
- slategray: { r: 112, g: 128, b: 144 },
170
- slategrey: { r: 112, g: 128, b: 144 },
171
- snow: { r: 255, g: 250, b: 250 },
172
- springgreen: { r: 0, g: 255, b: 127 },
173
- steelblue: { r: 70, g: 130, b: 180 },
174
- tan: { r: 210, g: 180, b: 140 },
175
- teal: { r: 0, g: 128, b: 128 },
176
- thistle: { r: 216, g: 191, b: 216 },
177
- tomato: { r: 255, g: 99, b: 71 },
178
- turquoise: { r: 64, g: 224, b: 208 },
179
- violet: { r: 238, g: 130, b: 238 },
180
- wheat: { r: 245, g: 222, b: 179 },
181
- white: { r: 255, g: 255, b: 255 },
182
- whitesmoke: { r: 245, g: 245, b: 245 },
183
- yellow: { r: 255, g: 255, b: 0 },
184
- yellowgreen: { r: 154, g: 205, b: 50 }
185
- };
186
-
187
- // src/agnostic/colors/typechecks/index.ts
188
- var isHex = (color) => {
189
- if (typeof color !== "string") return false;
190
- if (!color.startsWith("#")) return false;
191
- const withoutHash = color.slice(1);
192
- const withoutHashLength = withoutHash.length;
193
- const allowedLengths = [3, 4, 6, 8];
194
- if (!allowedLengths.includes(withoutHashLength)) return false;
195
- return /^[0-9a-f]+$/igm.test(withoutHash);
196
- };
197
- var isRgb = (color) => {
198
- if (!isNonNullObject(color)) return false;
199
- const { r, g, b, a } = color;
200
- if (typeof r !== "number") return false;
201
- if (typeof g !== "number") return false;
202
- if (typeof b !== "number") return false;
203
- if (a !== void 0 && typeof a !== "number") return false;
204
- return true;
205
- };
206
- var isHsl = (color) => {
207
- if (!isNonNullObject(color)) return false;
208
- const { h, s, l, a } = color;
209
- if (typeof h !== "number") return false;
210
- if (typeof s !== "number") return false;
211
- if (typeof l !== "number") return false;
212
- if (a !== void 0 && typeof a !== "number") return false;
213
- return true;
214
- };
215
- var isHsb = (color) => {
216
- if (!isNonNullObject(color)) return false;
217
- const { h, s, b, a } = color;
218
- if (typeof h !== "number") return false;
219
- if (typeof s !== "number") return false;
220
- if (typeof b !== "number") return false;
221
- if (a !== void 0 && typeof a !== "number") return false;
222
- return true;
223
- };
224
- var isLab = (color) => {
225
- if (!isNonNullObject(color)) return false;
226
- const { l, a, b, al } = color;
227
- if (typeof l !== "number") return false;
228
- if (typeof a !== "number") return false;
229
- if (typeof b !== "number") return false;
230
- if (al !== void 0 && typeof al !== "number") return false;
231
- return true;
232
- };
233
- var isLch = (color) => {
234
- if (!isNonNullObject(color)) return false;
235
- const { l, c, h, a } = color;
236
- if (typeof l !== "number") return false;
237
- if (typeof c !== "number") return false;
238
- if (typeof h !== "number") return false;
239
- if (a !== void 0 && typeof a !== "number") return false;
240
- return true;
241
- };
242
- var isCmyk = (color) => {
243
- if (!isNonNullObject(color)) return false;
244
- const { c, m, y, k, a } = color;
245
- if (typeof c !== "number") return false;
246
- if (typeof m !== "number") return false;
247
- if (typeof y !== "number") return false;
248
- if (typeof k !== "number") return false;
249
- if (a !== void 0 && typeof a !== "number") return false;
250
- return true;
251
- };
252
- var isXyz = (color) => {
253
- if (!isNonNullObject(color)) return false;
254
- const { x, y, z: z14, a } = color;
255
- if (typeof x !== "number") return false;
256
- if (typeof y !== "number") return false;
257
- if (typeof z14 !== "number") return false;
258
- if (a !== void 0 && typeof a !== "number") return false;
259
- return true;
260
- };
261
- var isCssColor = (color) => typeof color === "string" && cssColors[color] !== void 0;
262
- var isColor = (color) => {
263
- if (isHex(color)) return true;
264
- if (isCssColor(color)) return true;
265
- if (isRgb(color)) return true;
266
- if (isHsl(color)) return true;
267
- if (isHsb(color)) return true;
268
- if (isCmyk(color)) return true;
269
- if (isXyz(color)) return true;
270
- if (isLab(color)) return true;
271
- if (isLch(color)) return true;
272
- return false;
273
- };
274
-
275
- // src/agnostic/numbers/clamp/index.ts
276
- function clamp(num, bound1, bound2) {
277
- const min = Math.min(bound1, bound2);
278
- const max = Math.max(bound1, bound2);
279
- return Math.min(Math.max(num, min), max);
280
- }
281
-
282
- // src/agnostic/colors/tidy/index.ts
283
- function tidy(color) {
284
- const _color = color;
285
- if (isRgb(_color)) return {
286
- r: clamp(_color.r, 0, 255),
287
- g: clamp(_color.g, 0, 255),
288
- b: clamp(_color.b, 0, 255),
289
- a: clamp(_color.a ?? 1, 0, 1)
290
- };
291
- if (isHsl(_color)) return {
292
- h: absoluteModulo(_color.h, 360),
293
- s: clamp(_color.s, 0, 100),
294
- l: clamp(_color.l, 0, 100),
295
- a: clamp(_color.a ?? 1, 0, 1)
296
- };
297
- if (isHsb(_color)) return {
298
- h: absoluteModulo(_color.h, 360),
299
- s: clamp(_color.s, 0, 100),
300
- b: clamp(_color.b, 0, 100),
301
- a: clamp(_color.a ?? 1, 0, 1)
302
- };
303
- if (isCmyk(_color)) return {
304
- c: clamp(_color.c, 0, 100),
305
- m: clamp(_color.m, 0, 100),
306
- y: clamp(_color.y, 0, 100),
307
- k: clamp(_color.k, 0, 100),
308
- a: clamp(_color.a ?? 1, 0, 1)
309
- };
310
- if (isXyz(_color)) return {
311
- x: _color.x,
312
- y: _color.y,
313
- z: _color.z,
314
- a: clamp(_color.a ?? 1, 0, 1)
315
- };
316
- if (isLab(_color)) return {
317
- l: clamp(_color.l, 0, 100),
318
- a: _color.a,
319
- b: _color.b,
320
- al: clamp(_color.al ?? 1, 0, 1)
321
- };
322
- if (isLch(_color)) return {
323
- l: clamp(_color.l, 0, 100),
324
- c: Math.max(0, _color.c),
325
- h: clamp(_color.h, 0, 360),
326
- a: clamp(_color.a ?? 1, 0, 1)
327
- };
328
- if (isCssColor(_color)) return tidy(toRgb(_color));
329
- if (isHex(_color)) return toHex(tidy(toRgb(_color)));
330
- const _typecheck = true;
331
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
332
- }
333
-
334
- // src/agnostic/colors/convert/index.ts
335
- function _hex2rgb(hex) {
336
- if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
337
- let hexString = hex;
338
- const inputHex = hexString;
339
- const startsWithHash = hexString.startsWith("#");
340
- if (!startsWithHash) throw new Error(`invalid hex color ${inputHex}`);
341
- hexString = hexString.slice(1);
342
- if (hexString.length === 3) {
343
- hexString = hexString.split("").map((c) => c + c).join("") + "ff";
344
- } else if (hexString.length === 4) {
345
- hexString = hexString.split("").map((c) => c + c).join("");
346
- } else if (hexString.length === 6) {
347
- hexString = hexString + "ff";
348
- } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
349
- const r = parseInt(hexString.slice(0, 2), 16);
350
- const g = parseInt(hexString.slice(2, 4), 16);
351
- const b = parseInt(hexString.slice(4, 6), 16);
352
- const a = parseInt(hexString.slice(6, 8), 16) / 255;
353
- return { r, g, b, a };
354
- }
355
- function _rgb2hex(rgb) {
356
- const { r, g, b, a = 1 } = rgb;
357
- const rHex = Math.round(r).toString(16).padStart(2, "0");
358
- const gHex = Math.round(g).toString(16).padStart(2, "0");
359
- const bHex = Math.round(b).toString(16).padStart(2, "0");
360
- const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
361
- const returned = `#${rHex}${gHex}${bHex}${aHex}`;
362
- if (!isHex(returned)) {
363
- throw new Error(`invalid hex color output ${unknownToString(returned)}`);
364
- }
365
- return returned;
366
- }
367
- function _css2rgb(color) {
368
- if (color in cssColors) return cssColors[color];
369
- return void 0;
370
- }
371
- var cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
372
- name: cssColor,
373
- hex: _rgb2hex(rgba),
374
- rgba
375
- }));
376
- function _hsl2rgb(hsl) {
377
- const { h, s, l, a = 1 } = hsl;
378
- const H = absoluteModulo(h, 360) / 360;
379
- const S = Math.max(0, Math.min(1, s / 100));
380
- const L = Math.max(0, Math.min(1, l / 100));
381
- const A = Math.max(0, Math.min(1, a));
382
- const hue2rgb = (p, q, t) => {
383
- if (t < 0) t += 1;
384
- if (t > 1) t -= 1;
385
- if (t < 1 / 6) return p + (q - p) * 6 * t;
386
- if (t < 1 / 2) return q;
387
- if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
388
- return p;
389
- };
390
- let r;
391
- let g;
392
- let b;
393
- if (S === 0) {
394
- r = g = b = L;
395
- } else {
396
- const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
397
- const p = 2 * L - q;
398
- r = hue2rgb(p, q, H + 1 / 3);
399
- g = hue2rgb(p, q, H);
400
- b = hue2rgb(p, q, H - 1 / 3);
401
- }
402
- return {
403
- r: Math.round(r * 255),
404
- g: Math.round(g * 255),
405
- b: Math.round(b * 255),
406
- a: A
407
- };
408
- }
409
- function _hsb2rgb(hsb) {
410
- const { h, s, b, a = 1 } = hsb;
411
- const H = absoluteModulo(h, 360) / 360;
412
- const S = Math.max(0, Math.min(1, s / 100));
413
- const B = Math.max(0, Math.min(1, b / 100));
414
- const A = Math.max(0, Math.min(1, a));
415
- const i = Math.floor(H * 6);
416
- const f = H * 6 - i;
417
- const p = B * (1 - S);
418
- const q = B * (1 - f * S);
419
- const t = B * (1 - (1 - f) * S);
420
- let r;
421
- let g;
422
- let blue;
423
- switch (absoluteModulo(i, 6)) {
424
- case 0:
425
- r = B;
426
- g = t;
427
- blue = p;
428
- break;
429
- case 1:
430
- r = q;
431
- g = B;
432
- blue = p;
433
- break;
434
- case 2:
435
- r = p;
436
- g = B;
437
- blue = t;
438
- break;
439
- case 3:
440
- r = p;
441
- g = q;
442
- blue = B;
443
- break;
444
- case 4:
445
- r = t;
446
- g = p;
447
- blue = B;
448
- break;
449
- case 5:
450
- r = B;
451
- g = p;
452
- blue = q;
453
- break;
454
- default:
455
- r = g = blue = 0;
456
- }
457
- return {
458
- r: Math.round(r * 255),
459
- g: Math.round(g * 255),
460
- b: Math.round(blue * 255),
461
- a: A
462
- };
463
- }
464
- function _cmyk2rgb(cmyka) {
465
- const { c, m, y, k, a = 1 } = cmyka;
466
- const C = Math.max(0, Math.min(100, c)) / 100;
467
- const M = Math.max(0, Math.min(100, m)) / 100;
468
- const Y = Math.max(0, Math.min(100, y)) / 100;
469
- const K = Math.max(0, Math.min(100, k)) / 100;
470
- const A = Math.max(0, Math.min(1, a));
471
- const R = 1 - Math.min(1, C * (1 - K) + K);
472
- const G = 1 - Math.min(1, M * (1 - K) + K);
473
- const B = 1 - Math.min(1, Y * (1 - K) + K);
474
- return {
475
- r: Math.round(R * 255),
476
- g: Math.round(G * 255),
477
- b: Math.round(B * 255),
478
- a: A
479
- };
480
- }
481
- function _xyz2rgb(xyza) {
482
- const { x, y, z: z14, a = 1 } = xyza;
483
- const X = x / 100;
484
- const Y = y / 100;
485
- const Z = z14 / 100;
486
- const A = Math.max(0, Math.min(1, a));
487
- let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
488
- let G = X * -0.969266 + Y * 1.8760108 + Z * 0.041556;
489
- let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
490
- const GAMMA_THRESHOLD = 31308e-7;
491
- const GAMMA_EXPONENT = 1 / 2.4;
492
- const GAMMA_MULT = 1.055;
493
- const GAMMA_OFFSET = 0.055;
494
- const LINEAR_DIVISOR = 12.92;
495
- const gammaCorrect = (c) => c <= GAMMA_THRESHOLD ? c * LINEAR_DIVISOR : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
496
- R = gammaCorrect(R);
497
- G = gammaCorrect(G);
498
- B = gammaCorrect(B);
499
- return {
500
- r: Math.round(Math.max(0, Math.min(1, R)) * 255),
501
- g: Math.round(Math.max(0, Math.min(1, G)) * 255),
502
- b: Math.round(Math.max(0, Math.min(1, B)) * 255),
503
- a: A
504
- };
505
- }
506
- function _lab2xyz(lab) {
507
- const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
508
- const REF_X = 95.047;
509
- const REF_Y = 100;
510
- const REF_Z = 108.883;
511
- const fy = (l + 16) / 116;
512
- const fx = fy + A / 500;
513
- const fz = fy - B / 200;
514
- const fx3 = Math.pow(fx, 3);
515
- const fz3 = Math.pow(fz, 3);
516
- const fy3 = Math.pow(fy, 3);
517
- const epsilon = 8856e-6;
518
- const kappa = 903.3;
519
- const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
520
- const Y = l > kappa * epsilon ? fy3 : l / kappa;
521
- const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
522
- return {
523
- x: X * REF_X,
524
- y: Y * REF_Y,
525
- z: Z * REF_Z,
526
- a: Math.max(0, Math.min(1, alpha))
527
- };
528
- }
529
- function _lch2lab(lch) {
530
- const { l, c, h, a = 1 } = lch;
531
- const hRad = h * Math.PI / 180;
532
- const A = c * Math.cos(hRad);
533
- const B = c * Math.sin(hRad);
534
- return { l, a: A, b: B, al: a };
535
- }
536
- function toRgb(color) {
537
- if (isRgb(color)) return color;
538
- if (isHsl(color)) return _hsl2rgb(color);
539
- if (isHsb(color)) return _hsb2rgb(color);
540
- if (isCmyk(color)) return _cmyk2rgb(color);
541
- if (isCssColor(color)) return _css2rgb(color);
542
- if (isHex(color)) return _hex2rgb(color);
543
- if (isXyz(color)) return _xyz2rgb(color);
544
- if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
545
- if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
546
- throw new Error(`Invalid color input: ${unknownToString(color)}`);
547
- }
548
- function toHex(color) {
549
- if (isHex(color)) return color;
550
- const rgbColor = toRgb(color);
551
- return _rgb2hex(rgbColor);
552
- }
553
-
554
- // src/node/images/utils/index.ts
555
- function toSharpColor(color) {
556
- const rgb = tidy(toRgb(color));
557
- return {
558
- r: rgb.r,
559
- g: rgb.g,
560
- b: rgb.b,
561
- alpha: rgb.a
562
- };
563
- }
564
- function isDuckTypedSharpInstance(obj) {
565
- if (!isNonNullObject(obj)) return false;
566
- return "avif" in obj && "clone" in obj && "gif" in obj && "heif" in obj && "jpeg" in obj && "heif" in obj && "metadata" in obj && "png" in obj && "resize" in obj && "tiff" in obj && "webp" in obj && typeof obj.avif === "function" && typeof obj.clone === "function" && typeof obj.gif === "function" && typeof obj.heif === "function" && typeof obj.jpeg === "function" && typeof obj.heif === "function" && typeof obj.metadata === "function" && typeof obj.png === "function" && typeof obj.resize === "function" && typeof obj.tiff === "function" && typeof obj.webp === "function";
567
- }
568
- function toCreateOptions(options) {
569
- return {
570
- width: options.width ?? 100,
571
- height: options.height ?? 100,
572
- channels: options.channels ?? 4,
573
- background: options.background !== void 0 ? toSharpColor(options.background) : toSharpColor("white"),
574
- noise: options.noise !== void 0 ? { ...options.noise, type: "gaussian" } : void 0,
575
- pageHeight: options.pageHeight
576
- };
577
- }
578
- async function toSharpInstance(imageLike, clone = false) {
579
- if (typeof imageLike === "string") return sharp(await readFile(imageLike));
580
- if (Buffer.isBuffer(imageLike)) return sharp(imageLike);
581
- if (isDuckTypedSharpInstance(imageLike)) return clone ? imageLike.clone() : imageLike;
582
- return sharp({ create: toCreateOptions(imageLike) });
583
- }
584
-
585
- // src/node/images/transform/operations/blur/index.ts
586
- import z from "zod";
587
- function isBlurOperationParams(obj) {
588
- const schema = z.object({ sigma: z.number() });
589
- const result = schema.safeParse(obj);
590
- if (!result.success) return makeFailure(result.error.message);
591
- return makeSuccess(result.data);
592
- }
593
- async function blur(sharpInstance, params) {
594
- return sharpInstance.blur(params.sigma);
595
- }
596
-
597
- // src/node/images/transform/operations/brighten/index.ts
598
- import z2 from "zod";
599
- function isBrightenOperationParams(obj) {
600
- const schema = z2.object({ factor: z2.number() });
601
- const result = schema.safeParse(obj);
602
- if (!result.success) return makeFailure(result.error.message);
603
- return makeSuccess(result.data);
604
- }
605
- async function brighten(sharpInstance, params) {
606
- return sharpInstance.modulate({ brightness: params.factor });
607
- }
608
-
609
- // src/node/images/transform/operations/extend/index.ts
610
- import z3 from "zod";
611
- function isExtendOperationParams(obj) {
612
- const schema = z3.object({
613
- left: z3.number().optional(),
614
- right: z3.number().optional(),
615
- top: z3.number().optional(),
616
- bottom: z3.number().optional(),
617
- extendWith: z3.optional(z3.enum(["background", "copy", "repeat", "mirror"])),
618
- background: z3.custom(isColor).optional()
619
- });
620
- const result = schema.safeParse(obj);
621
- if (!result.success) return makeFailure(result.error.message);
622
- return makeSuccess(result.data);
623
- }
624
- async function extend(sharpInstance, params) {
625
- return sharpInstance.extend({
626
- ...params,
627
- background: params.background !== void 0 ? toSharpColor(params.background) : void 0
628
- });
629
- }
630
-
631
- // src/node/images/transform/operations/extract/index.ts
632
- import z4 from "zod";
633
- function isExtractOperationParams(obj) {
634
- const schema = z4.object({
635
- left: z4.number(),
636
- top: z4.number(),
637
- width: z4.number(),
638
- height: z4.number()
639
- });
640
- const result = schema.safeParse(obj);
641
- if (!result.success) return makeFailure(result.error.message);
642
- return makeSuccess(result.data);
643
- }
644
- async function extract(sharpInstance, params) {
645
- return sharpInstance.extract(params);
646
- }
647
-
648
- // src/node/images/transform/operations/flatten/index.ts
649
- import z5 from "zod";
650
- function isFlattenOperationParams(obj) {
651
- const schema = z5.object({
652
- background: z5.custom(isColor).optional()
653
- });
654
- const result = schema.safeParse(obj);
655
- if (!result.success) return makeFailure(result.error.message);
656
- return makeSuccess(result.data);
657
- }
658
- async function flatten(sharpInstance, params) {
659
- const inputBg = params.background;
660
- const rgbBackground = inputBg !== void 0 ? toSharpColor(inputBg) : void 0;
661
- const background = rgbBackground ?? rgbBackground;
662
- return sharpInstance.flatten({ background });
663
- }
664
-
665
- // src/node/images/transform/operations/flip/index.ts
666
- async function flip(sharpInstance) {
667
- return sharpInstance.flip();
668
- }
669
-
670
- // src/node/images/transform/operations/flop/index.ts
671
- async function flop(sharpInstance) {
672
- return sharpInstance.flop();
673
- }
674
-
675
- // src/node/images/transform/operations/hue/index.ts
676
- import z6 from "zod";
677
- function isHueOperationParams(obj) {
678
- const schema = z6.object({
679
- rotateDeg: z6.number().optional()
680
- });
681
- const result = schema.safeParse(obj);
682
- if (!result.success) return makeFailure(result.error.message);
683
- return makeSuccess(result.data);
684
- }
685
- async function hue(sharpInstance, params) {
686
- return sharpInstance.modulate({ hue: params.rotateDeg });
687
- }
688
-
689
- // src/node/images/transform/operations/level/index.ts
690
- import z7 from "zod";
691
- function isLevelOperationParams(obj) {
692
- const schema = z7.object({
693
- multiplier: z7.number().optional(),
694
- offset: z7.number().optional()
695
- });
696
- const result = schema.safeParse(obj);
697
- if (!result.success) return makeFailure(result.error.message);
698
- return makeSuccess(result.data);
699
- }
700
- async function level(sharpInstance, params) {
701
- return sharpInstance.linear(
702
- params.multiplier,
703
- params.offset
704
- );
705
- }
706
-
707
- // src/node/images/transform/operations/lighten/index.ts
708
- import z8 from "zod";
709
- function isLightenOperationParams(obj) {
710
- const schema = z8.object({
711
- amount: z8.number().optional()
712
- });
713
- const result = schema.safeParse(obj);
714
- if (!result.success) return makeFailure(result.error.message);
715
- return makeSuccess(result.data);
716
- }
717
- async function lighten(sharpInstance, params) {
718
- return sharpInstance.modulate({ lightness: params.amount });
719
- }
720
-
721
- // src/node/images/transform/operations/normalize/index.ts
722
- import z9 from "zod";
723
- function isNormalizeOperationParams(obj) {
724
- const schema = z9.object({
725
- lower: z9.number().optional(),
726
- upper: z9.number().optional()
727
- });
728
- const result = schema.safeParse(obj);
729
- if (!result.success) return makeFailure(result.error.message);
730
- return makeSuccess(result.data);
731
- }
732
- async function normalize(sharpInstance, params) {
733
- return sharpInstance.normalize(params);
734
- }
735
-
736
- // src/node/images/transform/operations/overlay/index.ts
737
- import sharp2 from "sharp";
738
- import z10 from "zod";
739
- function isOverlayOperationParams(obj) {
740
- const schema = z10.object({
741
- input: z10.union([
742
- z10.custom(isDuckTypedSharpInstance),
743
- z10.custom((data) => Buffer.isBuffer(data)),
744
- z10.string(),
745
- z10.object({
746
- width: z10.number().optional(),
747
- height: z10.number().optional(),
748
- channels: z10.union([z10.literal(3), z10.literal(4)]).optional(),
749
- background: z10.custom(isColor).optional(),
750
- noise: z10.object({
751
- mean: z10.number().optional(),
752
- sigma: z10.number().optional()
753
- }).optional(),
754
- pageHeight: z10.number().optional()
755
- })
756
- ]),
757
- top: z10.number().optional(),
758
- left: z10.number().optional(),
759
- tile: z10.boolean().optional(),
760
- premultiplied: z10.boolean().optional(),
761
- density: z10.number().optional(),
762
- animated: z10.boolean().optional(),
763
- autoOrient: z10.boolean().optional(),
764
- ignoreIcc: z10.boolean().optional(),
765
- pages: z10.number().optional(),
766
- page: z10.number().optional(),
767
- blend: z10.enum([
768
- "clear",
769
- "source",
770
- "over",
771
- "in",
772
- "out",
773
- "atop",
774
- "dest",
775
- "dest-over",
776
- "dest-in",
777
- "dest-out",
778
- "dest-atop",
779
- "xor",
780
- "add",
781
- "saturate",
782
- "multiply",
783
- "screen",
784
- "overlay",
785
- "darken",
786
- "lighten",
787
- "color-dodge",
788
- "colour-dodge",
789
- "color-burn",
790
- "colour-burn",
791
- "hard-light",
792
- "soft-light",
793
- "difference",
794
- "exclusion"
795
- ]).optional(),
796
- gravity: z10.enum([
797
- "north",
798
- "northeast",
799
- "southeast",
800
- "south",
801
- "southwest",
802
- "west",
803
- "northwest",
804
- "east",
805
- "center",
806
- "centre"
807
- ]).optional()
808
- });
809
- const result = schema.safeParse(obj);
810
- if (!result.success) return makeFailure(result.error.message);
811
- return makeSuccess(result.data);
812
- }
813
- async function overlay(sharpInstance, params) {
814
- const inputBuffer = params.input instanceof Buffer ? params.input : await (await toSharpInstance(params.input)).toBuffer();
815
- return sharp2(await sharpInstance.composite([{
816
- ...params,
817
- input: inputBuffer
818
- }]).webp().toBuffer());
819
- }
820
-
821
- // src/node/images/transform/operations/resize/index.ts
822
- import z11 from "zod";
823
- function isResizeOperationParams(obj) {
824
- const schema = z11.object({
825
- width: z11.number().optional(),
826
- height: z11.number().optional(),
827
- fit: z11.enum([
828
- "contain",
829
- "cover",
830
- "fill",
831
- "inside",
832
- "outside"
833
- ]).optional(),
834
- position: z11.union([
835
- z11.number(),
836
- z11.string()
837
- ]).optional(),
838
- background: z11.custom(isColor).optional(),
839
- kernel: z11.enum([
840
- "nearest",
841
- "cubic",
842
- "linear",
843
- "mitchell",
844
- "lanczos2",
845
- "lanczos3",
846
- "mks2013",
847
- "mks2021"
848
- ]).optional(),
849
- withoutEnlargement: z11.boolean().optional(),
850
- withoutReduction: z11.boolean().optional(),
851
- fastShrinkOnLoad: z11.boolean().optional()
852
- });
853
- const result = schema.safeParse(obj);
854
- if (!result.success) return makeFailure(result.error.message);
855
- return makeSuccess(result.data);
856
- }
857
- async function resize(sharpInstance, params) {
858
- return sharpInstance.resize({
859
- ...params,
860
- background: params.background !== void 0 ? toSharpColor(params.background) : void 0
861
- });
862
- }
863
-
864
- // src/node/images/transform/operations/rotate/index.ts
865
- import z12 from "zod";
866
- function isRotateOperationParams(obj) {
867
- const schema = z12.object({
868
- angleDeg: z12.number().optional(),
869
- background: z12.custom(isColor).optional()
870
- });
871
- const result = schema.safeParse(obj);
872
- if (!result.success) return makeFailure(result.error.message);
873
- return makeSuccess(result.data);
874
- }
875
- async function rotate(sharpInstance, params) {
876
- return sharpInstance.rotate(params.angleDeg, {
877
- background: params.background !== void 0 ? toSharpColor(params.background) : void 0
878
- });
879
- }
880
-
881
- // src/node/images/transform/operations/saturate/index.ts
882
- import z13 from "zod";
883
- function isSaturateOperationParams(obj) {
884
- const schema = z13.object({
885
- saturation: z13.number().optional()
886
- });
887
- const result = schema.safeParse(obj);
888
- if (!result.success) return makeFailure(result.error.message);
889
- return makeSuccess(result.data);
890
- }
891
- async function saturate(sharpInstance, params) {
892
- return sharpInstance.modulate({
893
- saturation: params.saturation
894
- });
895
- }
896
-
897
- // src/node/images/transform/index.ts
898
- var validators = {
899
- ["blur" /* BLUR */]: isBlurOperationParams,
900
- ["brighten" /* BRIGHTEN */]: isBrightenOperationParams,
901
- ["extend" /* EXTEND */]: isExtendOperationParams,
902
- ["extract" /* EXTRACT */]: isExtractOperationParams,
903
- ["flatten" /* FLATTEN */]: isFlattenOperationParams,
904
- ["hue" /* HUE */]: isHueOperationParams,
905
- ["level" /* LEVEL */]: isLevelOperationParams,
906
- ["lighten" /* LIGHTEN */]: isLightenOperationParams,
907
- ["normalize" /* NORMALIZE */]: isNormalizeOperationParams,
908
- ["overlay" /* OVERLAY */]: isOverlayOperationParams,
909
- ["resize" /* RESIZE */]: isResizeOperationParams,
910
- ["rotate" /* ROTATE */]: isRotateOperationParams,
911
- ["saturate" /* SATURATE */]: isSaturateOperationParams
1
+ import * as Outcome from '../../../agnostic/misc/outcome/index.js';
2
+ import { unknownToString } from '../../../agnostic/errors/unknown-to-string/index.js';
3
+ import { isNonNullObject } from '../../../agnostic/objects/is-object/index.js';
4
+ import { OpName, TransformErrCodes } from '../types.js';
5
+ import { toSharpInstance } from '../utils/index.js';
6
+ import { blur, isBlurOperationParams } from './operations/blur/index.js';
7
+ import { brighten, isBrightenOperationParams } from './operations/brighten/index.js';
8
+ import { extend, isExtendOperationParams } from './operations/extend/index.js';
9
+ import { extract, isExtractOperationParams } from './operations/extract/index.js';
10
+ import { flatten, isFlattenOperationParams } from './operations/flatten/index.js';
11
+ import { flip } from './operations/flip/index.js';
12
+ import { flop } from './operations/flop/index.js';
13
+ import { hue, isHueOperationParams } from './operations/hue/index.js';
14
+ import { level, isLevelOperationParams } from './operations/level/index.js';
15
+ import { lighten, isLightenOperationParams } from './operations/lighten/index.js';
16
+ import { normalize, isNormalizeOperationParams } from './operations/normalize/index.js';
17
+ import { overlay, isOverlayOperationParams } from './operations/overlay/index.js';
18
+ import { resize, isResizeOperationParams } from './operations/resize/index.js';
19
+ import { rotate, isRotateOperationParams } from './operations/rotate/index.js';
20
+ import { saturate, isSaturateOperationParams } from './operations/saturate/index.js';
21
+ const validators = {
22
+ [OpName.BLUR]: isBlurOperationParams,
23
+ [OpName.BRIGHTEN]: isBrightenOperationParams,
24
+ [OpName.EXTEND]: isExtendOperationParams,
25
+ [OpName.EXTRACT]: isExtractOperationParams,
26
+ [OpName.FLATTEN]: isFlattenOperationParams,
27
+ [OpName.HUE]: isHueOperationParams,
28
+ [OpName.LEVEL]: isLevelOperationParams,
29
+ [OpName.LIGHTEN]: isLightenOperationParams,
30
+ [OpName.NORMALIZE]: isNormalizeOperationParams,
31
+ [OpName.OVERLAY]: isOverlayOperationParams,
32
+ [OpName.RESIZE]: isResizeOperationParams,
33
+ [OpName.ROTATE]: isRotateOperationParams,
34
+ [OpName.SATURATE]: isSaturateOperationParams
912
35
  };
913
- function isOperationDescriptor(obj) {
914
- if (!isNonNullObject(obj)) return makeFailure("Invalid operation descriptor");
915
- if (!("name" in obj) || typeof obj.name !== "string") return makeFailure("Field named 'name' in operation descriptor is required and must be a string");
916
- const name = obj.name;
917
- const validateOperation = (validatorFn) => {
918
- const result = validatorFn(obj);
919
- if (result.success) return makeSuccess({
920
- name: obj.name,
921
- ...result.payload
922
- });
923
- return makeFailure(result.error);
924
- };
925
- const simpleOperations = /* @__PURE__ */ new Set(["flip" /* FLIP */, "flop" /* FLOP */]);
926
- if (simpleOperations.has(name)) return makeSuccess({
927
- name
928
- });
929
- const validator = validators[name];
930
- if (validator !== void 0) return validateOperation(validator);
931
- return makeFailure("Invalid operation descriptor");
932
- }
933
- async function transform(input, operationsSequence, limits) {
934
- let sharpInstance = await toSharpInstance(input);
935
- const start = Date.now();
936
- const deadline = limits?.timeoutMs !== void 0 ? start + limits.timeoutMs : void 0;
937
- const runWithOpTimeout = async (op) => {
938
- return limits?.opTimeoutMs === void 0 ? await op() : await Promise.race([op(), new Promise(
939
- (resolve) => setTimeout(
940
- () => resolve("op-timeout" /* OP_TIMEOUT */),
941
- limits.opTimeoutMs
942
- )
943
- )]);
944
- };
945
- for (const operation of operationsSequence) {
946
- if (deadline !== void 0 && Date.now() > deadline) return makeFailure({
947
- code: "process-timeout" /* PROCESS_TIMEOUT */,
948
- details: "Process timed out"
949
- });
950
- let result;
951
- try {
952
- result = await runWithOpTimeout(async () => {
953
- switch (operation.name) {
954
- case "blur" /* BLUR */:
955
- return await blur(sharpInstance, operation);
956
- case "brighten" /* BRIGHTEN */:
957
- return await brighten(sharpInstance, operation);
958
- case "extend" /* EXTEND */:
959
- return await extend(sharpInstance, operation);
960
- case "extract" /* EXTRACT */:
961
- return await extract(sharpInstance, operation);
962
- case "flatten" /* FLATTEN */:
963
- return await flatten(sharpInstance, operation);
964
- case "flip" /* FLIP */:
965
- return await flip(sharpInstance);
966
- case "flop" /* FLOP */:
967
- return await flop(sharpInstance);
968
- case "hue" /* HUE */:
969
- return await hue(sharpInstance, operation);
970
- case "level" /* LEVEL */:
971
- return await level(sharpInstance, operation);
972
- case "lighten" /* LIGHTEN */:
973
- return await lighten(sharpInstance, operation);
974
- case "normalize" /* NORMALIZE */:
975
- return await normalize(sharpInstance, operation);
976
- case "overlay" /* OVERLAY */:
977
- return await overlay(sharpInstance, operation);
978
- case "resize" /* RESIZE */:
979
- return await resize(sharpInstance, operation);
980
- case "rotate" /* ROTATE */:
981
- return await rotate(sharpInstance, operation);
982
- case "saturate" /* SATURATE */:
983
- return await saturate(sharpInstance, operation);
984
- default:
985
- return sharpInstance;
986
- }
987
- });
988
- } catch (err) {
989
- return makeFailure({
990
- code: "unknown-error" /* UNKNOWN_ERROR */,
991
- details: unknownToString(err)
992
- });
993
- }
994
- if (result === "op-timeout" /* OP_TIMEOUT */) return makeFailure({
995
- code: "op-timeout" /* OP_TIMEOUT */,
996
- details: "Operation timed out"
997
- });
998
- else {
999
- sharpInstance = result;
1000
- }
1001
- if (limits === void 0) continue;
1002
- if (operation.name === "resize" /* RESIZE */ || operation.name === "extend" /* EXTEND */ || operation.name === "extract" /* EXTRACT */ || operation.name === "rotate" /* ROTATE */) {
1003
- try {
1004
- const meta = await sharpInstance.metadata();
1005
- if (limits.width !== void 0 && meta.width > limits.width) return makeFailure({
1006
- code: "width-limit-exceeded" /* WIDTH_LIMIT_EXCEEDED */,
1007
- details: `Image width exceeded the limit (${meta.width}px)`
1008
- });
1009
- if (limits.height !== void 0 && meta.height > limits.height) return makeFailure({
1010
- code: "height-limit-exceeded" /* HEIGHT_LIMIT_EXCEEDED */,
1011
- details: `Image height exceeded the limit (${meta.height}px)`
36
+ /**
37
+ * Validates and checks if an object is a valid operation descriptor.
38
+ *
39
+ * @param obj - The object to validate.
40
+ * @returns
41
+ * - On success: `Outcome.makeSuccess(descriptor)` with the validated operation descriptor.
42
+ * - On failure: `Outcome.makeFailure(errStr)` describing the validation error.
43
+ */
44
+ export function isOperationDescriptor(obj) {
45
+ if (!isNonNullObject(obj))
46
+ return Outcome.makeFailure('Invalid operation descriptor');
47
+ if (!('name' in obj) || typeof obj.name !== 'string')
48
+ return Outcome.makeFailure('Field named \'name\' in operation descriptor is required and must be a string');
49
+ const name = obj.name;
50
+ const validateOperation = (validatorFn) => {
51
+ const result = validatorFn(obj);
52
+ if (result.success)
53
+ return Outcome.makeSuccess({
54
+ name: obj.name,
55
+ ...result.payload
56
+ });
57
+ return Outcome.makeFailure(result.error);
58
+ };
59
+ const simpleOperations = new Set([OpName.FLIP, OpName.FLOP]);
60
+ if (simpleOperations.has(name))
61
+ return Outcome.makeSuccess({
62
+ name: name
1012
63
  });
1013
- } catch (err) {
1014
- return makeFailure({
1015
- code: "unknown-error" /* UNKNOWN_ERROR */,
1016
- details: `Failed to read metadata: ${unknownToString(err)}`
1017
- });
1018
- }
64
+ const validator = validators[name];
65
+ if (validator !== undefined)
66
+ return validateOperation(validator);
67
+ return Outcome.makeFailure('Invalid operation descriptor');
68
+ }
69
+ /**
70
+ * Applies a sequence of transformations to an image.
71
+ *
72
+ * The function processes operations in order, applying each transformation to the image.
73
+ * Supports timeout limits for both individual operations and the entire process, as well
74
+ * as dimension limits to prevent excessive memory usage.
75
+ *
76
+ * @param input - The image to transform. Can be a Sharp instance, Buffer, CreateOptions, or file path.
77
+ * @param operationsSequence - Array of operation descriptors to apply in sequence.
78
+ * @param [limits] - Optional limits for timeouts and dimensions. See `TransformLimits` for details.
79
+ * @returns
80
+ * - On success: `Outcome.makeSuccess(sharpInstance)` with the transformed Sharp instance.
81
+ * - On failure: `Outcome.makeFailure(error)` with error code and details.
82
+ */
83
+ export async function transform(input, operationsSequence, limits) {
84
+ let sharpInstance = await toSharpInstance(input);
85
+ const start = Date.now();
86
+ const deadline = limits?.timeoutMs !== undefined
87
+ ? start + limits.timeoutMs
88
+ : undefined;
89
+ // Wrap op with per-operation timeout
90
+ const runWithOpTimeout = async (op) => {
91
+ return limits?.opTimeoutMs === undefined
92
+ ? await op()
93
+ : await Promise.race([op(), new Promise(resolve => setTimeout(() => resolve(TransformErrCodes.OP_TIMEOUT), limits.opTimeoutMs))]);
94
+ };
95
+ for (const operation of operationsSequence) {
96
+ // Process timeout check
97
+ if (deadline !== undefined
98
+ && Date.now() > deadline)
99
+ return Outcome.makeFailure({
100
+ code: TransformErrCodes.PROCESS_TIMEOUT,
101
+ details: 'Process timed out'
102
+ });
103
+ // Apply transformation
104
+ let result;
105
+ try {
106
+ result = await runWithOpTimeout(async () => {
107
+ switch (operation.name) {
108
+ case OpName.BLUR: return await blur(sharpInstance, operation);
109
+ case OpName.BRIGHTEN: return await brighten(sharpInstance, operation);
110
+ case OpName.EXTEND: return await extend(sharpInstance, operation);
111
+ case OpName.EXTRACT: return await extract(sharpInstance, operation);
112
+ case OpName.FLATTEN: return await flatten(sharpInstance, operation);
113
+ case OpName.FLIP: return await flip(sharpInstance);
114
+ case OpName.FLOP: return await flop(sharpInstance);
115
+ case OpName.HUE: return await hue(sharpInstance, operation);
116
+ case OpName.LEVEL: return await level(sharpInstance, operation);
117
+ case OpName.LIGHTEN: return await lighten(sharpInstance, operation);
118
+ case OpName.NORMALIZE: return await normalize(sharpInstance, operation);
119
+ case OpName.OVERLAY: return await overlay(sharpInstance, operation);
120
+ case OpName.RESIZE: return await resize(sharpInstance, operation);
121
+ case OpName.ROTATE: return await rotate(sharpInstance, operation);
122
+ case OpName.SATURATE: return await saturate(sharpInstance, operation);
123
+ default: return sharpInstance;
124
+ }
125
+ });
126
+ }
127
+ catch (err) {
128
+ return Outcome.makeFailure({
129
+ code: TransformErrCodes.UNKNOWN_ERROR,
130
+ details: unknownToString(err)
131
+ });
132
+ }
133
+ // Operation timeout check
134
+ if (result === TransformErrCodes.OP_TIMEOUT)
135
+ return Outcome.makeFailure({
136
+ code: TransformErrCodes.OP_TIMEOUT,
137
+ details: 'Operation timed out'
138
+ });
139
+ else {
140
+ sharpInstance = result;
141
+ }
142
+ // Limits checks
143
+ if (limits === undefined)
144
+ continue;
145
+ if (operation.name === OpName.RESIZE
146
+ || operation.name === OpName.EXTEND
147
+ || operation.name === OpName.EXTRACT
148
+ || operation.name === OpName.ROTATE) {
149
+ try {
150
+ const meta = await sharpInstance.metadata(); // can throw
151
+ if (limits.width !== undefined
152
+ && meta.width > limits.width)
153
+ return Outcome.makeFailure({
154
+ code: TransformErrCodes.WIDTH_LIMIT_EXCEEDED,
155
+ details: `Image width exceeded the limit (${meta.width}px)`
156
+ });
157
+ if (limits.height !== undefined
158
+ && meta.height > limits.height)
159
+ return Outcome.makeFailure({
160
+ code: TransformErrCodes.HEIGHT_LIMIT_EXCEEDED,
161
+ details: `Image height exceeded the limit (${meta.height}px)`
162
+ });
163
+ }
164
+ catch (err) {
165
+ return Outcome.makeFailure({
166
+ code: TransformErrCodes.UNKNOWN_ERROR,
167
+ details: `Failed to read metadata: ${unknownToString(err)}`
168
+ });
169
+ }
170
+ }
1019
171
  }
1020
- }
1021
- return makeSuccess(sharpInstance);
172
+ return Outcome.makeSuccess(sharpInstance);
1022
173
  }
1023
- export {
1024
- isOperationDescriptor,
1025
- transform
1026
- };