ggaction 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -4,6 +4,59 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [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
+
+- Added complete `createScatterPlot`, `createLinePlot`, `createBarPlot`, `createHistogram`, `createHeatmap`, and
+  `createParallelCoordinates` facades that reuse ordinary mark, encoding, scale, coordinate, and guide actions.
+- Added deterministic point jitter, ordered line paths, collision-aware text labels, field-driven rule widths, and
+  weighted Polar sectors with immutable rematerialization across data, scale, Canvas, selection, and facet changes.
+- Added window and rectangular 2D-bin data actions, binned heatmaps, categorical density and violin plots, Horizon
+  charts, Parallel Coordinates, and density-filled gradient plots with Browser Canvas and Node PNG parity.
+- Added backend-neutral item-local gradient paint, expanded public declarations and action contracts, and runnable
+  chart examples for every new capability.
+
+### Changed
+
+- Aligned Box Plot with the shared facade inference, ambiguity, public option-type, and opt-in guide contracts while
+  preserving its existing omitted-guide behavior.
+- Reorganized source, test, documentation, and internal architecture ownership around explicit policies and capability
+  registries without changing the renderer's concrete `graphicSpec` boundary.
+- Expanded public documentation with task-oriented API routing, generated split action references, improved mobile and
+  no-JavaScript navigation, complete facade discovery, and release-scoped deployment checks.
+
+### Fixed
+
+- Materialized the documented default point radius, made direct quantitative line x/y authoring order-independent, and
+  made layered datum rules resolve to the expected full-span geometry instead of an empty result.
+- Kept sticky documentation deep links below the top bar by sharing one computed fragment offset between CSS and the
+  page table of contents.
+
 ## [0.0.4] - 2026-07-19
 
 ### Changed
@@ -82,6 +135,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.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
 [0.0.2]: https://github.com/ggaction/ggaction/releases/tag/v0.0.2

package/README.md

@@ -38,10 +38,13 @@ import { chart } from "ggaction";
 const program = chart()
   .createCanvas()
   .createData({ values: cars })
-  .createPointMark({ id: "points" })
-  .encodeX({ field: "Displacement" })
-  .encodeY({ field: "Acceleration" })
-  .encodeColor({ field: "Origin" })
+  .createScatterPlot({
+    id: "points",
+    x: "Displacement",
+    y: "Acceleration",
+    color: "Origin",
+    guides: false
+  })
   .createRegression()
   .createGuides();
 ```
@@ -74,22 +77,41 @@ const program = chart()
     margin: { top: 30, right: 130, bottom: 60, left: 70 }
   })
   .createData({ values: observations })
-  .createPointMark()
-  .encodeX({ field: "displacement" })
-  .encodeY({ field: "acceleration" })
-  .encodeColor({ field: "origin" })
-  .encodeRadius({ value: 4 })
-  .createGuides();
+  .createScatterPlot({
+    x: "displacement",
+    y: "acceleration",
+    color: "origin"
+  });
 
 const context = document.querySelector("#chart").getContext("2d");
 render(program, context);
 ```
 
-For the advanced version, follow the [regression recipe](https://ggaction.github.io/ggaction/recipes/regression-scatterplot/) or open the [runnable example](./examples/cars-regression-scatterplot/).
+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
+[Basic Charts API](https://ggaction.github.io/ggaction/api/basic-charts/).
+
+Use `createParallelCoordinates({ dimensions })` to connect each source row
+across ordered, dimension-local scales and axes. See the
+[Parallel Coordinates API](https://ggaction.github.io/ggaction/api/parallel-coordinates/)
+or the [runnable Cars example](./examples/cars-parallel-coordinates/).
+
+For an advanced layered example, follow the [regression recipe](https://ggaction.github.io/ggaction/recipes/regression-scatterplot/)
+or open the [runnable regression example](./examples/cars-regression-scatterplot/).
+To compare category distributions with density-filled strips, read the
+[gradient-plot guide](https://ggaction.github.io/ggaction/api/gradient-plots/)
+or open the [runnable example](./examples/cars-gradient-plot/).
+For symmetric or split density shapes centered on categories, use the
+[violin-plot API](https://ggaction.github.io/ggaction/api/violin-plots/) or the
+[runnable Cars example](./examples/cars-acceleration-violins/).
+For compact signed time-series bands, use `encodeHorizon` on an area mark and
+open the [runnable Gapminder example](./examples/gapminder-horizon/).
 
 ## What it supports
 
-- Cartesian and polar charts
+- Cartesian, Polar, and Parallel-coordinate charts
 - Statistical layers and intervals
 - Faceting and program composition
 - Mark selection and coordinated highlighting
@@ -120,7 +142,7 @@ All entries include TypeScript declarations. The default entry is browser-safe;
 
 ## Status and development
 
-> **Status:** `0.0.4` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **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).
 
 ```bash
 npm install

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ggaction",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Build charts through immutable, traceable graphical actions.",
   "license": "MIT",
   "author": "Hyeon Jeon",
@@ -22,7 +22,7 @@
   "type": "module",
   "files": [
     "src/",
-    "!src/AGENTS.md",
+    "!src/**/AGENTS.md",
     "types/",
     "README.md",
     "CHANGELOG.md",
@@ -54,19 +54,29 @@
     "test:docs:built": "node scripts/check-built-docs.js _site",
     "test:docs:browser": "node scripts/test-built-docs.js _site",
     "test:coverage": "node scripts/run-tests.js coverage",
-    "test:render": "node test/support/artifacts.js && node scripts/run-tests.js render && node scripts/generate-roadmap-gallery.js && node scripts/test-roadmap-gallery.js",
+    "test:render": "node scripts/run-render-tests.js",
     "assets:readme": "node scripts/generate-readme-demo.js",
-    "artifacts:gallery": "node scripts/generate-roadmap-gallery.js",
-    "artifacts:gallery:test": "node scripts/test-roadmap-gallery.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",
     "docs:images": "node scripts/generate-doc-images.js",
     "docs:llms": "node scripts/generate-llm-docs.js",
     "docs:capabilities": "node scripts/generate-doc-capabilities.js",
     "docs:capabilities:check": "node scripts/generate-doc-capabilities.js --check",
+    "docs:actions": "node scripts/generate-doc-action-metadata.js",
+    "docs:actions:check": "node scripts/generate-doc-action-metadata.js --check",
+    "docs:search": "node scripts/generate-doc-search-index.js",
+    "docs:search:check": "node scripts/generate-doc-search-index.js --check",
+    "docs:reference": "node scripts/generate-doc-action-reference.js",
+    "docs:reference:check": "node scripts/generate-doc-action-reference.js --check",
+    "docs:metadata": "node scripts/generate-doc-page-metadata.js",
+    "docs:metadata:check": "node scripts/generate-doc-page-metadata.js --check",
+    "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:images && npm run docs:llms",
+    "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",
     "docs:build": "bundle exec jekyll build --source docs --destination _site --baseurl /ggaction",
-    "docs:verify": "npm run docs:generate && npm run test:docs && npm run docs:build && npm run test:docs:built && npm run test:docs:browser",
+    "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",
@@ -86,6 +96,7 @@
     "@napi-rs/canvas": "^1.0.2"
   },
   "devDependencies": {
+    "@axe-core/playwright": "^4.12.1",
     "es-module-lexer": "^1.7.0",
     "gifenc": "^1.0.3",
     "playwright": "^1.61.1",

package/src/actions/boxPlots/create.js

@@ -1,7 +1,7 @@
 import { action } from "../../core/action.js";
 import { validateKeys } from "../../core/validation.js";
-import { findDataset } from "../../selectors/datasets.js";
 import { findSemanticScale } from "../../selectors/scales.js";
+import { resolveFacadeData } from "../charts/shared.js";
 import {
   BOX_PLOT_OPTIONS,
   boxEncodingArgs,
@@ -9,6 +9,7 @@ import {
   resolveBoxMedianAppearance,
   resolveBoxOutlierAppearance,
   resolveBoxPosition,
+  resolveBoxGuides,
   resolveBoxWhisker,
   resolveBoxWidth
 } from "./options.js";
@@ -26,11 +27,14 @@ export const createBoxPlot = action(
   function (args = {}) {
     validateKeys(args, BOX_PLOT_OPTIONS, "createBoxPlot");
     const id = resolveBoxPlotId(this, args.id);
-    const source = resolveBoxSourceLayer(this, args.target);
-    const data = args.data ?? source?.data ?? this.context.currentData;
-    if (findDataset(this, data) === undefined) {
-      throw new Error("createBoxPlot requires data or one inferable dataset.");
-    }
+    const source = resolveBoxSourceLayer(this, args.target, {
+      requiresInference: args.x === undefined || args.y === undefined
+    });
+    const data = resolveFacadeData(
+      this,
+      args.data ?? source?.data,
+      "createBoxPlot"
+    );
     const x = resolveBoxPosition(args.x, "x") ?? source?.encoding?.x;
     const y = resolveBoxPosition(args.y, "y") ?? source?.encoding?.y;
     const whisker = resolveBoxWhisker(args.whisker);
@@ -41,6 +45,7 @@ export const createBoxPlot = action(
     const box = resolveBoxAppearance(args.box);
     const median = resolveBoxMedianAppearance(args.median);
     const outlier = resolveBoxOutlierAppearance(args.outlier);
+    const guides = resolveBoxGuides(args.guides);
     if (x !== undefined && y !== undefined && resolveBoxOrientation(x, y) === undefined) {
       throw new Error(
         "createBoxPlot requires one categorical axis and one quantitative axis."
@@ -62,7 +67,8 @@ export const createBoxPlot = action(
         outliers: args.outliers ?? true,
         box,
         median,
-        outlier
+        outlier,
+        guides
       }
     });
     if (x !== undefined) {