@uwdata/mosaic-spec 0.7.1 → 0.9.0

package/src/spec/marks/Axis.ts

@@ -0,0 +1,305 @@
+import { ParamRef } from '../Param.js';
+import { Interval } from '../PlotTypes.js';
+import { MarkOptions } from './Marks.js';
+import { RuleXOptions, RuleYOptions } from './Rule.js';
+import { TextOptions } from './Text.js';
+import { TickXOptions, TickYOptions } from './Tick.js';
+
+/** The scale options used by axis and grid marks. */
+interface ScaleOptions {
+  /**
+   * Enforces uniformity for data at regular intervals, such as integer values
+   * or daily samples. The interval may be one of:
+   *
+   * - a named time interval such as *day* (for date intervals)
+   * - a number (for number intervals), defining intervals at integer multiples of *n*
+   *
+   * This option sets the internal transform to the given interval’s
+   * *interval*.floor function. In addition, the default **domain** will align
+   * with interval boundaries.
+   */
+  interval?: Interval | ParamRef;
+
+  /**
+   * The desired approximate number of axis ticks, or an explicit array of tick
+   * values, or an interval such as *day* or *month*.
+   */
+  ticks?: number | Interval | any[] | ParamRef;
+
+  /**
+   * The length of axis tick marks in pixels; negative values extend in the
+   * opposite direction. Defaults to 6 for *x* and *y* axes and *color* and
+   * *opacity* *ramp* legends, and 0 for *fx* and *fy* axes.
+   */
+  tickSize?: number | ParamRef;
+
+  /**
+   * The desired approximate spacing between adjacent axis ticks, affecting the
+   * default **ticks**; defaults to 80 pixels for *x* and *fx*, and 35 pixels
+   * for *y* and *fy*.
+   */
+  tickSpacing?: number | ParamRef;
+
+  /**
+   * The distance between an axis tick mark and its associated text label (in
+   * pixels); often defaults to 3, but may be affected by **xTickSize** and
+   * **xTickRotate**.
+   */
+  tickPadding?: number | ParamRef;
+
+  /**
+   * How to format inputs (abstract values) for axis tick labels; one of:
+   *
+   * - a [d3-format][1] string for numeric scales
+   * - a [d3-time-format][2] string for temporal scales
+   *
+   * [1]: https://d3js.org/d3-time
+   * [2]: https://d3js.org/d3-time-format
+   */
+  tickFormat?: string | null | ParamRef;
+
+  /**
+   * The rotation angle of axis tick labels in degrees clocksize; defaults to 0.
+   */
+  tickRotate?: number | ParamRef;
+
+  /**
+   * A textual label to show on the axis or legend; if null, show no label. By
+   * default the scale label is inferred from channel definitions, possibly with
+   * an arrow (↑, →, ↓, or ←) to indicate the direction of increasing value.
+   *
+   * For axes and legends only.
+   */
+  label?: string | null | ParamRef;
+
+  /**
+   * Where to place the axis **label** relative to the plot’s frame. For
+   * vertical position scales (*y* and *fy*), may be *top*, *bottom*, or
+   * *center*; for horizontal position scales (*x* and *fx*), may be *left*,
+   * *right*, or *center*. Defaults to *center* for ordinal scales (including
+   * *fx* and *fy*), and otherwise *top* for *y*, and *right* for *x*.
+   */
+  labelAnchor?: 'top' | 'right' | 'bottom' | 'left' | 'center' | ParamRef;
+
+  /**
+   * The axis **label** position offset (in pixels); default depends on margins
+   * and orientation.
+   */
+  labelOffset?: number | ParamRef;
+
+  /**
+   * Whether to apply a directional arrow such as → or ↑ to the scale label. If
+   * *auto* (the default), the presence of the arrow depends on whether the
+   * scale is ordinal.
+   */
+  labelArrow?: 'auto' | 'up' | 'right' | 'down' | 'left' | 'none' | true | false | null | ParamRef;
+}
+
+/** The subset of scale options for grids. */
+type GridScaleOptions = Pick<ScaleOptions, 'interval' | 'ticks' | 'tickSpacing'>;
+
+/** The subset of scale options for axes. */
+type AxisScaleOptions = Pick<ScaleOptions, 'tickSize' | 'tickPadding' | 'tickFormat' | 'tickRotate' | 'label' | 'labelOffset' | 'labelAnchor' | 'labelArrow'>;
+
+/** Options for the grid marks. */
+export interface GridOptions extends GridScaleOptions {
+  /**
+   * The side of the frame on which to place the axis: *top* or *bottom* for
+   * horizontal axes (axisX and axisFx) and their associated vertical grids
+   * (gridX and gridFx), or *left* or *right* for vertical axes (axisY and
+   * axisFY) and their associated horizontal grids (gridY and gridFy).
+   *
+   * The default **anchor** depends on the associated scale:
+   *
+   * - *x* - *bottom*
+   * - *y* - *left*
+   * - *fx* - *top* if there is a *bottom* *x* axis, and otherwise *bottom*
+   * - *fy* - *right* if there is a *left* *y* axis, and otherwise *right*
+   *
+   * For grids, the **anchor** also affects the extent of grid lines when the
+   * opposite dimension is specified (**x** for gridY and **y** for gridX).
+   */
+  anchor?: 'top' | 'right' | 'bottom' | 'left' | ParamRef;
+
+  /**
+   * A shorthand for setting both **fill** and **stroke**; affects the stroke of
+   * tick vectors and grid rules, and the fill of tick texts and axis label
+   * texts; defaults to *currentColor*.
+   */
+  color?: MarkOptions['stroke'];
+
+  /**
+   * A shorthand for setting both **fillOpacity** and **strokeOpacity**; affects
+   * the stroke opacity of tick vectors and grid rules, and the fill opacity of
+   * tick texts and axis label texts; defaults to 1 for axes and 0.1 for grids.
+   */
+  opacity?: MarkOptions['opacity'];
+}
+
+/** Options for the axis marks. */
+export interface AxisOptions extends GridOptions, MarkOptions, TextOptions, AxisScaleOptions {
+  /** The tick text **stroke**, say for a *white* outline to improve legibility; defaults to null. */
+  textStroke?: MarkOptions['stroke'];
+  /** The tick text **strokeOpacity**; defaults to 1; has no effect unless **textStroke** is set. */
+  textStrokeOpacity?: MarkOptions['strokeOpacity'];
+  /** The tick text **strokeWidth**; defaults to 4; has no effect unless **textStroke** is set. */
+  textStrokeWidth?: MarkOptions['strokeWidth'];
+}
+
+/** Options for the axisX and axisFx marks. */
+export interface AxisXOptions extends AxisOptions, Omit<TickXOptions, 'data'> {}
+
+/** Options for the axisY and axisFy marks. */
+export interface AxisYOptions extends AxisOptions, Omit<TickYOptions, 'data'> {}
+
+/** Options for the gridX and gridFx marks. */
+export interface GridXOptions extends GridOptions, Omit<RuleXOptions, 'data' | 'interval'> {}
+
+/** Options for the gridY and gridFy marks. */
+export interface GridYOptions extends GridOptions, Omit<RuleYOptions, 'data' | 'interval'> {}
+
+/** The axisX mark. */
+export interface AxisX extends AxisXOptions {
+  /**
+   * An axis mark to document the visual encoding of the horizontal position
+   * *x* scale, comprised of (up to) three marks: a vector for ticks, a text
+   * for tick labels, and another text for an axis label. The data defaults to
+   * tick values sampled from the *x* scale’s domain; if desired, use one of
+   * the **ticks**, **tickSpacing**, or **interval** options.
+   *
+   * The **facetAnchor** option defaults to *bottom-empty* if **anchor** is
+   * *bottom*, and *top-empty* if **anchor** is *top*. The default margins
+   * likewise depend on **anchor** as follows; in order of **marginTop**,
+   * **marginRight**, **marginBottom**, and **marginLeft**, in pixels:
+   *
+   * - *top* - 30, 20, 0, 20
+   * - *bottom* - 0, 20, 30, 20
+   *
+   * For simplicity, and for consistent layout across plots, default axis margins
+   * are not affected by tick labels. If tick labels are too long, either increase
+   * the margin or shorten the labels: use the *k* SI-prefix tick format; use the
+   * **transform** *y*-scale option to show thousands or millions; or use the
+   * **textOverflow** and **lineWidth** options to clip.
+   */
+  mark: 'axisX';
+}
+
+/** The axisFx mark. */
+export interface AxisFx extends AxisXOptions {
+  /**
+   * An axis mark to document the visual encoding of the horizontal facet
+   * position *fx* scale, comprised of (up to) three marks: a vector for ticks,
+   * a text for tick labels, and another text for an axis label. The data
+   * defaults to the *fx* scale’s domain; if desired, use one of the **ticks**,
+   * **tickSpacing**, or **interval** options.
+   *
+   * The **facetAnchor** and **frameAnchor** options defaults to **anchor**. The
+   * default margins likewise depend on **anchor** as follows; in order of
+   * **marginTop**, **marginRight**, **marginBottom**, and **marginLeft**, in
+   * pixels:
+   *
+   * - *top* - 30, 20, 0, 20
+   * - *bottom* - 0, 20, 30, 20
+   *
+   * For simplicity, and for consistent layout across plots, default axis margins
+   * are not affected by tick labels. If tick labels are too long, either increase
+   * the margin or shorten the labels: use the *k* SI-prefix tick format; use the
+   * **transform** *y*-scale option to show thousands or millions; or use the
+   * **textOverflow** and **lineWidth** options to clip.
+   */
+  mark: 'axisFx';
+}
+
+/** The axisY mark. */
+export interface AxisY extends AxisYOptions {
+  /**
+   * An axis mark to document the visual encoding of the vertical position *y*
+   * scale, comprised of (up to) three marks: a vector for ticks, a text for
+   * tick labels, and another text for an axis label. The data defaults to tick
+   * values sampled from the *y* scale’s domain; if desired, use one of the
+   * **ticks**, **tickSpacing**, or **interval** options.
+   *
+   * The **facetAnchor** option defaults to *right-empty* if **anchor** is
+   * *right*, and *left-empty* if **anchor** is *left*. The default margins
+   * likewise depend on **anchor** as follows; in order of **marginTop**,
+   * **marginRight**, **marginBottom**, and **marginLeft**, in pixels:
+   *
+   * - *right* - 20, 40, 20, 0
+   * - *left* - 20, 0, 20, 40
+   *
+   * For simplicity, and for consistent layout across plots, default axis
+   * margins are not affected by tick labels. If tick labels are too long,
+   * either increase the margin or shorten the labels: use the *k* SI-prefix
+   * tick format; or use the **textOverflow** and **lineWidth** options to
+   * clip.
+   */
+  mark: 'axisY';
+}
+
+/** The axisFy mark. */
+export interface AxisFy extends AxisYOptions {
+  /**
+   * An axis mark to document the visual encoding of the vertical facet
+   * position *fy* scale, comprised of (up to) three marks: a vector for ticks,
+   * a text for tick labels, and another text for an axis label. The data
+   * defaults to the *fy* scale’s domain; if desired, use one of the **ticks**,
+   * **tickSpacing**, or **interval** options.
+   *
+   * The **facetAnchor** option defaults to *right-empty* if **anchor** is
+   * *right*, and *left-empty* if **anchor** is *left*. The default margins
+   * likewise depend on **anchor** as follows; in order of **marginTop**,
+   * **marginRight**, **marginBottom**, and **marginLeft**, in pixels:
+   *
+   * - *right* - 20, 40, 20, 0
+   * - *left* - 20, 0, 20, 40
+   *
+   * For simplicity, and for consistent layout across plots, default axis
+   * margins are not affected by tick labels. If tick labels are too long,
+   * either increase the margin or shorten the labels: use the *k* SI-prefix
+   * tick format; or use the **textOverflow** and **lineWidth** options to
+   * clip.
+   */
+  mark: 'axisFy';
+}
+
+/** The gridX mark. */
+export interface GridX extends GridXOptions {
+  /**
+   * A horizontally-positioned ruleX mark (a vertical line, |) that renders a
+   * grid for the *x* scale. The data defaults to tick values sampled from the
+   * *x* scale’s domain; if desired, use one of the **ticks**, **tickSpacing**,
+   * or **interval** options.
+   */
+  mark: 'gridX';
+}
+
+/** The gridFx mark. */
+export interface GridFx extends GridXOptions {
+  /**
+   * A horizontally-positioned ruleX mark (a vertical line, |) that renders a
+   * grid for the *fx* scale. The data defaults to the *fx* scale’s domain;
+   * if desired, use the **ticks** option.
+   */
+  mark: 'gridFx';
+}
+
+/** The gridY mark. */
+export interface GridY extends GridYOptions {
+  /**
+   * A vertically-positioned ruleY mark (a horizontal line, —) that renders a
+   * grid for the *y* scale. The data defaults to tick values sampled from the
+   * *y* scale’s domain; if desired, use one of the **ticks**, **tickSpacing**,
+   * or **interval** options.
+   */
+  mark: 'gridY';
+}
+
+/** The gridFy mark. */
+export interface GridFy extends GridYOptions {
+  /**
+   * A vertically-positioned ruleY mark (a horizontal line, —) that renders a
+   * grid for the *fy* scale. The data defaults to the *fy* scale’s domain;
+   * if desired, use the **ticks** option.
+   */
+  mark: 'gridFy';
+}

