@wp-playground/client 3.1.27 → 3.1.28

package/index.d.ts

@@ -5270,6 +5270,7 @@ export type WorkerBootOptions = {
 	withNetworking: boolean;
 	mounts?: Array<MountDescriptor>;
 	shouldInstallWordPress?: boolean;
+	shouldBootWordPress?: boolean;
 	corsProxyUrl?: string;
 	/** When true, skip default WP install and run Blueprints v2 in the worker */
 	experimentalBlueprintsV2Runner?: boolean;
@@ -5444,7 +5445,27 @@ 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.
+	 *
+	 * This option cannot be set to `true` when `shouldBootWordPress` is `false`,
+	 * because installing WordPress requires running the WordPress boot setup.
+	 */
 	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/`,