ggaction 0.0.17 → 0.0.19

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{resolveColorSizeEdit as R,createColorSizeLegendFromConfig as me}from"./colorSize.js";import{patchLegendClipHeight as Y,validateLegendClip as be}from"../../../grammar/legendClip.js";import{validateLegendCombine as ye,validateMappedSizeShapeSymbol as pe}from"../../../grammar/legendCombinations.js";import{legendBlockDescriptors as j}from"./target.js";import{editFacetParentLegend as he}from"../../../materialization/facetGuides/edit.js";import{localLegendPosition as Z,localLegendPlacement as Le}from"../../../materialization/legendGroups.js";import{mergeLegendTitleStyle as $}from"../../../grammar/legendTitleStyle.js";import{recordLegendOffsetIntent as J}from"./group.js";import{prepareLegendGroup as Se}from"./group.js";import{PLOT_LEGEND_POSITIONS as Q}from"../../../layout/legend.js";import{withGuideLayoutValidation as we}from"../../../materialization/guides/layout.js";import{resolveLegendStepConfig as ke}from"./creation.js";import{normalizeLegendOrder as U}from"../../../grammar/categoryOrder.js";import{resolveDefinition as ze}from"./categorical/resolve.js";import{action as Ce}from"../../../core/action.js";import{validateOptionObject as B}from"../../../core/validation.js";import{normalizeLegendOverflow as X,normalizeOptions as Oe}from"./categorical/options.js";import{resolveLegendSymbol as Ee}from"./categorical/recipes.js";import{resolveLayout as Ge}from"./categorical/layout.js";import{resolveLegendCreationPlan as ee}from"./categorical/actions.js";import{categoricalSymbolIds as _e,reconcileCategoricalSymbols as Pe,createCategoricalLegendFromConfig as je,resolveCategoricalLegendRevision as Te,removeLegendKinds as te}from"./lifecycle.js";import{normalizeColorSymbols as Ie}from"./continuous/colorSymbols.js";import{readLegendSampling as $e}from"./sampling.js";import{createGradientLegendFromConfig as ne}from"./continuous/gradient.js";import{normalizeLegendGradient as ie}from"../../../grammar/legendGradient.js";import{normalizeItemLegendLayout as xe,normalizeLegendBorder as Ve,normalizeLegendTextOptions as oe,normalizeLegendTitleOptions as le,normalizeContinuousLegend as re}from"./continuous/common.js";import{normalizeOpacitySymbol as De,createOpacityLegendFromConfig as Me}from"./continuous/opacity.js";import{normalizeIntervalLegend as qe,resolveIntervalConfig as Be,resolveIntervalLayout as Ae,createIntervalLegendFromConfig as We}from"./continuous/interval.js";import{createStrokeGradientLegendFromConfig as Fe,createStrokeIntervalLegendFromConfig as Ke,resolveStrokeIntervalConfig as He,resolveStrokeIntervalLayout as Ne}from"./continuous/stroke.js";import{findLayer as P}from"../../../selectors/layers.js";import{resolveLegendGraphicPlacement as ve}from"../../../materialization/graphicHierarchy.js";import{resolveLegendBlock as A,resolveLegendTarget as W,validateLegendChannels as Re}from"./target.js";import{isEnumeratedSizeScaleType as de}from"../../../grammar/scales/index.js";import{SIZE_LEGEND_LABELS as ce,SIZE_LEGEND_TITLE_STYLE as se,resolveSizeLegendLayout as Ye,createSizeLegendFromConfig as Ze}from"./size.js";import{STROKE_WIDTH_LEGEND_LABELS as Je,STROKE_WIDTH_LEGEND_TITLE_STYLE as Qe,resolveStrokeWidthLegendLayout as Ue,createStrokeWidthLegendFromConfig as Xe}from"./strokeWidth.js";import{normalizeLegendSampling as F}from"./sampling.js";import{patchLegendBlockOverride as et}from"./blocks.js";import{LEGEND_POSITIONS as tt}from"../../../core/vocabulary.js";import{planLegendBlockTransitions as nt}from"./transition.js";const fe=Object.freeze(["target","channel","channels","position","layout","align","direction","columns","offset","titlePosition","title","symbol","labels","titleStyle","itemGap","border","count","values","gradient","representation","order","overflow","blockLayout","at","combine","clipHeight"]);function T(n,t){return t===void 0?n:{...n,...t}}function I(n,t){return t===void 0?n:t===!1||t===!0||n===!1?t:{...n,...t}}function E(n,t,e,o){const i=n.graphicSpec.objects[t]!==void 0;return i&&!e?n.editGraphics({target:t,remove:!0}):!i&&e?n.createGraphics({id:t,...o,...ve(n,{...o.before===void 0?{}:{before:o.before},...o.after===void 0?{}:{after:o.after}})}):n}function it(n,t,e){const o=e.representation??t.representation??"gradient";if(!["gradient","symbols"].includes(o))throw new Error("Legend representation must be gradient or symbols.");const i=["target","representation","position","align","offset","title","labels","titleStyle","titlePosition","border","count",...o==="symbols"?["symbol","values","itemGap","layout","direction","columns"]:["gradient","direction"]];for(const a of Object.keys(e))if(!i.includes(a))throw new Error(`Color ${o} legend does not accept ${a}.`);const s=(t.representation??"gradient")!==o,u=e.title,r=u==="auto"?P(n,t.target)?.encoding?.color?.field:typeof u=="string"?u:t.title,f={target:t.target,position:e.position??t.position,align:e.align??t.align,offset:e.offset??t.offset,title:r,labels:T(t.labels,e.labels),titleStyle:$(t.titleStyle,e.titleStyle,{edit:!0}),border:I(t.border,e.border),titlePosition:e.titlePosition??(s&&(o==="gradient"||t.titlePosition==="bottom")?"top":t.titlePosition)};let m;if(o==="symbols"){e.symbol!==void 0&&e.symbol!=="auto"&&B(e.symbol,["type","radius","stroke","strokeWidth"],"Sampled color symbol");const a=s?{count:t.count}:{};for(const h of["values","count"])Object.hasOwn(e,h)&&(a[h]=e[h]);Object.hasOwn(e,"values")&&delete a.count,Object.hasOwn(e,"count")&&(a.count=e.count),m=Ie({...f,...a,layout:e.layout??(s?void 0:t.layout),direction:e.direction??(s||e.position!==void 0&&e.position!==t.position?void 0:t.direction),columns:e.columns??(s?void 0:t.columns),itemGap:e.itemGap??(s?void 0:t.itemGap),symbol:e.symbol==="auto"?"auto":e.symbol===void 0?s?void 0:t.symbol:{...s?{}:t.symbol,...e.symbol}},s?{count:t.count}:t,"edit")}else{m=re({...f,...e.direction==="auto"?{}:e.direction!==void 0?{direction:e.direction}:t.gradientDirection===void 0?{}:{direction:t.gradientDirection},count:e.count??(s?$e(t).count:t.count)},"gradient");const a=ie(e.gradient,s?void 0:t.gradient);m.gradient=a}const{representation:c,sampling:S,symbol:l,layout:L,direction:C,columns:z,gradient:k,count:w,...g}=t,p=s&&o==="gradient"&&t.blockOverrides!==void 0?Object.fromEntries(Object.entries(t.blockOverrides).map(([a,h])=>{const{symbol:d,labelMap:b,...y}=h;return[a,y]})):t.blockOverrides;return o==="gradient"&&e.direction==="auto"&&delete g.gradientDirection,{config:{...g,...m,...p===void 0?{}:{blockOverrides:p},inferredTitle:u==="auto"?!0:typeof u=="string"?!1:t.inferredTitle,titleVisible:u===!1?!1:u===void 0?t.titleVisible!==!1:!0},titleMode:u,title:r,titleVisible:u===!1?!1:u===void 0?t.titleVisible!==!1:!0}}function x(n,t,e,o){if(t==="gradient"&&(e.representation==="symbols"||o.representation!==void 0))return it(n,e,o);const i=["gradient","strokeGradient"].includes(t),s=i?["target","position","align","offset","title","labels","titleStyle","titlePosition","border","count","gradient","representation","direction"]:["target","position","align","offset","title","symbol","labels","titleStyle","titlePosition","itemGap","border","count","values"];for(const h of Object.keys(o))if(!s.includes(h))throw new Error(`${t} legend does not accept ${h}.`);const u=o.title,r=u==="auto"?!0:typeof u=="string"?!1:e.inferredTitle,f=u===!1?!1:u===void 0?e.titleVisible!==!1:!0,m=P(n,e.target),c=t==="gradient"?"color":t==="strokeGradient"?"stroke":"opacity",S=m?.encoding?.[c]?.field,l=u==="auto"?S:typeof u=="string"?u:e.title,L=o.titlePosition??e.titlePosition,C=t==="opacity"&&L==="left"&&e.titlePosition!=="left",z=T(e.labels,o.labels),k=i?void 0:F(o,{previous:e,operation:"edit",label:"Opacity legend"}),w=re({target:e.target,position:o.position??e.position,align:o.align??e.align,offset:o.offset??e.offset,...i?{count:o.count??e.count,...o.direction==="auto"?{}:o.direction!==void 0?{direction:o.direction}:e.gradientDirection===void 0?{}:{direction:e.gradientDirection}}:{},titlePosition:L,title:l,labels:C&&o.labels?.offset===void 0?{...z,offset:8}:z,titleStyle:$(e.titleStyle,o.titleStyle,{edit:!0}),border:I(e.border,o.border),...t==="opacity"?{itemGap:o.itemGap??(C?20:e.itemGap),symbol:o.symbol??e.symbol}:{}},i?"gradient":t),{count:g,...p}=e,a={...i?e:p,...w,...i?{}:{sampling:k},inferredTitle:r,titleVisible:f};if(i){o.direction==="auto"&&delete a.gradientDirection;const h=ie(o.gradient,e.gradient);a.gradient=h}else a.symbol=De(o.symbol??e.symbol);return{config:a,titleMode:u,title:l,titleVisible:f}}function V(n,t,e,o){const{config:i,titleMode:s,title:u,titleVisible:r}=x(n,t,e,o);if(t==="gradient"&&(e.representation??"gradient")!==(i.representation??"gradient"))return ne(te(n,[t]),i).rematerializeLegend();const f=t==="gradient"?"colorGradient":t==="strokeGradient"?"strokeGradient":"opacityLegend",m=t==="gradient"?"color":t==="strokeGradient"?"stroke":"opacity";let c=n;return(s==="auto"||typeof s=="string")&&(c=c.editSemantic({property:`guide.legend.${m}.title`,value:u})),c=c._withLegendConfig(t,i),c=E(c,`${f}Background`,i.border!==!1,{type:"rect",before:["gradient","strokeGradient"].includes(t)?`${f}${i.representation==="symbols"?"Symbols":"Strips"}`:"opacityLegendSymbols"}),c=E(c,`${f}Title`,r,{type:"text"}),c.rematerializeLegend()}function ae(n,t,e,o="color"){for(const l of Object.keys(e))if(!["target","position","align","direction","offset","title","symbol","labels","titleStyle","itemGap","border","layout","columns","titlePosition"].includes(l))throw new Error(`interval legend does not accept ${l}.`);const i=e.title,s=P(n,t.target),u=i==="auto"?!0:typeof i=="string"?!1:t.inferredTitle,r=i===!1?!1:i===void 0?t.titleVisible!==!1:!0,f=i==="auto"?s?.encoding?.[o]?.field:typeof i=="string"?i:t.title,m=qe({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:f,symbol:T(t.symbol,e.symbol),labels:T(t.labels,e.labels),titleStyle:$(t.titleStyle,e.titleStyle,{edit:!0}),itemGap:e.itemGap??t.itemGap,border:I(t.border,e.border)}),c={...t,...m,inferredTitle:u,titleVisible:r,...o==="stroke"&&e.symbol?.strokeWidth!==void 0?{inferredStrokeWidth:!1}:{}},S=o==="stroke"?He(n,c):Be(n,c);return(o==="stroke"?Ne:Ae)(n,S.config,S.scale),{normalized:m,config:c,titleMode:i,title:f,titleVisible:r}}function D(n,t,e,o="color"){const i=o==="stroke"?"strokeInterval":"interval",s=o==="stroke"?"strokeInterval":"colorLegend",{normalized:u,config:r,titleMode:f,title:m,titleVisible:c}=ae(n,t,e,o);let S=n._withLegendConfig(i,r);return(f==="auto"||typeof f=="string")&&(S=S.editSemantic({property:`guide.legend.${o}.title`,value:m})),S=E(S,`${s}Title`,c,{type:"text"}),S=E(S,`${s}Background`,u.border!==!1,{type:"rect",before:`${s}Symbols`}),S.rematerializeLegend()}function K(n,t,e,o,i=!1){const s=t==="size",u=s?"size":"stroke-width",r=["target","title","count","values","labels","titleStyle","position","layout","align","direction","columns","titlePosition","offset","itemGap","border"];s&&r.push("overflow");for(const a of Object.keys(o))if(!r.includes(a))throw new Error(`${u} legend does not accept ${a}.`);const f=s&&de(n.resolvedScales[e.scale]?.type),m=s&&n.resolvedScales[e.scale]?.type==="ordinal";if(o.overflow!==void 0&&!m)throw new Error("Size legend overflow requires an ordinal scale.");if(f&&(o.count!==void 0||o.values!==void 0))throw new Error("Discrete size legends do not support count or exact values.");const c=f?void 0:F(o,{previous:e,operation:"edit",label:`${s?"Size":"Stroke-width"} legend`}),S=P(n,e.target),l=o.title,L=l==="auto"?!0:typeof l=="string"?!1:e.inferredTitle,C=l===!1?!1:l===void 0?e.titleVisible!==!1:!0,z=l==="auto"?S?.encoding?.[t]?.field:typeof l=="string"?l:e.title,{count:k,...w}=e,p={...f?e:w,title:z,inferredTitle:L,titleVisible:C,...f?{}:{sampling:c},...m&&(o.overflow!==void 0||e.overflow!==void 0)?{overflow:X(o.overflow===void 0?e.overflow:o.overflow)}:{},...s?{inheritAppearance:i&&e.inheritAppearance===!0,...o.position===void 0?{}:{inheritPosition:!1}}:{},labels:oe(o.labels,"editLegend.labels",e.labels??(s?ce:Je)),titleStyle:le(o.titleStyle,"editLegend.titleStyle",e.titleStyle??(s?se:Qe),!0)};return Object.assign(p,xe({...e,...o,titleStyle:p.titleStyle,direction:o.direction??(o.position!==void 0&&o.position!==e.position?void 0:e.direction)})),p.border=Ve(I(e.border,o.border)),(s?Ye:Ue)(n,p),{config:p,titleMode:l,title:z,titleVisible:C}}function M(n,t,e,o,i=!1){const{config:s,titleMode:u,title:r,titleVisible:f}=K(n,t,e,o,i),m=t==="size"?"sizeLegend":"strokeWidthLegend";let c=n;return(u==="auto"||typeof u=="string")&&(c=c.editSemantic({property:`guide.legend.${t}.title`,value:r})),c=c._withLegendConfig(t,s),c=E(c,`${m}Background`,s.border!==!1,{type:"rect",before:`${m}Symbols`}),c=E(c,`${m}Title`,f,{type:"text",after:`${m}Labels`}),c.rematerializeLegend()}function ot(n,t,e,o){if(e===void 0)return;const i=de(n.resolvedScales[e.scale]?.type);if(i&&(o.count!==void 0||o.values!==void 0))throw new Error("Discrete size legends do not support count or exact values.");const s=i?void 0:F(o,{previous:e,operation:"edit",label:"Size legend"}),{count:u,...r}=e,m={...i?e:r,...i?{}:{sampling:s},...o.overflow!==void 0&&n.resolvedScales[e.scale]?.type==="ordinal"?{overflow:X(o.overflow)}:{}};if(o.labels===void 0&&o.titleStyle===void 0)return m;const c=e.inheritAppearance?{...t.labels,offset:e.labels.offset}:e.labels??ce,S=e.inheritAppearance?t.titleStyle:e.titleStyle??se;return{...m,inheritAppearance:!1,labels:oe(o.labels,"editLegend.labels",c),titleStyle:le(o.titleStyle,"editLegend.titleStyle",S,!0)}}function ue(n,t,e,o,i,s=n.semanticSpec.guides.legend?.[t]?.order){if(i.values!==void 0)throw new Error("Combined and categorical legends require a channel block selector for exact values.");if(i.gradient!==void 0)throw new Error("Categorical legends do not accept gradient.");if(i.count!==void 0&&o===void 0)throw new Error("Legend count requires an existing size legend.");const u=i.title,r=u==="auto"?!0:typeof u=="string"?!1:e.inferredTitle,f=u===!1?!1:u===void 0?e.titleVisible!==!1:!0,m=u==="auto"?e.field:typeof u=="string"?u:e.title,c=T(e.labels,i.labels);if(c.format!==void 0&&c.format!=="auto"&&o===void 0)throw new Error("Categorical legend labels do not accept format.");const{format:S,...l}=c,L=i.symbol===void 0?e.inferredSymbol:i.symbol==="auto",C=Oe({target:e.target,channels:e.channels,...i.overflow===void 0&&e.overflow===void 0?{}:{overflow:i.overflow===void 0?e.overflow:i.overflow},layout:i.layout===void 0?e.layout:i.layout,position:i.position??e.position,align:i.align??e.align,direction:i.direction??(i.position!==void 0&&i.position!==e.position?void 0:e.direction),...i.columns===void 0&&e.columns===void 0?{}:{columns:i.columns??e.columns},offset:i.offset??e.offset,titlePosition:i.titlePosition??e.titlePosition,title:m,symbol:i.symbol===void 0?e.symbol:Ee(n,P(n,e.target),e.channels,i.symbol,t),labels:l,titleStyle:$(e.titleStyle,i.titleStyle,{edit:!0}),itemGap:i.itemGap??e.itemGap,border:I(e.border,i.border)},t,{internalSymbol:L}),z={...e,...C,inferredTitle:r,inferredSymbol:L,titleVisible:f},k=i.order===void 0?s:U(i.order);return ze(n,P(n,e.target),e.channels,m,k),{config:z,order:k,titleMode:u,title:m,titleVisible:f,sizeConfig:ot(n,e,o,i)}}function H(n,t,e,o,i){e.combine==="size-shape"&&pe(i.symbol);const{config:s,order:u,titleMode:r,title:f,titleVisible:m,sizeConfig:c}=ue(n,t,e,o,i),S=_e(s);let l=n;(r==="auto"||typeof r=="string")&&(l=l.editSemantic({property:`guide.legend.${t}.title`,value:f})),i.order!==void 0&&(u==="scale"?n.semanticSpec.guides.legend?.[t]?.order!==void 0&&(l=l.editSemantic({property:`guide.legend.${t}.order`,remove:!0})):l=l.editSemantic({property:`guide.legend.${t}.order`,value:u})),l=l._withLegendConfig(t,s),l=Pe(l,e,s),l=E(l,`${t}LegendBackground`,s.border!==!1,{type:"rect",before:[...S][0]});const L=`${t}LegendTitle`;return l=E(l,L,m,{type:"text",...l.graphicSpec.objects.sizeLegendSymbols===void 0?{}:{before:l.graphicSpec.objects.sizeLegendBackground===void 0?"sizeLegendSymbols":"sizeLegendBackground"}}),o!==void 0&&(l=l._withLegendConfig("size",c)),l.rematerializeLegend()}function N(n,t,e){const o=R(n,t,e);let i=n._withLegendConfig("colorSize",o);return i=E(i,"colorSizeLegendBackground",o.border!==!1,{type:"rect",before:"colorSizeLegendSymbols"}),i=E(i,"colorSizeLegendTitle",o.titleVisible!==!1,{type:"text",after:"colorSizeLegendLabels"}),i.rematerializeLegend()}function v(n,t,e,o={position:e.position}){Re(e.channels,"editLegend");const{channels:i,target:s,combine:u,...r}=e,f=n.guideConfigs.legend??{},m=Object.keys(f).filter(d=>f[d].target===t);let c=m.reduce((d,b)=>d._withoutMaterializationConfig(["guides","legend",b]),n);const S=u==="color-size"&&r.representation===void 0?void 0:r.representation??(i.includes("color")&&f.gradient?.target===t?f.gradient.representation:void 0);if(r.representation!==void 0&&!i.includes("color"))throw new Error("Legend representation requires selected continuous color.");const l=Object.values(f).find(d=>d.target===t&&["size-shape","color-size"].includes(d.combine)),L=l?.combine==="color-size"?["color","size"]:["shape","size"],C=L.every(d=>i.includes(d));if(l&&u===void 0&&!C&&i.some(d=>L.includes(d)))throw new Error("An edited combined legend keeps its combination; explicitly choose separate to split it.");const z=u??(l&&C?l.combine:void 0);let k;if(u==="separate"&&l){const d=i.filter(y=>L.includes(y));k={steps:[...l.combine==="color-size"?d.map(y=>[y]):[d],...i.filter(y=>!L.includes(y)).map(y=>[y])].filter(y=>y.length).map(y=>ee(c,{target:t,channels:y})).flatMap(y=>y.steps),...n.guideConfigs.legendGroups?.[t]===void 0?{}:{legendGroup:{target:t,config:n.guideConfigs.legendGroups[t]}}}}else k=ee(c,{target:t,channels:i,...z===void 0?{}:{combine:z},...S===void 0?{}:{representation:S}},n.semanticSpec.layers,i);k.legendGroup!==void 0&&(c=c._withMaterializationConfig(["guides","legendGroups",t],k.legendGroup.config));const w=m.find(d=>["series","color","stroke"].includes(d));let g=k.steps.map(d=>{const b=ke(c,d),{kind:y}=b;if(f[y]!==void 0&&f[y].target!==t)throw new Error(`Legend ${y} content already belongs to another target.`);if(b.config.combine==="size-shape"&&f.series?.combine!=="size-shape"||b.kind==="colorSize"&&f.colorSize?.target!==t)return b;if(l?.combine==="color-size"&&["gradient","size"].includes(y)){const G=Object.fromEntries(["title","inferredTitle","titleVisible","labels","titleStyle","position","align","offset","border"].map(_=>[_,l[_]]));return y==="size"&&Object.assign(G,Object.fromEntries(["sampling","direction","columns","titlePosition","itemGap","layout","clipHeight"].map(_=>[_,l[_]])),{inheritAppearance:!1}),{...b,config:{...b.config,...G}}}if(y==="size"&&l){const O=Object.fromEntries(["title","inferredTitle","titleVisible","labels","titleStyle","position","align","direction","columns","offset","titlePosition","itemGap","border","layout","clipHeight"].map(G=>[G,l[G]]));return{...b,config:{...b.config,...O,inheritAppearance:!1}}}if(["series","color","stroke"].includes(y)&&w!==void 0){const O=f[y]?.target===t?y:w,G=r.order===void 0?n.semanticSpec.guides.legend?.[O]?.order:U(r.order);return{...Te(c,O,f[O],b.config.channels,{order:G,validateLayout:!1}),kind:y}}return{...b,config:f[y]?.target===t?f[y]:b.config}});const p=g.find(d=>["series","color","stroke"].includes(d.kind)),a=g.find(d=>d.kind==="size");if(r.representation!==void 0||g.some(d=>d.kind==="gradient"&&d.config.representation==="symbols")){const d=g.find(b=>b.kind==="gradient");if(d===void 0)throw new Error("Legend representation requires continuous color.");d.config=x(c,"gradient",d.config,r).config}else if(p!==void 0){a!==void 0&&f.size?.target!==t&&(a.config={...a.config,inheritAppearance:p.config.position==="left"||r.position==="left"||r.labels!==void 0||r.titleStyle!==void 0});const d=ue(c,p.kind,p.config,a?.config,r,p.order);if(p.config=d.config,p.order=d.order,a!==void 0&&(a.config=d.sizeConfig,p.config.layout==="legacy-bottom"))throw new Error('Combined size legends require layout "edge".')}else{const d=g[0];if(d.kind==="colorSize")d.config=R(c,d.config,r);else if(l?.combine==="color-size"&&u==="separate")for(const b of g)b.config=b.kind==="size"?K(c,"size",b.config,r).config:x(c,b.kind,b.config,Object.fromEntries(Object.entries(r).filter(([y])=>!["values","itemGap","layout","columns"].includes(y)))).config;else d.kind==="size"||d.kind==="strokeWidth"?d.config=K(c,d.kind,d.config,r).config:["interval","strokeInterval"].includes(d.kind)?d.config=ae(c,d.config,r,d.kind==="strokeInterval"?"stroke":"color").config:d.config=x(c,d.kind,d.config,r).config}g=nt(n,t,g,o.position);for(const{kind:d,config:b}of g)c=c._withLegendConfig(d,b);p!==void 0&&Ge(c,p.config);let h=te(n,m);k.legendGroup!==void 0&&(h=h._withMaterializationConfig(["guides","legendGroups",t],k.legendGroup.config));for(const{kind:d,config:b,order:y}of g)["series","color","stroke"].includes(d)?h=je(h,b,y):h={colorSize:me,size:Ze,strokeWidth:Xe,gradient:ne,opacity:Me,interval:We,strokeGradient:Fe,strokeInterval:Ke}[d](h,b);return h.rematerializeLegend()}function q(n={},t=!1,e={position:n.position}){if(B(n,fe,"editLegend"),Object.keys(n).filter(l=>l!=="target"&&l!=="channel").length===0)throw new Error("editLegend requires at least one change.");if(n.title!==void 0&&n.title!==!1&&n.title!=="auto"&&(typeof n.title!="string"||n.title.length===0))throw new TypeError('editLegend title must be a non-empty string, "auto", or false.');const i=W(this,n.target,"editLegend");if(Object.hasOwn(n,"channel")){if(Object.hasOwn(n,"channels"))throw new Error("editLegend cannot combine channel and channels.");if(Object.hasOwn(n,"combine"))throw new Error("Selected legend edits cannot change combine.");if(n.blockLayout!==void 0||n.at!==void 0)throw new Error("Selected legend blocks do not accept whole-group blockLayout or at.");let l=this;const L=A(l,n,"editLegend"),C=Object.hasOwn(n,"position");if(C){if(n.position!=="inherit"&&!tt.includes(n.position))throw new Error("Selected legend position requires an anchor or inherit.");const O=et(L.config,L.key,n.position==="inherit"?{removePosition:!0}:{position:n.position}),{blockOverrides:G,..._}=L.config;l=l._withLegendConfig(L.kind,O===void 0?_:{..._,blockOverrides:O});const{position:lt,...ge}=n;n=ge}const z=l.guideConfigs.legend?.size,k=["series","color","stroke"].map(O=>l.guideConfigs.legend?.[O]).find(O=>O?.target===i);z?.target===i&&z.inheritAppearance===!0&&k&&(L.kind==="size"||["series","color","stroke"].includes(L.kind))&&(l=l._withLegendConfig("size",{...z,inheritAppearance:!1,labels:{...k.labels,offset:z.labels.offset},titleStyle:{...k.titleStyle}}));const{kind:w}=L,g=l.guideConfigs.legend[w],{channel:p,...a}=n,h=Le(g),d=h===void 0?g:{...g,...h},b=C&&!["gradient","strokeGradient","opacity"].includes(w)?{...d,direction:void 0}:d,y=O=>h===void 0?O:O._withLegendConfig(w,{...O.guideConfigs.legend[w],position:g.position,...a.align===void 0?{align:g.align}:{},...a.offset===void 0?{offset:g.offset,inferredOffset:g.inferredOffset}:{}}).rematerializeLegend();return["series","color","stroke"].includes(w)?y(H(l,w,b,void 0,a)):w==="colorSize"?y(N(l,b,a)):["size","strokeWidth"].includes(w)?y(M(l,w,b,a)):["interval","strokeInterval"].includes(w)?y(D(l,b,a,w==="strokeInterval"?"stroke":"color")):y(V(l,w,b,a))}const s=this.guideConfigs.legendGroups?.[i];if(!t&&(s!==void 0||n.blockLayout!==void 0||n.at!==void 0||Q.includes(n.position)&&Object.values(this.guideConfigs.legend??{}).some(l=>l.target===i&&l.kind===void 0))){const l=Se(this,n,i,{corner:Q.includes(n.position)}),{channels:L,...C}=l.options;if(L!==void 0)return v(l.program,i,l.options,e);const z=["position","layout","align","direction","columns","offset","titlePosition","itemGap"];if(Object.keys(C).every(g=>g==="target"||z.includes(g))){let g=l.program;const p=Object.entries(g.guideConfigs.legend??{}).filter(([,a])=>a.target===i);for(const[a]of p){const h=g.guideConfigs.legend[a],d={...C};if(Z(h)!==void 0)for(const b of["position","align","offset"])delete d[b];if(["gradient","strokeGradient","opacity"].includes(a)&&h.representation!=="symbols")for(const b of a==="opacity"?["layout","columns","direction"]:["layout","columns"]){if(Object.hasOwn(n,b))throw new Error(`${a} legend does not accept ${b}.`);delete d[b]}["gradient","strokeGradient"].includes(a)&&h.representation!=="symbols"&&delete d.itemGap,["series","color","stroke"].includes(a)?g=H(g,a,h,void 0,d):a==="colorSize"?g=N(g,h,d):["size","strokeWidth"].includes(a)?g=M(g,a,h,d,!0):["interval","strokeInterval"].includes(a)?g=D(g,h,d,a==="strokeInterval"?"stroke":"color"):g=V(g,a,h,d)}return g.rematerializeLegend()}if(n.combine===void 0&&Object.values(this.guideConfigs.legend??{}).some(g=>g.target===i&&["size-shape","color-size"].includes(g.combine))){if(n.values!==void 0&&j(l.program,i).length>1)throw new Error("A target with multiple legend blocks requires a channel block selector for exact values.");let g=l.program;const p={...n};for(const a of["position","align","offset","blockLayout","at"])delete p[a];for(const a of j(g,i))g=q.call(g,{...p,target:i,channel:a.channels[0]},!0);return g.rematerializeLegend()}let w=q.call(l.program,l.options,!0,e);for(const[g,p]of Object.entries(this.guideConfigs.legend??{}))p.target!==i||Z(p)===void 0||w.guideConfigs.legend[g]===void 0||(w=w._withLegendConfig(g,{...w.guideConfigs.legend[g],position:p.position,align:p.align,offset:p.offset,inferredOffset:p.inferredOffset,...n.direction===void 0?{direction:p.direction}:{}}));return w.rematerializeLegend()}if(Object.hasOwn(n,"combine")){if(ye(n.combine),n.combine==="size-shape"&&n.channels!==void 0&&!(n.channels.length===2&&n.channels.includes("size")&&n.channels.includes("shape")))throw new Error("size-shape combine requires exactly shape and size channels.");const l=n.channels??[...new Set(j(this,i).flatMap(L=>L.channels))];return v(this,i,{...n,channels:l},e)}if(n.channels!==void 0)return v(this,i,n,e);const r=this.guideConfigs.legend??{},f=Object.keys(r).filter(l=>r[l]?.target===i);if(n.representation!==void 0){if(r.gradient?.target!==i)throw new Error("Legend representation requires continuous color.");return V(this,"gradient",r.gradient,n)}if(r.gradient?.target===i&&r.gradient.representation==="symbols"&&f.length>1)throw new Error("Multiple legend blocks require editLegendBlock with an explicit channel for appearance or samples.");if(n.values!==void 0&&f.length>1)throw new Error("A target with multiple legend blocks requires a channel block selector for exact values.");const m=["series","color","stroke"].filter(l=>r[l]?.target===i);if(m.length>1)throw new Error("editLegend requires channels when a target owns multiple categorical legend blocks.");const c=m[0];if(c!==void 0)return H(this,c,r[c],r.size?.target===i?r.size:void 0,n);if(r.colorSize?.target===i)return N(this,r.colorSize,n);if(r.interval?.target===i)return D(this,r.interval,n);if(r.strokeInterval?.target===i)return D(this,r.strokeInterval,n,"stroke");if(r.strokeWidth?.target===i)return M(this,"strokeWidth",r.strokeWidth,n);if(r.size?.target===i)return M(this,"size",r.size,n);const S=["gradient","strokeGradient","opacity"].find(l=>r[l]?.target===i);return V(this,S,r[S],n)}const vt=Ce({op:"editLegend",description:"Edit one stable legend content, layout or appearance.",scope:"any"},we(function(n={}){if(this.compositionSpec!==void 0)return he(this,"editLegend",n);if(B(n,fe,"editLegend"),!Object.hasOwn(n,"clipHeight"))return J(this,q.call(this,n),n);const{clipHeight:t,...e}=n,o=Object.keys(e).some(f=>!["target","channel"].includes(f));let i=this;if(t==="auto"){const f=W(i,n.target,"editLegend"),m=n.channel===void 0?j(i,f):[A(i,n,"editLegend")];for(const c of m)i=i._withLegendConfig(c.kind,Y(c.config,"auto"))}let s=o?q.call(i,e):i;const u=W(s,n.target,"editLegend"),r=n.channel===void 0?j(s,u):[A(s,n,"editLegend")];if(!r.length)throw new Error("Legend clipHeight requires an existing legend block.");for(const f of r){const m=Y(s.guideConfigs.legend[f.kind],t);be(f.kind,m),s=s._withLegendConfig(f.kind,m)}return J(this,s.rematerializeLegend(),n)}));export{vt as editLegend};