package/src/spec/marks/Bar.ts

@@ -0,0 +1,160 @@
+import { ParamRef } from '../Param.js';
+import { Interval } from '../PlotTypes.js';
+import { ChannelValueIntervalSpec, ChannelValueSpec, InsetOptions, MarkData, MarkOptions, StackOptions } from './Marks.js';
+import { RectCornerOptions } from './Rect.js';
+
+/** Options for the barX and barY marks. */
+interface BarOptions extends MarkOptions, InsetOptions, RectCornerOptions, StackOptions {
+  /**
+   * How to convert a continuous value (**x** for barX, or **y** for barY) into
+   * an interval (**x1** and **x2** for barX, or **y1** and **y2** for barY);
+   * one of:
+   *
+   * - a named time interval such as *day* (for date intervals)
+   * - a number (for number intervals), defining intervals at integer multiples of *n*
+   *
+   * Setting this option disables the implicit stack transform (stackX for barX,
+   * or stackY for barY).
+   */
+  interval?: Interval | ParamRef;
+}
+
+/** Options for the barX mark. */
+export interface BarXOptions extends BarOptions {
+  /**
+   * The horizontal position (or length/width) channel, typically bound to the
+   * *x* scale.
+   *
+   * If neither **x1** nor **x2** nor **interval** is specified, an implicit
+   * stackX transform is applied and **x** defaults to the identity function,
+   * assuming that *data* = [*x₀*, *x₁*, *x₂*, …]. Otherwise if an **interval**
+   * is specified, then **x1** and **x2** are derived from **x**, representing
+   * the lower and upper bound of the containing interval, respectively.
+   * Otherwise, if only one of **x1** or **x2** is specified, the other
+   * defaults to **x**, which defaults to zero.
+   */
+  x?: ChannelValueIntervalSpec;
+
+  /**
+   * The required primary (starting, often left) horizontal position channel,
+   * typically bound to the *x* scale. Setting this option disables the
+   * implicit stackX transform.
+   *
+   * If *x* represents ordinal values, use a cell mark instead.
+   */
+  x1?: ChannelValueSpec;
+
+  /**
+   * The required secondary (ending, often right) horizontal position channel,
+   * typically bound to the *x* scale. Setting this option disables the
+   * implicit stackX transform.
+   *
+   * If *x* represents ordinal values, use a cell mark instead.
+   */
+  x2?: ChannelValueSpec;
+
+  /**
+   * The optional vertical position of the bar; a ordinal channel typically
+   * bound to the *y* scale. If not specified, the bar spans the vertical
+   * extent of the frame; otherwise the *y* scale must be a *band* scale.
+   *
+   * If *y* represents quantitative or temporal values, use a rectX mark
+   * instead.
+   */
+  y?: ChannelValueSpec;
+}
+
+/** Options for the barY mark. */
+export interface BarYOptions extends BarOptions {
+  /**
+   * The vertical position (or length/height) channel, typically bound to the
+   * *y* scale.
+   *
+   * If neither **y1** nor **y2** nor **interval** is specified, an implicit
+   * stackY transform is applied and **y** defaults to the identity function,
+   * assuming that *data* = [*y₀*, *y₁*, *y₂*, …]. Otherwise if an **interval**
+   * is specified, then **y1** and **y2** are derived from **y**, representing
+   * the lower and upper bound of the containing interval, respectively.
+   * Otherwise, if only one of **y1** or **y2** is specified, the other
+   * defaults to **y**, which defaults to zero.
+   */
+  y?: ChannelValueIntervalSpec;
+
+  /**
+   * The required primary (starting, often bottom) vertical position channel,
+   * typically bound to the *y* scale. Setting this option disables the
+   * implicit stackY transform.
+   *
+   * If *y* represents ordinal values, use a cell mark instead.
+   */
+  y1?: ChannelValueSpec;
+
+  /**
+   * The required secondary (ending, often top) horizontal position channel,
+   * typically bound to the *y* scale. Setting this option disables the
+   * implicit stackY transform.
+   *
+   * If *y* represents ordinal values, use a cell mark instead.
+   */
+  y2?: ChannelValueSpec;
+
+  /**
+   * The optional horizontal position of the bar; a ordinal channel typically
+   * bound to the *x* scale. If not specified, the bar spans the horizontal
+   * extent of the frame; otherwise the *x* scale must be a *band* scale.
+   *
+   * If *x* represents quantitative or temporal values, use a rectY mark
+   * instead.
+   */
+  x?: ChannelValueSpec;
+}
+
+/** The barX mark. */
+export interface BarX extends MarkData, BarXOptions {
+  /**
+   * A horizontal bar mark. The required *x* values should be quantitative or
+   * temporal, and the optional *y* values should be ordinal.
+   *
+   * If neither **x1** nor **x2** nor **interval** is specified, an implicit
+   * stackX transform is applied and **x** defaults to the identity function,
+   * assuming that *data* = [*x₀*, *x₁*, *x₂*, …]. Otherwise if an **interval**
+   * is specified, then **x1** and **x2** are derived from **x**, representing
+   * the lower and upper bound of the containing interval, respectively.
+   * Otherwise, if only one of **x1** or **x2** is specified, the other
+   * defaults to **x**, which defaults to zero.
+   *
+   * The optional **y** ordinal channel specifies the vertical position; it is
+   * typically bound to the *y* scale, which must be a *band* scale. If the
+   * **y** channel is not specified, the bar will span the vertical extent of
+   * the plot’s frame.
+   *
+   * If *y* is quantitative, use the rectX mark instead.
+   * If *x* is ordinal, use the cell mark instead.
+   */
+  mark: 'barX';
+}
+
+/** The barY mark. */
+export interface BarY extends MarkData, BarYOptions {
+  /**
+   * A vertical bar mark. The required *y* values should be quantitative or
+   * temporal, and the optional *x* values should be ordinal.
+   *
+   * If neither **y1** nor **y2** nor **interval** is specified, an implicit
+   * stackY transform is applied and **y** defaults to the identity function,
+   * assuming that *data* = [*y₀*, *y₁*, *y₂*, …]. Otherwise if an **interval**
+   * is specified, then **y1** and **y2** are derived from **y**, representing
+   * the lower and upper bound of the containing interval, respectively.
+   * Otherwise, if only one of **y1** or **y2** is specified, the other
+   * defaults to **y**, which defaults to zero.
+   *
+   * The optional **x** ordinal channel specifies the horizontal position; it
+   * is typically bound to the *x* scale, which must be a *band* scale. If the
+   * **x** channel is not specified, the bar will span the horizontal extent of
+   * the plot’s frame.
+   *
+   * If *x* is quantitative, use the rectY mark instead.
+   * If *y* is ordinal, use the cell mark instead.
+   */
+  mark: 'barY';
+}

