@design-edito/tools 0.4.5 → 0.4.6

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 (415) 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.js +11 -6
  11. package/agnostic/arrays/make/index.test.js +10 -0
  12. package/agnostic/arrays/random-pick/index.js +38 -22
  13. package/agnostic/arrays/random-pick/index.test.js +23 -0
  14. package/agnostic/arrays/shuffle/index.js +15 -11
  15. package/agnostic/arrays/shuffle/index.test.js +14 -0
  16. package/agnostic/booleans/is-falsy/index.js +24 -15
  17. package/agnostic/booleans/is-falsy/index.test.js +26 -0
  18. package/agnostic/colors/channels/index.js +139 -936
  19. package/agnostic/colors/channels/index.test.js +64 -0
  20. package/agnostic/colors/contrast/index.js +24 -643
  21. package/agnostic/colors/contrast/index.test.js +21 -0
  22. package/agnostic/colors/convert/index.js +811 -837
  23. package/agnostic/colors/convert/index.test.js +98 -0
  24. package/agnostic/colors/cssColorsMap.js +153 -0
  25. package/agnostic/colors/distance/index.js +66 -538
  26. package/agnostic/colors/distance/index.test.js +21 -0
  27. package/agnostic/colors/grayscale/index.js +95 -872
  28. package/agnostic/colors/grayscale/index.test.js +34 -0
  29. package/agnostic/colors/index.d.ts +2 -2
  30. package/agnostic/colors/index.js +2 -2
  31. package/agnostic/colors/invert/index.js +34 -719
  32. package/agnostic/colors/invert/index.test.js +31 -0
  33. package/agnostic/colors/lerp/index.js +75 -804
  34. package/agnostic/colors/lerp/index.test.js +55 -0
  35. package/agnostic/colors/luminance/index.js +17 -625
  36. package/agnostic/colors/luminance/index.test.js +30 -0
  37. package/agnostic/colors/palette/index.js +83 -917
  38. package/agnostic/colors/palette/index.test.js +35 -0
  39. package/agnostic/colors/rotate/index.js +35 -835
  40. package/agnostic/colors/rotate/index.test.js +45 -0
  41. package/agnostic/colors/tidy/index.js +79 -530
  42. package/agnostic/colors/tidy/index.test.js +45 -0
  43. package/agnostic/colors/typechecks/index.js +188 -250
  44. package/agnostic/colors/typechecks/index.test.js +113 -0
  45. package/agnostic/colors/types.js +1 -0
  46. package/agnostic/css/bem/index.js +134 -171
  47. package/agnostic/css/clss/index.js +64 -29
  48. package/agnostic/css/clss/index.test.js +60 -0
  49. package/agnostic/css/generate-nice-color/index.js +26 -71
  50. package/agnostic/css/generate-nice-color/index.test.js +8 -0
  51. package/agnostic/css/index.d.ts +2 -2
  52. package/agnostic/css/index.js +2 -2
  53. package/agnostic/css/is-valid-css-class-name/index.js +14 -8
  54. package/agnostic/css/is-valid-css-class-name/index.test.js +36 -0
  55. package/agnostic/css/scale/index.js +37 -50
  56. package/agnostic/css/scale/index.test.js +71 -0
  57. package/agnostic/css/styles-set/index.js +151 -178
  58. package/agnostic/errors/index.d.ts +1 -1
  59. package/agnostic/errors/index.js +1 -1
  60. package/agnostic/errors/register/index.js +45 -49
  61. package/agnostic/errors/unknown-to-string/index.js +17 -10
  62. package/agnostic/errors/unknown-to-string/index.test.js +35 -0
  63. package/agnostic/html/get-node-ancestors/index.js +29 -29
  64. package/agnostic/html/get-node-ancestors/index.test.js +58 -0
  65. package/agnostic/html/get-position-inside-parent/index.js +13 -8
  66. package/agnostic/html/get-position-inside-parent/index.test.js +56 -0
  67. package/agnostic/html/hyper-json/cast/index.js +128 -2931
  68. package/agnostic/html/hyper-json/index.js +23 -2954
  69. package/agnostic/html/hyper-json/method/index.js +10 -14
  70. package/agnostic/html/hyper-json/serialize/index.js +88 -222
  71. package/agnostic/html/hyper-json/smart-tags/coalesced/add/index.js +14 -2938
  72. package/agnostic/html/hyper-json/smart-tags/coalesced/addclass/index.js +27 -2937
  73. package/agnostic/html/hyper-json/smart-tags/coalesced/and/index.js +13 -2938
  74. package/agnostic/html/hyper-json/smart-tags/coalesced/append/index.js +34 -2938
  75. package/agnostic/html/hyper-json/smart-tags/coalesced/at/index.js +42 -2935
  76. package/agnostic/html/hyper-json/smart-tags/coalesced/call/index.js +47 -2937
  77. package/agnostic/html/hyper-json/smart-tags/coalesced/clone/index.js +10 -2939
  78. package/agnostic/html/hyper-json/smart-tags/coalesced/deleteproperties/index.js +45 -2936
  79. package/agnostic/html/hyper-json/smart-tags/coalesced/equals/index.js +22 -2938
  80. package/agnostic/html/hyper-json/smart-tags/coalesced/getattribute/index.js +26 -2938
  81. package/agnostic/html/hyper-json/smart-tags/coalesced/getproperties/index.js +19 -2938
  82. package/agnostic/html/hyper-json/smart-tags/coalesced/getproperty/index.js +67 -2935
  83. package/agnostic/html/hyper-json/smart-tags/coalesced/hjparse/index.js +21 -2937
  84. package/agnostic/html/hyper-json/smart-tags/coalesced/hjstringify/index.js +89 -2938
  85. package/agnostic/html/hyper-json/smart-tags/coalesced/if/index.js +20 -2938
  86. package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts +18 -18
  87. package/agnostic/html/hyper-json/smart-tags/coalesced/index.js +18 -18
  88. package/agnostic/html/hyper-json/smart-tags/coalesced/initialize/index.js +37 -2938
  89. package/agnostic/html/hyper-json/smart-tags/coalesced/join/index.js +16 -2938
  90. package/agnostic/html/hyper-json/smart-tags/coalesced/length/index.js +21 -2938
  91. package/agnostic/html/hyper-json/smart-tags/coalesced/map/index.js +31 -2938
  92. package/agnostic/html/hyper-json/smart-tags/coalesced/negate/index.js +10 -2939
  93. package/agnostic/html/hyper-json/smart-tags/coalesced/notrailing/index.js +33 -2938
  94. package/agnostic/html/hyper-json/smart-tags/coalesced/or/index.js +13 -2938
  95. package/agnostic/html/hyper-json/smart-tags/coalesced/pickrandom/index.js +17 -2938
  96. package/agnostic/html/hyper-json/smart-tags/coalesced/populate/index.js +59 -2938
  97. package/agnostic/html/hyper-json/smart-tags/coalesced/print/index.js +23 -2938
  98. package/agnostic/html/hyper-json/smart-tags/coalesced/push/index.js +10 -2939
  99. package/agnostic/html/hyper-json/smart-tags/coalesced/pusheach/index.js +26 -2938
  100. package/agnostic/html/hyper-json/smart-tags/coalesced/recordtoarray/index.js +10 -2939
  101. package/agnostic/html/hyper-json/smart-tags/coalesced/removeattribute/index.js +53 -2935
  102. package/agnostic/html/hyper-json/smart-tags/coalesced/removeclass/index.js +27 -2937
  103. package/agnostic/html/hyper-json/smart-tags/coalesced/renameproperty/index.js +31 -2937
  104. package/agnostic/html/hyper-json/smart-tags/coalesced/replace/index.js +55 -2940
  105. package/agnostic/html/hyper-json/smart-tags/coalesced/select/index.js +29 -2935
  106. package/agnostic/html/hyper-json/smart-tags/coalesced/set/index.js +29 -2938
  107. package/agnostic/html/hyper-json/smart-tags/coalesced/setattribute/index.js +53 -2935
  108. package/agnostic/html/hyper-json/smart-tags/coalesced/setproperty/index.js +232 -2936
  109. package/agnostic/html/hyper-json/smart-tags/coalesced/sorton/index.js +89 -2936
  110. package/agnostic/html/hyper-json/smart-tags/coalesced/split/index.js +20 -2938
  111. package/agnostic/html/hyper-json/smart-tags/coalesced/spread/index.js +23 -2939
  112. package/agnostic/html/hyper-json/smart-tags/coalesced/toarray/index.js +11 -2939
  113. package/agnostic/html/hyper-json/smart-tags/coalesced/toboolean/index.js +11 -2939
  114. package/agnostic/html/hyper-json/smart-tags/coalesced/toelement/index.js +17 -2938
  115. package/agnostic/html/hyper-json/smart-tags/coalesced/toggleclass/index.js +27 -2937
  116. package/agnostic/html/hyper-json/smart-tags/coalesced/tonodelist/index.js +11 -2939
  117. package/agnostic/html/hyper-json/smart-tags/coalesced/tonull/index.js +10 -2939
  118. package/agnostic/html/hyper-json/smart-tags/coalesced/tonumber/index.js +11 -2939
  119. package/agnostic/html/hyper-json/smart-tags/coalesced/torecord/index.js +11 -2939
  120. package/agnostic/html/hyper-json/smart-tags/coalesced/toref/index.js +11 -2939
  121. package/agnostic/html/hyper-json/smart-tags/coalesced/tostring/index.js +11 -2939
  122. package/agnostic/html/hyper-json/smart-tags/coalesced/totext/index.js +11 -2939
  123. package/agnostic/html/hyper-json/smart-tags/coalesced/transformselected/index.js +84 -2938
  124. package/agnostic/html/hyper-json/smart-tags/coalesced/trim/index.js +14 -2938
  125. package/agnostic/html/hyper-json/smart-tags/index.js +28 -181
  126. package/agnostic/html/hyper-json/smart-tags/isolated/any/index.js +12 -195
  127. package/agnostic/html/hyper-json/smart-tags/isolated/array/index.js +12 -195
  128. package/agnostic/html/hyper-json/smart-tags/isolated/boolean/index.js +12 -2939
  129. package/agnostic/html/hyper-json/smart-tags/isolated/element/index.js +24 -2938
  130. package/agnostic/html/hyper-json/smart-tags/isolated/get/index.js +18 -2938
  131. package/agnostic/html/hyper-json/smart-tags/isolated/guess/index.js +56 -2937
  132. package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts +1 -1
  133. package/agnostic/html/hyper-json/smart-tags/isolated/index.js +1 -1
  134. package/agnostic/html/hyper-json/smart-tags/isolated/nodelist/index.js +18 -2938
  135. package/agnostic/html/hyper-json/smart-tags/isolated/null/index.js +9 -193
  136. package/agnostic/html/hyper-json/smart-tags/isolated/number/index.js +16 -2938
  137. package/agnostic/html/hyper-json/smart-tags/isolated/record/index.js +12 -2938
  138. package/agnostic/html/hyper-json/smart-tags/isolated/ref/index.js +40 -2935
  139. package/agnostic/html/hyper-json/smart-tags/isolated/string/index.js +16 -2938
  140. package/agnostic/html/hyper-json/smart-tags/isolated/text/index.js +18 -2938
  141. package/agnostic/html/hyper-json/transformer/index.js +112 -148
  142. package/agnostic/html/hyper-json/tree/index.js +411 -2928
  143. package/agnostic/html/hyper-json/types/index.js +27 -18
  144. package/agnostic/html/hyper-json/utils/index.js +497 -2921
  145. package/agnostic/html/index.d.ts +2 -2
  146. package/agnostic/html/index.js +2 -2
  147. package/agnostic/html/insert-node/index.js +27 -16
  148. package/agnostic/html/insert-node/index.test.js +73 -0
  149. package/agnostic/html/placeholders/index.js +26 -29
  150. package/agnostic/html/replace-in-element/index.js +31 -48
  151. package/agnostic/html/replace-in-element/index.test.js +80 -0
  152. package/agnostic/html/selector-to-element/index.js +53 -39
  153. package/agnostic/html/selector-to-element/index.test.js +69 -0
  154. package/agnostic/html/string-to-nodes/index.js +24 -25
  155. package/agnostic/html/string-to-nodes/index.test.js +54 -0
  156. package/agnostic/index.d.ts +6 -6
  157. package/agnostic/index.js +6 -6
  158. package/agnostic/misc/assert/index.js +60 -66
  159. package/agnostic/misc/cast/index.js +123 -57
  160. package/agnostic/misc/cast/index.test.js +134 -0
  161. package/agnostic/misc/connection/index.js +55 -36
  162. package/agnostic/misc/connection/index.test.js +143 -0
  163. package/agnostic/misc/crawler/index.js +68 -46
  164. package/agnostic/misc/crawler/index.test.js +56 -0
  165. package/agnostic/misc/crossenv/detect-runtime/index.js +41 -13
  166. package/agnostic/misc/crossenv/detect-runtime/index.test.js +24 -0
  167. package/agnostic/misc/crossenv/types.js +21 -14
  168. package/agnostic/misc/crossenv/window/index.js +45 -24
  169. package/agnostic/misc/crossenv/window/index.test.js +24 -0
  170. package/agnostic/misc/data-size/index.js +182 -294
  171. package/agnostic/misc/data-size/index.test.js +100 -0
  172. package/agnostic/misc/data-size/types.js +1 -0
  173. package/agnostic/misc/index.d.ts +5 -5
  174. package/agnostic/misc/index.js +5 -5
  175. package/agnostic/misc/is-constructor-function/index.js +12 -6
  176. package/agnostic/misc/is-constructor-function/index.test.js +36 -0
  177. package/agnostic/misc/is-nullish/index.js +24 -11
  178. package/agnostic/misc/is-nullish/index.test.js +44 -0
  179. package/agnostic/misc/logs/logger/index.js +115 -140
  180. package/agnostic/misc/logs/make-text-block/index.js +13 -13
  181. package/agnostic/misc/logs/styles/index.js +29 -48
  182. package/agnostic/misc/lorem-ipsum/index.js +51 -201
  183. package/agnostic/misc/lorem-ipsum/index.test.js +49 -0
  184. package/agnostic/misc/normalize-extension/index.js +99 -88
  185. package/agnostic/misc/normalize-extension/index.test.js +40 -0
  186. package/agnostic/misc/outcome/index.js +20 -14
  187. package/agnostic/misc/outcome/index.test.js +40 -0
  188. package/agnostic/numbers/absolute-modulo/index.js +9 -6
  189. package/agnostic/numbers/absolute-modulo/index.test.js +23 -0
  190. package/agnostic/numbers/approximate-rational/index.js +86 -69
  191. package/agnostic/numbers/approximate-rational/index.test.js +90 -0
  192. package/agnostic/numbers/clamp/index.js +12 -8
  193. package/agnostic/numbers/clamp/index.test.js +24 -0
  194. package/agnostic/numbers/geometric-progressions/index.js +25 -16
  195. package/agnostic/numbers/geometric-progressions/index.test.js +45 -0
  196. package/agnostic/numbers/index.d.ts +2 -2
  197. package/agnostic/numbers/index.js +2 -2
  198. package/agnostic/numbers/interpolate/index.js +25 -10
  199. package/agnostic/numbers/interpolate/index.test.js +40 -0
  200. package/agnostic/numbers/round/index.js +30 -15
  201. package/agnostic/numbers/round/index.test.js +56 -0
  202. package/agnostic/objects/deep-get-property/index.js +30 -27
  203. package/agnostic/objects/deep-get-property/index.test.js +59 -0
  204. package/agnostic/objects/enums/is-in-enum/index.js +17 -11
  205. package/agnostic/objects/enums/is-in-enum/index.test.js +100 -0
  206. package/agnostic/objects/flatten-getters/index.js +15 -14
  207. package/agnostic/objects/flatten-getters/index.test.js +78 -0
  208. package/agnostic/objects/index.d.ts +2 -2
  209. package/agnostic/objects/index.js +2 -2
  210. package/agnostic/objects/is-object/index.js +16 -9
  211. package/agnostic/objects/is-object/index.test.js +60 -0
  212. package/agnostic/objects/is-record/index.js +12 -7
  213. package/agnostic/objects/is-record/index.test.js +48 -0
  214. package/agnostic/objects/record-format/index.js +18 -12
  215. package/agnostic/objects/record-format/index.test.js +92 -0
  216. package/agnostic/objects/record-map/index.js +16 -11
  217. package/agnostic/objects/record-map/index.test.js +56 -0
  218. package/agnostic/objects/sort-keys/index.js +15 -11
  219. package/agnostic/objects/sort-keys/index.test.js +37 -0
  220. package/agnostic/objects/validation/index.js +21 -8
  221. package/agnostic/objects/validation/index.test.js +72 -0
  222. package/agnostic/optim/index.d.ts +1 -1
  223. package/agnostic/optim/index.js +1 -1
  224. package/agnostic/optim/memoize/index.js +24 -16
  225. package/agnostic/optim/memoize/index.test.js +30 -0
  226. package/agnostic/optim/throttle-debounce/index.js +120 -102
  227. package/agnostic/optim/throttle-debounce/index.test.js +44 -0
  228. package/agnostic/optim/throttle-debounce/types.js +1 -0
  229. package/agnostic/random/hex-char/index.js +8 -10
  230. package/agnostic/random/hex-char/index.test.js +20 -0
  231. package/agnostic/random/index.d.ts +1 -1
  232. package/agnostic/random/index.js +1 -1
  233. package/agnostic/random/random/index.js +17 -14
  234. package/agnostic/random/random/index.test.js +73 -0
  235. package/agnostic/random/uuid/index.js +28 -20
  236. package/agnostic/random/uuid/index.test.js +45 -0
  237. package/agnostic/regexps/index.js +126 -84
  238. package/agnostic/regexps/index.test.js +108 -0
  239. package/agnostic/sanitization/file-name/index.js +24 -8
  240. package/agnostic/sanitization/file-name/index.test.js +23 -0
  241. package/agnostic/sanitization/html/index.js +172 -122
  242. package/agnostic/sanitization/path/index.js +23 -15
  243. package/agnostic/sanitization/path/index.test.js +18 -0
  244. package/agnostic/sanitization/types.js +1 -0
  245. package/agnostic/sanitization/user-input/index.js +36 -24
  246. package/agnostic/sanitization/user-input/index.test.js +31 -0
  247. package/agnostic/strings/char-codes/index.js +123 -55
  248. package/agnostic/strings/matches/index.js +35 -16
  249. package/agnostic/strings/normalize-indent/index.js +34 -16
  250. package/agnostic/strings/parse-table/index.js +153 -86
  251. package/agnostic/strings/replace-all/index.js +36 -15
  252. package/agnostic/strings/to-alphanum/index.js +23 -8
  253. package/agnostic/strings/trim/index.js +22 -9
  254. package/agnostic/time/dates/format-date/index.js +140 -72
  255. package/agnostic/time/duration/index.js +106 -140
  256. package/agnostic/time/timeout/index.js +24 -16
  257. package/agnostic/time/transitions/index.js +200 -158
  258. package/agnostic/time/wait/index.js +10 -8
  259. package/agnostic/typescript/types.js +1 -0
  260. package/components/BeforeAfter/index.controlled.js +95 -0
  261. package/components/BeforeAfter/index.js +54 -189
  262. package/components/BeforeAfter/utils.js +9 -0
  263. package/components/Disclaimer/index.js +50 -110
  264. package/components/Drawer/index.js +81 -196
  265. package/components/EventListener/index.js +29 -80
  266. package/components/Gallery/index.js +146 -221
  267. package/components/Gallery/utils.js +12 -0
  268. package/components/Image/index.js +66 -293
  269. package/components/IntersectionObserver/index.js +62 -110
  270. package/components/Overlayer/index.js +59 -103
  271. package/components/Paginator/index.js +124 -155
  272. package/components/ResizeObserver/index.js +66 -119
  273. package/components/ResizeObserver/style.module.css +0 -0
  274. package/components/Scrllgngn/index.js +171 -468
  275. package/components/ScrollListener/index.js +97 -276
  276. package/components/ScrollListener/utils.js +51 -0
  277. package/components/Sequencer/index.controlled.js +67 -0
  278. package/components/Sequencer/index.js +105 -262
  279. package/components/ShadowRoot/index.js +42 -96
  280. package/components/Subtitles/index.js +107 -244
  281. package/components/Subtitles/types.js +1 -0
  282. package/components/Subtitles/utils.js +102 -0
  283. package/components/Theatre/index.js +88 -136
  284. package/components/UIModule/index.js +156 -199
  285. package/components/Video/index.js +292 -857
  286. package/components/Video/utils.js +137 -0
  287. package/components/_WIP_AudioQuote/index.js +1 -0
  288. package/components/_WIP_Icon/index.js +1 -0
  289. package/components/index.d.ts +5 -5
  290. package/components/index.js +5 -5
  291. package/components/public-classnames.js +18 -0
  292. package/components/utils/index.js +11 -11
  293. package/components/utils/types.js +1 -0
  294. package/index.d.ts +1 -1
  295. package/index.js +1 -1
  296. package/node/@aws-s3/index.test.js +6 -0
  297. package/node/@aws-s3/storage/directory/copy-dir/index.js +66 -72
  298. package/node/@aws-s3/storage/directory/index.d.ts +2 -2
  299. package/node/@aws-s3/storage/directory/index.js +2 -2
  300. package/node/@aws-s3/storage/directory/list/index.js +32 -42
  301. package/node/@aws-s3/storage/directory/move-dir/index.js +68 -86
  302. package/node/@aws-s3/storage/directory/remove-dir/index.js +56 -67
  303. package/node/@aws-s3/storage/file/copy/index.js +41 -53
  304. package/node/@aws-s3/storage/file/download/index.js +29 -40
  305. package/node/@aws-s3/storage/file/exists/index.js +35 -43
  306. package/node/@aws-s3/storage/file/index.d.ts +1 -1
  307. package/node/@aws-s3/storage/file/index.js +1 -1
  308. package/node/@aws-s3/storage/file/move/index.js +57 -63
  309. package/node/@aws-s3/storage/file/remove/index.js +35 -43
  310. package/node/@aws-s3/storage/file/stat/index.js +33 -47
  311. package/node/@aws-s3/storage/file/upload/index.js +52 -63
  312. package/node/@design-edito/index.js +1 -0
  313. package/node/@express/@multer/index.js +61 -55
  314. package/node/@google-cloud/storage/bucket/get-metadata/index.js +25 -29
  315. package/node/@google-cloud/storage/directory/copy-dir/index.js +35 -41
  316. package/node/@google-cloud/storage/directory/index.d.ts +1 -1
  317. package/node/@google-cloud/storage/directory/index.js +1 -1
  318. package/node/@google-cloud/storage/directory/list/index.js +28 -35
  319. package/node/@google-cloud/storage/directory/move-dir/index.js +43 -42
  320. package/node/@google-cloud/storage/directory/remove-dir/index.js +34 -38
  321. package/node/@google-cloud/storage/file/copy/index.js +35 -40
  322. package/node/@google-cloud/storage/file/download/index.js +27 -34
  323. package/node/@google-cloud/storage/file/exists/index.js +25 -31
  324. package/node/@google-cloud/storage/file/generate-signed-url/index.js +33 -35
  325. package/node/@google-cloud/storage/file/get-metadata/index.js +28 -31
  326. package/node/@google-cloud/storage/file/get-permissions/index.js +25 -31
  327. package/node/@google-cloud/storage/file/index.d.ts +2 -2
  328. package/node/@google-cloud/storage/file/index.js +2 -2
  329. package/node/@google-cloud/storage/file/move/index.js +38 -42
  330. package/node/@google-cloud/storage/file/remove/index.js +34 -35
  331. package/node/@google-cloud/storage/file/revoke-signed-urls/index.js +32 -95
  332. package/node/@google-cloud/storage/file/stat/index.js +34 -38
  333. package/node/@google-cloud/storage/file/update-metadata/index.js +30 -31
  334. package/node/@google-cloud/storage/file/upload/index.js +44 -46
  335. package/node/@google-cloud/storage/index.d.ts +1 -1
  336. package/node/@google-cloud/storage/index.js +1 -1
  337. package/node/cloud-storage/clients/index.js +35 -15
  338. package/node/cloud-storage/operations/copy-dir/index.js +30 -203
  339. package/node/cloud-storage/operations/copy-file/index.js +30 -152
  340. package/node/cloud-storage/operations/download-file/index.js +30 -103
  341. package/node/cloud-storage/operations/exists-file/index.js +30 -103
  342. package/node/cloud-storage/operations/index.d.ts +2 -2
  343. package/node/cloud-storage/operations/index.js +2 -2
  344. package/node/cloud-storage/operations/list-dir/index.js +29 -98
  345. package/node/cloud-storage/operations/move-dir/index.js +30 -169
  346. package/node/cloud-storage/operations/move-file/index.js +30 -157
  347. package/node/cloud-storage/operations/remove-dir/index.js +29 -159
  348. package/node/cloud-storage/operations/remove-file/index.js +29 -121
  349. package/node/cloud-storage/operations/stat-file/index.js +29 -124
  350. package/node/cloud-storage/operations/upload-file/index.js +30 -162
  351. package/node/encryption/@aes-256-gcm/buffer/index.js +31 -72
  352. package/node/encryption/@aes-256-gcm/uint8-array/index.js +55 -55
  353. package/node/encryption/key/index.js +19 -12
  354. package/node/files/index.d.ts +1 -1
  355. package/node/files/index.js +1 -1
  356. package/node/files/is-in-directory/index.js +11 -8
  357. package/node/files/read-write/index.js +11 -15
  358. package/node/files/subpaths/index.js +156 -121
  359. package/node/ftps/directory/copy-dir/index.js +55 -62
  360. package/node/ftps/directory/list/index.js +24 -29
  361. package/node/ftps/directory/move-dir/index.js +38 -38
  362. package/node/ftps/directory/remove-dir/index.js +39 -42
  363. package/node/ftps/file/copy/index.js +42 -47
  364. package/node/ftps/file/download/index.js +29 -34
  365. package/node/ftps/file/exists/index.js +38 -36
  366. package/node/ftps/file/index.d.ts +2 -2
  367. package/node/ftps/file/index.js +2 -2
  368. package/node/ftps/file/move/index.js +46 -44
  369. package/node/ftps/file/remove/index.js +36 -39
  370. package/node/ftps/file/stat/index.js +30 -38
  371. package/node/ftps/file/upload/index.js +40 -44
  372. package/node/images/create/index.js +10 -562
  373. package/node/images/format/index.js +264 -815
  374. package/node/images/metadata/index.js +10 -571
  375. package/node/images/transform/index.js +169 -1022
  376. package/node/images/transform/operations/blur/index.js +11 -24
  377. package/node/images/transform/operations/brighten/index.js +11 -24
  378. package/node/images/transform/operations/extend/index.js +25 -589
  379. package/node/images/transform/operations/extract/index.js +15 -28
  380. package/node/images/transform/operations/flatten/index.js +20 -584
  381. package/node/images/transform/operations/flip/index.js +2 -6
  382. package/node/images/transform/operations/flop/index.js +2 -6
  383. package/node/images/transform/operations/hue/index.js +13 -26
  384. package/node/images/transform/operations/index.d.ts +5 -5
  385. package/node/images/transform/operations/index.js +5 -5
  386. package/node/images/transform/operations/level/index.js +14 -30
  387. package/node/images/transform/operations/lighten/index.js +13 -26
  388. package/node/images/transform/operations/normalize/index.js +14 -27
  389. package/node/images/transform/operations/overlay/index.js +89 -673
  390. package/node/images/transform/operations/resize/index.js +46 -610
  391. package/node/images/transform/operations/rotate/index.js +20 -584
  392. package/node/images/transform/operations/saturate/index.js +14 -27
  393. package/node/images/types.js +34 -31
  394. package/node/images/utils/index.js +84 -568
  395. package/node/index.d.ts +5 -5
  396. package/node/index.js +5 -5
  397. package/node/process/on-exit/index.js +45 -26
  398. package/node/process/prompt-continue/index.js +29 -14
  399. package/node/process/spawner/index.js +104 -134
  400. package/node/sftp/directory/copy-dir/index.js +52 -60
  401. package/node/sftp/directory/index.d.ts +1 -1
  402. package/node/sftp/directory/index.js +1 -1
  403. package/node/sftp/directory/list/index.js +22 -29
  404. package/node/sftp/directory/move-dir/index.js +35 -35
  405. package/node/sftp/directory/remove-dir/index.js +39 -42
  406. package/node/sftp/file/copy/index.js +37 -45
  407. package/node/sftp/file/download/index.js +26 -32
  408. package/node/sftp/file/exists/index.js +29 -29
  409. package/node/sftp/file/index.d.ts +1 -1
  410. package/node/sftp/file/index.js +1 -1
  411. package/node/sftp/file/move/index.js +39 -38
  412. package/node/sftp/file/remove/index.js +31 -34
  413. package/node/sftp/file/stat/index.js +26 -37
  414. package/node/sftp/file/upload/index.js +34 -38
  415. 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
- };