@tellegen/engine 0.4.1 → 0.4.3

package/README.md

@@ -50,6 +50,9 @@ Every solvable ingest payload includes `module_json`, a generation-2 PowerIO
 IR module. Pass that value to `createStudy`, `solveModule`, and geographic
 transforms. The engine does not expose a second network JSON boundary.
 
+Stored AC OPF instances retain `formulation: "acopf"` and their original
+`module_json`. They use the experimental worker below, not `createStudy`.
+
 `ingestJsonDrop(bytes)` classifies and parses JSON in one call. Its
 `IngestedJsonDrop` result is discriminated by `kind`: PowerIO modules have a
 `null` format; transmission and distribution results carry the selected
@@ -59,6 +62,36 @@ bare model JSON is now `unknown`; regenerate it as `pio-ir` from source data.
 Every API that accepts a byte buffer rejects inputs larger than
 `MAX_ENGINE_INPUT_BYTES` (128 MiB) before worker dispatch.
 
+## Experimental AC OPF
+
+The ordinary package contains no POUNCE WASI asset. A development host must
+explicitly build and serve it, then probe it before offering AC OPF:
+
+```ts
+import { probeAcOpfWorker, solveAcOpfModule } from "@tellegen/engine";
+
+const wasmUrl = "/experimental-acopf/tellegen_acopf_wasi.wasm";
+const lifetime = new AbortController();
+if (!(await probeAcOpfWorker(wasmUrl, undefined, lifetime.signal)))
+  throw new Error("AC OPF unavailable");
+const cancel = new AbortController();
+const result = await solveAcOpfModule(wasmUrl, moduleJson, cancel.signal);
+// Calling cancel.abort() during a solve terminates its dedicated worker.
+```
+
+`moduleJson` must hold a balanced network or canonical `AcOpfInstance`. Each
+call uses a fresh worker and solves the supplied base operating point. Edits,
+sensitivities, LMPs, retained Studies, and browser solution export are not
+supported. There is no server or main-thread fallback. A successful result is
+locally feasible, not a proof of global optimality.
+
+See the [development setup and release gates](../../docs/src/acopf-pounce-decision.md#experimental-browser-abi)
+before building or distributing the separate asset.
+
+Probe calls accept an optional third `AbortSignal` argument. Abort it when the
+owning view is disposed; a cancelled probe returns `false` and terminates its
+worker. Solve calls accept their cancellation signal as the third argument.
+
 ## Synthetic Grid Generation
 
 `createSynthSession(request, { osm?, places?, signal? })` generates a

package/dist/acopf-protocol.d.ts

@@ -0,0 +1,20 @@
+import type { SolveResponse } from "./generated/api-types.js";
+export type AcOpfWorkerRequest = {
+    type: "probe";
+    wasmUrl: string;
+} | {
+    type: "solve";
+    wasmUrl: string;
+    moduleJson: string;
+    requestJson: string;
+};
+export type AcOpfWorkerResponse = {
+    type: "ready";
+} | {
+    type: "result";
+    response: SolveResponse;
+} | {
+    type: "error";
+    message: string;
+};
+//# sourceMappingURL=acopf-protocol.d.ts.map

package/dist/acopf-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acopf-protocol.d.ts","sourceRoot":"","sources":["../src/acopf-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/acopf-protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acopf-protocol.js.map

package/dist/acopf-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acopf-protocol.js","sourceRoot":"","sources":["../src/acopf-protocol.ts"],"names":[],"mappings":""}

package/dist/acopf-wasi.d.ts

@@ -0,0 +1,29 @@
+/** Minimal WASI Preview 1 host for the compute-only AC OPF reactor. */
+export declare function createAcOpfWasi(onOutput: (text: string) => void): {
+    imports: {
+        wasi_snapshot_preview1: {
+            fd_write(fd: number, iovs: number, iovsLen: number, nwritten: number): number;
+            clock_time_get(_id: number, _precision: bigint, out: number): number;
+            clock_res_get(_id: number, out: number): number;
+            random_get(buf: number, len: number): 0 | 8;
+            environ_sizes_get(count: number, size: number): number;
+            environ_get: () => number;
+            args_sizes_get(count: number, size: number): number;
+            args_get: () => number;
+            proc_exit(code: number): never;
+            sched_yield: () => number;
+            fd_close: () => number;
+            fd_fdstat_get: () => number;
+            fd_fdstat_set_flags: () => number;
+            fd_prestat_get: () => number;
+            fd_prestat_dir_name: () => number;
+            fd_read: () => number;
+            fd_seek: () => number;
+            path_create_directory: () => number;
+            path_filestat_get: () => number;
+            path_open: () => number;
+        };
+    };
+    bind(instance: WebAssembly.Instance): void;
+};
+//# sourceMappingURL=acopf-wasi.d.ts.map

package/dist/acopf-wasi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acopf-wasi.d.ts","sourceRoot":"","sources":["../src/acopf-wasi.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAMvE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;;;yBAS/C,MAAM,QAAQ,MAAM,WAAW,MAAM,YAAY,MAAM;gCAgBhD,MAAM,cAAc,MAAM,OAAO,MAAM;+BAQxC,MAAM,OAAO,MAAM;4BAItB,MAAM,OAAO,MAAM;qCAWV,MAAM,QAAQ,MAAM;;kCAOvB,MAAM,QAAQ,MAAM;;4BAO1B,MAAM,GAAG,KAAK;;;;;;;;;;;;;;mBAkBf,WAAW,CAAC,QAAQ;EAStC"}

package/dist/acopf-wasi.js

@@ -0,0 +1,91 @@
+/** Minimal WASI Preview 1 host for the compute-only AC OPF reactor. */
+const ERRNO_SUCCESS = 0;
+const ERRNO_BADF = 8;
+const ERRNO_NOSYS = 52;
+export function createAcOpfWasi(onOutput) {
+    let memory = null;
+    const decoder = new TextDecoder();
+    const view = () => {
+        if (!memory)
+            throw new Error("AC OPF WASI memory is not bound");
+        return new DataView(memory.buffer);
+    };
+    const wasi_snapshot_preview1 = {
+        fd_write(fd, iovs, iovsLen, nwritten) {
+            const data = view();
+            let written = 0;
+            let output = "";
+            for (let index = 0; index < iovsLen; index += 1) {
+                const ptr = data.getUint32(iovs + index * 8, true);
+                const len = data.getUint32(iovs + index * 8 + 4, true);
+                if (len > 0 && memory) {
+                    output += decoder.decode(new Uint8Array(memory.buffer, ptr, len));
+                }
+                written += len;
+            }
+            data.setUint32(nwritten, written, true);
+            if (output && (fd === 1 || fd === 2))
+                onOutput(output);
+            return ERRNO_SUCCESS;
+        },
+        clock_time_get(_id, _precision, out) {
+            view().setBigUint64(out, BigInt(Math.round(performance.now() * 1e6)), true);
+            return ERRNO_SUCCESS;
+        },
+        clock_res_get(_id, out) {
+            view().setBigUint64(out, 1000n, true);
+            return ERRNO_SUCCESS;
+        },
+        random_get(buf, len) {
+            if (!memory)
+                return ERRNO_BADF;
+            const bytes = new Uint8Array(memory.buffer, buf, len);
+            // Web Crypto limits one call to 65,536 bytes.
+            for (let offset = 0; offset < len; offset += 65_536) {
+                crypto.getRandomValues(bytes.subarray(offset, Math.min(len, offset + 65_536)));
+            }
+            return ERRNO_SUCCESS;
+        },
+        environ_sizes_get(count, size) {
+            const data = view();
+            data.setUint32(count, 0, true);
+            data.setUint32(size, 0, true);
+            return ERRNO_SUCCESS;
+        },
+        environ_get: () => ERRNO_SUCCESS,
+        args_sizes_get(count, size) {
+            const data = view();
+            data.setUint32(count, 0, true);
+            data.setUint32(size, 0, true);
+            return ERRNO_SUCCESS;
+        },
+        args_get: () => ERRNO_SUCCESS,
+        proc_exit(code) {
+            throw new Error(`AC OPF wasm called proc_exit(${code})`);
+        },
+        sched_yield: () => ERRNO_SUCCESS,
+        fd_close: () => ERRNO_BADF,
+        fd_fdstat_get: () => ERRNO_BADF,
+        fd_fdstat_set_flags: () => ERRNO_BADF,
+        fd_prestat_get: () => ERRNO_BADF,
+        fd_prestat_dir_name: () => ERRNO_BADF,
+        fd_read: () => ERRNO_BADF,
+        fd_seek: () => ERRNO_BADF,
+        path_create_directory: () => ERRNO_NOSYS,
+        path_filestat_get: () => ERRNO_NOSYS,
+        path_open: () => ERRNO_NOSYS,
+    };
+    return {
+        imports: { wasi_snapshot_preview1 },
+        bind(instance) {
+            memory = instance.exports.memory;
+            if (!(memory instanceof WebAssembly.Memory)) {
+                throw new Error("AC OPF wasm did not export memory");
+            }
+            const initialize = instance.exports._initialize;
+            if (typeof initialize === "function")
+                initialize();
+        },
+    };
+}
+//# sourceMappingURL=acopf-wasi.js.map

package/dist/acopf-wasi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acopf-wasi.js","sourceRoot":"","sources":["../src/acopf-wasi.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,MAAM,UAAU,eAAe,CAAC,QAAgC;IAC9D,IAAI,MAAM,GAA8B,IAAI,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAChE,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,sBAAsB,GAAG;QAC7B,QAAQ,CAAC,EAAU,EAAE,IAAY,EAAE,OAAe,EAAE,QAAgB;YAClE,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;YACpB,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;gBACnD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;gBACvD,IAAI,GAAG,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;oBACtB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,IAAI,GAAG,CAAC;YACjB,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,MAAM,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACvD,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,cAAc,CAAC,GAAW,EAAE,UAAkB,EAAE,GAAW;YACzD,IAAI,EAAE,CAAC,YAAY,CACjB,GAAG,EACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,EAC3C,IAAI,CACL,CAAC;YACF,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,aAAa,CAAC,GAAW,EAAE,GAAW;YACpC,IAAI,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,KAAM,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,UAAU,CAAC,GAAW,EAAE,GAAW;YACjC,IAAI,CAAC,MAAM;gBAAE,OAAO,UAAU,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACtD,8CAA8C;YAC9C,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;gBACpD,MAAM,CAAC,eAAe,CACpB,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CACvD,CAAC;YACJ,CAAC;YACD,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,iBAAiB,CAAC,KAAa,EAAE,IAAY;YAC3C,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC9B,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,aAAa;QAChC,cAAc,CAAC,KAAa,EAAE,IAAY;YACxC,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC9B,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa;QAC7B,SAAS,CAAC,IAAY;YACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,aAAa;QAChC,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU;QAC1B,aAAa,EAAE,GAAG,EAAE,CAAC,UAAU;QAC/B,mBAAmB,EAAE,GAAG,EAAE,CAAC,UAAU;QACrC,cAAc,EAAE,GAAG,EAAE,CAAC,UAAU;QAChC,mBAAmB,EAAE,GAAG,EAAE,CAAC,UAAU;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU;QACzB,qBAAqB,EAAE,GAAG,EAAE,CAAC,WAAW;QACxC,iBAAiB,EAAE,GAAG,EAAE,CAAC,WAAW;QACpC,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW;KAC7B,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,EAAE,sBAAsB,EAAE;QACnC,IAAI,CAAC,QAA8B;YACjC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAA4B,CAAC;YACvD,IAAI,CAAC,CAAC,MAAM,YAAY,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;YAChD,IAAI,OAAO,UAAU,KAAK,UAAU;gBAAE,UAAU,EAAE,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/acopf-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acopf-worker.d.ts.map

package/dist/acopf-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acopf-worker.d.ts","sourceRoot":"","sources":["../src/acopf-worker.ts"],"names":[],"mappings":""}

package/dist/acopf-worker.js

@@ -0,0 +1,86 @@
+import { errorText } from "./errors.js";
+import { createAcOpfWasi } from "./acopf-wasi.js";
+const scope = globalThis;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+async function instantiate(url) {
+    const wasi = createAcOpfWasi((text) => console.debug("[acopf]", text.trimEnd()));
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`AC OPF wasm fetch failed (HTTP ${response.status})`);
+    }
+    let instance;
+    try {
+        ({ instance } = await WebAssembly.instantiateStreaming(Promise.resolve(response.clone()), wasi.imports));
+    }
+    catch {
+        ({ instance } = await WebAssembly.instantiate(await response.arrayBuffer(), wasi.imports));
+    }
+    wasi.bind(instance);
+    const exports = instance.exports;
+    for (const name of [
+        "tellegen_acopf_alloc",
+        "tellegen_acopf_dealloc",
+        "tellegen_acopf_free_payload",
+        "tellegen_acopf_solve",
+    ]) {
+        if (typeof exports[name] !== "function") {
+            throw new Error(`AC OPF wasm is missing its ${name} export`);
+        }
+    }
+    return exports;
+}
+function copyInput(exports, text) {
+    const bytes = encoder.encode(text);
+    const ptr = exports.tellegen_acopf_alloc(bytes.length);
+    if (!ptr)
+        throw new Error("AC OPF wasm allocation failed");
+    new Uint8Array(exports.memory.buffer, ptr, bytes.length).set(bytes);
+    return [ptr, bytes.length];
+}
+function readPayload(exports, ptr) {
+    if (!ptr)
+        throw new Error("AC OPF wasm returned no payload");
+    const memory = new Uint8Array(exports.memory.buffer);
+    if (ptr + 4 > memory.length)
+        throw new Error("AC OPF wasm returned an invalid pointer");
+    const len = new DataView(exports.memory.buffer).getUint32(ptr, true);
+    if (ptr + 4 + len > memory.length) {
+        throw new Error("AC OPF wasm returned an invalid payload length");
+    }
+    const text = decoder.decode(memory.subarray(ptr + 4, ptr + 4 + len));
+    exports.tellegen_acopf_free_payload(ptr);
+    return JSON.parse(text);
+}
+scope.onmessage = async ({ data }) => {
+    try {
+        const exports = await instantiate(data.wasmUrl);
+        if (data.type === "probe") {
+            scope.postMessage({ type: "ready" });
+            scope.close();
+            return;
+        }
+        const moduleInput = copyInput(exports, data.moduleJson);
+        const requestInput = copyInput(exports, data.requestJson);
+        try {
+            const value = readPayload(exports, exports.tellegen_acopf_solve(...moduleInput, ...requestInput));
+            if (typeof value?.error === "string")
+                throw new Error(value.error);
+            scope.postMessage({
+                type: "result",
+                response: value,
+            });
+        }
+        finally {
+            exports.tellegen_acopf_dealloc(...moduleInput);
+            exports.tellegen_acopf_dealloc(...requestInput);
+        }
+    }
+    catch (error) {
+        scope.postMessage({ type: "error", message: errorText(error) });
+    }
+    finally {
+        scope.close();
+    }
+};
+//# sourceMappingURL=acopf-worker.js.map

