@mkbabb/value.js 0.4.4 → 0.4.5

package/dist/assets/xyz-CX5zPyPG.js

@@ -1,3 +0,0 @@
-import{K as r,r as m,x as g,f as c,l as h}from"./Katex-ClrxLHTj.js";import{g as f,W as b}from"./index-Q19pIqw1.js";import{J as v,V as y,a0 as e,a1 as n,a2 as i,u as o,a6 as d,N as s}from"./vendor-highlight-sMWp9TLU.js";import"./vendor-katex-Dehg5p_Y.js";import"./vendor-prettier-wO8BBsoP.js";const x={class:"markdown-body"},C={class:"language-typescript"},Y={class:"language-typescript"},w={class:"language-typescript"},X={class:"language-typescript"},Z={class:"language-typescript"},N={__name:"xyz",setup(D,{expose:u}){u({frontmatter:{}});const{x:a,y:l,z:p}=f("xyz");return(B,t)=>(v(),y("div",x,[t[4]||(t[4]=e("h3",null,"Attributes",-1)),e("ul",null,[e("li",null,[t[0]||(t[0]=e("code",null,"X",-1)),n(": Response curve to red ("+i(o(a).min)+" to "+i(o(a).max)+")",1)]),e("li",null,[t[1]||(t[1]=e("code",null,"Y",-1)),n(": Luminance ("+i(o(l).min)+" to "+i(o(l).max)+")",1)]),e("li",null,[t[2]||(t[2]=e("code",null,"Z",-1)),n(": Response curve to blue ("+i(o(p).min)+" to "+i(o(p).max)+")",1)])]),t[5]||(t[5]=d('<h3>Historical Context</h3><p>CIE XYZ (1931) was the first mathematically defined color space. The <a href="https://en.wikipedia.org/wiki/International_Commission_on_Illumination">Commission Internationale de l’Eclairage</a> derived it from experiments mapping how a standard observer responds to wavelengths of visible light. It’s device-independent by design—colors are specified as points in an abstract tristimulus space, not as instructions for a particular display or printer.</p><p>In value.js, <strong>XYZ is the conversion hub</strong>: most color space transforms pass through it.</p><hr><h2>Key Characteristics</h2><ol><li><strong>Device-independent.</strong> XYZ values describe a color itself, not how to reproduce it on hardware.</li><li><strong>Complete gamut.</strong> Encompasses all colors visible to the human eye—no clipping to an RGB or CMYK subset.</li><li><strong>Foundation space.</strong> Lab, Luv, and virtually every perceptual model derives from XYZ.</li><li><strong>Standardized white points.</strong> D50, D65, and others provide fixed reference whites for consistent colorimetry.</li></ol><h2>Advantages</h2><ul><li>Device-independent</li><li>Encompasses all visible colors</li><li>Mathematical basis for all other CIE-derived color spaces</li><li>Direct relationship to the standard observer model</li></ul><h2>Disadvantages</h2><ul><li>Not perceptually uniform—equal numeric steps don’t look equal</li><li>Components are abstract; <code>X</code> and <code>Z</code> don’t map to any intuitive visual attribute</li><li>Not directly usable for display or print output</li></ul><hr><h2>Color Model</h2><h3>Components</h3><ol><li><p><strong><code>X</code></strong>: A weighted mix of cone response curves, roughly tracking red sensitivity. Not a pure spectral response—it’s a mathematical construct chosen so that all tristimulus values remain non-negative.</p></li><li><p><strong><code>Y</code></strong>: Corresponds directly to luminance. Matches the CIE photopic luminosity function, so it doubles as a measure of perceived brightness.</p></li><li><p><strong><code>Z</code></strong>: Roughly tracks blue sensitivity. Like <code>X</code>, it’s primarily a mathematical convenience rather than a direct perceptual correlate.</p></li></ol><p>Colors in XYZ are points in a 3D space. <code>Y</code> carries brightness information; <code>X</code> and <code>Z</code> don’t correspond to perceptual attributes on their own. This makes XYZ a conversion intermediary, not a creative tool.</p><h3>White Points and Chromatic Adaptation</h3><p>XYZ values are relative to a reference white point:</p><ul><li><strong>D50</strong>: Standard for graphic arts and printing (slightly warm/yellowish)</li><li><strong>D65</strong>: Standard for digital imaging, approximating average daylight (slightly cool/bluish)</li></ul><p>Converting between white points requires chromatic adaptation. value.js uses the Bradford transform:</p>',19)),e("div",C,[n(" // D65 to D50 transformation matrix "+i(o(b))+" ",1),t[3]||(t[3]=e("pre",null,[e("code",null,`// D50 to D65 transformation matrix
-{{ WHITE_POINT_D50_D65 }}
-`)],-1))]),t[6]||(t[6]=e("hr",null,null,-1)),t[7]||(t[7]=e("h2",null,"Color Conversions",-1)),t[8]||(t[8]=e("h3",null,"RGB to XYZ",-1)),t[9]||(t[9]=e("p",null,"Linearize sRGB (undo the gamma curve), then multiply by the 3×3 sRGB-to-XYZ matrix:",-1)),s(o(r),{expression:"\\mathbf{rgb}_{\\text{linear}} = \\gamma^{-1}(\\mathbf{rgb}), \\quad \\begin{bmatrix} X \\\\ Y \\\\ Z \\end{bmatrix} = M_{\\text{sRGB}} \\cdot \\mathbf{rgb}_{\\text{linear}}"}),t[10]||(t[10]=e("p",null,"The sRGB transfer function is piecewise: linear below ~0.04045, power-law (exponent 2.4) above.",-1)),e("div",Y,i(o(m)),1),t[11]||(t[11]=e("h3",null,"XYZ to RGB",-1)),t[12]||(t[12]=e("p",null,"Multiply by the inverse matrix, then apply the sRGB gamma curve:",-1)),s(o(r),{expression:"\\mathbf{rgb}_{\\text{linear}} = M_{\\text{sRGB}}^{-1} \\begin{bmatrix} X \\\\ Y \\\\ Z \\end{bmatrix}, \\quad \\mathbf{rgb} = \\gamma(\\mathbf{rgb}_{\\text{linear}})"}),e("div",w,i(o(g)),1),t[13]||(t[13]=e("h3",null,"XYZ to Lab",-1)),t[14]||(t[14]=e("p",null,"Normalize by the white point, apply the CIE perceptual function, then scale:",-1)),s(o(r),{expression:"L^* = 116\\, f\\!\\left(\\frac{Y}{Y_n}\\right) - 16, \\quad a^* = 500\\left[f\\!\\left(\\frac{X}{X_n}\\right) - f\\!\\left(\\frac{Y}{Y_n}\\right)\\right], \\quad b^* = 200\\left[f\\!\\left(\\frac{Y}{Y_n}\\right) - f\\!\\left(\\frac{Z}{Z_n}\\right)\\right]"}),e("div",X,i(o(c)),1),t[15]||(t[15]=e("h3",null,"Lab to XYZ",-1)),t[16]||(t[16]=e("p",null,"Invert the L*a*b* formulas and scale by the white point:",-1)),s(o(r),{expression:"f_y = \\frac{L^* + 16}{116}, \\quad f_x = \\frac{a^*}{500} + f_y, \\quad f_z = f_y - \\frac{b^*}{200}"}),e("div",Z,i(o(h)),1),t[17]||(t[17]=d("<hr><h2>Applications</h2><ol><li><strong>Color management.</strong> ICC profiles define device gamuts in XYZ; all profile-to-profile conversions transit through it.</li><li><strong>Colorimetry.</strong> Spectrophotometers report measurements in XYZ or its derivatives.</li><li><strong>Cross-media reproduction.</strong> The device-independent anchor that lets a print proof match a monitor preview.</li><li><strong>Color difference metrics.</strong> Delta E formulas operate in Lab/Luv, both derived from XYZ.</li><li><strong>Appearance models.</strong> CIECAM02 and similar models take XYZ as input to predict how a color looks under different viewing conditions.</li></ol>",3))]))}};export{N as default};

package/dist/index.html

@@ -1,18 +0,0 @@
-<!doctype html>
-<html lang="en">
-    <head>
-        <meta charset="UTF-8" />
-        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>Color Picker</title>
-        <link rel="icon" type="image/svg+xml" href="./assets/favicon-BpOvZXpk.svg" />
-
-      <script type="module" crossorigin src="./assets/index-Q19pIqw1.js"></script>
-      <link rel="modulepreload" crossorigin href="./assets/vendor-highlight-sMWp9TLU.js">
-      <link rel="modulepreload" crossorigin href="./assets/vendor-prettier-wO8BBsoP.js">
-      <link rel="modulepreload" crossorigin href="./assets/vendor-katex-Dehg5p_Y.js">
-      <link rel="stylesheet" crossorigin href="./assets/index-VnEkwzsm.css">
-    </head>
-
-    <body class="relative" id="app"></body>
-</html>