ggaction 0.0.6 → 0.0.8

package/CHANGELOG.md

@@ -4,6 +4,47 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.8] - 2026-08-04
+
+### Added
+
+- Added immutable UTC time-unit derivation, semantic category ordering and reset, and partitioned moving mean/sum
+  windows with matching public actions, strict declarations, examples, and Current contracts.
+- Added the Tick mark lifecycle, point/Tick angle encoding, and non-negative centered area stacking with stable
+  Canvas, SVG, PNG, and PDF evidence.
+
+### Changed
+
+- Expanded the public example and documentation corpus with actual-data temporal, ordering, directional Tick,
+  centered-area, and multi-legend charts, plus installed-package coverage for their supported workflows.
+
+### Fixed
+
+- Replaced independent same-edge legend placement with deterministic shared right/left lanes and left-packed
+  top/bottom rows, aligning titles, symbols, and labels while preserving lifecycle convergence and compact margins.
+
+## [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 +176,8 @@ 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.8]: https://github.com/ggaction/ggaction/releases/tag/v0.0.8
+[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.8` 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.8",
   "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/categoryOrder/index.js

@@ -0,0 +1,111 @@
+import { action } from "../../core/action.js";
+import { validateUserId } from "../../core/identifiers.js";
+import { validateKeys } from "../../core/validation.js";
+import { findDataset } from "../../selectors/datasets.js";
+import { resolveEligibleLayer } from "../../selectors/layers.js";
+import { findScaleConsumers } from "../scales/consumers/index.js";
+import {
+  applyMaterializationPlan,
+  planScaleGuideRematerialization
+} from "../../materialization/dependencies.js";
+import { getMarkMaterializationStep } from "../../materialization/marks/index.js";
+import { buildMaterializationPlan } from "../../materialization/planner.js";
+import {
+  normalizeCategoryOrder,
+  resolveCategoryOrder
+} from "../../grammar/categoryOrder.js";
+
+const ORDER_OPTIONS = Object.freeze(["target", "channel", "values", "by", "direction"]);
+const REMOVE_OPTIONS = Object.freeze(["target", "channel"]);
+
+function resolveAssignment(program, args, operation, { activeOnly = false } = {}) {
+  if (!["x", "y"].includes(args.channel)) {
+    throw new Error(`${operation} channel must be x or y.`);
+  }
+  const requested = args.target === undefined
+    ? undefined
+    : validateUserId(args.target, "Mark id");
+  const layer = resolveEligibleLayer(program, {
+    target: requested,
+    label: "categorical position mark",
+    predicate: candidate => {
+      const encoding = candidate.encoding?.[args.channel];
+      return ["nominal", "ordinal"].includes(encoding?.fieldType) &&
+        typeof encoding.field === "string" && encoding.scale !== undefined &&
+        (!activeOnly || encoding.categoryOrder !== undefined);
+    }
+  });
+  const encoding = layer.encoding[args.channel];
+  const dataset = findDataset(program, layer.data);
+  if (dataset === undefined) {
+    throw new Error(`Mark "${layer.id}" requires an existing dataset.`);
+  }
+  const consumers = findScaleConsumers(program, encoding.scale);
+  const incompatible = consumers.find(consumer =>
+    consumer.layer.id !== layer.id &&
+    (consumer.layer.data !== layer.data || consumer.encoding.field !== encoding.field)
+  );
+  if (incompatible !== undefined) {
+    throw new Error(
+      `Category order scale "${encoding.scale}" has an incompatible shared consumer.`
+    );
+  }
+  return { layer, encoding, dataset };
+}
+
+function rematerializeAssignment(program, scaleId) {
+  const consumers = findScaleConsumers(program, scaleId);
+  return applyMaterializationPlan(program, buildMaterializationPlan({
+    scales: [{
+      op: "rematerializeScale",
+      args: { id: scaleId, guides: false, marks: false }
+    }],
+    marks: consumers.map(consumer =>
+      getMarkMaterializationStep(program, consumer.layer)
+    ),
+    guides: planScaleGuideRematerialization(program, scaleId)
+  }));
+}
+
+export const orderCategories = action(
+  { op: "orderCategories", description: "Assign semantic order to a categorical position." },
+  function (args = {}) {
+    validateKeys(args, ORDER_OPTIONS, "orderCategories");
+    const { layer, encoding, dataset } = resolveAssignment(this, args, "orderCategories");
+    const order = normalizeCategoryOrder(args);
+    resolveCategoryOrder(dataset.values, encoding.field, order);
+    const edited = this.editSemantic({
+      property: `layer[${layer.id}].encoding.${args.channel}.categoryOrder`,
+      value: order
+    });
+    return rematerializeAssignment(edited, encoding.scale);
+  }
+);
+
+export const removeCategoryOrder = action(
+  { op: "removeCategoryOrder", description: "Restore automatic category order." },
+  function (args = {}) {
+    validateKeys(args, REMOVE_OPTIONS, "removeCategoryOrder");
+    const { layer, encoding } = resolveAssignment(
+      this,
+      args,
+      "removeCategoryOrder",
+      { activeOnly: args.target === undefined }
+    );
+    if (encoding.categoryOrder === undefined) {
+      throw new Error(
+        `Mark "${layer.id}" ${args.channel} encoding has no category order assignment.`
+      );
+    }
+    const edited = this.editSemantic({
+        property: `layer[${layer.id}].encoding.${args.channel}.categoryOrder`,
+        remove: true
+      });
+    return rematerializeAssignment(edited, encoding.scale);
+  }
+);
+
+export function registerCategoryOrderActions(ProgramClass) {
+  ProgramClass.prototype.orderCategories = orderCategories;
+  ProgramClass.prototype.removeCategoryOrder = removeCategoryOrder;
+}

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/data/index.js

@@ -23,6 +23,10 @@ import {
 import { createIntervalData, materializeIntervalData } from "./interval.js";
 import { createHorizonData, materializeHorizonData } from "./horizon.js";
 import { createWindowData, materializeWindowData } from "./window.js";
+import {
+  createTimeUnitData,
+  materializeTimeUnitData
+} from "./timeUnit.js";
 import {
   createBin2DData,
   editBin2DData,
@@ -54,6 +58,8 @@ export function registerDataActions(ProgramClass) {
   ProgramClass.prototype.materializeHorizonData = materializeHorizonData;
   ProgramClass.prototype.createWindowData = createWindowData;
   ProgramClass.prototype.materializeWindowData = materializeWindowData;
+  ProgramClass.prototype.createTimeUnitData = createTimeUnitData;
+  ProgramClass.prototype.materializeTimeUnitData = materializeTimeUnitData;
   ProgramClass.prototype.createBin2DData = createBin2DData;
   ProgramClass.prototype.editBin2DData = editBin2DData;
   ProgramClass.prototype.materializeBin2DData = materializeBin2DData;