ggaction 0.0.17 → 0.0.19

package/CHANGELOG.md

@@ -4,6 +4,102 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.19] - 2026-10-17
+
+### Added
+
+- Named independent Cartesian axes retain their own scales, physical sides,
+  frame offsets, labels and titles across edits, facets and editable snapshots.
+  Complete axes support dashed ticks and per-value dash maps; focused text
+  editors support explicit alignment, baselines and along-axis title offsets.
+- Facet parents can declare and edit a shared legend against the complete plot
+  union without enlarging individual panels. Selected blocks retain independent
+  anchors through layout and data replay.
+- Added sampled size label maps, explicit categorical size-shape legend
+  combinations, channel-selected text editors, dashed legend borders,
+  independent gradient directions and bottom titles.
+- Compatible same-field quantitative color and point-size encodings can share
+  one sampled legend with one label list; both original scale mappings remain
+  independent through edits, splitting, replay and editable snapshots.
+- Sampled point-bearing legends support a clipping window without shrinking
+  encoded areas. Explicit symbol-layer opacity applies once to the complete
+  fill and outline, including SVG, Canvas, PNG and glyph-only PDF rasterization.
+- Added native wedge and arrow point shapes with consistent area and anchors.
+- Continuous color scales support signed-power transforms, cubehelix lightness
+  gamma and an explicit D50 white point for Lab/HCL interpolation. Existing
+  interpolation defaults and original-value legend labels are preserved.
+- Computed expressions support calendar-year extraction and finite floor.
+  Exponential regression fits positive responses through existing regression APIs.
+- `createRegressionStatisticsData` exposes observation counts, coefficients and
+  R-squared from the same linear fit. `editRegressionStatisticsData` replays
+  consumers atomically; editable snapshots retain compact fit statistics.
+- Point layers preserve up to 50,000 selected observations and summaries retain
+  up to 30,000 groups without reducing source data; editing, facets and snapshots
+  retain those bounded results.
+- Added opt-in difference compositing through `editBarMark`, with one source
+  for fill and outline, concrete SVG/Canvas output and glyph-only PDF rasterization.
+
+### Fixed
+
+- Closed Canvas rectangle outlines at all four corners so the first corner
+  uses its authored join instead of two open end caps.
+- Combining categorical size and shape legends rejects conflicting inherited
+  block anchors unless the author explicitly repositions the combined block.
+- Binned heatmaps preserve disabled axis titles and named axis arrays through
+  the same guide-owner validation used by other Cartesian charts.
+- Facet parents restore each legend block's sampling window independently and
+  composed child windows preserve valid private graphic identities.
+- Overflowing documentation signatures support keyboard scrolling and retain
+  accessible focus at mobile widths.
+- Unattached ordinal scale edits validate palette ranges like creation, including
+  rebuilding Raincloud colors without losing their channel-specific checks.
+
+## [0.0.18] - 2026-10-17
+
+### Added
+
+- Added target-owned legend block layouts and plot-relative placement, sampled
+  symbols for continuous color legends, aligned legend titles, and explicit
+  gradient-strip opacity.
+- Added square-root continuous color scales, field opacity on bars, structured
+  gradient fills for bars and areas, categorical grid boundaries, and explicit
+  mark draw ranks.
+- Added computed scalar `getPath`, `replaceLiteral`, explicit numeric conversion
+  and calendar-date parsing; source datasets preserve unnamed columns losslessly.
+- Added grouped mean imputation, calendar interval widths for temporal bars,
+  collision-checked inferred transform roles, and an optional inset plot border.
+- Added compact heatmap and weighted-arc scaffolds. Individual paths now accept
+  up to 20,000 commands without reducing observations.
+- Box plots accept precomputed five-field summaries, fixed pixel box and median
+  widths, and whisker cap/stroke styling through creation and editing.
+- Added full-entry `createTextPlot` for independent data text with position,
+  content, color, appearance and compatible guides in one composed action.
+
+### Fixed
+
+- Corrected rotated Cartesian label anchors, label containment, typed tick label
+  maps and colors, axis offsets, multiline titles, and title/label ink clearance.
+- Aligned side legend tops with plot bounds and shared facet legends with panel
+  plots. Restored independent legend placement, horizontal-guide clearance,
+  combined typography, sampled color guides, and finite size-symbol strokes.
+- Reduced default vertical legend spacing while preserving conservative label
+  clearance; corrected multiline and empty title/label materialization.
+- Preserved explicit temporal bar positions, shared measure scales for overlaid
+  bars, repeated observations during key completion, and text field bindings on
+  empty datasets with declared schemas.
+- Honored facet title offsets and bounds without changing immutable composition
+  ownership or renderer responsibilities.
+- Inferred Y-axis title ink clearance no longer introduces label collisions in
+  tight fixed margins. Automatic fitting retains space for the ink reserve.
+- Cartesian axis titles now materialize explicit hard line breaks before bounds
+  checks, preserving line order through edits, resizing, facets and snapshots.
+- Updated the optional MCP SDK pin to 1.32.1 and refreshed affected transitive
+  dependencies to resolve the remaining dependency audit findings.
+- Canvas now renders the existing `none` fill/stroke/background keyword as no
+  paint instead of retaining a preceding opaque color.
+- Canvas skips zero-width outlines and lines instead of reusing the preceding
+  positive line width.
+
 ## [0.0.17] - 2026-09-15
 
 ### Added

package/README.md

@@ -170,7 +170,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 175,000-byte gzip regression ceiling while
+creation path at or below the current 204,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
@@ -248,7 +248,7 @@ the extra discussion required before public API or architecture changes.
 
 ## Status and development
 
-> **Status:** `0.0.17` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
+> **Status:** `0.0.19` is the current experimental public release. APIs may change before `1.0.0`; changes are recorded in the [changelog](./CHANGELOG.md).
 
 ```bash
 npm install
@@ -258,6 +258,10 @@ npm run test:render
 npm run test:docs
 ```
 
+The renderer development suite also needs Poppler's `pdftoppm` on `PATH` for
+independent PDF pixel checks. The CI and protected release jobs install
+`poppler-utils` explicitly; this is not a runtime package dependency.
+
 ## Related Links
 
 - Action-trace demo: [Link](https://ggactionbot.github.io/action-trace-demo/)

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","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/"}}}
+{"$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":3,"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/"}}}