@uwdata/mosaic-spec 0.17.0 → 0.19.0

package/dist/src/spec/Transform.d.ts

@@ -0,0 +1,393 @@
+import { IntervalTransform } from './Interval.js';
+import { ParamRef } from './Param.js';
+/** A field argument to a data transform. */
+export type TransformField = string | ParamRef;
+export type FrameExclude = 'CURRENT ROW' | 'GROUP' | 'TIES' | 'NO OTHERS';
+export type FrameValue = number | IntervalTransform | null;
+/** Window transform options. */
+export interface WindowOptions {
+    orderby?: TransformField | TransformField[];
+    partitionby?: TransformField | TransformField[];
+    rows?: [FrameValue, FrameValue] | ParamRef;
+    range?: [FrameValue, FrameValue] | ParamRef;
+    groups?: [FrameValue, FrameValue] | ParamRef;
+    exclude?: Uppercase<FrameExclude> | Lowercase<FrameExclude>;
+}
+/** Aggregate transform options. */
+export interface AggregateOptions {
+    distinct?: boolean;
+}
+/** A transform argument. */
+type Arg = string | number | boolean | ParamRef;
+/** A zero argument transform signature. */
+type Arg0 = null | [];
+/** A single argument transform signature. */
+type Arg1 = Arg | [Arg];
+/**
+ * A two argument transform signature; both arguments are required.
+ */
+type Arg2 = [Arg, Arg];
+/**
+ * A two argument transform signature; the second argument is optional.
+ */
+type Arg2Opt = Arg | [Arg, Arg?];
+/**
+ * A three argument transform signature; the
+ * second and third arguments are optional.
+ */
+type Arg3Opt = Arg | [Arg, Arg?, Arg?];
+/** Binning interval names. */
+export type BinInterval = 'date' | 'number' | 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'month' | 'year';
+/** A bin transform. */
+export interface Bin {
+    /**
+     * Bin a continuous variable into discrete intervals. The bin argument
+     * specifies a data column or expression to bin. Both numerical and
+     * temporal (date/time) values are supported.
+     */
+    bin: Arg | [Arg];
+    /**
+     * The interval bin unit to use, typically used to indicate a date/time
+     * unit for binning temporal values, such as `hour`, `day`, or `month`.
+     * If `date`, the extent of data values is used to automatically select
+     * an interval for temporal data. The value `number` enforces normal
+     * numerical binning, even over temporal data. If unspecified, defaults
+     * to `number` for numerical data and `date` for temporal data.
+     */
+    interval?: BinInterval;
+    /**
+     * The step size to use between bins. When binning numerical values (or
+     * interval type `number`), this setting specifies the numerical step size.
+     * For data/time intervals, this indicates the number of steps of that unit,
+     * such as hours, days, or years.
+     */
+    step?: number;
+    /**
+     * The target number of binning steps to use. To accommodate human-friendly
+     * ("nice") bin boundaries, the actual number of bins may diverge from this
+     * exact value. This option is ignored when **step** is specified.
+     */
+    steps?: number;
+    /**
+     * The minimum allowed bin step size (default `0`) when performing numerical
+     * binning. For example, a setting of `1` prevents step sizes less than 1.
+     * This option is ignored when **step** is specified.
+     */
+    minstep?: number;
+    /**
+     * A flag (default `true`) requesting "nice" human-friendly end points and
+     * step sizes when performing numerical binning. When **step** is specified,
+     * this option affects the binning end points (e.g., origin) only.
+     */
+    nice?: true;
+    /**
+     * Offset for computed bins (default `0`). For example, a value of `1` will
+     * result in using the next consecutive bin boundary.
+     */
+    offset?: number;
+}
+/** A column transform. */
+export interface Column {
+    /**
+     * Interpret a string or param-value as a column reference.
+     */
+    column: Arg1;
+}
+/** A dateMonth transform. */
+export interface DateMonth {
+    /**
+     * Transform a Date value to a month boundary for cyclic comparison.
+     * Year values are collapsed to enable comparison over months only.
+     */
+    dateMonth: Arg1;
+}
+/** A dateMonthDay transform. */
+export interface DateMonthDay {
+    /**
+     * Transform a Date value to a month and day boundary for cyclic comparison.
+     * Year values are collapsed to enable comparison over months and days only.
+     */
+    dateMonthDay: Arg1;
+}
+/** A dateDay transform. */
+export interface DateDay {
+    /**
+     * Transform a Date value to a day of the month for cyclic comparison.
+     * Year and month values are collapsed to enable comparison over days only.
+     */
+    dateDay: Arg1;
+}
+/** A centroid transform. */
+export interface Centroid {
+    /**
+     * Compute the 2D centroid of geometry-typed data.
+     * This transform requires the DuckDB `spatial` extension.
+     */
+    centroid: Arg1;
+}
+/** A centroidX transform. */
+export interface CentroidX {
+    /**
+     * Compute the centroid x-coordinate of geometry-typed data.
+     * This transform requires the DuckDB `spatial` extension.
+     */
+    centroidX: Arg1;
+}
+/** A centroidY transform. */
+export interface CentroidY {
+    /**
+     * Compute the centroid y-coordinate of geometry-typed data.
+     * This transform requires the DuckDB `spatial` extension.
+     */
+    centroidY: Arg1;
+}
+/** A geojson transform. */
+export interface GeoJSON {
+    /**
+     * Compute a GeoJSON-formatted string from geometry-typed data.
+     * This transform requires the DuckDB `spatial` extension.
+     */
+    geojson: Arg1;
+}
+/** An argmax aggregate transform. */
+export interface Argmax extends AggregateOptions, WindowOptions {
+    /**
+     * Find a value of the first column that maximizes the second column.
+     */
+    argmax: Arg2;
+}
+/** An argmin aggregate transform. */
+export interface Argmin extends AggregateOptions, WindowOptions {
+    /**
+     * Find a value of the first column that minimizes the second column.
+     */
+    argmin: Arg2;
+}
+/** An avg (average, or mean) aggregate transform. */
+export interface Avg extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the average (mean) value of the given column.
+     */
+    avg: Arg1;
+}
+/** A count aggregate transform. */
+export interface Count extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the count of records in an aggregation group.
+     */
+    count: Arg0 | Arg1;
+}
+/** A sample covariance aggregate transform. */
+export interface Covariance extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sample covariance of between the given columns.
+     */
+    covariance: Arg2;
+}
+/** A population covariance aggregate transform. */
+export interface CovarPop extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the population covariance of between the given columns.
+     */
+    covarPop: Arg2;
+}
+/** A first aggregate transform. */
+export interface First extends AggregateOptions, WindowOptions {
+    /**
+     * Return the first column value found in an aggregation group.
+     */
+    first: Arg1;
+}
+/** A geometric mean aggregate transform. */
+export interface Geomean extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the geometric mean value of the given column.
+     */
+    geomean: Arg1;
+}
+/** A last aggregate transform. */
+export interface Last extends AggregateOptions, WindowOptions {
+    /**
+     * Return the last column value found in an aggregation group.
+     */
+    last: Arg1;
+}
+/** A max aggregate transform. */
+export interface Max extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the maximum value of the given column.
+     */
+    max: Arg1;
+}
+/** A min aggregate transform. */
+export interface Min extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the minimum value of the given column.
+     */
+    min: Arg1;
+}
+/** A median aggregate transform. */
+export interface Median extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the median value of the given column.
+     */
+    median: Arg1;
+}
+/** A mode aggregate transform. */
+export interface Mode extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the mode value of the given column.
+     */
+    mode: Arg1;
+}
+/** A product aggregate transform. */
+export interface Product extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the product of the given column.
+     */
+    product: Arg1;
+}
+/** A quantile aggregate transform. */
+export interface Quantile extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the quantile value of the given column at the provided
+     * probability threshold. For example, 0.5 is the median.
+     */
+    quantile: Arg2;
+}
+/** A sample standard deviation aggregate transform. */
+export interface Stddev extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sum of the given column.
+     */
+    stddev: Arg1;
+}
+/** A population standard deviation aggregate transform. */
+export interface StddevPop extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sum of the given column.
+     */
+    stddevPop: Arg1;
+}
+/** A sum aggregate transform. */
+export interface Sum extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sum of the given column.
+     */
+    sum: Arg1;
+}
+/** A sample variance aggregate transform. */
+export interface Variance extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sample variance of the given column.
+     */
+    variance: Arg1;
+}
+/** A population variance aggregate transform. */
+export interface VarPop extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the population variance of the given column.
+     */
+    varPop: Arg1;
+}
+/** A row_number window transform. */
+export interface RowNumber extends WindowOptions {
+    /**
+     * Compute the 1-based row number over an ordered window partition.
+     */
+    row_number: Arg0;
+}
+/** A rank window transform. */
+export interface Rank extends WindowOptions {
+    /**
+     * Compute the row rank over an ordered window partition.
+     * Sorting ties result in gaps in the rank numbers ([1, 1, 3, ...]).
+     */
+    rank: Arg0;
+}
+/** A dense_rank window transform. */
+export interface DenseRank extends WindowOptions {
+    /**
+     * Compute the dense row rank (no gaps) over an ordered window partition.
+     * Sorting ties do not result in gaps in the rank numbers ([1, 1, 2, ...]).
+     */
+    dense_rank: Arg0;
+}
+/** A percent_rank window transform. */
+export interface PercentRank extends WindowOptions {
+    /**
+     * Compute the percentage rank over an ordered window partition.
+     */
+    percent_rank: Arg0;
+}
+/** A cume_dist window transform. */
+export interface CumeDist extends WindowOptions {
+    /**
+     * Compute the cumulative distribution value over an ordered window
+     * partition. Equals the number of partition rows preceding or peer with
+     * the current row, divided by the total number of partition rows.
+     */
+    cume_dist: Arg0;
+}
+/** An ntile window transform. */
+export interface NTile extends WindowOptions {
+    /**
+     * Compute an n-tile integer ranging from 1 to the provided argument
+     * (num_buckets), dividing the partition as equally as possible.
+     */
+    ntile: Arg1;
+}
+/** A lag window transform. */
+export interface Lag extends WindowOptions {
+    /**
+     * Compute lagging values in a column. Returns the value at the row that is
+     * `offset` (second argument, default `1`) rows before the current row within
+     * the window frame. If there is no such row, instead return `default` (third
+     * argument, default `null`). Both offset and default are evaluated with
+     * respect to the current row.
+     */
+    lag: Arg3Opt;
+}
+/** A lead window transform. */
+export interface Lead extends WindowOptions {
+    /**
+     * Compute leading values in a column. Returns the value at the row that is
+     * `offset` (second argument, default `1`) rows after the current row within
+     * the window frame. If there is no such row, instead return `default` (third
+     * argument, default `null`). Both offset and default are evaluated with
+     * respect to the current row.
+     */
+    lag: Arg3Opt;
+}
+/** A first_value window transform. */
+export interface FirstValue extends WindowOptions {
+    /**
+     * Get the first value of the given column in the current window frame.
+     */
+    first_value: Arg1;
+}
+/** A last_value window transform. */
+export interface LastValue extends WindowOptions {
+    /**
+     * Get the last value of the given column in the current window frame.
+     */
+    last_value: Arg1;
+}
+/** An nth_value window transform. */
+export interface NthValue extends WindowOptions {
+    /**
+     * Get the nth value of the given column in the current window frame,
+     * counting from one. The second argument is the offset for the nth row.
+     */
+    nth_value: Arg2Opt;
+}
+/** A data transform that maps one column value to another. */
+export type ColumnTransform = Bin | Column | DateMonth | DateMonthDay | DateDay | Centroid | CentroidX | CentroidY | GeoJSON;
+/** An aggregate transform that combines multiple values. */
+export type AggregateTransform = Argmax | Argmin | Avg | Count | Max | Min | First | Last | Max | Min | Median | Mode | Product | Quantile | Stddev | StddevPop | Sum | Variance | VarPop;
+/** A window transform that operates over a sorted domain. */
+export type WindowTransform = RowNumber | Rank | DenseRank | PercentRank | CumeDist | NTile | Rank | Lag | Lead | FirstValue | LastValue | NthValue;
+/** A data transform. */
+export type Transform = ColumnTransform | AggregateTransform | WindowTransform;
+export {};
+//# sourceMappingURL=Transform.d.ts.map

