@uwdata/mosaic-sql 0.12.2 → 0.14.0

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,16 +94,25 @@ 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) {
   return aggFn('first', expr);
 }
 
+/**
+ * Compute a geomean aggregate.
+ * @param {ExprValue} expr The expression to aggregate.
+ * @returns {AggregateNode} A SQL aggregate function call.
+ */
+export function geomean(expr) {
+  return aggFn('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) {
@@ -109,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) {
@@ -118,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) {
@@ -127,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) {
@@ -136,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) {
@@ -145,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) {
@@ -154,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) {
@@ -163,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) {
@@ -172,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) {
@@ -182,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) {
@@ -192,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) {
@@ -203,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) {
@@ -213,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) {
@@ -223,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) {
@@ -233,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) {
@@ -243,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) {
@@ -253,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) {
@@ -263,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) {
@@ -273,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) {
@@ -282,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) {
@@ -291,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) {
@@ -300,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) {
@@ -309,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) {
@@ -318,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) {
@@ -327,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/cte.js

@@ -0,0 +1,16 @@
+import { Query } from '../ast/query.js';
+import { WithClauseNode } from '../ast/with.js';
+
+/**
+ * Create a common table expression (CTE) to include within a WITH clause.
+ * @param {string} name The common table expression (CTE) name.
+ * @param {Query} query The common table expression (CTE) query.
+ * @param {boolean | null} [materialized] The common table expression (CTE)
+ *  materialization flag. If `true`, forces materialization of the CTE.
+ *  If `false`, materialization is not performed. Otherwise (for example, if
+ *  `undefined` or `null`), materialization is decided by the database.
+ * @returns {WithClauseNode}
+ */
+export function cte(name, query, materialized) {
+  return new WithClauseNode(name, query, materialized);
+}

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) {

package/src/functions/numeric.js

@@ -1,9 +1,13 @@
+/**
+ * @import { FunctionNode } from '../ast/function.js'
+ * @import { ExprValue } from '../types.js'
+ */
 import { fn } from '../util/function.js';
 
 /**
  * Return true if the floating point value is not a number, false otherwise.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function isNaN(expr) {
   return fn('isnan', expr);
@@ -11,8 +15,8 @@ export function isNaN(expr) {
 
 /**
  * Return true if the floating point value is finite, false otherwise.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function isFinite(expr) {
   return fn('isfinite', expr);
@@ -20,8 +24,8 @@ export function isFinite(expr) {
 
 /**
  * Return true if the floating point value is infinite, false otherwise.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function isInfinite(expr) {
   return fn('isinf', expr);
@@ -29,8 +33,8 @@ export function isInfinite(expr) {
 
 /**
  * Selects the largest value.
- * @param {...import('../types.js').ExprValue} expr The input expressions.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {...ExprValue} expr The input expressions.
+ * @returns {FunctionNode}
  */
 export function greatest(...expr) {
   return fn('greatest', ...expr);
@@ -38,8 +42,8 @@ export function greatest(...expr) {
 
 /**
  * Selects the smallest value.
- * @param {...import('../types.js').ExprValue} expr The input expressions.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {...ExprValue} expr The input expressions.
+ * @returns {FunctionNode}
  */
 export function least(...expr) {
   return fn('least', ...expr);
@@ -47,8 +51,8 @@ export function least(...expr) {
 
 /**
  * Compute the exponentional function `e ** expr`.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function exp(expr) {
   return fn('exp', expr);
@@ -56,8 +60,8 @@ export function exp(expr) {
 
 /**
  * Compute a base 10 logarithm.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function log(expr) {
   return fn('log', expr);
@@ -65,8 +69,8 @@ export function log(expr) {
 
 /**
  * Compute a natural logarithm.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function ln(expr) {
   return fn('ln', expr);
@@ -74,8 +78,8 @@ export function ln(expr) {
 
 /**
  * Compute the sign of a number.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function sign(expr) {
   return fn('sign', expr);
@@ -83,8 +87,8 @@ export function sign(expr) {
 
 /**
  * Compute the absolute value of a number.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function abs(expr) {
   return fn('abs', expr);
@@ -92,8 +96,8 @@ export function abs(expr) {
 
 /**
  * Compute the square root of a number.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function sqrt(expr) {
   return fn('sqrt', expr);
@@ -101,8 +105,8 @@ export function sqrt(expr) {
 
 /**
  * Rounds the number up.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function ceil(expr) {
   return fn('ceil', expr);
@@ -110,8 +114,8 @@ export function ceil(expr) {
 
 /**
  * Rounds the number down.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function floor(expr) {
   return fn('floor', expr);
@@ -119,11 +123,11 @@ export function floor(expr) {
 
 /**
  * Round to the given decimal places.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @param {import('../types.js').ExprValue} [places] The decimal places.
+ * @param {ExprValue} expr The input number.
+ * @param {ExprValue} [places] The decimal places.
  *  Negative values are allowed, to round to tens, hundreds, etc.
  *  If unspecified, defaults to zero.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @returns {FunctionNode}
  */
 export function round(expr, places) {
   return fn('round', expr, places);
@@ -131,8 +135,8 @@ export function round(expr, places) {
 
 /**
  * Truncates the number.
- * @param {import('../types.js').ExprValue} expr The input number.
- * @returns {import('../ast/function.js').FunctionNode}
+ * @param {ExprValue} expr The input number.
+ * @returns {FunctionNode}
  */
 export function trunc(expr) {
   return fn('trunc', expr);