color-bits 1.1.1 → 1.2.0

package/build/operations/adjust.d.ts

@@ -0,0 +1,19 @@
+import type { ColorBits } from '../core/bits';
+/**
+ * Modifies color alpha channel.
+ * @param color - ColorBits
+ * @param value - Value in the range [0, 1]
+ */
+export declare function alpha(color: ColorBits, value: number): ColorBits;
+/**
+ * Darkens a color.
+ * @param color - ColorBits
+ * @param coefficient - Multiplier in the range [0, 1]
+ */
+export declare function darken(color: ColorBits, coefficient: number): ColorBits;
+/**
+ * Lighten a color.
+ * @param color - ColorBits
+ * @param coefficient - Multiplier in the range [0, 1]
+ */
+export declare function lighten(color: ColorBits, coefficient: number): ColorBits;

package/build/operations/adjust.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.alpha = alpha;
+exports.darken = darken;
+exports.lighten = lighten;
+const bits_1 = require("../core/bits");
+/**
+ * Modifies color alpha channel.
+ * @param color - ColorBits
+ * @param value - Value in the range [0, 1]
+ */
+function alpha(color, value) {
+    return (0, bits_1.setAlpha)(color, Math.round(value * 255));
+}
+/**
+ * Darkens a color.
+ * @param color - ColorBits
+ * @param coefficient - Multiplier in the range [0, 1]
+ */
+function darken(color, coefficient) {
+    const r = (0, bits_1.getRed)(color);
+    const g = (0, bits_1.getGreen)(color);
+    const b = (0, bits_1.getBlue)(color);
+    const a = (0, bits_1.getAlpha)(color);
+    const factor = 1 - coefficient;
+    return (0, bits_1.newColor)(r * factor, g * factor, b * factor, a);
+}
+/**
+ * Lighten a color.
+ * @param color - ColorBits
+ * @param coefficient - Multiplier in the range [0, 1]
+ */
+function lighten(color, coefficient) {
+    const r = (0, bits_1.getRed)(color);
+    const g = (0, bits_1.getGreen)(color);
+    const b = (0, bits_1.getBlue)(color);
+    const a = (0, bits_1.getAlpha)(color);
+    return (0, bits_1.newColor)(r + (255 - r) * coefficient, g + (255 - g) * coefficient, b + (255 - b) * coefficient, a);
+}
+//# sourceMappingURL=adjust.js.map

package/build/operations/adjust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust.js","sourceRoot":"","sources":["../../src/operations/adjust.ts"],"names":[],"mappings":";;AAQA,sBAEC;AAOD,wBAcC;AAOD,0BAYC;AAjDD,uCAAsF;AAEtF;;;;GAIG;AACH,SAAgB,KAAK,CAAC,KAAgB,EAAE,KAAa;IACnD,OAAO,IAAA,eAAQ,EAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,MAAM,CAAC,KAAgB,EAAE,WAAmB;IAC1D,MAAM,CAAC,GAAG,IAAA,aAAM,EAAC,KAAK,CAAC,CAAA;IACvB,MAAM,CAAC,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAA;IACzB,MAAM,CAAC,GAAG,IAAA,cAAO,EAAC,KAAK,CAAC,CAAA;IACxB,MAAM,CAAC,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAA;IAEzB,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAA;IAE9B,OAAO,IAAA,eAAQ,EACb,CAAC,GAAG,MAAM,EACV,CAAC,GAAG,MAAM,EACV,CAAC,GAAG,MAAM,EACV,CAAC,CACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,OAAO,CAAC,KAAgB,EAAE,WAAmB;IAC3D,MAAM,CAAC,GAAG,IAAA,aAAM,EAAC,KAAK,CAAC,CAAA;IACvB,MAAM,CAAC,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAA;IACzB,MAAM,CAAC,GAAG,IAAA,cAAO,EAAC,KAAK,CAAC,CAAA;IACxB,MAAM,CAAC,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAA;IAEzB,OAAO,IAAA,eAAQ,EACb,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,WAAW,EAC3B,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,WAAW,EAC3B,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,WAAW,EAC3B,CAAC,CACF,CAAA;AACH,CAAC"}

