@elaraai/east 1.0.61 → 1.0.63

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

@@ -162,7 +162,9 @@ export declare class BlobExpr extends Expr<BlobType> {
      * column is an error. For defensive ingestion, `defaults` maps column
      * names to CSV-text fallback values applied when a present field fails to
      * decode or a column is absent from the header (constant-fill), e.g.
-     * `defaults: new Map([["price", "0.0"]])`.
+     * `defaults: new Map([["price", "0.0"]])`, and `skipShortRows: true` drops
+     * ragged rows with too few fields for the required columns instead of
+     * erroring.
      *
      * @example
      * ```ts

package/dist/src/expr/blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../../src/expr/blob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAsC,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhH,OAAO,EAAa,IAAI,EAAiB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC3G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,QAAS,SAAQ,IAAI,CAAC,QAAQ,CAAC;gBAC9B,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM;IAIxC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,IAAI,WAAW;IAWnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW;IAanD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,IAAI,UAAU;IAWxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,IAAI,UAAU;IAWzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,IAAI,GAAG,IAAW,GAAG,QAAQ,CAAC,CAAC,CAAC;IAwBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IAevF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW;IAIjD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW;IAQpD,+BAA+B;IAC/B,EAAE,UA/BY,QAAQ,GAAG,UAAU,KAAG,WAAW,CA+BhC;IACjB,+BAA+B;IAC/B,KAAK,UAjCS,QAAQ,GAAG,UAAU,KAAG,WAAW,CAiC7B;IAEpB,kCAAkC;IAClC,EAAE,UAde,QAAQ,GAAG,UAAU,KAAG,WAAW,CAchC;IACpB,kCAAkC;IAClC,QAAQ,UAhBS,QAAQ,GAAG,UAAU,KAAG,WAAW,CAgB1B;CAC3B"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../../src/expr/blob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAsC,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhH,OAAO,EAAa,IAAI,EAAiB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC3G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,QAAS,SAAQ,IAAI,CAAC,QAAQ,CAAC;gBAC9B,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM;IAIxC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,IAAI,WAAW;IAWnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW;IAanD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,IAAI,UAAU;IAWxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,IAAI,UAAU;IAWzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,IAAI,GAAG,IAAW,GAAG,QAAQ,CAAC,CAAC,CAAC;IAwBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IAevF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW;IAIjD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW;IAQpD,+BAA+B;IAC/B,EAAE,UA/BY,QAAQ,GAAG,UAAU,KAAG,WAAW,CA+BhC;IACjB,+BAA+B;IAC/B,KAAK,UAjCS,QAAQ,GAAG,UAAU,KAAG,WAAW,CAiC7B;IAEpB,kCAAkC;IAClC,EAAE,UAde,QAAQ,GAAG,UAAU,KAAG,WAAW,CAchC;IACpB,kCAAkC;IAClC,QAAQ,UAhBS,QAAQ,GAAG,UAAU,KAAG,WAAW,CAgB1B;CAC3B"}

package/dist/src/expr/blob.js

@@ -218,7 +218,9 @@ export class BlobExpr extends Expr {
      * column is an error. For defensive ingestion, `defaults` maps column
      * names to CSV-text fallback values applied when a present field fails to
      * decode or a column is absent from the header (constant-fill), e.g.
-     * `defaults: new Map([["price", "0.0"]])`.
+     * `defaults: new Map([["price", "0.0"]])`, and `skipShortRows: true` drops
+     * ragged rows with too few fields for the required columns instead of
+     * erroring.
      *
      * @example
      * ```ts

package/dist/src/expr/blob.js.map

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

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

@@ -8,7 +8,6 @@ interface ValidationResult {
     errors: string[];
 }
 export declare function validateCrossPlatformCompatible(regex: RegExp): ValidationResult;
-export declare function runCompatibilityTests(): void;
 export declare const RECOMMENDED_PATTERNS: {
     email: RegExp;
     phoneUS: RegExp;

package/dist/src/expr/regex_validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regex_validation.d.ts","sourceRoot":"","sources":["../../../src/expr/regex_validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAkB/E;AAqED,wBAAgB,qBAAqB,IAAI,IAAI,CAyC5C;AAGD,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAWhC,CAAC"}
+{"version":3,"file":"regex_validation.d.ts","sourceRoot":"","sources":["../../../src/expr/regex_validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAkB/E;AAqED,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAWhC,CAAC"}

package/dist/src/expr/regex_validation.js

@@ -74,43 +74,6 @@ function validatePattern(pattern, result) {
         }
     }
 }
-// Example usage and test cases
-export function runCompatibilityTests() {
-    console.log("=== Cross-Platform RegExp Validation Tests ===\n");
-    const testCases = [
-        // ✅ Safe cross-platform patterns
-        { name: "Basic word pattern", regex: /\w+/, expectedValid: true },
-        { name: "Email pattern", regex: /\w+@\w+\.\w+/, expectedValid: true },
-        { name: "Case insensitive", regex: /hello/i, expectedValid: true },
-        { name: "Multiline mode", regex: /^test$/m, expectedValid: true },
-        { name: "Dotall mode", regex: /a.*b/s, expectedValid: true },
-        { name: "Character class", regex: /[a-z0-9]+/i, expectedValid: true },
-        { name: "Anchors", regex: /^start.*end$/, expectedValid: true },
-        { name: "Groups and alternation", regex: /(cat|dog)/, expectedValid: true },
-        { name: "Quantifiers", regex: /a{2,5}b*c+d?/, expectedValid: true },
-        // ⚠️ Problematic patterns
-        { name: "Global flag", regex: /test/g, expectedValid: false }, // Has warnings
-        { name: "Unicode flag", regex: /test/u, expectedValid: false },
-        { name: "Sticky flag", regex: /test/y, expectedValid: false },
-        // ❌ JavaScript-only features  
-        { name: "Named backreference", regex: /(?<name>\w+)\k<name>/, expectedValid: false },
-        { name: "Unicode property", regex: /\p{Letter}/u, expectedValid: false },
-    ];
-    for (const testCase of testCases) {
-        const result = validateCrossPlatformCompatible(testCase.regex);
-        const status = result.isValid ? "✅" : "❌";
-        const expected = testCase.expectedValid ? "should pass" : "should fail";
-        console.log(`${status} ${testCase.name} (${expected})`);
-        console.log(`   Pattern: ${testCase.regex}`);
-        if (result.errors.length > 0) {
-            console.log(`   Errors: ${result.errors.join(", ")}`);
-        }
-        if (result.warnings.length > 0) {
-            console.log(`   Warnings: ${result.warnings.join(", ")}`);
-        }
-        console.log();
-    }
-}
 // Recommended patterns that work well across different regex backends
 export const RECOMMENDED_PATTERNS = {
     email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
@@ -124,7 +87,4 @@ export const RECOMMENDED_PATTERNS = {
     word: /\b\w+\b/,
     lineBreak: /\r?\n/
 };
-if (import.meta.url === `file://${process.argv[1]}`) {
-    runCompatibilityTests();
-}
 //# sourceMappingURL=regex_validation.js.map

package/dist/src/expr/regex_validation.js.map

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

package/dist/src/frozen.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Brands a value as frozen in the registry.
+ *
+ * Used by the frozen decode paths for values `Object.freeze` cannot brand
+ * (typed arrays, lazy pager-backed collections). Non-objects pass through
+ * untouched.
+ *
+ * @param value - the value to brand
+ * @returns the same value
+ * @internal
+ */
+export declare function markFrozen<T>(value: T): T;
+/**
+ * Tests whether a value is a frozen East value.
+ *
+ * A value is frozen when a frozen decode/parse constructed it — either
+ * branded with `Object.freeze` or recorded in the frozen registry (typed
+ * arrays and lazy pager-backed collections, which cannot be `Object.freeze`d).
+ * Host code may also `Object.freeze` a container itself; such a container is
+ * treated as frozen too, since it is equally immutable.
+ *
+ * Frozen `Array`/`Set`/`Dict`/`Vector`/`Matrix` values are value types:
+ * `Is` compares two frozen operands by deep value equality (the `Blob`
+ * precedent), and every mutating builtin throws.
+ *
+ * @param value - the value to test
+ * @returns `true` when the value is frozen
+ *
+ * @example
+ * ```ts
+ * const decoded = decodeBeast2For(ArrayType(IntegerType), { frozen: true })(blob);
+ * isFrozenValue(decoded);  // true
+ * isFrozenValue([1n]);     // false
+ * ```
+ */
+export declare function isFrozenValue(value: unknown): boolean;
+//# sourceMappingURL=frozen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frozen.d.ts","sourceRoot":"","sources":["../../src/frozen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAKzC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAErD"}

package/dist/src/frozen.js

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The frozen-value registry.
+ *
+ * Frozen East values are produced by the frozen decode/parse surfaces
+ * (`decodeBeast2For(type, { frozen: true })`, `parseFor(type, true)`,
+ * `fromJSONFor(type, true)`, `openBeast2LazyFor(type, { frozen: true })`) and
+ * are deeply immutable: mutating builtins throw, and frozen collections
+ * compare as value types under `Is`.
+ *
+ * Most frozen values are branded with `Object.freeze` at construction. This
+ * registry brands the ones `Object.freeze` cannot:
+ *
+ * - non-empty typed arrays (Vector values, Matrix data, Blob bytes) — the
+ *   spec forbids freezing array buffer views with elements,
+ * - lazy pager-backed collections — freezing them would break their own
+ *   internal hydration writes (and probing a lazy Array proxy with
+ *   `Object.isFrozen` must not touch its traps).
+ *
+ * Registry membership OR `Object.isFrozen` together define frozen-ness; use
+ * {@link isFrozenValue} rather than either primitive directly.
+ */
+const frozenValues = new WeakSet();
+/**
+ * Brands a value as frozen in the registry.
+ *
+ * Used by the frozen decode paths for values `Object.freeze` cannot brand
+ * (typed arrays, lazy pager-backed collections). Non-objects pass through
+ * untouched.
+ *
+ * @param value - the value to brand
+ * @returns the same value
+ * @internal
+ */
+export function markFrozen(value) {
+    if (typeof value === "object" && value !== null) {
+        frozenValues.add(value);
+    }
+    return value;
+}
+/**
+ * Tests whether a value is a frozen East value.
+ *
+ * A value is frozen when a frozen decode/parse constructed it — either
+ * branded with `Object.freeze` or recorded in the frozen registry (typed
+ * arrays and lazy pager-backed collections, which cannot be `Object.freeze`d).
+ * Host code may also `Object.freeze` a container itself; such a container is
+ * treated as frozen too, since it is equally immutable.
+ *
+ * Frozen `Array`/`Set`/`Dict`/`Vector`/`Matrix` values are value types:
+ * `Is` compares two frozen operands by deep value equality (the `Blob`
+ * precedent), and every mutating builtin throws.
+ *
+ * @param value - the value to test
+ * @returns `true` when the value is frozen
+ *
+ * @example
+ * ```ts
+ * const decoded = decodeBeast2For(ArrayType(IntegerType), { frozen: true })(blob);
+ * isFrozenValue(decoded);  // true
+ * isFrozenValue([1n]);     // false
+ * ```
+ */
+export function isFrozenValue(value) {
+    return typeof value === "object" && value !== null && (frozenValues.has(value) || Object.isFrozen(value));
+}
+//# sourceMappingURL=frozen.js.map

package/dist/src/frozen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frozen.js","sourceRoot":"","sources":["../../src/frozen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,YAAY,GAAG,IAAI,OAAO,EAAU,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5G,CAAC"}

package/dist/src/fuzz.d.ts

@@ -6,6 +6,15 @@
  */
 import { type EastType, type ValueTypeOf } from "./types.js";
 import { type EastTypeValue } from "./type_of_type.js";
+/**
+ * Reseeds the fuzz generator's deterministic random stream.
+ *
+ * Call at the start of a generation run so the produced types and values are
+ * reproducible regardless of what consumed the stream before.
+ *
+ * @param seed - the stream seed; equal seeds reproduce equal output
+ */
+export declare function seedFuzz(seed: number): void;
 /**
  * Generates a random East type for fuzz testing.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"fuzz.d.ts","sourceRoot":"","sources":["../../src/fuzz.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAmBjB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAiBxE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,KAAK,GAAE,MAAU,EACjB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,QAAQ,CAkEV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAmD9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAqB7C;AA+TD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,CAAC;AAC/D,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC;AAuBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,OAAO,GAAE,MAAY,EACrB,SAAS,GAAE,MAAW,EACtB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,OAAO,CAAC,OAAO,CAAC,CA4DlB"}
+{"version":3,"file":"fuzz.d.ts","sourceRoot":"","sources":["../../src/fuzz.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAmBjB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAiBxE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE3C;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,KAAK,GAAE,MAAU,EACjB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,QAAQ,CAkEV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAmD9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAqB7C;AA+TD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,CAAC;AAC/D,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC;AAuBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,OAAO,GAAE,MAAY,EACrB,SAAS,GAAE,MAAW,EACtB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,OAAO,CAAC,OAAO,CAAC,CA4DlB"}

package/dist/src/fuzz.js

@@ -14,11 +14,34 @@ import { printType } from "./types.js";
 import { printFor } from "./serialization/east.js";
 import { toEastTypeValue } from "./type_of_type.js";
 import { ref } from "./containers/ref.js";
+/** Deterministic PRNG state (mulberry32). The fuzz output is a cross-runtime
+ * REPLAY corpus: east-c and east-py compliance and the eager-replay pins all
+ * key on the generated suite names, so generation must reproduce byte-for-byte
+ * across exports. Reseed with {@link seedFuzz}; mint a fresh corpus by bumping
+ * the seed deliberately, never by reverting to `Math.random`. */
+let fuzzState = 0xea57 | 0;
+function random() {
+    fuzzState = (fuzzState + 0x6d2b79f5) | 0;
+    let t = Math.imul(fuzzState ^ (fuzzState >>> 15), 1 | fuzzState);
+    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+}
+/**
+ * Reseeds the fuzz generator's deterministic random stream.
+ *
+ * Call at the start of a generation run so the produced types and values are
+ * reproducible regardless of what consumed the stream before.
+ *
+ * @param seed - the stream seed; equal seeds reproduce equal output
+ */
+export function seedFuzz(seed) {
+    fuzzState = seed | 0;
+}
 /**
  * Generates a random primitive East type.
  */
 function randomPrimitiveType() {
-    const r = Math.random() * 7;
+    const r = random() * 7;
     if (r < 1)
         return NullType;
     if (r < 2)
@@ -56,7 +79,7 @@ export function randomType(depth = 0, options = {}) {
     const maxDepth = 3;
     // Higher chance of primitives at deeper levels
     const primitiveWeight = depth >= maxDepth ? 0.9 : 0.5;
-    if (Math.random() < primitiveWeight) {
+    if (random() < primitiveWeight) {
         return randomPrimitiveType();
     }
     // Complex type - weights adjusted based on options
@@ -65,7 +88,7 @@ export function randomType(depth = 0, options = {}) {
         totalWeight += 1; // Recursive only at top level
     if (includeFunctions)
         totalWeight += 1;
-    const r = Math.random() * totalWeight;
+    const r = random() * totalWeight;
     if (r < 1) {
         // Array
         return ArrayType(randomType(depth + 1, { includeRecursive: false, includeFunctions: false }));
@@ -80,7 +103,7 @@ export function randomType(depth = 0, options = {}) {
     }
     else if (r < 4) {
         // Struct with 0-4 fields
-        const fieldCount = Math.floor(Math.random() * 5);
+        const fieldCount = Math.floor(random() * 5);
         const fields = {};
         for (let i = 0; i < fieldCount; i++) {
             fields[`field${i}`] = randomType(depth + 1, { includeRecursive: false, includeFunctions: false });
@@ -89,13 +112,13 @@ export function randomType(depth = 0, options = {}) {
     }
     else if (r < 5) {
         // Variant
-        if (Math.random() < 0.3) {
+        if (random() < 0.3) {
             // Option type (common variant pattern)
             return OptionType(randomType(depth + 1, { includeRecursive: false, includeFunctions: false }));
         }
         else {
             // Custom variant with 1-3 cases
-            const caseCount = 1 + Math.floor(Math.random() * 3);
+            const caseCount = 1 + Math.floor(random() * 3);
             const cases = {};
             for (let i = 0; i < caseCount; i++) {
                 cases[`case${i}`] = randomType(depth + 1, { includeRecursive: false, includeFunctions: false });
@@ -106,12 +129,12 @@ export function randomType(depth = 0, options = {}) {
     else if (r < 6) {
         // Vector with random numeric element type
         const elemTypes = [FloatType, IntegerType, BooleanType];
-        return VectorType(elemTypes[Math.floor(Math.random() * elemTypes.length)]);
+        return VectorType(elemTypes[Math.floor(random() * elemTypes.length)]);
     }
     else if (r < 7) {
         // Matrix with random numeric element type
         const elemTypes = [FloatType, IntegerType, BooleanType];
-        return MatrixType(elemTypes[Math.floor(Math.random() * elemTypes.length)]);
+        return MatrixType(elemTypes[Math.floor(random() * elemTypes.length)]);
     }
     else if (r < 8 && includeRecursive && depth === 0) {
         // Recursive type - only at top level to avoid nested recursion complexity
@@ -137,7 +160,7 @@ export function randomType(depth = 0, options = {}) {
  */
 export function randomRecursiveType() {
     const innerType = randomPrimitiveType();
-    const pattern = Math.floor(Math.random() * 5);
+    const pattern = Math.floor(random() * 5);
     switch (pattern) {
         case 0:
             // Linked list: rec t. <nil: Null, cons: (head: T, tail: t)>
@@ -182,17 +205,17 @@ export function randomRecursiveType() {
  * Output types are also kept simple to avoid excessive nesting.
  */
 export function randomFunctionType() {
-    const argCount = Math.floor(Math.random() * 4);
+    const argCount = Math.floor(random() * 4);
     const args = [];
     for (let i = 0; i < argCount; i++) {
         // Use simple types for arguments to keep things manageable
-        const argType = Math.random() < 0.7
+        const argType = random() < 0.7
             ? randomPrimitiveType()
             : ArrayType(randomPrimitiveType());
         args.push(argType);
     }
     // Output type - also keep simple
-    const outputType = Math.random() < 0.7
+    const outputType = random() < 0.7
         ? randomPrimitiveType()
         : StructType({
             result: randomPrimitiveType(),
@@ -244,14 +267,14 @@ function buildValueGenerator(type, ctx) {
         return () => null;
     }
     else if (type.type === "Boolean") {
-        return () => Math.random() < 0.5;
+        return () => random() < 0.5;
     }
     else if (type.type === "Integer") {
-        return () => BigInt(Math.floor(Math.random() * 200) - 100);
+        return () => BigInt(Math.floor(random() * 200) - 100);
     }
     else if (type.type === "Float") {
         return () => {
-            const r = Math.random();
+            const r = random();
             if (r < 0.05)
                 return NaN;
             if (r < 0.10)
@@ -262,30 +285,30 @@ function buildValueGenerator(type, ctx) {
                 return 0.0;
             if (r < 0.25)
                 return -0.0;
-            return Math.random() * 200 - 100;
+            return random() * 200 - 100;
         };
     }
     else if (type.type === "String") {
         return () => {
-            const length = Math.floor(Math.random() * 20);
+            const length = Math.floor(random() * 20);
             if (length === 0)
                 return "";
-            return Math.random().toString(36).substring(2, 2 + length);
+            return random().toString(36).substring(2, 2 + length);
         };
     }
     else if (type.type === "DateTime") {
         return () => {
             const year2025 = new Date("2025-01-01T00:00:00.000Z").valueOf();
             const oneYear = 1000 * 60 * 60 * 24 * 365;
-            return new Date(year2025 + Math.floor(Math.random() * oneYear));
+            return new Date(year2025 + Math.floor(random() * oneYear));
         };
     }
     else if (type.type === "Blob") {
         return () => {
-            const length = Math.floor(Math.random() * 100);
+            const length = Math.floor(random() * 100);
             const arr = new Uint8Array(length);
             for (let i = 0; i < length; i++) {
-                arr[i] = Math.floor(Math.random() * 256);
+                arr[i] = Math.floor(random() * 256);
             }
             return arr;
         };
@@ -301,7 +324,7 @@ function buildValueGenerator(type, ctx) {
         let itemGen;
         const ret = (depth) => {
             const maxLen = depth >= ctx.maxDepth ? 0 : Math.max(1, 5 - depth);
-            const length = Math.floor(Math.random() * (maxLen + 1));
+            const length = Math.floor(random() * (maxLen + 1));
             return Array.from({ length }, () => itemGen(depth));
         };
         itemGen = buildValueGenerator(type.value, ctx);
@@ -316,7 +339,7 @@ function buildValueGenerator(type, ctx) {
         let itemGen;
         const ret = (depth) => {
             const maxLen = depth >= ctx.maxDepth ? 0 : 5;
-            const length = Math.floor(Math.random() * (maxLen + 1));
+            const length = Math.floor(random() * (maxLen + 1));
             const set = new SortedSet(undefined, keyComparer);
             for (let i = 0; i < length; i++) {
                 set.add(itemGen(depth));
@@ -332,7 +355,7 @@ function buildValueGenerator(type, ctx) {
         let valueGen;
         const ret = (depth) => {
             const maxLen = depth >= ctx.maxDepth ? 0 : 5;
-            const length = Math.floor(Math.random() * (maxLen + 1));
+            const length = Math.floor(random() * (maxLen + 1));
             const dict = new SortedMap(undefined, keyComparer);
             for (let i = 0; i < length; i++) {
                 dict.set(keyGen(depth), valueGen(depth));
@@ -365,19 +388,19 @@ function buildValueGenerator(type, ctx) {
             const nonTerminalCases = caseInfos.filter((c) => !c.isTerminal);
             let chosen;
             if (depth >= ctx.maxDepth && terminalCases.length > 0) {
-                chosen = terminalCases[Math.floor(Math.random() * terminalCases.length)];
+                chosen = terminalCases[Math.floor(random() * terminalCases.length)];
             }
             else if (terminalCases.length > 0 && nonTerminalCases.length > 0) {
                 const terminalProb = Math.min(0.3 + depth * 0.2, 0.9);
-                if (Math.random() < terminalProb) {
-                    chosen = terminalCases[Math.floor(Math.random() * terminalCases.length)];
+                if (random() < terminalProb) {
+                    chosen = terminalCases[Math.floor(random() * terminalCases.length)];
                 }
                 else {
-                    chosen = nonTerminalCases[Math.floor(Math.random() * nonTerminalCases.length)];
+                    chosen = nonTerminalCases[Math.floor(random() * nonTerminalCases.length)];
                 }
             }
             else {
-                chosen = caseInfos[Math.floor(Math.random() * caseInfos.length)];
+                chosen = caseInfos[Math.floor(random() * caseInfos.length)];
             }
             return variant(chosen.name, chosen.gen(depth));
         };
@@ -425,11 +448,11 @@ function buildValueGenerator(type, ctx) {
     else if (type.type === "Vector") {
         const elemType = type.value;
         return () => {
-            const length = Math.floor(Math.random() * 10);
+            const length = Math.floor(random() * 10);
             if (elemType.type === "Float") {
                 const arr = new Float64Array(length);
                 for (let i = 0; i < length; i++) {
-                    const r = Math.random();
+                    const r = random();
                     if (r < 0.05)
                         arr[i] = NaN;
                     else if (r < 0.10)
@@ -437,20 +460,20 @@ function buildValueGenerator(type, ctx) {
                     else if (r < 0.15)
                         arr[i] = -Infinity;
                     else
-                        arr[i] = Math.random() * 200 - 100;
+                        arr[i] = random() * 200 - 100;
                 }
                 return arr;
             }
             else if (elemType.type === "Integer") {
                 const arr = new BigInt64Array(length);
                 for (let i = 0; i < length; i++)
-                    arr[i] = BigInt(Math.floor(Math.random() * 200) - 100);
+                    arr[i] = BigInt(Math.floor(random() * 200) - 100);
                 return arr;
             }
             else {
                 const arr = new Uint8ClampedArray(length);
                 for (let i = 0; i < length; i++)
-                    arr[i] = Math.random() < 0.5 ? 1 : 0;
+                    arr[i] = random() < 0.5 ? 1 : 0;
                 return arr;
             }
         };
@@ -458,13 +481,13 @@ function buildValueGenerator(type, ctx) {
     else if (type.type === "Matrix") {
         const elemType = type.value;
         return () => {
-            const rows = Math.floor(Math.random() * 5);
-            const cols = rows === 0 ? 0 : Math.floor(Math.random() * 5);
+            const rows = Math.floor(random() * 5);
+            const cols = rows === 0 ? 0 : Math.floor(random() * 5);
             const totalLen = rows * cols;
             if (elemType.type === "Float") {
                 const data = new Float64Array(totalLen);
                 for (let i = 0; i < totalLen; i++) {
-                    const r = Math.random();
+                    const r = random();
                     if (r < 0.05)
                         data[i] = NaN;
                     else if (r < 0.10)
@@ -472,20 +495,20 @@ function buildValueGenerator(type, ctx) {
                     else if (r < 0.15)
                         data[i] = -Infinity;
                     else
-                        data[i] = Math.random() * 200 - 100;
+                        data[i] = random() * 200 - 100;
                 }
                 return matrix(data, rows, cols);
             }
             else if (elemType.type === "Integer") {
                 const data = new BigInt64Array(totalLen);
                 for (let i = 0; i < totalLen; i++)
-                    data[i] = BigInt(Math.floor(Math.random() * 200) - 100);
+                    data[i] = BigInt(Math.floor(random() * 200) - 100);
                 return matrix(data, rows, cols);
             }
             else {
                 const data = new Uint8ClampedArray(totalLen);
                 for (let i = 0; i < totalLen; i++)
-                    data[i] = Math.random() < 0.5 ? 1 : 0;
+                    data[i] = random() < 0.5 ? 1 : 0;
                 return matrix(data, rows, cols);
             }
         };