@wp-playground/cli 3.0.19 → 3.0.20

package/{run-cli-fhMEvo2X.js → run-cli-g3_uJkf5.js}

@@ -1,18 +1,18 @@
-import { logger as g, LogSeverity as U, errorLogPath as z } from "@php-wasm/logger";
-import { PHPResponse as O, consumeAPI as B, SupportedPHPVersions as me, printDebugDetails as he, exposeAPI as ge, exposeSyncAPI as we } from "@php-wasm/universal";
+import { logger as g, LogSeverity as N, errorLogPath as z } from "@php-wasm/logger";
+import { PHPResponse as O, consumeAPI as R, SupportedPHPVersions as me, printDebugDetails as he, exposeAPI as ge, exposeSyncAPI as we } from "@php-wasm/universal";
 import { resolveRemoteBlueprint as ye, resolveRuntimeConfiguration as X, compileBlueprintV1 as be, isBlueprintBundle as ve, runBlueprintV1Steps as Pe } from "@wp-playground/blueprints";
 import { zipDirectory as Se, RecommendedPHPVersion as ee } from "@wp-playground/common";
-import u, { mkdirSync as J } from "fs";
-import { Worker as Z, MessageChannel as ke } from "worker_threads";
-import { p as Y, a as G, e as xe } from "./mounts-D1_eXSTw.js";
+import p, { mkdirSync as J } from "fs";
+import { Worker as Z, MessageChannel as xe } from "worker_threads";
+import { p as Y, a as G, e as ke } from "./mounts-ChxECdbN.js";
 import Ie from "express";
 import { FileLockManagerForNode as Ee } from "@php-wasm/node";
 import te, { cpus as Ce } from "os";
 import { jspi as Le } from "wasm-feature-detect";
 import $e from "yargs";
 import m, { basename as Te } from "path";
-import { NodeJsFilesystem as We, OverlayFilesystem as je, InMemoryFilesystem as Be, ZipFilesystem as Re } from "@wp-playground/storage";
-import { EmscriptenDownloadMonitor as Fe, ProgressTracker as Me } from "@php-wasm/progress";
+import { NodeJsFilesystem as je, OverlayFilesystem as Be, InMemoryFilesystem as Me, ZipFilesystem as Re } from "@wp-playground/storage";
+import { EmscriptenDownloadMonitor as Fe, ProgressTracker as We } from "@php-wasm/progress";
 import { resolveWordPressRelease as De } from "@wp-playground/wordpress";
 import T from "fs-extra";
 import { startBridge as Ae } from "@php-wasm/xdebug-bridge";