package/src/spec/marks/Cell.ts

@@ -0,0 +1,62 @@
+import { ChannelValueSpec, InsetOptions, MarkData, MarkOptions } from './Marks.js';
+import { RectCornerOptions } from './Rect.js';
+
+/** Options for the cell mark. */
+export interface CellOptions extends MarkOptions, InsetOptions, RectCornerOptions {
+  /**
+   * The horizontal position of the cell; an optional ordinal channel typically
+   * bound to the *x* scale. If not specified, the cell spans the horizontal
+   * extent of the frame; otherwise the *x* scale must be a *band* scale.
+   *
+   * If *x* represents quantitative or temporal values, use a barX mark instead;
+   * if *y* is also quantitative or temporal, use a rect mark.
+   */
+  x?: ChannelValueSpec;
+
+  /**
+   * The vertical position of the cell; an optional ordinal channel typically
+   * bound to the *y* scale. If not specified, the cell spans the vertical
+   * extent of the frame; otherwise the *y* scale must be a *band* scale.
+   *
+   * If *y* represents quantitative or temporal values, use a barY mark instead;
+   * if *x* is also quantitative or temporal, use a rect mark.
+   */
+  y?: ChannelValueSpec;
+}
+
+/** The cell mark. */
+export interface Cell extends MarkData, CellOptions {
+  /**
+   * A rectangular cell mark. Along with **x** and/or **y**, a **fill** channel
+   * is typically specified to encode value as color.
+   *
+   * If neither **x** nor **y** are specified, *data* is assumed to be an array of
+   * pairs [[*x₀*, *y₀*], [*x₁*, *y₁*], [*x₂*, *y₂*], …] such that **x** = [*x₀*,
+   * *x₁*, *x₂*, …] and **y** = [*y₀*, *y₁*, *y₂*, …].
+   *
+   * Both **x** and **y** should be ordinal; if only **x** is quantitative (or
+   * temporal), use a barX mark; if only **y** is quantitative, use a barY mark;
+   * if both are quantitative, use a rect mark.
+   */
+  mark: 'cell';
+}
+
+/** The cellX mark. */
+export interface CellX extends MarkData, CellOptions {
+  /**
+   * Like cell, but **x** defaults to the zero-based index [0, 1, 2, …], and if
+   * **stroke** is not a channel, **fill** defaults to the identity function,
+   * assuming that *data* = [*x₀*, *x₁*, *x₂*, …].
+   */
+  mark: 'cellX';
+}
+
+/** The cellY mark. */
+export interface CellY extends MarkData, CellOptions {
+  /**
+   * Like cell, but **y** defaults to the zero-based index [0, 1, 2, …], and if
+   * **stroke** is not a channel, **fill** defaults to the identity function,
+   * assuming that *data* = [*y₀*, *y₁*, *y₂*, …].
+   */
+  mark: 'cellY';
+}

