@uwdata/mosaic-sql 0.13.0 → 0.14.1

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

package/src/functions/operators.js

@@ -1,3 +1,6 @@
+/**
+ * @import { ExprValue, ExprVarArgs } from '../types.js'
+ */
 import { BetweenOpNode, NotBetweenOpNode } from '../ast/between-op.js';
 import { BinaryOpNode } from '../ast/binary-op.js';
 import { InOpNode } from '../ast/in-op.js';
@@ -25,7 +28,7 @@ function betweenOp(expr, extent, negate = false) {
 
 /**
  * Logical and (AND) operator.
- * @param {...import('../types.js').ExprVarArgs} clauses The input expressions.
+ * @param {...ExprVarArgs} clauses The input expressions.
  * @returns {AndNode}
  */
 export function and(...clauses) {
@@ -34,7 +37,7 @@ export function and(...clauses) {
 
 /**
  * Logical or (OR) operator.
- * @param {...import('../types.js').ExprVarArgs} clauses The input expressions.
+ * @param {...ExprVarArgs} clauses The input expressions.
  * @returns {OrNode}
  */
 export function or(...clauses) {
@@ -43,7 +46,7 @@ export function or(...clauses) {
 
 /**
  * Logical not (NOT) operator.
- * @param {import('../types.js').ExprValue} expr The expression to negate.
+ * @param {ExprValue} expr The expression to negate.
  * @returns {UnaryOpNode}
  */
 export function not(expr) {
@@ -52,7 +55,7 @@ export function not(expr) {
 
 /**
  * Null check (IS NULL) operator.
- * @param {import('../types.js').ExprValue} expr The expression to test.
+ * @param {ExprValue} expr The expression to test.
  * @returns {UnaryPosftixOpNode}
  */
 export function isNull(expr) {
@@ -61,7 +64,7 @@ export function isNull(expr) {
 
 /**
  * Non-null check (IS NOT NULL) operator.
- * @param {import('../types.js').ExprValue} expr The expression to test.
+ * @param {ExprValue} expr The expression to test.
  * @returns {UnaryPosftixOpNode}
  */
 export function isNotNull(expr) {
@@ -70,7 +73,7 @@ export function isNotNull(expr) {
 
 /**
  * Bitwise not (~) operator.
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {UnaryOpNode}
  */
 export function bitNot(expr) {
@@ -79,8 +82,8 @@ export function bitNot(expr) {
 
 /**
  * Bitwise and (&) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function bitAnd(left, right) {
@@ -89,8 +92,8 @@ export function bitAnd(left, right) {
 
 /**
  * Bitwise or (|) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function bitOr(left, right) {
@@ -99,8 +102,8 @@ export function bitOr(left, right) {
 
 /**
  * Bit shift left (<<) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function bitLeft(left, right) {
@@ -109,8 +112,8 @@ export function bitLeft(left, right) {
 
 /**
  * Bit shift right (>>) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function bitRight(left, right) {
@@ -119,8 +122,8 @@ export function bitRight(left, right) {
 
 /**
  * Addition (+) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function add(left, right) {
@@ -129,8 +132,8 @@ export function add(left, right) {
 
 /**
  * Subtraction (-) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function sub(left, right) {
@@ -139,8 +142,8 @@ export function sub(left, right) {
 
 /**
  * Multiplication (*) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function mul(left, right) {
@@ -149,8 +152,8 @@ export function mul(left, right) {
 
 /**
  * Division (/) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function div(left, right) {
@@ -159,8 +162,8 @@ export function div(left, right) {
 
 /**
  * Integer division (//) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function idiv(left, right) {
@@ -169,8 +172,8 @@ export function idiv(left, right) {
 
 /**
  * Modulo (%) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function mod(left, right) {
@@ -179,8 +182,8 @@ export function mod(left, right) {
 
 /**
  * Exponentiation (**) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function pow(left, right) {
@@ -189,8 +192,8 @@ export function pow(left, right) {
 
 /**
  * Equality comparision (=) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function eq(left, right) {
@@ -199,8 +202,8 @@ export function eq(left, right) {
 
 /**
  * Non-equality comparision (<>) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function neq(left, right) {
@@ -209,8 +212,8 @@ export function neq(left, right) {
 
 /**
  * Less-than comparision (<) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function lt(left, right) {
@@ -219,8 +222,8 @@ export function lt(left, right) {
 
 /**
  * Greater-than comparision (>) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function gt(left, right) {
@@ -229,8 +232,8 @@ export function gt(left, right) {
 
 /**
  * Less-than or equal comparision (<=) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function lte(left, right) {
@@ -239,8 +242,8 @@ export function lte(left, right) {
 
 /**
  * Greater-than or equal comparision (>=) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function gte(left, right) {
@@ -249,8 +252,8 @@ export function gte(left, right) {
 
 /**
  * Null-inclusive non-equality (IS DISTINCT FROM) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function isDistinct(left, right) {
@@ -259,8 +262,8 @@ export function isDistinct(left, right) {
 
 /**
  * Null-inclusive equality (IS NOT DISTINCT FROM) operator.
- * @param {import('../types.js').ExprValue} left The left argument.
- * @param {import('../types.js').ExprValue} right The right argument.
+ * @param {ExprValue} left The left argument.
+ * @param {ExprValue} right The right argument.
  * @returns {BinaryOpNode}
  */
 export function isNotDistinct(left, right) {
@@ -269,8 +272,8 @@ export function isNotDistinct(left, right) {
 
 /**
  * Range inclusion (BETWEEN) operator.
- * @param {import('../types.js').ExprValue} expr The expression to test.
- * @param {import('../types.js').ExprValue[]} extent The range extent.
+ * @param {ExprValue} expr The expression to test.
+ * @param {ExprValue[]} extent The range extent.
  * @returns {BetweenOpNode}
  */
 export function isBetween(expr, extent) {
@@ -279,8 +282,8 @@ export function isBetween(expr, extent) {
 
 /**
  * Range exclusion (NOT BETWEEN) operator.
- * @param {import('../types.js').ExprValue} expr The expression to test.
- * @param {import('../types.js').ExprValue[]} extent The range extent.
+ * @param {ExprValue} expr The expression to test.
+ * @param {ExprValue[]} extent The range extent.
  * @returns {NotBetweenOpNode}
  */
 export function isNotBetween(expr, extent) {
@@ -289,8 +292,8 @@ export function isNotBetween(expr, extent) {
 
 /**
  * Set inclusion (IN) operator.
- * @param {import('../types.js').ExprValue} expr The expression to test.
- * @param {import('../types.js').ExprValue[]} values The included values.
+ * @param {ExprValue} expr The expression to test.
+ * @param {ExprValue[]} values The included values.
  * @returns {InOpNode}
  */
 export function isIn(expr, values) {

package/src/functions/order-by.js

@@ -1,9 +1,12 @@
+/**
+ * @import { ExprValue } from '../types.js'
+ */
 import { OrderByNode } from '../ast/order-by.js';
 import { asNode } from '../util/ast.js';
 
 /**
  * Indicate ascending sort order for an expression.
- * @param {import('../types.js').ExprValue} expr An expression to order by.
+ * @param {ExprValue} expr An expression to order by.
  * @param {boolean | undefined} [nullsFirst] Flag indicating if null values
  *  should be sorted first.
  * @returns {OrderByNode}
@@ -14,7 +17,7 @@ export function asc(expr, nullsFirst) {
 
 /**
  * Indicate descending sort order for an expression.
- * @param {import('../types.js').ExprValue} expr An expression to order by.
+ * @param {ExprValue} expr An expression to order by.
  * @param {boolean | undefined} [nullsFirst] Flag indicating if null values
  *  should be sorted first.
  * @returns {OrderByNode}

package/src/functions/spatial.js

@@ -1,9 +1,12 @@
-import { FunctionNode } from '../ast/function.js';
+/**
+ * @import { FunctionNode } from '../ast/function.js'
+ * @import { ExprValue } from '../types.js'
+ */
 import { fn } from '../util/function.js';
 
 /**
  * Function that converts geometry data to GeoJSON format.
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {FunctionNode}
  */
 export function geojson(expr) {
@@ -12,7 +15,7 @@ export function geojson(expr) {
 
 /**
  * Function that returns a spatial x position (using ST_X).
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {FunctionNode}
  */
 export function x(expr) {
@@ -21,7 +24,7 @@ export function x(expr) {
 
 /**
  * Function that returns a spatial y position (using ST_Y).
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {FunctionNode}
  */
 export function y(expr) {
@@ -30,7 +33,7 @@ export function y(expr) {
 
 /**
  * Function that returns the centroid point for geometry data.
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {FunctionNode}
  */
 export function centroid(expr) {
@@ -39,7 +42,7 @@ export function centroid(expr) {
 
 /**
  * Function that returns the centroid x-coordinate for geometry data.
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {FunctionNode}
  */
 export function centroidX(expr) {
@@ -48,7 +51,7 @@ export function centroidX(expr) {
 
 /**
  * Function that returns yhe centroid y-coordinate for geometry data.
- * @param {import('../types.js').ExprValue} expr The input expression.
+ * @param {ExprValue} expr The input expression.
  * @returns {FunctionNode}
  */
 export function centroidY(expr) {

package/src/functions/sql-template-tag.js

@@ -1,4 +1,7 @@
-/* eslint-disable jsdoc/no-undefined-types */
+/**
+ * @import { ExprNode } from '../ast/node.js'
+ * @import { ParamLike } from '../types.js'
+ */
 import { FragmentNode } from '../ast/fragment.js';
 import { isNode } from '../ast/node.js';
 import { ParamNode } from '../ast/param.js';
@@ -7,10 +10,7 @@ import { isParamLike, isString } from '../util/type-check.js';
 import { literal } from './literal.js';
 
 /**
- * @typedef {import('../ast/node.js').ExprNode
- *  | import('../types.js').ParamLike
- *  | string | number | boolean | Date
- * } TemplateValue
+ * @typedef { ExprNode | ParamLike | string | number | boolean | Date } TemplateValue
  */
 
 /**

package/src/functions/string.js

@@ -1,4 +1,7 @@
-import { FunctionNode } from '../ast/function.js';
+/**
+ * @import { FunctionNode } from '../ast/function.js'
+ * @import { ExprValue, StringValue } from '../types.js'
+ */
 import { asLiteral } from '../util/ast.js';
 import { argsList, fn } from '../util/function.js';
 
@@ -9,9 +12,9 @@ function strFn(name, expr, ...args) {
 /**
  * Function that returns true if a string contains a regexp pattern,
  * false otherwise.
- * @param {import('../types.js').ExprValue} string The string match against.
- * @param {import('../types.js').StringValue} pattern The regular expression pattern to match.
- * @param {import('../types.js').StringValue} [options] Regular expression options:
+ * @param {ExprValue} string The string match against.
+ * @param {StringValue} pattern The regular expression pattern to match.
+ * @param {StringValue} [options] Regular expression options:
  *  'c': case-sensitive matching
  *  'i': case-insensitive matching
  *  'l': match literals instead of regular expression tokens
@@ -26,8 +29,8 @@ export function regexp_matches(string, pattern, options) {
 
 /**
  * Function that returns true if search_string is found within string.
- * @param {import('../types.js').ExprValue} string The string to match against.
- * @param {import('../types.js').StringValue} search_string The substring to search for.
+ * @param {ExprValue} string The string to match against.
+ * @param {StringValue} search_string The substring to search for.
  * @returns {FunctionNode}
  */
 export function contains(string, search_string) {
@@ -36,8 +39,8 @@ export function contains(string, search_string) {
 
 /**
  * Function that returns true if string begins with search_string.
- * @param {import('../types.js').ExprValue} string The string to match against.
- * @param {import('../types.js').StringValue} search_string The substring to search for.
+ * @param {ExprValue} string The string to match against.
+ * @param {StringValue} search_string The substring to search for.
  * @returns {FunctionNode}
  */
 export function prefix(string, search_string) {
@@ -46,8 +49,8 @@ export function prefix(string, search_string) {
 
 /**
  * Function that returns true if string ends with search_string.
- * @param {import('../types.js').ExprValue} string The string to match against.
- * @param {import('../types.js').StringValue} search_string The substring to search for.
+ * @param {ExprValue} string The string to match against.
+ * @param {StringValue} search_string The substring to search for.
  * @returns {FunctionNode}
  */
 export function suffix(string, search_string) {
@@ -56,7 +59,7 @@ export function suffix(string, search_string) {
 
 /**
  * Function that converts string to lower case.
- * @param {import('../types.js').ExprValue} string The string to convert.
+ * @param {ExprValue} string The string to convert.
  * @returns {FunctionNode}
  */
 export function lower(string) {
@@ -65,7 +68,7 @@ export function lower(string) {
 
 /**
  * Function that converts string to upper case.
- * @param {import('../types.js').ExprValue} string The string to convert.
+ * @param {ExprValue} string The string to convert.
  * @returns {FunctionNode}
  */
 export function upper(string) {
@@ -74,7 +77,7 @@ export function upper(string) {
 
 /**
  * Function that returns the number of characters in string.
- * @param {import('../types.js').ExprValue} value The string to measure.
+ * @param {ExprValue} value The string to measure.
  * @returns {FunctionNode}
  */
 export function length(value) {

package/src/functions/util.js

@@ -0,0 +1,14 @@
+/**
+ * @import { FunctionNode } from '../ast/function.js'
+ * @import { ExprValue } from '../types.js'
+ */
+import { fn } from '../util/function.js';
+
+/**
+ * Returns the first non-null argument.
+ * @param {...ExprValue} expr The input expressions.
+ * @returns {FunctionNode}
+ */
+export function coalesce(...expr) {
+  return fn('coalesce', ...expr);
+}