fix(runtime): pin PHP 8.4 overlay with extension ABI exports

.gitignore

@@ -7,7 +7,10 @@ artifacts/
 runtime-overlays/*
 !runtime-overlays/php-wasm-node-8-3/
 !runtime-overlays/php-wasm-node-8-3/**
+!runtime-overlays/php-wasm-node-8-4/
+!runtime-overlays/php-wasm-node-8-4/**
 !runtime-overlays/provenance.json
+!runtime-overlays/provenance-8-4.json
 scripts/uploads/
 *.tsbuildinfo
 .DS_Store

package.json

@@ -83,8 +83,10 @@
     "scripts/apply-development-patches.mjs",
     "patches",
     "runtime-overlays/php-wasm-node-8-3",
+    "runtime-overlays/php-wasm-node-8-4",
     "runtime-overlays/mdi-native",
     "runtime-overlays/provenance.json",
+    "runtime-overlays/provenance-8-4.json",
     "README.md",
     "LICENSE"
   ],
@@ -140,6 +142,7 @@
     "test:phpunit-runtime-rejection": "tsx tests/phpunit-runtime-rejection.test.ts",
     "test:phpunit-result-paths": "tsx tests/phpunit-result-paths.test.ts",
     "test:php-wasm-runtime-rejection-any-command": "tsx tests/php-wasm-runtime-rejection-any-command.test.ts",
+    "test:php-wasm-external-extension-abi": "tsx tests/php-wasm-external-extension-abi.test.ts",
     "test:browser-visual-compare-layout-drift": "tsx tests/browser-visual-compare-layout-drift.test.ts",
     "test:browser-visual-compare-capture-reliability": "tsx tests/browser-visual-compare-capture-reliability.test.ts",
     "test:browser-visual-compare-url-capture": "npm run build && tsx tests/browser-visual-compare-url-capture.test.ts",
@@ -204,7 +207,7 @@
     "@automattic/wp-codebox-core": "file:packages/runtime-core",
     "@automattic/wp-codebox-playground": "file:packages/runtime-playground",
     "@php-wasm/node-8-3": "file:runtime-overlays/php-wasm-node-8-3",
-    "@php-wasm/node-8-4": "3.1.46",
+    "@php-wasm/node-8-4": "file:runtime-overlays/php-wasm-node-8-4",
     "@php-wasm/universal": "3.1.46",
     "@types/pngjs": "^6.0.5",
     "@wp-playground/cli": "3.1.46",

patches/README.md

@@ -17,3 +17,12 @@ checksum-verifies the immutable patch and Playground revision
 package, and verifies `mysqli_poll()` against MariaDB before uploading the
 package and provenance. Remove the patch, vendored package, and workflow after
 a published Playground package contains the same fix.
+
+`runtime-overlays/php-wasm-node-8-4` carries the published `@php-wasm/node-8-4`
+3.1.53 JSPI/Asyncify artifacts (Playground revision
+`8cd60ace8c3d32c8cb2b569b7471fdd98f88013e`), which include the external-extension
+ABI exports from WordPress Playground PR
+[#4108](https://github.com/WordPress/wordpress-playground/pull/4108). The overlay
+package version stays at 3.1.46 so `@php-wasm/node` 3.1.46 dedupes onto it. Remove
+the overlay after the Playground driver and PHP 8.3 overlay move together onto a
+release that contains both #4108 and #4170.

runtime-overlays/php-wasm-node-8-4/README.md

@@ -0,0 +1,33 @@
+# @php-wasm/node-8-4
+
+PHP 8.4 WebAssembly binaries for Node.js.
+
+This package contains:
+
+- JSPI and Asyncify variants of PHP 8.4 compiled to WebAssembly
+- intl extension for PHP 8.4
+- xdebug extension for PHP 8.4
+
+## Installation
+
+```bash
+npm install @php-wasm/node-8-4
+```
+
+## Usage
+
+```typescript
+import { getPHPLoaderModule, getIntlExtensionPath } from '@php-wasm/node-8-4';
+
+const loaderModule = await getPHPLoaderModule();
+const intlPath = await getIntlExtensionPath();
+```
+
+## Related Packages
+
+- [@php-wasm/node](https://www.npmjs.com/package/@php-wasm/node) - Main package (requires version packages)
+- [@php-wasm/universal](https://www.npmjs.com/package/@php-wasm/universal) - Universal PHP.wasm bindings
+
+## License
+
+GPL-2.0-or-later

runtime-overlays/php-wasm-node-8-4/asyncify/extensions/intl/intl.la

@@ -0,0 +1,35 @@
+# intl.la - a libtool library file
+# Generated by ltmain.sh - GNU libtool 1.5.26 (1.1220.2.492 2008/01/30 06:40:56)
+#
+# Please DO NOT delete this file!
+# It is necessary for linking the library.
+
+# The name that we can dlopen(3).
+dlname='intl.so'
+
+# Names of this library.
+library_names='intl.so intl.so intl.so'
+
+# The name of the static archive.
+old_library=''
+
+# Libraries that this one depends upon.
+dependency_libs=' -L/root/lib'
+
+# Version information for intl.
+current=0
+age=0
+revision=0
+
+# Is this an already installed library?
+installed=yes
+
+# Should we warn about portability when linking against -modules?
+shouldnotlink=yes
+
+# Files to dlopen/dlpreopen
+dlopen=''
+dlpreopen=''
+
+# Directory that this library needs to be installed in:
+libdir='/root/php-src/ext/intl/modules'

runtime-overlays/php-wasm-node-8-4/asyncify/extensions/xdebug/xdebug.la

@@ -0,0 +1,35 @@
+# xdebug.la - a libtool library file
+# Generated by ltmain.sh - GNU libtool 1.5.26 (1.1220.2.492 2008/01/30 06:40:56)
+#
+# Please DO NOT delete this file!
+# It is necessary for linking the library.
+
+# The name that we can dlopen(3).
+dlname='xdebug.so'
+
+# Names of this library.
+library_names='xdebug.so xdebug.so xdebug.so'
+
+# The name of the static archive.
+old_library=''
+
+# Libraries that this one depends upon.
+dependency_libs=''
+
+# Version information for xdebug.
+current=0
+age=0
+revision=0
+
+# Is this an already installed library?
+installed=yes
+
+# Should we warn about portability when linking against -modules?
+shouldnotlink=yes
+
+# Files to dlopen/dlpreopen
+dlopen=''
+dlpreopen=''
+
+# Directory that this library needs to be installed in:
+libdir='/root/xdebug/modules'