package/dist/src/spec/Transform.d.ts.map

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

package/dist/src/spec/VConcat.d.ts

@@ -0,0 +1,9 @@
+import { Component } from './Spec.js';
+/** A vconcat component. */
+export interface VConcat {
+    /**
+     * Vertically concatenate components in a column layout.
+     */
+    vconcat: Component[];
+}
+//# sourceMappingURL=VConcat.d.ts.map

package/dist/src/spec/VConcat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VConcat.d.ts","sourceRoot":"","sources":["../../../src/spec/VConcat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,2BAA2B;AAC3B,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB"}

package/dist/src/spec/VSpace.d.ts

@@ -0,0 +1,10 @@
+/** A vspace component. */
+export interface VSpace {
+    /**
+     * Vertical space to place between components.
+     * Number values indicate screen pixels.
+     * String values may use CSS units (em, pt, px, etc).
+     */
+    vspace: number | string;
+}
+//# sourceMappingURL=VSpace.d.ts.map

package/dist/src/spec/VSpace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VSpace.d.ts","sourceRoot":"","sources":["../../../src/spec/VSpace.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB"}

package/dist/src/spec/interactors/BrushStyles.d.ts

@@ -0,0 +1,28 @@
+/** Styles for rectangular selection brushes. */
+export interface BrushStyles {
+    /**
+     * The overall opacity of the brush rectangle.
+     */
+    opacity?: number;
+    /**
+     * The fill opacity of the brush rectangle.
+     */
+    fillOpacity?: number;
+    /**
+     * The stroke opacity of the brush rectangle.
+     */
+    strokeOpacity?: number;
+    /**
+     * The fill color of the brush rectangle.
+     */
+    fill?: string;
+    /**
+     * The stroke color of the brush rectangle.
+     */
+    stroke?: string;
+    /**
+     * The stroke dash array of the brush rectangle.
+     */
+    strokeDasharray?: string;
+}
+//# sourceMappingURL=BrushStyles.d.ts.map

