@uwdata/mosaic-spec 0.8.0 → 0.10.0

package/dist/types/ast/ASTNode.d.ts

@@ -12,13 +12,13 @@ export class ASTNode {
      * @param {import('../ast-to-dom.js').InstantiateContext} ctx The instantiation context.
      * @returns {*} The instantiated value of this node.
      */
-    instantiate(ctx: import('../ast-to-dom.js').InstantiateContext): any;
+    instantiate(ctx: import("../ast-to-dom.js").InstantiateContext): any;
     /**
      * Generate ESM code for this AST node.
      * @param {import('../ast-to-esm.js').CodegenContext} ctx The code generator context.
      * @returns {string|void} The generated ESM code for the node.
      */
-    codegen(ctx: import('../ast-to-esm.js').CodegenContext): string | void;
+    codegen(ctx: import("../ast-to-esm.js").CodegenContext): string | void;
     /**
      * @returns {*} This AST node in JSON specification format.
      */

package/dist/types/ast/DataNode.d.ts

@@ -5,7 +5,7 @@
  * @param {import('../parse-spec.js').ParseContext} ctx The parser context.
  * @returns {DataNode} a parsed data definition AST node
  */
-export function parseData(name: string, spec: import('../spec/Data.js').DataDefinition, ctx: import('../parse-spec.js').ParseContext): DataNode;
+export function parseData(name: string, spec: import("../spec/Data.js").DataDefinition, ctx: import("../parse-spec.js").ParseContext): DataNode;
 export const TABLE_DATA: "table";
 export const PARQUET_DATA: "parquet";
 export const CSV_DATA: "csv";
@@ -21,13 +21,13 @@ export class QueryDataNode extends DataNode {
      * @param {import('../ast-to-dom.js').InstantiateContext} ctx The instantiation context.
      * @returns {string|void} The instantiated query.
      */
-    instantiateQuery(ctx: import('../ast-to-dom.js').InstantiateContext): string | void;
+    instantiateQuery(ctx: import("../ast-to-dom.js").InstantiateContext): string | void;
     /**
      * Code generate a table creation query.
      * @param {import('../ast-to-esm.js').CodegenContext} ctx The code generator context.
      * @returns {string|void} The generated query code.
      */
-    codegenQuery(ctx: import('../ast-to-esm.js').CodegenContext): string | void;
+    codegenQuery(ctx: import("../ast-to-esm.js").CodegenContext): string | void;
 }
 export class TableDataNode extends QueryDataNode {
     constructor(name: any, query: any, options: any);

package/dist/types/ast/SelectionNode.d.ts

@@ -1,12 +1,14 @@
 export class SelectionNode extends ASTNode {
-    constructor(select: string, cross: any);
+    constructor(select: string, cross: any, empty: any);
     select: string;
     cross: any;
+    empty: any;
     instantiate(ctx: any): any;
     codegen(ctx: any): string;
     toJSON(): {
         select: string;
         cross: any;
+        empty: any;
     };
 }
 import { ASTNode } from './ASTNode.js';

package/dist/types/ast/TransformNode.d.ts

@@ -1,4 +1,4 @@
-export function parseTransform(spec: any, ctx: any): TransformNode;
+export function parseTransform(spec: any, ctx: any): BinTransformNode | TransformNode;
 export class TransformNode extends ASTNode {
     constructor(name: any, args: any, options: any);
     name: any;
@@ -10,4 +10,12 @@ export class TransformNode extends ASTNode {
         [x: number]: any;
     };
 }
+export class BinTransformNode extends ASTNode {
+    constructor(name: any, arg: any, options: any);
+    name: any;
+    arg: any;
+    options: any;
+    instantiate(ctx: any): any;
+    codegen(ctx: any): string;
+}
 import { ASTNode } from './ASTNode.js';

package/dist/types/index.d.ts

@@ -22,7 +22,7 @@ export { VSpaceNode } from "./ast/VSpaceNode.js";
 /**
  * A Mosaic declarative specification.
  */
-export type Spec = import('./spec/Spec.js').Spec;
+export type Spec = import("./spec/Spec.js").Spec;
 export { astToDOM, InstantiateContext } from "./ast-to-dom.js";
 export { astToESM, CodegenContext } from "./ast-to-esm.js";
 export { DataNode, QueryDataNode, TableDataNode, FileDataNode, CSVDataNode, JSONDataNode, ParquetDataNode, SpatialDataNode, LiteralJSONDataNode } from "./ast/DataNode.js";

package/dist/types/parse-spec.d.ts

@@ -20,7 +20,7 @@
  *  dataset definition AST nodes.
  * @returns {SpecNode} The top-level AST spec node.
  */
-export function parseSpec(spec: import('./spec/Spec.js').Spec, options?: {
+export function parseSpec(spec: import("./spec/Spec.js").Spec, options?: {
     components?: Map<string, Function>;
     transforms?: Set<string>;
     inputs?: Set<string>;

package/dist/types/spec/Input.d.ts

@@ -10,6 +10,11 @@ export interface Menu {
      * currently selected menu option.
      */
     as?: ParamRef;
+    /**
+     * The database column name to use within generated selection clause
+     * predicates. Defaults to the `column` property.
+     */
+    field?: string;
     /**
      * The name of a database table to use as a data source for this widget.
      * Used in conjunction with the `column` property.
@@ -32,11 +37,14 @@ export interface Menu {
     /**
      * An array of menu options, as literal values or option objects.
      * Option objects have a `value` property and an optional `label` property.
-     * If no label is provided, the (string-coerced) value is used.
+     * If no label is provided, the string-coerced value is used.
      */
-    options?: Array<any>;
+    options?: Array<any | {
+        value: any;
+        label?: string;
+    }>;
     /**
-     * The initial selected menu option.
+     * The initial selected menu value.
      */
     value?: any;
 }
@@ -51,6 +59,11 @@ export interface Search {
      * current text search query.
      */
     as?: ParamRef;
+    /**
+     * The database column name to use within generated selection clause
+     * predicates. Defaults to the `column` property.
+     */
+    field?: string;
     /**
      * The type of text search query to perform. One of:
      * - `"contains"` (default): the query string may appear anywhere in the text
@@ -90,6 +103,18 @@ export interface Slider {
      * currently selected slider option.
      */
     as?: ParamRef;
+    /**
+     * The database column name to use within generated selection clause
+     * predicates. Defaults to the `column` property.
+     */
+    field?: string;
+    /**
+     * The type of selection clause predicate to generate if the **as** option
+     * is a Selection. If `'point'` (the default), the selection predicate is an
+     * equality check for the slider value. If `'interval'`, the predicate checks
+     * an interval from the minimum to the current slider value.
+     */
+    select?: 'point' | 'interval';
     /**
      * The name of a database table to use as a data source for this widget.
      * Used in conjunction with the `column` property.
@@ -137,6 +162,11 @@ export interface Table {
      * A table grid widget.
      */
     input: 'table';
+    /**
+     * The output selection. A selection clause is added for each
+     * currently selected table row.
+     */
+    as?: ParamRef;
     /**
      * The name of a database table to use as a data source for this widget.
      */

package/dist/types/spec/Param.d.ts

@@ -46,6 +46,12 @@ export interface Selection {
      * but not oneself (default `false`, except for `crossfilter` selections).
      */
     cross?: boolean;
+    /**
+     * A flag for setting an initial empty selection state. If true, a selection
+     * with no clauses corresponds to an empty selection with no records. If
+     * false, a selection with no clauses selects all values.
+     */
+    empty?: boolean;
 }
 /** A Param or Selection definition. */
 export type ParamDefinition = ParamValue | Param | ParamDate | Selection;

package/dist/types/spec/PlotAttribute.d.ts

@@ -1328,6 +1328,12 @@ export interface PlotAttributes {
      * For continuous scales only.
      */
     rNice?: boolean | number | Interval | 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.
+     */
+    rLabel?: string | null | ParamRef;
     /**
      * If true, shorthand for a transform suitable for percentages, mapping
      * proportions in [0, 1] to [0, 100].

package/dist/types/spec/PlotMark.d.ts

@@ -8,6 +8,7 @@ import { DelaunayLink, DelaunayMesh, Hull, Voronoi, VoronoiMesh } from './marks/
 import { DenseLine } from './marks/DenseLine.js';
 import { Density, DensityX, DensityY } from './marks/Density.js';
 import { Circle, Dot, DotX, DotY, Hexagon } from './marks/Dot.js';
+import { ErrorBarX, ErrorBarY } from './marks/ErrorBar.js';
 import { Frame } from './marks/Frame.js';
 import { Geo, Graticule, Sphere } from './marks/Geo.js';
 import { Hexbin } from './marks/Hexbin.js';
@@ -23,4 +24,4 @@ import { Text, TextX, TextY } from './marks/Text.js';
 import { TickX, TickY } from './marks/Tick.js';
 import { Spike, Vector, VectorX, VectorY } from './marks/Vector.js';
 /** A plot mark entry. */
-export type PlotMark = Area | AreaX | AreaY | Arrow | AxisX | AxisY | AxisFx | AxisFy | GridX | GridY | GridFx | GridFy | BarX | BarY | Cell | CellX | CellY | Contour | DelaunayLink | DelaunayMesh | Hull | Voronoi | VoronoiMesh | DenseLine | Density | DensityX | DensityY | Dot | DotX | DotY | Circle | Hexagon | Frame | Geo | Graticule | Sphere | Hexbin | Hexgrid | Image | Line | LineX | LineY | Link | Raster | Heatmap | RasterTile | Rect | RectX | RectY | RegressionY | RuleX | RuleY | Text | TextX | TextY | TickX | TickY | Vector | VectorX | VectorY | Spike;
+export type PlotMark = Area | AreaX | AreaY | Arrow | AxisX | AxisY | AxisFx | AxisFy | GridX | GridY | GridFx | GridFy | BarX | BarY | Cell | CellX | CellY | Contour | DelaunayLink | DelaunayMesh | Hull | Voronoi | VoronoiMesh | DenseLine | Density | DensityX | DensityY | Dot | DotX | DotY | Circle | Hexagon | ErrorBarX | ErrorBarY | Frame | Geo | Graticule | Sphere | Hexbin | Hexgrid | Image | Line | LineX | LineY | Link | Raster | Heatmap | RasterTile | Rect | RectX | RectY | RegressionY | RuleX | RuleY | Text | TextX | TextY | TickX | TickY | Vector | VectorX | VectorY | Spike;

package/dist/types/spec/Spec.d.ts

@@ -28,6 +28,13 @@ export type Data = Record<string, DataDefinition>;
 export type Params = Record<string, ParamDefinition>;
 /** Top-level specification properties. */
 export interface SpecHead {
+    /**
+     * A [JSON schema](http://json-schema.org/) URL for this specification,
+     * such as https://uwdata.github.io/mosaic/schema/latest.json. This property
+     * enables validation and autocomplete in editors with JSON schema support.
+     * @format uri
+     */
+    $schema?: string;
     /** Specification metadata. */
     meta?: Meta;
     /** Configuration options. */

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

@@ -31,20 +31,47 @@ type Arg2Opt = Arg | [Arg, Arg?];
  * second and third arguments are optional.
  */
 type Arg3Opt = Arg | [Arg, Arg?, Arg?];
-/** Bin transform options. */
-export interface BinOptions {
+/** Binning interval names. */
+export type BinInterval = 'date' | 'number' | 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'month' | 'year';
+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
-     * bin boundaries, the actual number of bins may diverge from this exact number.
+     * ("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`).
-     * For example, a setting of `1` will prevent step sizes less than 1.
+     * 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 requesting "nice" human-friendly step sizes (default `true`).
+     * 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;
     /**
@@ -53,13 +80,6 @@ export interface BinOptions {
      */
     offset?: number;
 }
-export interface Bin {
-    /**
-     * Bin a continuous variable into discrete intervals. This transform accepts
-     * a data column to bin over as well as an optional bin options object.
-     */
-    bin: Arg | [Arg] | [Arg, BinOptions];
-}
 export interface DateMonth {
     /**
      * Transform a Date value to a month boundary for cyclic comparison.
@@ -133,6 +153,18 @@ export interface Count extends AggregateOptions, WindowOptions {
      */
     count: Arg0 | Arg1;
 }
+export interface Covariance extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sample covariance of between the given columns.
+     */
+    covariance: Arg2;
+}
+export interface CovarPop extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the population covariance of between the given columns.
+     */
+    covarPop: Arg2;
+}
 export interface First extends AggregateOptions, WindowOptions {
     /**
      * Return the first column value found in an aggregation group.
@@ -182,12 +214,36 @@ export interface Quantile extends AggregateOptions, WindowOptions {
      */
     quantile: Arg2;
 }
+export interface Stddev extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sum of the given column.
+     */
+    stddev: Arg1;
+}
+export interface StddevPop extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sum of the given column.
+     */
+    stddevPop: Arg1;
+}
 export interface Sum extends AggregateOptions, WindowOptions {
     /**
      * Compute the sum of the given column.
      */
     sum: Arg1;
 }
+export interface Variance extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the sample variance of the given column.
+     */
+    variance: Arg1;
+}
+export interface VarPop extends AggregateOptions, WindowOptions {
+    /**
+     * Compute the population variance of the given column.
+     */
+    varPop: Arg1;
+}
 export interface RowNumber extends WindowOptions {
     /**
      * Compute the 1-based row number over an ordered window partition.
@@ -271,7 +327,7 @@ export interface NthValue extends WindowOptions {
 /** A data transform that maps one column value to another. */
 export type ColumnTransform = Bin | 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 | Sum;
+export type AggregateTransform = Argmax | Argmin | Avg | Count | Max | Min | First | Last | Max | Min | Median | Mode | Product | Quantile | Stddev | StddevPop | Sum | Variance | VarPop;
 export type WindowTransform = RowNumber | Rank | DenseRank | PercentRank | CumeDist | NTile | Rank | Lag | Lead | FirstValue | LastValue | NthValue;
 /** A data transform. */
 export type Transform = ColumnTransform | AggregateTransform | WindowTransform;

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

@@ -7,19 +7,38 @@ export interface NearestOptions {
      */
     as: ParamRef;
     /**
-     * The name of the field (database column) over which the nearest
-     * selection should be defined. If unspecified, the  channel field of the
-     * first valid prior mark definition is used.
+     * 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.
      */
-    field?: string;
+    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 the **x** domain value of the mark closest to the pointer. */
+    /** Select values from the mark closest to the pointer *x* location. */
     select: 'nearestX';
 }
 /** A nearestY interactor. */
 export interface NearestY extends NearestOptions {
-    /** Select the **y** domain value of the mark closest to the pointer. */
+    /** Select values from the mark closest to the pointer *y* location. */
     select: 'nearestY';
 }

package/dist/types/spec/interactors/Toggle.d.ts

@@ -41,6 +41,14 @@ export interface ToggleY extends ToggleOptions {
      */
     select: 'toggleY';
 }
+/** A toggleZ interactor. */
+export interface ToggleZ extends ToggleOptions {
+    /**
+     * Select individal values in the `z` scale domain.
+     * Clicking or touching a mark toggles its selection status.
+     */
+    select: 'toggleZ';
+}
 /** A toggleColor interactor. */
 export interface ToggleColor extends ToggleOptions {
     /**

package/dist/types/spec/marks/Dot.d.ts

@@ -13,6 +13,10 @@ export interface DotOptions extends MarkOptions {
      * to the *y* scale.
      */
     y?: ChannelValueSpec;
+    /**
+     * An optional ordinal channel for grouping data into series.
+     */
+    z?: ChannelValue;
     /**
      * The radius of dots; either a channel or constant. When a number, it is
      * interpreted as a constant radius in pixels. Otherwise it is interpreted as

package/dist/types/spec/marks/ErrorBar.d.ts

@@ -0,0 +1,82 @@
+import { ParamRef } from '../Param.js';
+import { ChannelValue, ChannelValueSpec, MarkData, MarkOptions, MarkerOptions } from './Marks.js';
+/** Options for errorbar marks. */
+interface ErrorBarOptions extends MarkOptions, MarkerOptions {
+    /**
+     * The confidence interval in (0, 1); defaults to 0.95.
+     */
+    ci?: number | ParamRef;
+    /**
+     * An optional ordinal channel for grouping data, producing an independent
+     * error bar for each group. If not specified, it defaults to **stroke** if
+     * a channel.
+     */
+    z?: ChannelValue;
+}
+/** Options for the errorbarX mark. */
+export interface ErrorBarXOptions extends ErrorBarOptions {
+    /**
+     * The dependent variable horizontal position channel, typically bound to the
+     * *x* scale.
+     */
+    x: ChannelValueSpec;
+    /**
+     * The independent variable vertical position channel, typically bound to
+     * the *y* scale; defaults to the zero-based index of the data [0, 1, 2, …].
+     */
+    y?: ChannelValueSpec;
+}
+/** The errorbarX mark. */
+export interface ErrorBarX extends MarkData, ErrorBarXOptions {
+    /**
+     * A mark that draws error bars for a calculated parametric confidence
+     * interval for a dependent variable (*x*), potentially grouped by an
+     * independent variable (*y*).
+     *
+     * This mark aggregates raw values to produce a [parametric confidence
+     * interval][1] of the mean, assuming a normal distribution. To instead
+     * visualize pre-computeted interval values or custom aggregations, use
+     * a **ruleY** mark with specified **x1** and **x2** channels.
+     *
+     * Multiple error bars can be produced by specifying a **z** or **stroke**
+     * channel. Set the **marker** option to `'tick'` to add small perpendicular
+     * lines at the start and end of the error interval.
+     *
+     * [1]: https://en.wikipedia.org/wiki/Normal_distribution#Confidence_intervals
+     */
+    mark: 'errorbarX';
+}
+/** Options for the errorbarY mark. */
+export interface ErrorBarYOptions extends ErrorBarOptions {
+    /**
+     * The independent variable horizontal position channel, typically bound to
+     * the *x* scale; defaults to the zero-based index of the data [0, 1, 2, …].
+     */
+    x?: ChannelValueSpec;
+    /**
+     * The dependent variable vertical position channel, typically bound to the
+     * *y* scale.
+     */
+    y: ChannelValueSpec;
+}
+/** The errorbarY mark. */
+export interface ErrorBarY extends MarkData, ErrorBarYOptions {
+    /**
+     * A mark that draws error bars for a calculated parametric confidence
+     * interval for a dependent variable (*y*), potentially grouped by an
+     * independent variable (*x*).
+     *
+     * This mark aggregates raw values to produce a [parametric confidence
+     * interval][1] of the mean, assuming a normal distribution. To instead
+     * visualize pre-computeted interval values or custom aggregations, use
+     * a **ruleX** mark with specified **y1** and **y2** channels.
+     *
+     * Multiple error bars can be produced by specifying a **z** or **stroke**
+     * channel. Set the **marker** option to `'tick'` to add small perpendicular
+     * lines at the start and end of the error interval.
+     *
+     * [1]: https://en.wikipedia.org/wiki/Normal_distribution#Confidence_intervals
+     */
+    mark: 'errorbarY';
+}
+export {};

package/dist/types/spec/marks/Marks.d.ts

@@ -147,6 +147,8 @@ export type SortOrder = ChannelValue | {
 };
 /** The pointer mode for the tip; corresponds to pointerX, pointerY, and pointer. */
 export type TipPointer = 'x' | 'y' | 'xy';
+/** Selection filters to apply internally to mark data. */
+export type SelectFilter = 'first' | 'last' | 'maxX' | 'maxY' | 'minX' | 'minY' | 'nearest' | 'nearestX' | 'nearestY';
 export interface MarkData {
     /**
      * The data source for the mark.
@@ -166,9 +168,22 @@ export interface MarkOptions {
      * channel values; only truthy values are retained.
      *
      * Note that filtering only affects the rendered mark index, not the
-     * associated channel values, and thus has no effect on imputed scale domains.
+     * associated channel values, and has no effect on imputed scale domains.
      */
     filter?: ChannelValue;
+    /**
+     * Applies a filter transform after data is loaded to highlight selected
+     * values only. For example, `first` and `last` select the first or last
+     * values of series only (using the *z* channel to separate series).
+     * Meanwhile, `nearestX` and `nearestY` select the point nearest to the
+     * pointer along the *x* or *y* channel dimension. Unlike Mosaic selections,
+     * a mark level *select* is internal to the mark only, and does not populate
+     * a param or selection value to be shared across clients.
+     *
+     * Note that filtering only affects the rendered mark index, not the
+     * associated channel values, and has no effect on imputed scale domains.
+     */
+    select?: SelectFilter;
     /**
      * Applies a transform to reverse the order of the mark’s index, say for
      * reverse input order.

package/dist/types/spec/marks/Text.d.ts

@@ -13,6 +13,10 @@ export interface TextOptions extends MarkOptions, TextStyles {
      * bound to the *y* scale.
      */
     y?: ChannelValueSpec;
+    /**
+     * An optional ordinal channel for grouping data into series.
+     */
+    z?: ChannelValue;
     /**
      * The text contents channel, possibly with line breaks (\n, \r\n, or \r). If
      * not specified, defaults to the zero-based index [0, 1, 2, …].

package/dist/types/util.d.ts

@@ -2,11 +2,11 @@ export function paramRef(value: any): any;
 export function paramStr(value: any): any;
 export function toParamRef(name: any): string;
 export function toArray(value: any): any[];
-export function isArray(value: any): boolean;
+export function isArray(value: any): value is any[];
 export function isObject(value: any): boolean;
-export function isNumber(value: any): boolean;
+export function isNumber(value: any): value is number;
 export function isNumberOrString(value: any): boolean;
-export function isString(value: any): boolean;
+export function isString(value: any): value is string;
 export function isFunction(value: any): boolean;
 export function error(message: any, data: any): void;
 export function isoparse(string: any, fallback: any): any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uwdata/mosaic-spec",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Declarative specification of Mosaic-powered applications.",
   "keywords": [
     "mosaic",
@@ -10,7 +10,7 @@
     "specification"
   ],
   "license": "BSD-3-Clause",
-  "author": "Jeffrey Heer (http://idl.cs.washington.edu)",
+  "author": "Jeffrey Heer (https://idl.uw.edu)",
   "type": "module",
   "main": "src/index.js",
   "module": "src/index.js",
@@ -29,16 +29,14 @@
     "schema": "ts-json-schema-generator -f tsconfig.json -p src/spec/Spec.ts -t Spec --no-type-check --no-ref-encode --functions hide > dist/mosaic-schema.json",
     "pretest": "npm run prebuild && npm run types",
     "test": "mocha 'test/**/*-test.js' && tsc -p jsconfig.json",
+    "version": "cd ../.. && npm run docs:schema",
     "prepublishOnly": "npm run test && npm run lint && npm run build"
   },
   "dependencies": {
-    "@uwdata/mosaic-core": "^0.8.0",
-    "@uwdata/mosaic-sql": "^0.8.0",
-    "@uwdata/vgplot": "^0.8.0",
-    "ts-json-schema-generator": "^2.1.1"
+    "@uwdata/mosaic-core": "^0.10.0",
+    "@uwdata/mosaic-sql": "^0.10.0",
+    "@uwdata/vgplot": "^0.10.0",
+    "ts-json-schema-generator": "^2.3.0"
   },
-  "devDependencies": {
-    "ajv": "^8.13.0"
-  },
-  "gitHead": "a24b4c9f7dfa1c38c6af96ec17e075326c1af9b0"
+  "gitHead": "94fc4f0d4efc622001f6afd6714d1e9dda745be2"
 }

package/src/ast/ParamNode.js

@@ -7,13 +7,13 @@ const paramTypes = new Set([VALUE, SINGLE, CROSSFILTER, INTERSECT, UNION]);
 
 export function parseParam(spec, ctx) {
   const param = isObject(spec) ? spec : { value: spec };
-  const { select = VALUE, cross, date, value } = param;
+  const { select = VALUE, cross, empty, date, value } = param;
   if (!paramTypes.has(select)) {
     ctx.error(`Unrecognized param type: ${select}`, param);
   }
 
   if (select !== VALUE) {
-    return new SelectionNode(select, cross);
+    return new SelectionNode(select, cross, empty);
   } else if (isArray(value)) {
     return new ParamNode(value.map(v => ctx.maybeParam(v)));
   } else {