ggaction 0.0.10 → 0.0.12

package/CHANGELOG.md

@@ -4,6 +4,101 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.12] - 2026-09-03
+
+### Added
+
+- Added direct quantitative theta encodings for Polar arc marks, producing one
+  proportional sector per positive row with deterministic order, validation,
+  selection, rematerialization, strict types, and executable documentation.
+- Added quantitative independent positions for explicit error bars and
+  categorical `xOffset`/`yOffset` grouping for points, rules, and complete
+  point-and-whisker charts. Inferred intervals now reuse the source offset
+  field, scale, padding, and statistical grouping.
+- Added Context7 project metadata, ownership verification, bounded indexing
+  rules, and manual or release-triggered documentation refresh automation.
+
+### Changed
+
+- Sharded the realistic data corpus across seven CI jobs and removed duplicate
+  coverage work from the ordinary test job, while retaining the complete
+  release qualification suite.
+- Updated the locked `fast-uri` and `qs` dependency lines and retained a clean
+  production dependency audit across the supported Node.js package matrix.
+
+### Fixed
+
+- Kept grouped points, whisker rules, and fixed-width caps on the same
+  categorical sub-slot after Canvas, scale, offset-scale, and data changes.
+- Preserved an explicitly authored shared facet legend at its child
+  `left`, `right`, `top`, or `bottom` edge, including horizontal alignment and
+  the correct width-versus-height reservation after composition layout edits.
+
+## [0.0.11] - 2026-09-02
+
+### Added
+
+- Added production guidance for accessibility, compatibility, responsive
+  layout, performance, data refresh, error recovery, version provenance,
+  fonts, and strict TypeScript use.
+- Published versioned action cards, task-packet schemas, the exact
+  `ChartProgram` declaration, and a hashed LLM section manifest as deployed
+  machine-readable documentation artifacts.
+- Added binned quantitative line aggregates with shared position-scale reuse,
+  stable series grouping, path ordering, selection, and rematerialization
+  behavior.
+- Added text labels for complete arc sectors, with anchors derived from final
+  annular geometry and replay after Canvas, scale, padding, or inner-radius
+  changes.
+- Added a provenance-verified 50-source TidyTuesday corpus and deterministic
+  smoke, deep, and realistic scenario runners for data, mark, encoding, guide,
+  scale, lifecycle, facade, and renderer qualification.
+
+### Changed
+
+- Expanded compact action cards with exact option type strings and upgraded
+  MCP task packets with package provenance, applied options, explicit
+  placeholders, and unmatched-requirement preservation.
+- Expanded chart-intent resolution for area, Horizon, pie, donut, rose, radar,
+  Polar axes, accessibility, responsive output, common option values, and
+  broader unsupported interaction and animation wording.
+- Expanded documentation search and the LLM routing index from prose-only
+  excerpts to complete canonical-page and technical-symbol coverage.
+- Inferred quantitative versus nominal bar positions from field-string
+  shorthand, inferred omitted rule datum types from scalar values, and allowed
+  compatible datum rules to share grouped or stacked measure scales.
+- Hardened transforms, scales, layouts, selections, legends, and Canvas, PNG,
+  SVG, and PDF rendering with deterministic finite-value, cardinality,
+  geometry, native-backend, and output-size boundaries.
+- Updated the Canvas runtime and browser build dependencies while preserving
+  explicit package and browser-bundle headroom across supported platforms.
+
+### Fixed
+
+- Rewrote full LLM-bundle links and images against deployed canonical routes,
+  preserved links authored with HTML/Liquid, and exposed deterministic section
+  hashes and source-status metadata.
+- Corrected the one-transform `DatasetTransform` documentation, all eight
+  public transform branches, legend placement support, duplicated chart
+  figures, generated action anchors, navigation order, and leaked internal
+  instruction files.
+- Prevented incompatible area stroke-dash steps from appearing as executable
+  MCP output and stopped silently dropping recognized numeric, layout,
+  accessibility, and interaction requirements.
+- Rematerialized every complete mark that consumes a shared automatic position
+  scale when a new ranged consumer expands its domain, keeping inherited error
+  bands aligned with existing lines.
+- Preserved direct quantitative line values at their row grain instead of
+  collapsing repeated positions through the aggregate-line path.
+- Aligned temporal bar annotations with their final geometry, spanned temporal
+  axis baselines across the plot, and composed multi-part UTC tick formats
+  without losing date or time components.
+- Preserved encoded ranged-bar outlines and the default or encoded radius of
+  path-shaped points across materialization and rendering.
+- Kept discretized heatmap domains nondegenerate, reserved data-aware facet
+  guide space, and made realistic gallery charts readable without weakening
+  the diagnostic corpus.
+
 ## [0.0.10] - 2026-08-11
 
 ### Added