package/dist/src/spec/interactors/BrushStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrushStyles.d.ts","sourceRoot":"","sources":["../../../../src/spec/interactors/BrushStyles.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/src/spec/interactors/Highlight.d.ts

@@ -0,0 +1,38 @@
+import { ParamRef } from '../Param.js';
+/** A highlight interactor. */
+export interface Highlight {
+    /**
+     * Highlight selected marks by deemphasizing the others.
+     */
+    select: 'highlight';
+    /**
+     * The input selection. Unselected marks are deemphasized.
+     */
+    by: ParamRef;
+    /**
+     * The overall opacity of deemphasized marks.
+     * By default the opacity is set to 0.2.
+     */
+    opacity?: number;
+    /**
+     * The fill opacity of deemphasized marks.
+     * By default the fill opacity is unchanged.
+     */
+    fillOpacity?: number;
+    /**
+     * The stroke opacity of deemphasized marks.
+     * By default the stroke opacity is unchanged.
+     */
+    strokeOpacity?: number;
+    /**
+     * The fill color of deemphasized marks.
+     * By default the fill is unchanged.
+     */
+    fill?: string;
+    /**
+     * The stroke color of deemphasized marks.
+     * By default the stroke is unchanged.
+     */
+    stroke?: string;
+}
+//# sourceMappingURL=Highlight.d.ts.map

