ggaction 0.0.6 → 0.0.7

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.7] - 2026-07-23
+
+### Added
+
+- Added the browser-safe `ggaction/basic` entry for creation-focused scatter, line, bar, histogram, and heatmap
+  programs, with matching TypeScript declarations and an enforced 120,000-byte gzip bundle budget.
+- Added browser-safe `ggaction/svg` output and Node-only `ggaction/pdf` single-page vector files, with matching
+  declarations, metadata/accessibility options, installed-consumer coverage, and Canvas/SVG/PNG/PDF visual evidence.
+
+### Changed
+
+- Applied the documented numeric font-weight normalization consistently across Canvas, SVG, PNG, and PDF rendering.
+- Generated the repository example index from the canonical chart catalog and reduced the LLM index to concise,
+  non-duplicated routes into exact runtime and support documentation.
+- Simplified Getting Started, grouped the support limitations by topic, and clarified the complete documentation
+  verification workflow for contributors.
+
+### Fixed
+
+- Corrected the Canvas target in troubleshooting guidance and documented complete, executable Canvas, SVG, PNG, and
+  PDF rendering flows with signatures generated from the public TypeScript declarations.
+
 ## [0.0.6] - 2026-07-23
 
 ### Added
@@ -135,6 +157,7 @@ All notable changes to `ggaction` are recorded in this file.
 - Cartesian charts are the complete current path. Polar semantic tokens exist only where explicitly documented and do
   not imply complete polar rendering.
 
+[0.0.7]: https://github.com/ggaction/ggaction/releases/tag/v0.0.7
 [0.0.6]: https://github.com/ggaction/ggaction/releases/tag/v0.0.6
 [0.0.5]: https://github.com/ggaction/ggaction/releases/tag/v0.0.5
 [0.0.4]: https://github.com/ggaction/ggaction/releases/tag/v0.0.4

package/README.md

@@ -1,6 +1,6 @@
 # ggaction
 
