Support multiple workers for NODEFS /wordpress mounts

.github/actions/prepare-playground/action.yml

@@ -24,7 +24,7 @@ runs:
           with:
               # caching node_modules
               path: node_modules
-              key: ${{ runner.os }}-${{ runner.arch }}-build-${{ env.cache-name }}-${{ hashFiles('package-lock.json') }}
+              key: ${{ runner.os }}-${{ runner.arch }}-node-${{ inputs.node-version }}-build-${{ env.cache-name }}-${{ hashFiles('package-lock.json') }}
               restore-keys: |
                   ${{ runner.os }}-build-${{ env.cache-name }}-
                   ${{ runner.os }}-build-

.github/workflows/ci.yml

@@ -30,34 +30,36 @@ jobs:
             fail-fast: false
             matrix:
                 include:
-                    - name: test-unit-asyncify (1/14)
+                    - name: test-unit-asyncify (1/15)
                       target: test
-                    - name: test-unit-asyncify (2/14)
+                    - name: test-unit-asyncify (2/15)
                       target: test-php
-                    - name: test-unit-asyncify (3/14)
+                    - name: test-unit-asyncify (3/15)
                       target: test-php-request-handler-files
-                    - name: test-unit-asyncify (4/14)
+                    - name: test-unit-asyncify (4/15)
                       target: test-php-request-handler-requests
-                    - name: test-unit-asyncify (5/14)
+                    - name: test-unit-asyncify (5/15)
                       target: test-php-asyncify-file-get-contents-http
-                    - name: test-unit-asyncify (6/14)
+                    - name: test-unit-asyncify (6/15)
                       target: test-php-asyncify-file-get-contents-https
-                    - name: test-unit-asyncify (7/14)
+                    - name: test-unit-asyncify (7/15)
                       target: test-php-asyncify-fopen-http
-                    - name: test-unit-asyncify (8/14)
+                    - name: test-unit-asyncify (8/15)
                       target: test-php-asyncify-fopen-https
-                    - name: test-unit-asyncify (9/14)
+                    - name: test-unit-asyncify (9/15)
                       target: test-php-asyncify-fsockopen-http
-                    - name: test-unit-asyncify (10/14)
+                    - name: test-unit-asyncify (10/15)
                       target: test-php-asyncify-fsockopen-https
-                    - name: test-unit-asyncify (11/14)
+                    - name: test-unit-asyncify (11/15)
                       target: test-php-asyncify-gethostbyname-http
-                    - name: test-unit-asyncify (12/14)
+                    - name: test-unit-asyncify (12/15)
                       target: test-php-asyncify-gethostbyname-https
-                    - name: test-unit-asyncify (13/14)
+                    - name: test-unit-asyncify (13/15)
                       target: test-php-asyncify-mysqli-http
-                    - name: test-unit-asyncify (14/14)
+                    - name: test-unit-asyncify (14/15)
                       target: test-php-asyncify-mysqli-https
+                    - name: test-unit-sqlite3 (15/15)
+                      target: test-php-asyncify-sqlite3
         name: ${{ matrix.name }}
         services:
             mysql:
@@ -189,6 +191,8 @@ jobs:
               with:
                   submodules: true
             - uses: ./.github/actions/prepare-playground
+              with:
+                  node-version: 22
             - name: Generate a mock version number (for releasing the packages in a local registry) and store it as a global variable
               run: |
                   VERSION=$(date +%s)
@@ -209,10 +213,20 @@ jobs:
             - name: Package repository
               run: |
                   npx nx run-many --all --target=package-for-self-hosting -- --hostingBaseUrl="$PACKAGE_BASE_URL"
-            - name: Install Bun
-              uses: oven-sh/setup-bun@v2
             - name: Start a local node package registry server
-              run: RUNNER_TRACKING_ID="" && (nohup bun ./packages/playground/cli/src/cli.ts server --port=$PORT --mount="$HOST_PATH:/wordpress/$VERSION" --quiet&)
+              run: |
+                  source ~/.nvm/nvm.sh;
+                  nvm install 22;
+                  RUNNER_TRACKING_ID="" && ( \
+                    nohup node \
+                      --experimental-strip-types \
+                      --experimental-transform-types \
+                      --import ./packages/meta/src/node-es-module-loader/register.mts \
+                      ./packages/playground/cli/src/cli.ts server \
+                      --port=$PORT \
+                      --mount="$HOST_PATH:/wordpress/$VERSION" \
+                      --quiet& \
+                    )
             - name: Wait for the package server to be ready
               run: |
                   for i in {1..60}; do

