@design-edito/tools 0.4.5 → 0.4.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/TODO.md +269 -0
- package/agnostic/arrays/dedupe/index.js +9 -7
- package/agnostic/arrays/dedupe/index.test.js +24 -0
- package/agnostic/arrays/find-duplicates/index.js +34 -22
- package/agnostic/arrays/find-duplicates/index.test.js +31 -0
- package/agnostic/arrays/index.d.ts +2 -2
- package/agnostic/arrays/index.js +2 -2
- package/agnostic/arrays/is-array-of/index.js +28 -26
- package/agnostic/arrays/is-array-of/index.test.js +56 -0
- package/agnostic/arrays/make/index.js +11 -6
- package/agnostic/arrays/make/index.test.js +10 -0
- package/agnostic/arrays/random-pick/index.js +38 -22
- package/agnostic/arrays/random-pick/index.test.js +23 -0
- package/agnostic/arrays/shuffle/index.js +15 -11
- package/agnostic/arrays/shuffle/index.test.js +14 -0
- package/agnostic/booleans/is-falsy/index.js +24 -15
- package/agnostic/booleans/is-falsy/index.test.js +26 -0
- package/agnostic/colors/channels/index.js +139 -936
- package/agnostic/colors/channels/index.test.js +64 -0
- package/agnostic/colors/contrast/index.js +24 -643
- package/agnostic/colors/contrast/index.test.js +21 -0
- package/agnostic/colors/convert/index.js +811 -837
- package/agnostic/colors/convert/index.test.js +98 -0
- package/agnostic/colors/cssColorsMap.js +153 -0
- package/agnostic/colors/distance/index.js +66 -538
- package/agnostic/colors/distance/index.test.js +21 -0
- package/agnostic/colors/grayscale/index.js +95 -872
- package/agnostic/colors/grayscale/index.test.js +34 -0
- package/agnostic/colors/index.d.ts +2 -2
- package/agnostic/colors/index.js +2 -2
- package/agnostic/colors/invert/index.js +34 -719
- package/agnostic/colors/invert/index.test.js +31 -0
- package/agnostic/colors/lerp/index.js +75 -804
- package/agnostic/colors/lerp/index.test.js +55 -0
- package/agnostic/colors/luminance/index.js +17 -625
- package/agnostic/colors/luminance/index.test.js +30 -0
- package/agnostic/colors/palette/index.js +83 -917
- package/agnostic/colors/palette/index.test.js +35 -0
- package/agnostic/colors/rotate/index.js +35 -835
- package/agnostic/colors/rotate/index.test.js +45 -0
- package/agnostic/colors/tidy/index.js +79 -530
- package/agnostic/colors/tidy/index.test.js +45 -0
- package/agnostic/colors/typechecks/index.js +188 -250
- package/agnostic/colors/typechecks/index.test.js +113 -0
- package/agnostic/colors/types.js +1 -0
- package/agnostic/css/bem/index.js +134 -171
- package/agnostic/css/clss/index.js +64 -29
- package/agnostic/css/clss/index.test.js +60 -0
- package/agnostic/css/generate-nice-color/index.js +26 -71
- package/agnostic/css/generate-nice-color/index.test.js +8 -0
- package/agnostic/css/index.d.ts +2 -2
- package/agnostic/css/index.js +2 -2
- package/agnostic/css/is-valid-css-class-name/index.js +14 -8
- package/agnostic/css/is-valid-css-class-name/index.test.js +36 -0
- package/agnostic/css/scale/index.js +37 -50
- package/agnostic/css/scale/index.test.js +71 -0
- package/agnostic/css/styles-set/index.js +151 -178
- package/agnostic/errors/index.d.ts +1 -1
- package/agnostic/errors/index.js +1 -1
- package/agnostic/errors/register/index.js +45 -49
- package/agnostic/errors/unknown-to-string/index.js +17 -10
- package/agnostic/errors/unknown-to-string/index.test.js +35 -0
- package/agnostic/html/get-node-ancestors/index.js +29 -29
- package/agnostic/html/get-node-ancestors/index.test.js +58 -0
- package/agnostic/html/get-position-inside-parent/index.js +13 -8
- package/agnostic/html/get-position-inside-parent/index.test.js +56 -0
- package/agnostic/html/hyper-json/cast/index.js +128 -2931
- package/agnostic/html/hyper-json/index.js +23 -2954
- package/agnostic/html/hyper-json/method/index.js +10 -14
- package/agnostic/html/hyper-json/serialize/index.js +88 -222
- package/agnostic/html/hyper-json/smart-tags/coalesced/add/index.js +14 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/addclass/index.js +27 -2937
- package/agnostic/html/hyper-json/smart-tags/coalesced/and/index.js +13 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/append/index.js +34 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/at/index.js +42 -2935
- package/agnostic/html/hyper-json/smart-tags/coalesced/call/index.js +47 -2937
- package/agnostic/html/hyper-json/smart-tags/coalesced/clone/index.js +10 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/deleteproperties/index.js +45 -2936
- package/agnostic/html/hyper-json/smart-tags/coalesced/equals/index.js +22 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/getattribute/index.js +26 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/getproperties/index.js +19 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/getproperty/index.js +67 -2935
- package/agnostic/html/hyper-json/smart-tags/coalesced/hjparse/index.js +21 -2937
- package/agnostic/html/hyper-json/smart-tags/coalesced/hjstringify/index.js +89 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/if/index.js +20 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts +18 -18
- package/agnostic/html/hyper-json/smart-tags/coalesced/index.js +18 -18
- package/agnostic/html/hyper-json/smart-tags/coalesced/initialize/index.js +37 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/join/index.js +16 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/length/index.js +21 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/map/index.js +31 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/negate/index.js +10 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/notrailing/index.js +33 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/or/index.js +13 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/pickrandom/index.js +17 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/populate/index.js +59 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/print/index.js +23 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/push/index.js +10 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/pusheach/index.js +26 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/recordtoarray/index.js +10 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/removeattribute/index.js +53 -2935
- package/agnostic/html/hyper-json/smart-tags/coalesced/removeclass/index.js +27 -2937
- package/agnostic/html/hyper-json/smart-tags/coalesced/renameproperty/index.js +31 -2937
- package/agnostic/html/hyper-json/smart-tags/coalesced/replace/index.js +55 -2940
- package/agnostic/html/hyper-json/smart-tags/coalesced/select/index.js +29 -2935
- package/agnostic/html/hyper-json/smart-tags/coalesced/set/index.js +29 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/setattribute/index.js +53 -2935
- package/agnostic/html/hyper-json/smart-tags/coalesced/setproperty/index.js +232 -2936
- package/agnostic/html/hyper-json/smart-tags/coalesced/sorton/index.js +89 -2936
- package/agnostic/html/hyper-json/smart-tags/coalesced/split/index.js +20 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/spread/index.js +23 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/toarray/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/toboolean/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/toelement/index.js +17 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/toggleclass/index.js +27 -2937
- package/agnostic/html/hyper-json/smart-tags/coalesced/tonodelist/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/tonull/index.js +10 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/tonumber/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/torecord/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/toref/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/tostring/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/totext/index.js +11 -2939
- package/agnostic/html/hyper-json/smart-tags/coalesced/transformselected/index.js +84 -2938
- package/agnostic/html/hyper-json/smart-tags/coalesced/trim/index.js +14 -2938
- package/agnostic/html/hyper-json/smart-tags/index.js +28 -181
- package/agnostic/html/hyper-json/smart-tags/isolated/any/index.js +12 -195
- package/agnostic/html/hyper-json/smart-tags/isolated/array/index.js +12 -195
- package/agnostic/html/hyper-json/smart-tags/isolated/boolean/index.js +12 -2939
- package/agnostic/html/hyper-json/smart-tags/isolated/element/index.js +24 -2938
- package/agnostic/html/hyper-json/smart-tags/isolated/get/index.js +18 -2938
- package/agnostic/html/hyper-json/smart-tags/isolated/guess/index.js +56 -2937
- package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts +1 -1
- package/agnostic/html/hyper-json/smart-tags/isolated/index.js +1 -1
- package/agnostic/html/hyper-json/smart-tags/isolated/nodelist/index.js +18 -2938
- package/agnostic/html/hyper-json/smart-tags/isolated/null/index.js +9 -193
- package/agnostic/html/hyper-json/smart-tags/isolated/number/index.js +16 -2938
- package/agnostic/html/hyper-json/smart-tags/isolated/record/index.js +12 -2938
- package/agnostic/html/hyper-json/smart-tags/isolated/ref/index.js +40 -2935
- package/agnostic/html/hyper-json/smart-tags/isolated/string/index.js +16 -2938
- package/agnostic/html/hyper-json/smart-tags/isolated/text/index.js +18 -2938
- package/agnostic/html/hyper-json/transformer/index.js +112 -148
- package/agnostic/html/hyper-json/tree/index.js +411 -2928
- package/agnostic/html/hyper-json/types/index.js +27 -18
- package/agnostic/html/hyper-json/utils/index.js +497 -2921
- package/agnostic/html/index.d.ts +2 -2
- package/agnostic/html/index.js +2 -2
- package/agnostic/html/insert-node/index.js +27 -16
- package/agnostic/html/insert-node/index.test.js +73 -0
- package/agnostic/html/placeholders/index.js +26 -29
- package/agnostic/html/replace-in-element/index.js +31 -48
- package/agnostic/html/replace-in-element/index.test.js +80 -0
- package/agnostic/html/selector-to-element/index.js +53 -39
- package/agnostic/html/selector-to-element/index.test.js +69 -0
- package/agnostic/html/string-to-nodes/index.js +24 -25
- package/agnostic/html/string-to-nodes/index.test.js +54 -0
- package/agnostic/index.d.ts +6 -6
- package/agnostic/index.js +6 -6
- package/agnostic/misc/assert/index.js +60 -66
- package/agnostic/misc/cast/index.js +123 -57
- package/agnostic/misc/cast/index.test.js +134 -0
- package/agnostic/misc/connection/index.js +55 -36
- package/agnostic/misc/connection/index.test.js +143 -0
- package/agnostic/misc/crawler/index.js +68 -46
- package/agnostic/misc/crawler/index.test.js +56 -0
- package/agnostic/misc/crossenv/detect-runtime/index.js +41 -13
- package/agnostic/misc/crossenv/detect-runtime/index.test.js +24 -0
- package/agnostic/misc/crossenv/types.js +21 -14
- package/agnostic/misc/crossenv/window/index.js +45 -24
- package/agnostic/misc/crossenv/window/index.test.js +24 -0
- package/agnostic/misc/data-size/index.js +182 -294
- package/agnostic/misc/data-size/index.test.js +100 -0
- package/agnostic/misc/data-size/types.js +1 -0
- package/agnostic/misc/index.d.ts +5 -5
- package/agnostic/misc/index.js +5 -5
- package/agnostic/misc/is-constructor-function/index.js +12 -6
- package/agnostic/misc/is-constructor-function/index.test.js +36 -0
- package/agnostic/misc/is-nullish/index.js +24 -11
- package/agnostic/misc/is-nullish/index.test.js +44 -0
- package/agnostic/misc/logs/logger/index.js +115 -140
- package/agnostic/misc/logs/make-text-block/index.js +13 -13
- package/agnostic/misc/logs/styles/index.js +29 -48
- package/agnostic/misc/lorem-ipsum/index.js +51 -201
- package/agnostic/misc/lorem-ipsum/index.test.js +49 -0
- package/agnostic/misc/normalize-extension/index.js +99 -88
- package/agnostic/misc/normalize-extension/index.test.js +40 -0
- package/agnostic/misc/outcome/index.js +20 -14
- package/agnostic/misc/outcome/index.test.js +40 -0
- package/agnostic/numbers/absolute-modulo/index.js +9 -6
- package/agnostic/numbers/absolute-modulo/index.test.js +23 -0
- package/agnostic/numbers/approximate-rational/index.js +86 -69
- package/agnostic/numbers/approximate-rational/index.test.js +90 -0
- package/agnostic/numbers/clamp/index.js +12 -8
- package/agnostic/numbers/clamp/index.test.js +24 -0
- package/agnostic/numbers/geometric-progressions/index.js +25 -16
- package/agnostic/numbers/geometric-progressions/index.test.js +45 -0
- package/agnostic/numbers/index.d.ts +2 -2
- package/agnostic/numbers/index.js +2 -2
- package/agnostic/numbers/interpolate/index.js +25 -10
- package/agnostic/numbers/interpolate/index.test.js +40 -0
- package/agnostic/numbers/round/index.js +30 -15
- package/agnostic/numbers/round/index.test.js +56 -0
- package/agnostic/objects/deep-get-property/index.js +30 -27
- package/agnostic/objects/deep-get-property/index.test.js +59 -0
- package/agnostic/objects/enums/is-in-enum/index.js +17 -11
- package/agnostic/objects/enums/is-in-enum/index.test.js +100 -0
- package/agnostic/objects/flatten-getters/index.js +15 -14
- package/agnostic/objects/flatten-getters/index.test.js +78 -0
- package/agnostic/objects/index.d.ts +2 -2
- package/agnostic/objects/index.js +2 -2
- package/agnostic/objects/is-object/index.js +16 -9
- package/agnostic/objects/is-object/index.test.js +60 -0
- package/agnostic/objects/is-record/index.js +12 -7
- package/agnostic/objects/is-record/index.test.js +48 -0
- package/agnostic/objects/record-format/index.js +18 -12
- package/agnostic/objects/record-format/index.test.js +92 -0
- package/agnostic/objects/record-map/index.js +16 -11
- package/agnostic/objects/record-map/index.test.js +56 -0
- package/agnostic/objects/sort-keys/index.js +15 -11
- package/agnostic/objects/sort-keys/index.test.js +37 -0
- package/agnostic/objects/validation/index.js +21 -8
- package/agnostic/objects/validation/index.test.js +72 -0
- package/agnostic/optim/index.d.ts +1 -1
- package/agnostic/optim/index.js +1 -1
- package/agnostic/optim/memoize/index.js +24 -16
- package/agnostic/optim/memoize/index.test.js +30 -0
- package/agnostic/optim/throttle-debounce/index.js +120 -102
- package/agnostic/optim/throttle-debounce/index.test.js +44 -0
- package/agnostic/optim/throttle-debounce/types.js +1 -0
- package/agnostic/random/hex-char/index.js +8 -10
- package/agnostic/random/hex-char/index.test.js +20 -0
- package/agnostic/random/index.d.ts +1 -1
- package/agnostic/random/index.js +1 -1
- package/agnostic/random/random/index.js +17 -14
- package/agnostic/random/random/index.test.js +73 -0
- package/agnostic/random/uuid/index.js +28 -20
- package/agnostic/random/uuid/index.test.js +45 -0
- package/agnostic/regexps/index.js +126 -84
- package/agnostic/regexps/index.test.js +108 -0
- package/agnostic/sanitization/file-name/index.js +24 -8
- package/agnostic/sanitization/file-name/index.test.js +23 -0
- package/agnostic/sanitization/html/index.js +172 -122
- package/agnostic/sanitization/path/index.js +23 -15
- package/agnostic/sanitization/path/index.test.js +18 -0
- package/agnostic/sanitization/types.js +1 -0
- package/agnostic/sanitization/user-input/index.js +36 -24
- package/agnostic/sanitization/user-input/index.test.js +31 -0
- package/agnostic/strings/char-codes/index.js +123 -55
- package/agnostic/strings/matches/index.js +35 -16
- package/agnostic/strings/normalize-indent/index.js +34 -16
- package/agnostic/strings/parse-table/index.js +153 -86
- package/agnostic/strings/replace-all/index.js +36 -15
- package/agnostic/strings/to-alphanum/index.js +23 -8
- package/agnostic/strings/trim/index.js +22 -9
- package/agnostic/time/dates/format-date/index.js +140 -72
- package/agnostic/time/duration/index.js +106 -140
- package/agnostic/time/timeout/index.js +24 -16
- package/agnostic/time/transitions/index.js +200 -158
- package/agnostic/time/wait/index.js +10 -8
- package/agnostic/typescript/types.js +1 -0
- package/components/BeforeAfter/index.controlled.js +95 -0
- package/components/BeforeAfter/index.js +54 -189
- package/components/BeforeAfter/utils.js +9 -0
- package/components/Disclaimer/index.js +50 -110
- package/components/Drawer/index.js +81 -196
- package/components/EventListener/index.js +29 -80
- package/components/Gallery/index.js +146 -221
- package/components/Gallery/utils.js +12 -0
- package/components/Image/index.js +66 -293
- package/components/IntersectionObserver/index.js +62 -110
- package/components/Overlayer/index.js +59 -103
- package/components/Paginator/index.js +124 -155
- package/components/ResizeObserver/index.js +66 -119
- package/components/ResizeObserver/style.module.css +0 -0
- package/components/Scrllgngn/index.js +171 -468
- package/components/ScrollListener/index.js +97 -276
- package/components/ScrollListener/utils.js +51 -0
- package/components/Sequencer/index.controlled.js +67 -0
- package/components/Sequencer/index.js +105 -262
- package/components/ShadowRoot/index.js +42 -96
- package/components/Subtitles/index.js +107 -244
- package/components/Subtitles/types.js +1 -0
- package/components/Subtitles/utils.js +102 -0
- package/components/Theatre/index.js +88 -136
- package/components/UIModule/index.js +156 -199
- package/components/Video/index.js +292 -857
- package/components/Video/utils.js +137 -0
- package/components/_WIP_AudioQuote/index.js +1 -0
- package/components/_WIP_Icon/index.js +1 -0
- package/components/index.d.ts +5 -5
- package/components/index.js +5 -5
- package/components/public-classnames.js +18 -0
- package/components/utils/index.js +11 -11
- package/components/utils/types.js +1 -0
- package/index.d.ts +1 -1
- package/index.js +1 -1
- package/node/@aws-s3/index.test.js +6 -0
- package/node/@aws-s3/storage/directory/copy-dir/index.js +66 -72
- package/node/@aws-s3/storage/directory/index.d.ts +2 -2
- package/node/@aws-s3/storage/directory/index.js +2 -2
- package/node/@aws-s3/storage/directory/list/index.js +32 -42
- package/node/@aws-s3/storage/directory/move-dir/index.js +68 -86
- package/node/@aws-s3/storage/directory/remove-dir/index.js +56 -67
- package/node/@aws-s3/storage/file/copy/index.js +41 -53
- package/node/@aws-s3/storage/file/download/index.js +29 -40
- package/node/@aws-s3/storage/file/exists/index.js +35 -43
- package/node/@aws-s3/storage/file/index.d.ts +1 -1
- package/node/@aws-s3/storage/file/index.js +1 -1
- package/node/@aws-s3/storage/file/move/index.js +57 -63
- package/node/@aws-s3/storage/file/remove/index.js +35 -43
- package/node/@aws-s3/storage/file/stat/index.js +33 -47
- package/node/@aws-s3/storage/file/upload/index.js +52 -63
- package/node/@design-edito/index.js +1 -0
- package/node/@express/@multer/index.js +61 -55
- package/node/@google-cloud/storage/bucket/get-metadata/index.js +25 -29
- package/node/@google-cloud/storage/directory/copy-dir/index.js +35 -41
- package/node/@google-cloud/storage/directory/index.d.ts +1 -1
- package/node/@google-cloud/storage/directory/index.js +1 -1
- package/node/@google-cloud/storage/directory/list/index.js +28 -35
- package/node/@google-cloud/storage/directory/move-dir/index.js +43 -42
- package/node/@google-cloud/storage/directory/remove-dir/index.js +34 -38
- package/node/@google-cloud/storage/file/copy/index.js +35 -40
- package/node/@google-cloud/storage/file/download/index.js +27 -34
- package/node/@google-cloud/storage/file/exists/index.js +25 -31
- package/node/@google-cloud/storage/file/generate-signed-url/index.js +33 -35
- package/node/@google-cloud/storage/file/get-metadata/index.js +28 -31
- package/node/@google-cloud/storage/file/get-permissions/index.js +25 -31
- package/node/@google-cloud/storage/file/index.d.ts +2 -2
- package/node/@google-cloud/storage/file/index.js +2 -2
- package/node/@google-cloud/storage/file/move/index.js +38 -42
- package/node/@google-cloud/storage/file/remove/index.js +34 -35
- package/node/@google-cloud/storage/file/revoke-signed-urls/index.js +32 -95
- package/node/@google-cloud/storage/file/stat/index.js +34 -38
- package/node/@google-cloud/storage/file/update-metadata/index.js +30 -31
- package/node/@google-cloud/storage/file/upload/index.js +44 -46
- package/node/@google-cloud/storage/index.d.ts +1 -1
- package/node/@google-cloud/storage/index.js +1 -1
- package/node/cloud-storage/clients/index.js +35 -15
- package/node/cloud-storage/operations/copy-dir/index.js +30 -203
- package/node/cloud-storage/operations/copy-file/index.js +30 -152
- package/node/cloud-storage/operations/download-file/index.js +30 -103
- package/node/cloud-storage/operations/exists-file/index.js +30 -103
- package/node/cloud-storage/operations/index.d.ts +2 -2
- package/node/cloud-storage/operations/index.js +2 -2
- package/node/cloud-storage/operations/list-dir/index.js +29 -98
- package/node/cloud-storage/operations/move-dir/index.js +30 -169
- package/node/cloud-storage/operations/move-file/index.js +30 -157
- package/node/cloud-storage/operations/remove-dir/index.js +29 -159
- package/node/cloud-storage/operations/remove-file/index.js +29 -121
- package/node/cloud-storage/operations/stat-file/index.js +29 -124
- package/node/cloud-storage/operations/upload-file/index.js +30 -162
- package/node/encryption/@aes-256-gcm/buffer/index.js +31 -72
- package/node/encryption/@aes-256-gcm/uint8-array/index.js +55 -55
- package/node/encryption/key/index.js +19 -12
- package/node/files/index.d.ts +1 -1
- package/node/files/index.js +1 -1
- package/node/files/is-in-directory/index.js +11 -8
- package/node/files/read-write/index.js +11 -15
- package/node/files/subpaths/index.js +156 -121
- package/node/ftps/directory/copy-dir/index.js +55 -62
- package/node/ftps/directory/list/index.js +24 -29
- package/node/ftps/directory/move-dir/index.js +38 -38
- package/node/ftps/directory/remove-dir/index.js +39 -42
- package/node/ftps/file/copy/index.js +42 -47
- package/node/ftps/file/download/index.js +29 -34
- package/node/ftps/file/exists/index.js +38 -36
- package/node/ftps/file/index.d.ts +2 -2
- package/node/ftps/file/index.js +2 -2
- package/node/ftps/file/move/index.js +46 -44
- package/node/ftps/file/remove/index.js +36 -39
- package/node/ftps/file/stat/index.js +30 -38
- package/node/ftps/file/upload/index.js +40 -44
- package/node/images/create/index.js +10 -562
- package/node/images/format/index.js +264 -815
- package/node/images/metadata/index.js +10 -571
- package/node/images/transform/index.js +169 -1022
- package/node/images/transform/operations/blur/index.js +11 -24
- package/node/images/transform/operations/brighten/index.js +11 -24
- package/node/images/transform/operations/extend/index.js +25 -589
- package/node/images/transform/operations/extract/index.js +15 -28
- package/node/images/transform/operations/flatten/index.js +20 -584
- package/node/images/transform/operations/flip/index.js +2 -6
- package/node/images/transform/operations/flop/index.js +2 -6
- package/node/images/transform/operations/hue/index.js +13 -26
- package/node/images/transform/operations/index.d.ts +5 -5
- package/node/images/transform/operations/index.js +5 -5
- package/node/images/transform/operations/level/index.js +14 -30
- package/node/images/transform/operations/lighten/index.js +13 -26
- package/node/images/transform/operations/normalize/index.js +14 -27
- package/node/images/transform/operations/overlay/index.js +89 -673
- package/node/images/transform/operations/resize/index.js +46 -610
- package/node/images/transform/operations/rotate/index.js +20 -584
- package/node/images/transform/operations/saturate/index.js +14 -27
- package/node/images/types.js +34 -31
- package/node/images/utils/index.js +84 -568
- package/node/index.d.ts +5 -5
- package/node/index.js +5 -5
- package/node/process/on-exit/index.js +45 -26
- package/node/process/prompt-continue/index.js +29 -14
- package/node/process/spawner/index.js +104 -134
- package/node/sftp/directory/copy-dir/index.js +52 -60
- package/node/sftp/directory/index.d.ts +1 -1
- package/node/sftp/directory/index.js +1 -1
- package/node/sftp/directory/list/index.js +22 -29
- package/node/sftp/directory/move-dir/index.js +35 -35
- package/node/sftp/directory/remove-dir/index.js +39 -42
- package/node/sftp/file/copy/index.js +37 -45
- package/node/sftp/file/download/index.js +26 -32
- package/node/sftp/file/exists/index.js +29 -29
- package/node/sftp/file/index.d.ts +1 -1
- package/node/sftp/file/index.js +1 -1
- package/node/sftp/file/move/index.js +39 -38
- package/node/sftp/file/remove/index.js +31 -34
- package/node/sftp/file/stat/index.js +26 -37
- package/node/sftp/file/upload/index.js +34 -38
- package/package.json +1 -1
|
@@ -1,865 +1,839 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
}
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
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
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
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
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
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
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
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
|
-
|
|
354
|
-
|
|
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
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
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
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
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
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
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
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
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
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
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
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
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
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
227
|
+
const { c, m, y, k, a = 1 } = cmyka;
|
|
228
|
+
// Clamp input to 0–100
|
|
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
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
246
|
+
const { r, g, b, a = 1 } = rgb;
|
|
247
|
+
// Normalize RGB to 0–1
|
|
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
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
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
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
301
|
+
const { r, g, b, a = 1 } = rgb;
|
|
302
|
+
// Normalize RGB to 0–1
|
|
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
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
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
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
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
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
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
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
}
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
}
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
}
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
}
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
}
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
if (
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
864
|
-
|
|
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
|
+
}
|