@sdeverywhere/runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020-2022 Climate Interactive / New Venture Fund
+
+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:
+
+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/README.md

@@ -0,0 +1,118 @@
+# @sdeverywhere/runtime
+
+This package provides a simplified API around a system dynamics model that
+has been produced by [SDEverywhere](https://github.com/climateinteractive/SDEverywhere)
+and compiled to a WebAssembly (Wasm) module via [Emscripten](https://emscripten.org).
+
+## Usage
+
+### 1. Initialize the `WasmModel`
+
+In your application, load the wasm module using the wrapper produced by
+Emscripten, then pass it to `initWasmModelAndBuffers`.
+This will create the `WasmModel` and `WasmBuffer` instances that will be
+used in the next step to initalize the `ModelRunner`.
+
+```ts
+import { initWasmModelAndBuffers, WasmModelInitResult } from '@sdeverywhere/runtime'
+import loadWasm from './generated/mymodel'
+
+// These are the same lists (and must be in the same order) as the spec file passed to `sde`.
+const inputVarNames = [] // from spec.json
+const outputVarNames = [] // from spec.json
+
+async function initWasmModel(): Promise<WasmModelInitResult> {
+  // Load the wasm module asynchronously
+  const wasmModule = await loadWasm()
+
+  // Initialize the wasm model and its associated buffers
+  return initWasmModelAndBuffers(wasmModule, inputVarNames.length, outputVarNames, 2000, 2100)
+}
+```
+
+### 2. Initialize the `ModelRunner`
+
+The next step is to create a `ModelRunner` instance, which simplifies
+the process of running a `WasmModel` with a given set of inputs and
+parsing the outputs.
+The `ModelRunner` produces an `Outputs` instance that provides easy
+access to time series data for each output variable in the model.
+The `createWasmModelRunner` function is the simplest way to create
+a `ModelRunner` that works with your `WasmModel`:
+
+```ts
+import { createWasmModelRunner, createInputValue, Outputs } from '@sdeverywhere/runtime'
+
+async function main() {
+  // Initialize the `WasmModel` and `ModelRunner`
+  const wasmResult = await initWasmModel()
+  const modelRunner = createWasmModelRunner(wasmResult)
+
+  // Create a set of `InputValue` instances corresponding to the inputs in the spec.json file
+  const inputs = [createInputValue('_input1', 2), createInputValue('_input2', 10)] // etc
+
+  // Create an `Outputs` instance to hold the model outputs
+  let outputs = new Outputs(wasmResult.outputVarIds, wasmResult.startTime, wasmResult.endTime)
+
+  // Run the model with those inputs
+  outputs = await modelRunner.runModel(inputs, outputs)
+
+  // Get the time series data and/or a specific value for a given output variable
+  const series = outputs.getSeriesForVar('_temperature_change_from_1850')
+  const tempChangeIn2100 = series.getValueAtTime(2100)
+  console.log(`Temperature change in 2100: ${tempChangeIn2100}`)
+```
+
+See the `@sdeverywhere/runtime-async` package for an alternative
+implementation of `ModelRunner` that allows for running a model in a Web
+Worker or Node.js worker thread.
+
+### 3. Initialize a `ModelScheduler` (optional)
+
+If you build a more complex application with a user interface around a
+model, the `ModelScheduler` class takes care of automatically scheduling
+and running the model whenever there are changes to input variables:
+
+```ts
+import { ModelScheduler } from '@sdeverywhere/runtime'
+
+async function initModel() {
+  // Initialize the `WasmModel`, `ModelRunner`, inputs, and outputs as above
+  const modelScheduler = new ModelScheduler(modelRunner, inputs, outputs)
+
+  // Get notified when new output data is available
+  modelScheduler.onOutputsChanged = newOutputs => {
+    // Update the user interface to reflect the new output data, etc
+  }
+
+  // When you change the value of an input, the scheduler will automatically
+  // run the model and call `onOutputsChanged` when new outputs are ready
+  inputs[0].set(3)
+}
+```
+
+## Emscripten Notes
+
+The `@sdeverywhere/runtime` package assumes you have created `<mymodel>.wasm`
+and `<mymodel>.js` files with Emscripten.
+The `emcc` command line options should be similar to the following:
+
+```
+$ emcc \
+build/<mymodel>.c build/macros.c build/model.c build/vensim.c \
+-Ibuild -o ./output/<mymodel>.js -Wall -Os \
+-s STRICT=1 -s MALLOC=emmalloc -s FILESYSTEM=0 -s MODULARIZE=1 \
+-s EXPORTED_FUNCTIONS="['_runModelWithBuffers', '_malloc']" \
+-s EXPORTED_RUNTIME_METHODS="['cwrap']"
+```
+
+(The generated module must export at minimum `_runModelWithBuffers`,
+`_malloc`, and `cwrap`.)
+
+## Documentation
+
+API documentation is available in the [`docs`](./docs/index.md) directory.
+
+## License
+
+SDEverywhere is distributed under the MIT license. See `LICENSE` for more details.

package/dist/index.cjs

@@ -0,0 +1,335 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ModelScheduler: () => ModelScheduler,
+  Outputs: () => Outputs,
+  Series: () => Series,
+  WasmBuffer: () => WasmBuffer,
+  WasmModel: () => WasmModel,
+  createInputValue: () => createInputValue,
+  createWasmModelRunner: () => createWasmModelRunner,
+  initWasmModelAndBuffers: () => initWasmModelAndBuffers,
+  perfElapsed: () => perfElapsed,
+  perfNow: () => perfNow
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/wasm-model/wasm-buffer.ts
+var WasmBuffer = class {
+  constructor(wasmModule, numElements) {
+    this.wasmModule = wasmModule;
+    const sizeOfFloat64 = 8;
+    const lengthInBytes = numElements * sizeOfFloat64;
+    this.byteOffset = wasmModule._malloc(lengthInBytes);
+    const float64Offset = this.byteOffset / sizeOfFloat64;
+    this.heapArray = wasmModule.HEAPF64.subarray(float64Offset, float64Offset + numElements);
+  }
+  getArrayView() {
+    return this.heapArray;
+  }
+  getAddress() {
+    return this.byteOffset;
+  }
+  dispose() {
+    if (this.heapArray) {
+      this.wasmModule._free(this.byteOffset);
+      this.heapArray = void 0;
+      this.byteOffset = void 0;
+    }
+  }
+};
+
+// src/wasm-model/wasm-model.ts
+var WasmModel = class {
+  constructor(wasmModule) {
+    this.wasmRunModel = wasmModule.cwrap("runModelWithBuffers", null, ["number", "number"]);
+  }
+  runModel(inputs, outputs) {
+    this.wasmRunModel(inputs.getAddress(), outputs.getAddress());
+  }
+};
+function initWasmModelAndBuffers(wasmModule, numInputs, outputVarIds, startTime, endTime) {
+  const model = new WasmModel(wasmModule);
+  const inputsBuffer = new WasmBuffer(wasmModule, numInputs);
+  const seriesLength = endTime - startTime + 1;
+  const outputsBuffer = new WasmBuffer(wasmModule, outputVarIds.length * seriesLength);
+  return {
+    model,
+    inputsBuffer,
+    outputsBuffer,
+    outputVarIds,
+    startTime,
+    endTime
+  };
+}
+
+// src/model-runner/inputs.ts
+function createInputValue(varId, defaultValue, initialValue) {
+  let currentValue = initialValue !== void 0 ? initialValue : defaultValue;
+  const callbacks = {};
+  const get = () => {
+    return currentValue;
+  };
+  const set = (newValue) => {
+    var _a;
+    if (newValue !== currentValue) {
+      currentValue = newValue;
+      (_a = callbacks.onSet) == null ? void 0 : _a.call(callbacks);
+    }
+  };
+  const reset = () => {
+    set(defaultValue);
+  };
+  return { varId, get, set, reset, callbacks };
+}
+
+// src/model-runner/outputs.ts
+var import_neverthrow = require("neverthrow");
+var Series = class {
+  constructor(varId, points) {
+    this.varId = varId;
+    this.points = points;
+  }
+  getValueAtTime(time) {
+    var _a;
+    const startTime = this.points[0].x;
+    return (_a = this.points[time - startTime]) == null ? void 0 : _a.y;
+  }
+  copy() {
+    const pointsCopy = this.points.map((p) => __spreadValues({}, p));
+    return new Series(this.varId, pointsCopy);
+  }
+};
+var Outputs = class {
+  constructor(varIds, timeStart, timeEnd) {
+    this.varIds = varIds;
+    this.timeStart = timeStart;
+    this.timeEnd = timeEnd;
+    this.seriesLength = timeEnd - timeStart + 1;
+    this.varSeries = new Array(varIds.length);
+    for (let i = 0; i < varIds.length; i++) {
+      const points = new Array(this.seriesLength);
+      let time = timeStart;
+      for (let j = 0; j < this.seriesLength; j++) {
+        points[j] = { x: time++, y: 0 };
+      }
+      const varId = varIds[i];
+      this.varSeries[i] = new Series(varId, points);
+    }
+  }
+  updateFromBuffer(outputsBuffer, rowLength) {
+    const result = parseOutputsBuffer(outputsBuffer, rowLength, this);
+    if (result.isOk()) {
+      return (0, import_neverthrow.ok)(void 0);
+    } else {
+      return (0, import_neverthrow.err)(result.error);
+    }
+  }
+  getSeriesForVar(varId) {
+    const seriesIndex = this.varIds.indexOf(varId);
+    if (seriesIndex >= 0) {
+      return this.varSeries[seriesIndex];
+    } else {
+      return void 0;
+    }
+  }
+};
+function parseOutputsBuffer(outputsBuffer, rowLength, outputs) {
+  const varCount = outputs.varIds.length;
+  const seriesLength = outputs.seriesLength;
+  if (rowLength < seriesLength || outputsBuffer.length < varCount * seriesLength) {
+    return (0, import_neverthrow.err)("invalid-point-count");
+  }
+  for (let outputVarIndex = 0; outputVarIndex < varCount; outputVarIndex++) {
+    const series = outputs.varSeries[outputVarIndex];
+    let sourceIndex = rowLength * outputVarIndex;
+    for (let valueIndex = 0; valueIndex < seriesLength; valueIndex++) {
+      series.points[valueIndex].y = validateNumber(outputsBuffer[sourceIndex]);
+      sourceIndex++;
+    }
+  }
+  return (0, import_neverthrow.ok)(outputs);
+}
+function validateNumber(x) {
+  if (!isNaN(x) && x > -1e32) {
+    return x;
+  } else {
+    return void 0;
+  }
+}
+
+// src/model-runner/perf.ts
+var isWeb;
+function perfNow() {
+  if (isWeb === void 0) {
+    isWeb = typeof self !== "undefined" && (self == null ? void 0 : self.performance) !== void 0;
+  }
+  if (isWeb) {
+    return self.performance.now();
+  } else {
+    return process == null ? void 0 : process.hrtime();
+  }
+}
+function perfElapsed(t0) {
+  if (isWeb) {
+    const t1 = self.performance.now();
+    return t1 - t0;
+  } else {
+    const elapsed = process.hrtime(t0);
+    return (elapsed[0] * 1e9 + elapsed[1]) / 1e6;
+  }
+}
+
+// src/model-runner/model-runner.ts
+function createWasmModelRunner(wasmResult) {
+  const wasmModel = wasmResult.model;
+  const inputsBuffer = wasmResult.inputsBuffer;
+  const inputsArray = inputsBuffer.getArrayView();
+  const outputsBuffer = wasmResult.outputsBuffer;
+  const outputsArray = outputsBuffer.getArrayView();
+  const rowLength = wasmResult.endTime - wasmResult.startTime + 1;
+  let terminated = false;
+  const runModelSync = (inputs, outputs) => {
+    let i = 0;
+    for (const input of inputs) {
+      inputsArray[i++] = input.get();
+    }
+    const t0 = perfNow();
+    wasmModel.runModel(inputsBuffer, outputsBuffer);
+    outputs.runTimeInMillis = perfElapsed(t0);
+    outputs.updateFromBuffer(outputsArray, rowLength);
+    return outputs;
+  };
+  return {
+    runModel: (inputs, outputs) => {
+      if (terminated) {
+        return Promise.reject(new Error("Model runner has already been terminated"));
+      }
+      return Promise.resolve(runModelSync(inputs, outputs));
+    },
+    runModelSync: (inputs, outputs) => {
+      if (terminated) {
+        throw new Error("Model runner has already been terminated");
+      }
+      return runModelSync(inputs, outputs);
+    },
+    terminate: () => {
+      if (!terminated) {
+        terminated = true;
+      }
+      return Promise.resolve();
+    }
+  };
+}
+
+// src/model-scheduler/model-scheduler.ts
+var ModelScheduler = class {
+  constructor(runner, userInputs, outputs) {
+    this.runner = runner;
+    this.userInputs = userInputs;
+    this.outputs = outputs;
+    this.runNeeded = false;
+    this.runInProgress = false;
+    const afterSet = () => {
+      this.runWasmModelIfNeeded();
+    };
+    for (const userInput of userInputs) {
+      userInput.callbacks.onSet = afterSet;
+    }
+    this.currentInputs = [];
+    for (const userInput of userInputs) {
+      this.currentInputs.push(createSimpleInputValue(userInput.varId));
+    }
+  }
+  runWasmModelIfNeeded() {
+    this.runNeeded = true;
+    if (this.runInProgress) {
+      return;
+    } else {
+      this.runInProgress = true;
+      setTimeout(() => {
+        this.runWasmModelNow();
+      }, 0);
+    }
+  }
+  async runWasmModelNow() {
+    var _a;
+    for (let i = 0; i < this.userInputs.length; i++) {
+      this.currentInputs[i].set(this.userInputs[i].get());
+    }
+    try {
+      this.outputs = await this.runner.runModel(this.currentInputs, this.outputs);
+      (_a = this.onOutputsChanged) == null ? void 0 : _a.call(this, this.outputs);
+    } catch (e) {
+      console.error(`ERROR: Failed to run model: ${e.message}`);
+    }
+    if (this.runNeeded) {
+      this.runNeeded = false;
+      setTimeout(() => {
+        this.runWasmModelNow();
+      }, 0);
+    } else {
+      this.runNeeded = false;
+      this.runInProgress = false;
+    }
+  }
+};
+function createSimpleInputValue(varId) {
+  let currentValue = 0;
+  const get = () => {
+    return currentValue;
+  };
+  const set = (newValue) => {
+    currentValue = newValue;
+  };
+  const reset = () => {
+    set(0);
+  };
+  return { varId, get, set, reset, callbacks: {} };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ModelScheduler,
+  Outputs,
+  Series,
+  WasmBuffer,
+  WasmModel,
+  createInputValue,
+  createWasmModelRunner,
+  initWasmModelAndBuffers,
+  perfElapsed,
+  perfNow
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/wasm-model/wasm-buffer.ts","../src/wasm-model/wasm-model.ts","../src/model-runner/inputs.ts","../src/model-runner/outputs.ts","../src/model-runner/perf.ts","../src/model-runner/model-runner.ts","../src/model-scheduler/model-scheduler.ts"],"sourcesContent":["// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nexport type { InputVarId, OutputVarId } from './_shared'\nexport * from './wasm-model'\nexport * from './model-runner'\nexport * from './model-scheduler'\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { WasmModule } from './wasm-module'\n\n/**\n * Wraps a `WebAssembly.Memory` buffer allocated on the wasm heap.\n *\n * When this is used synchronously (in the browser's normal JavaScript thread),\n * the client can use `getArrayView` to write directly into the underlying memory.\n *\n * Note, however, that `WebAssembly.Memory` buffers cannot be transferred to/from\n * a Web Worker.  When using this class in a worker thread, create a separate\n * `Float64Array` that can be transferred between the worker and the client running\n * in the browser's normal JS thread, and then use `getArrayView` to copy into and\n * out of the wasm buffer.\n */\nexport class WasmBuffer {\n  private byteOffset: number\n  private heapArray: Float64Array\n\n  /**\n   * @param wasmModule The `WasmModule` used to initialize the memory.\n   * @param numElements The number of 64-bit `double` elements in the buffer.\n   */\n  constructor(private readonly wasmModule: WasmModule, numElements: number) {\n    const sizeOfFloat64 = 8\n    const lengthInBytes = numElements * sizeOfFloat64\n    this.byteOffset = wasmModule._malloc(lengthInBytes)\n    const float64Offset = this.byteOffset / sizeOfFloat64\n    this.heapArray = wasmModule.HEAPF64.subarray(float64Offset, float64Offset + numElements)\n  }\n\n  /**\n   * @return A new `Float64Array` view on the underlying heap buffer.\n   */\n  getArrayView(): Float64Array {\n    return this.heapArray\n  }\n\n  /**\n   * @return The raw address of the underlying heap buffer.\n   * @hidden This is intended for use by `WasmModel` only.\n   */\n  getAddress(): number {\n    return this.byteOffset\n  }\n\n  /**\n   * Dispose the buffer by freeing the allocated heap memory.\n   */\n  dispose(): void {\n    if (this.heapArray) {\n      this.wasmModule._free(this.byteOffset)\n      this.heapArray = undefined\n      this.byteOffset = undefined\n    }\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { OutputVarId } from '../_shared'\nimport { WasmBuffer } from './wasm-buffer'\nimport type { WasmModule } from './wasm-module'\n\n/**\n * An interface to the En-ROADS model.  Allows for running the model with\n * a given set of input values, producing a set of output values.\n */\nexport class WasmModel {\n  private readonly wasmRunModel: (inputsAddress: number, outputsAddress: number) => void\n\n  /**\n   * @param wasmModule The `WasmModule` containing the `runModelWithBuffers` function.\n   */\n  constructor(wasmModule: WasmModule) {\n    this.wasmRunModel = wasmModule.cwrap('runModelWithBuffers', null, ['number', 'number'])\n  }\n\n  /**\n   * Run the model, using inputs from the `inputs` buffer, and writing outputs into\n   * the `outputs` buffer.\n   *\n   * @param inputs The buffer containing inputs in the order expected by the model.\n   * @param outputs The buffer into which the model will store output values.\n   */\n  runModel(inputs: WasmBuffer, outputs: WasmBuffer): void {\n    this.wasmRunModel(inputs.getAddress(), outputs.getAddress())\n  }\n}\n\n/**\n * The result of model initialization.\n */\nexport interface WasmModelInitResult {\n  /** The wasm model. */\n  model: WasmModel\n  /** The buffer used to pass input values to the model. */\n  inputsBuffer: WasmBuffer\n  /** The buffer used to receive output values from the model. */\n  outputsBuffer: WasmBuffer\n  /** The output variable IDs. */\n  outputVarIds: OutputVarId[]\n  /** The start time (year) for the model. */\n  startTime: number\n  /** The end time (year) for the model. */\n  endTime: number\n}\n\n/**\n * Initialize the wasm model and buffers.\n *\n * @param wasmModule The `WasmModule` that wraps the `wasm` binary.\n * @param numInputs The number of input variables, per the spec file passed to `sde`.\n * @param outputVarIds The output variable IDs, per the spec file passed to `sde`.\n * @param startTime The start time (year) for the model.\n * @param endTime The end time (year) for the model.\n */\nexport function initWasmModelAndBuffers(\n  wasmModule: WasmModule,\n  numInputs: number,\n  outputVarIds: OutputVarId[],\n  startTime: number,\n  endTime: number\n): WasmModelInitResult {\n  // Wrap the native C `runModelWithBuffers` function in a JS function that we can call\n  const model = new WasmModel(wasmModule)\n\n  // Allocate a buffer that is large enough to hold the input values\n  const inputsBuffer = new WasmBuffer(wasmModule, numInputs)\n\n  // Each series will include one data point per year, inclusive of the\n  // start and end years\n  // TODO: We should pull these from the C variables instead of having them passed in;\n  // for now we assume `_saveper` is 1 but that should be pulled from the C variable too\n  const seriesLength = endTime - startTime + 1\n\n  // Allocate a buffer that is large enough to hold the series data for\n  // each output variable\n  const outputsBuffer = new WasmBuffer(wasmModule, outputVarIds.length * seriesLength)\n\n  return {\n    model,\n    inputsBuffer,\n    outputsBuffer,\n    outputVarIds,\n    startTime,\n    endTime\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { InputVarId } from '../_shared'\n\n/** Callback functions that are called when the input value is changed. */\nexport interface InputCallbacks {\n  /** Called after a new value is set. */\n  onSet?: () => void\n}\n\n/**\n * Represents a writable model input.\n */\nexport interface InputValue {\n  /** The ID of the associated input variable, as used in SDEverywhere. */\n  varId: InputVarId\n  /** Get the current value of the input. */\n  get: () => number\n  /** Set the input to the given value. */\n  set: (value: number) => void\n  /** Reset the input to its default value. */\n  reset: () => void\n  /** Callback functions that are called when the input value is changed. */\n  callbacks: InputCallbacks\n}\n\n/**\n * Create a basic `InputValue` instance that notifies when a new value is set.\n *\n * @param varId The input variable ID, as used in SDEverywhere.\n * @param defaultValue The default value of the input.\n * @param initialValue The inital value of the input; if undefined, will use `defaultValue`.\n */\nexport function createInputValue(varId: InputVarId, defaultValue: number, initialValue?: number): InputValue {\n  let currentValue = initialValue !== undefined ? initialValue : defaultValue\n\n  // The `onSet` callback is initially undefined but will be installed by `ModelScheduler`\n  const callbacks: InputCallbacks = {}\n\n  const get = () => {\n    return currentValue\n  }\n\n  const set = (newValue: number) => {\n    if (newValue !== currentValue) {\n      currentValue = newValue\n      callbacks.onSet?.()\n    }\n  }\n\n  const reset = () => {\n    set(defaultValue)\n  }\n\n  return { varId, get, set, reset, callbacks }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { Result } from 'neverthrow'\nimport { ok, err } from 'neverthrow'\nimport type { OutputVarId } from '../_shared'\n\n/** Indicates the type of error encountered when parsing an outputs buffer. */\nexport type ParseError = 'invalid-point-count'\n\n/** A data point. */\nexport interface Point {\n  /** The x value (typically a year). */\n  x: number\n  /** The y value. */\n  y: number\n}\n\n/**\n * A time series of data points for an output variable.\n */\nexport class Series {\n  /**\n   * @param varId The ID for the output variable (as used by SDEverywhere).\n   * @param points The data points for the variable, one point per time increment.\n   */\n  constructor(public readonly varId: OutputVarId, public readonly points: Point[]) {}\n\n  /**\n   * Return the Y value at the given time.\n   *\n   * @param time The x (time) value.\n   */\n  getValueAtTime(time: number): number | undefined {\n    // TODO: This assumes one data point per year; we should take `_saveper` into account\n    // and if it's not 1 point per year, search for a specific x value\n    // TODO: Add option to allow interpolation if the given time value is in between points\n    const startTime = this.points[0].x\n    return this.points[time - startTime]?.y\n  }\n\n  /**\n   * Create a new `Series` instance that is a copy of this one.\n   */\n  copy(): Series {\n    // Create a deep copy\n    const pointsCopy = this.points.map(p => ({ ...p }))\n    return new Series(this.varId, pointsCopy)\n  }\n}\n\n/** Represents the outputs from a model run. */\nexport class Outputs {\n  /** The number of data points in each series. */\n  public readonly seriesLength: number\n  /** The array of series, one for each output variable. */\n  public readonly varSeries: Series[]\n\n  /**\n   * The latest model run time, in milliseconds.\n   * @hidden This is not yet part of the public API; it is exposed here for use\n   * in performance testing tools.\n   */\n  public runTimeInMillis: number\n\n  constructor(\n    public readonly varIds: OutputVarId[],\n    public readonly timeStart: number,\n    public readonly timeEnd: number\n  ) {\n    // Each series will include one data point per year, inclusive of the start and end years\n    this.seriesLength = timeEnd - timeStart + 1\n\n    // Create an array of arrays, one for each output variable\n    this.varSeries = new Array(varIds.length)\n\n    // Populate the arrays, filling in the time for each point\n    for (let i = 0; i < varIds.length; i++) {\n      const points: Point[] = new Array(this.seriesLength)\n      let time = timeStart\n      for (let j = 0; j < this.seriesLength; j++) {\n        points[j] = { x: time++, y: 0 }\n      }\n      const varId = varIds[i]\n      this.varSeries[i] = new Series(varId, points)\n    }\n  }\n\n  /**\n   * Parse the given raw float buffer (produced by the model) and store the values\n   * into this `Outputs` instance.\n   *\n   * Note that the length of `outputsBuffer` must be greater than or equal to\n   * the capacity of this `Outputs` instance.  The `Outputs` instance is allowed\n   * to be smaller to support the case where you want to extract a subset of\n   * the time range in the buffer produced by the model.\n   *\n   * @param outputsBuffer The raw outputs buffer produced by the model.\n   * @param rowLength The number of elements per row (one element per year or save point).\n   * @return An `ok` result if the buffer is valid, otherwise an `err` result.\n   */\n  updateFromBuffer(outputsBuffer: Float64Array, rowLength: number): Result<void, ParseError> {\n    const result = parseOutputsBuffer(outputsBuffer, rowLength, this)\n    if (result.isOk()) {\n      return ok(undefined)\n    } else {\n      return err(result.error)\n    }\n  }\n\n  /**\n   * Return the series for the given output variable.\n   *\n   * @param varId The ID of the output variable (as used by SDEverywhere).\n   */\n  getSeriesForVar(varId: OutputVarId): Series | undefined {\n    const seriesIndex = this.varIds.indexOf(varId)\n    if (seriesIndex >= 0) {\n      return this.varSeries[seriesIndex]\n    } else {\n      // TODO: Error\n      return undefined\n    }\n  }\n}\n\n/**\n * Parse the raw buffer produced by the model and store the values in the\n * given (reused) `Outputs` object.\n *\n * @param outputsBuffer The raw outputs buffer produced by the model.\n * @param rowLength The number of elements per row (one element per year or save point).\n * @return An `ok` result if the buffer is valid, otherwise an `err` result.\n * @hidden\n */\nfunction parseOutputsBuffer(\n  outputsBuffer: Float64Array,\n  rowLength: number,\n  outputs: Outputs\n): Result<Outputs, ParseError> {\n  const varCount = outputs.varIds.length\n  const seriesLength = outputs.seriesLength\n  if (rowLength < seriesLength || outputsBuffer.length < varCount * seriesLength) {\n    return err('invalid-point-count')\n  }\n\n  // The buffer populated by the C `runModelWithBuffers` function is already\n  // transposed, so the first \"row\" contains the values for the first output\n  // variable (from start time to end time), and so on.\n  for (let outputVarIndex = 0; outputVarIndex < varCount; outputVarIndex++) {\n    const series = outputs.varSeries[outputVarIndex]\n    let sourceIndex = rowLength * outputVarIndex\n    for (let valueIndex = 0; valueIndex < seriesLength; valueIndex++) {\n      series.points[valueIndex].y = validateNumber(outputsBuffer[sourceIndex])\n      sourceIndex++\n    }\n  }\n\n  return ok(outputs)\n}\n\n/**\n * Return the given number if it is valid, or undefined if it is invalid.\n *\n * SDE converts Vensim's `:NA:` values to `-DBL_MAX`, so if we see a very large negative\n * value, convert it to `undefined`.  This is preferable to including extreme values\n * because some charting libraries (e.g. Chart.js) appear to choke on these large values\n * in certain browsers (e.g. Safari), but `undefined` appears to be handled better and\n * does a better job of signaling that the data point is undefined.\n *\n * @hidden\n */\nfunction validateNumber(x: number): number | undefined {\n  if (!isNaN(x) && x > -1e32) {\n    return x\n  } else {\n    return undefined\n  }\n}\n","// Copyright (c) 2021-2022 Climate Interactive / New Venture Fund\n\nlet isWeb: boolean\n\n/**\n * Return a timestamp that can be passed to `perfElapsed` for calculating the elapsed\n * time of an operation.\n *\n * @hidden This is not part of the public API; exposed only for use in performance testing.\n */\nexport function perfNow(): unknown {\n  // Note that `self` resolves to the window (in browser context) or the worker global scope\n  // (in a Web Worker context)\n  if (isWeb === undefined) {\n    isWeb = typeof self !== 'undefined' && self?.performance !== undefined\n  }\n  if (isWeb) {\n    return self.performance.now()\n  } else {\n    // XXX: We only use `process` in two places; we bypass type checking instead of\n    // setting up type declarations\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    return process?.hrtime()\n  }\n}\n\n/**\n * Return the elapsed time between the given timestamp (created by `perfNow`) and now.\n *\n * @hidden This is not part of the public API; exposed only for use in performance testing.\n */\nexport function perfElapsed(t0: unknown): number {\n  if (isWeb) {\n    const t1 = self.performance.now()\n    return (t1 as number) - (t0 as number)\n  } else {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    const elapsed = process.hrtime(t0) as number[]\n    // Convert from nanoseconds to milliseconds\n    return (elapsed[0] * 1000000000 + elapsed[1]) / 1000000\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { WasmModelInitResult } from '../wasm-model'\nimport type { InputValue } from './inputs'\nimport type { Outputs } from './outputs'\nimport { perfElapsed, perfNow } from './perf'\n\n/**\n * Abstraction that allows for running the wasm model on the JS thread\n * or asynchronously (e.g. in a Web Worker), depending on the implementation.\n */\nexport interface ModelRunner {\n  /**\n   * Run the model.\n   *\n   * @param inputs The model input values (must be in the same order as in the spec file).\n   * @param outputs The structure into which the model outputs will be stored.\n   * @return A promise that resolves with the outputs when the model run is complete.\n   */\n  runModel(inputs: InputValue[], outputs: Outputs): Promise<Outputs>\n\n  /**\n   * Run the model synchronously.\n   *\n   * @param inputs The model input values (must be in the same order as in the spec file).\n   * @param outputs The structure into which the model outputs will be stored.\n   * @return The outputs of the run.\n   *\n   * @hidden This is only intended for internal use; some implementations may not support\n   * running the model synchronously, in which case this will be undefined.\n   */\n  runModelSync?(inputs: InputValue[], outputs: Outputs): Outputs\n\n  /**\n   * Terminate the runner by releasing underlying resources (e.g., the worker thread or\n   * Wasm module/buffers).\n   */\n  terminate(): Promise<void>\n}\n\n/**\n * Create a `ModelRunner` that runs the given wasm model on the JS thread.\n *\n * @param wasmResult The result of initializing the wasm model.\n */\nexport function createWasmModelRunner(wasmResult: WasmModelInitResult): ModelRunner {\n  // Create views on the wasm buffers\n  const wasmModel = wasmResult.model\n  const inputsBuffer = wasmResult.inputsBuffer\n  const inputsArray = inputsBuffer.getArrayView()\n  const outputsBuffer = wasmResult.outputsBuffer\n  const outputsArray = outputsBuffer.getArrayView()\n  const rowLength = wasmResult.endTime - wasmResult.startTime + 1\n\n  // Disallow `runModel` after the runner has been terminated\n  let terminated = false\n\n  const runModelSync = (inputs: InputValue[], outputs: Outputs) => {\n    // Capture the current set of input values into the reusable buffer\n    let i = 0\n    for (const input of inputs) {\n      inputsArray[i++] = input.get()\n    }\n\n    // Run the model\n    const t0 = perfNow()\n    wasmModel.runModel(inputsBuffer, outputsBuffer)\n    outputs.runTimeInMillis = perfElapsed(t0)\n\n    // Capture the outputs array by copying the data into the given `Outputs`\n    // data structure\n    outputs.updateFromBuffer(outputsArray, rowLength)\n\n    return outputs\n  }\n\n  return {\n    runModel: (inputs, outputs) => {\n      if (terminated) {\n        return Promise.reject(new Error('Model runner has already been terminated'))\n      }\n      return Promise.resolve(runModelSync(inputs, outputs))\n    },\n    runModelSync: (inputs, outputs) => {\n      if (terminated) {\n        throw new Error('Model runner has already been terminated')\n      }\n      return runModelSync(inputs, outputs)\n    },\n    terminate: () => {\n      if (!terminated) {\n        // TODO: Release wasm-related resources (module or buffers)\n        terminated = true\n      }\n      return Promise.resolve()\n    }\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { InputVarId } from '../_shared'\nimport type { InputValue, ModelRunner, Outputs } from '../model-runner'\n\n/**\n * A high-level interface that schedules running of the underlying `WasmModel`.\n *\n * When one or more input values are changed, this class will schedule a model\n * run to be completed as soon as possible.  When the model run has completed,\n * `onOutputsChanged` is called to notify that new output data is available.\n *\n * The `ModelRunner` is pluggable to allow for running the model synchronously\n * (on the main JavaScript thread) or asynchronously (in a Web Worker or Node.js\n * worker thread).\n */\nexport class ModelScheduler {\n  /** The second array that holds a stable copy of the user inputs. */\n  private readonly currentInputs: InputValue[]\n\n  /** Whether a model run has been scheduled. */\n  private runNeeded = false\n\n  /** Whether a model run is in progress. */\n  private runInProgress = false\n\n  /** Called when `outputs` has been updated after a model run. */\n  public onOutputsChanged?: (outputs: Outputs) => void\n\n  /**\n   * @param runner The model runner.\n   * @param userInputs The input values, in the same order as in the spec file passed to `sde`.\n   * @param outputs The structure into which the model outputs will be stored.\n   */\n  constructor(\n    private readonly runner: ModelRunner,\n    private readonly userInputs: InputValue[],\n    private outputs: Outputs\n  ) {\n    // When any input has an updated value, schedule a model run on the next tick\n    const afterSet = () => {\n      this.runWasmModelIfNeeded()\n    }\n    for (const userInput of userInputs) {\n      userInput.callbacks.onSet = afterSet\n    }\n\n    // Create a second array to hold a stable copy of the user inputs during model runs\n    this.currentInputs = []\n    for (const userInput of userInputs) {\n      this.currentInputs.push(createSimpleInputValue(userInput.varId))\n    }\n  }\n\n  /**\n   * Schedule a wasm model run (if not already pending).  When the run is\n   * complete, save the outputs and call the `onOutputsChanged` callback.\n   */\n  private runWasmModelIfNeeded(): void {\n    // Set a flag indicating that a new run is needed (even if one is already\n    // in progress)\n    this.runNeeded = true\n\n    if (this.runInProgress) {\n      // A run is already in progress; let it finish first\n      return\n    } else {\n      // A run is not already in progress, so schedule it now.  We use\n      // `setTimeout` so that if a lot of inputs are all changing at once\n      // (like after a reset), we wait for all those `set` or `reset`\n      // calls to finish before gathering the input values into an array\n      // and initiating the run on the next tick.\n      this.runInProgress = true\n      setTimeout(() => {\n        // Kick off the (possibly asynchronous) model run\n        this.runWasmModelNow()\n      }, 0)\n    }\n  }\n\n  /**\n   * Run the wasm model asynchronously using the current set of input values.\n   */\n  private async runWasmModelNow(): Promise<void> {\n    // Copy the current inputs into a separate array; this ensures that the\n    // model run uses a stable set of inputs, even if the user continues to\n    // change the inputs while the model is being run asynchronously\n    for (let i = 0; i < this.userInputs.length; i++) {\n      this.currentInputs[i].set(this.userInputs[i].get())\n    }\n\n    // Run the model with the current set of input values and save the outputs\n    try {\n      this.outputs = await this.runner.runModel(this.currentInputs, this.outputs)\n      this.onOutputsChanged?.(this.outputs)\n    } catch (e) {\n      console.error(`ERROR: Failed to run model: ${e.message}`)\n    }\n\n    // See if another run is needed\n    if (this.runNeeded) {\n      // Keep `runInProgress` set, but clear the `runNeeded` flag\n      this.runNeeded = false\n      setTimeout(() => {\n        this.runWasmModelNow()\n      }, 0)\n    } else {\n      // No run needed, so clear both flags\n      this.runNeeded = false\n      this.runInProgress = false\n    }\n  }\n}\n\n/**\n * Create an `InputValue` that is only used to hold a copy of another input (no callbacks).\n * @hidden\n */\nfunction createSimpleInputValue(varId: InputVarId): InputValue {\n  let currentValue = 0\n  const get = () => {\n    return currentValue\n  }\n  const set = (newValue: number) => {\n    currentValue = newValue\n  }\n  const reset = () => {\n    set(0)\n  }\n  return { varId, get, set, reset, callbacks: {} }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,296 @@
+import { Result } from 'neverthrow';
+
+/** An input variable identifier string, as used in SDEverywhere. */
+declare type InputVarId = string;
+/** An output variable identifier string, as used in SDEverywhere. */
+declare type OutputVarId = string;
+
+/**
+ * Type declaration for a WebAssembly module wrapper produced
+ * by the Emscripten compiler.  This only declares the minimal
+ * set of fields needed by `WasmModel` and `WasmBuffer`.
+ */
+interface WasmModule {
+    /** @hidden */
+    cwrap: (fname: string, rettype: string, argtypes: string[]) => any;
+    /** @hidden */
+    _malloc: (numBytes: number) => number;
+    /** @hidden */
+    _free: (byteOffset: number) => void;
+    /** @hidden */
+    HEAPF64: Float64Array;
+}
+
+/**
+ * Wraps a `WebAssembly.Memory` buffer allocated on the wasm heap.
+ *
+ * When this is used synchronously (in the browser's normal JavaScript thread),
+ * the client can use `getArrayView` to write directly into the underlying memory.
+ *
+ * Note, however, that `WebAssembly.Memory` buffers cannot be transferred to/from
+ * a Web Worker.  When using this class in a worker thread, create a separate
+ * `Float64Array` that can be transferred between the worker and the client running
+ * in the browser's normal JS thread, and then use `getArrayView` to copy into and
+ * out of the wasm buffer.
+ */
+declare class WasmBuffer {
+    private readonly wasmModule;
+    private byteOffset;
+    private heapArray;
+    /**
+     * @param wasmModule The `WasmModule` used to initialize the memory.
+     * @param numElements The number of 64-bit `double` elements in the buffer.
+     */
+    constructor(wasmModule: WasmModule, numElements: number);
+    /**
+     * @return A new `Float64Array` view on the underlying heap buffer.
+     */
+    getArrayView(): Float64Array;
+    /**
+     * @return The raw address of the underlying heap buffer.
+     * @hidden This is intended for use by `WasmModel` only.
+     */
+    getAddress(): number;
+    /**
+     * Dispose the buffer by freeing the allocated heap memory.
+     */
+    dispose(): void;
+}
+
+/**
+ * An interface to the En-ROADS model.  Allows for running the model with
+ * a given set of input values, producing a set of output values.
+ */
+declare class WasmModel {
+    private readonly wasmRunModel;
+    /**
+     * @param wasmModule The `WasmModule` containing the `runModelWithBuffers` function.
+     */
+    constructor(wasmModule: WasmModule);
+    /**
+     * Run the model, using inputs from the `inputs` buffer, and writing outputs into
+     * the `outputs` buffer.
+     *
+     * @param inputs The buffer containing inputs in the order expected by the model.
+     * @param outputs The buffer into which the model will store output values.
+     */
+    runModel(inputs: WasmBuffer, outputs: WasmBuffer): void;
+}
+/**
+ * The result of model initialization.
+ */
+interface WasmModelInitResult {
+    /** The wasm model. */
+    model: WasmModel;
+    /** The buffer used to pass input values to the model. */
+    inputsBuffer: WasmBuffer;
+    /** The buffer used to receive output values from the model. */
+    outputsBuffer: WasmBuffer;
+    /** The output variable IDs. */
+    outputVarIds: OutputVarId[];
+    /** The start time (year) for the model. */
+    startTime: number;
+    /** The end time (year) for the model. */
+    endTime: number;
+}
+/**
+ * Initialize the wasm model and buffers.
+ *
+ * @param wasmModule The `WasmModule` that wraps the `wasm` binary.
+ * @param numInputs The number of input variables, per the spec file passed to `sde`.
+ * @param outputVarIds The output variable IDs, per the spec file passed to `sde`.
+ * @param startTime The start time (year) for the model.
+ * @param endTime The end time (year) for the model.
+ */
+declare function initWasmModelAndBuffers(wasmModule: WasmModule, numInputs: number, outputVarIds: OutputVarId[], startTime: number, endTime: number): WasmModelInitResult;
+
+/** Callback functions that are called when the input value is changed. */
+interface InputCallbacks {
+    /** Called after a new value is set. */
+    onSet?: () => void;
+}
+/**
+ * Represents a writable model input.
+ */
+interface InputValue {
+    /** The ID of the associated input variable, as used in SDEverywhere. */
+    varId: InputVarId;
+    /** Get the current value of the input. */
+    get: () => number;
+    /** Set the input to the given value. */
+    set: (value: number) => void;
+    /** Reset the input to its default value. */
+    reset: () => void;
+    /** Callback functions that are called when the input value is changed. */
+    callbacks: InputCallbacks;
+}
+/**
+ * Create a basic `InputValue` instance that notifies when a new value is set.
+ *
+ * @param varId The input variable ID, as used in SDEverywhere.
+ * @param defaultValue The default value of the input.
+ * @param initialValue The inital value of the input; if undefined, will use `defaultValue`.
+ */
+declare function createInputValue(varId: InputVarId, defaultValue: number, initialValue?: number): InputValue;
+
+/** Indicates the type of error encountered when parsing an outputs buffer. */
+declare type ParseError = 'invalid-point-count';
+/** A data point. */
+interface Point {
+    /** The x value (typically a year). */
+    x: number;
+    /** The y value. */
+    y: number;
+}
+/**
+ * A time series of data points for an output variable.
+ */
+declare class Series {
+    readonly varId: OutputVarId;
+    readonly points: Point[];
+    /**
+     * @param varId The ID for the output variable (as used by SDEverywhere).
+     * @param points The data points for the variable, one point per time increment.
+     */
+    constructor(varId: OutputVarId, points: Point[]);
+    /**
+     * Return the Y value at the given time.
+     *
+     * @param time The x (time) value.
+     */
+    getValueAtTime(time: number): number | undefined;
+    /**
+     * Create a new `Series` instance that is a copy of this one.
+     */
+    copy(): Series;
+}
+/** Represents the outputs from a model run. */
+declare class Outputs {
+    readonly varIds: OutputVarId[];
+    readonly timeStart: number;
+    readonly timeEnd: number;
+    /** The number of data points in each series. */
+    readonly seriesLength: number;
+    /** The array of series, one for each output variable. */
+    readonly varSeries: Series[];
+    /**
+     * The latest model run time, in milliseconds.
+     * @hidden This is not yet part of the public API; it is exposed here for use
+     * in performance testing tools.
+     */
+    runTimeInMillis: number;
+    constructor(varIds: OutputVarId[], timeStart: number, timeEnd: number);
+    /**
+     * Parse the given raw float buffer (produced by the model) and store the values
+     * into this `Outputs` instance.
+     *
+     * Note that the length of `outputsBuffer` must be greater than or equal to
+     * the capacity of this `Outputs` instance.  The `Outputs` instance is allowed
+     * to be smaller to support the case where you want to extract a subset of
+     * the time range in the buffer produced by the model.
+     *
+     * @param outputsBuffer The raw outputs buffer produced by the model.
+     * @param rowLength The number of elements per row (one element per year or save point).
+     * @return An `ok` result if the buffer is valid, otherwise an `err` result.
+     */
+    updateFromBuffer(outputsBuffer: Float64Array, rowLength: number): Result<void, ParseError>;
+    /**
+     * Return the series for the given output variable.
+     *
+     * @param varId The ID of the output variable (as used by SDEverywhere).
+     */
+    getSeriesForVar(varId: OutputVarId): Series | undefined;
+}
+
+/**
+ * Abstraction that allows for running the wasm model on the JS thread
+ * or asynchronously (e.g. in a Web Worker), depending on the implementation.
+ */
+interface ModelRunner {
+    /**
+     * Run the model.
+     *
+     * @param inputs The model input values (must be in the same order as in the spec file).
+     * @param outputs The structure into which the model outputs will be stored.
+     * @return A promise that resolves with the outputs when the model run is complete.
+     */
+    runModel(inputs: InputValue[], outputs: Outputs): Promise<Outputs>;
+    /**
+     * Run the model synchronously.
+     *
+     * @param inputs The model input values (must be in the same order as in the spec file).
+     * @param outputs The structure into which the model outputs will be stored.
+     * @return The outputs of the run.
+     *
+     * @hidden This is only intended for internal use; some implementations may not support
+     * running the model synchronously, in which case this will be undefined.
+     */
+    runModelSync?(inputs: InputValue[], outputs: Outputs): Outputs;
+    /**
+     * Terminate the runner by releasing underlying resources (e.g., the worker thread or
+     * Wasm module/buffers).
+     */
+    terminate(): Promise<void>;
+}
+/**
+ * Create a `ModelRunner` that runs the given wasm model on the JS thread.
+ *
+ * @param wasmResult The result of initializing the wasm model.
+ */
+declare function createWasmModelRunner(wasmResult: WasmModelInitResult): ModelRunner;
+
+/**
+ * Return a timestamp that can be passed to `perfElapsed` for calculating the elapsed
+ * time of an operation.
+ *
+ * @hidden This is not part of the public API; exposed only for use in performance testing.
+ */
+declare function perfNow(): unknown;
+/**
+ * Return the elapsed time between the given timestamp (created by `perfNow`) and now.
+ *
+ * @hidden This is not part of the public API; exposed only for use in performance testing.
+ */
+declare function perfElapsed(t0: unknown): number;
+
+/**
+ * A high-level interface that schedules running of the underlying `WasmModel`.
+ *
+ * When one or more input values are changed, this class will schedule a model
+ * run to be completed as soon as possible.  When the model run has completed,
+ * `onOutputsChanged` is called to notify that new output data is available.
+ *
+ * The `ModelRunner` is pluggable to allow for running the model synchronously
+ * (on the main JavaScript thread) or asynchronously (in a Web Worker or Node.js
+ * worker thread).
+ */
+declare class ModelScheduler {
+    private readonly runner;
+    private readonly userInputs;
+    private outputs;
+    /** The second array that holds a stable copy of the user inputs. */
+    private readonly currentInputs;
+    /** Whether a model run has been scheduled. */
+    private runNeeded;
+    /** Whether a model run is in progress. */
+    private runInProgress;
+    /** Called when `outputs` has been updated after a model run. */
+    onOutputsChanged?: (outputs: Outputs) => void;
+    /**
+     * @param runner The model runner.
+     * @param userInputs The input values, in the same order as in the spec file passed to `sde`.
+     * @param outputs The structure into which the model outputs will be stored.
+     */
+    constructor(runner: ModelRunner, userInputs: InputValue[], outputs: Outputs);
+    /**
+     * Schedule a wasm model run (if not already pending).  When the run is
+     * complete, save the outputs and call the `onOutputsChanged` callback.
+     */
+    private runWasmModelIfNeeded;
+    /**
+     * Run the wasm model asynchronously using the current set of input values.
+     */
+    private runWasmModelNow;
+}
+
+export { InputCallbacks, InputValue, InputVarId, ModelRunner, ModelScheduler, OutputVarId, Outputs, ParseError, Point, Series, WasmBuffer, WasmModel, WasmModelInitResult, WasmModule, createInputValue, createWasmModelRunner, initWasmModelAndBuffers, perfElapsed, perfNow };

package/dist/index.js

@@ -0,0 +1,303 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// src/wasm-model/wasm-buffer.ts
+var WasmBuffer = class {
+  constructor(wasmModule, numElements) {
+    this.wasmModule = wasmModule;
+    const sizeOfFloat64 = 8;
+    const lengthInBytes = numElements * sizeOfFloat64;
+    this.byteOffset = wasmModule._malloc(lengthInBytes);
+    const float64Offset = this.byteOffset / sizeOfFloat64;
+    this.heapArray = wasmModule.HEAPF64.subarray(float64Offset, float64Offset + numElements);
+  }
+  getArrayView() {
+    return this.heapArray;
+  }
+  getAddress() {
+    return this.byteOffset;
+  }
+  dispose() {
+    if (this.heapArray) {
+      this.wasmModule._free(this.byteOffset);
+      this.heapArray = void 0;
+      this.byteOffset = void 0;
+    }
+  }
+};
+
+// src/wasm-model/wasm-model.ts
+var WasmModel = class {
+  constructor(wasmModule) {
+    this.wasmRunModel = wasmModule.cwrap("runModelWithBuffers", null, ["number", "number"]);
+  }
+  runModel(inputs, outputs) {
+    this.wasmRunModel(inputs.getAddress(), outputs.getAddress());
+  }
+};
+function initWasmModelAndBuffers(wasmModule, numInputs, outputVarIds, startTime, endTime) {
+  const model = new WasmModel(wasmModule);
+  const inputsBuffer = new WasmBuffer(wasmModule, numInputs);
+  const seriesLength = endTime - startTime + 1;
+  const outputsBuffer = new WasmBuffer(wasmModule, outputVarIds.length * seriesLength);
+  return {
+    model,
+    inputsBuffer,
+    outputsBuffer,
+    outputVarIds,
+    startTime,
+    endTime
+  };
+}
+
+// src/model-runner/inputs.ts
+function createInputValue(varId, defaultValue, initialValue) {
+  let currentValue = initialValue !== void 0 ? initialValue : defaultValue;
+  const callbacks = {};
+  const get = () => {
+    return currentValue;
+  };
+  const set = (newValue) => {
+    var _a;
+    if (newValue !== currentValue) {
+      currentValue = newValue;
+      (_a = callbacks.onSet) == null ? void 0 : _a.call(callbacks);
+    }
+  };
+  const reset = () => {
+    set(defaultValue);
+  };
+  return { varId, get, set, reset, callbacks };
+}
+
+// src/model-runner/outputs.ts
+import { ok, err } from "neverthrow";
+var Series = class {
+  constructor(varId, points) {
+    this.varId = varId;
+    this.points = points;
+  }
+  getValueAtTime(time) {
+    var _a;
+    const startTime = this.points[0].x;
+    return (_a = this.points[time - startTime]) == null ? void 0 : _a.y;
+  }
+  copy() {
+    const pointsCopy = this.points.map((p) => __spreadValues({}, p));
+    return new Series(this.varId, pointsCopy);
+  }
+};
+var Outputs = class {
+  constructor(varIds, timeStart, timeEnd) {
+    this.varIds = varIds;
+    this.timeStart = timeStart;
+    this.timeEnd = timeEnd;
+    this.seriesLength = timeEnd - timeStart + 1;
+    this.varSeries = new Array(varIds.length);
+    for (let i = 0; i < varIds.length; i++) {
+      const points = new Array(this.seriesLength);
+      let time = timeStart;
+      for (let j = 0; j < this.seriesLength; j++) {
+        points[j] = { x: time++, y: 0 };
+      }
+      const varId = varIds[i];
+      this.varSeries[i] = new Series(varId, points);
+    }
+  }
+  updateFromBuffer(outputsBuffer, rowLength) {
+    const result = parseOutputsBuffer(outputsBuffer, rowLength, this);
+    if (result.isOk()) {
+      return ok(void 0);
+    } else {
+      return err(result.error);
+    }
+  }
+  getSeriesForVar(varId) {
+    const seriesIndex = this.varIds.indexOf(varId);
+    if (seriesIndex >= 0) {
+      return this.varSeries[seriesIndex];
+    } else {
+      return void 0;
+    }
+  }
+};
+function parseOutputsBuffer(outputsBuffer, rowLength, outputs) {
+  const varCount = outputs.varIds.length;
+  const seriesLength = outputs.seriesLength;
+  if (rowLength < seriesLength || outputsBuffer.length < varCount * seriesLength) {
+    return err("invalid-point-count");
+  }
+  for (let outputVarIndex = 0; outputVarIndex < varCount; outputVarIndex++) {
+    const series = outputs.varSeries[outputVarIndex];
+    let sourceIndex = rowLength * outputVarIndex;
+    for (let valueIndex = 0; valueIndex < seriesLength; valueIndex++) {
+      series.points[valueIndex].y = validateNumber(outputsBuffer[sourceIndex]);
+      sourceIndex++;
+    }
+  }
+  return ok(outputs);
+}
+function validateNumber(x) {
+  if (!isNaN(x) && x > -1e32) {
+    return x;
+  } else {
+    return void 0;
+  }
+}
+
+// src/model-runner/perf.ts
+var isWeb;
+function perfNow() {
+  if (isWeb === void 0) {
+    isWeb = typeof self !== "undefined" && (self == null ? void 0 : self.performance) !== void 0;
+  }
+  if (isWeb) {
+    return self.performance.now();
+  } else {
+    return process == null ? void 0 : process.hrtime();
+  }
+}
+function perfElapsed(t0) {
+  if (isWeb) {
+    const t1 = self.performance.now();
+    return t1 - t0;
+  } else {
+    const elapsed = process.hrtime(t0);
+    return (elapsed[0] * 1e9 + elapsed[1]) / 1e6;
+  }
+}
+
+// src/model-runner/model-runner.ts
+function createWasmModelRunner(wasmResult) {
+  const wasmModel = wasmResult.model;
+  const inputsBuffer = wasmResult.inputsBuffer;
+  const inputsArray = inputsBuffer.getArrayView();
+  const outputsBuffer = wasmResult.outputsBuffer;
+  const outputsArray = outputsBuffer.getArrayView();
+  const rowLength = wasmResult.endTime - wasmResult.startTime + 1;
+  let terminated = false;
+  const runModelSync = (inputs, outputs) => {
+    let i = 0;
+    for (const input of inputs) {
+      inputsArray[i++] = input.get();
+    }
+    const t0 = perfNow();
+    wasmModel.runModel(inputsBuffer, outputsBuffer);
+    outputs.runTimeInMillis = perfElapsed(t0);
+    outputs.updateFromBuffer(outputsArray, rowLength);
+    return outputs;
+  };
+  return {
+    runModel: (inputs, outputs) => {
+      if (terminated) {
+        return Promise.reject(new Error("Model runner has already been terminated"));
+      }
+      return Promise.resolve(runModelSync(inputs, outputs));
+    },
+    runModelSync: (inputs, outputs) => {
+      if (terminated) {
+        throw new Error("Model runner has already been terminated");
+      }
+      return runModelSync(inputs, outputs);
+    },
+    terminate: () => {
+      if (!terminated) {
+        terminated = true;
+      }
+      return Promise.resolve();
+    }
+  };
+}
+
+// src/model-scheduler/model-scheduler.ts
+var ModelScheduler = class {
+  constructor(runner, userInputs, outputs) {
+    this.runner = runner;
+    this.userInputs = userInputs;
+    this.outputs = outputs;
+    this.runNeeded = false;
+    this.runInProgress = false;
+    const afterSet = () => {
+      this.runWasmModelIfNeeded();
+    };
+    for (const userInput of userInputs) {
+      userInput.callbacks.onSet = afterSet;
+    }
+    this.currentInputs = [];
+    for (const userInput of userInputs) {
+      this.currentInputs.push(createSimpleInputValue(userInput.varId));
+    }
+  }
+  runWasmModelIfNeeded() {
+    this.runNeeded = true;
+    if (this.runInProgress) {
+      return;
+    } else {
+      this.runInProgress = true;
+      setTimeout(() => {
+        this.runWasmModelNow();
+      }, 0);
+    }
+  }
+  async runWasmModelNow() {
+    var _a;
+    for (let i = 0; i < this.userInputs.length; i++) {
+      this.currentInputs[i].set(this.userInputs[i].get());
+    }
+    try {
+      this.outputs = await this.runner.runModel(this.currentInputs, this.outputs);
+      (_a = this.onOutputsChanged) == null ? void 0 : _a.call(this, this.outputs);
+    } catch (e) {
+      console.error(`ERROR: Failed to run model: ${e.message}`);
+    }
+    if (this.runNeeded) {
+      this.runNeeded = false;
+      setTimeout(() => {
+        this.runWasmModelNow();
+      }, 0);
+    } else {
+      this.runNeeded = false;
+      this.runInProgress = false;
+    }
+  }
+};
+function createSimpleInputValue(varId) {
+  let currentValue = 0;
+  const get = () => {
+    return currentValue;
+  };
+  const set = (newValue) => {
+    currentValue = newValue;
+  };
+  const reset = () => {
+    set(0);
+  };
+  return { varId, get, set, reset, callbacks: {} };
+}
+export {
+  ModelScheduler,
+  Outputs,
+  Series,
+  WasmBuffer,
+  WasmModel,
+  createInputValue,
+  createWasmModelRunner,
+  initWasmModelAndBuffers,
+  perfElapsed,
+  perfNow
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wasm-model/wasm-buffer.ts","../src/wasm-model/wasm-model.ts","../src/model-runner/inputs.ts","../src/model-runner/outputs.ts","../src/model-runner/perf.ts","../src/model-runner/model-runner.ts","../src/model-scheduler/model-scheduler.ts"],"sourcesContent":["// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { WasmModule } from './wasm-module'\n\n/**\n * Wraps a `WebAssembly.Memory` buffer allocated on the wasm heap.\n *\n * When this is used synchronously (in the browser's normal JavaScript thread),\n * the client can use `getArrayView` to write directly into the underlying memory.\n *\n * Note, however, that `WebAssembly.Memory` buffers cannot be transferred to/from\n * a Web Worker.  When using this class in a worker thread, create a separate\n * `Float64Array` that can be transferred between the worker and the client running\n * in the browser's normal JS thread, and then use `getArrayView` to copy into and\n * out of the wasm buffer.\n */\nexport class WasmBuffer {\n  private byteOffset: number\n  private heapArray: Float64Array\n\n  /**\n   * @param wasmModule The `WasmModule` used to initialize the memory.\n   * @param numElements The number of 64-bit `double` elements in the buffer.\n   */\n  constructor(private readonly wasmModule: WasmModule, numElements: number) {\n    const sizeOfFloat64 = 8\n    const lengthInBytes = numElements * sizeOfFloat64\n    this.byteOffset = wasmModule._malloc(lengthInBytes)\n    const float64Offset = this.byteOffset / sizeOfFloat64\n    this.heapArray = wasmModule.HEAPF64.subarray(float64Offset, float64Offset + numElements)\n  }\n\n  /**\n   * @return A new `Float64Array` view on the underlying heap buffer.\n   */\n  getArrayView(): Float64Array {\n    return this.heapArray\n  }\n\n  /**\n   * @return The raw address of the underlying heap buffer.\n   * @hidden This is intended for use by `WasmModel` only.\n   */\n  getAddress(): number {\n    return this.byteOffset\n  }\n\n  /**\n   * Dispose the buffer by freeing the allocated heap memory.\n   */\n  dispose(): void {\n    if (this.heapArray) {\n      this.wasmModule._free(this.byteOffset)\n      this.heapArray = undefined\n      this.byteOffset = undefined\n    }\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { OutputVarId } from '../_shared'\nimport { WasmBuffer } from './wasm-buffer'\nimport type { WasmModule } from './wasm-module'\n\n/**\n * An interface to the En-ROADS model.  Allows for running the model with\n * a given set of input values, producing a set of output values.\n */\nexport class WasmModel {\n  private readonly wasmRunModel: (inputsAddress: number, outputsAddress: number) => void\n\n  /**\n   * @param wasmModule The `WasmModule` containing the `runModelWithBuffers` function.\n   */\n  constructor(wasmModule: WasmModule) {\n    this.wasmRunModel = wasmModule.cwrap('runModelWithBuffers', null, ['number', 'number'])\n  }\n\n  /**\n   * Run the model, using inputs from the `inputs` buffer, and writing outputs into\n   * the `outputs` buffer.\n   *\n   * @param inputs The buffer containing inputs in the order expected by the model.\n   * @param outputs The buffer into which the model will store output values.\n   */\n  runModel(inputs: WasmBuffer, outputs: WasmBuffer): void {\n    this.wasmRunModel(inputs.getAddress(), outputs.getAddress())\n  }\n}\n\n/**\n * The result of model initialization.\n */\nexport interface WasmModelInitResult {\n  /** The wasm model. */\n  model: WasmModel\n  /** The buffer used to pass input values to the model. */\n  inputsBuffer: WasmBuffer\n  /** The buffer used to receive output values from the model. */\n  outputsBuffer: WasmBuffer\n  /** The output variable IDs. */\n  outputVarIds: OutputVarId[]\n  /** The start time (year) for the model. */\n  startTime: number\n  /** The end time (year) for the model. */\n  endTime: number\n}\n\n/**\n * Initialize the wasm model and buffers.\n *\n * @param wasmModule The `WasmModule` that wraps the `wasm` binary.\n * @param numInputs The number of input variables, per the spec file passed to `sde`.\n * @param outputVarIds The output variable IDs, per the spec file passed to `sde`.\n * @param startTime The start time (year) for the model.\n * @param endTime The end time (year) for the model.\n */\nexport function initWasmModelAndBuffers(\n  wasmModule: WasmModule,\n  numInputs: number,\n  outputVarIds: OutputVarId[],\n  startTime: number,\n  endTime: number\n): WasmModelInitResult {\n  // Wrap the native C `runModelWithBuffers` function in a JS function that we can call\n  const model = new WasmModel(wasmModule)\n\n  // Allocate a buffer that is large enough to hold the input values\n  const inputsBuffer = new WasmBuffer(wasmModule, numInputs)\n\n  // Each series will include one data point per year, inclusive of the\n  // start and end years\n  // TODO: We should pull these from the C variables instead of having them passed in;\n  // for now we assume `_saveper` is 1 but that should be pulled from the C variable too\n  const seriesLength = endTime - startTime + 1\n\n  // Allocate a buffer that is large enough to hold the series data for\n  // each output variable\n  const outputsBuffer = new WasmBuffer(wasmModule, outputVarIds.length * seriesLength)\n\n  return {\n    model,\n    inputsBuffer,\n    outputsBuffer,\n    outputVarIds,\n    startTime,\n    endTime\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { InputVarId } from '../_shared'\n\n/** Callback functions that are called when the input value is changed. */\nexport interface InputCallbacks {\n  /** Called after a new value is set. */\n  onSet?: () => void\n}\n\n/**\n * Represents a writable model input.\n */\nexport interface InputValue {\n  /** The ID of the associated input variable, as used in SDEverywhere. */\n  varId: InputVarId\n  /** Get the current value of the input. */\n  get: () => number\n  /** Set the input to the given value. */\n  set: (value: number) => void\n  /** Reset the input to its default value. */\n  reset: () => void\n  /** Callback functions that are called when the input value is changed. */\n  callbacks: InputCallbacks\n}\n\n/**\n * Create a basic `InputValue` instance that notifies when a new value is set.\n *\n * @param varId The input variable ID, as used in SDEverywhere.\n * @param defaultValue The default value of the input.\n * @param initialValue The inital value of the input; if undefined, will use `defaultValue`.\n */\nexport function createInputValue(varId: InputVarId, defaultValue: number, initialValue?: number): InputValue {\n  let currentValue = initialValue !== undefined ? initialValue : defaultValue\n\n  // The `onSet` callback is initially undefined but will be installed by `ModelScheduler`\n  const callbacks: InputCallbacks = {}\n\n  const get = () => {\n    return currentValue\n  }\n\n  const set = (newValue: number) => {\n    if (newValue !== currentValue) {\n      currentValue = newValue\n      callbacks.onSet?.()\n    }\n  }\n\n  const reset = () => {\n    set(defaultValue)\n  }\n\n  return { varId, get, set, reset, callbacks }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { Result } from 'neverthrow'\nimport { ok, err } from 'neverthrow'\nimport type { OutputVarId } from '../_shared'\n\n/** Indicates the type of error encountered when parsing an outputs buffer. */\nexport type ParseError = 'invalid-point-count'\n\n/** A data point. */\nexport interface Point {\n  /** The x value (typically a year). */\n  x: number\n  /** The y value. */\n  y: number\n}\n\n/**\n * A time series of data points for an output variable.\n */\nexport class Series {\n  /**\n   * @param varId The ID for the output variable (as used by SDEverywhere).\n   * @param points The data points for the variable, one point per time increment.\n   */\n  constructor(public readonly varId: OutputVarId, public readonly points: Point[]) {}\n\n  /**\n   * Return the Y value at the given time.\n   *\n   * @param time The x (time) value.\n   */\n  getValueAtTime(time: number): number | undefined {\n    // TODO: This assumes one data point per year; we should take `_saveper` into account\n    // and if it's not 1 point per year, search for a specific x value\n    // TODO: Add option to allow interpolation if the given time value is in between points\n    const startTime = this.points[0].x\n    return this.points[time - startTime]?.y\n  }\n\n  /**\n   * Create a new `Series` instance that is a copy of this one.\n   */\n  copy(): Series {\n    // Create a deep copy\n    const pointsCopy = this.points.map(p => ({ ...p }))\n    return new Series(this.varId, pointsCopy)\n  }\n}\n\n/** Represents the outputs from a model run. */\nexport class Outputs {\n  /** The number of data points in each series. */\n  public readonly seriesLength: number\n  /** The array of series, one for each output variable. */\n  public readonly varSeries: Series[]\n\n  /**\n   * The latest model run time, in milliseconds.\n   * @hidden This is not yet part of the public API; it is exposed here for use\n   * in performance testing tools.\n   */\n  public runTimeInMillis: number\n\n  constructor(\n    public readonly varIds: OutputVarId[],\n    public readonly timeStart: number,\n    public readonly timeEnd: number\n  ) {\n    // Each series will include one data point per year, inclusive of the start and end years\n    this.seriesLength = timeEnd - timeStart + 1\n\n    // Create an array of arrays, one for each output variable\n    this.varSeries = new Array(varIds.length)\n\n    // Populate the arrays, filling in the time for each point\n    for (let i = 0; i < varIds.length; i++) {\n      const points: Point[] = new Array(this.seriesLength)\n      let time = timeStart\n      for (let j = 0; j < this.seriesLength; j++) {\n        points[j] = { x: time++, y: 0 }\n      }\n      const varId = varIds[i]\n      this.varSeries[i] = new Series(varId, points)\n    }\n  }\n\n  /**\n   * Parse the given raw float buffer (produced by the model) and store the values\n   * into this `Outputs` instance.\n   *\n   * Note that the length of `outputsBuffer` must be greater than or equal to\n   * the capacity of this `Outputs` instance.  The `Outputs` instance is allowed\n   * to be smaller to support the case where you want to extract a subset of\n   * the time range in the buffer produced by the model.\n   *\n   * @param outputsBuffer The raw outputs buffer produced by the model.\n   * @param rowLength The number of elements per row (one element per year or save point).\n   * @return An `ok` result if the buffer is valid, otherwise an `err` result.\n   */\n  updateFromBuffer(outputsBuffer: Float64Array, rowLength: number): Result<void, ParseError> {\n    const result = parseOutputsBuffer(outputsBuffer, rowLength, this)\n    if (result.isOk()) {\n      return ok(undefined)\n    } else {\n      return err(result.error)\n    }\n  }\n\n  /**\n   * Return the series for the given output variable.\n   *\n   * @param varId The ID of the output variable (as used by SDEverywhere).\n   */\n  getSeriesForVar(varId: OutputVarId): Series | undefined {\n    const seriesIndex = this.varIds.indexOf(varId)\n    if (seriesIndex >= 0) {\n      return this.varSeries[seriesIndex]\n    } else {\n      // TODO: Error\n      return undefined\n    }\n  }\n}\n\n/**\n * Parse the raw buffer produced by the model and store the values in the\n * given (reused) `Outputs` object.\n *\n * @param outputsBuffer The raw outputs buffer produced by the model.\n * @param rowLength The number of elements per row (one element per year or save point).\n * @return An `ok` result if the buffer is valid, otherwise an `err` result.\n * @hidden\n */\nfunction parseOutputsBuffer(\n  outputsBuffer: Float64Array,\n  rowLength: number,\n  outputs: Outputs\n): Result<Outputs, ParseError> {\n  const varCount = outputs.varIds.length\n  const seriesLength = outputs.seriesLength\n  if (rowLength < seriesLength || outputsBuffer.length < varCount * seriesLength) {\n    return err('invalid-point-count')\n  }\n\n  // The buffer populated by the C `runModelWithBuffers` function is already\n  // transposed, so the first \"row\" contains the values for the first output\n  // variable (from start time to end time), and so on.\n  for (let outputVarIndex = 0; outputVarIndex < varCount; outputVarIndex++) {\n    const series = outputs.varSeries[outputVarIndex]\n    let sourceIndex = rowLength * outputVarIndex\n    for (let valueIndex = 0; valueIndex < seriesLength; valueIndex++) {\n      series.points[valueIndex].y = validateNumber(outputsBuffer[sourceIndex])\n      sourceIndex++\n    }\n  }\n\n  return ok(outputs)\n}\n\n/**\n * Return the given number if it is valid, or undefined if it is invalid.\n *\n * SDE converts Vensim's `:NA:` values to `-DBL_MAX`, so if we see a very large negative\n * value, convert it to `undefined`.  This is preferable to including extreme values\n * because some charting libraries (e.g. Chart.js) appear to choke on these large values\n * in certain browsers (e.g. Safari), but `undefined` appears to be handled better and\n * does a better job of signaling that the data point is undefined.\n *\n * @hidden\n */\nfunction validateNumber(x: number): number | undefined {\n  if (!isNaN(x) && x > -1e32) {\n    return x\n  } else {\n    return undefined\n  }\n}\n","// Copyright (c) 2021-2022 Climate Interactive / New Venture Fund\n\nlet isWeb: boolean\n\n/**\n * Return a timestamp that can be passed to `perfElapsed` for calculating the elapsed\n * time of an operation.\n *\n * @hidden This is not part of the public API; exposed only for use in performance testing.\n */\nexport function perfNow(): unknown {\n  // Note that `self` resolves to the window (in browser context) or the worker global scope\n  // (in a Web Worker context)\n  if (isWeb === undefined) {\n    isWeb = typeof self !== 'undefined' && self?.performance !== undefined\n  }\n  if (isWeb) {\n    return self.performance.now()\n  } else {\n    // XXX: We only use `process` in two places; we bypass type checking instead of\n    // setting up type declarations\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    return process?.hrtime()\n  }\n}\n\n/**\n * Return the elapsed time between the given timestamp (created by `perfNow`) and now.\n *\n * @hidden This is not part of the public API; exposed only for use in performance testing.\n */\nexport function perfElapsed(t0: unknown): number {\n  if (isWeb) {\n    const t1 = self.performance.now()\n    return (t1 as number) - (t0 as number)\n  } else {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    const elapsed = process.hrtime(t0) as number[]\n    // Convert from nanoseconds to milliseconds\n    return (elapsed[0] * 1000000000 + elapsed[1]) / 1000000\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { WasmModelInitResult } from '../wasm-model'\nimport type { InputValue } from './inputs'\nimport type { Outputs } from './outputs'\nimport { perfElapsed, perfNow } from './perf'\n\n/**\n * Abstraction that allows for running the wasm model on the JS thread\n * or asynchronously (e.g. in a Web Worker), depending on the implementation.\n */\nexport interface ModelRunner {\n  /**\n   * Run the model.\n   *\n   * @param inputs The model input values (must be in the same order as in the spec file).\n   * @param outputs The structure into which the model outputs will be stored.\n   * @return A promise that resolves with the outputs when the model run is complete.\n   */\n  runModel(inputs: InputValue[], outputs: Outputs): Promise<Outputs>\n\n  /**\n   * Run the model synchronously.\n   *\n   * @param inputs The model input values (must be in the same order as in the spec file).\n   * @param outputs The structure into which the model outputs will be stored.\n   * @return The outputs of the run.\n   *\n   * @hidden This is only intended for internal use; some implementations may not support\n   * running the model synchronously, in which case this will be undefined.\n   */\n  runModelSync?(inputs: InputValue[], outputs: Outputs): Outputs\n\n  /**\n   * Terminate the runner by releasing underlying resources (e.g., the worker thread or\n   * Wasm module/buffers).\n   */\n  terminate(): Promise<void>\n}\n\n/**\n * Create a `ModelRunner` that runs the given wasm model on the JS thread.\n *\n * @param wasmResult The result of initializing the wasm model.\n */\nexport function createWasmModelRunner(wasmResult: WasmModelInitResult): ModelRunner {\n  // Create views on the wasm buffers\n  const wasmModel = wasmResult.model\n  const inputsBuffer = wasmResult.inputsBuffer\n  const inputsArray = inputsBuffer.getArrayView()\n  const outputsBuffer = wasmResult.outputsBuffer\n  const outputsArray = outputsBuffer.getArrayView()\n  const rowLength = wasmResult.endTime - wasmResult.startTime + 1\n\n  // Disallow `runModel` after the runner has been terminated\n  let terminated = false\n\n  const runModelSync = (inputs: InputValue[], outputs: Outputs) => {\n    // Capture the current set of input values into the reusable buffer\n    let i = 0\n    for (const input of inputs) {\n      inputsArray[i++] = input.get()\n    }\n\n    // Run the model\n    const t0 = perfNow()\n    wasmModel.runModel(inputsBuffer, outputsBuffer)\n    outputs.runTimeInMillis = perfElapsed(t0)\n\n    // Capture the outputs array by copying the data into the given `Outputs`\n    // data structure\n    outputs.updateFromBuffer(outputsArray, rowLength)\n\n    return outputs\n  }\n\n  return {\n    runModel: (inputs, outputs) => {\n      if (terminated) {\n        return Promise.reject(new Error('Model runner has already been terminated'))\n      }\n      return Promise.resolve(runModelSync(inputs, outputs))\n    },\n    runModelSync: (inputs, outputs) => {\n      if (terminated) {\n        throw new Error('Model runner has already been terminated')\n      }\n      return runModelSync(inputs, outputs)\n    },\n    terminate: () => {\n      if (!terminated) {\n        // TODO: Release wasm-related resources (module or buffers)\n        terminated = true\n      }\n      return Promise.resolve()\n    }\n  }\n}\n","// Copyright (c) 2020-2022 Climate Interactive / New Venture Fund\n\nimport type { InputVarId } from '../_shared'\nimport type { InputValue, ModelRunner, Outputs } from '../model-runner'\n\n/**\n * A high-level interface that schedules running of the underlying `WasmModel`.\n *\n * When one or more input values are changed, this class will schedule a model\n * run to be completed as soon as possible.  When the model run has completed,\n * `onOutputsChanged` is called to notify that new output data is available.\n *\n * The `ModelRunner` is pluggable to allow for running the model synchronously\n * (on the main JavaScript thread) or asynchronously (in a Web Worker or Node.js\n * worker thread).\n */\nexport class ModelScheduler {\n  /** The second array that holds a stable copy of the user inputs. */\n  private readonly currentInputs: InputValue[]\n\n  /** Whether a model run has been scheduled. */\n  private runNeeded = false\n\n  /** Whether a model run is in progress. */\n  private runInProgress = false\n\n  /** Called when `outputs` has been updated after a model run. */\n  public onOutputsChanged?: (outputs: Outputs) => void\n\n  /**\n   * @param runner The model runner.\n   * @param userInputs The input values, in the same order as in the spec file passed to `sde`.\n   * @param outputs The structure into which the model outputs will be stored.\n   */\n  constructor(\n    private readonly runner: ModelRunner,\n    private readonly userInputs: InputValue[],\n    private outputs: Outputs\n  ) {\n    // When any input has an updated value, schedule a model run on the next tick\n    const afterSet = () => {\n      this.runWasmModelIfNeeded()\n    }\n    for (const userInput of userInputs) {\n      userInput.callbacks.onSet = afterSet\n    }\n\n    // Create a second array to hold a stable copy of the user inputs during model runs\n    this.currentInputs = []\n    for (const userInput of userInputs) {\n      this.currentInputs.push(createSimpleInputValue(userInput.varId))\n    }\n  }\n\n  /**\n   * Schedule a wasm model run (if not already pending).  When the run is\n   * complete, save the outputs and call the `onOutputsChanged` callback.\n   */\n  private runWasmModelIfNeeded(): void {\n    // Set a flag indicating that a new run is needed (even if one is already\n    // in progress)\n    this.runNeeded = true\n\n    if (this.runInProgress) {\n      // A run is already in progress; let it finish first\n      return\n    } else {\n      // A run is not already in progress, so schedule it now.  We use\n      // `setTimeout` so that if a lot of inputs are all changing at once\n      // (like after a reset), we wait for all those `set` or `reset`\n      // calls to finish before gathering the input values into an array\n      // and initiating the run on the next tick.\n      this.runInProgress = true\n      setTimeout(() => {\n        // Kick off the (possibly asynchronous) model run\n        this.runWasmModelNow()\n      }, 0)\n    }\n  }\n\n  /**\n   * Run the wasm model asynchronously using the current set of input values.\n   */\n  private async runWasmModelNow(): Promise<void> {\n    // Copy the current inputs into a separate array; this ensures that the\n    // model run uses a stable set of inputs, even if the user continues to\n    // change the inputs while the model is being run asynchronously\n    for (let i = 0; i < this.userInputs.length; i++) {\n      this.currentInputs[i].set(this.userInputs[i].get())\n    }\n\n    // Run the model with the current set of input values and save the outputs\n    try {\n      this.outputs = await this.runner.runModel(this.currentInputs, this.outputs)\n      this.onOutputsChanged?.(this.outputs)\n    } catch (e) {\n      console.error(`ERROR: Failed to run model: ${e.message}`)\n    }\n\n    // See if another run is needed\n    if (this.runNeeded) {\n      // Keep `runInProgress` set, but clear the `runNeeded` flag\n      this.runNeeded = false\n      setTimeout(() => {\n        this.runWasmModelNow()\n      }, 0)\n    } else {\n      // No run needed, so clear both flags\n      this.runNeeded = false\n      this.runInProgress = false\n    }\n  }\n}\n\n/**\n * Create an `InputValue` that is only used to hold a copy of another input (no callbacks).\n * @hidden\n */\nfunction createSimpleInputValue(varId: InputVarId): InputValue {\n  let currentValue = 0\n  const get = () => {\n    return currentValue\n  }\n  const set = (newValue: number) => {\n    currentValue = newValue\n  }\n  const reset = () => {\n    set(0)\n  }\n  return { varId, get, set, reset, callbacks: {} }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sdeverywhere/runtime",
+  "version": "0.1.0",
+  "files": [
+    "dist/**"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "neverthrow": "^2.7.1"
+  },
+  "author": "Climate Interactive",
+  "license": "MIT",
+  "homepage": "https://sdeverywhere.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/climateinteractive/SDEverywhere.git",
+    "directory": "packages/runtime"
+  },
+  "bugs": {
+    "url": "https://github.com/climateinteractive/SDEverywhere/issues"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts --max-warnings 0",
+    "prettier:check": "prettier --check .",
+    "prettier:fix": "prettier --write .",
+    "precommit": "../../scripts/precommit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ci": "vitest run",
+    "type-check": "tsc --noEmit -p tsconfig-build.json",
+    "build": "tsup",
+    "docs": "../../scripts/gen-docs.js",
+    "ci:build": "run-s clean lint prettier:check test:ci type-check build docs"
+  }
+}