@tellegen/engine 0.2.0 → 0.4.0

package/dist/study-document.test.js.map

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

package/dist/wasm-pkg/LICENSE

@@ -1,6 +1,19 @@
-This crate is part of tellegen.
+Copyright (c) 2026 Samuel Talkington and contributors
 
-License: Apache-2.0 OR MIT
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-See LICENSE-APACHE and LICENSE-MIT in this directory for the full license
-texts.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/wasm-pkg/tellegen.d.ts

@@ -2,17 +2,82 @@
 /* eslint-disable */
 
 /**
- * A build-once handle over the engine, exported to JS. Construct once per case (the
- * network is parsed and the model built here); then [`replace_edits`](Study::replace_edits)
+ * A retained fixed-point current-injection session. The prepared network,
+ * sparse LU, and last converged voltage remain in this WASM object across
+ * load edits. Ordinary edits return the compact summary; detailed terminal
+ * and equipment values are fetched on demand.
+ */
+export class McPfSession {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Phase timings of the session's parse, preparation, factorization, and first solve.
+     */
+    cold_profile(): string;
+    /**
+     * One bounded page of terminal and equipment values for a bus or element.
+     */
+    detail(query_json: string): string;
+    /**
+     * Materialize the current edited input as PowerIO IR.
+     */
+    input_module(): string;
+    /**
+     * Editable load branches with base and current P/Q values.
+     */
+    load_branches(): string;
+    /**
+     * Edited networks materialized for portable output; ordinary edits build none.
+     */
+    materialization_count(): number;
+    constructor(module_json: string, options_json: string);
+    /**
+     * Phase timings of the most recent solve.
+     */
+    profile(): string;
+    /**
+     * Replace the absolute branch-power edit state, solve with the retained
+     * factorization and previous converged voltage, and return the summary.
+     */
+    replace_load_powers(edits_json: string): string;
+    /**
+     * The complete terminal and equipment result, built on demand. Its size
+     * grows with the network; the interactive path uses `summary`/`detail`.
+     */
+    result(): string;
+    /**
+     * Save the current edited point and result without re-solving.
+     */
+    snapshot(study_id: string, study_title: string): string;
+    /**
+     * The compact summary of the current operating point (constant size).
+     */
+    summary(): string;
+    /**
+     * Currents injected into the network as interleaved `[re, im]` amperes.
+     */
+    terminal_currents(): Float64Array;
+    /**
+     * Terminal identities as `[bus, terminal]` pairs in calculation order.
+     * They never change for a session, so a host fetches them once.
+     */
+    terminal_ids(): string;
+    /**
+     * Terminal voltages as interleaved `[re, im]` volts (a `Float64Array`).
+     */
+    terminal_voltages(): Float64Array;
+}
+
+/**
+ * A retained handle over the engine, exported to JS. Construct once per PowerIO module;
+ * then [`replace_edits`](Study::replace_edits)
  * solves exactly at an absolute edit state and [`preview_replacement`](Study::preview_replacement)
- * returns a first-order linearization toward an absolute edit state — neither re-parses
- * the network, unlike `solve_json` which rebuilds it on every call. This is
- * the path a reactive drag should use.
+ * returns a first order linearization toward an absolute edit state.
  *
  * Arguments and results are JSON in the engine's `Study` shapes: edits are a
  * `NetworkEdit[]` (e.g. `[{"kind":"add_load","bus":2,"p_mw":50}]`; the element key
- * also accepts the powerio row uid string `ingest_case` stamps, e.g.
- * `"bus":"buses:1"`), `preview` watches an
+ * also accepts a powerio row uid string when the source format carries uids,
+ * e.g. `"bus":"buses:1"`), `preview` watches an
  * `Operand[]` (e.g. `[{"Price":"Active"}]`) and returns a `Preview`. `commit` takes the
  * edits plus a `SensRequest[]` of watched cells and returns `{ solution, iterations,
  * sensitivities }` — the committed [`SolveResponse`] plus the requested ∂operand/∂param
@@ -25,7 +90,7 @@ export class Study {
     /**
      * Apply a geographic layer (a canonical `.geo.json` from [`parse_geo`] or
      * [`apply_layout`]) onto this study's base network, so a later
-     * [`save_package`](Study::save_package) or export carries the coordinates
+     * [`save_module`](Study::save_module) or export carries the coordinates
      * on screen. Locations are metadata the model never reads; nothing
      * re-solves. Returns the apply report JSON.
      */
