@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,865 +1,839 @@
1
- // src/agnostic/numbers/absolute-modulo/index.ts
2
- function absoluteModulo(nbr, modulo) {
3
- return (nbr % modulo + modulo) % modulo;
4
- }
5
-
6
- // src/agnostic/objects/is-object/index.ts
7
- function isObject(unk) {
8
- return typeof unk === "object";
9
- }
10
- function isNonNullObject(unk) {
11
- return unk !== null && isObject(unk);
12
- }
13
-
14
- // src/agnostic/colors/cssColorsMap.ts
15
- var cssColors = {
16
- aliceblue: { r: 240, g: 248, b: 255 },
17
- antiquewhite: { r: 250, g: 235, b: 215 },
18
- aqua: { r: 0, g: 255, b: 255 },
19
- aquamarine: { r: 127, g: 255, b: 212 },
20
- azure: { r: 240, g: 255, b: 255 },
21
- beige: { r: 245, g: 245, b: 220 },
22
- bisque: { r: 255, g: 228, b: 196 },
23
- black: { r: 0, g: 0, b: 0 },
24
- blanchedalmond: { r: 255, g: 235, b: 205 },
25
- blue: { r: 0, g: 0, b: 255 },
26
- blueviolet: { r: 138, g: 43, b: 226 },
27
- brown: { r: 165, g: 42, b: 42 },
28
- burlywood: { r: 222, g: 184, b: 135 },
29
- cadetblue: { r: 95, g: 158, b: 160 },
30
- chartreuse: { r: 127, g: 255, b: 0 },
31
- chocolate: { r: 210, g: 105, b: 30 },
32
- coral: { r: 255, g: 127, b: 80 },
33
- cornflowerblue: { r: 100, g: 149, b: 237 },
34
- cornsilk: { r: 255, g: 248, b: 220 },
35
- crimson: { r: 220, g: 20, b: 60 },
36
- cyan: { r: 0, g: 255, b: 255 },
37
- darkblue: { r: 0, g: 0, b: 139 },
38
- darkcyan: { r: 0, g: 139, b: 139 },
39
- darkgoldenrod: { r: 184, g: 134, b: 11 },
40
- darkgray: { r: 169, g: 169, b: 169 },
41
- darkgreen: { r: 0, g: 100, b: 0 },
42
- darkgrey: { r: 169, g: 169, b: 169 },
43
- darkkhaki: { r: 189, g: 183, b: 107 },
44
- darkmagenta: { r: 139, g: 0, b: 139 },
45
- darkolivegreen: { r: 85, g: 107, b: 47 },
46
- darkorange: { r: 255, g: 140, b: 0 },
47
- darkorchid: { r: 153, g: 50, b: 204 },
48
- darkred: { r: 139, g: 0, b: 0 },
49
- darksalmon: { r: 233, g: 150, b: 122 },
50
- darkseagreen: { r: 143, g: 188, b: 143 },
51
- darkslateblue: { r: 72, g: 61, b: 139 },
52
- darkslategray: { r: 47, g: 79, b: 79 },
53
- darkslategrey: { r: 47, g: 79, b: 79 },
54
- darkturquoise: { r: 0, g: 206, b: 209 },
55
- darkviolet: { r: 148, g: 0, b: 211 },
56
- deeppink: { r: 255, g: 20, b: 147 },
57
- deepskyblue: { r: 0, g: 191, b: 255 },
58
- dimgray: { r: 105, g: 105, b: 105 },
59
- dimgrey: { r: 105, g: 105, b: 105 },
60
- dodgerblue: { r: 30, g: 144, b: 255 },
61
- firebrick: { r: 178, g: 34, b: 34 },
62
- floralwhite: { r: 255, g: 250, b: 240 },
63
- forestgreen: { r: 34, g: 139, b: 34 },
64
- fuchsia: { r: 255, g: 0, b: 255 },
65
- gainsboro: { r: 220, g: 220, b: 220 },
66
- ghostwhite: { r: 248, g: 248, b: 255 },
67
- gold: { r: 255, g: 215, b: 0 },
68
- goldenrod: { r: 218, g: 165, b: 32 },
69
- gray: { r: 128, g: 128, b: 128 },
70
- green: { r: 0, g: 128, b: 0 },
71
- greenyellow: { r: 173, g: 255, b: 47 },
72
- grey: { r: 128, g: 128, b: 128 },
73
- honeydew: { r: 240, g: 255, b: 240 },
74
- hotpink: { r: 255, g: 105, b: 180 },
75
- indianred: { r: 205, g: 92, b: 92 },
76
- indigo: { r: 75, g: 0, b: 130 },
77
- ivory: { r: 255, g: 255, b: 240 },
78
- khaki: { r: 240, g: 230, b: 140 },
79
- lavender: { r: 230, g: 230, b: 250 },
80
- lavenderblush: { r: 255, g: 240, b: 245 },
81
- lawngreen: { r: 124, g: 252, b: 0 },
82
- lemonchiffon: { r: 255, g: 250, b: 205 },
83
- lightblue: { r: 173, g: 216, b: 230 },
84
- lightcoral: { r: 240, g: 128, b: 128 },
85
- lightcyan: { r: 224, g: 255, b: 255 },
86
- lightgoldenrodyellow: { r: 250, g: 250, b: 210 },
87
- lightgray: { r: 211, g: 211, b: 211 },
88
- lightgreen: { r: 144, g: 238, b: 144 },
89
- lightgrey: { r: 211, g: 211, b: 211 },
90
- lightpink: { r: 255, g: 182, b: 193 },
91
- lightsalmon: { r: 255, g: 160, b: 122 },
92
- lightseagreen: { r: 32, g: 178, b: 170 },
93
- lightskyblue: { r: 135, g: 206, b: 250 },
94
- lightslategray: { r: 119, g: 136, b: 153 },
95
- lightslategrey: { r: 119, g: 136, b: 153 },
96
- lightsteelblue: { r: 176, g: 196, b: 222 },
97
- lightyellow: { r: 255, g: 255, b: 224 },
98
- lime: { r: 0, g: 255, b: 0 },
99
- limegreen: { r: 50, g: 205, b: 50 },
100
- linen: { r: 250, g: 240, b: 230 },
101
- magenta: { r: 255, g: 0, b: 255 },
102
- maroon: { r: 128, g: 0, b: 0 },
103
- mediumaquamarine: { r: 102, g: 205, b: 170 },
104
- mediumblue: { r: 0, g: 0, b: 205 },
105
- mediumorchid: { r: 186, g: 85, b: 211 },
106
- mediumpurple: { r: 147, g: 112, b: 219 },
107
- mediumseagreen: { r: 60, g: 179, b: 113 },
108
- mediumslateblue: { r: 123, g: 104, b: 238 },
109
- mediumspringgreen: { r: 0, g: 250, b: 154 },
110
- mediumturquoise: { r: 72, g: 209, b: 204 },
111
- mediumvioletred: { r: 199, g: 21, b: 133 },
112
- midnightblue: { r: 25, g: 25, b: 112 },
113
- mintcream: { r: 245, g: 255, b: 250 },
114
- mistyrose: { r: 255, g: 228, b: 225 },
115
- moccasin: { r: 255, g: 228, b: 181 },
116
- navajowhite: { r: 255, g: 222, b: 173 },
117
- navy: { r: 0, g: 0, b: 128 },
118
- oldlace: { r: 253, g: 245, b: 230 },
119
- olive: { r: 128, g: 128, b: 0 },
120
- olivedrab: { r: 107, g: 142, b: 35 },
121
- orange: { r: 255, g: 165, b: 0 },
122
- orangered: { r: 255, g: 69, b: 0 },
123
- orchid: { r: 218, g: 112, b: 214 },
124
- palegoldenrod: { r: 238, g: 232, b: 170 },
125
- palegreen: { r: 152, g: 251, b: 152 },
126
- paleturquoise: { r: 175, g: 238, b: 238 },
127
- palevioletred: { r: 219, g: 112, b: 147 },
128
- papayawhip: { r: 255, g: 239, b: 213 },
129
- peachpuff: { r: 255, g: 218, b: 185 },
130
- peru: { r: 205, g: 133, b: 63 },
131
- pink: { r: 255, g: 192, b: 203 },
132
- plum: { r: 221, g: 160, b: 221 },
133
- powderblue: { r: 176, g: 224, b: 230 },
134
- purple: { r: 128, g: 0, b: 128 },
135
- rebeccapurple: { r: 102, g: 51, b: 153 },
136
- red: { r: 255, g: 0, b: 0 },
137
- rosybrown: { r: 188, g: 143, b: 143 },
138
- royalblue: { r: 65, g: 105, b: 225 },
139
- saddlebrown: { r: 139, g: 69, b: 19 },
140
- salmon: { r: 250, g: 128, b: 114 },
141
- sandybrown: { r: 244, g: 164, b: 96 },
142
- seagreen: { r: 46, g: 139, b: 87 },
143
- seashell: { r: 255, g: 245, b: 238 },
144
- sienna: { r: 160, g: 82, b: 45 },
145
- silver: { r: 192, g: 192, b: 192 },
146
- skyblue: { r: 135, g: 206, b: 235 },
147
- slateblue: { r: 106, g: 90, b: 205 },
148
- slategray: { r: 112, g: 128, b: 144 },
149
- slategrey: { r: 112, g: 128, b: 144 },
150
- snow: { r: 255, g: 250, b: 250 },
151
- springgreen: { r: 0, g: 255, b: 127 },
152
- steelblue: { r: 70, g: 130, b: 180 },
153
- tan: { r: 210, g: 180, b: 140 },
154
- teal: { r: 0, g: 128, b: 128 },
155
- thistle: { r: 216, g: 191, b: 216 },
156
- tomato: { r: 255, g: 99, b: 71 },
157
- turquoise: { r: 64, g: 224, b: 208 },
158
- violet: { r: 238, g: 130, b: 238 },
159
- wheat: { r: 245, g: 222, b: 179 },
160
- white: { r: 255, g: 255, b: 255 },
161
- whitesmoke: { r: 245, g: 245, b: 245 },
162
- yellow: { r: 255, g: 255, b: 0 },
163
- yellowgreen: { r: 154, g: 205, b: 50 }
164
- };
165
-
166
- // src/agnostic/colors/typechecks/index.ts
167
- var isHex = (color) => {
168
- if (typeof color !== "string") return false;
169
- if (!color.startsWith("#")) return false;
170
- const withoutHash = color.slice(1);
171
- const withoutHashLength = withoutHash.length;
172
- const allowedLengths = [3, 4, 6, 8];
173
- if (!allowedLengths.includes(withoutHashLength)) return false;
174
- return /^[0-9a-f]+$/igm.test(withoutHash);
175
- };
176
- var isRgb = (color) => {
177
- if (!isNonNullObject(color)) return false;
178
- const { r, g, b, a } = color;
179
- if (typeof r !== "number") return false;
180
- if (typeof g !== "number") return false;
181
- if (typeof b !== "number") return false;
182
- if (a !== void 0 && typeof a !== "number") return false;
183
- return true;
184
- };
185
- var isHsl = (color) => {
186
- if (!isNonNullObject(color)) return false;
187
- const { h, s, l, a } = color;
188
- if (typeof h !== "number") return false;
189
- if (typeof s !== "number") return false;
190
- if (typeof l !== "number") return false;
191
- if (a !== void 0 && typeof a !== "number") return false;
192
- return true;
193
- };
194
- var isHsb = (color) => {
195
- if (!isNonNullObject(color)) return false;
196
- const { h, s, b, a } = color;
197
- if (typeof h !== "number") return false;
198
- if (typeof s !== "number") return false;
199
- if (typeof b !== "number") return false;
200
- if (a !== void 0 && typeof a !== "number") return false;
201
- return true;
202
- };
203
- var isLab = (color) => {
204
- if (!isNonNullObject(color)) return false;
205
- const { l, a, b, al } = color;
206
- if (typeof l !== "number") return false;
207
- if (typeof a !== "number") return false;
208
- if (typeof b !== "number") return false;
209
- if (al !== void 0 && typeof al !== "number") return false;
210
- return true;
211
- };
212
- var isLch = (color) => {
213
- if (!isNonNullObject(color)) return false;
214
- const { l, c, h, a } = color;
215
- if (typeof l !== "number") return false;
216
- if (typeof c !== "number") return false;
217
- if (typeof h !== "number") return false;
218
- if (a !== void 0 && typeof a !== "number") return false;
219
- return true;
220
- };
221
- var isCmyk = (color) => {
222
- if (!isNonNullObject(color)) return false;
223
- const { c, m, y, k, a } = color;
224
- if (typeof c !== "number") return false;
225
- if (typeof m !== "number") return false;
226
- if (typeof y !== "number") return false;
227
- if (typeof k !== "number") return false;
228
- if (a !== void 0 && typeof a !== "number") return false;
229
- return true;
230
- };
231
- var isXyz = (color) => {
232
- if (!isNonNullObject(color)) return false;
233
- const { x, y, z, a } = color;
234
- if (typeof x !== "number") return false;
235
- if (typeof y !== "number") return false;
236
- if (typeof z !== "number") return false;
237
- if (a !== void 0 && typeof a !== "number") return false;
238
- return true;
239
- };
240
- var isCssColor = (color) => typeof color === "string" && cssColors[color] !== void 0;
241
-
242
- // src/agnostic/numbers/clamp/index.ts
243
- function clamp(num, bound1, bound2) {
244
- const min = Math.min(bound1, bound2);
245
- const max = Math.max(bound1, bound2);
246
- return Math.min(Math.max(num, min), max);
247
- }
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/tidy/index.ts
259
- function tidy(color) {
260
- const _color = color;
261
- if (isRgb(_color)) return {
262
- r: clamp(_color.r, 0, 255),
263
- g: clamp(_color.g, 0, 255),
264
- b: clamp(_color.b, 0, 255),
265
- a: clamp(_color.a ?? 1, 0, 1)
266
- };
267
- if (isHsl(_color)) return {
268
- h: absoluteModulo(_color.h, 360),
269
- s: clamp(_color.s, 0, 100),
270
- l: clamp(_color.l, 0, 100),
271
- a: clamp(_color.a ?? 1, 0, 1)
272
- };
273
- if (isHsb(_color)) return {
274
- h: absoluteModulo(_color.h, 360),
275
- s: clamp(_color.s, 0, 100),
276
- b: clamp(_color.b, 0, 100),
277
- a: clamp(_color.a ?? 1, 0, 1)
278
- };
279
- if (isCmyk(_color)) return {
280
- c: clamp(_color.c, 0, 100),
281
- m: clamp(_color.m, 0, 100),
282
- y: clamp(_color.y, 0, 100),
283
- k: clamp(_color.k, 0, 100),
284
- a: clamp(_color.a ?? 1, 0, 1)
285
- };
286
- if (isXyz(_color)) return {
287
- x: _color.x,
288
- y: _color.y,
289
- z: _color.z,
290
- a: clamp(_color.a ?? 1, 0, 1)
291
- };
292
- if (isLab(_color)) return {
293
- l: clamp(_color.l, 0, 100),
294
- a: _color.a,
295
- b: _color.b,
296
- al: clamp(_color.al ?? 1, 0, 1)
297
- };
298
- if (isLch(_color)) return {
299
- l: clamp(_color.l, 0, 100),
300
- c: Math.max(0, _color.c),
301
- h: clamp(_color.h, 0, 360),
302
- a: clamp(_color.a ?? 1, 0, 1)
303
- };
304
- if (isCssColor(_color)) return tidy(toRgb(_color));
305
- if (isHex(_color)) return toHex(tidy(toRgb(_color)));
306
- const _typecheck = true;
307
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
308
- }
309
-
310
- // src/agnostic/colors/convert/index.ts
1
+ import { absoluteModulo } from '../../numbers/absolute-modulo/index.js';
2
+ import { tidy } from '../tidy/index.js';
3
+ import { cssColors } from '../cssColorsMap.js';
4
+ import { isHex, isRgb, isHsl, isHsb, isCmyk, isCssColor, isXyz, isLab, isLch } from '../typechecks/index.js';
5
+ import { unknownToString } from '../../errors/unknown-to-string/index.js';
6
+ /* * * * * * * * * * * * * * * * * *
7
+ * Convertion building blocks
8
+ * * * * * * * * * * * * * * * * * */
9
+ // RGB ↔ Hex
10
+ // [WIP] maybe use absoluteModulo where needed?
11
+ // needs rewrite, hex char checks, etc
311
12
  function _hex2rgb(hex) {
312
- if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
313
- let hexString = hex;
314
- const inputHex = hexString;
315
- const startsWithHash = hexString.startsWith("#");
316
- if (!startsWithHash) throw new Error(`invalid hex color ${inputHex}`);
317
- hexString = hexString.slice(1);
318
- if (hexString.length === 3) {
319
- hexString = hexString.split("").map((c) => c + c).join("") + "ff";
320
- } else if (hexString.length === 4) {
321
- hexString = hexString.split("").map((c) => c + c).join("");
322
- } else if (hexString.length === 6) {
323
- hexString = hexString + "ff";
324
- } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
325
- const r = parseInt(hexString.slice(0, 2), 16);
326
- const g = parseInt(hexString.slice(2, 4), 16);
327
- const b = parseInt(hexString.slice(4, 6), 16);
328
- const a = parseInt(hexString.slice(6, 8), 16) / 255;
329
- return { r, g, b, a };
13
+ // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
14
+ if (!isHex(hex))
15
+ throw new Error(`invalid hex color ${unknownToString(hex)}`);
16
+ let hexString = hex;
17
+ const inputHex = hexString;
18
+ const startsWithHash = hexString.startsWith('#');
19
+ if (!startsWithHash)
20
+ throw new Error(`invalid hex color ${inputHex}`);
21
+ hexString = hexString.slice(1);
22
+ if (hexString.length === 3) {
23
+ hexString = hexString.split('').map(c => c + c).join('') + 'ff';
24
+ }
25
+ else if (hexString.length === 4) {
26
+ hexString = hexString.split('').map(c => c + c).join('');
27
+ }
28
+ else if (hexString.length === 6) {
29
+ hexString = hexString + 'ff';
30
+ }
31
+ else if (hexString.length !== 8)
32
+ throw new Error(`invalid hex color ${inputHex}`);
33
+ const r = parseInt(hexString.slice(0, 2), 16);
34
+ const g = parseInt(hexString.slice(2, 4), 16);
35
+ const b = parseInt(hexString.slice(4, 6), 16);
36
+ const a = parseInt(hexString.slice(6, 8), 16) / 255;
37
+ return { r, g, b, a };
330
38
  }