@@ -104,9 +104,9 @@ async function Xe({
   if (e.startsWith("http://") || e.startsWith("https://"))
     return await ye(e);
   let t = m.resolve(process.cwd(), e);
-  if (!u.existsSync(t))
+  if (!p.existsSync(t))
     throw new Error(`Blueprint file does not exist: ${t}`);
-  const i = u.statSync(t);
+  const i = p.statSync(t);
   if (i.isDirectory() && (t = m.join(t, "blueprint.json")), !i.isFile() && i.isSymbolicLink())
     throw new Error(
       `Blueprint path is neither a file nor a directory: ${t}`
@@ -115,10 +115,10 @@ async function Xe({
   switch (s) {
     case ".zip":
       return Re.fromArrayBuffer(
-        u.readFileSync(t).buffer
+        p.readFileSync(t).buffer
       );
     case ".json": {
-      const n = u.readFileSync(t, "utf-8");
+      const n = p.readFileSync(t, "utf-8");
       try {
         JSON.parse(n);
       } catch {
@@ -126,9 +126,9 @@ async function Xe({
           `Blueprint file at ${t} is not a valid JSON file`
         );
       }
-      const r = m.dirname(t), a = new We(r);
-      return new je([
-        new Be({
+      const r = m.dirname(t), a = new je(r);
+      return new Be([
+        new Me({
           "blueprint.json": n
         }),
         /**
@@ -162,7 +162,7 @@ class Je {
     return "v2";
   }
   async bootAndSetUpInitialPlayground(o, t, i) {
-    const s = B(o);
+    const s = R(o);
     await s.useFileLockManager(t);
     const n = {
       ...this.args,
@@ -188,7 +188,7 @@ class Je {
     firstProcessId: i,
     nativeInternalDirPath: s
   }) {
-    const n = B(o.phpPort);
+    const n = R(o.phpPort);
     await n.useFileLockManager(t);
     const r = {
       ...this.args,
@@ -232,8 +232,8 @@ async function Ye(e, o, t) {
   r.close(), r.closed || await new Promise((a, l) => {
     r.on("finish", () => {
       T.renameSync(n, o), a(null);
-    }), r.on("error", (p) => {
-      T.removeSync(n), l(p);
+    }), r.on("error", (d) => {
+      T.removeSync(n), l(d);
     });
   });
 }
@@ -248,35 +248,34 @@ class Ge {
     return "v1";
   }
   async bootAndSetUpInitialPlayground(o, t, i) {
-    let s;
-    const n = new Fe();
-    if (!this.args.skipWordPressSetup) {
-      let x = !1;
-      n.addEventListener("progress", (W) => {
-        if (x)
+    let s, n, r;
+    const a = new Fe();
+    if (this.args.wordpressInstallMode === "download-and-install") {
+      let k = !1;
+      a.addEventListener("progress", (j) => {
+        if (k)
           return;
-        const { loaded: k, total: f } = W.detail, j = Math.floor(
-          Math.min(100, 100 * k / f)
+        const { loaded: x, total: f } = j.detail, B = Math.floor(
+          Math.min(100, 100 * x / f)
         );
-        x = j === 100, this.writeProgressUpdate(
+        k = B === 100, this.writeProgressUpdate(
           process.stdout,
-          `Downloading WordPress ${j}%...`,
-          x
+          `Downloading WordPress ${B}%...`,
+          k
         );
-      }), s = await De(this.args.wp), g.log(
+      }), s = await De(this.args.wp), r = m.join(
+        _,
+        `prebuilt-wp-content-for-wp-${s.version}.zip`
+      ), n = p.existsSync(r) ? ie(r) : await ne(
+        s.releaseUrl,
+        `${s.version}.zip`,
+        a
+      ), g.log(
         `Resolved WordPress release URL: ${s?.releaseUrl}`
       );
     }
-    const r = s && m.join(
-      _,
-      `prebuilt-wp-content-for-wp-${s.version}.zip`
-    ), a = s ? u.existsSync(r) ? ie(r) : await ne(
-      s.releaseUrl,
-      `${s.version}.zip`,
-      n
-    ) : void 0;
     g.log("Fetching SQLite integration plugin...");
-    const l = this.args.skipSqliteSetup ? void 0 : await Ze(n), p = this.args.followSymlinks === !0, c = this.args.experimentalTrace === !0, d = this.args["mount-before-install"] || [], h = this.args.mount || [], b = B(o);
+    const l = this.args.skipSqliteSetup ? void 0 : await Ze(a), d = this.args.followSymlinks === !0, c = this.args.experimentalTrace === !0, u = this.args["mount-before-install"] || [], h = this.args.mount || [], b = R(o);
     await b.isConnected(), g.log("Booting WordPress...");
     const S = await X(
       this.getEffectiveBlueprint()
@@ -285,13 +284,14 @@ class Ge {
       phpVersion: S.phpVersion,
       wpVersion: S.wpVersion,
       siteUrl: this.siteUrl,
-      mountsBeforeWpInstall: d,
+      mountsBeforeWpInstall: u,
       mountsAfterWpInstall: h,
-      wordPressZip: a && await a.arrayBuffer(),
+      wordpressInstallMode: this.args.wordpressInstallMode || "download-and-install",
+      wordPressZip: n && await n.arrayBuffer(),
       sqliteIntegrationPluginZip: await l?.arrayBuffer(),
       firstProcessId: 0,
       processIdSpaceLength: this.processIdSpaceLength,
-      followSymlinks: p,
+      followSymlinks: d,
       trace: c,
       internalCookieStore: this.args.internalCookieStore,
       // We do not enable Xdebug by default for the initial worker
@@ -300,7 +300,7 @@ class Ge {
       // TODO: Consider supporting Xdebug for the initial worker via a dedicated flag.
       withXdebug: !1,
       nativeInternalDirPath: i
-    }), s && !this.args["mount-before-install"] && !u.existsSync(r) && (g.log("Caching preinstalled WordPress for the next boot..."), u.writeFileSync(
+    }), r && !this.args["mount-before-install"] && !p.existsSync(r) && (g.log("Caching preinstalled WordPress for the next boot..."), p.writeFileSync(
       r,
       await Se(b, "/wordpress")
     ), g.log("Cached!")), b;
@@ -311,7 +311,7 @@ class Ge {
     firstProcessId: i,
     nativeInternalDirPath: s
   }) {
-    const n = B(
+    const n = R(
       o.phpPort
     );
     await n.isConnected();
@@ -335,7 +335,7 @@ class Ge {
     }), await n.isReady(), n;
   }
   async compileInputBlueprint(o) {
-    const t = this.getEffectiveBlueprint(), i = new Me();
+    const t = this.getEffectiveBlueprint(), i = new We();
     let s = "", n = !1;
     return i.addEventListener("progress", (r) => {
       if (n)
@@ -394,7 +394,7 @@ async function Qe(e, o, t) {
     t
   )).map(
     (n) => new Promise((r) => {
-      u.rm(n, { recursive: !0 }, (a) => {
+      p.rm(n, { recursive: !0 }, (a) => {
         a ? g.warn(
           `Failed to delete stale Playground temp dir: ${n}`,
           a
@@ -408,7 +408,7 @@ async function Qe(e, o, t) {
 }
 async function et(e, o, t) {
   try {
-    const i = u.readdirSync(t).map((n) => m.join(t, n)), s = [];
+    const i = p.readdirSync(t).map((n) => m.join(t, n)), s = [];
     for (const n of i)
       await tt(
         e,
@@ -421,7 +421,7 @@ async function et(e, o, t) {
   }
 }
 async function tt(e, o, t) {
-  if (!u.lstatSync(t).isDirectory())
+  if (!p.lstatSync(t).isDirectory())
     return !1;
   const s = m.basename(t);
   if (!s.includes(e))
@@ -438,7 +438,7 @@ async function tt(e, o, t) {
   if (await ot(r.pid, r.executableName))
     return !1;
   const a = Date.now() - o;
-  return u.statSync(t).mtime.getTime() < a;
+  return p.statSync(t).mtime.getTime() < a;
 }
 async function ot(e, o) {
   const [t] = await new Promise(
@@ -465,11 +465,11 @@ async function rt(e, o, t) {
     // symlinks and do not require elevated permissions.
     "junction"
   ) : "dir";
-  u.symlinkSync(e, o, i);
+  p.symlinkSync(e, o, i);
 }
 async function nt(e) {
   try {
-    u.lstatSync(e).isSymbolicLink() && u.unlinkSync(e);
+    p.lstatSync(e).isSymbolicLink() && p.unlinkSync(e);
   } catch {
   }
 }
@@ -500,7 +500,7 @@ const E = {
   suppressBooleanAttributes: !E.allowBooleanAttributes,
   format: !0,
   indentBy: "	"
-}, R = {
+}, F = {
   allowEmptyContent: !0,
   allowTrailingComma: !0
 };
@@ -511,7 +511,7 @@ function st(e, o) {
     } catch {
       throw new Error("PhpStorm configuration file is not valid XML.");
     }
-  })(), p = {
+  })(), d = {
     server: [
       {
         path_mappings: n.map((f) => ({
@@ -550,21 +550,21 @@ function st(e, o) {
     project: [],
     ":@": { version: "4" }
   }, l.push(c));
-  let d = c.project?.find(
+  let u = c.project?.find(
     (f) => !!f?.component && f?.[":@"]?.name === "PhpServers"
   );
-  d === void 0 && (d = {
+  u === void 0 && (u = {
     component: [],
     ":@": { name: "PhpServers" }
-  }, c.project === void 0 && (c.project = []), c.project.push(d));
-  let h = d.component?.find(
+  }, c.project === void 0 && (c.project = []), c.project.push(u));
+  let h = u.component?.find(
     (f) => !!f?.servers
   );
-  h === void 0 && (h = { servers: [] }, d.component === void 0 && (d.component = []), d.component.push(h));
+  h === void 0 && (h = { servers: [] }, u.component === void 0 && (u.component = []), u.component.push(h));
   const b = h.servers?.findIndex(
     (f) => !!f?.server && f?.[":@"]?.name === t
   );
-  (b === void 0 || b < 0) && (h.servers === void 0 && (h.servers = []), h.servers.push(p));
+  (b === void 0 || b < 0) && (h.servers === void 0 && (h.servers = []), h.servers.push(d));
   let S = c.project?.find(
     (f) => !!f?.component && f?.[":@"]?.name === "RunManager"
   );
@@ -592,33 +592,33 @@ function st(e, o) {
     };
     S.component === void 0 && (S.component = []), S.component.push(f);
   }
-  const k = new re(se).build(l);
+  const x = new re(se).build(l);
   try {
-    a.parse(k, !0);
+    a.parse(x, !0);
   } catch {
     throw new Error(
       "The resulting PhpStorm configuration file is not valid XML."
     );
   }
-  return k;
+  return x;
 }
 function at(e, o) {
   const { name: t, mappings: i } = o, s = [];
-  let n = e, r = v.parseTree(n, s, R);
+  let n = e, r = v.parseTree(n, s, F);
   if (r === void 0 || s.length)
     throw new Error("VS Code configuration file is not valid JSON.");
   let a = v.findNodeAtLocation(r, ["configurations"]);
   if (a === void 0 || a.children === void 0) {
-    const p = v.modify(n, ["configurations"], [], {});
-    n = v.applyEdits(n, p), r = v.parseTree(n, [], R), a = v.findNodeAtLocation(r, [
+    const d = v.modify(n, ["configurations"], [], {});
+    n = v.applyEdits(n, d), r = v.parseTree(n, [], F), a = v.findNodeAtLocation(r, [
       "configurations"
     ]);
   }
   const l = a?.children?.findIndex(
-    (p) => v.findNodeAtLocation(p, ["name"])?.value === t
+    (d) => v.findNodeAtLocation(d, ["name"])?.value === t
   );
   if (l === void 0 || l < 0) {
-    const p = {
+    const d = {
       name: t,
       type: "php",
       request: "launch",
@@ -626,10 +626,10 @@ function at(e, o) {
       pathMappings: i.reduce((h, b) => (h[b.vfsPath] = `\${workspaceFolder}/${le(
         m.relative(o.workspaceDir, b.hostPath)
       )}`, h), {})
-    }, c = a?.children?.length || 0, d = v.modify(
+    }, c = a?.children?.length || 0, u = v.modify(
       n,
       ["configurations", c],
-      p,
+      d,
       {
         formattingOptions: {
           insertSpaces: !0,
@@ -639,7 +639,7 @@ function at(e, o) {
         }
       }
     );
-    n = ae(n, d);
+    n = ae(n, u);
   }
   return n;
 }
@@ -654,13 +654,13 @@ async function lt({
 }) {
   const a = it(s, n), l = [];
   if (o.includes("phpstorm")) {
-    const p = ".idea/workspace.xml", c = m.join(
+    const d = ".idea/workspace.xml", c = m.join(
       s,
-      p
+      d
     );
-    if (!u.existsSync(c)) {
-      if (u.existsSync(m.dirname(c)))
-        u.writeFileSync(
+    if (!p.existsSync(c)) {
+      if (p.existsSync(m.dirname(c)))
+        p.writeFileSync(
           c,
           `<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
@@ -671,8 +671,8 @@ async function lt({
           "PhpStorm IDE integration requested, but no '.idea' directory was found in the current working directory."
         );
     }
-    if (u.existsSync(c)) {
-      const d = u.readFileSync(c, "utf8"), h = st(d, {
+    if (p.existsSync(c)) {
+      const u = p.readFileSync(c, "utf8"), h = st(u, {
         name: e,
         host: t,
         port: i,
@@ -680,18 +680,18 @@ async function lt({
         mappings: a,
         ideKey: r
       });
-      u.writeFileSync(c, h);
+      p.writeFileSync(c, h);
     }
-    l.push(p);
+    l.push(d);
   }
   if (o.includes("vscode")) {
-    const p = ".vscode/launch.json", c = m.join(
+    const d = ".vscode/launch.json", c = m.join(
       s,
-      p
+      d
     );
-    if (!u.existsSync(c)) {
-      if (u.existsSync(m.dirname(c)))
-        u.writeFileSync(
+    if (!p.existsSync(c)) {
+      if (p.existsSync(m.dirname(c)))
+        p.writeFileSync(
           c,
           `{
     "configurations": []
@@ -702,21 +702,21 @@ async function lt({
           "VS Code IDE integration requested, but no '.vscode' directory was found in the current working directory."
         );
     }
-    if (u.existsSync(c)) {
-      const d = u.readFileSync(c, "utf-8"), h = at(d, {
+    if (p.existsSync(c)) {
+      const u = p.readFileSync(c, "utf-8"), h = at(u, {
         name: e,
         workspaceDir: s,
         mappings: a
       });
-      h !== d && (u.writeFileSync(c, h), l.push(p));
+      h !== u && (p.writeFileSync(c, h), l.push(d));
     }
   }
   return l;
 }
 async function ct(e, o) {
   const t = m.join(o, ".idea/workspace.xml");
-  if (u.existsSync(t)) {
-    const s = u.readFileSync(t, "utf8"), n = new oe(E), r = (() => {
+  if (p.existsSync(t)) {
+    const s = p.readFileSync(t, "utf8"), n = new oe(E), r = (() => {
       try {
         return n.parse(s, !0);
       } catch {
@@ -724,17 +724,17 @@ async function ct(e, o) {
           "PhpStorm configuration file is not valid XML."
         );
       }
-    })(), p = r.find(
-      (d) => !!d?.project
+    })(), d = r.find(
+      (u) => !!u?.project
     )?.project?.find(
-      (d) => !!d?.component && d?.[":@"]?.name === "PhpServers"
+      (u) => !!u?.component && u?.[":@"]?.name === "PhpServers"
     )?.component?.find(
-      (d) => !!d?.servers
-    ), c = p?.servers?.findIndex(
-      (d) => !!d?.server && d?.[":@"]?.name === e
+      (u) => !!u?.servers
+    ), c = d?.servers?.findIndex(
+      (u) => !!u?.server && u?.[":@"]?.name === e
     );
     if (c !== void 0 && c >= 0) {
-      p.servers.splice(c, 1);
+      d.servers.splice(c, 1);
       const h = new re(se).build(r);
       try {
         n.parse(h, !0);
@@ -748,21 +748,21 @@ async function ct(e, o) {
 	<component name="PhpServers">
 		<servers></servers>
 	</component>
-</project>` ? u.unlinkSync(t) : u.writeFileSync(t, h);
+</project>` ? p.unlinkSync(t) : p.writeFileSync(t, h);
     }
   }
   const i = m.join(o, ".vscode/launch.json");
-  if (u.existsSync(i)) {
-    const s = [], n = u.readFileSync(i, "utf-8"), r = v.parseTree(n, s, R);
+  if (p.existsSync(i)) {
+    const s = [], n = p.readFileSync(i, "utf-8"), r = v.parseTree(n, s, F);
     if (r === void 0 || s.length)
       throw new Error("VS Code configuration file is not valid JSON.");
     const l = v.findNodeAtLocation(r, [
       "configurations"
     ])?.children?.findIndex(
-      (p) => v.findNodeAtLocation(p, ["name"])?.value === e
+      (d) => v.findNodeAtLocation(d, ["name"])?.value === e
     );
     if (l !== void 0 && l >= 0) {
-      const p = v.modify(
+      const d = v.modify(
         n,
         ["configurations", l],
         void 0,
@@ -774,16 +774,16 @@ async function ct(e, o) {
 `
           }
         }
-      ), c = ae(n, p);
+      ), c = ae(n, d);
       c === `{
     "configurations": []
-}` ? u.unlinkSync(i) : u.writeFileSync(i, c);
+}` ? p.unlinkSync(i) : p.writeFileSync(i, c);
     }
   }
 }
 function ae(e, o) {
   const t = [], i = v.applyEdits(e, o);
-  if (t.length = 0, v.parseTree(i, t, R), t.length) {
+  if (t.length = 0, v.parseTree(i, t, F), t.length) {
     const s = t.map((r) => ({
       message: v.printParseErrorCode(r.error),
       offset: r.offset,
@@ -815,9 +815,9 @@ function le(e) {
   return e.replaceAll(m.sep, m.posix.sep);
 }
 const H = {
-  Quiet: { name: "quiet", severity: U.Fatal },
-  Normal: { name: "normal", severity: U.Info },
-  Debug: { name: "debug", severity: U.Debug }
+  Quiet: { name: "quiet", severity: N.Fatal },
+  Normal: { name: "normal", severity: N.Info },
+  Debug: { name: "debug", severity: N.Debug }
 };
 async function At() {
   try {
@@ -878,10 +878,20 @@ async function At() {
       describe: 'Consent flag: Allow "bundled" resources in a local blueprint to read files in the same directory as the blueprint file.',
       type: "boolean",
       default: !1
-    }).option("skip-wordpress-setup", {
-      describe: "Do not download, unzip, and install WordPress. Useful for mounting a pre-configured WordPress directory at /wordpress.",
+    }).option("wordpress-install-mode", {
+      describe: "Control how Playground prepares WordPress before booting.",
+      type: "string",
+      default: "download-and-install",
+      choices: [
+        "download-and-install",
+        "install-from-existing-files",
+        "install-from-existing-files-if-needed",
+        "do-not-attempt-installing"
+      ]
+    }).option("skip-wordpress-install", {
+      describe: "[Deprecated] Use --wordpress-install-mode instead.",
       type: "boolean",
-      default: !1
+      hidden: !0
     }).option("skip-sqlite-setup", {
       describe: "Skip the SQLite integration plugin setup to allow the WordPress site to use MySQL.",
       type: "boolean",
@@ -955,7 +965,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
       // Remove the "hidden" flag once Blueprint V2 is fully supported
       hidden: !0
     }).showHelpOnFail(!1).strictOptions().check(async (r) => {
-      if ((r["skip-wordpress-setup"] || r.skipWordpressSetup) && (r.skipWordPressSetup = !0), r.wp !== void 0 && !ze(r.wp))
+      if (r["skip-wordpress-install"] === !0 && (r["wordpress-install-mode"] = "do-not-attempt-installing", r.wordpressInstallMode = "do-not-attempt-installing"), r.wp !== void 0 && !ze(r.wp))
         try {
           new URL(r.wp);
         } catch {
@@ -974,7 +984,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
       if (r["auto-mount"]) {
         let a = !1;
         try {
-          a = u.statSync(r["auto-mount"]).isDirectory();
+          a = p.statSync(r["auto-mount"]).isDirectory();
         } catch {
           a = !1;
         }
@@ -989,9 +999,9 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         );
       if (r["experimental-blueprints-v2-runner"] === !0) {
         if (r.mode !== void 0) {
-          if ("skip-wordpress-setup" in r)
+          if (r["wordpress-install-mode"] !== void 0)
             throw new Error(
-              "The --skipWordPressSetup option cannot be used with the --mode option. Use one or the other."
+              "The --wordpress-install-mode option cannot be used with the --mode option. Use one or the other."
             );
           if ("skip-sqlite-setup" in r)
             throw new Error(
@@ -1002,7 +1012,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
               "The --mode option cannot be used with --auto-mount because --auto-mount automatically sets the mode."
             );
         } else
-          r["skip-wordpress-setup"] === !0 ? r.mode = "apply-to-existing-site" : r.mode = "create-new-site";
+          r["wordpress-install-mode"] === "do-not-attempt-installing" ? r.mode = "apply-to-existing-site" : r.mode = "create-new-site";
         const a = r.allow || [];
         r.followSymlinks === !0 && a.push("follow-symlinks"), r["blueprint-may-read-adjacent-files"] === !0 && a.push("read-local-fs"), r.allow = a;
       } else if (r.mode !== void 0)
@@ -1022,7 +1032,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         ...o["mount-before-install"] || [],
         ...o["mount-dir-before-install"] || []
       ]
-    }, s = await ut(i);
+    }, s = await pt(i);
     s === void 0 && process.exit(0);
     const n = /* @__PURE__ */ (() => {
       let r;
@@ -1043,19 +1053,19 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         t.push(i.message), i = i.cause;
       while (i instanceof Error);
       console.error(
-        "\x1B[1m" + t.join(" caused by ") + "\x1B[0m"
+        "\x1B[1m" + t.join(" caused by: ") + "\x1B[0m"
       );
     }
     process.exit(1);
   }
 }
-const N = (e) => process.stdout.isTTY ? "\x1B[1m" + e + "\x1B[0m" : e, pt = (e) => process.stdout.isTTY ? `\x1B[2m${e}\x1B[0m` : e, V = (e) => process.stdout.isTTY ? `\x1B[3m${e}\x1B[0m` : e, K = (e) => process.stdout.isTTY ? `\x1B[33m${e}\x1B[0m` : e;
-async function ut(e) {
+const M = (e) => process.stdout.isTTY ? "\x1B[1m" + e + "\x1B[0m" : e, dt = (e) => process.stdout.isTTY ? `\x1B[2m${e}\x1B[0m` : e, V = (e) => process.stdout.isTTY ? `\x1B[3m${e}\x1B[0m` : e, K = (e) => process.stdout.isTTY ? `\x1B[33m${e}\x1B[0m` : e;
+async function pt(e) {
   let o, t;
   const i = [];
-  if (e.autoMount !== void 0 && (e.autoMount === "" && (e = { ...e, autoMount: process.cwd() }), e = xe(e)), e.quiet && (e.verbosity = "quiet", delete e.quiet), e.debug ? e.verbosity = "debug" : e.verbosity === "debug" && (e.debug = !0), e.verbosity) {
+  if (e.autoMount !== void 0 && (e.autoMount === "" && (e = { ...e, autoMount: process.cwd() }), e = ke(e)), e.wordpressInstallMode === void 0 && (e.wordpressInstallMode = "download-and-install"), e.quiet && (e.verbosity = "quiet", delete e.quiet), e.debug ? e.verbosity = "debug" : e.verbosity === "debug" && (e.debug = !0), e.verbosity) {
     const l = Object.values(H).find(
-      (p) => p.name === e.verbosity
+      (d) => d.name === e.verbosity
     ).severity;
     g.setSeverityFilterLevel(l);
   }
@@ -1070,22 +1080,22 @@ async function ut(e) {
   let r = !1, a = !0;
   return g.log("Starting a PHP server..."), Oe({
     port: e.port,
-    onBind: async (l, p) => {
-      const c = "127.0.0.1", d = `http://${c}:${p}`, h = e["site-url"] || d, b = e.experimentalMultiWorker ?? 1, S = b + 1, x = Math.floor(
+    onBind: async (l, d) => {
+      const c = "127.0.0.1", u = `http://${c}:${d}`, h = e["site-url"] || u, b = e.experimentalMultiWorker ?? 1, S = b + 1, k = Math.floor(
         Number.MAX_SAFE_INTEGER / S
-      ), W = "-playground-cli-site-", k = await Ke(
-        W
+      ), j = "-playground-cli-site-", x = await Ke(
+        j
       );
-      g.debug(`Native temp dir for VFS root: ${k.path}`);
-      const f = "WP Playground CLI - Listen for Xdebug", j = ".playground-xdebug-root", q = m.join(process.cwd(), j);
+      g.debug(`Native temp dir for VFS root: ${x.path}`);
+      const f = "WP Playground CLI - Listen for Xdebug", B = ".playground-xdebug-root", q = m.join(process.cwd(), B);
       if (await nt(q), e.xdebug && e.experimentalUnsafeIdeIntegration) {
         await rt(
-          k.path,
+          x.path,
           q,
           process.platform
         );
         const w = {
-          hostPath: m.join(".", m.sep, j),
+          hostPath: m.join(".", m.sep, B),
           vfsPath: "/"
         };
         try {
@@ -1093,7 +1103,7 @@ async function ut(e) {
           const y = typeof e.xdebug == "object" ? e.xdebug : void 0, $ = await lt({
             name: f,
             host: c,
-            port: p,
+            port: d,
             ides: e.experimentalUnsafeIdeIntegration,
             cwd: process.cwd(),
             mounts: [
@@ -1103,25 +1113,31 @@ async function ut(e) {
             ],
             ideKey: y?.ideKey
           }), P = e.experimentalUnsafeIdeIntegration, I = P.includes("vscode"), C = P.includes("phpstorm");
-          console.log(""), console.log(N("Xdebug configured successfully")), console.log(
+          console.log(""), console.log(M("Xdebug configured successfully")), console.log(
             K("Updated IDE config: ") + $.join(" ")
           ), console.log(
             K("Playground source root: ") + ".playground-xdebug-root" + V(
-              pt(
+              dt(
                 " – you can set breakpoints and preview Playground's VFS structure in there."
               )
             )
-          ), console.log(""), I && (console.log(N("VS Code / Cursor instructions:")), console.log(
-            "  1. Open the Run and Debug panel on the left sidebar"
+          ), console.log(""), I && (console.log(M("VS Code / Cursor instructions:")), console.log(
+            "  1. Ensure you have installed an IDE extension for PHP Debugging"
+          ), console.log(
+            `     (The ${M("PHP Debug")} extension by ${M(
+              "Xdebug"
+            )} has been a solid option)`
+          ), console.log(
+            "  2. Open the Run and Debug panel on the left sidebar"
           ), console.log(
-            `  2. Select "${V(
+            `  3. Select "${V(
               f
             )}" from the dropdown`
           ), console.log('  3. Click "start debugging"'), console.log(
-            "  4. Set a breakpoint. For example, in .playground-xdebug-root/wordpress/index.php"
+            "  5. Set a breakpoint. For example, in .playground-xdebug-root/wordpress/index.php"
           ), console.log(
-            "  5. Visit Playground in your browser to hit the breakpoint"
-          ), C && console.log("")), C && (console.log(N("PhpStorm instructions:")), console.log(
+            "  6. Visit Playground in your browser to hit the breakpoint"
+          ), C && console.log("")), C && (console.log(M("PhpStorm instructions:")), console.log(
             `  1. Choose "${V(
               f
             )}" debug configuration in the toolbar`
@@ -1136,15 +1152,15 @@ async function ut(e) {
           });
         }
       }
-      const ce = m.dirname(k.path), pe = 2 * 24 * 60 * 60 * 1e3;
+      const ce = m.dirname(x.path), de = 2 * 24 * 60 * 60 * 1e3;
       Qe(
-        W,
-        pe,
+        j,
+        de,
         ce
       );
-      const F = m.join(k.path, "internal");
-      J(F);
-      const ue = [
+      const W = m.join(x.path, "internal");
+      J(W);
+      const pe = [
         "wordpress",
         // Note: These dirs are from Emscripten's "default dirs" list:
         // https://github.com/emscripten-core/emscripten/blob/f431ec220e472e1f8d3db6b52fe23fb377facf30/src/lib/libfs.js#L1400-L1402
@@ -1155,11 +1171,11 @@ async function ut(e) {
         "tmp",
         "home"
       ];
-      for (const w of ue) {
+      for (const w of pe) {
         const y = (P) => P.vfsPath === `/${w}`;
         if (!(e["mount-before-install"]?.some(y) || e.mount?.some(y))) {
           const P = m.join(
-            k.path,
+            x.path,
             w
           );
           J(P), e["mount-before-install"] === void 0 && (e["mount-before-install"] = []), e["mount-before-install"].unshift({
@@ -1181,41 +1197,41 @@ async function ut(e) {
       let L;
       e["experimental-blueprints-v2-runner"] ? L = new Je(e, {
         siteUrl: h,
-        processIdSpaceLength: x
+        processIdSpaceLength: k
       }) : (L = new Ge(e, {
         siteUrl: h,
-        processIdSpaceLength: x
+        processIdSpaceLength: k
       }), typeof e.blueprint == "string" && (e.blueprint = await Xe({
         sourceString: e.blueprint,
         blueprintMayReadAdjacentFiles: e["blueprint-may-read-adjacent-files"] === !0
       })));
-      let M = !1;
-      const D = async function() {
-        M || (M = !0, await Promise.all(
+      let D = !1;
+      const A = async function() {
+        D || (D = !0, await Promise.all(
           i.map(async ({ playground: y, worker: $ }) => {
             await y.dispose(), await $.terminate();
           })
-        ), l && await new Promise((y) => l.close(y)), await k.cleanup());
-      }, de = dt(
+        ), l && await new Promise((y) => l.close(y)), await x.cleanup());
+      }, ue = ut(
         S,
         L.getWorkerType(),
         ({ exitCode: w, workerIndex: y }) => {
-          M || w === 0 && g.error(
+          D || w === 0 && g.error(
             `Worker ${y} exited with code ${w}
 `
           );
         }
       );
-      g.log(`Setting up WordPress ${e.wp}`);
+      g.log("Starting up workers");
       try {
-        const w = await de, y = await Q(
+        const w = await ue, y = await Q(
           n
         );
         {
           const P = w.shift(), I = await L.bootAndSetUpInitialPlayground(
             P.phpPort,
             y,
-            F
+            W
           );
           if (await I.isReady(), r = !0, g.log("Booted!"), o = new qe(I), !e["experimental-blueprints-v2-runner"]) {
             const C = await L.compileInputBlueprint(
@@ -1227,41 +1243,41 @@ async function ut(e) {
             ), g.log("Finished running the blueprint"));
           }
           if (e.command === "build-snapshot") {
-            await mt(t, e.outfile), g.log(`WordPress exported to ${e.outfile}`), await D();
+            await mt(t, e.outfile), g.log(`WordPress exported to ${e.outfile}`), await A();
             return;
           } else if (e.command === "run-blueprint") {
-            g.log("Blueprint executed"), await D();
+            g.log("Blueprint executed"), await A();
             return;
           }
           await o.removeWorker(I), await I.dispose(), await P.worker.terminate();
         }
         g.log("Preparing workers...");
-        const $ = x;
+        const $ = k;
         return [t] = await Promise.all(
           w.map(async (P, I) => {
-            const C = $ + I * x, fe = await Q(
+            const C = $ + I * k, fe = await Q(
               n
-            ), A = await L.bootPlayground({
+            ), U = await L.bootPlayground({
               worker: P,
               fileLockManagerPort: fe,
               firstProcessId: C,
-              nativeInternalDirPath: F
+              nativeInternalDirPath: W
             });
             return i.push({
-              playground: A,
+              playground: U,
               worker: P.worker
-            }), o.addWorker(A), A;
+            }), o.addWorker(U), U;
           })
         ), g.log(
-          `WordPress is running on ${d} with ${b} worker(s)`
+          `WordPress is running on ${u} with ${b} worker(s)`
         ), e.xdebug && e.experimentalDevtools && (await Ae({
           phpInstance: t,
           phpRoot: "/wordpress"
         })).start(), {
           playground: t,
           server: l,
-          serverUrl: d,
-          [Symbol.asyncDispose]: D,
+          serverUrl: u,
+          [Symbol.asyncDispose]: A,
           workerThreadCount: b
         };
       } catch (w) {
@@ -1279,22 +1295,22 @@ async function ut(e) {
         );
       if (a) {
         a = !1;
-        const p = {
+        const d = {
           "Content-Type": ["text/plain"],
           "Content-Length": ["0"],
           Location: [l.url]
         };
         return l.headers?.cookie?.includes(
           "playground_auto_login_already_happened"
-        ) && (p["Set-Cookie"] = [
+        ) && (d["Set-Cookie"] = [
           "playground_auto_login_already_happened=1; Max-Age=0; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Path=/"
-        ]), new O(302, p, new Uint8Array());
+        ]), new O(302, d, new Uint8Array());
       }
       return await o.handleRequest(l);
     }
   });
 }
-async function dt(e, o, t) {
+async function ut(e, o, t) {
   const i = [];
   for (let s = 0; s < e; s++) {
     const n = await ft(o), r = (a) => {
@@ -1306,12 +1322,12 @@ async function dt(e, o, t) {
     i.push(
       new Promise(
         (a, l) => {
-          n.once("message", function(p) {
-            p.command === "worker-script-initialized" && a({ worker: n, phpPort: p.phpPort });
-          }), n.once("error", function(p) {
-            console.error(p);
+          n.once("message", function(d) {
+            d.command === "worker-script-initialized" && a({ worker: n, phpPort: d.phpPort });
+          }), n.once("error", function(d) {
+            console.error(d);
             const c = new Error(
-              `Worker failed to load worker. ${p.message ? `Original error: ${p.message}` : ""}`
+              `Worker failed to load worker. ${d.message ? `Original error: ${d.message}` : ""}`
             );
             l(c);
           }), n.once("exit", r);
@@ -1325,7 +1341,7 @@ async function ft(e) {
   return e === "v1" ? new Z(new URL("./worker-thread-v1.js", import.meta.url)) : new Z(new URL("./worker-thread-v2.js", import.meta.url));
 }
 async function Q(e) {
-  const { port1: o, port2: t } = new ke();
+  const { port1: o, port2: t } = new xe();
   return await Le() ? ge(e, null, o) : await we(e, o), t;
 }
 async function mt(e, o) {
@@ -1350,11 +1366,11 @@ async function mt(e, o) {
 	`
   });
   const t = await e.readFileAsBuffer("/tmp/build.zip");
-  u.writeFileSync(o, t);
+  p.writeFileSync(o, t);
 }
 export {
   H as L,
   At as p,
-  ut as r
+  pt as r
 };
-//# sourceMappingURL=run-cli-fhMEvo2X.js.map
+//# sourceMappingURL=run-cli-g3_uJkf5.js.map