woxi-wasm 0.2.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "woxi-wasm",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Interpreter for a subset of the Wolfram Language, compiled to WebAssembly",
   "keywords": [
     "wolfram",

package/pkg/woxi.d.ts

@@ -1,49 +1,34 @@
 /* tslint:disable */
 /* eslint-disable */
+
 /**
- * Return the playable audio (base64-encoded) from the last `evaluate()`
- * call, if any. Returns an empty string when there is no sound.
+ * Clear all interpreter state (variables and function definitions).
  */
-export function get_sound(): string;
+export function clear(): void;
+
 /**
  * Remove all host-registered in-memory files.
  */
 export function clear_virtual_files(): void;
+
 /**
- * Return SVG rendering of the last text result (with superscripts etc.).
- * Returns an empty string when there is no output SVG (e.g. for Graphics results).
- */
-export function get_output_svg(): string;
-/**
- * Split `input` into top-level statements and return a JSON array of strings.
- * Lets the front-end loop one statement at a time so output (and side
- * effects like `Pause[n]`) appear progressively rather than batched.
- */
-export function split_statements(input: string): string;
-/**
- * Register (or replace) an in-memory file so `Import["name"]` can read it
- * in the browser.
+ * Evaluate a Wolfram Language expression and return the result.
+ * If the expression produces Print output, it is prepended to the result.
  */
-export function set_virtual_file(name: string, data: Uint8Array): void;
+export function evaluate(input: string): string;
+
 /**
- * Render a Manipulate body, its extra display elements, and any pending
- * interactive write-backs in one call. Used by widgets that have display
- * elements (e.g. a `Checkbox` grid) that both read and rewrite shared
- * state.
- *
- * `displays_json` and `mutations_json` are JSON string arrays. Each
- * mutation is an assignment (e.g. `data[[3, 5]] = 1`) applied before the
- * re-render; the updated value of every mutated variable is returned under
- * `state` so the frontend can keep its binding set in sync.
- *
- * The result is `{"output":{svg|text|textSvg}, "displays":[<tree>…],
- * "state":{name:value,…}}`.
+ * Evaluate all top-level statements and return a JSON array of output items.
+ * Each item has a "type" field ("text", "graphics", "print", "warning", "error",
+ * "manipulate") and corresponding content fields.
  */
-export function evaluate_manipulate_full(body: string, displays_json: string, bindings_json: string, mutations_json: string): string;
+export function evaluate_all(input: string): string;
+
 /**
- * Enable or disable dark mode for SVG output colors.
+ * Evaluate, returning only the final expression result (no Print output).
  */
-export function set_dark_mode(enabled: boolean): void;
+export function evaluate_expr(input: string): string;
+
 /**
  * Evaluate a Manipulate body with a specific set of variable bindings
  * and return a single JSON output item representing the result.
@@ -57,21 +42,7 @@ export function set_dark_mode(enabled: boolean): void;
  * the evaluate_all manipulate item: `{"svg": "...", "text": "..."}`.
  */
 export function evaluate_manipulate(body: string, bindings_json: string): string;
-/**
- * Evaluate all top-level statements and return a JSON array of output items.
- * Each item has a "type" field ("text", "graphics", "print", "warning", "error",
- * "manipulate") and corresponding content fields.
- */
-export function evaluate_all(input: string): string;
-/**
- * Return the captured GraphicsBox expression from the last `evaluate()` call.
- * Returns an empty string when there is no graphics output.
- */
-export function get_graphicsbox(): string;
-/**
- * Clear all interpreter state (variables and function definitions).
- */
-export function clear(): void;
+
 /**
  * Evaluate each Manipulate control's `Enabled` condition against a binding
  * set and return a JSON array of booleans (one per control, in order).
@@ -79,33 +50,77 @@ export function clear(): void;
  * `conditions_json` is a JSON string array aligned with the control list;
  * an empty string marks a control with no condition (always enabled).
  * `bindings_json` is the same JSON object of variable bindings used by
- * `evaluate_manipulate`. Used by the Playground to grey out controls that a
+ * `evaluate_manipulate`. Used by the Playground to gray out controls that a
  * `Enabled -> Dynamic[…]` option has switched off for the current state.
  */
 export function evaluate_manipulate_enabled(conditions_json: string, bindings_json: string): string;
+
+/**
+ * Render a Manipulate body, its extra display elements, and any pending
+ * interactive write-backs in one call. Used by widgets that have display
+ * elements (e.g. a `Checkbox` grid) that both read and rewrite shared
+ * state.
+ *
+ * `displays_json` and `mutations_json` are JSON string arrays. Each
+ * mutation is an assignment (e.g. `data[[3, 5]] = 1`) applied before the
+ * re-render; the updated value of every mutated variable is returned under
+ * `state` so the frontend can keep its binding set in sync.
+ *
+ * The result is `{"output":{svg|text|textSvg}, "displays":[<tree>…],
+ * "state":{name:value,…}}`.
+ */
+export function evaluate_manipulate_full(body: string, displays_json: string, bindings_json: string, mutations_json: string): string;
+
 /**
  * Evaluate a single statement and return a JSON array of output items
  * (same shape as `evaluate_all`'s elements). Use together with
  * `split_statements` for progressive output.
  */
 export function evaluate_statement(stmt: string): string;
+
 /**
- * Evaluate, returning only the final expression result (no Print output).
+ * Return the captured SVG graphics from the last `evaluate()` call, if any.
+ * Returns an empty string when there is no graphics output.
  */
-export function evaluate_expr(input: string): string;
+export function get_graphics(): string;
+
+/**
+ * Return the playable audio (base64-encoded) from the last `evaluate()`
+ * call, if any. Returns an empty string when there is no sound.
+ */
+export function get_sound(): string;
+
 /**
  * Return warnings from the last `evaluate()` call as newline-separated text.
  * Returns an empty string when there are no warnings.
  */
 export function get_warnings(): string;
+
+export function init(): void;
+
 /**
- * Return the captured SVG graphics from the last `evaluate()` call, if any.
- * Returns an empty string when there is no graphics output.
+ * Enable or disable dark mode for SVG output colors.
  */
-export function get_graphics(): string;
-export function init(): void;
+export function set_dark_mode(enabled: boolean): void;
+
 /**
- * Evaluate a Wolfram Language expression and return the result.
- * If the expression produces Print output, it is prepended to the result.
+ * Register (or replace) an in-memory file so `Import["name"]` can read it
+ * in the browser.
  */
-export function evaluate(input: string): string;
+export function set_virtual_file(name: string, data: Uint8Array): void;
+
+/**
+ * Split `input` into top-level statements and return a JSON array of strings.
+ * Lets the front-end loop one statement at a time so output (and side
+ * effects like `Pause[n]`) appear progressively rather than batched.
+ */
+export function split_statements(input: string): string;
+
+/**
+ * Return every file produced by `Export` since the last call as a JSON array
+ * of `{"name":…, "data":<base64>[, "rasterize":"png"]}`, then clear the store.
+ * The host decodes each base64 payload into a Blob and renders a download
+ * link; entries carrying `rasterize` hold SVG the host converts to that raster
+ * format first. Draining on read keeps each evaluation's exports separate.
+ */
+export function take_exported_files(): string;