331
39
  function _rgb2hex(rgb) {
332
- const { r, g, b, a = 1 } = rgb;
333
- const rHex = Math.round(r).toString(16).padStart(2, "0");
334
- const gHex = Math.round(g).toString(16).padStart(2, "0");
335
- const bHex = Math.round(b).toString(16).padStart(2, "0");
336
- const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
337
- const returned = `#${rHex}${gHex}${bHex}${aHex}`;
338
- if (!isHex(returned)) {
339
- throw new Error(`invalid hex color output ${unknownToString(returned)}`);
340
- }
341
- return returned;
40
+ const { r, g, b, a = 1 } = rgb;
41
+ const rHex = Math.round(r).toString(16).padStart(2, '0');
42
+ const gHex = Math.round(g).toString(16).padStart(2, '0');
43
+ const bHex = Math.round(b).toString(16).padStart(2, '0');
44
+ const aHex = Math.round(a * 255).toString(16).padStart(2, '0');
45
+ const returned = `#${rHex}${gHex}${bHex}${aHex}`;
46
+ if (!isHex(returned)) {
47
+ // Here typescript says returned is 'never' but this is because
48
+ // isHex function is more strict than Hex type, so technically
49
+ // isHex(hex) can return false, for instance if hex === '#zzz'
50
+ throw new Error(`invalid hex color output ${unknownToString(returned)}`);
51
+ }
52
+ return returned;
342
53
  }
