@hueycolor/core 0.0.1-beta.3

package/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 Eihab Khan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const lr=[[1,.3963377773761749,.2158037573099136],[1,-.1055613458156586,-.0638541728258133],[1,-.0894841775298119,-1.2914855480194092]],fr=[[.210454268309314,.7936177747023054,-.0040720430116193],[1.9779985324311684,-2.42859224204858,.450593709617411],[.0259040424655478,.7827717124575296,-.8086757549230774]],hr=[[.819022437996703,.3619062600528904,-.1288737815209879],[.0329836539323885,.9292868615863434,.0361446663506424],[.0481771893596242,.2642395317527308,.6335478284694309]],_r=[[1.2268798758459243,-.5578149944602171,.2813910456659647],[-.0405757452148008,1.112286803280317,-.0717110580655164],[-.0763729366746601,-.4214933324022432,1.5869240198367816]],ur=[[.4123907992659595,.35758433938387796,.1804807884018343],[.21263900587151036,.7151686787677559,.07219231536073371],[.01933081871559185,.11919477979462599,.9505321522496606]],dr=[[3.2409699419045213,-1.5373831775700935,-.4986107602930033],[-.9692436362808798,1.8759675015077206,.04155505740717561],[.05563007969699361,-.20397695888897657,1.0569715142428786]],mr=[[.4122214694707629,.5363325372617349,.051445993267502196],[.2119034958178251,.6806995506452345,.10739695353694051],[.08830245919005637,.2817188391361215,.6299787016738223]],gr=[[4.076741636075959,-3.307711539258062,.2309699031821041],[-1.2684379732850313,2.6097573492876878,-.3413193760026569],[-.004196076138675526,-.703418617935936,1.7076146940746113]],br=[[.48657094864821626,.26566769316909294,.1982172852343625],[.22897456406974884,.6917385218365062,.079286914093745],[0,.045113381858902575,1.0439443689009757]],Mr=[[2.4934969119414245,-.9313836179191236,-.40271078445071684],[-.829488969561575,1.7626640603183468,.02362468584194359],[.035845830243784335,-.07617238926804171,.9568845240076873]],xr=[[.48137985274995443,.4621183710113181,.05650177623872757],[.22883194181124475,.6532168193835676,.11795123880518778],[.08394575232299319,.22416527097756642,.6918889766994405]],pr=[[3.1277689713618737,-2.2571357625916395,.1293667912297651],[-1.091009018437798,2.413331710306923,-.3223226918691248],[-.02601080193857041,-.5080413317041669,1.5340521336427373]],wr=[[.6369580483012913,.14461690358620838,.16888097516417205],[.26270021201126703,.677998071518871,.059301716469861945],[0,.028072693049087508,1.0609850577107909]],$r=[[1.7166511879712676,-.3556707837763924,-.2533662813736598],[-.666684351832489,1.616481236634939,.01576854581391113],[.017639857445310915,-.042770613257808655,.942103121235474]],Lr=[[.6167557848654444,.3601984012264634,.023045813908092266],[.26513305939263676,.6358393720678492,.09902756853951414],[.10010262952034828,.20390652261661452,.6959908478630372]],Nr=[[2.1399067304346513,-1.246389493760618,.10648276332596689],[-.8847358357577675,2.1632309383612007,-.27849510260343363],[-.04857374640044396,-.45450314971409633,1.5030768961145404]],K=(r,t,e)=>Math.max(Math.min(r,e),t),Xr=r=>(r%360+360)%360,Fr=(r,t=b())=>{let e=r.replace(/#/,"");e.length===3?e=e[0]+e[0]+e[1]+e[1]+e[2]+e[2]:e.length>6&&(e=e.slice(0,6));const n=parseInt(e,16);return t[0]=(n>>16&255)/255,t[1]=(n>>8&255)/255,t[2]=(n&255)/255,t},Hr=r=>`#${r.map(t=>L(t).toString(16).padStart(2,"0")).join("")}`,L=r=>K(Math.round(255*r),0,255),b=()=>[0,0,0],x=b(),Er=r=>{const t=r[0],e=r[1],n=r[2];r[0]=t*t*t,r[1]=e*e*e,r[2]=n*n*n},Rr=r=>{r[0]=Math.cbrt(r[0]),r[1]=Math.cbrt(r[1]),r[2]=Math.cbrt(r[2])},R=(r,t)=>r[0]*t[0]+r[1]*t[1]+r[2]*t[2],yr=(r,t,e=b())=>($(r,lr,e),Er(e),$(e,t,e)),O=(r,t,e=b())=>($(r,t,e),Rr(e),$(e,fr,e)),$=(r,t,e=b())=>{const n=R(r,t[0]),i=R(r,t[1]),o=R(r,t[2]);return e[0]=n,e[1]=i,e[2]=o,e},v=(r,t)=>{t[0]=r[0],t[1]=r[1],t[2]=r[2]},Yr=(r,t,e=t)=>{if(!t)throw new Error("must specify an input space");let n=1;r.length>3&&(n=r[3]),v(r,x),t!==e&&g(r,t,e,x);const i=e.id;if(i=="srgb"){const o=L(x[0]),l=L(x[1]),h=L(x[2]),f=`${o}, ${l}, ${h}`;return n===1?`rgb(${f})`:`rgba(${f}, ${n})`}else{const o=n===1?"":` / ${n}`;return i=="oklab"||i=="oklch"?`${i}(${x[0]*100}% ${x[1]} ${x[2]}${o})`:`color(${i} ${x[0]} ${x[1]} ${x[2]}${o})`}},A=r=>r.length>=4&&r[3]===1?r.slice(0,3):r,y=r=>parseFloat(r)||0,P=(r,t=!1)=>t?K(y(r)/255,0,255):r.includes("%")?y(r)/100:y(r),Sr=r=>{if(typeof r!="string")throw new Error("expected a string as input");if(r=r.trim(),r.charAt(0)==="#"){const t=r.slice(0,7);let e=r.length>7?parseInt(r.slice(7,9),16):255,n=isNaN(e)?1:e/255;const i=Fr(t);return n!==1&&i.push(n),{id:"srgb",coords:i}}else{const t=/^(rgb|rgba|oklab|oklch|color)\((.+)\)$/i.exec(r);if(!t)throw new Error(`could not parse color string ${r}`);const e=t[1].toLowerCase();if(/^rgba?$/i.test(e)&&t[2].includes(",")){const n=t[2].split(",").map((i,o)=>P(i.trim(),o<3));return{id:"srgb",coords:A(n)}}else{let n,i,o=!1;if(/^color$/i.test(e)){const h=/([^\s]+)\s+([^\s]+)\s+([^\s]+)\s+([^\s/]+)(?:\s?\/\s?([^\s]+))?/.exec(t[2]);if(!h)throw new Error(`could not parse color() function ${r}`);n=h[1].toLowerCase(),i=h.slice(2,6)}else{if(/^(oklab|oklch)$/i.test(e))n=e;else if(/rgba?/i.test(e))n="srgb",o=!0;else throw new Error(`unknown color function ${e}`);const h=/([^\s]+)\s+([^\s]+)\s+([^\s/]+)(?:\s?\/\s?([^\s]+))?/.exec(t[2]);if(!h)throw new Error(`could not parse color() function ${r}`);i=h.slice(1,6)}i[3]==null&&(i=i.slice(0,3));const l=i.map((h,f)=>P(h.trim(),o&&f<3));if(l.length<3||l.length>4)throw new Error("invalid number of coordinates");return{id:n,coords:A(l)}}}},g=(r,t,e,n=b())=>{if(v(r,n),!t)throw new Error("must specify a fromSpace");if(!e)throw new Error("must specify a toSpace");if(t==e)return n;t.base&&(n=t.toBase(n,n),t=t.base);let i=t,o=e.base??e;if(t.base||o.base)throw new Error("Currently only base of depth=1 is supported");if(i!==o){let l=i.id==="xyz",h=o.id==="xyz",f=!1,s=!1;if(i.id==="oklab"){let c=o.fromLMS_M;c||(c=z.fromLMS_M,f=!0,l=!0),n=yr(n,c,n)}else if(o.id==="oklab"){let c=i.toLMS_M;c?n=O(n,c,n):(f=!0,s=!0)}else f=!0;if(f){if(!l)if(i.toXYZ)n=i.toXYZ(n,n);else if(i.toXYZ_M)n=$(n,i.toXYZ_M,n);else throw new Error(`no toXYZ or toXYZ_M on ${i.id}`);if(i.adapt&&(n=$(n,i.adapt.to,n)),o.adapt&&(n=$(n,o.adapt.from,n)),!h)if(s)n=O(n,z.toLMS_M,n);else if(o.fromXYZ)n=o.fromXYZ(n,n);else if(o.fromXYZ_M)n=$(n,o.fromXYZ_M,n);else throw new Error(`no fromXYZ or fromXYZ_M on ${o.id}`)}}if(o!==e)if(e.fromBase)n=e.fromBase(n,n);else throw new Error(`could not transform ${o.id} to ${e.id}`);return n},z={toLMS_M:hr,fromLMS_M:_r},Y=r=>{let t=r<0?-1:1,e=Math.abs(r);return e<=.04045?r/12.92:t*Math.pow((e+.055)/1.055,2.4)},S=r=>{let t=r<0?-1:1,e=Math.abs(r);return e>.0031308?t*(1.055*Math.pow(e,1/2.4)-.055):12.92*r},V=(r,t=b())=>(t[0]=S(r[0]),t[1]=S(r[1]),t[2]=S(r[2]),t),j=(r,t=b())=>(t[0]=Y(r[0]),t[1]=Y(r[1]),t[2]=Y(r[2]),t),Br={id:"srgb-linear",toXYZ_M:ur,fromXYZ_M:dr,toLMS_M:mr,fromLMS_M:gr},w={id:"srgb",base:Br,toBase:j,fromBase:V},D=(.4-0)/1e5,Cr={id:"oklab"},p={id:"oklch",base:Cr,toBase:(r,t=b())=>{const e=r[1],n=r[2];return t[0]=r[0],t[1]=e*Math.cos(n*Math.PI/180),t[2]=e*Math.sin(n*Math.PI/180),t},fromBase:(r,t=b())=>{const e=r[1],n=r[2];let i=Math.abs(e)<D&&Math.abs(n)<D,o=i?0:Xr(Math.atan2(n,e)*180/Math.PI),l=i?0:Math.sqrt(e*e+n*n);return t[0]=r[0],t[1]=l,t[2]=o,t}},Tr={id:"display-p3-linear",toXYZ_M:br,fromXYZ_M:Mr,toLMS_M:xr,fromLMS_M:pr},kr={id:"display-p3",base:Tr,toBase:j,fromBase:V},F=1.09929682680944,I=.018053968510807,B=r=>r<I*4.5?r/4.5:Math.pow((r+F-1)/F,1/.45),C=r=>r>=I?F*Math.pow(r,.45)-(F-1):4.5*r,Zr={id:"rec2020-linear",toXYZ_M:wr,fromXYZ_M:$r,toLMS_M:Lr,fromLMS_M:Nr},Gr={id:"rec2020",base:Zr,toBase:(r,t=b())=>(t[0]=B(r[0]),t[1]=B(r[1]),t[2]=B(r[2]),t),fromBase:(r,t=b())=>(t[0]=C(r[0]),t[1]=C(r[1]),t[2]=C(r[2]),t)},T=Symbol("huey-color"),U=/^#?(?:[A-F0-9]{8}|[A-F0-9]{6}|[A-F0-9]{3})$/i,W=/^rgba?\(\s*(\d+)\s*[,\s]\s*(\d+)\s*[,\s]\s*(\d+)\s*(?:[,/]\s*([\d.]+)\s*)?\)$/i,k=/^hsla?\(\s*([\d.]+)(?:deg|rad|grad|turn)?\s*[,\s]\s*([\d.]+)%?\s*[,\s]\s*([\d.]+)%?\s*(?:[,/]\s*([\d.]+))?\s*\)$/i,Z=/^oklch\(\s*([\d.]+%?)\s*[,\s]\s*([\d.]+)\s*[,\s]\s*([\d.]+)(?:deg|rad|grad|turn)?\s*(?:[,/]\s*([\d.]+))?\s*\)$/i;function q(r){return typeof r=="object"&&r!==null&&T in r&&r[T]===!0}function J(r){return U.test(r.trim())}function Q(r){const t=W.exec(r);if(!t)return!1;const[,e,n,i,o]=t;return[Number.parseInt(e),Number.parseInt(n),Number.parseInt(i)].some(h=>h<0||h>255)?!1:o!==void 0?E(o):!0}function rr(r){const t=k.exec(r);if(!t)return!1;const[,e,n,i,o]=t;return!G(e)||!H(n)||!H(i)?!1:o!==void 0?E(o):!0}function tr(r){const t=Z.exec(r);if(!t)return!1;const[,e,n,i,o]=t;return!H(e)||!er(n)||!G(i)?!1:o!==void 0?E(o):!0}function H(r){const t=typeof r=="string"?Number.parseFloat(r):r;return t>=0&&t<=1||t>=0&&t<=100}function er(r){return(typeof r=="string"?Number.parseFloat(r):r)>=0}function G(r){const t=typeof r=="string"?Number.parseFloat(r):r;return!(t<0||t>360)}function E(r){const t=typeof r=="string"?Number.parseFloat(r):r;return t>=0&&t<=1}function nr(r){const t=r.trim();return J(t)?"hex":Q(t)?"rgb":rr(t)?"hsl":tr(t)?"oklch":"unknown"}function sr(){const r=window.scrollX||window.pageXOffset||document.documentElement.scrollLeft||0,t=window.scrollY||window.pageYOffset||document.documentElement.scrollTop||0;return{x:r,y:t}}function Or(r){const{x:t,y:e}=sr(),n=r.getBoundingClientRect();return{x:n.left+t,y:n.top+e}}function Ar(r){const t={x:0,y:0};return r instanceof MouseEvent&&(t.x=r.pageX,t.y=r.pageY),typeof TouchEvent<"u"&&r instanceof TouchEvent&&(t.x=r.touches?r.touches[0].pageX:r.changedTouches?r.changedTouches[0].pageX:0,t.y=r.touches?r.touches[0].pageY:r.changedTouches?r.changedTouches[0].pageY:0),t}function Pr(r){return{ArrowUp:"up",ArrowDown:"down",ArrowLeft:"left",ArrowRight:"right"}[r.code]}function zr(r,t){let e=0;switch(t){case"down":e=-1;break;case"up":e=1;break}return r+e}function Dr(r,t,e){return Math.min(Math.max(r,t),e)}function Kr(r){let e=0;return["r","g","b"].includes(r)&&(e=255),r==="h"&&(e=360),["s","l","a"].includes(r)&&(e=100),{min:0,max:e}}function vr(r){return Math.trunc(Number(r.replace(/[%°]/g,"").trim()))}function Vr(r,t,e,n=0,i=1){const o=(r-t)/(e-t);return(i-n)*o+n}function jr(r,t){const e=t<1?Math.ceil(-Math.log10(t)):0;return Math.round(r*10**e)/10**e}function or(r){const t=k.exec(r.trim());if(!t)return null;const[,e,n,i,o]=t;if(!e||!n||!i)return null;const l=Number.parseFloat(e),h=Number.parseFloat(n),f=Number.parseFloat(i),s=o?Number.parseFloat(o):1;if(Number.isNaN(l)||Number.isNaN(h)||Number.isNaN(f)||h<0||h>100||f<0||f>100||s<0||s>1)return null;const{r:c,g:a,b:u}=X(l,h,f);return{coords:[c/255,a/255,u/255,s],space:"rgb"}}function ir(r){const t=Z.exec(r.trim());if(!t)return null;const[,e,n,i,o]=t;if(!e||!n||!i)return null;let l=Number.parseFloat(e.replace("%",""));const h=Number.parseFloat(n),f=Number.parseFloat(i),s=o?Number.parseFloat(o):1;return Number.isNaN(l)||Number.isNaN(h)||Number.isNaN(f)||(e.includes("%")&&(l=l/100),l<0||l>1)||h<0||s<0||s>1?null:{coords:[l,h,f,s],space:"oklch"}}function X(r,t,e,n=!1){const i=r/360,o=t/100,l=e/100;let h,f,s;if(o===0)h=f=s=l;else{const c=(_,m,d)=>(d<0&&(d+=1),d>1&&(d-=1),d<.16666666666666666?_+(m-_)*6*d:d<.5?m:d<.6666666666666666?_+(m-_)*(.6666666666666666-d)*6:_),a=l<.5?l*(1+o):l+o-l*o,u=2*l-a;h=c(u,a,i+1/3),f=c(u,a,i),s=c(u,a,i-1/3)}return n?{r:h,g:f,b:s}:{r:h*255,g:f*255,b:s*255}}function cr(r,t,e){const n=Math.max(r,t,e),i=Math.min(r,t,e),o=n-i;let l=0,h=0;const f=(n+i)/2;if(o!==0)switch(h=f>.5?o/(2-n-i):o/(n+i),n){case r:l=((t-e)/o+(t<e?6:0))/6;break;case t:l=((e-r)/o+2)/6;break;case e:l=((r-t)/o+4)/6;break}return{h:l*360,s:h*100,l:f*100}}function Ir(r,t,e){const n=t/100,i=e/100,o=i+n*Math.min(i,1-i),l=o===0?0:2*(1-i/o);return{h:r,s:l*100,v:o*100}}function Ur(r,t,e){const n=t/100,i=e/100,o=i*(1-n/2),l=o===0||o===1?0:(i-o)/Math.min(o,1-o);return{h:r,s:l*100,l:o*100}}function ar(r){if(q(r))return r;const t=nr(r);if(t==="unknown")throw new Error(`invalid color provided: ${r}`);let e,n;if(t==="hsl"){const c=or(r);if(!c)throw new Error(`invalid color provided: ${r}`);e=c.coords,n=e[3]??1}else if(t==="oklch"){const c=ir(r);if(!c)throw new Error(`invalid color provided: ${r}`);e=c.coords,n=e[3]??1}else{const c=t==="hex"&&!r.startsWith("#")?`#${r}`:r;e=Sr(c).coords,n=e[3]??1}const i=t==="oklch"?e.slice(0,3):g(e.slice(0,3),w,p),[o,l,h]=i,f=(c,a,u,_)=>{const m=Math.max(0,Math.min(1,c)),d=ar(`oklch(${m*100}% ${a} ${u} / ${_})`);return d.getFormat=()=>t,d.getOriginalInput=()=>r,d},s={[T]:!0,_l:Number(o.toFixed(4)),_c:Number(l.toFixed(4)),_h:Number(h.toFixed(4)),_a:n,getFormat:()=>t,getOriginalInput:()=>r,getAlpha:()=>s._a,setAlpha:c=>f(s._l,s._c,s._h,c),setHue:c=>{const a=s.toHsl(),{r:u,g:_,b:m}=X(c,a.s,a.l,!0),[d,M,N]=g([u,_,m],w,p);return f(d,M,N,s._a)},setSaturation:c=>{const a=s.toHsl(),{r:u,g:_,b:m}=X(a.h,c,a.l,!0),[d,M,N]=g([u,_,m],w,p);return f(d,M,N,s._a)},setLightness:c=>{const a=s.toHsl(),{r:u,g:_,b:m}=X(a.h,a.s,c,!0),[d,M,N]=g([u,_,m],w,p);return f(d,M,N,s._a)},desaturate:c=>f(s._l,Math.max(0,s._c-c),s._h,s._a),saturate:c=>f(s._l,Math.max(0,s._c+c),s._h,s._a),brighten:c=>f(Math.min(1,s._l+c),s._c,s._h,s._a),lighten:c=>f(Math.min(1,s._l+c),s._c,s._h,s._a),darken:c=>f(Math.max(0,s._l-c),s._c,s._h,s._a),randomize:()=>f(Math.random(),Math.random()*.4,Math.random()*360,s._a),clone:()=>f(s._l,s._c,s._h,s._a),contrastRatio:c=>{const a=s.getLuminance(),u=c.getLuminance(),_=Math.max(a,u),m=Math.min(a,u);return(_+.05)/(m+.05)},getLuminance:()=>{const[c,a,u]=g([s._l,s._c,s._h],p,w),_=m=>m<=.03928?m/12.92:((m+.055)/1.055)**2.4;return .2126*_(c)+.7152*_(a)+.0722*_(u)},getBrightness:()=>s._l,isLight:()=>s._l>.5,isDark:()=>s._l<=.5,toHsl:()=>{const[c,a,u]=g([s._l,s._c,s._h],p,w),{h:_,s:m,l:d}=cr(c,a,u);return{h:Number(_),s:Number(m.toFixed(2)),l:Number(d.toFixed(2)),a:Number(s._a.toFixed(1))}},toHslString:()=>{const{h:c,s:a,l:u}=s.toHsl(),_=Number(s._a.toFixed(1));return _<1?`hsla(${c.toFixed(0)}, ${a.toFixed(0)}%, ${u.toFixed(0)}%, ${_})`:`hsl(${c.toFixed(0)}, ${a.toFixed(0)}%, ${u.toFixed(0)}%)`},toHex:()=>{let c=s.toHexString().replace("#","");return n===1&&(c=c.slice(0,6)),c},toHexString:()=>{const c=g([s._l,s._c,s._h],p,w);let a=Hr([...c,s._a]);return n===1&&(a=a.slice(0,7)),a},toRgb:()=>{const[c,a,u]=g([s._l,s._c,s._h],p,w);return{r:L(c),g:L(a),b:L(u),a:Number(s._a.toFixed(1))}},toRgbString:()=>{const c=g([s._l,s._c,s._h],p,w);return Yr([...c,Number(s._a.toFixed(1))],w)},toString:()=>t==="hex"?s.toHexString():t==="hsl"?s.toHslString():t==="oklch"?s.toOklchString():t==="rgb"?s.toRgbString():"",toOklchString:()=>{const c=(s._l*100).toFixed(2),a=s._c.toFixed(2),u=s._h.toFixed(2),_=s._a;return _<1?`oklch(${c}% ${a} ${u} / ${_})`:`oklch(${c}% ${a} ${u})`},toDisplayP3:()=>{const[c,a,u]=g([s._l,s._c,s._h],p,kr),_=c.toFixed(2),m=a.toFixed(2),d=u.toFixed(2),M=s._a;return M<1?`color(display-p3 ${_} ${m} ${d} / ${M})`:`color(display-p3 ${_} ${m} ${d})`},toRec2020:()=>{const[c,a,u]=g([s._l,s._c,s._h],p,Gr),_=c.toFixed(2),m=a.toFixed(2),d=u.toFixed(2),M=s._a;return M<1?`color(rec2020 ${_} ${m} ${d} / ${M})`:`color(rec2020 ${_} ${m} ${d})`}};return s}exports.HEX_REGEX=U;exports.HSL_REGEX=k;exports.OKLCH_REGEX=Z;exports.RGB_REGEX=W;exports.bumpColorValue=zr;exports.clamp=Dr;exports.getAbsolutePosition=Or;exports.getChannelBounds=Kr;exports.getFormat=nr;exports.getPageXYFromEvent=Ar;exports.getScrollXY=sr;exports.hslToHsv=Ir;exports.hslToRgb=X;exports.hsvToHsl=Ur;exports.hueyColor=ar;exports.isAlpha=E;exports.isChroma=er;exports.isHex=J;exports.isHsl=rr;exports.isHue=G;exports.isHuey=q;exports.isOklch=tr;exports.isPercentage=H;exports.isRgb=Q;exports.normalize=Vr;exports.parseHSL=or;exports.parseOKLCH=ir;exports.resolveArrowDirection=Pr;exports.rgbToHsl=cr;exports.roundToStep=jr;exports.truncColorValue=vr;

package/dist/index.d.ts

@@ -0,0 +1,198 @@
+export declare type AlphaChannel = 'a';
+
+export declare type ArrowDirection = 'up' | 'down' | 'left' | 'right';
+
+export declare function bumpColorValue(value: number, direction: Omit<ArrowDirection, 'left' | 'right'> | null): number;
+
+export declare function clamp(value: number, min: number, max: number): number;
+
+export declare type ColorChannel = RgbChannel | HslChannel | AlphaChannel;
+
+export declare type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch';
+
+export declare interface Coordinates {
+    x: number;
+    y: number;
+}
+
+/** get the position of the container relative to the document’s edge, regardless of any scrolling that has occurred */
+export declare function getAbsolutePosition(container: HTMLElement): Coordinates;
+
+export declare function getChannelBounds(key: ColorChannel): {
+    min: number;
+    max: number;
+};
+
+export declare function getFormat(input: string): ColorFormat | 'unknown';
+
+export declare function getPageXYFromEvent(e: MouseEvent | TouchEvent): Coordinates;
+
+export declare function getScrollXY(): Coordinates;
+
+export declare const HEX_REGEX: RegExp;
+
+export declare const HSL_REGEX: RegExp;
+
+export declare interface HSLA {
+    h: number;
+    s: number;
+    l: number;
+    a: number;
+}
+
+export declare type HslChannel = 'h' | 's' | 'l';
+
+/**
+ * Convert HSL to HSV
+ * Input: h in 0-360, s and l in 0-100
+ * Output: { h, s, v } where h is 0-360, s and v are 0-100
+ */
+export declare function hslToHsv(h: number, s: number, l: number): {
+    h: number;
+    s: number;
+    v: number;
+};
+
+/**
+ * Convert HSL to RGB
+ * Input: h, s, l in 0-1 range
+ * Output: [r, g, b] in 0-1 range
+ */
+export declare function hslToRgb(_h: number, _s: number, _l: number, asVector?: boolean): Omit<RGBA, 'a'>;
+
+/**
+ * Convert HSV to HSL
+ * Input: h in 0-360, s and v in 0-100
+ * Output: { h, s, l } where h is 0-360, s and l are 0-100
+ */
+export declare function hsvToHsl(h: number, s: number, v: number): {
+    h: number;
+    s: number;
+    l: number;
+};
+
+export declare const HUEY_COLOR: unique symbol;
+
+export declare interface HueyColor {
+    _l: OKLCH['l'];
+    _c: OKLCH['c'];
+    _h: OKLCH['h'];
+    _a: OKLCH['a'];
+    getFormat: () => ColorFormat;
+    getOriginalInput: () => string;
+    getAlpha: () => number;
+    getLuminance: () => number;
+    getBrightness: () => number;
+    isLight: () => boolean;
+    isDark: () => boolean;
+    setAlpha: (a: number) => HueyColor;
+    setHue: (h: number) => HueyColor;
+    setSaturation: (s: number) => HueyColor;
+    setLightness: (l: number) => HueyColor;
+    toHsl: () => HSLA;
+    toHslString: () => string;
+    toHex: () => string;
+    toHexString: () => string;
+    toRgb: () => RGBA;
+    toRgbString: () => string;
+    toRec2020: () => string;
+    toOklchString: () => string;
+    toDisplayP3: () => string;
+    toString: () => string;
+    lighten: (v: number) => HueyColor;
+    brighten: (v: number) => HueyColor;
+    darken: (v: number) => HueyColor;
+    saturate: (v: number) => HueyColor;
+    desaturate: (v: number) => HueyColor;
+    contrastRatio: (c: HueyColor) => number;
+    randomize: () => HueyColor;
+    clone: () => HueyColor;
+}
+
+export declare function hueyColor(colorInput: string | HueyColor): HueyColor;
+
+export declare interface HueyColorSymbol extends HueyColor {
+    [HUEY_COLOR]: true;
+}
+
+export declare interface HueyError {
+    type: 'invalid-format' | 'parse-error' | 'unsupported-format';
+    input: string;
+    format: string;
+    message: string;
+}
+
+export declare interface HueyOptions {
+    fallback?: string;
+    onError?: (error: HueyError) => void;
+}
+
+export declare function isAlpha(a: string | number): boolean;
+
+export declare function isChroma(c: number | string): boolean;
+
+export declare function isHex(str: string): boolean;
+
+export declare function isHsl(str: string): boolean;
+
+export declare function isHue(h: number | string): boolean;
+
+export declare function isHuey(value: unknown): value is HueyColor;
+
+export declare function isOklch(str: string): boolean;
+
+export declare function isPercentage(v: number | string): boolean;
+
+export declare function isRgb(str: string): boolean;
+
+export declare function normalize(number: number, currentScaleMin: number, currentScaleMax: number, newScaleMin?: number, newScaleMax?: number): number;
+
+export declare interface OKLCH {
+    l: number;
+    c: number;
+    h: number;
+    a: number;
+}
+
+export declare const OKLCH_REGEX: RegExp;
+
+declare interface ParsedColor {
+    coords: number[];
+    space: 'rgb' | 'oklch';
+}
+
+/**
+ * Parse HSL string and convert to RGB [0-1 range]
+ */
+export declare function parseHSL(str: string): ParsedColor | null;
+
+/**
+ * Parse OKLCH string
+ */
+export declare function parseOKLCH(str: string): ParsedColor | null;
+
+export declare function resolveArrowDirection(e: KeyboardEvent): ArrowDirection;
+
+export declare const RGB_REGEX: RegExp;
+
+export declare interface RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+
+export declare type RgbChannel = 'r' | 'g' | 'b';
+
+/**
+ * Convert RGB to HSL
+ * Input: r, g, b in 0-1 range
+ * Output: { h, s, l } where h is 0-360, s and l are 0-100
+ */
+export declare function rgbToHsl(r: number, g: number, b: number): Omit<HSLA, 'a'>;
+
+export declare function roundToStep(value: number, step: number): number;
+
+export declare function truncColorValue(value: string): number;
+
+export { }

package/dist/index.js

@@ -0,0 +1,579 @@
+const U = [
+  [1, 0.3963377773761749, 0.2158037573099136],
+  [1, -0.1055613458156586, -0.0638541728258133],
+  [1, -0.0894841775298119, -1.2914855480194092]
+], W = [
+  [0.210454268309314, 0.7936177747023054, -0.0040720430116193],
+  [1.9779985324311684, -2.42859224204858, 0.450593709617411],
+  [0.0259040424655478, 0.7827717124575296, -0.8086757549230774]
+], q = [
+  [0.819022437996703, 0.3619062600528904, -0.1288737815209879],
+  [0.0329836539323885, 0.9292868615863434, 0.0361446663506424],
+  [0.0481771893596242, 0.2642395317527308, 0.6335478284694309]
+], J = [
+  [1.2268798758459243, -0.5578149944602171, 0.2813910456659647],
+  [-0.0405757452148008, 1.112286803280317, -0.0717110580655164],
+  [-0.0763729366746601, -0.4214933324022432, 1.5869240198367816]
+], Q = [
+  [0.4123907992659595, 0.35758433938387796, 0.1804807884018343],
+  [0.21263900587151036, 0.7151686787677559, 0.07219231536073371],
+  [0.01933081871559185, 0.11919477979462599, 0.9505321522496606]
+], tt = [
+  [3.2409699419045213, -1.5373831775700935, -0.4986107602930033],
+  [-0.9692436362808798, 1.8759675015077206, 0.04155505740717561],
+  [0.05563007969699361, -0.20397695888897657, 1.0569715142428786]
+], rt = [
+  [0.4122214694707629, 0.5363325372617349, 0.051445993267502196],
+  [0.2119034958178251, 0.6806995506452345, 0.10739695353694051],
+  [0.08830245919005637, 0.2817188391361215, 0.6299787016738223]
+], et = [
+  [4.076741636075959, -3.307711539258062, 0.2309699031821041],
+  [-1.2684379732850313, 2.6097573492876878, -0.3413193760026569],
+  [-0.004196076138675526, -0.703418617935936, 1.7076146940746113]
+], nt = [
+  [0.48657094864821626, 0.26566769316909294, 0.1982172852343625],
+  [0.22897456406974884, 0.6917385218365062, 0.079286914093745],
+  [0, 0.045113381858902575, 1.0439443689009757]
+], st = [
+  [2.4934969119414245, -0.9313836179191236, -0.40271078445071684],
+  [-0.829488969561575, 1.7626640603183468, 0.02362468584194359],
+  [0.035845830243784335, -0.07617238926804171, 0.9568845240076873]
+], ot = [
+  [0.48137985274995443, 0.4621183710113181, 0.05650177623872757],
+  [0.22883194181124475, 0.6532168193835676, 0.11795123880518778],
+  [0.08394575232299319, 0.22416527097756642, 0.6918889766994405]
+], ct = [
+  [3.1277689713618737, -2.2571357625916395, 0.1293667912297651],
+  [-1.091009018437798, 2.413331710306923, -0.3223226918691248],
+  [-0.02601080193857041, -0.5080413317041669, 1.5340521336427373]
+], it = [
+  [0.6369580483012913, 0.14461690358620838, 0.16888097516417205],
+  [0.26270021201126703, 0.677998071518871, 0.059301716469861945],
+  [0, 0.028072693049087508, 1.0609850577107909]
+], at = [
+  [1.7166511879712676, -0.3556707837763924, -0.2533662813736598],
+  [-0.666684351832489, 1.616481236634939, 0.01576854581391113],
+  [0.017639857445310915, -0.042770613257808655, 0.942103121235474]
+], lt = [
+  [0.6167557848654444, 0.3601984012264634, 0.023045813908092266],
+  [0.26513305939263676, 0.6358393720678492, 0.09902756853951414],
+  [0.10010262952034828, 0.20390652261661452, 0.6959908478630372]
+], ft = [
+  [2.1399067304346513, -1.246389493760618, 0.10648276332596689],
+  [-0.8847358357577675, 2.1632309383612007, -0.27849510260343363],
+  [-0.04857374640044396, -0.45450314971409633, 1.5030768961145404]
+], P = (t, r, e) => Math.max(Math.min(t, e), r), _t = (t) => (t % 360 + 360) % 360, ht = (t, r = b()) => {
+  let e = t.replace(/#/, "");
+  e.length === 3 ? e = e[0] + e[0] + e[1] + e[1] + e[2] + e[2] : e.length > 6 && (e = e.slice(0, 6));
+  const n = parseInt(e, 16);
+  return r[0] = (n >> 16 & 255) / 255, r[1] = (n >> 8 & 255) / 255, r[2] = (n & 255) / 255, r;
+}, ut = (t) => `#${t.map((r) => L(r).toString(16).padStart(2, "0")).join("")}`, L = (t) => P(Math.round(255 * t), 0, 255), b = () => [0, 0, 0], x = b(), dt = (t) => {
+  const r = t[0], e = t[1], n = t[2];
+  t[0] = r * r * r, t[1] = e * e * e, t[2] = n * n * n;
+}, mt = (t) => {
+  t[0] = Math.cbrt(t[0]), t[1] = Math.cbrt(t[1]), t[2] = Math.cbrt(t[2]);
+}, y = (t, r) => t[0] * r[0] + t[1] * r[1] + t[2] * r[2], gt = (t, r, e = b()) => (p(t, U, e), dt(e), p(e, r, e)), C = (t, r, e = b()) => (p(t, r, e), mt(e), p(e, W, e)), p = (t, r, e = b()) => {
+  const n = y(t, r[0]), c = y(t, r[1]), o = y(t, r[2]);
+  return e[0] = n, e[1] = c, e[2] = o, e;
+}, z = (t, r) => {
+  r[0] = t[0], r[1] = t[1], r[2] = t[2];
+}, bt = (t, r, e = r) => {
+  if (!r) throw new Error("must specify an input space");
+  let n = 1;
+  t.length > 3 && (n = t[3]), z(t, x), r !== e && g(t, r, e, x);
+  const c = e.id;
+  if (c == "srgb") {
+    const o = L(x[0]), l = L(x[1]), _ = L(x[2]), f = `${o}, ${l}, ${_}`;
+    return n === 1 ? `rgb(${f})` : `rgba(${f}, ${n})`;
+  } else {
+    const o = n === 1 ? "" : ` / ${n}`;
+    return c == "oklab" || c == "oklch" ? `${c}(${x[0] * 100}% ${x[1]} ${x[2]}${o})` : `color(${c} ${x[0]} ${x[1]} ${x[2]}${o})`;
+  }
+}, T = (t) => t.length >= 4 && t[3] === 1 ? t.slice(0, 3) : t, R = (t) => parseFloat(t) || 0, G = (t, r = !1) => r ? P(R(t) / 255, 0, 255) : t.includes("%") ? R(t) / 100 : R(t), Mt = (t) => {
+  if (typeof t != "string")
+    throw new Error("expected a string as input");
+  if (t = t.trim(), t.charAt(0) === "#") {
+    const r = t.slice(0, 7);
+    let e = t.length > 7 ? parseInt(t.slice(7, 9), 16) : 255, n = isNaN(e) ? 1 : e / 255;
+    const c = ht(r);
+    return n !== 1 && c.push(n), {
+      id: "srgb",
+      coords: c
+    };
+  } else {
+    const r = /^(rgb|rgba|oklab|oklch|color)\((.+)\)$/i.exec(t);
+    if (!r)
+      throw new Error(`could not parse color string ${t}`);
+    const e = r[1].toLowerCase();
+    if (/^rgba?$/i.test(e) && r[2].includes(",")) {
+      const n = r[2].split(",").map((c, o) => G(c.trim(), o < 3));
+      return {
+        id: "srgb",
+        coords: T(n)
+      };
+    } else {
+      let n, c, o = !1;
+      if (/^color$/i.test(e)) {
+        const _ = /([^\s]+)\s+([^\s]+)\s+([^\s]+)\s+([^\s/]+)(?:\s?\/\s?([^\s]+))?/.exec(
+          r[2]
+        );
+        if (!_)
+          throw new Error(`could not parse color() function ${t}`);
+        n = _[1].toLowerCase(), c = _.slice(2, 6);
+      } else {
+        if (/^(oklab|oklch)$/i.test(e))
+          n = e;
+        else if (/rgba?/i.test(e))
+          n = "srgb", o = !0;
+        else
+          throw new Error(`unknown color function ${e}`);
+        const _ = /([^\s]+)\s+([^\s]+)\s+([^\s/]+)(?:\s?\/\s?([^\s]+))?/.exec(r[2]);
+        if (!_)
+          throw new Error(`could not parse color() function ${t}`);
+        c = _.slice(1, 6);
+      }
+      c[3] == null && (c = c.slice(0, 3));
+      const l = c.map((_, f) => G(_.trim(), o && f < 3));
+      if (l.length < 3 || l.length > 4)
+        throw new Error("invalid number of coordinates");
+      return {
+        id: n,
+        coords: T(l)
+      };
+    }
+  }
+}, g = (t, r, e, n = b()) => {
+  if (z(t, n), !r) throw new Error("must specify a fromSpace");
+  if (!e) throw new Error("must specify a toSpace");
+  if (r == e)
+    return n;
+  r.base && (n = r.toBase(n, n), r = r.base);
+  let c = r, o = e.base ?? e;
+  if (r.base || o.base)
+    throw new Error("Currently only base of depth=1 is supported");
+  if (c !== o) {
+    let l = c.id === "xyz", _ = o.id === "xyz", f = !1, s = !1;
+    if (c.id === "oklab") {
+      let i = o.fromLMS_M;
+      i || (i = A.fromLMS_M, f = !0, l = !0), n = gt(n, i, n);
+    } else if (o.id === "oklab") {
+      let i = c.toLMS_M;
+      i ? n = C(n, i, n) : (f = !0, s = !0);
+    } else
+      f = !0;
+    if (f) {
+      if (!l)
+        if (c.toXYZ)
+          n = c.toXYZ(n, n);
+        else if (c.toXYZ_M)
+          n = p(n, c.toXYZ_M, n);
+        else
+          throw new Error(`no toXYZ or toXYZ_M on ${c.id}`);
+      if (c.adapt && (n = p(n, c.adapt.to, n)), o.adapt && (n = p(n, o.adapt.from, n)), !_)
+        if (s)
+          n = C(n, A.toLMS_M, n);
+        else if (o.fromXYZ)
+          n = o.fromXYZ(n, n);
+        else if (o.fromXYZ_M)
+          n = p(n, o.fromXYZ_M, n);
+        else
+          throw new Error(`no fromXYZ or fromXYZ_M on ${o.id}`);
+    }
+  }
+  if (o !== e)
+    if (e.fromBase)
+      n = e.fromBase(n, n);
+    else
+      throw new Error(`could not transform ${o.id} to ${e.id}`);
+  return n;
+}, A = {
+  toLMS_M: q,
+  fromLMS_M: J
+}, Y = (t) => {
+  let r = t < 0 ? -1 : 1, e = Math.abs(t);
+  return e <= 0.04045 ? t / 12.92 : r * Math.pow((e + 0.055) / 1.055, 2.4);
+}, E = (t) => {
+  let r = t < 0 ? -1 : 1, e = Math.abs(t);
+  return e > 31308e-7 ? r * (1.055 * Math.pow(e, 1 / 2.4) - 0.055) : 12.92 * t;
+}, D = (t, r = b()) => (r[0] = E(t[0]), r[1] = E(t[1]), r[2] = E(t[2]), r), K = (t, r = b()) => (r[0] = Y(t[0]), r[1] = Y(t[1]), r[2] = Y(t[2]), r), xt = {
+  id: "srgb-linear",
+  toXYZ_M: Q,
+  fromXYZ_M: tt,
+  toLMS_M: rt,
+  fromLMS_M: et
+}, w = {
+  id: "srgb",
+  base: xt,
+  toBase: K,
+  fromBase: D
+}, O = (0.4 - 0) / 1e5, $t = {
+  id: "oklab"
+}, $ = {
+  id: "oklch",
+  base: $t,
+  toBase: (t, r = b()) => {
+    const e = t[1], n = t[2];
+    return r[0] = t[0], r[1] = e * Math.cos(n * Math.PI / 180), r[2] = e * Math.sin(n * Math.PI / 180), r;
+  },
+  fromBase: (t, r = b()) => {
+    const e = t[1], n = t[2];
+    let c = Math.abs(e) < O && Math.abs(n) < O, o = c ? 0 : _t(Math.atan2(n, e) * 180 / Math.PI), l = c ? 0 : Math.sqrt(e * e + n * n);
+    return r[0] = t[0], r[1] = l, r[2] = o, r;
+  }
+}, wt = {
+  id: "display-p3-linear",
+  toXYZ_M: nt,
+  fromXYZ_M: st,
+  toLMS_M: ot,
+  fromLMS_M: ct
+}, pt = {
+  id: "display-p3",
+  base: wt,
+  toBase: K,
+  fromBase: D
+}, X = 1.09929682680944, V = 0.018053968510807, H = (t) => t < V * 4.5 ? t / 4.5 : Math.pow((t + X - 1) / X, 1 / 0.45), B = (t) => t >= V ? X * Math.pow(t, 0.45) - (X - 1) : 4.5 * t, Lt = {
+  id: "rec2020-linear",
+  toXYZ_M: it,
+  fromXYZ_M: at,
+  toLMS_M: lt,
+  fromLMS_M: ft
+}, Nt = {
+  id: "rec2020",
+  base: Lt,
+  toBase: (t, r = b()) => (r[0] = H(t[0]), r[1] = H(t[1]), r[2] = H(t[2]), r),
+  fromBase: (t, r = b()) => (r[0] = B(t[0]), r[1] = B(t[1]), r[2] = B(t[2]), r)
+}, S = Symbol("huey-color"), Ft = /^#?(?:[A-F0-9]{8}|[A-F0-9]{6}|[A-F0-9]{3})$/i, Xt = /^rgba?\(\s*(\d+)\s*[,\s]\s*(\d+)\s*[,\s]\s*(\d+)\s*(?:[,/]\s*([\d.]+)\s*)?\)$/i, v = /^hsla?\(\s*([\d.]+)(?:deg|rad|grad|turn)?\s*[,\s]\s*([\d.]+)%?\s*[,\s]\s*([\d.]+)%?\s*(?:[,/]\s*([\d.]+))?\s*\)$/i, I = /^oklch\(\s*([\d.]+%?)\s*[,\s]\s*([\d.]+)\s*[,\s]\s*([\d.]+)(?:deg|rad|grad|turn)?\s*(?:[,/]\s*([\d.]+))?\s*\)$/i;
+function yt(t) {
+  return typeof t == "object" && t !== null && S in t && t[S] === !0;
+}
+function Rt(t) {
+  return Ft.test(t.trim());
+}
+function Yt(t) {
+  const r = Xt.exec(t);
+  if (!r)
+    return !1;
+  const [, e, n, c, o] = r;
+  return [Number.parseInt(e), Number.parseInt(n), Number.parseInt(c)].some((_) => _ < 0 || _ > 255) ? !1 : o !== void 0 ? Z(o) : !0;
+}
+function Et(t) {
+  const r = v.exec(t);
+  if (!r)
+    return !1;
+  const [, e, n, c, o] = r;
+  return !j(e) || !k(n) || !k(c) ? !1 : o !== void 0 ? Z(o) : !0;
+}
+function Ht(t) {
+  const r = I.exec(t);
+  if (!r)
+    return !1;
+  const [, e, n, c, o] = r;
+  return !k(e) || !Bt(n) || !j(c) ? !1 : o !== void 0 ? Z(o) : !0;
+}
+function k(t) {
+  const r = typeof t == "string" ? Number.parseFloat(t) : t;
+  return r >= 0 && r <= 1 || r >= 0 && r <= 100;
+}
+function Bt(t) {
+  return (typeof t == "string" ? Number.parseFloat(t) : t) >= 0;
+}
+function j(t) {
+  const r = typeof t == "string" ? Number.parseFloat(t) : t;
+  return !(r < 0 || r > 360);
+}
+function Z(t) {
+  const r = typeof t == "string" ? Number.parseFloat(t) : t;
+  return r >= 0 && r <= 1;
+}
+function St(t) {
+  const r = t.trim();
+  return Rt(r) ? "hex" : Yt(r) ? "rgb" : Et(r) ? "hsl" : Ht(r) ? "oklch" : "unknown";
+}
+function kt() {
+  const t = window.scrollX || window.pageXOffset || document.documentElement.scrollLeft || 0, r = window.scrollY || window.pageYOffset || document.documentElement.scrollTop || 0;
+  return { x: t, y: r };
+}
+function At(t) {
+  const { x: r, y: e } = kt(), n = t.getBoundingClientRect();
+  return {
+    x: n.left + r,
+    y: n.top + e
+  };
+}
+function Ot(t) {
+  const r = { x: 0, y: 0 };
+  return t instanceof MouseEvent && (r.x = t.pageX, r.y = t.pageY), typeof TouchEvent < "u" && t instanceof TouchEvent && (r.x = t.touches ? t.touches[0].pageX : t.changedTouches ? t.changedTouches[0].pageX : 0, r.y = t.touches ? t.touches[0].pageY : t.changedTouches ? t.changedTouches[0].pageY : 0), r;
+}
+function Pt(t) {
+  return {
+    ArrowUp: "up",
+    ArrowDown: "down",
+    ArrowLeft: "left",
+    ArrowRight: "right"
+  }[t.code];
+}
+function zt(t, r) {
+  let e = 0;
+  switch (r) {
+    case "down":
+      e = -1;
+      break;
+    case "up":
+      e = 1;
+      break;
+  }
+  return t + e;
+}
+function Dt(t, r, e) {
+  return Math.min(Math.max(t, r), e);
+}
+function Kt(t) {
+  let e = 0;
+  return ["r", "g", "b"].includes(t) && (e = 255), t === "h" && (e = 360), ["s", "l", "a"].includes(t) && (e = 100), {
+    min: 0,
+    max: e
+  };
+}
+function Vt(t) {
+  return Math.trunc(Number(t.replace(/[%°]/g, "").trim()));
+}
+function vt(t, r, e, n = 0, c = 1) {
+  const o = (t - r) / (e - r);
+  return (c - n) * o + n;
+}
+function It(t, r) {
+  const e = r < 1 ? Math.ceil(-Math.log10(r)) : 0;
+  return Math.round(t * 10 ** e) / 10 ** e;
+}
+function Zt(t) {
+  const r = v.exec(t.trim());
+  if (!r)
+    return null;
+  const [, e, n, c, o] = r;
+  if (!e || !n || !c)
+    return null;
+  const l = Number.parseFloat(e), _ = Number.parseFloat(n), f = Number.parseFloat(c), s = o ? Number.parseFloat(o) : 1;
+  if (Number.isNaN(l) || Number.isNaN(_) || Number.isNaN(f) || _ < 0 || _ > 100 || f < 0 || f > 100 || s < 0 || s > 1)
+    return null;
+  const { r: i, g: a, b: u } = F(l, _, f);
+  return {
+    coords: [i / 255, a / 255, u / 255, s],
+    space: "rgb"
+  };
+}
+function Ct(t) {
+  const r = I.exec(t.trim());
+  if (!r)
+    return null;
+  const [, e, n, c, o] = r;
+  if (!e || !n || !c)
+    return null;
+  let l = Number.parseFloat(e.replace("%", ""));
+  const _ = Number.parseFloat(n), f = Number.parseFloat(c), s = o ? Number.parseFloat(o) : 1;
+  return Number.isNaN(l) || Number.isNaN(_) || Number.isNaN(f) || (e.includes("%") && (l = l / 100), l < 0 || l > 1) || _ < 0 || s < 0 || s > 1 ? null : {
+    coords: [l, _, f, s],
+    space: "oklch"
+  };
+}
+function F(t, r, e, n = !1) {
+  const c = t / 360, o = r / 100, l = e / 100;
+  let _, f, s;
+  if (o === 0)
+    _ = f = s = l;
+  else {
+    const i = (h, m, d) => (d < 0 && (d += 1), d > 1 && (d -= 1), d < 0.16666666666666666 ? h + (m - h) * 6 * d : d < 0.5 ? m : d < 0.6666666666666666 ? h + (m - h) * (0.6666666666666666 - d) * 6 : h), a = l < 0.5 ? l * (1 + o) : l + o - l * o, u = 2 * l - a;
+    _ = i(u, a, c + 1 / 3), f = i(u, a, c), s = i(u, a, c - 1 / 3);
+  }
+  return n ? { r: _, g: f, b: s } : {
+    r: _ * 255,
+    g: f * 255,
+    b: s * 255
+  };
+}
+function Tt(t, r, e) {
+  const n = Math.max(t, r, e), c = Math.min(t, r, e), o = n - c;
+  let l = 0, _ = 0;
+  const f = (n + c) / 2;
+  if (o !== 0)
+    switch (_ = f > 0.5 ? o / (2 - n - c) : o / (n + c), n) {
+      case t:
+        l = ((r - e) / o + (r < e ? 6 : 0)) / 6;
+        break;
+      case r:
+        l = ((e - t) / o + 2) / 6;
+        break;
+      case e:
+        l = ((t - r) / o + 4) / 6;
+        break;
+    }
+  return {
+    h: l * 360,
+    // Convert to degrees
+    s: _ * 100,
+    // Convert to percentage
+    l: f * 100
+    // Convert to percentage
+  };
+}
+function jt(t, r, e) {
+  const n = r / 100, c = e / 100, o = c + n * Math.min(c, 1 - c), l = o === 0 ? 0 : 2 * (1 - c / o);
+  return {
+    h: t,
+    // Hue stays the same
+    s: l * 100,
+    // Convert to percentage
+    v: o * 100
+    // Convert to percentage
+  };
+}
+function Ut(t, r, e) {
+  const n = r / 100, c = e / 100, o = c * (1 - n / 2), l = o === 0 || o === 1 ? 0 : (c - o) / Math.min(o, 1 - o);
+  return {
+    h: t,
+    s: l * 100,
+    l: o * 100
+  };
+}
+function Gt(t) {
+  if (yt(t))
+    return t;
+  const r = St(t);
+  if (r === "unknown")
+    throw new Error(`invalid color provided: ${t}`);
+  let e, n;
+  if (r === "hsl") {
+    const i = Zt(t);
+    if (!i)
+      throw new Error(`invalid color provided: ${t}`);
+    e = i.coords, n = e[3] ?? 1;
+  } else if (r === "oklch") {
+    const i = Ct(t);
+    if (!i)
+      throw new Error(`invalid color provided: ${t}`);
+    e = i.coords, n = e[3] ?? 1;
+  } else {
+    const i = r === "hex" && !t.startsWith("#") ? `#${t}` : t;
+    e = Mt(i).coords, n = e[3] ?? 1;
+  }
+  const c = r === "oklch" ? e.slice(0, 3) : g(e.slice(0, 3), w, $), [o, l, _] = c, f = (i, a, u, h) => {
+    const m = Math.max(0, Math.min(1, i)), d = Gt(`oklch(${m * 100}% ${a} ${u} / ${h})`);
+    return d.getFormat = () => r, d.getOriginalInput = () => t, d;
+  }, s = {
+    [S]: !0,
+    _l: Number(o.toFixed(4)),
+    _c: Number(l.toFixed(4)),
+    _h: Number(_.toFixed(4)),
+    _a: n,
+    getFormat: () => r,
+    getOriginalInput: () => t,
+    getAlpha: () => s._a,
+    setAlpha: (i) => f(s._l, s._c, s._h, i),
+    setHue: (i) => {
+      const a = s.toHsl(), { r: u, g: h, b: m } = F(i, a.s, a.l, !0), [d, M, N] = g([u, h, m], w, $);
+      return f(d, M, N, s._a);
+    },
+    setSaturation: (i) => {
+      const a = s.toHsl(), { r: u, g: h, b: m } = F(a.h, i, a.l, !0), [d, M, N] = g([u, h, m], w, $);
+      return f(d, M, N, s._a);
+    },
+    setLightness: (i) => {
+      const a = s.toHsl(), { r: u, g: h, b: m } = F(a.h, a.s, i, !0), [d, M, N] = g([u, h, m], w, $);
+      return f(d, M, N, s._a);
+    },
+    desaturate: (i) => f(s._l, Math.max(0, s._c - i), s._h, s._a),
+    saturate: (i) => f(s._l, Math.max(0, s._c + i), s._h, s._a),
+    brighten: (i) => f(Math.min(1, s._l + i), s._c, s._h, s._a),
+    lighten: (i) => f(Math.min(1, s._l + i), s._c, s._h, s._a),
+    darken: (i) => f(Math.max(0, s._l - i), s._c, s._h, s._a),
+    randomize: () => f(Math.random(), Math.random() * 0.4, Math.random() * 360, s._a),
+    clone: () => f(s._l, s._c, s._h, s._a),
+    contrastRatio: (i) => {
+      const a = s.getLuminance(), u = i.getLuminance(), h = Math.max(a, u), m = Math.min(a, u);
+      return (h + 0.05) / (m + 0.05);
+    },
+    getLuminance: () => {
+      const [i, a, u] = g([s._l, s._c, s._h], $, w), h = (m) => m <= 0.03928 ? m / 12.92 : ((m + 0.055) / 1.055) ** 2.4;
+      return 0.2126 * h(i) + 0.7152 * h(a) + 0.0722 * h(u);
+    },
+    getBrightness: () => s._l,
+    isLight: () => s._l > 0.5,
+    isDark: () => s._l <= 0.5,
+    toHsl: () => {
+      const [i, a, u] = g([s._l, s._c, s._h], $, w), { h, s: m, l: d } = Tt(i, a, u);
+      return { h: Number(h), s: Number(m.toFixed(2)), l: Number(d.toFixed(2)), a: Number(s._a.toFixed(1)) };
+    },
+    toHslString: () => {
+      const { h: i, s: a, l: u } = s.toHsl(), h = Number(s._a.toFixed(1));
+      return h < 1 ? `hsla(${i.toFixed(0)}, ${a.toFixed(0)}%, ${u.toFixed(0)}%, ${h})` : `hsl(${i.toFixed(0)}, ${a.toFixed(0)}%, ${u.toFixed(0)}%)`;
+    },
+    toHex: () => {
+      let i = s.toHexString().replace("#", "");
+      return n === 1 && (i = i.slice(0, 6)), i;
+    },
+    toHexString: () => {
+      const i = g([s._l, s._c, s._h], $, w);
+      let a = ut([...i, s._a]);
+      return n === 1 && (a = a.slice(0, 7)), a;
+    },
+    toRgb: () => {
+      const [i, a, u] = g([s._l, s._c, s._h], $, w);
+      return {
+        r: L(i),
+        g: L(a),
+        b: L(u),
+        a: Number(s._a.toFixed(1))
+      };
+    },
+    toRgbString: () => {
+      const i = g([s._l, s._c, s._h], $, w);
+      return bt([...i, Number(s._a.toFixed(1))], w);
+    },
+    toString: () => r === "hex" ? s.toHexString() : r === "hsl" ? s.toHslString() : r === "oklch" ? s.toOklchString() : r === "rgb" ? s.toRgbString() : "",
+    toOklchString: () => {
+      const i = (s._l * 100).toFixed(2), a = s._c.toFixed(2), u = s._h.toFixed(2), h = s._a;
+      return h < 1 ? `oklch(${i}% ${a} ${u} / ${h})` : `oklch(${i}% ${a} ${u})`;
+    },
+    toDisplayP3: () => {
+      const [i, a, u] = g([s._l, s._c, s._h], $, pt), h = i.toFixed(2), m = a.toFixed(2), d = u.toFixed(2), M = s._a;
+      return M < 1 ? `color(display-p3 ${h} ${m} ${d} / ${M})` : `color(display-p3 ${h} ${m} ${d})`;
+    },
+    toRec2020: () => {
+      const [i, a, u] = g([s._l, s._c, s._h], $, Nt), h = i.toFixed(2), m = a.toFixed(2), d = u.toFixed(2), M = s._a;
+      return M < 1 ? `color(rec2020 ${h} ${m} ${d} / ${M})` : `color(rec2020 ${h} ${m} ${d})`;
+    }
+  };
+  return s;
+}
+export {
+  Ft as HEX_REGEX,
+  v as HSL_REGEX,
+  I as OKLCH_REGEX,
+  Xt as RGB_REGEX,
+  zt as bumpColorValue,
+  Dt as clamp,
+  At as getAbsolutePosition,
+  Kt as getChannelBounds,
+  St as getFormat,
+  Ot as getPageXYFromEvent,
+  kt as getScrollXY,
+  jt as hslToHsv,
+  F as hslToRgb,
+  Ut as hsvToHsl,
+  Gt as hueyColor,
+  Z as isAlpha,
+  Bt as isChroma,
+  Rt as isHex,
+  Et as isHsl,
+  j as isHue,
+  yt as isHuey,
+  Ht as isOklch,
+  k as isPercentage,
+  Yt as isRgb,
+  vt as normalize,
+  Zt as parseHSL,
+  Ct as parseOKLCH,
+  Pt as resolveArrowDirection,
+  Tt as rgbToHsl,
+  It as roundToStep,
+  Vt as truncColorValue
+};

package/dist/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@hueycolor/core",
+  "type": "module",
+  "version": "0.0.1-beta.3",
+  "private": false,
+  "description": "Core utility lib for color manipulation for huey's components",
+  "author": "Eihab Khan <yo@eihab.me>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hueycolor/huey",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "color",
+    "colour",
+    "color-manipulation",
+    "hsl",
+    "rgb",
+    "hex",
+    "tinycolor",
+    "huey"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "tinycolor2": "^1.6.0"
+  },
+  "devDependencies": {
+    "typescript": "~5.8.3",
+    "vite": "^7.1.2",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "scripts": {
+    "dev": "vite",
+    "watch": "vite build --watch",
+    "build": "vite build",
+    "preview": "vite preview"
+  }
+}