Published-release documentation · release compatibility

Statistical Layer Actions

Each declared action has an exact signature and its own stable link. Option tables are generated from types; behavior prose names the owning workflow and its constraints. API layers and H0–H4 catalog role tags are independent classifications. Relative action hierarchy is determined by composition, not by a tag or fixed trace depth.

createSummaryData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createSummaryData(options: SummaryDataOptions): ChartProgram;

Named option contracts: SummaryDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createSummaryData({ id, source?, groupBy?, aggregates, members? })

Materialize reusable, first-appearance-ordered summary rows from one or more shared aggregate operations. Nonweighted mean CI outputs also accept seeded percentile bootstrap method objects; see bootstrap mean intervals. Source and Derived Data

createBinData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createBinData(options: BinDataOptions): ChartProgram;

Named option contracts: BinDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createBinData({ id, source?, field, maxBins? | step | boundaries, extent?, nice?, zero?, includeEmpty?, members?, as? })

Materialize reusable one-dimensional bounds, counts, and optional source members using the same edge rules as Histogram. Source and Derived Data

createLookupData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.24. See release compatibility.

createLookupData(options: LookupDataOptions): ChartProgram;

Named option contracts: LookupDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createLookupData({ id, source?, field, lookup: { data, key, fields, as? } })

Copy fields from one named table without changing primary row order or count. Keys keep their scalar types; unmatched rows receive null, and duplicate reference keys reject. Full and Basic support creation. Named table lookup

createFlattenData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.24. See release compatibility.

createFlattenData(options: FlattenDataOptions): ChartProgram;

Named option contracts: FlattenDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createFlattenData({ id, source?, fields, as? })

Expand parallel array columns into index-aligned rows; shorter arrays pad with null. Retain raw ancestors and original row/index order. Full and Basic support creation. Aligned array data

createFoldData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createFoldData(options: FoldDataOptions): ChartProgram;

Named option contracts: FoldDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createFoldData({ id, source?, fields, as? })

Materialize selected wide fields as stable key/value rows while preserving every source cell. Source and Derived Data

createComputedData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createComputedData(options: ComputedDataOptions): ChartProgram;

Named option contracts: ComputedDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createComputedData({ id, source?, as, expression })

Materialize a typed primitive or null field from a serializable, closed expression, including explicit nested scalar getPath and first-occurrence replaceLiteral operations. Source and Derived Data

createNormalizedData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.24. See release compatibility.

createNormalizedData(options: NormalizedDataOptions): ChartProgram;

Named option contracts: NormalizedDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createNormalizedData({ id, source?, field, as, groupBy?, method, variance?, zeroDenominator?, baseline?, sortBy? })

Materialize row-preserving share, z-score, min-max, index, change, or fractional percent-change values independently within each group. Source and Derived Data

createSortedData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.24. See release compatibility.

createSortedData(options: SortedDataOptions): ChartProgram;

Named option contracts: SortedDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createSortedData({ id, source?, sortBy })

Create immutable rows in stable multi-key order. Each key controls direction, null placement, and quantitative, categorical, or temporal comparison. Source and derived data

createCompleteData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.24. See release compatibility.

createCompleteData(options: CompleteDataOptions): ChartProgram;

Named option contracts: CompleteDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createCompleteData({ id, source?, key, groupBy?, values?, sequence?, fill?, members? })

Complete one typed key domain independently inside every observed group, with explicit fill and source-membership provenance for synthesized rows. Source and Derived Data

createImputedData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.24. See release compatibility.

createImputedData(options: ImputedDataOptions): ChartProgram;

Named option contracts: ImputedDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createImputedData({ id, source?, fields, groupBy?, sortBy?, method?, value?, edges?, maxGap? })

Replace nullish cells by group mean (the default), constant, forward, backward, or distance-based linear imputation while preserving group boundaries and final source order. Source and Derived Data

createStackData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createStackData(options: StackDataOptions): ChartProgram;

Named option contracts: StackDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createStackData({ id?, source?, category, group, value, mode?, as? })

Materialize reusable start/end/value/share rows with the same stack math used by Bar and Area layouts. Source and Derived Data

editComputedData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editComputedData(options: EditComputedDataOptions): ChartProgram;

Named option contracts: EditComputedDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editLookupData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editLookupData(options: EditLookupDataOptions): ChartProgram;

Named option contracts: EditLookupDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editFlattenData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editFlattenData(options: EditFlattenDataOptions): ChartProgram;