package/dist/src/spec/interactors/Highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Highlight.d.ts","sourceRoot":"","sources":["../../../../src/spec/interactors/Highlight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,EAAE,EAAE,QAAQ,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/src/spec/interactors/Interval1D.d.ts

@@ -0,0 +1,43 @@
+import { ParamRef } from '../Param.js';
+import { BrushStyles } from './BrushStyles.js';
+/** Options for 1D interval interactors. */
+export interface Interval1DOptions {
+    /**
+     * The output selection. A clause of the form `field BETWEEN lo AND hi`
+     * is added for the currently selected interval [lo, hi].
+     */
+    as: ParamRef;
+    /**
+     * The name of the field (database column) over which the interval
+     * selection should be defined. If unspecified, the  channel field of the
+     * first valid prior mark definition is used.
+     */
+    field?: string;
+    /**
+     * The size of an interactive pixel (default `1`). Larger pixel sizes reduce
+     * the brush resolution, which can reduce the size of pre-aggregated
+     * materialized views.
+     */
+    pixelSize?: number;
+    /**
+     * A flag indicating if peer (sibling) marks are excluded when
+     * cross-filtering (default `true`). If set, peer marks will not be
+     * filtered by this interactor's selection in cross-filtering setups.
+     */
+    peers?: boolean;
+    /**
+     * CSS styles for the brush (SVG `rect`) element.
+     */
+    brush?: BrushStyles;
+}
+/** An intervalX interactor. */
+export interface IntervalX extends Interval1DOptions {
+    /** Select a continuous 1D interval selection over the `x` scale domain. */
+    select: 'intervalX';
+}
+/** An intervalY interactor. */
+export interface IntervalY extends Interval1DOptions {
+    /** Select a continuous 1D interval selection over the `y` scale domain. */
+    select: 'intervalY';
+}
+//# sourceMappingURL=Interval1D.d.ts.map

package/dist/src/spec/interactors/Interval1D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interval1D.d.ts","sourceRoot":"","sources":["../../../../src/spec/interactors/Interval1D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,EAAE,EAAE,QAAQ,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,2EAA2E;IAC3E,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,2EAA2E;IAC3E,MAAM,EAAE,WAAW,CAAC;CACrB"}

