@@ -1,19 +1,3 @@
-[target.wasm32-unknown-unknown]
-rustflags = [
-    "-C", "target-feature=+atomics",
-    "-Clink-args=--shared-memory",
-    "-Clink-args=--import-memory",
-    "-Clink-args=--max-memory=1073741824",
-    "-Clink-args=--export=__wasm_init_tls",
-    "-Clink-args=--export=__tls_size",
-    "-Clink-args=--export=__tls_align",
-    "-Clink-args=--export=__tls_base",
-]
-# Ciantic: Tested +simd128 22.7.2021, didn't work! Got some wasm-opt problems.
-# 2024-10-01 - It now works, but threading works without it. So probably best to wait for it to stabilize.
-# 2025-06-12 - mutable-globals is enabled by default, and bulk-memory is enabled by default on Rust 1.87+
-# 2025-10-02 - rust now requires extra -Clink-args to enable shared-memory, see https://github.com/rust-lang/rust/pull/147225
-
-[unstable]
-build-std = ["panic_abort", "std"]
-
+# this is mainly for rust-analyzer
+[env]
+WASM_BINDGEN_USE_JS_SYS="1"
@@ -0,0 +1,40 @@
+name: Docs
+
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+    branches:
+    - main
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: Pistonight/mono-dev/actions/setup@main
+        with:
+          ecma-pnpm: true
+          tool-mdbook: true
+      - run: task build-doc
+      - uses: actions/upload-pages-artifact@v5
+        if: github.event_name != 'pull_request'
+        with:
+          path: packages/docs/book
+          retention-days: 3
+
+  deploy-docs:
+    name: deploy-docs
+    needs:
+      - docs
+    if: github.event_name != 'pull_request'
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5
@@ -5,3 +5,5 @@ node_modules
 !/src/js/createDispatcher.min.js
 /mono-dev
 rust-toolchain
