@strategicprojects/rpic 0.6.0 → 0.6.2

package/README.md

@@ -25,7 +25,7 @@ rpic.renderSvg('A:(0,0); B:(2,0)\nresistor(A,B)', { circuits: true });
 ```js
 import { readFileSync } from 'node:fs';
 import * as rpic from '@strategicprojects/rpic';
-await rpic.ready(readFileSync(new URL('./node_modules/rpic/pkg/rpic_wasm_bg.wasm', import.meta.url)));
+await rpic.ready(readFileSync(new URL('./node_modules/@strategicprojects/rpic/pkg/rpic_wasm_bg.wasm', import.meta.url)));
 console.log(rpic.renderSvg('box "hi"'));
 ```
 
@@ -38,19 +38,20 @@ data) that is only fetched when you ask for it:
 
 ```js
 await rpic.ready(undefined, { math: true }); // browser: fetches pkg/rpic_wasm_math_bg.wasm
-rpic.renderSvg('box "$-\\\\frac{T}{2}$" fit', { texlabels: true });
+rpic.renderSvg('box "$-\\frac{T}{2}$" fit', { texlabels: true });
 ```
 
 Apps can keep the fast path untouched and lazy-load math only when the source
-contains `$…$`. The build choice is fixed by the first `ready()` call. In
-Node, pass the math artifact's bytes:
+contains `$…$`. The build choice is fixed by the first `ready()` call; a later
+call that asks for the other build rejects instead of silently reusing the
+first build. In Node, pass the math artifact's bytes:
 `ready(readFileSync(new URL('…/pkg/rpic_wasm_math_bg.wasm', import.meta.url)), { math: true })`.
 
 ## API
 
 | Function | Description |
 |----------|-------------|
-| `ready(wasmInput?, {math?})` | Initialize WASM. Browser: no arg. Node: pass `.wasm` bytes/URL. `math: true` loads the math-enabled build. |
+| `ready(wasmInput?, {math?})` | Initialize WASM. Browser: no arg. Node: pass `.wasm` bytes/URL. `math: true` loads the math-enabled build; conflicting later calls reject. |
 | `compile(src, {circuits?, texlabels?})` | → `{ svg, animations, diagnostics, warnings }` (throws on a pic error with `errorInfo`). |
 | `renderSvg(src, {circuits?, texlabels?})` | → SVG string. |
 | `animate(root, animations, gsap)` | Build/play a GSAP timeline (`draw`/`fade`/`pop`). Browser only. |

package/index.d.ts

@@ -59,15 +59,16 @@ export interface ReadyOptions {
    * Load the math-enabled wasm build (`pkg/rpic_wasm_math_bg.wasm`), which
    * bundles the RaTeX renderer so `texlabels` sources typeset `$…$` labels.
    * The heavier artifact is only fetched when requested; the choice is fixed
-   * by the first `ready()` call. In Node, pass the math wasm bytes as
-   * `wasmInput`.
+   * by the first `ready()` call, and conflicting later calls reject. In Node,
+   * pass the math wasm bytes as `wasmInput`.
    */
   math?: boolean;
 }
 
 /**
  * Initialize the WebAssembly module. In the browser call with no argument; in
- * Node pass the `.wasm` bytes or a file URL.
+ * Node pass the `.wasm` bytes or a file URL. Idempotent while pending or
+ * after success; a *failed* init clears the slot so `ready()` can be retried.
  */
 export function ready(
   wasmInput?: BufferSource | URL | string,

package/index.js

@@ -7,6 +7,7 @@ import * as leanModule from './pkg/rpic_wasm.js';
 
 let initPromise = null;
 let wasm = null; // the initialized glue module (lean or math)
+let initMath = null;
 
 /**
  * Initialize the WebAssembly module (idempotent; concurrent calls share one
@@ -16,18 +17,42 @@ let wasm = null; // the initialized glue module (lean or math)
  * Pass `{ math: true }` to load the math-enabled build instead: it bundles
  * the RaTeX renderer so `texlabels` sources typeset `$…$` labels exactly like
  * the native CLI. The math glue + wasm are only fetched when requested, so
- * the lean fast path stays untouched. The choice is fixed by the first call;
- * in Node, pass the bytes of `pkg/rpic_wasm_math_bg.wasm` along with it.
+ * the lean fast path stays untouched. The choice is fixed by the first
+ * successful (or in-flight) call; later calls asking for the other build
+ * reject. A *failed* init (bad bytes, fetch error) clears the slot so
+ * `ready()` can be retried. In Node, pass the bytes of
+ * `pkg/rpic_wasm_math_bg.wasm` along with it.
  */
 export function ready(wasmInput, opts = {}) {
-  if (!initPromise) {
-    initPromise = (
-      opts.math ? import('./pkg/rpic_wasm_math.js') : Promise.resolve(leanModule)
-    ).then(async (mod) => {
+  const wantsMath = !!opts.math;
+  if (initPromise) {
+    if (initMath !== wantsMath) {
+      const current = initMath ? 'math-enabled' : 'lean';
+      const requested = wantsMath ? 'math-enabled' : 'lean';
+      return Promise.reject(
+        new Error(`rpic: ready() already initialized the ${current} build; cannot switch to ${requested}`)
+      );
+    }
+    return initPromise;
+  }
+  initMath = wantsMath;
+  const attempt = (
+    wantsMath ? import('./pkg/rpic_wasm_math.js') : Promise.resolve(leanModule)
+  )
+    .then(async (mod) => {
       await mod.default(wasmInput === undefined ? undefined : { module_or_path: wasmInput });
       wasm = mod;
+    })
+    .catch((e) => {
+      // a settled rejection must not poison future calls — clear the slot
+      // (only if it is still ours) so the next ready() starts fresh
+      if (initPromise === attempt) {
+        initPromise = null;
+        initMath = null;
+      }
+      throw e;
     });
-  }
+  initPromise = attempt;
   return initPromise;
 }
 

package/package.json

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