package/dist/src/spec/interactors/Interval2D.d.ts

@@ -0,0 +1,48 @@
+import { ParamRef } from '../Param.js';
+import { BrushStyles } from './BrushStyles.js';
+/** Options for 2D interval interactors. */
+export interface Interval2DOptions {
+    /**
+     * The output selection. A clause of the form
+     * `(xfield BETWEEN x1 AND x2) AND (yfield BETWEEN y1 AND y2)`
+     * is added for the currently selected intervals.
+     */
+    as: ParamRef;
+    /**
+     * The name of the field (database column) over which the `x`-component
+     * of the interval selection should be defined. If unspecified, the `x`
+     * channel field of the first valid prior mark definition is used.
+     */
+    xfield?: string;
+    /**
+     * The name of the field (database column) over which the `y`-component
+     * of the interval selection should be defined. If unspecified, the `y`
+     * channel field of the first valid prior mark definition is used.
+     */
+    yfield?: string;
+    /**
+     * The size of an interactive pixel (default `1`). Larger pixel sizes reduce
+     * the brush resolution, which can reduce the size of pre-aggregated
+     * materialized views.
+     */
+    pixelSize?: number;
+    /**
+     * A flag indicating if peer (sibling) marks are excluded when
+     * cross-filtering (default `true`). If set, peer marks will not be
+     * filtered by this interactor's selection in cross-filtering setups.
+     */
+    peers?: boolean;
+    /**
+     * CSS styles for the brush (SVG `rect`) element.
+     */
+    brush?: BrushStyles;
+}
+/** An intervalXY interactor. */
+export interface IntervalXY extends Interval2DOptions {
+    /**
+     * Select a continuous 2D interval selection
+     * over the `x` and `y` scale domains.
+     */
+    select: 'intervalXY';
+}
+//# sourceMappingURL=Interval2D.d.ts.map

package/dist/src/spec/interactors/Interval2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interval2D.d.ts","sourceRoot":"","sources":["../../../../src/spec/interactors/Interval2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,EAAE,EAAE,QAAQ,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;CACtB"}

package/dist/src/spec/interactors/Nearest.d.ts

@@ -0,0 +1,45 @@
+import { ParamRef } from '../Param.js';
+/** Options for nearest interactors. */
+export interface NearestOptions {
+    /**
+     * The output selection. A clause of the form `field = value`
+     * is added for the currently nearest value.
+     */
+    as: ParamRef;
+    /**
+     * The encoding channels whose domain values should be selected. For example,
+     * a setting of `['color']` selects the data value backing the color channel,
+     * whereas `['x', 'z']` selects both x and z channel domain values. If
+     * unspecified, the selected channels default to match the current pointer
+     * settings: a `nearestX` interactor selects the `['x']` channels, while
+     * a `nearest` interactor selects the `['x', 'y']` channels.
+     */
+    channels?: string[];
+    /**
+     * The fields (database column names) to use in generated selection clause
+     * predicates. If unspecified, the fields backing the selected *channels*
+     * in the first valid prior mark definition are used by default.
+     */
+    fields?: string[];
+    /**
+     * The maximum radius of a nearest selection (default 40). Marks with (x, y)
+     * coordinates outside this radius will not be selected as nearest points.
+     */
+    maxRadius?: number;
+}
+/** A nearest interactor. */
+export interface Nearest extends NearestOptions {
+    /** Select values from the mark closest to the pointer. */
+    select: 'nearest';
+}
+/** A nearestX interactor. */
+export interface NearestX extends NearestOptions {
+    /** Select values from the mark closest to the pointer *x* location. */
+    select: 'nearestX';
+}
+/** A nearestY interactor. */
+export interface NearestY extends NearestOptions {
+    /** Select values from the mark closest to the pointer *y* location. */
+    select: 'nearestY';
+}
+//# sourceMappingURL=Nearest.d.ts.map

package/dist/src/spec/interactors/Nearest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nearest.d.ts","sourceRoot":"","sources":["../../../../src/spec/interactors/Nearest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,EAAE,EAAE,QAAQ,CAAC;IACb;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4BAA4B;AAC5B,MAAM,WAAW,OAAQ,SAAQ,cAAc;IAC7C,0DAA0D;IAC1D,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C,uEAAuE;IACvE,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,6BAA6B;AAC7B,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C,uEAAuE;IACvE,MAAM,EAAE,UAAU,CAAC;CACpB"}