ggaction 0.0.16 → 0.0.18

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"];
-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 M}from"./editPolicy.js";import{validateUserId as m}from"../../core/identifiers.js";import{isPlainObject as W}from"../../core/immutable.js";import{validateKeys as u}from"../../core/validation.js";import{validateColorRange as U,isContinuousColorScaleType as w,normalizeTransformParameters as B,validateTransformedDomain as F,validateContinuousColorInterpolation as K,validateSequentialMidpoint as Q,validateLinearScaleType as z,validateOpacityRange as H,validateOrdinalDomain as E,validateOrdinalScaleType as N,validateScaleDomain as h,validateScaleRange as _,validateShapeRange as V,validateStrokeDashRange as Y,validateStrokeWidthRange as Z,validateSequentialColorRange as G,validateDiscretizedColorDomain as J,validateDiscretizedColorRange as X,validateTimeScaleType as ee,normalizeScaleDefinition as k,SCALE_ROLES as P,validateScalePropertyForType as A,validateScaleTypeForRole as b,isDiscretePositionScaleType as te,normalizeSizeScaleDefinition as ae,withScaleUnknown as O}from"../../grammar/scales/index.js";import{validateRadialRange as ne,validateThetaRange as ie}from"../../grammar/polar.js";import{findSemanticScale as p}from"../../selectors/scales.js";import{normalizeOffsetScalePolicy as re}from"../../grammar/bars/geometry.js";import{resolveRequestedOffsetPolicy as oe}from"../../materialization/scales/policies/offset.js";import{findScaleConsumers as ce}from"./consumers/index.js";const T=["id","type","domain","range","emptyDomain"],j=[...T,"unknown"],S=["clamp","reverse"],v=["nice","zero",...S],q=["base","exponent","constant"],de=[...T,...v,...q,"paddingInner","paddingOuter","padding","align","unknown"],C=[...T,"palette","unknown"],L=[...C,"interpolate","midpoint","base","constant",...S],le=[...T,...v,"unknown"],se=[...T,...v,...q],ue=[...j,"clamp","reverse","base","exponent"];function y(i){if(!W(i))throw new TypeError("Encoding scale must be a plain object.")}function D(i,e,t){for(const a of e){if(i[a]!==void 0&&typeof i[a]!="boolean")throw new TypeError(`Scale ${a} must be a boolean.`);t!==void 0&&i[a]!==void 0&&A(t,a)}}function R(i,e,t,a){for(const n of a){const r=e[n]??t?.[n];r!==void 0&&(i[n]=r)}return i}function x(i){if(i.palette!==void 0&&i.range!==void 0)throw new Error("Color scale cannot specify both palette and range.")}function Ce(i,e,t,a,n={}){y(a),u(a,de,"scale");const r=m(a.id??e,"Scale id"),o=p(i,r),c=["ordinal","nominal"].includes(t),f=t==="temporal"?"time":c?n.discreteType??"point":"linear",d=a.type??o?.type??f;if(t==="temporal")ee(d);else if(c){if(!te(d))throw new Error(`Scale type "${d}" is not valid for discrete position.`)}else e==="theta"?z(d):b(d,P.quantitativePosition);const l={id:r,...k({type:d,previous:o,patch:{...a,...n.radialMapping===void 0?{}:{radialMapping:n.radialMapping}},defaults:{...o===void 0&&n.nice!==void 0?{nice:n.nice}:{},...o===void 0&&n.zero!==void 0&&(d!=="log"||n.zero)?{zero:n.zero}:{}},retainCoreOnTypeChange:!0,retainCompatibleOnTypeChange:!0,validateDomain:(g,s)=>c?E(s):h(s),validateRange:(g,s)=>e==="theta"?ie(s):e==="radius"?ne(s):_(s)})};return O(l,{...o,...a},e)}function De(i,e,t="color"){y(e),u(e,C,"scale"),x(e);const a=m(e.id??t,"Scale id"),n=p(i,a),r=n?.type==="ordinal"?n:void 0,o=e.palette===void 0?e.range:{palette:e.palette};return O({id:a,type:N(e.type??r?.type??"ordinal"),domain:E(e.domain??r?.domain??"auto"),range:U(o??r?.range??"auto")},{...r,...e},t)}function fe(i,e){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 t=i.map(a=>e==="quantitative"?a:typeof a=="string"?Date.parse(a):a);if(!t.every(Number.isFinite)||t[0]===t[1])throw new TypeError("Continuous color domain requires two distinct valid values.");return t}function me(i,e,t,a="color"){y(t),u(t,L,"scale"),x(t);const n=m(t.id??a,"Scale id"),r=p(i,n),o=w(r?.type)?r:void 0,c=t.type??o?.type??"sequential";if(!w(c))throw new Error(`Unsupported continuous color scale type "${c}".`);D(t,S);const f=t.palette===void 0?t.range:{palette:t.palette},d={id:n,type:c,domain:fe(t.domain??o?.domain??"auto",e),range:G(f??o?.range??{palette:"viridis"}),interpolate:K(t.interpolate??o?.interpolate??"rgb")};if(c!=="sequential"&&e!=="quantitative")throw new Error(`Scale type "${c}" requires quantitative color.`);const l=Object.fromEntries(["base","constant"].flatMap(s=>{const I=t[s]??o?.[s];return I===void 0?[]:[[s,I]]}));if(c!=="sequential"){const s=B(c,l);c==="log"&&(d.base=s.base),c==="symlog"&&(d.constant=s.constant),d.domain!=="auto"&&F(c,d.domain,l)}else if(Object.keys(l).length)throw new Error("Sequential color does not support transform parameters.");const g=Q(Object.hasOwn(t,"midpoint")?t.midpoint:o?.midpoint,c,d.domain);if(g!==void 0){if(e!=="quantitative")throw new Error("Scale midpoint requires quantitative color consumers.");d.midpoint=g}return O(R(d,t,o,S),{...o,...t},a)}function Re(i,e,t,a="color"){y(t);const n=p(i,t.id??a),r=n!==void 0&&(w(n.type)||["quantize","quantile","threshold"].includes(n.type)),o=t.type??(r?n.type:"sequential");if(r&&n.type!==o){if(u(t,w(o)?L:[...C,...S],"scale"),e!=="quantitative")throw new Error("Color scale type transition requires quantitative color.");return{id:n.id,...M(i,n,a,[],t)}}if(w(o))return me(i,e,t,a);if(u(t,[...C,...S],"scale"),e!=="quantitative")throw new Error(`Scale type "${o}" requires quantitative color.`);b(o,P.discretizedColor),x(t),D(t,S,o);const c=m(t.id??a,"Scale id"),f=n?.type===o?n:void 0,d=t.palette===void 0?t.range:{palette:t.palette},l={id:c,type:o,domain:J(o,t.domain??f?.domain??"auto"),range:X(d??f?.range??{palette:"viridis"})};return O(R(l,t,f,S),{...n,...t},a)}function $(i,e,t,a){y(e),u(e,j,"scale");const n=m(e.id??t,"Scale id"),r=p(i,n);return O({id:n,type:N(e.type??r?.type??"ordinal"),domain:E(e.domain??r?.domain??"auto"),range:a(e.range??r?.range??"auto")},{...r,...e},t)}function he(i,e){return $(i,e,"strokeDash",Y)}function Pe(i,e,t,a="quantitative"){if(y(t),e==="size"){u(t,ue,"scale");const n=m(t.id??e,"Scale id"),r=p(i,n),o=["nominal","ordinal"].includes(a),c=ae({previous:r,patch:{...t,type:t.type??r?.type??(o?"ordinal":"linear")}});if(c.type==="ordinal"!==o)throw new Error("Size scale type must match its field type.");return{id:n,...c}}return $(i,t,e,V)}function be(i,e){y(e),u(e,le,"scale");const t=m(e.id??"opacity","Scale id"),a=p(i,t),n=z(e.type??a?.type??"linear");D(e,v,n);const r={id:t,type:n,domain:h(e.domain??a?.domain??"auto"),range:H(e.range??a?.range??"auto")};return O(R(r,e,a,v),{...a,...e},"opacity")}function xe(i,e){y(e),u(e,se,"scale");const t=m(e.id??"strokeWidth","Scale id"),a=p(i,t),n=e.type??a?.type??"linear";b(n,P.quantitativePosition),D(e,v,n);for(const c of q)e[c]!==void 0&&A(n,c);const r=h(e.domain??a?.domain??"auto");if(r!=="auto"&&r.some(c=>c<0))throw new RangeError("StrokeWidth scale domain cannot contain negative values.");const o={id:t,type:n,domain:r,range:Z(e.range??a?.range??"auto")};return R(o,e,a,[...v,...q])}function Ie(i,e,t="xOffset"){y(e),u(e,["id","type","domain","range","reverse","padding","paddingInner","paddingOuter","align"],"scale");const a=m(e.id??t,"Scale id"),n=p(i,a),r=e.type??n?.type??"ordinal";if(r!=="ordinal")throw new Error(`Scale type "${r}" is not valid for ${t}.`);if(Object.hasOwn(e,"range")&&e.range!=="auto")throw new Error(`${t} scale range is derived from its parent categorical slot.`);const o=ce(i,a).filter(l=>l.channel===t),c=oe({scale:n,consumers:o,markConfigs:i.markConfigs,id:a,channel:t}),f=re(e,c,t),d=Object.fromEntries(Object.entries(e).filter(([l])=>!["id","padding"].includes(l)));return{id:a,...k({type:r,previous:n,patch:{...d,...f},allowOrdinalBandParameters:!0,validateDomain:(l,g)=>E(g),validateRange:(l,g)=>_(g)})}}export{Pe as resolveAppearanceScaleDefinition,De as resolveColorScaleDefinition,Ie as resolveOffsetScaleDefinition,be as resolveOpacityScaleDefinition,Ce as resolvePositionScaleDefinition,Re as resolveQuantitativeColorScaleDefinition,me as resolveSequentialColorScaleDefinition,he as resolveStrokeDashScaleDefinition,xe 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,
@@ -26,7 +26,7 @@ import { hasExactLegendSamplingForScale } from
   "../guides/legends/sampling.js";
 
 const OPTIONS = Object.freeze([
-  "id", "type", "domain", "range", "nice", "zero", "clamp", "reverse",
+  "id", "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "paddingInner", "paddingOuter", "padding",
   "align", "interpolate", "midpoint", "unknown", "palette", "radialMapping"
 ]);
@@ -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,
@@ -53,7 +54,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)) {
@@ -72,7 +73,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 +164,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,6 +212,7 @@ function normalizeDefinition(program, scale, channel, consumers, patch) {
     : patch;
   const definition = normalizeScaleDefinition({
     type,
+    color: channel === "color" || scale.interpolate !== undefined,
     previous: scale,
     patch: normalizedPatch,
     retainCoreOnTypeChange: true,
@@ -252,6 +257,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/parallel.js

@@ -6,7 +6,7 @@ import { requireLayer } from "../../selectors/layers.js";
 import { requireSemanticScale } from "../../selectors/scales.js";
 
 const QUANTITATIVE_OPTIONS = Object.freeze([
-  "type", "domain", "range", "nice", "zero", "clamp", "reverse",
+  "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "unknown"
 ]);
 const ORDINAL_OPTIONS = Object.freeze([

package/src/actions/scales/patch.js

@@ -1,5 +1,5 @@
 const SCALE_EDIT_PROPERTIES = Object.freeze([
-  "type", "domain", "range", "nice", "zero", "clamp", "reverse",
+  "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "paddingInner", "paddingOuter",
   "padding", "align", "interpolate", "midpoint", "unknown"
 ]);

package/src/actions/scales/preview.js

@@ -5,21 +5,31 @@ 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";
 import { requireCoordinate } from "../../selectors/coordinates.js";
-import { resolveScaleMaterialization } from "../../materialization/scales/resolve.js";
+import {
+  rememberResolvedScaleBinding,
+  resolveScaleMaterialization
+} from "../../materialization/scales/resolve.js";
 import { findScale, findScaleConsumers, resolveConsumerCategoryOrder,
   resolveConsumerValues, resolveSeriesLayoutScaleValues } from "./consumers/index.js";
 
 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
   ));
@@ -96,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"
   ]);
@@ -123,9 +139,40 @@ 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);
 }
 