package/build/operations/blend.d.ts

@@ -0,0 +1,9 @@
+import type { ColorBits } from '../core/bits';
+/**
+ * Blend (aka mix) two colors together.
+ * @param background The background color
+ * @param overlay The overlay color affected by `opacity`
+ * @param opacity Opacity (alpha) for `overlay`
+ * @param [gamma=1.0] Gamma correction coefficient. `1.0` to match browser behavior, `2.2` for gamma-corrected blending.
+ */
+export declare function blend(background: ColorBits, overlay: ColorBits, opacity: number, gamma?: number): ColorBits;

package/build/operations/blend.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blend = blend;
+const bits_1 = require("../core/bits");
+/**
+ * Blend (aka mix) two colors together.
+ * @param background The background color
+ * @param overlay The overlay color affected by `opacity`
+ * @param opacity Opacity (alpha) for `overlay`
+ * @param [gamma=1.0] Gamma correction coefficient. `1.0` to match browser behavior, `2.2` for gamma-corrected blending.
+ */
+function blend(background, overlay, opacity, gamma = 1.0) {
+    const blendChannel = (b, o) => Math.round((b ** (1 / gamma) * (1 - opacity) + o ** (1 / gamma) * opacity) ** gamma);
+    const r = blendChannel((0, bits_1.getRed)(background), (0, bits_1.getRed)(overlay));
+    const g = blendChannel((0, bits_1.getGreen)(background), (0, bits_1.getGreen)(overlay));
+    const b = blendChannel((0, bits_1.getBlue)(background), (0, bits_1.getBlue)(overlay));
+    return (0, bits_1.newColor)(r, g, b, 255);
+}
+//# sourceMappingURL=blend.js.map

package/build/operations/blend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.js","sourceRoot":"","sources":["../../src/operations/blend.ts"],"names":[],"mappings":";;AAUA,sBASC;AAlBD,uCAAkE;AAElE;;;;;;GAMG;AACH,SAAgB,KAAK,CAAC,UAAqB,EAAE,OAAkB,EAAE,OAAe,EAAE,KAAK,GAAG,GAAG;IAC3F,MAAM,YAAY,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAC5C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,CAAC,CAAA;IAEtF,MAAM,CAAC,GAAG,YAAY,CAAC,IAAA,aAAM,EAAC,UAAU,CAAC,EAAE,IAAA,aAAM,EAAC,OAAO,CAAC,CAAC,CAAA;IAC3D,MAAM,CAAC,GAAG,YAAY,CAAC,IAAA,eAAQ,EAAC,UAAU,CAAC,EAAE,IAAA,eAAQ,EAAC,OAAO,CAAC,CAAC,CAAA;IAC/D,MAAM,CAAC,GAAG,YAAY,CAAC,IAAA,cAAO,EAAC,UAAU,CAAC,EAAE,IAAA,cAAO,EAAC,OAAO,CAAC,CAAC,CAAA;IAE7D,OAAO,IAAA,eAAQ,EAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;AAC/B,CAAC"}

package/build/operations/color-mix.d.ts

@@ -0,0 +1,20 @@
+import { ColorBits } from '../core/bits';
+import type { ColorModel } from '../conversion/channels';
+export type HueMethod = 'shorter' | 'longer' | 'increasing' | 'decreasing';
+export interface ColorMixOptions {
+    /** interpolation space: a model name ("oklab", "hsl", …) or a ColorModel, e.g. colorSpaceModel('srgb') */
+    space: string | ColorModel;
+    /** hue interpolation method for polar spaces (default "shorter") */
+    hue?: HueMethod;
+    /** percentage (0..100) of color1; defaults derived from p2 or 50 */
+    p1?: number;
+    /** percentage (0..100) of color2; defaults derived from p1 or 50 */
+    p2?: number;
+}
+/**
+ * Mix two colors in the given color space.
+ * @param color1 first color
+ * @param color2 second color
+ * @param options interpolation space, hue method and percentages
+ */
+export declare function colorMix(color1: ColorBits, color2: ColorBits, options: ColorMixOptions): ColorBits;