CHANGELOG.md

@@ -4,26 +4,25 @@ All notable changes to this project are documented in this file by a CI job
 that runs on every NPM release. The file follows the [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 format.
 
-## [v1.0.38] (2025-05-22) 
+## [v1.0.38] (2025-05-22)
 
 ### Various
 
-- Revert "[ php-wasm ] add Intl support (#150)". ([#154](https://github.com/Automattic/wordpress-playground-private/pull/154))
-- Use the new SQLite driver. ([#144](https://github.com/Automattic/wordpress-playground-private/pull/144))
-- [ php-wasm ] Add intl support. ([#155](https://github.com/Automattic/wordpress-playground-private/pull/155))
-- [ php-wasm ] Intl : Improve integration. ([#159](https://github.com/Automattic/wordpress-playground-private/pull/159))
-- [ php-wasm ] add Intl support. ([#150](https://github.com/Automattic/wordpress-playground-private/pull/150))
-- [CLI] Enable users to automatically mount their current working directory into Playground. ([#39](https://github.com/Automattic/wordpress-playground-private/pull/39))
-- [PHP-wasm Node] Fix Identifier '__filename' has already been declared. ([#143](https://github.com/Automattic/wordpress-playground-private/pull/143))
-- [Website] Support data URLs in blueprint-url query parameter. ([#158](https://github.com/Automattic/wordpress-playground-private/pull/158))
+-   Revert "[ php-wasm ] add Intl support (#150)". ([#154](https://github.com/Automattic/wordpress-playground-private/pull/154))
+-   Use the new SQLite driver. ([#144](https://github.com/Automattic/wordpress-playground-private/pull/144))
+-   [ php-wasm ] Add intl support. ([#155](https://github.com/Automattic/wordpress-playground-private/pull/155))
+-   [ php-wasm ] Intl : Improve integration. ([#159](https://github.com/Automattic/wordpress-playground-private/pull/159))
+-   [ php-wasm ] add Intl support. ([#150](https://github.com/Automattic/wordpress-playground-private/pull/150))
+-   [CLI] Enable users to automatically mount their current working directory into Playground. ([#39](https://github.com/Automattic/wordpress-playground-private/pull/39))
+-   [PHP-wasm Node] Fix Identifier '\_\_filename' has already been declared. ([#143](https://github.com/Automattic/wordpress-playground-private/pull/143))
+-   [Website] Support data URLs in blueprint-url query parameter. ([#158](https://github.com/Automattic/wordpress-playground-private/pull/158))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @adamziel @bgrgicak @JanJakes @mho22
 
-
 ## [v1.0.37] (2025-05-15)
 
 ### Various

package.json

@@ -72,11 +72,12 @@
 		"ajv": "8.12.0",
 		"async-lock": "1.4.1",
 		"classnames": "^2.3.2",
-		"comlink": "^4.4.1",
+		"comlink": "^4.4.2",
 		"crc-32": "1.2.2",
 		"diff3": "0.0.4",
 		"express": "4.21.2",
 		"file-saver": "^2.0.5",
+		"fs-ext": "2.1.1",
 		"fs-extra": "11.1.1",
 		"ini": "4.1.2",
 		"octokit": "3.1.2",
@@ -109,6 +110,7 @@
 		"@playwright/test": "1.47.1",
 		"@types/ajv": "1.0.0",
 		"@types/file-saver": "^2.0.5",
+		"@types/fs-ext": "2.0.3",
 		"@types/fs-extra": "11.0.4",
 		"@types/ini": "4.1.0",
 		"@types/jest": "29.5.14",

packages/docs/site/docs/developers/06-apis/javascript-api/06-mount-data.md

@@ -46,21 +46,21 @@ try {
 		initialSyncDirection: hasWordPressSiteInOPFS ? 'opfs-to-memfs' : 'memfs-to-opfs',
 	};
 
-	const client = await startPlaygroundWeb( {
+	const client = await startPlaygroundWeb({
 		iframe: document.getElementById('wp'),
 		remoteUrl: 'https://playground.wordpress.net/remote.html',
 		blueprint: blueprint,
-		shouldInstallWordPress: ! hasWordPressSiteInOPFS,
-		mounts: hasWordPressSiteInOPFS ? [ mountDescriptor ] : [],
-	} );
+		shouldInstallWordPress: !hasWordPressSiteInOPFS,
+		mounts: hasWordPressSiteInOPFS ? [mountDescriptor] : [],
+	});
 
-	if ( ! hasWordPressSiteInOPFS ) {
-		await client.mountOpfs( mountDescriptor );
+	if (!hasWordPressSiteInOPFS) {
+		await client.mountOpfs(mountDescriptor);
 	}
 
 	await client.isReady();
 	return client;
-} catch ( error ) {
+} catch (error) {
 	// handle error here
 }
 ```

packages/docs/site/docs/developers/23-architecture/11-browser-php-worker-threads.md

@@ -33,4 +33,4 @@ await phpClient.run({ code: `<?php echo "Hello from the thread!";` });
 
 Exchanging messages is the only way to control web workers. The main application has no access to functions or variables inside of a web worker. It can only send and receive messages using `worker.postMessage` and `worker.onmessage = function(msg) { }`.
 
-This can be tedious, which is why Playground provides a convenient [consumeAPI](/api/web/function/consumeAPI) function that abstracts the message exchange and exposes specific functions from the web worker. This is why we can call `phpClient.run` in the example above.
+This can be tedious, which is why Playground provides a convenient [consumeAPI](/api/universal/function/consumeAPI) function that abstracts the message exchange and exposes specific functions from the web worker. This is why we can call `phpClient.run` in the example above.

packages/docs/site/docs/main/changelog.md

@@ -9,26 +9,25 @@ All notable changes to this project are documented in this file by a CI job
 that runs on every NPM release. The file follows the [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 format.
 
-## [v1.0.38] (2025-05-22) 
+## [v1.0.38] (2025-05-22)
 
 ### Various
 
-- Revert "[ php-wasm ] add Intl support (#150)". ([#154](https://github.com/Automattic/wordpress-playground-private/pull/154))
-- Use the new SQLite driver. ([#144](https://github.com/Automattic/wordpress-playground-private/pull/144))
-- [ php-wasm ] Add intl support. ([#155](https://github.com/Automattic/wordpress-playground-private/pull/155))
-- [ php-wasm ] Intl : Improve integration. ([#159](https://github.com/Automattic/wordpress-playground-private/pull/159))
-- [ php-wasm ] add Intl support. ([#150](https://github.com/Automattic/wordpress-playground-private/pull/150))
-- [CLI] Enable users to automatically mount their current working directory into Playground. ([#39](https://github.com/Automattic/wordpress-playground-private/pull/39))
-- [PHP-wasm Node] Fix Identifier '__filename' has already been declared. ([#143](https://github.com/Automattic/wordpress-playground-private/pull/143))
-- [Website] Support data URLs in blueprint-url query parameter. ([#158](https://github.com/Automattic/wordpress-playground-private/pull/158))
+-   Revert "[ php-wasm ] add Intl support (#150)". ([#154](https://github.com/Automattic/wordpress-playground-private/pull/154))
+-   Use the new SQLite driver. ([#144](https://github.com/Automattic/wordpress-playground-private/pull/144))
+-   [ php-wasm ] Add intl support. ([#155](https://github.com/Automattic/wordpress-playground-private/pull/155))
+-   [ php-wasm ] Intl : Improve integration. ([#159](https://github.com/Automattic/wordpress-playground-private/pull/159))
+-   [ php-wasm ] add Intl support. ([#150](https://github.com/Automattic/wordpress-playground-private/pull/150))
+-   [CLI] Enable users to automatically mount their current working directory into Playground. ([#39](https://github.com/Automattic/wordpress-playground-private/pull/39))
+-   [PHP-wasm Node] Fix Identifier '\_\_filename' has already been declared. ([#143](https://github.com/Automattic/wordpress-playground-private/pull/143))
+-   [Website] Support data URLs in blueprint-url query parameter. ([#158](https://github.com/Automattic/wordpress-playground-private/pull/158))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @adamziel @bgrgicak @JanJakes @mho22
 
-
 ## [v1.0.37] (2025-05-15)
 
 ### Various