ggaction 0.0.17 → 0.0.19

package/src/actions/guides/legends/continuous/common.js

@@ -1,447 +1 @@
-import { isPlainObject } from "../../../../core/immutable.js";
-import { resolveTextBounds } from "../../../../core/textMetrics.js";
-import {
-  validateKeys,
-  validateOptionObject,
-  validateNonEmptyString,
-  validateNonNegativeFinite,
-  validatePositiveFinite,
-  validateGeneratedItemLimit
-} from "../../../../core/validation.js";
-import { formatTimeTick } from "../../../../grammar/ticks.js";
-import {
-  formatValue,
-  validateValueFormat
-} from "../../../../grammar/valueFormat.js";
-import {
-  formatDistinctNumericSamples,
-  sampleNumericRange
-} from "../../../../grammar/numeric.js";
-import { resolveGraphicBounds } from "../../../../layout/canvas.js";
-import { isHorizontalEdgeLegend } from "../../../../layout/legendLane.js";
-import { DEFAULT_COLORS, DEFAULT_FONT_FAMILY } from
-  "../../../../theme/defaults.js";
-import { findLayer } from "../../../../selectors/layers.js";
-import { isOpacityLegendLayer } from "../../../../materialization/legends.js";
-import { findCanvasGraphic } from
-  "../../../../materialization/graphicHierarchy.js";
-import { normalizeLegendSampling } from "../sampling.js";
-import { editGraphicProperties } from "../../../primitives/graphicProperties.js";
-
-const OPTIONS = [
-  "target", "channels", "position", "align", "offset", "title", "count",
-  "values",
-  "gradient", "symbol", "labels", "titleStyle", "itemGap", "border",
-  "direction", "columns", "titlePosition"
-];
-const TEXT_OPTIONS = [
-  "offset", "color", "fontSize", "fontFamily", "fontWeight", "format"
-];
-const BORDER_OPTIONS = [
-  "color", "lineWidth", "padding", "background"
-];
-const POSITIONS = ["right", "left", "top", "bottom"];
-const DEFAULT_LABELS = {
-  offset: 12,
-  color: DEFAULT_COLORS.text,
-  fontSize: 12,
-  fontFamily: DEFAULT_FONT_FAMILY,
-  fontWeight: "normal"
-};
-const DEFAULT_TITLE = {
-  color: DEFAULT_COLORS.text,
-  fontSize: 13,
-  fontFamily: DEFAULT_FONT_FAMILY,
-  fontWeight: 600
-};
-const DEFAULT_BORDER = {
-  color: DEFAULT_COLORS.border,
-  lineWidth: 1,
-  padding: 12,
-  background: "transparent"
-};
-
-export const validatePositive = validatePositiveFinite;
-export const validateNonNegative = validateNonNegativeFinite;
-
-export { editGraphicProperties };
-
-export function normalizeLegendTextOptions(value, label, defaults) {
-  if (value === undefined) return { ...defaults };
-  if (!isPlainObject(value)) {
-    throw new TypeError(`${label} must be a plain object.`);
-  }
-  validateKeys(value, TEXT_OPTIONS, label);
-  const result = { ...defaults, ...value };
-  if (Object.hasOwn(result, "offset")) {
-    validateNonNegative(result.offset, `${label} offset`);
-  }
-  validatePositive(result.fontSize, `${label} fontSize`);
-  for (const key of ["color", "fontFamily"]) {
-    validateNonEmptyString(result[key], `${label} ${key}`);
-  }
-  if (
-    typeof result.fontWeight !== "string" &&
-    !Number.isFinite(result.fontWeight)
-  ) {
-    throw new TypeError(`${label} fontWeight must be a string or finite number.`);
-  }
-  if (Object.hasOwn(result, "format")) {
-    result.format = validateValueFormat(result.format, `${label} format`);
-  }
-  return result;
-}
-
-export function normalizeLegendTitleOptions(value, label, defaults) {
-  if (value !== undefined) {
-    validateOptionObject(value, ["color", "fontSize", "fontFamily", "fontWeight"], label);
-  }
-  return normalizeLegendTextOptions(value, label, defaults);
-}
-
-export function normalizeLegendBorder(value) {
-  if (value === undefined || value === false) return false;
-  if (value !== true && !isPlainObject(value)) {
-    throw new TypeError("createLegend.border must be a boolean or plain object.");
-  }
-  if (value !== true) validateKeys(value, BORDER_OPTIONS, "createLegend.border");
-  const border = { ...DEFAULT_BORDER, ...(value === true ? {} : value) };
-  for (const key of ["color", "background"]) {
-    validateNonEmptyString(border[key], `Legend border ${key}`);
-  }
-  validateNonNegative(border.lineWidth, "Legend border lineWidth");
-  validateNonNegative(border.padding, "Legend border padding");
-  return border;
-}
-
-export function normalizeContinuousLegend(args, kind) {
-  validateOptionObject(args, OPTIONS, "createLegend");
-  const position = args.position ?? "right";
-  if (!POSITIONS.includes(position)) {
-    throw new Error(`Unsupported legend position "${position}".`);
-  }
-  const align = args.align ?? "center";
-  if (!["left", "center", "right"].includes(align)) {
-    throw new Error(`Unsupported legend alignment "${align}".`);
-  }
-  if (["left", "right"].includes(position) && align !== "center") {
-    throw new Error("Side continuous legends require center alignment.");
-  }
-  if (kind === "gradient" && Object.hasOwn(args, "values")) {
-    throw new Error("Gradient legends do not support exact sample values.");
-  }
-  const sampling = kind === "opacity"
-    ? normalizeLegendSampling(args, {
-        operation: "create",
-        label: "Opacity legend"
-      })
-    : undefined;
-  const count = kind === "gradient" ? args.count ?? 5 : undefined;
-  if (kind === "gradient") {
-    if (!Number.isInteger(count) || count < 2) {
-      throw new RangeError(
-        "Continuous legend count must be an integer of at least 2."
-      );
-    }
-    validateGeneratedItemLimit(count, "Continuous legend count");
-  }
-  const offset = args.offset ?? 30;
-  validateNonNegative(offset, "Legend offset");
-  const titlePosition = args.titlePosition ?? "top";
-  if (!["top", "left"].includes(titlePosition)) {
-    throw new Error(`Unsupported legend titlePosition "${titlePosition}".`);
-  }
-  if (
-    titlePosition === "left" &&
-    (!["top", "bottom"].includes(position) || kind !== "opacity")
-  ) {
-    throw new Error(
-      "Only horizontal opacity legends support left titlePosition."
-    );
-  }
-  const itemGap = args.itemGap ?? (titlePosition === "left" ? 20 : 28);
-  validatePositive(itemGap, "Legend itemGap");
-  if (args.title !== undefined) validateNonEmptyString(args.title, "Legend title");
-  if (kind === "gradient") {
-    for (const key of ["symbol", "columns", "direction", "itemGap"]) {
-      if (Object.hasOwn(args, key)) {
-        throw new Error(`Gradient legend does not accept ${key}.`);
-      }
-    }
-  } else {
-    for (const key of ["columns", "direction", "gradient"]) {
-      if (Object.hasOwn(args, key)) {
-        throw new Error(`Opacity legend does not accept ${key}.`);
-      }
-    }
-  }
-  return {
-    target: args.target,
-    position,
-    align,
-    offset,
-    ...(kind === "gradient" ? { count } : { sampling }),
-    title: args.title,
-    inferredTitle: args.title === undefined,
-    labels: normalizeLegendTextOptions(
-      args.labels,
-      "createLegend.labels",
-      titlePosition === "left"
-        ? { ...DEFAULT_LABELS, offset: 8 }
-        : DEFAULT_LABELS
-    ),
-    titleStyle: normalizeLegendTitleOptions(
-      args.titleStyle,
-      "createLegend.titleStyle",
-      DEFAULT_TITLE
-    ),
-    itemGap,
-    titlePosition,
-    border: normalizeLegendBorder(args.border)
-  };
-}
-
-export function selectLegendLayer(program, requested, predicate) {
-  const candidates = program.semanticSpec.layers.filter(predicate);
-  if (requested === undefined) return candidates.length === 1
-    ? candidates[0]
-    : undefined;
-  const candidate = findLayer(program, requested);
-  return candidates.includes(candidate) ? candidate : undefined;
-}
-
-export function resolveContinuousLegendLayer(program, requested, channel) {
-  const layer = selectLegendLayer(
-    program,
-    requested,
-    channel === "opacity" ? isOpacityLegendLayer : candidate =>
-      candidate.mark?.type === "point" && candidate.encoding?.[channel]?.scale !== undefined
-  );
-  if (layer === undefined) {
-    throw new Error(
-      requested === undefined
-        ? `${channel} legend requires one eligible ${channel === "opacity" ? "point or line" : "point"} mark.`
-        : `Unknown ${channel} legend target "${requested}".`
-    );
-  }
-  return layer;
-}
-
-export function resolveContinuousColorLayer(program, requested, channel = "color") {
-  const layer = selectLegendLayer(
-    program,
-    requested,
-    candidate => (channel === "stroke"
-      ? ["point", "line", "area", "bar", "rect", "arc", "rule", "tick"]
-      : ["point", "bar", "rect"]
-    ).includes(candidate.mark?.type) &&
-      candidate.encoding?.[channel]?.scale !== undefined
-  );
-  if (layer === undefined) {
-    throw new Error(
-      requested === undefined
-        ? channel === "color"
-          ? "color legend requires one eligible point, bar, or rect mark."
-          : "stroke legend requires one eligible mark."
-        : `Unknown ${channel} legend target "${requested}".`
-    );
-  }
-  return layer;
-}
-
-export function requireResolvedLegendScale(program, id, type) {
-  const scale = program.resolvedScales[id];
-  if (scale?.type !== type) {
-    throw new Error(`Legend requires resolved ${type} scale "${id}".`);
-  }
-  return scale;
-}
-
-export function resolveContinuousBounds(
-  program,
-  message = "Continuous legend layout requires Canvas bounds."
-) {
-  const plot = resolveGraphicBounds(program);
-  const canvas = findCanvasGraphic(program);
-  if (
-    plot === undefined ||
-    ![plot.x, plot.y, plot.width, plot.height].every(Number.isFinite) ||
-    canvas?.type !== "canvas" ||
-    !Number.isFinite(canvas.properties.width) ||
-    !Number.isFinite(canvas.properties.height)
-  ) {
-    throw new Error(message);
-  }
-  return { plot, canvas: canvas.properties };
-}
-
-export function sampleContinuousValues(domain, count) {
-  return sampleNumericRange(
-    domain[0],
-    domain[1],
-    count,
-    "Continuous legend domain"
-  );
-}
-
-export function formatContinuousValues(values, domain, fieldType, format = "auto") {
-  const resolved = validateValueFormat(format, "Legend label format");
-  if (resolved === "auto") {
-    return fieldType === "temporal"
-      ? values.map(value => formatTimeTick(value, domain))
-      : formatDistinctNumericSamples(values);
-  }
-  return values.map(value => formatValue(value, {
-    format: resolved,
-    valueType: fieldType === "temporal" ? "temporal" : "quantitative",
-    label: "Legend label format"
-  }));
-}
-
-export function styleContinuousText(
-  program,
-  id,
-  style,
-  { align = "left" } = {}
-) {
-  return editGraphicProperties(program, id, {
-    fill: style.color,
-    fontSize: style.fontSize,
-    fontFamily: style.fontFamily,
-    fontWeight: style.fontWeight,
-    textAlign: align,
-    textBaseline: "middle"
-  });
-}
-
-export function resolveLegendTextBounds(position, text, style, profile) {
-  return resolveTextBounds({
-    x: position.x,
-    y: position.y,
-    text: String(text),
-    ...style,
-    textAlign: position.align ?? "left",
-    textBaseline: "middle"
-  }, profile);
-}
-
-export function assertLegendBoundsInsideCanvas(bounds, canvas, label, config) {
-  // Horizontal content is intrinsic until the shared lane places its actual
-  // concrete bounds. Only that final placement can determine Canvas fit.
-  if (isHorizontalEdgeLegend(config)) return;
-  if (bounds.some(item =>
-    item.left < 0 || item.right > canvas.width ||
-    item.top < 0 || item.bottom > canvas.height
-  )) {
-    throw new Error(`${label} requires more Canvas margin space.`);
-  }
-}
-
-export function resolveLegendBackgroundFromBounds(
-  bounds,
-  border,
-  canvas,
-  label,
-  config
-) {
-  if (border === false) return undefined;
-  const strokeExtent = border.lineWidth / 2;
-  let x = Infinity;
-  let y = Infinity;
-  let right = -Infinity;
-  let bottom = -Infinity;
-  for (const item of bounds) {
-    x = Math.min(x, item.left);
-    y = Math.min(y, item.top);
-    right = Math.max(right, item.right);
-    bottom = Math.max(bottom, item.bottom);
-  }
-  x -= border.padding;
-  y -= border.padding;
-  right += border.padding;
-  bottom += border.padding;
-  if (!isHorizontalEdgeLegend(config) && (
-    x - strokeExtent < 0 || y - strokeExtent < 0 ||
-    right + strokeExtent > canvas.width ||
-    bottom + strokeExtent > canvas.height
-  )) {
-    throw new Error(`${label} background requires more Canvas margin space.`);
-  }
-  return { x, y, width: right - x, height: bottom - y };
-}
-
-export function editLegendBackground(program, id, bounds, border) {
-  if (bounds === undefined) return program;
-  return editGraphicProperties(program, id, {
-    ...bounds,
-    fill: border.background,
-    stroke: border.color,
-    strokeWidth: border.lineWidth
-  });
-}
-
-export function normalizeItemLegendLayout(args) {
-  const position = args.position ?? "right";
-  if (!["right", "left", "top", "bottom"].includes(position)) throw new Error(`Unsupported legend position "${position}".`);
-  const side = ["left", "right"].includes(position);
-  const layout = args.layout === undefined ? "edge" : args.layout;
-  if (layout !== "edge") throw new Error('This legend requires layout "edge".');
-  const align = args.align ?? "center";
-  if (!["left", "center", "right"].includes(align)) throw new Error(`Unsupported legend alignment "${align}".`);
-  const direction = args.direction ?? (side ? "vertical" : "horizontal");
-  if (!["horizontal", "vertical"].includes(direction)) throw new Error(`Unsupported legend direction "${direction}".`);
-  const columns = args.columns;
-  if (columns !== undefined && (!Number.isInteger(columns) || columns < 1)) throw new RangeError("Legend columns must be a positive integer.");
-  const titlePosition = args.titlePosition ?? "top";
-  if (!["top", "left"].includes(titlePosition)) throw new Error(`Unsupported legend titlePosition "${titlePosition}".`);
-  if (side && (direction !== "vertical" || align !== "center" || (columns !== undefined && columns !== 1) || titlePosition !== "top")) {
-    throw new Error("Side item legends require vertical direction, center alignment, top title and one column.");
-  }
-  const offset = args.offset ?? 30;
-  const itemGap = args.itemGap ?? 28;
-  validateNonNegative(offset, "Legend offset");
-  validatePositive(itemGap, "Legend itemGap");
-  return { position, layout, align, direction, columns, titlePosition, offset, itemGap };
-}
-
-export function materializeItemLegend(program, kind, config, layout, {
-  symbols, optional = {}, text = layout.labels,
-  labels = layout.config.labels, titleStyle = layout.config.titleStyle
-}) {
-  const prefix = `${kind}Legend`;
-  let next = program
-    .editSemantic({ property: `guide.legend.${kind}.scale`, value: config.scale })
-    .editSemantic({ property: `guide.legend.${kind}.title`, value: config.title })
-    ._withLegendConfig(kind, config);
-  next = editGraphicProperties(next, `${prefix}Symbols`, {
-    length: text.length,
-    ...symbols
-  });
-  next = editGraphicProperties(next, `${prefix}Labels`, {
-    length: text.length, x: layout.labelX, y: layout.itemY, text
-  });
-  next = editLegendBackground(next, `${prefix}Background`, layout.background, config.border);
-  next = editGraphicProperties(next, `${prefix}Symbols`, Object.fromEntries(
-    Object.entries(optional).filter(([, value]) => value !== undefined)
-  ));
-  next = styleContinuousText(next, `${prefix}Labels`, labels);
-  const effective = layout.config;
-  if (effective.titleVisible === false) return next;
-  next = editGraphicProperties(next, `${prefix}Title`, {
-    x: layout.title.x, y: layout.title.y, text: effective.title
-  });
-  return styleContinuousText(next, `${prefix}Title`, titleStyle, { align: layout.title.align });
-}
-
-export function createItemLegendGraphics(program, kind, config, count, type, placement) {
-  const prefix = `${kind}Legend`;
-  let next = program
-    .editSemantic({ property: `guide.legend.${kind}.scale`, value: config.scale })
-    .editSemantic({ property: `guide.legend.${kind}.title`, value: config.title })
-    ._withLegendConfig(kind, config);
-  if (config.border !== false) next = next.createGraphics({ id: `${prefix}Background`, type: "rect", ...placement });
-  next = next.createGraphics({ id: `${prefix}Symbols`, type, length: count, ...placement })
-    .createGraphics({ id: `${prefix}Labels`, type: "text", length: count, ...placement });
-  if (config.titleVisible !== false) next = next.createGraphics({ id: `${prefix}Title`, type: "text", ...placement });
-  return next;
-}
+import{normalizeLegendClipHeight as O}from"../../../../grammar/legendClip.js";import{applyLegendClipGraphics as $}from"../../../../materialization/legendClip.js";import{normalizeGradientDirection as H}from"../../../../grammar/legendGradient.js";import{normalizeLegendBorderDash as R}from"../../../../grammar/legendBorder.js";import{materializeLegendBorder as M}from"../../../../materialization/legendBorder.js";import{LEGEND_TITLE_STYLE_KEYS as q,mergeLegendTitleStyle as V,validateLegendTitleAlignment as v}from"../../../../grammar/legendTitleStyle.js";import{PLOT_LEGEND_POSITIONS as Y,isPlotLegend as m}from"../../../../layout/legend.js";import{isContinuousColorScaleType as K}from"../../../../grammar/scales/types.js";import{isPlainObject as I}from"../../../../core/immutable.js";import{resolveTextBounds as X}from"../../../../core/textMetrics.js";import{resolveLegendTitleText as J}from"../../../../layout/legendText.js";import{materializeLegendTitleLines as Q}from"../../../../materialization/legendText.js";import{validateKeys as G,validateFontWeight as Z,validateOptionObject as z,validateNonEmptyString as y,validateNonNegativeFinite as ee,validatePositiveFinite as te,validateGeneratedItemLimit as ne}from"../../../../core/validation.js";import{formatTimeTick as ie}from"../../../../grammar/ticks.js";import{formatValue as oe,validateValueFormat as C}from"../../../../grammar/valueFormat.js";import{formatDistinctNumericSamples as re,sampleNumericRange as le}from"../../../../grammar/numeric.js";import{resolveGraphicBounds as de,canvasOverflowError as _}from"../../../../layout/canvas.js";import{isHorizontalEdgeLegend as N}from"../../../../layout/legendLane.js";import{DEFAULT_COLORS as h,DEFAULT_FONT_FAMILY as F,DEFAULT_VERTICAL_LEGEND_ITEM_GAP as w}from"../../../../theme/defaults.js";import{findLayer as se}from"../../../../selectors/layers.js";import{isOpacityLegendLayer as ae}from"../../../../materialization/legends.js";import{findCanvasGraphic as ce}from"../../../../materialization/graphicHierarchy.js";import{normalizeLegendSampling as fe}from"../sampling.js";import{editGraphicProperties as p}from"../../../primitives/graphicProperties.js";const pe=["clipHeight","target","channels","position","align","offset","title","count","values","gradient","symbol","labels","titleStyle","itemGap","border","direction","columns","titlePosition"],Re=Object.freeze(["clipHeight","target","count","values","position","layout","align","direction","columns","titlePosition","offset","itemGap","title","labels","titleStyle","border","overflow"]),ue=["offset","color","fontSize","fontFamily","fontWeight","format"],me=["color","lineWidth","padding","background","strokeDash"],P=["right","left","top","bottom",...Y],E={offset:12,color:h.text,fontSize:12,fontFamily:F,fontWeight:"normal"},D={color:h.text,fontSize:13,fontFamily:F,fontWeight:600},ge=Object.freeze(E),he=Object.freeze({...D,color:h.strongText});function B(e,t){return e!==void 0&&e!==!1&&y(e,"Legend title"),{title:e===!1||e===void 0?t:e,inferredTitle:e===!1||e===void 0,titleVisible:e!==!1}}function Me(e,t,n){const i=["right","left"].includes(e.position??"right")||m(e),r=(e.direction??(i?"vertical":"horizontal"))==="vertical"?w:n;return{...e.clipHeight===void 0?{}:{clipHeight:O(e.clipHeight)},...ye({...e,itemGap:e.itemGap??r}),...B(e.title,t.field),labels:T(e.labels,"createLegend.labels",ge),titleStyle:A(e.titleStyle,"createLegend.titleStyle",he),border:j(e.border)}}const Le={color:h.border,lineWidth:1,padding:12,background:"transparent"},x=te,g=ee;function T(e,t,n){if(e===void 0)return{...n};if(!I(e))throw new TypeError(`${t} must be a plain object.`);G(e,ue,t);const i={...n,...e};Object.hasOwn(i,"offset")&&g(i.offset,`${t} offset`),x(i.fontSize,`${t} fontSize`);for(const o of["color","fontFamily"])y(i[o],`${t} ${o}`);return Z(i.fontWeight,`${t} fontWeight`,"finite number"),Object.hasOwn(i,"format")&&(i.format=C(i.format,`${t} format`)),i}function A(e,t,n,i=!1){e!==void 0&&z(e,q,t);const o=V(n,e,{edit:i}),{align:r,...d}=o;return{...T(d,t,{}),...r===void 0?{}:{align:r}}}function j(e){if(e===void 0||e===!1)return!1;if(e!==!0&&!I(e))throw new TypeError("createLegend.border must be a boolean or plain object.");e!==!0&&G(e,me,"createLegend.border");const t={...Le,...e===!0?{}:e};for(const i of["color","background"])y(t[i],`Legend border ${i}`);g(t.lineWidth,"Legend border lineWidth"),g(t.padding,"Legend border padding");const n=R(t.strokeDash);return{...t,...n===void 0?{}:{strokeDash:n}}}function qe(e,t){z(e,pe,"createLegend");const n=e.position??"right";if(!P.includes(n))throw new Error(`Unsupported legend position "${n}".`);const i=e.align??"center";if(!["left","center","right"].includes(i))throw new Error(`Unsupported legend alignment "${i}".`);if(["left","right"].includes(n)&&i!=="center")throw new Error("Side continuous legends require center alignment.");if(t==="gradient"&&Object.hasOwn(e,"values"))throw new Error("Gradient legends do not support exact sample values.");const o=t==="opacity"?fe(e,{operation:"create",label:"Opacity legend"}):void 0,r=t==="gradient"?e.count??5:void 0;if(t==="gradient"){if(!Number.isInteger(r)||r<2)throw new RangeError("Continuous legend count must be an integer of at least 2.");ne(r,"Continuous legend count")}const d=e.offset??(m({position:n})?8:30);g(d,"Legend offset");const l=e.titlePosition??"top";if(v(e.titleStyle,l),!(t==="gradient"?["top","left","bottom"]:["top","left"]).includes(l))throw new Error(`Unsupported legend titlePosition "${l}".`);if(l==="left"&&(!["top","bottom"].includes(n)||t!=="opacity"))throw new Error("Only horizontal opacity legends support left titlePosition.");const a=e.itemGap??(t==="opacity"&&(["right","left"].includes(n)||m({position:n}))?w:l==="left"?20:28);if(x(a,"Legend itemGap"),t==="gradient"){for(const s of["symbol","columns","itemGap"])if(Object.hasOwn(e,s))throw new Error(`Gradient legend does not accept ${s}.`)}else for(const s of["columns","direction","gradient"])if(Object.hasOwn(e,s))throw new Error(`Opacity legend does not accept ${s}.`);return{...e.clipHeight===void 0?{}:{clipHeight:O(e.clipHeight)},target:e.target,position:n,align:i,offset:d,...t==="gradient"?{count:r,...e.direction===void 0?{}:{gradientDirection:H(e.direction)}}:{sampling:o},...B(e.title),labels:T(e.labels,"createLegend.labels",l==="left"?{...E,offset:8}:E),titleStyle:A(e.titleStyle,"createLegend.titleStyle",D),itemGap:a,titlePosition:l,border:j(e.border)}}function U(e,t,n){const i=e.semanticSpec.layers.filter(n);if(t===void 0)return i.length===1?i[0]:void 0;const o=se(e,t);return i.includes(o)?o:void 0}function Ve(e,t,n){const i=U(e,t,n==="opacity"?ae:o=>o.mark?.type==="point"&&o.encoding?.[n]?.scale!==void 0);if(i===void 0)throw new Error(t===void 0?`${n} legend requires one eligible ${n==="opacity"?"point, line or bar":"point"} mark.`:`Unknown ${n} legend target "${t}".`);return i}function Ye(e,t,n="color"){const i=U(e,t,o=>(n==="stroke"?["point","line","area","bar","rect","arc","rule","tick"]:["point","bar","rect","text"]).includes(o.mark?.type)&&o.encoding?.[n]?.scale!==void 0);if(i===void 0)throw new Error(t===void 0?n==="color"?"color legend requires one eligible point, bar, or rect mark.":"stroke legend requires one eligible mark.":`Unknown ${n} legend target "${t}".`);return i}function Ke(e,t,n){const i=e.resolvedScales[t];if(n==="sequential"?!K(i?.type):i?.type!==n)throw new Error(`Legend requires resolved ${n} scale "${t}".`);return i}function Xe(e,t="Continuous legend layout requires Canvas bounds."){const n=de(e),i=ce(e);if(n===void 0||![n.x,n.y,n.width,n.height].every(Number.isFinite)||i?.type!=="canvas"||!Number.isFinite(i.properties.width)||!Number.isFinite(i.properties.height))throw new Error(t);return{plot:n,canvas:i.properties}}function Je(e,t){return le(e[0],e[1],t,"Continuous legend domain")}function Qe(e,t,n,i="auto"){const o=C(i,"Legend label format");return o==="auto"?n==="temporal"?e.map(r=>ie(r,t)):re(e):e.map(r=>oe(r,{format:o,valueType:n==="temporal"?"temporal":"quantitative",label:"Legend label format"}))}function k(e,t,n,{align:i="left"}={}){const o=p(e,t,{fill:n.color,fontSize:n.fontSize,fontFamily:n.fontFamily,fontWeight:n.fontWeight,textAlign:i,textBaseline:"middle"});return t.endsWith("Title")?Q(o,t,o.graphicSpec.objects[t].properties.text,n):o}function Ze(e,t,n,i,{hardBreaks:o=!1}={}){return X({x:e.x,y:e.y,text:String(t),...n,...o?{lines:J(t,n,i).lines}:{},textAlign:e.align??"left",textBaseline:"middle"},i)}function et(e,t,n,i){if(!(i?.groupIntrinsic||N(i)||["left","right"].includes(i?.position))&&e.some(o=>o.left<0||o.right>t.width||o.top<0||o.bottom>t.height))throw _(`${n} requires more Canvas margin space.`,e,t)}function tt(e,t,n,i,o){if(t===!1)return;const r=t.lineWidth/2;let d=1/0,l=1/0,a=-1/0,s=-1/0;for(const f of e)d=Math.min(d,f.left),l=Math.min(l,f.top),a=Math.max(a,f.right),s=Math.max(s,f.bottom);if(d-=t.padding,l-=t.padding,a+=t.padding,s+=t.padding,!o?.groupIntrinsic&&!N(o)&&!["left","right"].includes(o?.position)&&(d-r<0||l-r<0||a+r>n.width||s+r>n.height))throw _(`${i} background requires more Canvas margin space.`,[{left:d-r,right:a+r,top:l-r,bottom:s+r}],n);return{x:d,y:l,width:a-d,height:s-l}}function be(e,t,n,i){return n===void 0?e:M(e,t,n,i)}function ye(e,{multiColumnSide:t=!1}={}){const n=e.position??"right";if(!P.includes(n))throw new Error(`Unsupported legend position "${n}".`);const i=["left","right"].includes(n)||m({position:n}),o=e.layout===void 0?"edge":e.layout;if(o!=="edge")throw new Error('This legend requires layout "edge".');const r=e.align??"center";if(!["left","center","right"].includes(r))throw new Error(`Unsupported legend alignment "${r}".`);const d=e.direction??(i?"vertical":"horizontal");if(!["horizontal","vertical"].includes(d))throw new Error(`Unsupported legend direction "${d}".`);const l=e.columns;if(l!==void 0&&(!Number.isInteger(l)||l<1))throw new RangeError("Legend columns must be a positive integer.");const a=e.titlePosition??"top";if(v(e.titleStyle,a),!["top","left"].includes(a))throw new Error(`Unsupported legend titlePosition "${a}".`);if(i&&(r!=="center"||a!=="top"||!t&&(d!=="vertical"||l!==void 0&&l!==1)))throw new Error("Side item legends require vertical direction, center alignment, top title and one column.");const s=e.offset??(m({position:n})?8:30),f=e.itemGap??(d==="vertical"?w:28);return g(s,"Legend offset"),x(f,"Legend itemGap"),{position:n,layout:o,align:r,direction:d,columns:l,titlePosition:a,offset:s,itemGap:f}}function nt(e,t,n,i,{symbols:o,optional:r={},text:d=i.labels,labels:l=i.config.labels,titleStyle:a=i.config.titleStyle}){const s=`${t}Legend`,f=Object.values(o).find(Array.isArray)?.length??d.length;let c=e.editSemantic({property:`guide.legend.${t}.scale`,value:n.scale}).editSemantic({property:`guide.legend.${t}.title`,value:n.title})._withLegendConfig(t,n);c=p(c,`${s}Symbols`,{length:f,...o});const L=i.labelItemIndices,b=u=>L===void 0||!Array.isArray(u)?u:L.map(W=>u[W]);c=p(c,`${s}Labels`,{length:L?.length??d.length,x:b(i.labelX),y:b(i.itemY),text:b(d)}),c=be(c,`${s}Background`,i.background,n.border),c=p(c,`${s}Symbols`,Object.fromEntries(Object.entries(r).filter(([,u])=>u!==void 0))),c=k(c,`${s}Labels`,l);const S=i.config;return S.titleVisible===!1?$(c):(c=p(c,`${s}Title`,{x:i.title.x,y:i.title.y,text:S.title}),$(k(c,`${s}Title`,a,{align:i.title.align})))}function it(e,t,n,i,o,r){const d=`${t}Legend`;let l=e.editSemantic({property:`guide.legend.${t}.scale`,value:n.scale}).editSemantic({property:`guide.legend.${t}.title`,value:n.title})._withLegendConfig(t,n);return n.border!==!1&&(l=l.createGraphics({id:`${d}Background`,type:"rect",...r})),l=l.createGraphics({id:`${d}Symbols`,type:o,length:i,...r}).createGraphics({id:`${d}Labels`,type:"text",length:i,...r}),n.titleVisible!==!1&&(l=l.createGraphics({id:`${d}Title`,type:"text",...r})),l}export{ge as ITEM_LEGEND_LABELS,Re as ITEM_LEGEND_OPTIONS,he as ITEM_LEGEND_TITLE_STYLE,et as assertLegendBoundsInsideCanvas,it as createItemLegendGraphics,p as editGraphicProperties,be as editLegendBackground,Qe as formatContinuousValues,nt as materializeItemLegend,qe as normalizeContinuousLegend,B as normalizeInitialLegendTitle,Me as normalizeItemLegendConfig,ye as normalizeItemLegendLayout,j as normalizeLegendBorder,T as normalizeLegendTextOptions,A as normalizeLegendTitleOptions,Ke as requireResolvedLegendScale,Xe as resolveContinuousBounds,Ye as resolveContinuousColorLayer,Ve as resolveContinuousLegendLayer,tt as resolveLegendBackgroundFromBounds,Ze as resolveLegendTextBounds,Je as sampleContinuousValues,U as selectLegendLayer,k as styleContinuousText,g as validateNonNegative,x as validatePositive};