ggaction 0.0.12 → 0.0.15

package/CHANGELOG.md

@@ -4,6 +4,132 @@ All notable changes to `ggaction` are recorded in this file.
 
 ## Unreleased
 
+## [0.0.15] - 2026-09-14
+
+### Added
+
+- Added independent field-driven stroke color for Point, Line, Area, Bar, Rect,
+  Arc, Rule, and Tick marks, including categorical and continuous scales,
+  focused scale editing, legends, selections, facets, and renderer parity.
+- Added logarithmic, square-root, power, quantize, quantile, and threshold
+  point-size scales with equal-area geometry, focused scale editing, complete
+  interval legends, source replay, strict types, and installed-package support.
+
+- Added normalization and missing-data workflows with `createNormalizedData`,
+  `createCompleteData`, and `createImputedData`. Computed expressions now support
+  typed scalar/null results, comparisons, conditions, and short-circuit logic;
+  calendar buckets and windows have explicit time and ordering policies.
+- Added immutable derived revision editing: `editDerivedData`, `editComputedData`,
+  `editFilteredData`, `editFoldData`, `editSummaryData`, `editBinData`,
+  `editTimeUnitData`, `editWindowData`, `editDensityData`, `editStackData`,
+  `editRegressionData`, `editIntervalData`, `editECDFData`, `editNormalizedData`,
+  `editCompleteData`, and `editImputedData`. An existing descendant rejects an
+  edit by default; `dependents: "recompute"` rebuilds the full affected closure.
+- Added focused scale editing with `editXScale`, `editYScale`, `editThetaScale`,
+  `editRScale`, `editColorScale`, `editStrokeScale`, `editSizeScale`,
+  `editOpacityScale`, `editShapeScale`, `editStrokeWidthScale`,
+  `editStrokeDashScale`, `editXOffsetScale`, `editYOffsetScale`, and
+  `editParallelScale`. These select the channel owner and replay its consumers.
+- Added `encodeChannels` for atomic multi-channel reassignment; `editCoordinate`
+  for Cartesian aspect and Polar frame changes; and `editLegendBlock` for one
+  identified block of a composite legend.
+- Added `editMarkLabelSelection`, `editMarkLabelPlacement`, and `removeMarkLabels`.
+  Label selection now works on final aggregated items; semantic placement follows
+  directed boundaries through source, scale, and layout changes.
+- Added explicit safe removal with `removeData`, `removeScale`, and
+  `removeCoordinate`. A live dependency produces an ownership-path error; remove
+  or rebind consumers before removing the resource.
+- Added weighted summaries, bins, histogram/KDE authoring and revisions; dynamic
+  statistical reference lines/bands; exact sampled legend values; typed display
+  label maps; facet-header role/side/alignment controls; custom theme tokens;
+  detailed stroke styles, rounded rectangles, and expanded Polar/Parallel facets.
+
+### Changed
+
+- Clarified the action/program grammar, relative action hierarchy, and
+  decision-level atomicity. Catalog role tags are distinguished from action
+  delegation and package exposure.
+- Resource removal actions now record their semantic deletions as `editSemantic`
+  children. The full extension primitive accepts whole unused source datasets
+  and coordinates while retaining dependency guards and immutable snapshots.
+- Point-size ranges represent area across continuous and discrete families.
+  Entering a discrete size family requires a destination domain and range;
+  repeated field assignments preserve compatible scale settings.
+- Axis, legend, and facet display labels preserve raw category identity. Mapping
+  `"KR"` to `"South Korea"` changes visible text while grouping, selection, and
+  domain lookup still use `"KR"`. Numeric and UTC formats must match field type.
+- Custom themes supply defaults while explicit mark styles retain precedence.
+  Removing a theme restores baseline defaults and retains explicit overrides.
+- Complete guides can be created progressively without duplicating existing
+  compatible components. Polar/Parallel repetition retains source recipes and
+  rejects unsupported role substitutions explicitly.
+- Documentation now distinguishes released API snapshots from later development,
+  provides an exact address and declaration for every action, and executes every
+  maintained tutorial and recipe against the packaged module. See
+  [migration notes](https://ggaction.github.io/ggaction/version/#migration-from-v0013).
+
+### Fixed
+
+- Prevented typing immediately after a failed search-index prefetch from sending
+  an implicit retry. Each explicit retry now sends one request even when the
+  first failure arrives before the input event.
+- Corrected the README's canvas margins for its complete 406-row example and
+  documented regression defaults beside the example. The hierarchy tutorial now
+  refines its high-level chart and demonstrates a subsequent style revision.
+- Corrected default dumbbell axis titles, direct Rose radius refinement, and stale
+  current-guide pointers after removal.
+- Corrected executable examples, API defaults and compatibility descriptions,
+  missing gallery/tutorial entries, exact-action search, initial ArrowUp selection,
+  filter/TOC synchronization, search retries, and narrow-screen type references.
+
+## [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
@@ -309,6 +435,7 @@ 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

package/README.md

@@ -16,15 +16,14 @@ Every frame is rendered from an immutable `ChartProgram`. The final R² label is
 
 ## A grammar of graphical action
 
-Actions are verbs:
+An action expresses a design operation on a chart element. In
+`editLineMark({ strokeWidth: 4 })`, `edit` is the operation, `LineMark` names
+the target concept, and the option supplies the design choice.
 
-`create · transform · encode · edit · select · compose`
-
-Chart resources are nouns:
-
-`data · marks · scales · coordinates · guides`
-
-A `ChartProgram` is the immutable sentence they produce.
+The grammar has two units: **graphical actions** and **chart programs**.
+A program composes action calls in authoring order and retains their resulting
+immutable state. Authors read a linear sequence of decisions; an action may
+delegate to smaller actions recorded in its nested execution trace.
 
 The following fragment assumes `cars` is an array of row objects:
 
@@ -32,7 +31,11 @@ The following fragment assumes `cars` is an array of row objects:
 import { chart } from "ggaction";
 
 const program = chart()
-  .createCanvas()
+  .createCanvas({
+    width: 760,
+    height: 480,
+    margin: { top: 40, right: 190, bottom: 70, left: 80 }
+  })
   .createData({ values: cars })
   .createScatterPlot({
     id: "points",
@@ -45,6 +48,12 @@ const program = chart()
   .createGuides();
 ```
 
+Here `createRegression()` infers groups from the point layer, uses a linear
+model, and includes a 95% mean-response interval band. The right margin reserves
+space for the resulting legend. The [regression recipe](https://ggaction.github.io/ggaction/recipes/regression-scatterplot/)
+provides data and rendering setup; [regression options](https://ggaction.github.io/ggaction/api/regression/)
+control grouping, model, interval, and whether a band is drawn.
+
 ## Why actions?
 
 - **Progressive** — build and revise a chart one meaningful operation at a time.
@@ -157,7 +166,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 175,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
@@ -231,7 +240,7 @@ the extra discussion required before public API or architecture changes.
 
 ## Status and development
 
-> **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).
+> **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).
 
 ```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/"}}}