ggaction 0.0.11 → 0.0.13

package/src/actions/guides/axes/parallel.js

@@ -1,228 +1,104 @@
 import { action } from "../../../core/action.js";
-import { validateOptionObject } from "../../../core/validation.js";
-import { resolvePlotGraphicPlacement } from
-  "../../../materialization/graphicHierarchy.js";
-import { DEFAULT_COLORS, DEFAULT_FONT_FAMILY } from
-  "../../../theme/defaults.js";
-import {
-  requireParallelAxisLayer,
-  resolveParallelAxisTarget,
-  resolveParallelAxisValues
-} from "./parallel/resolve.js";
+import { validateGeneratedItemLimit, validateOptionObject } from "../../../core/validation.js";
+import { resolvePlotGraphicPlacement } from "../../../materialization/graphicHierarchy.js";
+import { requireParallelAxisLayer, resolveParallelAxisTarget, resolveStyledParallelAxes } from "./parallel/resolve.js";
+import { PARALLEL_AXIS_GRAPHICS, PARALLEL_AXIS_PARTS, hasParallelAxisParts } from "./parallel/policy.js";
+import { registerParallelAxisLifecycleActions } from "./parallel/lifecycle.js";
 
-const CREATE_OPTIONS = Object.freeze(["target", "coordinate"]);
-const REMATERIALIZE_OPTIONS = Object.freeze(["target"]);
+function uniform(values) {
+  return values.length > 0 && values.every(value => value === values[0]) ? values[0] : values;
+}
 
