@uwdata/mosaic-spec 0.10.0 → 0.12.0

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

@@ -0,0 +1,8 @@
+export class ColumnParamRefNode extends ASTNode {
+    constructor(param: any);
+    param: any;
+    instantiate(ctx: any): any;
+    codegen(ctx: any): string;
+    toJSON(): string;
+}
+import { ASTNode } from './ASTNode.js';

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

@@ -1,15 +1,13 @@
 export function parseExpression(spec: any, ctx: any): ExpressionNode;
 export class ExpressionNode extends ASTNode {
-    constructor(value: any, spans: any, params: any, label: any, aggregate: any);
+    constructor(value: any, spans: any, params: any);
     value: any;
     spans: any;
     params: any;
-    label: any;
-    aggregate: any;
     instantiate(ctx: any): any;
     codegen(ctx: any): string;
     toJSON(): {
-        [x: string]: any;
+        sql: any;
     };
 }
 import { ASTNode } from './ASTNode.js';

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

@@ -1,9 +1,8 @@
-export function parseParam(spec: any, ctx: any): SelectionNode | ParamNode;
+export function parseParam(spec: any, ctx: any): import("./SelectionNode.js").SelectionNode | ParamNode;
 export class ParamNode extends ASTNode {
     value: any;
     date: any;
     instantiate(ctx: any): any;
     codegen(ctx: any): string;
 }
-import { SelectionNode } from './SelectionNode.js';
 import { ASTNode } from './ASTNode.js';

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

@@ -2,7 +2,7 @@ export class ParamRefNode extends ASTNode {
     constructor(name: any);
     name: any;
     instantiate(ctx: any): any;
-    codegen(): string;
+    codegen(ctx: any): string;
     toJSON(): string;
 }
 import { ASTNode } from './ASTNode.js';

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

@@ -1,14 +1,24 @@
+export function parseSelection(spec: any, ctx: any): SelectionNode;
 export class SelectionNode extends ASTNode {
-    constructor(select: string, cross: any, empty: any);
+    /**
+     * Create a Selection AST node.
+     * @param {string} select The selection type.
+     * @param {OptionsNode} options Selection options.
+     */
+    constructor(select?: string, options?: OptionsNode);
     select: string;
-    cross: any;
-    empty: any;
+    options: OptionsNode;
     instantiate(ctx: any): any;
     codegen(ctx: any): string;
     toJSON(): {
         select: string;
-        cross: any;
-        empty: any;
     };
 }
+export class IncludeNode extends ASTNode {
+    constructor(refs: any);
+    refs: any;
+    instantiate(ctx: any): any;
+    codegen(ctx: any): string;
+}
 import { ASTNode } from './ASTNode.js';
+import { OptionsNode } from './OptionsNode.js';

package/dist/types/constants.d.ts

@@ -4,7 +4,9 @@ export const DATAREF: "dataref";
 export const OPTIONS: "options";
 export const SELECTION: "selection";
 export const PARAMREF: "paramref";
+export const COLUMPARAMREF: "columnparamref";
 export const PARAM: "param";
+export const INCLUDE: "include";
 export const SELECT: "select";
 export const VALUE: "value";
 export const CROSSFILTER: "crossfilter";
@@ -14,7 +16,6 @@ export const SINGLE: "single";
 export const DATA: "data";
 export const EXPRESSION: "expression";
 export const SQL: "sql";
-export const AGG: "agg";
 export const INPUT: "input";
 export const HCONCAT: "hconcat";
 export const VCONCAT: "vconcat";

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