package/dist/acopf-worker.js.map

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

package/dist/acopf.d.ts

@@ -0,0 +1,19 @@
+import type { SolveResponse } from "./generated/api-types.js";
+import type { AcOpfWorkerRequest, AcOpfWorkerResponse } from "./acopf-protocol.js";
+interface WorkerLike {
+    onmessage: ((event: MessageEvent<AcOpfWorkerResponse>) => void) | null;
+    onerror: ((event: ErrorEvent) => void) | null;
+    onmessageerror: ((event: MessageEvent) => void) | null;
+    postMessage(message: AcOpfWorkerRequest): void;
+    terminate(): void;
+}
+export type AcOpfWorkerFactory = () => WorkerLike;
+/** Probe the optional development asset in the same worker/WASI environment a
+ * solve uses. A missing asset, unsupported browser, or instantiation failure
+ * returns false and leaves the formulation disabled. */
+export declare function probeAcOpfWorker(wasmUrl: string, workerFactory?: AcOpfWorkerFactory, signal?: AbortSignal): Promise<boolean>;
+/** Run one nonlinear AC OPF in a fresh, dedicated worker. Cancellation always
+ * terminates that worker; there is deliberately no main-thread fallback. */
+export declare function solveAcOpfModule(wasmUrl: string, moduleJson: string, signal?: AbortSignal, workerFactory?: AcOpfWorkerFactory): Promise<SolveResponse>;
+export {};
+//# sourceMappingURL=acopf.d.ts.map

