@elaraai/east-node-std 0.0.1-beta.9 → 1.0.1

package/dist/{test.d.ts → src/test.d.ts}

@@ -1,4 +1,4 @@
-import { Expr, NullType, StringType, type SubtypeExprOrValue } from "@elaraai/east";
+import { Expr, NullType, StringType, type SubtypeExprOrValue, type ExampleDef } from "@elaraai/east";
 import type { BlockBuilder, PlatformFunction, TypeSymbol } from "@elaraai/east/internal";
 /**
  * Creates a test platform that uses Node.js assertions.
@@ -169,5 +169,12 @@ export declare const Assert: {
      * @returns An East expression that unconditionally fails the test
      */
     fail(message: SubtypeExprOrValue<StringType>): import("@elaraai/east").NullExpr;
+    /**
+     * Runs all examples as tests, calling each with its inputs and asserting the result equals returns.
+     *
+     * @param test - The test function from describeEast's builder
+     * @param examples - A record of named ExampleDef exports (e.g. `import * as examples from "./array.examples.js"`)
+     */
+    examples(test: (name: string, body: ($: BlockBuilder<NullType>) => void) => void, examples: Record<string, ExampleDef>): void;
 };
 //# sourceMappingURL=test.d.ts.map

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

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

package/dist/src/test.js

