@uwdata/mosaic-sql 0.13.0 → 0.14.1

package/src/ast/query.js

@@ -1,3 +1,7 @@
+/**
+ * @import { FilterExpr, FromExpr, GroupByExpr, OrderByExpr, SelectExpr, WithExpr } from '../types.js'
+ * @import { SampleMethod } from './sample.js'
+ */
 import { DESCRIBE_QUERY, SELECT_QUERY, SET_OPERATION } from '../constants.js';
 import { asNode, asTableRef, asVerbatim } from '../util/ast.js';
 import { exprList } from '../util/function.js';
@@ -42,7 +46,7 @@ export function isDescribeQuery(value) {
 export class Query extends ExprNode {
   /**
    * Create a new WITH clause with the given CTE queries.
-   * @param {...import('../types.js').WithExpr} expr The WITH CTE queries.
+   * @param {...WithExpr} expr The WITH CTE queries.
    * @returns {WithClause}
    */
   static with(...expr) {
@@ -51,7 +55,7 @@ export class Query extends ExprNode {
 
   /**
    * Create a new select query with the given SELECT expressions.
-   * @param {...import('../types.js').SelectExpr} expr The SELECT expressions.
+   * @param {...SelectExpr} expr The SELECT expressions.
    * @returns {SelectQuery}
    */
   static select(...expr) {
@@ -60,7 +64,7 @@ export class Query extends ExprNode {
 
   /**
    * Create a new select query with the given FROM expressions.
-   * @param {...import('../types.js').FromExpr} expr The FROM expressions.
+   * @param {...FromExpr} expr The FROM expressions.
    * @returns {SelectQuery}
    */
   static from(...expr) {
@@ -147,7 +151,7 @@ export class Query extends ExprNode {
 
   /**
    * Add WITH common table expressions (CTEs).
-   * @param  {...import('../types.js').WithExpr} expr Expressions to add.
+   * @param  {...WithExpr} expr Expressions to add.
    * @returns {this}
    */
   with(...expr) {
@@ -168,7 +172,7 @@ export class Query extends ExprNode {
 
   /**
    * Add ORDER BY expressions.
-   * @param  {...import('../types.js').OrderByExpr} expr Expressions to add.
+   * @param  {...OrderByExpr} expr Expressions to add.
    * @returns
    */
   orderby(...expr) {
@@ -255,7 +259,7 @@ export class SelectQuery extends Query {
 
   /**
    * Add SELECT expressions.
-   * @param {...import('../types.js').SelectExpr} expr Expressions to add.
+   * @param {...SelectExpr} expr Expressions to add.
    * @returns {this}
    */
   select(...expr) {
@@ -281,7 +285,7 @@ export class SelectQuery extends Query {
 
   /**
    * Set SELECT expressions, replacing any prior expressions.
-   * @param {...import('../types.js').SelectExpr} expr Expressions to add.
+   * @param {...SelectExpr} expr Expressions to add.
    * @returns {this}
    */
   setSelect(...expr) {
@@ -301,7 +305,7 @@ export class SelectQuery extends Query {
 
   /**
    * Add table FROM expressions.
-   * @param  {...import('../types.js').FromExpr} expr Expressions to add.
+   * @param  {...FromExpr} expr Expressions to add.
    * @returns {this}
    */
   from(...expr) {
@@ -321,7 +325,7 @@ export class SelectQuery extends Query {
 
   /**
    * Set FROM expressions, replacing any prior expressions.
-   * @param {...import('../types.js').FromExpr} expr Expressions to add.
+   * @param {...FromExpr} expr Expressions to add.
    * @returns {this}
    */
   setFrom(...expr) {
@@ -333,7 +337,7 @@ export class SelectQuery extends Query {
    * Set SAMPLE settings.
    * @param {number | SampleClauseNode} value Either a sample clause node
    *  or the sample size as either a row count or percentage.
-   * @param {import('./sample.js').SampleMethod} [method] The sampling method
+   * @param {SampleMethod} [method] The sampling method
    *  to use.
    * @param {number} [seed] The random seed.
    * @returns {this}
@@ -353,7 +357,7 @@ export class SelectQuery extends Query {
 
   /**
    * Add WHERE expressions.
-   * @param  {...import('../types.js').FilterExpr} expr Expressions to add.
+   * @param  {...FilterExpr} expr Expressions to add.
    * @returns {this}
    */
   where(...expr) {
@@ -363,7 +367,7 @@ export class SelectQuery extends Query {
 
   /**
    * Set WHERE expressions, replacing any prior expressions.
-   * @param {...import('../types.js').FilterExpr} expr Expressions to add.
+   * @param {...FilterExpr} expr Expressions to add.
    * @returns {this}
    */
   setWhere(...expr) {
@@ -373,7 +377,7 @@ export class SelectQuery extends Query {
 
   /**
    * Add GROUP BY expressions.
-   * @param  {...import('../types.js').GroupByExpr} expr Expressions to add.
+   * @param  {...GroupByExpr} expr Expressions to add.
    * @returns {this}
    */
   groupby(...expr) {
@@ -383,7 +387,7 @@ export class SelectQuery extends Query {
 
   /**
    * Set GROUP BY expressions, replacing any prior expressions.
-   * @param {...import('../types.js').GroupByExpr} expr Expressions to add.
+   * @param {...GroupByExpr} expr Expressions to add.
    * @returns {this}
    */
   setGroupby(...expr) {
@@ -393,7 +397,7 @@ export class SelectQuery extends Query {
 
   /**
    * Add HAVING expressions.
-   * @param {...import('../types.js').FilterExpr} expr Expressions to add.
+   * @param {...FilterExpr} expr Expressions to add.
    * @returns {this}
    */
   having(...expr) {
@@ -419,7 +423,7 @@ export class SelectQuery extends Query {
 
   /**
    * Add QUALIFY expressions.
-   * @param {...import('../types.js').FilterExpr} expr Expressions to add.
+   * @param {...FilterExpr} expr Expressions to add.
    * @returns {this}
    */
   qualify(...expr) {
@@ -585,7 +589,7 @@ export class SetOperation extends Query {
 class WithClause {
   /**
    * Instantiate a new WITH clause instance.
-   * @param {...import('../types.js').WithExpr} expr The WITH CTE queries.
+   * @param {...WithExpr} expr The WITH CTE queries.
    */
   constructor(...expr) {
     this._with = expr;
@@ -593,7 +597,7 @@ class WithClause {
 
   /**
    * Create a new select query with the given SELECT expressions.
-   * @param {...import('../types.js').SelectExpr} expr The SELECT expressions.
+   * @param {...SelectExpr} expr The SELECT expressions.
    * @returns {SelectQuery}
    */
   select(...expr) {
@@ -602,7 +606,7 @@ class WithClause {
 
   /**
    * Create a new select query with the given FROM expressions.
-   * @param {...import('../types.js').FromExpr} expr The FROM expressions.
+   * @param {...FromExpr} expr The FROM expressions.
    * @returns {SelectQuery}
    */
   from(...expr) {

package/src/ast/window.js

@@ -1,3 +1,7 @@
+/**
+ * @import { ExprVarArgs, WindowFunctionName } from '../types.js'
+ * @import { ParamLike } from '../types.js'
+ */
 import { WINDOW, WINDOW_CLAUSE, WINDOW_DEF, WINDOW_FRAME } from '../constants.js';
 import { exprList } from '../util/function.js';
 import { quoteIdentifier } from '../util/string.js';
@@ -8,7 +12,7 @@ import { ExprNode, isNode, SQLNode } from './node.js';
 import { ParamNode } from './param.js';
 
 /**
- * @typedef {[any, any] | import('../types.js').ParamLike} FrameExtent
+ * @typedef {[any, any] | ParamLike} FrameExtent
  */
 
 export class WindowClauseNode extends SQLNode {
@@ -69,7 +73,7 @@ export class WindowNode extends ExprNode {
 
   /**
    * Return an updated window with the given partitions.
-   * @param {...import('../types.js').ExprVarArgs} expr The partition by criteria.
+   * @param {...ExprVarArgs} expr The partition by criteria.
    * @returns {WindowNode} A new window node.
    */
   partitionby(...expr) {
@@ -78,7 +82,7 @@ export class WindowNode extends ExprNode {
 
   /**
    * Return an updated window with the given ordering.
-   * @param {...import('../types.js').ExprVarArgs} expr The order by criteria.
+   * @param {...ExprVarArgs} expr The order by criteria.
    * @returns {WindowNode} A new window node.
    */
   orderby(...expr) {
@@ -115,7 +119,7 @@ export class WindowNode extends ExprNode {
 export class WindowFunctionNode extends FunctionNode {
   /**
    * Instantiate a window function call node.
-   * @param {import('../types.js').WindowFunctionName} name The function name.
+   * @param {WindowFunctionName} name The function name.
    * @param {ExprNode[]} [args=[]] The function arguments.
    */
   constructor(name, args) {
@@ -170,7 +174,7 @@ export class WindowDefNode extends SQLNode {
 
   /**
    * Return an updated window definition with the given partitions.
-   * @param {...import('../types.js').ExprVarArgs} expr The partition by criteria.
+   * @param {...ExprVarArgs} expr The partition by criteria.
    * @returns {WindowDefNode} A new window definition node.
    */
   partitionby(...expr) {
@@ -179,7 +183,7 @@ export class WindowDefNode extends SQLNode {
 
   /**
    * Return an updated window definition with the given ordering.
-   * @param {...import('../types.js').ExprVarArgs} expr The order by criteria.
+   * @param {...ExprVarArgs} expr The order by criteria.
    * @returns {WindowDefNode} A new window definition node.
    */
   orderby(...expr) {

package/src/functions/aggregate.js

@@ -1,10 +1,13 @@
-import { AggregateNode } from '../ast/aggregate.js';
+/**
+ * @import { AggregateNode } from '../ast/aggregate.js'
+ * @import { ExprValue } from '../types.js'
+ */
 import { aggFn } from '../util/function.js';
 
 /**
  * Compute an arg_max aggregate.
- * @param {import('../types.js').ExprValue} y The argument to return.
- * @param {import('../types.js').ExprValue} x The expression to maximize.
+ * @param {ExprValue} y The argument to return.
+ * @param {ExprValue} x The expression to maximize.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function argmax(y, x) {
@@ -13,8 +16,8 @@ export function argmax(y, x) {
 
 /**
  * Compute an arg_min aggregate.
- * @param {import('../types.js').ExprValue} y The argument to return.
- * @param {import('../types.js').ExprValue} x The expression to minimize.
+ * @param {ExprValue} y The argument to return.
+ * @param {ExprValue} x The expression to minimize.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function argmin(y, x) {
@@ -23,7 +26,7 @@ export function argmin(y, x) {
 
 /**
  * Compute an array aggregation.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function arrayAgg(expr) {
@@ -32,7 +35,7 @@ export function arrayAgg(expr) {
 
 /**
  * Compute an average aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function avg(expr) {
@@ -41,8 +44,8 @@ export function avg(expr) {
 
 /**
  * Compute a correlation aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function corr(x, y) {
@@ -51,7 +54,7 @@ export function corr(x, y) {
 
 /**
  * Compute a count aggregate.
- * @param {import('../types.js').ExprValue} [expr] An optional expression
+ * @param {ExprValue} [expr] An optional expression
  *  to count. If specified, only non-null expression values are counted.
  *  If omitted, all rows within a group are counted.
  * @returns {AggregateNode} A SQL aggregate function call.
@@ -62,8 +65,8 @@ export function count(expr) {
 
 /**
  * Compute a sample covariance aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function covariance(x, y) {
@@ -72,8 +75,8 @@ export function covariance(x, y) {
 
 /**
  * Compute a population covariance aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function covarPop(x, y) {
@@ -82,7 +85,7 @@ export function covarPop(x, y) {
 
 /**
  * Compute an entropy aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function entropy(expr) {
@@ -91,7 +94,7 @@ export function entropy(expr) {
 
 /**
  * Compute a first aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function first(expr) {
@@ -100,7 +103,7 @@ export function first(expr) {
 
 /**
  * Compute a geomean aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function geomean(expr) {
@@ -109,7 +112,7 @@ export function geomean(expr) {
 
 /**
  * Compute a sample kurtosis aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function kurtosis(expr) {
@@ -118,7 +121,7 @@ export function kurtosis(expr) {
 
 /**
  * Compute a median absolute deviation (MAD) aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function mad(expr) {
@@ -127,7 +130,7 @@ export function mad(expr) {
 
 /**
  * Compute a maximum aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function max(expr) {
@@ -136,7 +139,7 @@ export function max(expr) {
 
 /**
  * Compute a median aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function median(expr) {
@@ -145,7 +148,7 @@ export function median(expr) {
 
 /**
  * Compute a minimum aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function min(expr) {
@@ -154,7 +157,7 @@ export function min(expr) {
 
 /**
  * Compute a mode aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function mode(expr) {
@@ -163,7 +166,7 @@ export function mode(expr) {
 
 /**
  * Compute a last aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function last(expr) {
@@ -172,7 +175,7 @@ export function last(expr) {
 
 /**
  * Compute a product aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function product(expr) {
@@ -181,8 +184,8 @@ export function product(expr) {
 
 /**
  * Compute a quantile aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
- * @param {import('../types.js').ExprValue} p The quantile value.
+ * @param {ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} p The quantile value.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function quantile(expr, p) {
@@ -191,8 +194,8 @@ export function quantile(expr, p) {
 
 /**
  * Compute a linear regression reg_avgX aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrAvgX(x, y) {
@@ -201,8 +204,8 @@ export function regrAvgX(x, y) {
 
 /**
  * Compute a linear regression reg_avgY aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrAvgY(x, y) {
@@ -212,8 +215,8 @@ export function regrAvgY(x, y) {
 /**
  * Compute a linear regression count aggregate.
  * This returns the count of rows where both x and y are non-null.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrCount(x, y) {
@@ -222,8 +225,8 @@ export function regrCount(x, y) {
 
 /**
  * Compute a linear regression intercept aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrIntercept(x, y) {
@@ -232,8 +235,8 @@ export function regrIntercept(x, y) {
 
 /**
  * Compute a linear regression R^2 aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrR2(x, y) {
@@ -242,8 +245,8 @@ export function regrR2(x, y) {
 
 /**
  * Compute a linear regression regr_sxx aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrSXX(x, y) {
@@ -252,8 +255,8 @@ export function regrSXX(x, y) {
 
 /**
  * Compute a linear regression regr_sxy aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrSXY(x, y) {
@@ -262,8 +265,8 @@ export function regrSXY(x, y) {
 
 /**
  * Compute a linear regression regr_syy aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrSYY(x, y) {
@@ -272,8 +275,8 @@ export function regrSYY(x, y) {
 
 /**
  * Compute a linear regression slope aggregate.
- * @param {import('../types.js').ExprValue} x The x expression to aggregate.
- * @param {import('../types.js').ExprValue} y The y expression to aggregate.
+ * @param {ExprValue} x The x expression to aggregate.
+ * @param {ExprValue} y The y expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function regrSlope(x, y) {
@@ -282,7 +285,7 @@ export function regrSlope(x, y) {
 
 /**
  * Compute a skewness aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function skewness(expr) {
@@ -291,7 +294,7 @@ export function skewness(expr) {
 
 /**
  * Compute a sample standard deviation aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function stddev(expr) {
@@ -300,7 +303,7 @@ export function stddev(expr) {
 
 /**
  * Compute a population standard deviation aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function stddevPop(expr) {
@@ -309,7 +312,7 @@ export function stddevPop(expr) {
 
 /**
  * Compute a string aggregation.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function stringAgg(expr) {
@@ -318,7 +321,7 @@ export function stringAgg(expr) {
 
 /**
  * Compute a sum aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function sum(expr) {
@@ -327,7 +330,7 @@ export function sum(expr) {
 
 /**
  * Compute a sample variance aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function variance(expr) {
@@ -336,7 +339,7 @@ export function variance(expr) {
 
 /**
  * Compute a population variance aggregate.
- * @param {import('../types.js').ExprValue} expr The expression to aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
  * @returns {AggregateNode} A SQL aggregate function call.
  */
 export function varPop(expr) {

package/src/functions/case.js

@@ -1,17 +1,17 @@
+/**
+ * @import { ExprValue } from '../types.js'
+ */
 import { CaseNode, WhenNode } from '../ast/case.js';
 import { asNode } from '../util/ast.js';
 
 /**
  * Create a new conditional CASE statement. If three arguments are provided,
- * acts like a ternary conditional (if, then else). If no arguments are
+ * acts like a ternary conditional (if, then, else). If no arguments are
  * provided, the chained `when` and `else` methods can be used to to complete
  * a conditional statement with WHEN/THEN and ELSE expressions.
- * @param {import('../types.js').ExprValue} [when]
- *  A conditional WHEN expression.
- * @param {import('../types.js').ExprValue} [then]
- *  A THEN value expression.
- * @param {import('../types.js').ExprValue} [other]
- *  An ELSE expression.
+ * @param {ExprValue} [when] A conditional WHEN expression.
+ * @param {ExprValue} [then] A THEN value expression.
+ * @param {ExprValue} [other] An ELSE expression.
  * @returns {CaseNode}
  */
 export function cond(when, then, other) {

package/src/functions/column.js

@@ -1,3 +1,7 @@
+/**
+ * @import { ColumnRefNode } from '../ast/column-ref.js'
+ * @import { ParamLike } from '../types.js'
+ */
 import { ColumnParamNode } from '../ast/column-param.js';
 import { ColumnNameRefNode } from '../ast/column-ref.js';
 import { ParamNode } from '../ast/param.js';
@@ -7,10 +11,10 @@ import { isParamLike } from '../util/type-check.js';
 
 /**
  * Create a column reference.
- * @param {string | import('../types.js').ParamLike} name The column name,
+ * @param {string | ParamLike} name The column name,
  *  as a string or as a dynamic parameter.
  * @param {string | string[] | TableRefNode} [table] The table reference.
- * @returns {import('../ast/column-ref.js').ColumnRefNode}
+ * @returns {ColumnRefNode}
  */
 export function column(name, table) {
   const tref = asTableRef(table);

package/src/functions/datetime.js

@@ -1,4 +1,7 @@
-import { FunctionNode } from '../ast/function.js';
+/**
+ * @import { FunctionNode } from '../ast/function.js'
+ * @import { ExprValue } from '../types.js'
+ */
 import { IntervalNode } from '../ast/interval.js';
 import { asNode } from '../util/ast.js';
 import { fn } from '../util/function.js';
@@ -15,7 +18,7 @@ export function interval(unit, steps) {
 
 /**
  * Given a date/time value, return the milliseconds since the UNIX epoch.
- * @param {import('../types.js').ExprValue} expr The date/time expression.
+ * @param {ExprValue} expr The date/time expression.
  * @returns {FunctionNode}
  */
 export function epoch_ms(expr) {
@@ -24,7 +27,7 @@ export function epoch_ms(expr) {
 
 /**
  * Perform data binning according to the provided interval unit and steps.
- * @param {import('../types.js').ExprValue} expr The date/time expression to bin.
+ * @param {ExprValue} expr The date/time expression to bin.
  * @param {string} unit The datetime interval unit to bin by.
  * @param {number} [steps=1] The number of interval steps.
  * @returns {FunctionNode}
@@ -36,7 +39,7 @@ export function dateBin(expr, unit, steps = 1) {
 /**
  * Map date/times to a month value, all within the same year for comparison.
  * The resulting value is still date-typed.
- * @param {import('../types.js').ExprValue} expr The date/time expression.
+ * @param {ExprValue} expr The date/time expression.
  * @returns {FunctionNode}
  */
 export function dateMonth(expr) {
@@ -46,7 +49,7 @@ export function dateMonth(expr) {
 /**
  * Map date/times to a month and day value, all within the same year for
  * comparison. The resulting value is still date-typed.
- * @param {import('../types.js').ExprValue} expr The date/time expression.
+ * @param {ExprValue} expr The date/time expression.
  * @returns {FunctionNode}
  */
 export function dateMonthDay(expr) {
@@ -57,7 +60,7 @@ export function dateMonthDay(expr) {
 /**
  * Map date/times to a day of the month value, all within the same year and month
  * for comparison. The resulting value is still date-typed.
- * @param {import('../types.js').ExprValue} expr The date/time expression.
+ * @param {ExprValue} expr The date/time expression.
  * @returns {FunctionNode}
  */
 export function dateDay(expr) {