343
54
  function _css2rgb(color) {
344
- if (color in cssColors) return cssColors[color];
345
- return void 0;
346
- }
347
- var cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
348
- name: cssColor,
349
- hex: _rgb2hex(rgba),
350
- rgba
55
+ if (color in cssColors)
56
+ return cssColors[color];
57
+ return undefined;
58
+ }
59
+ const cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
60
+ name: cssColor,
61
+ hex: _rgb2hex(rgba),
62
+ rgba
351
63
  }));
352
64
  function _rgb2css(rgb) {
353
- const hexTarget = _rgb2hex(rgb);
354
- return cssColorsWithHex.find((c) => c.hex === hexTarget)?.name;
65
+ const hexTarget = _rgb2hex(rgb);
66
+ return cssColorsWithHex.find(c => c.hex === hexTarget)?.name;
355
67
  }
68
+ // RGB ↔ HSL
356
69
  function _hsl2rgb(hsl) {
357
- const { h, s, l, a = 1 } = hsl;
358
- const H = absoluteModulo(h, 360) / 360;
359
- const S = Math.max(0, Math.min(1, s / 100));
360
- const L = Math.max(0, Math.min(1, l / 100));
361
- const A = Math.max(0, Math.min(1, a));
362
- const hue2rgb = (p, q, t) => {
363
- if (t < 0) t += 1;
364
- if (t > 1) t -= 1;
365
- if (t < 1 / 6) return p + (q - p) * 6 * t;
366
- if (t < 1 / 2) return q;
367
- if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
368
- return p;
369
- };
370
- let r;
371
- let g;
372
- let b;
373
- if (S === 0) {
374
- r = g = b = L;
375
- } else {
376
- const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
377
- const p = 2 * L - q;
378
- r = hue2rgb(p, q, H + 1 / 3);
379
- g = hue2rgb(p, q, H);
380
- b = hue2rgb(p, q, H - 1 / 3);
381
- }
382
- return {
383
- r: Math.round(r * 255),
384
- g: Math.round(g * 255),
385
- b: Math.round(b * 255),
386
- a: A
387
- };
70
+ const { h, s, l, a = 1 } = hsl;
71
+ const H = absoluteModulo(h, 360) / 360;
72
+ const S = Math.max(0, Math.min(1, s / 100));
73
+ const L = Math.max(0, Math.min(1, l / 100));
74
+ const A = Math.max(0, Math.min(1, a));
75
+ const hue2rgb = (p, q, t) => {
76
+ if (t < 0)
77
+ t += 1;
78
+ if (t > 1)
79
+ t -= 1;
80
+ if (t < 1 / 6)
81
+ return p + (q - p) * 6 * t;
82
+ if (t < 1 / 2)
83
+ return q;
84
+ if (t < 2 / 3)
85
+ return p + (q - p) * (2 / 3 - t) * 6;
86
+ return p;
87
+ };
88
+ let r;
89
+ let g;
90
+ let b;
91
+ if (S === 0) {
92
+ r = g = b = L; // achromatic
93
+ }
94
+ else {
95
+ const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
96
+ const p = 2 * L - q;
97
+ r = hue2rgb(p, q, H + 1 / 3);
98
+ g = hue2rgb(p, q, H);
99
+ b = hue2rgb(p, q, H - 1 / 3);
100
+ }
101
+ return {
102
+ r: Math.round(r * 255),
103
+ g: Math.round(g * 255),
104
+ b: Math.round(b * 255),
105
+ a: A
106
+ };
388
107
  }
389
108
  function _rgb2hsl(rgb) {
390
- const { r, g, b, a = 1 } = rgb;
391
- const R = r / 255;
392
- const G = g / 255;
393
- const B = b / 255;
394
- const max = Math.max(R, G, B);
395
- const min = Math.min(R, G, B);
396
- const delta = max - min;
397
- let h = 0;
398
- let s = 0;
399
- const l = (max + min) / 2;
400
- if (delta !== 0) {
401
- s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
402
- if (max === R) {
403
- h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
404
- } else if (max === G) {
405
- h = ((B - R) / delta + 2) / 6;
406
- } else {
407
- h = ((R - G) / delta + 4) / 6;
109
+ const { r, g, b, a = 1 } = rgb;
110
+ const R = r / 255;
111
+ const G = g / 255;
112
+ const B = b / 255;
113
+ const max = Math.max(R, G, B);
114
+ const min = Math.min(R, G, B);
115
+ const delta = max - min;
116
+ let h = 0;
117
+ let s = 0;
118
+ const l = (max + min) / 2;
119
+ if (delta !== 0) {
120
+ s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
121
+ if (max === R) {
122
+ h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
123
+ }
124
+ else if (max === G) {
125
+ h = ((B - R) / delta + 2) / 6;
126
+ }
127
+ else {
128
+ h = ((R - G) / delta + 4) / 6;
129
+ }
408
130
  }
409
- }
410
- return {
411
- h: Math.round(h * 360),
412
- s: Math.round(s * 100),
413
- l: Math.round(l * 100),
414
- a
415
- };
416
- }
131
+ return {
132
+ h: Math.round(h * 360),
133
+ s: Math.round(s * 100),
134
+ l: Math.round(l * 100),
135
+ a
136
+ };
137
+ }
138
+ // RGB ↔ HSB
417
139
  function _hsb2rgb(hsb) {
418
- const { h, s, b, a = 1 } = hsb;
419
- const H = absoluteModulo(h, 360) / 360;
420
- const S = Math.max(0, Math.min(1, s / 100));
421
- const B = Math.max(0, Math.min(1, b / 100));
422
- const A = Math.max(0, Math.min(1, a));
423
- const i = Math.floor(H * 6);
424
- const f = H * 6 - i;
425
- const p = B * (1 - S);
426
- const q = B * (1 - f * S);
427
- const t = B * (1 - (1 - f) * S);
428
- let r;
429
- let g;
430
- let blue;
431
- switch (absoluteModulo(i, 6)) {
432
- case 0:
433
- r = B;
434
- g = t;
435
- blue = p;
436
- break;
437
- case 1:
438
- r = q;
439
- g = B;
440
- blue = p;
441
- break;
442
- case 2:
443
- r = p;
444
- g = B;
445
- blue = t;
446
- break;
447
- case 3:
448
- r = p;
449
- g = q;
450
- blue = B;
451
- break;
452
- case 4:
453
- r = t;
454
- g = p;
455
- blue = B;
456
- break;
457
- case 5:
458
- r = B;
459
- g = p;
460
- blue = q;
461
- break;
462
- default:
463
- r = g = blue = 0;
464
- }
465
- return {
466
- r: Math.round(r * 255),
467
- g: Math.round(g * 255),
468
- b: Math.round(blue * 255),
469
- a: A
470
- };
140
+ const { h, s, b, a = 1 } = hsb;
141
+ const H = absoluteModulo(h, 360) / 360;
142
+ const S = Math.max(0, Math.min(1, s / 100));
143
+ const B = Math.max(0, Math.min(1, b / 100));
144
+ const A = Math.max(0, Math.min(1, a));
145
+ const i = Math.floor(H * 6);
146
+ const f = H * 6 - i;
147
+ const p = B * (1 - S);
148
+ const q = B * (1 - f * S);
149
+ const t = B * (1 - (1 - f) * S);
150
+ let r;
151
+ let g;
152
+ let blue;
153
+ switch (absoluteModulo(i, 6)) {
154
+ case 0:
155
+ r = B;
156
+ g = t;
157
+ blue = p;
158
+ break;
159
+ case 1:
160
+ r = q;
161
+ g = B;
162
+ blue = p;
163
+ break;
164
+ case 2:
165
+ r = p;
166
+ g = B;
167
+ blue = t;
168
+ break;
169
+ case 3:
170
+ r = p;
171
+ g = q;
172
+ blue = B;
173
+ break;
174
+ case 4:
175
+ r = t;
176
+ g = p;
177
+ blue = B;
178
+ break;
179
+ case 5:
180
+ r = B;
181
+ g = p;
182
+ blue = q;
183
+ break;
184
+ default: r = g = blue = 0;
185
+ }
186
+ return {
187
+ r: Math.round(r * 255),
188
+ g: Math.round(g * 255),
189
+ b: Math.round(blue * 255),
190
+ a: A
191
+ };
471
192
  }