@@ -59,15 +59,40 @@ export class ParseContext {
     plotDefaults: import("./ast/PlotAttributeNode.js").PlotAttributeNode[];
     parseComponent(spec: any): any;
     /**
-     * Test if a value is param reference, if so, generate a paramter definition
-     * as needed and return a new ParamRefNode. Otherwise, return a LiteralNode.
+     * Test if a value is a param reference, if so, generates a parameter
+     * definition as needed and returns a new ParamRefNode. Otherwise,
+     * returns a LiteralNode for the given value.
      * @param {*} value The value to test.
-     * @param {() => ParamNode | SelectionNode} [makeNode] A Param of Selection AST
-     *  node constructor.
      * @returns {ParamRefNode|LiteralNode} An AST node for the input value.
      */
-    maybeParam(value: any, makeNode?: () => ParamNode | SelectionNode): ParamRefNode | LiteralNode;
-    maybeSelection(value: any): LiteralNode | ParamRefNode;
+    maybeParam(value: any): ParamRefNode | LiteralNode;
+    /**
+     * Test if a value is a param reference, if so, generates a selection
+     * definition as needed and returns a new ParamRefNode. Otherwise,
+     * returns a LiteralNode for the given value.
+     * @param {*} value The value to test.
+     * @returns {ParamRefNode|LiteralNode} An AST node for the input value.
+     */
+    maybeSelection(value: any): ParamRefNode | LiteralNode;
+    /**
+     * Create a parameter reference. Generates a parameter definition if needed
+     * and returns a new ParamRefNode.
+     * @param {string} name The parameter name.
+     * @param {() => ParamNode | SelectionNode} [makeNode] A Param or Selection AST
+     *  node constructor.
+     * @returns {ParamRefNode|null} A node referring to the param or selection.
+     */
+    paramRef(name: string, makeNode?: () => ParamNode | SelectionNode): ParamRefNode | null;
+    /**
+     * Create a selection reference. Generates a selection definition if needed
+     * and returns a new ParamRefNode. Returns null if a non-selection parameter
+     * with the same name already exists and *strict* is true.
+     * @param {string} name The selection name.
+     * @param {boolean} [strict=false] Indicates if this method may return param
+     *  references (false, default) or only selection references (true).
+     * @returns {ParamRefNode|null} A node referring to the param or selection.
+     */
+    selectionRef(name: string, strict?: boolean): ParamRefNode | null;
     error(message: any, data: any): void;
 }
 /**
@@ -80,7 +105,7 @@ export type PlotNames = {
     marks: Set<string>;
 };
 import { SpecNode } from './ast/SpecNode.js';
-import { ParamNode } from './ast/ParamNode.js';
-import { SelectionNode } from './ast/SelectionNode.js';
 import { ParamRefNode } from './ast/ParamRefNode.js';
 import { LiteralNode } from './ast/LiteralNode.js';
+import { ParamNode } from './ast/ParamNode.js';
+import { SelectionNode } from './ast/SelectionNode.js';

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

@@ -170,7 +170,7 @@ export interface Table {
     /**
      * The name of a database table to use as a data source for this widget.
      */
-    from: string;
+    from: string | ParamRef;
     /**
      * A list of column names to include in the table grid.
      * If unspecified, all table columns are included.

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

@@ -52,6 +52,12 @@ export interface Selection {
      * false, a selection with no clauses selects all values.
      */
     empty?: boolean;
+    /**
+     * Upstream selections whose clauses should be included as part of this
+     * selection. Any clauses or activations published to the upstream
+     * selections will be relayed to this selection.
+     */
+    include?: ParamRef | ParamRef[];
 }
 /** A Param or Selection definition. */
 export type ParamDefinition = ParamValue | Param | ParamDate | Selection;

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

