@elaraai/east 0.0.1-beta.3 → 0.0.1-beta.31

package/dist/src/datetime_format/types.d.ts

@@ -44,51 +44,51 @@ export declare const DateTimeFormatTokenType: VariantType<{
      * Any characters in the format string that are not recognized as format
      * codes are treated as literals.
      */
-    literal: StringType;
+    readonly literal: StringType;
     /** Four-digit year (e.g., "2025") - Format: YYYY */
-    year4: NullType;
+    readonly year4: NullType;
     /** Two-digit year (e.g., "25") - Format: YY */
-    year2: NullType;
+    readonly year2: NullType;
     /** Month as 1-12 without zero-padding (e.g., "1", "12") - Format: M */
-    month1: NullType;
+    readonly month1: NullType;
     /** Month as 01-12 with zero-padding (e.g., "01", "12") - Format: MM */
-    month2: NullType;
+    readonly month2: NullType;
     /** Short month name (e.g., "Jan", "Feb") - Format: MMM */
-    monthNameShort: NullType;
+    readonly monthNameShort: NullType;
     /** Full month name (e.g., "January", "February") - Format: MMMM */
-    monthNameFull: NullType;
+    readonly monthNameFull: NullType;
     /** Day of month as 1-31 without zero-padding (e.g., "1", "31") - Format: D */
-    day1: NullType;
+    readonly day1: NullType;
     /** Day of month as 01-31 with zero-padding (e.g., "01", "31") - Format: DD */
-    day2: NullType;
+    readonly day2: NullType;
     /** Minimal weekday name (e.g., "Su", "Mo") - Format: dd */
-    weekdayNameMin: NullType;
+    readonly weekdayNameMin: NullType;
     /** Short weekday name (e.g., "Sun", "Mon") - Format: ddd */
-    weekdayNameShort: NullType;
+    readonly weekdayNameShort: NullType;
     /** Full weekday name (e.g., "Sunday", "Monday") - Format: dddd */
-    weekdayNameFull: NullType;
+    readonly weekdayNameFull: NullType;
     /** Hour 0-23 without zero-padding (e.g., "0", "23") - Format: H */
-    hour24_1: NullType;
+    readonly hour24_1: NullType;
     /** Hour 00-23 with zero-padding (e.g., "00", "23") - Format: HH */
-    hour24_2: NullType;
+    readonly hour24_2: NullType;
     /** Hour 1-12 without zero-padding (e.g., "1", "12") - Format: h */
-    hour12_1: NullType;
+    readonly hour12_1: NullType;
     /** Hour 01-12 with zero-padding (e.g., "01", "12") - Format: hh */
-    hour12_2: NullType;
+    readonly hour12_2: NullType;
     /** Minute 0-59 without zero-padding (e.g., "0", "59") - Format: m */
-    minute1: NullType;
+    readonly minute1: NullType;
     /** Minute 00-59 with zero-padding (e.g., "00", "59") - Format: mm */
-    minute2: NullType;
+    readonly minute2: NullType;
     /** Second 0-59 without zero-padding (e.g., "0", "59") - Format: s */
-    second1: NullType;
+    readonly second1: NullType;
     /** Second 00-59 with zero-padding (e.g., "00", "59") - Format: ss */
-    second2: NullType;
+    readonly second2: NullType;
     /** Millisecond 000-999 with zero-padding (e.g., "000", "999") - Format: SSS */
-    millisecond3: NullType;
+    readonly millisecond3: NullType;
     /** Uppercase AM/PM (e.g., "AM", "PM") - Format: A */
-    ampmUpper: NullType;
+    readonly ampmUpper: NullType;
     /** Lowercase am/pm (e.g., "am", "pm") - Format: a */
-    ampmLower: NullType;
+    readonly ampmLower: NullType;
 }>;
 /**
  * TypeScript type for datetime format tokens.

package/dist/src/eastir.d.ts

@@ -13,6 +13,8 @@ export declare class EastIR<Inputs extends any[], Output extends any> {
     constructor(ir: FunctionIR);
     /** Compile the function for execution in JavaScript using a closure-compiler technique.
      * Platform functions must be provided for the function to evaluate.
+     *
+     * @param platform - Array of platform function implementations
      */
     compile(platform: PlatformFunction[]): (...inputs: {
         [K in keyof Inputs]: ValueTypeOf<Inputs[K]>;
@@ -27,6 +29,8 @@ export declare class AsyncEastIR<Inputs extends any[], Output extends any> {
     /** Compile the async function for execution in JavaScript using a closure-compiler technique.
      * Platform functions must be provided for the function to evaluate, which may return `Promise`s.
      * The compiled function itself returns a `Promise`.
+     *
+     * @param platform - Array of platform function implementations
      */
     compile(platform: PlatformFunction[]): (...inputs: {
         [K in keyof Inputs]: ValueTypeOf<Inputs[K]>;

package/dist/src/eastir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eastir.d.ts","sourceRoot":"","sources":["../../src/eastir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;GAEG;AACH,qBAAa,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,EAAE,MAAM,SAAS,GAAG;IACvC,EAAE,EAAE,UAAU;gBAAd,EAAE,EAAE,UAAU;IASjC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAAE,KAAK,WAAW,CAAC,MAAM,CAAC;CA0B3H;AAED;;GAEG;AACH,qBAAa,WAAW,CAAC,MAAM,SAAS,GAAG,EAAE,EAAE,MAAM,SAAS,GAAG;IAC5C,EAAE,EAAE,eAAe;gBAAnB,EAAE,EAAE,eAAe;IAStC;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CA4BpI"}
+{"version":3,"file":"eastir.d.ts","sourceRoot":"","sources":["../../src/eastir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;GAEG;AACH,qBAAa,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,EAAE,MAAM,SAAS,GAAG;IACvC,EAAE,EAAE,UAAU;gBAAd,EAAE,EAAE,UAAU;IASjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAAE,KAAK,WAAW,CAAC,MAAM,CAAC;CAoC3H;AAED;;GAEG;AACH,qBAAa,WAAW,CAAC,MAAM,SAAS,GAAG,EAAE,EAAE,MAAM,SAAS,GAAG;IAC5C,EAAE,EAAE,eAAe;gBAAnB,EAAE,EAAE,eAAe;IAStC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CAsCpI"}

package/dist/src/eastir.js

@@ -3,7 +3,7 @@
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
 import {} from "./types.js";
-import { compile_internal, ReturnException } from "./compile.js";
+import { compile_internal, ReturnException, EAST_IR_SYMBOL } from "./compile.js";
 import { analyzeIR } from "./analyze.js";
 /** A helper class wrapping East's "intermediate representation" (IR) for a free function.
  * The IR can be serialized and saved, or compiled so that the function can be executed.
@@ -21,18 +21,20 @@ export class EastIR {
     }
     /** Compile the function for execution in JavaScript using a closure-compiler technique.
      * Platform functions must be provided for the function to evaluate.
+     *
+     * @param platform - Array of platform function implementations
      */
     compile(platform) {
         // Analyse the IR
-        const analyzed_ir = analyzeIR(this.ir, platform, {});
+        const analyzed_ir = analyzeIR(this.ir, platform);
         // compile the function (with no variables in environment)
         const platformFns = Object.fromEntries(platform.map(fn => [fn.name, fn.fn]));
         const asyncPlatformFns = new Set();
-        const compiled_expr = compile_internal(analyzed_ir, {}, platformFns, asyncPlatformFns);
+        const compiled_expr = compile_internal(analyzed_ir, {}, platformFns, asyncPlatformFns, platform);
         // instantiate the function (with no environment)
         const instantiated_function = compiled_expr({});
         // Return sync wrapper
-        return (...inputs) => {
+        const wrapper = (...inputs) => {
             try {
                 return instantiated_function(...inputs);
             }
@@ -45,6 +47,14 @@ export class EastIR {
                 }
             }
         };
+        // Attach IR to wrapper for serialization support
+        Object.defineProperty(wrapper, EAST_IR_SYMBOL, {
+            value: this.ir,
+            writable: false,
+            enumerable: false,
+            configurable: false
+        });
+        return wrapper;
     }
 }
 /** A helper class wrapping East's "intermediate representation" (IR) for a free async function.
@@ -64,18 +74,20 @@ export class AsyncEastIR {
     /** Compile the async function for execution in JavaScript using a closure-compiler technique.
      * Platform functions must be provided for the function to evaluate, which may return `Promise`s.
      * The compiled function itself returns a `Promise`.
+     *
+     * @param platform - Array of platform function implementations
      */
     compile(platform) {
         // Analyse the IR
-        const analyzed_ir = analyzeIR(this.ir, platform, {});
+        const analyzed_ir = analyzeIR(this.ir, platform);
         // compile the function (with no variables in environment)
         const platformFns = Object.fromEntries(platform.map(fn => [fn.name, fn.fn]));
         const asyncPlatformFns = new Set(platform.filter(fn => fn.type === 'async').map(fn => fn.name));
-        const compiled_expr = compile_internal(analyzed_ir, {}, platformFns, asyncPlatformFns);
+        const compiled_expr = compile_internal(analyzed_ir, {}, platformFns, asyncPlatformFns, platform);
         // instantiate the function (with no environment)
         const instantiated_function = compiled_expr({});
         // Return async wrapper
-        return async (...inputs) => {
+        const wrapper = async (...inputs) => {
             try {
                 return await instantiated_function(...inputs);
             }
@@ -88,6 +100,14 @@ export class AsyncEastIR {
                 }
             }
         };
+        // Attach IR to wrapper for serialization support
+        Object.defineProperty(wrapper, EAST_IR_SYMBOL, {
+            value: this.ir,
+            writable: false,
+            enumerable: false,
+            configurable: false
+        });
+        return wrapper;
     }
 }
 //# sourceMappingURL=eastir.js.map

package/dist/src/eastir.js.map

@@ -1 +1 @@
-{"version":3,"file":"eastir.js","sourceRoot":"","sources":["../../src/eastir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eastir.js","sourceRoot":"","sources":["../../src/eastir.ts"],"names":[],"mappings":"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"}

package/dist/src/error.d.ts

@@ -3,11 +3,22 @@
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
 import type { LocationValue } from "./ir.js";
+/**
+ * Internal error for invariant violations in the East compiler/runtime.
+ * These indicate bugs in East itself, not user errors.
+ */
+export declare class InternalError extends Error {
+    constructor(message: string);
+}
 export declare class EastError extends Error {
     location: LocationValue[];
+    eastMessage: string;
     constructor(message: string, options: {
         cause?: any;
-        location: LocationValue;
+        location: LocationValue[];
     });
+    toString(): string;
+    /** Format for use with Error.message */
+    get formattedMessage(): string;
 }
 //# sourceMappingURL=error.d.ts.map

package/dist/src/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,SAAU,SAAQ,KAAK;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE;CAI/E"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,SAAU,SAAQ,KAAK;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE;IAMvE,QAAQ,IAAI,MAAM;IAkB3B,wCAAwC;IACxC,IAAI,gBAAgB,IAAI,MAAM,CAE7B;CACF"}

package/dist/src/error.js

@@ -1,8 +1,38 @@
+/**
+ * Internal error for invariant violations in the East compiler/runtime.
+ * These indicate bugs in East itself, not user errors.
+ */
+export class InternalError extends Error {
+    constructor(message) {
+        super(`Internal East error: ${message}`);
+        this.name = "InternalError";
+    }
+}
 export class EastError extends Error {
     location;
+    eastMessage;
     constructor(message, options) {
         super(message, options.cause === undefined ? undefined : { cause: options.cause });
-        this.location = [options.location];
+        this.eastMessage = message;
+        this.location = [...options.location];
+    }
+    toString() {
+        const loc = this.location[0];
+        const header = `${loc.filename}:${loc.line}:${loc.column}: ${this.eastMessage}`;
+        if (this.location.length <= 1) {
+            return header;
+        }
+        // Build stack trace (skip first since it's in the header)
+        const lines = [header, "Stack trace:"];
+        for (let i = this.location.length - 1; i >= 1; i--) {
+            const frame = this.location[i];
+            lines.push(`  at ${frame.filename}:${frame.line}:${frame.column}`);
+        }
+        return lines.join("\n");
+    }
+    /** Format for use with Error.message */
+    get formattedMessage() {
+        return this.toString();
     }
 }
 //# sourceMappingURL=error.js.map

package/dist/src/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC3B,QAAQ,CAAkB;IAEjC,YAAY,OAAe,EAAE,OAAiD;QAC5E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC3B,QAAQ,CAAkB;IAC1B,WAAW,CAAS;IAE3B,YAAY,OAAe,EAAE,OAAmD;QAC9E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAEQ,QAAQ;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAEhF,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,0DAA0D;QAC1D,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,wCAAwC;IACxC,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/src/expr/array.d.ts

@@ -14,6 +14,8 @@ import type { BooleanExpr } from "./boolean.js";
 import type { SetExpr } from "./set.js";
 import type { FloatExpr } from "./float.js";
 import type { DictExpr } from "./dict.js";
+import { type CsvSerializeOptions } from "../serialization/csv.js";
+import type { BlobExpr } from "./blob.js";
 /**
  * Expression representing mutable array values and operations.
  *
@@ -61,6 +63,22 @@ export declare class ArrayExpr<T extends any> extends Expr<ArrayType<T>> {
      * ```
      */
     size(): IntegerExpr;
+    /**
+     * Returns the length of the array (an alias for size).
+     *
+     * @returns An IntegerExpr representing the number of elements
+     *
+     * @example
+     * ```ts
+     * const getLength = East.function([ArrayType(IntegerType)], IntegerType, ($, arr) => {
+     *   $.return(arr.length());
+     * });
+     * const compiled = East.compile(getLength.toIR(), []);
+     * compiled([1n, 2n, 3n]);  // 3n
+     * compiled([]);            // 0n
+     * ```
+     */
+    length(): IntegerExpr;
     /**
      * Checks if an element exists at the specified index (i.e., if the index is in bounds).
      *
@@ -106,6 +124,33 @@ export declare class ArrayExpr<T extends any> extends Expr<ArrayType<T>> {
      * ```
      */
     get(key: Expr<IntegerType> | bigint, defaultFn?: SubtypeExprOrValue<FunctionType<[IntegerType], T>>): ExprType<T>;
+    /**
+     * Gets the element at the specified index (alias for get).
+     *
+     * @param key - The zero-based index
+     * @param defaultFn - Optional function to provide a default value for out-of-bounds indices
+     * @returns An expression of the array's element type
+     *
+     * @throws East runtime error if index is out of bounds and no defaultFn is provided
+     *
+     * @example
+     * ```ts
+     * const getElement = East.function([ArrayType(IntegerType), IntegerType], IntegerType, ($, arr, index) => {
+     *   $.return(arr.get(index));
+     * });
+     * const compiled = East.compile(getElement.toIR(), []);
+     * compiled([10n, 20n, 30n], 1n);  // 20n
+     * // compiled([10n, 20n, 30n], 5n) would throw error
+     *
+     * // With default value
+     * const getOrDefault = East.function([ArrayType(IntegerType), IntegerType], IntegerType, ($, arr, index) => {
+     *   $.return(arr.get(index, ($, i) => -1n));
+     * });
+     * compiled = East.compile(getOrDefault.toIR(), []);
+     * compiled([10n, 20n, 30n], 5n);  // -1n (out of bounds)
+     * ```
+     */
+    at(key: Expr<IntegerType> | bigint, defaultFn?: SubtypeExprOrValue<FunctionType<[IntegerType], T>>): ExprType<T>;
     /**
      * Safely gets the element at the specified index, returning an Option variant.
      *
@@ -705,7 +750,7 @@ export declare class ArrayExpr<T extends any> extends Expr<ArrayType<T>> {
      * compiled([{ name: "Alice", age: 30n }, { name: "Bob", age: 15n }]);  // [{ name: "Alice", age: 30n }]
      * ```
      */
-    filter(predicate: SubtypeExprOrValue<FunctionType<[T, IntegerType], BooleanType>>): Expr<ArrayType<T>>;
+    filter(predicate: SubtypeExprOrValue<FunctionType<[T, IntegerType], BooleanType>>): ArrayExpr<T>;
     /**
      * Filters and maps array elements in a single pass using an Option-returning function.
      *
@@ -1707,5 +1752,68 @@ export declare class ArrayExpr<T extends any> extends Expr<ArrayType<T>> {
     groupToDicts<K1, KeyFn2 extends (($: BlockBuilder<NeverType>, v: ExprType<T>, i: IntegerExpr) => any)>(keyFn: Expr<FunctionType<[T, IntegerType], K1>>, keyFn2: KeyFn2): DictExpr<K1, DictType<TypeOf<ReturnType<KeyFn2>>, T>>;
     groupToDicts<KeyFn extends (($: BlockBuilder<NeverType>, v: ExprType<T>, i: IntegerExpr) => any), K2>(keyFn: KeyFn, keyFn2: Expr<FunctionType<[T, IntegerType], K2>>): DictExpr<TypeOf<ReturnType<KeyFn>>, DictType<K2, T>>;
     groupToDicts<KeyFn extends (($: BlockBuilder<NeverType>, v: ExprType<T>, i: IntegerExpr) => any), KeyFn2 extends (($: BlockBuilder<NeverType>, v: ExprType<T>, i: IntegerExpr) => any)>(keyFn: KeyFn, keyFn2: KeyFn2): DictExpr<TypeOf<ReturnType<KeyFn>>, DictType<TypeOf<ReturnType<KeyFn2>>, T>>;
+    /**
+     * Encodes this array of structs as CSV data.
+     *
+     * @param options - CSV serialization options
+     * @returns A BlobExpr containing the encoded CSV data
+     *
+     * @remarks Only works on arrays of structs with primitive or optional primitive fields.
+     *
+     * @example
+     * ```ts
+     * const PersonType = StructType({ name: StringType, age: IntegerType });
+     *
+     * const toCsv = East.function([ArrayType(PersonType)], BlobType, ($, people) => {
+     *   $.return(people.encodeCsv({ delimiter: ',' }));
+     * });
+     * const compiled = East.compile(toCsv.toIR(), []);
+     * const blob = compiled([{ name: "Alice", age: 30n }, { name: "Bob", age: 25n }]);
+     * new TextDecoder().decode(blob);  // "name,age\r\nAlice,30\r\nBob,25"
+     * ```
+     */
+    encodeCsv(options?: CsvSerializeOptions): BlobExpr;
+    /**
+     * Checks if this array equals another array (deep comparison).
+     *
+     * @param other - The array to compare against
+     * @returns A BooleanExpr that is true if the arrays are deeply equal
+     *
+     * @example
+     * ```ts
+     * const isEqual = East.function([ArrayType(IntegerType), ArrayType(IntegerType)], BooleanType, ($, a, b) => {
+     *   $.return(a.equals(b));
+     * });
+     * const compiled = East.compile(isEqual.toIR(), []);
+     * compiled([1n, 2n, 3n], [1n, 2n, 3n]);  // true
+     * compiled([1n, 2n], [1n, 2n, 3n]);      // false
+     * ```
+     */
+    equals(other: ArrayExpr<T> | SubtypeExprOrValue<T>[]): BooleanExpr;
+    /**
+     * Checks if this array does not equal another array.
+     *
+     * @param other - The array to compare against
+     * @returns A BooleanExpr that is true if the arrays are not equal
+     *
+     * @example
+     * ```ts
+     * const isNotEqual = East.function([ArrayType(IntegerType), ArrayType(IntegerType)], BooleanType, ($, a, b) => {
+     *   $.return(a.notEquals(b));
+     * });
+     * const compiled = East.compile(isNotEqual.toIR(), []);
+     * compiled([1n, 2n], [1n, 2n, 3n]);      // true
+     * compiled([1n, 2n, 3n], [1n, 2n, 3n]);  // false
+     * ```
+     */
+    notEquals(other: ArrayExpr<T> | SubtypeExprOrValue<T>[]): BooleanExpr;
+    /** Alias for {@link equals} */
+    eq: (other: ArrayExpr<T> | SubtypeExprOrValue<T>[]) => BooleanExpr;
+    /** Alias for {@link equals} */
+    equal: (other: ArrayExpr<T> | SubtypeExprOrValue<T>[]) => BooleanExpr;
+    /** Alias for {@link notEquals} */
+    ne: (other: ArrayExpr<T> | SubtypeExprOrValue<T>[]) => BooleanExpr;
+    /** Alias for {@link notEquals} */
+    notEqual: (other: ArrayExpr<T> | SubtypeExprOrValue<T>[]) => BooleanExpr;
 }
 //# sourceMappingURL=array.d.ts.map