Named option contracts: EditFlattenDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editFoldData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editFoldData(options: EditFoldDataOptions): ChartProgram;

Named option contracts: EditFoldDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editSummaryData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editSummaryData(options: EditSummaryDataOptions): ChartProgram;

Named option contracts: EditSummaryDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editBinData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editBinData(options: EditBinDataOptions): ChartProgram;

Named option contracts: EditBinDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editStackData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editStackData(options: EditStackDataOptions): ChartProgram;

Named option contracts: EditStackDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editIntervalData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editIntervalData(options: EditIntervalDataOptions): ChartProgram;

Named option contracts: EditIntervalDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editECDFData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editECDFData(options: EditECDFDataOptions): ChartProgram;

Named option contracts: EditECDFDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editNormalizedData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editNormalizedData(options: EditNormalizedDataOptions): ChartProgram;

Named option contracts: EditNormalizedDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editSortedData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editSortedData(options: EditSortedDataOptions): ChartProgram;

Named option contracts: EditSortedDataOptions.

Behavior, inference, resets, and errors: Focused core data editing.

editCompleteData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editCompleteData(options: EditCompleteDataOptions): ChartProgram;

Named option contracts: EditCompleteDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

editImputedData

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.24. See release compatibility.

editImputedData(options: EditImputedDataOptions): ChartProgram;

Named option contracts: EditImputedDataOptions.

Behavior, inference, resets, and errors: Focused statistical data editing.

createIntervalData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createIntervalData(options: IntervalDataOptions): ChartProgram;

Named option contracts: IntervalDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createIntervalData({
  id, source?, field, groupBy?, center?, extent?, method?, level?, missing?, as?
})

Create immutable grouped center/lower/upper summary rows. Mean supports standard error, sample standard deviation, and normal, Student-t or explicitly seeded percentile-bootstrap confidence intervals; median supports interquartile range. Data

createECDFData

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createECDFData(options: ECDFDataOptions): ChartProgram;

Named option contracts: ECDFDataOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createECDFData({ id, source?, field, groupBy?, weight?, missing?, as? })

Create immutable sorted support, cumulative count or weight, and probability rows. Ties are aggregated, group order follows first source appearance, and resolved provenance stores every positive denominator. Data

createRegression

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createRegression(options?: RegressionOptions): ChartProgram;

Named option contracts: RegressionOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createRegression({
  target?, x?, y?, groupBy?, method?, degree?, span?, robustIterations?,
  confidenceMethod?, level?, confidence?, interval?, band?, line?
})

Infer an eligible point layer and create immutable fitted data, optional grouped interval-band paths, and grouped line paths. Method defaults to "linear"; polynomial degree to 2; LOESS span to 0.75 and robustIterations to 0. Regression

editRegression

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editRegression(options: EditRegressionOptions): ChartProgram;

Named option contracts: EditRegressionOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

editRegression({
  target?, data?, x?, y?, groupBy?, method?, degree?, span?, robustIterations?,
  confidenceMethod?, level?, confidence?, interval?, band?, line?
})

Revise the model through its stable point owner. Data-role or statistical changes create and rebind one immutable derived-data revision; groupBy: false removes grouping. Component-only changes retain the current fitted rows. Regression

createErrorBar

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createErrorBar(options?: ErrorBarOptions): ChartProgram;

Named option contracts: ErrorBarOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createErrorBar({
  id?, target?, data?, x?, y?, xOffset?, yOffset?, groupBy?, coordinate?,
  caps?, capSize?, stroke?, strokeWidth?, strokeDash?, opacity?
} = {})

Create vertical or horizontal statistical or explicit intervals. With one eligible encoded layer, the shortest call infers its fields, orientation, data, coordinate, and scales. Explicit interval fields also allow the independent position to be quantitative. A categorical source can also infer a matching xOffset/yOffset; its field joins statistical grouping and aligns source points, the main rule, and both caps on one shared sub-slot scale. Error bars

editErrorBar

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editErrorBar(options: EditErrorBarOptions): ChartProgram;

Named option contracts: EditErrorBarOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

editErrorBar({
  target?, data?, x?, y?, xOffset?, yOffset?, groupBy?, caps?, capSize?,
  stroke?, strokeWidth?, strokeDash?, opacity?, statistics?
})

Revise one error bar’s source, position/interval roles, optional categorical offset, statistics, and owned caps. Role changes can switch orientation or convert statistical and explicit intervals while preserving owner/cap IDs. caps: false removes both caps and caps: true restores them. Error bars

