ggaction 0.0.24 → 0.0.26

package/src/materialization/facetGuides/edit.js

@@ -1,6 +1,8 @@
 import { prepareSharedFacetLegend } from "./preparation.js";
 import { facetLegendIntent, intrinsicFacetLegendSource, restoreFacetLegendIntent,
   prepareAuthoredFacetLegend } from "./owner.js";
+import { legendBlockChannels } from "../../grammar/legendBlocks.js";
+import { suppressLegendChannels } from "../legendSuppression.js";
 
 export function editFacetParentLegend(program, operation, args) {
   if (program.compositionSpec?.type !== "facet") {
@@ -9,6 +11,7 @@ export function editFacetParentLegend(program, operation, args) {
   const current = program.compositionSpec.facet.guides.legend;
   if (current === false) throw new Error(`${operation} requires an existing facet parent legend.`);
   const prepared = current === "shared" ? prepareSharedFacetLegend(program) : prepareAuthoredFacetLegend(program);
+  if (prepared === undefined) throw new Error(`${operation} requires an existing facet parent legend.`);
   let source;
   if (prepared.source !== undefined) {
     source = restoreFacetLegendIntent(intrinsicFacetLegendSource(program), facetLegendIntent(prepared.source));
@@ -21,10 +24,27 @@ export function editFacetParentLegend(program, operation, args) {
       ...(prepared.legend.mark === "point" ? { symbol: { layers: [{ type: "point", size: 5.5, stroke: "#ffffff", strokeWidth: 0.35 }] } } : {}) });
   }
   source = source[operation](args);
-  const intent = Object.keys(source.guideConfigs.legend ?? {}).length === 0 ? false : facetLegendIntent(source);
+  const suppress = operation === "removeLegend" && args.suppress === true;
+  const intent = suppress && (current === "shared" || Object.keys(source.guideConfigs.legend ?? {}).length === 0) ? "shared"
+    : Object.keys(source.guideConfigs.legend ?? {}).length === 0 ? false : facetLegendIntent(source);
+  let children = program.children;
+  if (suppress) {
+    children = Object.fromEntries(Object.entries(children).map(([id, child]) => {
+      let next = child;
+      for (const [target, { channels }] of Object.entries(source.guideConfigs.suppressedLegends ?? {})) {
+        const existing = new Set(Object.entries(next.guideConfigs.legend ?? {})
+          .filter(([, config]) => config.target === target)
+          .flatMap(([kind, config]) => legendBlockChannels(kind, config)));
+        const removed = channels.filter(channel => existing.has(channel));
+        if (removed.length) next = next.removeLegend({ target, channels: removed, suppress: true });
+        next = suppressLegendChannels(next, target, channels);
+      }
+      return [id, next];
+    }));
+  }
   const spec = program.compositionSpec;
   return program._clone({ trace: source.trace, actionStack: source.actionStack, actionSequence: source._actionSequence })
-    ._withCompositionState({ children: program.children,
+    ._withCompositionState({ children,
       compositionSpec: { ...spec, facet: { ...spec.facet, guides: { ...spec.facet.guides, legend: intent } } } })
     .materializeComposition();
 }

package/src/materialization/facetGuides/layout.js

@@ -1 +1 @@
-import{cartesianAxisOwners as O,axisGraphicIds as S}from"../../selectors/axes.js";import{resolveAuthoredFacetLegendLayout as B}from"./ownerLayout.js";import{PLOT_LEGEND_POSITIONS as F}from"../../layout/legend.js";import{resolveConcreteGraphicBounds as P}from"../../grammar/schemas/graphicBounds.js";import{resolveTextBounds as y,textBoundsIntersect as C}from"../../core/textMetrics.js";import{resolveFacetHeaderItems as E,retainedFacetGuideIds as T}from"../facetHeaders.js";function w(n,t,e){return{left:n.left+t,right:n.right+t,top:n.top+e,bottom:n.bottom+e}}function M(n,t,e,m){const f=n.materializationConfigs.textMetrics,h=[];for(const o of t.children){const c=n.children[o.id],g=new Set(o.footerShift===void 0?[]:O(c).filter(d=>d.channel==="x").flatMap(d=>["line","ticks","labels","title"].flatMap((a,l)=>d.config?.[a]?.position==="bottom"?[S(d.channel,d.id)[l]]:[])));for(const d of T(n,o.id)){const a=P(c.graphicSpec,d,f);a!==void 0&&h.push(w(a,o.x,o.y+(g.has(d)?o.footerShift:0)))}}const{items:i}=E(t,e,m);for(const o of i)o.properties.text!==""&&h.push(y(o.properties,f));return h}function b(n,t,e,m,f){const h=n.right-n.left,i=n.bottom-n.top,o=e==="right"?t.x+t.width+f:e==="left"?t.x-f-h:m==="left"?t.x:m==="right"?t.x+t.width-h:t.x+(t.width-h)/2,c=["left","right"].includes(e)?t.y:e==="top"?t.y-f-i:t.y+t.height+f;return{left:o,right:o+h,top:c,bottom:c+i}}function j(n,{layout:t,plot:e,plots:m,title:f,preparedHeaders:h,prepared:i}){if(i?.mode==="authored")return B(n,{layout:t,plot:e,title:f,prepared:i,guides:M(n,t,m,h)});if(i?.mode!=="promoted")return{layout:t,plot:e};const o=i.occupiedGroup;if(o?.placement.at!==void 0||F.includes(o?.placement.position))return{layout:t,plot:e};const c=i.reservation.position,g=i.reservation.align,d=i.kinds.map(r=>i.source.guideConfigs.legend[r]),a=i.reservation.gap,l=o===void 0?d.every(r=>r.inferredOffset===!0):o.inferredOffset===!0;let s=b(i.bounds,e,c,g,a);const v=M(n,t,m,h),I=v.map(r=>c==="right"?r.right-(e.x+e.width):c==="left"?e.x-r.left:c==="top"?e.y-r.top:r.bottom-(e.y+e.height));if(l)s=b(i.bounds,e,c,g,Math.max(a,...I.map(r=>r+a)));else if(v.some(r=>C(s,r)))throw new Error("Facet shared legend overlaps retained axes or headers.");const x=Math.max(0,t.padding.left-s.left),u=Math.max(0,f.height+t.padding.top-s.top),G=t.children.map(r=>({...r,x:r.x+x,y:r.y+u})),L={...e,x:e.x+x,y:e.y+u};return s=w(s,x,u),{plot:L,layout:{...t,children:G,width:Math.ceil(Math.max(t.width+x,s.right+t.padding.right)),height:Math.ceil(Math.max(t.height+u,s.bottom+t.padding.bottom)),legend:{position:c,x:s.left,y:s.top,width:s.right-s.left,height:s.bottom-s.top,translation:{x:s.left-i.bounds.left,y:s.top-i.bounds.top}}}}}export{j as resolvePromotedFacetLegendLayout};
+import{cartesianAxisOwners as S,axisGraphicIds as B}from"../../selectors/axes.js";import{resolveAuthoredFacetLegendLayout as F}from"./ownerLayout.js";import{PLOT_LEGEND_POSITIONS as y}from"../../layout/legend.js";import{resolveConcreteGraphicBounds as C}from"../../grammar/schemas/graphicBounds.js";import{resolveTextBounds as P,textBoundsIntersect as k}from"../../core/textMetrics.js";import{resolveFacetHeaderItems as E,retainedFacetGuideIds as T}from"../facetHeaders.js";function M(n,t,e){return{left:n.left+t,right:n.right+t,top:n.top+e,bottom:n.bottom+e}}function b(n,t,e,g){const f=n.materializationConfigs.textMetrics,d=[];for(const o of t.children){const r=n.children[o.id],a=new Set(o.footerShift===void 0?[]:S(r).filter(h=>h.channel==="x").flatMap(h=>["line","ticks","labels","title"].flatMap((m,l)=>h.config?.[m]?.position==="bottom"?[B(h.channel,h.id)[l]]:[])));for(const h of T(n,o.id)){const m=C(r.graphicSpec,h,f);m!==void 0&&d.push(M(m,o.x,o.y+(a.has(h)?o.footerShift:0)))}}const{items:i}=E(t,e,g);for(const o of i)o.properties.text!==""&&d.push(P(o.properties,f));return d}function I(n,t,e,g,f,d=0){const i=n.right-n.left,o=n.bottom-n.top;let r=e==="right"?t.x+t.width+f:e==="left"?t.x-f-i:g==="left"?t.x:g==="right"?t.x+t.width-i:t.x+(t.width-i)/2,a=["left","right"].includes(e)?t.y:e==="top"?t.y-f-o:t.y+t.height+f;return["left","right"].includes(e)?a+=d:r+=d,{left:r,right:r+i,top:a,bottom:a+o}}function q(n,{layout:t,plot:e,plots:g,title:f,preparedHeaders:d,prepared:i}){if(i?.mode==="authored")return F(n,{layout:t,plot:e,title:f,prepared:i,guides:b(n,t,g,d)});if(i?.mode!=="promoted")return{layout:t,plot:e};const o=i.occupiedGroup;if(o?.placement.at!==void 0||y.includes(o?.placement.position))return{layout:t,plot:e};const r=i.reservation.position,a=i.reservation.align,h=i.kinds.map(s=>i.source.guideConfigs.legend[s]),m=i.reservation.gap,l=o===void 0?h.every(s=>s.inferredOffset===!0):o.inferredOffset===!0,v=o?.placement.alongOffset??0;let c=I(i.bounds,e,r,a,m,v);const w=b(n,t,g,d),L=w.map(s=>r==="right"?s.right-(e.x+e.width):r==="left"?e.x-s.left:r==="top"?e.y-s.top:s.bottom-(e.y+e.height));if(l)c=I(i.bounds,e,r,a,Math.max(m,...L.map(s=>s+m)),v);else if(!i.kinds.every(s=>n.context.compositionCollectedLegends?.includes(s))&&w.some(s=>k(c,s)))throw new Error("Facet shared legend overlaps retained axes or headers.");const x=Math.max(0,t.padding.left-c.left),u=Math.max(0,f.height+t.padding.top-c.top),O=t.children.map(s=>({...s,x:s.x+x,y:s.y+u})),G={...e,x:e.x+x,y:e.y+u};return c=M(c,x,u),{plot:G,layout:{...t,children:O,width:Math.ceil(Math.max(t.width+x,c.right+t.padding.right)),height:Math.ceil(Math.max(t.height+u,c.bottom+t.padding.bottom)),legend:{position:r,x:c.left,y:c.top,width:c.right-c.left,height:c.bottom-c.top,translation:{x:c.left-i.bounds.left,y:c.top-i.bounds.top}}}}}export{q as resolvePromotedFacetLegendLayout};

package/src/materialization/facetGuides/owner.js

@@ -42,7 +42,7 @@ export function restoreFacetLegendIntent(source, intent) {
     const descriptor = describeLegendBlock(source, kind, config);
     const entry = { target: config.target, channels: [...descriptor.channels] };
     if (descriptor.channels.includes("shape") && descriptor.channels.includes("size")) entry.combine = "size-shape";
-    if (kind === "colorSize") entry.combine = "color-size";
+    if (kind === "colorSize") { entry.combine = config.combine; if(config.shapeScale!==undefined)entry.values=config.sampling.values; }
     if (descriptor.family === "categorical" && config.inferredSymbol === false && entry.combine === undefined) entry.symbol = config.symbol;
     if (kind === "gradient" && config.representation === "symbols") entry.representation = "symbols";
     scaffolds.push(entry);
@@ -67,12 +67,13 @@ export function restoreFacetLegendIntent(source, intent) {
     }
   }
   source = source._withMaterializationConfig(["guides", "legendGroups"], intent.groups);
-  return source.rematerializeLegend();
+  return source.rematerializeLegend().rematerializeSideLegendLane();
 }
 
 export function prepareAuthoredFacetLegend(program, intent = program.compositionSpec.facet.guides.legend) {
   let source = intrinsicFacetLegendSource(program);
-  source = isAuthoredFacetLegend(intent) ? restoreFacetLegendIntent(source, intent) : source.createLegend(intent);
+  source = isAuthoredFacetLegend(intent) ? restoreFacetLegendIntent(source, intent)
+    : source.createLegend(intent).rematerializeSideLegendLane();
   const kinds = Object.keys(source.guideConfigs.legend ?? {});
   for (const [kind, config] of Object.entries(source.guideConfigs.legend)) {
     const descriptor = describeLegendBlock(source, kind, config);

package/src/materialization/facetGuides/ownerLayout.js

@@ -1,4 +1,4 @@
-import { localLegendPlacement } from "../../grammar/legendGroups.js";
+import { localLegendPlacement, retainsLegendSlot } from "../../grammar/legendGroups.js";
 import { PLOT_LEGEND_POSITIONS } from "../../core/vocabulary.js";
 import { resolveLegendGroupPlacement } from "../../layout/legendGroup.js";
 import { textBoundsIntersect } from "../../core/textMetrics.js";
@@ -20,8 +20,10 @@ export function resolveAuthoredFacetLegendLayout(program, { layout, plot, title,
   const targets = [...new Set(prepared.blocks.map(block => block.config.target))];
   for (const target of targets) {
     const owned = prepared.blocks.filter(block => block.config.target === target);
-    const inherited = owned.filter(block => localLegendPlacement(block.config) === undefined);
-    if (inherited.length) partitions.push({ blocks: inherited,
+    const retainedGroup = prepared.source.guideConfigs.legendGroups?.[target];
+    const anchor = retainedGroup ? retainedGroup.placement.position ?? null : undefined;
+    const inherited = owned.filter(block => localLegendPlacement(block.config) === undefined || retainsLegendSlot(block.config, anchor));
+    if (inherited.length) partitions.push({ blocks: inherited, inherited: true,
       group: prepared.source.guideConfigs.legendGroups?.[target] ?? nativeGroup(inherited) });
     for (const block of owned) {
       const placement = localLegendPlacement(block.config);
@@ -30,7 +32,7 @@ export function resolveAuthoredFacetLegendLayout(program, { layout, plot, title,
     }
   }
   const placements = [];
-  for (const { blocks, group } of partitions) {
+  for (const { blocks, group, inherited } of partitions) {
     const position = group.placement.position;
     const inside = group.placement.at !== undefined || PLOT_LEGEND_POSITIONS.includes(position);
     let effective = group;
@@ -45,15 +47,19 @@ export function resolveAuthoredFacetLegendLayout(program, { layout, plot, title,
       group: effective, plot, canvas: layout, deferCanvasFit: true });
     for (const plan of plans) {
       const block = blocks.find(block => block.kind === plan.id);
+      // Keep a fine-positioned block in packing only; its local partition below
+      // paints it once at its explicit anchor.
+      if (localLegendPlacement(block.config) !== undefined && inherited && retainsLegendSlot(block.config, group.placement.position)) continue;
       const bounds = shift(block.bounds, plan.dx, plan.dy);
       if (inside && (bounds.left < plot.x || bounds.right > plot.x + plot.width ||
           bounds.top < plot.y || bounds.bottom > plot.y + plot.height)) {
         throw new Error("Facet parent legend does not fit the final plot union.");
       }
-      if (guides.some(bound => textBoundsIntersect(bounds, bound))) {
+      const hidden = program.context.compositionCollectedLegends ?? [];
+      if (!hidden.includes(block.kind) && guides.some(bound => textBoundsIntersect(bounds, bound))) {
         throw new Error("Facet parent legend overlaps retained axes or headers.");
       }
-      if (placements.some(other => textBoundsIntersect(bounds, other.bounds))) {
+      if (!hidden.includes(block.kind) && placements.some(other => !hidden.includes(other.kind) && textBoundsIntersect(bounds, other.bounds))) {
         throw new Error("Facet parent legend blocks overlap.");
       }
       placements.push({ kind: block.kind, dx: plan.dx, dy: plan.dy, bounds, inside });

package/src/materialization/facetGuides/placement.js

@@ -27,16 +27,6 @@ function copyLegendConfig(program, source) {
   return next;
 }
 
-function removeNamespacedGraphics(program, namespace, ids) {
-  let next = program;
-  for (const id of ids) {
-    const target = namespaceGraphicId(namespace, id);
-    if (next.graphicSpec.objects[target] !== undefined) {
-      next = next.editGraphics({ target, remove: true });
-    }
-  }
-  return next;
-}
 
 function legendTranslation(prepared, plot, layout) {
   if (layout.legend?.translation !== undefined) return layout.legend.translation;
@@ -161,7 +151,7 @@ export function prepareFacetGuideOwnership(program, placements, prepared) {
     placements,
     children,
     axes: program.compositionSpec.facet.guides.axes,
-    legend: program.compositionSpec.facet.guides.legend,
+    legend: prepared === undefined ? false : program.compositionSpec.facet.guides.legend,
     ...(prepared === undefined ? {} : { sharedLegends: prepared.compatibility })
   });
 }
@@ -175,7 +165,13 @@ export function applyFacetGuideComposition(program, { layout, plot, synchronizeC
   }
   const prepared = prepareSharedFacetLegend(program);
   const ownership = prepareFacetGuideOwnership(program, layout.children, prepared);
-  let next = program;
+  const removals = new Set();
+  const remove = (namespace, ids) => {
+    for (const id of ids) {
+      const qualified = namespaceGraphicId(namespace, id);
+      if (program.graphicSpec.objects[qualified]) removals.add(qualified);
+    }
+  };
   for (const cell of layout.children) {
     const namespace = `${program.compositionSpec.id}-${cell.id}`;
     const childPlan = ownership.children[cell.id];
@@ -184,19 +180,27 @@ export function applyFacetGuideComposition(program, { layout, plot, synchronizeC
     // policy still removes each local copy while retaining hue legends.
     for (const [owner, config] of Object.entries(program.children[cell.id].markConfigs)) {
       if (!config.gradientPlot) continue;
-      next = removeNamespacedGraphics(next, namespace,
+      remove(namespace,
         ["DensityLegend", "DensityLegendLabels", "DensityLegendTitle"].map(suffix => `${owner}${suffix}`));
     }
     const axisOwners = cartesianAxisOwners(program.children[cell.id]);
     for (const axisId of childPlan.removeAxes) {
       const owner = axisOwners.find(owner => owner.id === axisId);
-      next = removeNamespacedGraphics(next, namespace, axisGraphicIds(owner.channel, axisId));
+      remove(namespace, axisGraphicIds(owner.channel, axisId));
     }
     for (const [axisId, components] of Object.entries(childPlan.removeAxisComponents ?? {})) {
       const owner = axisOwners.find(owner => owner.id === axisId);
       const ids = axisGraphicIds(owner.channel, axisId);
-      next = removeNamespacedGraphics(next, namespace, components.map(component => ids[["line", "ticks", "labels", "title"].indexOf(component)]));
+      remove(namespace, components.map(component => ids[["line", "ticks", "labels", "title"].indexOf(component)]));
     }
+    if (childPlan.removeLegends.length > 0) remove(namespace, allLegendGraphicIds(childPlan.removeLegends));
+  }
+  // All ownership removals are independent. Rebuild the immutable graphic map
+  // once, rather than copying every panel for each hidden guide component.
+  let next = removals.size ? program.editGraphics({ target: [...removals], remove: true }) : program;
+  for (const cell of layout.children) {
+    const namespace = `${program.compositionSpec.id}-${cell.id}`;
+    const axisOwners = cartesianAxisOwners(program.children[cell.id]);
     if (cell.footerShift !== undefined) {
       for (const owner of axisOwners.filter(owner => owner.channel === "x")) {
         for (const [index, component] of ["line", "ticks", "labels", "title"].entries()) {
@@ -213,13 +217,6 @@ export function applyFacetGuideComposition(program, { layout, plot, synchronizeC
         }
       }
     }
-    if (childPlan.removeLegends.length > 0) {
-      next = removeNamespacedGraphics(
-        next,
-        namespace,
-        allLegendGraphicIds(childPlan.removeLegends)
-      );
-    }
   }
   if (prepared === undefined) {
     if (next.semanticSpec.guides.legend?.colorSize !== undefined) {

package/src/materialization/facetGuides/preparation.js

@@ -1,4 +1,5 @@
 import { localLegendPosition } from "../../grammar/legendGroups.js";
+import { restoreLegendItemsOffset } from "../legendItemsOffset.js";
 import { prepareAuthoredFacetLegend, facetLegendIntent } from "./owner.js";
 import { isPlainObject } from "../../core/immutable.js";
 import { PLOT_LEGEND_POSITIONS } from "../../layout/legend.js";
@@ -31,9 +32,11 @@ export function legendKinds(program) {
 
 function legendCandidates(program) {
   const layers = program.semanticSpec.layers;
+  const eligible = (layer, channel) => layer.encoding?.[channel]?.scale !== undefined &&
+    !program.guideConfigs.suppressedLegends?.[layer.id]?.channels.includes(channel);
   const color = layers.filter(layer => {
     const encoding = layer.encoding?.color;
-    return encoding?.scale !== undefined &&
+    return eligible(layer, "color") &&
       findSemanticScale(program, encoding.scale) !== undefined;
   });
   if (color.length === 1) {
@@ -41,7 +44,7 @@ function legendCandidates(program) {
     return {
       target: layer.id,
       channels: ["color", "stroke", "shape", "strokeDash"].filter(
-        channel => layer.encoding?.[channel]?.scale !== undefined
+        channel => eligible(layer, channel)
       )
     };
   }
@@ -52,7 +55,7 @@ function legendCandidates(program) {
   }
   for (const channel of ["stroke", "shape", "strokeDash", "size", "opacity"]) {
     const candidates = layers.filter(
-      layer => layer.encoding?.[channel]?.scale !== undefined
+      layer => eligible(layer, channel)
     );
     if (candidates.length === 1) {
       return { target: candidates[0].id, channels: [channel] };
@@ -63,6 +66,7 @@ function legendCandidates(program) {
       );
     }
   }
+  if (Object.keys(program.guideConfigs.suppressedLegends ?? {}).length) return undefined;
   throw new Error("Shared facet legend requires one eligible encoded scale.");
 }
 
@@ -85,6 +89,7 @@ function continuousValues(domain, count) {
 
 function legendRequests(program) {
   const request = legendCandidates(program);
+  if (request === undefined) return [];
   const layer = findLayer(program, request.target);
   const separate = request.channels.filter(channel => {
     if (!["color", "stroke"].includes(channel)) return false;
@@ -100,7 +105,12 @@ function legendRequests(program) {
 }
 
 function prepareAutoLegendSource(child) {
+  // Facet inference has already selected explicit eligible owner/channel pairs
+  // in legendCandidates, including suppression. Invoke the public creator with
+  // those requests; importing its action planner here reverses the dependency
+  // direction and repeats the same policy through a circular action graph.
   const requests = legendRequests(child);
+  if (!requests.length) return child;
   const canvas = child.graphicSpec.objects.canvas;
   let source = child
     ._withCanvasConfig({
@@ -207,12 +217,14 @@ export function prepareSharedFacetLegend(program) {
   const firstId = program.compositionSpec.children[0];
   const first = program.children[firstId];
   const inferred = legendKinds(first).length === 0;
-  if (inferred) {
+  if (inferred && !Object.keys(first.guideConfigs.suppressedLegends ?? {}).length) {
     const legacy = resolveLegacyCategoricalLegend(program);
     if (legacy !== undefined) return legacy;
   }
-  const source = inferred ? prepareAutoLegendSource(first) : first;
+  // Shared guides receive the offset once in the parent's final placement.
+  const source = restoreLegendItemsOffset(inferred ? prepareAutoLegendSource(first) : first);
   const kinds = legendKinds(source);
+  if (!kinds.length && Object.keys(first.guideConfigs.suppressedLegends ?? {}).length) return undefined;
   if (kinds.some(kind => localLegendPosition(source.guideConfigs.legend[kind]) !== undefined)) {
     return { ...prepareAuthoredFacetLegend(program, facetLegendIntent(source)), keepShared: true };
   }

package/src/materialization/facetHeaders.js

@@ -1 +1,5 @@
-import{measureFacetContentChildren as V}from"./facetContentBounds.js";import{facetAxisMode as P,hasOuterFacetAxes as W}from"../core/facetAxisPolicy.js";import{isPlainObject as v}from"../core/immutable.js";import{formatVisibleText as _,measureTextWidth as U,resolveTextBounds as z,textBoundsIntersect as S}from"../core/textMetrics.js";import{validateFacetHeaderRotations as K}from"../grammar/facetHeaders.js";import{resolveDisplayLabel as N}from"../grammar/displayLabels.js";import{resolveGraphicBounds as F}from"../layout/canvas.js";import{unionConcreteGraphicBounds as Y}from"../grammar/schemas/graphicBounds.js";import{intersectClipBounds as Z}from"../grammar/schemas/graphicClip.js";import{DEFAULT_COLORS as J,DEFAULT_FONT_FAMILY as Q}from"../theme/defaults.js";import{prepareFacetHeaderTitles as X}from"../layout/facetHeaderTitles.js";import{cartesianAxisOwners as tt,axisGraphicIds as E}from"../selectors/axes.js";import{resolveFacetOuterSides as et}from"../grammar/facets/guides.js";import{resolveConcreteGraphicBounds as ot}from"../grammar/schemas/graphicBounds.js";import{allLegendGraphicIds as nt}from"./guides/resources.js";const it=Object.freeze(["top","right","bottom","left"]),B=Object.freeze({top:0,right:0,bottom:0,left:0});function ct(t){return`${t}-headers`}function T(){return{mode:"legacy",common:{fontSize:12,fontFamily:Q,fontWeight:600,color:J.strongText,offset:10,align:"center"},row:{side:"left"},column:{side:"top"}}}function j(t){if(!v(t))throw new TypeError("Facet headers config must be a plain object.");if(K(t),t.common===void 0&&t.mode===void 0)return{...T(),common:{...T().common,...t}};if(!["legacy","roles"].includes(t.mode)||!v(t.common)||!v(t.row)||!v(t.column))throw new Error("Facet headers config must contain canonical mode and role objects.");return{mode:t.mode,common:{...t.common},row:{...t.row},column:{...t.column}}}function y(t,e){const o=j(t);return e==="all"?{...o.common}:{...o.common,...o[e]}}function b(t,e){return N(t,e.labelMap,_)}function st(t){return new Map((t.facet.grid?.cells??[]).map(e=>[e.id,e]))}function rt(t,e){const o=t.compositionSpec,c=y(e,"all"),s=st(o);return o.children.map((i,n)=>{const r=s.get(i),f=r===void 0?b(o.facet.values[n],c):`${b(r.rowValue,c)} \xB7 ${b(r.columnValue,c)}`;return{topology:"legacy",role:"column",id:i,text:f,config:c}})}function G(t,e){const o=e==="column"?"column":"row",c=e==="column"?"columnValue":"rowValue",s=new Map;for(const i of t.facet.grid.cells){const n=s.get(i[o]);if(n===void 0)s.set(i[o],{coordinate:i[o],value:i[c],ids:[i.id]});else{if(n.value!==i[c])throw new Error(`Facet ${e} header values conflict at coordinate ${i[o]}.`);n.ids.push(i.id)}}return[...s.values()].sort((i,n)=>i.coordinate-n.coordinate)}function ft(t,e){const o=t.compositionSpec,c=y(e,"column");if(o.facet.grid===void 0)return o.children.map((r,f)=>({topology:"cell-column",role:"column",id:r,ids:[r],row:Math.floor(f/o.columns),column:f%o.columns,text:b(o.facet.values[f],c),config:c}));const s=y(e,"row"),i=G(o,"column").map(r=>({topology:"grid-column",role:"column",ids:r.ids,coordinate:r.coordinate,text:b(r.value,c),config:c})),n=G(o,"row").map(r=>({topology:"grid-row",role:"row",ids:r.ids,coordinate:r.coordinate,text:b(r.value,s),config:s}));return[...i,...n]}function x(t){return t.rotation!==void 0&&t.rotation!==0}function H(t,e){return z({x:0,y:0,text:t.text,...t.config,textAlign:"center",textBaseline:"middle"},e)}function at(t,e,o){if(x(t.config)){const c=H(t,o);return["left","right"].includes(e)?c.right-c.left:c.bottom-c.top}return["left","right"].includes(e)?U(t.text,t.config,o):t.config.fontSize}function lt(t){const e={...B};if(!["plot","content"].includes(t.compositionSpec.spacing))return e;for(const o of t.compositionSpec.children){const c=t.children[o],s=F(c),i=c.graphicSpec.objects.canvas.properties;e.left=Math.max(e.left,s.x),e.top=Math.max(e.top,s.y),e.right=Math.max(e.right,i.width-s.x-s.width),e.bottom=Math.max(e.bottom,i.height-s.y-s.height)}return e}function O(t,e,o,c,s){const i=at(t,e,o)+t.config.offset+(t.clearance?.[e]??0);return x(t.config)&&s?Math.max(0,i-c[e]):i}function dt(t,e,o){if(!e.some(n=>["content","view"].includes(n.config.anchor)))return;if(!["plot","content"].includes(t.compositionSpec.spacing))throw new Error("Facet header content anchor requires plot spacing or content spacing.");const c=new Map,s=e.some(n=>n.config.anchor==="view")?new Map(V(t).map(n=>[n.id,n])):void 0;for(const n of t.compositionSpec.children){const r=t.children[n],f=F(r),d={left:f.x,right:f.x+f.width,top:f.y,bottom:f.y+f.height},l=r.semanticSpec.layers.map(u=>u.id).filter(u=>r.graphicSpec.objects[u]!==void 0),h=Y(r.graphicSpec,l,o),a=r.graphicSpec.objects.canvas.properties,m=h===void 0?void 0:Z(h,{left:0,right:a.width,top:0,bottom:a.height});c.set(n,m===void 0||m.left>m.right||m.top>m.bottom?d:C([d,m]))}const i=s===void 0?void 0:new Map([...s].map(([n,r])=>[n,{left:r.bounds.left+r.plot.x,right:r.bounds.right+r.plot.x,top:r.bounds.top+r.plot.y,bottom:r.bounds.bottom+r.plot.y}]));for(const n of e)if(["content","view"].includes(n.config.anchor)){n.config.anchor==="view"&&(n.contentById=i),n.clearance={...B};for(const r of n.ids??[n.id]){const f=F(t.children[r]),d=(n.contentById??c).get(r);for(const[l,h]of Object.entries({left:f.x-d.left,right:d.right-f.x-f.width,top:f.y-d.top,bottom:d.bottom-f.y-f.height}))n.clearance[l]=Math.max(n.clearance[l],h)}}return c}function R(t,e,o,c){const s=t.filter(i=>i.role===e&&i.text!=="");return s.length===0?0:Math.max(...s.map(i=>O(i,i.config.side,o,c,!0)))}function ut(t,e){const o=t.compositionSpec,c=t.children[e],s=W(o.facet.guides.axes)?et({placements:o.facet.grid?.cells??o.children.map((n,r)=>({id:n,row:Math.floor(r/o.columns),column:r%o.columns}))}):void 0,i=tt(c).flatMap(n=>E(n.channel,n.id).filter((r,f)=>f>=2&&(s===void 0||P(o.facet.guides.axes,n.channel)==="each"||s[n.config?.[["line","ticks","labels","title"][f]]?.position]?.includes(e))));for(const n of["theta","radius","parallel"])c.guideConfigs.axis?.[n]!==void 0&&i.push(...E(n).slice(2));return o.facet.guides.legend===!1&&i.push(...nt(Object.keys(c.guideConfigs.legend??{}))),i.filter(n=>c.graphicSpec.objects[n]!==void 0)}function mt(t,e){const o=t.children[e],c=F(o),s=ut(t,e).map(i=>ot(o.graphicSpec,i,o.materializationConfigs.textMetrics)).filter(Boolean);return{top:Math.max(0,...s.map(i=>c.y-i.top)),bottom:Math.max(0,...s.map(i=>i.bottom-c.y-c.height)),left:Math.max(0,...s.map(i=>c.x-i.left)),right:Math.max(0,...s.map(i=>i.right-c.x-c.width))}}function Rt(t,e){const o=j(e),c=o.mode==="legacy"?rt(t,o):ft(t,o),s=t.compositionSpec.facet.grid===void 0?Math.ceil(t.compositionSpec.children.length/t.compositionSpec.columns):Math.max(...t.compositionSpec.facet.grid.cells.map(a=>a.row))+1,i=t.materializationConfigs.textMetrics,n=["column",...t.compositionSpec.facet.grid===void 0?[]:["row"]].map(a=>[a,y(o,a)]),r=n.some(([,a])=>a.title!==void 0);if(["plot","content"].includes(t.compositionSpec.spacing)){const a=new Map(t.compositionSpec.children.map(m=>[m,mt(t,m)]));for(const m of c)m.clearance=Object.fromEntries(it.map(u=>{const p=Math.max(0,...(m.ids??[m.id]).map(g=>a.get(g)[u]));return[u,p>m.config.offset?p:0]}))}const f=dt(t,c,i),d=r||c.some(a=>x(a.config))?lt(t):B,l={outer:{...B},cellRows:{top:Array(s).fill(0),bottom:Array(s).fill(0)}};if(o.mode==="legacy"&&["plot","content"].includes(t.compositionSpec.spacing))for(const a of c){if(a.text==="")continue;const m=t.compositionSpec.children.indexOf(a.id),u=t.compositionSpec.facet.grid?.cells[m]?.row??Math.floor(m/t.compositionSpec.columns);l.cellRows.top[u]=Math.max(l.cellRows.top[u],O(a,"top",i,d,u===0))}if(o.mode==="roles"){const a=y(o,"column"),m=R(c,"column",i,d);if(t.compositionSpec.facet.grid===void 0){const u=["left","right"].includes(a.side);u&&(l.cellColumns={left:Array(t.compositionSpec.columns).fill(0),right:Array(t.compositionSpec.columns).fill(0)});for(const p of c)if(p.text!==""){const g=u?l.cellColumns:l.cellRows,M=u?p.column:p.row,$=u?t.compositionSpec.columns-1:s-1,q=["top","left"].includes(a.side)?M===0:M===$;g[a.side][M]=Math.max(g[a.side][M],O(p,a.side,i,d,q))}}else{l.outer[a.side]=m;const u=y(o,"row");l.outer[u.side]=R(c,"row",i,d)}}const h=X({roles:n,descriptors:c,space:d,headerLayout:l,profile:i,ids:t.compositionSpec.children});return{headers:o,descriptors:c,titles:h,headerLayout:l,...f===void 0?{}:{contentById:f},...(r||c.some(a=>x(a.config)))&&i!==void 0?{profile:i}:{}}}function D(t,e){return e==="start"?{x:t.left,textAlign:"left"}:e==="end"?{x:t.right,textAlign:"right"}:{x:(t.left+t.right)/2,textAlign:"center"}}function pt(t,e){return e==="start"?{y:t.top,textBaseline:"top"}:e==="end"?{y:t.bottom,textBaseline:"bottom"}:{y:(t.top+t.bottom)/2,textBaseline:"middle"}}function C(t){return{left:Math.min(...t.map(e=>e.left)),right:Math.max(...t.map(e=>e.right)),top:Math.min(...t.map(e=>e.top)),bottom:Math.max(...t.map(e=>e.bottom))}}function w(t,e){return{left:t.x+e.x,right:t.x+e.x+e.width,top:t.y+e.y,bottom:t.y+e.y+e.height}}function A(t){return{left:t.x,right:t.x+t.width,top:t.y,bottom:t.y+t.height}}function I(t,e){return{left:t.x+e.left,right:t.x+e.right,top:t.y+e.top,bottom:t.y+e.bottom}}function L(t,e,o,c,s){return s==="start"?t-o:s==="end"?e-c:(t+e-o-c)/2}function k(t,e,o,c){const{config:s}=t,i=H(t,c),n={textAlign:"center",textBaseline:"middle",rotation:s.rotation};return["top","bottom"].includes(s.side)?{...n,x:L(e.left,e.right,i.left,i.right,s.align),y:s.side==="top"?o.top-s.offset-i.bottom:o.bottom+s.offset-i.top}:{...n,x:s.side==="left"?o.left-s.offset-i.right:o.right+s.offset-i.left,y:L(e.top,e.bottom,i.top,i.bottom,s.align)}}function ht(t,e,o,c,s,i){i=t.contentById??i;const n=t.ids.map(p=>e.get(p)),r=t.ids.find((p,g)=>n[g]===void 0),f=t.ids.find(p=>o.get(p)===void 0);if(r!==void 0||f!==void 0)throw new Error(`Facet header requires cell and plot bounds for "${r??f}".`);const d=t.ids.map((p,g)=>w(n[g],o.get(p))),l=C(d),h=["content","view"].includes(t.config.anchor)?C(t.ids.map((p,g)=>I(n[g],i.get(p)))):["plot","content"].includes(c)?l:C(n.map(A)),a=t.config;if(x(a)||t.topology==="role-title"){const p=k(t,l,h,s),g=["left","right"].includes(a.side)?"y":"x";return a.alongOffset!==void 0&&(p[g]+=a.alongOffset),{descriptor:t,snapshots:h,properties:p}}const m=["content","view"].includes(a.anchor)?0:t.clearance?.[a.side]??0;let u;if(["top","bottom"].includes(a.side)){u=D(l,a.align);const p=a.side==="top";u.y=p?h.top-m-a.offset-a.fontSize/2:h.bottom+m+a.offset+a.fontSize/2,u.textBaseline="middle"}else{u=pt(l,a.align);const p=a.side==="left";u.x=p?h.left-m-a.offset:h.right+m+a.offset,u.textAlign=p?"right":"left"}return{descriptor:t,snapshots:h,properties:u}}function gt(t,e,o,c,s,i){if(i=t.contentById??i,e===void 0||o===void 0)throw new Error(`Facet header requires cell and plot bounds for "${t.id}".`);const n=["content","view"].includes(t.config.anchor)?I(e,i.get(t.id)):w(e,o);if(x(t.config)&&["plot","content"].includes(c)){const r=w(e,o);return{descriptor:t,snapshots:A(e),properties:k({...t,config:{...t.config,side:"top"}},r,n,s)}}return{descriptor:t,snapshots:A(e),properties:{...D(w(e,o),t.config.align),y:["plot","content"].includes(c)?e.y+o.y-(t.clearance?.top??0)-t.config.offset-t.config.fontSize/2:e.y+t.config.offset,textBaseline:"middle",...x(t.config)?{rotation:t.config.rotation}:{}}}}function xt(t){const{config:e}=t.descriptor;return{type:"text",properties:{...t.properties,text:t.descriptor.text,fill:e.color,fontSize:e.fontSize,fontFamily:e.fontFamily,fontWeight:e.fontWeight}}}function wt(t,e,o,c,s,i){const n=e.map((r,f)=>t[f].descriptor.text===""?void 0:z(r.properties,c));for(const[r,f]of n.entries())if(f!==void 0&&(f.left<-1e-9||f.right>o.width+1e-9||f.top<-1e-9||f.bottom>o.height+1e-9||n.some((d,l)=>l<r&&d!==void 0&&S(d,f))||o.children.some(d=>S(f,i===void 0?["plot","content"].includes(o.spacing)?w(d,s.get(d.id)):A(d):I(d,i.get(d.id))))))throw new Error("Facet role headers require sufficient non-overlapping reserved space.")}function yt(t,e,o,c,s){const i=[];for(let n=0;n<t.length;n+=1){if(t[n].properties.text==="")continue;const r=z(t[n].properties,c),f=e.children[n],d=o.get(f.id);if(r.left<0||r.right>e.width||r.top<0||r.bottom>e.height||i.some(l=>S(l,r))||(["plot","content"].includes(e.spacing)?e.children.some(l=>S(r,s===void 0?w(l,o.get(l.id)):I(l,s.get(l.id)))):S(r,w(f,d))))throw new Error("Facet headers require sufficient non-overlapping space above every child plot.");i.push(r)}}function bt(t,e,o){const c=new Map(t.children.map(n=>[n.id,n])),s=new Map(e.map(n=>[n.id,n])),i=[...o.descriptors,...o.titles??[]].map(n=>n.topology==="legacy"?gt(n,c.get(n.id),s.get(n.id),t.spacing,o.profile,o.contentById):ht(n,c,s,t.spacing,o.profile,o.contentById));return{records:i,items:i.map(xt),plotById:s}}function Dt(t,e,o,c){const s=t.materializationConfigs.textMetrics,{records:i,items:n,plotById:r}=bt(e,o,c);c.headers.mode==="legacy"?yt(n,e,r,s,c.contentById):wt(i,n,e,s,r,c.contentById);const f=ct(t.compositionSpec.id);return t.createGraphics({id:f,type:"collection",parent:"canvas"}).editGraphics({target:f,property:"items",value:n})}export{T as createDefaultFacetHeaders,ct as facetHeaderGraphicId,Dt as materializeFacetHeaders,j as normalizeFacetHeadersConfig,Rt as prepareFacetHeaders,y as resolveFacetHeaderConfig,bt as resolveFacetHeaderItems,ut as retainedFacetGuideIds};
+import{resolveLegendTitleText as x}from"../layout/legendText.js";import{measureFacetContentChildren as _}from"./facetContentBounds.js";import{facetAxisMode as U,hasOuterFacetAxes as K}from"../core/facetAxisPolicy.js";import{isPlainObject as F}from"../core/immutable.js";import{formatVisibleText as N,resolveTextBounds as T,textBoundsIntersect as v}from"../core/textMetrics.js";import{validateFacetHeaderRotations as Y}from"../grammar/facetHeaders.js";import{resolveDisplayLabel as Z}from"../grammar/displayLabels.js";import{resolveGraphicBounds as B}from"../layout/canvas.js";import{unionConcreteGraphicBounds as J}from"../grammar/schemas/graphicBounds.js";import{intersectClipBounds as Q}from"../grammar/schemas/graphicClip.js";import{DEFAULT_COLORS as X,DEFAULT_FONT_FAMILY as tt}from"../theme/defaults.js";import{prepareFacetHeaderTitles as et}from"../layout/facetHeaderTitles.js";import{cartesianAxisOwners as nt,axisGraphicIds as j}from"../selectors/axes.js";import{resolveFacetOuterSides as ot}from"../grammar/facets/guides.js";import{resolveConcreteGraphicBounds as it}from"../grammar/schemas/graphicBounds.js";import{allLegendGraphicIds as ct}from"./guides/resources.js";const st=Object.freeze(["top","right","bottom","left"]),C=Object.freeze({top:0,right:0,bottom:0,left:0});function rt(t){return`${t}-headers`}function H(){return{mode:"legacy",common:{fontSize:12,fontFamily:tt,fontWeight:600,color:X.strongText,offset:10,align:"center"},row:{side:"left"},column:{side:"top"}}}function O(t){if(!F(t))throw new TypeError("Facet headers config must be a plain object.");if(Y(t),t.common===void 0&&t.mode===void 0)return{...H(),common:{...H().common,...t}};if(!["legacy","roles"].includes(t.mode)||!F(t.common)||!F(t.row)||!F(t.column))throw new Error("Facet headers config must contain canonical mode and role objects.");return{mode:t.mode,common:{...t.common},row:{...t.row},column:{...t.column}}}function w(t,e){const n=O(t);return e==="all"?{...n.common}:{...n.common,...n[e]}}function S(t,e){return Z(t,e.labelMap,N)}function ft(t){return new Map((t.facet.grid?.cells??[]).map(e=>[e.id,e]))}function G(t,e){const n=t.compositionSpec,c=w(e,"all"),s=ft(n);return n.children.map((o,i)=>{const r=s.get(o),a=r===void 0?S(n.facet.values[i],c):`${S(r.rowValue,c)} \xB7 ${S(r.columnValue,c)}`;return{topology:"legacy",role:"column",id:o,text:a,config:c,value:r===void 0?n.facet.values[i]:void 0}})}function R(t,e){const n=e==="column"?"column":"row",c=e==="column"?"columnValue":"rowValue",s=new Map;for(const o of t.facet.grid.cells){const i=s.get(o[n]);if(i===void 0)s.set(o[n],{coordinate:o[n],value:o[c],ids:[o.id]});else{if(i.value!==o[c])throw new Error(`Facet ${e} header values conflict at coordinate ${o[n]}.`);i.ids.push(o.id)}}return[...s.values()].sort((o,i)=>o.coordinate-i.coordinate)}function L(t,e){const n=t.compositionSpec,c=w(e,"column");if(n.facet.grid===void 0)return n.children.map((r,a)=>({topology:"cell-column",role:"column",id:r,ids:[r],row:Math.floor(a/n.columns),column:a%n.columns,value:n.facet.values[a],text:S(n.facet.values[a],c),config:c}));const s=w(e,"row"),o=R(n,"column").map(r=>({topology:"grid-column",role:"column",ids:r.ids,coordinate:r.coordinate,value:r.value,text:S(r.value,c),config:c})),i=R(n,"row").map(r=>({topology:"grid-row",role:"row",ids:r.ids,coordinate:r.coordinate,value:r.value,text:S(r.value,s),config:s}));return[...o,...i]}function y(t){return t.rotation!==void 0&&t.rotation!==0}function D(t,e){return T({x:0,y:0,text:t.text,lines:x(t.text,t.config,e).lines,...t.config,textAlign:"center",textBaseline:"middle"},e)}function at(t,e,n){if(y(t.config)){const c=D(t,n);return["left","right"].includes(e)?c.right-c.left:c.bottom-c.top}return["left","right"].includes(e)?x(t.text,t.config,n).width:t.text.includes(`
+`)?x(t.text,t.config,n).height:t.config.fontSize}function lt(t){const e={...C};if(!["plot","content"].includes(t.compositionSpec.spacing))return e;for(const n of t.compositionSpec.children){const c=t.children[n],s=B(c),o=c.graphicSpec.objects.canvas.properties;e.left=Math.max(e.left,s.x),e.top=Math.max(e.top,s.y),e.right=Math.max(e.right,o.width-s.x-s.width),e.bottom=Math.max(e.bottom,o.height-s.y-s.height)}return e}function E(t,e,n,c,s){const o=at(t,e,n)+t.config.offset+(t.clearance?.[e]??0);return y(t.config)&&s?Math.max(0,o-c[e]):o}function dt(t,e,n){if(!e.some(i=>["content","view"].includes(i.config.anchor)))return;if(!["plot","content"].includes(t.compositionSpec.spacing))throw new Error("Facet header content anchor requires plot spacing or content spacing.");const c=new Map,s=e.some(i=>i.config.anchor==="view")?new Map(_(t).map(i=>[i.id,i])):void 0;for(const i of t.compositionSpec.children){const r=t.children[i],a=B(r),d={left:a.x,right:a.x+a.width,top:a.y,bottom:a.y+a.height},l=r.semanticSpec.layers.map(u=>u.id).filter(u=>r.graphicSpec.objects[u]!==void 0),p=J(r.graphicSpec,l,n),f=r.graphicSpec.objects.canvas.properties,m=p===void 0?void 0:Q(p,{left:0,right:f.width,top:0,bottom:f.height});c.set(i,m===void 0||m.left>m.right||m.top>m.bottom?d:A([d,m]))}const o=s===void 0?void 0:new Map([...s].map(([i,r])=>[i,{left:r.bounds.left+r.plot.x,right:r.bounds.right+r.plot.x,top:r.bounds.top+r.plot.y,bottom:r.bounds.bottom+r.plot.y}]));for(const i of e)if(["content","view"].includes(i.config.anchor)){i.config.anchor==="view"&&(i.contentById=o),i.clearance={...C};for(const r of i.ids??[i.id]){const a=B(t.children[r]),d=(i.contentById??c).get(r);for(const[l,p]of Object.entries({left:a.x-d.left,right:d.right-a.x-a.width,top:a.y-d.top,bottom:d.bottom-a.y-a.height}))i.clearance[l]=Math.max(i.clearance[l],p)}}return c}function k(t,e,n,c){const s=t.filter(o=>o.role===e&&o.text!=="");return s.length===0?0:Math.max(...s.map(o=>E(o,o.config.side,n,c,!0)))}function ut(t,e){const n=t.compositionSpec,c=t.children[e],s=K(n.facet.guides.axes)?ot({placements:n.facet.grid?.cells??n.children.map((i,r)=>({id:i,row:Math.floor(r/n.columns),column:r%n.columns}))}):void 0,o=nt(c).flatMap(i=>j(i.channel,i.id).filter((r,a)=>a>=2&&(s===void 0||U(n.facet.guides.axes,i.channel)==="each"||s[i.config?.[["line","ticks","labels","title"][a]]?.position]?.includes(e))));for(const i of["theta","radius","parallel"])c.guideConfigs.axis?.[i]!==void 0&&o.push(...j(i).slice(2));return n.facet.guides.legend===!1&&o.push(...ct(Object.keys(c.guideConfigs.legend??{}))),o.filter(i=>c.graphicSpec.objects[i]!==void 0)}function mt(t,e){const n=t.children[e],c=B(n),s=ut(t,e).map(o=>it(n.graphicSpec,o,n.materializationConfigs.textMetrics)).filter(Boolean);return{top:Math.max(0,...s.map(o=>c.y-o.top)),bottom:Math.max(0,...s.map(o=>o.bottom-c.y-c.height)),left:Math.max(0,...s.map(o=>c.x-o.left)),right:Math.max(0,...s.map(o=>o.right-c.x-c.width))}}function Dt(t,e){const n=O(e),c=n.mode==="legacy"?G(t,n):L(t,n),s=t.compositionSpec.facet.grid===void 0?Math.ceil(t.compositionSpec.children.length/t.compositionSpec.columns):Math.max(...t.compositionSpec.facet.grid.cells.map(f=>f.row))+1,o=t.materializationConfigs.textMetrics,i=["column",...t.compositionSpec.facet.grid===void 0?[]:["row"]].map(f=>[f,w(n,f)]),r=i.some(([,f])=>f.title!==void 0);if(["plot","content"].includes(t.compositionSpec.spacing)){const f=new Map(t.compositionSpec.children.map(m=>[m,mt(t,m)]));for(const m of c)m.clearance=Object.fromEntries(st.map(u=>{const h=Math.max(0,...(m.ids??[m.id]).map(g=>f.get(g)[u]));return[u,h>m.config.offset?h:0]}))}const a=dt(t,c,o),d=r||c.some(f=>y(f.config))?lt(t):C,l={outer:{...C},cellRows:{top:Array(s).fill(0),bottom:Array(s).fill(0)}};if(n.mode==="legacy"&&["plot","content"].includes(t.compositionSpec.spacing))for(const f of c){if(f.text==="")continue;const m=t.compositionSpec.children.indexOf(f.id),u=t.compositionSpec.facet.grid?.cells[m]?.row??Math.floor(m/t.compositionSpec.columns);l.cellRows.top[u]=Math.max(l.cellRows.top[u],E(f,"top",o,d,u===0))}if(n.mode==="roles"){const f=w(n,"column"),m=k(c,"column",o,d);if(t.compositionSpec.facet.grid===void 0){const u=["left","right"].includes(f.side);u&&(l.cellColumns={left:Array(t.compositionSpec.columns).fill(0),right:Array(t.compositionSpec.columns).fill(0)});for(const h of c)if(h.text!==""){const g=u?l.cellColumns:l.cellRows,M=u?h.column:h.row,P=u?t.compositionSpec.columns-1:s-1,W=["top","left"].includes(f.side)?M===0:M===P;g[f.side][M]=Math.max(g[f.side][M],E(h,f.side,o,d,W))}}else{l.outer[f.side]=m;const u=w(n,"row");l.outer[u.side]=k(c,"row",o,d)}}const p=et({roles:i,descriptors:c,space:d,headerLayout:l,profile:o,ids:t.compositionSpec.children});return{headers:n,descriptors:c,titles:p,headerLayout:l,...a===void 0?{}:{contentById:a},...(r||c.some(f=>y(f.config)))&&o!==void 0?{profile:o}:{}}}function $(t,e){return e==="start"?{x:t.left,textAlign:"left"}:e==="end"?{x:t.right,textAlign:"right"}:{x:(t.left+t.right)/2,textAlign:"center"}}function ht(t,e){return e==="start"?{y:t.top,textBaseline:"top"}:e==="end"?{y:t.bottom,textBaseline:"bottom"}:{y:(t.top+t.bottom)/2,textBaseline:"middle"}}function A(t){return{left:Math.min(...t.map(e=>e.left)),right:Math.max(...t.map(e=>e.right)),top:Math.min(...t.map(e=>e.top)),bottom:Math.max(...t.map(e=>e.bottom))}}function b(t,e){return{left:t.x+e.x,right:t.x+e.x+e.width,top:t.y+e.y,bottom:t.y+e.y+e.height}}function I(t){return{left:t.x,right:t.x+t.width,top:t.y,bottom:t.y+t.height}}function z(t,e){return{left:t.x+e.left,right:t.x+e.right,top:t.y+e.top,bottom:t.y+e.bottom}}function q(t,e,n,c,s){return s==="start"?t-n:s==="end"?e-c:(t+e-n-c)/2}function V(t,e,n,c){const{config:s}=t,o=D(t,c),i={textAlign:"center",textBaseline:"middle",rotation:s.rotation};return["top","bottom"].includes(s.side)?{...i,x:q(e.left,e.right,o.left,o.right,s.align),y:s.side==="top"?n.top-s.offset-o.bottom:n.bottom+s.offset-o.top}:{...i,x:s.side==="left"?n.left-s.offset-o.right:n.right+s.offset-o.left,y:q(e.top,e.bottom,o.top,o.bottom,s.align)}}function pt(t,e,n,c,s,o){o=t.contentById??o;const i=t.ids.map(h=>e.get(h)),r=t.ids.find((h,g)=>i[g]===void 0),a=t.ids.find(h=>n.get(h)===void 0);if(r!==void 0||a!==void 0)throw new Error(`Facet header requires cell and plot bounds for "${r??a}".`);const d=t.ids.map((h,g)=>b(i[g],n.get(h))),l=A(d),p=["content","view"].includes(t.config.anchor)?A(t.ids.map((h,g)=>z(i[g],o.get(h)))):["plot","content"].includes(c)?l:A(i.map(I)),f=t.config;if(y(f)||t.topology==="role-title"){const h=V(t,l,p,s),g=["left","right"].includes(f.side)?"y":"x";return f.alongOffset!==void 0&&(h[g]+=f.alongOffset),{descriptor:t,snapshots:p,properties:h}}const m=["content","view"].includes(f.anchor)?0:t.clearance?.[f.side]??0;let u;if(["top","bottom"].includes(f.side)){u=$(l,f.align);const h=f.side==="top";u.y=h?p.top-m-f.offset-(t.text.includes(`
+`)?x(t.text,f,s).height:f.fontSize)/2:p.bottom+m+f.offset+(t.text.includes(`
+`)?x(t.text,f,s).height:f.fontSize)/2,u.textBaseline="middle"}else{u=ht(l,f.align);const h=f.side==="left";u.x=h?p.left-m-f.offset:p.right+m+f.offset,u.textAlign=h?"right":"left"}return{descriptor:t,snapshots:p,properties:u}}function gt(t,e,n,c,s,o){if(o=t.contentById??o,e===void 0||n===void 0)throw new Error(`Facet header requires cell and plot bounds for "${t.id}".`);const i=["content","view"].includes(t.config.anchor)?z(e,o.get(t.id)):b(e,n);if(y(t.config)&&["plot","content"].includes(c)){const r=b(e,n);return{descriptor:t,snapshots:I(e),properties:V({...t,config:{...t.config,side:"top"}},r,i,s)}}return{descriptor:t,snapshots:I(e),properties:{...$(b(e,n),t.config.align),y:["plot","content"].includes(c)?e.y+n.y-(t.clearance?.top??0)-t.config.offset-(t.text.includes(`
+`)?x(t.text,t.config,s).height:t.config.fontSize)/2:e.y+t.config.offset,textBaseline:"middle",...y(t.config)?{rotation:t.config.rotation}:{}}}}function xt(t){const{config:e}=t.descriptor;return{type:"text",properties:{...t.properties,text:t.descriptor.text,...x(t.descriptor.text,e).lines?{lines:x(t.descriptor.text,e).lines}:{},fill:e.color,fontSize:e.fontSize,fontFamily:e.fontFamily,fontWeight:e.fontWeight}}}function wt(t,e,n,c,s,o){const i=e.map((r,a)=>t[a].descriptor.text===""?void 0:T(r.properties,c));for(const[r,a]of i.entries())if(a!==void 0&&(a.left<-1e-9||a.right>n.width+1e-9||a.top<-1e-9||a.bottom>n.height+1e-9||i.some((d,l)=>l<r&&d!==void 0&&v(d,a))||n.children.some(d=>v(a,o===void 0?["plot","content"].includes(n.spacing)?b(d,s.get(d.id)):I(d):z(d,o.get(d.id))))))throw new Error("Facet role headers require sufficient non-overlapping reserved space.")}function yt(t,e,n,c,s){const o=[];for(let i=0;i<t.length;i+=1){if(t[i].properties.text==="")continue;const r=T(t[i].properties,c),a=e.children[i],d=n.get(a.id);if(r.left<0||r.right>e.width||r.top<0||r.bottom>e.height||o.some(l=>v(l,r))||(["plot","content"].includes(e.spacing)?e.children.some(l=>v(r,s===void 0?b(l,n.get(l.id)):z(l,s.get(l.id)))):v(r,b(a,d))))throw new Error("Facet headers require sufficient non-overlapping space above every child plot.");o.push(r)}}function bt(t,e,n){const c=new Map(t.children.map(i=>[i.id,i])),s=new Map(e.map(i=>[i.id,i])),o=[...n.descriptors,...n.titles??[]].map(i=>i.topology==="legacy"?gt(i,c.get(i.id),s.get(i.id),t.spacing,n.profile,n.contentById):pt(i,c,s,t.spacing,n.profile,n.contentById));return{records:o,items:o.map(xt),plotById:s}}function kt(t,e,n,c){const s=t.materializationConfigs.textMetrics,{records:o,items:i,plotById:r}=bt(e,n,c);c.headers.mode==="legacy"?yt(i,e,r,s,c.contentById):wt(o,i,e,s,r,c.contentById);const a=rt(t.compositionSpec.id);return t.createGraphics({id:a,type:"collection",parent:"canvas"}).editGraphics({target:a,property:"items",value:i})}function $t(t){const e=O(t.materializationConfigs.facets[t.compositionSpec.id].headers),n=e.mode==="legacy"?G(t,e):L(t,e),c=e.mode==="legacy"?[]:["column",...t.compositionSpec.facet.grid?["row"]:[]].flatMap(s=>{const o=w(e,s);return o.title?[{role:s,title:!0,text:o.title.text,config:o}]:[]});return[...n.map(s=>({...s,role:e.mode==="legacy"?"all":s.role})),...c]}export{H as createDefaultFacetHeaders,rt as facetHeaderGraphicId,$t as facetHeaderTextEntries,kt as materializeFacetHeaders,O as normalizeFacetHeadersConfig,Dt as prepareFacetHeaders,w as resolveFacetHeaderConfig,bt as resolveFacetHeaderItems,ut as retainedFacetGuideIds};

package/src/materialization/facets.js

@@ -1 +1 @@
-import{walkGraphicTreeEvents as P}from"../grammar/schemas/graphicTree.js";import{measureFacetContentChildren as E}from"./facetContentBounds.js";import{measureFacetContentChildren as It}from"./facetContentBounds.js";import{resolveFacetContentFlow as O,resolveFacetContentFooters as H}from"../layout/facetContentFlow.js";import{resolveConcreteGraphicBounds as G}from"../grammar/schemas/graphicBounds.js";import{textBoundsFitCanvas as $,textBoundsIntersect as S,resolveTextBounds as I}from"../core/textMetrics.js";import{resolveGraphicBounds as C}from"../layout/canvas.js";import{resolvePlacedPlotBounds as R}from"../layout/composition.js";import{alignedTextAnchor as A,alignedTitleAnchor as _,buildTitleReadingBlock as q,paintedTitleComponent as D,resolveTitleComponentBounds as W,titleTextProperties as N}from"../layout/title.js";import{resolveFacetLayout as k}from"../layout/facets.js";import{assertFacetTopLane as Z}from"./facetTopLane.js";import{namespaceGraphicId as j,namespaceGraphicSnapshot as J}from"./compositionSnapshot.js";import{prepareSharedFacetLegend as T}from"./facetGuides/index.js";import{resolvePromotedFacetLegendLayout as K}from"./facetGuides/layout.js";import{attachSnapshotObject as Q,clearCompositionChildren as U,compositionChildDescriptor as V}from"./composition.js";import{materializeFacetHeaders as X,resolveFacetHeaderItems as Y,prepareFacetHeaders as tt,facetHeaderGraphicId as F,retainedFacetGuideIds as et}from"./facetHeaders.js";const ot={top:0,right:0,bottom:0,left:0},L=Object.freeze(["chartTitle","chartSubtitle"]);function it(t){const c=t.materializationConfigs.facets?.[t.compositionSpec.id];if(c===void 0)throw new Error(`Facet "${t.compositionSpec.id}" requires materialization config.`);return c}function nt(t){if(t.semanticSpec.title.text===void 0)return{height:0};const c=t.titleConfig;if(c===void 0)throw new Error("Facet title requires chart title configuration.");const e=q({text:t.semanticSpec.title.text,subtitle:t.semanticSpec.title.subtitle},c,t.materializationConfigs.textMetrics),i=8+c.offset;if(i<0)throw new Error("Facet parent title offset places text outside the Canvas.");const h=Math.ceil(i+e.height);return{config:c,block:e,top:i,reservation:h,height:c.position==="top"?h:0}}function z(t,c,e,i,h,f,n){if(e.length===0)return t;const{config:s,block:o,top:a}=n,d=t.graphicSpec.objects.canvas.properties,p=["top","bottom"].includes(s.position),u=D(p?{x:A(f.x,f.width,s.align)+(s.alongOffset??0),y:i.map(m=>(s.position==="top"?a:d.height-a-o.height)+m),lines:e,textAlign:s.align,...s.position==="bottom"?{rotation:0,explicitRotation:!0}:{}}:{x:i.map(m=>s.position==="left"?a+m:d.width-a-m),y:_(f.y,f.height,o.width,s.align)+(s.alongOffset??0),lines:e,textAlign:"center",rotation:s.position==="left"?-Math.PI/2:Math.PI/2,explicitRotation:!0}),w=W(u,h,t.materializationConfigs.textMetrics);if(!$(w,t.graphicSpec.objects.canvas.properties))throw new Error("Facet parent title places text outside the Canvas.");const v=u.lines.length;let l=t.createGraphics({id:c,type:"text",...v>1?{length:v}:{},parent:"canvas"});for(const[m,x]of Object.entries({...N(u,h),...u.explicitRotation?{rotation:u.rotation}:{}}))l=l.editGraphics({target:c,property:m,value:x});return l}function ct(t,c,e){let i=z(t,L[0],e.block.titleLines,e.block.titleCenters,e.config.titleStyle,c,e);return e.block.subtitleLines.length>0&&(i=z(i,L[1],e.block.subtitleLines,e.block.subtitleCenters,e.config.subtitleStyle,c,e)),i}function st(t,c,e){const i=t.compositionSpec,h=c.plots,f={spacing:"content",children:c.children.map((r,g)=>({...r,x:0,y:0,row:Math.floor(g/i.columns),column:g%i.columns}))},{records:n,items:s}=Y(f,h,e),o=n.flatMap((r,g)=>{const b=r.descriptor;return b.topology==="role-title"||b.ids?.length>1?[]:[{...s[g],ownerId:b.id??b.ids[0]}]}),a=E(t,{headerItems:o}),d=O({children:a,columns:i.columns,gap:i.gap}),p=new Map(a.map(r=>[r.id,r])),u=new Map(d.children.map(r=>[r.column,r])),w=H({flow:d,footers:[...u.values()].filter(r=>p.get(r.id).footerBounds!==void 0).map(r=>({id:r.id,column:r.column}))}),v=new Map(w.map(r=>[r.ownerId,r])),l={...d.bounds};for(const r of w){const g=p.get(r.ownerId),b=g.footerBounds,y=r.y-g.plot.height;l.left=Math.min(l.left,r.x+b.left),l.right=Math.max(l.right,r.x+b.right),l.top=Math.min(l.top,y+b.top),l.bottom=Math.max(l.bottom,y+b.bottom)}const m=k({...c,spacing:"canvas",topLane:void 0,children:[{id:"packed",width:l.right-l.left,height:l.bottom-l.top}],columns:1,gap:0,headerLayout:{outer:e.headerLayout.outer},plots:void 0}),x=m.children[0].x-l.left,B=m.children[0].y-l.top;return{...m,spacing:"content",columns:d.columns,rows:Math.ceil(d.children.length/d.columns),gap:i.gap,children:d.children.map(r=>{const g=p.get(r.id),y=t.children[r.id].graphicSpec.objects.canvas.properties,M=v.get(r.id);return{id:r.id,row:r.row,column:r.column,x:x+r.x-g.plot.x,y:B+r.y-g.plot.y,width:y.width,height:y.height,...M===void 0?{}:{footerShift:M.y-r.y-g.plot.height}}})}}function rt(t,c){if(t._assertCompositionProgram("resolveFacetProgramLayout"),t.compositionSpec.type!=="facet")throw new Error("resolveFacetProgramLayout requires a facet composition.");c??=T(t);const e=nt(t),i=t.compositionSpec,h=tt(t,it(t).headers),f=new Map((i.facet.grid?.cells??[]).map(p=>[p.id,p])),n={...i.padding};e.config&&e.config.position!=="top"&&(n[e.config.position]+=e.reservation);const s={children:i.children.map((p,u)=>({...V(p,t.children[p]),value:i.facet.values[u],...f.has(p)?{row:f.get(p).row,column:f.get(p).column}:{}})),spacing:i.spacing,topLane:i.topLane,plots:i.children.map(p=>({id:p,...C(t.children[p])})),columns:i.columns,gap:i.gap,align:i.align,padding:n,titleHeight:e.height,headerLayout:h.headerLayout,sharedLegend:i.facet.guides.legend==="shared"&&c?.mode!=="promoted",...c===void 0?{}:{sharedLegendGap:c.reservation.gap,sharedLegendWidth:c.reservation.width,sharedLegendHeight:c.reservation.height,sharedLegendPosition:c.reservation.position}};let o=i.spacing==="content"?st(t,s,h):k(s);const a=i.children.map(p=>({id:p,...C(t.children[p])}));let d=R({placements:o.children,plots:a});return{layout:o,plot:d}=K(t,{layout:o,plot:d,plots:a,title:e,preparedHeaders:h,prepared:c}),{layout:o,title:e,plot:d,plots:a,preparedHeaders:h}}function at(t,c,e){const i=[],h=c.children.map((n,s)=>({id:n.id,left:n.x+e[s].x,right:n.x+e[s].x+e[s].width,top:n.y+e[s].y,bottom:n.y+e[s].y+e[s].height}));for(const n of c.children){const s=et(t,n.id);for(const o of s){const a=j(`${t.compositionSpec.id}-${n.id}`,o);if(t.graphicSpec.objects[a]===void 0)continue;const d=G(t.graphicSpec,a,t.materializationConfigs.textMetrics);d!==void 0&&i.push({owner:n.id,bounds:d})}}const f=t.graphicSpec.objects[F(t.compositionSpec.id)];for(const n of f?.items??[])n.properties.text!==""&&i.push({owner:"headers",bounds:I(n.properties,t.materializationConfigs.textMetrics)});for(let n=0;n<i.length;n+=1){const s=i[n];if(h.some(o=>o.id!==s.owner&&S(s.bounds,o))||i.slice(0,n).some(o=>o.owner!==s.owner&&S(s.bounds,o.bounds)))throw new Error("Plot spacing gap is too small for the retained facet guides or headers.")}}function dt(t,c){if(c.titles.length===0)return;const e=F(t.compositionSpec.id),i=t.materializationConfigs.textMetrics,h=t.graphicSpec.objects[e].items.slice(c.descriptors.length).map(n=>I(n.properties,i)),f=n=>{if((n.ownerId??n.id)===e)return;const s=n.object.type??n.owner?.type,o=n.object.properties;if(s!=="text"||o?.text===""||o?.opacity===0)return;const a=G(t.graphicSpec,n.id,i);if(a!==void 0&&h.some(d=>S(d,a)))throw new Error("Facet field title overlaps retained chart text.")};P(t.graphicSpec,{enter:f,item:f})}function Lt(t){const c=T(t),{layout:e,title:i,plot:h,plots:f,preparedHeaders:n}=rt(t,c),s=t.graphicSpec.objects.canvas?.properties?.background??"white";let o=U(t);o.graphicSpec.objects.canvas===void 0&&(o=o.createGraphics({id:"canvas",type:"canvas"}));for(const[a,d]of Object.entries({width:e.width,height:e.height,background:s}))o=o.editGraphics({target:"canvas",property:a,value:d});for(const a of e.children){const d=t.children[a.id],p=J(d.graphicSpec,{namespace:`${t.compositionSpec.id}-${a.id}`,x:a.x,y:a.y});if(o=Q(o,p,p.order[0],"canvas"),["plot","content"].includes(e.spacing)){const u=p.order[0],w=j(`${t.compositionSpec.id}-${a.id}`,"plot-background"),v=C(d),l=o.graphicSpec.objects[u].children?.[0];o=o.editGraphics({target:u,property:"background",value:"transparent"}).createGraphics({id:w,type:"rect",parent:u,...l===void 0?{}:{before:l}});for(const[m,x]of Object.entries({...v,stroke:"none",strokeWidth:0,fill:d.graphicSpec.objects.canvas.properties.background??"transparent"}))o=o.editGraphics({target:w,property:m,value:x})}}return o=X(o,e,f,n),o=o.composeFacetGuides({layout:e,plot:h}),e.spacing==="plot"&&at(o,e,f),i.config&&(o=ct(o,h,i)),dt(o,n),Z(o,{layout:e,plots:f,headerId:F(t.compositionSpec.id),titleIds:L}),o._withCanvasConfig({margin:ot,size:{width:"auto",height:"auto"}})}export{Lt as materializeFacetGraphics,It as measureFacetContentChildren,rt as resolveFacetProgramLayout};
+import{compositionTitleLayout as B,materializeCompositionTitle as P}from"./compositionTitle.js";import{restoreLegendItemsOffset as T,applyLegendItemsOffset as O}from"./legendItemsOffset.js";import{walkGraphicTreeEvents as E}from"../grammar/schemas/graphicTree.js";import{measureFacetContentChildren as H}from"./facetContentBounds.js";import{measureFacetContentChildren as Fe}from"./facetContentBounds.js";import{resolveFacetContentFlow as $,resolveFacetContentFooters as _}from"../layout/facetContentFlow.js";import{resolveConcreteGraphicBounds as I}from"../grammar/schemas/graphicBounds.js";import{textBoundsIntersect as x,resolveTextBounds as G}from"../core/textMetrics.js";import{resolveGraphicBounds as F}from"../layout/canvas.js";import{resolvePlacedPlotBounds as q}from"../layout/composition.js";import{resolveFacetLayout as M}from"../layout/facets.js";import{assertFacetTopLane as D}from"./facetTopLane.js";import{namespaceGraphicId as j,namespaceGraphicSnapshot as R}from"./compositionSnapshot.js";import{prepareSharedFacetLegend as z}from"./facetGuides/index.js";import{resolvePromotedFacetLegendLayout as W}from"./facetGuides/layout.js";import{attachSnapshotObject as A,clearCompositionChildren as N,compositionChildDescriptor as Z}from"./composition.js";import{materializeFacetHeaders as J,resolveFacetHeaderItems as K,prepareFacetHeaders as Q,facetHeaderGraphicId as C,retainedFacetGuideIds as U}from"./facetHeaders.js";const V={top:0,right:0,bottom:0,left:0},X=Object.freeze(["chartTitle","chartSubtitle"]);function Y(e){const c=e.materializationConfigs.facets?.[e.compositionSpec.id];if(c===void 0)throw new Error(`Facet "${e.compositionSpec.id}" requires materialization config.`);return c}function ee(e,c,s){const n=e.compositionSpec,f=c.plots,l={spacing:"content",children:c.children.map((i,u)=>({...i,x:0,y:0,row:Math.floor(u/n.columns),column:u%n.columns}))},{records:o,items:r}=K(l,f,s),t=o.flatMap((i,u)=>{const m=i.descriptor;return m.topology==="role-title"||m.ids?.length>1?[]:[{...r[u],ownerId:m.id??m.ids[0]}]}),p=H(e,{headerItems:t}),a=$({children:p,columns:n.columns,gap:n.gap}),d=new Map(p.map(i=>[i.id,i])),g=new Map(a.children.map(i=>[i.column,i])),w=_({flow:a,footers:[...g.values()].filter(i=>d.get(i.id).footerBounds!==void 0).map(i=>({id:i.id,column:i.column}))}),v=new Map(w.map(i=>[i.ownerId,i])),h={...a.bounds};for(const i of w){const u=d.get(i.ownerId),m=u.footerBounds,b=i.y-u.plot.height;h.left=Math.min(h.left,i.x+m.left),h.right=Math.max(h.right,i.x+m.right),h.top=Math.min(h.top,b+m.top),h.bottom=Math.max(h.bottom,b+m.bottom)}const y=M({...c,spacing:"canvas",topLane:void 0,children:[{id:"packed",width:h.right-h.left,height:h.bottom-h.top}],columns:1,gap:0,headerLayout:{outer:s.headerLayout.outer},plots:void 0}),S=y.children[0].x-h.left,k=y.children[0].y-h.top;return{...y,spacing:"content",columns:a.columns,rows:Math.ceil(a.children.length/a.columns),gap:n.gap,children:a.children.map(i=>{const u=d.get(i.id),b=e.children[i.id].graphicSpec.objects.canvas.properties,L=v.get(i.id);return{id:i.id,row:i.row,column:i.column,x:S+i.x-u.plot.x,y:k+i.y-u.plot.y,width:b.width,height:b.height,...L===void 0?{}:{footerShift:L.y-i.y-u.plot.height}}})}}function te(e,c){if(e._assertCompositionProgram("resolveFacetProgramLayout"),e.compositionSpec.type!=="facet")throw new Error("resolveFacetProgramLayout requires a facet composition.");c??=z(e);const s=B(e),n=e.compositionSpec,f=Q(e,Y(e).headers),l=new Map((n.facet.grid?.cells??[]).map(d=>[d.id,d])),o={...n.padding};s.config&&s.config.position!=="top"&&(o[s.config.position]+=s.reservation);const r={children:n.children.map((d,g)=>({...Z(d,e.children[d]),value:n.facet.values[g],...l.has(d)?{row:l.get(d).row,column:l.get(d).column}:{}})),spacing:n.spacing,topLane:n.topLane,plots:n.children.map(d=>({id:d,...F(e.children[d])})),columns:n.columns,gap:n.gap,align:n.align,padding:o,titleHeight:s.height,headerLayout:f.headerLayout,sharedLegend:n.facet.guides.legend==="shared"&&c?.mode!=="promoted",...c===void 0?{}:{sharedLegendGap:c.reservation.gap,sharedLegendWidth:c.reservation.width,sharedLegendHeight:c.reservation.height,sharedLegendPosition:c.reservation.position}};let t=n.spacing==="content"?ee(e,r,f):M(r);const p=n.children.map(d=>({id:d,...F(e.children[d])}));let a=q({placements:t.children,plots:p});return{layout:t,plot:a}=W(e,{layout:t,plot:a,plots:p,title:s,preparedHeaders:f,prepared:c}),{layout:t,title:s,plot:a,plots:p,preparedHeaders:f}}function oe(e,c,s){const n=[],f=c.children.map((o,r)=>({id:o.id,left:o.x+s[r].x,right:o.x+s[r].x+s[r].width,top:o.y+s[r].y,bottom:o.y+s[r].y+s[r].height}));for(const o of c.children){const r=U(e,o.id);for(const t of r){const p=j(`${e.compositionSpec.id}-${o.id}`,t);if(e.graphicSpec.objects[p]===void 0)continue;const a=I(e.graphicSpec,p,e.materializationConfigs.textMetrics);a!==void 0&&n.push({owner:o.id,bounds:a})}}const l=e.graphicSpec.objects[C(e.compositionSpec.id)];for(const o of l?.items??[])o.properties.text!==""&&n.push({owner:"headers",bounds:G(o.properties,e.materializationConfigs.textMetrics)});for(let o=0;o<n.length;o+=1){const r=n[o];if(f.some(t=>t.id!==r.owner&&x(r.bounds,t))||n.slice(0,o).some(t=>t.owner!==r.owner&&x(r.bounds,t.bounds)))throw new Error("Plot spacing gap is too small for the retained facet guides or headers.")}}function ie(e,c){if(c.titles.length===0)return;const s=C(e.compositionSpec.id),n=e.materializationConfigs.textMetrics,f=e.graphicSpec.objects[s].items.slice(c.descriptors.length).map(o=>G(o.properties,n)),l=o=>{if((o.ownerId??o.id)===s)return;const r=o.object.type??o.owner?.type,t=o.object.properties;if(r!=="text"||t?.text===""||t?.opacity===0)return;const p=I(e.graphicSpec,o.id,n);if(p!==void 0&&f.some(a=>x(a,p)))throw new Error("Facet field title overlaps retained chart text.")};E(e.graphicSpec,{enter:l,item:l})}function ve(e){e=T(e);const c=z(e),{layout:s,title:n,plot:f,plots:l,preparedHeaders:o}=te(e,c),r=e.graphicSpec.objects.canvas?.properties?.background??"white";let t=N(e);t.graphicSpec.objects.canvas===void 0&&(t=t.createGraphics({id:"canvas",type:"canvas"}));for(const[p,a]of Object.entries({width:s.width,height:s.height,background:r}))t=t.editGraphics({target:"canvas",property:p,value:a});for(const p of s.children){const a=e.children[p.id],d=R(a.graphicSpec,{namespace:`${e.compositionSpec.id}-${p.id}`,x:p.x,y:p.y});if(t=A(t,d,d.order[0],"canvas"),["plot","content"].includes(s.spacing)){const g=d.order[0],w=j(`${e.compositionSpec.id}-${p.id}`,"plot-background"),v=F(a),h=t.graphicSpec.objects[g].children?.[0];t=t.editGraphics({target:g,property:"background",value:"transparent"}).createGraphics({id:w,type:"rect",parent:g,...h===void 0?{}:{before:h}});for(const[y,S]of Object.entries({...v,stroke:"none",strokeWidth:0,fill:a.graphicSpec.objects.canvas.properties.background??"transparent"}))t=t.editGraphics({target:w,property:y,value:S})}}return t=J(t,s,l,o),t=t.composeFacetGuides({layout:s,plot:f}),s.spacing==="plot"&&oe(t,s,l),n.config&&(t=P(t,f,n)),ie(t,o),D(t,{layout:s,plots:l,headerId:C(e.compositionSpec.id),titleIds:X}),O(t)._withCanvasConfig({margin:V,size:{width:"auto",height:"auto"}})}export{ve as materializeFacetGraphics,Fe as measureFacetContentChildren,te as resolveFacetProgramLayout};

package/src/materialization/guides/layout.js

@@ -1 +1 @@
-import{resetLegendClipGraphics as p,hasLegendClipGraphics as u}from"../legendClip.js";import{localLegendPosition as m}from"../legendGroups.js";import{needsLegendAxisReflow as h,needsSideLegendAxisReflow as x}from"./resources.js";import{getErrorDetails as v}from"../../core/diagnostics.js";import{planCanvasRematerialization as C}from"../layout.js";import{applyMaterializationPlan as L}from"../planner.js";import{assertGuideCollisionBlocks as G}from"../../layout/guideCollisions.js";import{resolveGuideCollisionBlocks as w}from"./resources.js";import{hasPlotUnderlays as g}from"../plotDrawOrder.js";import{resolveGuideCollisionBlocks as M}from"./resources.js";function _(i,l,a){const t=a(i._withContext({pendingRelativeTitleAxis:l})),{pendingRelativeTitleAxis:e,...s}=t.context;return Object.hasOwn(i.context,"pendingRelativeTitleAxis")&&(s.pendingRelativeTitleAxis=i.context.pendingRelativeTitleAxis),t._clone({context:s})}function y(i,l){if(i.context.deferGuideLayoutValidation===!0)return l(i);const a=i.materializationConfigs.canvas?.plot;let t=i.materializationConfigs.canvas?.margin,e;for(let f=0;;f+=1)try{let n=p(i)._withContext({deferGuideLayoutValidation:!0});f>0&&(n=n.editGraphics({target:"canvas",property:"width",value:a.width+t.left+t.right}).editGraphics({target:"canvas",property:"height",value:a.height+t.top+t.bottom})._withCanvasConfig({...n.materializationConfigs.canvas,margin:t}),n=L(n,C(n))),e=l(n),u(i)&&!u(e)&&Object.values(e.guideConfigs.legend??{}).some(o=>o.clipHeight!==void 0)&&(e=e.rematerializeLegend()),e.compositionSpec===void 0&&x(i,e)&&(e=e.rematerializeLegend()),e.compositionSpec===void 0&&Object.values(e.guideConfigs.legend??{}).some(o=>["left","right"].includes(o.position))&&(e=e.rematerializeSideLegendLane()),e.compositionSpec===void 0&&h(i,e)&&(e=e.rematerializeHorizontalLegendLane()),e.compositionSpec===void 0&&(Object.keys(e.guideConfigs.legendGroups??{}).length>0||Object.values(e.guideConfigs.legend??{}).some(o=>m(o)!==void 0))&&(e=e.rematerializeLegendGroups()),a!==void 0&&e.titleConfig!==void 0&&(e=e.rematerializeTitle()),(g(i)||g(e))&&(e=e.rematerializePlotDrawOrder());break}catch(n){const o=v(n)?.canvasOverflow;if(a===void 0||o===void 0||f>=16)throw n;t=Object.fromEntries(Object.keys(t).map(d=>[d,o[d]>0?Math.ceil((t[d]+o[d])*4)/4:t[d]]))}const{deferGuideLayoutValidation:s,...c}=e.context;Object.hasOwn(i.context,"deferGuideLayoutValidation")&&(c.deferGuideLayoutValidation=i.context.deferGuideLayoutValidation);const r=e._clone({context:c});return G(w(r.graphicSpec,r.guideConfigs,r.titleConfig,r.materializationConfigs.textMetrics)),r}function k(i){return function(l){return y(this,a=>i.call(a,l))}}export{M as resolveGuideCollisionBlocks,y as withGuideLayoutTransaction,k as withGuideLayoutValidation,_ as withPendingRelativeAxisTitle};
+import{restoreGuideVisibilityPaint as x,applyGuideVisibilityPaint as C}from"./visibility.js";import{restoreLegendItemsOffset as v,applyLegendItemsOffset as L}from"../legendItemsOffset.js";import{resetLegendClipGraphics as G,hasLegendClipGraphics as p}from"../legendClip.js";import{localLegendPosition as y}from"../legendGroups.js";import{needsLegendAxisReflow as w,needsSideLegendAxisReflow as O}from"./resources.js";import{getErrorDetails as b}from"../../core/diagnostics.js";import{planCanvasRematerialization as z}from"../layout.js";import{applyMaterializationPlan as j}from"../planner.js";import{assertGuideCollisionBlocks as R}from"../../layout/guideCollisions.js";import{resolveGuideCollisionBlocks as V}from"./resources.js";import{hasPlotUnderlays as m}from"../plotDrawOrder.js";import{resolveGuideCollisionBlocks as K}from"./resources.js";function q(i,r,o){const t=o(i._withContext({pendingRelativeTitleAxis:r})),{pendingRelativeTitleAxis:e,...f}=t.context;return Object.hasOwn(i.context,"pendingRelativeTitleAxis")&&(f.pendingRelativeTitleAxis=i.context.pendingRelativeTitleAxis),t._clone({context:f})}function A(i,r){if(i.context.deferGuideLayoutValidation===!0)return r(i);const o=i.materializationConfigs.canvas?.plot;let t=i.materializationConfigs.canvas?.margin,e;for(let d=0;;d+=1)try{let n=G(v(x(i)))._withContext({deferGuideLayoutValidation:!0});d>0&&(n=n.editGraphics({target:"canvas",property:"width",value:o.width+t.left+t.right}).editGraphics({target:"canvas",property:"height",value:o.height+t.top+t.bottom})._withCanvasConfig({...n.materializationConfigs.canvas,margin:t}),n=j(n,z(n))),e=r(n),p(i)&&!p(e)&&Object.values(e.guideConfigs.legend??{}).some(l=>l.clipHeight!==void 0)&&(e=e.rematerializeLegend()),e.compositionSpec===void 0&&O(i,e)&&(e=e.rematerializeLegend()),e.compositionSpec===void 0&&Object.values(e.guideConfigs.legend??{}).some(l=>["left","right"].includes(l.position))&&(e=e.rematerializeSideLegendLane()),e.compositionSpec===void 0&&w(i,e)&&(e=e.rematerializeHorizontalLegendLane()),e.compositionSpec===void 0&&(Object.keys(e.guideConfigs.legendGroups??{}).length>0||Object.values(e.guideConfigs.legend??{}).some(l=>y(l)!==void 0))&&(e=e.rematerializeLegendGroups()),o!==void 0&&e.titleConfig!==void 0&&(e=e.rematerializeTitle()),(m(i)||m(e))&&(e=e.rematerializePlotDrawOrder()),e=L(e);break}catch(n){const l=b(n),c=l?.canvasOverflow;if(o===void 0||c===void 0||l.requiresExplicitCanvas||d>=16)throw n;t=Object.fromEntries(Object.keys(t).map(s=>[s,c[s]>0?Math.ceil((t[s]+c[s])*4)/4:t[s]]))}const{deferGuideLayoutValidation:f,...u}=e.context;Object.hasOwn(i.context,"deferGuideLayoutValidation")&&(u.deferGuideLayoutValidation=i.context.deferGuideLayoutValidation);const a=e._clone({context:u}),g=a.context.compositionCollectedLegends,h=g?{...a.guideConfigs,legend:Object.fromEntries(Object.entries(a.guideConfigs.legend??{}).filter(([d])=>!g.includes(d)))}:a.guideConfigs;return R(V(a.graphicSpec,h,a.titleConfig,a.materializationConfigs.textMetrics)),C(a)}function U(i){return function(r){return A(this,o=>i.call(o,r))}}export{K as resolveGuideCollisionBlocks,A as withGuideLayoutTransaction,U as withGuideLayoutValidation,q as withPendingRelativeAxisTitle};

package/src/materialization/guides/resources.js

@@ -1 +1 @@
-import{axisGraphicIds as k,selectCartesianAxis as v}from"../../selectors/axes.js";import{localLegendPosition as z,localLegendPlacement as T}from"../legendGroups.js";import{resolveConcreteGraphicBounds as B,unionConcreteGraphicBounds as y}from"../../grammar/schemas/graphicBounds.js";function W(e,i,n){const o=e.context.pendingMaterializationPlan;if(o===void 0)return!1;const t=`edit${i.toUpperCase()}AxisTitle`;return o.steps.slice(o.next).some(r=>r.op===t&&v(e,i,r.args).id===n)}function K(e,i,n,o){const t=[],r=(s,a,u,l)=>{if(u===void 0)return;const b=l.filter(O=>e.objects[O]!==void 0),m=y(e,b,o);m!==void 0&&t.push({id:s,kind:a,position:u,bounds:m})};r("chart title","title",n?.position,["chartTitle","chartSubtitle"]);for(const[s,a]of Object.entries(i.axis??{})){const u=["line","ticks","labels","title"].map(b=>a[b]?.position).find(Boolean),l=["x","y"].includes(s)?s:["top","bottom"].includes(u)?"x":["left","right"].includes(u)?"y":void 0;if(l!==void 0)for(const[b,m]of["line","ticks","labels","title"].entries()){const O=k(l,s)[b],I=t.length;if(r(`${s}-axis ${m}`,"axis",a[m]?.position,[O]),t.length===I)continue;const h=t.at(-1);if(h.axisId=s,h.namedAxis=s!==l,["labels","title"].includes(m)){const G=e.objects[O];h.textBounds=G.items?.map(C=>B(e,C.id,o))??[h.bounds]}}}const c=w(),d=i.legend??{},f=c.find(s=>s.family==="categorical"&&d[s.kind]!==void 0),g=f!==void 0&&d.size!==void 0&&d[f.kind].target===d.size.target&&z(d[f.kind])===void 0&&z(d.size)===void 0&&(d.size.inheritPosition!==!1||d[f.kind].position===d.size.position),p=i.legendGroups??{};for(const[s,a]of Object.entries(p)){const u=c.filter(l=>d[l.kind]?.target===s&&z(d[l.kind])===void 0).flatMap(l=>l.graphicIds);r(`${s} legend group`,"legend",a.placement.position??"free",u)}for(const s of c){const a=d[s.kind];if(p[a?.target]!==void 0&&z(a)===void 0||a===void 0||g&&s.kind==="size")continue;const u=g&&s===f?[...s.graphicIds,...c.find(l=>l.kind==="size").graphicIds]:s.graphicIds;r(`${s.kind}${g&&s===f?"+size":""} legend`,"legend",z(a)??a.position,u)}return t}const L=Object.freeze(["Symbols","SymbolLines","SymbolPoints","SymbolSwatches","Labels","Title","Background"]),j=Object.freeze({colorSize:Object.freeze({semanticKind:"colorSize",family:"sampled",rematerializeOp:void 0,graphicIds:Object.freeze(["colorSizeLegendBackground","colorSizeLegendSymbols","colorSizeLegendLabels","colorSizeLegendTitle"])}),series:Object.freeze({semanticKind:"series",family:"categorical",rematerializeOp:void 0,graphicIds:Object.freeze(L.map(e=>`seriesLegend${e}`))}),color:Object.freeze({semanticKind:"color",family:"categorical",rematerializeOp:void 0,graphicIds:Object.freeze(L.map(e=>`colorLegend${e}`))}),stroke:Object.freeze({semanticKind:"stroke",family:"categorical",rematerializeOp:void 0,graphicIds:Object.freeze(L.map(e=>`strokeLegend${e}`))}),size:Object.freeze({semanticKind:"size",family:"size",rematerializeOp:"rematerializeSizeLegend",graphicIds:Object.freeze(["sizeLegendBackground","sizeLegendSymbols","sizeLegendLabels","sizeLegendTitle"])}),gradient:Object.freeze({semanticKind:"color",family:"continuous",rematerializeOp:"rematerializeGradientLegend",graphicIds:Object.freeze(["colorGradientBackground","colorGradientStrips","colorGradientTicks","colorGradientSymbols","colorGradientLabels","colorGradientTitle"])}),interval:Object.freeze({semanticKind:"color",family:"interval",rematerializeOp:"rematerializeIntervalLegend",graphicIds:Object.freeze(["colorLegendBackground","colorLegendSymbols","colorLegendLabels","colorLegendTitle"])}),strokeGradient:Object.freeze({semanticKind:"stroke",family:"continuous",rematerializeOp:"rematerializeStrokeGradientLegend",graphicIds:Object.freeze(["strokeGradientBackground","strokeGradientStrips","strokeGradientTicks","strokeGradientLabels","strokeGradientTitle"])}),strokeInterval:Object.freeze({semanticKind:"stroke",family:"interval",rematerializeOp:"rematerializeStrokeIntervalLegend",graphicIds:Object.freeze(["strokeIntervalBackground","strokeIntervalSymbols","strokeIntervalLabels","strokeIntervalTitle"])}),opacity:Object.freeze({semanticKind:"opacity",family:"continuous",rematerializeOp:"rematerializeOpacityLegend",graphicIds:Object.freeze(["opacityLegendBackground","opacityLegendSymbols","opacityLegendLabels","opacityLegendTitle"])}),strokeWidth:Object.freeze({semanticKind:"strokeWidth",family:"strokeWidth",rematerializeOp:"rematerializeStrokeWidthLegend",graphicIds:Object.freeze(["strokeWidthLegendBackground","strokeWidthLegendSymbols","strokeWidthLegendLabels","strokeWidthLegendTitle"])})});function P(e){return $(e).graphicIds}function $(e){const i=j[e];if(i===void 0)throw new Error(`Unknown legend graphic kind "${e}".`);return i}function w(){return Object.entries(j).map(([e,i])=>({kind:e,...i}))}function M(e){return[...new Set(e.flatMap(P))]}function x(e){const i=K(e.graphicSpec,e.guideConfigs,void 0,e.materializationConfigs.textMetrics).filter(n=>n.kind==="axis");for(const n of["theta","radius"]){if(e.guideConfigs.axis?.[n]===void 0)continue;const o=k(n).slice(2).filter(r=>e.graphicSpec.objects[r]!==void 0),t=y(e.graphicSpec,o,e.materializationConfigs.textMetrics);if(t!==void 0)for(const r of["left","right","top","bottom"])i.push({id:`${n}-axis text`,kind:"axis",position:r,bounds:t})}return i}function N(e,i,n){if(i.inferredOffset!==!0||!["top","bottom","left","right"].includes(i.position)||i.layout==="legacy-bottom")return i.offset;const o=x(e).filter(r=>r.position===i.position),t=Math.max(0,...o.map(r=>({bottom:r.bounds.bottom-n.y-n.height,top:n.y-r.bounds.top,left:n.x-r.bounds.left,right:r.bounds.right-n.x-n.width})[i.position]));return i.offset+t}function S(e,i,n){if(i!=="size"||n.inheritPosition===!1)return n;const o=["series","color","stroke"].map(t=>e.guideConfigs.legend?.[t]).find(t=>t?.target===n.target);return o===void 0?n:{...n,position:o.position,offset:o.offset,inferredOffset:o.inferredOffset}}function U(e,i){return[e,i].some(o=>Object.entries(o.guideConfigs.legend??{}).some(([t,r])=>{const c=S(o,t,r);return c.inferredOffset===!0&&["top","bottom"].includes(c.position)&&c.layout!=="legacy-bottom"})||Object.values(o.guideConfigs.legendGroups??{}).some(t=>t.inferredOffset===!0&&["top","bottom"].includes(t.placement.position)))&&[e,i].some(o=>x(o).some(t=>["top","bottom"].includes(t.position)))}function _(e,i){const n=new Set;for(const t of[e,i])for(const[r,c]of Object.entries(t.guideConfigs.legend??{})){const d=T(c),f=d===void 0?t.guideConfigs.legendGroups?.[c.target]:void 0,g=S(t,r,c),p=d??f?.placement??g;(d?.inferredOffset??f?.inferredOffset??g.inferredOffset)===!0&&p.at===void 0&&["left","right"].includes(p.position)&&g.layout!=="legacy-bottom"&&n.add(p.position)}const o=t=>JSON.stringify(x(t).filter(r=>n.has(r.position)));return n.size>0&&o(e)!==o(i)}export{M as allLegendGraphicIds,k as axisGraphicIds,S as effectiveLegendOffsetConfig,W as hasPendingAxisTitleRematerialization,P as legendGraphicIds,w as legendResourcePolicies,$ as legendResourcePolicy,U as needsLegendAxisReflow,_ as needsSideLegendAxisReflow,K as resolveGuideCollisionBlocks,N as resolveLegendAxisOffset};
+import{axisGraphicIds as k,selectCartesianAxis as v}from"../../selectors/axes.js";import{localLegendPosition as z,localLegendPlacement as C}from"../legendGroups.js";import{resolveConcreteGraphicBounds as T,unionConcreteGraphicBounds as B}from"../../grammar/schemas/graphicBounds.js";function W(e,t,r){const d=e.context.pendingMaterializationPlan;if(d===void 0)return!1;const i=`edit${t.toUpperCase()}AxisTitle`;return d.steps.slice(d.next).some(n=>n.op===i&&v(e,t,n.args).id===r)}function K(e,t,r,d){const i=[],n=(o,c,u,l)=>{if(u===void 0)return;const b=l.filter(O=>e.objects[O]!==void 0),m=B(e,b,d);m!==void 0&&i.push({id:o,kind:c,position:u,bounds:m})};n("chart title","title",r?.position,["chartTitle","chartSubtitle"]);for(const[o,c]of Object.entries(t.axis??{})){const u=["line","ticks","labels","title"].map(b=>c[b]?.position).find(Boolean),l=["x","y"].includes(o)?o:["top","bottom"].includes(u)?"x":["left","right"].includes(u)?"y":void 0;if(l!==void 0)for(const[b,m]of["line","ticks","labels","title"].entries()){const O=k(l,o)[b],I=i.length;if(n(`${o}-axis ${m}`,"axis",c[m]?.position,[O]),i.length===I)continue;const h=i.at(-1);if(h.axisId=o,h.namedAxis=o!==l,["labels","title"].includes(m)){const S=e.objects[O];h.textBounds=S.items?.map(G=>T(e,G.id,d))??[h.bounds]}}}for(const o of["parallel","theta","radius"])if(t.axis?.[o]!==void 0)for(const c of["left","right","top","bottom"])n(`${o}-axis text`,"axis",c,k(o).slice(2));const a=w(),s=t.legend??{},f=a.find(o=>o.family==="categorical"&&s[o.kind]!==void 0),g=f!==void 0&&s.size!==void 0&&s[f.kind].target===s.size.target&&z(s[f.kind])===void 0&&z(s.size)===void 0&&(s.size.inheritPosition!==!1||s[f.kind].position===s.size.position),p=t.legendGroups??{};for(const[o,c]of Object.entries(p)){const u=a.filter(l=>s[l.kind]?.target===o&&z(s[l.kind])===void 0).flatMap(l=>l.graphicIds);n(`${o} legend group`,"legend",c.placement.position??"free",u)}for(const o of a){const c=s[o.kind];if(p[c?.target]!==void 0&&z(c)===void 0||c===void 0||g&&o.kind==="size")continue;const u=g&&o===f?[...o.graphicIds,...a.find(l=>l.kind==="size").graphicIds]:o.graphicIds;n(`${o.kind}${g&&o===f?"+size":""} legend`,"legend",z(c)??c.position,u)}return i}const L=Object.freeze(["Symbols","SymbolLines","SymbolPoints","SymbolSwatches","Labels","Title","Background"]),j=Object.freeze({colorSize:Object.freeze({semanticKind:"colorSize",family:"sampled",rematerializeOp:void 0,graphicIds:Object.freeze(["colorSizeLegendBackground","colorSizeLegendSymbols","colorSizeLegendLabels","colorSizeLegendTitle"])}),series:Object.freeze({semanticKind:"series",family:"categorical",rematerializeOp:void 0,graphicIds:Object.freeze(L.map(e=>`seriesLegend${e}`))}),color:Object.freeze({semanticKind:"color",family:"categorical",rematerializeOp:void 0,graphicIds:Object.freeze(L.map(e=>`colorLegend${e}`))}),stroke:Object.freeze({semanticKind:"stroke",family:"categorical",rematerializeOp:void 0,graphicIds:Object.freeze(L.map(e=>`strokeLegend${e}`))}),size:Object.freeze({semanticKind:"size",family:"size",rematerializeOp:"rematerializeSizeLegend",graphicIds:Object.freeze(["sizeLegendBackground","sizeLegendSymbols","sizeLegendLabels","sizeLegendTitle"])}),gradient:Object.freeze({semanticKind:"color",family:"continuous",rematerializeOp:"rematerializeGradientLegend",graphicIds:Object.freeze(["colorGradientBackground","colorGradientStrips","colorGradientTicks","colorGradientSymbols","colorGradientLabels","colorGradientTitle"])}),interval:Object.freeze({semanticKind:"color",family:"interval",rematerializeOp:"rematerializeIntervalLegend",graphicIds:Object.freeze(["colorLegendBackground","colorLegendSymbols","colorLegendLabels","colorLegendTitle"])}),strokeGradient:Object.freeze({semanticKind:"stroke",family:"continuous",rematerializeOp:"rematerializeStrokeGradientLegend",graphicIds:Object.freeze(["strokeGradientBackground","strokeGradientStrips","strokeGradientTicks","strokeGradientLabels","strokeGradientTitle"])}),strokeInterval:Object.freeze({semanticKind:"stroke",family:"interval",rematerializeOp:"rematerializeStrokeIntervalLegend",graphicIds:Object.freeze(["strokeIntervalBackground","strokeIntervalSymbols","strokeIntervalLabels","strokeIntervalTitle"])}),opacity:Object.freeze({semanticKind:"opacity",family:"continuous",rematerializeOp:"rematerializeOpacityLegend",graphicIds:Object.freeze(["opacityLegendBackground","opacityLegendSymbols","opacityLegendLabels","opacityLegendTitle"])}),strokeWidth:Object.freeze({semanticKind:"strokeWidth",family:"strokeWidth",rematerializeOp:"rematerializeStrokeWidthLegend",graphicIds:Object.freeze(["strokeWidthLegendBackground","strokeWidthLegendSymbols","strokeWidthLegendLabels","strokeWidthLegendTitle"])})});function P(e){return $(e).graphicIds}function $(e){const t=j[e];if(t===void 0)throw new Error(`Unknown legend graphic kind "${e}".`);return t}function w(){return Object.entries(j).map(([e,t])=>({kind:e,...t}))}function M(e){return[...new Set(e.flatMap(P))]}function y(e){return K(e.graphicSpec,e.guideConfigs,void 0,e.materializationConfigs.textMetrics).filter(t=>t.kind==="axis")}function N(e,t,r){if(t.inferredOffset!==!0||!["top","bottom","left","right"].includes(t.position)||t.layout==="legacy-bottom")return t.offset;const d=y(e).filter(n=>n.position===t.position),i=Math.max(0,...d.map(n=>({bottom:n.bounds.bottom-r.y-r.height,top:r.y-n.bounds.top,left:r.x-n.bounds.left,right:n.bounds.right-r.x-r.width})[t.position]));return t.offset+i}function x(e,t,r){if(t!=="size"||r.inheritPosition===!1)return r;const d=["series","color","stroke"].map(i=>e.guideConfigs.legend?.[i]).find(i=>i?.target===r.target);return d===void 0?r:{...r,position:d.position,offset:d.offset,inferredOffset:d.inferredOffset}}function U(e,t){const r=Object.entries(t.guideConfigs.legend??{}).some(([i,n])=>{const a=x(t,i,n);return a.inferredOffset===!1&&e.guideConfigs.legend?.[i]?.inferredOffset===!0&&["top","bottom"].includes(a.position)&&a.layout!=="legacy-bottom"});return([e,t].some(i=>Object.entries(i.guideConfigs.legend??{}).some(([n,a])=>{const s=x(i,n,a);return s.inferredOffset===!0&&["top","bottom"].includes(s.position)&&s.layout!=="legacy-bottom"})||Object.values(i.guideConfigs.legendGroups??{}).some(n=>n.inferredOffset===!0&&["top","bottom"].includes(n.placement.position)))||r)&&[e,t].some(i=>y(i).some(n=>["top","bottom"].includes(n.position)))}function _(e,t){const r=new Set;for(const i of[e,t])for(const[n,a]of Object.entries(i.guideConfigs.legend??{})){const s=C(a),f=s===void 0?i.guideConfigs.legendGroups?.[a.target]:void 0,g=x(i,n,a),p=s??f?.placement??g;(s?.inferredOffset??f?.inferredOffset??g.inferredOffset)===!0&&p.at===void 0&&["left","right"].includes(p.position)&&g.layout!=="legacy-bottom"&&r.add(p.position)}const d=i=>JSON.stringify(y(i).filter(n=>r.has(n.position)));return r.size>0&&d(e)!==d(t)}export{M as allLegendGraphicIds,k as axisGraphicIds,x as effectiveLegendOffsetConfig,W as hasPendingAxisTitleRematerialization,P as legendGraphicIds,w as legendResourcePolicies,$ as legendResourcePolicy,U as needsLegendAxisReflow,_ as needsSideLegendAxisReflow,K as resolveGuideCollisionBlocks,N as resolveLegendAxisOffset};