ggaction 0.0.21 → 0.0.23

package/src/actions/facets/actions.js

@@ -1,793 +1 @@
-import { resolveGraphicBounds } from "../../layout/canvas.js";
-import { action, closedAction } from "../../core/action.js";
-import { registerFacetDataRevision, reviseUnitData } from "../data/revise.js";
-import { freezeOwned, isPlainObject } from "../../core/immutable.js";
-import { validateUserId } from "../../core/identifiers.js";
-import {
-  validateNonEmptyString,
-  validateNonNegativeFinite,
-  validateOptionObject,
-  validatePositiveFinite
-} from "../../core/validation.js";
-import {
-  resolveFacetDefinition,
-  resolveFacetGridDefinition
-} from "../../grammar/facets/index.js";
-import { collectFacetScaleBindings, resolveFacetFamily } from
-  "../../grammar/facets/dependencies.js";
-import {
-  FACET_SCALE_CHANNELS,
-  normalizeFacetScalePolicies
-} from "../../grammar/facets/scales.js";
-import { resolveFacetLayout } from "../../layout/facets.js";
-import { compositionChildDescriptor } from
-  "../../materialization/composition.js";
-import { deriveFacetChildren } from "./derive.js";
-import { resolveFacetChildrenScales } from "./derive.js";
-import { replayDerivedData } from "./replay.js";
-import { composeFacetGuides } from "./guides.js";
-import { applyCompositionState } from "../composition/actions.js";
-import { replayCompositionThemeState } from "../theme/composition.js";
-import { findDataset } from "../../selectors/datasets.js";
-import { findLayer } from "../../selectors/layers.js";
-import { findSemanticScale } from "../../selectors/scales.js";
-import { normalizeDisplayLabelMap } from "../../grammar/displayLabels.js";
-import {
-  createDefaultFacetHeaders,
-  normalizeFacetHeadersConfig,
-  resolveFacetHeaderConfig
-} from "../../materialization/facetHeaders.js";
-
-const FACET_OPTIONS = Object.freeze([
-  "id", "field", "data", "values", "columns", "gap", "spacing", "align", "padding", "scales",
-  "guides", "headers"
-]);
-const FACET_GRID_OPTIONS = Object.freeze([
-  "id", "data", "rows", "columns", "combinations", "gap", "spacing", "align",
-  "padding", "scales", "guides", "headers"
-]);
-const REPEAT_OPTIONS = Object.freeze([
-  "id", "target", "channel", "fields", "columns", "gap", "spacing", "align",
-  "padding", "scales", "guides", "headers"
-]);
-const SOURCE_EDIT_OPTIONS = Object.freeze(["program"]);
-const GUIDE_OPTIONS = Object.freeze(["axes", "legend"]);
-const HEADER_OPTIONS = Object.freeze([
-  "fontSize", "fontFamily", "fontWeight", "color", "offset", "role",
-  "labelMap", "side", "align"
-]);
-const HEADER_STYLE_OPTIONS = Object.freeze([
-  "fontSize", "fontFamily", "fontWeight", "color", "offset", "align"
-]);
-
-function normalizeGuides(guides, allowStored = false) {
-  if (guides === undefined) return { axes: "each", legend: false };
-  validateOptionObject(guides, GUIDE_OPTIONS, "facet.guides");
-  const axes = guides.axes ?? "each";
-  if (!["each", "outer"].includes(axes)) {
-    throw new Error('facet guides.axes must be "each" or "outer".');
-  }
-  const legend = guides.legend ?? false;
-  if (legend !== false && legend !== "shared" && !isPlainObject(legend)) {
-    throw new Error('facet guides.legend must be false, "shared", or legend options.');
-  }
-  if (!allowStored && isPlainObject(legend) && Object.hasOwn(legend, "type")) {
-    throw new Error("Facet legend options do not accept internal type tags.");
-  }
-  return { axes, legend };
-}
-
-function requireFacetProgram(program, operation) {
-  program._assertCompositionProgram(operation);
-  if (program.compositionSpec.type !== "facet") {
-    throw new Error(`${operation} requires a facet composition.`);
-  }
-}
-
-function usedFacetScalePolicies(program, policies) {
-  const used = new Set(
-    collectFacetScaleBindings(program.semanticSpec).map(binding => binding.policyKey)
-  );
-  return Object.fromEntries(
-    FACET_SCALE_CHANNELS.flatMap(channel =>
-      used.has(channel) ? [[channel, policies[channel]]] : []
-    )
-  );
-}
-
-function facetUnitTemplate(program) {
-  const seedId = program.compositionSpec.children.find(id =>
-    program.children[id]?.semanticSpec.layers.length > 0
-  ) ?? program.compositionSpec.children[0];
-  const seed = program.children[seedId];
-  if (seed === undefined) {
-    throw new Error(`Facet "${program.compositionSpec.id}" requires a retained child.`);
-  }
-  const { facets: _facets, guides: _guides, ...unitConfigs } = program.materializationConfigs;
-  return new program.constructor({
-    semanticSpec: program.semanticSpec,
-    graphicSpec: seed.graphicSpec,
-    resolvedScales: program.resolvedScales,
-    materializationConfigs: freezeOwned({
-      ...unitConfigs,
-      ...(seed.materializationConfigs.theme === undefined
-        ? {}
-        : { theme: seed.materializationConfigs.theme }),
-      ...(seed.materializationConfigs.guides === undefined
-        ? {}
-        : { guides: seed.materializationConfigs.guides }),
-      canvas: seed.materializationConfigs.canvas
-    }),
-    children: {},
-    context: program.context,
-    trace: program.trace,
-    actionStack: program.actionStack,
-    actionSequence: program._actionSequence
-  });
-}
-
-function rederiveFacet(program, { scales, guides }) {
-  const current = program.compositionSpec;
-  if (current.facet.repeat !== undefined) {
-    const template = facetUnitTemplate(program);
-    const definition = resolveRepeatDefinition(template, {
-      id: current.id,
-      ...current.facet.repeat
-    });
-    const derived = deriveRepeatChildren(
-      template,
-      definition,
-      usedFacetScalePolicies(template, scales),
-      true
-    );
-    return applyCompositionState(program, {
-      children: derived.children,
-      compositionSpec: {
-        ...current,
-        facet: { ...current.facet, scales, guides }
-      }
-    }, current.children);
-  }
-  const definition = current.facet.grid === undefined
-    ? resolveFacetDefinition(program.semanticSpec, {
-        id: current.id,
-        data: current.facet.data,
-        field: current.facet.field,
-        values: current.facet.values
-      })
-    : resolveFacetGridDefinition(program.semanticSpec, {
-        id: current.id,
-        data: current.facet.data,
-        rows: current.facet.grid.rows,
-        columns: current.facet.grid.columns,
-        combinations: current.facet.grid.combinations
-      });
-  const request = usedFacetScalePolicies(program, scales);
-  const normalized = normalizeFacetScalePolicies(program.semanticSpec, request);
-  const template = facetUnitTemplate(program);
-  const derived = deriveFacetChildren(template, definition, {
-    closeInheritedAction: true,
-    stripTitle: true,
-    scales: request
-  });
-  const compositionSpec = {
-    ...current,
-    facet: {
-      ...current.facet,
-      scales: normalized.channels,
-      guides
-    }
-  };
-  let parent = program._withoutMaterializationConfig(["guides", "legend"]);
-  for (const [kind, config] of Object.entries(template.guideConfigs.legend ?? {})) {
-    parent = parent._withLegendConfig(kind, config);
-  }
-  return applyCompositionState(parent, {
-    children: derived.children,
-    compositionSpec
-  }, compositionSpec.children);
-}
-
-function resolveEditedFacetHeaders(currentHeaders, args, grid, operation = "editFacetHeaders") {
-  validateOptionObject(args, HEADER_OPTIONS, operation, {
-    allowEmpty: false,
-    emptyMessage: `${operation} requires at least one change.`
-  });
-  const role = args.role ?? "all";
-  if (!["all", "row", "column"].includes(role)) {
-    throw new Error(`Unknown facet header role "${role}".`);
-  }
-  if (role === "all" && Object.hasOwn(args, "side")) {
-    throw new Error(`${operation} side requires an explicit row or column role.`);
-  }
-  if (role === "row" && grid === undefined) {
-    throw new Error(`${operation} row role requires a row-column facet grid.`);
-  }
-  if (Object.hasOwn(args, "side")) {
-    const sides = role === "row" ? ["left", "right"]
-      : grid === undefined
-        ? ["top", "bottom", "left", "right"] : ["top", "bottom"];
-    if (!sides.includes(args.side)) {
-      throw new Error(`${operation} ${role} side must be ${sides.join(" or ")}.`);
-    }
-  }
-  if (Object.hasOwn(args, "align") &&
-      !["start", "center", "end"].includes(args.align)) {
-    throw new Error(`${operation} align must be start, center, or end.`);
-  }
-  if (role === "all" && Object.keys(args).every(key => key === "role")) {
-    throw new Error(`${operation} requires at least one change.`);
-  }
-  const current = normalizeFacetHeadersConfig(currentHeaders);
-  const owner = role === "all" ? "common" : role;
-  const patch = { ...current[owner] };
-  for (const key of HEADER_STYLE_OPTIONS) {
-    if (Object.hasOwn(args, key)) patch[key] = args[key];
-  }
-  if (Object.hasOwn(args, "side")) patch.side = args.side;
-  if (Object.hasOwn(args, "labelMap")) {
-    if (args.labelMap === "auto") delete patch.labelMap;
-    else {
-      patch.labelMap = normalizeDisplayLabelMap(
-        args.labelMap,
-        `${operation} ${role} labelMap`
-      );
-    }
-  }
-  const headers = {
-    ...current,
-    ...(role === "all" ? {} : { mode: "roles" }),
-    [owner]: patch
-  };
-  for (const headerRole of ["all", "row", "column"]) {
-    const resolved = resolveFacetHeaderConfig(headers, headerRole);
-    validatePositiveFinite(resolved.fontSize, `Facet ${headerRole} header fontSize`);
-    validateNonEmptyString(resolved.fontFamily, `Facet ${headerRole} header fontFamily`);
-    validateNonEmptyString(resolved.color, `Facet ${headerRole} header color`);
-    validateNonNegativeFinite(resolved.offset, `Facet ${headerRole} header offset`);
-    if (!(
-      (typeof resolved.fontWeight === "string" && resolved.fontWeight.length > 0) ||
-      Number.isFinite(resolved.fontWeight)
-    )) {
-      throw new TypeError(
-        `Facet ${headerRole} header fontWeight must be a non-empty string or number.`
-      );
-    }
-    if (!["start", "center", "end"].includes(resolved.align)) {
-      throw new Error(`Facet ${headerRole} header align must be start, center, or end.`);
-    }
-    if (resolved.labelMap !== undefined) {
-      normalizeDisplayLabelMap(
-        resolved.labelMap,
-        `Facet ${headerRole} header labelMap`
-      );
-    }
-  }
-  return headers;
-}
-
-function initialFacetHeaders(value, grid) {
-  let headers = createDefaultFacetHeaders();
-  if (value === undefined) return headers;
-  validateOptionObject(value, [...HEADER_STYLE_OPTIONS, "labelMap", "row", "column"], "facet.headers");
-  const { row, column, ...common } = value;
-  if (Object.keys(common).length > 0) headers = resolveEditedFacetHeaders(headers, common, grid, "facet.headers");
-  for (const [role, patch] of [["row", row], ["column", column]]) {
-    if (patch === undefined) continue;
-    validateOptionObject(patch, HEADER_OPTIONS.filter(key => key !== "role"), `facet.headers.${role}`);
-    headers = resolveEditedFacetHeaders(headers, { ...patch, role }, grid, `facet.headers.${role}`);
-  }
-  return headers;
-}
-
-function composeDerivedFacet(program, args, { definition, derived, guides, scalePolicies, facet }) {
-  const headers = initialFacetHeaders(args.headers, definition.grid);
-  const preflight = resolveFacetLayout({
-    spacing: args.spacing,
-    plots: Object.entries(derived.children).map(([id, child]) => ({ id, ...resolveGraphicBounds(child) })),
-    children: definition.cells.map(cell => ({
-      ...compositionChildDescriptor(cell.id, derived.children[cell.id]), value: cell.value,
-      ...(definition.grid === undefined ? {} : { row: cell.row, column: cell.column })
-    })),
-    columns: definition.grid?.columns.values.length ?? args.columns,
-    gap: args.gap, align: args.align, padding: args.padding,
-    sharedLegend: guides.legend === "shared"
-  });
-  const compositionSpec = {
-    id: definition.id, type: "facet", children: definition.cells.map(cell => cell.id),
-    columns: preflight.columns, gap: preflight.gap, align: preflight.align, padding: preflight.padding,
-    ...(preflight.spacing === undefined ? {} : { spacing: preflight.spacing }),
-    facet: { data: definition.data, ...facet, scales: scalePolicies.channels, guides }
-  };
-  return applyCompositionState(
-    program._withMaterializationConfig(["facets", definition.id], { headers }),
-    { children: derived.children, compositionSpec }, compositionSpec.children
-  );
-}
-
-function partitionFacetAction(op, description, definitionResolver) {
-  return closedAction({ op, description }, op === "facet" ? FACET_OPTIONS : FACET_GRID_OPTIONS,
-    function (args = {}) {
-      const guides = normalizeGuides(args.guides);
-      const definition = definitionResolver(this.semanticSpec, args);
-      if (definition.family !== "cartesian" && guides.axes === "outer") {
-        throw new Error("Polar and Parallel facets do not support outer axes.");
-      }
-      const scalePolicies = normalizeFacetScalePolicies(this.semanticSpec, args.scales ?? {});
-      const derived = deriveFacetChildren(this, definition, {
-        closeInheritedAction: true, stripTitle: true, scales: args.scales ?? {}
-      });
-      const facet = definition.grid === undefined
-        ? { field: definition.field, values: definition.values }
-        : { values: definition.cells.map(cell => cell.value), grid: {
-            ...definition.grid, cells: definition.cells.map(cell => ({
-              id: cell.id, row: cell.row, column: cell.column,
-              rowValue: cell.rowValue, columnValue: cell.columnValue, empty: cell.empty
-            }))
-          } };
-      return composeDerivedFacet(this, args, { definition, derived, guides, scalePolicies, facet });
-    });
-}
-
-export const facet = /* @__PURE__ */ partitionFacetAction("facet",
-  "Repeat one direct-source chart by field value.", resolveFacetDefinition);
-
-function resolveRepeatDefinition(program, args) {
-  if (!isPlainObject(args)) {
-    throw new TypeError("repeatCharts options must be a plain object.");
-  }
-  const id = validateUserId(args.id ?? "repeat", "Repeat id");
-  const parallelChannel = isPlainObject(args.channel);
-  if (parallelChannel) {
-    const keys = Object.keys(args.channel);
-    if (keys.length !== 1 || keys[0] !== "parallelDimension" ||
-        typeof args.channel.parallelDimension !== "string" ||
-        args.channel.parallelDimension.length === 0) {
-      throw new Error(
-        "repeatCharts Parallel channel must contain exactly one non-empty parallelDimension."
-      );
-    }
-  } else if (!["x", "y", "theta", "r"].includes(args.channel)) {
-    throw new Error(
-      'repeatCharts channel must be "x", "y", "theta", "r", or one parallelDimension.'
-    );
-  }
-  if (!Array.isArray(args.fields) || args.fields.length === 0 ||
-      args.fields.some(field => typeof field !== "string" || field.length === 0)) {
-    throw new TypeError("repeatCharts fields must be a non-empty array of field names.");
-  }
-  if (new Set(args.fields).size !== args.fields.length) {
-    throw new Error("repeatCharts fields must be unique.");
-  }
-  const family = resolveFacetFamily(program.semanticSpec).family;
-  const semanticChannel = args.channel === "r" ? "radius" : args.channel;
-  const eligible = program.semanticSpec.layers.filter(layer => {
-    if (parallelChannel) {
-      const matches = (layer.encoding?.parallel?.dimensions ?? []).filter(
-        dimension => dimension.field === args.channel.parallelDimension
-      );
-      return family === "parallel" && layer.mark?.type === "line" && matches.length === 1;
-    }
-    if (["x", "y"].includes(args.channel)) {
-      return family === "cartesian" &&
-        layer.encoding?.x?.scale !== undefined &&
-        layer.encoding?.y?.scale !== undefined &&
-        layer.encoding?.[args.channel]?.field !== undefined &&
-        ["point", "line", "area", "bar", "rule", "tick", "rect"].includes(layer.mark?.type);
-    }
-    const role = program.markConfigs[layer.id]?.compositionRole;
-    if (family !== "polar" || ["pie", "radar"].includes(role)) return false;
-    return ["point", "line", "arc"].includes(layer.mark?.type) &&
-      layer.encoding?.[semanticChannel]?.field !== undefined;
-  });
-  let target;
-  if (args.target !== undefined) {
-    target = validateUserId(args.target, "Repeat target");
-    if (!eligible.some(layer => layer.id === target)) {
-      throw new Error(
-        `repeatCharts target "${target}" is not eligible for the requested field role.`
-      );
-    }
-  } else if (eligible.length === 1) {
-    target = eligible[0].id;
-  } else {
-    throw new Error(
-      eligible.length === 0
-        ? "repeatCharts requires one eligible complete mark for the requested field role."
-        : "repeatCharts target is ambiguous; provide target."
-    );
-  }
-  const unrelatedLayers = program.semanticSpec.layers.filter(layer => {
-    if (layer.id === target) return false;
-    const attachedLabel = layer.mark?.type === "text" && layer.source === target;
-    const statisticalReference = program.markConfigs[layer.id]
-      ?.statisticalReference?.source === target;
-    return !attachedLabel && !statisticalReference;
-  });
-  if (unrelatedLayers.length > 0) {
-    throw new Error("repeatCharts currently supports one direct mark only.");
-  }
-  const config = program.markConfigs[target] ?? {};
-  const composite = [
-    "boxPlot", "gradientPlot", "violinPlot", "regressionPlot", "endpointPlot",
-    "ecdfPlot", "raincloudPlot", "intervalPlot"
-  ].find(key => config[key] !== undefined);
-  if (composite !== undefined) {
-    throw new Error(`repeatCharts does not replace the ${composite} composite role.`);
-  }
-  const layer = findLayer(program, target);
-  const dataset = findDataset(program, layer.data);
-  if (dataset?.transform?.length > 0) {
-    throw new Error("repeatCharts does not rewrite a derived dataset dependency.");
-  }
-  const encoding = parallelChannel
-    ? layer.encoding.parallel
-    : layer.encoding[semanticChannel];
-  const dimensionIndex = parallelChannel
-    ? encoding.dimensions.findIndex(
-        dimension => dimension.field === args.channel.parallelDimension
-      )
-    : undefined;
-  return {
-    id,
-    target,
-    channel: parallelChannel ? { ...args.channel } : args.channel,
-    policyKey: parallelChannel ? "parallelDimensions" : args.channel,
-    fields: [...args.fields],
-    data: layer.data,
-    encoding,
-    ...(dimensionIndex === undefined ? {} : { dimensionIndex }),
-    cells: args.fields.map((field, index) => ({
-      id: `${id}-field-${index + 1}`,
-      field,
-      value: field
-    }))
-  };
-}
-
-function repeatEncodingArgs(definition, field) {
-  const encoding = definition.encoding;
-  return {
-    target: definition.target,
-    field,
-    fieldType: encoding.fieldType,
-    ...(encoding.temporalUnit === undefined ? {} : { temporalUnit: encoding.temporalUnit }),
-    ...(encoding.aggregate === undefined ? {} : { aggregate: encoding.aggregate }),
-    ...(encoding.bin === undefined ? {} : { bin: encoding.bin }),
-    ...(encoding.stack === undefined ? {} : { stack: encoding.stack }),
-    ...(encoding.weight === undefined ? {} : { weight: encoding.weight }),
-    scale: { id: encoding.scale }
-  };
-}
-
-function parallelRepeatDimensions(program, definition, field) {
-  return definition.encoding.dimensions.map((dimension, index) => {
-    const semanticScale = findSemanticScale(program, dimension.scale);
-    if (semanticScale === undefined) {
-      throw new Error(`repeatCharts Parallel dimension scale "${dimension.scale}" is missing.`);
-    }
-    const { id: _id, ...scale } = semanticScale;
-    void _id;
-    const replacement = index === definition.dimensionIndex;
-    return {
-      field: replacement ? field : dimension.field,
-      fieldType: dimension.fieldType,
-      title: replacement && dimension.title === dimension.field
-        ? field
-        : dimension.title,
-      scale
-    };
-  });
-}
-
-function deriveRepeatedProgram(template, definition, field) {
-  if (isPlainObject(definition.channel)) {
-    return template.encodeParallelCoordinates({
-      target: definition.target,
-      coordinate: findLayer(template, definition.target).coordinate,
-      dimensions: parallelRepeatDimensions(template, definition, field),
-      ...(definition.encoding.key === undefined ? {} : { key: definition.encoding.key }),
-      missing: definition.encoding.missing
-    });
-  }
-  const operation = {
-    x: "encodeX",
-    y: "encodeY",
-    theta: "encodeTheta",
-    r: "encodeR"
-  }[definition.channel];
-  return template[operation](repeatEncodingArgs(definition, field));
-}
-
-function deriveRepeatChildren(base, definition, scales, closeInheritedAction) {
-  const template = base.semanticSpec.title.text === undefined
-    ? base
-    : base.removeTitle();
-  const independentlyResolved = Object.fromEntries(definition.cells.map(cell => [
-    cell.id,
-    deriveRepeatedProgram(template, definition, cell.field)
-  ]));
-  return resolveFacetChildrenScales(
-    template,
-    definition.cells.map(cell => cell.id),
-    independentlyResolved,
-    scales,
-    closeInheritedAction
-  );
-}
-
-export const repeatCharts = /* @__PURE__ */ closedAction(
-  {
-    op: "repeatCharts",
-    description: "Repeat one direct chart across an ordered field-role list."
-  }, REPEAT_OPTIONS,
-  function (args = {}) {
-    const guides = normalizeGuides(args.guides);
-    if (guides.axes === "outer") {
-      throw new Error("repeatCharts does not promote axes across different repeated fields.");
-    }
-    const definition = resolveRepeatDefinition(this, args);
-    const requestedScales = {
-      ...(args.scales ?? {}),
-      [definition.policyKey]: args.scales?.[definition.policyKey] ?? "independent"
-    };
-    const scalePolicies = normalizeFacetScalePolicies(
-      this.semanticSpec,
-      requestedScales
-    );
-    const derived = deriveRepeatChildren(
-      this,
-      definition,
-      requestedScales,
-      true
-    );
-    return composeDerivedFacet(this, args, {
-      definition, derived, guides, scalePolicies,
-      facet: { values: definition.fields,
-        repeat: { target: definition.target, channel: definition.channel, fields: definition.fields } }
-    });
-  }
-);
-
-export const facetGrid = /* @__PURE__ */ partitionFacetAction("facetGrid",
-  "Repeat one direct-source Cartesian chart across a row and column field grid.", resolveFacetGridDefinition);
-
-export const editFacetHeaders = /* @__PURE__ */ action(
-  {
-    op: "editFacetHeaders",
-    description: "Edit parent-owned facet header appearance.",
-    scope: "composition"
-  },
-  function (args = {}) {
-    requireFacetProgram(this, "editFacetHeaders");
-    const id = this.compositionSpec.id;
-    const config = this.materializationConfigs.facets?.[id];
-    if (!isPlainObject(config?.headers)) {
-      throw new Error(`Facet "${id}" requires header configuration.`);
-    }
-    const headers = resolveEditedFacetHeaders(config.headers, args, this.compositionSpec.facet.grid);
-    return this
-      ._withMaterializationConfig(["facets", id], { ...config, headers })
-      .materializeComposition();
-  }
-);
-
-export const editFacetScales = /* @__PURE__ */ action(
-  {
-    op: "editFacetScales",
-    description: "Edit facet scale-resolution policies and rederive every cell.",
-    scope: "composition"
-  },
-  function (args = {}) {
-    requireFacetProgram(this, "editFacetScales");
-    validateOptionObject(args, FACET_SCALE_CHANNELS, "editFacetScales", {
-      allowEmpty: false,
-      emptyMessage: "editFacetScales requires at least one channel policy change."
-    });
-    for (const channel of Object.keys(args)) {
-      if (!collectFacetScaleBindings(this.semanticSpec).some(
-        binding => binding.policyKey === channel
-      )) {
-        throw new Error(
-          `Facet scale channel "${channel}" is not used by an affected layer.`
-        );
-      }
-    }
-    const current = this.compositionSpec.facet;
-    const scales = { ...current.scales, ...args };
-    if (FACET_SCALE_CHANNELS.every(
-      channel => scales[channel] === current.scales[channel]
-    )) {
-      throw new Error("editFacetScales requires at least one channel policy change.");
-    }
-    return rederiveFacet(this, {
-      scales,
-      guides: current.guides
-    });
-  }
-);
-
-export const editFacetGuides = /* @__PURE__ */ action(
-  {
-    op: "editFacetGuides",
-    description: "Edit facet guide ownership and rederive every cell.",
-    scope: "composition"
-  },
-  function (args = {}) {
-    requireFacetProgram(this, "editFacetGuides");
-    validateOptionObject(args, GUIDE_OPTIONS, "editFacetGuides", {
-      allowEmpty: false,
-      emptyMessage: "editFacetGuides requires at least one guide policy."
-    });
-    const current = this.compositionSpec.facet;
-    if (Object.hasOwn(args, "legend")) normalizeGuides({ legend: args.legend });
-    const guides = normalizeGuides({ ...current.guides, ...args }, true);
-    const family = resolveFacetFamily(this.semanticSpec).family;
-    if (family !== "cartesian" && guides.axes === "outer") {
-      throw new Error("Polar and Parallel facets do not support outer axes.");
-    }
-    if (current.repeat !== undefined && guides.axes === "outer") {
-      throw new Error("repeatCharts does not promote axes across different repeated fields.");
-    }
-    return rederiveFacet(this, {
-      scales: current.scales,
-      guides
-    });
-  }
-);
-
-function adoptUnitState(program, actionOwner) {
-  if (!(program instanceof actionOwner.constructor)) {
-    throw new TypeError("editFacetSource program must be a ChartProgram.");
-  }
-  if (program.compositionSpec !== undefined) {
-    throw new Error("editFacetSource program must be a complete unit ChartProgram.");
-  }
-  if (program.actionStack.length !== 0) {
-    throw new Error("editFacetSource program has an unfinished action stack.");
-  }
-  const seedId = actionOwner.compositionSpec.children.find(id =>
-    actionOwner.children[id]?.semanticSpec.layers.length > 0
-  ) ?? actionOwner.compositionSpec.children[0];
-  const retained = actionOwner.children[seedId]?.materializationConfigs ?? {};
-  const {
-    canvas: _retainedCanvas,
-    theme: _retainedTheme,
-    facets: _retainedFacets,
-    ...retainedRecipe
-  } = retained;
-  void _retainedCanvas;
-  void _retainedTheme;
-  void _retainedFacets;
-  return new actionOwner.constructor({
-    semanticSpec: program.semanticSpec,
-    graphicSpec: program.graphicSpec,
-    resolvedScales: program.resolvedScales,
-    materializationConfigs: freezeOwned({
-      ...program.materializationConfigs,
-      ...retainedRecipe,
-      ...(program.materializationConfigs.canvas === undefined
-        ? {}
-        : { canvas: program.materializationConfigs.canvas }),
-      ...(program.materializationConfigs.theme === undefined
-        ? {}
-        : { theme: program.materializationConfigs.theme })
-    }),
-    children: {},
-    context: program.context,
-    trace: actionOwner.trace,
-    actionStack: actionOwner.actionStack,
-    actionSequence: actionOwner._actionSequence
-  });
-}
-
-export const editFacetSource = /* @__PURE__ */ closedAction(
-  {
-    op: "editFacetSource",
-    description: "Reapply one facet, grid, or repeat recipe to a revised complete unit program.",
-    scope: "composition"
-  }, SOURCE_EDIT_OPTIONS,
-  function (args = {}) {
-    requireFacetProgram(this, "editFacetSource");
-    const current = this.compositionSpec;
-    const facetConfig = this.materializationConfigs.facets?.[current.id];
-    const base = adoptUnitState(args.program, this);
-    const authored = isPlainObject(current.facet.guides.legend);
-    const guides = authored ? { ...current.facet.guides, legend: false } : current.facet.guides;
-    let revised;
-    const scales = usedFacetScalePolicies(base, current.facet.scales);
-    if (current.facet.grid !== undefined) {
-      revised = base.facetGrid({
-        id: current.id,
-        data: current.facet.data,
-        rows: current.facet.grid.rows,
-        columns: current.facet.grid.columns,
-        combinations: current.facet.grid.combinations,
-        gap: current.gap,
-        ...(current.spacing === undefined ? {} : { spacing: current.spacing }),
-        align: current.align,
-        padding: current.padding,
-        scales,
-        guides
-      });
-    } else if (current.facet.repeat !== undefined) {
-      revised = base.repeatCharts({
-        id: current.id,
-        ...current.facet.repeat,
-        columns: current.columns,
-        gap: current.gap,
-        ...(current.spacing === undefined ? {} : { spacing: current.spacing }),
-        align: current.align,
-        padding: current.padding,
-        scales,
-        guides
-      });
-    } else {
-      revised = base.facet({
-        id: current.id,
-        data: current.facet.data,
-        field: current.facet.field,
-        values: current.facet.values,
-        columns: current.columns,
-        gap: current.gap,
-        ...(current.spacing === undefined ? {} : { spacing: current.spacing }),
-        align: current.align,
-        padding: current.padding,
-        scales,
-        guides
-      });
-    }
-    if (authored) {
-      const spec = revised.compositionSpec;
-      revised = revised._withCompositionState({ children: revised.children,
-        compositionSpec: { ...spec, facet: { ...spec.facet, guides: current.facet.guides } } });
-    }
-    if (facetConfig !== undefined) {
-      revised = revised
-        ._withMaterializationConfig(["facets", current.id], facetConfig)
-        .materializeComposition();
-    }
-    if (revised.semanticSpec.title.text !== undefined) {
-      revised = revised.removeTitle();
-    }
-    if (this.semanticSpec.title.text !== undefined) {
-      revised = revised.createTitle({
-        ...this.titleConfig,
-        ...this.semanticSpec.title
-      });
-    }
-    return replayCompositionThemeState(
-      revised,
-      this.materializationConfigs.theme
-    );
-  }
-);
-
-export function registerFacetActions(ProgramClass) {
-  registerFacetDataRevision((program, args) => {
-    const { program: unit, plan } = reviseUnitData(facetUnitTemplate(program), args);
-    const current = program.compositionSpec;
-    // Adopt an already-materialized unit revision into the retained parent.
-    const revised = new program.constructor({
-      ...unit,
-      graphicSpec: program.graphicSpec,
-      children: program.children,
-      materializationConfigs: { ...unit.materializationConfigs,
-        facets: program.materializationConfigs.facets,
-        ...(program.titleConfig === undefined ? {} : { title: program.titleConfig }) },
-      actionSequence: unit._actionSequence,
-      compositionSpec: { ...current, facet: { ...current.facet,
-        data: plan.replacements.get(current.facet.data) ?? current.facet.data } }
-    });
-    return rederiveFacet(revised, current.facet);
-  });
-  ProgramClass.prototype.replayDerivedData = replayDerivedData;
-  ProgramClass.prototype.composeFacetGuides = composeFacetGuides;
-  ProgramClass.prototype.facet = facet;
-  ProgramClass.prototype.facetGrid = facetGrid;
-  ProgramClass.prototype.repeatCharts = repeatCharts;
-  ProgramClass.prototype.editFacetHeaders = editFacetHeaders;
-  ProgramClass.prototype.editFacetScales = editFacetScales;
-  ProgramClass.prototype.editFacetGuides = editFacetGuides;
-  ProgramClass.prototype.editFacetSource = editFacetSource;
-}
+import{normalizeFacetAxes as R,validateFacetAxisPolicy as x}from"../../core/facetAxisPolicy.js";import{DEFAULT_ACTION_METHODS as te}from"../../core/vocabulary.js";import{axisGraphicIds as ie}from"../../materialization/guides/resources.js";import{cartesianAxisOwners as ne,axisTargetArgs as ae}from"../../selectors/axes.js";import{resolveGraphicBounds as oe}from"../../layout/canvas.js";import{action as z,closedAction as T,getWrappedActionMetadata as ce}from"../../core/action.js";import{registerFacetDataRevision as se,reviseUnitData as re}from"../data/revise.js";import{applyMaterializationPlan as de}from"../../materialization/dependencies.js";import{getMarkMaterializationStep as le}from"../../materialization/marks/index.js";import{buildMaterializationPlan as fe}from"../../materialization/planner.js";import{freezeOwned as A,isPlainObject as S}from"../../core/immutable.js";import{validateUserId as P}from"../../core/identifiers.js";import{validateNonEmptyString as $,validateNonNegativeFinite as pe,validateOptionObject as w,validatePositiveFinite as ue}from"../../core/validation.js";import{resolveFacetDefinition as G,resolveFacetGridDefinition as I}from"../../grammar/facets/index.js";import{collectFacetScaleBindings as N,resolveFacetFamily as k}from"../../grammar/facets/dependencies.js";import{FACET_SCALE_CHANNELS as _,normalizeFacetScalePolicies as j}from"../../grammar/facets/scales.js";import{resolveFacetLayout as he}from"../../layout/facets.js";import{compositionChildDescriptor as me}from"../../materialization/composition.js";import{deriveFacetChildren as H}from"./derive.js";import{resolveFacetChildrenScales as ge}from"./derive.js";import{replayDerivedData as Se}from"./replay.js";import{composeFacetGuides as we}from"./guides.js";import{applyCompositionState as q}from"../composition/actions.js";import{replayCompositionThemeState as ye}from"../theme/composition.js";import{findDataset as Fe}from"../../selectors/datasets.js";import{findLayer as U}from"../../selectors/layers.js";import{findSemanticScale as be}from"../../selectors/scales.js";import{normalizeDisplayLabelMap as W}from"../../grammar/displayLabels.js";import{resolveRotation as ve}from"../../grammar/rotation.js";import{normalizeFacetHeaderTitle as Ce}from"../../grammar/facetHeaders.js";import{createDefaultFacetHeaders as Ee,normalizeFacetHeadersConfig as K,resolveFacetHeaderConfig as Oe}from"../../materialization/facetHeaders.js";const xe=Object.freeze(["id","field","data","values","columns","gap","spacing","topLane","align","padding","scales","guides","headers"]),ze=Object.freeze(["id","data","rows","columns","combinations","gap","spacing","topLane","align","padding","scales","guides","headers"]),Te=Object.freeze(["id","target","channel","fields","columns","gap","spacing","topLane","align","padding","scales","guides","headers"]),$e=new Set(te),ke=Object.freeze(["program","action"]),V=Object.freeze(["axes","legend"]),B=Object.freeze(["fontSize","fontFamily","fontWeight","color","offset","role","labelMap","side","align","rotation","title","anchor"]),Y=Object.freeze(["fontSize","fontFamily","fontWeight","color","offset","align","rotation","anchor"]);function b(t,e=!1){if(t===void 0)return{axes:"each",legend:!1};w(t,V,"facet.guides");const n=R(t.axes),i=t.legend??!1;if(i!==!1&&i!=="shared"&&!S(i))throw new Error('facet guides.legend must be false, "shared", or legend options.');if(!e&&S(i)&&Object.hasOwn(i,"type"))throw new Error("Facet legend options do not accept internal type tags.");return{axes:n,legend:i}}function v(t,e){if(t._assertCompositionProgram(e),t.compositionSpec.type!=="facet")throw new Error(`${e} requires a facet composition.`)}function C(t,e){const n=new Set(N(t.semanticSpec).map(i=>i.policyKey));return Object.fromEntries(_.flatMap(i=>n.has(i)&&e[i]!==void 0?[[i,e[i]]]:[]))}function E(t,e=!1){const n=t.compositionSpec.children.find(l=>t.children[l]?.semanticSpec.layers.length>0)??t.compositionSpec.children[0],i=t.children[n];if(i===void 0)throw new Error(`Facet "${t.compositionSpec.id}" requires a retained child.`);const{facets:c,guides:o,...d}=t.materializationConfigs,{legend:s,...r}=t.semanticSpec.guides,a={...i.materializationConfigs.guides,axis:o?.axis??i.guideConfigs.axis,grid:o?.grid??i.guideConfigs.grid};return e&&delete d.title,new t.constructor({semanticSpec:e?{...t.semanticSpec,title:{},guides:{...r,...i.semanticSpec.guides.legend===void 0?{}:{legend:i.semanticSpec.guides.legend}}}:t.semanticSpec,graphicSpec:i.graphicSpec,resolvedScales:t.resolvedScales,materializationConfigs:A({...d,...i.materializationConfigs.theme===void 0?{}:{theme:i.materializationConfigs.theme},...a===void 0?{}:{guides:a},canvas:i.materializationConfigs.canvas}),children:{},context:t.context,trace:t.trace,actionStack:t.actionStack,actionSequence:t._actionSequence})}function D(t,{scales:e,guides:n}){const i=t.compositionSpec;if(i.facet.repeat!==void 0){const f=E(t),u=Q(f,{id:i.id,...i.facet.repeat}),m=Z(f,u,C(f,e),!0);return q(t,{children:m.children,compositionSpec:{...i,facet:{...i.facet,scales:e,guides:n}}},i.children)}const c=i.facet.grid===void 0?G(t.semanticSpec,{id:i.id,data:i.facet.data,field:i.facet.field,values:i.facet.values}):I(t.semanticSpec,{id:i.id,data:i.facet.data,rows:i.facet.grid.rows,columns:i.facet.grid.columns,combinations:i.facet.grid.combinations}),o=C(t,e),d=j(t.semanticSpec,o),s=E(t),r=H(s,c,{closeInheritedAction:!0,stripTitle:!0,scales:o}),a={...i,facet:{...i.facet,scales:d.channels,guides:n}};let l=t._withoutMaterializationConfig(["guides","legend"]);for(const[f,u]of Object.entries(s.guideConfigs.legend??{}))l=l._withLegendConfig(f,u);return q(l,{children:r.children,compositionSpec:a},a.children)}function L(t,e,n,i="editFacetHeaders"){w(e,B,i,{allowEmpty:!1,emptyMessage:`${i} requires at least one change.`});const c=e.role??"all";if(!["all","row","column"].includes(c))throw new Error(`Unknown facet header role "${c}".`);if(c==="all"&&Object.hasOwn(e,"side"))throw new Error(`${i} side requires an explicit row or column role.`);if(c==="all"&&Object.hasOwn(e,"title"))throw new Error(`${i} title requires an explicit row or column role.`);if(c==="row"&&n===void 0)throw new Error(`${i} row role requires a row-column facet grid.`);if(Object.hasOwn(e,"side")){const a=c==="row"?["left","right"]:n===void 0?["top","bottom","left","right"]:["top","bottom"];if(!a.includes(e.side))throw new Error(`${i} ${c} side must be ${a.join(" or ")}.`)}if(Object.hasOwn(e,"align")&&!["start","center","end"].includes(e.align))throw new Error(`${i} align must be start, center, or end.`);if(c==="all"&&Object.keys(e).every(a=>a==="role"))throw new Error(`${i} requires at least one change.`);const o=K(t),d=c==="all"?"common":c,s={...o[d]};if(Object.hasOwn(e,"title")){const a=Ce(s.title,e.title);a===void 0?delete s.title:s.title=a}for(const a of Y)Object.hasOwn(e,a)&&(s[a]=e[a]);Object.hasOwn(e,"rotation")&&(s.rotation=ve(e.rotation,`${i} ${c} rotation`)),Object.hasOwn(e,"side")&&(s.side=e.side),Object.hasOwn(e,"labelMap")&&(e.labelMap==="auto"?delete s.labelMap:s.labelMap=W(e.labelMap,`${i} ${c} labelMap`));const r={...o,...c==="all"?{}:{mode:"roles"},[d]:s};for(const a of["all","row","column"]){const l=Oe(r,a);if(ue(l.fontSize,`Facet ${a} header fontSize`),$(l.fontFamily,`Facet ${a} header fontFamily`),$(l.color,`Facet ${a} header color`),pe(l.offset,`Facet ${a} header offset`),l.rotation!==void 0&&!Number.isFinite(l.rotation))throw new TypeError(`Facet ${a} header rotation must resolve to finite radians.`);if(!(typeof l.fontWeight=="string"&&l.fontWeight.length>0||Number.isFinite(l.fontWeight)))throw new TypeError(`Facet ${a} header fontWeight must be a non-empty string or number.`);if(!["start","center","end"].includes(l.align))throw new Error(`Facet ${a} header align must be start, center, or end.`);l.labelMap!==void 0&&W(l.labelMap,`Facet ${a} header labelMap`)}return r}function _e(t,e){let n=Ee();if(t===void 0)return n;w(t,[...Y,"labelMap","row","column"],"facet.headers");const{row:i,column:c,...o}=t;Object.keys(o).length>0&&(n=L(n,o,e,"facet.headers"));for(const[d,s]of[["row",i],["column",c]])s!==void 0&&(w(s,B.filter(r=>r!=="role"),`facet.headers.${d}`),n=L(n,{...s,role:d},e,`facet.headers.${d}`));return n}function X(t,e,{definition:n,derived:i,guides:c,scalePolicies:o,facet:d}){const s=t.materializationConfigs.facets?.[n.id]?.headers,r=e.headers===void 0&&s!==void 0?K(s):_e(e.headers,n.grid),a=he({spacing:e.spacing,topLane:e.topLane,plots:Object.entries(i.children).map(([f,u])=>({id:f,...oe(u)})),children:n.cells.map(f=>({...me(f.id,i.children[f.id]),value:f.value,...n.grid===void 0?{}:{row:f.row,column:f.column}})),columns:n.grid?.columns.values.length??e.columns,gap:e.gap,align:e.align,padding:e.padding,sharedLegend:c.legend==="shared"}),l={id:n.id,type:"facet",children:n.cells.map(f=>f.id),columns:a.columns,gap:a.gap,align:a.align,padding:a.padding,...a.spacing===void 0?{}:{spacing:a.spacing},...a.topLane===void 0?{}:{topLane:a.topLane},facet:{data:n.data,...d,scales:o.channels,guides:c}};return q(t._withMaterializationConfig(["facets",n.id],{headers:r}),{children:i.children,compositionSpec:l},l.children)}function J(t,e,n){return T({op:t,description:e},t==="facet"?xe:ze,function(i={}){const c=b(i.guides),o=n(this.semanticSpec,i);x(c.axes,o.family);const d=j(this.semanticSpec,i.scales??{}),s=H(this,o,{closeInheritedAction:!0,stripTitle:!0,scales:i.scales??{}}),r=o.grid===void 0?{field:o.field,values:o.values}:{values:o.cells.map(a=>a.value),grid:{...o.grid,cells:o.cells.map(a=>({id:a.id,row:a.row,column:a.column,rowValue:a.rowValue,columnValue:a.columnValue,empty:a.empty}))}};return X(this,i,{definition:o,derived:s,guides:c,scalePolicies:d,facet:r})})}const je=J("facet","Repeat one direct-source chart by field value.",G);function Q(t,e){if(!S(e))throw new TypeError("repeatCharts options must be a plain object.");const n=P(e.id??"repeat","Repeat id"),i=S(e.channel);if(i){const p=Object.keys(e.channel);if(p.length!==1||p[0]!=="parallelDimension"||typeof e.channel.parallelDimension!="string"||e.channel.parallelDimension.length===0)throw new Error("repeatCharts Parallel channel must contain exactly one non-empty parallelDimension.")}else if(!["x","y","theta","r"].includes(e.channel))throw new Error('repeatCharts channel must be "x", "y", "theta", "r", or one parallelDimension.');if(!Array.isArray(e.fields)||e.fields.length===0||e.fields.some(p=>typeof p!="string"||p.length===0))throw new TypeError("repeatCharts fields must be a non-empty array of field names.");if(new Set(e.fields).size!==e.fields.length)throw new Error("repeatCharts fields must be unique.");const c=k(t.semanticSpec).family,o=e.channel==="r"?"radius":e.channel,d=t.semanticSpec.layers.filter(p=>{if(i){const F=(p.encoding?.parallel?.dimensions??[]).filter(y=>y.field===e.channel.parallelDimension);return c==="parallel"&&p.mark?.type==="line"&&F.length===1}if(["x","y"].includes(e.channel))return c==="cartesian"&&p.encoding?.x?.scale!==void 0&&p.encoding?.y?.scale!==void 0&&p.encoding?.[e.channel]?.field!==void 0&&["point","line","area","bar","rule","tick","rect"].includes(p.mark?.type);const g=t.markConfigs[p.id]?.compositionRole;return c!=="polar"||["pie","radar"].includes(g)?!1:["point","line","arc"].includes(p.mark?.type)&&p.encoding?.[o]?.field!==void 0});let s;if(e.target!==void 0){if(s=P(e.target,"Repeat target"),!d.some(p=>p.id===s))throw new Error(`repeatCharts target "${s}" is not eligible for the requested field role.`)}else if(d.length===1)s=d[0].id;else throw new Error(d.length===0?"repeatCharts requires one eligible complete mark for the requested field role.":"repeatCharts target is ambiguous; provide target.");if(t.semanticSpec.layers.filter(p=>{if(p.id===s)return!1;const g=p.mark?.type==="text"&&p.source===s,F=t.markConfigs[p.id]?.statisticalReference?.source===s;return!g&&!F}).length>0)throw new Error("repeatCharts currently supports one direct mark only.");const a=t.markConfigs[s]??{},l=["boxPlot","gradientPlot","violinPlot","regressionPlot","endpointPlot","ecdfPlot","raincloudPlot","intervalPlot"].find(p=>a[p]!==void 0);if(l!==void 0)throw new Error(`repeatCharts does not replace the ${l} composite role.`);const f=U(t,s),u=Fe(t,f.data);if(u?.transform?.length>0&&u.transform[0].type!=="lookup")throw new Error("repeatCharts does not rewrite a derived dataset dependency.");const m=i?f.encoding.parallel:f.encoding[o],h=i?m.dimensions.findIndex(p=>p.field===e.channel.parallelDimension):void 0;return{id:n,target:s,channel:i?{...e.channel}:e.channel,policyKey:i?"parallelDimensions":e.channel,fields:[...e.fields],data:f.data,encoding:m,...h===void 0?{}:{dimensionIndex:h},cells:e.fields.map((p,g)=>({id:`${n}-field-${g+1}`,field:p,value:p}))}}function qe(t,e){const n=t.encoding;return{target:t.target,field:e,fieldType:n.fieldType,...n.temporalUnit===void 0?{}:{temporalUnit:n.temporalUnit},...n.aggregate===void 0?{}:{aggregate:n.aggregate},...n.bin===void 0?{}:{bin:n.bin},...n.stack===void 0?{}:{stack:n.stack},...n.weight===void 0?{}:{weight:n.weight},scale:{id:n.scale}}}function De(t,e,n){return e.encoding.dimensions.map((i,c)=>{const o=be(t,i.scale);if(o===void 0)throw new Error(`repeatCharts Parallel dimension scale "${i.scale}" is missing.`);const{id:d,...s}=o,r=c===e.dimensionIndex;return{field:r?n:i.field,fieldType:i.fieldType,title:r&&i.title===i.field?n:i.title,scale:s}})}function Le(t,e,n){if(S(e.channel))return t.encodeParallelCoordinates({target:e.target,coordinate:U(t,e.target).coordinate,dimensions:De(t,e,n),...e.encoding.key===void 0?{}:{key:e.encoding.key},missing:e.encoding.missing});const i={x:"encodeX",y:"encodeY",theta:"encodeTheta",r:"encodeR"}[e.channel];return t[i](qe(e,n))}function Z(t,e,n,i){const c=t.semanticSpec.title.text===void 0?t:t.removeTitle(),o=Object.fromEntries(e.cells.map(d=>[d.id,Le(c,e,d.field)]));return ge(c,e.cells.map(d=>d.id),o,n,i)}const Me=T({op:"repeatCharts",description:"Repeat one direct chart across an ordered field-role list."},Te,function(t={}){const e=b(t.guides),n=Q(this,t);x(e.axes,k(this.semanticSpec).family,!0);const i={...t.scales??{},[n.policyKey]:t.scales?.[n.policyKey]??"independent"},c=j(this.semanticSpec,i),o=Z(this,n,i,!0);return X(this,t,{definition:n,derived:o,guides:e,scalePolicies:c,facet:{values:n.fields,repeat:{target:n.target,channel:n.channel,fields:n.fields}}})}),Re=J("facetGrid","Repeat one direct-source Cartesian chart across a row and column field grid.",I),Ae=z({op:"editFacetHeaders",description:"Edit parent-owned facet header appearance.",scope:"composition"},function(t={}){v(this,"editFacetHeaders");const e=this.compositionSpec.id,n=this.materializationConfigs.facets?.[e];if(!S(n?.headers))throw new Error(`Facet "${e}" requires header configuration.`);const i=L(n.headers,t,this.compositionSpec.facet.grid);return this._withMaterializationConfig(["facets",e],{...n,headers:i}).materializeComposition()}),Pe=z({op:"editFacetScales",description:"Edit facet scale-resolution policies and rederive every cell.",scope:"composition"},function(t={}){v(this,"editFacetScales"),w(t,_,"editFacetScales",{allowEmpty:!1,emptyMessage:"editFacetScales requires at least one channel policy change."});for(const i of Object.keys(t))if(!N(this.semanticSpec).some(c=>c.policyKey===i))throw new Error(`Facet scale channel "${i}" is not used by an affected layer.`);const e=this.compositionSpec.facet,n={...e.scales,...t};if(_.every(i=>n[i]===e.scales[i]))throw new Error("editFacetScales requires at least one channel policy change.");return D(this,{scales:n,guides:e.guides})}),Ge=z({op:"editFacetGuides",description:"Edit facet guide ownership and rederive every cell.",scope:"composition"},function(t={}){v(this,"editFacetGuides"),w(t,V,"editFacetGuides",{allowEmpty:!1,emptyMessage:"editFacetGuides requires at least one guide policy."});const e=this.compositionSpec.facet;Object.hasOwn(t,"legend")&&b({legend:t.legend});const n=b({...e.guides,...t,...Object.hasOwn(t,"axes")?{axes:R(t.axes,e.guides.axes)}:{}},!0),i=k(this.semanticSpec).family;return x(n.axes,i,e.repeat!==void 0),D(this,{scales:e.scales,guides:n})});function Ie(t,e,n=!1){if(!(t instanceof e.constructor))throw new TypeError("editFacetSource program must be a ChartProgram.");if(t.compositionSpec!==void 0)throw new Error("editFacetSource program must be a complete unit ChartProgram.");if(t.actionStack.length!==0)throw new Error("editFacetSource program has an unfinished action stack.");const i=e.compositionSpec.children.find(a=>e.children[a]?.semanticSpec.layers.length>0)??e.compositionSpec.children[0],c=e.children[i]?.materializationConfigs??{},{canvas:o,theme:d,facets:s,...r}=c;return new e.constructor({semanticSpec:t.semanticSpec,graphicSpec:t.graphicSpec,resolvedScales:t.resolvedScales,materializationConfigs:A({...n?{...r,...t.materializationConfigs}:{...t.materializationConfigs,...r},...t.materializationConfigs.canvas===void 0?{}:{canvas:t.materializationConfigs.canvas},...t.materializationConfigs.theme===void 0?{}:{theme:t.materializationConfigs.theme}}),children:{},context:t.context,trace:e.trace,actionStack:e.actionStack,actionSequence:e._actionSequence})}const Ne=T({op:"editFacetSource",description:"Reapply one facet, grid, or repeat recipe to a revised complete unit program.",scope:"composition"},ke,function(t={}){v(this,"editFacetSource");const e=this.compositionSpec,n=this.materializationConfigs.facets?.[e.id];if(Object.hasOwn(t,"program")===Object.hasOwn(t,"action"))throw new Error("editFacetSource requires exactly one of program or action.");let i=t.program,c=this;if(t.action!==void 0){w(t.action,["method","options"],"editFacetSource action");const l=$(t.action.method,"editFacetSource action method");let f=E(this,!0);const u=typeof f[l]=="function"?ce(f[l]):void 0;if(!u||!$e.has(l)||u.scope==="composition"||/^(?:_|materialize|rematerialize|replay|editSemantic$|editGraphics$|createGraphics$)/.test(l))throw new Error("editFacetSource action requires a unit chart-authoring action.");f=de(f,fe({marks:f.semanticSpec.layers.map(h=>le(f,h))}));for(const h of ne(f)){const p=f.guideConfigs.axis?.[h.id]??{},g=ie(h.channel,h.id);for(const[F,y]of["line","ticks","labels","title"].entries()){if(!p[y]||f.graphicSpec.objects[g[F]])continue;const{mode:M,inferredValues:He,inferredText:Ue,inferredRotation:We,inferredOffset:Ke,...O}=p[y];M==="values"&&delete O.count,M==="count"&&delete O.values;const ee=y[0].toUpperCase()+y.slice(1);f=f[`create${h.channel.toUpperCase()}Axis${ee}`]({...O,...ae(h.id,h.channel)})}}const m=f[l](t.action.options??{});c=new this.constructor({...this,trace:m.trace,actionStack:m.actionStack,actionSequence:m._actionSequence}),i=new this.constructor({...m,actionStack:[],actionSequence:m._actionSequence})}let o=Ie(i,c,t.action!==void 0);n!==void 0&&(o=o._withMaterializationConfig(["facets",e.id],n));const d=S(e.facet.guides.legend),s=d?{...e.facet.guides,legend:!1}:e.facet.guides;let r;const a=C(o,C(this,e.facet.scales));if(e.facet.grid!==void 0?r=o.facetGrid({id:e.id,data:e.facet.data,rows:e.facet.grid.rows,columns:e.facet.grid.columns,combinations:e.facet.grid.combinations,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:a,guides:s}):e.facet.repeat!==void 0?r=o.repeatCharts({id:e.id,...e.facet.repeat,columns:e.columns,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:a,guides:s}):r=o.facet({id:e.id,data:e.facet.data,field:e.facet.field,values:e.facet.values,columns:e.columns,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:a,guides:s}),d){const l=r.compositionSpec;r=r._withCompositionState({children:r.children,compositionSpec:{...l,facet:{...l.facet,guides:e.facet.guides}}})}return n!==void 0&&(r=r._withMaterializationConfig(["facets",e.id],n).materializeComposition()),r.semanticSpec.title.text!==void 0&&(r=r.removeTitle()),this.semanticSpec.title.text!==void 0&&(r=r.createTitle({...this.titleConfig,...this.semanticSpec.title})),ye(r,this.materializationConfigs.theme)});function Et(t){se((e,n)=>{const{program:i,plan:c}=re(E(e),n),o=e.compositionSpec,d=new e.constructor({...i,graphicSpec:e.graphicSpec,children:e.children,materializationConfigs:{...i.materializationConfigs,facets:e.materializationConfigs.facets,...e.titleConfig===void 0?{}:{title:e.titleConfig}},actionSequence:i._actionSequence,compositionSpec:{...o,facet:{...o.facet,data:c.replacements.get(o.facet.data)??o.facet.data}}});return D(d,o.facet)}),t.prototype.replayDerivedData=Se,t.prototype.composeFacetGuides=we,t.prototype.facet=je,t.prototype.facetGrid=Re,t.prototype.repeatCharts=Me,t.prototype.editFacetHeaders=Ae,t.prototype.editFacetScales=Pe,t.prototype.editFacetGuides=Ge,t.prototype.editFacetSource=Ne}export{Ge as editFacetGuides,Ae as editFacetHeaders,Pe as editFacetScales,Ne as editFacetSource,je as facet,Re as facetGrid,Et as registerFacetActions,Me as repeatCharts};