createErrorBand

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createErrorBand(options?: ErrorBandOptions): ChartProgram;

Named option contracts: ErrorBandOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createErrorBand({
  id?, target?, data?, x?, y?, groupBy?, coordinate?, fill?, opacity?,
  curve?, boundaries?
} = {})

Create a vertical or horizontal statistical or explicit interval ribbon. The action can infer one encoded source layer and reuses createIntervalData, an ordinary area, the matching atomic range action, and grouping actions. boundaries: { stroke?, strokeWidth?, strokeDash?, opacity?, curve? } adds lower and upper line layers. Boundary curve inherits the area curve unless it is overridden. Error bands

editErrorBand

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editErrorBand(options: EditErrorBandOptions): ChartProgram;

Named option contracts: EditErrorBandOptions.

Behavior, inference, resets, and errors: editErrorBand and editErrorBandBoundary.

editErrorBandBoundary

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editErrorBandBoundary(options: EditErrorBandBoundaryOptions): ChartProgram;

Named option contracts: EditErrorBandBoundaryOptions.

Behavior, inference, resets, and errors: editErrorBand and editErrorBandBoundary.

createBoxPlot

API layer: user-facing. Authoring roles: H0, H1.

Availability: Available by v0.0.13. See release compatibility.

createBoxPlot(options?: BoxPlotOptions): ChartProgram;

Named option contracts: BoxPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createBoxPlot({
  id?, target?, data?, x?, y?, coordinate?, color?, summary?, whisker?, width?, outliers?,
  box?, median?, outlier?, guides?
} = {})

Create a Box plot owner from raw observations or explicit five-field summaries. Geometry and guides defer until compatible x/y roles are available. The action infers an encoded source when possible and composes immutable box summary data, error-bar whiskers, ranged-bar bodies, median rules, and optional point outliers. Tukey factor, band width, component appearance, and outlier creation are configurable. Box plots Guides remain opt-in for compatibility: pass guides: {} or nested options to ensure compatible guides inside the facade; omission and false create none. Optional color uses the ordinary field/fixed encoding on the body after position completion and before guides. It cannot be combined with explicit box.fill.

editBoxPlot

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editBoxPlot(options: EditBoxPlotOptions): ChartProgram;

Named option contracts: EditBoxPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

editBoxPlot({ target?, whisker?, width?, outliers?, box?, median?, outlier? })

Revise box statistics, optional outlier topology, width, and component appearance through the stable box owner without addressing generated child IDs. Box plots

createGradientPlot

API layer: user-facing. Authoring roles: H0, H1.

Availability: Available by v0.0.13. See release compatibility.

createGradientPlot(options?: GradientPlotOptions): ChartProgram;

Named option contracts: GradientPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createGradientPlot({
  id?, target?, data?, x?, y?, coordinate?, color?, density?, width?, gradient?,
  center?, guides?
} = {})

Create a Gradient plot owner that defers geometry and guides until compatible x/y roles are available. Positions can be explicit, inferred from one eligible encoded layer, or completed later. Defaults are Gaussian auto density, 64 samples, width band 0.7, no outline, a median center rule, and applicable guides. A categorical encodeColor owns strip hue while density continues to control lightness and opacity. Optional color applies that same field/fixed encoding at creation or deferred position completion, before guides. Statistical actions

editGradientPlot

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editGradientPlot(options: EditGradientPlotOptions): ChartProgram;

Named option contracts: EditGradientPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

editGradientPlot({ target?, density?, width?, gradient?, center? })

Revise one stable gradient-plot owner. Statistical changes create and rebind one immutable raw-source profile revision; appearance-only edits retain it. center: false removes the optional rule and center: {} restores it. Statistical actions

createViolinPlot

API layer: user-facing. Authoring roles: H0, H1.

Availability: Available by v0.0.13. See release compatibility.

createViolinPlot(options: ViolinPlotOptions): ChartProgram;

Named option contracts: ViolinPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createViolinPlot({
  id?, data?, coordinate?, x, y, split?, color?, density?, area?, guides?
})

Create a vertical or horizontal categorical density plot from exactly one categorical and one quantitative x/y role. The action infers field types, orientation, data, scales, and applicable guides, then records an ordinary area mark, categorical encodeDensity, optional color, and guides as wrapped children. Density options own bandwidth, extent, kernel, normalization, and shared or independent band-relative width. An optional two-value split assigns one half to each side of the category center. Violin plots

