ggaction 0.0.17 → 0.0.19

package/src/actions/scales/definitions.js

@@ -1,425 +1 @@
-import { prepareScaleEdit } from "./editPolicy.js";
-import { validateUserId } from "../../core/identifiers.js";
-import { isPlainObject } from "../../core/immutable.js";
-import { validateKeys } from "../../core/validation.js";
-import {
-  validateColorRange,
-  validateContinuousColorInterpolation,
-  validateSequentialMidpoint,
-  validateLinearScaleType,
-  validateOpacityRange,
-  validateOrdinalDomain,
-  validateOrdinalScaleType,
-  validateScaleDomain,
-  validateScaleRange,
-  validateShapeRange,
-  validateStrokeDashRange,
-  validateStrokeWidthRange,
-  validateSequentialColorRange,
-  validateDiscretizedColorDomain,
-  validateDiscretizedColorRange,
-  validateTimeScaleType,
-  normalizeScaleDefinition,
-  SCALE_ROLES,
-  validateScalePropertyForType,
-  validateScaleTypeForRole,
-  isDiscretePositionScaleType,
-  normalizeSizeScaleDefinition,
-  withScaleUnknown
-} from "../../grammar/scales/index.js";
-import {
-  validateRadialRange,
-  validateThetaRange
-} from "../../grammar/polar.js";
-import { findSemanticScale } from "../../selectors/scales.js";
-import { normalizeOffsetScalePolicy } from "../../grammar/bars/geometry.js";
-import { resolveRequestedOffsetPolicy } from
-  "../../materialization/scales/policies/offset.js";
-import { findScaleConsumers } from "./consumers/index.js";
-
-const BASE_OPTIONS = ["id", "type", "domain", "range", "emptyDomain"];
-const UNKNOWN_OPTIONS = [...BASE_OPTIONS, "unknown"];
-const CLAMP_REVERSE = ["clamp", "reverse"];
-const BOOLEAN_OPTIONS = ["nice", "zero", ...CLAMP_REVERSE];
-const TRANSFORM_OPTIONS = ["base", "exponent", "constant"];
-const POSITION_OPTIONS = [
-  ...BASE_OPTIONS,
-  ...BOOLEAN_OPTIONS,
-  ...TRANSFORM_OPTIONS,
-  "paddingInner",
-  "paddingOuter",
-  "padding",
-  "align",
-  "unknown"
-];
-const COLOR_OPTIONS = [...BASE_OPTIONS, "palette", "unknown"];
-const SEQUENTIAL_COLOR_OPTIONS = [
-  ...COLOR_OPTIONS,
-  "interpolate", "midpoint",
-  ...CLAMP_REVERSE
-];
-const OPACITY_OPTIONS = [...BASE_OPTIONS, ...BOOLEAN_OPTIONS, "unknown"];
-const STROKE_WIDTH_OPTIONS = [
-  ...BASE_OPTIONS, ...BOOLEAN_OPTIONS, ...TRANSFORM_OPTIONS
-];
-const SIZE_OPTIONS = [
-  ...UNKNOWN_OPTIONS, "clamp", "reverse", "base", "exponent"
-];
-
-function optionsObject(options) {
-  if (!isPlainObject(options)) {
-    throw new TypeError("Encoding scale must be a plain object.");
-  }
-}
-
-function validateBooleanOptions(options, properties, type) {
-  for (const property of properties) {
-    if (options[property] !== undefined && typeof options[property] !== "boolean") {
-      throw new TypeError(`Scale ${property} must be a boolean.`);
-    }
-    if (type !== undefined && options[property] !== undefined) {
-      validateScalePropertyForType(type, property);
-    }
-  }
-}
-
-function assignOptions(scale, options, existing, properties) {
-  for (const property of properties) {
-    const value = options[property] ?? existing?.[property];
-    if (value !== undefined) scale[property] = value;
-  }
-  return scale;
-}
-
-function validatePaletteRange(options) {
-  if (options.palette !== undefined && options.range !== undefined) {
-    throw new Error("Color scale cannot specify both palette and range.");
-  }
-}
-
-export function resolvePositionScaleDefinition(
-  program,
-  channel,
-  fieldType,
-  options,
-  defaults = {}
-) {
-  optionsObject(options);
-  validateKeys(options, POSITION_OPTIONS, "scale");
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const existing = findSemanticScale(program, id);
-  const discrete = ["ordinal", "nominal"].includes(fieldType);
-  const expectedType = fieldType === "temporal"
-    ? "time"
-    : discrete
-      ? defaults.discreteType ?? "point"
-      : "linear";
-  const type = options.type ?? existing?.type ?? expectedType;
-  if (fieldType === "temporal") validateTimeScaleType(type);
-  else if (discrete) {
-    if (!isDiscretePositionScaleType(type)) {
-      throw new Error(
-        `Scale type "${type}" is not valid for discrete position.`
-      );
-    }
-  }
-  else if (channel === "theta") validateLinearScaleType(type);
-  else validateScaleTypeForRole(type, SCALE_ROLES.quantitativePosition);
-  const scale = {
-    id,
-    ...normalizeScaleDefinition({
-      type,
-      previous: existing,
-      patch: { ...options, ...(defaults.radialMapping === undefined ? {} : { radialMapping: defaults.radialMapping }) },
-      defaults: {
-        ...(existing === undefined && defaults.nice !== undefined
-          ? { nice: defaults.nice }
-          : {}),
-        ...(
-          existing === undefined &&
-          defaults.zero !== undefined &&
-          (type !== "log" || defaults.zero)
-          ? { zero: defaults.zero }
-          : {})
-      },
-      retainCoreOnTypeChange: true,
-      retainCompatibleOnTypeChange: true,
-      validateDomain: (_scaleType, value) =>
-        discrete
-          ? validateOrdinalDomain(value)
-          : validateScaleDomain(value),
-      validateRange: (_scaleType, value) => channel === "theta"
-        ? validateThetaRange(value)
-        : channel === "radius"
-          ? validateRadialRange(value)
-          : validateScaleRange(value)
-    })
-  };
-  return withScaleUnknown(scale, { ...existing, ...options }, channel);
-}
-
-export function resolveColorScaleDefinition(program, options, channel = "color") {
-  optionsObject(options);
-  validateKeys(options, COLOR_OPTIONS, "scale");
-  validatePaletteRange(options);
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const existing = findSemanticScale(program, id);
-  const previous = existing?.type === "ordinal" ? existing : undefined;
-  const range = options.palette === undefined
-    ? options.range
-    : { palette: options.palette };
-  return withScaleUnknown({
-    id,
-    type: validateOrdinalScaleType(options.type ?? previous?.type ?? "ordinal"),
-    domain: validateOrdinalDomain(options.domain ?? previous?.domain ?? "auto"),
-    range: validateColorRange(range ?? previous?.range ?? "auto")
-  }, { ...previous, ...options }, channel);
-}
-
-function continuousDomain(value, fieldType) {
-  if (value === "auto") return value;
-  if (!Array.isArray(value) || value.length !== 2) {
-    throw new TypeError("Continuous color domain must contain two values or auto.");
-  }
-  const normalized = value.map(item => {
-    if (fieldType === "quantitative") return item;
-    return typeof item === "string" ? Date.parse(item) : item;
-  });
-  if (!normalized.every(Number.isFinite) || normalized[0] === normalized[1]) {
-    throw new TypeError("Continuous color domain requires two distinct valid values.");
-  }
-  return normalized;
-}
-
-export function resolveSequentialColorScaleDefinition(
-  program,
-  fieldType,
-  options,
-  channel = "color"
-) {
-  optionsObject(options);
-  validateKeys(options, SEQUENTIAL_COLOR_OPTIONS, "scale");
-  validatePaletteRange(options);
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const existing = findSemanticScale(program, id);
-  const previous = existing?.type === "sequential" ? existing : undefined;
-  const type = options.type ?? previous?.type ?? "sequential";
-  if (type !== "sequential") {
-    throw new Error(`Unsupported continuous color scale type "${type}".`);
-  }
-  validateBooleanOptions(options, CLAMP_REVERSE);
-  const requestedRange = options.palette === undefined
-    ? options.range
-    : { palette: options.palette };
-  const scale = {
-    id,
-    type,
-    domain: continuousDomain(options.domain ?? previous?.domain ?? "auto", fieldType),
-    range: validateSequentialColorRange(
-      requestedRange ?? previous?.range ?? { palette: "viridis" }
-    ),
-    interpolate: validateContinuousColorInterpolation(
-      options.interpolate ?? previous?.interpolate ?? "rgb"
-    )
-  };
-  const midpoint = validateSequentialMidpoint(
-    Object.hasOwn(options, "midpoint") ? options.midpoint : previous?.midpoint, type, scale.domain
-  );
-  if (midpoint !== undefined) {
-    if (fieldType !== "quantitative") {
-      throw new Error("Scale midpoint requires quantitative color consumers.");
-    }
-    scale.midpoint = midpoint;
-  }
-  return withScaleUnknown(
-    assignOptions(scale, options, previous, CLAMP_REVERSE),
-    { ...previous, ...options },
-    channel
-  );
-}
-
-export function resolveQuantitativeColorScaleDefinition(
-  program,
-  fieldType,
-  options,
-  channel = "color"
-) {
-  optionsObject(options);
-  const existing = findSemanticScale(program, options.id ?? channel);
-  const existingContinuous = existing !== undefined && (
-    existing.type === "sequential" ||
-    ["quantize", "quantile", "threshold"].includes(existing.type)
-  );
-  const type = options.type ?? (
-    existingContinuous ? existing.type : "sequential"
-  );
-  if (existingContinuous && existing.type !== type) {
-    validateKeys(options, type === "sequential" ? SEQUENTIAL_COLOR_OPTIONS : [...COLOR_OPTIONS, ...CLAMP_REVERSE], "scale");
-    if (fieldType !== "quantitative") throw new Error("Color scale type transition requires quantitative color.");
-    return { id: existing.id, ...prepareScaleEdit(program, existing, channel, [], options) };
-  }
-  if (type === "sequential") {
-    return resolveSequentialColorScaleDefinition(program, fieldType, options, channel);
-  }
-  validateKeys(options, [...COLOR_OPTIONS, ...CLAMP_REVERSE], "scale");
-  if (fieldType !== "quantitative") {
-    throw new Error(`Scale type "${type}" requires quantitative color.`);
-  }
-  validateScaleTypeForRole(type, SCALE_ROLES.discretizedColor);
-  validatePaletteRange(options);
-  validateBooleanOptions(options, CLAMP_REVERSE, type);
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const previous = existing?.type === type ? existing : undefined;
-  const requestedRange = options.palette === undefined
-    ? options.range
-    : { palette: options.palette };
-  const scale = {
-    id,
-    type,
-    domain: validateDiscretizedColorDomain(
-      type,
-      options.domain ?? previous?.domain ?? "auto"
-    ),
-    range: validateDiscretizedColorRange(
-      requestedRange ?? previous?.range ?? { palette: "viridis" }
-    )
-  };
-  return withScaleUnknown(
-    assignOptions(scale, options, previous, CLAMP_REVERSE),
-    { ...existing, ...options },
-    channel
-  );
-}
-
-function resolveOrdinalScaleDefinition(program, options, channel, rangeValidator) {
-  optionsObject(options);
-  validateKeys(options, UNKNOWN_OPTIONS, "scale");
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const existing = findSemanticScale(program, id);
-  return withScaleUnknown({
-    id,
-    type: validateOrdinalScaleType(options.type ?? existing?.type ?? "ordinal"),
-    domain: validateOrdinalDomain(options.domain ?? existing?.domain ?? "auto"),
-    range: rangeValidator(options.range ?? existing?.range ?? "auto")
-  }, { ...existing, ...options }, channel);
-}
-
-export function resolveStrokeDashScaleDefinition(program, options) {
-  return resolveOrdinalScaleDefinition(
-    program, options, "strokeDash", validateStrokeDashRange
-  );
-}
-
-export function resolveAppearanceScaleDefinition(program, channel, options) {
-  optionsObject(options);
-  if (channel === "size") {
-    validateKeys(options, SIZE_OPTIONS, "scale");
-    const id = validateUserId(options.id ?? channel, "Scale id");
-    const existing = findSemanticScale(program, id);
-    return {
-      id,
-      ...normalizeSizeScaleDefinition({ previous: existing, patch: options })
-    };
-  }
-  validateKeys(options, UNKNOWN_OPTIONS, "scale");
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const existing = findSemanticScale(program, id);
-  return withScaleUnknown({
-    id,
-    type: validateOrdinalScaleType(options.type ?? existing?.type ?? "ordinal"),
-    domain: validateOrdinalDomain(options.domain ?? existing?.domain ?? "auto"),
-    range: validateShapeRange(options.range ?? existing?.range ?? "auto")
-  }, { ...existing, ...options }, channel);
-}
-
-export function resolveOpacityScaleDefinition(program, options) {
-  optionsObject(options);
-  validateKeys(options, OPACITY_OPTIONS, "scale");
-  const id = validateUserId(options.id ?? "opacity", "Scale id");
-  const existing = findSemanticScale(program, id);
-  const type = validateLinearScaleType(options.type ?? existing?.type ?? "linear");
-  validateBooleanOptions(options, BOOLEAN_OPTIONS, type);
-  const scale = {
-    id,
-    type,
-    domain: validateScaleDomain(options.domain ?? existing?.domain ?? "auto"),
-    range: validateOpacityRange(options.range ?? existing?.range ?? "auto")
-  };
-  return withScaleUnknown(
-    assignOptions(scale, options, existing, BOOLEAN_OPTIONS),
-    { ...existing, ...options },
-    "opacity"
-  );
-}
-
-export function resolveStrokeWidthScaleDefinition(program, options) {
-  optionsObject(options);
-  validateKeys(options, STROKE_WIDTH_OPTIONS, "scale");
-  const id = validateUserId(options.id ?? "strokeWidth", "Scale id");
-  const existing = findSemanticScale(program, id);
-  const type = options.type ?? existing?.type ?? "linear";
-  validateScaleTypeForRole(type, SCALE_ROLES.quantitativePosition);
-  validateBooleanOptions(options, BOOLEAN_OPTIONS, type);
-  for (const property of TRANSFORM_OPTIONS) {
-    if (options[property] !== undefined) {
-      validateScalePropertyForType(type, property);
-    }
-  }
-  const domain = validateScaleDomain(options.domain ?? existing?.domain ?? "auto");
-  if (domain !== "auto" && domain.some(value => value < 0)) {
-    throw new RangeError("StrokeWidth scale domain cannot contain negative values.");
-  }
-  const scale = {
-    id,
-    type,
-    domain,
-    range: validateStrokeWidthRange(options.range ?? existing?.range ?? "auto")
-  };
-  return assignOptions(
-    scale, options, existing, [...BOOLEAN_OPTIONS, ...TRANSFORM_OPTIONS]
-  );
-}
-
-export function resolveOffsetScaleDefinition(program, options, channel = "xOffset") {
-  optionsObject(options);
-  validateKeys(options, [
-    "id", "type", "domain", "range", "reverse",
-    "padding", "paddingInner", "paddingOuter", "align"
-  ], "scale");
-  const id = validateUserId(options.id ?? channel, "Scale id");
-  const existing = findSemanticScale(program, id);
-  const type = options.type ?? existing?.type ?? "ordinal";
-  if (type !== "ordinal") {
-    throw new Error(`Scale type "${type}" is not valid for ${channel}.`);
-  }
-  if (Object.hasOwn(options, "range") && options.range !== "auto") {
-    throw new Error(
-      `${channel} scale range is derived from its parent categorical slot.`
-    );
-  }
-  const consumers = findScaleConsumers(program, id).filter(
-    consumer => consumer.channel === channel
-  );
-  const currentPolicy = resolveRequestedOffsetPolicy({
-    scale: existing,
-    consumers,
-    markConfigs: program.markConfigs,
-    id,
-    channel
-  });
-  const policy = normalizeOffsetScalePolicy(options, currentPolicy, channel);
-  const patch = Object.fromEntries(Object.entries(options).filter(
-    ([property]) => !["id", "padding"].includes(property)
-  ));
-  return {
-    id,
-    ...normalizeScaleDefinition({
-      type,
-      previous: existing,
-      patch: { ...patch, ...policy },
-      allowOrdinalBandParameters: true,
-      validateDomain: (_scaleType, value) => validateOrdinalDomain(value),
-      validateRange: (_scaleType, value) => validateScaleRange(value)
-    })
-  };
-}
+import{prepareScaleEdit as U}from"./editPolicy.js";import{validateUserId as p}from"../../core/identifiers.js";import{isPlainObject as B}from"../../core/immutable.js";import{validateKeys as f}from"../../core/validation.js";import{validateColorRange as F,isContinuousColorScaleType as E,normalizeTransformParameters as K,validateTransformedDomain as Q,validateContinuousColorInterpolation as H,normalizeColorInterpolationOptions as V,validateSequentialMidpoint as Y,validateLinearScaleType as _,validateOpacityRange as Z,validateOrdinalDomain as h,validateOrdinalScaleType as j,validateScaleDomain as P,validateScaleRange as k,validateShapeRange as G,validateStrokeDashRange as J,validateStrokeWidthRange as X,validateSequentialColorRange as ee,validateDiscretizedColorDomain as te,validateDiscretizedColorRange as ne,validateTimeScaleType as ae,normalizeScaleDefinition as A,SCALE_ROLES as R,validateScalePropertyForType as L,validateScaleTypeForRole as I,isDiscretePositionScaleType as ie,normalizeSizeScaleDefinition as re,withScaleUnknown as w}from"../../grammar/scales/index.js";import{validateRadialRange as oe,validateThetaRange as ce}from"../../grammar/polar.js";import{findSemanticScale as g}from"../../selectors/scales.js";import{normalizeOffsetScalePolicy as le}from"../../grammar/bars/geometry.js";import{resolveRequestedOffsetPolicy as de}from"../../materialization/scales/policies/offset.js";import{findScaleConsumers as se}from"./consumers/index.js";const C=["id","type","domain","range","emptyDomain"],M=[...C,"unknown"],S=["clamp","reverse"],O=["nice","zero",...S],q=["base","exponent","constant"],ue=[...C,...O,...q,"paddingInner","paddingOuter","padding","align","unknown"],D=[...C,"palette","unknown"],$=[...D,"interpolate","whitePoint","gamma","midpoint","base","exponent","constant",...S],fe=[...C,...O,"unknown"],me=[...C,...O,...q],pe=[...M,"clamp","reverse","base","exponent"];function y(i){if(!B(i))throw new TypeError("Encoding scale must be a plain object.")}function b(i,t,e){for(const n of t){if(i[n]!==void 0&&typeof i[n]!="boolean")throw new TypeError(`Scale ${n} must be a boolean.`);e!==void 0&&i[n]!==void 0&&L(e,n)}}function x(i,t,e,n){for(const a of n){const o=t[a]??e?.[a];o!==void 0&&(i[a]=o)}return i}function z(i){if(i.palette!==void 0&&i.range!==void 0)throw new Error("Color scale cannot specify both palette and range.")}function be(i,t,e,n,a={}){y(n),f(n,ue,"scale");const o=p(n.id??t,"Scale id"),r=g(i,o),c=["ordinal","nominal"].includes(e),m=e==="temporal"?"time":c?a.discreteType??"point":"linear",l=n.type??r?.type??m;if(e==="temporal")ae(l);else if(c){if(!ie(l))throw new Error(`Scale type "${l}" is not valid for discrete position.`)}else t==="theta"?_(l):I(l,R.quantitativePosition);const s={id:o,...A({type:l,previous:r,patch:{...n,...a.radialMapping===void 0?{}:{radialMapping:a.radialMapping}},defaults:{...r===void 0&&a.nice!==void 0?{nice:a.nice}:{},...r===void 0&&a.zero!==void 0&&(l!=="log"||a.zero)?{zero:a.zero}:{}},retainCoreOnTypeChange:!0,retainCompatibleOnTypeChange:!0,validateDomain:(v,u)=>c?h(u):P(u),validateRange:(v,u)=>t==="theta"?ce(u):t==="radius"?oe(u):k(u)})};return w(s,{...r,...n},t)}function xe(i,t,e="color"){y(t),f(t,D,"scale"),z(t);const n=p(t.id??e,"Scale id"),a=g(i,n),o=a?.type==="ordinal"?a:void 0,r=t.palette===void 0?t.range:{palette:t.palette};return w({id:n,type:j(t.type??o?.type??"ordinal"),domain:h(t.domain??o?.domain??"auto"),range:F(r??o?.range??"auto")},{...o,...t},e)}function ge(i,t){if(i==="auto")return i;if(!Array.isArray(i)||i.length!==2)throw new TypeError("Continuous color domain must contain two values or auto.");const e=i.map(n=>t==="quantitative"?n:typeof n=="string"?Date.parse(n):n);if(!e.every(Number.isFinite)||e[0]===e[1])throw new TypeError("Continuous color domain requires two distinct valid values.");return e}function ye(i,t,e,n="color"){y(e),f(e,$,"scale"),z(e);const a=p(e.id??n,"Scale id"),o=g(i,a),r=E(o?.type)?o:void 0,c=e.type??r?.type??"sequential";if(!E(c))throw new Error(`Unsupported continuous color scale type "${c}".`);b(e,S);const m=e.palette===void 0?e.range:{palette:e.palette},l={id:a,type:c,domain:ge(e.domain??r?.domain??"auto",t),range:ee(m??r?.range??{palette:"viridis"}),interpolate:H(e.interpolate??r?.interpolate??"rgb")},s=Object.hasOwn(e,"interpolate")&&e.interpolate!==r?.interpolate,v=Object.fromEntries(["whitePoint","gamma"].flatMap(d=>{const T=Object.hasOwn(e,d)?e[d]:s?void 0:r?.[d];return T===void 0?[]:[[d,T]]}));if(Object.assign(l,V(l.interpolate,v)),c!=="sequential"&&t!=="quantitative")throw new Error(`Scale type "${c}" requires quantitative color.`);const u=Object.fromEntries(["base","exponent","constant"].flatMap(d=>{const T=e[d]??(c===r?.type?r?.[d]:void 0);return T===void 0?[]:[[d,T]]}));if(c!=="sequential"){const d=K(c,u);c==="log"&&(l.base=d.base),c==="pow"&&(l.exponent=d.exponent),c==="symlog"&&(l.constant=d.constant),l.domain!=="auto"&&Q(c,l.domain,u)}else if(Object.keys(u).length)throw new Error("Sequential color does not support transform parameters.");const N=Y(Object.hasOwn(e,"midpoint")?e.midpoint:r?.midpoint,c,l.domain);if(N!==void 0){if(t!=="quantitative")throw new Error("Scale midpoint requires quantitative color consumers.");l.midpoint=N}return w(x(l,e,r,S),{...r,...e},n)}function Pe(i,t,e,n="color"){y(e);const a=g(i,e.id??n),o=a!==void 0&&(E(a.type)||["quantize","quantile","threshold"].includes(a.type)),r=e.type??(o?a.type:"sequential");if(o&&a.type!==r){if(f(e,E(r)?$:[...D,...S],"scale"),t!=="quantitative")throw new Error("Color scale type transition requires quantitative color.");return{id:a.id,...U(i,a,n,[],e)}}if(E(r))return ye(i,t,e,n);if(f(e,[...D,...S],"scale"),t!=="quantitative")throw new Error(`Scale type "${r}" requires quantitative color.`);I(r,R.discretizedColor),z(e),b(e,S,r);const c=p(e.id??n,"Scale id"),m=a?.type===r?a:void 0,l=e.palette===void 0?e.range:{palette:e.palette},s={id:c,type:r,domain:te(r,e.domain??m?.domain??"auto"),range:ne(l??m?.range??{palette:"viridis"})};return w(x(s,e,m,S),{...a,...e},n)}function W(i,t,e,n){y(t),f(t,M,"scale");const a=p(t.id??e,"Scale id"),o=g(i,a);return w({id:a,type:j(t.type??o?.type??"ordinal"),domain:h(t.domain??o?.domain??"auto"),range:n(t.range??o?.range??"auto")},{...o,...t},e)}function Re(i,t){return W(i,t,"strokeDash",J)}function Ie(i,t,e,n="quantitative"){if(y(e),t==="size"){f(e,pe,"scale");const a=p(e.id??t,"Scale id"),o=g(i,a),r=["nominal","ordinal"].includes(n),c=re({previous:o,patch:{...e,type:e.type??o?.type??(r?"ordinal":"linear")}});if(c.type==="ordinal"!==r)throw new Error("Size scale type must match its field type.");return{id:a,...c}}return W(i,e,t,G)}function ze(i,t){y(t),f(t,fe,"scale");const e=p(t.id??"opacity","Scale id"),n=g(i,e),a=_(t.type??n?.type??"linear");b(t,O,a);const o={id:e,type:a,domain:P(t.domain??n?.domain??"auto"),range:Z(t.range??n?.range??"auto")};return w(x(o,t,n,O),{...n,...t},"opacity")}function Ne(i,t){y(t),f(t,me,"scale");const e=p(t.id??"strokeWidth","Scale id"),n=g(i,e),a=t.type??n?.type??"linear";I(a,R.quantitativePosition),b(t,O,a);for(const c of q)t[c]!==void 0&&L(a,c);const o=P(t.domain??n?.domain??"auto");if(o!=="auto"&&o.some(c=>c<0))throw new RangeError("StrokeWidth scale domain cannot contain negative values.");const r={id:e,type:a,domain:o,range:X(t.range??n?.range??"auto")};return x(r,t,n,[...O,...q])}function _e(i,t,e="xOffset"){y(t),f(t,["id","type","domain","range","reverse","padding","paddingInner","paddingOuter","align"],"scale");const n=p(t.id??e,"Scale id"),a=g(i,n),o=t.type??a?.type??"ordinal";if(o!=="ordinal")throw new Error(`Scale type "${o}" is not valid for ${e}.`);if(Object.hasOwn(t,"range")&&t.range!=="auto")throw new Error(`${e} scale range is derived from its parent categorical slot.`);const r=se(i,n).filter(s=>s.channel===e),c=de({scale:a,consumers:r,markConfigs:i.markConfigs,id:n,channel:e}),m=le(t,c,e),l=Object.fromEntries(Object.entries(t).filter(([s])=>!["id","padding"].includes(s)));return{id:n,...A({type:o,previous:a,patch:{...l,...m},allowOrdinalBandParameters:!0,validateDomain:(s,v)=>h(v),validateRange:(s,v)=>k(v)})}}export{Ie as resolveAppearanceScaleDefinition,xe as resolveColorScaleDefinition,_e as resolveOffsetScaleDefinition,ze as resolveOpacityScaleDefinition,be as resolvePositionScaleDefinition,Pe as resolveQuantitativeColorScaleDefinition,ye as resolveSequentialColorScaleDefinition,Re as resolveStrokeDashScaleDefinition,Ne as resolveStrokeWidthScaleDefinition};