package/src/spec/marks/Contour.ts

@@ -0,0 +1,25 @@
+import { ParamRef } from '../Param.js';
+import { MarkData, MarkOptions } from './Marks.js';
+import { Grid2DOptions } from './Raster.js';
+
+export interface ContourOptions extends MarkOptions, Grid2DOptions {
+  /**
+   * The number of contour thresholds to subdivide the domain into discrete
+   * level sets; defaults to 10. One of:
+   *
+   * - a count representing the desired number of bins
+   * - an array of *n* threshold values for *n* - 1 bins
+   */
+  thresholds?: number | number[] | ParamRef;
+}
+
+/** The contour mark. */
+export interface Contour extends MarkData, ContourOptions {
+  /**
+   * A contour mark that draws isolines to delineate regions above and below a
+   * particular continuous value. It is often used to convey densities as a
+   * height field. The special column name "density" can be used to map density
+   * values to the fill or stroke options.
+   */
+  mark: 'contour';
+}

package/src/spec/marks/Delaunay.ts

@@ -0,0 +1,95 @@
+import {
+  ChannelValue, ChannelValueSpec, CurveOptions,
+  MarkData, MarkOptions, MarkerOptions
+} from './Marks.js';
+
+/** Options for the Delaunay marks. */
+export interface DelaunayOptions extends MarkOptions, MarkerOptions, CurveOptions {
+  /** The horizontal position channel, typically bound to the *x* scale. */
+  x?: ChannelValueSpec;
+  /** The vertical position channel, typically bound to the *y* scale. */
+  y?: ChannelValueSpec;
+  /**
+   * An optional ordinal channel for grouping to produce multiple
+   * (possibly overlapping) triangulations.
+   */
+  z?: ChannelValue;
+}
+
+/** The delaunayLink mark. */
+export interface DelaunayLink extends MarkData, DelaunayOptions {
+  /**
+   * A mark that draws links for each edge of the Delaunay triangulation
+   * of points given by the **x** and **y** channels. Like the link mark,
+   * except that **x1**, **y1**, **x2**, and **y2** are derived automatically
+   * from **x** and **y**. When an aesthetic channel is specified (such as
+   * **stroke** or **strokeWidth**), the link inherits the corresponding
+   * channel value from one of its two endpoints arbitrarily.
+   *
+   * If **z** is specified, the input points are grouped by *z*, producing a
+   * separate Delaunay triangulation for each group.
+   */
+  mark: 'delaunayLink';
+}
+
+/** The delaunayMesh mark. */
+export interface DelaunayMesh extends MarkData, DelaunayOptions {
+  /**
+   * A mark that draws a mesh of the Delaunay triangulation of the points
+   * given by the **x** and **y** channels. The **stroke** option defaults to
+   * _currentColor_, and the **strokeOpacity** defaults to 0.2; the **fill**
+   * option is not supported. When an aesthetic channel is specified (such as
+   * **stroke** or **strokeWidth**), the mesh inherits the corresponding
+   * channel value from one of its constituent points arbitrarily.
+   *
+   * If **z** is specified, the input points are grouped by *z*, producing a
+   * separate Delaunay triangulation for each group.
+   */
+  mark: 'delaunayMesh';
+}
+
+/** The hull mark. */
+export interface Hull extends MarkData, DelaunayOptions {
+  /**
+   * A mark that draws a convex hull around the points given by the **x** and
+   * **y** channels. The **stroke** option defaults to _currentColor_ and the
+   * **fill** option defaults to _none_. When an aesthetic channel is specified
+   * (such as **stroke** or **strokeWidth**), the hull inherits the
+   * corresponding channel value from one of its constituent points
+   * arbitrarily.
+   *
+   * If **z** is specified, the input points are grouped by *z*, producing a
+   * separate hull for each group. If **z** is not specified, it defaults to
+   * the **fill** channel, if any, or the **stroke** channel, if any.
+   */
+  mark: 'hull';
+}
+
+/** The voronoi mark. */
+export interface Voronoi extends MarkData, DelaunayOptions {
+  /**
+   * A mark that draws polygons for each cell of the Voronoi tesselation
+   * of the points given by the **x** and **y** channels.
+   *
+   * If **z** is specified, the input points are grouped by *z*, producing a
+   * separate Voronoi tesselation for each group.
+   */
+  mark: 'voronoi';
+}
+
+/** The voronoiMesh mark. */
+export interface VoronoiMesh extends MarkData, DelaunayOptions {
+  /**
+   * A mark that draws a mesh for the cell boundaries of the Voronoi
+   * tesselation of the points given by the **x** and **y** channels. The
+   * **stroke** option defaults to _currentColor_, and the **strokeOpacity**
+   * defaults to 0.2. The **fill** option is not supported. When an aesthetic
+   * channel is specified (such as **stroke** or **strokeWidth**), the mesh
+   * inherits the corresponding channel value from one of its constituent
+   * points arbitrarily.
+   *
+   * If **z** is specified, the input points are grouped by *z*, producing a
+   * separate Voronoi tesselation for each group.
+   */
+  mark: 'voronoiMesh';
+}

package/src/spec/marks/DenseLine.ts

@@ -0,0 +1,30 @@
+import { ParamRef } from '../Param.js';
+import { ChannelValue, MarkData } from './Marks.js';
+import { RasterOptions } from './Raster.js';
+
+export interface DenseLineOptions extends RasterOptions {
+  /**
+   * Flag to perform approximate arc length normalization of line segments
+   * to prevent artifacts due to overcounting steep lines. Defaults to `true`.
+   */
+  normalize?: boolean | ParamRef;
+
+  /**
+   * A ordinal channel for grouping data into series to be drawn as separate
+   * lines.
+   */
+  z?: ChannelValue;
+}
+
+/** The denseLine mark. */
+export interface DenseLine extends MarkData, DenseLineOptions {
+  /**
+   * A denseLine mark that plots line densities rather than point densities.
+   * The mark forms a binned raster grid and "draws" straight lines into it.
+   * To avoid over-weighting steep lines, by default each drawn series is
+   * normalized on a per-column basis to approximate arc length normalization.
+   * The values for each series are aggregated to form the line density, which
+   * is then drawn as an image similar to the raster mark.
+   */
+  mark: 'denseLine';
+}