@@ -148,13 +148,19 @@ export interface PlotAttributes {
      */
     grid?: boolean | string | 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.
+     * The [aria-label attribute][1] on the SVG root.
      *
-     * For axes and legends only.
+     * [1]: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label
+     */
+    ariaLabel?: string | null;
+    /**
+     * The [aria-description attribute][1] on the SVG root.
+     *
+     * [1]: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-description
      */
-    label?: string | null | ParamRef;
+    ariaDescription?: string | null;
+    /** The default clip for all marks. */
+    clip?: 'frame' | 'sphere' | boolean | null | ParamRef;
     /**
      * The *x* scale type, affecting how the scale encodes abstract data, say by
      * applying a mathematical transformation. If null, the scale is disabled.

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

@@ -7,7 +7,7 @@ export type PlotDataInline = any[];
 /** Input data specification for a plot mark. */
 export interface PlotFrom {
     /** The name of the backing data table. */
-    from: string;
+    from: string | ParamRef;
     /** A selection that filters the mark data. */
     filterBy?: ParamRef;
     /**

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

@@ -3,6 +3,7 @@ import { IntervalX, IntervalY } from './interactors/Interval1D.js';
 import { IntervalXY } from './interactors/Interval2D.js';
 import { NearestX, NearestY } from './interactors/Nearest.js';
 import { Pan, PanX, PanY, PanZoom, PanZoomX, PanZoomY } from './interactors/PanZoom.js';
+import { Region } from './interactors/Region.js';
 import { Toggle, ToggleColor, ToggleX, ToggleY } from './interactors/Toggle.js';
 /** A plot interactor entry. */
-export type PlotInteractor = Highlight | IntervalX | IntervalY | IntervalXY | NearestX | NearestY | Toggle | ToggleX | ToggleY | ToggleColor | Pan | PanX | PanY | PanZoom | PanZoomX | PanZoomY;
+export type PlotInteractor = Highlight | IntervalX | IntervalY | IntervalXY | NearestX | NearestY | Pan | PanX | PanY | PanZoom | PanZoomX | PanZoomY | Region | Toggle | ToggleX | ToggleY | ToggleColor;

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

@@ -13,7 +13,7 @@ export interface AggregateOptions {
     distinct?: boolean;
 }
 /** A transform argument. */
-type Arg = string | number | boolean;
+type Arg = string | number | boolean | ParamRef;
 /** A zero argument transform signature. */
 type Arg0 = null | [];
 /** A single argument transform signature. */
@@ -80,6 +80,12 @@ export interface Bin {
      */
     offset?: number;
 }
+export interface Column {
+    /**
+     * Intpret a string or param-value as a column reference.
+     */
+    column: Arg1;
+}
 export interface DateMonth {
     /**
      * Transform a Date value to a month boundary for cyclic comparison.
@@ -325,7 +331,7 @@ export interface NthValue extends WindowOptions {
     nth_value: Arg2Opt;
 }
 /** A data transform that maps one column value to another. */
-export type ColumnTransform = Bin | DateMonth | DateMonthDay | DateDay | Centroid | CentroidX | CentroidY | GeoJSON;
+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;
 export type WindowTransform = RowNumber | Rank | DenseRank | PercentRank | CumeDist | NTile | Rank | Lag | Lead | FirstValue | LastValue | NthValue;

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

@@ -0,0 +1,27 @@
+/** 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;
+}

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

@@ -1,27 +1,5 @@
 import { ParamRef } from '../Param.js';
-/** 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;
-}
+import { BrushStyles } from './BrushStyles.js';
 /** Options for 1D interval interactors. */
 export interface Interval1DOptions {
     /**
@@ -37,13 +15,14 @@ export interface Interval1DOptions {
     field?: string;
     /**
      * The size of an interative pixel (default `1`). Larger pixel sizes reduce
-     * the brush resolution, which can reduce the size of data cube indexes.
+     * the brush resolution, which can reduce the size of pre-aggregated
+     * materialized views.
      */
     pixelSize?: number;
     /**
-     * A flag indicating if peer (sibling) marks are when cross-filtering
-     * (default `true`). If set, peer marks will not be filtered by this
-     * interactor's selection in cross-filtering setups.
+     * 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;
     /**

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

@@ -1,5 +1,5 @@
 import { ParamRef } from '../Param.js';
-import { BrushStyles } from './Interval1D.js';
+import { BrushStyles } from './BrushStyles.js';
 /** Options for 2D interval interactors. */
 export interface Interval2DOptions {
     /**
@@ -22,13 +22,14 @@ export interface Interval2DOptions {
     yfield?: string;
     /**
      * The size of an interative pixel (default `1`). Larger pixel sizes reduce
-     * the brush resolution, which can reduce the size of data cube indexes.
+     * the brush resolution, which can reduce the size of pre-aggregated
+     * materialized views.
      */
     pixelSize?: number;
     /**
-     * A flag indicating if peer (sibling) marks are when cross-filtering
-     * (default `true`). If set, peer marks will not be filtered by this
-     * interactor's selection in cross-filtering setups.
+     * 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;
     /**

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

@@ -0,0 +1,32 @@
+import { ParamRef } from '../Param.js';
+import { BrushStyles } from './BrushStyles.js';
+/** Options for region interactors. */
+export interface RegionOptions {
+    /**
+     * The output selection. A clause of the form
+     * `(field = value1) OR (field = value2) ...`
+     * is added for the currently selected values.
+     */
+    as: ParamRef;
+    /**
+     * The encoding channels over which to select values.
+     * For a selected mark, selection clauses will cover
+     * the backing data fields for each channel.
+     */
+    channels: string[];
+    /**
+     * 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;
+}
+/** A rectangular region interactor. */
+export interface Region extends RegionOptions {
+    /** Select aspects of individual marks within a 2D range. */
+    select: 'region';
+}

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

@@ -8,9 +8,9 @@ export interface ToggleOptions {
      */
     as: ParamRef;
     /**
-     * A flag indicating if peer (sibling) marks are when cross-filtering
-     * (default `true`). If set, peer marks will not be filtered by this
-     * interactor's selection in cross-filtering setups.
+     * 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;
 }

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

@@ -337,6 +337,11 @@ export interface MarkOptions {
     tip?: boolean | TipPointer | (TipOptions & {
         pointer?: TipPointer;
     }) | ParamRef;
+    /**
+     * Additional named channels, for example to include in a tooltip.
+     * Consists of (channel name, data field name) key-value pairs.
+     */
+    channels?: Record<string, string>;
     /**
      * How to clip the mark; one of:
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uwdata/mosaic-spec",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Declarative specification of Mosaic-powered applications.",
   "keywords": [
     "mosaic",
@@ -25,18 +25,18 @@
     "prebuild": "rimraf dist && mkdir dist",
     "build": "npm run types && node ../../esbuild.js mosaic-spec",
     "lint": "eslint src test",
-    "types": "tsc -p tsconfig.json && npm run schema",
+    "types": "tsc && npm run schema",
     "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",
+    "test": "vitest run && 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.10.0",
-    "@uwdata/mosaic-sql": "^0.10.0",
-    "@uwdata/vgplot": "^0.10.0",
+    "@uwdata/mosaic-core": "^0.12.0",
+    "@uwdata/mosaic-sql": "^0.12.0",
+    "@uwdata/vgplot": "^0.12.0",
     "ts-json-schema-generator": "^2.3.0"
   },
-  "gitHead": "94fc4f0d4efc622001f6afd6714d1e9dda745be2"
+  "gitHead": "523b1afe2a0880291c92f81e4a7b91829362d285"
 }

package/src/ast/ColumnParamRefNode.js

@@ -0,0 +1,21 @@
+import { ASTNode } from './ASTNode.js';
+import { COLUMPARAMREF } from '../constants.js';
+
+export class ColumnParamRefNode extends ASTNode {
+  constructor(param) {
+    super(COLUMPARAMREF);
+    this.param = param;
+  }
+
+  instantiate(ctx) {
+    return ctx.api.column(this.param.instantiate(ctx));
+  }
+
+  codegen(ctx) {
+    return `${ctx.ns()}column(${this.param.codegen(ctx)})`;
+  }
+
+  toJSON() {
+    return `$${this.param.toJSON}`;
+  }
+}

package/src/ast/DataNode.js

@@ -1,4 +1,4 @@
-import { create } from '@uwdata/mosaic-sql';
+import { createTable } from '@uwdata/mosaic-sql';
 import { DATA } from '../constants.js';
 import { isArray, isString } from '../util.js';
 import { ASTNode } from './ASTNode.js';
@@ -162,7 +162,7 @@ export class TableDataNode extends QueryDataNode {
   instantiateQuery(ctx) {
     const { name, query, options } = this;
     if (query) {
-      return ctx.api.create(name, query, options.instantiate(ctx));
+      return ctx.api.createTable(name, query, options.instantiate(ctx));
     }
   }
 
@@ -174,7 +174,7 @@ export class TableDataNode extends QueryDataNode {
   codegenQuery(ctx) {
     const { name, query, options } = this;
     if (query) {
-      return `\`${create(name, query, options.instantiate(ctx))}\``;
+      return `\`${createTable(name, query, options.instantiate(ctx))}\``;
     }
   }
 

package/src/ast/ExpressionNode.js

@@ -1,50 +1,47 @@
-import { AGG, EXPRESSION, SQL } from '../constants.js';
+import { EXPRESSION, SQL } from '../constants.js';
 import { ASTNode } from './ASTNode.js';
+import { ColumnParamRefNode } from './ColumnParamRefNode.js';
 
-export function parseExpression(spec, ctx) {
-  const { label } = spec;
-  const key = spec[SQL] ? SQL
-    : spec[AGG] ? AGG
-    : ctx.error('Unrecognized expression type', spec);
+const tokenRegExp = /(\\'|\\"|"(?:\\"|[^"])*"|'(?:\\'|[^'])*'|\${1,2}\w+)/g;
 
-  const expr = spec[key];
-  const tokens = expr.split(/(\\'|\\"|"(?:\\"|[^"])*"|'(?:\\'|[^'])*'|\$\w+)/g);
+export function parseExpression(spec, ctx) {
+  const expr = spec[SQL];
+  const tokens = expr.split(tokenRegExp);
   const spans = [''];
   const params = [];
 
   for (let i = 0, k = 0; i < tokens.length; ++i) {
     const tok = tokens[i];
     if (tok.startsWith('$')) {
-      params[k] = ctx.maybeParam(tok);
+      params[k] = tok.startsWith('$$')
+        ? new ColumnParamRefNode(ctx.paramRef(tok.slice(2)))
+        : ctx.maybeParam(tok);
       spans[++k] = '';
     } else {
       spans[k] += tok;
     }
   }
 
-  return new ExpressionNode(expr, spans, params, label, key === AGG);
+  return new ExpressionNode(expr, spans, params);
 }
 
 export class ExpressionNode extends ASTNode {
-  constructor(value, spans, params, label, aggregate) {
+  constructor(value, spans, params) {
     super(EXPRESSION);
     this.value = value;
     this.spans = spans;
     this.params = params;
-    this.label = label;
-    this.aggregate = aggregate;
   }
 
   instantiate(ctx) {
-    const { spans, params, label, aggregate } = this;
-    const tag = ctx.api[aggregate ? AGG : SQL];
+    const { spans, params } = this;
+    const tag = ctx.api[SQL];
     const args = params.map(e => e.instantiate(ctx));
-    return tag(spans, ...args).annotate({ label });
+    return tag(spans, ...args);
   }
 
   codegen(ctx) {
-    const { spans, params, label, aggregate } = this;
-    const method = aggregate ? AGG : SQL;
+    const { spans, params } = this;
 
     // reconstitute expression string
     let str = '';
@@ -54,12 +51,10 @@ export class ExpressionNode extends ASTNode {
     }
     str += spans[n];
 
-    return `${ctx.ns()}${method}\`${str}\``
-      + (label ? `.annotate({ label: ${JSON.stringify(label)} })` : '');
+    return `${ctx.ns()}${SQL}\`${str}\``;
   }
 
   toJSON() {
-    const key = this.aggregate ? AGG : SQL;
-    return { [key]: this.value };
+    return { [SQL]: this.value };
   }
 }

package/src/ast/ParamNode.js

@@ -1,19 +1,18 @@
 import { isArray, isObject, isoparse } from '../util.js';
 import { ASTNode } from './ASTNode.js';
+import { parseSelection } from './SelectionNode.js';
 import { CROSSFILTER, INTERSECT, PARAM, SINGLE, UNION, VALUE } from '../constants.js';
-import { SelectionNode } from './SelectionNode.js';
 
 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, empty, date, value } = param;
+  const { select = VALUE, value, date } = param;
   if (!paramTypes.has(select)) {
     ctx.error(`Unrecognized param type: ${select}`, param);
   }
-
   if (select !== VALUE) {
-    return new SelectionNode(select, cross, empty);
+    return parseSelection(spec, ctx);
   } else if (isArray(value)) {
     return new ParamNode(value.map(v => ctx.maybeParam(v)));
   } else {

package/src/ast/ParamRefNode.js

@@ -12,7 +12,7 @@ export class ParamRefNode extends ASTNode {
     return ctx.activeParams?.get(this.name);
   }
 
-  codegen() {
+  codegen(ctx) { // eslint-disable-line no-unused-vars
     return toParamRef(this.name);
   }
 

package/src/ast/PlotFromNode.js

@@ -16,7 +16,7 @@ export function parseMarkData(spec, ctx) {
   }
 
   const { from: table, ...options } = spec;
-  return new PlotFromNode(table, parseOptions(options, ctx));
+  return new PlotFromNode(ctx.maybeParam(table), parseOptions(options, ctx));
 }
 
 export class PlotFromNode extends ASTNode {
@@ -28,17 +28,17 @@ export class PlotFromNode extends ASTNode {
 
   instantiate(ctx) {
     const { table, options } = this;
-    return ctx.api[FROM](table, options.instantiate(ctx));
+    return ctx.api[FROM](table.instantiate(ctx), options.instantiate(ctx));
   }
 
   codegen(ctx) {
-    const { type, table, options } = this;
-    const opt = options.codegen(ctx);
-    return `${ctx.ns()}${type}("${table}"${opt ? ', ' + opt : ''})`;
+    const table = this.table.codegen(ctx);
+    const opt = this.options.codegen(ctx);
+    return `${ctx.ns()}${this.type}(${table}${opt ? ', ' + opt : ''})`;
   }
 
   toJSON() {
     const { type, table, options } = this;
-    return { [type]: table, ...options.toJSON() };
+    return { [type]: table.toJSON(), ...options.toJSON() };
   }
 }