@elaraai/east-web-std 1.0.85

package/dist/src/random.js.map

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

package/dist/src/test.d.ts

@@ -0,0 +1,86 @@
+import type { PlatformFunction } from "@elaraai/east/internal";
+/**
+ * A failed East test assertion: what `testFail` throws.
+ *
+ * It is not an `EastError`, so an East `try`/`catch` does not catch it — as it
+ * does not catch the `node:assert` error east-node-std throws — and an
+ * assertion that fails inside one still fails the test.
+ */
+export declare class TestFailure extends Error {
+    /**
+     * @param message - What failed
+     * @param options - The error that caused it, if any
+     */
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Runs the suites and tests an East test program declares.
+ *
+ * The program calls `describe` and `test` (as east-node-std's `describeEast`
+ * builds them, and as east-node-std's exported compliance suite does), and
+ * the host decides how each runs and where its result goes: in place
+ * (the default), through `node:test`, or into a browser test page's report.
+ *
+ * @remarks
+ * A test's body rejects when an assertion in it fails, with a
+ * {@link TestFailure}, or when the East code in it throws.
+ */
+export interface TestHost {
+    /**
+     * Runs a suite: `body` declares its tests, calling {@link TestHost.test}.
+     *
+     * @param name - The suite's name
+     * @param body - The suite's body
+     */
+    describe(name: string, body: () => Promise<void>): Promise<void>;
+    /**
+     * Runs one test.
+     *
+     * @param name - The test's name
+     * @param body - The test's body, which rejects when the test fails
+     */
+    test(name: string, body: () => Promise<void>): Promise<void>;
+}
+/**
+ * Creates the test platform functions — `testPass`, `testFail`, `test` and
+ * `describe` — over a host that runs them.
+ *
+ * These are the functions east-node-std's `describeEast` and `Assert` build
+ * East tests from, and so the functions its exported compliance suite calls.
+ *
+ * @param host - Runs the suites and tests; by default, in place (see
+ *   {@link TestImpl})
+ * @returns The test platform functions
+ *
+ * @example
+ * ```ts
+ * import { createWebPlatform, type TestHost } from "@elaraai/east-web-std";
+ *
+ * const results: string[] = [];
+ * const recording: TestHost = {
+ *     describe: async (_name, body) => { await body(); },
+ *     test: async (name, body) => {
+ *         try { await body(); results.push(`pass ${name}`); }
+ *         catch (error) { results.push(`fail ${name}`); }
+ *     },
+ * };
+ * const platform = createWebPlatform({ test: recording });
+ * ```
+ */
+export declare function createTestImpl(host?: TestHost): PlatformFunction[];
+/**
+ * The test platform functions, running each suite and test in place.
+ *
+ * Every test runs; when the outermost suite ends, it fails with a
+ * {@link TestFailure} listing every test that failed, so a test program
+ * fails when a test did. Give `createWebPlatform` (or
+ * {@link createTestImpl}) a {@link TestHost} to report tests another way.
+ *
+ * @remarks
+ * Its failures are kept for the suite that is running, so run one test
+ * program at a time over it; each {@link createTestImpl} keeps its own.
+ */
+export declare const TestImpl: PlatformFunction[];
+//# 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":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AA0C/D;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI7D;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAsDD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,QAA4B,GAAG,gBAAgB,EAAE,CAcrF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,EAAE,gBAAgB,EAAqB,CAAC"}

package/dist/src/test.js

@@ -0,0 +1,160 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { AsyncFunctionType, East, NullType, StringType } from "@elaraai/east";
+/**
+ * Platform function that indicates a test assertion passed.
+ *
+ * This is used by East test code to signal successful assertions. It does
+ * nothing: the test continues.
+ */
+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. It throws a
+ * {@link TestFailure}, which fails the test.
+ *
+ * @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. The host's
+ * {@link TestHost.test} runs it.
+ *
+ * @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. The host's
+ * {@link TestHost.describe} runs it.
+ *
+ * @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);
+/**
+ * A failed East test assertion: what `testFail` throws.
+ *
+ * It is not an `EastError`, so an East `try`/`catch` does not catch it — as it
+ * does not catch the `node:assert` error east-node-std throws — and an
+ * assertion that fails inside one still fails the test.
+ */
+export class TestFailure extends Error {
+    /**
+     * @param message - What failed
+     * @param options - The error that caused it, if any
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "TestFailure";
+    }
+}
+/** The message of whatever a failing body threw. */
+function messageOf(error) {
+    return error instanceof Error ? error.message : `${error}`;
+}
+/**
+ * A host that runs each suite and test where the program declares it.
+ *
+ * Every test runs, whether or not the ones before it passed. When the
+ * outermost suite ends, it fails with a {@link TestFailure} that lists every
+ * failure in it, so the program fails when a test did. A test declared
+ * outside any suite fails the program at once.
+ */
+function inPlaceTestHost() {
+    const suites = [];
+    const failures = [];
+    return {
+        async describe(name, body) {
+            suites.push(name);
+            try {
+                await body();
+            }
+            catch (error) {
+                // The suite failed outside its tests
+                failures.push({ path: [...suites], error });
+            }
+            finally {
+                suites.pop();
+            }
+            if (suites.length === 0 && failures.length > 0) {
+                const failed = failures.splice(0);
+                const lines = failed.map(({ path, error }) => `  ${path.join(" > ")}: ${messageOf(error)}`);
+                throw new TestFailure(`East tests failed:\n${lines.join("\n")}`, { cause: failed[0].error });
+            }
+        },
+        async test(name, body) {
+            try {
+                await body();
+            }
+            catch (error) {
+                if (suites.length === 0) {
+                    throw new TestFailure(`${name}: ${messageOf(error)}`, { cause: error });
+                }
+                failures.push({ path: [...suites, name], error });
+            }
+        },
+    };
+}
+/**
+ * Creates the test platform functions — `testPass`, `testFail`, `test` and
+ * `describe` — over a host that runs them.
+ *
+ * These are the functions east-node-std's `describeEast` and `Assert` build
+ * East tests from, and so the functions its exported compliance suite calls.
+ *
+ * @param host - Runs the suites and tests; by default, in place (see
+ *   {@link TestImpl})
+ * @returns The test platform functions
+ *
+ * @example
+ * ```ts
+ * import { createWebPlatform, type TestHost } from "@elaraai/east-web-std";
+ *
+ * const results: string[] = [];
+ * const recording: TestHost = {
+ *     describe: async (_name, body) => { await body(); },
+ *     test: async (name, body) => {
+ *         try { await body(); results.push(`pass ${name}`); }
+ *         catch (error) { results.push(`fail ${name}`); }
+ *     },
+ * };
+ * const platform = createWebPlatform({ test: recording });
+ * ```
+ */
+export function createTestImpl(host = inPlaceTestHost()) {
+    return [
+        testPass.implement(() => { }), // Assertion passed - do nothing (test continues)
+        testFail.implement((message) => {
+            // Assertion failed - throw to fail the test
+            throw new TestFailure(message);
+        }),
+        test.implement(async (name, body) => {
+            await host.test(name, async () => { await body(); });
+        }),
+        describe.implement(async (name, body) => {
+            await host.describe(name, async () => { await body(); });
+        }),
+    ];
+}
+/**
+ * The test platform functions, running each suite and test in place.
+ *
+ * Every test runs; when the outermost suite ends, it fails with a
+ * {@link TestFailure} listing every test that failed, so a test program
+ * fails when a test did. Give `createWebPlatform` (or
+ * {@link createTestImpl}) a {@link TestHost} to report tests another way.
+ *
+ * @remarks
+ * Its failures are kept for the suite that is running, so run one test
+ * program at a time over it; each {@link createTestImpl} keeps its own.
+ */
+export const TestImpl = createTestImpl();
+//# 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/src/time.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { IntegerType, NullType, DateTimeType, StringType } from "@elaraai/east";
+import type { PlatformFunction } from "@elaraai/east/internal";
+/**
+ * Gets the current Unix timestamp in milliseconds.
+ *
+ * Returns the number of milliseconds elapsed since the Unix epoch
+ * (January 1, 1970 00:00:00 UTC). This is useful for timestamping events,
+ * measuring durations, and working with date/time data.
+ *
+ * This is a platform function for the East language, enabling time access
+ * in East programs running in a browser.
+ *
+ * @returns The current time as milliseconds since epoch (January 1, 1970 UTC)
+ *
+ * @example
+ * ```ts
+ * const getTimestamp = East.function([], IntegerType, $ => {
+ *     return Time.now();
+ *     // Returns: 1735689600000n (example)
+ * });
+ * ```
+ */
+export declare const time_now: import("@elaraai/east").PlatformDefinition<[], IntegerType>;
+/**
+ * Sleeps for the specified number of milliseconds.
+ *
+ * Pauses execution asynchronously for the given duration. This is a non-blocking
+ * sleep that allows other operations to run during the wait period. Useful for
+ * rate limiting, delays, and timing control.
+ *
+ * This is a platform function for the East language, enabling timed delays
+ * in East programs running in a browser.
+ *
+ * @param ms - The number of milliseconds to sleep (must be non-negative)
+ * @returns Null after sleeping completes
+ *
+ * @throws {EastError} When sleep fails
+ *
+ * @example
+ * ```ts
+ * const delayedTask = East.function([], NullType, $ => {
+ *     $(Console.log("Starting..."));
+ *     $(Time.sleep(1000n));  // Wait 1 second
+ *     $(Console.log("Done!"));
+ * });
+ * ```
+ *
+ * @remarks
+ * A browser may slow the timers of a page in a background tab, so a sleep
+ * there can last longer than asked.
+ */
+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>;
+/**
+ * Browser implementation of time platform functions, whose sleeps a host may
+ * stop.
+ *
+ * @param signal - Stops the program's sleeps, for a host that stops a program
+ *   without ending its thread: once it aborts, a sleep under way fails at
+ *   once, its timer cleared, and a later one fails as it starts. Unset, a
+ *   sleep ends once its time has passed
+ * @returns The platform functions, to pass to {@link East.compileAsync}
+ *
+ * @example
+ * ```ts
+ * const stop = new AbortController();
+ * const compiled = await East.compileAsync(delayedTask.toIR(), createTimeImpl(stop.signal));
+ * const running = compiled();
+ * stop.abort();  // the sleep under way fails at once: "Failed to sleep: the program was stopped"
+ * ```
+ */
+export declare function createTimeImpl(signal?: AbortSignal): PlatformFunction[];
+/**
+ * Browser implementation of time platform functions.
+ *
+ * Pass this array to {@link East.compileAsync} to enable time operations.
+ */
+declare const TimeImpl: PlatformFunction[];
+/**
+ * Grouped time platform functions.
+ *
+ * Provides time, sleep, and timezone operations for East programs.
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { Time } from "@elaraai/east-web-std";
+ *
+ * const timedTask = East.function([], NullType, $ => {
+ *     const start = $.let(Time.now());
+ *     $(Time.sleep(1000n)); // Sleep for 1 second
+ *     const end = $.let(Time.now());
+ * });
+ *
+ * const compiled = await East.compileAsync(timedTask.toIR(), Time.Implementation);
+ * await compiled();
+ * ```
+ */
+export declare const Time: {
+    /**
+     * Gets the current Unix timestamp in milliseconds.
+     *
+     * Returns the number of milliseconds elapsed since the Unix epoch
+     * (January 1, 1970 00:00:00 UTC). Useful for timestamping and measuring durations.
+     *
+     * @returns The current time as milliseconds since epoch
+     *
+     * @example
+     * ```ts
+     * const getTimestamp = East.function([], IntegerType, $ => {
+     *     return Time.now();
+     * });
+     *
+     * const compiled = await East.compileAsync(getTimestamp.toIR(), Time.Implementation);
+     * await compiled();  // Returns: 1735689600000n (example timestamp)
+     * ```
+     */
+    readonly now: import("@elaraai/east").PlatformDefinition<[], IntegerType>;
+    /**
+     * Sleeps for the specified number of milliseconds.
+     *
+     * Pauses execution asynchronously for the given duration. Non-blocking sleep
+     * that allows other operations to run during the wait period.
+     *
+     * @param ms - The number of milliseconds to sleep (must be non-negative)
+     * @returns Null after sleeping completes
+     * @throws {EastError} When sleep fails
+     *
+     * @example
+     * ```ts
+     * const delayedTask = East.function([], NullType, $ => {
+     *     $(Console.log("Starting..."));
+     *     $(Time.sleep(1000n));
+     *     $(Console.log("Done!"));
+     * });
+     *
+     * const compiled = await East.compileAsync(delayedTask.toIR(), Time.Implementation);
+     * await compiled();  // Waits 1 second between log messages
+     * ```
+     */
+    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>;
+    /**
+     * Browser implementation of time platform functions.
+     *
+     * Pass this to {@link East.compileAsync} to enable time operations.
+     */
+    readonly Implementation: PlatformFunction[];
+};
+export { TimeImpl };
+//# sourceMappingURL=time.d.ts.map

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;AAqC/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,QAAQ,6DAA6C,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,UAAU,0EAA4D,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,wBAAwB,qFAIpC,CAAC;AA4BF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,gBAAgB,EAAE,CA2CvE;AAED;;;;GAIG;AACH,QAAA,MAAM,QAAQ,EAAE,gBAAgB,EAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,QAAQ,EAAE,CAAC"}