@wp-playground/client 3.1.33 → 3.1.35

package/index.d.ts

@@ -5272,8 +5272,10 @@ export type SyncProgress = {
 	files: number;
 	/** The number of all files that need to be synced. */
 	total: number;
+	/** The current stage of the initial sync. */
+	phase?: "copying" | "flushing";
 };
-export type SyncProgressCallback = (progress: SyncProgress) => void;
+export type SyncProgressCallback = (progress: SyncProgress) => void | Promise<void>;
 declare function createMemoizedFetch(originalFetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>): (url: string, options?: RequestInit) => Promise<Response>;
 export interface MountDescriptor {
 	mountpoint: string;
@@ -5289,8 +5291,8 @@ export type WorkerBootOptions = {
 	extensions?: PHPWebExtension[];
 	withNetworking: boolean;
 	mounts?: Array<MountDescriptor>;
+	/** @deprecated Use `wordpressInstallMode` instead. */
 	shouldInstallWordPress?: boolean;
-	shouldBootWordPress?: boolean;
 	corsProxyUrl?: string;
 	/** When true, skip default WP install and run Blueprints v2 in the worker */
 	experimentalBlueprintsV2Runner?: boolean;
@@ -5298,7 +5300,7 @@ export type WorkerBootOptions = {
 	blueprint?: BlueprintDeclaration;
 	/**
 	 * How to handle WordPress installation.
-	 * Defaults to 'install-from-existing-files-if-needed'.
+	 * Defaults to `download-and-install`.
 	 */
 	wordpressInstallMode?: WordPressInstallMode;
 	/**
@@ -5354,6 +5356,7 @@ declare abstract class PlaygroundWorkerEndpoint extends PHPWorker {
 		all: {
 			trunk: string;
 			beta: string;
+			"7.0": string;
 			"6.9": string;
 			"6.8": string;
 			"6.7": string;
@@ -5444,6 +5447,10 @@ export interface StartPlaygroundOptions {
 	progressTracker?: ProgressTracker;
 	disableProgressBar?: boolean;
 	blueprint?: BlueprintV1;
+	/**
+	 * PHP extensions to install before the runtime starts.
+	 */
+	extensions?: PHPWebExtension[];
 	/**
 	 * Prefer experimental Blueprints v2 PHP runner instead of TypeScript steps
 	 */
@@ -5466,26 +5473,13 @@ export interface StartPlaygroundOptions {
 	sapiName?: string;
 	mounts?: Array<MountDescriptor>;
 	/**
-	 * Whether to download/install WordPress files.
-	 *
-	 * Set this to `false` when WordPress files are already available, for example
-	 * from `mounts` or a saved site.
+	 * @deprecated Use `wordpressInstallMode` instead.
 	 *
-	 * This option cannot be set to `true` when `shouldBootWordPress` is `false`,
-	 * because installing WordPress requires running the WordPress boot setup.
+	 * Whether to download/install WordPress files. Set this to `false` when
+	 * WordPress files are already available, for example from `mounts` or a
+	 * saved site.
 	 */
 	shouldInstallWordPress?: boolean;
-	/**
-	 * Whether to run WordPress boot setup.
-	 *
-	 * This is separate from `shouldInstallWordPress` because saved sites can boot
-	 * from existing WordPress files without downloading or installing a fresh copy.
-	 * Set this to `false` for PHP-only Playgrounds.
-	 *
-	 * If `shouldInstallWordPress` is `false` and this option is `true`, WordPress
-	 * files must already be present, for example via `mounts` or a saved site.
-	 */
-	shouldBootWordPress?: boolean;
 	/**
 	 * The string prefix used in the site URL served by the currently
 	 * running remote.html. E.g. for a prefix like `/scope:playground/`,
@@ -5517,7 +5511,7 @@ export interface StartPlaygroundOptions {
 	sqliteDriverVersion?: string;
 	/**
 	 * How to handle WordPress installation.
-	 * Defaults to 'install-from-existing-files-if-needed'.
+	 * Defaults to `download-and-install`.
 	 */
 	wordpressInstallMode?: WordPressInstallMode;
 	/**