@@ -0,0 +1,364 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import assert from "node:assert/strict";
+import util from "node:util";
+import { test as testNode, describe as describeNode } from "node:test";
+import { writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { AsyncFunctionType, East, Expr, get_location, IRType, NullType, printLocations, StringType, toJSONFor, ArrayType, IntegerType, StructType } from "@elaraai/east";
+const { str } = East;
+// Force node test to show full stack traces for easier debugging
+Error.stackTraceLimit = Infinity;
+// Force node to print full objects in console.log output
+util.inspect.defaultOptions.depth = null;
+/**
+ * Platform function that indicates a test assertion passed.
+ *
+ * This is used by East test code to signal successful assertions.
+ * When running in Node.js, this does nothing. Other platforms may log or track passes.
+ */
+const testPass = East.platform("testPass", [], NullType);
+/**
+ * Platform function that indicates a test assertion failed.
+ *
+ * This is used by East test code to signal failed assertions.
+ * When running in Node.js, this throws an assertion error.
+ *
+ * @param message - The error message describing the assertion failure
+ */
+const testFail = East.platform("testFail", [StringType], NullType);
+/**
+ * Platform function that defines a single test case.
+ *
+ * This is used by East test code to define individual tests.
+ * When running in Node.js, this runs the test using Node's test runner.
+ *
+ * @param name - The name of the test
+ * @param body - The test body function
+ */
+const test = East.asyncPlatform("test", [StringType, AsyncFunctionType([], NullType)], NullType);
+/**
+ * Platform function that defines a test suite.
+ *
+ * This is used by East test code to group related tests.
+ * When running in Node.js, this runs the suite using Node's describe.
+ *
+ * @param name - The name of the test suite
+ * @param body - A function that calls test() to define tests
+ */
+const describe = East.asyncPlatform("describe", [StringType, AsyncFunctionType([], NullType)], NullType);
+/**
+ * Creates a test platform that uses Node.js assertions.
+ *
+ * @returns A platform object with `testPass`, `testFail`, `test`, and `describe` functions
+ */
+export const TestImpl = [
+    testPass.implement(() => { }), // Assertion passed - do nothing (test continues)
+    testFail.implement((message) => {
+        // Assertion failed - throw to fail the test
+        assert.fail(message);
+    }),
+    test.implement((name, body) => testNode(name, async () => { await body(); })),
+    describe.implement((name, body) => describeNode(name, async () => { await body(); })),
+];
+/* Type-directed JSON serialization for the test IR export format:
+ * StructType({ ir: IRType, source_map: StructType({ stacks: Array(Array(Struct({column,filename,line}))) }) })
+ * Note: struct fields are sorted alphabetically in East's structural type system. */
+const LocationType = StructType({ column: IntegerType, filename: StringType, line: IntegerType });
+const SourceMapType = StructType({ stacks: ArrayType(ArrayType(LocationType)) });
+const ExportWrapperType = StructType({ ir: IRType, source_map: SourceMapType });
+const exportToJSON = toJSONFor(ExportWrapperType);
+/**
+ * Defines and runs an East test suite using platform functions.
+ *
+ * This creates a single East function that calls `describe` and `test` platform functions.
+ * The entire suite can be exported as IR and run on any East implementation that provides
+ * the test platform (testPass, testFail, test, describe).
+ *
+ * When the `EXPORT_TEST_IR` environment variable is set to a directory path, the IR for
+ * each test suite is exported to `<path>/<suite_name>.json`.
+ *
+ * @param suiteName - The name of the test suite
+ * @param builder - A function that receives a `test` function for defining tests
+ *
+ * @example
+ * ```ts
+ * describeEast("Array tests", (test) => {
+ *   test("addition", $ => {
+ *     $(assertEast.equal(East.value(1n).add(1n), 2n));
+ *   });
+ *   test("subtraction", $ => {
+ *     $(assertEast.equal(East.value(2n).subtract(1n), 1n));
+ *   });
+ * });
+ * ```
+ *
+ * @example
+ * ```bash
+ * # Export test IR to a directory
+ * EXPORT_TEST_IR=./test-ir npm test
+ * ```
+ */
+export function describeEast(suiteName, builder, options) {
+    const tests = [];
+    // Collect all test names and bodies
+    builder((name, body) => {
+        tests.push({ name, body });
+    });
+    // Create a single East function that uses describe/test platform functions
+    const suiteFunction = East.asyncFunction([], NullType, $ => {
+        $(describe.call($, suiteName, East.asyncFunction([], NullType, $ => {
+            // beforeAll hook
+            if (options?.beforeAll) {
+                options.beforeAll($);
+            }
+            for (const { name, body } of tests) {
+                $(test.call($, name, East.asyncFunction([], NullType, $test => {
+                    // beforeEach hook (inside test body)
+                    if (options?.beforeEach) {
+                        options.beforeEach($test);
+                    }
+                    // Wrap test body in try-finally so afterEach runs even on failure
+                    if (options?.afterEach) {
+                        $test.try(body)
+                            .catch(($catch, message) => {
+                            // Re-throw the error after finally runs
+                            $catch.error(message);
+                        })
+                            .finally(options.afterEach);
+                    }
+                    else {
+                        body($test);
+                    }
+                })));
+            }
+            // afterAll hook
+            if (options?.afterAll) {
+                options.afterAll($);
+            }
+        })));
+    });
+    // Auto-export test IR if EXPORT_TEST_IR environment variable is set to a path
+    if (process.env.EXPORT_TEST_IR) {
+        const outputDir = process.env.EXPORT_TEST_IR;
+        try {
+            mkdirSync(outputDir, { recursive: true });
+            const ir = suiteFunction.toIR();
+            const stacks = (ir.source_map?.entries() ?? [[]]).map(stack => stack.map(frame => ({ column: frame.column, filename: frame.filename, line: frame.line })));
+            const wrapperValue = { ir: ir.ir, source_map: { stacks } };
+            const wrapperJSON = exportToJSON(wrapperValue);
+            const filename = join(outputDir, `${suiteName.replace(/[^a-zA-Z0-9]/g, '_')}.json`);
+            writeFileSync(filename, JSON.stringify(wrapperJSON, null, 2));
+            console.log(`✓ Exported test IR: ${filename}`);
+        }
+        catch (err) {
+            console.error(`✗ Failed to export test IR for "${suiteName}":`, err);
+        }
+    }
+    if (options?.exportOnly !== true) {
+        // Run the test suite using the Node.js platform implementation
+        const compiled = suiteFunction.toIR().compile([...(options?.platformFns ?? [])]);
+        return compiled();
+    }
+}
+/**
+ * East assertion functions that match Node.js assert API naming.
+ *
+ * These functions generate East expressions that perform runtime assertions
+ * using platform functions, enabling testing of East code.
+ */
+export const Assert = {
+    /**
+     * Asserts that two values are the same reference (meaning if one is mutated, the other reflects the change - and they are always equal).
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The expected value to compare against
+     * @returns An East expression that performs the equality check
+     */
+    is(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.is(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to be ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that two values are equal.
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The expected value to compare against
+     * @returns An East expression that performs the equality check
+     */
+    equal(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.equal(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to equal ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that two values are not equal.
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The value that should not be equal
+     * @returns An East expression that performs the inequality check
+     */
+    notEqual(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.notEqual(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to not equal ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that actual is less than expected.
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The value that actual should be less than
+     * @returns An East expression that performs the less-than check
+     */
+    less(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.less(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to be less than ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that actual is less than or equal to expected.
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The value that actual should be less than or equal to
+     * @returns An East expression that performs the less-than-or-equal check
+     */
+    lessEqual(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.lessEqual(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to be less than or equal to ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that actual is greater than expected.
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The value that actual should be greater than
+     * @returns An East expression that performs the greater-than check
+     */
+    greater(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.greater(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to be greater than ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that actual is greater than or equal to expected.
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param expected - The value that actual should be greater than or equal to
+     * @returns An East expression that performs the greater-than-or-equal check
+     */
+    greaterEqual(actual, expected) {
+        const location = get_location();
+        const expected_expr = Expr.from(expected, Expr.type(actual));
+        return Expr.tryCatch(Expr.block($ => {
+            const act = $.let(actual);
+            const exp = $.let(expected_expr);
+            return East.greaterEqual(act, exp).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${act} to be greater than or equal to ${exp} (${printLocations(location)})`));
+        }), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that actual is between min and max (inclusive).
+     *
+     * @typeParam E - The type of the actual expression
+     * @param actual - The actual value to test
+     * @param min - The minimum value (inclusive)
+     * @param max - The maximum value (inclusive)
+     * @returns An East expression that performs the range check
+     */
+    between(actual, min, max) {
+        const location = get_location();
+        const min_expr = Expr.from(min, Expr.type(actual));
+        const max_expr = Expr.from(max, Expr.type(actual));
+        return Expr.tryCatch(East.greaterEqual(actual, min_expr).ifElse(_$ => East.lessEqual(actual, max_expr).ifElse(_$ => testPass(), _$ => testFail(str `Expected ${actual} to be less than or equal to ${max_expr} (${printLocations(location)})`)), _$ => testFail(str `Expected ${actual} to be greater than or equal to ${min_expr}`)), (_$, message, stack) => testFail(East.String.printError(message, stack)));
+    },
+    /**
+     * Asserts that an expression throws an error.
+     *
+     * @param fn - The expression that should throw an error when evaluated
+     * @param pattern - Optional regex pattern to match against the error message
+     * @returns An East expression that verifies an error is thrown
+     */
+    throws(fn, pattern) {
+        const location = get_location();
+        return Expr.tryCatch(Expr.block($ => {
+            const result = $.let(fn);
+            $(testFail(str `Expected error, got ${result} (${printLocations(location)})`));
+            return null;
+        }), ($, message, stack) => {
+            if (pattern) {
+                // Validate error message matches the pattern
+                return message.contains(pattern).ifElse(_$ => testPass(), _$ => testFail(str `Expected error message to match ${East.value(pattern.source)}, but got: ${East.String.printError(message, stack)}`));
+            }
+            else {
+                // Just verify it threw
+                return testPass();
+            }
+        });
+    },
+    /**
+     * Fails a test with the given message.
+     *
+     * @param message
+     * @returns An East expression that unconditionally fails the test
+     */
+    fail(message) {
+        const location = get_location();
+        const message_expr = Expr.from(message, StringType);
+        return testFail(str `${message_expr} (${printLocations(location)})`);
+    },
+    /**
+     * Runs all examples as tests, calling each with its inputs and asserting the result equals returns.
+     *
+     * @param test - The test function from describeEast's builder
+     * @param examples - A record of named ExampleDef exports (e.g. `import * as examples from "./array.examples.js"`)
+     */
+    examples(test, examples) {
+        for (const ex of Object.values(examples)) {
+            if (ex.returns !== undefined) {
+                test(ex.description, $ => {
+                    const result = $.let(ex.fn(...ex.inputs));
+                    $(Assert.equal(result, ex.returns));
+                });
+            }
+            else {
+                test(ex.description, $ => {
+                    $.let(ex.fn(...ex.inputs));
+                });
+            }
+        }
+    },
+};
+//# sourceMappingURL=test.js.map

package/dist/src/test.js.map

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

package/dist/{time.d.ts → src/time.d.ts}

@@ -2,7 +2,7 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { IntegerType, NullType } from "@elaraai/east";
+import { IntegerType, NullType, DateTimeType, StringType } from "@elaraai/east";
 import type { PlatformFunction } from "@elaraai/east/internal";
 /**
  * Gets the current Unix timestamp in milliseconds.
@@ -50,6 +50,33 @@ export declare const time_now: import("@elaraai/east").PlatformDefinition<[], In
  * ```
  */
 export declare const time_sleep: import("@elaraai/east").AsyncPlatformDefinition<[IntegerType], NullType>;
+/**
+ * Gets the UTC offset in minutes for an IANA timezone at a given UTC datetime.
+ *
+ * Returns the number of minutes that the given timezone is ahead of (positive)
+ * or behind (negative) UTC at the specified instant. This accounts for DST
+ * transitions — the same timezone can return different offsets depending on
+ * the datetime.
+ *
+ * The timezone must be a valid IANA timezone name (e.g., "Australia/Sydney",
+ * "America/New_York", "Europe/London", "Asia/Tokyo"). See the IANA Time Zone
+ * Database for the full list of valid names.
+ *
+ * @param datetime - A UTC datetime to compute the offset for
+ * @param zone - An IANA timezone name (e.g., "Australia/Sydney")
+ * @returns UTC offset in minutes (e.g., 660 for Sydney in summer, 600 in winter)
+ *
+ * @throws {EastError} When the timezone name is not a valid IANA timezone
+ *
+ * @example
+ * ```ts
+ * const toSydneyTime = East.function([DateTimeType], DateTimeType, ($, dt) => {
+ *     const offset = $.let(Time.getTimezoneOffset(dt, "Australia/Sydney"));
+ *     $.return(dt.addMinutes(offset));
+ * });
+ * ```
+ */
+export declare const time_get_timezone_offset: import("@elaraai/east").PlatformDefinition<[DateTimeType, StringType], IntegerType>;
 /**
  * Node.js implementation of time platform functions.
  *
@@ -59,7 +86,7 @@ declare const TimeImpl: PlatformFunction[];
 /**
  * Grouped time platform functions.
  *
- * Provides time and sleep operations for East programs.
+ * Provides time, sleep, and timezone operations for East programs.
  *
  * @example
  * ```ts
@@ -119,6 +146,27 @@ export declare const Time: {
      * ```
      */
     readonly sleep: import("@elaraai/east").AsyncPlatformDefinition<[IntegerType], NullType>;
+    /**
+     * Gets the UTC offset in minutes for an IANA timezone at a given UTC datetime.
+     *
+     * Accounts for DST — the same timezone returns different offsets depending
+     * on the datetime. Use the result with `addMinutes` to convert a UTC datetime
+     * to local time.
+     *
+     * @param datetime - A UTC datetime
+     * @param zone - An IANA timezone name (e.g., "Australia/Sydney")
+     * @returns UTC offset in minutes
+     * @throws {EastError} When the timezone name is invalid
+     *
+     * @example
+     * ```ts
+     * const toSydneyTime = East.function([DateTimeType], DateTimeType, ($, dt) => {
+     *     const offset = $.let(Time.getTimezoneOffset(dt, "Australia/Sydney"));
+     *     $.return(dt.addMinutes(offset));
+     * });
+     * ```
+     */
+    readonly getTimezoneOffset: import("@elaraai/east").PlatformDefinition<[DateTimeType, StringType], IntegerType>;
     /**
      * Node.js implementation of time platform functions.
      *

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAoC/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,QAAQ,6DAA6C,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,0EAA4D,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,wBAAwB,qFAIpC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,QAAQ,EAAE,gBAAgB,EAyC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/{time.js → src/time.js}

@@ -2,8 +2,37 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { East, IntegerType, NullType } from "@elaraai/east";
+import { East, IntegerType, NullType, DateTimeType, StringType } from "@elaraai/east";
 import { EastError } from "@elaraai/east/internal";
+/**
+ * Computes the UTC offset in minutes for an IANA timezone at a given instant.
+ *
+ * Uses Intl.DateTimeFormat to format the datetime in both UTC and the target
+ * timezone, then computes the difference. This is reliable across all Node.js
+ * versions — it only depends on the date component formatting, not abbreviations.
+ */
+function computeUtcOffsetMinutes(datetime, zone) {
+    const formatParts = (tz) => {
+        const fmt = new Intl.DateTimeFormat("en-US", {
+            timeZone: tz,
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+            hour12: false,
+        });
+        const parts = fmt.formatToParts(datetime);
+        const get = (type) => parseInt(parts.find(p => p.type === type).value);
+        return { year: get("year"), month: get("month"), day: get("day"), hour: get("hour"), minute: get("minute"), second: get("second") };
+    };
+    const utc = formatParts("UTC");
+    const local = formatParts(zone);
+    const utcMs = Date.UTC(utc.year, utc.month - 1, utc.day, utc.hour, utc.minute, utc.second);
+    const localMs = Date.UTC(local.year, local.month - 1, local.day, local.hour, local.minute, local.second);
+    return (localMs - utcMs) / 60000;
+}
 /**
  * Gets the current Unix timestamp in milliseconds.
  *
@@ -50,6 +79,33 @@ export const time_now = East.platform("time_now", [], IntegerType);
  * ```
  */
 export const time_sleep = East.asyncPlatform("time_sleep", [IntegerType], NullType);
+/**
+ * Gets the UTC offset in minutes for an IANA timezone at a given UTC datetime.
+ *
+ * Returns the number of minutes that the given timezone is ahead of (positive)
+ * or behind (negative) UTC at the specified instant. This accounts for DST
+ * transitions — the same timezone can return different offsets depending on
+ * the datetime.
+ *
+ * The timezone must be a valid IANA timezone name (e.g., "Australia/Sydney",
+ * "America/New_York", "Europe/London", "Asia/Tokyo"). See the IANA Time Zone
+ * Database for the full list of valid names.
+ *
+ * @param datetime - A UTC datetime to compute the offset for
+ * @param zone - An IANA timezone name (e.g., "Australia/Sydney")
+ * @returns UTC offset in minutes (e.g., 660 for Sydney in summer, 600 in winter)
+ *
+ * @throws {EastError} When the timezone name is not a valid IANA timezone
+ *
+ * @example
+ * ```ts
+ * const toSydneyTime = East.function([DateTimeType], DateTimeType, ($, dt) => {
+ *     const offset = $.let(Time.getTimezoneOffset(dt, "Australia/Sydney"));
+ *     $.return(dt.addMinutes(offset));
+ * });
+ * ```
+ */
+export const time_get_timezone_offset = East.platform("time_get_timezone_offset", [DateTimeType, StringType], IntegerType);
 /**
  * Node.js implementation of time platform functions.
  *
@@ -62,7 +118,7 @@ const TimeImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to get current time: ${err.message}`, {
-                location: { filename: "time_now", line: 0n, column: 0n },
+                location: [{ filename: "time_now", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -73,7 +129,26 @@ const TimeImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to sleep: ${err.message}`, {
-                location: { filename: "time_sleep", line: 0n, column: 0n },
+                location: [{ filename: "time_sleep", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    time_get_timezone_offset.implement((datetime, zone) => {
+        try {
+            const offset = computeUtcOffsetMinutes(datetime, zone);
+            return BigInt(offset);
+        }
+        catch (err) {
+            if (err instanceof RangeError) {
+                throw new EastError(`Invalid IANA timezone: "${zone}". ` +
+                    `Use a valid IANA timezone name such as "Australia/Sydney", "America/New_York", or "Europe/London". ` +
+                    `See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the full list.`, { location: [{ filename: "time_get_timezone_offset", line: 0n, column: 0n }], cause: err });
+            }
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`Failed to get timezone offset for "${zone}": ${err.message}`, {
+                location: [{ filename: "time_get_timezone_offset", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -82,7 +157,7 @@ const TimeImpl = [
 /**
  * Grouped time platform functions.
  *
- * Provides time and sleep operations for East programs.
+ * Provides time, sleep, and timezone operations for East programs.
  *
  * @example
  * ```ts
@@ -142,6 +217,27 @@ export const Time = {
      * ```
      */
     sleep: time_sleep,
+    /**
+     * Gets the UTC offset in minutes for an IANA timezone at a given UTC datetime.
+     *
+     * Accounts for DST — the same timezone returns different offsets depending
+     * on the datetime. Use the result with `addMinutes` to convert a UTC datetime
+     * to local time.
+     *
+     * @param datetime - A UTC datetime
+     * @param zone - An IANA timezone name (e.g., "Australia/Sydney")
+     * @returns UTC offset in minutes
+     * @throws {EastError} When the timezone name is invalid
+     *
+     * @example
+     * ```ts
+     * const toSydneyTime = East.function([DateTimeType], DateTimeType, ($, dt) => {
+     *     const offset = $.let(Time.getTimezoneOffset(dt, "Australia/Sydney"));
+     *     $.return(dt.addMinutes(offset));
+     * });
+     * ```
+     */
+    getTimezoneOffset: time_get_timezone_offset,
     /**
      * Node.js implementation of time platform functions.
      *

package/dist/src/time.js.map

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