@wp-playground/client 0.7.20 → 0.9.2

package/index.d.ts

@@ -195,156 +195,664 @@ export declare class PHPResponse implements PHPResponseData {
 	 */
 	get text(): string;
 }
-/**
- * Represents an event related to the PHP request.
- */
-export interface PHPRequestEndEvent {
-	type: "request.end";
+export type RuntimeType = "NODE" | "WEB" | "WORKER";
+export type PHPRuntimeId = number;
+/** Other WebAssembly declarations, for compatibility with older versions of Typescript */
+export declare namespace Emscripten {
+	export interface RootFS extends Emscripten.FileSystemInstance {
+		filesystems: Record<string, Emscripten.FileSystemType>;
+	}
+	export interface FileSystemType {
+		mount(mount: FS.Mount): FS.FSNode;
+		syncfs(mount: FS.Mount, populate: () => unknown, done: (err?: number | null) => unknown): void;
+	}
+	export type EnvironmentType = "WEB" | "NODE" | "SHELL" | "WORKER";
+	export type JSType = "number" | "string" | "array" | "boolean";
+	export type TypeCompatibleWithC = number | string | any[] | boolean;
+	export type CIntType = "i8" | "i16" | "i32" | "i64";
+	export type CFloatType = "float" | "double";
+	export type CPointerType = "i8*" | "i16*" | "i32*" | "i64*" | "float*" | "double*" | "*";
+	export type CType = CIntType | CFloatType | CPointerType;
+	export interface CCallOpts {
+		async?: boolean | undefined;
+	}
+	type NamespaceToInstance<T> = {
+		[K in keyof T]: T[K] extends (...args: any[]) => any ? T[K] : never;
+	};
+	export type FileSystemInstance = NamespaceToInstance<typeof FS> & {
+		mkdirTree(path: string): void;
+		lookupPath(path: string, opts?: any): FS.Lookup;
+	};
+	export interface EmscriptenModule {
+		print(str: string): void;
+		printErr(str: string): void;
+		arguments: string[];
+		environment: Emscripten.EnvironmentType;
+		preInit: Array<{
+			(): void;
+		}>;
+		preRun: Array<{
+			(): void;
+		}>;
+		postRun: Array<{
+			(): void;
+		}>;
+		onAbort: {
+			(what: any): void;
+		};
+		onRuntimeInitialized: {
+			(): void;
+		};
+		preinitializedWebGLContext: WebGLRenderingContext;
+		noInitialRun: boolean;
+		noExitRuntime: boolean;
+		logReadFiles: boolean;
+		filePackagePrefixURL: string;
+		wasmBinary: ArrayBuffer;
+		destroy(object: object): void;
+		getPreloadedPackage(remotePackageName: string, remotePackageSize: number): ArrayBuffer;
+		instantiateWasm(imports: WebAssembly.Imports, successCallback: (module: WebAssembly.Instance) => void): WebAssembly.Exports | undefined;
+		locateFile(url: string, scriptDirectory: string): string;
+		onCustomMessage(event: MessageEvent): void;
+		HEAP: Int32Array;
+		IHEAP: Int32Array;
+		FHEAP: Float64Array;
+		HEAP8: Int8Array;
+		HEAP16: Int16Array;
+		HEAP32: Int32Array;
+		HEAPU8: Uint8Array;
+		HEAPU16: Uint16Array;
+		HEAPU32: Uint32Array;
+		HEAPF32: Float32Array;
+		HEAPF64: Float64Array;
+		HEAP64: BigInt64Array;
+		HEAPU64: BigUint64Array;
+		TOTAL_STACK: number;
+		TOTAL_MEMORY: number;
+		FAST_MEMORY: number;
+		addOnPreRun(cb: () => any): void;
+		addOnInit(cb: () => any): void;
+		addOnPreMain(cb: () => any): void;
+		addOnExit(cb: () => any): void;
+		addOnPostRun(cb: () => any): void;
+		preloadedImages: any;
+		preloadedAudios: any;
+		_malloc(size: number): number;
+		_free(ptr: number): void;
+	}
+	/**
+	 * A factory function is generated when setting the `MODULARIZE` build option
+	 * to `1` in your Emscripten build. It return a Promise that resolves to an
+	 * initialized, ready-to-call `EmscriptenModule` instance.
+	 *
+	 * By default, the factory function will be named `Module`. It's recommended to
+	 * use the `EXPORT_ES6` option, in which the factory function will be the
+	 * default export. If used without `EXPORT_ES6`, the factory function will be a
+	 * global variable. You can rename the variable using the `EXPORT_NAME` build
+	 * option. It's left to you to export any global variables as needed in your
+	 * application's types.
+	 * @param moduleOverrides Default properties for the initialized module.
+	 */
+	export type EmscriptenModuleFactory<T extends EmscriptenModule = EmscriptenModule> = (moduleOverrides?: Partial<T>) => Promise<T>;
+	export namespace FS {
+		interface Lookup {
+			path: string;
+			node: FSNode;
+		}
+		interface Analyze {
+			isRoot: boolean;
+			exists: boolean;
+			error: Error;
+			name: string;
+			path: Lookup["path"];
+			object: Lookup["node"];
+			parentExists: boolean;
+			parentPath: Lookup["path"];
+			parentObject: Lookup["node"];
+		}
+		interface Mount {
+			type: Emscripten.FileSystemType;
+			opts: object;
+			mountpoint: string;
+			mounts: Mount[];
+			root: FSNode;
+		}
+		class FSStream {
+			constructor();
+			object: FSNode;
+			readonly isRead: boolean;
+			readonly isWrite: boolean;
+			readonly isAppend: boolean;
+			flags: number;
+			position: number;
+		}
+		class FSNode {
+			parent: FSNode;
+			mount: Mount;
+			mounted?: Mount;
+			id: number;
+			name: string;
+			mode: number;
+			rdev: number;
+			readMode: number;
+			writeMode: number;
+			constructor(parent: FSNode, name: string, mode: number, rdev: number);
+			read: boolean;
+			write: boolean;
+			readonly isFolder: boolean;
+			readonly isDevice: boolean;
+		}
+		interface ErrnoError extends Error {
+			name: "ErronoError";
+			errno: number;
+			code: string;
+		}
+		function lookupPath(path: string, opts: any): Lookup;
+		function getPath(node: FSNode): string;
+		function analyzePath(path: string, dontResolveLastLink?: boolean): Analyze;
+		function isFile(mode: number): boolean;
+		function isDir(mode: number): boolean;
+		function isLink(mode: number): boolean;
+		function isChrdev(mode: number): boolean;
+		function isBlkdev(mode: number): boolean;
+		function isFIFO(mode: number): boolean;
+		function isSocket(mode: number): boolean;
+		function major(dev: number): number;
+		function minor(dev: number): number;
+		function makedev(ma: number, mi: number): number;
+		function registerDevice(dev: number, ops: any): void;
+		function syncfs(populate: boolean, callback: (e: any) => any): void;
+		function syncfs(callback: (e: any) => any, populate?: boolean): void;
+		function mount(type: Emscripten.FileSystemType, opts: any, mountpoint: string): any;
+		function unmount(mountpoint: string): void;
+		function mkdir(path: string, mode?: number): any;
+		function mkdev(path: string, mode?: number, dev?: number): any;
+		function symlink(oldpath: string, newpath: string): any;
+		function rename(old_path: string, new_path: string): void;
+		function rmdir(path: string): void;
+		function readdir(path: string): any;
+		function unlink(path: string): void;
+		function readlink(path: string): string;
+		function stat(path: string, dontFollow?: boolean): any;
+		function lstat(path: string): any;
+		function chmod(path: string, mode: number, dontFollow?: boolean): void;
+		function lchmod(path: string, mode: number): void;
+		function fchmod(fd: number, mode: number): void;
+		function chown(path: string, uid: number, gid: number, dontFollow?: boolean): void;
+		function lchown(path: string, uid: number, gid: number): void;
+		function fchown(fd: number, uid: number, gid: number): void;
+		function truncate(path: string, len: number): void;
+		function ftruncate(fd: number, len: number): void;
+		function utime(path: string, atime: number, mtime: number): void;
+		function open(path: string, flags: string, mode?: number, fd_start?: number, fd_end?: number): FSStream;
+		function close(stream: FSStream): void;
+		function llseek(stream: FSStream, offset: number, whence: number): any;
+		function read(stream: FSStream, buffer: ArrayBufferView, offset: number, length: number, position?: number): number;
+		function write(stream: FSStream, buffer: ArrayBufferView, offset: number, length: number, position?: number, canOwn?: boolean): number;
+		function allocate(stream: FSStream, offset: number, length: number): void;
+		function mmap(stream: FSStream, buffer: ArrayBufferView, offset: number, length: number, position: number, prot: number, flags: number): any;
+		function ioctl(stream: FSStream, cmd: any, arg: any): any;
+		function readFile(path: string, opts: {
+			encoding: "binary";
+			flags?: string | undefined;
+		}): Uint8Array;
+		function readFile(path: string, opts: {
+			encoding: "utf8";
+			flags?: string | undefined;
+		}): string;
+		function readFile(path: string, opts?: {
+			flags?: string | undefined;
+		}): Uint8Array;
+		function writeFile(path: string, data: string | ArrayBufferView, opts?: {
+			flags?: string | undefined;
+		}): void;
+		function cwd(): string;
+		function chdir(path: string): void;
+		function init(input: null | (() => number | null), output: null | ((c: number) => any), error: null | ((c: number) => any)): void;
+		function createLazyFile(parent: string | FSNode, name: string, url: string, canRead: boolean, canWrite: boolean): FSNode;
+		function createPreloadedFile(parent: string | FSNode, name: string, url: string, canRead: boolean, canWrite: boolean, onload?: () => void, onerror?: () => void, dontCreateFile?: boolean, canOwn?: boolean): void;
+		function createDataFile(parent: string | FSNode, name: string, data: ArrayBufferView, canRead: boolean, canWrite: boolean, canOwn: boolean): FSNode;
+	}
+	export const MEMFS: Emscripten.FileSystemType;
+	export const NODEFS: Emscripten.FileSystemType;
+	export const IDBFS: Emscripten.FileSystemType;
+	type StringToType<R> = R extends Emscripten.JSType ? {
+		number: number;
+		string: string;
+		array: number[] | string[] | boolean[] | Uint8Array | Int8Array;
+		boolean: boolean;
+		null: null;
+	}[R] : never;
+	type ArgsToType<T extends Array<Emscripten.JSType | null>> = Extract<{
+		[P in keyof T]: StringToType<T[P]>;
+	}, any[]>;
+	type ReturnToType<R extends Emscripten.JSType | null> = R extends null ? null : StringToType<Exclude<R, null>>;
+	export function cwrap<I extends Array<Emscripten.JSType | null> | [
+	], R extends Emscripten.JSType | null>(ident: string, returnType: R, argTypes: I, opts?: Emscripten.CCallOpts): (...arg: ArgsToType<I>) => ReturnToType<R>;
+	export function ccall<I extends Array<Emscripten.JSType | null> | [
+	], R extends Emscripten.JSType | null>(ident: string, returnType: R, argTypes: I, args: ArgsToType<I>, opts?: Emscripten.CCallOpts): ReturnToType<R>;
+	export function setValue(ptr: number, value: any, type: Emscripten.CType, noSafe?: boolean): void;
+	export function getValue(ptr: number, type: Emscripten.CType, noSafe?: boolean): number;
+	export function allocate(slab: number[] | ArrayBufferView | number, types: Emscripten.CType | Emscripten.CType[], allocator: number, ptr?: number): number;
+	export function stackAlloc(size: number): number;
+	export function stackSave(): number;
+	export function stackRestore(ptr: number): void;
+	export function UTF8ToString(ptr: number, maxBytesToRead?: number): string;
+	export function stringToUTF8(str: string, outPtr: number, maxBytesToRead?: number): void;
+	export function lengthBytesUTF8(str: string): number;
+	export function allocateUTF8(str: string): number;
+	export function allocateUTF8OnStack(str: string): number;
+	export function UTF16ToString(ptr: number): string;
+	export function stringToUTF16(str: string, outPtr: number, maxBytesToRead?: number): void;
+	export function lengthBytesUTF16(str: string): number;
+	export function UTF32ToString(ptr: number): string;
+	export function stringToUTF32(str: string, outPtr: number, maxBytesToRead?: number): void;
+	export function lengthBytesUTF32(str: string): number;
+	export function intArrayFromString(stringy: string, dontAddNull?: boolean, length?: number): number[];
+	export function intArrayToString(array: number[]): string;
+	export function writeStringToMemory(str: string, buffer: number, dontAddNull: boolean): void;
+	export function writeArrayToMemory(array: number[], buffer: number): void;
+	export function writeAsciiToMemory(str: string, buffer: number, dontAddNull: boolean): void;
+	export function addRunDependency(id: any): void;
+	export function removeRunDependency(id: any): void;
+	export function addFunction(func: (...args: any[]) => any, signature?: string): number;
+	export function removeFunction(funcPtr: number): void;
+	export const ALLOC_NORMAL: number;
+	export const ALLOC_STACK: number;
+	export const ALLOC_STATIC: number;
+	export const ALLOC_DYNAMIC: number;
+	export const ALLOC_NONE: number;
+	export {};
 }
-/**
- * Represents an error event related to the PHP request.
- */
-export interface PHPRequestErrorEvent {
-	type: "request.error";
-	error: Error;
-	source?: "request" | "php-wasm";
+export interface RmDirOptions {
+	/**
+	 * If true, recursively removes the directory and all its contents.
+	 * Default: true.
+	 */
+	recursive?: boolean;
 }
-/**
- * Represents a PHP runtime initialization event.
- */
-export interface PHPRuntimeInitializedEvent {
-	type: "runtime.initialized";
+export interface ListFilesOptions {
+	/**
+	 * If true, prepend given folder path to all file names.
+	 * Default: false.
+	 */
+	prependPath: boolean;
 }
-/**
- * Represents a PHP runtime destruction event.
- */
-export interface PHPRuntimeBeforeDestroyEvent {
-	type: "runtime.beforedestroy";
+export interface SemaphoreOptions {
+	/**
+	 * The maximum number of concurrent locks.
+	 */
+	concurrency: number;
+	/**
+	 * The maximum time to wait for a lock to become available.
+	 */
+	timeout?: number;
 }
-/**
- * Represents an event related to the PHP instance.
- * This is intentionally not an extension of CustomEvent
- * to make it isomorphic between different JavaScript runtimes.
- */
-export type PHPEvent = PHPRequestEndEvent | PHPRequestErrorEvent | PHPRuntimeInitializedEvent | PHPRuntimeBeforeDestroyEvent;
-/**
- * A callback function that handles PHP events.
- */
-export type PHPEventListener = (event: PHPEvent) => void;
-export interface IsomorphicLocalPHP {
-	/** @deprecated Use PHPRequestHandler instead. */
-	request(request: PHPRequest): Promise<PHPResponse>;
-	/** @deprecated Use PHPRequestHandler instead. */
-	pathToInternalUrl(path: string): string;
-	/** @deprecated Use PHPRequestHandler instead. */
-	internalUrlToPath(internalUrl: string): string;
-	/** @deprecated Use PHPRequestHandler instead. */
-	absoluteUrl: string;
-	/** @deprecated Use PHPRequestHandler instead. */
-	documentRoot: string;
+declare class Semaphore {
+	private _running;
+	private concurrency;
+	private timeout?;
+	private queue;
+	constructor({ concurrency, timeout }: SemaphoreOptions);
+	get remaining(): number;
+	get running(): number;
+	acquire(): Promise<() => void>;
+	run<T>(fn: () => T | Promise<T>): Promise<T>;
+}
+export declare function phpVar(value: unknown): string;
+export declare function phpVars<T extends Record<string, unknown>>(vars: T): Record<keyof T, string>;
+export type PHPFactoryOptions = {
+	isPrimary: boolean;
+};
+export type PHPFactory = (options: PHPFactoryOptions) => Promise<PHP>;
+export interface ProcessManagerOptions {
 	/**
-	 * Sets the SAPI name exposed by the PHP module.
-	 * @param newName - The new SAPI name.
+	 * The maximum number of PHP instances that can exist at
+	 * the same time.
 	 */
-	setSapiName(newName: string): void;
+	maxPhpInstances?: number;
 	/**
-	 * Defines a constant in the PHP runtime.
-	 * @param key - The name of the constant.
-	 * @param value - The value of the constant.
+	 * The number of milliseconds to wait for a PHP instance when
+	 * we have reached the maximum number of PHP instances and
+	 * cannot spawn a new one. If the timeout is reached, we assume
+	 * all the PHP instances are deadlocked and a throw MaxPhpInstancesError.
+	 *
+	 * Default: 5000
 	 */
-	defineConstant(key: string, value: boolean | string | number | null): void;
+	timeout?: number;
 	/**
-	 * Adds an event listener for a PHP event.
-	 * @param eventType - The type of event to listen for.
-	 * @param listener - The listener function to be called when the event is triggered.
+	 * The primary PHP instance that's never killed. This instance
+	 * contains the reference filesystem used by all other PHP instances.
 	 */
-	addEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
+	primaryPhp?: PHP;
 	/**
-	 * Removes an event listener for a PHP event.
-	 * @param eventType - The type of event to remove the listener from.
-	 * @param listener - The listener function to be removed.
+	 * A factory function used for spawning new PHP instances.
 	 */
-	removeEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
+	phpFactory?: PHPFactory;
+}
+export interface SpawnedPHP {
+	php: PHP;
+	reap: () => void;
+}
+declare class PHPProcessManager implements AsyncDisposable {
+	private primaryPhp?;
+	private primaryIdle;
+	private nextInstance;
 	/**
-	 * Recursively creates a directory with the given path in the PHP filesystem.
-	 * For example, if the path is `/root/php/data`, and `/root` already exists,
-	 * it will create the directories `/root/php` and `/root/php/data`.
-	 *
-	 * @param  path - The directory path to create.
+	 * All spawned PHP instances, including the primary PHP instance.
+	 * Used for bookkeeping and reaping all instances on dispose.
 	 */
-	mkdir(path: string): void;
+	private allInstances;
+	private phpFactory?;
+	private maxPhpInstances;
+	private semaphore;
+	constructor(options?: ProcessManagerOptions);
 	/**
-	 * @deprecated Use mkdir instead.
+	 * Get the primary PHP instance.
+	 *
+	 * If the primary PHP instance is not set, it will be spawned
+	 * using the provided phpFactory.
+	 *
+	 * @throws {Error} when called twice before the first call is resolved.
 	 */
-	mkdirTree(path: string): void;
+	getPrimaryPhp(): Promise<PHP>;
 	/**
-	 * Reads a file from the PHP filesystem and returns it as a string.
+	 * Get a PHP instance.
 	 *
-	 * @throws {@link @php-wasm/universal:ErrnoError} – If the file doesn't exist.
-	 * @param  path - The file path to read.
-	 * @returns The file contents.
+	 * It could be either the primary PHP instance, an idle disposable PHP instance,
+	 * or a newly spawned PHP instance – depending on the resource availability.
+	 *
+	 * @throws {MaxPhpInstancesError} when the maximum number of PHP instances is reached
+	 *                                and the waiting timeout is exceeded.
 	 */
-	readFileAsText(path: string): string;
+	acquirePHPInstance(): Promise<SpawnedPHP>;
 	/**
-	 * Reads a file from the PHP filesystem and returns it as an array buffer.
+	 * Initiated spawning of a new PHP instance.
+	 * This function is synchronous on purpose – it needs to synchronously
+	 * add the spawn promise to the allInstances array without waiting
+	 * for PHP to spawn.
+	 */
+	private spawn;
+	/**
+	 * Actually acquires the lock and spawns a new PHP instance.
+	 */
+	private doSpawn;
+	[Symbol.asyncDispose](): Promise<void>;
+}
+export type RewriteRule = {
+	match: RegExp;
+	replacement: string;
+};
+export interface BaseConfiguration {
+	/**
+	 * The directory in the PHP filesystem where the server will look
+	 * for the files to serve. Default: `/var/www`.
+	 */
+	documentRoot?: string;
+	/**
+	 * Request Handler URL. Used to populate $_SERVER details like HTTP_HOST.
+	 */
+	absoluteUrl?: string;
+	/**
+	 * Rewrite rules
+	 */
+	rewriteRules?: RewriteRule[];
+}
+export type PHPRequestHandlerFactoryArgs = PHPFactoryOptions & {
+	requestHandler: PHPRequestHandler;
+};
+export type PHPRequestHandlerConfiguration = BaseConfiguration & ({
+	/**
+	 * PHPProcessManager is required because the request handler needs
+	 * to make a decision for each request.
 	 *
-	 * @throws {@link @php-wasm/universal:ErrnoError} – If the file doesn't exist.
-	 * @param  path - The file path to read.
-	 * @returns The file contents.
+	 * Static assets are served using the primary PHP's filesystem, even
+	 * when serving 100 static files concurrently. No new PHP interpreter
+	 * is ever created as there's no need for it.
+	 *
+	 * Dynamic PHP requests, however, require grabbing an available PHP
+	 * interpreter, and that's where the PHPProcessManager comes in.
 	 */
-	readFileAsBuffer(path: string): Uint8Array;
+	processManager: PHPProcessManager;
+} | {
+	phpFactory: (requestHandler: PHPRequestHandlerFactoryArgs) => Promise<PHP>;
 	/**
-	 * Overwrites data in a file in the PHP filesystem.
-	 * Creates a new file if one doesn't exist yet.
+	 * The maximum number of PHP instances that can exist at
+	 * the same time.
+	 */
+	maxPhpInstances?: number;
+});
+/**
+ * Handles HTTP requests using PHP runtime as a backend.
+ *
+ * @public
+ * @example Use PHPRequestHandler implicitly with a new PHP instance:
+ * ```js
+ * import { PHP } from '@php-wasm/web';
+ *
+ * const php = await PHP.load( '7.4', {
+ *     requestHandler: {
+ *         // PHP FS path to serve the files from:
+ *         documentRoot: '/www',
+ *
+ *         // Used to populate $_SERVER['SERVER_NAME'] etc.:
+ *         absoluteUrl: 'http://127.0.0.1'
+ *     }
+ * } );
+ *
+ * php.mkdirTree('/www');
+ * php.writeFile('/www/index.php', '<?php echo "Hi from PHP!"; ');
+ *
+ * const response = await php.request({ path: '/index.php' });
+ * console.log(response.text);
+ * // "Hi from PHP!"
+ * ```
+ *
+ * @example Explicitly create a PHPRequestHandler instance and run a PHP script:
+ * ```js
+ * import {
+ *   loadPHPRuntime,
+ *   PHP,
+ *   PHPRequestHandler,
+ *   getPHPLoaderModule,
+ * } from '@php-wasm/web';
+ *
+ * const runtime = await loadPHPRuntime( await getPHPLoaderModule('7.4') );
+ * const php = new PHP( runtime );
+ *
+ * php.mkdirTree('/www');
+ * php.writeFile('/www/index.php', '<?php echo "Hi from PHP!"; ');
+ *
+ * const server = new PHPRequestHandler(php, {
+ *     // PHP FS path to serve the files from:
+ *     documentRoot: '/www',
+ *
+ *     // Used to populate $_SERVER['SERVER_NAME'] etc.:
+ *     absoluteUrl: 'http://127.0.0.1'
+ * });
+ *
+ * const response = server.request({ path: '/index.php' });
+ * console.log(response.text);
+ * // "Hi from PHP!"
+ * ```
+ */
+export declare class PHPRequestHandler {
+	#private;
+	rewriteRules: RewriteRule[];
+	processManager: PHPProcessManager;
+	/**
+	 * The request handler needs to decide whether to serve a static asset or
+	 * run the PHP interpreter. For static assets it should just reuse the primary
+	 * PHP even if there's 50 concurrent requests to serve. However, for
+	 * dynamic PHP requests, it needs to grab an available interpreter.
+	 * Therefore, it cannot just accept PHP as an argument as serving requests
+	 * requires access to ProcessManager.
 	 *
-	 * @param  path - The file path to write to.
-	 * @param  data - The data to write to the file.
+	 * @param  php    - The PHP instance.
+	 * @param  config - Request Handler configuration.
 	 */
-	writeFile(path: string, data: string | Uint8Array): void;
+	constructor(config: PHPRequestHandlerConfiguration);
+	getPrimaryPhp(): Promise<PHP>;
 	/**
-	 * Removes a file from the PHP filesystem.
+	 * Converts a path to an absolute URL based at the PHPRequestHandler
+	 * root.
 	 *
-	 * @throws {@link @php-wasm/universal:ErrnoError} – If the file doesn't exist.
-	 * @param  path - The file path to remove.
+	 * @param  path The server path to convert to an absolute URL.
+	 * @returns The absolute URL.
 	 */
-	unlink(path: string): void;
+	pathToInternalUrl(path: string): string;
 	/**
-	 * Moves a file or directory in the PHP filesystem to a
-	 * new location.
+	 * Converts an absolute URL based at the PHPRequestHandler to a relative path
+	 * without the server pathname and scope.
 	 *
-	 * @param oldPath The path to rename.
-	 * @param newPath The new path.
+	 * @param  internalUrl An absolute URL based at the PHPRequestHandler root.
+	 * @returns The relative path.
 	 */
-	mv(oldPath: string, newPath: string): void;
+	internalUrlToPath(internalUrl: string): string;
 	/**
-	 * Removes a directory from the PHP filesystem.
+	 * The absolute URL of this PHPRequestHandler instance.
+	 */
+	get absoluteUrl(): string;
+	/**
+	 * The directory in the PHP filesystem where the server will look
+	 * for the files to serve. Default: `/var/www`.
+	 */
+	get documentRoot(): string;
+	/**
+	 * Serves the request – either by serving a static file, or by
+	 * dispatching it to the PHP runtime.
 	 *
-	 * @param path The directory path to remove.
-	 * @param options Options for the removal.
+	 * The request() method mode behaves like a web server and only works if
+	 * the PHP was initialized with a `requestHandler` option (which the online version
+	 * of WordPress Playground does by default).
+	 *
+	 * In the request mode, you pass an object containing the request information
+	 * (method, headers, body, etc.) and the path to the PHP file to run:
+	 *
+	 * ```ts
+	 * const php = PHP.load('7.4', {
+	 * 	requestHandler: {
+	 * 		documentRoot: "/www"
+	 * 	}
+	 * })
+	 * php.writeFile("/www/index.php", `<?php echo file_get_contents("php://input");`);
+	 * const result = await php.request({
+	 * 	method: "GET",
+	 * 	headers: {
+	 * 		"Content-Type": "text/plain"
+	 * 	},
+	 * 	body: "Hello world!",
+	 * 	path: "/www/index.php"
+	 * });
+	 * // result.text === "Hello world!"
+	 * ```
+	 *
+	 * The `request()` method cannot be used in conjunction with `cli()`.
+	 *
+	 * @example
+	 * ```js
+	 * const output = await php.request({
+	 * 	method: 'GET',
+	 * 	url: '/index.php',
+	 * 	headers: {
+	 * 		'X-foo': 'bar',
+	 * 	},
+	 * 	body: {
+	 * 		foo: 'bar',
+	 * 	},
+	 * });
+	 * console.log(output.stdout); // "Hello world!"
+	 * ```
+	 *
+	 * @param  request - PHP Request data.
 	 */
-	rmdir(path: string, options?: RmDirOptions): void;
+	request(request: PHPRequest): Promise<PHPResponse>;
+}
+declare const __private__dont__use: unique symbol;
+export type UnmountFunction = (() => Promise<any>) | (() => any);
+export type MountHandler = (php: PHP, FS: Emscripten.RootFS, vfsMountPoint: string) => UnmountFunction | Promise<UnmountFunction>;
+declare class PHP implements Disposable {
+	#private;
+	protected [__private__dont__use]: any;
+	requestHandler?: PHPRequestHandler;
 	/**
-	 * Lists the files and directories in the given directory.
+	 * An exclusive lock that prevent multiple requests from running at
+	 * the same time.
+	 */
+	semaphore: Semaphore;
+	/**
+	 * Initializes a PHP runtime.
 	 *
-	 * @param  path - The directory path to list.
-	 * @param  options - Options for the listing.
-	 * @returns The list of files and directories in the given directory.
+	 * @internal
+	 * @param  PHPRuntime - Optional. PHP Runtime ID as initialized by loadPHPRuntime.
+	 * @param  requestHandlerOptions - Optional. Options for the PHPRequestHandler. If undefined, no request handler will be initialized.
+	 */
+	constructor(PHPRuntimeId?: PHPRuntimeId);
+	/**
+	 * Adds an event listener for a PHP event.
+	 * @param eventType - The type of event to listen for.
+	 * @param listener - The listener function to be called when the event is triggered.
 	 */
-	listFiles(path: string, options?: ListFilesOptions): string[];
+	addEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
 	/**
-	 * Checks if a directory exists in the PHP filesystem.
-	 *
-	 * @param  path – The path to check.
-	 * @returns True if the path is a directory, false otherwise.
+	 * Removes an event listener for a PHP event.
+	 * @param eventType - The type of event to remove the listener from.
+	 * @param listener - The listener function to be removed.
 	 */
-	isDir(path: string): boolean;
+	removeEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
+	dispatchEvent<Event extends PHPEvent>(event: Event): void;
 	/**
-	 * Checks if a file (or a directory) exists in the PHP filesystem.
+	 * Listens to message sent by the PHP code.
 	 *
-	 * @param  path - The file path to check.
-	 * @returns True if the file exists, false otherwise.
+	 * To dispatch messages, call:
+	 *
+	 *     post_message_to_js(string $data)
+	 *
+	 *     Arguments:
+	 *         $data (string) – Data to pass to JavaScript.
+	 *
+	 * @example
+	 *
+	 * ```ts
+	 * const php = await PHP.load('8.0');
+	 *
+	 * php.onMessage(
+	 *     // The data is always passed as a string
+	 *     function (data: string) {
+	 *         // Let's decode and log the data:
+	 *         console.log(JSON.parse(data));
+	 *     }
+	 * );
+	 *
+	 * // Now that we have a listener in place, let's
+	 * // dispatch a message:
+	 * await php.run({
+	 *     code: `<?php
+	 *         post_message_to_js(
+	 *             json_encode([
+	 *                 'post_id' => '15',
+	 *                 'post_title' => 'This is a blog post!'
+	 *             ])
+	 *         ));
+	 *     `,
+	 * });
+	 * ```
+	 *
+	 * @param listener Callback function to handle the message.
 	 */
-	fileExists(path: string): boolean;
+	onMessage(listener: MessageListener): void;
+	setSpawnHandler(handler: SpawnHandler | string): Promise<void>;
+	/** @deprecated Use PHPRequestHandler instead. */
+	get absoluteUrl(): string;
+	/** @deprecated Use PHPRequestHandler instead. */
+	get documentRoot(): string;
+	/** @deprecated Use PHPRequestHandler instead. */
+	pathToInternalUrl(path: string): string;
+	/** @deprecated Use PHPRequestHandler instead. */
+	internalUrlToPath(internalUrl: string): string;
+	initializeRuntime(runtimeId: PHPRuntimeId): void;
+	/** @inheritDoc */
+	setSapiName(newName: string): Promise<void>;
 	/**
 	 * Changes the current working directory in the PHP filesystem.
 	 * This is the directory that will be used as the base for relative paths.
@@ -354,6 +862,11 @@ export interface IsomorphicLocalPHP {
 	 * @param  path - The new working directory.
 	 */
 	chdir(path: string): void;
+	/**
+	 * Do not use. Use new PHPRequestHandler() instead.
+	 * @deprecated
+	 */
+	request(request: PHPRequest): Promise<PHPResponse>;
 	/**
 	 * Runs PHP code.
 	 *
@@ -423,556 +936,323 @@ export interface IsomorphicLocalPHP {
 	 *
 	 * @param  options - PHP runtime options.
 	 */
-	run(options: PHPRunOptions): Promise<PHPResponse>;
-	/**
-	 * Listens to message sent by the PHP code.
-	 *
-	 * To dispatch messages, call:
-	 *
-	 *     post_message_to_js(string $data)
-	 *
-	 *     Arguments:
-	 *         $data (string) – Data to pass to JavaScript.
-	 *
-	 * @example
-	 *
-	 * ```ts
-	 * const php = await PHP.load('8.0');
-	 *
-	 * php.onMessage(
-	 *     // The data is always passed as a string
-	 *     function (data: string) {
-	 *         // Let's decode and log the data:
-	 *         console.log(JSON.parse(data));
-	 *     }
-	 * );
-	 *
-	 * // Now that we have a listener in place, let's
-	 * // dispatch a message:
-	 * await php.run({
-	 *     code: `<?php
-	 *         post_message_to_js(
-	 *             json_encode([
-	 *                 'post_id' => '15',
-	 *                 'post_title' => 'This is a blog post!'
-	 *             ])
-	 *         ));
-	 *     `,
-	 * });
-	 * ```
-	 *
-	 * @param listener Callback function to handle the message.
-	 */
-	onMessage(listener: MessageListener): void;
-}
-export type MessageListener = (data: string) => Promise<string | Uint8Array | void> | string | void;
-export interface EventEmitter {
-	on(event: string, listener: (...args: any[]) => void): this;
-	emit(event: string, ...args: any[]): boolean;
-}
-export type ChildProcess = EventEmitter & {
-	stdout: EventEmitter;
-	stderr: EventEmitter;
-};
-export type SpawnHandler = (command: string, args: string[]) => ChildProcess;
-/**
- * The omited methods must either be called synchronously before
- * the PHP internal state is initialized, or with a complex argument
- * that can't be serialized over a remote connection. Therefeore,
- * they don't make sense in a remote PHP instance.
- */
-export type IsomorphicRemotePHP = Remote<Omit<IsomorphicLocalPHP, "setSapiName">>;
-export type UniversalPHP = IsomorphicLocalPHP | IsomorphicRemotePHP;
-export type HTTPMethod = "GET" | "POST" | "HEAD" | "OPTIONS" | "PATCH" | "PUT" | "DELETE";
-export type PHPRequestHeaders = Record<string, string>;
-export interface PHPRequest {
-	/**
-	 * Request method. Default: `GET`.
-	 */
-	method?: HTTPMethod;
-	/**
-	 * Request path or absolute URL.
-	 */
-	url: string;
-	/**
-	 * Request headers.
-	 */
-	headers?: PHPRequestHeaders;
-	/**
-	 * Request body.
-	 * If an object is given, the request will be encoded as multipart
-	 * and sent with a `multipart/form-data` header.
-	 */
-	body?: string | Uint8Array | Record<string, string | Uint8Array | File>;
-}
-export interface PHPRunOptions {
-	/**
-	 * Request path following the domain:port part.
-	 */
-	relativeUri?: string;
-	/**
-	 * Path of the .php file to execute.
-	 */
-	scriptPath?: string;
-	/**
-	 * Request protocol.
-	 */
-	protocol?: string;
-	/**
-	 * Request method. Default: `GET`.
-	 */
-	method?: HTTPMethod;
-	/**
-	 * Request headers.
-	 */
-	headers?: PHPRequestHeaders;
-	/**
-	 * Request body.
-	 */
-	body?: string | Uint8Array;
-	/**
-	 * Environment variables to set for this run.
-	 */
-	env?: Record<string, string>;
-	/**
-	 * $_SERVER entries to set for this run.
-	 */
-	$_SERVER?: Record<string, string>;
-	/**
-	 * The code snippet to eval instead of a php file.
-	 */
-	code?: string;
-}
-/**
- * Output of the PHP.wasm runtime.
- */
-export interface PHPOutput {
-	/** Exit code of the PHP process. 0 means success, 1 and 2 mean error. */
-	exitCode: number;
-	/** Stdout data */
-	stdout: ArrayBuffer;
-	/** Stderr lines */
-	stderr: string[];
-}
-export interface RmDirOptions {
-	/**
-	 * If true, recursively removes the directory and all its contents.
-	 * Default: true.
-	 */
-	recursive?: boolean;
-}
-export interface ListFilesOptions {
-	/**
-	 * If true, prepend given folder path to all file names.
-	 * Default: false.
-	 */
-	prependPath: boolean;
-}
-/**
- * Rewrites the php.ini file with the given entries.
- *
- * @param php The PHP instance.
- * @param entries The entries to write to the php.ini file.
- */
-export declare function setPhpIniEntries(php: UniversalPHP, entries: Record<string, unknown>): Promise<void>;
-export type RuntimeType = "NODE" | "WEB" | "WORKER";
-export type PHPRuntimeId = number;
-export type PHPRuntime = any;
-export type PHPLoaderModule = {
-	dependencyFilename: string;
-	dependenciesTotalSize: number;
-	init: (jsRuntime: string, options: EmscriptenOptions) => PHPRuntime;
-};
-export type EmscriptenOptions = {
-	onAbort?: (message: string) => void;
-	/**
-	 * Set to true for debugging tricky WebAssembly errors.
-	 */
-	debug?: boolean;
-	ENV?: Record<string, string>;
-	locateFile?: (path: string) => string;
-	noInitialRun?: boolean;
-	print?: (message: string) => void;
-	printErr?: (message: string) => void;
-	quit?: (status: number, toThrow: any) => void;
-	onRuntimeInitialized?: () => void;
-	monitorRunDependencies?: (left: number) => void;
-	onMessage?: (listener: EmscriptenMessageListener) => void;
-	instantiateWasm?: (info: WebAssembly.Imports, receiveInstance: (instance: WebAssembly.Instance, module: WebAssembly.Module) => void) => void;
-} & Record<string, any>;
-export type EmscriptenMessageListener = (type: string, data: string) => void;
-export interface SemaphoreOptions {
-	/**
-	 * The maximum number of concurrent locks.
-	 */
-	concurrency: number;
+	run(request: PHPRunOptions): Promise<PHPResponse>;
 	/**
-	 * The maximum time to wait for a lock to become available.
+	 * Defines a constant in the PHP runtime.
+	 * @param key - The name of the constant.
+	 * @param value - The value of the constant.
 	 */
-	timeout?: number;
-}
-declare class Semaphore {
-	private _running;
-	private concurrency;
-	private timeout?;
-	private queue;
-	constructor({ concurrency, timeout }: SemaphoreOptions);
-	get remaining(): number;
-	get running(): number;
-	acquire(): Promise<() => void>;
-	run<T>(fn: () => T | Promise<T>): Promise<T>;
-}
-export declare function phpVar(value: unknown): string;
-export declare function phpVars<T extends Record<string, unknown>>(vars: T): Record<keyof T, string>;
-export type RewriteRule = {
-	match: RegExp;
-	replacement: string;
-};
-export interface BaseConfiguration {
+	defineConstant(key: string, value: string | boolean | number | null): void;
 	/**
-	 * The directory in the PHP filesystem where the server will look
-	 * for the files to serve. Default: `/var/www`.
+	 * Recursively creates a directory with the given path in the PHP filesystem.
+	 * For example, if the path is `/root/php/data`, and `/root` already exists,
+	 * it will create the directories `/root/php` and `/root/php/data`.
+	 *
+	 * @param  path - The directory path to create.
 	 */
-	documentRoot?: string;
+	mkdir(path: string): void;
 	/**
-	 * Request Handler URL. Used to populate $_SERVER details like HTTP_HOST.
+	 * @deprecated Use mkdir instead.
 	 */
-	absoluteUrl?: string;
+	mkdirTree(path: string): void;
 	/**
-	 * Rewrite rules
+	 * Reads a file from the PHP filesystem and returns it as a string.
+	 *
+	 * @throws {@link @php-wasm/universal:ErrnoError} – If the file doesn't exist.
+	 * @param  path - The file path to read.
+	 * @returns The file contents.
 	 */
-	rewriteRules?: RewriteRule[];
-}
-export type PHPRequestHandlerFactoryArgs<PHP extends BasePHP> = PHPFactoryOptions & {
-	requestHandler: PHPRequestHandler<PHP>;
-};
-export type PHPRequestHandlerConfiguration<PHP extends BasePHP> = BaseConfiguration & ({
+	readFileAsText(path: string): string;
 	/**
-	 * PHPProcessManager is required because the request handler needs
-	 * to make a decision for each request.
-	 *
-	 * Static assets are served using the primary PHP's filesystem, even
-	 * when serving 100 static files concurrently. No new PHP interpreter
-	 * is ever created as there's no need for it.
+	 * Reads a file from the PHP filesystem and returns it as an array buffer.
 	 *
-	 * Dynamic PHP requests, however, require grabbing an available PHP
-	 * interpreter, and that's where the PHPProcessManager comes in.
+	 * @throws {@link @php-wasm/universal:ErrnoError} – If the file doesn't exist.
+	 * @param  path - The file path to read.
+	 * @returns The file contents.
 	 */
-	processManager: PHPProcessManager<PHP>;
-} | {
-	phpFactory: (requestHandler: PHPRequestHandlerFactoryArgs<PHP>) => Promise<PHP>;
+	readFileAsBuffer(path: string): Uint8Array;
 	/**
-	 * The maximum number of PHP instances that can exist at
-	 * the same time.
+	 * Overwrites data in a file in the PHP filesystem.
+	 * Creates a new file if one doesn't exist yet.
+	 *
+	 * @param  path - The file path to write to.
+	 * @param  data - The data to write to the file.
 	 */
-	maxPhpInstances?: number;
-});
-/**
- * Handles HTTP requests using PHP runtime as a backend.
- *
- * @public
- * @example Use PHPRequestHandler implicitly with a new PHP instance:
- * ```js
- * import { PHP } from '@php-wasm/web';
- *
- * const php = await PHP.load( '7.4', {
- *     requestHandler: {
- *         // PHP FS path to serve the files from:
- *         documentRoot: '/www',
- *
- *         // Used to populate $_SERVER['SERVER_NAME'] etc.:
- *         absoluteUrl: 'http://127.0.0.1'
- *     }
- * } );
- *
- * php.mkdirTree('/www');
- * php.writeFile('/www/index.php', '<?php echo "Hi from PHP!"; ');
- *
- * const response = await php.request({ path: '/index.php' });
- * console.log(response.text);
- * // "Hi from PHP!"
- * ```
- *
- * @example Explicitly create a PHPRequestHandler instance and run a PHP script:
- * ```js
- * import {
- *   loadPHPRuntime,
- *   PHP,
- *   PHPRequestHandler,
- *   getPHPLoaderModule,
- * } from '@php-wasm/web';
- *
- * const runtime = await loadPHPRuntime( await getPHPLoaderModule('7.4') );
- * const php = new PHP( runtime );
- *
- * php.mkdirTree('/www');
- * php.writeFile('/www/index.php', '<?php echo "Hi from PHP!"; ');
- *
- * const server = new PHPRequestHandler(php, {
- *     // PHP FS path to serve the files from:
- *     documentRoot: '/www',
- *
- *     // Used to populate $_SERVER['SERVER_NAME'] etc.:
- *     absoluteUrl: 'http://127.0.0.1'
- * });
- *
- * const response = server.request({ path: '/index.php' });
- * console.log(response.text);
- * // "Hi from PHP!"
- * ```
- */
-export declare class PHPRequestHandler<PHP extends BasePHP> {
-	#private;
-	rewriteRules: RewriteRule[];
-	processManager: PHPProcessManager<PHP>;
+	writeFile(path: string, data: string | Uint8Array): void;
 	/**
-	 * The request handler needs to decide whether to serve a static asset or
-	 * run the PHP interpreter. For static assets it should just reuse the primary
-	 * PHP even if there's 50 concurrent requests to serve. However, for
-	 * dynamic PHP requests, it needs to grab an available interpreter.
-	 * Therefore, it cannot just accept PHP as an argument as serving requests
-	 * requires access to ProcessManager.
+	 * Removes a file from the PHP filesystem.
 	 *
-	 * @param  php    - The PHP instance.
-	 * @param  config - Request Handler configuration.
+	 * @throws {@link @php-wasm/universal:ErrnoError} – If the file doesn't exist.
+	 * @param  path - The file path to remove.
 	 */
-	constructor(config: PHPRequestHandlerConfiguration<PHP>);
-	getPrimaryPhp(): Promise<PHP>;
+	unlink(path: string): void;
 	/**
-	 * Converts a path to an absolute URL based at the PHPRequestHandler
-	 * root.
+	 * Moves a file or directory in the PHP filesystem to a
+	 * new location.
 	 *
-	 * @param  path The server path to convert to an absolute URL.
-	 * @returns The absolute URL.
+	 * @param oldPath The path to rename.
+	 * @param newPath The new path.
 	 */
-	pathToInternalUrl(path: string): string;
+	mv(fromPath: string, toPath: string): void;
 	/**
-	 * Converts an absolute URL based at the PHPRequestHandler to a relative path
-	 * without the server pathname and scope.
+	 * Removes a directory from the PHP filesystem.
 	 *
-	 * @param  internalUrl An absolute URL based at the PHPRequestHandler root.
-	 * @returns The relative path.
+	 * @param path The directory path to remove.
+	 * @param options Options for the removal.
 	 */
-	internalUrlToPath(internalUrl: string): string;
+	rmdir(path: string, options?: RmDirOptions): void;
 	/**
-	 * The absolute URL of this PHPRequestHandler instance.
+	 * Lists the files and directories in the given directory.
+	 *
+	 * @param  path - The directory path to list.
+	 * @param  options - Options for the listing.
+	 * @returns The list of files and directories in the given directory.
 	 */
-	get absoluteUrl(): string;
+	listFiles(path: string, options?: ListFilesOptions): string[];
 	/**
-	 * The directory in the PHP filesystem where the server will look
-	 * for the files to serve. Default: `/var/www`.
+	 * Checks if a directory exists in the PHP filesystem.
+	 *
+	 * @param  path – The path to check.
+	 * @returns True if the path is a directory, false otherwise.
 	 */
-	get documentRoot(): string;
+	isDir(path: string): boolean;
 	/**
-	 * Serves the request – either by serving a static file, or by
-	 * dispatching it to the PHP runtime.
+	 * Checks if a file (or a directory) exists in the PHP filesystem.
 	 *
-	 * The request() method mode behaves like a web server and only works if
-	 * the PHP was initialized with a `requestHandler` option (which the online version
-	 * of WordPress Playground does by default).
+	 * @param  path - The file path to check.
+	 * @returns True if the file exists, false otherwise.
+	 */
+	fileExists(path: string): boolean;
+	/**
+	 * Hot-swaps the PHP runtime for a new one without
+	 * interrupting the operations of this PHP instance.
 	 *
-	 * In the request mode, you pass an object containing the request information
-	 * (method, headers, body, etc.) and the path to the PHP file to run:
+	 * @param runtime
+	 * @param cwd. Internal, the VFS path to recreate in the new runtime.
+	 *             This arg is temporary and will be removed once BasePHP
+	 *             is fully decoupled from the request handler and
+	 *             accepts a constructor-level cwd argument.
+	 */
+	hotSwapPHPRuntime(runtime: number, cwd?: string): void;
+	/**
+	 * Mounts a filesystem to a given path in the PHP filesystem.
 	 *
-	 * ```ts
-	 * const php = PHP.load('7.4', {
-	 * 	requestHandler: {
-	 * 		documentRoot: "/www"
-	 * 	}
-	 * })
-	 * php.writeFile("/www/index.php", `<?php echo file_get_contents("php://input");`);
-	 * const result = await php.request({
-	 * 	method: "GET",
-	 * 	headers: {
-	 * 		"Content-Type": "text/plain"
-	 * 	},
-	 * 	body: "Hello world!",
-	 * 	path: "/www/index.php"
-	 * });
-	 * // result.text === "Hello world!"
-	 * ```
+	 * @param  virtualFSPath - Where to mount it in the PHP virtual filesystem.
+	 * @param  mountHandler - The mount handler to use.
+	 * @return Unmount function to unmount the filesystem.
+	 */
+	mount(virtualFSPath: string, mountHandler: MountHandler): Promise<UnmountFunction>;
+	/**
+	 * Starts a PHP CLI session with given arguments.
 	 *
-	 * The `request()` method cannot be used in conjunction with `cli()`.
+	 * This method can only be used when PHP was compiled with the CLI SAPI
+	 * and it cannot be used in conjunction with `run()`.
 	 *
-	 * @example
-	 * ```js
-	 * const output = await php.request({
-	 * 	method: 'GET',
-	 * 	url: '/index.php',
-	 * 	headers: {
-	 * 		'X-foo': 'bar',
-	 * 	},
-	 * 	body: {
-	 * 		foo: 'bar',
-	 * 	},
-	 * });
-	 * console.log(output.stdout); // "Hello world!"
-	 * ```
+	 * Once this method finishes running, the PHP instance is no
+	 * longer usable and should be discarded. This is because PHP
+	 * internally cleans up all the resources and calls exit().
 	 *
-	 * @param  request - PHP Request data.
+	 * @param  argv - The arguments to pass to the CLI.
+	 * @returns The exit code of the CLI session.
 	 */
-	request(request: PHPRequest): Promise<PHPResponse>;
+	cli(argv: string[]): Promise<number>;
+	setSkipShebang(shouldSkip: boolean): void;
+	exit(code?: number): void;
+	[Symbol.dispose](): void;
 }
-declare const __private__dont__use: unique symbol;
-declare abstract class BasePHP implements IsomorphicLocalPHP, Disposable {
-	#private;
-	protected [__private__dont__use]: any;
-	requestHandler?: PHPRequestHandler<any>;
-	/**
-	 * An exclusive lock that prevent multiple requests from running at
-	 * the same time.
-	 */
-	semaphore: Semaphore;
+export type LimitedPHPApi = Pick<PHP, "request" | "defineConstant" | "addEventListener" | "removeEventListener" | "mkdir" | "mkdirTree" | "readFileAsText" | "readFileAsBuffer" | "writeFile" | "unlink" | "mv" | "rmdir" | "listFiles" | "isDir" | "fileExists" | "chdir" | "run" | "onMessage"> & {
+	documentRoot: PHP["documentRoot"];
+	absoluteUrl: PHP["absoluteUrl"];
+};
+declare class PHPWorker implements LimitedPHPApi {
+	/** @inheritDoc @php-wasm/universal!RequestHandler.absoluteUrl  */
+	absoluteUrl: string;
+	/** @inheritDoc @php-wasm/universal!RequestHandler.documentRoot  */
+	documentRoot: string;
+	/** @inheritDoc */
+	constructor(requestHandler?: PHPRequestHandler, monitor?: EmscriptenDownloadMonitor);
+	__internal_setRequestHandler(requestHandler: PHPRequestHandler): void;
 	/**
-	 * Initializes a PHP runtime.
-	 *
 	 * @internal
-	 * @param  PHPRuntime - Optional. PHP Runtime ID as initialized by loadPHPRuntime.
-	 * @param  requestHandlerOptions - Optional. Options for the PHPRequestHandler. If undefined, no request handler will be initialized.
+	 * @deprecated
+	 * Do not use this method directly in the code consuming
+	 * the web API. It will change or even be removed without
+	 * a warning.
 	 */
-	constructor(PHPRuntimeId?: PHPRuntimeId);
-	addEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
-	removeEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
-	dispatchEvent<Event extends PHPEvent>(event: Event): void;
-	/** @inheritDoc */
-	onMessage(listener: MessageListener): Promise<void>;
-	/** @inheritDoc */
-	setSpawnHandler(handler: SpawnHandler | string): Promise<void>;
-	/** @inheritDoc */
-	get absoluteUrl(): string;
-	/** @inheritDoc */
-	get documentRoot(): string;
-	/** @inheritDoc */
+	protected __internal_getPHP(): PHP | undefined;
+	setPrimaryPHP(php: PHP): Promise<void>;
+	/** @inheritDoc @php-wasm/universal!PHPRequestHandler.pathToInternalUrl  */
 	pathToInternalUrl(path: string): string;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!PHPRequestHandler.internalUrlToPath  */
 	internalUrlToPath(internalUrl: string): string;
-	initializeRuntime(runtimeId: PHPRuntimeId): void;
-	/** @inheritDoc */
-	setSapiName(newName: string): Promise<void>;
-	/** @inheritDoc */
-	chdir(path: string): void;
 	/**
-	 * Do not use. Use new PHPRequestHandler() instead.
-	 * @deprecated
+	 * The onDownloadProgress event listener.
 	 */
+	onDownloadProgress(callback: (progress: CustomEvent<ProgressEvent>) => void): Promise<void>;
+	/** @inheritDoc @php-wasm/universal!PHP.mv  */
+	mv(fromPath: string, toPath: string): Promise<void>;
+	/** @inheritDoc @php-wasm/universal!PHP.rmdir  */
+	rmdir(path: string, options?: RmDirOptions): Promise<void>;
+	/** @inheritDoc @php-wasm/universal!PHPRequestHandler.request */
 	request(request: PHPRequest): Promise<PHPResponse>;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.run */
 	run(request: PHPRunOptions): Promise<PHPResponse>;
-	defineConstant(key: string, value: string | boolean | number | null): void;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.chdir */
+	chdir(path: string): void;
+	/** @inheritDoc @php-wasm/universal!/PHP.setSapiName */
+	setSapiName(newName: string): void;
+	/** @inheritDoc @php-wasm/universal!/PHP.mkdir */
 	mkdir(path: string): void;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.mkdirTree */
 	mkdirTree(path: string): void;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.readFileAsText */
 	readFileAsText(path: string): string;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.readFileAsBuffer */
 	readFileAsBuffer(path: string): Uint8Array;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.writeFile */
 	writeFile(path: string, data: string | Uint8Array): void;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.unlink */
 	unlink(path: string): void;
-	/** @inheritDoc */
-	mv(fromPath: string, toPath: string): void;
-	/** @inheritDoc */
-	rmdir(path: string, options?: RmDirOptions): void;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.listFiles */
 	listFiles(path: string, options?: ListFilesOptions): string[];
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.isDir */
 	isDir(path: string): boolean;
-	/** @inheritDoc */
+	/** @inheritDoc @php-wasm/universal!/PHP.fileExists */
 	fileExists(path: string): boolean;
-	/**
-	 * Hot-swaps the PHP runtime for a new one without
-	 * interrupting the operations of this PHP instance.
-	 *
-	 * @param runtime
-	 * @param cwd. Internal, the VFS path to recreate in the new runtime.
-	 *             This arg is temporary and will be removed once BasePHP
-	 *             is fully decoupled from the request handler and
-	 *             accepts a constructor-level cwd argument.
-	 */
-	hotSwapPHPRuntime(runtime: number, cwd?: string): void;
-	exit(code?: number): void;
-	[Symbol.dispose](): void;
+	/** @inheritDoc @php-wasm/universal!/PHP.onMessage */
+	onMessage(listener: MessageListener): void;
+	/** @inheritDoc @php-wasm/universal!/PHP.defineConstant */
+	defineConstant(key: string, value: string | boolean | number | null): void;
+	/** @inheritDoc @php-wasm/universal!/PHP.addEventListener */
+	addEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
+	/** @inheritDoc @php-wasm/universal!/PHP.removeEventListener */
+	removeEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
 }
-export type PHPFactoryOptions = {
-	isPrimary: boolean;
+/**
+ * Represents an event related to the PHP request.
+ */
+export interface PHPRequestEndEvent {
+	type: "request.end";
+}
+/**
+ * Represents an error event related to the PHP request.
+ */
+export interface PHPRequestErrorEvent {
+	type: "request.error";
+	error: Error;
+	source?: "request" | "php-wasm";
+}
+/**
+ * Represents a PHP runtime initialization event.
+ */
+export interface PHPRuntimeInitializedEvent {
+	type: "runtime.initialized";
+}
+/**
+ * Represents a PHP runtime destruction event.
+ */
+export interface PHPRuntimeBeforeDestroyEvent {
+	type: "runtime.beforedestroy";
+}
+/**
+ * Represents an event related to the PHP instance.
+ * This is intentionally not an extension of CustomEvent
+ * to make it isomorphic between different JavaScript runtimes.
+ */
+export type PHPEvent = PHPRequestEndEvent | PHPRequestErrorEvent | PHPRuntimeInitializedEvent | PHPRuntimeBeforeDestroyEvent;
+/**
+ * A callback function that handles PHP events.
+ */
+export type PHPEventListener = (event: PHPEvent) => void;
+export type UniversalPHP = LimitedPHPApi | Remote<LimitedPHPApi>;
+export type MessageListener = (data: string) => Promise<string | Uint8Array | void> | string | void;
+export interface EventEmitter {
+	on(event: string, listener: (...args: any[]) => void): this;
+	emit(event: string, ...args: any[]): boolean;
+}
+export type ChildProcess = EventEmitter & {
+	stdout: EventEmitter;
+	stderr: EventEmitter;
 };
-export type PHPFactory<PHP extends BasePHP> = (options: PHPFactoryOptions) => Promise<PHP>;
-export interface ProcessManagerOptions<PHP extends BasePHP> {
+export type SpawnHandler = (command: string, args: string[]) => ChildProcess;
+export type HTTPMethod = "GET" | "POST" | "HEAD" | "OPTIONS" | "PATCH" | "PUT" | "DELETE";
+export type PHPRequestHeaders = Record<string, string>;
+export interface PHPRequest {
 	/**
-	 * The maximum number of PHP instances that can exist at
-	 * the same time.
+	 * Request method. Default: `GET`.
 	 */
-	maxPhpInstances?: number;
+	method?: HTTPMethod;
 	/**
-	 * The number of milliseconds to wait for a PHP instance when
-	 * we have reached the maximum number of PHP instances and
-	 * cannot spawn a new one. If the timeout is reached, we assume
-	 * all the PHP instances are deadlocked and a throw MaxPhpInstancesError.
-	 *
-	 * Default: 5000
+	 * Request path or absolute URL.
 	 */
-	timeout?: number;
+	url: string;
 	/**
-	 * The primary PHP instance that's never killed. This instance
-	 * contains the reference filesystem used by all other PHP instances.
+	 * Request headers.
 	 */
-	primaryPhp?: PHP;
+	headers?: PHPRequestHeaders;
 	/**
-	 * A factory function used for spawning new PHP instances.
+	 * Request body.
+	 * If an object is given, the request will be encoded as multipart
+	 * and sent with a `multipart/form-data` header.
 	 */
-	phpFactory?: PHPFactory<PHP>;
-}
-export interface SpawnedPHP<PHP extends BasePHP> {
-	php: PHP;
-	reap: () => void;
+	body?: string | Uint8Array | Record<string, string | Uint8Array | File>;
 }
-declare class PHPProcessManager<PHP extends BasePHP> implements AsyncDisposable {
-	private primaryPhp?;
-	private primaryIdle;
-	private nextInstance;
+export interface PHPRunOptions {
 	/**
-	 * All spawned PHP instances, including the primary PHP instance.
-	 * Used for bookkeeping and reaping all instances on dispose.
+	 * Request path following the domain:port part.
 	 */
-	private allInstances;
-	private phpFactory?;
-	private maxPhpInstances;
-	private semaphore;
-	constructor(options?: ProcessManagerOptions<PHP>);
+	relativeUri?: string;
 	/**
-	 * Get the primary PHP instance.
-	 *
-	 * If the primary PHP instance is not set, it will be spawned
-	 * using the provided phpFactory.
-	 *
-	 * @throws {Error} when called twice before the first call is resolved.
+	 * Path of the .php file to execute.
 	 */
-	getPrimaryPhp(): Promise<PHP>;
+	scriptPath?: string;
 	/**
-	 * Get a PHP instance.
-	 *
-	 * It could be either the primary PHP instance, an idle disposable PHP instance,
-	 * or a newly spawned PHP instance – depending on the resource availability.
-	 *
-	 * @throws {MaxPhpInstancesError} when the maximum number of PHP instances is reached
-	 *                                and the waiting timeout is exceeded.
+	 * Request protocol.
 	 */
-	acquirePHPInstance(): Promise<SpawnedPHP<PHP>>;
+	protocol?: string;
 	/**
-	 * Initiated spawning of a new PHP instance.
-	 * This function is synchronous on purpose – it needs to synchronously
-	 * add the spawn promise to the allInstances array without waiting
-	 * for PHP to spawn.
+	 * Request method. Default: `GET`.
 	 */
-	private spawn;
+	method?: HTTPMethod;
 	/**
-	 * Actually acquires the lock and spawns a new PHP instance.
+	 * Request headers.
 	 */
-	private doSpawn;
-	[Symbol.asyncDispose](): Promise<void>;
+	headers?: PHPRequestHeaders;
+	/**
+	 * Request body.
+	 */
+	body?: string | Uint8Array;
+	/**
+	 * Environment variables to set for this run.
+	 */
+	env?: Record<string, string>;
+	/**
+	 * $_SERVER entries to set for this run.
+	 */
+	$_SERVER?: Record<string, string>;
+	/**
+	 * The code snippet to eval instead of a php file.
+	 */
+	code?: string;
+}
+/**
+ * Output of the PHP.wasm runtime.
+ */
+export interface PHPOutput {
+	/** Exit code of the PHP process. 0 means success, 1 and 2 mean error. */
+	exitCode: number;
+	/** Stdout data */
+	stdout: ArrayBuffer;
+	/** Stderr lines */
+	stderr: string[];
 }
+/**
+ * Rewrites the php.ini file with the given entries.
+ *
+ * @param php The PHP instance.
+ * @param entries The entries to write to the php.ini file.
+ */
+export declare function setPhpIniEntries(php: UniversalPHP, entries: Record<string, unknown>): Promise<void>;
 /**
  * Emscripten's filesystem-related Exception.
  *
@@ -1955,6 +2235,28 @@ export interface WPCLIStep {
  * Runs PHP code using [WP-CLI](https://developer.wordpress.org/cli/commands/).
  */
 export declare const wpCLI: StepHandler<WPCLIStep, Promise<PHPResponse>>;
+/**
+ * Deletes WordPress posts and comments and sets the auto increment sequence for the
+ * posts and comments tables to 0.
+ *
+ * @private
+ * @internal
+ * @inheritDoc resetData
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "resetData"
+ * }
+ * </code>
+ */
+export interface ResetDataStep {
+	step: "resetData";
+}
+/**
+ * @param playground Playground client.
+ */
+export declare const resetData: StepHandler<ResetDataStep>;
 /**
  * Used by the export step to exclude the Playground-specific files
  * from the zip file. Keep it in sync with the list of files created
@@ -1972,7 +2274,7 @@ export type StepDefinition = Step & {
  * If you add a step here, make sure to also
  * add it to the exports below.
  */
-export type GenericStep<Resource> = ActivatePluginStep | ActivateThemeStep | CpStep | DefineWpConfigConstsStep | DefineSiteUrlStep | EnableMultisiteStep | ImportWxrStep<Resource> | ImportWordPressFilesStep<Resource> | InstallPluginStep<Resource> | InstallThemeStep<Resource> | LoginStep | MkdirStep | MvStep | RequestStep | RmStep | RmdirStep | RunPHPStep | RunPHPWithOptionsStep | RunWpInstallationWizardStep | RunSqlStep<Resource> | SetSiteOptionsStep | UnzipStep<Resource> | UpdateUserMetaStep | WriteFileStep<Resource> | WPCLIStep;
+export type GenericStep<Resource> = ActivatePluginStep | ActivateThemeStep | CpStep | DefineWpConfigConstsStep | DefineSiteUrlStep | EnableMultisiteStep | ImportWxrStep<Resource> | ImportWordPressFilesStep<Resource> | InstallPluginStep<Resource> | InstallThemeStep<Resource> | LoginStep | MkdirStep | MvStep | ResetDataStep | RequestStep | RmStep | RmdirStep | RunPHPStep | RunPHPWithOptionsStep | RunWpInstallationWizardStep | RunSqlStep<Resource> | SetSiteOptionsStep | UnzipStep<Resource> | UpdateUserMetaStep | WriteFileStep<Resource> | WPCLIStep;
 /**
  * Progress reporting details.
  */
@@ -2153,90 +2455,11 @@ export type WithAPIState = {
 	isReady: () => Promise<void>;
 };
 export type RemoteAPI<T> = Comlink.Remote<T> & WithAPIState;
-export interface PHPWebLoaderOptions {
-	emscriptenOptions?: EmscriptenOptions;
-	onPhpLoaderModuleLoaded?: (module: PHPLoaderModule) => void;
-	/** @deprecated To be replaced with `extensions` in the future */
-	loadAllExtensions?: boolean;
-}
-declare class WebPHP extends BasePHP {
-	/**
-	 * Creates a new PHP instance.
-	 *
-	 * Dynamically imports the PHP module, initializes the runtime,
-	 * and sets up networking. It's a shorthand for the lower-level
-	 * functions like `getPHPLoaderModule`, `loadPHPRuntime`, and
-	 * `PHP.initializeRuntime`
-	 *
-	 * @param phpVersion The PHP Version to load
-	 * @param options The options to use when loading PHP
-	 * @returns A new PHP instance
-	 */
-	static load(phpVersion: SupportedPHPVersion, options?: PHPWebLoaderOptions): Promise<WebPHP>;
-	static loadRuntime(phpVersion: SupportedPHPVersion, options?: PHPWebLoaderOptions): Promise<number>;
-}
-declare class WebPHPEndpoint implements Omit<IsomorphicLocalPHP, "setSapiName"> {
-	/** @inheritDoc @php-wasm/universal!RequestHandler.absoluteUrl  */
-	absoluteUrl: string;
-	/** @inheritDoc @php-wasm/universal!RequestHandler.documentRoot  */
-	documentRoot: string;
-	/** @inheritDoc */
-	constructor(requestHandler: PHPRequestHandler<WebPHP>, monitor?: EmscriptenDownloadMonitor);
-	/**
-	 * @internal
-	 * @deprecated
-	 * Do not use this method directly in the code consuming
-	 * the web API. It will change or even be removed without
-	 * a warning.
-	 */
-	protected __internal_getPHP(): WebPHP | undefined;
-	setPrimaryPHP(php: WebPHP): Promise<void>;
-	/** @inheritDoc @php-wasm/universal!PHPRequestHandler.pathToInternalUrl  */
-	pathToInternalUrl(path: string): string;
-	/** @inheritDoc @php-wasm/universal!PHPRequestHandler.internalUrlToPath  */
-	internalUrlToPath(internalUrl: string): string;
-	/**
-	 * The onDownloadProgress event listener.
-	 */
-	onDownloadProgress(callback: (progress: CustomEvent<ProgressEvent>) => void): Promise<void>;
-	/** @inheritDoc @php-wasm/universal!IsomorphicLocalPHP.mv  */
-	mv(fromPath: string, toPath: string): Promise<void>;
-	/** @inheritDoc @php-wasm/universal!IsomorphicLocalPHP.rmdir  */
-	rmdir(path: string, options?: RmDirOptions): Promise<void>;
-	/** @inheritDoc @php-wasm/universal!PHPRequestHandler.request */
-	request(request: PHPRequest): Promise<PHPResponse>;
-	/** @inheritDoc @php-wasm/web!WebPHP.run */
-	run(request: PHPRunOptions): Promise<PHPResponse>;
-	/** @inheritDoc @php-wasm/web!WebPHP.chdir */
-	chdir(path: string): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.setSapiName */
-	setSapiName(newName: string): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.mkdir */
-	mkdir(path: string): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.mkdirTree */
-	mkdirTree(path: string): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.readFileAsText */
-	readFileAsText(path: string): string;
-	/** @inheritDoc @php-wasm/web!WebPHP.readFileAsBuffer */
-	readFileAsBuffer(path: string): Uint8Array;
-	/** @inheritDoc @php-wasm/web!WebPHP.writeFile */
-	writeFile(path: string, data: string | Uint8Array): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.unlink */
-	unlink(path: string): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.listFiles */
-	listFiles(path: string, options?: ListFilesOptions): string[];
-	/** @inheritDoc @php-wasm/web!WebPHP.isDir */
-	isDir(path: string): boolean;
-	/** @inheritDoc @php-wasm/web!WebPHP.fileExists */
-	fileExists(path: string): boolean;
-	/** @inheritDoc @php-wasm/web!WebPHP.onMessage */
-	onMessage(listener: MessageListener): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.defineConstant */
-	defineConstant(key: string, value: string | boolean | number | null): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.addEventListener */
-	addEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
-	/** @inheritDoc @php-wasm/web!WebPHP.removeEventListener */
-	removeEventListener(eventType: PHPEvent["type"], listener: PHPEventListener): void;
+export interface MountOptions {
+	initialSync: {
+		direction?: "opfs-to-memfs" | "memfs-to-opfs";
+		onProgress?: SyncProgressCallback;
+	};
 }
 export type SyncProgress = {
 	/** The number of files that have been synced. */
@@ -2245,6 +2468,13 @@ export type SyncProgress = {
 	total: number;
 };
 export type SyncProgressCallback = (progress: SyncProgress) => void;
+export type BindOpfsOptions = {
+	php: PHP;
+	opfs: FileSystemDirectoryHandle;
+	initialSyncDirection?: MountOptions["initialSync"]["direction"];
+	onProgress?: SyncProgressCallback;
+	mountpoint: string;
+};
 /**
  * Represents the type of node in PHP file system.
  */
@@ -2294,22 +2524,26 @@ export type RenameOperation = {
 	nodeType: FSNodeType;
 };
 export type FilesystemOperation = CreateOperation | UpdateFileOperation | DeleteOperation | RenameOperation;
-declare class PlaygroundWorkerEndpoint extends WebPHPEndpoint {
+declare class PlaygroundWorkerEndpoint extends PHPWorker {
 	/**
 	 * A string representing the scope of the Playground instance.
 	 */
 	scope: string;
 	/**
-	 * A string representing the version of WordPress being used.
+	 * A string representing the requested version of WordPress.
+	 */
+	requestedWordPressVersion: string;
+	/**
+	 * A string representing the version of WordPress that was loaded.
 	 */
-	wordPressVersion: string;
-	constructor(requestHandler: PHPRequestHandler<WebPHP>, monitor: EmscriptenDownloadMonitor, scope: string, wordPressVersion: string);
+	loadedWordPressVersion: string | undefined;
+	constructor(monitor: EmscriptenDownloadMonitor, scope: string, requestedWordPressVersion: string);
 	/**
 	 * @returns WordPress module details, including the static assets directory and default theme.
 	 */
 	getWordPressModuleDetails(): Promise<{
 		majorVersion: string;
-		staticAssetsDirectory: string;
+		staticAssetsDirectory: string | undefined;
 	}>;
 	getSupportedWordPressVersions(): Promise<{
 		all: {
@@ -2319,13 +2553,12 @@ declare class PlaygroundWorkerEndpoint extends WebPHPEndpoint {
 			"6.4": string;
 			"6.3": string;
 			"6.2": string;
-			"6.1": string;
 		};
 		latest: string;
 	}>;
 	resetVirtualOpfs(): Promise<void>;
 	reloadFilesFromOpfs(): Promise<void>;
-	bindOpfs(opfs: FileSystemDirectoryHandle, onProgress?: SyncProgressCallback): Promise<void>;
+	bindOpfs(options: Omit<BindOpfsOptions, "php" | "onProgress">, onProgress?: SyncProgressCallback): Promise<void>;
 	journalFSEvents(root: string, callback: (op: FilesystemOperation) => void): Promise<() => any>;
 	replayFSJournal(events: FilesystemOperation[]): Promise<void>;
 }
@@ -2374,7 +2607,7 @@ export interface WebClientMixin extends ProgressReceiver {
 	removeEventListener: PlaygroundWorkerEndpoint["removeEventListener"];
 	/** @inheritDoc @php-wasm/universal!UniversalPHP.onMessage */
 	onMessage: PlaygroundWorkerEndpoint["onMessage"];
-	bindOpfs(opfs: FileSystemDirectoryHandle, onProgress?: SyncProgressCallback): Promise<void>;
+	bindOpfs(options: Omit<BindOpfsOptions, "php" | "onProgress">, onProgress?: SyncProgressCallback): Promise<void>;
 }
 /**
  * The Playground Client interface.
@@ -2402,6 +2635,15 @@ export interface StartPlaygroundOptions {
 	 * @private
 	 */
 	sapiName?: string;
+	/**
+	 * Called before the blueprint steps are run,
+	 * allows the caller to delay the Blueprint execution
+	 * once the Playground is booted.
+	 *
+	 * @returns
+	 */
+	onBeforeBlueprint?: () => Promise<void>;
+	siteSlug?: string;
 }
 /**
  * Loads playground in iframe and returns a PlaygroundClient instance.
@@ -2410,7 +2652,7 @@ export interface StartPlaygroundOptions {
  * @param options Options for loading the playground.
  * @returns A PlaygroundClient instance.
  */
-export declare function startPlaygroundWeb({ iframe, blueprint, remoteUrl, progressTracker, disableProgressBar, onBlueprintStepCompleted, onClientConnected, sapiName, }: StartPlaygroundOptions): Promise<PlaygroundClient>;
+export declare function startPlaygroundWeb({ iframe, blueprint, remoteUrl, progressTracker, disableProgressBar, onBlueprintStepCompleted, onClientConnected, sapiName, onBeforeBlueprint, siteSlug, }: StartPlaygroundOptions): Promise<PlaygroundClient>;
 /**
  * @deprecated Use `startPlayground` instead.
  *