472
193
  function _rgb2hsb(rgb) {
473
- const { r, g, b, a = 1 } = rgb;
474
- const R = r / 255;
475
- const G = g / 255;
476
- const B = b / 255;
477
- const max = Math.max(R, G, B);
478
- const min = Math.min(R, G, B);
479
- const delta = max - min;
480
- let h = 0;
481
- let s = 0;
482
- const brightness = max;
483
- if (max !== 0) {
484
- s = delta / max;
485
- }
486
- if (delta !== 0) {
487
- if (max === R) {
488
- h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
489
- } else if (max === G) {
490
- h = ((B - R) / delta + 2) / 6;
491
- } else {
492
- h = ((R - G) / delta + 4) / 6;
194
+ const { r, g, b, a = 1 } = rgb;
195
+ const R = r / 255;
196
+ const G = g / 255;
197
+ const B = b / 255;
198
+ const max = Math.max(R, G, B);
199
+ const min = Math.min(R, G, B);
200
+ const delta = max - min;
201
+ let h = 0;
202
+ let s = 0;
203
+ const brightness = max;
204
+ if (max !== 0) {
205
+ s = delta / max;
493
206
  }
494
- }
495
- return {
496
- h: Math.round(h * 360),
497
- s: Math.round(s * 100),
498
- b: Math.round(brightness * 100),
499
- a
500
- };
501
- }
207
+ if (delta !== 0) {
208
+ if (max === R) {
209
+ h = ((G - B) / delta + (G < B ? 6 : 0)) / 6;
210
+ }
211
+ else if (max === G) {
212
+ h = ((B - R) / delta + 2) / 6;
213
+ }
214
+ else {
215
+ h = ((R - G) / delta + 4) / 6;
216
+ }
217
+ }
218
+ return {
219
+ h: Math.round(h * 360),
220
+ s: Math.round(s * 100),
221
+ b: Math.round(brightness * 100),
222
+ a
223
+ };
224
+ }
225
+ // RGB ↔ CMYK
502
226
  function _cmyk2rgb(cmyka) {
503
- const { c, m, y, k, a = 1 } = cmyka;
504
- const C = Math.max(0, Math.min(100, c)) / 100;
505
- const M = Math.max(0, Math.min(100, m)) / 100;
506
- const Y = Math.max(0, Math.min(100, y)) / 100;
507
- const K = Math.max(0, Math.min(100, k)) / 100;
508
- const A = Math.max(0, Math.min(1, a));
509
- const R = 1 - Math.min(1, C * (1 - K) + K);
510
- const G = 1 - Math.min(1, M * (1 - K) + K);
511
- const B = 1 - Math.min(1, Y * (1 - K) + K);
512
- return {
513
- r: Math.round(R * 255),
514
- g: Math.round(G * 255),
515
- b: Math.round(B * 255),
516
- a: A
517
- };
227
+ const { c, m, y, k, a = 1 } = cmyka;
228
+ // Clamp input to 0100
229
+ const C = Math.max(0, Math.min(100, c)) / 100;
230
+ const M = Math.max(0, Math.min(100, m)) / 100;
231
+ const Y = Math.max(0, Math.min(100, y)) / 100;
232
+ const K = Math.max(0, Math.min(100, k)) / 100;
233
+ const A = Math.max(0, Math.min(1, a));
234
+ // CMYK RGB formula
235
+ const R = 1 - Math.min(1, C * (1 - K) + K);
236
+ const G = 1 - Math.min(1, M * (1 - K) + K);
237
+ const B = 1 - Math.min(1, Y * (1 - K) + K);
238
+ return {
239
+ r: Math.round(R * 255),
240
+ g: Math.round(G * 255),
241
+ b: Math.round(B * 255),
242
+ a: A
243
+ };
518
244
  }
519
245
  function _rgb2cmyk(rgb) {
520
- const { r, g, b, a = 1 } = rgb;
521
- const R = Math.max(0, Math.min(1, r / 255));
522
- const G = Math.max(0, Math.min(1, g / 255));
523
- const B = Math.max(0, Math.min(1, b / 255));
524
- const A = Math.max(0, Math.min(1, a));
525
- const K = 1 - Math.max(R, G, B);
526
- const denom = 1 - K || 1;
527
- const C = (1 - R - K) / denom;
528
- const M = (1 - G - K) / denom;
529
- const Y = (1 - B - K) / denom;
530
- return {
531
- c: Math.round(C * 100),
532
- m: Math.round(M * 100),
533
- y: Math.round(Y * 100),
534
- k: Math.round(K * 100),
535
- a: A
536
- };
537
- }
246
+ const { r, g, b, a = 1 } = rgb;
247
+ // Normalize RGB to 01
248
+ const R = Math.max(0, Math.min(1, r / 255));
249
+ const G = Math.max(0, Math.min(1, g / 255));
250
+ const B = Math.max(0, Math.min(1, b / 255));
251
+ const A = Math.max(0, Math.min(1, a));
252
+ // Compute K (black)
253
+ const K = 1 - Math.max(R, G, B);
254
+ // Avoid division by zero
255
+ // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
256
+ const denom = 1 - K || 1;
257
+ // Compute C, M, Y
258
+ const C = (1 - R - K) / denom;
259
+ const M = (1 - G - K) / denom;
260
+ const Y = (1 - B - K) / denom;
261
+ return {
262
+ c: Math.round(C * 100),
263
+ m: Math.round(M * 100),
264
+ y: Math.round(Y * 100),
265
+ k: Math.round(K * 100),
266
+ a: A
267
+ };
268
+ }
269
+ // Rgb ↔ XYZ
538
270
  function _xyz2rgb(xyza) {
539
- const { x, y, z, a = 1 } = xyza;
540
- const X = x / 100;
541
- const Y = y / 100;
542
- const Z = z / 100;
543
- const A = Math.max(0, Math.min(1, a));
544
- let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
545
- let G = X * -0.969266 + Y * 1.8760108 + Z * 0.041556;
546
- let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
547
- const GAMMA_THRESHOLD = 31308e-7;
548
- const GAMMA_EXPONENT = 1 / 2.4;
549
- const GAMMA_MULT = 1.055;
550
- const GAMMA_OFFSET = 0.055;
551
- const LINEAR_DIVISOR = 12.92;
552
- const gammaCorrect = (c) => c <= GAMMA_THRESHOLD ? c * LINEAR_DIVISOR : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
553
- R = gammaCorrect(R);
554
- G = gammaCorrect(G);
555
- B = gammaCorrect(B);
556
- return {
557
- r: Math.round(Math.max(0, Math.min(1, R)) * 255),
558
- g: Math.round(Math.max(0, Math.min(1, G)) * 255),
559
- b: Math.round(Math.max(0, Math.min(1, B)) * 255),
560
- a: A
561
- };
271
+ const { x, y, z, a = 1 } = xyza;
272
+ // Normalize XYZ to 0–1
273
+ const X = x / 100;
274
+ const Y = y / 100;
275
+ const Z = z / 100;
276
+ const A = Math.max(0, Math.min(1, a));
277
+ // XYZ linear RGB (D65)
278
+ let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
279
+ let G = X * -0.9692660 + Y * 1.8760108 + Z * 0.0415560;
280
+ let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
281
+ // Apply gamma correction
282
+ const GAMMA_THRESHOLD = 0.0031308;
283
+ const GAMMA_EXPONENT = 1 / 2.4;
284
+ const GAMMA_MULT = 1.055;
285
+ const GAMMA_OFFSET = 0.055;
286
+ const LINEAR_DIVISOR = 12.92;
287
+ const gammaCorrect = (c) => c <= GAMMA_THRESHOLD
288
+ ? c * LINEAR_DIVISOR
289
+ : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
290
+ R = gammaCorrect(R);
291
+ G = gammaCorrect(G);
292
+ B = gammaCorrect(B);
293
+ return {
294
+ r: Math.round(Math.max(0, Math.min(1, R)) * 255),
295
+ g: Math.round(Math.max(0, Math.min(1, G)) * 255),
296
+ b: Math.round(Math.max(0, Math.min(1, B)) * 255),
297
+ a: A
298
+ };
562
299
  }