editViolinPlot

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editViolinPlot(options: EditViolinPlotOptions): ChartProgram;

Named option contracts: EditViolinPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

editViolinPlot({ target?, data?, x?, y?, split?, density? })

Revise source, category, quantitative value, split, orientation, and density parameters through one stable violin owner. The action creates an immutable density revision and reconciles axes, grid, selections, and highlights. Area appearance remains available through editAreaMark. Violin plots

createRegressionBand

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createRegressionBand(options: CreateRegressionBandOptions): ChartProgram;

Named option contracts: CreateRegressionBandOptions.

Behavior, inference, resets, and errors: Semantic resources and regression layers.

editRegressionBand

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editRegressionBand(options: StrokeStyleDetails & { target?: string; color?: string; opacity?: number; stroke?: string | false; strokeWidth?: number; curve?: CurveInterpolation; }): ChartProgram;

Named option contracts: StrokeStyleDetails · CurveInterpolation.

Behavior, inference, resets, and errors: Semantic resources and regression layers.

createRegressionLine

API layer: user-facing. Authoring roles: H1.

Availability: Available by v0.0.13. See release compatibility.

createRegressionLine(options: CreateRegressionLineOptions): ChartProgram;

Named option contracts: CreateRegressionLineOptions.

Behavior, inference, resets, and errors: Semantic resources and regression layers.

editRegressionLine

API layer: user-facing. Authoring roles: H1, H3.

Availability: Available by v0.0.13. See release compatibility.

editRegressionLine(options: StrokeStyleDetails & { target?: string; strokeWidth?: number; curve?: CurveInterpolation; }): ChartProgram;

Named option contracts: StrokeStyleDetails · CurveInterpolation.

Behavior, inference, resets, and errors: Semantic resources and regression layers.

createDensityPlot

API layer: user-facing. Authoring roles: H0, H1.

Availability: Available by v0.0.13. See release compatibility.

createDensityPlot(options: CreateDensityPlotOptions): ChartProgram;

Named option contracts: CreateDensityPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createDensityPlot({ id?, data?, coordinate?, field, groupBy?, bandwidth?, extent?, steps?, kernel?, normalization?, as?, densityChannel?, valueScale?, densityScale?, color?, area?, guides? })

Creates a complete baseline density area from a required quantitative field. The default ID is densityPlot. Existing KDE defaults apply: automatic bandwidth and extent, 100 steps, Gaussian kernel, unit normalization. groupBy is an explicit field or false; omission is ungrouped. Color is optional and must use that same group field, with a nominal/ordinal categorical scale and optional layout: "overlay". Raw metadata is not copied into density profiles. densityChannel: "y" places values on x; "x" exchanges those roles. The density scale must include zero. area accepts fill, opacity, stroke, strokeWidth, and curve; opacity defaults to 0.2. Scalar fill conflicts with field color, and stroke width requires a stroke. Guides default to both axes and the existing horizontal grid in either orientation; an explicit group color enables a categorical legend. guides: false skips guide creation. Use editDensity, editAreaMark, and scale/guide editors for revisions. Category placement and orientation edits are outside this facade. This action is available from ggaction and is absent from ggaction/basic.

See the complete density workflow.

Both value and density grid directions follow continuous scales and reject explicit bandPosition.

createHorizonPlot

API layer: user-facing. Authoring roles: H0, H1.

Availability: Available by v0.0.13. See release compatibility.

createHorizonPlot(options: CreateHorizonPlotOptions): ChartProgram;

Named option contracts: CreateHorizonPlotOptions.

The following call patterns are abbreviated examples; the declaration above owns the complete option set.

createHorizonPlot({ id?, data?, coordinate?, x, y, groupBy?, bands?, baseline?, extent?, resolve?, missing?, overflow?, palette?, area?, guides? })

Create a complete signed, folded area chart from explicit x and y source fields. Defaults use three bands, a zero baseline, automatic shared extent, blue positive bands and red negative bands. Temporal x fields support the existing temporal unit vocabulary. The full entry owns this facade; Basic does not expose it.

The original x axis and vertical grid are the only automatic guides. Folded y/horizontal grid/internal band legend options accept only false. Palette owns fill; area appearance accepts opacity, stroke, strokeWidth and curve. Explicit opacity is applied after encoding. Revise statistics with editHorizon and style with editAreaMark. See the Horizon tutorial.

