@uwdata/mosaic-sql 0.16.2 → 0.18.0

package/src/transforms/bin-histogram.js

@@ -1,52 +0,0 @@
-/**
- * @import { ExprNode } from '../ast/node.js'
- * @import { ExprValue } from '../types.js'
- */
-import { float64 } from '../functions/cast.js';
-import { floor } from '../functions/numeric.js';
-import { add, div, mul, sub } from '../functions/operators.js';
-import { binSpec } from './util/bin-step.js';
-import { scaleTransform } from './scales.js';
-
-/**
- * @typedef {object} BinHistogramOptions
- * @property {number} [step] An exact binning step to use.
- * @property {number} [steps] The desired number of binning steps.
- *  This value is a hint, it does not guarantee an exact number of steps.
- * @property {number} [minstep] A minimum binning step value. No generated
- *  step can be less than this value.
- * @property {boolean} [nice] A boolean flag (default true) indicating if bin
- *  extents should be snapped to "nice" numbers such as multiples of 5 or 10.
- * @property {number} [offset] The number of bin steps (default 0) by
- *  which to offset the result.
- */
-
-/**
- * Return a SQL expression for histogram bins.
- * @param {ExprValue} field The column or expression to bin.
- * @param {[number, number]} extent The min/max extent over which to bin.
- * @param {BinHistogramOptions} [options] Binning options.
- * @param {ReturnType<typeof scaleTransform>} [transform] Scale transforms to
- *  apply to create (potentially non-linear) binning intervals.
- * @returns {ExprNode} The resulting SQL expression
- */
-export function binHistogram(
-  field,
-  extent,
-  options = {},
-  transform = scaleTransform({ type: 'linear' })
-) {
-  const [min, max] = extent;
-  const { offset = 0 } = options;
-  const { apply, sqlApply, sqlInvert } = transform;
-  const b = binSpec(apply(min), apply(max), options);
-  const col = sqlApply(field);
-  const alpha = (b.max - b.min) / b.steps;
-
-  let expr = b.min === 0 ? col : sub(col, b.min);
-  if (alpha !== 1) expr = div(expr, float64(alpha));
-  expr = floor(offset ? add(offset, expr) : expr);
-  if (alpha !== 1) expr = mul(alpha, expr);
-  if (b.min !== 0) expr = add(b.min, expr);
-  return sqlInvert(expr);
-}

package/src/transforms/util/bin-step.js

@@ -1,79 +0,0 @@
-/**
- * @typedef {object} BinOptions
- * @property {number} [step] An exact binning step to use.
- * @property {number} [steps] The desired number of binning steps.
- *  This value is a hint, it does not guarantee an exact number of steps.
- * @property {number} [minstep] A minimum binning step value. No generated
- *  step can be less than this value.
- * @property {boolean} [nice] A boolean flag (default true) indicating if bin
- *  extents should be snapped to "nice" numbers such as multiples of 5 or 10.
- * @property {number} [base] A number indicating the the logarithm base to
- *  use for automatic step size determination. Defaults to base 10.
- */
-
-/**
- * Generate a numeric binning scheme suitable for a histogram.
- * @param {number} min The minimum value of the extent to bin.
- * @param {number} max The maximum value of the extent to bin.
- * @param {BinOptions} options Binning scheme options.
- */
-export function binSpec(min, max, options) {
-  let {
-    step,
-    steps = 25,
-    minstep = 0,
-    nice = true,
-    base
-  } = options;
-
-  if (nice !== false) {
-    // use span to determine step size
-    const span = max - min;
-    const logb = base ? Math.log(base) : Math.LN10;
-    step = step || binStep(span, steps, minstep, logb);
-
-    // adjust min/max relative to step
-    let v = Math.log(step);
-    const precision = v >= 0 ? 0 : ~~(-v / logb) + 1;
-    const eps = Math.pow(10, -precision - 1);
-    v = Math.floor(min / step + eps) * step;
-    min = min < v ? v - step : v;
-    max = Math.ceil(max / step) * step;
-    steps = Math.round((max - min) / step);
-  }
-
-  return { min, max, steps };
-}
-
-/**
- * Determine a bin step interval.
- * @param {number} span The span from maximum to minimum value.
- * @param {number} steps The approximate number of desired bins.
- * @param {number} [minstep=0] The minimum acceptable bin step size.
- * @param {number} [logb=Math.LN10] The log base for determining
- *  orders of magnitude for step sizes. Defaults to log base 10
- *  (`Math.LN10`). For example to use log base 2, provide the
- *  argument `Math.LN2` instead.
- * @returns {number} The bin step interval (bin size).
- */
-export function binStep(span, steps, minstep = 0, logb = Math.LN10) {
-  let v;
-
-  const level = Math.ceil(Math.log(steps) / logb);
-  let step = Math.max(
-    minstep,
-    Math.pow(10, Math.round(Math.log(span) / logb) - level)
-  );
-
-  // increase step size if too many bins
-  while (Math.ceil(span / step) > steps) { step *= 10; }
-
-  // decrease step size if allowed
-  const div = [5, 2];
-  for (let i = 0, n = div.length; i < n; ++i) {
-    v = step / div[i];
-    if (v >= minstep && span / v <= steps) step = v;
-  }
-
-  return step;
-}

package/src/util/type-check.js

@@ -1,33 +0,0 @@
-/**
- * @import { ParamLike } from '../types.js'
- */
-
-/**
- * Check if a value is a string.
- * @param {*} value The value to check.
- * @returns {value is string}
- */
-export function isString(value) {
-  return typeof value === 'string';
-}
-
-/**
- * Check if a value is an array.
- * @param {*} value The value to check.
- * @returns {value is Array}
- */
-export function isArray(value) {
-  return Array.isArray(value);
-}
-
-/**
- * Check if a value is a dynamic parameter.
- * @param {*} value The value to check.
- * @returns {value is ParamLike}
- */
-export function isParamLike(value) {
-  return value
-    && typeof value.addEventListener === 'function'
-    && value.dynamic !== false
-    && 'value' in value;
-}

package/src/visit/walk.js

@@ -1,35 +0,0 @@
-/**
- * @import { SQLNode } from '../ast/node.js'
- * @import { VisitorCallback, VisitorResult } from '../types.js'
-
- */
-import { isNode } from '../ast/node.js';
-import { recurse } from './recurse.js';
-
-/**
- * Perform a traversal of a SQL expression AST.
- * @param {SQLNode} node Root node for AST traversal.
- * @param {VisitorCallback} visit Visitor callback function.
- * @return {VisitorResult}
- */
-export function walk(node, visit) {
-  if (!isNode(node)) return;
-  const result = visit(node);
-  if (result) return result;
-
-  const props = recurse[node.type];
-  const n = props?.length ?? 0;
-  for (let i = 0; i < n; ++i) {
-    const value = node[props[i]];
-    if (Array.isArray(value)) {
-      const m = value.length;
-      for (let j = 0; j < m; ++j) {
-        if (value[j] && +walk(value[j], visit) < 0) {
-          return result;
-        }
-      }
-    } else if (value && +walk(value, visit) < 0) {
-      return -1;
-    }
-  }
-}

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "include": ["src/index-types.ts"],
-  "compilerOptions": {
-    "allowJs": true,
-    "declaration": true,
-    "emitDeclarationOnly": true,
-    "outDir": "dist/types",
-    "module": "node16",
-    "skipLibCheck": true,
-    "types": []
-  }
-}

package/vitest.config.ts

@@ -1,3 +0,0 @@
-import { defineConfig } from 'vite';
-
-export default defineConfig({});