@swmmrs/swmmrs 0.1.0

package/dist/serial/README.md

@@ -0,0 +1,264 @@
+# swmmrs for JavaScript and TypeScript
+
+`@swmmrs/swmmrs` runs SWMM in a dedicated worker from a browser or from Node.js
+22 and later. A `Simulation` owns its worker, solver state, and in-memory project
+files. The package is private and is built from this repository.
+
+See the [JavaScript / TypeScript documentation](../docs/javascript/index.md) for
+usage guides and the [API reference](../docs/javascript/api/index.md) for all
+public signatures. After building the package, `npm run test:docs` type-checks
+the documentation examples.
+
+## Build the browser package
+
+Install Node.js 22 or later, `wasm-pack`, and the Rust toolchain used by this
+repository. Then run these commands in `js`:
+
+```sh
+npm ci
+npm run build
+npm start
+```
+
+Open `http://127.0.0.1:8080/`. `npm run build` and `npm run build:wasm` produce
+threaded WASM in `dist/` and serial WASM with unshared memory in `dist/serial/`.
+The pinned Rust nightly toolchain rebuilds the standard library for WASM threads.
+`npm run build:wasm -- --dev` builds both modules without optimization, and
+`npm run build:ts` rebuilds JavaScript and declarations after TypeScript changes.
+
+Alternatively, with [Just](https://just.systems/) installed, use the shared
+build recipes from the repository root:
+
+```sh
+just js-deps
+just js-debug      # Debug threaded and serial WASM, then TypeScript.
+just js-release    # Optimized threaded and serial WASM, then TypeScript.
+```
+
+Both profiles write to the same `js/dist/` and `js/lib/` package paths; the
+latest build replaces those assets. Cargo dependencies are locked in both modes.
+
+The package exports ES modules. Import `index.js` when serving this directory, or
+install `@swmmrs/swmmrs` as a local package dependency. Node uses
+`node:worker_threads`; it does not need browser isolation headers.
+
+## Run a model
+
+The API accepts file contents, not host paths or URLs. Valid values are strings,
+`Blob`, `ArrayBuffer`, and array-buffer views. Supporting-file keys are relative
+paths from the INP.
+
+In Node.js, read files yourself and pass the resulting bytes:
+
+```javascript
+import { readFile } from "node:fs/promises";
+import { runSwmm } from "@swmmrs/swmmrs";
+
+const input = await readFile("model.inp");
+const files = { "rain.dat": await readFile("rain.dat") };
+const { report, output } = await runSwmm(input, files, { threads: 1 });
+console.log(report, output.byteLength);
+```
+
+In a browser, fetch contents or pass `File` and `Blob` values:
+
+```typescript
+import { runSwmm } from "@swmmrs/swmmrs";
+
+export async function runBrowserModel() {
+	const response = await fetch("/models/model.inp");
+	if (!response.ok) throw new Error(`INP request failed: ${response.status}`);
+	const input = await response.text();
+	const rainfall = await fetch("/models/rain.dat");
+	if (!rainfall.ok) throw new Error(`Rainfall request failed: ${rainfall.status}`);
+	const files = { "rain.dat": await rainfall.blob() };
+	return runSwmm(input, files, { threads: 1 });
+}
+```
+
+`runSwmm()` starts the model, runs it to completion, finalizes report text and
+binary output, and closes the owner. Set `saveResults: false` in the third
+argument when report-period binary results are not needed. The returned
+`output` is then an empty `Uint8Array`; detailed report tables are not written.
+
+## Inspect and control a run
+
+Use `Simulation.open()` when the application needs configuration, progress,
+quality reads, statistics, or runtime controls:
+
+```typescript
+import { Simulation, type FileContents } from "@swmmrs/swmmrs";
+
+export async function inspectAndControl(
+	input: FileContents,
+	files: Readonly<Record<string, FileContents>> = {},
+) {
+	const simulation = await Simulation.open(input, files, { threads: 1 });
+	try {
+		const node = simulation.nodes.get("J1");
+		const link = simulation.links.get("OR1");
+		await node.configure({ fullDepth: 6 });
+		await simulation.options.update({ reportStepSeconds: 60 });
+
+		for await (const time of simulation.steps({ seconds: 60, strict: true })) {
+			const { depth } = await node.results();
+			await link.setTargetSetting(depth > 2 ? 1 : 0.25);
+			console.log(time, depth, (await simulation.status()).percentComplete);
+		}
+
+		const statistics = await simulation.statistics();
+		const files = await simulation.finish();
+		return { statistics, ...files };
+	} finally {
+		await simulation.close();
+	}
+}
+```
+
+`steps()` and `stride()` default to `strict: true`, so interval observations
+request exact boundaries. Pass positive whole seconds. Set `strict: false`
+explicitly when whole routing-step boundaries are preferred. `step()` and
+`stride()` return `null` at natural completion. Collection lookup is synchronous,
+but configuration, results, quality, statistics, and controls are asynchronous.
+Returned records are frozen copies. Handles remain owner-bound and expose
+canonical IDs; related object references are IDs, not foreign handles.
+
+`start()`, `run()`, and `steps()` default to `saveResults: true`. `finish()` ends
+the run, flushes binary output, writes requested detailed report tables when
+results are enabled, finalizes the report, and retains the owner for reads or
+reruns. `end()` writes summary statistics, `finalizeReport()` appends only the
+runtime footer, and `report()` appends the requested detailed tables and footer.
+
+## Specialized configuration
+
+Node and link handles do not have public subtype constructors. Their
+configuration records carry a `kind`; link records also carry a kind-tagged
+`subtype`. The package exposes sparse configuration for node, link,
+subcatchment, options, aquifer, snowmelt, AMM, RTK, and LID families.
+
+```typescript
+import { type Simulation } from "@swmmrs/swmmrs";
+
+export async function configureSpecialized(simulation: Simulation) {
+	await simulation.aquifers.get("A1").configure({ waterTableElevation: 10 });
+	await simulation.snowmeltSets.get("Snow").configureSurface("pervious", {
+		baseTemperature: 0,
+	});
+	await simulation.ammModels.get("M1").configure({ hotTemperature: 30 });
+	await simulation.unitHydrographs.get("UH1").configure({ rainGage: "Rain" });
+	await simulation.replaceAmmAssignments([
+		{ node: "J1", model: "M1", area: 1 },
+	]);
+	await simulation.replaceRdiiAssignments([
+		{ node: "J1", unitHydrograph: "UH1", area: 1 },
+	]);
+	await simulation.lidControls.get("Bio").configure("surface", {
+		roughness: 0.1,
+	});
+	const unit = await simulation.subcatchments.get("S1").lidUnits.access(0);
+	await unit.configure({ count: 2 });
+}
+```
+
+Definition collections such as `timeSeries` expose read-only identity handles.
+They do not provide editable time-series definitions. Change those definitions
+in the INP and open a new owner. See [specialized families](../docs/javascript/api/collections.md#specialized-families).
+
+## Quality, statistics, and output
+
+Use `node.quality()`, `link.quality()`, or `subcatchment.quality()` for current
+pollutant values. The matching collections provide quality snapshots. Per-object
+statistics and family statistics snapshots are available while the run is
+`running` or `complete`. Capture `simulation.statistics()` before `finish()`
+for system totals, diagnostics, continuity errors, and pollutant balances.
+
+For report-period time series, pass finalized or valid incomplete output bytes to
+the standalone `OutputReader`. It provides immutable metadata, exact-case name
+selectors or integer indexes, integer or `ModelTime` half-open bounds,
+`lowMemory` reads, duplicate selections, and system or family series:
+
+```typescript
+import { OutputReader, type FileContents } from "@swmmrs/swmmrs";
+
+export async function readOutput(output: FileContents) {
+	const reader = await OutputReader.open(output);
+	try {
+		return await reader.nodeSeries("J1", "invert_depth");
+	} finally {
+		await reader.close();
+	}
+}
+```
+
+See [binary output reader](../docs/javascript/api/output.md).
+
+## Lifecycle and scenarios
+
+`resetSolver()` clears stale run and output state while retaining declarations and
+returns the owner to `open`. `sleepWorkers()` asks active Dynamic Wave workers to
+sleep while `running`. `terminate()` cooperatively ends an active iterator at
+its next observation boundary. `run()` and `runSwmm()` are single native worker
+requests with no progress callback, `AbortSignal`, or hard interrupt. `close()`
+is cleanup, not interruption.
+
+For continuation, use `saveHotstart()` and `useHotstart(bytes)` for selected EPA
+`.hsf` physical state. Use `saveCheckpoint()` for a complete `CheckpointBundle`
+containing a manifest and sidecar/dependency bytes, then `Simulation.resume(bundle)`
+for fuller continuation. `fork()` creates an independent in-process child.
+`loadCheckpointState(bundle)` loads classified warm state into an already opened
+compatible receiver, which keeps its own dates, declarations, forcings,
+accounting, and output history. The native checkpoint JSON alone is not a complete
+JavaScript bundle. See [hotstarts, checkpoints, and forks](../docs/javascript/guides/checkpoints-and-forks.md).
+
+## Browser assets and threads
+
+Serve `index.js`, `worker.js`, the generated `lib/` directory, and all of `dist/`,
+including `dist/snippets/` and `dist/serial/`, from the same build. Serve `.wasm`
+with `Content-Type: application/wasm`. Both WASM builds expose the same API.
+
+Serial browser execution with `threads: 1` needs no cross-origin isolation.
+Browser `threads > 1` requires these response headers and
+`globalThis.crossOriginIsolated === true`:
+
+```text
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+Cross-Origin-Resource-Policy: same-origin
+```
+
+Browser defaults are `navigator.hardwareConcurrency || 1` on an isolated page and
+`1` otherwise. Node defaults to `1`; explicit counts use `worker_threads` when
+within host capacity. The browser setup has been tested with Chromium, not every
+browser or bundler.
+
+## Handle errors
+
+Native failures preserve `code`, `operation`, and partial `report` when available.
+Catch `SwmmError` or a specific `SolverError`, `LifecycleError`, `ValidationError`,
+`ObjectNotFoundError`, `WorkerError`, or `OutputError`. JavaScript-side type and
+range failures use `TypeError` or `RangeError`. Close failed owners and open a new
+one for retries.
+
+## Run checks
+
+The commands below build their WASM prerequisites:
+
+```sh
+npm run typecheck
+npx playwright install chromium
+npm test
+npm run test:package
+npm run test:docs
+```
+
+Set `CHROMIUM_PATH` to use an installed Chromium executable. Browser tests run
+WASM and include serial and parallel paths. The documentation checker type-checks
+all `typescript` fences as standalone modules.
+
+## Find the implementation
+
+`src/swmmrs` holds the public TypeScript API, including simulation ownership,
+objects, snapshots, output, and exceptions. `protocol.ts`, `client.ts`, and
+`worker.ts` are private worker plumbing. `src/native` contains Rust adapters
+organized by object family. The root `index.d.ts` re-exports declarations built
+from the TypeScript source.

package/dist/serial/swmmrs.d.ts

@@ -0,0 +1,395 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Standalone reader owning one validated SWMM output byte buffer.
+ */
+export class OutputReader {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Opens and validates one finalized or recoverable output byte buffer.
+     */
+    constructor(bytes: Uint8Array);
+    /**
+     * Reads one link series identified by an already-resolved index/code pair.
+     */
+    outputLinkSeries(index: number, code: number, start: number, end: number): any;
+    /**
+     * Returns immutable output metadata.
+     */
+    outputMetadata(): any;
+    /**
+     * Reads one node series identified by an already-resolved index/code pair.
+     */
+    outputNodeSeries(index: number, code: number, start: number, end: number): any;
+    /**
+     * Reads selected cells through the deduplicated adjacent-run strategy.
+     */
+    outputReadBulkSeries(selections: any, start: number, end: number): any;
+    /**
+     * Reads selected cells through one complete payload per period.
+     */
+    outputReadBulkSeriesByPeriod(selections: any, start: number, end: number): any;
+    /**
+     * Reads exact stored report-date serial values over a period range.
+     */
+    outputReadStoredDates(start: number, end: number): any;
+    /**
+     * Reads one subcatchment series identified by an already-resolved index/code pair.
+     */
+    outputSubcatchmentSeries(index: number, code: number, start: number, end: number): any;
+    /**
+     * Reads one system series identified by its stored result code.
+     */
+    outputSystemSeries(code: number, start: number, end: number): any;
+}
+
+/**
+ * An isolated project. Call close before freeing it to report cleanup errors.
+ */
+export class Simulation {
+    free(): void;
+    [Symbol.dispose](): void;
+    ammAssignments(): any;
+    ammModelConfiguration(id: string): any;
+    aquiferConfiguration(id: string): any;
+    close(): void;
+    configureAmmModel(id: string, patch: any): void;
+    configureAquifer(id: string, value: any): void;
+    configureLidControl(id: string, layer: string, patch: any): void;
+    configureLidUnit(subcatchment_id: string, unit_index: number, patch: any): void;
+    configureLink(id: string, patch: any): void;
+    configureNode(id: string, patch: any): void;
+    configureOptions(patch: any): void;
+    configureSnowmelt(id: string, value: any): void;
+    configureSnowmeltSurface(id: string, surface: string, value: any): void;
+    configureSubcatchment(id: string, patch: any): void;
+    configureUnitHydrograph(id: string, patch: any): void;
+    /**
+     * Ends computation and flushes output and summary statistics without detailed report tables.
+     */
+    end(): void;
+    /**
+     * Publishes the complete core checkpoint and detaches it into bytes.
+     */
+    exportCheckpoint(): any;
+    /**
+     * Appends only the runtime footer to an ended run's summary report.
+     */
+    finalizeReport(): void;
+    /**
+     * Finalizes binary output, requested detailed report tables, and the runtime footer.
+     */
+    finish(): void;
+    /**
+     * Project units, object IDs, and the effective hydraulic lane count.
+     */
+    info(): any;
+    inletResults(id: string): any;
+    lidControlConfiguration(id: string): any;
+    lidUnitConfiguration(subcatchment_id: string, unit_index: number): any;
+    lidUnitCount(subcatchment_id: string): number;
+    lidUnitSnapshot(subcatchment_id: string, unit_index: number): any;
+    link(id: string): any;
+    linkConfiguration(id: string): any;
+    linkExternalPollutantMassFlux(id: string): any;
+    linkExternalPollutantMassFluxValue(id: string, pollutant_id: string): number;
+    /**
+     * Returns the complete optional inlet placement owned by a link.
+     */
+    linkInlet(id: string): any;
+    linkQuality(id: string): any;
+    linkQualitySnapshot(ids?: string[] | null): any;
+    linkStatistics(id: string): any;
+    linkStatisticsSnapshot(ids?: string[] | null): any;
+    links(ids?: string[] | null): any;
+    /**
+     * Imports only the core physical checkpoint state into this open owner.
+     */
+    loadCheckpointState(value: any): void;
+    maximumRoutingStepSeconds(): number;
+    /**
+     * Input and external files are bytes; external names are relative to the model.
+     */
+    constructor(input: Uint8Array, files: any);
+    node(id: string): any;
+    nodeConfiguration(id: string): any;
+    nodeExternalInflow(id: string): number;
+    nodeExternalPollutantMassFlux(id: string): any;
+    nodeExternalPollutantMassFluxValue(id: string, pollutant_id: string): number;
+    nodeQuality(id: string): any;
+    nodeQualitySnapshot(ids?: string[] | null): any;
+    nodeStatistics(id: string): any;
+    nodeStatisticsSnapshot(ids?: string[] | null): any;
+    nodeTotalInflowVolume(id: string): number;
+    /**
+     * One coherent columnar snapshot, preserving the requested ID order.
+     */
+    nodes(ids?: string[] | null): any;
+    options(): any;
+    outfallFixedStage(id: string): any;
+    outfallStatistics(id: string): any;
+    overrideLinkPollutantConcentrations(id: string, values: any): void;
+    overrideNodePollutantConcentrations(id: string, values: any): void;
+    pumpStatistics(id: string): any;
+    rainGage(id: string): any;
+    rainGageExternalPrecipitationRate(id: string): any;
+    rainGageRainfallOverride(id: string): any;
+    rdiiAssignments(): any;
+    /**
+     * Reads an input or generated file before close removes the project.
+     */
+    readFile(name: string): Uint8Array;
+    replaceAmmAssignments(assignments: any): void;
+    replaceRdiiAssignments(assignments: any): void;
+    /**
+     * Generates the requested report tables and footer on demand.
+     */
+    report(): void;
+    resetSolver(): void;
+    static resumeCheckpoint(value: any): Simulation;
+    /**
+     * Runs to completion without a worker message for every routing step.
+     */
+    run(save_results?: boolean | null): void;
+    /**
+     * Writes an EPA hotstart from the current active run and returns its bytes.
+     */
+    saveHotstart(): Uint8Array;
+    setLinkFlowLimit(id: string, value: any): void;
+    setLinkTargetSetting(id: string, setting: any): void;
+    setNodeExternalInflow(id: string, flow: any): void;
+    setOutfallStage(id: string, value: any): void;
+    setRainGagePrecipitation(id: string, value: any): void;
+    setRainGageRainfallOverride(id: string, value: any): void;
+    setSubcatchmentExternalRainfall(id: string, value: any): void;
+    setSubcatchmentExternalSnowfall(id: string, value: any): void;
+    setSubcatchmentPrecipitationScaleFactors(id: string, rainfall: any, snowfall: any): void;
+    sleepWorkers(): void;
+    snowmeltConfiguration(id: string): any;
+    snowmeltSurfaceConfiguration(id: string, surface: string): any;
+    start(save_results?: boolean | null): void;
+    statistics(): any;
+    /**
+     * Lifecycle, model-time, progress, and warning state in one owner read.
+     */
+    status(): any;
+    /**
+     * Timezone-free model timestamp, or undefined at natural completion.
+     */
+    step(): string | undefined;
+    storageStatistics(id: string): any;
+    /**
+     * Advances by a positive whole number of seconds.
+     */
+    stride(seconds: number, strict: boolean): string | undefined;
+    subcatchment(id: string): any;
+    subcatchmentConfiguration(id: string): any;
+    subcatchmentExternalForcing(id: string): any;
+    subcatchmentExternalPollutantBuildupIncrement(id: string): any;
+    subcatchmentExternalPollutantBuildupIncrementValue(id: string, pollutant_id: string): number;
+    subcatchmentLidSnapshot(subcatchment_id: string): any;
+    subcatchmentNamedSetting(id: string, kind: string, name: string): number;
+    subcatchmentNamedSettings(id: string, kind: string): any;
+    subcatchmentPrecipitationScaleFactors(id: string): any;
+    subcatchmentQuality(id: string): any;
+    subcatchmentQualitySnapshot(ids?: string[] | null): any;
+    subcatchmentStatistics(id: string): any;
+    subcatchmentStatisticsSnapshot(ids?: string[] | null): any;
+    subcatchments(ids?: string[] | null): any;
+    unitHydrographConfiguration(id: string): any;
+    updateInlet(id: string, patch: any): void;
+    updateLinkExternalPollutantMassFlux(id: string, values: any, replace: boolean): void;
+    updateNodeExternalPollutantMassFlux(id: string, values: any, replace: boolean): void;
+    updateSchedule(patch: any): void;
+    updateSubcatchmentExternalPollutantBuildupIncrement(id: string, values: any, replace: boolean): void;
+    updateSubcatchmentNamedSettings(id: string, kind: string, values: any, replace: boolean): void;
+    /**
+     * Configures or clears an EPA hotstart input from caller-owned bytes.
+     */
+    useHotstart(value: any): void;
+    useRainGageExternalPrecipitation(id: string, value: any): void;
+    readonly state: string;
+}
+
+/**
+ * Validates the single caller lane without creating Workers.
+ *
+ * # Arguments
+ * * `threads` - Requested caller-inclusive capacity, which must be one.
+ * * `module_url` - Generated JavaScript entry URL, unused without Workers.
+ *
+ * # Returns
+ * Success when the requested capacity is one.
+ *
+ * # Errors
+ * Rejects any capacity other than one.
+ */
+export function initThreadPool(threads: number, module_url: string): Promise<void>;
+
+/**
+ * Completes shutdown without releasing resources because no Workers exist.
+ *
+ * # Returns
+ * Success for every call.
+ */
+export function terminateThreadPool(): void;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_simulation_free: (a: number, b: number) => void;
+    readonly simulation_close: (a: number, b: number) => void;
+    readonly simulation_end: (a: number, b: number) => void;
+    readonly simulation_finalizeReport: (a: number, b: number) => void;
+    readonly simulation_finish: (a: number, b: number) => void;
+    readonly simulation_info: (a: number, b: number) => void;
+    readonly simulation_link: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_links: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_new: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_node: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodes: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_readFile: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_report: (a: number, b: number) => void;
+    readonly simulation_resetSolver: (a: number, b: number) => void;
+    readonly simulation_run: (a: number, b: number, c: number) => void;
+    readonly simulation_setLinkTargetSetting: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_setNodeExternalInflow: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_sleepWorkers: (a: number, b: number) => void;
+    readonly simulation_start: (a: number, b: number, c: number) => void;
+    readonly simulation_state: (a: number, b: number) => void;
+    readonly simulation_step: (a: number, b: number) => void;
+    readonly simulation_stride: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_configureLink: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_inletResults: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkExternalPollutantMassFlux: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkExternalPollutantMassFluxValue: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_linkInlet: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkQuality: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkQualitySnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkStatistics: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_linkStatisticsSnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_overrideLinkPollutantConcentrations: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_pumpStatistics: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_setLinkFlowLimit: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_updateInlet: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_updateLinkExternalPollutantMassFlux: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_configureSubcatchment: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_rainGage: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_rainGageExternalPrecipitationRate: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_rainGageRainfallOverride: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_setRainGagePrecipitation: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_setRainGageRainfallOverride: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_setSubcatchmentExternalRainfall: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_setSubcatchmentExternalSnowfall: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_setSubcatchmentPrecipitationScaleFactors: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_subcatchment: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentExternalForcing: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentExternalPollutantBuildupIncrement: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentExternalPollutantBuildupIncrementValue: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_subcatchmentNamedSetting: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly simulation_subcatchmentNamedSettings: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_subcatchmentPrecipitationScaleFactors: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentQuality: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentQualitySnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentStatistics: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchmentStatisticsSnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_subcatchments: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_updateSubcatchmentExternalPollutantBuildupIncrement: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_updateSubcatchmentNamedSettings: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly simulation_useRainGageExternalPrecipitation: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_configureNode: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_nodeConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeExternalInflow: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeExternalPollutantMassFlux: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeExternalPollutantMassFluxValue: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_nodeQuality: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeQualitySnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeStatistics: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeStatisticsSnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_nodeTotalInflowVolume: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_outfallFixedStage: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_outfallStatistics: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_overrideNodePollutantConcentrations: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_setOutfallStage: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_storageStatistics: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_updateNodeExternalPollutantMassFlux: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_configureLidControl: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly simulation_configureLidUnit: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_lidControlConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_lidUnitConfiguration: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_lidUnitCount: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_lidUnitSnapshot: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_subcatchmentLidSnapshot: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_configureOptions: (a: number, b: number, c: number) => void;
+    readonly simulation_maximumRoutingStepSeconds: (a: number, b: number) => void;
+    readonly simulation_options: (a: number, b: number) => void;
+    readonly simulation_statistics: (a: number, b: number) => void;
+    readonly simulation_status: (a: number, b: number) => void;
+    readonly simulation_updateSchedule: (a: number, b: number, c: number) => void;
+    readonly __wbg_outputreader_free: (a: number, b: number) => void;
+    readonly outputreader_new: (a: number, b: number, c: number) => void;
+    readonly outputreader_outputLinkSeries: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly outputreader_outputMetadata: (a: number, b: number) => void;
+    readonly outputreader_outputNodeSeries: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly outputreader_outputReadBulkSeries: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly outputreader_outputReadBulkSeriesByPeriod: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly outputreader_outputReadStoredDates: (a: number, b: number, c: number, d: number) => void;
+    readonly outputreader_outputSubcatchmentSeries: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly outputreader_outputSystemSeries: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_exportCheckpoint: (a: number, b: number) => void;
+    readonly simulation_loadCheckpointState: (a: number, b: number, c: number) => void;
+    readonly simulation_resumeCheckpoint: (a: number, b: number) => void;
+    readonly simulation_saveHotstart: (a: number, b: number) => void;
+    readonly simulation_useHotstart: (a: number, b: number, c: number) => void;
+    readonly simulation_ammAssignments: (a: number, b: number) => void;
+    readonly simulation_ammModelConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_aquiferConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_configureAmmModel: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_configureAquifer: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_configureSnowmelt: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_configureSnowmeltSurface: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly simulation_configureUnitHydrograph: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly simulation_rdiiAssignments: (a: number, b: number) => void;
+    readonly simulation_replaceAmmAssignments: (a: number, b: number, c: number) => void;
+    readonly simulation_replaceRdiiAssignments: (a: number, b: number, c: number) => void;
+    readonly simulation_snowmeltConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly simulation_snowmeltSurfaceConfiguration: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly simulation_unitHydrographConfiguration: (a: number, b: number, c: number, d: number) => void;
+    readonly initThreadPool: (a: number, b: number, c: number) => number;
+    readonly terminateThreadPool: (a: number) => void;
+    readonly __wasm_bindgen_func_elem_6787: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_6789: (a: number, b: number, c: number, d: number) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_export4: (a: number, b: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+    readonly __wbindgen_export5: (a: number, b: number, c: number) => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;