package/dist/acopf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acopf.d.ts","sourceRoot":"","sources":["../src/acopf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,UAAU,UAAU;IAClB,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9C,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,UAAU,CAAC;AA8DlD;;wDAEwD;AACxD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,kBAAkB,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED;4EAC4E;AAC5E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,aAAa,CAAC,CAgBxB"}

package/dist/acopf.js

@@ -0,0 +1,84 @@
+import { assertEngineInputLength } from "./input-limit.js";
+const defaultWorkerFactory = () => new Worker(new URL("./acopf-worker.js", import.meta.url), { type: "module" });
+function workerCall(request, signal, workerFactory = defaultWorkerFactory) {
+    signal?.throwIfAborted();
+    if (typeof Worker === "undefined" && workerFactory === defaultWorkerFactory) {
+        return Promise.reject(new Error("AC OPF requires a browser with dedicated Worker support"));
+    }
+    return new Promise((resolve, reject) => {
+        let worker;
+        try {
+            worker = workerFactory();
+        }
+        catch (error) {
+            reject(error);
+            return;
+        }
+        const finish = () => {
+            signal?.removeEventListener("abort", abort);
+            worker.onmessage = null;
+            worker.onerror = null;
+            worker.onmessageerror = null;
+            worker.terminate();
+        };
+        const abort = () => {
+            finish();
+            reject(new DOMException("AC OPF solve cancelled", "AbortError"));
+        };
+        signal?.addEventListener("abort", abort, { once: true });
+        if (signal?.aborted) {
+            abort();
+            return;
+        }
+        worker.onmessage = ({ data }) => {
+            finish();
+            if (data.type === "error")
+                reject(new Error(data.message));
+            else
+                resolve(data);
+        };
+        worker.onerror = () => {
+            finish();
+            reject(new Error("AC OPF worker failed"));
+        };
+        worker.onmessageerror = () => {
+            finish();
+            reject(new Error("AC OPF worker returned an unreadable message"));
+        };
+        try {
+            worker.postMessage(request);
+        }
+        catch (error) {
+            finish();
+            reject(error);
+        }
+    });
+}
+/** Probe the optional development asset in the same worker/WASI environment a
+ * solve uses. A missing asset, unsupported browser, or instantiation failure
+ * returns false and leaves the formulation disabled. */
+export async function probeAcOpfWorker(wasmUrl, workerFactory, signal) {
+    try {
+        const response = await workerCall({ type: "probe", wasmUrl }, signal, workerFactory);
+        return response.type === "ready";
+    }
+    catch {
+        return false;
+    }
+}
+/** Run one nonlinear AC OPF in a fresh, dedicated worker. Cancellation always
+ * terminates that worker; there is deliberately no main-thread fallback. */
+export async function solveAcOpfModule(wasmUrl, moduleJson, signal, workerFactory) {
+    assertEngineInputLength(moduleJson.length);
+    const response = await workerCall({
+        type: "solve",
+        wasmUrl,
+        moduleJson,
+        requestJson: JSON.stringify({ formulation: "acopf" }),
+    }, signal, workerFactory);
+    if (response.type !== "result") {
+        throw new Error("AC OPF worker returned no solve result");
+    }
+    return response.response;
+}
+//# sourceMappingURL=acopf.js.map

