ggaction 0.0.17 → 0.0.18

package/src/actions/guides/legends/edit.js

@@ -1,604 +1 @@
-import { withGuideLayoutValidation } from "../../../materialization/guides/layout.js";
-import { resolveLegendStepConfig } from "./creation.js";
-import { normalizeLegendOrder } from "../../../grammar/categoryOrder.js";
-import { resolveDefinition } from "./categorical/resolve.js";
-import { action } from "../../../core/action.js";
-import {
-  validateOptionObject
-} from "../../../core/validation.js";
-import { normalizeOptions } from "./categorical/options.js";
-import { resolveLegendSymbol } from "./categorical/recipes.js";
-import { resolveLayout } from "./categorical/layout.js";
-import { resolveLegendCreationPlan } from "./categorical/actions.js";
-import { categoricalSymbolIds, reconcileCategoricalSymbols, createCategoricalLegendFromConfig, resolveCategoricalLegendRevision, removeLegendKinds } from "./lifecycle.js";
-import { createGradientLegendFromConfig } from "./continuous/gradient.js";
-import {
-  normalizeItemLegendLayout,
-  normalizeLegendBorder,
-  normalizeLegendTextOptions,
-  normalizeLegendTitleOptions,
-  normalizeContinuousLegend,
-  validatePositive
-} from "./continuous/common.js";
-import { normalizeOpacitySymbol, createOpacityLegendFromConfig } from "./continuous/opacity.js";
-import { normalizeIntervalLegend, resolveIntervalConfig, resolveIntervalLayout, createIntervalLegendFromConfig } from "./continuous/interval.js";
-import {
-  createStrokeGradientLegendFromConfig,
-  createStrokeIntervalLegendFromConfig,
-  resolveStrokeIntervalConfig,
-  resolveStrokeIntervalLayout
-} from "./continuous/stroke.js";
-import { findLayer } from "../../../selectors/layers.js";
-import { resolveLegendGraphicPlacement } from
-  "../../../materialization/graphicHierarchy.js";
-import { resolveLegendTarget, validateLegendChannels } from "./target.js";
-import { isDiscreteSizeScaleType } from "../../../grammar/scales/index.js";
-import { SIZE_LEGEND_LABELS, SIZE_LEGEND_TITLE_STYLE, resolveSizeLegendLayout, createSizeLegendFromConfig } from "./size.js";
-import {
-  STROKE_WIDTH_LEGEND_LABELS,
-  STROKE_WIDTH_LEGEND_TITLE_STYLE,
-  resolveStrokeWidthLegendLayout,
-  createStrokeWidthLegendFromConfig
-} from "./strokeWidth.js";
-import { normalizeLegendSampling } from "./sampling.js";
-import { planLegendBlockTransitions } from "./transition.js";
-
-const OPTIONS = Object.freeze([
-  "target", "channels", "position", "layout", "align", "direction", "columns", "offset",
-  "titlePosition", "title", "symbol", "labels", "titleStyle", "itemGap",
-  "border", "count", "values", "gradient", "order"
-]);
-
-function mergeObject(previous, patch) {
-  return patch === undefined
-    ? previous
-    : { ...previous, ...patch };
-}
-
-function mergeBorder(previous, patch) {
-  if (patch === undefined) return previous;
-  if (patch === false || patch === true) return patch;
-  return previous === false ? patch : { ...previous, ...patch };
-}
-
-function reconcileGraphic(program, id, shouldExist, definition) {
-  const exists = program.graphicSpec.objects[id] !== undefined;
-  if (exists && !shouldExist) return program.editGraphics({ target: id, remove: true });
-  if (!exists && shouldExist) {
-    return program.createGraphics({
-      id,
-      ...definition,
-      ...resolveLegendGraphicPlacement(program, {
-        ...(definition.before === undefined ? {} : { before: definition.before }),
-        ...(definition.after === undefined ? {} : { after: definition.after })
-      })
-    });
-  }
-  return program;
-}
-
-function resolveContinuousEdit(program, kind, previous, args) {
-  const gradient = ["gradient", "strokeGradient"].includes(kind);
-  const allowed = gradient
-    ? ["target", "position", "align", "offset", "title", "labels",
-      "titleStyle", "titlePosition", "border", "count", "gradient"]
-    : ["target", "position", "align", "offset", "title", "symbol", "labels",
-      "titleStyle", "titlePosition", "itemGap", "border", "count", "values"];
-  for (const key of Object.keys(args)) {
-    if (!allowed.includes(key)) throw new Error(`${kind} legend does not accept ${key}.`);
-  }
-  const titleMode = args.title;
-  const inferredTitle = titleMode === "auto"
-    ? true
-    : typeof titleMode === "string" ? false : previous.inferredTitle;
-  const titleVisible = titleMode === false ? false
-    : titleMode === undefined ? previous.titleVisible !== false : true;
-  const layer = findLayer(program, previous.target);
-  const channel = kind === "gradient" ? "color"
-    : kind === "strokeGradient" ? "stroke" : "opacity";
-  const inferred = layer?.encoding?.[channel]?.field;
-  const title = titleMode === "auto"
-    ? inferred
-    : typeof titleMode === "string" ? titleMode : previous.title;
-  const titlePosition = args.titlePosition ?? previous.titlePosition;
-  const enteringInline = kind === "opacity" &&
-    titlePosition === "left" && previous.titlePosition !== "left";
-  const labels = mergeObject(previous.labels, args.labels);
-  const sampling = gradient ? undefined : normalizeLegendSampling(args, {
-    previous,
-    operation: "edit",
-    label: "Opacity legend"
-  });
-  const normalized = normalizeContinuousLegend({
-    target: previous.target,
-    position: args.position ?? previous.position,
-    align: args.align ?? previous.align,
-    offset: args.offset ?? previous.offset,
-    ...(gradient ? { count: args.count ?? previous.count } : {}),
-    titlePosition,
-    title,
-    labels: enteringInline && args.labels?.offset === undefined
-      ? { ...labels, offset: 8 }
-      : labels,
-    titleStyle: mergeObject(previous.titleStyle, args.titleStyle),
-    border: mergeBorder(previous.border, args.border),
-    ...(kind === "opacity" ? {
-      itemGap: args.itemGap ?? (enteringInline ? 20 : previous.itemGap),
-      symbol: args.symbol ?? previous.symbol
-    } : {})
-  }, gradient ? "gradient" : kind);
-  const { count: _legacyCount, ...canonicalPrevious } = previous;
-  const config = {
-    ...(gradient ? previous : canonicalPrevious),
-    ...normalized,
-    ...(gradient ? {} : { sampling }),
-    inferredTitle,
-    titleVisible
-  };
-  if (gradient) {
-    const gradient = mergeObject(previous.gradient, args.gradient);
-    validatePositive(gradient.length, "Gradient length");
-    validatePositive(gradient.thickness, "Gradient thickness");
-    config.gradient = gradient;
-  } else {
-    config.symbol = normalizeOpacitySymbol(args.symbol ?? previous.symbol);
-  }
-  return { config, titleMode, title, titleVisible };
-}
-
-function editContinuous(program, kind, previous, args) {
-  const { config, titleMode, title, titleVisible } = resolveContinuousEdit(program, kind, previous, args);
-  const prefix = kind === "gradient" ? "colorGradient"
-    : kind === "strokeGradient" ? "strokeGradient" : "opacityLegend";
-  const semanticKind = kind === "gradient" ? "color"
-    : kind === "strokeGradient" ? "stroke" : "opacity";
-  let next = program;
-  if (titleMode === "auto" || typeof titleMode === "string") {
-    next = next.editSemantic({
-      property: `guide.legend.${semanticKind}.title`,
-      value: title
-    });
-  }
-  next = next._withLegendConfig(kind, config);
-  next = reconcileGraphic(next, `${prefix}Background`, config.border !== false, {
-    type: "rect",
-    before: ["gradient", "strokeGradient"].includes(kind)
-      ? `${prefix}Strips`
-      : "opacityLegendSymbols"
-  });
-  next = reconcileGraphic(next, `${prefix}Title`, titleVisible, { type: "text" });
-  return next.rematerializeLegend();
-}
-
-function resolveIntervalEdit(program, previous, args, channel = "color") {
-  for (const key of Object.keys(args)) {
-    if (![
-      "target", "position", "align", "direction", "offset", "title",
-      "symbol", "labels", "titleStyle", "itemGap", "border", "layout", "columns", "titlePosition"
-    ].includes(key)) {
-      throw new Error(`interval legend does not accept ${key}.`);
-    }
-  }
-  const titleMode = args.title;
-  const layer = findLayer(program, previous.target);
-  const inferredTitle = titleMode === "auto"
-    ? true
-    : typeof titleMode === "string" ? false : previous.inferredTitle;
-  const titleVisible = titleMode === false
-    ? false
-    : titleMode === undefined ? previous.titleVisible !== false : true;
-  const title = titleMode === "auto"
-    ? layer?.encoding?.[channel]?.field
-    : typeof titleMode === "string" ? titleMode : previous.title;
-  const normalized = normalizeIntervalLegend({
-    target: previous.target,
-    position: args.position ?? previous.position,
-    align: args.align ?? previous.align,
-    direction: args.direction ?? (args.position !== undefined && args.position !== previous.position
-      ? undefined : previous.direction),
-    layout: args.layout === undefined ? previous.layout : args.layout,
-    columns: args.columns ?? previous.columns,
-    titlePosition: args.titlePosition ?? previous.titlePosition,
-    offset: args.offset ?? previous.offset,
-    title,
-    symbol: mergeObject(previous.symbol, args.symbol),
-    labels: mergeObject(previous.labels, args.labels),
-    titleStyle: mergeObject(previous.titleStyle, args.titleStyle),
-    itemGap: args.itemGap ?? previous.itemGap,
-    border: mergeBorder(previous.border, args.border)
-  });
-  const config = {
-    ...previous,
-    ...normalized,
-    inferredTitle,
-    titleVisible,
-    ...(channel === "stroke" && args.symbol?.strokeWidth !== undefined
-      ? { inferredStrokeWidth: false }
-      : {})
-  };
-  const resolved = channel === "stroke"
-    ? resolveStrokeIntervalConfig(program, config)
-    : resolveIntervalConfig(program, config);
-  (channel === "stroke" ? resolveStrokeIntervalLayout : resolveIntervalLayout)(
-    program,
-    resolved.config,
-    resolved.scale
-  );
-  return { normalized, config, titleMode, title, titleVisible };
-}
-
-function editInterval(program, previous, args, channel = "color") {
-  const kind = channel === "stroke" ? "strokeInterval" : "interval";
-  const prefix = channel === "stroke" ? "strokeInterval" : "colorLegend";
-  const { normalized, config, titleMode, title, titleVisible } = resolveIntervalEdit(program, previous, args, channel);
-  let next = program._withLegendConfig(kind, config);
-  if (titleMode === "auto" || typeof titleMode === "string") {
-    next = next.editSemantic({
-      property: `guide.legend.${channel}.title`,
-      value: title
-    });
-  }
-  next = reconcileGraphic(next, `${prefix}Title`, titleVisible, {
-    type: "text"
-  });
-  next = reconcileGraphic(
-    next,
-    `${prefix}Background`,
-    normalized.border !== false,
-    { type: "rect", before: `${prefix}Symbols` }
-  );
-  return next.rematerializeLegend();
-}
-
-function resolveSampledLegendEdit(program, kind, previous, args) {
-  const size = kind === "size";
-  const label = size ? "size" : "stroke-width";
-  const allowed = ["target", "title", "count", "values", "labels", "titleStyle",
-    "position", "layout", "align", "direction", "columns", "titlePosition", "offset", "itemGap", "border"];
-  for (const key of Object.keys(args)) {
-    if (!allowed.includes(key)) {
-      throw new Error(`${label} legend does not accept ${key}.`);
-    }
-  }
-  const discrete = size &&
-    isDiscreteSizeScaleType(program.resolvedScales[previous.scale]?.type);
-  if (discrete && (args.count !== undefined || args.values !== undefined)) {
-    throw new Error("Discrete size legends do not support count or exact values.");
-  }
-  const sampling = discrete ? undefined : normalizeLegendSampling(args, {
-    previous,
-    operation: "edit",
-    label: `${size ? "Size" : "Stroke-width"} legend`
-  });
-  const layer = findLayer(program, previous.target);
-  const titleMode = args.title;
-  const inferredTitle = titleMode === "auto"
-    ? true
-    : typeof titleMode === "string" ? false : previous.inferredTitle;
-  const titleVisible = titleMode === false
-    ? false
-    : titleMode === undefined ? previous.titleVisible !== false : true;
-  const title = titleMode === "auto"
-    ? layer?.encoding?.[kind]?.field
-    : typeof titleMode === "string" ? titleMode : previous.title;
-  const { count: _legacyCount, ...continuousPrevious } = previous;
-  const canonicalPrevious = discrete ? previous : continuousPrevious;
-  const config = {
-    ...canonicalPrevious,
-    title,
-    inferredTitle,
-    titleVisible,
-    ...(discrete ? {} : { sampling }),
-    ...(size ? { inheritAppearance: false } : {}),
-    labels: normalizeLegendTextOptions(
-      args.labels,
-      "editLegend.labels",
-      previous.labels ?? (size ? SIZE_LEGEND_LABELS : STROKE_WIDTH_LEGEND_LABELS)
-    ),
-    titleStyle: normalizeLegendTitleOptions(
-      args.titleStyle,
-      "editLegend.titleStyle",
-      previous.titleStyle ?? (size ? SIZE_LEGEND_TITLE_STYLE : STROKE_WIDTH_LEGEND_TITLE_STYLE)
-    )
-  };
-  Object.assign(config, normalizeItemLegendLayout({ ...previous, ...args,
-    direction: args.direction ?? (args.position !== undefined && args.position !== previous.position
-      ? undefined : previous.direction) }));
-  config.border = normalizeLegendBorder(mergeBorder(previous.border, args.border));
-  (size ? resolveSizeLegendLayout : resolveStrokeWidthLegendLayout)(program, config);
-  return { config, titleMode, title, titleVisible };
-}
-
-function editSampledLegend(program, kind, previous, args) {
-  const { config, titleMode, title, titleVisible } = resolveSampledLegendEdit(program, kind, previous, args);
-  const prefix = kind === "size" ? "sizeLegend" : "strokeWidthLegend";
-  let next = program;
-  if (titleMode === "auto" || typeof titleMode === "string") {
-    next = next.editSemantic({
-      property: `guide.legend.${kind}.title`,
-      value: title
-    });
-  }
-  next = next._withLegendConfig(kind, config);
-  next = reconcileGraphic(next, `${prefix}Background`, config.border !== false, {
-    type: "rect", before: `${prefix}Symbols`
-  });
-  next = reconcileGraphic(next, `${prefix}Title`, titleVisible, {
-    type: "text", after: `${prefix}Labels`
-  });
-  return next.rematerializeLegend();
-}
-
-function resolveCompanionSizeEdit(program, previous, size, args) {
-  if (size === undefined) return undefined;
-  const discrete = isDiscreteSizeScaleType(
-    program.resolvedScales[size.scale]?.type
-  );
-  if (discrete && (args.count !== undefined || args.values !== undefined)) {
-    throw new Error("Discrete size legends do not support count or exact values.");
-  }
-  const sampling = discrete ? undefined : normalizeLegendSampling(args, {
-    previous: size,
-    operation: "edit",
-    label: "Size legend"
-  });
-  const { count: _legacyCount, ...continuousSize } = size;
-  const canonicalSize = discrete ? size : continuousSize;
-  const config = {
-    ...canonicalSize,
-    ...(discrete ? {} : { sampling })
-  };
-  if (args.labels === undefined && args.titleStyle === undefined) return config;
-  const labels = size.inheritAppearance
-    ? { ...previous.labels, offset: size.labels.offset } : size.labels ?? SIZE_LEGEND_LABELS;
-  const titleStyle = size.inheritAppearance
-    ? previous.titleStyle : size.titleStyle ?? SIZE_LEGEND_TITLE_STYLE;
-  return { ...config, inheritAppearance: false,
-    labels: normalizeLegendTextOptions(args.labels, "editLegend.labels", labels),
-    titleStyle: normalizeLegendTitleOptions(args.titleStyle, "editLegend.titleStyle", titleStyle) };
-}
-
-function resolveCategoricalEdit(program, kind, previous, size, args, storedOrder = program.semanticSpec.guides.legend?.[kind]?.order) {
-  if (args.values !== undefined) {
-    throw new Error(
-      "Combined and categorical legends require a channel block selector for exact values."
-    );
-  }
-  if (args.gradient !== undefined) {
-    throw new Error("Categorical legends do not accept gradient.");
-  }
-  if (args.count !== undefined && size === undefined) {
-    throw new Error("Legend count requires an existing size legend.");
-  }
-  const titleMode = args.title;
-  const inferredTitle = titleMode === "auto"
-    ? true
-    : typeof titleMode === "string" ? false : previous.inferredTitle;
-  const titleVisible = titleMode === false ? false
-    : titleMode === undefined ? previous.titleVisible !== false : true;
-  const title = titleMode === "auto"
-    ? previous.field
-    : typeof titleMode === "string" ? titleMode : previous.title;
-  const mergedLabels = mergeObject(previous.labels, args.labels);
-  if (mergedLabels.format !== undefined && mergedLabels.format !== "auto" && size === undefined) {
-    throw new Error("Categorical legend labels do not accept format.");
-  }
-  const { format: _sizeFormat, ...categoricalLabels } = mergedLabels;
-  const inferredSymbol = args.symbol === undefined
-    ? previous.inferredSymbol
-    : args.symbol === "auto";
-  const normalized = normalizeOptions({
-    target: previous.target,
-    channels: previous.channels,
-    layout: args.layout === undefined ? previous.layout : args.layout,
-    position: args.position ?? previous.position,
-    align: args.align ?? previous.align,
-    direction: args.direction ?? (args.position !== undefined && args.position !== previous.position
-      ? undefined : previous.direction),
-    ...(args.columns === undefined && previous.columns === undefined
-      ? {} : { columns: args.columns ?? previous.columns }),
-    offset: args.offset ?? previous.offset,
-    titlePosition: args.titlePosition ?? previous.titlePosition,
-    title,
-    symbol: args.symbol === undefined ? previous.symbol
-      : resolveLegendSymbol(
-          program,
-          findLayer(program, previous.target),
-          previous.channels,
-          args.symbol,
-          kind
-        ),
-    labels: categoricalLabels,
-    titleStyle: mergeObject(previous.titleStyle, args.titleStyle),
-    itemGap: args.itemGap ?? previous.itemGap,
-    border: mergeBorder(previous.border, args.border)
-  }, kind, { internalSymbol: inferredSymbol });
-  const config = {
-    ...previous,
-    ...normalized,
-    inferredTitle,
-    inferredSymbol,
-    titleVisible
-  };
-  const order = args.order === undefined
-    ? storedOrder
-    : normalizeLegendOrder(args.order);
-  // Resolve the final domain before changing semantic/config/graphic state.
-  resolveDefinition(program, findLayer(program, previous.target), previous.channels, title, order);
-  return { config, order, titleMode, title, titleVisible, sizeConfig: resolveCompanionSizeEdit(program, previous, size, args) };
-}
-
-function editCategorical(program, kind, previous, size, args) {
-  const { config, order, titleMode, title, titleVisible, sizeConfig } = resolveCategoricalEdit(program, kind, previous, size, args);
-  const newSymbols = categoricalSymbolIds(config);
-  let next = program;
-  if (titleMode === "auto" || typeof titleMode === "string") {
-    next = next.editSemantic({
-      property: `guide.legend.${kind}.title`,
-      value: title
-    });
-  }
-  if (args.order !== undefined) {
-    if (order === "scale") {
-      if (program.semanticSpec.guides.legend?.[kind]?.order !== undefined) {
-        next = next.editSemantic({ property: `guide.legend.${kind}.order`, remove: true });
-      }
-    } else {
-      next = next.editSemantic({ property: `guide.legend.${kind}.order`, value: order });
-    }
-  }
-  next = next._withLegendConfig(kind, config);
-  next = reconcileCategoricalSymbols(next, previous, config);
-  next = reconcileGraphic(next, `${kind}LegendBackground`,
-    config.border !== false, {
-      type: "rect",
-      before: [...newSymbols][0]
-    });
-  const titleId = `${kind}LegendTitle`;
-  next = reconcileGraphic(next, titleId, titleVisible, {
-    type: "text",
-    ...(next.graphicSpec.objects.sizeLegendSymbols === undefined
-      ? {} : { before: next.graphicSpec.objects.sizeLegendBackground === undefined
-        ? "sizeLegendSymbols" : "sizeLegendBackground" })
-  });
-  if (size !== undefined) {
-    next = next._withLegendConfig("size", sizeConfig);
-  }
-  return next.rematerializeLegend();
-}
-
-
-function editLegendContent(program, target, args) {
-  validateLegendChannels(args.channels, "editLegend");
-  const { channels, target: _target, ...patch } = args;
-  const previous = program.guideConfigs.legend ?? {};
-  const removed = Object.keys(previous).filter(kind => previous[kind].target === target);
-  let view = removed.reduce((next, kind) => next._withoutMaterializationConfig(["guides", "legend", kind]), program);
-  const creation = resolveLegendCreationPlan(view, { target, channels });
-  const oldCategorical = removed.find(kind =>
-    ["series", "color", "stroke"].includes(kind)
-  );
-  let plans = creation.steps.map(step => {
-    const descriptor = resolveLegendStepConfig(view, step);
-    const { kind } = descriptor;
-    if (previous[kind] !== undefined && previous[kind].target !== target) {
-      throw new Error(`Legend ${kind} content already belongs to another target.`);
-    }
-    if (["series", "color", "stroke"].includes(kind) && oldCategorical !== undefined) {
-      const order = patch.order === undefined ? program.semanticSpec.guides.legend?.[oldCategorical]?.order
-        : normalizeLegendOrder(patch.order);
-      return { ...resolveCategoricalLegendRevision(view, oldCategorical, previous[oldCategorical],
-        descriptor.config.channels, { order, validateLayout: false }), kind };
-    }
-    return { ...descriptor, config: previous[kind]?.target === target ? previous[kind] : descriptor.config };
-  });
-  const categorical = plans.find(plan =>
-    ["series", "color", "stroke"].includes(plan.kind)
-  );
-  const size = plans.find(plan => plan.kind === "size");
-  if (categorical !== undefined) {
-    if (size !== undefined && previous.size?.target !== target) {
-      size.config = { ...size.config, inheritAppearance: categorical.config.position === "left" ||
-        patch.position === "left" || patch.labels !== undefined || patch.titleStyle !== undefined };
-    }
-    const edited = resolveCategoricalEdit(view, categorical.kind, categorical.config, size?.config, patch, categorical.order);
-    categorical.config = edited.config;
-    categorical.order = edited.order;
-    if (size !== undefined) {
-      size.config = edited.sizeConfig;
-      if (categorical.config.layout === "legacy-bottom") {
-        throw new Error('Combined size legends require layout "edge".');
-      }
-    }
-  } else {
-    const plan = plans[0];
-    if (plan.kind === "size" || plan.kind === "strokeWidth") {
-      plan.config = resolveSampledLegendEdit(view, plan.kind, plan.config, patch).config;
-    } else if (["interval", "strokeInterval"].includes(plan.kind)) {
-      plan.config = resolveIntervalEdit(
-        view,
-        plan.config,
-        patch,
-        plan.kind === "strokeInterval" ? "stroke" : "color"
-      ).config;
-    }
-    else plan.config = resolveContinuousEdit(view, plan.kind, plan.config, patch).config;
-  }
-  plans = planLegendBlockTransitions(program, target, plans);
-  // The complete final content and styles are validated before removing resources.
-  for (const { kind, config } of plans) view = view._withLegendConfig(kind, config);
-  if (categorical !== undefined) resolveLayout(view, categorical.config);
-  let next = removeLegendKinds(program, removed);
-  for (const { kind, config, order } of plans) {
-    if (["series", "color", "stroke"].includes(kind)) {
-      next = createCategoricalLegendFromConfig(next, config, order);
-    }
-    else next = ({ size: createSizeLegendFromConfig, strokeWidth: createStrokeWidthLegendFromConfig,
-      gradient: createGradientLegendFromConfig, opacity: createOpacityLegendFromConfig,
-      interval: createIntervalLegendFromConfig,
-      strokeGradient: createStrokeGradientLegendFromConfig,
-      strokeInterval: createStrokeIntervalLegendFromConfig })[kind](next, config);
-  }
-  return next.rematerializeLegend();
-}
-
-export const editLegend = /* @__PURE__ */ action(
-  { op: "editLegend", description: "Edit one stable legend content, layout or appearance." },
-  withGuideLayoutValidation(function (args = {}) {
-    validateOptionObject(args, OPTIONS, "editLegend");
-    const changes = Object.keys(args).filter(key => key !== "target");
-    if (changes.length === 0) {
-      throw new Error("editLegend requires at least one change.");
-    }
-    if (args.title !== undefined && args.title !== false && args.title !== "auto" && (
-      typeof args.title !== "string" || args.title.length === 0
-    )) {
-      throw new TypeError('editLegend title must be a non-empty string, "auto", or false.');
-    }
-    const target = resolveLegendTarget(this, args.target, "editLegend");
-    if (args.channels !== undefined) return editLegendContent(this, target, args);
-    const configs = this.guideConfigs.legend ?? {};
-    const ownedKinds = Object.keys(configs).filter(
-      kind => configs[kind]?.target === target
-    );
-    if (args.values !== undefined && ownedKinds.length > 1) {
-      throw new Error(
-        "A target with multiple legend blocks requires a channel block selector for exact values."
-      );
-    }
-    const categoricalKinds = ["series", "color", "stroke"].filter(
-      kind => configs[kind]?.target === target
-    );
-    if (categoricalKinds.length > 1) {
-      throw new Error(
-        "editLegend requires channels when a target owns multiple categorical legend blocks."
-      );
-    }
-    const categoricalKind = categoricalKinds[0];
-    if (categoricalKind !== undefined) {
-      return editCategorical(
-        this,
-        categoricalKind,
-        configs[categoricalKind],
-        configs.size?.target === target ? configs.size : undefined,
-        args
-      );
-    }
-    if (configs.interval?.target === target) {
-      return editInterval(this, configs.interval, args);
-    }
-    if (configs.strokeInterval?.target === target) {
-      return editInterval(this, configs.strokeInterval, args, "stroke");
-    }
-    if (configs.strokeWidth?.target === target) {
-      return editSampledLegend(this, "strokeWidth", configs.strokeWidth, args);
-    }
-    if (configs.size?.target === target) {
-      return editSampledLegend(this, "size", configs.size, args);
-    }
-    const continuousKind = ["gradient", "strokeGradient", "opacity"].find(
-      kind => configs[kind]?.target === target
-    );
-    return editContinuous(this, continuousKind, configs[continuousKind], args);
-  })
-);
+import{mergeLegendTitleStyle as G}from"../../../grammar/legendTitleStyle.js";import{recordLegendOffsetIntent as X}from"./group.js";import{prepareLegendGroup as v}from"./group.js";import{PLOT_LEGEND_POSITIONS as $}from"../../../layout/legend.js";import{withGuideLayoutValidation as ee}from"../../../materialization/guides/layout.js";import{resolveLegendStepConfig as te}from"./creation.js";import{normalizeLegendOrder as j}from"../../../grammar/categoryOrder.js";import{resolveDefinition as ne}from"./categorical/resolve.js";import{action as oe}from"../../../core/action.js";import{validateOptionObject as x}from"../../../core/validation.js";import{normalizeLegendOverflow as V,normalizeOptions as ie}from"./categorical/options.js";import{resolveLegendSymbol as le}from"./categorical/recipes.js";import{resolveLayout as re}from"./categorical/layout.js";import{resolveLegendCreationPlan as de}from"./categorical/actions.js";import{categoricalSymbolIds as ce,reconcileCategoricalSymbols as se,createCategoricalLegendFromConfig as fe,resolveCategoricalLegendRevision as ae,removeLegendKinds as W}from"./lifecycle.js";import{normalizeColorSymbols as ue}from"./continuous/colorSymbols.js";import{readLegendSampling as me}from"./sampling.js";import{createGradientLegendFromConfig as M}from"./continuous/gradient.js";import{normalizeLegendGradient as B}from"../../../grammar/legendGradient.js";import{normalizeItemLegendLayout as ge,normalizeLegendBorder as ye,normalizeLegendTextOptions as q,normalizeLegendTitleOptions as D,normalizeContinuousLegend as A}from"./continuous/common.js";import{normalizeOpacitySymbol as be,createOpacityLegendFromConfig as pe}from"./continuous/opacity.js";import{normalizeIntervalLegend as Le,resolveIntervalConfig as Se,resolveIntervalLayout as he,createIntervalLegendFromConfig as we}from"./continuous/interval.js";import{createStrokeGradientLegendFromConfig as ke,createStrokeIntervalLegendFromConfig as ze,resolveStrokeIntervalConfig as Ee,resolveStrokeIntervalLayout as Ce}from"./continuous/stroke.js";import{findLayer as z}from"../../../selectors/layers.js";import{resolveLegendGraphicPlacement as Ge}from"../../../materialization/graphicHierarchy.js";import{resolveLegendTarget as Oe,validateLegendChannels as _e}from"./target.js";import{isEnumeratedSizeScaleType as F}from"../../../grammar/scales/index.js";import{SIZE_LEGEND_LABELS as K,SIZE_LEGEND_TITLE_STYLE as N,resolveSizeLegendLayout as Te,createSizeLegendFromConfig as Ie}from"./size.js";import{STROKE_WIDTH_LEGEND_LABELS as Pe,STROKE_WIDTH_LEGEND_TITLE_STYLE as $e,resolveStrokeWidthLegendLayout as je,createStrokeWidthLegendFromConfig as xe}from"./strokeWidth.js";import{normalizeLegendSampling as O}from"./sampling.js";import{planLegendBlockTransitions as Ve}from"./transition.js";const We=Object.freeze(["target","channels","position","layout","align","direction","columns","offset","titlePosition","title","symbol","labels","titleStyle","itemGap","border","count","values","gradient","representation","order","overflow","blockLayout","at"]);function E(o,t){return t===void 0?o:{...o,...t}}function C(o,t){return t===void 0?o:t===!1||t===!0||o===!1?t:{...o,...t}}function k(o,t,e,n){const l=o.graphicSpec.objects[t]!==void 0;return l&&!e?o.editGraphics({target:t,remove:!0}):!l&&e?o.createGraphics({id:t,...n,...Ge(o,{...n.before===void 0?{}:{before:n.before},...n.after===void 0?{}:{after:n.after}})}):o}function Me(o,t,e){const n=e.representation??t.representation??"gradient";if(!["gradient","symbols"].includes(n))throw new Error("Legend representation must be gradient or symbols.");const l=["target","representation","position","align","offset","title","labels","titleStyle","titlePosition","border","count",...n==="symbols"?["symbol","values","itemGap","layout","direction","columns"]:["gradient"]];for(const y of Object.keys(e))if(!l.includes(y))throw new Error(`Color ${n} legend does not accept ${y}.`);const d=(t.representation??"gradient")!==n,i=e.title,m=i==="auto"?z(o,t.target)?.encoding?.color?.field:typeof i=="string"?i:t.title,s={target:t.target,position:e.position??t.position,align:e.align??t.align,offset:e.offset??t.offset,title:m,labels:E(t.labels,e.labels),titleStyle:G(t.titleStyle,e.titleStyle,{edit:!0}),border:C(t.border,e.border),titlePosition:e.titlePosition??(d&&n==="gradient"?"top":t.titlePosition)};let u;if(n==="symbols"){e.symbol!==void 0&&e.symbol!=="auto"&&x(e.symbol,["type","radius","stroke","strokeWidth"],"Sampled color symbol");const y=d?{count:t.count}:{};for(const w of["values","count"])Object.hasOwn(e,w)&&(y[w]=e[w]);Object.hasOwn(e,"values")&&delete y.count,Object.hasOwn(e,"count")&&(y.count=e.count),u=ue({...s,...y,layout:e.layout??(d?void 0:t.layout),direction:e.direction??(d||e.position!==void 0&&e.position!==t.position?void 0:t.direction),columns:e.columns??(d?void 0:t.columns),itemGap:e.itemGap??(d?void 0:t.itemGap),symbol:e.symbol==="auto"?"auto":e.symbol===void 0?d?void 0:t.symbol:{...d?{}:t.symbol,...e.symbol}},d?{count:t.count}:t,"edit")}else{u=A({...s,count:e.count??(d?me(t).count:t.count)},"gradient");const y=B(e.gradient,d?void 0:t.gradient);u.gradient=y}const{representation:f,sampling:a,symbol:c,layout:b,direction:S,columns:h,gradient:r,count:p,...g}=t,L=d&&n==="gradient"&&t.blockOverrides!==void 0?Object.fromEntries(Object.entries(t.blockOverrides).map(([y,w])=>{const{symbol:qe,labelMap:De,...U}=w;return[y,U]})):t.blockOverrides;return{config:{...g,...u,...L===void 0?{}:{blockOverrides:L},inferredTitle:i==="auto"?!0:typeof i=="string"?!1:t.inferredTitle,titleVisible:i===!1?!1:i===void 0?t.titleVisible!==!1:!0},titleMode:i,title:m,titleVisible:i===!1?!1:i===void 0?t.titleVisible!==!1:!0}}function _(o,t,e,n){if(t==="gradient"&&(e.representation==="symbols"||n.representation!==void 0))return Me(o,e,n);const l=["gradient","strokeGradient"].includes(t),d=l?["target","position","align","offset","title","labels","titleStyle","titlePosition","border","count","gradient","representation"]:["target","position","align","offset","title","symbol","labels","titleStyle","titlePosition","itemGap","border","count","values"];for(const w of Object.keys(n))if(!d.includes(w))throw new Error(`${t} legend does not accept ${w}.`);const i=n.title,m=i==="auto"?!0:typeof i=="string"?!1:e.inferredTitle,s=i===!1?!1:i===void 0?e.titleVisible!==!1:!0,u=z(o,e.target),f=t==="gradient"?"color":t==="strokeGradient"?"stroke":"opacity",a=u?.encoding?.[f]?.field,c=i==="auto"?a:typeof i=="string"?i:e.title,b=n.titlePosition??e.titlePosition,S=t==="opacity"&&b==="left"&&e.titlePosition!=="left",h=E(e.labels,n.labels),r=l?void 0:O(n,{previous:e,operation:"edit",label:"Opacity legend"}),p=A({target:e.target,position:n.position??e.position,align:n.align??e.align,offset:n.offset??e.offset,...l?{count:n.count??e.count}:{},titlePosition:b,title:c,labels:S&&n.labels?.offset===void 0?{...h,offset:8}:h,titleStyle:G(e.titleStyle,n.titleStyle,{edit:!0}),border:C(e.border,n.border),...t==="opacity"?{itemGap:n.itemGap??(S?20:e.itemGap),symbol:n.symbol??e.symbol}:{}},l?"gradient":t),{count:g,...L}=e,y={...l?e:L,...p,...l?{}:{sampling:r},inferredTitle:m,titleVisible:s};if(l){const w=B(n.gradient,e.gradient);y.gradient=w}else y.symbol=be(n.symbol??e.symbol);return{config:y,titleMode:i,title:c,titleVisible:s}}function T(o,t,e,n){const{config:l,titleMode:d,title:i,titleVisible:m}=_(o,t,e,n);if(t==="gradient"&&(e.representation??"gradient")!==(l.representation??"gradient"))return M(W(o,[t]),l).rematerializeLegend();const s=t==="gradient"?"colorGradient":t==="strokeGradient"?"strokeGradient":"opacityLegend",u=t==="gradient"?"color":t==="strokeGradient"?"stroke":"opacity";let f=o;return(d==="auto"||typeof d=="string")&&(f=f.editSemantic({property:`guide.legend.${u}.title`,value:i})),f=f._withLegendConfig(t,l),f=k(f,`${s}Background`,l.border!==!1,{type:"rect",before:["gradient","strokeGradient"].includes(t)?`${s}${l.representation==="symbols"?"Symbols":"Strips"}`:"opacityLegendSymbols"}),f=k(f,`${s}Title`,m,{type:"text"}),f.rematerializeLegend()}function R(o,t,e,n="color"){for(const c of Object.keys(e))if(!["target","position","align","direction","offset","title","symbol","labels","titleStyle","itemGap","border","layout","columns","titlePosition"].includes(c))throw new Error(`interval legend does not accept ${c}.`);const l=e.title,d=z(o,t.target),i=l==="auto"?!0:typeof l=="string"?!1:t.inferredTitle,m=l===!1?!1:l===void 0?t.titleVisible!==!1:!0,s=l==="auto"?d?.encoding?.[n]?.field:typeof l=="string"?l:t.title,u=Le({target:t.target,position:e.position??t.position,align:e.align??t.align,direction:e.direction??(e.position!==void 0&&e.position!==t.position?void 0:t.direction),layout:e.layout===void 0?t.layout:e.layout,columns:e.columns??t.columns,titlePosition:e.titlePosition??t.titlePosition,offset:e.offset??t.offset,title:s,symbol:E(t.symbol,e.symbol),labels:E(t.labels,e.labels),titleStyle:G(t.titleStyle,e.titleStyle,{edit:!0}),itemGap:e.itemGap??t.itemGap,border:C(t.border,e.border)}),f={...t,...u,inferredTitle:i,titleVisible:m,...n==="stroke"&&e.symbol?.strokeWidth!==void 0?{inferredStrokeWidth:!1}:{}},a=n==="stroke"?Ee(o,f):Se(o,f);return(n==="stroke"?Ce:he)(o,a.config,a.scale),{normalized:u,config:f,titleMode:l,title:s,titleVisible:m}}function I(o,t,e,n="color"){const l=n==="stroke"?"strokeInterval":"interval",d=n==="stroke"?"strokeInterval":"colorLegend",{normalized:i,config:m,titleMode:s,title:u,titleVisible:f}=R(o,t,e,n);let a=o._withLegendConfig(l,m);return(s==="auto"||typeof s=="string")&&(a=a.editSemantic({property:`guide.legend.${n}.title`,value:u})),a=k(a,`${d}Title`,f,{type:"text"}),a=k(a,`${d}Background`,i.border!==!1,{type:"rect",before:`${d}Symbols`}),a.rematerializeLegend()}function H(o,t,e,n,l=!1){const d=t==="size",i=d?"size":"stroke-width",m=["target","title","count","values","labels","titleStyle","position","layout","align","direction","columns","titlePosition","offset","itemGap","border"];d&&m.push("overflow");for(const y of Object.keys(n))if(!m.includes(y))throw new Error(`${i} legend does not accept ${y}.`);const s=d&&F(o.resolvedScales[e.scale]?.type),u=d&&o.resolvedScales[e.scale]?.type==="ordinal";if(n.overflow!==void 0&&!u)throw new Error("Size legend overflow requires an ordinal scale.");if(s&&(n.count!==void 0||n.values!==void 0))throw new Error("Discrete size legends do not support count or exact values.");const f=s?void 0:O(n,{previous:e,operation:"edit",label:`${d?"Size":"Stroke-width"} legend`}),a=z(o,e.target),c=n.title,b=c==="auto"?!0:typeof c=="string"?!1:e.inferredTitle,S=c===!1?!1:c===void 0?e.titleVisible!==!1:!0,h=c==="auto"?a?.encoding?.[t]?.field:typeof c=="string"?c:e.title,{count:r,...p}=e,L={...s?e:p,title:h,inferredTitle:b,titleVisible:S,...s?{}:{sampling:f},...u&&(n.overflow!==void 0||e.overflow!==void 0)?{overflow:V(n.overflow===void 0?e.overflow:n.overflow)}:{},...d?{inheritAppearance:l&&e.inheritAppearance===!0,...n.position===void 0?{}:{inheritPosition:!1}}:{},labels:q(n.labels,"editLegend.labels",e.labels??(d?K:Pe)),titleStyle:D(n.titleStyle,"editLegend.titleStyle",e.titleStyle??(d?N:$e),!0)};return Object.assign(L,ge({...e,...n,titleStyle:L.titleStyle,direction:n.direction??(n.position!==void 0&&n.position!==e.position?void 0:e.direction)})),L.border=ye(C(e.border,n.border)),(d?Te:je)(o,L),{config:L,titleMode:c,title:h,titleVisible:S}}function P(o,t,e,n,l=!1){const{config:d,titleMode:i,title:m,titleVisible:s}=H(o,t,e,n,l),u=t==="size"?"sizeLegend":"strokeWidthLegend";let f=o;return(i==="auto"||typeof i=="string")&&(f=f.editSemantic({property:`guide.legend.${t}.title`,value:m})),f=f._withLegendConfig(t,d),f=k(f,`${u}Background`,d.border!==!1,{type:"rect",before:`${u}Symbols`}),f=k(f,`${u}Title`,s,{type:"text",after:`${u}Labels`}),f.rematerializeLegend()}function Be(o,t,e,n){if(e===void 0)return;const l=F(o.resolvedScales[e.scale]?.type);if(l&&(n.count!==void 0||n.values!==void 0))throw new Error("Discrete size legends do not support count or exact values.");const d=l?void 0:O(n,{previous:e,operation:"edit",label:"Size legend"}),{count:i,...m}=e,u={...l?e:m,...l?{}:{sampling:d},...n.overflow!==void 0&&o.resolvedScales[e.scale]?.type==="ordinal"?{overflow:V(n.overflow)}:{}};if(n.labels===void 0&&n.titleStyle===void 0)return u;const f=e.inheritAppearance?{...t.labels,offset:e.labels.offset}:e.labels??K,a=e.inheritAppearance?t.titleStyle:e.titleStyle??N;return{...u,inheritAppearance:!1,labels:q(n.labels,"editLegend.labels",f),titleStyle:D(n.titleStyle,"editLegend.titleStyle",a,!0)}}function Y(o,t,e,n,l,d=o.semanticSpec.guides.legend?.[t]?.order){if(l.values!==void 0)throw new Error("Combined and categorical legends require a channel block selector for exact values.");if(l.gradient!==void 0)throw new Error("Categorical legends do not accept gradient.");if(l.count!==void 0&&n===void 0)throw new Error("Legend count requires an existing size legend.");const i=l.title,m=i==="auto"?!0:typeof i=="string"?!1:e.inferredTitle,s=i===!1?!1:i===void 0?e.titleVisible!==!1:!0,u=i==="auto"?e.field:typeof i=="string"?i:e.title,f=E(e.labels,l.labels);if(f.format!==void 0&&f.format!=="auto"&&n===void 0)throw new Error("Categorical legend labels do not accept format.");const{format:a,...c}=f,b=l.symbol===void 0?e.inferredSymbol:l.symbol==="auto",S=ie({target:e.target,channels:e.channels,...l.overflow===void 0&&e.overflow===void 0?{}:{overflow:l.overflow===void 0?e.overflow:l.overflow},layout:l.layout===void 0?e.layout:l.layout,position:l.position??e.position,align:l.align??e.align,direction:l.direction??(l.position!==void 0&&l.position!==e.position?void 0:e.direction),...l.columns===void 0&&e.columns===void 0?{}:{columns:l.columns??e.columns},offset:l.offset??e.offset,titlePosition:l.titlePosition??e.titlePosition,title:u,symbol:l.symbol===void 0?e.symbol:le(o,z(o,e.target),e.channels,l.symbol,t),labels:c,titleStyle:G(e.titleStyle,l.titleStyle,{edit:!0}),itemGap:l.itemGap??e.itemGap,border:C(e.border,l.border)},t,{internalSymbol:b}),h={...e,...S,inferredTitle:m,inferredSymbol:b,titleVisible:s},r=l.order===void 0?d:j(l.order);return ne(o,z(o,e.target),e.channels,u,r),{config:h,order:r,titleMode:i,title:u,titleVisible:s,sizeConfig:Be(o,e,n,l)}}function Z(o,t,e,n,l){const{config:d,order:i,titleMode:m,title:s,titleVisible:u,sizeConfig:f}=Y(o,t,e,n,l),a=ce(d);let c=o;(m==="auto"||typeof m=="string")&&(c=c.editSemantic({property:`guide.legend.${t}.title`,value:s})),l.order!==void 0&&(i==="scale"?o.semanticSpec.guides.legend?.[t]?.order!==void 0&&(c=c.editSemantic({property:`guide.legend.${t}.order`,remove:!0})):c=c.editSemantic({property:`guide.legend.${t}.order`,value:i})),c=c._withLegendConfig(t,d),c=se(c,e,d),c=k(c,`${t}LegendBackground`,d.border!==!1,{type:"rect",before:[...a][0]});const b=`${t}LegendTitle`;return c=k(c,b,u,{type:"text",...c.graphicSpec.objects.sizeLegendSymbols===void 0?{}:{before:c.graphicSpec.objects.sizeLegendBackground===void 0?"sizeLegendSymbols":"sizeLegendBackground"}}),n!==void 0&&(c=c._withLegendConfig("size",f)),c.rematerializeLegend()}function J(o,t,e){_e(e.channels,"editLegend");const{channels:n,target:l,...d}=e,i=o.guideConfigs.legend??{},m=Object.keys(i).filter(r=>i[r].target===t);let s=m.reduce((r,p)=>r._withoutMaterializationConfig(["guides","legend",p]),o);const u=d.representation??(n.includes("color")&&i.gradient?.target===t?i.gradient.representation:void 0);if(d.representation!==void 0&&!n.includes("color"))throw new Error("Legend representation requires selected continuous color.");const f=de(s,{target:t,channels:n,...u===void 0?{}:{representation:u}}),a=m.find(r=>["series","color","stroke"].includes(r));let c=f.steps.map(r=>{const p=te(s,r),{kind:g}=p;if(i[g]!==void 0&&i[g].target!==t)throw new Error(`Legend ${g} content already belongs to another target.`);if(["series","color","stroke"].includes(g)&&a!==void 0){const L=d.order===void 0?o.semanticSpec.guides.legend?.[a]?.order:j(d.order);return{...ae(s,a,i[a],p.config.channels,{order:L,validateLayout:!1}),kind:g}}return{...p,config:i[g]?.target===t?i[g]:p.config}});const b=c.find(r=>["series","color","stroke"].includes(r.kind)),S=c.find(r=>r.kind==="size");if(d.representation!==void 0||c.some(r=>r.kind==="gradient"&&r.config.representation==="symbols")){const r=c.find(p=>p.kind==="gradient");if(r===void 0)throw new Error("Legend representation requires continuous color.");r.config=_(s,"gradient",r.config,d).config}else if(b!==void 0){S!==void 0&&i.size?.target!==t&&(S.config={...S.config,inheritAppearance:b.config.position==="left"||d.position==="left"||d.labels!==void 0||d.titleStyle!==void 0});const r=Y(s,b.kind,b.config,S?.config,d,b.order);if(b.config=r.config,b.order=r.order,S!==void 0&&(S.config=r.sizeConfig,b.config.layout==="legacy-bottom"))throw new Error('Combined size legends require layout "edge".')}else{const r=c[0];r.kind==="size"||r.kind==="strokeWidth"?r.config=H(s,r.kind,r.config,d).config:["interval","strokeInterval"].includes(r.kind)?r.config=R(s,r.config,d,r.kind==="strokeInterval"?"stroke":"color").config:r.config=_(s,r.kind,r.config,d).config}c=Ve(o,t,c);for(const{kind:r,config:p}of c)s=s._withLegendConfig(r,p);b!==void 0&&re(s,b.config);let h=W(o,m);for(const{kind:r,config:p,order:g}of c)["series","color","stroke"].includes(r)?h=fe(h,p,g):h={size:Ie,strokeWidth:xe,gradient:M,opacity:pe,interval:we,strokeGradient:ke,strokeInterval:ze}[r](h,p);return h.rematerializeLegend()}function Q(o={},t=!1){if(x(o,We,"editLegend"),Object.keys(o).filter(a=>a!=="target").length===0)throw new Error("editLegend requires at least one change.");if(o.title!==void 0&&o.title!==!1&&o.title!=="auto"&&(typeof o.title!="string"||o.title.length===0))throw new TypeError('editLegend title must be a non-empty string, "auto", or false.');const n=Oe(this,o.target,"editLegend"),l=this.guideConfigs.legendGroups?.[n];if(!t&&(l!==void 0||o.blockLayout!==void 0||o.at!==void 0||$.includes(o.position)&&Object.values(this.guideConfigs.legend??{}).some(a=>a.target===n&&a.kind===void 0))){const a=v(this,o,n,{corner:$.includes(o.position)}),{channels:c,...b}=a.options;if(c!==void 0)return J(a.program,n,a.options);const S=["position","layout","align","direction","columns","offset","titlePosition","itemGap"];if(Object.keys(b).every(r=>r==="target"||S.includes(r))){let r=a.program;const p=Object.entries(r.guideConfigs.legend??{}).filter(([,g])=>g.target===n);for(const[g]of p){const L=r.guideConfigs.legend[g],y={...b};if(["gradient","strokeGradient","opacity"].includes(g)&&L.representation!=="symbols")for(const w of["layout","columns","direction"]){if(Object.hasOwn(o,w))throw new Error(`${g} legend does not accept ${w}.`);delete y[w]}["gradient","strokeGradient"].includes(g)&&L.representation!=="symbols"&&delete y.itemGap,["series","color","stroke"].includes(g)?r=Z(r,g,L,void 0,y):["size","strokeWidth"].includes(g)?r=P(r,g,L,y,!0):["interval","strokeInterval"].includes(g)?r=I(r,L,y,g==="strokeInterval"?"stroke":"color"):r=T(r,g,L,y)}return r.rematerializeLegend()}return Q.call(a.program,a.options,!0)}if(o.channels!==void 0)return J(this,n,o);const i=this.guideConfigs.legend??{},m=Object.keys(i).filter(a=>i[a]?.target===n);if(o.representation!==void 0){if(i.gradient?.target!==n)throw new Error("Legend representation requires continuous color.");return T(this,"gradient",i.gradient,o)}if(i.gradient?.target===n&&i.gradient.representation==="symbols"&&m.length>1)throw new Error("Multiple legend blocks require editLegendBlock with an explicit channel for appearance or samples.");if(o.values!==void 0&&m.length>1)throw new Error("A target with multiple legend blocks requires a channel block selector for exact values.");const s=["series","color","stroke"].filter(a=>i[a]?.target===n);if(s.length>1)throw new Error("editLegend requires channels when a target owns multiple categorical legend blocks.");const u=s[0];if(u!==void 0)return Z(this,u,i[u],i.size?.target===n?i.size:void 0,o);if(i.interval?.target===n)return I(this,i.interval,o);if(i.strokeInterval?.target===n)return I(this,i.strokeInterval,o,"stroke");if(i.strokeWidth?.target===n)return P(this,"strokeWidth",i.strokeWidth,o);if(i.size?.target===n)return P(this,"size",i.size,o);const f=["gradient","strokeGradient","opacity"].find(a=>i[a]?.target===n);return T(this,f,i[f],o)}const St=oe({op:"editLegend",description:"Edit one stable legend content, layout or appearance."},ee(function(o={}){return X(this,Q.call(this,o),o)}));export{St as editLegend};

package/src/actions/guides/legends/focused.js

@@ -20,7 +20,7 @@ function makeFocusedLegendEdit({ name, options, map }) {
 const editLegendLayout = /* @__PURE__ */ makeFocusedLegendEdit({
   name: "editLegendLayout",
   options: [
-    "position", "layout", "align", "direction", "columns", "offset",
+    "position", "layout", "align", "direction", "columns", "offset", "blockLayout", "at",
     "titlePosition", "itemGap"
   ],
   map: args => args
@@ -34,7 +34,7 @@ const editLegendLabels = /* @__PURE__ */ makeFocusedLegendEdit({
 
 const editLegendTitle = /* @__PURE__ */ makeFocusedLegendEdit({
   name: "editLegendTitle",
-  options: ["title", "color", "fontSize", "fontFamily", "fontWeight"],
+  options: ["title", "color", "fontSize", "fontFamily", "fontWeight", "align"],
   map: ({ target, title, ...titleStyle }) => ({
     target,
     ...(title === undefined ? {} : { title }),