-export const rematerializeParallelAxes = action(
-  {
-    op: "rematerializeParallelAxes",
-    description: "Recompute concrete Parallel dimension axes."
-  },
-  function (args = {}) {
-    validateOptionObject(
-      args,
-      REMATERIALIZE_OPTIONS,
-      "rematerializeParallelAxes"
-    );
-    const target = resolveParallelAxisTarget(
-      this,
-      args.target ?? this.guideConfigs.axis?.parallel?.axes?.target
-    );
-    const { dimensions } = requireParallelAxisLayer(this, target);
-    const { axes, bounds } = resolveParallelAxisValues(this, dimensions);
-    const ticks = axes.flatMap(axis => axis.values.map((value, index) => ({
-      x: axis.x,
-      y: axis.y[index],
-      value,
-      text: axis.labels[index]
-    })));
-    let next = this
-      .editGraphics({
-        target: "parallelAxisLines",
-        property: "length",
-        value: axes.length
-      })
-      .editGraphics({
-        target: "parallelAxisLines",
-        property: "x1",
-        value: axes.map(axis => axis.x)
-      })
-      .editGraphics({ target: "parallelAxisLines", property: "y1", value: bounds.y })
-      .editGraphics({
-        target: "parallelAxisLines",
-        property: "x2",
-        value: axes.map(axis => axis.x)
-      })
-      .editGraphics({
-        target: "parallelAxisLines",
-        property: "y2",
-        value: bounds.y + bounds.height
-      })
-      .editGraphics({
-        target: "parallelAxisLines",
-        property: "stroke",
-        value: DEFAULT_COLORS.axis
-      })
-      .editGraphics({
-        target: "parallelAxisLines",
-        property: "strokeWidth",
-        value: 1.25
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "length",
-        value: ticks.length
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "x1",
-        value: ticks.map(tick => tick.x - 4)
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "y1",
-        value: ticks.map(tick => tick.y)
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "x2",
-        value: ticks.map(tick => tick.x + 4)
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "y2",
-        value: ticks.map(tick => tick.y)
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "stroke",
-        value: DEFAULT_COLORS.mutedText
-      })
-      .editGraphics({
-        target: "parallelAxisTicks",
-        property: "strokeWidth",
-        value: 1
-      })
-      .editGraphics({
-        target: "parallelAxisLabels",
-        property: "length",
-        value: ticks.length
-      })
-      .editGraphics({
-        target: "parallelAxisLabels",
-        property: "x",
-        value: ticks.map(tick => tick.x - 9)
-      })
-      .editGraphics({
-        target: "parallelAxisLabels",
-        property: "y",
-        value: ticks.map(tick => tick.y)
-      })
-      .editGraphics({
-        target: "parallelAxisLabels",
-        property: "text",
-        value: ticks.map(tick => tick.text)
-      })
-      .editGraphics({ target: "parallelAxisLabels", property: "fill", value: DEFAULT_COLORS.axis })
-      .editGraphics({ target: "parallelAxisLabels", property: "fontSize", value: 11 })
-      .editGraphics({ target: "parallelAxisLabels", property: "fontFamily", value: DEFAULT_FONT_FAMILY })
-      .editGraphics({ target: "parallelAxisLabels", property: "fontWeight", value: "normal" })
-      .editGraphics({ target: "parallelAxisLabels", property: "textAlign", value: "right" })
-      .editGraphics({ target: "parallelAxisLabels", property: "textBaseline", value: "middle" })
-      .editGraphics({
-        target: "parallelAxisTitles",
-        property: "length",
-        value: axes.length
-      })
-      .editGraphics({
-        target: "parallelAxisTitles",
-        property: "x",
-        value: axes.map(axis => axis.x)
-      })
-      .editGraphics({
-        target: "parallelAxisTitles",
-        property: "y",
-        value: bounds.y - 20
-      })
-      .editGraphics({
-        target: "parallelAxisTitles",
-        property: "text",
-        value: axes.map(axis => axis.title)
-      })
-      .editGraphics({ target: "parallelAxisTitles", property: "fill", value: DEFAULT_COLORS.axisTitle })
-      .editGraphics({ target: "parallelAxisTitles", property: "fontSize", value: 13 })
-      .editGraphics({ target: "parallelAxisTitles", property: "fontFamily", value: DEFAULT_FONT_FAMILY })
-      .editGraphics({ target: "parallelAxisTitles", property: "fontWeight", value: 600 })
-      .editGraphics({ target: "parallelAxisTitles", property: "textAlign", value: "center" })
-      .editGraphics({ target: "parallelAxisTitles", property: "textBaseline", value: "middle" });
-    return next._withGuideConfig("parallel", "axes", {
-      target,
-      scales: dimensions.map(dimension => dimension.scale)
-    });
-  }
-);
+function collectionProperties(part, axes, bounds) {
+  if (part === "line") return {
+    length: axes.length,
+    x1: axes.map(axis => axis.x), y1: bounds.y,
+    x2: axes.map(axis => axis.x), y2: bounds.y + bounds.height,
+    stroke: uniform(axes.map(axis => axis.config.line.color)),
+    strokeWidth: uniform(axes.map(axis => axis.config.line.lineWidth))
+  };
+  if (part === "title") return {
+    length: axes.length, x: axes.map(axis => axis.x),
+    y: uniform(axes.map(axis => bounds.y - axis.config.title.offset)),
+    text: axes.map(axis => axis.title),
+    fill: uniform(axes.map(axis => axis.config.title.color)),
+    fontSize: uniform(axes.map(axis => axis.config.title.fontSize)),
+    fontFamily: uniform(axes.map(axis => axis.config.title.fontFamily)),
+    fontWeight: uniform(axes.map(axis => axis.config.title.fontWeight)),
+    textAlign: "center", textBaseline: "middle"
+  };
+  const rows = axes.flatMap(axis => axis[part].values.map((value, index) => ({
+    x: axis.x, y: axis[part].y[index], text: axis[part].text?.[index], config: axis.config[part]
+  })));
+  if (part === "ticks") return {
+    length: rows.length, x1: rows.map(row => row.x - row.config.length / 2),
+    y1: rows.map(row => row.y), x2: rows.map(row => row.x + row.config.length / 2),
+    y2: rows.map(row => row.y), stroke: uniform(rows.map(row => row.config.color)),
+    strokeWidth: uniform(rows.map(row => row.config.lineWidth))
+  };
+  return {
+    length: rows.length, x: rows.map(row => row.x - row.config.offset),
+    y: rows.map(row => row.y), text: rows.map(row => row.text),
+    fill: uniform(rows.map(row => row.config.color)),
+    fontSize: uniform(rows.map(row => row.config.fontSize)),
+    fontFamily: uniform(rows.map(row => row.config.fontFamily)),
+    fontWeight: uniform(rows.map(row => row.config.fontWeight)),
+    textAlign: "right", textBaseline: "middle"
+  };
+}
+
+export const rematerializeParallelAxes = action({
+  op: "rematerializeParallelAxes",
+  description: "Recompute concrete Parallel dimension axes."
+}, function (args = {}) {
+  validateOptionObject(args, ["target"], "rematerializeParallelAxes");
+  const stored = this.semanticSpec.guides.axis?.parallel;
+  if (stored === undefined) throw new Error("rematerializeParallelAxes requires existing Parallel axes.");
+  const target = resolveParallelAxisTarget(this, args.target ?? stored.target);
+  if (target !== stored.target) throw new Error("Parallel axes belong to another target.");
+  const { dimensions } = requireParallelAxisLayer(this, target);
+  const { axes, bounds, configs } = resolveStyledParallelAxes(this, dimensions);
+  if (!configs.dimensions.some(hasParallelAxisParts)) return this.removeParallelAxes({ target });
 
-export const createParallelAxes = action(
-  {
-    op: "createParallelAxes",
-    description: "Create ordinary line and text graphics for Parallel dimensions."
-  },
-  function (args = {}) {
-    validateOptionObject(args, CREATE_OPTIONS, "createParallelAxes");
-    const target = resolveParallelAxisTarget(this, args.target);
-    const { coordinate, dimensions } = requireParallelAxisLayer(this, target);
-    if (args.coordinate !== undefined && args.coordinate !== coordinate.id) {
-      throw new Error(
-        `Parallel layer "${target}" uses coordinate "${coordinate.id}".`
-      );
+  // Preflight every collection before authoring any concrete graphic.
+  const properties = Object.fromEntries(PARALLEL_AXIS_PARTS.map(part => {
+    const selected = axes.filter(axis => axis.config[part] !== undefined);
+    const value = collectionProperties(part, selected, bounds);
+    validateGeneratedItemLimit(value.length, "Parallel axis item count");
+    return [part, { enabled: selected.length > 0, value }];
+  }));
+  let next = this;
+  const scales = dimensions.map(dimension => dimension.scale);
+  if (stored.scales?.length !== scales.length || scales.some((scale, index) => scale !== stored.scales[index])) {
+    next = next.editSemantic({ property: "guide.axis.parallel.scales", value: scales });
+  }
+  const retainedTitles = stored.titles?.filter(title =>
+    configs.dimensions.some(config => config.field === title.field && config.title !== undefined));
+  if (retainedTitles !== undefined && retainedTitles.length !== stored.titles.length) {
+    next = next.editSemantic({ property: "guide.axis.parallel.titles",
+      ...(retainedTitles.length === 0 ? { remove: true } : { value: retainedTitles }) });
+  }
+  for (const [index, part] of PARALLEL_AXIS_PARTS.entries()) {
+    const id = PARALLEL_AXIS_GRAPHICS[part];
+    const { enabled, value } = properties[part];
+    if (!enabled) {
+      if (next.graphicSpec.objects[id] !== undefined) next = next.editGraphics({ target: id, remove: true });
+      continue;
+    }
+    if (next.graphicSpec.objects[id] === undefined) {
+      const before = PARALLEL_AXIS_PARTS.slice(index + 1).map(key => PARALLEL_AXIS_GRAPHICS[key])
+        .find(key => next.graphicSpec.objects[key] !== undefined);
+      next = next.createGraphics({ id, type: part === "line" || part === "ticks" ? "line" : "text", length: 0,
+        ...resolvePlotGraphicPlacement(next, before === undefined ? {} : { before }) });
     }
-    for (const id of [
-      "parallelAxisLines", "parallelAxisTicks", "parallelAxisLabels",
-      "parallelAxisTitles"
-    ]) {
-      if (this.graphicSpec.objects[id] !== undefined) {
-        throw new Error("createParallelAxes requires missing Parallel axes.");
-      }
+    for (const [property, item] of Object.entries(value)) {
+      next = next.editGraphics({ target: id, property, value: item });
     }
-    const placement = resolvePlotGraphicPlacement(this);
-    let next = this
-      .editSemantic({
-        property: "guide.axis.parallel.target",
-        value: target
-      })
-      .editSemantic({
-        property: "guide.axis.parallel.coordinate",
-        value: coordinate.id
-      })
-      .editSemantic({
-        property: "guide.axis.parallel.scales",
-        value: dimensions.map(dimension => dimension.scale)
-      })
-      .createGraphics({ id: "parallelAxisLines", type: "line", length: 0, ...placement })
-      .editGraphics({ target: "parallelAxisLines", property: "stroke", value: DEFAULT_COLORS.axis })
-      .editGraphics({ target: "parallelAxisLines", property: "strokeWidth", value: 1.25 })
-      .createGraphics({ id: "parallelAxisTicks", type: "line", length: 0, ...placement })
-      .editGraphics({ target: "parallelAxisTicks", property: "stroke", value: DEFAULT_COLORS.mutedText })
-      .editGraphics({ target: "parallelAxisTicks", property: "strokeWidth", value: 1 })
-      .createGraphics({ id: "parallelAxisLabels", type: "text", length: 0, ...placement })
-      .editGraphics({ target: "parallelAxisLabels", property: "fill", value: DEFAULT_COLORS.axis })
-      .editGraphics({ target: "parallelAxisLabels", property: "fontSize", value: 11 })
-      .editGraphics({ target: "parallelAxisLabels", property: "fontFamily", value: DEFAULT_FONT_FAMILY })
-      .editGraphics({ target: "parallelAxisLabels", property: "fontWeight", value: "normal" })
-      .editGraphics({ target: "parallelAxisLabels", property: "textAlign", value: "right" })
-      .editGraphics({ target: "parallelAxisLabels", property: "textBaseline", value: "middle" })
-      .createGraphics({ id: "parallelAxisTitles", type: "text", length: 0, ...placement })
-      .editGraphics({ target: "parallelAxisTitles", property: "fill", value: DEFAULT_COLORS.axisTitle })
-      .editGraphics({ target: "parallelAxisTitles", property: "fontSize", value: 13 })
-      .editGraphics({ target: "parallelAxisTitles", property: "fontFamily", value: DEFAULT_FONT_FAMILY })
-      .editGraphics({ target: "parallelAxisTitles", property: "fontWeight", value: 600 })
-      .editGraphics({ target: "parallelAxisTitles", property: "textAlign", value: "center" })
-      .editGraphics({ target: "parallelAxisTitles", property: "textBaseline", value: "middle" });
-    return next.rematerializeParallelAxes({ target });
   }
-);
+  return next._withGuideConfig("parallel", "axes", { target, scales, ...configs });
+});
 
 export function registerParallelAxisActions(ProgramClass) {
-  ProgramClass.prototype.createParallelAxes = createParallelAxes;
   ProgramClass.prototype.rematerializeParallelAxes = rematerializeParallelAxes;
+  registerParallelAxisLifecycleActions(ProgramClass);
 }

package/src/actions/guides/axes/policy.js

@@ -1,32 +1,15 @@
 import { formatVisibleText } from "../../../core/textMetrics.js";
+import {
+  formatValue,
+  isUtcValueFormat,
+  validateValueFormat
+} from "../../../grammar/valueFormat.js";
 
 const AXIS_POSITIONS = Object.freeze({
   x: Object.freeze(["bottom", "top"]),
   y: Object.freeze(["left", "right"])
 });
 
-const NUMERIC_FORMATS = new Set([
-  ".0f", ".1f", ".2f", ".0%", ".1%", ".2e"
-]);
-const TIME_DIRECTIVES = new Set(["Y", "m", "d", "b", "%"]);
-const MONTH_NAMES = Object.freeze([
-  "Jan", "Feb", "Mar", "Apr", "May", "Jun",
-  "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
-]);
-
-function isTimeFormat(format) {
-  if (typeof format !== "string") return false;
-  let directives = 0;
-  for (let index = 0; index < format.length; index += 1) {
-    if (format[index] !== "%") continue;
-    const directive = format[index + 1];
-    if (!TIME_DIRECTIVES.has(directive)) return false;
-    if (directive !== "%") directives += 1;
-    index += 1;
-  }
-  return directives > 0;
-}
-
 export function defaultAxisPosition(channel) {
   return channel === "x" ? "bottom" : "left";
 }
@@ -113,42 +96,9 @@ export function resolveAxisTitleGeometry({
 }
 
 export function validateAxisFormat(format) {
-  if (format === "auto") return format;
-  if (
-    format !== null &&
-    typeof format === "object" &&
-    Number.isInteger(format.decimals) &&
-    format.decimals >= 0 &&
-    Object.keys(format).length === 1
-  ) {
-    return format;
-  }
-  if (typeof format === "string" && (
-    NUMERIC_FORMATS.has(format) || isTimeFormat(format)
-  )) {
-    return format;
-  }
-  throw new TypeError(
-    "Label format must be auto, { decimals }, or a supported format string."
-  );
-}
-
-function pad(value, length = 2) {
-  return String(value).padStart(length, "0");
-}
-
-function formatTime(value, format) {
-  const date = new Date(value);
-  if (!Number.isFinite(date.getTime())) {
-    throw new TypeError("Time axis format requires valid timestamps.");
-  }
-  const year = pad(date.getUTCFullYear(), 4);
-  const month = pad(date.getUTCMonth() + 1);
-  const day = pad(date.getUTCDate());
-  const values = { Y: year, m: month, d: day, b: MONTH_NAMES[date.getUTCMonth()] };
-  return format.replace(/%([Ymdb%])/g, (_, directive) =>
-    directive === "%" ? "%" : values[directive]
-  );
+  return validateValueFormat(format, "Label format", {
+    allowDecimalsObject: true
+  });
 }
 
 export function formatAxisValue(value, scaleType, format, autoFormatter) {
@@ -158,18 +108,22 @@ export function formatAxisValue(value, scaleType, format, autoFormatter) {
     throw new Error('Discrete axis labels require format "auto".');
   }
   if (scaleType === "time") {
-    if (!isTimeFormat(format)) {
+    if (!isUtcValueFormat(format)) {
       throw new Error("Time axis labels require a supported time format string.");
     }
-    return formatTime(value, format);
+    return formatValue(value, {
+      format,
+      valueType: "temporal",
+      label: "Axis label format"
+    });
   }
-  if (isTimeFormat(format)) {
+  if (isUtcValueFormat(format)) {
     throw new Error("Quantitative axis labels cannot use a time format string.");
   }
-  if (typeof format === "object") return value.toFixed(format.decimals);
-  if (format.endsWith("f")) return value.toFixed(Number(format[1]));
-  if (format.endsWith("%")) {
-    return `${(value * 100).toFixed(Number(format[1]))}%`;
-  }
-  return value.toExponential(2);
+  return formatValue(value, {
+    format,
+    valueType: "quantitative",
+    label: "Axis label format",
+    allowDecimalsObject: true
+  });
 }

package/src/actions/guides/axes/tickGroups.js

@@ -1,3 +1,4 @@
+import { withGuideLayoutValidation } from "../../../materialization/guides/layout.js";
 import { action } from "../../../core/action.js";
 import { isPlainObject } from "../../../core/immutable.js";
 import { validateKeys, validateOptionObject } from "../../../core/validation.js";
@@ -24,7 +25,12 @@ const LABEL_OPTIONS = Object.freeze([
   "color",
   "fontSize",
   "fontFamily",
-  "fontWeight"
+  "fontWeight",
+  "rotation",
+  "maxWidth",
+  "wrap",
+  "lineHeight",
+  "overlap"
 ]);
 const SHARED_CREATE = Object.freeze(["scale", "position", "count", "values"]);
 const SHARED_EDIT = Object.freeze(["position", "count", "values"]);
@@ -37,7 +43,7 @@ function validateNested(value, supported, label) {
   validateKeys(value, supported, label);
 }
 
-function validateArgs(args, operation, create) {
+export function validateAxisTickGroupArgs(args, operation, create) {
   validateOptionObject(
     args,
     create ? CREATE_OPTIONS : EDIT_OPTIONS,
@@ -89,8 +95,8 @@ function makeCreate(channel) {
       op: operation.create,
       description: `Create ${channel}-axis ticks and labels.`
     },
-    function (args = {}) {
-      validateArgs(args, operation.create, true);
+    withGuideLayoutValidation(function (args = {}) {
+      validateAxisTickGroupArgs(args, operation.create, true);
       const shared = select(args, SHARED_CREATE);
       const tickArgs = { ...shared, ...(args.ticks ?? {}) };
       const labelArgs = {
@@ -101,7 +107,7 @@ function makeCreate(channel) {
       return this[operation.createTicks](tickArgs)[operation.createLabels](
         labelArgs
       );
-    }
+    })
   );
 }
 
@@ -113,8 +119,8 @@ function makeEdit(channel) {
       op: operation.edit,
       description: `Edit ${channel}-axis ticks and labels.`
     },
-    function (args = {}) {
-      validateArgs(args, operation.edit, false);
+    withGuideLayoutValidation(function (args = {}) {
+      validateAxisTickGroupArgs(args, operation.edit, false);
       const shared = select(args, SHARED_EDIT);
       const hasShared = Object.keys(shared).length > 0;
       let next = this;
@@ -134,7 +140,7 @@ function makeEdit(channel) {
       }
 
       return next;
-    }
+    })
   );
 }
 

package/src/actions/guides/axes/ticks.js

@@ -1,3 +1,4 @@
+import { withGuideLayoutValidation } from "../../../materialization/guides/layout.js";
 import { action } from "../../../core/action.js";
 import { validateUserId } from "../../../core/identifiers.js";
 import {
@@ -126,7 +127,7 @@ function geometry(program, channel, config) {
 
 function makeEdit(channel) {
   const op = channel === "x" ? "editXAxisTicks" : "editYAxisTicks";
-  return action({ op, description: `Edit concrete ${channel}-axis ticks.` }, function (args = {}) {
+  return action({ op, description: `Edit concrete ${channel}-axis ticks.` }, withGuideLayoutValidation(function (args = {}) {
     validateOptions(args, op, false);
     const id = `${channel}AxisTicks`;
     if (this.graphicSpec.objects[id]?.type !== "line") throw new Error(`${op} requires existing axis ticks.`);
@@ -157,7 +158,7 @@ function makeEdit(channel) {
     let next = this._withGuideConfig(channel, config).editGraphics({ target: id, property: "length", value: resolved.values.length });
     for (const property of ["x1", "y1", "x2", "y2"]) next = next.editGraphics({ target: id, property, value: resolved[property] });
     return next.editGraphics({ target: id, property: "stroke", value: config.color }).editGraphics({ target: id, property: "strokeWidth", value: config.lineWidth });
-  });
+  }));
 }
 
 const editXAxisTicks = makeEdit("x"), editYAxisTicks = makeEdit("y");
@@ -165,7 +166,7 @@ const editXAxisTicks = makeEdit("x"), editYAxisTicks = makeEdit("y");
 function makeCreate(channel) {
   const op = channel === "x" ? "createXAxisTicks" : "createYAxisTicks";
   const edit = channel === "x" ? "editXAxisTicks" : "editYAxisTicks";
-  return action({ op, description: `Create concrete ${channel}-axis ticks.` }, function (args = {}) {
+  return action({ op, description: `Create concrete ${channel}-axis ticks.` }, withGuideLayoutValidation(function (args = {}) {
     validateOptions(args, op, true);
     const scale = validateUserId(args.scale ?? channel, "Scale id");
     const existingGuide = this.semanticSpec.guides.axis?.[channel]?.scale;
@@ -192,7 +193,7 @@ function makeCreate(channel) {
         ...resolvePlotGraphicPlacement(this)
       })
       ._withGuideConfig(channel, config)[edit]();
-  });
+  }));
 }
 
 const createXAxisTicks = makeCreate("x"), createYAxisTicks = makeCreate("y");

package/src/actions/guides/axes/titles.js

@@ -1,3 +1,5 @@
+import { isSourceOwnedText } from "../../../grammar/text.js";
+import { withGuideLayoutValidation } from "../../../materialization/guides/layout.js";
 import { action } from "../../../core/action.js";
 import { validateUserId } from "../../../core/identifiers.js";
 import {
@@ -32,6 +34,7 @@ import {
 import { resolveConcreteGraphicBounds } from
   "../../../grammar/schemas/graphicBounds.js";
 import { validateAxisTextStyle } from "./labels.js";
+import { resolveRotation } from "../../../grammar/rotation.js";
 
 function titleBounds(geometry, config, text) {
   return resolveTextBounds({
@@ -102,7 +105,15 @@ export function inferAxisTitleText(program, channel, scaleId) {
   const titles = new Set();
   const primaryTitles = new Set();
   for (const layer of program.semanticSpec.layers) {
-    const encoding = layer.encoding?.[channel];
+    if (isSourceOwnedText(layer)) continue;
+    const primary = layer.encoding?.[channel];
+    const encoding = layer.mark?.type === "area" && Object.hasOwn(primary ?? {}, "datum")
+      ? layer.encoding?.[`${channel}2`] : primary;
+    if (channel === "radius" && layer.mark?.type === "arc" &&
+      encoding?.scale === scaleId && encoding.aggregate === "count" && encoding.field === undefined) {
+      titles.add(encoding.title ?? "count");
+      continue;
+    }
     if (
       encoding?.scale === scaleId &&
       typeof encoding.field === "string" &&
@@ -193,12 +204,12 @@ function names(channel) {
 
 function makeEdit(channel) {
   const operation = names(channel);
-  return action({ op: operation.edit, description: `Edit the ${channel}-axis title.` }, function (args = {}) {
+  return action({ op: operation.edit, description: `Edit the ${channel}-axis title.` }, withGuideLayoutValidation(function (args = {}) {
       validateKeys(args, EDIT_OPTIONS, operation.edit);
     if (this.graphicSpec.objects[operation.graphic]?.type !== "text") throw new Error(`${operation.edit} requires an existing axis title.`);
     const previous = this.guideConfigs.axis?.[channel]?.title;
     if (!previous) throw new Error(`${operation.edit} requires title configuration.`);
-    const { text, ...appearance } = args;
+    const { text, rotation: requestedRotation, ...appearance } = args;
     const explicitText = Object.hasOwn(args, "text");
     const explicitRotation = Object.hasOwn(args, "rotation");
     const position = appearance.position ?? previous.position;
@@ -211,7 +222,9 @@ function makeEdit(channel) {
       position,
       rotation: inferredRotation
         ? defaultAxisTitleRotation(channel, position)
-        : appearance.rotation ?? previous.rotation,
+        : explicitRotation
+          ? resolveRotation(requestedRotation, "Axis title rotation")
+          : previous.rotation,
       inferredRotation,
       inferredOffset: Object.hasOwn(args, "offset")
         ? false
@@ -245,7 +258,7 @@ function makeEdit(channel) {
     };
     for (const [property, value] of Object.entries(properties)) next = next.editGraphics({ target: operation.graphic, property, value });
     return next;
-  });
+  }));
 }
 
 const editXAxisTitle = makeEdit("x");
@@ -253,7 +266,7 @@ const editYAxisTitle = makeEdit("y");
 
 function makeCreate(channel) {
   const operation = names(channel);
-  return action({ op: operation.create, description: `Create the ${channel}-axis title.` }, function (args = {}) {
+  return action({ op: operation.create, description: `Create the ${channel}-axis title.` }, withGuideLayoutValidation(function (args = {}) {
       validateKeys(args, CREATE_OPTIONS, operation.create);
     const {
       text: requestedText,
@@ -281,7 +294,7 @@ function makeCreate(channel) {
       offset: channel === "x" ? 42 : 52,
       rotation: inferredRotation
         ? defaultAxisTitleRotation(channel, position)
-        : requestedRotation,
+        : resolveRotation(requestedRotation, "Axis title rotation"),
       inferredRotation,
       inferredOffset,
       color: DEFAULTS.color,
@@ -303,7 +316,7 @@ function makeCreate(channel) {
         ...resolvePlotGraphicPlacement(this)
       })
       ._withGuideConfig(channel, "title", config)[operation.edit]();
-  });
+  }));
 }
 
 const createXAxisTitle = makeCreate("x");

package/src/actions/guides/basic.js

@@ -5,6 +5,7 @@ import {
   registerBasicCategoricalLegendActions
 } from "./legends/categorical/index.js";
 import {
+  registerIntervalLegendActions,
   registerGradientLegendActions
 } from "./legends/continuous/index.js";
 import { registerSizeLegendActions } from "./legends/size.js";
@@ -13,6 +14,7 @@ export function registerBasicGuideActions(ProgramClass) {
   registerBasicCartesianAxisActions(ProgramClass);
   registerBasicCategoricalLegendActions(ProgramClass);
   registerGradientLegendActions(ProgramClass);
+  registerIntervalLegendActions(ProgramClass);
   registerSizeLegendActions(ProgramClass);
   registerBasicGridActions(ProgramClass);
   registerGuideCollectionActions(ProgramClass);