ggaction 0.0.5 → 0.0.7

package/CHANGELOG.md

@@ -4,6 +4,52 @@ 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
+
+- Added explicit edit and removal lifecycles for encodings, point appearance, selections, highlights, legends, and
+  Cartesian axis components while preserving immutable state and meaningful action traces.
+- Added revision workflows for 2D bins, interval statistics, regression, density, box plots, gradient plots, and facet
+  policies, including deterministic rematerialization after data-role and layout changes.
+
+### Changed
+
+- Expanded installed-package, Browser Canvas, Node PNG, TypeScript, action-contract, and cross-capability coverage for
+  the complete authoring lifecycle surface.
+- Improved documentation entry points, navigation, chart discovery, gallery filtering, responsive presentation, and
+  generated API routing for the completed lifecycle actions.
+
+### Fixed
+
+- Preserved unaffected shared-legend channels when selectively removing an encoding, and prevented removed resources
+  from returning after later rematerialization or facet replay.
+- Kept documentation search results under the deployed `/ggaction/` base path and improved gallery text contrast.
+- Allowed the approved Polar chart ink bounds to absorb the observed 1.5-pixel platform rasterization variance while
+  retaining exact primitive/public pixel comparisons and the existing density, color, and region checks.
+
 ## [0.0.5] - 2026-07-21
 
 ### Added
@@ -111,6 +157,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.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
 [0.0.3]: https://github.com/ggaction/ggaction/releases/tag/v0.0.3

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.5` 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.5",
+  "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);
+}