df-script 1.7.0 → 1.8.0

package/README.md

@@ -2,6 +2,8 @@
 
 [![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-blue?style=for-the-badge&logo=github)](https://github.com/trentamorris/df-script)
 [![Donate](https://img.shields.io/badge/Donate-Support-green?style=for-the-badge)](DONATIONS.md)
+[![Environment](https://img.shields.io/badge/Environment-Node.js%20%7C%20Browser%20%7C%20Bun%20%7C%20Deno%20%7C%20Workers-brightgreen?style=for-the-badge)](#)
+[![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-success?style=for-the-badge)](#)
 
 DFScript is a lightweight, high-performance, and **zero-dependency** data analysis library for TypeScript and JavaScript. Heavily inspired by modern dataframe libraries like **Polars** and **Pandas**, DFScript brings a robust, expression-based columnar data processing engine directly to the JavaScript ecosystem.
 

package/dist/api.d.ts

@@ -1,5 +1,5 @@
 import { DataFrame } from "./dataframe";
-import { ColumnExpr, lit, all, exclude, coalesce, when, implode, seq_range, element, struct } from "./columnExpressions";
+import { ColumnExpr, lit, all, exclude, coalesce, when, implode, seq_range, element, struct, duration } from "./columnExpressions";
 import { DataType } from "./datatypes";
 import { concat, read_json, read_csv } from "./functions";
 import type { RowRecord, DataFrameSchema, ColumnDict, InferSchema } from "./types";
@@ -20,6 +20,7 @@ export declare const $df: {
     seq_range: typeof seq_range;
     element: typeof element;
     struct: typeof struct;
+    duration: typeof duration;
     DataType: {
         Int8: import("./datatypes").Int8Type;
         Int16: import("./datatypes").Int16Type;

package/dist/columnExpressions/ExprBase.d.ts

@@ -11,6 +11,7 @@ export declare class ExprBase implements IExpr {
     _isLiteral?: boolean;
     _literalValue?: any;
     _aggFn?: AggFn<any> | null;
+    _castType?: RegisteredDataType;
     _groupingOpsIndex?: number;
     _partitionOpsIndex?: number;
     _partitionBy: (string | IExpr)[] | null;

package/dist/columnExpressions/constants.d.ts

@@ -3,3 +3,4 @@ export declare const LITERAL_MARKER = "*literal*";
 export declare const COALESCE_MARKER = "*coalesce*";
 export declare const ELEMENT_MARKER = "*element*";
 export declare const STRUCT_MARKER = "*struct*";
+export declare const DURATION_MARKER = "*duration*";

package/dist/columnExpressions/functions/duration.d.ts

@@ -0,0 +1,33 @@
+import { ColumnExpr } from "../ColumnExpr";
+import type { IntoExpr, DatetimeTimeUnit } from "../../types";
+export interface DurationOptions {
+    weeks?: IntoExpr | number;
+    days?: IntoExpr | number;
+    hours?: IntoExpr | number;
+    minutes?: IntoExpr | number;
+    seconds?: IntoExpr | number;
+    milliseconds?: IntoExpr | number;
+    microseconds?: IntoExpr | number;
+    nanoseconds?: IntoExpr | number;
+    timeUnit?: DatetimeTimeUnit;
+}
+/**
+ * Constructs a Duration expression column from numeric values, column references, or expressions.
+ *
+ * @param {DurationOptions} [options] Duration component options (weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds, timeUnit).
+ * @returns {ColumnExpr<any>} A column expression with the calculated duration values.
+ * @namespace $df
+ * @category ColumnExpression
+ * @syntax $df.duration(options)
+ * @example
+ * >>> const df = $df.data({ dt: ["2026-01-01"], add: [1, 2] })
+ * >>> df.select($df.col("dt").cast($df.DataType.Datetime).add($df.duration({ days: "add" })).alias("add_days"))
+ * shape: (2, 1)
+ * ┌──────────────────────────┐
+ * │ add_days                 │
+ * ├──────────────────────────┤
+ * │ 2026-01-02T00:00:00.000Z │
+ * │ 2026-01-03T00:00:00.000Z │
+ * └──────────────────────────┘
+ */
+export declare function duration(options?: DurationOptions): ColumnExpr<any>;

package/dist/columnExpressions/index.d.ts

@@ -20,4 +20,5 @@ export * from "./functions/implode";
 export * from "./functions/seq_range";
 export * from "./functions/element";
 export * from "./functions/struct";
+export * from "./functions/duration";
 export * from "./utils";

package/dist/columnExpressions/mixins/TemporalExpr.d.ts

@@ -1,17 +1,48 @@
-import type { TimeUnit, StrftimeOptions, IsBusinessDayOptions, BusinessDayOffsetOptions, UtcOffsetOptions } from "../../types";
+import type { TimeUnit, DatetimeTimeUnit, StrftimeOptions, IsBusinessDayOptions, DayOffsetOptions, UtcOffsetOptions, ReplaceDateOptions } from "../../types";
 import { ExprBase } from "../ExprBase";
 /**
  * @namespace $df.col.dt
  * @category ColumnExpression
  * @syntax $df.col(<column_name>).dt.{symbol}(...)
+ *
+ * **Implementation Notes**
+ *
+ * _TimeUnit_: `Date` objects are always millisecond-based, so `timeUnit` is schema
+ * metadata only. Sub-millisecond precision (`us`, `ns`) cannot be stored; methods such
+ * as `microsecond()` and `nanosecond()` always scale from milliseconds. Migrating to
+ * raw `BigInt` arrays would be required for true sub-ms storage.
+ *
+ * _Timezone enforcement_: `convert_time_zone` can only validate that the column is
+ * timezone-aware when `_castType` is explicitly set within the expression chain
+ * (e.g. after `cast_time_unit`). Enforcement against a column whose type is unknown
+ * at expression-build time requires schema-level checks in DataFrame operations.
  */
 export declare class DateTimeExprNamespace {
     expr: any;
     constructor(expr: any);
+    /** Returns the column's schema timezone from a prior convert_time_zone call, or null. */
+    _colTz(): string | null;
+    /** Returns the column's schema time unit from a prior cast_time_unit call, or null. */
+    _colTu(): DatetimeTimeUnit | null;
     _deriveDate(fn: (d: Date) => any): any;
-    _deriveDuration(fn: (v: number) => number): any;
     /**
-     * Extracts century index of a Datetime value.
+     * Casts the schema time unit of a Datetime column (`"ms"`, `"us"`, `"ns"`).
+     * This is a metadata-only operation — underlying millisecond Date timestamps are preserved.
+     * @param unit Target time unit: `"ms"` (milliseconds), `"us"` (microseconds), or `"ns"` (nanoseconds).
+     * @returns ColumnExpression
+     * @example
+     * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.123Z"] })
+     * >>> df.with_columns($df.col("ts").dt.cast_time_unit("us").alias("ts_us"))
+     * shape: (1, 2)
+     * ┌──────────────────────────┬──────────────────────────┐
+     * │ ts                       │ ts_us                    │
+     * ├──────────────────────────┼──────────────────────────┤
+     * │ 2026-05-20T10:00:00.123Z │ 2026-05-20T10:00:00.123Z │
+     * └──────────────────────────┴──────────────────────────┘
+     */
+    cast_time_unit(unit: DatetimeTimeUnit): any;
+    /**
+     * Extracts the 1-indexed century component (e.g. 21 for 2026) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -25,7 +56,26 @@ export declare class DateTimeExprNamespace {
      */
     century(): any;
     /**
-     * Extracts Date object component from Datetime.
+     * Converts a Datetime column to a different IANA timezone.
+     * Preserves the exact UTC epoch instant while changing the timezone label, affecting
+     * how local wall-clock component extractors (`hour()`, `day()`, etc.) and `strftime` interpret values.
+     * Requires the column to already be timezone-aware; use `replace({ timeZone })`
+     * to assign a timezone to a naive column first.
+     * @param timeZone Target IANA timezone identifier (e.g. `"UTC"`, `"America/New_York"`, `"Europe/London"`).
+     * @returns ColumnExpression
+     * @example
+     * >>> const df = $df.data({ ts: ["2026-06-01T00:00:00.000Z"] })
+     * >>> df.with_columns($df.col("ts").dt.convert_time_zone("America/New_York").alias("ts_ny"))
+     * shape: (1, 2)
+     * ┌──────────────────────────┬───────────────────────────────┐
+     * │ ts                       │ ts_ny                         │
+     * ├──────────────────────────┼───────────────────────────────┤
+     * │ 2026-06-01T00:00:00.000Z │ 2026-05-31 20:00:00.000 EDT   │
+     * └──────────────────────────┴───────────────────────────────┘
+     */
+    convert_time_zone(timeZone: string): any;
+    /**
+     * Extracts the Date object component from a Datetime column, truncating time to 00:00:00.000 UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:30:00Z"] })
@@ -40,6 +90,7 @@ export declare class DateTimeExprNamespace {
     date(): any;
     /**
      * Extracts the calendar day component (1-31) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -51,9 +102,10 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 20  │
      * └────────────┴─────┘
      */
-    day(): any;
+    day(timeZone?: string): any;
     /**
-     * Extracts number of days in the month.
+     * Extracts the total number of days in the month (28-31) for each Datetime value.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2024-02-15"] })
@@ -65,10 +117,10 @@ export declare class DateTimeExprNamespace {
      * │ 2024-02-15 │ 29  │
      * └────────────┴─────┘
      */
-    days_in_month(): any;
+    days_in_month(timeZone?: string): any;
     /**
-     * Returns epoch duration timestamp offset.
-     * @param unit Time resolution unit ("ms", "us", "ns", "s").
+     * Returns the epoch duration timestamp offset in the specified time resolution unit.
+     * @param unit Time resolution unit (`"ms"`, `"us"`, `"ns"`, `"s"`). Defaults to `"ms"`.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-01-01T00:00:00Z"] })
@@ -82,7 +134,8 @@ export declare class DateTimeExprNamespace {
      */
     epoch(unit?: TimeUnit): any;
     /**
-     * Extracts the hour component (0-23) from a Datetime column.
+     * Extracts the local hour component (0-23) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T14:30:00Z"] })
@@ -94,10 +147,11 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20T14:30:00Z │ 14 │
      * └──────────────────────┴────┘
      */
-    hour(): any;
+    hour(timeZone?: string): any;
     /**
-     * Boolean check: Returns true if target falls on a business day.
-     * @param options Config options including custom weekend or holiday definitions.
+     * Evaluates whether each Datetime value falls on a business day.
+     * Supports custom weekend day definitions and holiday arrays or timestamp sets.
+     * @param options Business day rules and custom holiday configuration options.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-18"] })
@@ -111,7 +165,7 @@ export declare class DateTimeExprNamespace {
      */
     is_business_day(options?: IsBusinessDayOptions): any;
     /**
-     * Checks if year is a leap year.
+     * Checks if the calendar year of a Datetime value is a leap year (366 days).
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2024-01-01", "2026-01-01"] })
@@ -126,7 +180,7 @@ export declare class DateTimeExprNamespace {
      */
     is_leap_year(): any;
     /**
-     * Extracts ISO week index.
+     * Extracts the ISO 8601 week number (1-53) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -140,7 +194,7 @@ export declare class DateTimeExprNamespace {
      */
     iso_week(): any;
     /**
-     * Extracts ISO calendar year.
+     * Extracts the ISO 8601 week-numbering year from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -154,7 +208,7 @@ export declare class DateTimeExprNamespace {
      */
     iso_year(): any;
     /**
-     * Extracts microseconds component.
+     * Extracts the microsecond component (0-999,000) scaled from Datetime millisecond precision.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.123Z"] })
@@ -168,7 +222,7 @@ export declare class DateTimeExprNamespace {
      */
     microsecond(): any;
     /**
-     * Extracts millennium component index.
+     * Extracts the 1-indexed millennium component index (e.g. 3 for the year 2026) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -182,7 +236,7 @@ export declare class DateTimeExprNamespace {
      */
     millennium(): any;
     /**
-     * Extracts milliseconds component.
+     * Extracts the millisecond component (0-999) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.456Z"] })
@@ -197,6 +251,7 @@ export declare class DateTimeExprNamespace {
     millisecond(): any;
     /**
      * Extracts the minute component (0-59) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:45:00Z"] })
@@ -208,9 +263,10 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20T10:45:00Z │ 45  │
      * └──────────────────────┴─────┘
      */
-    minute(): any;
+    minute(timeZone?: string): any;
     /**
      * Extracts the calendar month component (1-12) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -222,9 +278,9 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 5 │
      * └────────────┴───┘
      */
-    month(): any;
+    month(timeZone?: string): any;
     /**
-     * Returns date representing end of the month.
+     * Returns a Datetime column shifted to the last calendar day of the month at 00:00:00.000 UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -238,7 +294,7 @@ export declare class DateTimeExprNamespace {
      */
     month_end(): any;
     /**
-     * Returns date representing start of the month.
+     * Returns a Datetime column shifted to the first calendar day of the month at 00:00:00.000 UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -252,7 +308,7 @@ export declare class DateTimeExprNamespace {
      */
     month_start(): any;
     /**
-     * Extracts nanoseconds component.
+     * Extracts the nanosecond component (0-999,000,000) scaled from Datetime millisecond precision.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.001Z"] })
@@ -266,25 +322,10 @@ export declare class DateTimeExprNamespace {
      */
     nanosecond(): any;
     /**
-     * Offsets date by N business days.
-     * @param n Number of business days to offset.
-     * @param options Business day rules and holidays options.
-     * @returns ColumnExpression
-     * @example
-     * >>> const df = $df.data({ d: ["2026-05-15"] })
-     * >>> df.with_columns($df.col("d").dt.offset_business_day(2).alias("next_bday"))
-     * shape: (1, 2)
-     * ┌────────────┬──────────────────────────┐
-     * │ d          │ next_bday                │
-     * ├────────────┼──────────────────────────┤
-     * │ 2026-05-15 │ 2026-05-19T00:00:00.000Z │
-     * └────────────┴──────────────────────────┘
-     */
-    offset_business_day(n: number | any, { excludeWeekdays, ...options }?: BusinessDayOffsetOptions): any;
-    /**
-     * Offsets date by N calendar days.
-     * @param n Number of calendar days to offset.
-     * @param options Offset options.
+     * Offsets a Datetime column by N calendar days (numeric constant, column reference, or expression).
+     * Reuses $df.duration({ days: n }) and expression addition math under the hood.
+     * @param n Number of calendar days to offset (positive or negative).
+     * @param options Day offset configuration options.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -296,9 +337,9 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2026-05-25T00:00:00.000Z │
      * └────────────┴──────────────────────────┘
      */
-    offset_day(n: number | any, options?: BusinessDayOffsetOptions): any;
+    offset_day(n: number | any, options?: DayOffsetOptions): any;
     /**
-     * Returns day of the year (1-366).
+     * Extracts the day of the year (1-366) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-02-01"] })
@@ -312,7 +353,7 @@ export declare class DateTimeExprNamespace {
      */
     ordinal_day(): any;
     /**
-     * Returns quarter of the year (1-4).
+     * Extracts the calendar quarter of the year (1-4) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -326,7 +367,25 @@ export declare class DateTimeExprNamespace {
      */
     quarter(): any;
     /**
-     * Extracts seconds component (0-59).
+     * Replaces specific date and time components (`year`, `month`, `day`, `hour`, `minute`, `second`, `ms`, `timeZone`) of a Datetime column.
+     * Unspecified components are preserved from the original value.
+     * When `timeZone` is provided in options, components are interpreted in that timezone.
+     * Note: `month` is 1-indexed (1 = January, 12 = December); `day` is 1-indexed (1-31).
+     * @param options Object specifying which components to replace.
+     * @returns ColumnExpression
+     * @example
+     * >>> const df = $df.data({ ts: ["2026-05-20T14:30:00Z"] })
+     * >>> df.with_columns($df.col("ts").dt.replace({ year: 2030, month: 1, day: 1 }).alias("replaced"))
+     * shape: (1, 2)
+     * ┌──────────────────────┬──────────────────────────┐
+     * │ ts                   │ replaced                 │
+     * ├──────────────────────┼──────────────────────────┤
+     * │ 2026-05-20T14:30:00Z │ 2030-01-01T14:30:00.000Z │
+     * └──────────────────────┴──────────────────────────┘
+     */
+    replace(options: ReplaceDateOptions): any;
+    /**
+     * Extracts the second component (0-59) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:00:45Z"] })
@@ -340,8 +399,9 @@ export declare class DateTimeExprNamespace {
      */
     second(): any;
     /**
-     * Formats dates to custom strings using strftime format tokens.
-     * @param options Formatting pattern configuration.
+     * Formats Datetime values into custom formatted strings using strftime directive pattern tokens.
+     * Automatically applies the column's assigned timezone unless explicitly overridden in options.
+     * @param options Formatting pattern string (e.g. `"%Y-%m-%d %H:%M:%S"`) or configuration object.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -355,7 +415,7 @@ export declare class DateTimeExprNamespace {
      */
     strftime(options: StrftimeOptions): any;
     /**
-     * Extracts time component string ("HH:MM:SS.mmm").
+     * Extracts the time component formatted string (`"HH:MM:SS.mmm"`) from a Datetime column.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ ts: ["2026-05-20T10:30:00Z"] })
@@ -384,22 +444,7 @@ export declare class DateTimeExprNamespace {
      */
     timestamp(unit?: TimeUnit): any;
     /**
-     * Formats dates to custom strings. Alias for strftime.
-     * @param options Formatting configuration.
-     * @returns ColumnExpression
-     * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.to_string("%Y-%m-%d").alias("str"))
-     * shape: (1, 2)
-     * ┌────────────┬────────────┐
-     * │ d          │ str        │
-     * ├────────────┼────────────┤
-     * │ 2026-05-20 │ 2026-05-20 │
-     * └────────────┴────────────┘
-     */
-    to_string(options: StrftimeOptions): any;
-    /**
-     * Converts Duration to integer day count.
+     * Converts a Duration value (in milliseconds) to total days count.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ dur: [86400000] })
@@ -413,7 +458,7 @@ export declare class DateTimeExprNamespace {
      */
     total_days(): any;
     /**
-     * Converts Duration to floating point hours.
+     * Converts a Duration value (in milliseconds) to total hours count.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ dur: [3600000] })
@@ -497,9 +542,13 @@ export declare class DateTimeExprNamespace {
      */
     total_seconds(): any;
     /**
-     * Returns the offset of local timezone relative to UTC in minutes.
-     * @param timeZone Target timezone string identifier.
-     * @param options Utc offset calculation options.
+     * Returns the UTC offset of a timezone for a given Datetime value.
+     * Supports returning the total offset, the standard (base) offset, or just the
+     * daylight saving time component, in multiple output formats.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the system local timezone.
+     * @param options Output configuration: `type` selects which offset component to return
+     *   (`"total"` | `"standardTime"` | `"daylightSavingTime"`), and `format` controls the
+     *   output unit (`"milliseconds"` | `"minutes"` | `"hours"` | `"iso"` | `"basic"`).
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -528,6 +577,7 @@ export declare class DateTimeExprNamespace {
     week(): any;
     /**
      * Extracts weekday component (1=Monday, 7=Sunday).
+     * @param timeZone Optional IANA timezone identifier. Defaults to UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-18"] })
@@ -539,9 +589,10 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-18 │ 1  │
      * └────────────┴────┘
      */
-    weekday(): any;
+    weekday(timeZone?: string): any;
     /**
      * Extracts the year component from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to UTC.
      * @returns ColumnExpression
      * @example
      * >>> const df = $df.data({ d: ["2026-05-20"] })
@@ -553,7 +604,7 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2026 │
      * └────────────┴──────┘
      */
-    year(): any;
+    year(timeZone?: string): any;
 }
 export declare class TemporalExpr extends ExprBase {
     /**

package/dist/columnExpressions/utils.d.ts

@@ -1,4 +1,14 @@
 import type { IExpr, ColumnData, ColumnDict } from "../types";
+/**
+ * Normalizes a single unary value (coercing Date instances to getTime if valid)
+ * and executes the operation callback.
+ */
+export declare function evalUnaryOp(v: any, fn: (a: any) => any): any;
+/**
+ * Normalizes binary values (coercing Date instances to getTime if valid)
+ * and executes the operation callback.
+ */
+export declare function evalBinaryOp(v: any, r: any, fn: (a: any, b: any) => any): any;
 export declare const kleeneUnary: (fn: (v: any) => any) => (vArray: ColumnData) => any[];
 export declare const kleeneBinary: (expr: IExpr, other: any, fn: (v: any, r: any) => any) => (vArray: ColumnData, columns: ColumnDict) => any[];
 export declare function evaluateExpression(expr: IExpr, columns: ColumnDict, height: number): ColumnData;

package/dist/constants.d.ts

@@ -1,11 +1,23 @@
 export declare const NEWLINE = "\n";
 export declare const CARRIAGE_RETURN = "\r";
 export declare const UTF8_BOM = "\uFEFF";
-export declare const MS_PER_SECOND = 1000;
-export declare const MS_PER_MINUTE = 60000;
-export declare const MS_PER_HOUR = 3600000;
+export declare const MS_PER_WEEK = 604800000;
 export declare const MS_PER_DAY = 86400000;
+export declare const MS_PER_HOUR = 3600000;
+export declare const MS_PER_MINUTE = 60000;
+export declare const MS_PER_SECOND = 1000;
+export declare const MS_PER_MILLISECOND = 1;
+export declare const MS_PER_MICROSECOND = 0.001;
+export declare const MS_PER_NANOSECOND = 0.000001;
 export declare const US_PER_MS = 1000;
 export declare const NS_PER_MS = 1000000;
 export declare const US_PER_MS_BI = 1000n;
 export declare const NS_PER_MS_BI = 1000000n;
+/** Separates composite key segments within a single row hash (e.g. multi-column join keys). */
+export declare const KEY_SEPARATOR = "\0";
+/** Separates key-value pairs within a serialized object or map canonical hash. */
+export declare const KEY_PAIR_SEPARATOR = "\u0001";
+/** Sentinel value used in join left-index arrays to indicate a right-only (unmatched) row. */
+export declare const UNMATCHED_ROW_INDEX = -1;
+/** Maximum allowable length for a single JavaScript array (2^32 - 1). */
+export declare const MAX_JS_ARRAY_LENGTH = 4294967295;