ggaction 0.0.15 → 0.0.17

package/src/actions/scales/consumers/common.js

@@ -5,6 +5,7 @@ import { readScaleField } from "../../../grammar/scales/index.js";
 import { findDataset } from "../../../selectors/datasets.js";
 import { requireSemanticScale } from "../../../selectors/scales.js";
 import { SCALED_ENCODING_CHANNELS } from "../../../core/vocabulary.js";
+import { applyItemMissingPolicy } from "../../../grammar/itemMissing.js";
 
 export function findScale(program, id) {
   return requireSemanticScale(program, id);
@@ -39,7 +40,7 @@ export function requireConsumerDataset(program, consumer) {
       `Mark "${consumer.layer.id}" references unknown dataset "${consumer.layer.data}".`
     );
   }
-  return dataset;
+  return applyItemMissingPolicy(consumer.layer, dataset);
 }
 
 export function isDirectCategoricalConsumer(consumer) {

package/src/actions/scales/create.js

@@ -24,6 +24,7 @@ const CREATE_SCALE_OPTIONS = Object.freeze([
   "id",
   "type",
   "domain",
+  "emptyDomain",
   "range",
   "nice",
   "zero",
@@ -77,7 +78,7 @@ function assertEquivalentScale(existing, expected) {
   }
 }
 
-export const createScale = action(
+export const createScale = /* @__PURE__ */ action(
   {
     op: "createScale",
     description: "Create a named semantic scale."
@@ -164,7 +165,7 @@ export const createScale = action(
       .editSemantic({ property: `scale[${id}].range`, value: definition.range });
 
     for (const property of [
-      "nice", "zero", "clamp", "reverse", "base", "exponent", "constant",
+      "emptyDomain", "nice", "zero", "clamp", "reverse", "base", "exponent", "constant",
       "paddingInner", "paddingOuter", "padding", "align", "interpolate", "midpoint",
       "radialMapping", "unknown"
     ]) {

package/src/actions/scales/definitions.js

@@ -37,7 +37,7 @@ import { resolveRequestedOffsetPolicy } from
   "../../materialization/scales/policies/offset.js";
 import { findScaleConsumers } from "./consumers/index.js";
 
-const BASE_OPTIONS = ["id", "type", "domain", "range"];
+const BASE_OPTIONS = ["id", "type", "domain", "range", "emptyDomain"];
 const UNKNOWN_OPTIONS = [...BASE_OPTIONS, "unknown"];
 const CLAMP_REVERSE = ["clamp", "reverse"];
 const BOOLEAN_OPTIONS = ["nice", "zero", ...CLAMP_REVERSE];

package/src/actions/scales/edit.js

@@ -26,7 +26,7 @@ import { hasExactLegendSamplingForScale } from
   "../guides/legends/sampling.js";
 
 const OPTIONS = Object.freeze([
-  "id", "type", "domain", "range", "nice", "zero", "clamp", "reverse",
+  "id", "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "paddingInner", "paddingOuter", "padding",
   "align", "interpolate", "midpoint", "unknown", "palette", "radialMapping"
 ]);
@@ -145,7 +145,7 @@ function applyScaleEdit(program, {
   return next;
 }
 
-export const editScale = action(
+export const editScale = /* @__PURE__ */ action(
   {
     op: "editScale",
     description: "Edit an existing scale and rematerialize its consumers."

package/src/actions/scales/materialize.js

@@ -27,7 +27,7 @@ function validateOptions(args) {
   }
 }
 
-export const rematerializeScale = action(
+export const rematerializeScale = /* @__PURE__ */ action(
   {
     op: "rematerializeScale",
     description: "Recompute every concrete consumer of a scale."

package/src/actions/scales/offset.js

@@ -39,8 +39,8 @@ function createOffsetScaleEditor(channel) {
   );
 }
 
-export const editXOffsetScale = createOffsetScaleEditor("xOffset");
-export const editYOffsetScale = createOffsetScaleEditor("yOffset");
+export const editXOffsetScale = /* @__PURE__ */ createOffsetScaleEditor("xOffset");
+export const editYOffsetScale = /* @__PURE__ */ createOffsetScaleEditor("yOffset");
 
 export function registerOffsetScaleActions(ProgramClass) {
   ProgramClass.prototype.editXOffsetScale = editXOffsetScale;

package/src/actions/scales/parallel.js

@@ -6,7 +6,7 @@ import { requireLayer } from "../../selectors/layers.js";
 import { requireSemanticScale } from "../../selectors/scales.js";
 
 const QUANTITATIVE_OPTIONS = Object.freeze([
-  "type", "domain", "range", "nice", "zero", "clamp", "reverse",
+  "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "unknown"
 ]);
 const ORDINAL_OPTIONS = Object.freeze([
@@ -45,7 +45,7 @@ function resolveParallelDimension(program, args) {
   return dimension;
 }
 
-export const editParallelScale = action(
+export const editParallelScale = /* @__PURE__ */ action(
   {
     op: "editParallelScale",
     description: "Edit a Parallel-coordinate dimension scale by field identity."

package/src/actions/scales/patch.js

@@ -1,5 +1,5 @@
 const SCALE_EDIT_PROPERTIES = Object.freeze([
-  "type", "domain", "range", "nice", "zero", "clamp", "reverse",
+  "type", "domain", "range", "emptyDomain", "nice", "zero", "clamp", "reverse",
   "base", "exponent", "constant", "paddingInner", "paddingOuter",
   "padding", "align", "interpolate", "midpoint", "unknown"
 ]);

package/src/actions/scales/preview.js

@@ -9,7 +9,10 @@ import {
   resolveScaleConsumerBounds
 } from "../../materialization/coordinateBounds.js";
 import { requireCoordinate } from "../../selectors/coordinates.js";
-import { resolveScaleMaterialization } from "../../materialization/scales/resolve.js";
+import {
+  rememberResolvedScaleBinding,
+  resolveScaleMaterialization
+} from "../../materialization/scales/resolve.js";
 import { findScale, findScaleConsumers, resolveConsumerCategoryOrder,
   resolveConsumerValues, resolveSeriesLayoutScaleValues } from "./consumers/index.js";
 
@@ -126,6 +129,30 @@ export function resolveScalePreview(program, id) {
   return resolveScalePreviewAtBounds(program, id, bounds);
 }
 
+export function restoreResolvedScaleBindings(program) {
+  for (const scale of program.semanticSpec.scales) {
+    const resolved = program.resolvedScales[scale.id];
+    if (resolved === undefined) continue;
+    const consumers = findScaleConsumers(program, scale.id);
+    const channels = new Set(consumers.map(consumer =>
+      normalizePositionScaleChannel(consumer.channel)
+    ));
+    const families = new Set([...channels].map(channel =>
+      channel === "stroke" ? "color" : channel
+    ));
+    if (families.size === 1) {
+      const channel = channels.size === 1
+        ? channels.values().next().value
+        : families.values().next().value;
+      rememberResolvedScaleBinding(resolved, channel, consumers);
+    }
+  }
+  for (const child of Object.values(program.children)) {
+    restoreResolvedScaleBindings(child);
+  }
+  return program;
+}
+
 export function validatePendingMeasuredScale(program, scale, consumers) {
   const bounds = resolveScaleConsumerBounds(program, consumers);
   const range = resolveArcAutoPositionRange({ consumers, scale, channel: "radius",

package/src/actions/scales/quantitativeColor.js

@@ -1,5 +1,5 @@
-import { action } from "../../core/action.js";
-import { validateKeys } from "../../core/validation.js";
+import { closedAction } from "../../core/action.js";
+
 import { findSemanticScale } from "../../selectors/scales.js";
 
 const OPTIONS = Object.freeze([
@@ -13,13 +13,12 @@ const OPTIONS = Object.freeze([
   "unknown"
 ]);
 
-export const setQuantitativeColorScale = action(
+export const setQuantitativeColorScale = /* @__PURE__ */ closedAction(
   {
     op: "setQuantitativeColorScale",
     description: "Create or update an internal quantitative color scale."
-  },
+  }, OPTIONS,
   function (args = {}) {
-    validateKeys(args, OPTIONS, "setQuantitativeColorScale");
     if (!["sequential", "quantize", "quantile", "threshold"].includes(args.type)) {
       throw new Error(`Unsupported quantitative color scale type "${args.type}".`);
     }

package/src/actions/selection/actions.js

@@ -1,4 +1,4 @@
-import { action } from "../../core/action.js";
+import { action, closedAction } from "../../core/action.js";
 import { validateUserId } from "../../core/identifiers.js";
 import { isPlainObject } from "../../core/immutable.js";
 import { validateKeys } from "../../core/validation.js";
@@ -278,10 +278,9 @@ export function rematerializeThemeHighlights(program) {
   return next;
 }
 
-export const selectMarks = action(
-  { op: "selectMarks", description: "Create one reusable selection over final mark items." },
+export const selectMarks = /* @__PURE__ */ closedAction(
+  { op: "selectMarks", description: "Create one reusable selection over final mark items." }, SELECT_OPTIONS,
   function (args = {}) {
-    validateKeys(args, SELECT_OPTIONS, "selectMarks");
     const layer = resolveTarget(this, args.target);
     const resolved = resolveMarkSelection(this, layer.id, selectorFrom(args));
     const id = resolveSelectionCreationId(this, args.id, layer.id);
@@ -291,13 +290,12 @@ export const selectMarks = action(
   }
 );
 
-export const editMarkSelection = action(
+export const editMarkSelection = /* @__PURE__ */ closedAction(
   {
     op: "editMarkSelection",
     description: "Replace one stored mark selector while preserving its identity and target."
-  },
+  }, EDIT_SELECTION_OPTIONS,
   function (args = {}) {
-    validateKeys(args, EDIT_SELECTION_OPTIONS, "editMarkSelection");
     const current = resolveStoredSelection(this, args.selection);
     const replacement = resolveMarkSelection(
       this,
@@ -325,13 +323,12 @@ export const editMarkSelection = action(
   }
 );
 
-export const removeMarkHighlight = action(
+export const removeMarkHighlight = /* @__PURE__ */ closedAction(
   {
     op: "removeMarkHighlight",
     description: "Remove one stored highlight assignment and restore the clean mark baseline."
-  },
+  }, REMOVE_SELECTION_OPTIONS,
   function (args = {}) {
-    validateKeys(args, REMOVE_SELECTION_OPTIONS, "removeMarkHighlight");
     const current = resolveStoredSelection(this, args.selection);
     const dependent = Object.entries(
       this.materializationConfigs.highlights ?? {}
@@ -349,13 +346,12 @@ export const removeMarkHighlight = action(
   }
 );
 
-export const removeMarkSelection = action(
+export const removeMarkSelection = /* @__PURE__ */ closedAction(
   {
     op: "removeMarkSelection",
     description: "Remove one stored selection after removing its dependent highlight."
-  },
+  }, REMOVE_SELECTION_OPTIONS,
   function (args = {}) {
-    validateKeys(args, REMOVE_SELECTION_OPTIONS, "removeMarkSelection");
     const current = resolveStoredSelection(this, args.selection);
     const labelDependents = namedLabelDependents(this, current.id);
     if (labelDependents.length > 0) {
@@ -376,10 +372,9 @@ export const removeMarkSelection = action(
   }
 );
 
-export const applyPointHighlight = action(
-  { op: "applyPointHighlight", description: "Apply selected point appearance and geometry." },
+export const applyPointHighlight = /* @__PURE__ */ closedAction(
+  { op: "applyPointHighlight", description: "Apply selected point appearance and geometry." }, INTERNAL_SELECTION_OPTIONS,
   function (args = {}) {
-    validateKeys(args, INTERNAL_SELECTION_OPTIONS, "applyPointHighlight");
     const resolved = resolveStoredSelection(this, args.selection);
     const keys = selectedKeys(args, resolved);
     if (resolved.items[0]?.markType !== "point" && resolved.items.length > 0) {
@@ -432,14 +427,14 @@ function applyRectangularHighlight(
     transformRectangularHighlightChild(item, args.style, offset));
 }
 
-export const applyBarHighlight = action(
+export const applyBarHighlight = /* @__PURE__ */ action(
   { op: "applyBarHighlight", description: "Apply selected bar appearance." },
   function (args = {}) {
     return applyRectangularHighlight(this, args, "applyBarHighlight", "bar");
   }
 );
 
-export const applyRectHighlight = action(
+export const applyRectHighlight = /* @__PURE__ */ action(
   { op: "applyRectHighlight", description: "Apply selected rect appearance." },
   function (args = {}) {
     return applyRectangularHighlight(
@@ -452,10 +447,9 @@ export const applyRectHighlight = action(
   }
 );
 
-export const applyPathHighlight = action(
-  { op: "applyPathHighlight", description: "Apply selected line or area path appearance and offset." },
+export const applyPathHighlight = /* @__PURE__ */ closedAction(
+  { op: "applyPathHighlight", description: "Apply selected line or area path appearance and offset." }, INTERNAL_SELECTION_OPTIONS,
   function (args = {}) {
-    validateKeys(args, INTERNAL_SELECTION_OPTIONS, "applyPathHighlight");
     const resolved = resolveStoredSelection(this, args.selection);
     const keys = selectedKeys(args, resolved);
     const markType = resolved.items[0]?.markType;
@@ -473,10 +467,9 @@ export const applyPathHighlight = action(
   }
 );
 
-export const applyRuleHighlight = action(
-  { op: "applyRuleHighlight", description: "Apply selected rule appearance and offset." },
+export const applyRuleHighlight = /* @__PURE__ */ closedAction(
+  { op: "applyRuleHighlight", description: "Apply selected rule appearance and offset." }, INTERNAL_SELECTION_OPTIONS,
   function (args = {}) {
-    validateKeys(args, INTERNAL_SELECTION_OPTIONS, "applyRuleHighlight");
     const resolved = resolveStoredSelection(this, args.selection);
     const keys = selectedKeys(args, resolved);
     if (
@@ -493,10 +486,9 @@ export const applyRuleHighlight = action(
   }
 );
 
-export const dimUnselectedMarkItems = action(
-  { op: "dimUnselectedMarkItems", description: "Dim the complement of one mark selection." },
+export const dimUnselectedMarkItems = /* @__PURE__ */ closedAction(
+  { op: "dimUnselectedMarkItems", description: "Dim the complement of one mark selection." }, INTERNAL_DIM_OPTIONS,
   function (args = {}) {
-    validateKeys(args, INTERNAL_DIM_OPTIONS, "dimUnselectedMarkItems");
     const opacity = validateUnitInterval(args.opacity, "Dim opacity");
     const resolved = resolveStoredSelection(this, args.selection);
     const keys = selectedKeys(args, resolved);
@@ -507,10 +499,9 @@ export const dimUnselectedMarkItems = action(
   }
 );
 
-export const placeSelectedMarkItemsLast = action(
-  { op: "placeSelectedMarkItemsLast", description: "Place selected collection items after their complement." },
+export const placeSelectedMarkItemsLast = /* @__PURE__ */ closedAction(
+  { op: "placeSelectedMarkItemsLast", description: "Place selected collection items after their complement." }, INTERNAL_ORDER_OPTIONS,
   function (args = {}) {
-    validateKeys(args, INTERNAL_ORDER_OPTIONS, "placeSelectedMarkItemsLast");
     const resolved = resolveStoredSelection(this, args.selection);
     const keys = selectedKeys(args, resolved);
     if (keys.length === 0 || keys.length === resolved.items.length) {
@@ -528,10 +519,9 @@ export const placeSelectedMarkItemsLast = action(
   }
 );
 
-export const rematerializeMarkHighlights = action(
-  { op: "rematerializeMarkHighlights", description: "Reapply stored highlight assignments to one rematerialized mark." },
+export const rematerializeMarkHighlights = /* @__PURE__ */ closedAction(
+  { op: "rematerializeMarkHighlights", description: "Reapply stored highlight assignments to one rematerialized mark." }, REMATERIALIZE_OPTIONS,
   function (args = {}) {
-    validateKeys(args, REMATERIALIZE_OPTIONS, "rematerializeMarkHighlights");
     validateUserId(args.target, "Highlight target id");
     if (!Array.isArray(args.highlights)) {
       throw new TypeError("rematerializeMarkHighlights requires highlight entries.");
@@ -553,10 +543,9 @@ export const rematerializeMarkHighlights = action(
   }
 );
 
-export const highlightMarks = action(
-  { op: "highlightMarks", description: "Select and emphasize final visual mark items." },
+export const highlightMarks = /* @__PURE__ */ closedAction(
+  { op: "highlightMarks", description: "Select and emphasize final visual mark items." }, HIGHLIGHT_OPTIONS,
   function (args = {}) {
-    validateKeys(args, HIGHLIGHT_OPTIONS, "highlightMarks");
     if (args.select !== undefined && args.selection !== undefined) {
       throw new Error("highlightMarks accepts select or selection, not both.");
     }

package/src/actions/textMetrics/index.js

@@ -0,0 +1,56 @@
+import { action, closedAction } from "../../core/action.js";
+import { noOptions } from "../../core/validation.js";
+import { normalizeTextMetricProfile } from "../../core/textMetricProfile.js";
+import { rematerializeTypography } from "../../materialization/typography.js";
+
+function metricsProgram(parent, child) {
+  return typeof child.applyTextMetrics === "function" ? child : new parent.constructor({
+    ...child, actionSequence: child._actionSequence
+  });
+}
+
+export function inheritTextMetrics(parent, child) {
+  const profile = parent.materializationConfigs.textMetrics;
+  return profile === undefined ? child : metricsProgram(parent, child).applyTextMetrics({ profile });
+}
+
+function applyProfile(program, profile) {
+  let next = profile === undefined
+    ? program._withoutMaterializationConfig(["textMetrics"])
+    : program._withMaterializationConfig(["textMetrics"], profile);
+  if (next.compositionSpec !== undefined) {
+    const children = Object.fromEntries(next.compositionSpec.children.map(id => {
+      const child = next.children[id];
+      return [id, profile === undefined
+        ? child.materializationConfigs.textMetrics === undefined ? child : metricsProgram(next, child).removeTextMetrics()
+        : inheritTextMetrics(next, child)];
+    }));
+    next = next._withCompositionState({ children, compositionSpec: next.compositionSpec });
+    for (const id of next.compositionSpec.children) next = next.useProgram({ id });
+    return next.materializeComposition();
+  }
+  return rematerializeTypography(next);
+}
+
+export const applyTextMetrics = /* @__PURE__ */ closedAction(
+  { op: "applyTextMetrics", description: "Apply measured text widths to chart layout.", scope: "any" }, ["profile"],
+  function (args = {}) {
+    const profile = normalizeTextMetricProfile(args.profile);
+    applyProfile(this, profile);
+    return applyProfile(this, profile);
+  }
+);
+
+export const removeTextMetrics = /* @__PURE__ */ action(
+  { op: "removeTextMetrics", description: "Restore estimated text layout.", scope: "any" },
+  function (args = {}) {
+    noOptions(args, "removeTextMetrics");
+    if (this.materializationConfigs.textMetrics === undefined) throw new Error("removeTextMetrics requires an active profile.");
+    applyProfile(this, undefined);
+    return applyProfile(this, undefined);
+  }
+);
+
+export function registerTextMetricActions(ProgramClass) {
+  Object.assign(ProgramClass.prototype, { applyTextMetrics, removeTextMetrics });
+}

package/src/actions/theme/actions.js

@@ -28,7 +28,7 @@ function requireCompositionThemeHandlers() {
   return compositionThemeHandlers;
 }
 
-export const applyTheme = action(
+export const applyTheme = /* @__PURE__ */ action(
   {
     op: "applyTheme",
     description: "Apply persistent visual defaults to the chart program.",
@@ -70,7 +70,7 @@ export const applyTheme = action(
   }
 );
 
-export const removeTheme = action(
+export const removeTheme = /* @__PURE__ */ action(
   {
     op: "removeTheme",
     description: "Remove program theme defaults while preserving local styles.",