@@ -40,16 +105,34 @@ export class Study {
      * columns so the UI renders the ∂LMP/∂d column without a second solve.
      */
     commit(edits_json: string, sensitivities_json: string): string;
+    /**
+     * Export the committed operating point to a powerio `format` (`matpower`,
+     * `psse`, ...). Returns `{ text, diagnostics, format,
+     * extension }` as JSON: the serialized case, this output operation's
+     * structured diagnostics, and the format token and file extension.
+     */
+    export(format: string): string;
     /**
      * The formulation tag (`"dcopf"` / `"acpf"`).
      */
     formulation(): string;
     /**
-     * Build a study over `network_json` for `formulation` (`"dcopf"` / `"acpf"`, and —
+     * Build a study over `module_json` for `formulation` (`"dcopf"` / `"acpf"`, and —
      * in a build that includes them — `"socwr"` / `"acopf"`), solving the base case.
-     * Errors on an unknown or not-built formulation.
+     * Bare model JSON and unknown or unavailable formulations are rejected.
+     */
+    constructor(module_json: string, formulation: string);
+    /**
+     * Run a bounded differentiable planning search over the committed
+     * operating point: the implicit gradient of the serializable outer
+     * objective through the exact DC OPF KKT orders capacity trials
+     * whose every step is verified by an exact re-solve. Read only — the
+     * committed case, edits, and revision are untouched. `spec_json` is a
+     * [`tellegen::plan::CapacityPlanSpec`]; the returned JSON is the complete
+     * [`tellegen::plan::CapacityPlanOutcome`] trace with the unapplied
+     * proposal. A non-DC formulation returns a typed error.
      */
-    constructor(network_json: string, formulation: string);
+    plan(spec_json: string): string;
     /**
      * First-order preview of `edits_json` (a `NetworkEdit[]`) for the `watched_json`
      * operands (an `Operand[]`), at the committed point, without re-solving. Returns the
@@ -69,25 +152,104 @@ export class Study {
      */
     replace_edits(edits_json: string, sensitivities_json: string): string;
     /**
-     * Serialize this study as a `.pio.json` package: the base network is the payload,
-     * the edit log is the study block (one commit per `commit` call, keyed by row uid),
-     * and the formulation and solve options ride under `study.app["tellegen"]`. Returns
-     * the package JSON, ready to download or hand to [`export_study`].
+     * Serialize the exact problem instance, including its inner objective and constraints.
+     */
+    save_instance_module(): string;
+    /**
+     * Serialize the committed operating point as a stored PowerIO module:
+     * the materialized network with one descriptive `Edit` history entry per
+     * committed edit, ready to download as `.pio.json`. Any PowerIO reader
+     * understands the file; reloading it starts a fresh session.
      */
-    save_package(): string;
+    save_module(): string;
+    /**
+     * Save the committed exact DC OPF result as a PowerIO solution module.
+     * The embedded instance contains the materialized case that was solved.
+     */
+    save_solution_module(): string;
     /**
      * The most recent committed solution as `SolveResponse` JSON.
      */
     solution(): string;
 }
 
