ggaction 0.0.11 → 0.0.13

package/CHANGELOG.md

@@ -4,6 +4,84 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.13] - 2026-09-07
+
+### Added
+
+- Added complete Pie/Donut, Area, Density, Horizon, Polar scatter and line,
+  Radar, Rug, Strip, Beeswarm, Raincloud, Interval, Regression, Dot,
+  Lollipop, Dumbbell, ECDF, Rose, and Radial Bar authoring families. Each
+  facade composes the same public data, mark, encoding, scale, guide, and
+  primitive actions available for lower-level authoring.
+- Added reusable summary, bin, fold, computed, stack, interval, and ECDF data
+  actions, plus immutable mark-data binding, filter removal, statistical-role
+  editing, deterministic point packing, and composite owner revision.
+- Added complete Cartesian, Polar, and Parallel component lifecycles; focused
+  legend content and layout editing; final-item labels; reference lines and
+  bands; annotations; shared formatting and explicit rotation units; program
+  themes; and opt-in Canvas fitting.
+- Added row-by-column facet grids, field repetition, whole-facet source
+  revision, and stable named-child insertion, removal, and reordering for
+  compositions.
+- Added action-card schema v3 for all 234 direct actions, with H0-H4 authoring
+  roles, observed direct-child relationships, direct editors, package entry
+  support, units, inference rules, and completion requirements.
+
+### Changed
+
+- Made complete-chart defaults and guide reuse compose predictably with
+  existing data, scales, coordinates, and explicitly authored guides while
+  retaining atomic errors for incompatible resources.
+- Separated series identity from color and other appearance, made temporal
+  input units explicit, preserved JSON group opt-outs, and exposed persistent
+  source, role, order, layout, theme, and guide recipes for rematerialization.
+- Expanded generated discovery, documentation, browser examples, renderer
+  evidence, installed-package checks, and the realistic corpus to cover the
+  complete 234-action hierarchy and its supported lifecycle combinations.
+
+### Fixed
+
+- Corrected horizontal Bar role inference and temporal declarations,
+  definition-only dataset diagnostics, Point and Bar stroke declarations,
+  internal action inventory coverage, and false-complete MCP chart results.
+- Prevented unrelated scales, guides, coordinates, or ambiguous resources from
+  being selected by authoring order, and preserved immutable rollback when a
+  data, role, scale, guide, selection, or composition revision is invalid.
+- Corrected Polar and radial measurement semantics, categorical and continuous
+  legend layout, hidden-title bounds, scale-family transitions, midpoint
+  mapping, text ownership, datum spans, numeric formatting, and replay after
+  Canvas, data, scale, filter, or theme changes.
+
+## [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
@@ -279,6 +357,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.13]: https://github.com/ggaction/ggaction/releases/tag/v0.0.13
+[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

package/README.md

@@ -157,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 125,000-byte gzip regression ceiling while
+creation path at or below the current 153,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
@@ -219,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/)
 
@@ -230,7 +231,7 @@ the extra discussion required before public API or architecture changes.
 
 ## Status and development
 
-> **Status:** `0.0.11` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **Status:** `0.0.13` 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

@@ -1 +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/"}}}
+{"$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","authoringRoles","wraps","editableVia","supports","units","inference","completionRequirements","options","callPatterns","snippet","errors","route"],"properties":{"schemaVersion":{"const":3},"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}}}},"authoringRoles":{"type":"array","minItems":1,"maxItems":5,"uniqueItems":true,"items":{"enum":["H0","H1","H2","H3","H4"]}},"wraps":{"type":"array","maxItems":20,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"}},"editableVia":{"type":"array","maxItems":20,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$"}},"supports":{"type":"object","additionalProperties":false,"required":["entryPoints"],"properties":{"entryPoints":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["default","basic"]}}}},"units":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["path","unit"],"properties":{"path":{"type":"string","minLength":1,"maxLength":80},"unit":{"enum":["logical-pixel","degree","angle","ratio","probability","count","calendar-unit","temporal-input","data-value","band-fraction"]}}}},"inference":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["input","strategy"],"properties":{"input":{"type":"string","minLength":1,"maxLength":80},"strategy":{"enum":["explicit","explicit-or-current","explicit-current-unique-or-error","documented-auto","documented-default"]}}}},"completionRequirements":{"type":"object","additionalProperties":false,"required":["state","requires","allowsEmpty"],"properties":{"state":{"enum":["complete","deferred","contextual","not-applicable"]},"requires":{"type":"array","maxItems":4,"uniqueItems":true,"items":{"type":"string","minLength":2,"maxLength":100}},"allowsEmpty":{"type":"boolean"}}},"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/"}}}