Files
58c2c80401 Migrate from Yarn to pnpm (#246)
* Migrate from Yarn to pnpm

- Replace Yarn 4.0.2 with pnpm 10.29.3 as the package manager
- Add pnpm-workspace.yaml and .npmrc configuration
- Update all scripts to use pnpm commands
- Rename getYarnWorkspaces() to getWorkspaces() in scripts/helpers.ts
- Update CI workflow to use pnpm/action-setup@v4 with Node 22
- Add @jitl/tsconfig as root devDependency for proper resolution
- Add variant packages as devDependencies for test resolution
- Fix TypeScript 5.9 compatibility in memory.ts (Int32Array<ArrayBuffer>)
- Upgrade typedoc to 0.28.17 for TypeScript 5.9 support
- Upgrade typedoc-plugin-markdown to 4.10.0
- Regenerate documentation with new typedoc version

* Clarify git commit --amend rule in CLAUDE.md

* CI: Add --ignore-scripts to pnpm install

Equivalent to yarn's YARN_ENABLE_SCRIPTS=0 - prevents prepare scripts
from running during install, which would fail on a fresh checkout.

* Fix pnpm tarball naming in smoketest scripts

pnpm pack generates tarball names like jitl-quickjs-ffi-types-0.32.0.tgz
(without @ prefix, with version) instead of @jitl-quickjs-ffi-types.tgz

* Update examples to TypeScript 5.9 for compatibility

The library now requires TypeScript 5.9+ due to stricter typed array
generics (Int32Array<ArrayBuffer>). Update all TypeScript-using examples.

* Use --legacy-peer-deps for create-react-app smoketest

react-scripts@5 only supports TypeScript 3.x/4.x, but our library now
requires TypeScript 5.9+ for typed array generics. Use --legacy-peer-deps
to work around the peer dependency conflict.

* Fix formatting issues

* Fix remaining formatting issues

* Add reminder to run prettier and lint before pushing

* Document CI workflow in CLAUDE.md

* Add typedoc.json and remark plugins for in-page table of contents

- Add typedoc-plugin-remark, remark-toc, and remark-insert-headings
- Configure remark plugins to generate "Contents" section for Class,
  Interface, Enum, TypeAlias, and Function pages
- This restores the in-page TOC that lists methods/properties that was
  removed in typedoc-plugin-markdown 4.3.0

* Use custom remark plugin for headless TOC in docs

Replace remark-insert-headings + remark-toc with a custom plugin that
inserts the table of contents directly after the class description,
without a separate "Contents" heading.

* Revert to standard remark plugins for TOC with Contents heading

Use remark-insert-headings + remark-toc instead of custom plugin.
Remove mdast-util-toc dependency and custom remark-toc-headless.mjs.

* Fix lockfile - remove mdast-util-toc

* Ignore pnpm-lock.yaml in prettier, update .yarn to .pnpm

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-02-16 20:35:52 +00:00
..
2023-12-29 18:38:05 +00:00
2023-12-29 18:38:05 +00:00
2023-12-29 18:38:05 +00:00
2023-12-29 18:38:05 +00:00
2026-02-16 20:35:52 +00:00
2024-01-26 16:49:25 -05:00
2023-12-29 18:38:05 +00:00
2023-12-29 18:38:05 +00:00

quickjs-emscripten + cloudflare workers

Cloudflare Workers need some extra setup steps because of the unusual environment and limitations with the bundling defaults, because Cloudflare refuses to let us read these files and compile them from bytes.

  1. We need to copy the WASM files for the QuickJS variants in use into the src directory, so we can import them directly. The script copy-wasm-file-into-src.sh does this. You should copy it to your project, and run it whenever you update quickjs-emscripten to a new version. It will copy the WASM and SourceMap files from node_modules into the src directory every time you run it.
    • This creates the files src/DEBUG_SYNC.wasm and src/DEBUG_SYNC.wasm.map.txt. Add them to your .gitignore.
  2. We need to override the normal loading behavior to use the special imported WebAssembly.Module. See src/index.mts. Copy and paste the code in index.mts into your project, or do something similar:
    • import the quickjs-emscripten WASM files directly, like import wasmModule from './DEBUG_SYNC.wasm'.
    • import the quickjs-emscripten SourceMap.txt files directly as well, like import wasmSourceMapData from './DEBUG_SYNC.wasm.map.txt'.
    • create a new variant using those files: const cloudflareVariant = newVariant(DEBUG_SYNC, { wasmModule, wasmSourceMapData }).
    • Instead of using await getQuickJS(), use newQuickJSWASMModule(cloudflareVariant).