+export function restoreResolvedScaleBindings(program) {
+  for (const scale of program.semanticSpec.scales) {
+    const resolved = program.resolvedScales[scale.id];
+    if (resolved === undefined) continue;
+    const consumers = findScaleConsumers(program, scale.id);
+    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
+    ));
+    if (families.size === 1) {
+      const channel = channels.size === 1
+        ? channels.values().next().value
+        : families.values().next().value;
+      rememberResolvedScaleBinding(resolved, channel, consumers);
+    }
+  }
+  for (const child of Object.values(program.children)) {
+    restoreResolvedScaleBindings(child);
+  }
+  return program;
+}
+
 export function validatePendingMeasuredScale(program, scale, consumers) {
   const bounds = resolveScaleConsumerBounds(program, consumers);
   const range = resolveArcAutoPositionRange({ consumers, scale, channel: "radius",

package/src/actions/scales/quantitativeColor.js

@@ -7,7 +7,7 @@ const OPTIONS = Object.freeze([
   "type",
   "domain",
   "range",
-  "interpolate", "midpoint",
+  "interpolate", "midpoint", "base", "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", "sqrt", "symlog", "quantize", "quantile", "threshold"].includes(args.type)) {
       throw new Error(`Unsupported quantitative color scale type "${args.type}".`);
     }
     const existing = findSemanticScale(this, args.id);
@@ -34,7 +34,7 @@ export const setQuantitativeColorScale = /* @__PURE__ */ closedAction(
       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", "midpoint", "base", "constant", "clamp", "reverse", "unknown"
     ]) {
       if (!Object.hasOwn(args, property)) continue;
       if (existing?.[property] === args[property]) continue;