@strategicprojects/rpic 0.3.0 → 0.4.0

package/index.d.ts

@@ -18,6 +18,13 @@ export interface Bundle {
 export interface CompileOptions {
   /** prepend the native circuit-element library (resistor, and_gate, …) */
   circuits?: boolean;
+  /**
+   * set `texlabels = 1`, typesetting fully `$…$`-delimited labels as TeX
+   * math. The default wasm build ships without the math renderer (size
+   * budget), so labels fall back to literal text plus a diagnostic; the
+   * option exists for API parity and future math-enabled builds.
+   */
+  texlabels?: boolean;
 }
 
 /**

package/index.js

@@ -5,6 +5,7 @@
 import initWasm, {
   compile as wasmCompile,
   compile_circuits as wasmCompileCircuits,
+  compile_with as wasmCompileWith,
 } from './pkg/rpic_wasm.js';
 
 let initPromise = null;
@@ -35,11 +36,15 @@ function ensure() {
 /**
  * Compile pic source into `{ svg, animations, diagnostics }` (throws on a pic error).
  * @param {string} src
- * @param {{circuits?: boolean}} [opts]
+ * @param {{circuits?: boolean, texlabels?: boolean}} [opts]
  */
 export function compile(src, opts = {}) {
   ensure();
-  const json = opts.circuits ? wasmCompileCircuits(src) : wasmCompile(src);
+  const json = opts.texlabels
+    ? wasmCompileWith(src, !!opts.circuits, true)
+    : opts.circuits
+      ? wasmCompileCircuits(src)
+      : wasmCompile(src);
   const out = JSON.parse(json);
   if (out.error) throw new Error(out.error);
   return out;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strategicprojects/rpic",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The pic graphics language compiled to SVG with animation manifests, via WebAssembly. Browser + Node.",
   "type": "module",
   "main": "./index.js",

package/pkg/rpic_wasm.d.ts

@@ -13,12 +13,23 @@ export function compile(src: string): string;
  */
 export function compile_circuits(src: string): string;
 
+/**
+ * Like [`compile`], with options: `circuits` prepends the circuit-element
+ * library; `texlabels` sets `texlabels = 1` so `$…$` labels are typeset as
+ * TeX math. Note: this wasm build ships without the math renderer (size
+ * budget), so with `texlabels` the labels currently fall back to literal
+ * text and a diagnostic — the option exists for API parity and for future
+ * math-enabled builds.
+ */
+export function compile_with(src: string, circuits: boolean, texlabels: boolean): string;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly compile: (a: number, b: number) => [number, number];
     readonly compile_circuits: (a: number, b: number) => [number, number];
+    readonly compile_with: (a: number, b: number, c: number, d: number) => [number, number];
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/pkg/rpic_wasm.js

@@ -41,6 +41,33 @@ export function compile_circuits(src) {
         wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
     }
 }
+
+/**
+ * Like [`compile`], with options: `circuits` prepends the circuit-element
+ * library; `texlabels` sets `texlabels = 1` so `$…$` labels are typeset as
+ * TeX math. Note: this wasm build ships without the math renderer (size
+ * budget), so with `texlabels` the labels currently fall back to literal
+ * text and a diagnostic — the option exists for API parity and for future
+ * math-enabled builds.
+ * @param {string} src
+ * @param {boolean} circuits
+ * @param {boolean} texlabels
+ * @returns {string}
+ */
+export function compile_with(src, circuits, texlabels) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(src, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.compile_with(ptr0, len0, circuits, texlabels);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,

package/pkg/rpic_wasm_bg.wasm.d.ts

@@ -3,6 +3,7 @@
 export const memory: WebAssembly.Memory;
 export const compile: (a: number, b: number) => [number, number];
 export const compile_circuits: (a: number, b: number) => [number, number];
+export const compile_with: (a: number, b: number, c: number, d: number) => [number, number];
 export const __wbindgen_externrefs: WebAssembly.Table;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;