@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,942 +1,145 @@
1
- // src/agnostic/numbers/clamp/index.ts
2
- function clamp(num, bound1, bound2) {
3
- const min = Math.min(bound1, bound2);
4
- const max = Math.max(bound1, bound2);
5
- return Math.min(Math.max(num, min), max);
6
- }
7
-
8
- // src/agnostic/numbers/absolute-modulo/index.ts
9
- function absoluteModulo(nbr, modulo) {
10
- return (nbr % modulo + modulo) % modulo;
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, a } = color;
241
- if (typeof x !== "number") return false;
242
- if (typeof y !== "number") return false;
243
- if (typeof z !== "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
-
249
- // src/agnostic/errors/unknown-to-string/index.ts
250
- function unknownToString(unk, encoding) {
251
- if (unk instanceof Error) return unk.message;
252
- if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
253
- if (typeof unk === "string") return unk;
254
- if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
255
- return `${unk}`;
256
- }
257
-
258
- // src/agnostic/colors/convert/index.ts
259
- function _hex2rgb(hex) {
260
- if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
261
- let hexString = hex;
262
- const inputHex = hexString;
263
- const startsWithHash = hexString.startsWith("#");
264
- if (!startsWithHash) throw new Error(`invalid hex color ${inputHex}`);
265
- hexString = hexString.slice(1);
266
- if (hexString.length === 3) {
267
- hexString = hexString.split("").map((c) => c + c).join("") + "ff";
268
- } else if (hexString.length === 4) {
269
- hexString = hexString.split("").map((c) => c + c).join("");
270
- } else if (hexString.length === 6) {
271
- hexString = hexString + "ff";
272
- } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
273
- const r = parseInt(hexString.slice(0, 2), 16);
274
- const g = parseInt(hexString.slice(2, 4), 16);
275
- const b = parseInt(hexString.slice(4, 6), 16);
276
- const a = parseInt(hexString.slice(6, 8), 16) / 255;
277
- return { r, g, b, a };
278
- }
279
- function _rgb2hex(rgb) {
280
- const { r, g, b, a = 1 } = rgb;
281
- const rHex = Math.round(r).toString(16).padStart(2, "0");
282
- const gHex = Math.round(g).toString(16).padStart(2, "0");
283
- const bHex = Math.round(b).toString(16).padStart(2, "0");
284
- const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
285
- const returned = `#${rHex}${gHex}${bHex}${aHex}`;
286
- if (!isHex(returned)) {
287
- throw new Error(`invalid hex color output ${unknownToString(returned)}`);
288
- }
289
- return returned;
290
- }
291
- function _css2rgb(color) {
292
- if (color in cssColors) return cssColors[color];
293
- return void 0;
294
- }
295
- var cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
296
- name: cssColor,
297
- hex: _rgb2hex(rgba),
298
- rgba
299
- }));
300
- function _hsl2rgb(hsl) {
301
- const { h, s, l, a = 1 } = hsl;
302
- const H = absoluteModulo(h, 360) / 360;
303
- const S = Math.max(0, Math.min(1, s / 100));
304
- const L = Math.max(0, Math.min(1, l / 100));
305
- const A = Math.max(0, Math.min(1, a));
306
- const hue2rgb = (p, q, t) => {
307
- if (t < 0) t += 1;
308
- if (t > 1) t -= 1;
309
- if (t < 1 / 6) return p + (q - p) * 6 * t;
310
- if (t < 1 / 2) return q;
311
- if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
312
- return p;
313
- };
314
- let r;
315
- let g;
316
- let b;
317
- if (S === 0) {
318
- r = g = b = L;
319
- } else {
320
- const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
321
- const p = 2 * L - q;
322
- r = hue2rgb(p, q, H + 1 / 3);
323
- g = hue2rgb(p, q, H);
324
- b = hue2rgb(p, q, H - 1 / 3);
325
- }
326
- return {
327
- r: Math.round(r * 255),
328
- g: Math.round(g * 255),
329
- b: Math.round(b * 255),
330
- a: A
331
- };
332
- }
333
- function _rgb2hsl(rgb) {
334
- const { r, g, b, a = 1 } = rgb;
335
- const R = r / 255;
336
- const G = g / 255;
337
- const B = b / 255;
338
- const max = Math.max(R, G, B);
339
- const min = Math.min(R, G, B);
340
- const delta = max - min;
341
- let h = 0;
342
- let s = 0;
343
- const l = (max + min) / 2;
344
- if (delta !== 0) {
345
- s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
346
- if (max === R) {
347
- h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
348
- } else if (max === G) {
349
- h = ((B - R) / delta + 2) / 6;
350
- } else {
351
- h = ((R - G) / delta + 4) / 6;
1
+ import { clamp } from '../../numbers/clamp/index.js';
2
+ import { absoluteModulo } from '../../numbers/absolute-modulo/index.js';
3
+ import { toRgb, toHsl, toHsb, toCmyk, toXyz, toLab, toLch, viaRgb, viaHsl, viaHsb, viaCmyk, viaXyz, viaLab, viaLch } from '../convert/index.js';
4
+ /* * * * * * * * * * * * * * * * * *
5
+ * Set channel
6
+ * * * * * * * * * * * * * * * * * */
7
+ /**
8
+ * Sets a specific color channel to an absolute value.
9
+ *
10
+ * @template C - The input color type.
11
+ * @param {C} color - The color to modify.
12
+ * @param {Channel} channel - The channel to set.
13
+ * @param {number} value - The new value for the channel.
14
+ * @returns {TransformedColor<C>} The color with the updated channel, in the original format.
15
+ */
16
+ export function setChannel(color, channel, value) {
17
+ switch (channel) {
18
+ case 'red': return viaRgb(color, rgb => ({ ...rgb, r: clamp(value, 0, 255) }));
19
+ case 'green': return viaRgb(color, rgb => ({ ...rgb, g: clamp(value, 0, 255) }));
20
+ case 'blue': return viaRgb(color, rgb => ({ ...rgb, b: clamp(value, 0, 255) }));
21
+ case 'hue': return viaHsl(color, hsl => ({ ...hsl, h: absoluteModulo(value, 360) }));
22
+ case 'saturation': return viaHsl(color, hsl => ({ ...hsl, s: clamp(value, 0, 100) }));
23
+ case 'lightness': return viaHsl(color, hsl => ({ ...hsl, l: clamp(value, 0, 100) }));
24
+ case 'brightness': return viaHsb(color, hsb => ({ ...hsb, b: clamp(value, 0, 100) }));
25
+ case 'alpha': return viaRgb(color, rgb => ({ ...rgb, a: clamp(value, 0, 1) }));
26
+ case 'cyan': return viaCmyk(color, cmyk => ({ ...cmyk, c: clamp(value, 0, 100) }));
27
+ case 'magenta': return viaCmyk(color, cmyk => ({ ...cmyk, m: clamp(value, 0, 100) }));
28
+ case 'yellow': return viaCmyk(color, cmyk => ({ ...cmyk, y: clamp(value, 0, 100) }));
29
+ case 'black': return viaCmyk(color, cmyk => ({ ...cmyk, k: clamp(value, 0, 100) }));
30
+ case 'x': return viaXyz(color, xyz => ({ ...xyz, x: value }));
31
+ case 'y': return viaXyz(color, xyz => ({ ...xyz, y: value }));
32
+ case 'z': return viaXyz(color, xyz => ({ ...xyz, z: value }));
33
+ case 'lightnessLab': return viaLab(color, lab => ({ ...lab, a: clamp(value, 0, 100) }));
34
+ case 'aLab': return viaLab(color, lab => ({ ...lab, a: value }));
35
+ case 'bLab': return viaLab(color, lab => ({ ...lab, b: value }));
36
+ case 'chroma': return viaLch(color, lch => ({ ...lch, c: Math.max(0, value) }));
37
+ case 'hueLch': return viaLch(color, lch => ({ ...lch, h: clamp(value, 0, 360) }));
352
38
  }
353
- }
354
- return {
355
- h: Math.round(h * 360),
356
- s: Math.round(s * 100),
357
- l: Math.round(l * 100),
358
- a
359
- };
360
- }
361
- function _hsb2rgb(hsb) {
362
- const { h, s, b, a = 1 } = hsb;
363
- const H = absoluteModulo(h, 360) / 360;
364
- const S = Math.max(0, Math.min(1, s / 100));
365
- const B = Math.max(0, Math.min(1, b / 100));
366
- const A = Math.max(0, Math.min(1, a));
367
- const i = Math.floor(H * 6);
368
- const f = H * 6 - i;
369
- const p = B * (1 - S);
370
- const q = B * (1 - f * S);
371
- const t = B * (1 - (1 - f) * S);
372
- let r;
373
- let g;
374
- let blue;
375
- switch (absoluteModulo(i, 6)) {
376
- case 0:
377
- r = B;
378
- g = t;
379
- blue = p;
380
- break;
381
- case 1:
382
- r = q;
383
- g = B;
384
- blue = p;
385
- break;
386
- case 2:
387
- r = p;
388
- g = B;
389
- blue = t;
390
- break;
391
- case 3:
392
- r = p;
393
- g = q;
394
- blue = B;
395
- break;
396
- case 4:
397
- r = t;
398
- g = p;
399
- blue = B;
400
- break;
401
- case 5:
402
- r = B;
403
- g = p;
404
- blue = q;
405
- break;
406
- default:
407
- r = g = blue = 0;
408
- }
409
- return {
410
- r: Math.round(r * 255),
411
- g: Math.round(g * 255),
412
- b: Math.round(blue * 255),
413
- a: A
414
- };
415
39
  }
416
- function _rgb2hsb(rgb) {
417
- const { r, g, b, a = 1 } = rgb;
418
- const R = r / 255;
419
- const G = g / 255;
420
- const B = b / 255;
421
- const max = Math.max(R, G, B);
422
- const min = Math.min(R, G, B);
423
- const delta = max - min;
424
- let h = 0;
425
- let s = 0;
426
- const brightness = max;
427
- if (max !== 0) {
428
- s = delta / max;
429
- }
430
- if (delta !== 0) {
431
- if (max === R) {
432
- h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
433
- } else if (max === G) {
434
- h = ((B - R) / delta + 2) / 6;
435
- } else {
436
- h = ((R - G) / delta + 4) / 6;
40
+ /* * * * * * * * * * * * * * * * * *
41
+ * Get channel
42
+ * * * * * * * * * * * * * * * * * */
43
+ /**
44
+ * Gets the value of a specific color channel.
45
+ *
46
+ * @param {Color} color - The color to read from.
47
+ * @param {Channel} channel - The channel to retrieve.
48
+ * @returns {number} The value of the specified channel.
49
+ */
50
+ export function getChannel(color, channel) {
51
+ switch (channel) {
52
+ case 'red': return toRgb(color).r;
53
+ case 'green': return toRgb(color).g;
54
+ case 'blue': return toRgb(color).b;
55
+ case 'hue': return toHsl(color).h;
56
+ case 'saturation': return toHsl(color).s;
57
+ case 'lightness': return toHsl(color).l;
58
+ case 'brightness': return toHsb(color).b;
59
+ case 'alpha': return toRgb(color).a ?? 1;
60
+ case 'cyan': return toCmyk(color).c;
61
+ case 'magenta': return toCmyk(color).m;
62
+ case 'yellow': return toCmyk(color).y;
63
+ case 'black': return toCmyk(color).k;
64
+ case 'x': return toXyz(color).x;
65
+ case 'y': return toXyz(color).y;
66
+ case 'z': return toXyz(color).z;
67
+ case 'lightnessLab': return toLab(color).l;
68
+ case 'aLab': return toLab(color).a;
69
+ case 'bLab': return toLab(color).b;
70
+ case 'chroma': return toLch(color).c;
71
+ case 'hueLch': return toLch(color).h;
437
72
  }
438
- }
439
- return {
440
- h: Math.round(h * 360),
441
- s: Math.round(s * 100),
442
- b: Math.round(brightness * 100),
443
- a
444
- };
445
- }
446
- function _cmyk2rgb(cmyka) {
447
- const { c, m, y, k, a = 1 } = cmyka;
448
- const C = Math.max(0, Math.min(100, c)) / 100;
449
- const M = Math.max(0, Math.min(100, m)) / 100;
450
- const Y = Math.max(0, Math.min(100, y)) / 100;
451
- const K = Math.max(0, Math.min(100, k)) / 100;
452
- const A = Math.max(0, Math.min(1, a));
453
- const R = 1 - Math.min(1, C * (1 - K) + K);
454
- const G = 1 - Math.min(1, M * (1 - K) + K);
455
- const B = 1 - Math.min(1, Y * (1 - K) + K);
456
- return {
457
- r: Math.round(R * 255),
458
- g: Math.round(G * 255),
459
- b: Math.round(B * 255),
460
- a: A
461
- };
462
- }
463
- function _rgb2cmyk(rgb) {
464
- const { r, g, b, a = 1 } = rgb;
465
- const R = Math.max(0, Math.min(1, r / 255));
466
- const G = Math.max(0, Math.min(1, g / 255));
467
- const B = Math.max(0, Math.min(1, b / 255));
468
- const A = Math.max(0, Math.min(1, a));
469
- const K = 1 - Math.max(R, G, B);
470
- const denom = 1 - K || 1;
471
- const C = (1 - R - K) / denom;
472
- const M = (1 - G - K) / denom;
473
- const Y = (1 - B - K) / denom;
474
- return {
475
- c: Math.round(C * 100),
476
- m: Math.round(M * 100),
477
- y: Math.round(Y * 100),
478
- k: Math.round(K * 100),
479
- a: A
480
- };
481
- }
482
- function _xyz2rgb(xyza) {
483
- const { x, y, z, a = 1 } = xyza;
484
- const X = x / 100;
485
- const Y = y / 100;
486
- const Z = z / 100;
487
- const A = Math.max(0, Math.min(1, a));
488
- let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
489
- let G = X * -0.969266 + Y * 1.8760108 + Z * 0.041556;
490
- let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
491
- const GAMMA_THRESHOLD = 31308e-7;
492
- const GAMMA_EXPONENT = 1 / 2.4;
493
- const GAMMA_MULT = 1.055;
494
- const GAMMA_OFFSET = 0.055;
495
- const LINEAR_DIVISOR = 12.92;
496
- const gammaCorrect = (c) => c <= GAMMA_THRESHOLD ? c * LINEAR_DIVISOR : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
497
- R = gammaCorrect(R);
498
- G = gammaCorrect(G);
499
- B = gammaCorrect(B);
500
- return {
501
- r: Math.round(Math.max(0, Math.min(1, R)) * 255),
502
- g: Math.round(Math.max(0, Math.min(1, G)) * 255),
503
- b: Math.round(Math.max(0, Math.min(1, B)) * 255),
504
- a: A
505
- };
506
- }
507
- function _rgb2xyz(rgb) {
508
- const { r, g, b, a = 1 } = rgb;
509
- let R = Math.max(0, Math.min(1, r / 255));
510
- let G = Math.max(0, Math.min(1, g / 255));
511
- let B = Math.max(0, Math.min(1, b / 255));
512
- const A = Math.max(0, Math.min(1, a));
513
- const SRGB_THRESHOLD = 0.04045;
514
- const SRGB_OFFSET = 0.055;
515
- const SRGB_DIVISOR = 1.055;
516
- const SRGB_EXPONENT = 2.4;
517
- const SRGB_LINEAR_DIVISOR = 12.92;
518
- const linearize = (c) => c > SRGB_THRESHOLD ? Math.pow((c + SRGB_OFFSET) / SRGB_DIVISOR, SRGB_EXPONENT) : c / SRGB_LINEAR_DIVISOR;
519
- R = linearize(R);
520
- G = linearize(G);
521
- B = linearize(B);
522
- const X = R * 0.4124564 + G * 0.3575761 + B * 0.1804375;
523
- const Y = R * 0.2126729 + G * 0.7151522 + B * 0.072175;
524
- const Z = R * 0.0193339 + G * 0.119192 + B * 0.9503041;
525
- return {
526
- x: X * 100,
527
- y: Y * 100,
528
- z: Z * 100,
529
- a: A
530
- };
531
- }
532
- function _lab2xyz(lab) {
533
- const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
534
- const REF_X = 95.047;
535
- const REF_Y = 100;
536
- const REF_Z = 108.883;
537
- const fy = (l + 16) / 116;
538
- const fx = fy + A / 500;
539
- const fz = fy - B / 200;
540
- const fx3 = Math.pow(fx, 3);
541
- const fz3 = Math.pow(fz, 3);
542
- const fy3 = Math.pow(fy, 3);
543
- const epsilon = 8856e-6;
544
- const kappa = 903.3;
545
- const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
546
- const Y = l > kappa * epsilon ? fy3 : l / kappa;
547
- const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
548
- return {
549
- x: X * REF_X,
550
- y: Y * REF_Y,
551
- z: Z * REF_Z,
552
- a: Math.max(0, Math.min(1, alpha))
553
- };
554
- }
555
- function _xyz2lab(xyza) {
556
- const { x, y, z, a: alpha = 1 } = xyza;
557
- const REF_X = 95.047;
558
- const REF_Y = 100;
559
- const REF_Z = 108.883;
560
- const X = x / REF_X;
561
- const Y = y / REF_Y;
562
- const Z = z / REF_Z;
563
- const epsilon = 8856e-6;
564
- const kappa = 903.3;
565
- const fx = X > epsilon ? Math.cbrt(X) : (kappa * X + 16) / 116;
566
- const fy = Y > epsilon ? Math.cbrt(Y) : (kappa * Y + 16) / 116;
567
- const fz = Z > epsilon ? Math.cbrt(Z) : (kappa * Z + 16) / 116;
568
- const L = 116 * fy - 16;
569
- const A = 500 * (fx - fy);
570
- const B = 200 * (fy - fz);
571
- return {
572
- l: L,
573
- a: A,
574
- b: B,
575
- al: Math.max(0, Math.min(1, alpha))
576
- };
577
- }
578
- function _lab2lch(lab) {
579
- const { l, a, b, al = 1 } = lab;
580
- const c = Math.sqrt(a * a + b * b);
581
- let h = Math.atan2(b, a) * (180 / Math.PI);
582
- if (h < 0) h += 360;
583
- return { l, c, h, a: al };
584
- }
585
- function _lch2lab(lch) {
586
- const { l, c, h, a = 1 } = lch;
587
- const hRad = h * Math.PI / 180;
588
- const A = c * Math.cos(hRad);
589
- const B = c * Math.sin(hRad);
590
- return { l, a: A, b: B, al: a };
591
- }
592
- function toRgb(color) {
593
- if (isRgb(color)) return color;
594
- if (isHsl(color)) return _hsl2rgb(color);
595
- if (isHsb(color)) return _hsb2rgb(color);
596
- if (isCmyk(color)) return _cmyk2rgb(color);
597
- if (isCssColor(color)) return _css2rgb(color);
598
- if (isHex(color)) return _hex2rgb(color);
599
- if (isXyz(color)) return _xyz2rgb(color);
600
- if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
601
- if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
602
- throw new Error(`Invalid color input: ${unknownToString(color)}`);
603
73
  }
604
- function toXyz(color) {
605
- if (isXyz(color)) return color;
606
- if (isLab(color)) return _lab2xyz(color);
607
- if (isLch(color)) return _lab2xyz(_lch2lab(color));
608
- if (isRgb(color)) return _rgb2xyz(color);
609
- if (isHsl(color)) return _rgb2xyz(_hsl2rgb(color));
610
- if (isHsb(color)) return _rgb2xyz(_hsb2rgb(color));
611
- if (isCmyk(color)) return _rgb2xyz(_cmyk2rgb(color));
612
- if (isCssColor(color)) return _rgb2xyz(_css2rgb(color));
613
- if (isHex(color)) return _rgb2xyz(_hex2rgb(color));
614
- throw new Error(`Invalid color input: ${unknownToString(color)}`);
615
- }
616
- function toLab(color) {
617
- if (isLab(color)) return color;
618
- if (isLch(color)) return _lch2lab(color);
619
- const xyzColor = toXyz(color);
620
- return _xyz2lab(xyzColor);
621
- }
622
- function toLch(color) {
623
- if (isLch(color)) return color;
624
- const labColor = toLab(color);
625
- return _lab2lch(labColor);
626
- }
627
- function toHsl(color) {
628
- if (isHsl(color)) return color;
629
- const rgbColor = toRgb(color);
630
- return _rgb2hsl(rgbColor);
631
- }
632
- function toHsb(color) {
633
- if (isHsb(color)) return color;
634
- const rgbColor = toRgb(color);
635
- return _rgb2hsb(rgbColor);
636
- }
637
- function toCmyk(color) {
638
- if (isCmyk(color)) return color;
639
- const rgbColor = toRgb(color);
640
- return _rgb2cmyk(rgbColor);
641
- }
642
- function toHex(color) {
643
- if (isHex(color)) return color;
644
- const rgbColor = toRgb(color);
645
- return _rgb2hex(rgbColor);
646
- }
647
- function viaRgb(color, transformer) {
648
- const _color = color;
649
- const rgb = toRgb(_color);
650
- const transformedRgb = transformer(rgb);
651
- if (isRgb(_color)) return transformedRgb;
652
- if (isHsl(_color)) return toHsl(transformedRgb);
653
- if (isHsb(_color)) return toHsb(transformedRgb);
654
- if (isCmyk(_color)) return toCmyk(transformedRgb);
655
- if (isXyz(_color)) return toXyz(transformedRgb);
656
- if (isLab(_color)) return toLab(transformedRgb);
657
- if (isLch(_color)) return toLch(transformedRgb);
658
- if (isHex(_color)) return toRgb(transformedRgb);
659
- if (isCssColor(_color)) return transformedRgb;
660
- const _typecheck = true;
661
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
662
- }
663
- function viaHsl(color, transformer) {
664
- const _color = color;
665
- const hsl = toHsl(_color);
666
- const transformedHsl = transformer(hsl);
667
- if (isHsl(_color)) return transformedHsl;
668
- if (isRgb(_color)) return toRgb(transformedHsl);
669
- if (isHsb(_color)) return toHsb(transformedHsl);
670
- if (isCmyk(_color)) return toCmyk(transformedHsl);
671
- if (isXyz(_color)) return toXyz(transformedHsl);
672
- if (isLab(_color)) return toLab(transformedHsl);
673
- if (isLch(_color)) return toLch(transformedHsl);
674
- if (isHex(_color)) return toHex(transformedHsl);
675
- if (isCssColor(_color)) return transformedHsl;
676
- const _typecheck = true;
677
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
678
- }
679
- function viaHsb(color, transformer) {
680
- const _color = color;
681
- const hsb = toHsb(_color);
682
- const transformedHsb = transformer(hsb);
683
- if (isHsb(_color)) return transformedHsb;
684
- if (isRgb(_color)) return toRgb(transformedHsb);
685
- if (isHsl(_color)) return toHsl(transformedHsb);
686
- if (isCmyk(_color)) return toCmyk(transformedHsb);
687
- if (isXyz(_color)) return toXyz(transformedHsb);
688
- if (isLab(_color)) return toLab(transformedHsb);
689
- if (isLch(_color)) return toLch(transformedHsb);
690
- if (isHex(_color)) return toHex(transformedHsb);
691
- if (isCssColor(_color)) return transformedHsb;
692
- const _typecheck = true;
693
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
694
- }
695
- function viaCmyk(color, transformer) {
696
- const _color = color;
697
- const cmyk = toCmyk(_color);
698
- const transformedCmyk = transformer(cmyk);
699
- if (isHsb(_color)) return transformedCmyk;
700
- if (isRgb(_color)) return toRgb(transformedCmyk);
701
- if (isHsl(_color)) return toHsl(transformedCmyk);
702
- if (isCmyk(_color)) return toCmyk(transformedCmyk);
703
- if (isXyz(_color)) return toXyz(transformedCmyk);
704
- if (isLab(_color)) return toLab(transformedCmyk);
705
- if (isLch(_color)) return toLch(transformedCmyk);
706
- if (isHex(_color)) return toHex(transformedCmyk);
707
- if (isCssColor(_color)) return transformedCmyk;
708
- const _typecheck = true;
709
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
710
- }
711
- function viaXyz(color, transformer) {
712
- const _color = color;
713
- const xyz = toXyz(_color);
714
- const transformedXyz = transformer(xyz);
715
- if (isHsb(_color)) return transformedXyz;
716
- if (isRgb(_color)) return toRgb(transformedXyz);
717
- if (isHsl(_color)) return toHsl(transformedXyz);
718
- if (isCmyk(_color)) return toCmyk(transformedXyz);
719
- if (isXyz(_color)) return toXyz(transformedXyz);
720
- if (isLab(_color)) return toLab(transformedXyz);
721
- if (isLch(_color)) return toLch(transformedXyz);
722
- if (isHex(_color)) return toHex(transformedXyz);
723
- if (isCssColor(_color)) return transformedXyz;
724
- const _typecheck = true;
725
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
726
- }
727
- function viaLab(color, transformer) {
728
- const _color = color;
729
- const lab = toLab(_color);
730
- const transformedLab = transformer(lab);
731
- if (isHsb(_color)) return transformedLab;
732
- if (isRgb(_color)) return toRgb(transformedLab);
733
- if (isHsl(_color)) return toHsl(transformedLab);
734
- if (isCmyk(_color)) return toCmyk(transformedLab);
735
- if (isXyz(_color)) return toXyz(transformedLab);
736
- if (isLab(_color)) return toLab(transformedLab);
737
- if (isLch(_color)) return toLch(transformedLab);
738
- if (isHex(_color)) return toHex(transformedLab);
739
- if (isCssColor(_color)) return transformedLab;
740
- const _typecheck = true;
741
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
742
- }
743
- function viaLch(color, transformer) {
744
- const _color = color;
745
- const lch = toLch(_color);
746
- const transformedLch = transformer(lch);
747
- if (isHsb(_color)) return transformedLch;
748
- if (isRgb(_color)) return toRgb(transformedLch);
749
- if (isHsl(_color)) return toHsl(transformedLch);
750
- if (isCmyk(_color)) return toCmyk(transformedLch);
751
- if (isXyz(_color)) return toXyz(transformedLch);
752
- if (isLab(_color)) return toLab(transformedLch);
753
- if (isLch(_color)) return toLch(transformedLch);
754
- if (isHex(_color)) return toHex(transformedLch);
755
- if (isCssColor(_color)) return transformedLch;
756
- const _typecheck = true;
757
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
758
- }
759
-
760
- // src/agnostic/colors/channels/index.ts
761
- function setChannel(color, channel, value) {
762
- switch (channel) {
763
- case "red":
764
- return viaRgb(color, (rgb) => ({ ...rgb, r: clamp(value, 0, 255) }));
765
- case "green":
766
- return viaRgb(color, (rgb) => ({ ...rgb, g: clamp(value, 0, 255) }));
767
- case "blue":
768
- return viaRgb(color, (rgb) => ({ ...rgb, b: clamp(value, 0, 255) }));
769
- case "hue":
770
- return viaHsl(color, (hsl) => ({ ...hsl, h: absoluteModulo(value, 360) }));
771
- case "saturation":
772
- return viaHsl(color, (hsl) => ({ ...hsl, s: clamp(value, 0, 100) }));
773
- case "lightness":
774
- return viaHsl(color, (hsl) => ({ ...hsl, l: clamp(value, 0, 100) }));
775
- case "brightness":
776
- return viaHsb(color, (hsb) => ({ ...hsb, b: clamp(value, 0, 100) }));
777
- case "alpha":
778
- return viaRgb(color, (rgb) => ({ ...rgb, a: clamp(value, 0, 1) }));
779
- case "cyan":
780
- return viaCmyk(color, (cmyk) => ({ ...cmyk, c: clamp(value, 0, 100) }));
781
- case "magenta":
782
- return viaCmyk(color, (cmyk) => ({ ...cmyk, m: clamp(value, 0, 100) }));
783
- case "yellow":
784
- return viaCmyk(color, (cmyk) => ({ ...cmyk, y: clamp(value, 0, 100) }));
785
- case "black":
786
- return viaCmyk(color, (cmyk) => ({ ...cmyk, k: clamp(value, 0, 100) }));
787
- case "x":
788
- return viaXyz(color, (xyz) => ({ ...xyz, x: value }));
789
- case "y":
790
- return viaXyz(color, (xyz) => ({ ...xyz, y: value }));
791
- case "z":
792
- return viaXyz(color, (xyz) => ({ ...xyz, z: value }));
793
- case "lightnessLab":
794
- return viaLab(color, (lab) => ({ ...lab, a: clamp(value, 0, 100) }));
795
- case "aLab":
796
- return viaLab(color, (lab) => ({ ...lab, a: value }));
797
- case "bLab":
798
- return viaLab(color, (lab) => ({ ...lab, b: value }));
799
- case "chroma":
800
- return viaLch(color, (lch) => ({ ...lch, c: Math.max(0, value) }));
801
- case "hueLch":
802
- return viaLch(color, (lch) => ({ ...lch, h: clamp(value, 0, 360) }));
803
- }
804
- }
805
- function getChannel(color, channel) {
806
- switch (channel) {
807
- case "red":
808
- return toRgb(color).r;
809
- case "green":
810
- return toRgb(color).g;
811
- case "blue":
812
- return toRgb(color).b;
813
- case "hue":
814
- return toHsl(color).h;
815
- case "saturation":
816
- return toHsl(color).s;
817
- case "lightness":
818
- return toHsl(color).l;
819
- case "brightness":
820
- return toHsb(color).b;
821
- case "alpha":
822
- return toRgb(color).a ?? 1;
823
- case "cyan":
824
- return toCmyk(color).c;
825
- case "magenta":
826
- return toCmyk(color).m;
827
- case "yellow":
828
- return toCmyk(color).y;
829
- case "black":
830
- return toCmyk(color).k;
831
- case "x":
832
- return toXyz(color).x;
833
- case "y":
834
- return toXyz(color).y;
835
- case "z":
836
- return toXyz(color).z;
837
- case "lightnessLab":
838
- return toLab(color).l;
839
- case "aLab":
840
- return toLab(color).a;
841
- case "bLab":
842
- return toLab(color).b;
843
- case "chroma":
844
- return toLch(color).c;
845
- case "hueLch":
846
- return toLch(color).h;
847
- }
848
- }
849
- function addChannel(color, channel, amount) {
850
- switch (channel) {
851
- case "red":
852
- return viaRgb(color, (rgb) => ({ ...rgb, r: clamp(rgb.r + amount, 0, 255) }));
853
- case "green":
854
- return viaRgb(color, (rgb) => ({ ...rgb, g: clamp(rgb.g + amount, 0, 255) }));
855
- case "blue":
856
- return viaRgb(color, (rgb) => ({ ...rgb, b: clamp(rgb.b + amount, 0, 255) }));
857
- case "hue":
858
- return viaHsl(color, (hsl) => ({ ...hsl, h: absoluteModulo(hsl.h + amount, 360) }));
859
- case "saturation":
860
- return viaHsl(color, (hsl) => ({ ...hsl, s: clamp(hsl.s + amount, 0, 100) }));
861
- case "lightness":
862
- return viaHsl(color, (hsl) => ({ ...hsl, l: clamp(hsl.l + amount, 0, 100) }));
863
- case "brightness":
864
- return viaHsb(color, (hsb) => ({ ...hsb, b: clamp(hsb.b + amount, 0, 100) }));
865
- case "alpha":
866
- return viaRgb(color, (rgb) => ({ ...rgb, a: clamp(rgb.a ?? 1 + amount, 0, 1) }));
867
- case "cyan":
868
- return viaCmyk(color, (cmyk) => ({ ...cmyk, c: clamp(cmyk.c + amount, 0, 100) }));
869
- case "magenta":
870
- return viaCmyk(color, (cmyk) => ({ ...cmyk, m: clamp(cmyk.m + amount, 0, 100) }));
871
- case "yellow":
872
- return viaCmyk(color, (cmyk) => ({ ...cmyk, y: clamp(cmyk.y + amount, 0, 100) }));
873
- case "black":
874
- return viaCmyk(color, (cmyk) => ({ ...cmyk, k: clamp(cmyk.k + amount, 0, 100) }));
875
- case "x":
876
- return viaXyz(color, (xyz) => ({ ...xyz, x: xyz.x + amount }));
877
- case "y":
878
- return viaXyz(color, (xyz) => ({ ...xyz, y: xyz.y + amount }));
879
- case "z":
880
- return viaXyz(color, (xyz) => ({ ...xyz, z: xyz.z + amount }));
881
- case "lightnessLab":
882
- return viaLab(color, (lab) => ({ ...lab, l: clamp(lab.l + amount, 0, 100) }));
883
- case "aLab":
884
- return viaLab(color, (lab) => ({ ...lab, a: lab.a + amount }));
885
- case "bLab":
886
- return viaLab(color, (lab) => ({ ...lab, b: lab.b + amount }));
887
- case "chroma":
888
- return viaLch(color, (lch) => ({ ...lch, c: Math.max(0, lch.c + amount) }));
889
- case "hueLch":
890
- return viaLch(color, (lch) => ({ ...lch, h: clamp(lch.h + amount, 0, 360) }));
891
- }
74
+ /* * * * * * * * * * * * * * * * * *
75
+ * Add channel
76
+ * * * * * * * * * * * * * * * * * */
77
+ /**
78
+ * Adds a value to a specific color channel.
79
+ *
80
+ * @template C - The input color type.
81
+ * @param {C} color - The color to modify.
82
+ * @param {Channel} channel - The channel to modify.
83
+ * @param {number} amount - The amount to add to the channel.
84
+ * @returns {TransformedColor<C>} The color with the updated channel, in the original format.
85
+ */
86
+ export function addChannel(color, channel, amount) {
87
+ switch (channel) {
88
+ case 'red': return viaRgb(color, rgb => ({ ...rgb, r: clamp(rgb.r + amount, 0, 255) }));
89
+ case 'green': return viaRgb(color, rgb => ({ ...rgb, g: clamp(rgb.g + amount, 0, 255) }));
90
+ case 'blue': return viaRgb(color, rgb => ({ ...rgb, b: clamp(rgb.b + amount, 0, 255) }));
91
+ case 'hue': return viaHsl(color, hsl => ({ ...hsl, h: absoluteModulo(hsl.h + amount, 360) }));
92
+ case 'saturation': return viaHsl(color, hsl => ({ ...hsl, s: clamp(hsl.s + amount, 0, 100) }));
93
+ case 'lightness': return viaHsl(color, hsl => ({ ...hsl, l: clamp(hsl.l + amount, 0, 100) }));
94
+ case 'brightness': return viaHsb(color, hsb => ({ ...hsb, b: clamp(hsb.b + amount, 0, 100) }));
95
+ case 'alpha': return viaRgb(color, rgb => ({ ...rgb, a: clamp(rgb.a ?? 1 + amount, 0, 1) }));
96
+ case 'cyan': return viaCmyk(color, cmyk => ({ ...cmyk, c: clamp(cmyk.c + amount, 0, 100) }));
97
+ case 'magenta': return viaCmyk(color, cmyk => ({ ...cmyk, m: clamp(cmyk.m + amount, 0, 100) }));
98
+ case 'yellow': return viaCmyk(color, cmyk => ({ ...cmyk, y: clamp(cmyk.y + amount, 0, 100) }));
99
+ case 'black': return viaCmyk(color, cmyk => ({ ...cmyk, k: clamp(cmyk.k + amount, 0, 100) }));
100
+ case 'x': return viaXyz(color, xyz => ({ ...xyz, x: xyz.x + amount }));
101
+ case 'y': return viaXyz(color, xyz => ({ ...xyz, y: xyz.y + amount }));
102
+ case 'z': return viaXyz(color, xyz => ({ ...xyz, z: xyz.z + amount }));
103
+ case 'lightnessLab': return viaLab(color, lab => ({ ...lab, l: clamp(lab.l + amount, 0, 100) }));
104
+ case 'aLab': return viaLab(color, lab => ({ ...lab, a: lab.a + amount }));
105
+ case 'bLab': return viaLab(color, lab => ({ ...lab, b: lab.b + amount }));
106
+ case 'chroma': return viaLch(color, lch => ({ ...lch, c: Math.max(0, lch.c + amount) }));
107
+ case 'hueLch': return viaLch(color, lch => ({ ...lch, h: clamp(lch.h + amount, 0, 360) }));
108
+ }
892
109
  }
893
- function multChannel(color, channel, factor) {
894
- switch (channel) {
895
- case "red":
896
- return viaRgb(color, (rgb) => ({ ...rgb, r: clamp(rgb.r * factor, 0, 255) }));
897
- case "green":
898
- return viaRgb(color, (rgb) => ({ ...rgb, g: clamp(rgb.g * factor, 0, 255) }));
899
- case "blue":
900
- return viaRgb(color, (rgb) => ({ ...rgb, b: clamp(rgb.b * factor, 0, 255) }));
901
- case "hue":
902
- return viaHsl(color, (hsl) => ({ ...hsl, h: absoluteModulo(hsl.h * factor, 360) }));
903
- case "saturation":
904
- return viaHsl(color, (hsl) => ({ ...hsl, s: clamp(hsl.s * factor, 0, 100) }));
905
- case "lightness":
906
- return viaHsl(color, (hsl) => ({ ...hsl, l: clamp(hsl.l * factor, 0, 100) }));
907
- case "brightness":
908
- return viaHsb(color, (hsb) => ({ ...hsb, b: clamp(hsb.b * factor, 0, 100) }));
909
- case "alpha":
910
- return viaRgb(color, (rgb) => ({ ...rgb, a: clamp(rgb.a ?? 1 * factor, 0, 1) }));
911
- case "cyan":
912
- return viaCmyk(color, (cmyk) => ({ ...cmyk, c: clamp(cmyk.c * factor, 0, 100) }));
913
- case "magenta":
914
- return viaCmyk(color, (cmyk) => ({ ...cmyk, m: clamp(cmyk.m * factor, 0, 100) }));
915
- case "yellow":
916
- return viaCmyk(color, (cmyk) => ({ ...cmyk, y: clamp(cmyk.y * factor, 0, 100) }));
917
- case "black":
918
- return viaCmyk(color, (cmyk) => ({ ...cmyk, k: clamp(cmyk.k * factor, 0, 100) }));
919
- case "x":
920
- return viaXyz(color, (xyz) => ({ ...xyz, x: xyz.x * factor }));
921
- case "y":
922
- return viaXyz(color, (xyz) => ({ ...xyz, y: xyz.y * factor }));
923
- case "z":
924
- return viaXyz(color, (xyz) => ({ ...xyz, z: xyz.z * factor }));
925
- case "lightnessLab":
926
- return viaLab(color, (lab) => ({ ...lab, l: clamp(lab.l * factor, 0, 100) }));
927
- case "aLab":
928
- return viaLab(color, (lab) => ({ ...lab, a: lab.a * factor }));
929
- case "bLab":
930
- return viaLab(color, (lab) => ({ ...lab, b: lab.b * factor }));
931
- case "chroma":
932
- return viaLch(color, (lch) => ({ ...lch, c: Math.max(0, lch.c * factor) }));
933
- case "hueLch":
934
- return viaLch(color, (lch) => ({ ...lch, h: clamp(lch.h * factor, 0, 360) }));
935
- }
110
+ /* * * * * * * * * * * * * * * * * *
111
+ * Mult channel
112
+ * * * * * * * * * * * * * * * * * */
113
+ /**
114
+ * Multiplies a specific color channel by a factor.
115
+ *
116
+ * @template C - The input color type.
117
+ * @param {C} color - The color to modify.
118
+ * @param {Channel} channel - The channel to modify.
119
+ * @param {number} factor - The multiplication factor.
120
+ * @returns {TransformedColor<C>} The color with the updated channel, in the original format.
121
+ */
122
+ export function multChannel(color, channel, factor) {
123
+ switch (channel) {
124
+ case 'red': return viaRgb(color, rgb => ({ ...rgb, r: clamp(rgb.r * factor, 0, 255) }));
125
+ case 'green': return viaRgb(color, rgb => ({ ...rgb, g: clamp(rgb.g * factor, 0, 255) }));
126
+ case 'blue': return viaRgb(color, rgb => ({ ...rgb, b: clamp(rgb.b * factor, 0, 255) }));
127
+ case 'hue': return viaHsl(color, hsl => ({ ...hsl, h: absoluteModulo(hsl.h * factor, 360) }));
128
+ case 'saturation': return viaHsl(color, hsl => ({ ...hsl, s: clamp(hsl.s * factor, 0, 100) }));
129
+ case 'lightness': return viaHsl(color, hsl => ({ ...hsl, l: clamp(hsl.l * factor, 0, 100) }));
130
+ case 'brightness': return viaHsb(color, hsb => ({ ...hsb, b: clamp(hsb.b * factor, 0, 100) }));
131
+ case 'alpha': return viaRgb(color, rgb => ({ ...rgb, a: clamp(rgb.a ?? 1 * factor, 0, 1) }));
132
+ case 'cyan': return viaCmyk(color, cmyk => ({ ...cmyk, c: clamp(cmyk.c * factor, 0, 100) }));
133
+ case 'magenta': return viaCmyk(color, cmyk => ({ ...cmyk, m: clamp(cmyk.m * factor, 0, 100) }));
134
+ case 'yellow': return viaCmyk(color, cmyk => ({ ...cmyk, y: clamp(cmyk.y * factor, 0, 100) }));
135
+ case 'black': return viaCmyk(color, cmyk => ({ ...cmyk, k: clamp(cmyk.k * factor, 0, 100) }));
136
+ case 'x': return viaXyz(color, xyz => ({ ...xyz, x: xyz.x * factor }));
137
+ case 'y': return viaXyz(color, xyz => ({ ...xyz, y: xyz.y * factor }));
138
+ case 'z': return viaXyz(color, xyz => ({ ...xyz, z: xyz.z * factor }));
139
+ case 'lightnessLab': return viaLab(color, lab => ({ ...lab, l: clamp(lab.l * factor, 0, 100) }));
140
+ case 'aLab': return viaLab(color, lab => ({ ...lab, a: lab.a * factor }));
141
+ case 'bLab': return viaLab(color, lab => ({ ...lab, b: lab.b * factor }));
142
+ case 'chroma': return viaLch(color, lch => ({ ...lch, c: Math.max(0, lch.c * factor) }));
143
+ case 'hueLch': return viaLch(color, lch => ({ ...lch, h: clamp(lch.h * factor, 0, 360) }));
144
+ }
936
145
  }
937
- export {
938
- addChannel,
939
- getChannel,
940
- multChannel,
941
- setChannel
942
- };