@php-wasm/web 3.1.21 → 3.1.22

package/lib/extensions/load-extensions.d.ts

@@ -0,0 +1,37 @@
+import type { EmscriptenOptions, PHPExtensionInstallOptions, PHPWasmAsyncMode, SupportedPHPVersion } from '@php-wasm/universal';
+/**
+ * Built-in PHP extensions shipped with `@php-wasm/web`.
+ */
+export type BuiltInPHPWebExtensionName = 'intl';
+/**
+ * External PHP extension source that can be installed before PHP starts.
+ *
+ * The runtime supplies the active PHP version and async mode before
+ * resolving the source, so callers only provide the artifact source and
+ * install options.
+ */
+export type RuntimePHPWebExtensionSource = PHPExtensionInstallOptions;
+/**
+ * PHP extension request accepted by `loadWebRuntime()`.
+ *
+ * The array may mix built-in extension names with external extension sources:
+ *
+ * ```ts
+ * await loadWebRuntime('8.4', {
+ *   extensions: [
+ *     'intl',
+ *     { source: { format: 'manifest', manifestUrl } },
+ *   ],
+ * });
+ * ```
+ */
+export type PHPWebExtension = BuiltInPHPWebExtensionName | {
+    name: BuiltInPHPWebExtensionName;
+} | RuntimePHPWebExtensionSource;
+/**
+ * Adds PHP extensions to Emscripten options before the Web runtime starts.
+ *
+ * Extension sources are resolved in parallel so multiple manifest or artifact
+ * downloads do not block each other.
+ */
+export declare function withPHPExtensions(version: SupportedPHPVersion, asyncMode: PHPWasmAsyncMode, options: EmscriptenOptions, extensions?: PHPWebExtension[]): Promise<EmscriptenOptions>;

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 export type { LoaderOptions as PHPWebLoaderOptions } from './load-runtime';
+export type { BuiltInPHPWebExtensionName, PHPWebExtension, RuntimePHPWebExtensionSource, } from './extensions/load-extensions';
 export { loadWebRuntime } from './load-runtime';
 export { getPHPLoaderModule } from './get-php-loader-module';
 export { setupPostMessageRelay } from './setup-post-message-relay';

package/lib/load-runtime.d.ts

@@ -1,9 +1,20 @@
 import type { AllPHPVersion, EmscriptenOptions, PHPLoaderModule } from '@php-wasm/universal';
 import type { TCPOverFetchOptions } from './tcp-over-fetch-websocket';
+import { type PHPWebExtension } from './extensions/load-extensions';
 export interface LoaderOptions {
     emscriptenOptions?: EmscriptenOptions;
     onPhpLoaderModuleLoaded?: (module: PHPLoaderModule) => void;
     tcpOverFetch?: TCPOverFetchOptions;
+    /**
+     * PHP extensions to install before the runtime starts.
+     *
+     * Use built-in names such as `intl`, or pass an external extension source
+     * such as a manifest.
+     */
+    extensions?: PHPWebExtension[];
+    /**
+     * @deprecated Use `extensions: ['intl']` instead.
+     */
     withIntl?: boolean;
 }
 export declare function loadWebRuntime(phpVersion: AllPHPVersion, loaderOptions?: LoaderOptions): Promise<number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/web",
-  "version": "3.1.21",
+  "version": "3.1.22",
   "description": "PHP.wasm for the web",
   "repository": {
     "type": "git",
@@ -37,11 +37,6 @@
   "main": "./index.cjs",
   "module": "./index.js",
   "types": "index.d.ts",
-  "gitHead": "5864051cbf4c2a55656112d99a3f1b076bcd67cd",
-  "engines": {
-    "node": ">=20.10.0",
-    "npm": ">=10.2.3"
-  },
   "dependencies": {
     "@zip.js/zip.js": "2.7.57",
     "async-lock": "1.4.1",
@@ -64,21 +59,26 @@
     "wasm-feature-detect": "1.8.0",
     "ws": "8.18.0",
     "yargs": "17.7.2",
-    "@php-wasm/util": "3.1.21",
-    "@php-wasm/universal": "3.1.21",
-    "@php-wasm/logger": "3.1.21",
-    "@php-wasm/fs-journal": "3.1.21",
-    "@wp-playground/storage": "3.1.21",
-    "@php-wasm/web-8-5": "3.1.21",
-    "@php-wasm/web-8-4": "3.1.21",
-    "@php-wasm/web-8-3": "3.1.21",
-    "@php-wasm/web-8-2": "3.1.21",
-    "@php-wasm/web-8-1": "3.1.21",
-    "@php-wasm/web-8-0": "3.1.21",
-    "@php-wasm/web-7-4": "3.1.21",
-    "@wp-playground/common": "3.1.21",
-    "@php-wasm/web-5-2": "3.1.21",
-    "@php-wasm/web-service-worker": "3.1.21"
+    "@php-wasm/util": "3.1.22",
+    "@php-wasm/universal": "3.1.22",
+    "@php-wasm/logger": "3.1.22",
+    "@php-wasm/fs-journal": "3.1.22",
+    "@wp-playground/storage": "3.1.22",
+    "@php-wasm/web-8-5": "3.1.22",
+    "@php-wasm/web-8-4": "3.1.22",
+    "@php-wasm/web-8-3": "3.1.22",
+    "@php-wasm/web-8-2": "3.1.22",
+    "@php-wasm/web-8-1": "3.1.22",
+    "@php-wasm/web-8-0": "3.1.22",
+    "@php-wasm/web-7-4": "3.1.22",
+    "@wp-playground/common": "3.1.22",
+    "@php-wasm/web-5-2": "3.1.22",
+    "@php-wasm/web-service-worker": "3.1.22"
+  },
+  "gitHead": "04c986b63dd56fe74e4ed0cf04d00cae7ac050bf",
+  "engines": {
+    "node": ">=20.10.0",
+    "npm": ">=10.2.3"
   },
   "packageManager": "npm@10.9.2",
   "overrides": {

package/test/playwright/browser-globals.d.ts

@@ -0,0 +1,12 @@
+import { PHP, PHPRequestHandler, proxyFileSystem, setPhpIniEntries } from '@php-wasm/universal';
+import { generateCertificate, loadWebRuntime } from '../../lib';
+declare global {
+    interface Window {
+        PHP: typeof PHP;
+        PHPRequestHandler: typeof PHPRequestHandler;
+        loadWebRuntime: typeof loadWebRuntime;
+        proxyFileSystem: typeof proxyFileSystem;
+        setPhpIniEntries: typeof setPhpIniEntries;
+        generateCertificate: typeof generateCertificate;
+    }
+}

package/lib/extensions/intl/with-intl.d.ts

@@ -1,2 +0,0 @@
-import type { EmscriptenOptions } from '@php-wasm/universal';
-export declare function withIntl(version: "8.5" | "8.4" | "8.3" | "8.2" | "8.1" | "8.0" | "7.4" | undefined, options: EmscriptenOptions): Promise<EmscriptenOptions>;

package/test/playwright/globals.d.ts

@@ -1 +0,0 @@
-export {};