+/**
+ * A synthetic preview as flat arrays: bus `[lon, lat]` pairs, kinds (0 load,
+ * 1 substation, 2 generator, 3 converter) and kV in bus order, branch route
+ * points, the index where each route starts (one entry more than there are
+ * branches) and branch kV.
+ */
+export class SynthPreviewBuffers {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    branch_kv(): Float32Array;
+    branch_positions(): Float64Array;
+    branch_start_indices(): Uint32Array;
+    bus_kinds(): Uint8Array;
+    bus_kv(): Float32Array;
+    bus_positions(): Float64Array;
+}
+
+/**
+ * A staged synthetic generation: one bounded stage per `advance`, a map
+ * preview between stages, and the module, the report and the drop-panel
+ * payload once it is done.
+ */
+export class SynthSession {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Run one stage (one calibration iteration for `calibrate`); returns the
+     * `StepOutcome` JSON.
+     */
+    advance(): string;
+    /**
+     * The network as GridFM graphkit JSON (per-unit feature matrices on a
+     * 0-based bus index), from `electrify` on.
+     */
+    export_gridfm(): string;
+    /**
+     * The drop-panel payload of the module (the `ingest_case` shape with
+     * `module_json`).
+     */
+    ingest(): string;
+    /**
+     * The module as generation 2 PowerIO IR text, with bus locations and
+     * branch routes, from `electrify` on.
+     */
+    module(): string;
+    /**
+     * Open a session at the `context` stage. `osm_json` is the Overpass
+     * document (one, or a JSON array of documents) for `source: "osm"`.
+     */
+    constructor(request_json: string, osm_json?: string | null);
+    /**
+     * The map preview as `Preview` JSON records.
+     */
+    preview(): string;
+    /**
+     * The map preview as flat arrays for binary map attributes, computed
+     * once; read each array, then `free()` the buffers.
+     */
+    preview_buffers(): SynthPreviewBuffers;
+    /**
+     * The `GenerationReport` JSON, partial until the session is done.
+     */
+    report(): string;
+    /**
+     * The stage the next `advance` runs.
+     */
+    stage(): string;
+}
+
 /**
  * Fill case coordinates from a PowerWorld `.pwd` sibling: substation symbols
  * project to approximate longitude/latitude and join onto buses through the
  * `SubNum` extras key. Returns the refreshed `ingest_case` payload plus a
  * `report`; errors when no bus joined.
  */
-export function apply_display_geo(network_json: string, bytes: Uint8Array): string;
+export function apply_display_geo(module_json: string, bytes: Uint8Array): string;
 
 /**
  * Apply a [`parse_geo`] layer onto a case network: matched bus points land in
@@ -96,7 +258,7 @@ export function apply_display_geo(network_json: string, bytes: Uint8Array): stri
  * the refreshed `ingest_case` payload plus a `report` of matched/unmatched
  * counts; errors when nothing matched.
  */
-export function apply_geo(network_json: string, layer_geojson: string): string;
+export function apply_geo(module_json: string, layer_geojson: string): string;
 
 /**
  * Stamp a computed layout (bus id => `[lon, lat]`) onto a case network with
@@ -104,7 +266,12 @@ export function apply_geo(network_json: string, layer_geojson: string): string;
  * `ingest_case` payload plus `layer`, the stamped layout as a canonical
  * `.geo.json` document.
  */
-export function apply_layout(network_json: string, coords_json: string, kind: string): string;
+export function apply_layout(module_json: string, coords_json: string, kind: string): string;
+
+/**
+ * Attach geographic or drawing positions to a saved multiconductor result.
+ */
+export function apply_mc_study_geo(snapshot_json: string, layer_geojson: string): string;
 
 /**
  * The capability matrix as JSON: which `(formulation, operand, parameter)` cells this
@@ -118,25 +285,16 @@ export function capabilities_json(): string;
  */
 export function classify_json(bytes: Uint8Array): string;
 
-/**
- * Export the balanced study state at commit `commit` to a powerio `format`
- * (`matpower`, `psse`, `model-json`, ...). Returns `{ text, warnings, format,
- * extension }` as JSON: the serialized case, the writer's fidelity warnings so the
- * frontend can surface them, and the format token and file extension. The package
- * JSON is untrusted; malformed input returns a `JsError`, never a panic.
- */
-export function export_study(package_json: string, commit: number, format: string): string;
-
 /**
  * A case's coordinates as a canonical `.geo.json` document (one point per
  * located bus, one route per routed branch, provenance preserved). Errors
  * when the case carries none.
  */