563
300
  function _rgb2xyz(rgb) {
564
- const { r, g, b, a = 1 } = rgb;
565
- let R = Math.max(0, Math.min(1, r / 255));
566
- let G = Math.max(0, Math.min(1, g / 255));
567
- let B = Math.max(0, Math.min(1, b / 255));
568
- const A = Math.max(0, Math.min(1, a));
569
- const SRGB_THRESHOLD = 0.04045;
570
- const SRGB_OFFSET = 0.055;
571
- const SRGB_DIVISOR = 1.055;
572
- const SRGB_EXPONENT = 2.4;
573
- const SRGB_LINEAR_DIVISOR = 12.92;
574
- const linearize = (c) => c > SRGB_THRESHOLD ? Math.pow((c + SRGB_OFFSET) / SRGB_DIVISOR, SRGB_EXPONENT) : c / SRGB_LINEAR_DIVISOR;
575
- R = linearize(R);
576
- G = linearize(G);
577
- B = linearize(B);
578
- const X = R * 0.4124564 + G * 0.3575761 + B * 0.1804375;
579
- const Y = R * 0.2126729 + G * 0.7151522 + B * 0.072175;
580
- const Z = R * 0.0193339 + G * 0.119192 + B * 0.9503041;
581
- return {
582
- x: X * 100,
583
- y: Y * 100,
584
- z: Z * 100,
585
- a: A
586
- };
587
- }
301
+ const { r, g, b, a = 1 } = rgb;
302
+ // Normalize RGB to 01
303
+ let R = Math.max(0, Math.min(1, r / 255));
304
+ let G = Math.max(0, Math.min(1, g / 255));
305
+ let B = Math.max(0, Math.min(1, b / 255));
306
+ const A = Math.max(0, Math.min(1, a));
307
+ // Apply inverse gamma correction (sRGB → linear)
308
+ const SRGB_THRESHOLD = 0.04045;
309
+ const SRGB_OFFSET = 0.055;
310
+ const SRGB_DIVISOR = 1.055;
311
+ const SRGB_EXPONENT = 2.4;
312
+ const SRGB_LINEAR_DIVISOR = 12.92;
313
+ const linearize = (c) => c > SRGB_THRESHOLD
314
+ ? Math.pow((c + SRGB_OFFSET) / SRGB_DIVISOR, SRGB_EXPONENT)
315
+ : c / SRGB_LINEAR_DIVISOR;
316
+ R = linearize(R);
317
+ G = linearize(G);
318
+ B = linearize(B);
319
+ // Linear RGB → XYZ (D65)
320
+ const X = R * 0.4124564 + G * 0.3575761 + B * 0.1804375;
321
+ const Y = R * 0.2126729 + G * 0.7151522 + B * 0.0721750;
322
+ const Z = R * 0.0193339 + G * 0.1191920 + B * 0.9503041;
323
+ return {
324
+ x: X * 100,
325
+ y: Y * 100,
326
+ z: Z * 100,
327
+ a: A
328
+ };
329
+ }
330
+ // XYZ ↔ LAB
588
331
  function _lab2xyz(lab) {
589
- const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
590
- const REF_X = 95.047;
591
- const REF_Y = 100;
592
- const REF_Z = 108.883;
593
- const fy = (l + 16) / 116;
594
- const fx = fy + A / 500;
595
- const fz = fy - B / 200;
596
- const fx3 = Math.pow(fx, 3);
597
- const fz3 = Math.pow(fz, 3);
598
- const fy3 = Math.pow(fy, 3);
599
- const epsilon = 8856e-6;
600
- const kappa = 903.3;
601
- const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
602
- const Y = l > kappa * epsilon ? fy3 : l / kappa;
603
- const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
604
- return {
605
- x: X * REF_X,
606
- y: Y * REF_Y,
607
- z: Z * REF_Z,
608
- a: Math.max(0, Math.min(1, alpha))
609
- };
332
+ const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
333
+ // D65 reference white
334
+ const REF_X = 95.047;
335
+ const REF_Y = 100.0;
336
+ const REF_Z = 108.883;
337
+ const fy = (l + 16) / 116;
338
+ const fx = fy + A / 500;
339
+ const fz = fy - B / 200;
340
+ const fx3 = Math.pow(fx, 3);
341
+ const fz3 = Math.pow(fz, 3);
342
+ const fy3 = Math.pow(fy, 3);
343
+ const epsilon = 0.008856; // CIE standard
344
+ const kappa = 903.3; // CIE standard
345
+ const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
346
+ const Y = l > (kappa * epsilon) ? fy3 : l / kappa;
347
+ const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
348
+ return {
349
+ x: X * REF_X,
350
+ y: Y * REF_Y,
351
+ z: Z * REF_Z,
352
+ a: Math.max(0, Math.min(1, alpha))
353
+ };
610
354
  }
611
355
  function _xyz2lab(xyza) {
612
- const { x, y, z, a: alpha = 1 } = xyza;
613
- const REF_X = 95.047;
614
- const REF_Y = 100;
615
- const REF_Z = 108.883;
616
- const X = x / REF_X;
617
- const Y = y / REF_Y;
618
- const Z = z / REF_Z;
619
- const epsilon = 8856e-6;
620
- const kappa = 903.3;
621
- const fx = X > epsilon ? Math.cbrt(X) : (kappa * X + 16) / 116;
622
- const fy = Y > epsilon ? Math.cbrt(Y) : (kappa * Y + 16) / 116;
623
- const fz = Z > epsilon ? Math.cbrt(Z) : (kappa * Z + 16) / 116;
624
- const L = 116 * fy - 16;
625
- const A = 500 * (fx - fy);
626
- const B = 200 * (fy - fz);
627
- return {
628
- l: L,
629
- a: A,
630
- b: B,
631
- al: Math.max(0, Math.min(1, alpha))
632
- };
633
- }
356
+ const { x, y, z, a: alpha = 1 } = xyza;
357
+ // D65 reference white
358
+ const REF_X = 95.047;
359
+ const REF_Y = 100.0;
360
+ const REF_Z = 108.883;
361
+ const X = x / REF_X;
362
+ const Y = y / REF_Y;
363
+ const Z = z / REF_Z;
364
+ const epsilon = 0.008856; // CIE standard
365
+ const kappa = 903.3; // CIE standard
366
+ const fx = X > epsilon ? Math.cbrt(X) : (kappa * X + 16) / 116;
367
+ const fy = Y > epsilon ? Math.cbrt(Y) : (kappa * Y + 16) / 116;
368
+ const fz = Z > epsilon ? Math.cbrt(Z) : (kappa * Z + 16) / 116;
369
+ const L = 116 * fy - 16;
370
+ const A = 500 * (fx - fy);
371
+ const B = 200 * (fy - fz);
372
+ return {
373
+ l: L,
374
+ a: A,
375
+ b: B,
376
+ al: Math.max(0, Math.min(1, alpha))
377
+ };
378
+ }
379
+ // LAB ↔ LCH
634
380
  function _lab2lch(lab) {
635
- const { l, a, b, al = 1 } = lab;
636
- const c = Math.sqrt(a * a + b * b);
637
- let h = Math.atan2(b, a) * (180 / Math.PI);
638
- if (h < 0) h += 360;
639
- return { l, c, h, a: al };
381
+ const { l, a, b, al = 1 } = lab;
382
+ const c = Math.sqrt(a * a + b * b);
383
+ let h = Math.atan2(b, a) * (180 / Math.PI); // convert to degrees
384
+ if (h < 0)
385
+ h += 360;
386
+ return { l, c, h, a: al };
640
387
  }
