ggaction 0.0.4 → 0.0.6

package/src/actions/marks/line/actions.js

@@ -1,6 +1,4 @@
 import { action } from "../../../core/action.js";
-import { deriveLineSeries } from "../../../grammar/lineSeries.js";
-import { mapContinuousScaleValues, mapOrdinalValues } from "../../../grammar/scales/index.js";
 import { validateUserId } from "../../../core/identifiers.js";
 import {
   validateNonEmptyString,
@@ -19,18 +17,17 @@ import {
 import { DEFAULT_COLORS } from "../../../theme/defaults.js";
 import { findDataset } from "../../../selectors/datasets.js";
 import { findLayer, resolveEligibleLayer } from "../../../selectors/layers.js";
-import {
-  buildCurvePathCommands,
-  validateCurveInterpolation
-} from "../../../grammar/curveCommands.js";
-import { buildPolarLinePathCommands } from "../../../grammar/polarLineCommands.js";
-import { resolvePolarFrame } from "../../../grammar/polar.js";
+import { validateCurveInterpolation } from "../../../grammar/curveCommands.js";
 import { resolveGraphicBounds } from "../../../layout/canvas.js";
-import { normalizeStrokeDashPattern } from "../../../grammar/scales/index.js";
 import { canMaterializeLine } from "../../../materialization/marks/index.js";
 import { resolveMarkGraphicPlacement } from
   "../../../materialization/graphicHierarchy.js";
 import { rematerializeHighlightBaseline } from "../lifecycle.js";
+import { validateParallelRows } from "../../../grammar/parallelCoordinates.js";
+import {
+  resolveParallelLineMaterialization,
+  resolvePositionedLineMaterialization
+} from "./materialize.js";
 
 const DEFAULT_LINE_STROKE = DEFAULT_COLORS.mark;
 const DEFAULT_LINE_WIDTH = 2;
@@ -54,7 +51,17 @@ function isPolarLine(layer) {
     layer.encoding?.radius !== undefined;
 }
 
+function isParallelLine(layer) {
+  return layer.encoding?.parallel !== undefined;
+}
+
 function validatePolarLineConfig(layer, config) {
+  if (isParallelLine(layer)) {
+    if ((config.curve ?? "linear") !== "linear" || config.closed === true) {
+      throw new Error("Parallel lines require curve \"linear\" and closed false.");
+    }
+    return;
+  }
   if (!isPolarLine(layer)) return;
   if ((config.curve ?? "linear") !== "linear") {
     throw new Error("Polar line position currently requires curve \"linear\".");
@@ -84,9 +91,6 @@ const createLineMark = action(
       args.strokeWidth ?? DEFAULT_LINE_WIDTH,
       "Line strokeWidth"
     );
-    if (args.scales !== undefined && typeof args.scales !== "boolean") {
-      throw new TypeError("rematerializeLineMark scales must be a boolean.");
-    }
     const curve = validateCurveInterpolation(args.curve ?? "linear");
     const closed = Object.hasOwn(args, "closed")
       ? validateClosed(args.closed)
@@ -176,6 +180,7 @@ const rematerializeLineMark = action(
     if (highlighted !== undefined) return highlighted;
     const { dataset, layer } = requireLine(this, id);
     const existingChildren = this.graphicSpec.objects[id].items;
+    const parallel = layer.encoding?.parallel;
     const xScaleId = layer.encoding?.x?.scale;
     const yScaleId = layer.encoding?.y?.scale;
     const thetaScaleId = layer.encoding?.theta?.scale;
@@ -184,6 +189,64 @@ const rematerializeLineMark = action(
     const config = this.markConfigs[id] ?? {};
     validatePolarLineConfig(layer, config);
 
+    if (parallel !== undefined) {
+      validateParallelRows(dataset.values, parallel.dimensions, parallel);
+      let resolved = this;
+      if (args.scales !== false) {
+        for (const dimension of parallel.dimensions) {
+          resolved = resolved.rematerializeScale({ id: dimension.scale });
+        }
+      }
+      for (const channel of args.scales === false
+        ? []
+        : ["color", "strokeDash", "strokeWidth"]) {
+        const scaleId = layer.encoding?.[channel]?.scale;
+        if (scaleId !== undefined) {
+          resolved = resolved.rematerializeScale({ id: scaleId });
+        }
+      }
+      const materialization = resolveParallelLineMaterialization({
+        rows: dataset.values,
+        parallel,
+        layer,
+        resolvedScales: resolved.resolvedScales,
+        bounds: resolveGraphicBounds(resolved),
+        config,
+        existingChildren,
+        defaults: { stroke: DEFAULT_LINE_STROKE, strokeWidth: DEFAULT_LINE_WIDTH }
+      });
+      let next = resolved
+        .editGraphics({
+          target: id,
+          property: "length",
+          value: materialization.commands.length
+        })
+        .editGraphics({
+          target: id,
+          property: "commands",
+          value: materialization.commands
+        })
+        .editGraphics({ target: id, property: "stroke", value: materialization.strokes })
+        .editGraphics({
+          target: id,
+          property: "strokeWidth",
+          value: materialization.strokeWidths
+        })
+        .editGraphics({
+          target: id,
+          property: "strokeDash",
+          value: materialization.strokeDashes
+        });
+      if (config.opacity !== undefined) {
+        next = next.editGraphics({
+          target: id,
+          property: "opacity",
+          value: config.opacity
+        });
+      }
+      return next;
+    }
+
     if (
       polar
         ? thetaScaleId === undefined || radiusScaleId === undefined
@@ -206,85 +269,37 @@ const rematerializeLineMark = action(
             .rematerializeScale({ id: xScaleId })
             .rematerializeScale({ id: yScaleId });
 
-    for (const channel of args.scales === false ? [] : ["color", "strokeDash"]) {
+    for (const channel of args.scales === false ? [] : ["color", "strokeDash", "strokeWidth"]) {
       const scaleId = layer.encoding?.[channel]?.scale;
       if (scaleId !== undefined) {
         resolved = resolved.rematerializeScale({ id: scaleId });
       }
     }
 
-    const derived = deriveLineSeries(
-      dataset.values,
+    const materialization = resolvePositionedLineMaterialization({
+      rows: dataset.values,
       layer,
-      polar
-        ? { thetaDomain: resolved.resolvedScales[thetaScaleId].domain }
-        : undefined
-    );
-    const commands = polar
-      ? derived.series.map(series => buildPolarLinePathCommands({
-          series: series.values,
-          thetaFieldType: derived.thetaFieldType,
-          thetaScale: resolved.resolvedScales[thetaScaleId],
-          radiusScale: resolved.resolvedScales[radiusScaleId],
-          frame: resolvePolarFrame(resolveGraphicBounds(resolved)),
-          closed: config.closed ?? false
-        }))
-      : derived.series.map(series => {
-          const x = mapContinuousScaleValues(
-            series.values.map(value => value.x),
-            resolved.resolvedScales[xScaleId]
-          );
-          const y = mapContinuousScaleValues(
-            series.values.map(value => value.y),
-            resolved.resolvedScales[yScaleId]
-          );
-
-          return buildCurvePathCommands(
-            series.values.map((_, index) => ({ x: x[index], y: y[index] })),
-            config.curve ?? "linear"
-          );
-        });
-    const colorEncoding = layer.encoding?.color;
-    const dashEncoding = layer.encoding?.strokeDash;
-    const strokes = colorEncoding?.scale === undefined
-      ? commands.map(
-          (_, index) =>
-            config.stroke ??
-            existingChildren[index]?.properties.stroke ??
-            DEFAULT_LINE_STROKE
-        )
-      : mapOrdinalValues(
-          derived.series.map(series => series.key[colorEncoding.field]),
-          resolved.resolvedScales[colorEncoding.scale].domain,
-          resolved.resolvedScales[colorEncoding.scale].range
-        );
-    const strokeWidths = commands.map(
-      (_, index) =>
-        config.strokeWidth ??
-        existingChildren[index]?.properties.strokeWidth ??
-        DEFAULT_LINE_WIDTH
-    );
-    const strokeDashes = dashEncoding?.datum !== undefined
-      ? commands.map(() => normalizeStrokeDashPattern(dashEncoding.datum))
-      : dashEncoding?.scale === undefined
-      ? commands.map(
-          (_, index) => existingChildren[index]?.properties.strokeDash ?? []
-        )
-      : mapOrdinalValues(
-          derived.series.map(series => series.key[dashEncoding.field]),
-          resolved.resolvedScales[dashEncoding.scale].domain,
-          resolved.resolvedScales[dashEncoding.scale].range
-        );
+      resolvedScales: resolved.resolvedScales,
+      bounds: resolveGraphicBounds(resolved),
+      config,
+      existingChildren,
+      polar,
+      defaults: { stroke: DEFAULT_LINE_STROKE, strokeWidth: DEFAULT_LINE_WIDTH }
+    });
 
     let next = resolved
-      .editGraphics({ target: id, property: "length", value: commands.length })
-      .editGraphics({ target: id, property: "commands", value: commands })
-      .editGraphics({ target: id, property: "stroke", value: strokes })
-      .editGraphics({ target: id, property: "strokeWidth", value: strokeWidths })
+      .editGraphics({
+        target: id,
+        property: "length",
+        value: materialization.commands.length
+      })
+      .editGraphics({ target: id, property: "commands", value: materialization.commands })
+      .editGraphics({ target: id, property: "stroke", value: materialization.strokes })
+      .editGraphics({ target: id, property: "strokeWidth", value: materialization.strokeWidths })
       .editGraphics({
         target: id,
         property: "strokeDash",
-        value: strokeDashes
+        value: materialization.strokeDashes
       });
     if (config.opacity !== undefined) {
       next = next.editGraphics({
@@ -329,13 +344,17 @@ const editLineMark = action(
       );
     }
     if (Object.hasOwn(args, "closed") && args.closed === true &&
-        layer.encoding?.x !== undefined) {
+        (layer.encoding?.x !== undefined || isParallelLine(layer))) {
       throw new Error("Line closed requires theta/radius Polar position encodings.");
     }
     if (Object.hasOwn(args, "curve") && isPolarLine(layer) &&
         args.curve !== "linear") {
       throw new Error("Polar line position currently requires curve \"linear\".");
     }
+    if (Object.hasOwn(args, "curve") && isParallelLine(layer) &&
+        args.curve !== "linear") {
+      throw new Error("Parallel lines require curve \"linear\".");
+    }
     const config = {
       ...this.markConfigs[layer.id],
       ...(Object.hasOwn(args, "stroke")

package/src/actions/marks/line/materialize.js

@@ -0,0 +1,146 @@
+import {
+  deriveLineSeries,
+  deriveLineSeriesFieldValues
+} from "../../../grammar/lineSeries.js";
+import {
+  mapContinuousScaleValues,
+  mapOrdinalValues,
+  normalizeStrokeDashPattern
+} from "../../../grammar/scales/index.js";
+import { buildCurvePathCommands } from
+  "../../../grammar/curveCommands.js";
+import { buildPolarLinePathCommands } from
+  "../../../grammar/polarLineCommands.js";
+import { resolvePolarFrame } from "../../../grammar/polar.js";
+import { materializeParallelRows } from
+  "../../../grammar/parallelCoordinates.js";
+import { mapScaleConsumerValues } from
+  "../../../materialization/scales/map.js";
+
+function existingValue(children, index, property, fallback) {
+  return children[index]?.properties[property] ?? fallback;
+}
+
+export function resolveParallelLineMaterialization({
+  rows,
+  parallel,
+  layer,
+  resolvedScales,
+  bounds,
+  config,
+  existingChildren,
+  defaults
+}) {
+  const items = materializeParallelRows(
+    rows,
+    parallel.dimensions,
+    resolvedScales,
+    bounds,
+    parallel
+  );
+  const sourceRows = items.map(item => rows[item.sourceRowIndex]);
+  const mapAppearance = (channel, fallback) => {
+    const encoding = layer.encoding?.[channel];
+    if (encoding?.datum !== undefined) {
+      return items.map(() => channel === "strokeDash"
+        ? normalizeStrokeDashPattern(encoding.datum)
+        : encoding.datum);
+    }
+    if (encoding?.scale === undefined) return items.map(fallback);
+    return mapScaleConsumerValues(
+      sourceRows.map(row => row[encoding.field]),
+      resolvedScales[encoding.scale],
+      channel
+    );
+  };
+  return {
+    commands: items.map(item => item.commands),
+    strokes: mapAppearance(
+      "color",
+      (_, index) => config.stroke ??
+        existingValue(existingChildren, index, "stroke", defaults.stroke)
+    ),
+    strokeWidths: mapAppearance(
+      "strokeWidth",
+      (_, index) => config.strokeWidth ??
+        existingValue(existingChildren, index, "strokeWidth", defaults.strokeWidth)
+    ),
+    strokeDashes: mapAppearance(
+      "strokeDash",
+      (_, index) => existingValue(existingChildren, index, "strokeDash", [])
+    )
+  };
+}
+
+export function resolvePositionedLineMaterialization({
+  rows,
+  layer,
+  resolvedScales,
+  bounds,
+  config,
+  existingChildren,
+  polar,
+  defaults
+}) {
+  const xScaleId = layer.encoding?.x?.scale;
+  const yScaleId = layer.encoding?.y?.scale;
+  const thetaScaleId = layer.encoding?.theta?.scale;
+  const radiusScaleId = layer.encoding?.radius?.scale;
+  const derived = deriveLineSeries(
+    rows,
+    layer,
+    polar ? { thetaDomain: resolvedScales[thetaScaleId].domain } : undefined
+  );
+  const commands = polar
+    ? derived.series.map(series => buildPolarLinePathCommands({
+        series: series.values,
+        thetaFieldType: derived.thetaFieldType,
+        thetaScale: resolvedScales[thetaScaleId],
+        radiusScale: resolvedScales[radiusScaleId],
+        frame: resolvePolarFrame(bounds),
+        closed: config.closed ?? false
+      }))
+    : derived.series.map(series => {
+        const x = mapContinuousScaleValues(
+          series.values.map(value => value.x),
+          resolvedScales[xScaleId]
+        );
+        const y = mapContinuousScaleValues(
+          series.values.map(value => value.y),
+          resolvedScales[yScaleId]
+        );
+        return buildCurvePathCommands(
+          series.values.map((_, index) => ({ x: x[index], y: y[index] })),
+          config.curve ?? "linear"
+        );
+      });
+  const colorEncoding = layer.encoding?.color;
+  const dashEncoding = layer.encoding?.strokeDash;
+  const widthEncoding = layer.encoding?.strokeWidth;
+  const strokes = colorEncoding?.scale === undefined
+    ? commands.map((_, index) => config.stroke ??
+        existingValue(existingChildren, index, "stroke", defaults.stroke))
+    : mapOrdinalValues(
+        derived.series.map(series => series.key[colorEncoding.field]),
+        resolvedScales[colorEncoding.scale].domain,
+        resolvedScales[colorEncoding.scale].range
+      );
+  const strokeWidths = widthEncoding?.scale === undefined
+    ? commands.map((_, index) => config.strokeWidth ??
+        existingValue(existingChildren, index, "strokeWidth", defaults.strokeWidth))
+    : mapContinuousScaleValues(
+        deriveLineSeriesFieldValues(rows, layer, derived, widthEncoding.field),
+        resolvedScales[widthEncoding.scale]
+      );
+  const strokeDashes = dashEncoding?.datum !== undefined
+    ? commands.map(() => normalizeStrokeDashPattern(dashEncoding.datum))
+    : dashEncoding?.scale === undefined
+      ? commands.map((_, index) =>
+          existingValue(existingChildren, index, "strokeDash", []))
+      : mapOrdinalValues(
+          derived.series.map(series => series.key[dashEncoding.field]),
+          resolvedScales[dashEncoding.scale].domain,
+          resolvedScales[dashEncoding.scale].range
+        );
+  return { commands, strokes, strokeWidths, strokeDashes };
+}

package/src/actions/marks/point/create.js

@@ -0,0 +1,76 @@
+import { action } from "../../../core/action.js";
+import { validatePointShape } from "../../../grammar/pointShapes.js";
+import { getPointGraphicType } from "../../../grammar/schemas/mark.js";
+import { resolveMarkGraphicPlacement } from
+  "../../../materialization/graphicHierarchy.js";
+import {
+  applyLayeredMarkInheritance,
+  assertMarkAvailable,
+  materializeInheritedMark,
+  resolveLayeredMarkInheritance,
+  resolveMarkData,
+  resolveMarkId,
+  validateMarkOptions
+} from "../shared.js";
+
+const OPTIONS = Object.freeze([
+  "id", "data", "shape", "fill", "opacity", "stroke", "strokeWidth"
+]);
+
+export const createPointMark = action(
+  {
+    op: "createPointMark",
+    description: "Create a semantic point mark and concrete point graphics."
+  },
+  function (args = {}) {
+    validateMarkOptions(args, OPTIONS, "createPointMark");
+    const id = resolveMarkId(this, args.id, {
+      defaultId: "point",
+      label: "Point mark id",
+      markType: "point",
+      operation: "createPointMark"
+    });
+    const inherited = resolveLayeredMarkInheritance(this, args, "point");
+    const { data, dataset } = resolveMarkData(this, {
+      ...args,
+      ...(args.data === undefined &&
+        this.context.currentData === undefined &&
+        inherited?.data !== undefined
+        ? { data: inherited.data }
+        : {})
+    });
+    const shape = Object.hasOwn(args, "shape") ? args.shape : "circle";
+    validatePointShape(shape);
+    const resolvedType = getPointGraphicType(shape);
+    const graphicType = resolvedType === "path" ? "circle" : resolvedType;
+
+    assertMarkAvailable(this, id);
+
+    let next = this
+      .editSemantic({
+        property: `layer[${id}].mark.type`,
+        value: "point"
+      })
+      .editSemantic({
+        property: `layer[${id}].data`,
+        value: data
+      });
+    next = applyLayeredMarkInheritance(next, id, inherited)
+      .createGraphics({
+        id,
+        type: graphicType,
+        length: dataset.values.length,
+        ...resolveMarkGraphicPlacement(next, { data, markType: "point" })
+      })
+      ._withMarkConfig(id, { shape });
+    const created = materializeInheritedMark(next, id);
+    const appearance = Object.fromEntries(
+      ["fill", "opacity", "stroke", "strokeWidth"]
+        .filter(property => Object.hasOwn(args, property))
+        .map(property => [property, args[property]])
+    );
+    return Object.keys(appearance).length === 0
+      ? created
+      : created.editPointMark({ target: id, ...appearance });
+  }
+);

package/src/actions/marks/point/edit.js

@@ -0,0 +1,97 @@
+import { action } from "../../../core/action.js";
+import { validateUserId } from "../../../core/identifiers.js";
+import {
+  validateNonEmptyString,
+  validateNonNegativeFinite,
+  validateUnitInterval
+} from "../../../core/validation.js";
+import { validatePointShape } from "../../../grammar/pointShapes.js";
+import { findLayer } from "../../../selectors/layers.js";
+import { rematerializeExistingLegend } from "../../encodings/shared.js";
+import { validateMarkOptions } from "../shared.js";
+
+const OPTIONS = Object.freeze([
+  "target", "shape", "fill", "opacity", "stroke", "strokeWidth"
+]);
+
+export const editPointMark = action(
+  {
+    op: "editPointMark",
+    description: "Edit constant point-mark appearance."
+  },
+  function (args = {}) {
+    validateMarkOptions(args, OPTIONS, "editPointMark");
+    const editable = ["shape", "fill", "opacity", "stroke", "strokeWidth"];
+    if (!editable.some(property => Object.hasOwn(args, property))) {
+      throw new Error(
+        "editPointMark requires shape, fill, opacity, stroke, or strokeWidth."
+      );
+    }
+    const candidates = this.semanticSpec.layers.filter(
+      layer => layer.mark?.type === "point"
+    );
+    const current = findLayer(this, this.context.currentMark);
+    const requested = args.target ??
+      (current?.mark?.type === "point" ? current.id : undefined);
+    const inferred = requested ?? (candidates.length === 1
+      ? candidates[0].id
+      : undefined);
+    const id = validateUserId(inferred, "Point mark id");
+    const layer = findLayer(this, id);
+    if (layer?.mark?.type !== "point") {
+      throw new Error(`Unknown point mark "${id}".`);
+    }
+    if (Object.hasOwn(args, "shape") && layer.encoding?.shape !== undefined) {
+      throw new Error(
+        "editPointMark shape cannot be combined with a shape encoding."
+      );
+    }
+    if (Object.hasOwn(args, "fill") && layer.encoding?.color !== undefined) {
+      throw new Error(
+        "editPointMark fill cannot be combined with a color encoding."
+      );
+    }
+    const config = { ...this.markConfigs[id] };
+    if (Object.hasOwn(args, "shape")) {
+      config.shape = validatePointShape(args.shape);
+    }
+    if (Object.hasOwn(args, "fill")) {
+      config.fill = validateNonEmptyString(args.fill, "Point fill");
+    }
+    if (Object.hasOwn(args, "opacity")) {
+      config.opacity = validateUnitInterval(args.opacity, "Point opacity");
+    }
+    if (args.stroke === false && Object.hasOwn(args, "strokeWidth")) {
+      throw new Error(
+        "editPointMark cannot set strokeWidth while removing stroke."
+      );
+    }
+    if (Object.hasOwn(args, "stroke")) {
+      if (args.stroke === false) {
+        config.stroke = false;
+        delete config.strokeWidth;
+      } else {
+        const restoresStroke = config.stroke === false;
+        config.stroke = validateNonEmptyString(args.stroke, "Point stroke");
+        if (restoresStroke) config.strokeWidth = 1;
+        else config.strokeWidth ??= 1;
+      }
+    }
+    if (Object.hasOwn(args, "strokeWidth")) {
+      if (typeof config.stroke !== "string") {
+        throw new Error("Point strokeWidth requires an active stroke.");
+      }
+      config.strokeWidth = validateNonNegativeFinite(
+        args.strokeWidth,
+        "Point strokeWidth"
+      );
+    }
+    const next = this
+      ._withMarkConfig(id, config)
+      .rematerializePointMark({ id });
+    const legend = next.guideConfigs.legend?.series;
+    return legend?.target === id && legend.channels.includes("shape")
+      ? rematerializeExistingLegend(next)
+      : next;
+  }
+);

package/src/actions/marks/point/index.js

@@ -1 +1,11 @@
-export { registerPointMarkActions } from "./actions.js";
+import { createPointMark } from "./create.js";
+import { editPointMark } from "./edit.js";
+import { rematerializePointMark } from "./materialize.js";
+
+export { registerPointJitterActions } from "./jitter.js";
+
+export function registerPointMarkActions(ProgramClass) {
+  ProgramClass.prototype.createPointMark = createPointMark;
+  ProgramClass.prototype.editPointMark = editPointMark;
+  ProgramClass.prototype.rematerializePointMark = rematerializePointMark;
+}

package/src/actions/marks/point/jitter.js

@@ -0,0 +1,72 @@
+import { action } from "../../../core/action.js";
+import { validateUserId } from "../../../core/identifiers.js";
+import { validateKeys } from "../../../core/validation.js";
+import { normalizePointJitterPolicy } from "../../../grammar/jitter.js";
+import { findCoordinate } from "../../../selectors/coordinates.js";
+import { resolveEligibleLayer } from "../../../selectors/layers.js";
+
+const JITTER_OPTIONS = Object.freeze([
+  "target", "channel", "maxOffset", "seed", "key"
+]);
+const REMOVE_OPTIONS = Object.freeze(["target"]);
+
+function isCartesianPoint(program, layer, channel) {
+  return layer.mark?.type === "point" &&
+    layer.encoding?.[channel]?.scale !== undefined &&
+    layer.encoding?.[channel === "x" ? "y" : "x"]?.scale !== undefined &&
+    findCoordinate(program, layer.coordinate)?.type === "cartesian";
+}
+
+function resolveJitterTarget(program, target, channel) {
+  const requested = target === undefined
+    ? undefined
+    : validateUserId(target, "Point jitter target");
+  return resolveEligibleLayer(program, {
+    target: requested,
+    predicate: layer => isCartesianPoint(program, layer, channel),
+    label: "point jitter"
+  });
+}
+
+export const jitterPoints = action(
+  {
+    op: "jitterPoints",
+    description: "Apply deterministic bounded graphical jitter to a point mark."
+  },
+  function (args = {}) {
+    validateKeys(args, JITTER_OPTIONS, "jitterPoints");
+    const policy = normalizePointJitterPolicy(args);
+    const layer = resolveJitterTarget(this, args.target, policy.channel);
+    return this
+      ._withMaterializationConfig(["jitters", layer.id], policy)
+      .rematerializePointMark({ id: layer.id });
+  }
+);
+
+export const removeJitter = action(
+  {
+    op: "removeJitter",
+    description: "Remove point jitter and restore semantic scale positions."
+  },
+  function (args = {}) {
+    validateKeys(args, REMOVE_OPTIONS, "removeJitter");
+    const requested = args.target === undefined
+      ? undefined
+      : validateUserId(args.target, "Point jitter target");
+    const layer = resolveEligibleLayer(this, {
+      target: requested,
+      predicate: candidate =>
+        candidate.mark?.type === "point" &&
+        this.materializationConfigs.jitters?.[candidate.id] !== undefined,
+      label: "point jitter"
+    });
+    return this
+      ._withoutMaterializationConfig(["jitters", layer.id])
+      .rematerializePointMark({ id: layer.id });
+  }
+);
+
+export function registerPointJitterActions(ProgramClass) {
+  ProgramClass.prototype.jitterPoints = jitterPoints;
+  ProgramClass.prototype.removeJitter = removeJitter;
+}