ggaction 0.0.17 → 0.0.19

package/src/grammar/scales/color.js

@@ -1,382 +1 @@
-import { cloneAndFreeze, isPlainObject } from "../../core/immutable.js";
-import { validateGeneratedItemLimit } from "../../core/validation.js";
-import {
-  normalizePalette,
-  resolveContinuousPalette
-} from "../palettes.js";
-import { inverseLerp } from "../numeric.js";
-
-export const CONTINUOUS_COLOR_INTERPOLATIONS = cloneAndFreeze([
-  "rgb",
-  "hsl",
-  "hsl-long",
-  "lab",
-  "hcl",
-  "hcl-long",
-  "cubehelix",
-  "cubehelix-long"
-]);
-
-const BASIC_COLORS = Object.freeze({
-  black: "#000000",
-  blue: "#0000ff",
-  cyan: "#00ffff",
-  gray: "#808080",
-  green: "#008000",
-  grey: "#808080",
-  magenta: "#ff00ff",
-  navy: "#000080",
-  orange: "#ffa500",
-  purple: "#800080",
-  red: "#ff0000",
-  teal: "#008080",
-  white: "#ffffff",
-  yellow: "#ffff00"
-});
-
-function clamp(value, minimum = 0, maximum = 1) {
-  return Math.max(minimum, Math.min(maximum, value));
-}
-
-function hue(value) {
-  return ((value % 360) + 360) % 360;
-}
-
-function hslToRgb({ h, s, l }) {
-  const chroma = (1 - Math.abs(2 * l - 1)) * s;
-  const segment = hue(h) / 60;
-  const second = chroma * (1 - Math.abs(segment % 2 - 1));
-  const [red, green, blue] = segment < 1 ? [chroma, second, 0]
-    : segment < 2 ? [second, chroma, 0]
-      : segment < 3 ? [0, chroma, second]
-        : segment < 4 ? [0, second, chroma]
-          : segment < 5 ? [second, 0, chroma]
-            : [chroma, 0, second];
-  const match = l - chroma / 2;
-  return { r: red + match, g: green + match, b: blue + match };
-}
-
-function parseColor(value) {
-  if (typeof value !== "string" || value.length === 0) {
-    throw new TypeError("Continuous color range requires non-empty color strings.");
-  }
-  const normalized = BASIC_COLORS[value.toLowerCase()] ?? value.toLowerCase();
-  let match = normalized.match(/^#([0-9a-f]{3})$/i);
-  if (match) {
-    return Object.fromEntries(["r", "g", "b"].map((channel, index) => [
-      channel,
-      Number.parseInt(match[1][index].repeat(2), 16) / 255
-    ]));
-  }
-  match = normalized.match(/^#([0-9a-f]{6})$/i);
-  if (match) {
-    return {
-      r: Number.parseInt(match[1].slice(0, 2), 16) / 255,
-      g: Number.parseInt(match[1].slice(2, 4), 16) / 255,
-      b: Number.parseInt(match[1].slice(4, 6), 16) / 255
-    };
-  }
-  match = normalized.match(
-    /^rgb\(\s*([\d.]+)%?\s*,\s*([\d.]+)%?\s*,\s*([\d.]+)%?\s*\)$/
-  );
-  if (match) {
-    const percentage = normalized.includes("%");
-    const divisor = percentage ? 100 : 255;
-    const channels = match.slice(1).map(item => Number(item) / divisor);
-    if (channels.every(item => Number.isFinite(item) && item >= 0 && item <= 1)) {
-      return { r: channels[0], g: channels[1], b: channels[2] };
-    }
-  }
-  match = normalized.match(
-    /^hsl\(\s*([-\d.]+)\s*,\s*([\d.]+)%\s*,\s*([\d.]+)%\s*\)$/
-  );
-  if (match) {
-    const h = Number(match[1]);
-    const s = Number(match[2]) / 100;
-    const l = Number(match[3]) / 100;
-    if ([h, s, l].every(Number.isFinite) && s >= 0 && s <= 1 && l >= 0 && l <= 1) {
-      return hslToRgb({ h, s, l });
-    }
-  }
-  throw new Error(`Unsupported continuous color "${value}".`);
-}
-
-function rgbToHex({ r, g, b }) {
-  return `#${[r, g, b].map(channel =>
-    Math.round(clamp(channel) * 255).toString(16).padStart(2, "0")
-  ).join("")}`;
-}
-
-function byteChannels({ r, g, b }) {
-  return [r, g, b].map(channel => Math.round(channel * 255));
-}
-
-function rgbToHsl({ r, g, b }) {
-  const maximum = Math.max(r, g, b);
-  const minimum = Math.min(r, g, b);
-  const delta = maximum - minimum;
-  const l = (maximum + minimum) / 2;
-  if (delta === 0) return { h: 0, s: 0, l };
-  const s = delta / (1 - Math.abs(2 * l - 1));
-  const raw = maximum === r
-    ? ((g - b) / delta) % 6
-    : maximum === g
-      ? (b - r) / delta + 2
-      : (r - g) / delta + 4;
-  return { h: hue(raw * 60), s, l };
-}
-
-function linearRgb(channel) {
-  return channel <= 0.04045
-    ? channel / 12.92
-    : ((channel + 0.055) / 1.055) ** 2.4;
-}
-
-function encodedRgb(channel) {
-  return channel <= 0.0031308
-    ? 12.92 * channel
-    : 1.055 * channel ** (1 / 2.4) - 0.055;
-}
-
-function rgbToLab(color) {
-  const r = linearRgb(color.r);
-  const g = linearRgb(color.g);
-  const b = linearRgb(color.b);
-  const x = (0.4124564 * r + 0.3575761 * g + 0.1804375 * b) / 0.95047;
-  const y = 0.2126729 * r + 0.7151522 * g + 0.072175 * b;
-  const z = (0.0193339 * r + 0.119192 * g + 0.9503041 * b) / 1.08883;
-  const convert = value => value > 216 / 24389
-    ? Math.cbrt(value)
-    : 841 / 108 * value + 4 / 29;
-  const fx = convert(x);
-  const fy = convert(y);
-  const fz = convert(z);
-  return { l: 116 * fy - 16, a: 500 * (fx - fy), b: 200 * (fy - fz) };
-}
-
-function labToRgb({ l, a, b }) {
-  const fy = (l + 16) / 116;
-  const fx = fy + a / 500;
-  const fz = fy - b / 200;
-  const convert = value => value ** 3 > 216 / 24389
-    ? value ** 3
-    : 108 / 841 * (value - 4 / 29);
-  const x = 0.95047 * convert(fx);
-  const y = convert(fy);
-  const z = 1.08883 * convert(fz);
-  return {
-    r: encodedRgb(3.2404542 * x - 1.5371385 * y - 0.4985314 * z),
-    g: encodedRgb(-0.969266 * x + 1.8760108 * y + 0.041556 * z),
-    b: encodedRgb(0.0556434 * x - 0.2040259 * y + 1.0572252 * z)
-  };
-}
-
-function labToHcl({ l, a, b }) {
-  return { h: hue(Math.atan2(b, a) * 180 / Math.PI), c: Math.hypot(a, b), l };
-}
-
-function hclToLab({ h, c, l }) {
-  const radians = h * Math.PI / 180;
-  return { l, a: Math.cos(radians) * c, b: Math.sin(radians) * c };
-}
-
-function rgbToCubehelix({ r, g, b }) {
-  const A = -0.14861;
-  const B = 1.78277;
-  const C = -0.29227;
-  const D = -0.90649;
-  const E = 1.97294;
-  const ED = E * D;
-  const EB = E * B;
-  const BC_DA = B * C - D * A;
-  const l = (BC_DA * b + ED * r - EB * g) / (BC_DA + ED - EB);
-  const blue = b - l;
-  const k = (E * (g - l) - C * blue) / D;
-  const denominator = E * l * (1 - l);
-  return {
-    h: hue(Math.atan2(k, blue) * 180 / Math.PI - 120),
-    s: denominator === 0 ? 0 : Math.hypot(k, blue) / denominator,
-    l
-  };
-}
-
-function cubehelixToRgb({ h, s, l }) {
-  const angle = (h + 120) * Math.PI / 180;
-  const amplitude = s * l * (1 - l);
-  const cosine = Math.cos(angle);
-  const sine = Math.sin(angle);
-  return {
-    r: l + amplitude * (-0.14861 * cosine + 1.78277 * sine),
-    g: l + amplitude * (-0.29227 * cosine - 0.90649 * sine),
-    b: l + amplitude * (1.97294 * cosine)
-  };
-}
-
-function interpolateHue(left, right, amount, long) {
-  let delta = right - left;
-  if (!long) delta = ((delta + 540) % 360) - 180;
-  return hue(left + delta * amount);
-}
-
-function mix(left, right, amount, method) {
-  if (method.startsWith("hsl")) {
-    const a = rgbToHsl(left);
-    const b = rgbToHsl(right);
-    return hslToRgb({
-      h: interpolateHue(a.h, b.h, amount, method.endsWith("-long")),
-      s: a.s + (b.s - a.s) * amount,
-      l: a.l + (b.l - a.l) * amount
-    });
-  }
-  if (method === "lab") {
-    const a = rgbToLab(left);
-    const b = rgbToLab(right);
-    return labToRgb({
-      l: a.l + (b.l - a.l) * amount,
-      a: a.a + (b.a - a.a) * amount,
-      b: a.b + (b.b - a.b) * amount
-    });
-  }
-  if (method.startsWith("hcl")) {
-    const a = labToHcl(rgbToLab(left));
-    const b = labToHcl(rgbToLab(right));
-    return labToRgb(hclToLab({
-      h: interpolateHue(a.h, b.h, amount, method.endsWith("-long")),
-      c: a.c + (b.c - a.c) * amount,
-      l: a.l + (b.l - a.l) * amount
-    }));
-  }
-  const a = rgbToCubehelix(left);
-  const b = rgbToCubehelix(right);
-  return cubehelixToRgb({
-    h: interpolateHue(a.h, b.h, amount, method.endsWith("-long")),
-    s: a.s + (b.s - a.s) * amount,
-    l: a.l + (b.l - a.l) * amount
-  });
-}
-
-export function validateContinuousColorInterpolation(value) {
-  if (!CONTINUOUS_COLOR_INTERPOLATIONS.includes(value)) {
-    throw new Error(`Unsupported continuous color interpolation "${value}".`);
-  }
-  return value;
-}
-
-export function validateSequentialColorRange(value) {
-  if (value === "auto") return value;
-  if (Array.isArray(value)) {
-    validateGeneratedItemLimit(value.length, "Sequential color range length");
-    if (value.length < 2) {
-      throw new TypeError("Sequential color range requires at least two colors.");
-    }
-    value.forEach(parseColor);
-    return cloneAndFreeze(value);
-  }
-  if (
-    !isPlainObject(value) ||
-    Object.keys(value).length !== 1 ||
-    !Object.hasOwn(value, "palette")
-  ) {
-    throw new TypeError("Sequential color range requires colors or a palette descriptor.");
-  }
-  const palette = normalizePalette(value.palette);
-  if (palette.count !== undefined && palette.count < 2) {
-    throw new RangeError(
-      "Sequential palette count must be an integer of at least 2."
-    );
-  }
-  return cloneAndFreeze({ palette });
-}
-
-export function resolveSequentialColorStops(value) {
-  const range = validateSequentialColorRange(value);
-  if (range === "auto") return resolveContinuousPalette("viridis");
-  return Array.isArray(range)
-    ? cloneAndFreeze(range.map(color => rgbToHex(parseColor(color))))
-    : resolveContinuousPalette(range.palette);
-}
-
-function interpolateColors(colors, position, method, shouldClamp) {
-  const bounded = shouldClamp ? clamp(position) : position;
-  const scaled = bounded * (colors.length - 1);
-  const left = Math.max(0, Math.min(colors.length - 2, Math.floor(scaled)));
-  const right = left + 1;
-  const amount = scaled - left;
-  if (method === "rgb") {
-    const leftChannels = byteChannels(colors[left]);
-    const rightChannels = byteChannels(colors[right]);
-    return `#${leftChannels.map((channel, index) =>
-      Math.round(clamp(
-        channel + (rightChannels[index] - channel) * amount,
-        0,
-        255
-      )).toString(16).padStart(2, "0")
-    ).join("")}`;
-  }
-  return rgbToHex(mix(colors[left], colors[right], amount, method));
-}
-
-export function interpolateColorStops(stops, position, interpolation = "rgb") {
-  const method = validateContinuousColorInterpolation(interpolation);
-  if (!Array.isArray(stops) || stops.length < 2) {
-    throw new TypeError("Color interpolation requires at least two stops.");
-  }
-  const colors = stops.map(parseColor);
-  return interpolateColors(colors, position, method, true);
-}
-
-export function validateSequentialMidpoint(value, type, domain = "auto") {
-  if (value === undefined || value === "auto") return undefined;
-  if (type !== "sequential") {
-    throw new Error(`Scale type "${type}" does not support midpoint.`);
-  }
-  if (!Number.isFinite(value)) {
-    throw new TypeError("Scale midpoint must be finite or auto.");
-  }
-  if (domain !== "auto" && (
-    !Array.isArray(domain) || domain.length !== 2 || !domain.every(Number.isFinite) ||
-    !(value > Math.min(...domain) && value < Math.max(...domain))
-  )) {
-    throw new RangeError("Scale midpoint must lie strictly inside its resolved domain.");
-  }
-  return value;
-}
-
-export function mapSequentialColors(
-  values,
-  domain,
-  stops,
-  options = {}
-) {
-  const { interpolation = "rgb", clamp: shouldClamp = false } = options;
-  const hasUnknown = Object.hasOwn(options, "unknown");
-  if (!Array.isArray(domain) || domain.length !== 2 || !domain.every(Number.isFinite)) {
-    throw new TypeError("Sequential color domain must contain two finite numbers.");
-  }
-  if (!Array.isArray(values) || (!hasUnknown && !values.every(Number.isFinite))) {
-    throw new TypeError("Sequential color values must be finite numbers.");
-  }
-  if (typeof shouldClamp !== "boolean") {
-    throw new TypeError("Sequential color clamp must be a boolean.");
-  }
-  const midpoint = validateSequentialMidpoint(options.midpoint, "sequential", domain);
-  const [start, end] = domain;
-  const constant = start === end;
-  const method = validateContinuousColorInterpolation(interpolation);
-  if (!Array.isArray(stops) || stops.length < 2) {
-    throw new TypeError("Color interpolation requires at least two stops.");
-  }
-  const colors = stops.map(parseColor);
-  return cloneAndFreeze(values.map(value => {
-    if (!Number.isFinite(value)) {
-      if (hasUnknown) return options.unknown;
-      throw new TypeError("Sequential color values must be finite numbers.");
-    }
-    const raw = midpoint === undefined
-      ? constant ? 0.5 : inverseLerp(value, start, end)
-      : (end > start ? value <= midpoint : value >= midpoint)
-        ? inverseLerp(value, start, midpoint) / 2
-        : 0.5 + inverseLerp(value, midpoint, end) / 2;
-    return interpolateColors(colors, raw, method, shouldClamp);
-  }));
-}
+import{mapTransformedValues as F}from"./transformed.js";import{cloneAndFreeze as p,isPlainObject as j}from"../../core/immutable.js";import{validateGeneratedItemLimit as $}from"../../core/validation.js";import{normalizePalette as k,resolveContinuousPalette as S}from"../palettes.js";import{inverseLerp as C}from"../numeric.js";const B=p(["rgb","hsl","hsl-long","lab","hcl","hcl-long","cubehelix","cubehelix-long"]),D=Object.freeze({black:"#000000",blue:"#0000ff",cyan:"#00ffff",gray:"#808080",green:"#008000",grey:"#808080",magenta:"#ff00ff",navy:"#000080",orange:"#ffa500",purple:"#800080",red:"#ff0000",teal:"#008080",white:"#ffffff",yellow:"#ffff00"});function E(t,e=0,n=1){return Math.max(e,Math.min(n,t))}function d(t){return(t%360+360)%360}function q({h:t,s:e,l:n}){const r=(1-Math.abs(2*n-1))*e,o=d(t)/60,i=r*(1-Math.abs(o%2-1)),[a,u,l]=o<1?[r,i,0]:o<2?[i,r,0]:o<3?[0,r,i]:o<4?[0,i,r]:o<5?[i,0,r]:[r,0,i],s=n-r/2;return{r:a+s,g:u+s,b:l+s}}function w(t){if(typeof t!="string"||t.length===0)throw new TypeError("Continuous color range requires non-empty color strings.");const e=D[t.toLowerCase()]??t.toLowerCase();let n=e.match(/^#([0-9a-f]{3})$/i);if(n)return Object.fromEntries(["r","g","b"].map((r,o)=>[r,Number.parseInt(n[1][o].repeat(2),16)/255]));if(n=e.match(/^#([0-9a-f]{6})$/i),n)return{r:Number.parseInt(n[1].slice(0,2),16)/255,g:Number.parseInt(n[1].slice(2,4),16)/255,b:Number.parseInt(n[1].slice(4,6),16)/255};if(n=e.match(/^rgb\(\s*([\d.]+)%?\s*,\s*([\d.]+)%?\s*,\s*([\d.]+)%?\s*\)$/),n){const o=e.includes("%")?100:255,i=n.slice(1).map(a=>Number(a)/o);if(i.every(a=>Number.isFinite(a)&&a>=0&&a<=1))return{r:i[0],g:i[1],b:i[2]}}if(n=e.match(/^hsl\(\s*([-\d.]+)\s*,\s*([\d.]+)%\s*,\s*([\d.]+)%\s*\)$/),n){const r=Number(n[1]),o=Number(n[2])/100,i=Number(n[3])/100;if([r,o,i].every(Number.isFinite)&&o>=0&&o<=1&&i>=0&&i<=1)return q({h:r,s:o,l:i})}throw new Error(`Unsupported continuous color "${t}".`)}function N({r:t,g:e,b:n}){return`#${[t,e,n].map(r=>Math.round(E(r)*255).toString(16).padStart(2,"0")).join("")}`}function T({r:t,g:e,b:n}){return[t,e,n].map(r=>Math.round(r*255))}function A({r:t,g:e,b:n}){const r=Math.max(t,e,n),o=Math.min(t,e,n),i=r-o,a=(r+o)/2;if(i===0)return{h:0,s:0,l:a};const u=i/(1-Math.abs(2*a-1)),l=r===t?(e-n)/i%6:r===e?(n-t)/i+2:(t-e)/i+4;return{h:d(l*60),s:u,l:a}}function x(t){return t<=.04045?t/12.92:((t+.055)/1.055)**2.4}function m(t){return t<=.0031308?12.92*t:1.055*t**(1/2.4)-.055}function y(t,e="d65"){const n=x(t.r),r=x(t.g),o=x(t.b),i=e==="d50"?(.4360747*n+.3850649*r+.1430804*o)/.96422:(.4124564*n+.3575761*r+.1804375*o)/.95047,a=e==="d50"?.2225045*n+.7168786*r+.0606169*o:.2126729*n+.7151522*r+.072175*o,u=e==="d50"?(.0139322*n+.0971045*r+.7141733*o)/.82521:(.0193339*n+.119192*r+.9503041*o)/1.08883,l=b=>b>216/24389?Math.cbrt(b):841/108*b+4/29,s=l(i),c=l(a),f=l(u);return{l:116*c-16,a:500*(s-c),b:200*(c-f)}}function O({l:t,a:e,b:n},r="d65"){const o=(t+16)/116,i=o+e/500,a=o-n/200,u=f=>f**3>216/24389?f**3:108/841*(f-4/29),l=(r==="d50"?.96422:.95047)*u(i),s=u(o),c=(r==="d50"?.82521:1.08883)*u(a);return r==="d50"?{r:m(3.1338561*l-1.6168667*s-.4906146*c),g:m(-.9787684*l+1.9161415*s+.033454*c),b:m(.0719453*l-.2289914*s+1.4052427*c)}:{r:m(3.2404542*l-1.5371385*s-.4985314*c),g:m(-.969266*l+1.8760108*s+.041556*c),b:m(.0556434*l-.2040259*s+1.0572252*c)}}function I({l:t,a:e,b:n}){return{h:d(Math.atan2(n,e)*180/Math.PI),c:Math.hypot(e,n),l:t}}function H({h:t,c:e,l:n}){const r=t*Math.PI/180;return{l:n,a:Math.cos(r)*e,b:Math.sin(r)*e}}function R({r:t,g:e,b:n}){const l=-1.7884503806,s=1.97294*1.78277,c=1.78277*-.29227- -.90649*-.14861,f=(c*n+l*t-s*e)/(c+l-s),b=n-f,h=(1.97294*(e-f)- -.29227*b)/-.90649,g=1.97294*f*(1-f);return{h:d(Math.atan2(h,b)*180/Math.PI-120),s:g===0?0:Math.hypot(h,b)/g,l:f}}function U({h:t,s:e,l:n}){const r=(t+120)*Math.PI/180,o=e*n*(1-n),i=Math.cos(r),a=Math.sin(r);return{r:n+o*(-.14861*i+1.78277*a),g:n+o*(-.29227*i-.90649*a),b:n+o*(1.97294*i)}}function M(t,e,n,r){let o=e-t;return r||(o=(o+540)%360-180),d(t+o*n)}function W(t,e,n,r,o){const i=o.whitePoint??"d65";if(r.startsWith("hsl")){const s=A(t),c=A(e);return q({h:M(s.h,c.h,n,r.endsWith("-long")),s:s.s+(c.s-s.s)*n,l:s.l+(c.l-s.l)*n})}if(r==="lab"){const s=y(t,i),c=y(e,i);return O({l:s.l+(c.l-s.l)*n,a:s.a+(c.a-s.a)*n,b:s.b+(c.b-s.b)*n},i)}if(r.startsWith("hcl")){const s=I(y(t,i)),c=I(y(e,i));return O(H({h:M(s.h,c.h,n,r.endsWith("-long")),c:s.c+(c.c-s.c)*n,l:s.l+(c.l-s.l)*n}),i)}const a=R(t),u=R(e),l=n**(o.gamma??1);if(!Number.isFinite(l))throw new RangeError("Continuous cubehelix gamma produced a nonfinite interpolation.");return U({h:M(a.h,u.h,n,r.endsWith("-long")),s:a.s+(u.s-a.s)*n,l:a.l+(u.l-a.l)*l})}function P(t){if(!B.includes(t))throw new Error(`Unsupported continuous color interpolation "${t}".`);return t}function _(t,e={}){const n={};if(e.whitePoint!==void 0){if(!["lab","hcl","hcl-long"].includes(t))throw new Error("Scale whitePoint requires Lab or HCL interpolation.");if(!["d65","d50"].includes(e.whitePoint))throw new Error("Scale whitePoint must be d65 or d50.");n.whitePoint=e.whitePoint}if(e.gamma!==void 0){if(!["cubehelix","cubehelix-long"].includes(t))throw new Error("Scale gamma requires cubehelix interpolation.");if(!Number.isFinite(e.gamma)||e.gamma<=0)throw new RangeError("Scale gamma must be a positive finite number.");n.gamma=e.gamma}return n}function G(t){if(t==="auto")return t;if(Array.isArray(t)){if($(t.length,"Sequential color range length"),t.length<2)throw new TypeError("Sequential color range requires at least two colors.");return t.forEach(w),p(t)}if(!j(t)||Object.keys(t).length!==1||!Object.hasOwn(t,"palette"))throw new TypeError("Sequential color range requires colors or a palette descriptor.");const e=k(t.palette);if(e.count!==void 0&&e.count<2)throw new RangeError("Sequential palette count must be an integer of at least 2.");return p({palette:e})}function Z(t){const e=G(t);return e==="auto"?S("viridis"):Array.isArray(e)?p(e.map(n=>N(w(n)))):S(e.palette)}function L(t,e,n,r,o={}){const a=(r?E(e):e)*(t.length-1),u=Math.max(0,Math.min(t.length-2,Math.floor(a))),l=u+1,s=a-u;if(n==="rgb"){const c=T(t[u]),f=T(t[l]);return`#${c.map((b,h)=>Math.round(E(b+(f[h]-b)*s,0,255)).toString(16).padStart(2,"0")).join("")}`}return N(W(t[u],t[l],s,n,o))}function v(t,e,n="rgb"){const r=P(n);if(!Array.isArray(t)||t.length<2)throw new TypeError("Color interpolation requires at least two stops.");const o=t.map(w);return L(o,e,r,!0)}function z(t,e,n="auto"){if(!(t===void 0||t==="auto")){if(e!=="sequential")throw new Error(`Scale type "${e}" does not support midpoint.`);if(!Number.isFinite(t))throw new TypeError("Scale midpoint must be finite or auto.");if(n!=="auto"&&(!Array.isArray(n)||n.length!==2||!n.every(Number.isFinite)||!(t>Math.min(...n)&&t<Math.max(...n))))throw new RangeError("Scale midpoint must lie strictly inside its resolved domain.");return t}}function V(t,e,n,r={}){const{interpolation:o="rgb",clamp:i=!1}=r;if(_(o,r),["log","pow","sqrt","symlog"].includes(r.type)){z(r.midpoint,r.type,e);const h=F(t,e,[0,1],{type:r.type,clamp:i,...r.type==="log"?{base:r.base}:{},...r.type==="pow"?{exponent:r.exponent}:{},...r.type==="symlog"?{constant:r.constant}:{},...Object.hasOwn(r,"unknown")?{unknown:NaN}:{}});return V(h,[0,1],n,{...r,type:"sequential"})}const a=Object.hasOwn(r,"unknown");if(!Array.isArray(e)||e.length!==2||!e.every(Number.isFinite))throw new TypeError("Sequential color domain must contain two finite numbers.");if(!Array.isArray(t)||!a&&!t.every(Number.isFinite))throw new TypeError("Sequential color values must be finite numbers.");if(typeof i!="boolean")throw new TypeError("Sequential color clamp must be a boolean.");const u=z(r.midpoint,"sequential",e),[l,s]=e,c=l===s,f=P(o);if(!Array.isArray(n)||n.length<2)throw new TypeError("Color interpolation requires at least two stops.");const b=n.map(w);return p(t.map(h=>{if(!Number.isFinite(h)){if(a)return r.unknown;throw new TypeError("Sequential color values must be finite numbers.")}const g=u===void 0?c?.5:C(h,l,s):(s>l?h<=u:h>=u)?C(h,l,u)/2:.5+C(h,u,s)/2;return L(b,g,f,i,r)}))}export{B as CONTINUOUS_COLOR_INTERPOLATIONS,v as interpolateColorStops,V as mapSequentialColors,_ as normalizeColorInterpolationOptions,Z as resolveSequentialColorStops,P as validateContinuousColorInterpolation,G as validateSequentialColorRange,z as validateSequentialMidpoint};

package/src/grammar/scales/colorConsumers.js

@@ -7,6 +7,9 @@ export function validateContinuousColorConsumer(layer, encoding, scale, {
   channel = "color"
 } = {}) {
   const kind = layer.mark?.type;
+  if (["log", "pow", "sqrt", "symlog"].includes(scale.type) && encoding.fieldType !== "quantitative") {
+    throw new Error(`Scale type "${scale.type}" requires quantitative color.`);
+  }
   if (channel === "stroke") {
     if (!["point", "line", "area", "bar", "rect", "arc", "rule", "tick"].includes(kind)) {
       throw new Error("Continuous stroke requires a supported graphical mark consumer.");
@@ -23,8 +26,8 @@ export function validateContinuousColorConsumer(layer, encoding, scale, {
     }
     return undefined;
   }
-  if (!["point", "bar", "rect"].includes(kind)) {
-    throw new Error("Continuous color requires a Point, aggregate Bar, or Rect consumer.");
+  if (!["point", "bar", "rect", "text"].includes(kind)) {
+    throw new Error("Continuous color requires a Point, aggregate Bar, Rect, or Text consumer.");
   }
   if (!["quantitative", "temporal"].includes(encoding.fieldType) ||
     (isDiscretizedColorScaleType(scale.type) && encoding.fieldType !== "quantitative")) {

package/src/grammar/scales/definition.js

@@ -1,197 +1 @@
-import { validateMeasuredRadiusScale } from "./radial.js";
-import { validateContinuousColorInterpolation, validateSequentialMidpoint } from "./color.js";
-import { isTransformedScaleType } from "./mapping.js";
-import {
-  normalizeTransformParameters,
-  validateTransformedDomain
-} from "./transformed.js";
-import {
-  isContinuousColorScaleType,
-  validateScalePropertyForType
-} from "./types.js";
-
-const BOOLEAN_PROPERTIES = Object.freeze([
-  "nice", "zero", "clamp", "reverse"
-]);
-const TYPE_PARAMETERS = Object.freeze(["base", "exponent", "constant"]);
-
-function retainedValue(previous, patch, defaults, property, typeChanged) {
-  if (Object.hasOwn(patch, property)) return patch[property];
-  if (!typeChanged && Object.hasOwn(previous, property)) {
-    return previous[property];
-  }
-  return defaults[property];
-}
-
-function validateBandParameters(definition, previous, patch, defaults, typeChanged) {
-  const hasPadding = Object.hasOwn(patch, "padding");
-  if (
-    hasPadding &&
-    (Object.hasOwn(patch, "paddingInner") || Object.hasOwn(patch, "paddingOuter"))
-  ) {
-    throw new Error(
-      "Scale padding cannot be combined with paddingInner or paddingOuter."
-    );
-  }
-  if (
-    hasPadding &&
-    (!Number.isFinite(patch.padding) || patch.padding < 0 || patch.padding >= 1)
-  ) {
-    throw new RangeError(
-      "Scale padding must be from 0 (inclusive) to 1 (exclusive)."
-    );
-  }
-  const normalizedPatch = hasPadding
-    ? { ...patch, paddingInner: patch.padding, paddingOuter: patch.padding }
-    : patch;
-  const paddingInner = retainedValue(
-    previous, normalizedPatch, defaults, "paddingInner", typeChanged
-  ) ?? 0;
-  const paddingOuter = retainedValue(
-    previous, normalizedPatch, defaults, "paddingOuter", typeChanged
-  ) ?? 0;
-  const align = retainedValue(
-    previous, normalizedPatch, defaults, "align", typeChanged
-  ) ?? 0.5;
-  if (!Number.isFinite(paddingInner) || paddingInner < 0 || paddingInner >= 1) {
-    throw new RangeError(
-      "Scale paddingInner must be from 0 (inclusive) to 1 (exclusive)."
-    );
-  }
-  if (!Number.isFinite(paddingOuter) || paddingOuter < 0) {
-    throw new RangeError("Scale paddingOuter must be non-negative and finite.");
-  }
-  if (!Number.isFinite(align) || align < 0 || align > 1) {
-    throw new RangeError("Scale align must be between 0 and 1.");
-  }
-  Object.assign(definition, { paddingInner, paddingOuter, align });
-}
-
-function validatePointParameters(definition, previous, patch, defaults, typeChanged) {
-  const padding = retainedValue(
-    previous, patch, defaults, "padding", typeChanged
-  ) ?? 0.5;
-  const align = retainedValue(previous, patch, defaults, "align", typeChanged) ?? 0.5;
-  if (!Number.isFinite(padding) || padding < 0) {
-    throw new RangeError("Scale padding must be non-negative and finite.");
-  }
-  if (!Number.isFinite(align) || align < 0 || align > 1) {
-    throw new RangeError("Scale align must be between 0 and 1.");
-  }
-  Object.assign(definition, { padding, align });
-}
-
-export function normalizeScaleDefinition({
-  type,
-  previous = {},
-  patch = {},
-  defaults = {},
-  retainCoreOnTypeChange = false,
-  retainCompatibleOnTypeChange = false,
-  allowOrdinalBandParameters = false,
-  validateDomain,
-  validateRange
-}) {
-  const typeChanged = previous.type !== undefined && previous.type !== type;
-  const rawDomain = Object.hasOwn(patch, "domain")
-    ? patch.domain
-    : (!typeChanged || retainCoreOnTypeChange) && Object.hasOwn(previous, "domain")
-      ? previous.domain
-      : defaults.domain ?? "auto";
-  const rawRange = Object.hasOwn(patch, "range")
-    ? patch.range
-    : (!typeChanged || retainCoreOnTypeChange) && Object.hasOwn(previous, "range")
-      ? previous.range
-      : defaults.range ?? "auto";
-  const definition = {
-    type,
-    domain: validateDomain(type, rawDomain),
-    range: validateRange(type, rawRange)
-  };
-  const emptyDomain = retainedValue(previous, patch, defaults, "emptyDomain", typeChanged);
-  if (emptyDomain !== undefined) {
-    if (!["preserve", "require-explicit"].includes(emptyDomain)) {
-      throw new Error('Scale emptyDomain must be "preserve" or "require-explicit".');
-    }
-    definition.emptyDomain = emptyDomain;
-  }
-
-  for (const property of BOOLEAN_PROPERTIES) {
-    let value = retainedValue(previous, patch, defaults, property, typeChanged);
-    if (
-      value === undefined &&
-      typeChanged &&
-      retainCompatibleOnTypeChange &&
-      Object.hasOwn(previous, property)
-    ) {
-      try {
-        validateScalePropertyForType(type, property);
-        value = previous[property];
-      } catch {
-        value = undefined;
-      }
-    }
-    if (value === undefined) continue;
-    if (typeof value !== "boolean") {
-      throw new TypeError(`Scale ${property} must be a boolean.`);
-    }
-    validateScalePropertyForType(type, property);
-    definition[property] = value;
-  }
-
-  const requested = Object.fromEntries(TYPE_PARAMETERS.flatMap(property => {
-    const value = retainedValue(previous, patch, defaults, property, typeChanged);
-    return value === undefined ? [] : [[property, value]];
-  }));
-  if (isTransformedScaleType(type)) {
-    const parameters = normalizeTransformParameters(type, requested);
-    if (type === "log") definition.base = parameters.base;
-    if (type === "pow") definition.exponent = parameters.exponent;
-    if (type === "symlog") definition.constant = parameters.constant;
-    if (definition.domain !== "auto") {
-      validateTransformedDomain(type, definition.domain, requested);
-    }
-  } else {
-    for (const property of Object.keys(requested)) {
-      validateScalePropertyForType(type, property);
-    }
-  }
-
-  const interpolate = retainedValue(
-    previous, patch, defaults, "interpolate", typeChanged
-  );
-  if (isContinuousColorScaleType(type)) {
-    definition.interpolate = validateContinuousColorInterpolation(
-      interpolate ?? "rgb"
-    );
-  } else if (interpolate !== undefined) {
-    throw new Error(`Scale type "${type}" does not support interpolate.`);
-  }
-
-  const midpoint = validateSequentialMidpoint(
-    retainedValue(previous, patch, defaults, "midpoint", typeChanged), type, definition.domain
-  );
-  if (midpoint !== undefined) definition.midpoint = midpoint;
-
-  if (type === "band" || (type === "ordinal" && allowOrdinalBandParameters)) {
-    validateBandParameters(definition, previous, patch, defaults, typeChanged);
-  } else if (type === "point") {
-    validatePointParameters(definition, previous, patch, defaults, typeChanged);
-  } else {
-    for (const property of ["paddingInner", "paddingOuter", "padding", "align"]) {
-      if (Object.hasOwn(patch, property)) {
-        validateScalePropertyForType(type, property);
-      }
-    }
-  }
-
-  const radialMapping = Object.hasOwn(patch, "radialMapping") ? patch.radialMapping : previous.radialMapping;
-  if (radialMapping !== undefined) {
-    definition.radialMapping = radialMapping;
-    validateMeasuredRadiusScale({ ...definition,
-      ...(Object.hasOwn(patch, "unknown") || Object.hasOwn(previous, "unknown")
-        ? { unknown: patch.unknown ?? previous.unknown } : {})
-    }, { allowAuto: true });
-  }
-  return definition;
-}
+import{validateMeasuredRadiusScale as D}from"./radial.js";import{normalizeColorInterpolationOptions as F,validateContinuousColorInterpolation as N,validateSequentialMidpoint as T}from"./color.js";import{isTransformedScaleType as k}from"./mapping.js";import{normalizeTransformParameters as q,validateTransformedDomain as A}from"./transformed.js";import{isContinuousColorScaleType as R,validateScalePropertyForType as b}from"./types.js";const p=Object.freeze(["nice","zero","clamp","reverse"]),B=Object.freeze(["base","exponent","constant"]);function f(i,l,n,e,o){return Object.hasOwn(l,e)?l[e]:!o&&Object.hasOwn(i,e)?i[e]:n[e]}function _(i,l,n,e,o){const m=Object.hasOwn(n,"padding");if(m&&(Object.hasOwn(n,"paddingInner")||Object.hasOwn(n,"paddingOuter")))throw new Error("Scale padding cannot be combined with paddingInner or paddingOuter.");if(m&&(!Number.isFinite(n.padding)||n.padding<0||n.padding>=1))throw new RangeError("Scale padding must be from 0 (inclusive) to 1 (exclusive).");const d=m?{...n,paddingInner:n.padding,paddingOuter:n.padding}:n,g=f(l,d,e,"paddingInner",o)??0,w=f(l,d,e,"paddingOuter",o)??0,c=f(l,d,e,"align",o)??.5;if(!Number.isFinite(g)||g<0||g>=1)throw new RangeError("Scale paddingInner must be from 0 (inclusive) to 1 (exclusive).");if(!Number.isFinite(w)||w<0)throw new RangeError("Scale paddingOuter must be non-negative and finite.");if(!Number.isFinite(c)||c<0||c>1)throw new RangeError("Scale align must be between 0 and 1.");Object.assign(i,{paddingInner:g,paddingOuter:w,align:c})}function $(i,l,n,e,o){const m=f(l,n,e,"padding",o)??.5,d=f(l,n,e,"align",o)??.5;if(!Number.isFinite(m)||m<0)throw new RangeError("Scale padding must be non-negative and finite.");if(!Number.isFinite(d)||d<0||d>1)throw new RangeError("Scale align must be between 0 and 1.");Object.assign(i,{padding:m,align:d})}function J({type:i,color:l=!1,previous:n={},patch:e={},defaults:o={},retainCoreOnTypeChange:m=!1,retainCompatibleOnTypeChange:d=!1,allowColorReset:g=!1,allowOrdinalBandParameters:w=!1,validateDomain:c,validateRange:I}){const s=n.type!==void 0&&n.type!==i,M=Object.hasOwn(e,"domain")?e.domain:(!s||m)&&Object.hasOwn(n,"domain")?n.domain:o.domain??"auto",x=Object.hasOwn(e,"range")?e.range:(!s||m)&&Object.hasOwn(n,"range")?n.range:o.range??"auto",r={type:i,domain:c(i,M),range:I(i,x)},u=f(n,e,o,"emptyDomain",s);if(u!==void 0){if(!["preserve","require-explicit"].includes(u))throw new Error('Scale emptyDomain must be "preserve" or "require-explicit".');r.emptyDomain=u}for(const a of p){let t=f(n,e,o,a,s);if(t===void 0&&s&&d&&Object.hasOwn(n,a))try{b(i,a),t=n[a]}catch{t=void 0}if(t!==void 0){if(typeof t!="boolean")throw new TypeError(`Scale ${a} must be a boolean.`);b(i,a),r[a]=t}}const j=Object.fromEntries(B.flatMap(a=>{const t=f(n,e,o,a,s);return t===void 0?[]:[[a,t]]}));if(k(i)){const a=q(i,j);i==="log"&&(r.base=a.base),i==="pow"&&(r.exponent=a.exponent),i==="symlog"&&(r.constant=a.constant),r.domain!=="auto"&&A(i,r.domain,j)}else for(const a of Object.keys(j))b(i,a);let O=f(n,e,o,"interpolate",s);if(i==="sequential"||l&&R(i))O===void 0&&d&&(O=n.interpolate),r.interpolate=N(O??"rgb");else if(O!==void 0)throw new Error(`Scale type "${i}" does not support interpolate.`);const z=Object.hasOwn(e,"interpolate")&&e.interpolate!==n.interpolate,S={};for(const a of["whitePoint","gamma"]){const t=Object.hasOwn(e,a)?e[a]:z?void 0:f(n,e,o,a,s&&!(d&&R(i)));t!==void 0&&!(g&&t==="auto")&&(S[a]=t)}Object.assign(r,F(r.interpolate,S));const E=T(f(n,e,o,"midpoint",s),i,r.domain);if(E!==void 0&&(r.midpoint=E),i==="band"||i==="ordinal"&&w)_(r,n,e,o,s);else if(i==="point")$(r,n,e,o,s);else for(const a of["paddingInner","paddingOuter","padding","align"])Object.hasOwn(e,a)&&b(i,a);const P=Object.hasOwn(e,"radialMapping")?e.radialMapping:n.radialMapping;return P!==void 0&&(r.radialMapping=P,D({...r,...Object.hasOwn(e,"unknown")||Object.hasOwn(n,"unknown")?{unknown:e.unknown??n.unknown}:{}},{allowAuto:!0})),r}export{J as normalizeScaleDefinition};