641
388
  function _lch2lab(lch) {
642
- const { l, c, h, a = 1 } = lch;
643
- const hRad = h * Math.PI / 180;
644
- const A = c * Math.cos(hRad);
645
- const B = c * Math.sin(hRad);
646
- return { l, a: A, b: B, al: a };
647
- }
648
- function toRgb(color) {
649
- if (isRgb(color)) return color;
650
- if (isHsl(color)) return _hsl2rgb(color);
651
- if (isHsb(color)) return _hsb2rgb(color);
652
- if (isCmyk(color)) return _cmyk2rgb(color);
653
- if (isCssColor(color)) return _css2rgb(color);
654
- if (isHex(color)) return _hex2rgb(color);
655
- if (isXyz(color)) return _xyz2rgb(color);
656
- if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
657
- if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
658
- throw new Error(`Invalid color input: ${unknownToString(color)}`);
659
- }
660
- function toXyz(color) {
661
- if (isXyz(color)) return color;
662
- if (isLab(color)) return _lab2xyz(color);
663
- if (isLch(color)) return _lab2xyz(_lch2lab(color));
664
- if (isRgb(color)) return _rgb2xyz(color);
665
- if (isHsl(color)) return _rgb2xyz(_hsl2rgb(color));
666
- if (isHsb(color)) return _rgb2xyz(_hsb2rgb(color));
667
- if (isCmyk(color)) return _rgb2xyz(_cmyk2rgb(color));
668
- if (isCssColor(color)) return _rgb2xyz(_css2rgb(color));
669
- if (isHex(color)) return _rgb2xyz(_hex2rgb(color));
670
- throw new Error(`Invalid color input: ${unknownToString(color)}`);
671
- }
672
- function toLab(color) {
673
- if (isLab(color)) return color;
674
- if (isLch(color)) return _lch2lab(color);
675
- const xyzColor = toXyz(color);
676
- return _xyz2lab(xyzColor);
677
- }
678
- function toLch(color) {
679
- if (isLch(color)) return color;
680
- const labColor = toLab(color);
681
- return _lab2lch(labColor);
682
- }
683
- function toHsl(color) {
684
- if (isHsl(color)) return color;
685
- const rgbColor = toRgb(color);
686
- return _rgb2hsl(rgbColor);
687
- }
688
- function toHsb(color) {
689
- if (isHsb(color)) return color;
690
- const rgbColor = toRgb(color);
691
- return _rgb2hsb(rgbColor);
692
- }
693
- function toCmyk(color) {
694
- if (isCmyk(color)) return color;
695
- const rgbColor = toRgb(color);
696
- return _rgb2cmyk(rgbColor);
697
- }
698
- function toCss(color) {
699
- if (isCssColor(color)) return color;
700
- const rgbColor = toRgb(color);
701
- return _rgb2css(rgbColor);
702
- }
703
- function toHex(color) {
704
- if (isHex(color)) return color;
705
- const rgbColor = toRgb(color);
706
- return _rgb2hex(rgbColor);
707
- }
708
- function viaRgb(color, transformer) {
709
- const _color = color;
710
- const rgb = toRgb(_color);
711
- const transformedRgb = transformer(rgb);
712
- if (isRgb(_color)) return transformedRgb;
713
- if (isHsl(_color)) return toHsl(transformedRgb);
714
- if (isHsb(_color)) return toHsb(transformedRgb);
715
- if (isCmyk(_color)) return toCmyk(transformedRgb);
716
- if (isXyz(_color)) return toXyz(transformedRgb);
717
- if (isLab(_color)) return toLab(transformedRgb);
718
- if (isLch(_color)) return toLch(transformedRgb);
719
- if (isHex(_color)) return toRgb(transformedRgb);
720
- if (isCssColor(_color)) return transformedRgb;
721
- const _typecheck = true;
722
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
723
- }
724
- function viaHsl(color, transformer) {
725
- const _color = color;
726
- const hsl = toHsl(_color);
727
- const transformedHsl = transformer(hsl);
728
- if (isHsl(_color)) return transformedHsl;
729
- if (isRgb(_color)) return toRgb(transformedHsl);
730
- if (isHsb(_color)) return toHsb(transformedHsl);
731
- if (isCmyk(_color)) return toCmyk(transformedHsl);
732
- if (isXyz(_color)) return toXyz(transformedHsl);
733
- if (isLab(_color)) return toLab(transformedHsl);
734
- if (isLch(_color)) return toLch(transformedHsl);
735
- if (isHex(_color)) return toHex(transformedHsl);
736
- if (isCssColor(_color)) return transformedHsl;
737
- const _typecheck = true;
738
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
739
- }
740
- function viaHsb(color, transformer) {
741
- const _color = color;
742
- const hsb = toHsb(_color);
743
- const transformedHsb = transformer(hsb);
744
- if (isHsb(_color)) return transformedHsb;
745
- if (isRgb(_color)) return toRgb(transformedHsb);
746
- if (isHsl(_color)) return toHsl(transformedHsb);
747
- if (isCmyk(_color)) return toCmyk(transformedHsb);
748
- if (isXyz(_color)) return toXyz(transformedHsb);
749
- if (isLab(_color)) return toLab(transformedHsb);
750
- if (isLch(_color)) return toLch(transformedHsb);
751
- if (isHex(_color)) return toHex(transformedHsb);
752
- if (isCssColor(_color)) return transformedHsb;
753
- const _typecheck = true;
754
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
755
- }
756
- function viaCmyk(color, transformer) {
757
- const _color = color;
758
- const cmyk = toCmyk(_color);
759
- const transformedCmyk = transformer(cmyk);
760
- if (isHsb(_color)) return transformedCmyk;
761
- if (isRgb(_color)) return toRgb(transformedCmyk);
762
- if (isHsl(_color)) return toHsl(transformedCmyk);
763
- if (isCmyk(_color)) return toCmyk(transformedCmyk);
764
- if (isXyz(_color)) return toXyz(transformedCmyk);
765
- if (isLab(_color)) return toLab(transformedCmyk);
766
- if (isLch(_color)) return toLch(transformedCmyk);
767
- if (isHex(_color)) return toHex(transformedCmyk);
768
- if (isCssColor(_color)) return transformedCmyk;
769
- const _typecheck = true;
770
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
771
- }
772
- function viaXyz(color, transformer) {
773
- const _color = color;
774
- const xyz = toXyz(_color);
775
- const transformedXyz = transformer(xyz);
776
- if (isHsb(_color)) return transformedXyz;
777
- if (isRgb(_color)) return toRgb(transformedXyz);
778
- if (isHsl(_color)) return toHsl(transformedXyz);
779
- if (isCmyk(_color)) return toCmyk(transformedXyz);
780
- if (isXyz(_color)) return toXyz(transformedXyz);
781
- if (isLab(_color)) return toLab(transformedXyz);
782
- if (isLch(_color)) return toLch(transformedXyz);
783
- if (isHex(_color)) return toHex(transformedXyz);
784
- if (isCssColor(_color)) return transformedXyz;
785
- const _typecheck = true;
786
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
787
- }
788
- function viaLab(color, transformer) {
789
- const _color = color;
790
- const lab = toLab(_color);
791
- const transformedLab = transformer(lab);
792
- if (isHsb(_color)) return transformedLab;
793
- if (isRgb(_color)) return toRgb(transformedLab);
794
- if (isHsl(_color)) return toHsl(transformedLab);
795
- if (isCmyk(_color)) return toCmyk(transformedLab);
796
- if (isXyz(_color)) return toXyz(transformedLab);
797
- if (isLab(_color)) return toLab(transformedLab);
798
- if (isLch(_color)) return toLch(transformedLab);
799
- if (isHex(_color)) return toHex(transformedLab);
800
- if (isCssColor(_color)) return transformedLab;
801
- const _typecheck = true;
802
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
803
- }
804
- function viaLch(color, transformer) {
805
- const _color = color;
806
- const lch = toLch(_color);
807
- const transformedLch = transformer(lch);
808
- if (isHsb(_color)) return transformedLch;
809
- if (isRgb(_color)) return toRgb(transformedLch);
810
- if (isHsl(_color)) return toHsl(transformedLch);
811
- if (isCmyk(_color)) return toCmyk(transformedLch);
812
- if (isXyz(_color)) return toXyz(transformedLch);
813
- if (isLab(_color)) return toLab(transformedLch);
814
- if (isLch(_color)) return toLch(transformedLch);
815
- if (isHex(_color)) return toHex(transformedLch);
816
- if (isCssColor(_color)) return transformedLch;
817
- const _typecheck = true;
818
- throw new Error(`Invalid color input: ${unknownToString(_color)}`);
819
- }
820
- function linearizeToSRgb(rgb) {
821
- const cleanRgb = tidy(rgb);
822
- const linearChannel = (v) => {
823
- const n = v / 255;
824
- if (n <= 0.04045) return n / 12.92;
825
- else return Math.pow((n + 0.055) / 1.055, 2.4);
826
- };
827
- return {
828
- linearR: linearChannel(cleanRgb.r),
829
- linearG: linearChannel(cleanRgb.g),
830
- linearB: linearChannel(cleanRgb.b),
831
- a: cleanRgb.a
832
- };
833
- }
834
- function delinearizeToRgb(srgb) {
835
- const gammaChannel = (v) => {
836
- if (v <= 31308e-7) return v * 12.92;
837
- else return 1.055 * Math.pow(v, 1 / 2.4) - 0.055;
838
- };
839
- return tidy({
840
- r: gammaChannel(srgb.linearR) * 255,
841
- g: gammaChannel(srgb.linearG) * 255,
842
- b: gammaChannel(srgb.linearB) * 255,
843
- a: srgb.a
844
- });
845
- }
846
- export {
847
- delinearizeToRgb,
848
- linearizeToSRgb,
849
- toCmyk,
850
- toCss,
851
- toHex,
852
- toHsb,
853
- toHsl,
854
- toLab,
855
- toLch,
856
- toRgb,
857
- toXyz,
858
- viaCmyk,
859
- viaHsb,
860
- viaHsl,
861
- viaLab,
862
- viaLch,
863
- viaRgb,
864
- viaXyz
865
- };
389
+ const { l, c, h, a = 1 } = lch;
390
+ const hRad = (h * Math.PI) / 180;
391
+ const A = c * Math.cos(hRad);
392
+ const B = c * Math.sin(hRad);
393
+ return { l, a: A, b: B, al: a };
394
+ }
395
+ /* * * * * * * * * * * * * * * * * *
396
+ * Converters
397
+ * * * * * * * * * * * * * * * * * */
398
+ /**
399
+ * Converts any supported color format to RGBA.
400
+ *
401
+ * @param {Color} color - The color to convert.
402
+ * @returns {Rgba} The color in RGBA format.
403
+ * @throws {Error} If the color format is invalid or unsupported.
404
+ */
405
+ export function toRgb(color) {
406
+ if (isRgb(color))
407
+ return color;
408
+ if (isHsl(color))
409
+ return _hsl2rgb(color);
410
+ if (isHsb(color))
411
+ return _hsb2rgb(color);
412
+ if (isCmyk(color))
413
+ return _cmyk2rgb(color);
414
+ if (isCssColor(color))
415
+ return _css2rgb(color);
416
+ if (isHex(color))
417
+ return _hex2rgb(color);
418
+ if (isXyz(color))
419
+ return _xyz2rgb(color);
420
+ if (isLab(color))
421
+ return _xyz2rgb(_lab2xyz(color));
422
+ if (isLch(color))
423
+ return _xyz2rgb(_lab2xyz(_lch2lab(color)));
424
+ throw new Error(`Invalid color input: ${unknownToString(color)}`);
425
+ }
426
+ /**
427
+ * Converts any supported color format to CIE XYZ.
428
+ *
429
+ * @param {Color} color - The color to convert.
430
+ * @returns {Xyza} The color in CIE XYZ format.
431
+ * @throws {Error} If the color format is invalid or unsupported.
432
+ */
433
+ export function toXyz(color) {
434
+ if (isXyz(color))
435
+ return color;
436
+ if (isLab(color))
437
+ return _lab2xyz(color);
438
+ if (isLch(color))
439
+ return _lab2xyz(_lch2lab(color));
440
+ if (isRgb(color))
441
+ return _rgb2xyz(color);
442
+ if (isHsl(color))
443
+ return _rgb2xyz(_hsl2rgb(color));
444
+ if (isHsb(color))
445
+ return _rgb2xyz(_hsb2rgb(color));
446
+ if (isCmyk(color))
447
+ return _rgb2xyz(_cmyk2rgb(color));
448
+ if (isCssColor(color))
449
+ return _rgb2xyz(_css2rgb(color));
450
+ if (isHex(color))
451
+ return _rgb2xyz(_hex2rgb(color));
452
+ throw new Error(`Invalid color input: ${unknownToString(color)}`);
453
+ }
454
+ /**
455
+ * Converts any supported color format to CIELAB.
456
+ *
457
+ * @param {Color} color - The color to convert.
458
+ * @returns {Laba} The color in CIELAB format.
459
+ * @throws {Error} If the color format is invalid or unsupported.
460
+ */
461
+ export function toLab(color) {
462
+ if (isLab(color))
463
+ return color;
464
+ if (isLch(color))
465
+ return _lch2lab(color);
466
+ const xyzColor = toXyz(color);
467
+ return _xyz2lab(xyzColor);
468
+ }
469
+ /**
470
+ * Converts any supported color format to CIELCh.
471
+ *
472
+ * @param {Color} color - The color to convert.
473
+ * @returns {Lcha} The color in CIELCh format.
474
+ * @throws {Error} If the color format is invalid or unsupported.
475
+ */
476
+ export function toLch(color) {
477
+ if (isLch(color))
478
+ return color;
479
+ const labColor = toLab(color);
480
+ return _lab2lch(labColor);
481
+ }
482
+ /**
483
+ * Converts any supported color format to HSLA.
484
+ *
485
+ * @param {Color} color - The color to convert.
486
+ * @returns {Hsla} The color in HSLA format.
487
+ * @throws {Error} If the color format is invalid or unsupported.
488
+ */
489
+ export function toHsl(color) {
490
+ if (isHsl(color))
491
+ return color;
492
+ const rgbColor = toRgb(color);
493
+ return _rgb2hsl(rgbColor);
494
+ }
495
+ /**
496
+ * Converts any supported color format to HSBA (HSB/HSV).
497
+ *
498
+ * @param {Color} color - The color to convert.
499
+ * @returns {Hsba} The color in HSBA format.
500
+ * @throws {Error} If the color format is invalid or unsupported.
501
+ */
502
+ export function toHsb(color) {
503
+ if (isHsb(color))
504
+ return color;
505
+ const rgbColor = toRgb(color);
506
+ return _rgb2hsb(rgbColor);
507
+ }
508
+ /**
509
+ * Converts any supported color format to CMYK.
510
+ *
511
+ * @param {Color} color - The color to convert.
512
+ * @returns {Cmyka} The color in CMYK format.
513
+ * @throws {Error} If the color format is invalid or unsupported.
514
+ */
515
+ export function toCmyk(color) {
516
+ if (isCmyk(color))
517
+ return color;
518
+ const rgbColor = toRgb(color);
519
+ return _rgb2cmyk(rgbColor);
520
+ }
521
+ export function toCss(color) {
522
+ if (isCssColor(color))
523
+ return color;
524
+ const rgbColor = toRgb(color);
525
+ return _rgb2css(rgbColor);
526
+ }
527
+ /**
528
+ * Converts any supported color format to hexadecimal.
529
+ *
530
+ * @param {Color} color - The color to convert.
531
+ * @returns {Hex} The color in hexadecimal format.
532
+ * @throws {Error} If the color format is invalid or unsupported.
533
+ */
534
+ export function toHex(color) {
535
+ if (isHex(color))
536
+ return color;
537
+ const rgbColor = toRgb(color);
538
+ return _rgb2hex(rgbColor);
539
+ }
540
+ /* * * * * * * * * * * * * * * * * *
541
+ * Transformers
542
+ * * * * * * * * * * * * * * * * * */
543
+ /**
544
+ * Transforms a color by converting it to RGBA, applying a transformation function,
545
+ * then converting back to the original color format.
546
+ *
547
+ * @template C - The input color type.
548
+ * @param {C} color - The color to transform.
549
+ * @param {(rgb: Rgba) => Rgba} transformer - Function that transforms the RGBA representation.
550
+ * @returns {TransformedColor<C>} The transformed color in the original format.
551
+ * @throws {Error} If the color format is invalid or unsupported.
552
+ */
553
+ export function viaRgb(color, transformer) {
554
+ const _color = color;
555
+ const rgb = toRgb(_color);
556
+ const transformedRgb = transformer(rgb);
557
+ if (isRgb(_color))
558
+ return transformedRgb;
559
+ if (isHsl(_color))
560
+ return toHsl(transformedRgb);
561
+ if (isHsb(_color))
562
+ return toHsb(transformedRgb);
563
+ if (isCmyk(_color))
564
+ return toCmyk(transformedRgb);
565
+ if (isXyz(_color))
566
+ return toXyz(transformedRgb);
567
+ if (isLab(_color))
568
+ return toLab(transformedRgb);
569
+ if (isLch(_color))
570
+ return toLch(transformedRgb);
571
+ if (isHex(_color))
572
+ return toRgb(transformedRgb);
573
+ if (isCssColor(_color))
574
+ return transformedRgb;
575
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
576
+ const _typecheck = true;
577
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
578
+ }
579
+ /**
580
+ * Transforms a color by converting it to HSLA, applying a transformation function,
581
+ * then converting back to the original color format.
582
+ *
583
+ * @template C - The input color type.
584
+ * @param {C} color - The color to transform.
585
+ * @param {(hsl: Hsla) => Hsla} transformer - Function that transforms the HSLA representation.
586
+ * @returns {TransformedColor<C>} The transformed color in the original format.
587
+ * @throws {Error} If the color format is invalid or unsupported.
588
+ */
589
+ export function viaHsl(color, transformer) {
590
+ const _color = color;
591
+ const hsl = toHsl(_color);
592
+ const transformedHsl = transformer(hsl);
593
+ if (isHsl(_color))
594
+ return transformedHsl;
595
+ if (isRgb(_color))
596
+ return toRgb(transformedHsl);
597
+ if (isHsb(_color))
598
+ return toHsb(transformedHsl);
599
+ if (isCmyk(_color))
600
+ return toCmyk(transformedHsl);
601
+ if (isXyz(_color))
602
+ return toXyz(transformedHsl);
603
+ if (isLab(_color))
604
+ return toLab(transformedHsl);
605
+ if (isLch(_color))
606
+ return toLch(transformedHsl);
607
+ if (isHex(_color))
608
+ return toHex(transformedHsl);
609
+ if (isCssColor(_color))
610
+ return transformedHsl;
611
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
612
+ const _typecheck = true;
613
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
614
+ }
615
+ /**
616
+ * Transforms a color by converting it to HSBA, applying a transformation function,
617
+ * then converting back to the original color format.
618
+ *
619
+ * @template C - The input color type.
620
+ * @param {C} color - The color to transform.
621
+ * @param {(hsb: Hsba) => Hsba} transformer - Function that transforms the HSBA representation.
622
+ * @returns {TransformedColor<C>} The transformed color in the original format.
623
+ * @throws {Error} If the color format is invalid or unsupported.
624
+ */
625
+ export function viaHsb(color, transformer) {
626
+ const _color = color;
627
+ const hsb = toHsb(_color);
628
+ const transformedHsb = transformer(hsb);
629
+ if (isHsb(_color))
630
+ return transformedHsb;
631
+ if (isRgb(_color))
632
+ return toRgb(transformedHsb);
633
+ if (isHsl(_color))
634
+ return toHsl(transformedHsb);
635
+ if (isCmyk(_color))
636
+ return toCmyk(transformedHsb);
637
+ if (isXyz(_color))
638
+ return toXyz(transformedHsb);
639
+ if (isLab(_color))
640
+ return toLab(transformedHsb);
641
+ if (isLch(_color))
642
+ return toLch(transformedHsb);
643
+ if (isHex(_color))
644
+ return toHex(transformedHsb);
645
+ if (isCssColor(_color))
646
+ return transformedHsb;
647
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
648
+ const _typecheck = true;
649
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
650
+ }
651
+ /**
652
+ * Transforms a color by converting it to CMYK, applying a transformation function,
653
+ * then converting back to the original color format.
654
+ *
655
+ * @template C - The input color type.
656
+ * @param {C} color - The color to transform.
657
+ * @param {(cmyk: Cmyka) => Cmyka} transformer - Function that transforms the CMYK representation.
658
+ * @returns {TransformedColor<C>} The transformed color in the original format.
659
+ * @throws {Error} If the color format is invalid or unsupported.
660
+ */
661
+ export function viaCmyk(color, transformer) {
662
+ const _color = color;
663
+ const cmyk = toCmyk(_color);
664
+ const transformedCmyk = transformer(cmyk);
665
+ if (isHsb(_color))
666
+ return transformedCmyk;
667
+ if (isRgb(_color))
668
+ return toRgb(transformedCmyk);
669
+ if (isHsl(_color))
670
+ return toHsl(transformedCmyk);
671
+ if (isCmyk(_color))
672
+ return toCmyk(transformedCmyk);
673
+ if (isXyz(_color))
674
+ return toXyz(transformedCmyk);
675
+ if (isLab(_color))
676
+ return toLab(transformedCmyk);
677
+ if (isLch(_color))
678
+ return toLch(transformedCmyk);
679
+ if (isHex(_color))
680
+ return toHex(transformedCmyk);
681
+ if (isCssColor(_color))
682
+ return transformedCmyk;
683
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
684
+ const _typecheck = true;
685
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
686
+ }
687
+ /**
688
+ * Transforms a color by converting it to CIE XYZ, applying a transformation function,
689
+ * then converting back to the original color format.
690
+ *
691
+ * @template C - The input color type.
692
+ * @param {C} color - The color to transform.
693
+ * @param {(xyz: Xyza) => Xyza} transformer - Function that transforms the XYZ representation.
694
+ * @returns {TransformedColor<C>} The transformed color in the original format.
695
+ * @throws {Error} If the color format is invalid or unsupported.
696
+ */
697
+ export function viaXyz(color, transformer) {
698
+ const _color = color;
699
+ const xyz = toXyz(_color);
700
+ const transformedXyz = transformer(xyz);
701
+ if (isHsb(_color))
702
+ return transformedXyz;
703
+ if (isRgb(_color))
704
+ return toRgb(transformedXyz);
705
+ if (isHsl(_color))
706
+ return toHsl(transformedXyz);
707
+ if (isCmyk(_color))
708
+ return toCmyk(transformedXyz);
709
+ if (isXyz(_color))
710
+ return toXyz(transformedXyz);
711
+ if (isLab(_color))
712
+ return toLab(transformedXyz);
713
+ if (isLch(_color))
714
+ return toLch(transformedXyz);
715
+ if (isHex(_color))
716
+ return toHex(transformedXyz);
717
+ if (isCssColor(_color))
718
+ return transformedXyz;
719
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
720
+ const _typecheck = true;
721
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
722
+ }
723
+ /**
724
+ * Transforms a color by converting it to CIELAB, applying a transformation function,
725
+ * then converting back to the original color format.
726
+ *
727
+ * @template C - The input color type.
728
+ * @param {C} color - The color to transform.
729
+ * @param {(lab: Laba) => Laba} transformer - Function that transforms the CIELAB representation.
730
+ * @returns {TransformedColor<C>} The transformed color in the original format.
731
+ * @throws {Error} If the color format is invalid or unsupported.
732
+ */
733
+ export function viaLab(color, transformer) {
734
+ const _color = color;
735
+ const lab = toLab(_color);
736
+ const transformedLab = transformer(lab);
737
+ if (isHsb(_color))
738
+ return transformedLab;
739
+ if (isRgb(_color))
740
+ return toRgb(transformedLab);
741
+ if (isHsl(_color))
742
+ return toHsl(transformedLab);
743
+ if (isCmyk(_color))
744
+ return toCmyk(transformedLab);
745
+ if (isXyz(_color))
746
+ return toXyz(transformedLab);
747
+ if (isLab(_color))
748
+ return toLab(transformedLab);
749
+ if (isLch(_color))
750
+ return toLch(transformedLab);
751
+ if (isHex(_color))
752
+ return toHex(transformedLab);
753
+ if (isCssColor(_color))
754
+ return transformedLab;
755
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
756
+ const _typecheck = true;
757
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
758
+ }
759
+ /**
760
+ * Transforms a color by converting it to CIELCh, applying a transformation function,
761
+ * then converting back to the original color format.
762
+ *
763
+ * @template C - The input color type.
764
+ * @param {C} color - The color to transform.
765
+ * @param {(lch: Lcha) => Lcha} transformer - Function that transforms the CIELCh representation.
766
+ * @returns {TransformedColor<C>} The transformed color in the original format.
767
+ * @throws {Error} If the color format is invalid or unsupported.
768
+ */
769
+ export function viaLch(color, transformer) {
770
+ const _color = color;
771
+ const lch = toLch(_color);
772
+ const transformedLch = transformer(lch);
773
+ if (isHsb(_color))
774
+ return transformedLch;
775
+ if (isRgb(_color))
776
+ return toRgb(transformedLch);
777
+ if (isHsl(_color))
778
+ return toHsl(transformedLch);
779
+ if (isCmyk(_color))
780
+ return toCmyk(transformedLch);
781
+ if (isXyz(_color))
782
+ return toXyz(transformedLch);
783
+ if (isLab(_color))
784
+ return toLab(transformedLch);
785
+ if (isLch(_color))
786
+ return toLch(transformedLch);
787
+ if (isHex(_color))
788
+ return toHex(transformedLch);
789
+ if (isCssColor(_color))
790
+ return transformedLch;
791
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
792
+ const _typecheck = true;
793
+ throw new Error(`Invalid color input: ${unknownToString(_color)}`);
794
+ }
795
+ /* * * * * * * * * * * * * * * * * *
796
+ * sRGB linearization / delinearization
797
+ * * * * * * * * * * * * * * * * * */
798
+ /**
799
+ * Converts an RGBA color to linear sRGB color space by applying inverse gamma correction.
800
+ *
801
+ * @param {Rgba} rgb - The RGBA color to linearize.
802
+ * @returns {Srgba} The linearized color in sRGB color space.
803
+ */
804
+ export function linearizeToSRgb(rgb) {
805
+ const cleanRgb = tidy(rgb);
806
+ const linearChannel = (v) => {
807
+ const n = v / 255;
808
+ if (n <= 0.04045)
809
+ return n / 12.92;
810
+ else
811
+ return Math.pow((n + 0.055) / 1.055, 2.4);
812
+ };
813
+ return {
814
+ linearR: linearChannel(cleanRgb.r),
815
+ linearG: linearChannel(cleanRgb.g),
816
+ linearB: linearChannel(cleanRgb.b),
817
+ a: cleanRgb.a
818
+ };
819
+ }
820
+ /**
821
+ * Converts a linear sRGB color to RGBA by applying gamma correction.
822
+ *
823
+ * @param {Srgba} srgb - The linear sRGB color to delinearize.
824
+ * @returns {Rgba} The delinearized color in RGBA format.
825
+ */
826
+ export function delinearizeToRgb(srgb) {
827
+ const gammaChannel = (v) => {
828
+ if (v <= 0.0031308)
829
+ return v * 12.92;
830
+ else
831
+ return 1.055 * Math.pow(v, 1 / 2.4) - 0.055;
832
+ };
833
+ return tidy({
834
+ r: gammaChannel(srgb.linearR) * 255,
835
+ g: gammaChannel(srgb.linearG) * 255,
836
+ b: gammaChannel(srgb.linearB) * 255,
837
+ a: srgb.a
838
+ });
839
+ }