package/build/operations/color-mix.js

@@ -0,0 +1,144 @@
+"use strict";
+// CSS Color 5 color-mix(). Interpolates two colors in a chosen color space with
+// premultiplied alpha and the four hue-interpolation methods.
+// https://drafts.csswg.org/css-color-5/#color-mix
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorMix = colorMix;
+const bits_1 = require("../core/bits");
+const bytes_1 = require("../core/bytes");
+const channels_1 = require("../conversion/channels");
+// Both interpolation endpoints are alive at once, so each gets its own buffer.
+const CHANNELS_1 = new Float64Array(3);
+const CHANNELS_2 = new Float64Array(3);
+function fail(message) {
+    throw new Error('color-mix(): ' + message);
+}
+function normalizeHue(h) {
+    return ((h % 360) + 360) % 360;
+}
+function adjustHue(h1, h2, method) {
+    h1 = normalizeHue(h1);
+    h2 = normalizeHue(h2);
+    const d = h2 - h1;
+    switch (method) {
+        case 'shorter':
+            if (d > 180)
+                h1 += 360;
+            else if (d < -180)
+                h2 += 360;
+            break;
+        case 'longer':
+            if (d > 0 && d < 180)
+                h1 += 360;
+            else if (d > -180 && d <= 0)
+                h2 += 360;
+            break;
+        case 'increasing':
+            if (h2 < h1)
+                h2 += 360;
+            break;
+        case 'decreasing':
+            if (h1 < h2)
+                h1 += 360;
+            break;
+    }
+    return [h1, h2];
+}
+/**
+ * Mix two colors in the given color space.
+ * @param color1 first color
+ * @param color2 second color
+ * @param options interpolation space, hue method and percentages
+ */
+function colorMix(color1, color2, options) {
+    const { space } = options;
+    const model = typeof space === 'string' ? (0, channels_1.colorModel)(space.toLowerCase()) : space;
+    if (model === null) {
+        fail(`unsupported color space: "${space}"`);
+    }
+    const hueIndex = model.hues.indexOf(true);
+    if (options.hue !== undefined && hueIndex === -1) {
+        fail('hue method requires a polar space');
+    }
+    const method = options.hue ?? 'shorter';
+    // Resolve percentages and the (sub-100%) alpha multiplier.
+    // https://drafts.csswg.org/css-color-5/#color-mix-percent-norm
+    const o1 = options.p1;
+    const o2 = options.p2;
+    if ((o1 !== undefined && !(o1 >= 0 && o1 <= 100)) || (o2 !== undefined && !(o2 >= 0 && o2 <= 100))) {
+        fail('percentages must be within [0%, 100%]');
+    }
+    let p1;
+    let p2;
+    let alphaMultiplier = 1;
+    if (o1 === undefined && o2 === undefined) {
+        p1 = 50;
+        p2 = 50;
+    }
+    else if (o1 === undefined) {
+        p2 = o2;
+        p1 = 100 - p2;
+    }
+    else if (o2 === undefined) {
+        p1 = o1;
+        p2 = 100 - p1;
+    }
+    else {
+        const sum = o1 + o2;
+        if (sum === 0) {
+            fail('percentages must not sum to zero');
+        }
+        if (sum < 100) {
+            alphaMultiplier = sum / 100;
+        }
+        p1 = (o1 / sum) * 100;
+        p2 = (o2 / sum) * 100;
+    }
+    const w1 = p1 / 100;
+    const w2 = p2 / 100;
+    const r1 = (0, bits_1.getRed)(color1), g1 = (0, bits_1.getGreen)(color1), b1 = (0, bits_1.getBlue)(color1);
+    const r2 = (0, bits_1.getRed)(color2), g2 = (0, bits_1.getGreen)(color2), b2 = (0, bits_1.getBlue)(color2);
+    const a1 = (0, bits_1.getAlpha)(color1) / 255;
+    const a2 = (0, bits_1.getAlpha)(color2) / 255;
+    const c1 = model.fromSrgb(r1 / 255, g1 / 255, b1 / 255, CHANNELS_1);
+    const c2 = model.fromSrgb(r2 / 255, g2 / 255, b2 / 255, CHANNELS_2);
+    const hi = hueIndex;
+    if (hi >= 0) {
+        // A powerless hue (achromatic color) is treated as missing and takes the
+        // other color's hue. https://drafts.csswg.org/css-color-4/#interpolation-missing
+        // Achromaticity is detected on the sRGB bytes (exact); the converted
+        // channels carry conversion noise (e.g. white -> lch chroma ~0.02).
+        const missing1 = r1 === g1 && g1 === b1;
+        const missing2 = r2 === g2 && g2 === b2;
+        if (missing1 && !missing2) {
+            c1[hi] = c2[hi];
+        }
+        else if (missing2 && !missing1) {
+            c2[hi] = c1[hi];
+        }
+        const [h1, h2] = adjustHue(c1[hi], c2[hi], method);
+        c1[hi] = h1;
+        c2[hi] = h2;
+    }
+    // Premultiply every non-hue coordinate by its alpha.
+    for (let i = 0; i < 3; i++) {
+        if (i !== hi) {
+            c1[i] *= a1;
+            c2[i] *= a2;
+        }
+    }
+    const mixedAlpha = a1 * w1 + a2 * w2;
+    for (let i = 0; i < 3; i++) {
+        let v = c1[i] * w1 + c2[i] * w2;
+        if (i === hi) {
+            v = normalizeHue(v);
+        }
+        else if (mixedAlpha !== 0) {
+            v /= mixedAlpha; // un-premultiply
+        }
+        c1[i] = v;
+    }
+    const alphaByte = (0, bytes_1.clampByte)(mixedAlpha * alphaMultiplier * 255);
+    return model.toColor(c1[0], c1[1], c1[2], alphaByte);
+}
+//# sourceMappingURL=color-mix.js.map

