ggaction 0.0.15 → 0.0.16

package/CHANGELOG.md

@@ -4,6 +4,74 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.16] - 2026-09-14
+
+### Added
+
+- Added `reviseData` for immutable original-data revisions that update dependent
+  transforms, chart owners, scales, guides, labels, selections, and retained facets.
+- Added `applyTextMetrics` and `removeTextMetrics` for host-measured text layout
+  with immutable exact-font profiles, deterministic fallback, composition
+  propagation, and wrapped typography rematerialization.
+- Added browser-safe `ggaction/persistence` with versioned editable-program and
+  graphic-only snapshots, tagged value preservation, and strict restoration.
+- Added browser-safe `ggaction/accessibility` with immutable final visual data,
+  component roles, aggregate/bin/interval values, series, and composition hierarchy.
+- Added `ggaction/diagnostics` to read structured error codes and resource details
+  while preserving the original Error, TypeError, or RangeError identity.
+- Added `renderToPNGBuffer` and `renderToPDFBuffer` for Node memory output.
+  PNG encoding is asynchronous; Canvas drawing remains synchronous.
+- Added `release:prepare` for reviewable version, changelog, release-contract,
+  provenance, and generated-documentation updates without publishing side effects.
+- Added reproducible runtime benchmarks, exhaustive direct-action negative-input
+  contracts, semantic authoring evaluations, and cross-platform/browser checks.
+
+### Changed
+
+- **Installation:** Node rendering and MCP dependencies are now optional peers.
+  Canvas/SVG users can install only `ggaction`. Node PNG/PDF users must also install
+  `@napi-rs/canvas`; MCP users must also install `@modelcontextprotocol/sdk`.
+  Missing backends report the required install command and never auto-install.
+- MCP task packets now use schema version 5. Required options are separate from
+  example/configured options, exact calls preserve explicit user choices, and
+  unresolved request fragments remain visible. Consumers must check packet versions.
+- Reused owned immutable subtrees, avoided unrelated theme traversal, shared
+  persistent trace tails, and cached immutable SVG resource hashes. Mutable
+  renderer inputs still recompute their hashes.
+- Reduced Basic browser bundle size through built-in factory tree shaking and
+  shared validation/materialization code. Existing browser gzip limits remain.
+- Release verification now distributes one canonical candidate artifact across
+  independent source, coverage, package, documentation, platform, browser, and
+  weighted realistic-test jobs, then requires a strict successful aggregate.
+- Added a strict realistic-test aggregate check and bounded failure evidence for
+  test logs, render differences, and browser screenshots. Verification errors
+  retain their original failing status.
+- Consolidated architecture prose around ownership and state flow, with exact
+  action behavior linked to current contracts and shared metadata owners.
+
+### Fixed
+
+- Rejected callable, mutable class-instance, cyclic, and sparse source inputs
+  before they could escape immutable ownership or fail during materialization.
+  TypeScript source-row declarations now match the runtime data boundary.
+- Rejected unknown options consistently in extension primitives and renderers,
+  including PNG, and validated axis coordinate/channel assertions before changes.
+- Corrected padding units for focused scale editors using one canonical registry.
+- Corrected MCP required-option inference, explicit style/scale choices, derived
+  owner references, and false-completion reporting for partially understood tasks.
+- Preserved nested facet trace closure and prototype-named keys during snapshot
+  round trips, and distinguished live dependencies from reserved optional IDs.
+- Distinguished data and mark identity when revising statistical-reference inputs.
+  Inferred grids now follow explicit tick changes without disrupting orientation
+  changes that must rematerialize guides in dependency order.
+- Applied the same interval-statistics merge during simultaneous role edits,
+  clearing inherited confidence-interval parameters when changing extent.
+- Reused the exact release artifact in installed-package consumers instead of
+  silently repacking it, and made development npm/TypeScript invocation portable
+  across supported operating systems.
+- Bounded long CSV description memory in realistic test fixtures and synchronized
+  their direct action coverage and coordinate options with current contracts.
+
 ## [0.0.15] - 2026-09-14
 
 ### Added

package/README.md

@@ -89,6 +89,10 @@ Install the current public release:
 npm install ggaction
 ```
 
+For Node PNG/PDF output, also install `@napi-rs/canvas`. For the MCP server,
+also install `@modelcontextprotocol/sdk`. These are optional peer dependencies;
+browser Canvas/SVG users do not need either package.
+
 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:
@@ -211,11 +215,14 @@ The package is ESM-only and requires Node.js 20 or later.
 | `ggaction/extension` | Author and register 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/persistence` | Save and restore editable programs or graphic snapshots in Browser or Node |
+| `ggaction/accessibility` | Export final visual data for host-provided accessible tables and descriptions |
+| `ggaction/diagnostics` | Read structured error codes and resource details in Browser or Node |
 | `ggaction/svg` | Serialize a completed program to browser-safe SVG |
 | `ggaction-mcp` | Run the local read-only MCP authoring server over stdio in Node.js |
 
 All module entries include TypeScript declarations. The default, basic,
-extension, and SVG entries are browser-safe; the PNG and PDF adapters are
+extension, diagnostics, accessibility, and SVG entries are browser-safe; the PNG and PDF adapters are
 Node-only.
 
 The installed package also includes the Node-only `ggaction-mcp` executable. It
@@ -240,7 +247,7 @@ the extra discussion required before public API or architecture changes.
 
 ## Status and development
 
-> **Status:** `0.0.15` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **Status:** `0.0.16` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
 
 ```bash
 npm install
@@ -253,3 +260,16 @@ npm run test:docs
 ## Related Links
 
 - Action-trace demo: [Link](https://ggactionbot.github.io/action-trace-demo/)
+
+### Prepare a release
+
+Record changes under `Unreleased` in `CHANGELOG.md` and commit the reviewed work.
+Run `npm run release:prepare -- 0.0.16 --dry-run` to preview version updates.
+Omit `--dry-run` to update versions, promote notes, and generate the release
+contract, documentation, and local notes. Review the Git diff. After committing
+runtime changes, rerun the command to refresh source provenance; existing notes
+and their date are preserved.
+
+Preparation does not commit, push, tag, publish, or deploy. Integration and required
+PR checks precede an annotated tag. The protected workflow verifies and publishes
+one candidate from that tag. Generation failures leave an unfinished diff to review.