-export function extract_geo(network_json: string): string;
+export function extract_geo(module_json: string): string;
 
 /**
  * Everything the drop panel needs from one parse: counts, total load and
- * capacity, parse warnings, and a `view` of buses and branches in the shape
+ * capacity, parse diagnostics, and a `view` of buses and branches in the shape
  * the tellegen API serves, placed at the coordinates the file carries
  * (PowerWorld complete case aux exports). `view` is null when the file has no
  * coordinates.
@@ -149,13 +307,14 @@ export function ingest_case(bytes: Uint8Array, format: string): string;
 /**
  * The distribution counterpart of [`ingest_case`]: view a multiconductor case
  * with no solve. `format` is a distribution reader token (`dss`, `bmopf`,
- * `pmd`) parsed by [`powerio_dist`], or `pio` for a `.pio.json` package
- * carrying a multiconductor payload. Returns the drop-panel payload JSON:
- * name, element counts, connected load/generation (kW), parse warnings,
+ * `pmd`) parsed by [`powerio_dist`], or `pio` for a `.pio.json` stored module
+ * holding a supported multiconductor network, instance, or solution. Returns
+ * the drop-panel payload JSON:
+ * name, element counts, connected load/generation (kW), parse diagnostics,
  * coordinate provenance, and the bus/terminal graph the frontend renders (see
- * [`dist`]).
+ * the private `dist` adapter).
  *
- * Untrusted input: the parse and package restore return error strings (mapped
+ * Untrusted input: the parse and module restore return error strings (mapped
  * to `JsError` here), so a malformed, truncated, or oversized `.dss`/JSON
  * rejects cleanly and never panics the wasm instance.
  */
@@ -170,113 +329,201 @@ export function ingest_dist_case_bytes(bytes: Uint8Array, format: string): strin
  * Classify and ingest one dropped JSON byte buffer. Known inputs return their
  * render-ready payload; ambiguous and unknown documents return a null payload
  * so the caller can request an explicit format without decoding the bytes a