package/build/operations/color-mix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-mix.js","sourceRoot":"","sources":["../../src/operations/color-mix.ts"],"names":[],"mappings":"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"}

package/build/operations/luminance.d.ts

@@ -0,0 +1,7 @@
+import type { ColorBits } from '../core/bits';
+/**
+ * The relative brightness of any point in a color space, normalized to 0 for
+ * darkest black and 1 for lightest white.
+ * @returns The relative brightness of the color in the range 0 - 1, with 3 digits precision
+ */
+export declare function getLuminance(color: ColorBits): number;

package/build/operations/luminance.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLuminance = getLuminance;
+const bits_1 = require("../core/bits");
+/**
+ * The relative brightness of any point in a color space, normalized to 0 for
+ * darkest black and 1 for lightest white.
+ * @returns The relative brightness of the color in the range 0 - 1, with 3 digits precision
+ */
+function getLuminance(color) {
+    const r = (0, bits_1.getRed)(color) / 255;
+    const g = (0, bits_1.getGreen)(color) / 255;
+    const b = (0, bits_1.getBlue)(color) / 255;
+    const apply = (v) => v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;
+    const r1 = apply(r);
+    const g1 = apply(g);
+    const b1 = apply(b);
+    return Math.round((0.2126 * r1 + 0.7152 * g1 + 0.0722 * b1) * 1000) / 1000;
+}
+//# sourceMappingURL=luminance.js.map

package/build/operations/luminance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luminance.js","sourceRoot":"","sources":["../../src/operations/luminance.ts"],"names":[],"mappings":";;AAQA,oCAYC;AAnBD,uCAAwD;AAExD;;;;GAIG;AACH,SAAgB,YAAY,CAAC,KAAgB;IAC3C,MAAM,CAAC,GAAG,IAAA,aAAM,EAAC,KAAK,CAAC,GAAG,GAAG,CAAA;IAC7B,MAAM,CAAC,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,GAAG,GAAG,CAAA;IAC/B,MAAM,CAAC,GAAG,IAAA,cAAO,EAAC,KAAK,CAAC,GAAG,GAAG,CAAA;IAE9B,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAA;IAEpF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACnB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACnB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAEnB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;AAC5E,CAAC"}

