@re2tools/re2-wasm-esm 1.0.2 → 1.0.3

package/README.md

@@ -53,6 +53,90 @@ With a bundler (Vite, Webpack, etc.), copy `node_modules/@re2tools/re2-wasm-esm/
 await init({ baseUrl: "https://your-cdn.com/@re2tools/re2-wasm-esm/" });
 ```
 
+### React (16.8+, 17, 18)
+
+This package is React-agnostic (no React dependency). Use it in React 16, 17, or 18 by calling `init()` once, then `getRE2()` in components or helpers.
+
+**Option A — init in entry (recommended, React 16/17)**
+
+```tsx
+// src/index.tsx
+import React from "react";
+import ReactDOM from "react-dom";
+import { init, getRE2 } from "@re2tools/re2-wasm-esm";
+import App from "./App";
+
+async function bootstrap() {
+  await init();
+  ReactDOM.render(<App />, document.getElementById("root"));
+}
+bootstrap();
+```
+
+**React 18** — use `createRoot` instead of `render`:
+
+```tsx
+import { createRoot } from "react-dom/client";
+// after await init():
+createRoot(document.getElementById("root")!).render(<App />);
+```
+
+**Option B — init in a component (React 16.8+ for hooks)**
+
+```tsx
+import { useState, useEffect } from "react";
+import { init, getRE2 } from "@re2tools/re2-wasm-esm";
+
+function useRE2() {
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    init().then(() => setReady(true));
+  }, []);
+  return ready ? getRE2() : null;
+}
+
+// In a component: const RE2 = useRE2(); use RE2 when non-null.
+```
+
+Use RE2 with the **`u`** (unicode) flag: `new RE2("pattern", "u")` or `new RE2(/pattern/u)`.
+
+### Storybook (fix 404 for re2-glue.js / re2.wasm)
+
+Storybook serves from its own dev server, so the loader can’t find `re2.wasm` and `re2-glue.js` unless you serve them and pass their base URL.
+
+**1. Serve the files**
+
+Copy the two files into a folder your app (or Storybook) serves as static:
+
+```bash
+mkdir -p public/re2
+cp node_modules/@re2tools/re2-wasm-esm/dist/re2.wasm node_modules/@re2tools/re2-wasm-esm/dist/re2-glue.js public/re2/
+```
+
+If your project has no `public/`, use whatever directory Storybook uses for static files (e.g. `static/`), or add `staticDirs` in `.storybook/main.js`:
+
+```js
+// .storybook/main.js (or main.ts)
+module.exports = {
+  staticDirs: ['public'],  // or ['static']
+  // ...
+};
+```
+
+**2. Tell the loader where they are**
+
+In `.storybook/preview.js` (or `preview.ts`), init with that base path:
+
+```js
+import { init } from "@re2tools/re2-wasm-esm";
+
+await init({ baseUrl: "/re2/" });
+
+export const parameters = { /* ... */ };
+```
+
+If your app is not at the root (e.g. Storybook base path), use that base: `init({ baseUrl: "/storybook/re2/" })` or use a relative URL that resolves to the same origin where the files are served.
+
 ### API
 
 - **`init(options?: { wasmUrl?, glueUrl?, baseUrl? })`**  

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC;IAED,IAAI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACjD;AAYD,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,6DAA6D;AAC7D,eAAO,IAAI,gBAAgB,EAAE,OAAc,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,KACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,KACZ;QACH,EAAE,IAAI,OAAO,CAAC;QACd,KAAK,IAAI,MAAM,CAAC;QAChB,OAAO,IAAI,MAAM,CAAC;QAClB,KAAK,CACH,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,OAAO,GAC1B;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAA;SAAE,CAAC;QACpE,mBAAmB,IAAI;YAAE,IAAI,IAAI;gBAAE,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;gBAAC,IAAI,IAAI,MAAM,CAAA;aAAE,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACzG,CAAC;CACH;AAkBD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,KAC3C,IAAI,CAAC;AAEV,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,EACzC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACpC,WAAW,CAAC,EAAE;IAAE,WAAW,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,EACpE,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuFlC;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChB;AAED,wBAAgB,SAAS,IAAI,aAAa,CAOzC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAMlD"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC;IAED,IAAI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACjD;AAYD,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,6DAA6D;AAC7D,eAAO,IAAI,gBAAgB,EAAE,OAAc,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,KACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,KACZ;QACH,EAAE,IAAI,OAAO,CAAC;QACd,KAAK,IAAI,MAAM,CAAC;QAChB,OAAO,IAAI,MAAM,CAAC;QAClB,KAAK,CACH,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,OAAO,GAC1B;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAA;SAAE,CAAC;QACpE,mBAAmB,IAAI;YAAE,IAAI,IAAI;gBAAE,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;gBAAC,IAAI,IAAI,MAAM,CAAA;aAAE,CAAC;YAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACzG,CAAC;CACH;AAkBD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,KAC3C,IAAI,CAAC;AAEV,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,EACzC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACpC,WAAW,CAAC,EAAE;IAAE,WAAW,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,EACpE,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+FlC;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChB;AAED,wBAAgB,SAAS,IAAI,aAAa,CAOzC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAMlD"}

package/dist/loader.js

@@ -111,7 +111,15 @@ export function createLoader(getWasmBuffer, getGlueScript, nodeOptions, re2Scrip
                 .catch(rej);
         }
         else {
-            getGlueScript().then(runGlue).catch(rej);
+            // Browser: preload WASM into Module.wasmBinary so Emscripten glue
+            // does not try to sync-fetch (which fails in bundlers/Storybook).
+            getWasmBuffer()
+                .then((buffer) => {
+                Module.wasmBinary = buffer;
+                return getGlueScript();
+            })
+                .then(runGlue)
+                .catch(rej);
         }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@re2tools/re2-wasm-esm",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Google RE2 as WASM - ESM build with browser support (async init)",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,14 +31,21 @@
     "@types/node": "^18.0.0",
     "typescript": "~5.0.0"
   },
-  "peerDependencies": {},
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true }
+  },
   "keywords": [
     "re2",
     "regex",
     "wasm",
     "esm",
     "browser",
-    "redos"
+    "redos",
+    "react",
+    "react16"
   ],
   "license": "Apache-2.0",
   "repository": {