The vertical grid follows continuous original x and rejects explicit bandPosition.

Focused statistical data editing

editComputedData({ target, as?, expression?, dependents? })
editLookupData({ target, field?, lookup?, dependents? })
editFlattenData({ target, fields?, as?, dependents? })
editFoldData({ target, fields?, as?, dependents? })
editSummaryData({ target, groupBy?, aggregates?, members?, weight?, dependents? })
editBinData({ target, field?, maxBins? | step? | boundaries?, extent?, nice?, zero?, includeEmpty?, members?, as?, weight?, dependents? })
editStackData({ target, category?, group?, value?, mode?, as?, dependents? })
editIntervalData({ target, field?, groupBy?, center?, extent?, method?, level?, as?, dependents? })
editECDFData({ target, field?, groupBy?, weight?, missing?, as?, dependents? })
editNormalizedData({ target, field?, as?, groupBy?, method?, variance?, zeroDenominator?, baseline?, sortBy?, dependents? })
editCompleteData({ target, key?, groupBy?, values? | sequence?, fill?, members?, dependents? })
editImputedData({ target, fields?, groupBy?, sortBy?, method?, value?, edges?, maxGap?, dependents? })

Use a focused editor for a partial change to the corresponding standalone data transform. Arrays, expressions, aggregate lists, and output maps replace the whole current value. A patch must contain at least one transform option. undefined and null do not delete options. weight: false removes an existing weight only from the editors that expose weight. Mode changes remove keys that belong only to the previous mode before validating the final definition. Editing derived data

editErrorBand and editErrorBandBoundary

editErrorBand({
  target?, data?, x?, y?, groupBy?, fill?, opacity?, curve?, statistics?,
  boundaries?
})
editErrorBandBoundary({
  target?, boundary?, stroke?, strokeWidth?, strokeDash?, opacity?, curve?
})

Constant band fill conflicts with active color. Remove that encoding first, or use edit-only fill: false to clear a constant fill and restore color eligibility.

Edit the band source, position/interval roles, grouping, body, statistical interval, or both owned boundary components without addressing generated line IDs. Role changes may switch orientation or interval mode. boundaries: false disables both; an object creates or edits both. The focused boundary action still accepts "both", "lower", or "upper" and creates missing selected boundaries. Error bands

Semantic resources and regression layers

createCoordinate({ id?, type?, layers? })
editCoordinate({ target, aspect?, polarFrame? })
createDerivedData({
  id,
  source,
  transform: [DatasetTransform]
})
createRegressionBand({
  id, data, x, lower, upper, groupBy?, coordinate, xScale, yScale,
  color?, opacity?, stroke?, strokeWidth?, curve?, missing?
})
editRegressionBand({ target?, color?, opacity?, stroke?, strokeWidth?, curve?, missing? })
createRegressionLine({
  id, data, x, y, groupBy?, coordinate, xScale, yScale,
  colorScale?, strokeWidth?, curve?, missing?
})
editRegressionLine({ target?, strokeWidth?, curve?, missing? })

These actions explicitly author named semantic resources or the component layers normally owned by createRegression.

createCoordinate.type accepts "cartesian", "polar", or "parallel". Parallel coordinates normally create their resource through encodeParallelCoordinates or createParallelCoordinates.

editCoordinate.aspect accepts "auto" or a frame/data ratio request with optional start/center/end alignment. Frame mode supports Cartesian, Polar, and Parallel coordinates. Data mode requires one complete Cartesian quantitative linear x/y scale pair and preserves equal-unit intent through scale-domain and Canvas edits. The target coordinate ID is always explicit. editCoordinate.polarFrame accepts "auto" or a Polar-only center/radius request. Center values are normalized effective-bound fractions; radius is a fraction of the largest fitting radius or a positive fixed pixel value. The frame object is replaced as a whole, and aspect is resolved before the Polar frame and radial scale range. Optional overflow: "allow" permits a pixel radius beyond plot bounds while preserving Canvas size; reserve outer margins for its exported extent. Omitted overflow defaults to "error".

createDerivedData stores immutable source and transform provenance only; it does not materialize values. Chart facades and mark creation reject definition-only datasets with an error explaining that materialized values are required. Its public DatasetTransform union is listed in the canonical transform table. A bare object, empty array, or multi-transform pipeline is invalid. Focused create*Data helpers validate fields, apply defaults, and materialize values; raw provenance objects have their own normalized requirements.

Related

Action Reference · Chart API · Supported Features