@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,674 +1,90 @@
1
- // src/node/images/transform/operations/overlay/index.ts
2
- import sharp2 from "sharp";
3
- import z from "zod";
4
-
5
- // src/agnostic/misc/outcome/index.ts
6
- function makeSuccess(payload) {
7
- return { success: true, payload };
1
+ import sharp from 'sharp';
2
+ import z from 'zod';
3
+ import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
4
+ import { isColor } from '../../../../../agnostic/colors/typechecks/index.js';
5
+ import { isDuckTypedSharpInstance, toSharpInstance } from '../../../utils/index.js';
6
+ export function isOverlayOperationParams(obj) {
7
+ const schema = z.object({
8
+ input: z.union([
9
+ z.custom(isDuckTypedSharpInstance),
10
+ z.custom(data => Buffer.isBuffer(data)),
11
+ z.string(),
12
+ z.object({
13
+ width: z.number().optional(),
14
+ height: z.number().optional(),
15
+ channels: z.union([z.literal(3), z.literal(4)]).optional(),
16
+ background: z.custom(isColor).optional(),
17
+ noise: z.object({
18
+ mean: z.number().optional(),
19
+ sigma: z.number().optional()
20
+ }).optional(),
21
+ pageHeight: z.number().optional()
22
+ })
23
+ ]),
24
+ top: z.number().optional(),
25
+ left: z.number().optional(),
26
+ tile: z.boolean().optional(),
27
+ premultiplied: z.boolean().optional(),
28
+ density: z.number().optional(),
29
+ animated: z.boolean().optional(),
30
+ autoOrient: z.boolean().optional(),
31
+ ignoreIcc: z.boolean().optional(),
32
+ pages: z.number().optional(),
33
+ page: z.number().optional(),
34
+ blend: z.enum([
35
+ 'clear',
36
+ 'source',
37
+ 'over',
38
+ 'in',
39
+ 'out',
40
+ 'atop',
41
+ 'dest',
42
+ 'dest-over',
43
+ 'dest-in',
44
+ 'dest-out',
45
+ 'dest-atop',
46
+ 'xor',
47
+ 'add',
48
+ 'saturate',
49
+ 'multiply',
50
+ 'screen',
51
+ 'overlay',
52
+ 'darken',
53
+ 'lighten',
54
+ 'color-dodge',
55
+ 'colour-dodge',
56
+ 'color-burn',
57
+ 'colour-burn',
58
+ 'hard-light',
59
+ 'soft-light',
60
+ 'difference',
61
+ 'exclusion'
62
+ ]).optional(),
63
+ gravity: z.enum([
64
+ 'north',
65
+ 'northeast',
66
+ 'southeast',
67
+ 'south',
68
+ 'southwest',
69
+ 'west',
70
+ 'northwest',
71
+ 'east',
72
+ 'center',
73
+ 'centre'
74
+ ]).optional()
75
+ });
76
+ const result = schema.safeParse(obj);
77
+ if (!result.success)
78
+ return Outcome.makeFailure(result.error.message);
79
+ return Outcome.makeSuccess(result.data);
80
+ }
81
+ export async function overlay(sharpInstance, params) {
82
+ const inputBuffer = params.input instanceof Buffer
83
+ ? params.input
84
+ : await (await toSharpInstance(params.input)).toBuffer();
85
+ /* Pour pouvoir chainer plusieurs composites à la suite, on a d'abord besoin d'"applatir" l'image courante et de lui donner un format */
86
+ return sharp(await sharpInstance.composite([{
87
+ ...params,
88
+ input: inputBuffer
89
+ }]).webp().toBuffer());
8
90
  }
9
- function makeFailure(error) {
10
- return { success: false, error };
11
- }
12
-
13
- // src/agnostic/objects/is-object/index.ts
14
- function isObject(unk) {
15
- return typeof unk === "object";
16
- }
17
- function isNonNullObject(unk) {
18
- return unk !== null && isObject(unk);
19
- }
20
-
21
- // src/agnostic/colors/cssColorsMap.ts
22
- var cssColors = {
23
- aliceblue: { r: 240, g: 248, b: 255 },
24
- antiquewhite: { r: 250, g: 235, b: 215 },
25
- aqua: { r: 0, g: 255, b: 255 },
26
- aquamarine: { r: 127, g: 255, b: 212 },
27
- azure: { r: 240, g: 255, b: 255 },
28
- beige: { r: 245, g: 245, b: 220 },
29
- bisque: { r: 255, g: 228, b: 196 },
30
- black: { r: 0, g: 0, b: 0 },
31
- blanchedalmond: { r: 255, g: 235, b: 205 },
32
- blue: { r: 0, g: 0, b: 255 },
33
- blueviolet: { r: 138, g: 43, b: 226 },
34
- brown: { r: 165, g: 42, b: 42 },
35
- burlywood: { r: 222, g: 184, b: 135 },
36
- cadetblue: { r: 95, g: 158, b: 160 },
37
- chartreuse: { r: 127, g: 255, b: 0 },
38
- chocolate: { r: 210, g: 105, b: 30 },
39
- coral: { r: 255, g: 127, b: 80 },
40
- cornflowerblue: { r: 100, g: 149, b: 237 },
41
- cornsilk: { r: 255, g: 248, b: 220 },
42
- crimson: { r: 220, g: 20, b: 60 },
43
- cyan: { r: 0, g: 255, b: 255 },
44
- darkblue: { r: 0, g: 0, b: 139 },
45
- darkcyan: { r: 0, g: 139, b: 139 },
46
- darkgoldenrod: { r: 184, g: 134, b: 11 },
47
- darkgray: { r: 169, g: 169, b: 169 },
48
- darkgreen: { r: 0, g: 100, b: 0 },
49
- darkgrey: { r: 169, g: 169, b: 169 },
50
- darkkhaki: { r: 189, g: 183, b: 107 },
51
- darkmagenta: { r: 139, g: 0, b: 139 },
52
- darkolivegreen: { r: 85, g: 107, b: 47 },
53
- darkorange: { r: 255, g: 140, b: 0 },
54
- darkorchid: { r: 153, g: 50, b: 204 },
55
- darkred: { r: 139, g: 0, b: 0 },
56
- darksalmon: { r: 233, g: 150, b: 122 },
57
- darkseagreen: { r: 143, g: 188, b: 143 },
58
- darkslateblue: { r: 72, g: 61, b: 139 },
59
- darkslategray: { r: 47, g: 79, b: 79 },
60
- darkslategrey: { r: 47, g: 79, b: 79 },
61
- darkturquoise: { r: 0, g: 206, b: 209 },
62
- darkviolet: { r: 148, g: 0, b: 211 },
63
- deeppink: { r: 255, g: 20, b: 147 },
64
- deepskyblue: { r: 0, g: 191, b: 255 },
65
- dimgray: { r: 105, g: 105, b: 105 },
66
- dimgrey: { r: 105, g: 105, b: 105 },
67
- dodgerblue: { r: 30, g: 144, b: 255 },
68
- firebrick: { r: 178, g: 34, b: 34 },
69
- floralwhite: { r: 255, g: 250, b: 240 },
70
- forestgreen: { r: 34, g: 139, b: 34 },
71
- fuchsia: { r: 255, g: 0, b: 255 },
72
- gainsboro: { r: 220, g: 220, b: 220 },
73
- ghostwhite: { r: 248, g: 248, b: 255 },
74
- gold: { r: 255, g: 215, b: 0 },
75
- goldenrod: { r: 218, g: 165, b: 32 },
76
- gray: { r: 128, g: 128, b: 128 },
77
- green: { r: 0, g: 128, b: 0 },
78
- greenyellow: { r: 173, g: 255, b: 47 },
79
- grey: { r: 128, g: 128, b: 128 },
80
- honeydew: { r: 240, g: 255, b: 240 },
81
- hotpink: { r: 255, g: 105, b: 180 },
82
- indianred: { r: 205, g: 92, b: 92 },
83
- indigo: { r: 75, g: 0, b: 130 },
84
- ivory: { r: 255, g: 255, b: 240 },
85
- khaki: { r: 240, g: 230, b: 140 },
86
- lavender: { r: 230, g: 230, b: 250 },
87
- lavenderblush: { r: 255, g: 240, b: 245 },
88
- lawngreen: { r: 124, g: 252, b: 0 },
89
- lemonchiffon: { r: 255, g: 250, b: 205 },
90
- lightblue: { r: 173, g: 216, b: 230 },
91
- lightcoral: { r: 240, g: 128, b: 128 },
92
- lightcyan: { r: 224, g: 255, b: 255 },
93
- lightgoldenrodyellow: { r: 250, g: 250, b: 210 },
94
- lightgray: { r: 211, g: 211, b: 211 },
95
- lightgreen: { r: 144, g: 238, b: 144 },
96
- lightgrey: { r: 211, g: 211, b: 211 },
97
- lightpink: { r: 255, g: 182, b: 193 },
98
- lightsalmon: { r: 255, g: 160, b: 122 },
99
- lightseagreen: { r: 32, g: 178, b: 170 },
100
- lightskyblue: { r: 135, g: 206, b: 250 },
101
- lightslategray: { r: 119, g: 136, b: 153 },
102
- lightslategrey: { r: 119, g: 136, b: 153 },
103
- lightsteelblue: { r: 176, g: 196, b: 222 },
104
- lightyellow: { r: 255, g: 255, b: 224 },
105
- lime: { r: 0, g: 255, b: 0 },
106
- limegreen: { r: 50, g: 205, b: 50 },
107
- linen: { r: 250, g: 240, b: 230 },
108
- magenta: { r: 255, g: 0, b: 255 },
109
- maroon: { r: 128, g: 0, b: 0 },
110
- mediumaquamarine: { r: 102, g: 205, b: 170 },
111
- mediumblue: { r: 0, g: 0, b: 205 },
112
- mediumorchid: { r: 186, g: 85, b: 211 },
113
- mediumpurple: { r: 147, g: 112, b: 219 },
114
- mediumseagreen: { r: 60, g: 179, b: 113 },
115
- mediumslateblue: { r: 123, g: 104, b: 238 },
116
- mediumspringgreen: { r: 0, g: 250, b: 154 },
117
- mediumturquoise: { r: 72, g: 209, b: 204 },
118
- mediumvioletred: { r: 199, g: 21, b: 133 },
119
- midnightblue: { r: 25, g: 25, b: 112 },
120
- mintcream: { r: 245, g: 255, b: 250 },
121
- mistyrose: { r: 255, g: 228, b: 225 },
122
- moccasin: { r: 255, g: 228, b: 181 },
123
- navajowhite: { r: 255, g: 222, b: 173 },
124
- navy: { r: 0, g: 0, b: 128 },
125
- oldlace: { r: 253, g: 245, b: 230 },
126
- olive: { r: 128, g: 128, b: 0 },
127
- olivedrab: { r: 107, g: 142, b: 35 },
128
- orange: { r: 255, g: 165, b: 0 },
129
- orangered: { r: 255, g: 69, b: 0 },
130
- orchid: { r: 218, g: 112, b: 214 },
131
- palegoldenrod: { r: 238, g: 232, b: 170 },
132
- palegreen: { r: 152, g: 251, b: 152 },
133
- paleturquoise: { r: 175, g: 238, b: 238 },
134
- palevioletred: { r: 219, g: 112, b: 147 },
135
- papayawhip: { r: 255, g: 239, b: 213 },
136
- peachpuff: { r: 255, g: 218, b: 185 },
137
- peru: { r: 205, g: 133, b: 63 },
138
- pink: { r: 255, g: 192, b: 203 },
139
- plum: { r: 221, g: 160, b: 221 },
140
- powderblue: { r: 176, g: 224, b: 230 },
141
- purple: { r: 128, g: 0, b: 128 },
142
- rebeccapurple: { r: 102, g: 51, b: 153 },
143
- red: { r: 255, g: 0, b: 0 },
144
- rosybrown: { r: 188, g: 143, b: 143 },
145
- royalblue: { r: 65, g: 105, b: 225 },
146
- saddlebrown: { r: 139, g: 69, b: 19 },
147
- salmon: { r: 250, g: 128, b: 114 },
148
- sandybrown: { r: 244, g: 164, b: 96 },
149
- seagreen: { r: 46, g: 139, b: 87 },
150
- seashell: { r: 255, g: 245, b: 238 },
151
- sienna: { r: 160, g: 82, b: 45 },
152
- silver: { r: 192, g: 192, b: 192 },
153
- skyblue: { r: 135, g: 206, b: 235 },
154
- slateblue: { r: 106, g: 90, b: 205 },
155
- slategray: { r: 112, g: 128, b: 144 },
156
- slategrey: { r: 112, g: 128, b: 144 },
157
- snow: { r: 255, g: 250, b: 250 },
158
- springgreen: { r: 0, g: 255, b: 127 },
159
- steelblue: { r: 70, g: 130, b: 180 },
160
- tan: { r: 210, g: 180, b: 140 },
161
- teal: { r: 0, g: 128, b: 128 },
162
- thistle: { r: 216, g: 191, b: 216 },
163
- tomato: { r: 255, g: 99, b: 71 },
164
- turquoise: { r: 64, g: 224, b: 208 },
165
- violet: { r: 238, g: 130, b: 238 },
166
- wheat: { r: 245, g: 222, b: 179 },
167
- white: { r: 255, g: 255, b: 255 },
168
- whitesmoke: { r: 245, g: 245, b: 245 },
169
- yellow: { r: 255, g: 255, b: 0 },
170
- yellowgreen: { r: 154, g: 205, b: 50 }
171
- };
172
-
173
- // src/agnostic/colors/typechecks/index.ts
174
- var isHex = (color) => {
175
- if (typeof color !== "string") return false;
176
- if (!color.startsWith("#")) return false;
177
- const withoutHash = color.slice(1);
178
- const withoutHashLength = withoutHash.length;
179
- const allowedLengths = [3, 4, 6, 8];
180
- if (!allowedLengths.includes(withoutHashLength)) return false;
181
- return /^[0-9a-f]+$/igm.test(withoutHash);
182
- };
183
- var isRgb = (color) => {
184
- if (!isNonNullObject(color)) return false;
185
- const { r, g, b, a } = color;
186
- if (typeof r !== "number") return false;
187
- if (typeof g !== "number") return false;
188
- if (typeof b !== "number") return false;
189
- if (a !== void 0 && typeof a !== "number") return false;
190
- return true;
191
- };
192
- var isHsl = (color) => {
193
- if (!isNonNullObject(color)) return false;
194
- const { h, s, l, a } = color;
195
- if (typeof h !== "number") return false;
196
- if (typeof s !== "number") return false;
197
- if (typeof l !== "number") return false;
198
- if (a !== void 0 && typeof a !== "number") return false;
199
- return true;
200
- };
201
- var isHsb = (color) => {
202
- if (!isNonNullObject(color)) return false;
203
- const { h, s, b, a } = color;
204
- if (typeof h !== "number") return false;
205
- if (typeof s !== "number") return false;
206
- if (typeof b !== "number") return false;
207
- if (a !== void 0 && typeof a !== "number") return false;
208
- return true;
209
- };
210
- var isLab = (color) => {
211
- if (!isNonNullObject(color)) return false;
212
- const { l, a, b, al } = color;
213
- if (typeof l !== "number") return false;
214
- if (typeof a !== "number") return false;
215
- if (typeof b !== "number") return false;
216
- if (al !== void 0 && typeof al !== "number") return false;
217
- return true;
218
- };
219
- var isLch = (color) => {
220
- if (!isNonNullObject(color)) return false;
221
- const { l, c, h, a } = color;
222
- if (typeof l !== "number") return false;
223
- if (typeof c !== "number") return false;
224
- if (typeof h !== "number") return false;
225
- if (a !== void 0 && typeof a !== "number") return false;
226
- return true;
227
- };
228
- var isCmyk = (color) => {
229
- if (!isNonNullObject(color)) return false;
230
- const { c, m, y, k, a } = color;
231
- if (typeof c !== "number") return false;
232
- if (typeof m !== "number") return false;
233
- if (typeof y !== "number") return false;
234
- if (typeof k !== "number") return false;
235
- if (a !== void 0 && typeof a !== "number") return false;
236
- return true;
237
- };
238
- var isXyz = (color) => {
239
- if (!isNonNullObject(color)) return false;
240
- const { x, y, z: z2, a } = color;
241
- if (typeof x !== "number") return false;
242
- if (typeof y !== "number") return false;
243
- if (typeof z2 !== "number") return false;
244
- if (a !== void 0 && typeof a !== "number") return false;
245
- return true;
246
- };
247
- var isCssColor = (color) => typeof color === "string" && cssColors[color] !== void 0;
248
- var isColor = (color) => {
249
- if (isHex(color)) return true;
250
- if (isCssColor(color)) return true;
251
- if (isRgb(color)) return true;
252
- if (isHsl(color)) return true;
253
- if (isHsb(color)) return true;
254
- if (isCmyk(color)) return true;
255
- if (isXyz(color)) return true;
256
- if (isLab(color)) return true;
257
- if (isLch(color)) return true;
258
- return false;
259
- };
260
-
261
- // src/node/images/utils/index.ts
262
- import { readFile } from "node:fs/promises";
263
- import sharp from "sharp";
264
-
265
- // src/agnostic/numbers/absolute-modulo/index.ts
266
- function absoluteModulo(nbr, modulo) {
267
- return (nbr % modulo + modulo) % modulo;
268
- }
269
-
270
- // src/agnostic/numbers/clamp/index.ts
271
- function clamp(num, bound1, bound2) {
272
- const min = Math.min(bound1, bound2);
273
- const max = Math.max(bound1, bound2);
274
- return Math.min(Math.max(num, min), max);
275
- }
276
-
277
- // src/agnostic/errors/unknown-to-string/index.ts
278
- function unknownToString(unk, encoding) {
279
- if (unk instanceof Error) return unk.message;
280
- if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
281
- if (typeof unk === "string") return unk;
282
- if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
283
- return `${unk}`;
284
- }
285
-
286
- // src/agnostic/colors/tidy/index.ts
287
- function tidy(color) {
288
- const _color = color;
289
- if (isRgb(_color)) return {
290
- r: clamp(_color.r, 0, 255),
291
- g: clamp(_color.g, 0, 255),
292
- b: clamp(_color.b, 0, 255),
293
- a: clamp(_color.a ?? 1, 0, 1)
294
- };
295
- if (isHsl(_color)) return {
296
- h: absoluteModulo(_color.h, 360),
297
- s: clamp(_color.s, 0, 100),
298
- l: clamp(_color.l, 0, 100),
299
- a: clamp(_color.a ?? 1, 0, 1)
300
- };
301
- if (isHsb(_color)) return {
302
- h: absoluteModulo(_color.h, 360),
303
- s: clamp(_color.s, 0, 100),
304
- b: clamp(_color.b, 0, 100),
305
- a: clamp(_color.a ?? 1, 0, 1)
306
- };
307
- if (isCmyk(_color)) return {
308
- c: clamp(_color.c, 0, 100),
309
- m: clamp(_color.m, 0, 100),
310
- y: clamp(_color.y, 0, 100),
311
- k: clamp(_color.k, 0, 100),
312
- a: clamp(_color.a ?? 1, 0, 1)
313
- };
314
- if (isXyz(_color)) return {
315
- x: _color.x,
316
- y: _color.y,
317
- z: _color.z,
318
- a: clamp(_color.a ?? 1, 0, 1)
319
- };
320
- if (isLab(_color)) return {
321
- l: clamp(_color.l, 0, 100),
322
- a: _color.a,
323
- b: _color.b,
324
- al: clamp(_color.al ?? 1, 0, 1)
325
- };
326
- if (isLch(_color)) return {
327
- l: clamp(_color.l, 0, 100),
328
- c: Math.max(0, _color.c),
329
- h: clamp(_color.h, 0, 360),
330
- a: clamp(_color.a ?? 1, 0, 1)
331
- };
332
- if (isCssColor(_color)) return tidy(toRgb(_color));
333
- if (isHex(_color)) return toHex(tidy(toRgb(_color)));
334
- const _typecheck = true;
335
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
336
- }
337
-
338
- // src/agnostic/colors/convert/index.ts
339
- function _hex2rgb(hex) {
340
- if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
341
- let hexString = hex;
342
- const inputHex = hexString;
343
- const startsWithHash = hexString.startsWith("#");
344
- if (!startsWithHash) throw new Error(`invalid hex color ${inputHex}`);
345
- hexString = hexString.slice(1);
346
- if (hexString.length === 3) {
347
- hexString = hexString.split("").map((c) => c + c).join("") + "ff";
348
- } else if (hexString.length === 4) {
349
- hexString = hexString.split("").map((c) => c + c).join("");
350
- } else if (hexString.length === 6) {
351
- hexString = hexString + "ff";
352
- } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
353
- const r = parseInt(hexString.slice(0, 2), 16);
354
- const g = parseInt(hexString.slice(2, 4), 16);
355
- const b = parseInt(hexString.slice(4, 6), 16);
356
- const a = parseInt(hexString.slice(6, 8), 16) / 255;
357
- return { r, g, b, a };
358
- }
359
- function _rgb2hex(rgb) {
360
- const { r, g, b, a = 1 } = rgb;
361
- const rHex = Math.round(r).toString(16).padStart(2, "0");
362
- const gHex = Math.round(g).toString(16).padStart(2, "0");
363
- const bHex = Math.round(b).toString(16).padStart(2, "0");
364
- const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
365
- const returned = `#${rHex}${gHex}${bHex}${aHex}`;
366
- if (!isHex(returned)) {
367
- throw new Error(`invalid hex color output ${unknownToString(returned)}`);
368
- }
369
- return returned;
370
- }
371
- function _css2rgb(color) {
372
- if (color in cssColors) return cssColors[color];
373
- return void 0;
374
- }
375
- var cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
376
- name: cssColor,
377
- hex: _rgb2hex(rgba),
378
- rgba
379
- }));
380
- function _hsl2rgb(hsl) {
381
- const { h, s, l, a = 1 } = hsl;
382
- const H = absoluteModulo(h, 360) / 360;
383
- const S = Math.max(0, Math.min(1, s / 100));
384
- const L = Math.max(0, Math.min(1, l / 100));
385
- const A = Math.max(0, Math.min(1, a));
386
- const hue2rgb = (p, q, t) => {
387
- if (t < 0) t += 1;
388
- if (t > 1) t -= 1;
389
- if (t < 1 / 6) return p + (q - p) * 6 * t;
390
- if (t < 1 / 2) return q;
391
- if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
392
- return p;
393
- };
394
- let r;
395
- let g;
396
- let b;
397
- if (S === 0) {
398
- r = g = b = L;
399
- } else {
400
- const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
401
- const p = 2 * L - q;
402
- r = hue2rgb(p, q, H + 1 / 3);
403
- g = hue2rgb(p, q, H);
404
- b = hue2rgb(p, q, H - 1 / 3);
405
- }
406
- return {
407
- r: Math.round(r * 255),
408
- g: Math.round(g * 255),
409
- b: Math.round(b * 255),
410
- a: A
411
- };
412
- }
413
- function _hsb2rgb(hsb) {
414
- const { h, s, b, a = 1 } = hsb;
415
- const H = absoluteModulo(h, 360) / 360;
416
- const S = Math.max(0, Math.min(1, s / 100));
417
- const B = Math.max(0, Math.min(1, b / 100));
418
- const A = Math.max(0, Math.min(1, a));
419
- const i = Math.floor(H * 6);
420
- const f = H * 6 - i;
421
- const p = B * (1 - S);
422
- const q = B * (1 - f * S);
423
- const t = B * (1 - (1 - f) * S);
424
- let r;
425
- let g;
426
- let blue;
427
- switch (absoluteModulo(i, 6)) {
428
- case 0:
429
- r = B;
430
- g = t;
431
- blue = p;
432
- break;
433
- case 1:
434
- r = q;
435
- g = B;
436
- blue = p;
437
- break;
438
- case 2:
439
- r = p;
440
- g = B;
441
- blue = t;
442
- break;
443
- case 3:
444
- r = p;
445
- g = q;
446
- blue = B;
447
- break;
448
- case 4:
449
- r = t;
450
- g = p;
451
- blue = B;
452
- break;
453
- case 5:
454
- r = B;
455
- g = p;
456
- blue = q;
457
- break;
458
- default:
459
- r = g = blue = 0;
460
- }
461
- return {
462
- r: Math.round(r * 255),
463
- g: Math.round(g * 255),
464
- b: Math.round(blue * 255),
465
- a: A
466
- };
467
- }
468
- function _cmyk2rgb(cmyka) {
469
- const { c, m, y, k, a = 1 } = cmyka;
470
- const C = Math.max(0, Math.min(100, c)) / 100;
471
- const M = Math.max(0, Math.min(100, m)) / 100;
472
- const Y = Math.max(0, Math.min(100, y)) / 100;
473
- const K = Math.max(0, Math.min(100, k)) / 100;
474
- const A = Math.max(0, Math.min(1, a));
475
- const R = 1 - Math.min(1, C * (1 - K) + K);
476
- const G = 1 - Math.min(1, M * (1 - K) + K);
477
- const B = 1 - Math.min(1, Y * (1 - K) + K);
478
- return {
479
- r: Math.round(R * 255),
480
- g: Math.round(G * 255),
481
- b: Math.round(B * 255),
482
- a: A
483
- };
484
- }
485
- function _xyz2rgb(xyza) {
486
- const { x, y, z: z2, a = 1 } = xyza;
487
- const X = x / 100;
488
- const Y = y / 100;
489
- const Z = z2 / 100;
490
- const A = Math.max(0, Math.min(1, a));
491
- let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
492
- let G = X * -0.969266 + Y * 1.8760108 + Z * 0.041556;
493
- let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
494
- const GAMMA_THRESHOLD = 31308e-7;
495
- const GAMMA_EXPONENT = 1 / 2.4;
496
- const GAMMA_MULT = 1.055;
497
- const GAMMA_OFFSET = 0.055;
498
- const LINEAR_DIVISOR = 12.92;
499
- const gammaCorrect = (c) => c <= GAMMA_THRESHOLD ? c * LINEAR_DIVISOR : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
500
- R = gammaCorrect(R);
501
- G = gammaCorrect(G);
502
- B = gammaCorrect(B);
503
- return {
504
- r: Math.round(Math.max(0, Math.min(1, R)) * 255),
505
- g: Math.round(Math.max(0, Math.min(1, G)) * 255),
506
- b: Math.round(Math.max(0, Math.min(1, B)) * 255),
507
- a: A
508
- };
509
- }
510
- function _lab2xyz(lab) {
511
- const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
512
- const REF_X = 95.047;
513
- const REF_Y = 100;
514
- const REF_Z = 108.883;
515
- const fy = (l + 16) / 116;
516
- const fx = fy + A / 500;
517
- const fz = fy - B / 200;
518
- const fx3 = Math.pow(fx, 3);
519
- const fz3 = Math.pow(fz, 3);
520
- const fy3 = Math.pow(fy, 3);
521
- const epsilon = 8856e-6;
522
- const kappa = 903.3;
523
- const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
524
- const Y = l > kappa * epsilon ? fy3 : l / kappa;
525
- const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
526
- return {
527
- x: X * REF_X,
528
- y: Y * REF_Y,
529
- z: Z * REF_Z,
530
- a: Math.max(0, Math.min(1, alpha))
531
- };
532
- }
533
- function _lch2lab(lch) {
534
- const { l, c, h, a = 1 } = lch;
535
- const hRad = h * Math.PI / 180;
536
- const A = c * Math.cos(hRad);
537
- const B = c * Math.sin(hRad);
538
- return { l, a: A, b: B, al: a };
539
- }
540
- function toRgb(color) {
541
- if (isRgb(color)) return color;
542
- if (isHsl(color)) return _hsl2rgb(color);
543
- if (isHsb(color)) return _hsb2rgb(color);
544
- if (isCmyk(color)) return _cmyk2rgb(color);
545
- if (isCssColor(color)) return _css2rgb(color);
546
- if (isHex(color)) return _hex2rgb(color);
547
- if (isXyz(color)) return _xyz2rgb(color);
548
- if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
549
- if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
550
- throw new Error(`Invalid color input: ${unknownToString(color)}`);
551
- }
552
- function toHex(color) {
553
- if (isHex(color)) return color;
554
- const rgbColor = toRgb(color);
555
- return _rgb2hex(rgbColor);
556
- }
557
-
558
- // src/node/images/utils/index.ts
559
- function toSharpColor(color) {
560
- const rgb = tidy(toRgb(color));
561
- return {
562
- r: rgb.r,
563
- g: rgb.g,
564
- b: rgb.b,
565
- alpha: rgb.a
566
- };
567
- }
568
- function isDuckTypedSharpInstance(obj) {
569
- if (!isNonNullObject(obj)) return false;
570
- 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";
571
- }
572
- function toCreateOptions(options) {
573
- return {
574
- width: options.width ?? 100,
575
- height: options.height ?? 100,
576
- channels: options.channels ?? 4,
577
- background: options.background !== void 0 ? toSharpColor(options.background) : toSharpColor("white"),
578
- noise: options.noise !== void 0 ? { ...options.noise, type: "gaussian" } : void 0,
579
- pageHeight: options.pageHeight
580
- };
581
- }
582
- async function toSharpInstance(imageLike, clone = false) {
583
- if (typeof imageLike === "string") return sharp(await readFile(imageLike));
584
- if (Buffer.isBuffer(imageLike)) return sharp(imageLike);
585
- if (isDuckTypedSharpInstance(imageLike)) return clone ? imageLike.clone() : imageLike;
586
- return sharp({ create: toCreateOptions(imageLike) });
587
- }
588
-
589
- // src/node/images/transform/operations/overlay/index.ts
590
- function isOverlayOperationParams(obj) {
591
- const schema = z.object({
592
- input: z.union([
593
- z.custom(isDuckTypedSharpInstance),
594
- z.custom((data) => Buffer.isBuffer(data)),
595
- z.string(),
596
- z.object({
597
- width: z.number().optional(),
598
- height: z.number().optional(),
599
- channels: z.union([z.literal(3), z.literal(4)]).optional(),
600
- background: z.custom(isColor).optional(),
601
- noise: z.object({
602
- mean: z.number().optional(),
603
- sigma: z.number().optional()
604
- }).optional(),
605
- pageHeight: z.number().optional()
606
- })
607
- ]),
608
- top: z.number().optional(),
609
- left: z.number().optional(),
610
- tile: z.boolean().optional(),
611
- premultiplied: z.boolean().optional(),
612
- density: z.number().optional(),
613
- animated: z.boolean().optional(),
614
- autoOrient: z.boolean().optional(),
615
- ignoreIcc: z.boolean().optional(),
616
- pages: z.number().optional(),
617
- page: z.number().optional(),
618
- blend: z.enum([
619
- "clear",
620
- "source",
621
- "over",
622
- "in",
623
- "out",
624
- "atop",
625
- "dest",
626
- "dest-over",
627
- "dest-in",
628
- "dest-out",
629
- "dest-atop",
630
- "xor",
631
- "add",
632
- "saturate",
633
- "multiply",
634
- "screen",
635
- "overlay",
636
- "darken",
637
- "lighten",
638
- "color-dodge",
639
- "colour-dodge",
640
- "color-burn",
641
- "colour-burn",
642
- "hard-light",
643
- "soft-light",
644
- "difference",
645
- "exclusion"
646
- ]).optional(),
647
- gravity: z.enum([
648
- "north",
649
- "northeast",
650
- "southeast",
651
- "south",
652
- "southwest",
653
- "west",
654
- "northwest",
655
- "east",
656
- "center",
657
- "centre"
658
- ]).optional()
659
- });
660
- const result = schema.safeParse(obj);
661
- if (!result.success) return makeFailure(result.error.message);
662
- return makeSuccess(result.data);
663
- }
664
- async function overlay(sharpInstance, params) {
665
- const inputBuffer = params.input instanceof Buffer ? params.input : await (await toSharpInstance(params.input)).toBuffer();
666
- return sharp2(await sharpInstance.composite([{
667
- ...params,
668
- input: inputBuffer
669
- }]).webp().toBuffer());
670
- }
671
- export {
672
- isOverlayOperationParams,
673
- overlay
674
- };