@@ -214,6 +309,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.12]: https://github.com/ggaction/ggaction/releases/tag/v0.0.12
+[0.0.11]: https://github.com/ggaction/ggaction/releases/tag/v0.0.11
 [0.0.10]: https://github.com/ggaction/ggaction/releases/tag/v0.0.10
 [0.0.9]: https://github.com/ggaction/ggaction/releases/tag/v0.0.9
 [0.0.8]: https://github.com/ggaction/ggaction/releases/tag/v0.0.8

package/README.md

@@ -54,7 +54,8 @@ const program = chart()
 ## MCP server for LLM
 
 ggaction includes a local, read-only MCP server that gives coding assistants
-current action names, exact call shapes, and task-specific authoring steps
+current action names, syntax-valid call templates, explicit placeholders, and
+task-specific authoring steps
 without loading the complete documentation.
 
 <p align="left">
@@ -156,7 +157,7 @@ automatic undo stack; the application chooses which to retain or render.
 
 Use `createLinePlot`, `createBarPlot`, `createHistogram`, and `createHeatmap` for
 the other basic Cartesian charts. The `ggaction/basic` entry keeps this common
-creation path at or below the current 120,000-byte gzip regression ceiling while
+creation path at or below the current 125,000-byte gzip regression ceiling while
 each facade still records its mark, encoding, and guide actions as trace
 children. Import from
 `ggaction` when you need editing, selection, composition, alternative
@@ -218,6 +219,7 @@ browser entry. See the [local MCP guide](https://ggaction.github.io/ggaction/mcp
 - [Tutorials and Examples](https://ggaction.github.io/ggaction/tutorials/)
 - [Action Reference](https://ggaction.github.io/ggaction/reference/actions/)
 - [Local MCP for LLM Chart Authoring](https://ggaction.github.io/ggaction/mcp/)
+- [Context7 library](https://context7.com/ggaction/ggaction) — use the library ID `/ggaction/ggaction`
 - [Concepts](https://ggaction.github.io/ggaction/concepts/chart-program/)
 - [Supported Features](https://ggaction.github.io/ggaction/supported-features/)
 
@@ -229,7 +231,7 @@ the extra discussion required before public API or architecture changes.
 
 ## Status and development
 
-> **Status:** `0.0.10` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **Status:** `0.0.12` 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/knowledge/action-card.schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://ggaction.github.io/ggaction/schemas/action-card.schema.json","title":"ggaction compact action card","type":"object","additionalProperties":false,"required":["schemaVersion","name","layer","domain","summary","signature","intents","lifecycle","resources","options","callPatterns","snippet","errors","route"],"properties":{"schemaVersion":{"const":2},"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"},"layer":{"enum":["user-facing","advanced","primitive"]},"domain":{"type":"string","minLength":1},"summary":{"type":"string","minLength":20,"maxLength":420},"signature":{"type":"string","minLength":10},"intents":{"type":"array","minItems":3,"maxItems":7,"uniqueItems":true,"items":{"type":"string","minLength":2,"maxLength":80}},"lifecycle":{"type":"string","minLength":3},"resources":{"type":"object","additionalProperties":false,"required":["prerequisites","owns","idOptions"],"properties":{"prerequisites":{"type":"array","maxItems":4,"uniqueItems":true,"items":{"type":"string","minLength":2,"maxLength":100}},"owns":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"type":"string","minLength":2,"maxLength":80}},"idOptions":{"type":"array","maxItems":10,"uniqueItems":true,"items":{"type":"string","minLength":2,"maxLength":30}}}},"options":{"type":"array","maxItems":40,"items":{"type":"object","additionalProperties":false,"required":["name","required","type"],"properties":{"name":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"},"required":{"type":"boolean"},"type":{"type":"string","minLength":1,"maxLength":500}}}},"callPatterns":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":260}},"snippet":{"type":"string","minLength":3,"maxLength":700},"errors":{"type":"array","maxItems":2,"items":{"type":"object","additionalProperties":false,"required":["error","fix"],"properties":{"error":{"type":"string","minLength":5,"maxLength":220},"fix":{"type":"string","minLength":5,"maxLength":220}}}},"route":{"type":"string","pattern":"^/reference/"}}}