-[![npm version](https://img.shields.io/npm/v/ggaction.svg)](https://www.npmjs.com/package/ggaction) [![license](https://img.shields.io/npm/l/ggaction.svg)](./LICENSE) [![documentation](https://img.shields.io/badge/docs-ggaction.github.io-2563eb)](https://ggaction.github.io/ggaction/)
+[![npm version](https://img.shields.io/npm/v/ggaction.svg)](https://www.npmjs.com/package/ggaction) [![CI](https://github.com/ggaction/ggaction/actions/workflows/ci.yml/badge.svg)](https://github.com/ggaction/ggaction/actions/workflows/ci.yml) [![license](https://img.shields.io/npm/l/ggaction.svg)](./LICENSE) [![documentation](https://img.shields.io/badge/docs-ggaction.github.io-2563eb)](https://ggaction.github.io/ggaction/)
 
 ### A grammar for how charts are made.
 
@@ -12,11 +12,7 @@ Build, inspect, select, and revise charts one meaningful action at a time.
   <img src="./docs/assets/images/readme-authoring-sequence.gif" width="960" height="540" loading="eager" alt="A ggaction program progressively creates a scatterplot, adds grouped regression fits and confidence bands, highlights the Japan group across chart layers, and finishes with an R-squared annotation.">
 </p>
 
-Every frame is rendered from an immutable `ChartProgram`. The final R² label is a custom traceable action composed from ggaction's public extension primitives.
-
-```bash
-npm install ggaction
-```
+Every frame is rendered from an immutable `ChartProgram`. The final R² label is a traceable action built from public extension primitives.
 
 ## A grammar of graphical action
 
@@ -57,12 +53,24 @@ const program = chart()
 
 ## Quick start
 
+Install the current public release:
+
 ```bash
 npm install ggaction
 ```
 
+Add the Canvas element that the rendering code targets. Its accessible name and
+fallback text summarize the chart for contexts where Canvas pixels are not
+available:
+
+```html
+<canvas id="chart" aria-label="Scatterplot of displacement versus acceleration by origin">
+  Scatterplot of displacement versus acceleration by origin.
+</canvas>
+```
+
 ```javascript
-import { chart, render } from "ggaction";
+import { chart, render } from "ggaction/basic";
 
 const observations = [
   { displacement: 97, acceleration: 14.5, origin: "Japan" },
@@ -80,17 +88,58 @@ const program = chart()
   .createScatterPlot({
     x: "displacement",
     y: "acceleration",
-    color: "origin"
+    color: "origin",
+    shape: "origin"
   });
 
 const context = document.querySelector("#chart").getContext("2d");
 render(program, context);
 ```
 
+Matching color and shape encodings give each origin a redundant visual cue and
+create a labeled categorical legend automatically.
+
+The Quick Start uses the smaller `ggaction/basic` entry for the common creation
+path. Import from `ggaction` when you need editing, selection, composition,
+alternative coordinates, or statistical layers.
+
+### Branch revisions without mutation
+
+Start a separate program without a shape encoding, then derive alternatives
+without changing the checkpoint:
+
+```javascript
+import { chart as editableChart } from "ggaction";
+
+const checkpoint = editableChart()
+  .createCanvas({ width: 640, height: 400 })
+  .createData({ values: observations })
+  .createScatterPlot({
+    x: "displacement",
+    y: "acceleration",
+    color: "origin"
+  });
+
+const outlined = checkpoint.editPointMark({
+  stroke: "#0f172a",
+  strokeWidth: 2
+});
+const muted = checkpoint.editPointMark({ opacity: 0.35 });
+
+console.log(checkpoint === outlined); // false
+console.log(checkpoint.trace.children.at(-1).op); // "createScatterPlot"
+console.log(outlined.trace.children.at(-1).op);   // "editPointMark"
+```
+
+All three remain renderable and inspectable. They are immutable values, not an
+automatic undo stack; the application chooses which to retain or render.
+
 Use `createLinePlot`, `createBarPlot`, `createHistogram`, and `createHeatmap` for
-the other basic Cartesian charts. Each facade records the regular mark,
-encoding, and guide actions as trace children, and the same resource-specific
-actions remain available for later edits. See the
+the other basic Cartesian charts. The `ggaction/basic` entry keeps this common
+creation path below a 120,000-byte gzip bundle budget while each facade still
+records its mark, encoding, and guide actions as trace children. Import from
+`ggaction` when you need editing, selection, composition, alternative
+coordinates, or statistical layers. See the
 [Basic Charts API](https://ggaction.github.io/ggaction/api/basic-charts/).
 
 Use `createParallelCoordinates({ dimensions })` to connect each source row
@@ -115,7 +164,7 @@ open the [runnable Gapminder example](./examples/gapminder-horizon/).
 - Statistical layers and intervals
 - Faceting and program composition
 - Mark selection and coordinated highlighting
-- Browser Canvas and Node PNG output
+- Browser Canvas, SVG, Node PNG, and vector PDF output
 - TypeScript declarations and traceable extension actions
 
 See the current [supported features](https://ggaction.github.io/ggaction/supported-features/), [tutorials and examples](https://ggaction.github.io/ggaction/tutorials/), and [action reference](https://ggaction.github.io/ggaction/reference/actions/) for exact coverage. Runnable programs are collected in [`examples/`](./examples/README.md).
@@ -127,10 +176,14 @@ The package is ESM-only and requires Node.js 20 or later.
 | Entry | Purpose |
 | --- | --- |
 | `ggaction` | Create chart programs and render them to Browser Canvas |
+| `ggaction/basic` | Create and render scatter, line, bar, histogram, and heatmap charts with a smaller browser bundle |
 | `ggaction/extension` | Author wrapped actions with public low-level primitives |
 | `ggaction/png` | Render a completed program to a PNG file in Node.js |
+| `ggaction/pdf` | Render a completed program to a single-page vector PDF file in Node.js |
+| `ggaction/svg` | Serialize a completed program to browser-safe SVG |
 
-All entries include TypeScript declarations. The default entry is browser-safe; the PNG adapter is Node-only.
+All entries include TypeScript declarations. The default, basic, extension, and
+SVG entries are browser-safe; the PNG and PDF adapters are Node-only.
 
 ## Documentation
 
@@ -140,9 +193,15 @@ All entries include TypeScript declarations. The default entry is browser-safe;
 - [Concepts](https://ggaction.github.io/ggaction/concepts/chart-program/)
 - [Supported Features](https://ggaction.github.io/ggaction/supported-features/)
 
+## Contributing
+
+Bug reports, documentation improvements, examples, and focused code changes are
+welcome. Read [CONTRIBUTING.md](./CONTRIBUTING.md) for setup, scope, tests, and
+the extra discussion required before public API or architecture changes.
+
 ## Status and development
 
-> **Status:** `0.0.6` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **Status:** `0.0.7` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
 
 ```bash
 npm install
@@ -151,3 +210,7 @@ npm test
 npm run test:render
 npm run test:docs
 ```
+
+## Related Links
+
+- Action-trace demo: [Link](https://ggactionbot.github.io/action-trace-demo/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ggaction",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Build charts through immutable, traceable graphical actions.",
   "license": "MIT",
   "author": "Hyeon Jeon",
@@ -20,6 +20,7 @@
     "data-visualization"
   ],
   "type": "module",
+  "sideEffects": false,
   "files": [
     "src/",
     "!src/**/AGENTS.md",
@@ -34,6 +35,10 @@
       "types": "./types/index.d.ts",
       "default": "./src/index.js"
     },
+    "./basic": {
+      "types": "./types/basic.d.ts",
+      "default": "./src/basic.js"
+    },
     "./extension": {
       "types": "./types/extension.d.ts",
       "default": "./src/extension.js"
@@ -41,6 +46,14 @@
     "./png": {
       "types": "./types/png.d.ts",
       "default": "./src/renderers/png.js"
+    },
+    "./pdf": {
+      "types": "./types/pdf.d.ts",
+      "default": "./src/renderers/pdf.js"
+    },
+    "./svg": {
+      "types": "./types/svg.d.ts",
+      "default": "./src/renderers/svg.js"
     }
   },
   "scripts": {
@@ -56,6 +69,7 @@
     "test:coverage": "node scripts/run-tests.js coverage",
     "test:render": "node scripts/run-render-tests.js",
     "assets:readme": "node scripts/generate-readme-demo.js",
+    "artifacts:renderers": "node scripts/generate-renderer-comparison.js",
     "artifacts:clean": "node test/support/artifacts.js",
     "artifacts:gallery": "node scripts/generate-artifact-gallery.js",
     "artifacts:gallery:test": "node scripts/test-artifact-gallery.js",
@@ -74,13 +88,16 @@
     "docs:preflight": "node scripts/check-docs-environment.js",
     "docs:signatures": "node scripts/generate-doc-signatures.js",
     "docs:signatures:check": "node scripts/generate-doc-signatures.js --check",
-    "docs:generate": "npm run docs:signatures && npm run docs:capabilities && npm run docs:actions && npm run docs:reference && npm run docs:metadata && npm run docs:search && npm run docs:images && npm run docs:llms",
+    "examples:index": "node scripts/generate-examples-readme.js",
+    "examples:index:check": "node scripts/generate-examples-readme.js --check",
+    "docs:generate": "npm run examples:index && npm run docs:actions && npm run docs:reference && npm run docs:signatures && npm run docs:capabilities && npm run docs:metadata && npm run docs:search && npm run docs:images && npm run docs:llms",
     "docs:build": "bundle exec jekyll build --source docs --destination _site --baseurl /ggaction",
     "docs:verify": "npm run docs:preflight && npm run docs:generate && npm run test:docs && npm run docs:build && npm run test:docs:built && npm run test:docs:browser",
     "contracts:catalog": "node scripts/generate-action-catalog.js",
     "contracts:catalog:check": "node scripts/generate-action-catalog.js --check",
     "package:check": "node scripts/package-artifact.js --check",
     "package:pack": "node scripts/package-artifact.js --pack",
+    "package:bundle": "node scripts/measure-browser-bundle.js",
     "test:package": "node scripts/package-consumer.js",
     "release:notes": "node scripts/release-notes.js"
   },

package/src/BasicChartProgram.js

@@ -0,0 +1,10 @@
+import { registerBasicActions } from "./actions/basic.js";
+import { ChartProgram as CoreChartProgram } from "./core/ChartProgram.js";
+
+class BasicChartProgram extends CoreChartProgram {}
+
+registerBasicActions(BasicChartProgram);
+
+export function chart() {
+  return new BasicChartProgram();
+}

package/src/actions/basic.js

@@ -0,0 +1,21 @@
+import { registerBasicCanvasActions } from "./canvas/index.js";
+import { registerBasicChartActions } from "./charts/basic.js";
+import { registerCoordinateActions } from "./coordinates/index.js";
+import { registerBasicDataActions } from "./data/basic.js";
+import { registerBasicEncodingActions } from "./encodings/basic.js";
+import { registerBasicGuideActions } from "./guides/basic.js";
+import { registerBasicMarkActions } from "./marks/basic.js";
+import { registerPrimitiveActions } from "./primitives/index.js";
+import { registerBasicScaleActions } from "./scales/index.js";
+
+export function registerBasicActions(ProgramClass) {
+  registerPrimitiveActions(ProgramClass);
+  registerBasicCanvasActions(ProgramClass);
+  registerBasicDataActions(ProgramClass);
+  registerBasicMarkActions(ProgramClass);
+  registerBasicScaleActions(ProgramClass);
+  registerBasicEncodingActions(ProgramClass);
+  registerCoordinateActions(ProgramClass);
+  registerBasicGuideActions(ProgramClass);
+  registerBasicChartActions(ProgramClass);
+}

package/src/actions/canvas/actions.js

@@ -146,3 +146,45 @@ export const createCanvas = action(
     });
   }
 );
+
+export const createBasicCanvas = action(
+  {
+    op: "createCanvas",
+    description: "Create and configure the chart canvas."
+  },
+  function (args = {}) {
+    validateOptions(args, "createCanvas", { allowEmpty: true });
+    assertCanvasHierarchyAvailable(this);
+    const state = {
+      width: Object.hasOwn(args, "width") ? args.width : DEFAULT_CANVAS.width,
+      height: Object.hasOwn(args, "height") ? args.height : DEFAULT_CANVAS.height,
+      background: Object.hasOwn(args, "background")
+        ? args.background
+        : DEFAULT_CANVAS.background,
+      margin: normalizeMargin(args.margin, DEFAULT_MARGIN),
+      size: {
+        width: Object.hasOwn(args, "width") ? "explicit" : "auto",
+        height: Object.hasOwn(args, "height") ? "explicit" : "auto"
+      }
+    };
+    validateCanvasState(state);
+    let next = this
+      .createGraphics({
+        id: CANVAS_GRAPHIC_ID,
+        type: "canvas"
+      })
+      .createGraphics({
+        id: PLOT_GRAPHIC_ID,
+        type: "collection",
+        parent: CANVAS_GRAPHIC_ID
+      });
+    for (const property of ["width", "height", "background"]) {
+      next = next.editGraphics({
+        target: CANVAS_GRAPHIC_ID,
+        property,
+        value: state[property]
+      });
+    }
+    return next._withCanvasConfig({ margin: state.margin, size: state.size });
+  }
+);

package/src/actions/canvas/index.js

@@ -1,6 +1,10 @@
-import { createCanvas, editCanvas } from "./actions.js";
+import { createBasicCanvas, createCanvas, editCanvas } from "./actions.js";
 
 export function registerCanvasActions(ProgramClass) {
   ProgramClass.prototype.editCanvas = editCanvas;
   ProgramClass.prototype.createCanvas = createCanvas;
 }
+
+export function registerBasicCanvasActions(ProgramClass) {
+  ProgramClass.prototype.createCanvas = createBasicCanvas;
+}

package/src/actions/charts/basic.js

@@ -0,0 +1,13 @@
+import { createBarPlot } from "./bar.js";
+import { createHeatmap } from "./heatmap.js";
+import { createHistogram } from "./histogram.js";
+import { createLinePlot } from "./line.js";
+import { createScatterPlot } from "./scatter.js";
+
+export function registerBasicChartActions(ProgramClass) {
+  ProgramClass.prototype.createBarPlot = createBarPlot;
+  ProgramClass.prototype.createHeatmap = createHeatmap;
+  ProgramClass.prototype.createHistogram = createHistogram;
+  ProgramClass.prototype.createScatterPlot = createScatterPlot;
+  ProgramClass.prototype.createLinePlot = createLinePlot;
+}

package/src/actions/data/basic.js

@@ -0,0 +1,11 @@
+import { createData } from "./create.js";
+import { createDerivedData } from "./derived.js";
+import { createBasicBin2DData } from "./basicBin2d.js";
+import { materializeBin2DData } from "./bin2dMaterialize.js";
+
+export function registerBasicDataActions(ProgramClass) {
+  ProgramClass.prototype.createData = createData;
+  ProgramClass.prototype.createDerivedData = createDerivedData;
+  ProgramClass.prototype.createBin2DData = createBasicBin2DData;
+  ProgramClass.prototype.materializeBin2DData = materializeBin2DData;
+}

package/src/actions/data/basicBin2d.js

@@ -0,0 +1,43 @@
+import { action } from "../../core/action.js";
+import { validateUserId } from "../../core/identifiers.js";
+import { validateKeys } from "../../core/validation.js";
+import {
+  deriveBin2DRows,
+  normalizeBin2DTransform
+} from "../../grammar/bin2d.js";
+import { findDataset } from "../../selectors/datasets.js";
+
+const OPTIONS = Object.freeze([
+  "id", "source", "x", "y", "bins", "extent", "includeEmpty", "members", "as"
+]);
+
+export const createBasicBin2DData = action(
+  {
+    op: "createBin2DData",
+    description: "Create immutable rectangular 2D-bin values."
+  },
+  function (args = {}) {
+    validateKeys(args, OPTIONS, "createBin2DData");
+    const owner = validateUserId(args.id, "2D bin dataset id");
+    if (this.materializationConfigs.data?.bin2d?.[owner] !== undefined) {
+      throw new Error(`2D bin owner "${owner}" already exists.`);
+    }
+    const source = validateUserId(
+      args.source ?? this.context.currentData,
+      "Source dataset id"
+    );
+    const dataset = findDataset(this, source);
+    if (dataset?.values === undefined) {
+      throw new Error(`Source dataset "${source}" has no values.`);
+    }
+    const transform = normalizeBin2DTransform({ ...args, id: owner });
+    deriveBin2DRows(dataset.values, transform);
+    return this
+      .createDerivedData({ id: owner, source, transform: [transform] })
+      .materializeBin2DData({ id: owner })
+      ._withMaterializationConfig(
+        ["data", "bin2d", owner],
+        { current: owner }
+      );
+  }
+);

package/src/actions/data/bin2d.js

@@ -14,7 +14,7 @@ import {
   findDataset,
   findDatasetConsumer
 } from "../../selectors/datasets.js";
-import { MATERIALIZE_OPTIONS, requireDerivedDataset } from "./shared.js";
+export { materializeBin2DData } from "./bin2dMaterialize.js";
 
 const OPTIONS = Object.freeze([
   "id", "source", "x", "y", "bins", "extent", "includeEmpty", "members", "as"
@@ -160,31 +160,6 @@ function applyBin2DRevision(program, { owner, previous, source, transform }) {
   );
 }
 
-export const materializeBin2DData = action(
-  {
-    op: "materializeBin2DData",
-    description: "Materialize one immutable rectangular 2D-bin dataset."
-  },
-  function (args = {}) {
-    validateKeys(args, MATERIALIZE_OPTIONS, "materializeBin2DData");
-    const { id, source, transform } = requireDerivedDataset(
-      this,
-      args.id,
-      "bin2d"
-    );
-    const result = deriveBin2DRows(source.values, transform);
-    return this
-      .editSemantic({
-        property: `dataset[${id}].transform`,
-        value: [{ ...transform, resolved: result.resolved }]
-      })
-      .editSemantic({
-        property: `dataset[${id}].values`,
-        value: result.values
-      });
-  }
-);
-
 export const createBin2DData = action(
   {
     op: "createBin2DData",

package/src/actions/data/bin2dMaterialize.js

@@ -0,0 +1,29 @@
+import { action } from "../../core/action.js";
+import { validateKeys } from "../../core/validation.js";
+import { deriveBin2DRows } from "../../grammar/bin2d.js";
+import { MATERIALIZE_OPTIONS, requireDerivedDataset } from "./shared.js";
+
+export const materializeBin2DData = action(
+  {
+    op: "materializeBin2DData",
+    description: "Materialize one immutable rectangular 2D-bin dataset."
+  },
+  function (args = {}) {
+    validateKeys(args, MATERIALIZE_OPTIONS, "materializeBin2DData");
+    const { id, source, transform } = requireDerivedDataset(
+      this,
+      args.id,
+      "bin2d"
+    );
+    const result = deriveBin2DRows(source.values, transform);
+    return this
+      .editSemantic({
+        property: `dataset[${id}].transform`,
+        value: [{ ...transform, resolved: result.resolved }]
+      })
+      .editSemantic({
+        property: `dataset[${id}].values`,
+        value: result.values
+      });
+  }
+);

package/src/actions/encodings/appearance.js

@@ -277,12 +277,16 @@ const encodeOpacity = action(
   }
 );
 
+export function registerBasicAppearanceEncodingActions(ProgramClass) {
+  ProgramClass.prototype.encodeSize = encodeSize;
+  ProgramClass.prototype.encodeShape = encodeShape;
+}
+
 export function registerAppearanceEncodingAction(ProgramClass) {
+  registerBasicAppearanceEncodingActions(ProgramClass);
   ProgramClass.prototype.encodeRadius = encodeRadius;
   ProgramClass.prototype.encodePointRadius = encodePointRadius;
   ProgramClass.prototype.removePointRadius = removePointRadius;
-  ProgramClass.prototype.encodeSize = encodeSize;
-  ProgramClass.prototype.encodeShape = encodeShape;
   ProgramClass.prototype.encodeOpacity = encodeOpacity;
   ProgramClass.prototype.clearOpacityEncoding = clearOpacityEncoding;
 }

package/src/actions/encodings/basic.js

@@ -0,0 +1,21 @@
+import { registerBasicAppearanceEncodingActions } from "./appearance.js";
+import { registerBarWidthEncodingAction } from "./barWidth.js";
+import { registerColorEncodingAction } from "./color/index.js";
+import { registerHistogramEncodingAction } from "./histogram.js";
+import { registerOffsetEncodingAction } from "./offset.js";
+import {
+  registerCartesianPositionEncodingActions
+} from "./position/index.js";
+import { registerBasicRangedEncodingActions } from "./ranged.js";
+import { registerStrokeDashEncodingActions } from "./strokeDash.js";
+
+export function registerBasicEncodingActions(ProgramClass) {
+  registerCartesianPositionEncodingActions(ProgramClass);
+  registerBasicRangedEncodingActions(ProgramClass);
+  registerColorEncodingAction(ProgramClass);
+  registerBasicAppearanceEncodingActions(ProgramClass);
+  registerStrokeDashEncodingActions(ProgramClass);
+  registerOffsetEncodingAction(ProgramClass);
+  registerHistogramEncodingAction(ProgramClass);
+  registerBarWidthEncodingAction(ProgramClass);
+}

package/src/actions/encodings/position/index.js

@@ -135,9 +135,13 @@ const encodeR = action(
   }
 );
 
-export function registerPositionEncodingActions(ProgramClass) {
+export function registerCartesianPositionEncodingActions(ProgramClass) {
   ProgramClass.prototype.encodeX = encodeX;
   ProgramClass.prototype.encodeY = encodeY;
+}
+
+export function registerPositionEncodingActions(ProgramClass) {
+  registerCartesianPositionEncodingActions(ProgramClass);
   ProgramClass.prototype.encodeTheta = encodeTheta;
   ProgramClass.prototype.encodeR = encodeR;
 }

package/src/actions/encodings/ranged.js

@@ -291,10 +291,14 @@ const encodeGroup = action(
   }
 );
 
-export function registerRangedEncodingActions(ProgramClass) {
+export function registerBasicRangedEncodingActions(ProgramClass) {
   ProgramClass.prototype.encodeX2 = encodeX2;
   ProgramClass.prototype.encodeY2 = encodeY2;
+  ProgramClass.prototype.encodeGroup = encodeGroup;
+}
+
+export function registerRangedEncodingActions(ProgramClass) {
+  registerBasicRangedEncodingActions(ProgramClass);
   ProgramClass.prototype.encodeXRange = encodeXRange;
   ProgramClass.prototype.encodeYRange = encodeYRange;
-  ProgramClass.prototype.encodeGroup = encodeGroup;
 }

package/src/actions/guides/axes/index.js

@@ -14,7 +14,7 @@ import {
 } from "./remove.js";
 import { registerParallelAxisActions } from "./parallel.js";
 
-export function registerGuideAxisActions(ProgramClass) {
+export function registerBasicCartesianAxisActions(ProgramClass) {
   registerAxisLineActions(ProgramClass);
   registerAxisTickActions(ProgramClass);
   registerAxisLabelActions(ProgramClass);
@@ -22,10 +22,18 @@ export function registerGuideAxisActions(ProgramClass) {
   registerAxisTitleActions(ProgramClass);
   registerAxisActions(ProgramClass);
   registerAxisCollectionActions(ProgramClass);
+}
+
+export function registerCartesianAxisActions(ProgramClass) {
+  registerBasicCartesianAxisActions(ProgramClass);
   registerCompleteAxisEditActions(ProgramClass);
-  registerParallelAxisActions(ProgramClass);
   ProgramClass.prototype.removeXAxis = removeXAxis;
   ProgramClass.prototype.removeYAxis = removeYAxis;
+}
+
+export function registerGuideAxisActions(ProgramClass) {
+  registerCartesianAxisActions(ProgramClass);
+  registerParallelAxisActions(ProgramClass);
   ProgramClass.prototype.removeThetaAxis = removeThetaAxis;
   ProgramClass.prototype.removeRadialAxis = removeRadialAxis;
 }

package/src/actions/guides/basic.js

@@ -0,0 +1,19 @@
+import { registerBasicCartesianAxisActions } from "./axes/index.js";
+import { registerGuideCollectionActions } from "./guides.js";
+import { registerBasicGridActions } from "./grids/index.js";
+import {
+  registerBasicCategoricalLegendActions
+} from "./legends/categorical/index.js";
+import {
+  registerGradientLegendActions
+} from "./legends/continuous/index.js";
+import { registerSizeLegendActions } from "./legends/size.js";
+
+export function registerBasicGuideActions(ProgramClass) {
+  registerBasicCartesianAxisActions(ProgramClass);
+  registerBasicCategoricalLegendActions(ProgramClass);
+  registerGradientLegendActions(ProgramClass);
+  registerSizeLegendActions(ProgramClass);
+  registerBasicGridActions(ProgramClass);
+  registerGuideCollectionActions(ProgramClass);
+}

package/src/actions/guides/grids/grid.js

@@ -343,13 +343,17 @@ const removeGrid = action(
 );
 
 export function registerGridActions(ProgramClass) {
-  ProgramClass.prototype.createGrid = createGrid;
-  ProgramClass.prototype.createHorizontalGrid = createHorizontalGrid;
-  ProgramClass.prototype.createVerticalGrid = createVerticalGrid;
+  registerBasicGridActions(ProgramClass);
   ProgramClass.prototype.editHorizontalGrid = editHorizontalGrid;
   ProgramClass.prototype.editVerticalGrid = editVerticalGrid;
   ProgramClass.prototype.editGrid = editGrid;
   ProgramClass.prototype.removeGrid = removeGrid;
+}
+
+export function registerBasicGridActions(ProgramClass) {
+  ProgramClass.prototype.createGrid = createGrid;
+  ProgramClass.prototype.createHorizontalGrid = createHorizontalGrid;
+  ProgramClass.prototype.createVerticalGrid = createVerticalGrid;
   ProgramClass.prototype.rematerializeGrid = rematerializeGrid;
   ProgramClass.prototype.rematerializeHorizontalGrid =
     rematerializeHorizontalGrid;

package/src/actions/guides/grids/index.js

@@ -1 +1 @@
-export { registerGridActions } from "./grid.js";
+export { registerBasicGridActions, registerGridActions } from "./grid.js";