package/build/parsing/calc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Evaluate a calc() expression against channel keyword bindings.
+ * @param body the expression, with or without the outer `calc(` `)`, e.g.
+ *   "calc(l * 0.8)" or "l * 0.8"; nested calc() is supported
+ * @param scope channel keyword bindings
+ * @param range percentage reference for the destination channel
+ */
+export declare function evaluateCalc(body: string, scope: Map<string, number>, range: number): number;

package/build/parsing/calc.js

@@ -0,0 +1,205 @@
+"use strict";
+// Minimal CSS calc() evaluator for relative-color channel expressions, e.g.
+// `calc(l * 0.8)`, `calc(h + 120)`, `calc((r + g) / 2)`. Supports + - * /, unary
+// +/-, parentheses, nested calc(), numbers, percentages and angle dimensions.
+//
+// Identifiers are channel keywords resolved from `scope` (e.g. r, g, b, l, h,
+// alpha). Percentages resolve against `range` — the destination channel's
+// reference (e.g. 255 for rgb, 1 for oklab lightness) — matching how a bare
+// percentage is interpreted in that channel slot.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateCalc = evaluateCalc;
+const ZERO = 48; // '0'
+const NINE = 57; // '9'
+const DOT = 46; // '.'
+const PERCENT = 37; // '%'
+function isDigit(c) {
+    return (c >= ZERO && c <= NINE) || c === DOT;
+}
+function isAlpha(c) {
+    // a-z, A-Z (identifiers like `alpha`, channel letters, angle units)
+    return (c >= 97 && c <= 122) || (c >= 65 && c <= 90);
+}
+const ANGLE_TO_DEG = {
+    deg: 1,
+    grad: 360 / 400,
+    rad: 180 / Math.PI,
+    turn: 360,
+};
+/** A complete CSS <number>: the lexer's digit scan can overshoot (e.g. "1.2.3", "2e"). */
+const NUMBER = /^(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i;
+function fail(message, input) {
+    throw new Error(`calc(): ${message} in "${input}"`);
+}
+function lex(input, range) {
+    const tokens = [];
+    let i = 0;
+    const n = input.length;
+    while (i < n) {
+        const c = input.charCodeAt(i);
+        if (c === 32 || c === 9 || c === 10 || c === 13) { // whitespace
+            i++;
+            continue;
+        }
+        if (c === 40) {
+            tokens.push({ t: 'lparen' });
+            i++;
+            continue;
+        }
+        if (c === 41) {
+            tokens.push({ t: 'rparen' });
+            i++;
+            continue;
+        }
+        if (c === 43 || c === 45 || c === 42 || c === 47) { // + - * /
+            tokens.push({ t: 'op', v: input[i] });
+            i++;
+            continue;
+        }
+        if (isDigit(c)) {
+            let j = i + 1;
+            while (j < n && isDigit(input.charCodeAt(j)))
+                j++;
+            // scientific notation (e.g. 1e-3)
+            if (j < n && (input.charCodeAt(j) === 101 || input.charCodeAt(j) === 69)) {
+                j++;
+                if (j < n && (input.charCodeAt(j) === 43 || input.charCodeAt(j) === 45))
+                    j++;
+                while (j < n && isDigit(input.charCodeAt(j)))
+                    j++;
+            }
+            const raw = input.slice(i, j);
+            if (!NUMBER.test(raw)) {
+                fail(`invalid number "${raw}"`, input);
+            }
+            let value = parseFloat(raw);
+            i = j;
+            // trailing unit: % or angle
+            if (i < n && input.charCodeAt(i) === PERCENT) {
+                value = (value / 100) * range;
+                i++;
+            }
+            else {
+                let u = i;
+                while (u < n && isAlpha(input.charCodeAt(u)))
+                    u++;
+                if (u > i) {
+                    const unit = input.slice(i, u).toLowerCase();
+                    const factor = ANGLE_TO_DEG[unit];
+                    if (factor !== undefined) {
+                        value *= factor;
+                        i = u;
+                    }
+                }
+            }
+            tokens.push({ t: 'num', v: value });
+            continue;
+        }
+        if (isAlpha(c)) {
+            let j = i + 1;
+            while (j < n && isAlpha(input.charCodeAt(j)))
+                j++;
+            const id = input.slice(i, j).toLowerCase();
+            i = j;
+            // `calc(` (outer and nested) reads as a plain parenthesis
+            if (id === 'calc' && i < n && input.charCodeAt(i) === 40) {
+                continue;
+            }
+            tokens.push({ t: 'id', v: id });
+            continue;
+        }
+        fail(`unexpected character "${input[i]}"`, input);
+    }
+    return tokens;
+}
+/**
+ * Evaluate a calc() expression against channel keyword bindings.
+ * @param body the expression, with or without the outer `calc(` `)`, e.g.
+ *   "calc(l * 0.8)" or "l * 0.8"; nested calc() is supported
+ * @param scope channel keyword bindings
+ * @param range percentage reference for the destination channel
+ */
+function evaluateCalc(body, scope, range) {
+    const tokens = lex(body, range);
+    let pos = 0;
+    const peek = () => tokens[pos];
+    const next = () => tokens[pos++];
+    function parseExpr() {
+        let value = parseTerm();
+        for (;;) {
+            const tok = peek();
+            if (tok && tok.t === 'op' && (tok.v === '+' || tok.v === '-')) {
+                next();
+                const rhs = parseTerm();
+                value = tok.v === '+' ? value + rhs : value - rhs;
+            }
+            else {
+                return value;
+            }
+        }
+    }
+    function parseTerm() {
+        let value = parseFactor();
+        for (;;) {
+            const tok = peek();
+            if (tok && tok.t === 'op' && (tok.v === '*' || tok.v === '/')) {
+                next();
+                const rhs = parseFactor();
+                value = tok.v === '*' ? value * rhs : value / rhs;
+            }
+            else {
+                return value;
+            }
+        }
+    }
+    function parseFactor() {
+        const tok = next();
+        if (!tok) {
+            fail('unexpected end of expression', body);
+        }
+        switch (tok.t) {
+            case 'num':
+                return tok.v;
+            case 'id': {
+                // constants and channel keywords
+                if (tok.v === 'pi')
+                    return Math.PI;
+                if (tok.v === 'e')
+                    return Math.E;
+                if (tok.v === 'infinity')
+                    return Infinity;
+                if (tok.v === 'nan')
+                    return NaN;
+                if (tok.v === 'none')
+                    return 0;
+                const bound = scope.get(tok.v);
+                if (bound === undefined) {
+                    fail(`unknown identifier "${tok.v}"`, body);
+                }
+                return bound;
+            }
+            case 'op':
+                if (tok.v === '-')
+                    return -parseFactor();
+                if (tok.v === '+')
+                    return parseFactor();
+                fail(`unexpected "${tok.v}"`, body);
+            case 'lparen': {
+                const value = parseExpr();
+                const close = next();
+                if (!close || close.t !== 'rparen') {
+                    fail('expected ")"', body);
+                }
+                return value;
+            }
+            default:
+                fail('unexpected token', body);
+        }
+    }
+    const result = parseExpr();
+    if (pos !== tokens.length) {
+        fail('trailing tokens', body);
+    }
+    return result;
+}
+//# sourceMappingURL=calc.js.map

package/build/parsing/calc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calc.js","sourceRoot":"","sources":["../../src/parsing/calc.ts"],"names":[],"mappings":"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"}

package/build/parsing/color-mix.d.ts

@@ -0,0 +1,8 @@
+import type { ColorBits } from '../core/bits';
+import type { Tokens } from './tokenizer';
+/**
+ * Resolve a color-mix() from its tokenized form.
+ * @param tokens tokenized `color-mix(...)`
+ * @param parseColor parser for the two color arguments (recursive)
+ */
+export declare function resolveColorMix(tokens: Tokens, parseColor: (input: string) => ColorBits): ColorBits;

package/build/parsing/color-mix.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveColorMix = resolveColorMix;
+const channels_1 = require("../conversion/channels");
+const color_mix_1 = require("../operations/color-mix");
+const PERCENT = 37; // '%'
+function fail(message) {
+    throw new Error('color-mix(): ' + message);
+}
+/** Parse one `<color> [<percentage>]` (order-independent) color-mix argument. */
+function parseColorArg(group, parseColor) {
+    let colorToken;
+    let p;
+    for (const token of group) {
+        if (token.charCodeAt(token.length - 1) === PERCENT) {
+            if (p !== undefined) {
+                fail(`unexpected "${token}"`);
+            }
+            p = parseFloat(token);
+        }
+        else {
+            if (colorToken !== undefined) {
+                fail(`unexpected "${token}"`);
+            }
+            colorToken = token;
+        }
+    }
+    if (colorToken === undefined) {
+        fail('missing color');
+    }
+    return { color: parseColor(colorToken), p };
+}
+/**
+ * Resolve a color-mix() from its tokenized form.
+ * @param tokens tokenized `color-mix(...)`
+ * @param parseColor parser for the two color arguments (recursive)
+ */
+function resolveColorMix(tokens, parseColor) {
+    const groups = [[]];
+    for (const token of tokens.tokens) {
+        if (token === ',') {
+            groups.push([]);
+        }
+        else {
+            groups[groups.length - 1].push(token);
+        }
+    }
+    if (groups.length !== 3) {
+        fail('expected "in <space>, <color>, <color>"');
+    }
+    const inClause = groups[0].map((token) => token.toLowerCase());
+    if (inClause[0] !== 'in' || inClause[1] === undefined) {
+        fail('expected "in <space>, <color>, <color>"');
+    }
+    const space = inClause[1];
+    let hue;
+    if (inClause.length !== 2) {
+        const method = inClause[2];
+        if (inClause.length !== 4 || inClause[3] !== 'hue' ||
+            (method !== 'shorter' && method !== 'longer' && method !== 'increasing' && method !== 'decreasing')) {
+            fail(`invalid interpolation: "${groups[0].join(' ')}"`);
+        }
+        hue = method;
+    }
+    const arg1 = parseColorArg(groups[1], parseColor);
+    const arg2 = parseColorArg(groups[2], parseColor);
+    // CSS also allows predefined color() spaces, which have no named model.
+    return (0, color_mix_1.colorMix)(arg1.color, arg2.color, { space: (0, channels_1.colorSpaceModel)(space) ?? space, hue, p1: arg1.p, p2: arg2.p });
+}
+//# sourceMappingURL=color-mix.js.map

package/build/parsing/color-mix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-mix.js","sourceRoot":"","sources":["../../src/parsing/color-mix.ts"],"names":[],"mappings":"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"}

package/build/parsing/css.d.ts

@@ -0,0 +1,23 @@
+import { ColorBits } from '../core/bits';
+export { colorMix } from '../operations/color-mix';
+export type { HueMethod, ColorMixOptions } from '../operations/color-mix';
+export { colorModel, colorSpaceModel } from '../conversion/channels';
+export type { ColorModel } from '../conversion/channels';
+export { resolveNamed, namedColors } from './named-colors';
+/**
+ * Resolves a color keyword that has no fixed value — `currentColor` and system
+ * colors (e.g. `Canvas`, `ButtonText`). Return ColorBits, a CSS color string, or
+ * null if unresolved. In the browser this is typically backed by
+ * `getComputedStyle`.
+ */
+export type ColorResolver = (name: string) => ColorBits | string | null;
+export interface ParseCSSOptions {
+    resolve?: ColorResolver;
+}
+/**
+ * Parse any CSS Color Module 4/5 color: hex, named colors, rgb()/hsl()/hwb()/
+ * lab()/lch()/oklab()/oklch()/color(), their relative `from …` forms, calc()
+ * channels, and color-mix(). For `currentColor`/system colors, pass
+ * `options.resolve`.
+ */
+export declare function parseCSS(input: string, options?: ParseCSSOptions): ColorBits;