- * second time. Package envelopes are decoded once and the parsed package is
- * passed directly to the appropriate restore path.
+ * second time. A stored module is read once and its value routed to the
+ * balanced or multiconductor view. The TS drop-classify layer must mirror
+ * the kinds (`module` and powerio's families).
  */
 export function ingest_json_drop(bytes: Uint8Array): string;
 
 /**
- * [`ingest_case`] for powerio's own model JSON, the document `export_study`
- * writes under the `model-json` token and powerio classifies as
- * `JsonClass::ModelJson`. It is not a case format, so it reaches
- * `BalancedNetwork::from_json` rather than a case reader, and there are no
- * reader warnings to carry: nothing was converted.
+ * Engine heap accounting: live and peak bytes held by the WASM allocator
+ * (peak since the last reset) and the size of linear memory, which only
+ * grows. Native builds report zeros.
  */
-export function ingest_model_json(network_json: string): string;
-
-/**
- * Byte counterpart of [`ingest_model_json`] for dropped files. UTF-8 decoding
- * and model validation both stay in powerio.
- */
-export function ingest_model_json_bytes(bytes: Uint8Array): string;
-
-/**
- * Restore a study saved by [`Study::save_package`]. Returns a JSON bundle the frontend
- * reads to rebuild its case, edit sliders, formulation, and solve options in one step.
- * See [`load_package_bundle`] for the shape and the fail-closed contract.
- */
-export function load_package(package_json: string): string;
-
-/**
- * Byte counterpart of [`load_package`] for a dropped package.
- */
-export function load_package_bytes(bytes: Uint8Array): string;
+export function memory_stats(): string;
 
 /**
  * Parse a case file (MATPOWER, PSS/E RAW, PowerWorld aux, PowerModels or
- * egret JSON) and return `{"network": ..., "warnings": [...]}` as JSON.
+ * egret JSON) and return `{"network": ..., "diagnostics": [...]}` as JSON.
  *
- * Takes the upload's bytes, not decoded text: `powerio::parse_bytes` refuses a
- * text format whose bytes are not UTF-8, where a browser side `File.text()`
- * would have replaced each offending byte with U+FFFD and parsed on. It also
- * reaches PowerWorld `.pwb`, which has no text form at all.
+ * Takes the upload's bytes, not decoded text: powerio refuses a text format
+ * whose bytes are not UTF-8, where a browser side `File.text()` would have
+ * replaced each offending byte with U+FFFD and parsed on. It also reaches
+ * PowerWorld `.pwb`, which has no text form at all.
  */
 export function parse_case(bytes: Uint8Array, format: string): string;
 
 /**
- * Decode a PowerWorld `.pwd` display file (binary). Returns the substation
- * symbols at the diagram coordinates the file stores (x east, y north) plus
- * the canvas size, each with the approximate `lon`/`lat` projection
- * (`pwd_mercator_to_lonlat`; hand edited diagrams drift from it). A `.pwd`
- * carries no buses or branches. `format` is "pwd". Pure in-memory parsing,
- * no filesystem, so it runs in the browser.
+ * Decode a PowerWorld drawing as a canonical PowerIO GeoLayer in diagram units.
  */
 export function parse_display(bytes: Uint8Array, format: string): string;
 
 /**
  * Parse a geographic sidecar (buscoords CSV, aliased CSV/JSON records,
  * GeoJSON) from raw dropped bytes; `hint` is the file name ("" to sniff).
- * Returns `{ layer, warnings, n_points, n_routes }` — the layer as its
+ * Returns `{ layer, diagnostics, n_points, n_routes }` — the layer as its
  * canonical `.geo.json` document, ready for [`apply_geo`]. Untrusted input
  * rejects as a `JsError`, never a panic.
  */
 export function parse_geo(bytes: Uint8Array, hint: string): string;
 
 /**
- * The stateless solve front door: a [`SolveRequest`](tellegen::SolveRequest) JSON
- * in, a [`SolveResponse`](tellegen::SolveResponse) JSON out. One-shot callers only;
+ * Validate and canonicalize a saved multiconductor Study snapshot without
+ * re-solving it.
+ */
+export function replay_mc_study(snapshot_json: string): string;
+
+/**
+ * Start a new peak-heap window at the current live size.
+ */
+export function reset_peak_memory(): void;
+
+/**
+ * Solve a raw BMOPF multiconductor constant-power case.  The parser and
+ * fixed-point implementation remain in the engine crate; this export only
+ * performs the bounded text/JSON conversion at the browser boundary.
+ */
+export function solve_mc_bmopf(text: string, options_json: string): string;
+
+/**
+ * Solve a stored PowerIO multiconductor module. This accepts the portable
+ * module form used by browser persistence in addition to raw BMOPF text.
+ */
+export function solve_mc_module(module_json: string, options_json: string): string;
+
+/**
+ * Solve a supported multiconductor Study input and return a self-contained,
+ * replayable snapshot containing the typed input, PowerIO solution module, and
+ * terminal-aware result view.
+ */
+export function solve_mc_study(module_json: string, study_id: string, study_title: string, options_json: string): string;
+
+/**
+ * The stateless solve front door: a retained PowerIO module and a
+ * [`tellegen::SolveRequest`] JSON in, a [`tellegen::SolveResponse`] JSON out. One-shot callers only;
  * the reactive hot path is the [`Study`].
  */
-export function solve_json(network_json: string, request_json: string): string;
+export function solve_module(module_json: string, request_json: string): string;
+
+/**
+ * Create a portable application Study through the shared native controller.
+ */
+export function study_document_create(request_json: string): string;
+
+/**
+ * Validate and normalize a portable bundle without executing its contents.
+ */
+export function study_document_import(bundle_json: string): string;
+
+/**
+ * Execute a revision-checked Study operation and return the completed bundle.
+ */
+export function study_document_run(bundle_json: string, request_json: string, cancelled: Function): Promise<string>;
+
+/**
+ * Run every stage of a synthetic generation: `{module_json, report, ingest}`.
+ */
+export function synth_generate(request_json: string, osm_json?: string | null): string;
+
+/**
+ * Load the populated places table every synthetic session of this instance
+ * reads (the engine package's `data/populated_places.json`, or any table of
+ * `{n, lo, la, p, c}` rows). Returns `{count, sha256}`.
+ */
+export function synth_load_places(bytes: Uint8Array): string;
+
+/**
+ * The Overpass QL queries for a synthetic request's region: a JSON array, two
+ * entries when the region crosses the antimeridian.
+ */
+export function synth_overpass_queries(request_json: string): string;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_mcpfsession_free: (a: number, b: number) => void;
     readonly __wbg_study_free: (a: number, b: number) => void;
+    readonly __wbg_synthpreviewbuffers_free: (a: number, b: number) => void;
+    readonly __wbg_synthsession_free: (a: number, b: number) => void;
     readonly apply_display_geo: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly apply_geo: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly apply_layout: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly apply_mc_study_geo: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly capabilities_json: () => [number, number];
     readonly classify_json: (a: number, b: number) => [number, number, number, number];
-    readonly export_study: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly extract_geo: (a: number, b: number) => [number, number, number, number];
     readonly ingest_case: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly ingest_dist_case: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly ingest_dist_case_bytes: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly ingest_json_drop: (a: number, b: number) => [number, number, number, number];
-    readonly ingest_model_json: (a: number, b: number) => [number, number, number, number];
-    readonly ingest_model_json_bytes: (a: number, b: number) => [number, number, number, number];
-    readonly load_package: (a: number, b: number) => [number, number, number, number];
-    readonly load_package_bytes: (a: number, b: number) => [number, number, number, number];
+    readonly mcpfsession_cold_profile: (a: number) => [number, number, number, number];
+    readonly mcpfsession_detail: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly mcpfsession_input_module: (a: number) => [number, number, number, number];
+    readonly mcpfsession_load_branches: (a: number) => [number, number, number, number];
+    readonly mcpfsession_materialization_count: (a: number) => number;
+    readonly mcpfsession_new: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly mcpfsession_profile: (a: number) => [number, number, number, number];
+    readonly mcpfsession_replace_load_powers: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly mcpfsession_result: (a: number) => [number, number, number, number];
+    readonly mcpfsession_snapshot: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly mcpfsession_summary: (a: number) => [number, number, number, number];
+    readonly mcpfsession_terminal_currents: (a: number) => [number, number];
+    readonly mcpfsession_terminal_ids: (a: number) => [number, number, number, number];
+    readonly mcpfsession_terminal_voltages: (a: number) => [number, number];
+    readonly memory_stats: () => [number, number];
     readonly parse_case: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly parse_display: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly parse_geo: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly solve_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly replay_mc_study: (a: number, b: number) => [number, number, number, number];
+    readonly reset_peak_memory: () => void;
+    readonly solve_mc_bmopf: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly solve_mc_module: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly solve_mc_study: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly solve_module: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly study_apply_geo: (a: number, b: number, c: number) => [number, number, number, number];
     readonly study_commit: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly study_document_create: (a: number, b: number) => [number, number, number, number];
+    readonly study_document_import: (a: number, b: number) => [number, number, number, number];
+    readonly study_document_run: (a: number, b: number, c: number, d: number, e: any) => any;
+    readonly study_export: (a: number, b: number, c: number) => [number, number, number, number];
     readonly study_formulation: (a: number) => [number, number];
     readonly study_new: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly study_plan: (a: number, b: number, c: number) => [number, number, number, number];
     readonly study_preview: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly study_preview_replacement: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly study_replace_edits: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly study_save_package: (a: number) => [number, number, number, number];
+    readonly study_save_instance_module: (a: number) => [number, number, number, number];
+    readonly study_save_module: (a: number) => [number, number, number, number];
+    readonly study_save_solution_module: (a: number) => [number, number, number, number];
     readonly study_solution: (a: number) => [number, number, number, number];
+    readonly synth_generate: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly synth_load_places: (a: number, b: number) => [number, number, number, number];
+    readonly synth_overpass_queries: (a: number, b: number) => [number, number, number, number];
+    readonly synthpreviewbuffers_branch_kv: (a: number) => [number, number];
+    readonly synthpreviewbuffers_branch_positions: (a: number) => [number, number];
+    readonly synthpreviewbuffers_branch_start_indices: (a: number) => [number, number];
+    readonly synthpreviewbuffers_bus_kinds: (a: number) => [number, number];
+    readonly synthpreviewbuffers_bus_kv: (a: number) => [number, number];
+    readonly synthpreviewbuffers_bus_positions: (a: number) => [number, number];
+    readonly synthsession_advance: (a: number) => [number, number, number, number];
+    readonly synthsession_export_gridfm: (a: number) => [number, number, number, number];
+    readonly synthsession_ingest: (a: number) => [number, number, number, number];
+    readonly synthsession_module: (a: number) => [number, number, number, number];
+    readonly synthsession_new: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly synthsession_preview: (a: number) => [number, number, number, number];
+    readonly synthsession_preview_buffers: (a: number) => number;
+    readonly synthsession_report: (a: number) => [number, number, number, number];
+    readonly synthsession_stage: (a: number) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h1c534e945ee6d3b6: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h67ba427e9454f1d8: (a: number, b: number, c: any, d: any) => void;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-    readonly __externref_table_alloc: () => number;
-    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
     readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }