@uwdata/mosaic-spec 0.17.0 → 0.19.0

package/dist/src/spec/marks/Axis.d.ts

@@ -0,0 +1,282 @@
+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';
+}
+export {};
+//# sourceMappingURL=Axis.d.ts.map

package/dist/src/spec/marks/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../../../src/spec/marks/Axis.ts"],"names":[],"mappings":"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"}

package/dist/src/spec/marks/Bar.d.ts

@@ -0,0 +1,151 @@
+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';
+}
+export {};
+//# sourceMappingURL=Bar.d.ts.map

package/dist/src/spec/marks/Bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bar.d.ts","sourceRoot":"","sources":["../../../../src/spec/marks/Bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,2CAA2C;AAC3C,UAAU,UAAW,SAAQ,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY;IACrF;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C;;;;;;;;;;;OAWG;IACH,CAAC,CAAC,EAAE,wBAAwB,CAAC;IAE7B;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,gBAAgB,CAAC;IAEtB;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,gBAAgB,CAAC;IAEtB;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,gBAAgB,CAAC;CACtB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C;;;;;;;;;;;OAWG;IACH,CAAC,CAAC,EAAE,wBAAwB,CAAC;IAE7B;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,gBAAgB,CAAC;IAEtB;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,gBAAgB,CAAC;IAEtB;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,gBAAgB,CAAC;CACtB;AAED,qBAAqB;AACrB,MAAM,WAAW,IAAK,SAAQ,QAAQ,EAAE,WAAW;IACjD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAqB;AACrB,MAAM,WAAW,IAAK,SAAQ,QAAQ,EAAE,WAAW;IACjD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/src/spec/marks/Cell.d.ts

@@ -0,0 +1,58 @@
+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';
+}
+//# sourceMappingURL=Cell.d.ts.map

package/dist/src/spec/marks/Cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../../src/spec/marks/Cell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,iCAAiC;AACjC,MAAM,WAAW,WAAY,SAAQ,WAAW,EAAE,YAAY,EAAE,iBAAiB;IAC/E;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAErB;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,gBAAgB,CAAC;CACtB;AAED,qBAAqB;AACrB,MAAM,WAAW,IAAK,SAAQ,QAAQ,EAAE,WAAW;IACjD;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sBAAsB;AACtB,MAAM,WAAW,KAAM,SAAQ,QAAQ,EAAE,WAAW;IAClD;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;CACf;AAED,sBAAsB;AACtB,MAAM,WAAW,KAAM,SAAQ,QAAQ,EAAE,WAAW;IAClD;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/src/spec/marks/Contour.d.ts

@@ -0,0 +1,24 @@
+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';
+}
+//# sourceMappingURL=Contour.d.ts.map

package/dist/src/spec/marks/Contour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Contour.d.ts","sourceRoot":"","sources":["../../../../src/spec/marks/Contour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,cAAe,SAAQ,WAAW,EAAE,aAAa;IAChE;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC;CAC3C;AAED,wBAAwB;AACxB,MAAM,WAAW,OAAQ,SAAQ,QAAQ,EAAE,cAAc;IACvD;;;;;OAKG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB"}

package/dist/src/spec/marks/Delaunay.d.ts

@@ -0,0 +1,87 @@
+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';
+}
+//# sourceMappingURL=Delaunay.d.ts.map

package/dist/src/spec/marks/Delaunay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Delaunay.d.ts","sourceRoot":"","sources":["../../../../src/spec/marks/Delaunay.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAC5C,QAAQ,EAAE,WAAW,EAAE,aAAa,EACrC,MAAM,YAAY,CAAC;AAEpB,sCAAsC;AACtC,MAAM,WAAW,eAAgB,SAAQ,WAAW,EAAE,aAAa,EAAE,YAAY;IAC/E,yEAAyE;IACzE,CAAC,CAAC,EAAE,gBAAgB,CAAC;IACrB,uEAAuE;IACvE,CAAC,CAAC,EAAE,gBAAgB,CAAC;IACrB;;;OAGG;IACH,CAAC,CAAC,EAAE,YAAY,CAAC;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAa,SAAQ,QAAQ,EAAE,eAAe;IAC7D;;;;;;;;;;OAUG;IACH,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAa,SAAQ,QAAQ,EAAE,eAAe;IAC7D;;;;;;;;;;OAUG;IACH,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,qBAAqB;AACrB,MAAM,WAAW,IAAK,SAAQ,QAAQ,EAAE,eAAe;IACrD;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAwB;AACxB,MAAM,WAAW,OAAQ,SAAQ,QAAQ,EAAE,eAAe;IACxD;;;;;;OAMG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAY,SAAQ,QAAQ,EAAE,eAAe;IAC5D;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,aAAa,CAAC;CACrB"}

package/dist/src/spec/marks/DenseLine.d.ts

@@ -0,0 +1,28 @@
+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';
+}
+//# sourceMappingURL=DenseLine.d.ts.map

package/dist/src/spec/marks/DenseLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenseLine.d.ts","sourceRoot":"","sources":["../../../../src/spec/marks/DenseLine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAE/B;;;OAGG;IACH,CAAC,CAAC,EAAE,YAAY,CAAC;CAClB;AAED,0BAA0B;AAC1B,MAAM,WAAW,SAAU,SAAQ,QAAQ,EAAE,gBAAgB;IAC3D;;;;;;;OAOG;IACH,IAAI,EAAE,WAAW,CAAC;CACnB"}