package/dist/acopf.js.map

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

package/dist/acopf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acopf.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acopf.test.d.ts","sourceRoot":"","sources":["../src/acopf.test.ts"],"names":[],"mappings":""}

package/dist/acopf.test.js

@@ -0,0 +1,91 @@
+import { describe, expect, it } from "vitest";
+import { probeAcOpfWorker, solveAcOpfModule, } from "./acopf.js";
+class FakeWorker {
+    onmessage = null;
+    onerror = null;
+    onmessageerror = null;
+    terminated = false;
+    request = null;
+    postMessage(request) {
+        this.request = request;
+    }
+    terminate() {
+        this.terminated = true;
+    }
+    reply(response) {
+        this.onmessage?.({ data: response });
+    }
+}
+describe("experimental AC OPF worker host", () => {
+    it("enables the capability only after the WASI worker probes successfully", async () => {
+        const worker = new FakeWorker();
+        const pending = probeAcOpfWorker("/acopf.wasm", () => worker);
+        expect(worker.request).toEqual({ type: "probe", wasmUrl: "/acopf.wasm" });
+        worker.reply({ type: "ready" });
+        await expect(pending).resolves.toBe(true);
+        expect(worker.terminated).toBe(true);
+    });
+    it("keeps the capability disabled when the asset or ABI probe fails", async () => {
+        const worker = new FakeWorker();
+        const pending = probeAcOpfWorker("/missing.wasm", () => worker);
+        worker.reply({ type: "error", message: "HTTP 404" });
+        await expect(pending).resolves.toBe(false);
+        expect(worker.terminated).toBe(true);
+    });
+    it("terminates the isolated worker on cancellation and never falls back", async () => {
+        const worker = new FakeWorker();
+        const factory = () => worker;
+        const abort = new AbortController();
+        const pending = solveAcOpfModule("/acopf.wasm", "{}", abort.signal, factory);
+        abort.abort();
+        await expect(pending).rejects.toMatchObject({ name: "AbortError" });
+        expect(worker.terminated).toBe(true);
+    });
+    it("returns the typed solve response and disposes the one-shot worker", async () => {
+        const workers = [new FakeWorker(), new FakeWorker()];
+        let index = 0;
+        const factory = () => workers[index++];
+        const first = solveAcOpfModule("/acopf.wasm", "{}", undefined, factory);
+        workers[0].reply({
+            type: "result",
+            response: { formulation: "acopf", status: "feasible" },
+        });
+        await expect(first).resolves.toMatchObject({ formulation: "acopf" });
+        const second = solveAcOpfModule("/acopf.wasm", "{}", undefined, factory);
+        workers[1].reply({
+            type: "result",
+            response: { formulation: "acopf", status: "feasible" },
+        });
+        await expect(second).resolves.toMatchObject({ formulation: "acopf" });
+        expect(workers.every((worker) => worker.terminated)).toBe(true);
+        expect(index).toBe(2);
+    });
+    it("terminates a pending probe when its owner is disposed", async () => {
+        const worker = new FakeWorker();
+        const abort = new AbortController();
+        const pending = probeAcOpfWorker("/acopf.wasm", () => worker, abort.signal);
+        abort.abort();
+        await expect(pending).resolves.toBe(false);
+        expect(worker.terminated).toBe(true);
+        expect(worker.onmessage).toBeNull();
+    });
+    it("does not create a worker for an already cancelled probe", async () => {
+        const abort = new AbortController();
+        abort.abort();
+        let created = false;
+        await expect(probeAcOpfWorker("/acopf.wasm", () => {
+            created = true;
+            return new FakeWorker();
+        }, abort.signal)).resolves.toBe(false);
+        expect(created).toBe(false);
+    });
+    it("disposes the worker if posting the request throws", async () => {
+        const worker = new FakeWorker();
+        worker.postMessage = () => {
+            throw new Error("post failed");
+        };
+        await expect(solveAcOpfModule("/acopf.wasm", "{}", undefined, () => worker)).rejects.toThrow("post failed");
+        expect(worker.terminated).toBe(true);
+    });
+});
+//# sourceMappingURL=acopf.test.js.map

package/dist/acopf.test.js.map

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