package/src/actions/scales/edit.js

@@ -11,7 +11,7 @@ import {
   applyMaterializationPlan,
   planCoordinateRematerialization
 } from "../../materialization/dependencies.js";
-import { findDataAspectCoordinatesForScale } from
+import { axisScaleBindings, findDataAspectCoordinatesForScale } from
   "../../materialization/coordinateBounds.js";
 import {
   findSemanticScale,
@@ -28,7 +28,7 @@ import { hasExactLegendSamplingForScale } from
 const OPTIONS = Object.freeze([
   "id", "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "paddingInner", "paddingOuter", "padding",
-  "align", "interpolate", "midpoint", "unknown", "palette", "radialMapping"
+  "align", "interpolate", "whitePoint", "gamma", "midpoint", "unknown", "palette", "radialMapping"
 ]);
 const EDITABLE = Object.freeze(
   OPTIONS.filter(option => !["id", "palette"].includes(option))
@@ -115,7 +115,7 @@ function applyScaleEdit(program, {
       value: definition[property]
     });
   }
-  if (consumers.length === 0) return next;
+  if (consumers.length === 0) return axisScaleBindings(next, id).length === 0 ? next : next.rematerializeScale({ id });
 
   const aspectCoordinates = findDataAspectCoordinatesForScale(next, id);
   if (aspectCoordinates.length > 0) {

package/src/actions/scales/editPolicy.js

@@ -1,6 +1,7 @@
 import { validateContinuousColorConsumer } from "../../grammar/scales/colorConsumers.js";
 import {
   hasOrdinalDomain,
+  isContinuousColorScaleType,
   isDiscretizedColorScaleType,
   isDiscretePositionScaleType,
   isTransformedScaleType,
@@ -11,6 +12,7 @@ import {
   validateDiscretizedColorDomain,
   validateDiscretizedColorRange,
   validateOrdinalDomain,
+  validateOrdinalRange,
   validateScaleDomain,
   validateScaleRange,
   validateScaleType,
@@ -53,7 +55,7 @@ function validateRangeForChannel(scale, channel, value) {
   if (channel === "size") return validateSizeRange(value);
   if (channel === "theta") return validateThetaRange(value);
   if (channel === "radius") return validateRadialRange(value);
-  if (scale.type === "sequential") {
+  if (scale.type === "sequential" || (channel === "color" && isContinuousColorScaleType(scale.type))) {
     return validateSequentialColorRange(value);
   }
   if (isDiscretizedColorScaleType(scale.type)) {
@@ -65,6 +67,7 @@ function validateRangeForChannel(scale, channel, value) {
   if (channel === "strokeDash") return validateStrokeDashRange(value);
   if (channel === "size") return validateSizeRange(value);
   if (channel === "strokeWidth") return validateStrokeWidthRange(value);
+  if (channel === undefined) return validateOrdinalRange(value);
   return validateScaleRange(value);
 }
 
@@ -72,7 +75,8 @@ function validateTypeTransition(scale, nextType, channel, consumers) {
   if (nextType === scale.type) return;
   validateScaleType(nextType);
   if (consumers.length === 0) return;
-  if (nextType === "sequential" || isDiscretizedColorScaleType(nextType)) {
+  if (nextType === "sequential" || isDiscretizedColorScaleType(nextType) ||
+    (channel === "color" && isContinuousColorScaleType(nextType))) {
     if (channel !== "color") {
       throw new Error(`Scale "${scale.id}" has a consumer incompatible with type "${nextType}".`);
     }
@@ -162,7 +166,9 @@ function normalizeDefinition(program, scale, channel, consumers, patch) {
   if (channel === "size") {
     if (consumers.some(consumer =>
       consumer.layer.mark?.type !== "point" ||
-      consumer.encoding.fieldType !== "quantitative"
+      ((patch.type ?? scale.type) === "ordinal"
+        ? !["nominal", "ordinal"].includes(consumer.encoding.fieldType)
+        : consumer.encoding.fieldType !== "quantitative")
     )) {
       throw new Error(
         `Scale "${scale.id}" has a consumer incompatible with size mapping.`
@@ -208,10 +214,12 @@ function normalizeDefinition(program, scale, channel, consumers, patch) {
     : patch;
   const definition = normalizeScaleDefinition({
     type,
+    color: channel === "color" || scale.interpolate !== undefined,
     previous: scale,
     patch: normalizedPatch,
     retainCoreOnTypeChange: true,
     retainCompatibleOnTypeChange: true,
+    allowColorReset: true,
     allowOrdinalBandParameters: offset,
     validateDomain: (scaleType, value) =>
       isDiscretizedColorScaleType(scaleType)
@@ -252,6 +260,7 @@ function normalizeDefinition(program, scale, channel, consumers, patch) {
 }
 
 export function prepareScaleEdit(program, scale, channel, consumers, args) {
+  channel ??= scale.interpolate === undefined ? undefined : "color";
   const hasPalette = Object.hasOwn(args, "palette");
   if (hasPalette && Object.hasOwn(args, "range")) {
     throw new Error("editScale cannot specify both palette and range.");

package/src/actions/scales/materialize.js

@@ -37,7 +37,7 @@ export const rematerializeScale = /* @__PURE__ */ action(
     const id = validateUserId(args.id, "Scale id");
     const semanticScale = findScale(this, id);
     const consumers = findScaleConsumers(this, id);
-    if (semanticScale.radialMapping !== undefined && consumers.length > 0 &&
+    if (consumers.length > 0 &&
       consumers.every(isPendingMeasuredRadiusConsumer)) {
       validatePendingMeasuredScale(this, semanticScale, consumers);
       return this._withoutResolvedScale(id);

package/src/actions/scales/patch.js

@@ -1,7 +1,7 @@
 const SCALE_EDIT_PROPERTIES = Object.freeze([
   "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "paddingInner", "paddingOuter",
-  "padding", "align", "interpolate", "midpoint", "unknown"
+  "padding", "align", "interpolate", "whitePoint", "gamma", "midpoint", "unknown"
 ]);
 
 function sameValue(left, right) {

package/src/actions/scales/preview.js

@@ -5,6 +5,8 @@ import { findSemanticScale } from "../../selectors/scales.js";
 import { normalizePositionScaleChannel } from "../../core/vocabulary.js";
 import { resolveGraphicBounds } from "../../layout/canvas.js";
 import {
+  axisScaleBindings,
+  resolveCoordinateBounds,
   resolveDataAspectScalePair,
   resolveScaleConsumerBounds
 } from "../../materialization/coordinateBounds.js";
@@ -19,10 +21,15 @@ import { findScale, findScaleConsumers, resolveConsumerCategoryOrder,
 function resolveScalePreviewAtBounds(program, id, bounds) {
   const scale = findScale(program, id);
   const consumers = findScaleConsumers(program, id);
-  if (consumers.length === 0) throw new Error(`Scale "${id}" has no supported consumers.`);
+  const axes = axisScaleBindings(program, id);
+  if (consumers.length === 0 && axes.length === 0) throw new Error(`Scale "${id}" has no supported consumers.`);
+  if (consumers.length === 0 && (!Array.isArray(scale.domain) || scale.domain.length === 0)) {
+    throw new Error("Standalone axis scales require an explicit nonempty domain.");
+  }
   const consumerChannels = new Set(consumers.map(
     consumer => normalizePositionScaleChannel(consumer.channel)
   ));
+  for (const binding of axes) consumerChannels.add(binding.channel);
   const families = new Set([...consumerChannels].map(
     channel => channel === "stroke" ? "color" : channel
   ));
@@ -99,6 +106,12 @@ function dataAspectScaleIds(program) {
 
 export function resolveScalePreview(program, id) {
   const requestedConsumers = findScaleConsumers(program, id);
+  const axes = axisScaleBindings(program, id);
+  if (requestedConsumers.length === 0 && axes.length > 0) {
+    const coordinate = requireCoordinate(program, axes[0].coordinate);
+    if (coordinate.type !== "cartesian") throw new Error("Standalone axes require a Cartesian coordinate.");
+    return resolveScalePreviewAtBounds(program, id, resolveCoordinateBounds(program, coordinate.id));
+  }
   const positionChannels = new Set([
     "x", "y", "x2", "y2", "theta", "radius"
   ]);
@@ -126,6 +139,12 @@ export function resolveScalePreview(program, id) {
     provisional.consumers,
     { resolvedScales }
   );
+  for (const binding of axes) {
+    const guideBounds = resolveCoordinateBounds(program, binding.coordinate, { resolvedScales });
+    if (["x", "y", "width", "height"].some(key => Math.abs(guideBounds[key] - bounds[key]) > 1e-9)) {
+      throw new Error("Axis and mark scale consumers require matching coordinate bounds.");
+    }
+  }
   return resolveScalePreviewAtBounds(program, id, bounds);
 }
 
@@ -137,6 +156,7 @@ export function restoreResolvedScaleBindings(program) {
     const channels = new Set(consumers.map(consumer =>
       normalizePositionScaleChannel(consumer.channel)
     ));
+    for (const binding of axisScaleBindings(program, scale.id)) channels.add(binding.channel);
     const families = new Set([...channels].map(channel =>
       channel === "stroke" ? "color" : channel
     ));

package/src/actions/scales/quantitativeColor.js

@@ -7,7 +7,7 @@ const OPTIONS = Object.freeze([
   "type",
   "domain",
   "range",
-  "interpolate", "midpoint",
+  "interpolate", "whitePoint", "gamma", "midpoint", "base", "exponent", "constant",
   "clamp",
   "reverse",
   "unknown"
@@ -19,7 +19,7 @@ export const setQuantitativeColorScale = /* @__PURE__ */ closedAction(
     description: "Create or update an internal quantitative color scale."
   }, OPTIONS,
   function (args = {}) {
-    if (!["sequential", "quantize", "quantile", "threshold"].includes(args.type)) {
+    if (!["sequential", "log", "pow", "sqrt", "symlog", "quantize", "quantile", "threshold"].includes(args.type)) {
       throw new Error(`Unsupported quantitative color scale type "${args.type}".`);
     }
     const existing = findSemanticScale(this, args.id);
@@ -30,11 +30,16 @@ export const setQuantitativeColorScale = /* @__PURE__ */ closedAction(
       return this.editScale(args);
     }
     let next = this;
+    for (const property of ["whitePoint", "gamma"]) {
+      if (existing?.[property] !== undefined && args[property] === undefined) {
+        next = next.editSemantic({ property: `scale[${args.id}].${property}`, remove: true });
+      }
+    }
     if (existing?.midpoint !== undefined && args.midpoint === undefined) {
       next = next.editSemantic({ property: `scale[${args.id}].midpoint`, remove: true });
     }
     for (const property of [
-      "type", "domain", "range", "interpolate", "midpoint", "clamp", "reverse", "unknown"
+      "type", "domain", "range", "interpolate", "whitePoint", "gamma", "midpoint", "base", "exponent", "constant", "clamp", "reverse", "unknown"
     ]) {
       if (!Object.hasOwn(args, property)) continue;
       if (existing?.[property] === args[property]) continue;