df-script 1.7.0 → 1.8.0

package/dist/types.d.ts

@@ -27,6 +27,7 @@ export interface IExpr {
     _isLiteral?: boolean;
     _literalValue?: any;
     _aggFn?: AggFn<any> | null;
+    _castType?: RegisteredDataType;
     _groupingOpsIndex?: number;
     _partitionOpsIndex?: number;
     _partitionBy?: (string | IExpr)[] | null;
@@ -45,6 +46,7 @@ export interface IExpr {
     debug(label?: string): this;
 }
 export type TimeUnit = "s" | "ms" | "us" | "ns";
+export type DatetimeTimeUnit = "ms" | "us" | "ns";
 export type DateDiffUnit = "ms" | "milliseconds" | "s" | "seconds" | "m" | "minutes" | "h" | "hours" | "d" | "days" | "w" | "weeks" | "mo" | "months" | "q" | "quarters" | "y" | "years";
 export interface DateDiffOptions {
     roundMode?: "exact" | "floor" | "ceil" | "round" | "trunc";
@@ -64,7 +66,7 @@ export interface IsBusinessDayOptions {
     holidays?: (Date | string | number)[] | Set<number>;
     excludeWeekdays?: number[];
 }
-export interface BusinessDayOffsetOptions extends IsBusinessDayOptions {
+export interface DayOffsetOptions extends IsBusinessDayOptions {
     roll?: BusinessDayRollType;
 }
 export type UtcOffsetType = "base" | "total" | "daylightSavingTime";
@@ -73,6 +75,27 @@ export interface UtcOffsetOptions {
     type?: UtcOffsetType;
     format?: UtcOffsetFormat;
 }
+export interface DateTimeParts {
+    /** Calendar year (e.g. 2026). */
+    year: number;
+    /** 1-indexed calendar month from 1 to 12 (1 = January, 12 = December). */
+    month: number;
+    /** 1-indexed day of the month from 1 to 31. */
+    day: number;
+    /** 0-indexed hour of day from 0 to 23 (0 = Midnight). */
+    hour: number;
+    /** 0-indexed minute of hour from 0 to 59. */
+    minute: number;
+    /** 0-indexed second of minute from 0 to 59. */
+    second: number;
+    /** 0-indexed millisecond from 0 to 999. */
+    ms: number;
+    /** 0-indexed day of week (0 = Sunday, 6 = Saturday). */
+    dayOfWeek?: number;
+    /** Optional target timezone identifier (e.g. "UTC", "America/New_York"). */
+    timeZone?: string | null;
+}
+export type ReplaceDateOptions = Partial<Omit<DateTimeParts, "dayOfWeek">>;
 /** Concatenation Configuration */
 export type ConcatHow = "vertical" | "horizontal" | "diagonal";
 export interface HorizontalConcatOptions {

package/dist/utils/array.d.ts

@@ -246,3 +246,26 @@ export declare function computeDotProduct(pairs: ColumnData<[any, any]>): number
  * Defensive against absolute sum-zero weight errors.
  */
 export declare function computeWeightedAverage(pairs: ColumnData<[any, any]>): number | null;
+/**
+ * Generates Cartesian product pair index arrays for two lengths lenA and lenB.
+ */
+export declare function computeCartesianProduct(lenA: number, lenB: number): {
+    leftIndices: number[];
+    rightIndices: number[];
+};
+export type BinarySearchSide = "left" | "right";
+export interface BinarySearchOptions<T = any> {
+    side?: BinarySearchSide;
+    getValue?: (index: number, item: T) => number;
+}
+/**
+ * Performs a binary search on a sorted numeric array or ArrayLike structure.
+ * Supports an optional `getValue` accessor for indirect index searching without array allocations.
+ * @param arr Sorted array or ArrayLike structure to search within.
+ * @param target Target numeric value to search for.
+ * @param options Binary search options.
+ * @param options.side Search side: `"left"` (bisect_left, first index >= target) or `"right"` (bisect_right, first index > target). Default `"left"`.
+ * @param options.getValue Optional accessor function `(index, item) => number` for indirect searching.
+ * @returns Index insertion point.
+ */
+export declare function binarySearch<T = any>(arr: ArrayLike<T>, target: number, options?: BinarySearchOptions<T>): number;

package/dist/utils/date.d.ts

@@ -1,7 +1,10 @@
-import type { TimeUnit, StrptimeOptions, StrftimeOptions, IsBusinessDayOptions, BusinessDayOffsetOptions, DateDiffUnit, DateDiffOptions, UtcOffsetOptions } from "../types";
+import type { TimeUnit, StrptimeOptions, StrftimeOptions, IsBusinessDayOptions, DayOffsetOptions, DateDiffUnit, DateDiffOptions, UtcOffsetOptions, ReplaceDateOptions, DateTimeParts } from "../types";
 export declare const TIME_PREFIX_REGEX: RegExp;
 export declare const ZONE_OFFSET_REGEX: RegExp;
 export declare const ISO_DATE_ONLY_REGEX: RegExp;
+export declare function _createUTCDate(year: number, monthZeroIndexed?: number, day?: number, hour?: number, minute?: number, second?: number, ms?: number): Date;
+export declare function _getDateTimeParts(d: Date, timeZone?: string): DateTimeParts;
+export declare function _getTimeZoneOffsetMinutes(d: Date, tz: string): number;
 export declare function toValidDate(input: unknown, options?: {
     dateOnly?: boolean;
 }): Date | null;
@@ -21,6 +24,7 @@ export declare function isLeapYear(yOrDate: number | Date): boolean;
 export declare const FORMAT_REGEX: RegExp;
 export declare function strftime(d: Date, { format, locale, timeZone }: StrftimeOptions): string;
 export declare function strptime(str: string, { format, strict, defaultTimeZone }: StrptimeOptions): Date | null;
-export declare function offsetDay(d: Date, n: number | any, { excludeWeekdays, holidays, roll }?: BusinessDayOffsetOptions): Date;
+export declare function offsetDay(d: Date, n: number | any, { excludeWeekdays, holidays, roll }?: DayOffsetOptions): number;
 export declare function getTimeZoneOffset(d: Date, timeZone?: string, options?: UtcOffsetOptions): number | string;
 export declare function isBusinessDay(d: Date, options?: IsBusinessDayOptions): boolean | null;
+export declare function replaceDateComponents(d: Date, opts?: ReplaceDateOptions): Date;

package/dist/utils/duration.d.ts

@@ -0,0 +1,5 @@
+/** @internalfile */
+/**
+ * Scale total milliseconds into the target time unit precision.
+ */
+export declare function scaleDurationMs(ms: number, timeUnit: "ms" | "us" | "ns"): number;

package/dist/utils/index.d.ts

@@ -6,3 +6,4 @@ export * from "./string";
 export * from "./json";
 export * from "./csv";
 export * from "./binary";
+export * from "./duration";

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "df-script",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "A zero-dependency, high-performance, expression-based DataFrame library for TypeScript/JavaScript.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "typings": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,10 +20,11 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc --emitDeclarationOnly && esbuild src/index.ts --bundle --minify --outfile=dist/index.js --platform=node --mangle-props=^_ && esbuild src/index.ts --bundle --minify --outfile=dist/index.mjs --platform=neutral --format=esm --external:fs --mangle-props=^_",
+    "build": "tsc --emitDeclarationOnly && esbuild src/index.ts --bundle --minify --outfile=dist/index.js --platform=node --mangle-props=\\\"^_\\\" && esbuild src/index.ts --bundle --minify --outfile=dist/index.mjs --platform=neutral --format=esm --external:fs --mangle-props=\\\"^_\\\"",
     "test": "tsx _tests/run_all_project_tests.ts",
     "prepublishOnly": "npm run build",
-    "extract-docs": "node scripts/extract-docs.mjs"
+    "extract-docs": "node scripts/extract-docs.mjs",
+    "release": "node scripts/publish.mjs"
   },
   "keywords": [
     "dataframe",
@@ -39,6 +41,14 @@
     "expression-engine"
   ],
   "author": "Trent Morris",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trentamorris/df-script.git"
+  },
+  "bugs": {
+    "url": "https://github.com/trentamorris/df-script/issues"
+  },
+  "homepage": "https://github.com/trentamorris/df-script#readme",
   "license": "MIT",
   "funding": {
     "type": "custom",