+.task
+.cert
@@ -1,31 +1,19 @@
-[package]
-name = "wasm-bindgen-spawn"
-version = "0.0.5"
-edition = "2024"
-description = "Web Worker Multithreading library for wasm-bindgen the uses shared memory"
-repository = "https://github.com/Pistonite/wasm-bindgen-spawn"
-license = "MIT"
-authors = ["Pistonight <pistonknight@outlook.com>"]
-keywords = ["WASM", "threads", "atomics", "wasm-bindgen", "shared-memory"]
-categories = ["web-programming", "wasm"]
-include = [
-    "/.cargo/config.toml",
-    "/.gitignore",
-    "src/js/createDispatcher.min.js",
-    "src/**/*.rs",
-    "Cargo.toml",
-    "/LICENSE",
-    "/README.md",
+[workspace]
+resolver = "2"
+members = [
+    "packages/example",
+    "packages/lib",
 ]
 
-[dependencies]
-js-sys = "0.3.83"
-oneshot = { version = "0.1.11", default-features = false, features = ["std"] }
-static_assertions = "1.1.0"
-thiserror = "2.0.17"
-wasm-bindgen = "0.2.106"
-wasm-bindgen-futures = { version = "0.4.56", optional = true }
+[workspace.dependencies]
+# If versions are changed please also update docs/src/support.md
+wasm-bindgen = "0.2.127"
+js-sys = "0.3.104"
+
 
-[features]
-default = ["async"]
-async = ["wasm-bindgen-futures"]
+anyhow = "1.0.104"
+console_error_panic_hook = "0.1.7"
+oneshot = { version = "0.2.1", default-features = false }
+tokio = "1.53.1"
+static_assertions = "1.1.0"
+thiserror = "2.0.20"
@@ -1,6 +1,5 @@
 # wasm-bindgen-spawn
 
-![Build Badge](https://img.shields.io/github/check-runs/Pistonite/wasm-bindgen-spawn/main)
 ![Version Badge](https://img.shields.io/crates/v/wasm-bindgen-spawn)
 ![License Badge](https://img.shields.io/github/license/Pistonite/wasm-bindgen-spawn)
 ![Issue Badge](https://img.shields.io/github/issues/Pistonite/wasm-bindgen-spawn)
@@ -9,10 +8,10 @@ A Web Worker based multithreading library for Rust and WebAssembly.
 
 This uses the WebAssembly [threads proposal](https://github.com/WebAssembly/threads/blob/master/proposals/threads/Overview.md)
 and shared memory to communicate between workers (once they are started), instead of `postMessage`.
-The threads proposal is currently in [phase 4](https://webassembly.org/features/) and available in Chrome, Firefox, Safari and Node.js
+The threads proposal is currently in [phase 4](https://webassembly.org/features/) and available in all major browsers and runtimes.
 
 At the current stage, this is the closest thing to `std::thread::spawn`
-that "Just Works" for `wasm32-unknown-unknown` target. You can:
+that "Just Works" for `wasm32-unknown-unknown` target. For example you can:
 - Spawn a thread with a Rust closure
 - Join a thread
 - Send data between threads using channels
@@ -23,73 +22,12 @@ will remain on version `0.0.x` until all features required are in stable Rust,
 standardized in WASM, and baseline widely available across browsers.
 
 ## Examples
-The [`examples`](https://github.com/Pistonite/wasm-bindgen-spawn/tree/main/example) directory 
-on GitHub contains a full example using Vite. Check out the [live demo](https://wasm-bindgen-spawn.pistonite.org)
+The [Playground](https://wbgspawn-playground.pistonite.dev) has runnable examples and links to their source code on GitHub.
 
-See [ThreadCreator](https://docs.rs/wasm-bindgen-spawn/latest/wasm_bindgen_spawn/struct.ThreadCreator.html) for the main API.
+## Documentation
+- For setup, tutorial, and concepts, please refer to [the book](https://wbgspawn.pistonite.dev).
+- For technical reference, refer to [API documentation on docs.rs](https://docs.rs/wasm-bindgen-spawn).
+- There is also a [blog post](https://wbgspawn.psitonite.dev/design.html) I wrote when I first made this library
 
-## Background/Design
-I wrote a blog on how and why this library is designed this way,
-and what the limitations are. You can read it [here](https://pistonite.github.io/wasm-bindgen-spawn).
-
-## Requirements
-
-### Cross-Origin Isolation
-
-You can read more about this in the [web dev article](https://web.dev/articles/coop-coep). Long story short:
-- This is required for `SharedArrayBuffer`
-- This is to mitigate Spectre-like attacks
-
-To get started, the server that serves the main document must send these headers:
-```
-Cross-Origin-Embedder-Policy: require-corp
-Cross-Origin-Opener-Policy: same-origin
-```
-
-You can check if the document is in a cross-origin isolated context by running this in the console:
-```javascript
-self.crossOriginIsolated
-```
-
-Read the full article for more details on the implications of Cross-Origin Isolation.
-
-### Rust Nightly and `target-feature`
-1. Create a `rust-toolchain` file (no extensions) and put `nightly` in it, to use the nightly toolchain
-    ```sh
-    echo "nightly" > rust-toolchain
-    ```
-2. Add the following to `.cargo/config.toml`
-    ```toml
-    [target.wasm32-unknown-unknown]
-    rustflags = [
-        "-C", "target-feature=+atomics",
-        "-Clink-args=--shared-memory",
-        "-Clink-args=--import-memory",
-        "-Clink-args=--max-memory=1073741824",
-        "-Clink-args=--export=__wasm_init_tls",
-        "-Clink-args=--export=__tls_size",
-        "-Clink-args=--export=__tls_align",
-        "-Clink-args=--export=__tls_base",
-    ]
-    # You also need `bulk-memory` for Rust < 1.87. For 1.87+ it's enabled by default
-    # rustflags = ["-C", "target-feature=+atomics,+bulk-memory"]
-
-    [unstable]
-    build-std = ["panic_abort", "std"]
-    ```
-
-### `wasm-pack` Target
-Currently, this library only supports the `no-modules` target:
-```sh
-wasm-pack build -t no-modules
-```
-
-### WASM in Web Worker
-Since the main thread in web cannot block, you must use blocking operations in a 
-web worker, this include:
-1. Calling `join` on a JoinHandle
-2. Calling `recv` on a Receiver in the `std::sync` library or `oneshot` library.
-
-The [example](https://github.com/Pistonite/wasm-bindgen-spawn/tree/main/example) shows how to put the WASM module in the worker. You can
-then use some kind of RPC with `postMessage` to communicate between the main thread and the worker.
-This is probably something you have to do anyway to avoid the heavy, multithreaded computation freezing the UI.
+## Contributing
+Contribution is accepted. Please refer to the [Contribution Guidelines](https://wbgspawn.pistonite.dev/contributing.html)
@@ -1,43 +1,73 @@
 version: '3'
 
 includes:
-  example:
-    aliases: [ex]
-    taskfile: ./example
-    dir: ./example
+  common:
+    taskfile: ./node_modules/mono-dev/task/common.yaml
+    flatten: true
+    optional: true
 
   cargo:
-    taskfile: ./mono-dev/task/cargo.yaml
+    taskfile: ./node_modules/mono-dev/task/cargo.yaml
     internal: true
     optional: true
 
+  disp:    { taskfile: packages/dispatcher, dir: packages/dispatcher, internal: true }
+  example: { taskfile: packages/example,    dir: packages/example,    internal: true }
+  lib:     { taskfile: packages/lib,        dir: packages/lib,        internal: true }
+  test:    { taskfile: packages/test,       dir: packages/test,       internal: true }
+  website: { taskfile: packages/website,    dir: packages/website,    internal: true }
+  docs:    { taskfile: packages/docs,       dir: packages/docs,       internal: true }
+    
+
 tasks:
   install-cargo-extra-tools:
     aliases: [icets]
     cmds:
-      - cargo install txtpp
-
+      # requires edge wasm-pack for a newer version of binaryen
+      - cargo install wasm-pack --git https://github.com/wasm-bindgen/wasm-pack --branch master
+      - cargo binstall shwoop mdbook
   install:
     cmds:
-      - rm -rf mono-dev
-      - git clone https://github.com/Pistonight/mono-dev --depth 1
-      - echo "nightly" > example/rust-toolchain
+      - pnpm install
+      - task: docs:install
       - echo "nightly" > rust-toolchain
 
-  build:
-    desc: Incrementally dev build
-    cmds:
-      - txtpp src/js/createDispatcher.min.js
-      - cd example && pnpm run wasm
-
   check:
-    desc: Check for issues
-    cmds:
-      - task: cargo:clippy-all
-      - task: cargo:fmt-check
+    - task: disp:check
+    - task: disp:build
+    - task: lib:check
+    - task: example:check
+    - task: test:check
+    - task: website:check
 
   fix:
-    desc: Fix issues
+    - task: disp:fix
+    - task: test:fix
+    - task: website:fix
+    - cargo fmt
+
+  build:
+    desc: Ensure everything builds
     cmds:
-      - task: cargo:fmt-fix
-      - txtpp src -r
+      - task: build-test
+      - task: build-web
+      - task: build-doc
+    
+  build-doc:
+    - task: docs:install
+    - task: docs:build
+
+  build-test:
+    - task: test:build
+
+  build-web:
+    - task: website:build
+
+  clean:
+    - rm -rf target node_modules
+    - rm -rf packages/build-*/target
+    - rm -rf packages/dispatcher/node_modules packages/dispatcher/.task
+    - rm -rf packages/dispatcher/node_modules packages/dispatcher/.task
+    - rm -rf packages/lib/.task packages/lib/target
+    - rm -rf packages/test/.task packages/test/target packages/test/node_modules
+    - rm -rf packages/website/.task packages/website/dist packages/website/node_modules