@wp-playground/cli 3.0.43 → 3.0.45

package/{run-cli-NcKUE5gJ.js → run-cli-BK0MGgcU.js}

@@ -1,26 +1,26 @@
-import { logger as g, LogSeverity as j, errorLogPath as ee } from "@php-wasm/logger";
-import { PHPResponse as Y, consumeAPI as F, SupportedPHPVersions as te, printDebugDetails as ye, exposeAPI as be, exposeSyncAPI as ve } from "@php-wasm/universal";
-import { resolveRemoteBlueprint as Pe, resolveRuntimeConfiguration as re, compileBlueprintV1 as Se, isBlueprintBundle as xe, runBlueprintV1Steps as ke } from "@wp-playground/blueprints";
-import { zipDirectory as Ie, RecommendedPHPVersion as U } from "@wp-playground/common";
-import p, { existsSync as X, rmdirSync as $e, mkdirSync as z, readdirSync as Te } from "fs";
-import { MessageChannel as Be, Worker as oe } from "worker_threads";
-import { createNodeFsMountHandler as Ee, FileLockManagerForNode as Le } from "@php-wasm/node";
-import h, { basename as A, join as ue } from "path";
+import { logger as y, LogSeverity as j, errorLogPath as re } from "@php-wasm/logger";
+import { PHPResponse as z, consumeAPI as U, SupportedPHPVersions as oe, printDebugDetails as ve, exposeAPI as Pe, exposeSyncAPI as Se } from "@php-wasm/universal";
+import { resolveRemoteBlueprint as xe, resolveRuntimeConfiguration as se, compileBlueprintV1 as ke, isBlueprintBundle as Ie, runBlueprintV1Steps as $e } from "@wp-playground/blueprints";
+import { zipDirectory as Ee, RecommendedPHPVersion as F } from "@wp-playground/common";
+import c, { existsSync as Z, rmdirSync as Te, mkdirSync as G, readdirSync as Be } from "fs";
+import { MessageChannel as Me, Worker as ie } from "worker_threads";
+import { createNodeFsMountHandler as Ce, FileLockManagerForNode as Le } from "@php-wasm/node";
+import p, { basename as A, join as ce } from "path";
 import We from "express";
-import O, { cpus as Ce } from "os";
-import { jspi as Me } from "wasm-feature-detect";
+import N, { cpus as De } from "os";
+import { jspi as Q } from "wasm-feature-detect";
 import Re from "yargs";
-import { NodeJsFilesystem as De, OverlayFilesystem as Ae, InMemoryFilesystem as Fe, ZipFilesystem as Ue } from "@wp-playground/storage";
-import { EmscriptenDownloadMonitor as Oe, ProgressTracker as He } from "@php-wasm/progress";
-import { resolveWordPressRelease as Ve } from "@wp-playground/wordpress";
+import { NodeJsFilesystem as Ae, OverlayFilesystem as Ue, InMemoryFilesystem as Fe, ZipFilesystem as Oe } from "@wp-playground/storage";
+import { EmscriptenDownloadMonitor as Ne, ProgressTracker as _e } from "@php-wasm/progress";
+import { resolveWordPressRelease as He } from "@wp-playground/wordpress";
 import B from "fs-extra";
-import { startBridge as Ne } from "@php-wasm/xdebug-bridge";
+import { startBridge as Ve } from "@php-wasm/xdebug-bridge";
 import { exec as je } from "child_process";
-import { dir as _e, setGracefulCleanup as qe } from "tmp-promise";
-import Ye from "ps-man";
-import { removeTempDirSymlink as ze, createTempDirSymlink as Qe, clearXdebugIDEConfig as Xe, addXdebugIDEConfig as Ze } from "@php-wasm/cli-util";
-import { createHash as Ge } from "crypto";
-function _(e) {
+import { dir as qe, setGracefulCleanup as Ye } from "tmp-promise";
+import ze from "ps-man";
+import { removeTempDirSymlink as Ge, createTempDirSymlink as Qe, clearXdebugIDEConfig as Xe, addXdebugIDEConfig as Ze } from "@php-wasm/cli-util";
+import { createHash as Je } from "crypto";
+function q(e) {
   const t = [];
   for (const r of e) {
     const s = r.split(":");
@@ -30,35 +30,35 @@ function _(e) {
 				If your path contains a colon, e.g. C:\\myplugin, use the --mount-dir option instead.
 				Example: --mount-dir C:\\my-plugin /wordpress/wp-content/plugins/my-plugin`);
     const [o, i] = s;
-    if (!X(o))
+    if (!Z(o))
       throw new Error(`Host path does not exist: ${o}`);
     t.push({ hostPath: o, vfsPath: i });
   }
   return t;
 }
-function se(e) {
+function ne(e) {
   if (e.length % 2 !== 0)
     throw new Error("Invalid mount format. Expected: /host/path /vfs/path");
   const t = [];
   for (let r = 0; r < e.length; r += 2) {
     const s = e[r], o = e[r + 1];
-    if (!X(s))
+    if (!Z(s))
       throw new Error(`Host path does not exist: ${s}`);
     t.push({
-      hostPath: h.resolve(process.cwd(), s),
+      hostPath: p.resolve(process.cwd(), s),
       vfsPath: o
     });
   }
   return t;
 }
-async function Gt(e, t) {
+async function rr(e, t) {
   for (const r of t)
     await e.mount(
       r.vfsPath,
-      Ee(r.hostPath)
+      Ce(r.hostPath)
     );
 }
-const ie = {
+const ae = {
   step: "runPHP",
   code: {
     filename: "activate-theme.php",
@@ -77,7 +77,7 @@ const ie = {
 		`
   }
 };
-function de(e) {
+function pe(e) {
   const t = e.autoMount, r = [...e.mount || []], s = [...e["mount-before-install"] || []], o = {
     ...e,
     mount: r,
@@ -86,7 +86,7 @@ function de(e) {
       ...e["additional-blueprint-steps"] || []
     ]
   };
-  if (tt(t)) {
+  if (rt(t)) {
     const n = `/wordpress/wp-content/plugins/${A(t)}`;
     r.push({
       hostPath: t,
@@ -96,7 +96,7 @@ function de(e) {
       step: "activatePlugin",
       pluginPath: `/wordpress/wp-content/plugins/${A(t)}`
     });
-  } else if (et(t)) {
+  } else if (tt(t)) {
     const i = A(t), n = `/wordpress/wp-content/themes/${i}`;
     r.push({
       hostPath: t,
@@ -111,44 +111,117 @@ function de(e) {
         themeFolderName: i
       }
     );
-  } else if (Ke(t)) {
-    const i = p.readdirSync(t);
+  } else if (et(t)) {
+    const i = c.readdirSync(t);
     for (const n of i)
       n !== "index.php" && r.push({
         hostPath: `${t}/${n}`,
         vfsPath: `/wordpress/wp-content/${n}`,
         autoMounted: !0
       });
-    o["additional-blueprint-steps"].push(ie);
-  } else Je(t) && (s.push({
+    o["additional-blueprint-steps"].push(ae);
+  } else Ke(t) && (s.push({
     hostPath: t,
     vfsPath: "/wordpress",
     autoMounted: !0
-  }), o.mode = "apply-to-existing-site", o["additional-blueprint-steps"].push(ie), o.wordpressInstallMode || (o.wordpressInstallMode = "install-from-existing-files-if-needed"));
+  }), o.mode = "apply-to-existing-site", o["additional-blueprint-steps"].push(ae), o.wordpressInstallMode || (o.wordpressInstallMode = "install-from-existing-files-if-needed"));
   return o;
 }
-function Je(e) {
-  const t = p.readdirSync(e);
+function Ke(e) {
+  const t = c.readdirSync(e);
   return t.includes("wp-admin") && t.includes("wp-includes") && t.includes("wp-content");
 }
-function Ke(e) {
-  const t = p.readdirSync(e);
+function et(e) {
+  const t = c.readdirSync(e);
   return t.includes("themes") || t.includes("plugins") || t.includes("mu-plugins") || t.includes("uploads");
 }
-function et(e) {
-  if (!p.readdirSync(e).includes("style.css"))
+function tt(e) {
+  if (!c.readdirSync(e).includes("style.css"))
     return !1;
-  const r = p.readFileSync(ue(e, "style.css"), "utf8");
+  const r = c.readFileSync(ce(e, "style.css"), "utf8");
   return !!/^(?:[ \t]*<\?php)?[ \t/*#@]*Theme Name:(.*)$/im.exec(r);
 }
-function tt(e) {
-  const t = p.readdirSync(e), r = /^(?:[ \t]*<\?php)?[ \t/*#@]*Plugin Name:(.*)$/im;
+function rt(e) {
+  const t = c.readdirSync(e), r = /^(?:[ \t]*<\?php)?[ \t/*#@]*Plugin Name:(.*)$/im;
   return !!t.filter((o) => o.endsWith(".php")).find((o) => {
-    const i = p.readFileSync(ue(e, o), "utf8");
+    const i = c.readFileSync(ce(e, o), "utf8");
     return !!r.exec(i);
   });
 }
-async function rt(e) {
+function ot(e) {
+  if (e.length % 2 !== 0)
+    throw new Error(
+      "Invalid constant definition format. Expected pairs of NAME value"
+    );
+  const t = {};
+  for (let r = 0; r < e.length; r += 2) {
+    const s = e[r], o = e[r + 1];
+    if (!s || !s.trim())
+      throw new Error("Constant name cannot be empty");
+    t[s.trim()] = o;
+  }
+  return t;
+}
+function st(e) {
+  if (e.length % 2 !== 0)
+    throw new Error(
+      "Invalid boolean constant definition format. Expected pairs of NAME value"
+    );
+  const t = {};
+  for (let r = 0; r < e.length; r += 2) {
+    const s = e[r], o = e[r + 1].trim().toLowerCase();
+    if (!s || !s.trim())
+      throw new Error("Constant name cannot be empty");
+    if (o === "true" || o === "1")
+      t[s.trim()] = !0;
+    else if (o === "false" || o === "0")
+      t[s.trim()] = !1;
+    else
+      throw new Error(
+        `Invalid boolean value for constant "${s}": "${o}". Must be "true", "false", "1", or "0".`
+      );
+  }
+  return t;
+}
+function it(e) {
+  if (e.length % 2 !== 0)
+    throw new Error(
+      "Invalid number constant definition format. Expected pairs of NAME value"
+    );
+  const t = {};
+  for (let r = 0; r < e.length; r += 2) {
+    const s = e[r], o = e[r + 1].trim();
+    if (!s || !s.trim())
+      throw new Error("Constant name cannot be empty");
+    const i = Number(o);
+    if (isNaN(i))
+      throw new Error(
+        `Invalid number value for constant "${s}": "${o}". Must be a valid number.`
+      );
+    t[s.trim()] = i;
+  }
+  return t;
+}
+function nt(e = {}, t = {}, r = {}) {
+  const s = {}, o = /* @__PURE__ */ new Set(), i = (n, l) => {
+    for (const u in n) {
+      if (o.has(u))
+        throw new Error(
+          `Constant "${u}" is defined multiple times across different --define-${l} flags`
+        );
+      o.add(u), s[u] = n[u];
+    }
+  };
+  return i(e, "string"), i(t, "bool"), i(r, "number"), s;
+}
+function O(e) {
+  return nt(
+    e.define,
+    e["define-bool"],
+    e["define-number"]
+  );
+}
+async function at(e) {
   const t = We(), r = await new Promise((i, n) => {
     const l = t.listen(e.port, () => {
       const u = l.address();
@@ -160,12 +233,12 @@ async function rt(e) {
     try {
       l = await e.handleRequest({
         url: i.url,
-        headers: st(i),
+        headers: ut(i),
         method: i.method,
-        body: await ot(i)
+        body: await lt(i)
       });
     } catch (u) {
-      g.error(u), l = Y.forHttpCode(500);
+      y.error(u), l = z.forHttpCode(500);
     }
     n.statusCode = l.httpStatusCode;
     for (const u in l.headers)
@@ -175,21 +248,21 @@ async function rt(e) {
   const o = r.address().port;
   return await e.onBind(r, o);
 }
-const ot = async (e) => await new Promise((t) => {
+const lt = async (e) => await new Promise((t) => {
   const r = [];
   e.on("data", (s) => {
     r.push(s);
   }), e.on("end", () => {
     t(new Uint8Array(Buffer.concat(r)));
   });
-}), st = (e) => {
+}), ut = (e) => {
   const t = {};
   if (e.rawHeaders && e.rawHeaders.length)
     for (let r = 0; r < e.rawHeaders.length; r += 2)
       t[e.rawHeaders[r].toLowerCase()] = e.rawHeaders[r + 1];
   return t;
 };
-class it {
+class dt {
   constructor(t) {
     this.workerLoads = [], this.addWorker(t);
   }
@@ -220,33 +293,33 @@ class it {
     });
   }
 }
-function nt(e) {
+function ct(e) {
   return /^latest$|^trunk$|^nightly$|^(?:(\d+)\.(\d+)(?:\.(\d+))?)((?:-beta(?:\d+)?)|(?:-RC(?:\d+)?))?$/.test(e);
 }
-async function at({
+async function pt({
   sourceString: e,
   blueprintMayReadAdjacentFiles: t
 }) {
   if (!e)
     return;
   if (e.startsWith("http://") || e.startsWith("https://"))
-    return await Pe(e);
-  let r = h.resolve(process.cwd(), e);
-  if (!p.existsSync(r))
+    return await xe(e);
+  let r = p.resolve(process.cwd(), e);
+  if (!c.existsSync(r))
     throw new Error(`Blueprint file does not exist: ${r}`);
-  const s = p.statSync(r);
-  if (s.isDirectory() && (r = h.join(r, "blueprint.json")), !s.isFile() && s.isSymbolicLink())
+  const s = c.statSync(r);
+  if (s.isDirectory() && (r = p.join(r, "blueprint.json")), !s.isFile() && s.isSymbolicLink())
     throw new Error(
       `Blueprint path is neither a file nor a directory: ${r}`
     );
-  const o = h.extname(r);
+  const o = p.extname(r);
   switch (o) {
     case ".zip":
-      return Ue.fromArrayBuffer(
-        p.readFileSync(r).buffer
+      return Oe.fromArrayBuffer(
+        c.readFileSync(r).buffer
       );
     case ".json": {
-      const i = p.readFileSync(r, "utf-8");
+      const i = c.readFileSync(r, "utf-8");
       try {
         JSON.parse(i);
       } catch {
@@ -254,8 +327,8 @@ async function at({
           `Blueprint file at ${r} is not a valid JSON file`
         );
       }
-      const n = h.dirname(r), l = new De(n);
-      return new Ae([
+      const n = p.dirname(r), l = new Ae(n);
+      return new Ue([
         new Fe({
           "blueprint.json": i
         }),
@@ -282,7 +355,7 @@ You can allow this Blueprint to read files from the same parent directory by exp
       );
   }
 }
-class lt {
+class mt {
   constructor(t, r) {
     this.args = t, this.siteUrl = r.siteUrl, this.processIdSpaceLength = r.processIdSpaceLength, this.phpVersion = t.php, this.cliOutput = r.cliOutput;
   }
@@ -290,7 +363,7 @@ class lt {
     return "v2";
   }
   async bootAndSetUpInitialPlayground(t, r, s) {
-    const o = F(t);
+    const o = U(t);
     await o.useFileLockManager(r);
     const i = {
       ...this.args,
@@ -301,6 +374,8 @@ class lt {
       trace: this.args.verbosity === "debug",
       blueprint: this.args.blueprint,
       withIntl: this.args.intl,
+      withRedis: this.args.redis,
+      withMemcached: this.args.memcached,
       // We do not enable Xdebug by default for the initial worker
       // because we do not imagine users expect to hit breakpoints
       // until Playground has fully booted.
@@ -309,7 +384,8 @@ class lt {
       xdebug: void 0,
       nativeInternalDirPath: s,
       mountsBeforeWpInstall: this.args["mount-before-install"] || [],
-      mountsAfterWpInstall: this.args.mount || []
+      mountsAfterWpInstall: this.args.mount || [],
+      constants: O(this.args)
     };
     return await o.bootAndSetUpInitialWorker(i), o;
   }
@@ -319,7 +395,7 @@ class lt {
     firstProcessId: s,
     nativeInternalDirPath: o
   }) {
-    const i = F(t.phpPort);
+    const i = U(t.phpPort);
     await i.useFileLockManager(r);
     const n = {
       ...this.args,
@@ -329,27 +405,30 @@ class lt {
       processIdSpaceLength: this.processIdSpaceLength,
       trace: this.args.verbosity === "debug",
       withIntl: this.args.intl,
+      withRedis: this.args.redis,
+      withMemcached: this.args.memcached,
       withXdebug: !!this.args.xdebug,
       nativeInternalDirPath: o,
       mountsBeforeWpInstall: this.args["mount-before-install"] || [],
-      mountsAfterWpInstall: this.args.mount || []
+      mountsAfterWpInstall: this.args.mount || [],
+      constants: O(this.args)
     };
     return await i.bootWorker(n), i;
   }
 }
-const Q = h.join(O.homedir(), ".wordpress-playground");
-async function ut(e) {
-  return await pe(
+const X = p.join(N.homedir(), ".wordpress-playground");
+async function ht(e) {
+  return await me(
     "https://github.com/WordPress/sqlite-database-integration/archive/refs/heads/develop.zip",
     "sqlite.zip",
     e
   );
 }
-async function pe(e, t, r) {
-  const s = h.join(Q, t);
-  return B.existsSync(s) || (B.ensureDirSync(Q), await dt(e, s, r)), ce(s);
+async function me(e, t, r) {
+  const s = p.join(X, t);
+  return B.existsSync(s) || (B.ensureDirSync(X), await ft(e, s, r)), he(s);
 }
-async function dt(e, t, r) {
+async function ft(e, t, r) {
   const o = (await r.monitorFetch(fetch(e))).body.getReader(), i = `${t}.partial`, n = B.createWriteStream(i);
   for (; ; ) {
     const { done: l, value: u } = await o.read();
@@ -359,15 +438,15 @@ async function dt(e, t, r) {
   n.close(), n.closed || await new Promise((l, u) => {
     n.on("finish", () => {
       B.renameSync(i, t), l(null);
-    }), n.on("error", (b) => {
-      B.removeSync(i), u(b);
+    }), n.on("error", (v) => {
+      B.removeSync(i), u(v);
     });
   });
 }
-function ce(e, t) {
+function he(e, t) {
   return new File([B.readFileSync(e)], A(e));
 }
-class pt {
+class wt {
   constructor(t, r) {
     this.args = t, this.siteUrl = r.siteUrl, this.processIdSpaceLength = r.processIdSpaceLength, this.cliOutput = r.cliOutput;
   }
@@ -376,62 +455,65 @@ class pt {
   }
   async bootAndSetUpInitialPlayground(t, r, s) {
     let o, i, n;
-    const l = new Oe();
+    const l = new Ne();
     if (this.args.wordpressInstallMode === "download-and-install") {
-      let E = !1;
-      l.addEventListener("progress", (k) => {
-        if (E)
+      let k = !1;
+      l.addEventListener("progress", (I) => {
+        if (k)
           return;
-        const { loaded: W, total: Z } = k.detail, C = Math.floor(
-          Math.min(100, 100 * W / Z)
+        const { loaded: C, total: J } = I.detail, L = Math.floor(
+          Math.min(100, 100 * C / J)
         );
-        E = C === 100, this.cliOutput.updateProgress(
+        k = L === 100, this.cliOutput.updateProgress(
           "Downloading WordPress",
-          C
+          L
         );
-      }), o = await Ve(this.args.wp), n = h.join(
-        Q,
+      }), o = await He(this.args.wp), n = p.join(
+        X,
         `prebuilt-wp-content-for-wp-${o.version}.zip`
-      ), i = p.existsSync(n) ? ce(n) : await pe(
+      ), i = c.existsSync(n) ? he(n) : await me(
         o.releaseUrl,
         `${o.version}.zip`,
         l
-      ), g.debug(
+      ), y.debug(
         `Resolved WordPress release URL: ${o?.releaseUrl}`
       );
     }
     let u;
-    this.args.skipSqliteSetup ? (g.debug("Skipping SQLite integration plugin setup..."), u = void 0) : (this.cliOutput.updateProgress("Preparing SQLite database"), u = await ut(l));
-    const b = this.args.followSymlinks === !0, v = this.args.experimentalTrace === !0, a = this.args["mount-before-install"] || [], f = this.args.mount || [], c = F(t);
-    await c.isConnected(), this.cliOutput.updateProgress("Booting WordPress");
-    const S = await re(
+    this.args.skipSqliteSetup ? (y.debug("Skipping SQLite integration plugin setup..."), u = void 0) : (this.cliOutput.updateProgress("Preparing SQLite database"), u = await ht(l));
+    const v = this.args.followSymlinks === !0, P = this.args.experimentalTrace === !0, w = this.args["mount-before-install"] || [], a = this.args.mount || [], g = U(t);
+    await g.isConnected(), this.cliOutput.updateProgress("Booting WordPress");
+    const h = await se(
       this.getEffectiveBlueprint()
     );
-    return await c.useFileLockManager(r), await c.bootAndSetUpInitialWorker({
-      phpVersion: S.phpVersion,
-      wpVersion: S.wpVersion,
+    return await g.useFileLockManager(r), await g.bootAndSetUpInitialWorker({
+      phpVersion: h.phpVersion,
+      wpVersion: h.wpVersion,
       siteUrl: this.siteUrl,
-      mountsBeforeWpInstall: a,
-      mountsAfterWpInstall: f,
+      mountsBeforeWpInstall: w,
+      mountsAfterWpInstall: a,
       wordpressInstallMode: this.args.wordpressInstallMode || "download-and-install",
       wordPressZip: i && await i.arrayBuffer(),
       sqliteIntegrationPluginZip: await u?.arrayBuffer(),
       firstProcessId: 0,
       processIdSpaceLength: this.processIdSpaceLength,
-      followSymlinks: b,
-      trace: v,
+      followSymlinks: v,
+      trace: P,
       internalCookieStore: this.args.internalCookieStore,
       withIntl: this.args.intl,
+      withRedis: this.args.redis,
+      withMemcached: this.args.memcached,
       // We do not enable Xdebug by default for the initial worker
       // because we do not imagine users expect to hit breakpoints
       // until Playground has fully booted.
       // TODO: Consider supporting Xdebug for the initial worker via a dedicated flag.
       withXdebug: !1,
-      nativeInternalDirPath: s
-    }), n && !this.args["mount-before-install"] && !p.existsSync(n) && (this.cliOutput.updateProgress("Caching WordPress for next boot"), p.writeFileSync(
+      nativeInternalDirPath: s,
+      constants: O(this.args)
+    }), n && !this.args["mount-before-install"] && !c.existsSync(n) && (this.cliOutput.updateProgress("Caching WordPress for next boot"), c.writeFileSync(
       n,
-      await Ie(c, "/wordpress")
-    )), c;
+      await Ee(g, "/wordpress")
+    )), g;
   }
   async bootPlayground({
     worker: t,
@@ -439,11 +521,11 @@ class pt {
     firstProcessId: s,
     nativeInternalDirPath: o
   }) {
-    const i = F(
+    const i = U(
       t.phpPort
     );
     await i.isConnected();
-    const n = await re(
+    const n = await se(
       this.getEffectiveBlueprint()
     );
     return await i.useFileLockManager(r), await i.bootWorker({
@@ -459,12 +541,15 @@ class pt {
       //        will have a separate cookie store.
       internalCookieStore: this.args.internalCookieStore,
       withIntl: this.args.intl,
+      withRedis: this.args.redis,
+      withMemcached: this.args.memcached,
       withXdebug: !!this.args.xdebug,
-      nativeInternalDirPath: o
+      nativeInternalDirPath: o,
+      constants: O(this.args)
     }), await i.isReady(), i;
   }
   async compileInputBlueprint(t) {
-    const r = this.getEffectiveBlueprint(), s = new He();
+    const r = this.getEffectiveBlueprint(), s = new _e();
     let o = "", i = !1;
     return s.addEventListener("progress", (n) => {
       if (i)
@@ -472,26 +557,26 @@ class pt {
       i = n.detail.progress === 100;
       const l = Math.floor(n.detail.progress);
       o = n.detail.caption || o || "Running Blueprint", this.cliOutput.updateProgress(o.trim(), l);
-    }), await Se(r, {
+    }), await ke(r, {
       progress: s,
       additionalSteps: t
     });
   }
   getEffectiveBlueprint() {
     const t = this.args.blueprint;
-    return xe(t) ? t : {
+    return Ie(t) ? t : {
       login: this.args.login,
       ...t || {},
       preferredVersions: {
-        php: this.args.php ?? t?.preferredVersions?.php ?? U,
+        php: this.args.php ?? t?.preferredVersions?.php ?? F,
         wp: this.args.wp ?? t?.preferredVersions?.wp ?? "latest",
         ...t?.preferredVersions || {}
       }
     };
   }
 }
-async function ct(e, t = !0) {
-  const s = `${h.basename(process.argv0)}${e}${process.pid}-`, o = await _e({
+async function gt(e, t = !0) {
+  const s = `${p.basename(process.argv0)}${e}${process.pid}-`, o = await qe({
     prefix: s,
     /*
      * Allow recursive cleanup on process exit.
@@ -503,20 +588,20 @@ async function ct(e, t = !0) {
      */
     unsafeCleanup: !0
   });
-  return t && qe(), o;
+  return t && Ye(), o;
 }
-async function ht(e, t, r) {
-  const o = (await mt(
+async function yt(e, t, r) {
+  const o = (await bt(
     e,
     t,
     r
   )).map(
     (i) => new Promise((n) => {
-      p.rm(i, { recursive: !0 }, (l) => {
-        l ? g.warn(
+      c.rm(i, { recursive: !0 }, (l) => {
+        l ? y.warn(
           `Failed to delete stale Playground temp dir: ${i}`,
           l
-        ) : g.info(
+        ) : y.info(
           `Deleted stale Playground temp dir: ${i}`
         ), n();
       });
@@ -524,24 +609,24 @@ async function ht(e, t, r) {
   );
   await Promise.all(o);
 }
-async function mt(e, t, r) {
+async function bt(e, t, r) {
   try {
-    const s = p.readdirSync(r).map((i) => h.join(r, i)), o = [];
+    const s = c.readdirSync(r).map((i) => p.join(r, i)), o = [];
     for (const i of s)
-      await ft(
+      await vt(
         e,
         t,
         i
       ) && o.push(i);
     return o;
   } catch (s) {
-    return g.warn(`Failed to find stale Playground temp dirs: ${s}`), [];
+    return y.warn(`Failed to find stale Playground temp dirs: ${s}`), [];
   }
 }
-async function ft(e, t, r) {
-  if (!p.lstatSync(r).isDirectory())
+async function vt(e, t, r) {
+  if (!c.lstatSync(r).isDirectory())
     return !1;
-  const o = h.basename(r);
+  const o = p.basename(r);
   if (!o.includes(e))
     return !1;
   const i = o.match(
@@ -553,15 +638,15 @@ async function ft(e, t, r) {
     executableName: i[1],
     pid: i[2]
   };
-  if (await wt(n.pid, n.executableName))
+  if (await Pt(n.pid, n.executableName))
     return !1;
   const l = Date.now() - t;
-  return p.statSync(r).mtime.getTime() < l;
+  return c.statSync(r).mtime.getTime() < l;
 }
-async function wt(e, t) {
+async function Pt(e, t) {
   const [r] = await new Promise(
     (s, o) => {
-      Ye.list(
+      ze.list(
         {
           pid: e,
           name: t,
@@ -576,10 +661,10 @@ async function wt(e, t) {
   );
   return !!r && r.pid === e && r.command === t;
 }
-function gt(e) {
+function St(e) {
   return process.env.CI === "true" || process.env.CI === "1" || process.env.GITHUB_ACTIONS === "true" || process.env.GITHUB_ACTIONS === "1" || (process.env.TERM || "").toLowerCase() === "dumb" ? !1 : e ? !!e.isTTY : process.stdout.isTTY;
 }
-class yt {
+class xt {
   constructor(t) {
     this.lastProgressLine = "", this.progressActive = !1, this.verbosity = t.verbosity, this.writeStream = t.writeStream || process.stdout;
   }
@@ -593,7 +678,7 @@ class yt {
    * This prevents progress spam in logs - users only see the final outcome.
    */
   get shouldRender() {
-    return gt(this.writeStream);
+    return St(this.writeStream);
   }
   get isQuiet() {
     return this.verbosity === "quiet";
@@ -645,7 +730,7 @@ ${t}
       `${this.dim("PHP")} ${this.cyan(t.phpVersion)}  ${this.dim("WordPress")} ${this.cyan(t.wpVersion)}`
     );
     const s = [];
-    if (t.intl && s.push("intl"), t.xdebug && s.push(this.yellow("xdebug")), s.length > 0 && r.push(`${this.dim("Extensions")} ${s.join(", ")}`), t.mounts.length > 0)
+    if (t.intl && s.push("intl"), t.redis && s.push("redis"), t.memcached && s.push("memcached"), t.xdebug && s.push(this.yellow("xdebug")), s.length > 0 && r.push(`${this.dim("Extensions")} ${s.join(", ")}`), t.mounts.length > 0)
       for (const o of t.mounts) {
         const i = o.autoMounted ? ` ${this.dim("(auto-mount)")}` : "";
         r.push(
@@ -732,12 +817,12 @@ ${this.green("Ready!")} WordPress is running on ${this.bold(t)} ${this.dim(`(${r
 `);
   }
 }
-const he = {
+const fe = {
   Quiet: { name: "quiet", severity: j.Fatal },
   Normal: { name: "normal", severity: j.Info },
   Debug: { name: "debug", severity: j.Debug }
 };
-async function Jt(e) {
+async function or(e) {
   try {
     const t = {
       "site-url": {
@@ -747,41 +832,62 @@ async function Jt(e) {
       php: {
         describe: "PHP version to use.",
         type: "string",
-        default: U,
-        choices: te
+        default: F,
+        choices: oe
       },
       wp: {
         describe: "WordPress version to use.",
         type: "string",
         default: "latest"
       },
+      define: {
+        describe: 'Define PHP string constants (can be used multiple times). Format: NAME value. These constants are set via php.defineConstant() and only exist for the current request. Examples: --define API_KEY secret --define CON=ST "va=lu=e"',
+        type: "string",
+        nargs: 2,
+        array: !0,
+        coerce: ot
+      },
+      "define-bool": {
+        describe: 'Define PHP boolean constants (can be used multiple times). Format: NAME value. Value must be "true", "false", "1", or "0". Examples: --define-bool WP_DEBUG true --define-bool MY_FEATURE false',
+        type: "string",
+        nargs: 2,
+        array: !0,
+        coerce: st
+      },
+      "define-number": {
+        describe: "Define PHP number constants (can be used multiple times). Format: NAME value. Examples: --define-number LIMIT 100 --define-number RATE 45.67",
+        type: "string",
+        nargs: 2,
+        array: !0,
+        coerce: it
+      },
       // @TODO: Support read-only mounts, e.g. via WORKERFS, a custom
       // ReadOnlyNODEFS, or by copying the files into MEMFS
       mount: {
         describe: "Mount a directory to the PHP runtime (can be used multiple times). Format: /host/path:/vfs/path",
         type: "array",
         string: !0,
-        coerce: _
+        coerce: q
       },
       "mount-before-install": {
         describe: "Mount a directory to the PHP runtime before WordPress installation (can be used multiple times). Format: /host/path:/vfs/path",
         type: "array",
         string: !0,
-        coerce: _
+        coerce: q
       },
       "mount-dir": {
         describe: 'Mount a directory to the PHP runtime (can be used multiple times). Format: "/host/path" "/vfs/path"',
         type: "array",
         nargs: 2,
         array: !0,
-        coerce: se
+        coerce: ne
       },
       "mount-dir-before-install": {
         describe: 'Mount a directory before WordPress installation (can be used multiple times). Format: "/host/path" "/vfs/path"',
         type: "string",
         nargs: 2,
         array: !0,
-        coerce: se
+        coerce: ne
       },
       login: {
         describe: "Should log the user in",
@@ -828,7 +934,7 @@ async function Jt(e) {
       verbosity: {
         describe: "Output logs and progress messages.",
         type: "string",
-        choices: Object.values(he).map(
+        choices: Object.values(fe).map(
           (a) => a.name
         ),
         default: "normal"
@@ -867,6 +973,16 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         type: "boolean",
         default: !0
       },
+      redis: {
+        describe: "Enable Redis (requires JSPI support).",
+        type: "boolean"
+        // No default - will be determined at runtime based on JSPI availability
+      },
+      memcached: {
+        describe: "Enable Memcached.",
+        type: "boolean"
+        // No default - will be determined at runtime based on JSPI availability
+      },
       xdebug: {
         describe: "Enable Xdebug.",
         type: "boolean",
@@ -904,7 +1020,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
       "experimental-multi-worker": {
         describe: "Enable experimental multi-worker support which requires a /wordpress directory backed by a real filesystem. Pass a positive number to specify the number of workers to use. Otherwise, default to the number of CPUs minus 1.",
         type: "number",
-        coerce: (a) => a ?? Ce().length - 1
+        coerce: (a) => a ?? De().length - 1
       },
       "experimental-devtools": {
         describe: "Enable experimental browser development tools.",
@@ -919,8 +1035,8 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
       php: {
         describe: "PHP version to use.",
         type: "string",
-        default: U,
-        choices: te
+        default: F,
+        choices: oe
       },
       wp: {
         describe: "WordPress version to use.",
@@ -966,7 +1082,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         describe: "Mount a directory to the PHP runtime (can be used multiple times). Format: /host/path:/vfs/path. Use this for additional mounts beyond auto-detection.",
         type: "array",
         string: !0,
-        coerce: _
+        coerce: q
       },
       reset: {
         describe: "Deletes the stored site directory and starts a new site from scratch.",
@@ -977,7 +1093,11 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         describe: "Disable automatic project type detection. Use --mount to manually specify mounts instead.",
         type: "boolean",
         default: !1
-      }
+      },
+      // Define constants
+      define: t.define,
+      "define-bool": t["define-bool"],
+      "define-number": t["define-number"]
     }, o = {
       outfile: {
         describe: "When building, write to this output file.",
@@ -1022,13 +1142,13 @@ Examples:
     ).demandCommand(1, "Please specify a command").strictCommands().conflicts(
       "experimental-unsafe-ide-integration",
       "experimental-devtools"
-    ).showHelpOnFail(!1).fail((a, f, c) => {
-      if (f)
-        throw f;
-      a && a.includes("Please specify a command") && (c.showHelp(), console.error(`
+    ).showHelpOnFail(!1).fail((a, g, h) => {
+      if (g)
+        throw g;
+      a && a.includes("Please specify a command") && (h.showHelp(), console.error(`
 ` + a), process.exit(1)), console.error(a), process.exit(1);
     }).strictOptions().check(async (a) => {
-      if (a["skip-wordpress-install"] === !0 && (a["wordpress-install-mode"] = "do-not-attempt-installing", a.wordpressInstallMode = "do-not-attempt-installing"), a.wp !== void 0 && typeof a.wp == "string" && !nt(a.wp))
+      if (a["skip-wordpress-install"] === !0 && (a["wordpress-install-mode"] = "do-not-attempt-installing", a.wordpressInstallMode = "do-not-attempt-installing"), a.wp !== void 0 && typeof a.wp == "string" && !ct(a.wp))
         try {
           new URL(a.wp);
         } catch {
@@ -1036,25 +1156,25 @@ Examples:
             'Unrecognized WordPress version. Please use "latest", a URL, or a numeric version such as "6.2", "6.0.1", "6.2-beta1", or "6.2-RC1"'
           );
         }
-      const f = a["site-url"];
-      if (typeof f == "string" && f.trim() !== "")
+      const g = a["site-url"];
+      if (typeof g == "string" && g.trim() !== "")
         try {
-          new URL(f);
+          new URL(g);
         } catch {
           throw new Error(
-            `Invalid site-url "${f}". Please provide a valid URL (e.g., http://localhost:8080 or https://example.com)`
+            `Invalid site-url "${g}". Please provide a valid URL (e.g., http://localhost:8080 or https://example.com)`
           );
         }
       if (a["auto-mount"]) {
-        let c = !1;
+        let h = !1;
         try {
-          c = p.statSync(
+          h = c.statSync(
             a["auto-mount"]
           ).isDirectory();
         } catch {
-          c = !1;
+          h = !1;
         }
-        if (!c)
+        if (!h)
           throw new Error(
             `The specified --auto-mount path is not a directory: '${a["auto-mount"]}'.`
           );
@@ -1085,8 +1205,8 @@ Examples:
             );
         } else
           a["wordpress-install-mode"] === "do-not-attempt-installing" ? a.mode = "apply-to-existing-site" : a.mode = "create-new-site";
-        const c = a.allow || [];
-        a.followSymlinks === !0 && c.push("follow-symlinks"), a["blueprint-may-read-adjacent-files"] === !0 && c.push("read-local-fs"), a.allow = c;
+        const h = a.allow || [];
+        a.followSymlinks === !0 && h.push("follow-symlinks"), a["blueprint-may-read-adjacent-files"] === !0 && h.push("read-local-fs"), a.allow = h;
       } else if (a.mode !== void 0)
         throw new Error(
           "The --mode option requires the --experimentalBlueprintsV2Runner flag."
@@ -1098,8 +1218,11 @@ Examples:
     ["start", "run-blueprint", "server", "build-snapshot"].includes(
       l
     ) || (i.showHelp(), process.exit(1));
-    const u = {
+    const u = n.define || {};
+    !("WP_DEBUG" in u) && !("WP_DEBUG_LOG" in u) && !("WP_DEBUG_DISPLAY" in u) && (u.WP_DEBUG = "true", u.WP_DEBUG_LOG = "true", u.WP_DEBUG_DISPLAY = "true");
+    const v = {
       ...n,
+      define: u,
       command: l,
       mount: [
         ...n.mount || [],
@@ -1109,20 +1232,20 @@ Examples:
         ...n["mount-before-install"] || [],
         ...n["mount-dir-before-install"] || []
       ]
-    }, b = await St(u);
-    b === void 0 && process.exit(0);
-    const v = /* @__PURE__ */ (() => {
+    }, P = await Et(v);
+    P === void 0 && process.exit(0);
+    const w = /* @__PURE__ */ (() => {
       let a;
       return async () => {
-        a !== void 0 && (a = b[Symbol.asyncDispose]()), await a, process.exit(0);
+        a !== void 0 && (a = P[Symbol.asyncDispose]()), await a, process.exit(0);
       };
     })();
-    process.on("SIGINT", v), process.on("SIGTERM", v);
+    process.on("SIGINT", w), process.on("SIGTERM", w);
   } catch (t) {
     if (console.error(t), !(t instanceof Error))
       throw t;
     if (process.argv.includes("--debug"))
-      ye(t);
+      ve(t);
     else {
       const s = [];
       let o = t;
@@ -1136,73 +1259,75 @@ Examples:
     process.exit(1);
   }
 }
-function ne(e, t) {
+function le(e, t) {
   return e.find(
     (r) => r.vfsPath.replace(/\/$/, "") === t.replace(/\/$/, "")
   );
 }
-const bt = Symbol("playground-cli-testing"), T = (e) => process.stdout.isTTY ? "\x1B[1m" + e + "\x1B[0m" : e, vt = (e) => process.stdout.isTTY ? "\x1B[31m" + e + "\x1B[0m" : e, Pt = (e) => process.stdout.isTTY ? `\x1B[2m${e}\x1B[0m` : e, q = (e) => process.stdout.isTTY ? `\x1B[3m${e}\x1B[0m` : e, ae = (e) => process.stdout.isTTY ? `\x1B[33m${e}\x1B[0m` : e;
-async function St(e) {
+const kt = Symbol("playground-cli-testing"), T = (e) => process.stdout.isTTY ? "\x1B[1m" + e + "\x1B[0m" : e, It = (e) => process.stdout.isTTY ? "\x1B[31m" + e + "\x1B[0m" : e, $t = (e) => process.stdout.isTTY ? `\x1B[2m${e}\x1B[0m` : e, Y = (e) => process.stdout.isTTY ? `\x1B[3m${e}\x1B[0m` : e, ue = (e) => process.stdout.isTTY ? `\x1B[33m${e}\x1B[0m` : e;
+async function Et(e) {
   let t, r;
   const s = /* @__PURE__ */ new Map();
-  if (e.command === "start" && (e = xt(e)), e.autoMount !== void 0 && (e.autoMount === "" && (e = { ...e, autoMount: process.cwd() }), e = de(e)), e.wordpressInstallMode === void 0 && (e.wordpressInstallMode = "download-and-install"), e.quiet && (e.verbosity = "quiet", delete e.quiet), e.debug && (e.verbosity = "debug", delete e.debug), e.verbosity) {
-    const a = Object.values(he).find(
-      (f) => f.name === e.verbosity
+  if (e.command === "start" && (e = Tt(e)), e.autoMount !== void 0 && (e.autoMount === "" && (e = { ...e, autoMount: process.cwd() }), e = pe(e)), e.wordpressInstallMode === void 0 && (e.wordpressInstallMode = "download-and-install"), e.quiet && (e.verbosity = "quiet", delete e.quiet), e.debug && (e.verbosity = "debug", delete e.debug), e.verbosity) {
+    const w = Object.values(fe).find(
+      (a) => a.name === e.verbosity
     ).severity;
-    g.setSeverityFilterLevel(a);
+    y.setSeverityFilterLevel(w);
   }
-  e.intl || (e.intl = !0);
-  const o = new yt({
+  e.intl || (e.intl = !0), e.redis === void 0 && (e.redis = await Q()), e.memcached === void 0 && (e.memcached = await Q());
+  const o = new xt({
     verbosity: e.verbosity || "normal"
   });
   e.command === "server" && (o.printBanner(), o.printConfig({
-    phpVersion: e.php || U,
+    phpVersion: e.php || F,
     wpVersion: e.wp || "latest",
     port: e.port || 9400,
     xdebug: !!e.xdebug,
     intl: !!e.intl,
+    redis: !!e.redis,
+    memcached: !!e.memcached,
     mounts: [
       ...e.mount || [],
       ...e["mount-before-install"] || []
     ],
     blueprint: typeof e.blueprint == "string" ? e.blueprint : void 0
   }));
-  const i = e.command === "server" ? e.port ?? 9400 : 0, n = O.platform() === "win32" ? (
+  const i = e.command === "server" ? e.port ?? 9400 : 0, n = N.platform() === "win32" ? (
     // @TODO: Enable fs-ext here when it works with Windows.
     void 0
-  ) : await import("fs-ext").then((a) => a.flockSync).catch(() => {
-    g.debug(
+  ) : await import("fs-ext").then((w) => w.flockSync).catch(() => {
+    y.debug(
       "The fs-ext package is not installed. Internal file locking will not be integrated with host OS file locking."
     );
   }), l = new Le(n);
-  let u = !1, b = !0;
-  const v = await rt({
+  let u = !1, v = !0;
+  const P = await at({
     port: i,
-    onBind: async (a, f) => {
-      const c = "127.0.0.1", S = `http://${c}:${f}`, E = e["site-url"] || S, k = e.command === "server" ? e.experimentalMultiWorker ?? 1 : 1, W = e.command === "server" ? (
+    onBind: async (w, a) => {
+      const g = "127.0.0.1", h = `http://${g}:${a}`, k = e["site-url"] || h, I = e.command === "server" ? e.experimentalMultiWorker ?? 1 : 1, C = e.command === "server" ? (
         // Account for the initial worker which is discarded by the server after setup.
-        k + 1
-      ) : k, C = 2 ** 31 - 1, L = Math.floor(
-        C / W
-      ), G = "-playground-cli-site-", I = await ct(G);
-      g.debug(`Native temp dir for VFS root: ${I.path}`);
-      const M = "WP Playground CLI - Listen for Xdebug", J = ".playground-xdebug-root", K = h.join(process.cwd(), J);
-      if (await ze(K), e.xdebug && e.experimentalUnsafeIdeIntegration) {
+        I + 1
+      ) : I, L = 2 ** 31 - 1, M = Math.floor(
+        L / C
+      ), K = "-playground-cli-site-", $ = await gt(K);
+      y.debug(`Native temp dir for VFS root: ${$.path}`);
+      const W = "WP Playground CLI - Listen for Xdebug", ee = ".playground-xdebug-root", te = p.join(process.cwd(), ee);
+      if (await Ge(te), e.xdebug && e.experimentalUnsafeIdeIntegration) {
         await Qe(
-          I.path,
-          K,
+          $.path,
+          te,
           process.platform
         );
         const d = {
-          hostPath: h.join(".", h.sep, J),
+          hostPath: p.join(".", p.sep, ee),
           vfsPath: "/"
         };
         try {
-          await Xe(M, process.cwd());
-          const w = typeof e.xdebug == "object" ? e.xdebug : void 0, P = await Ze({
-            name: M,
-            host: c,
-            port: f,
+          await Xe(W, process.cwd());
+          const f = typeof e.xdebug == "object" ? e.xdebug : void 0, S = await Ze({
+            name: W,
+            host: g,
+            port: a,
             ides: e.experimentalUnsafeIdeIntegration,
             cwd: process.cwd(),
             mounts: [
@@ -1210,19 +1335,19 @@ async function St(e) {
               ...e["mount-before-install"] || [],
               ...e.mount || []
             ],
-            ideKey: w?.ideKey
-          }), m = e.experimentalUnsafeIdeIntegration, y = m.includes("vscode"), x = m.includes("phpstorm"), D = Object.values(P);
-          console.log(""), D.length > 0 ? (console.log(T("Xdebug configured successfully")), console.log(
-            ae("Updated IDE config: ") + D.join(" ")
+            ideKey: f?.ideKey
+          }), m = e.experimentalUnsafeIdeIntegration, b = m.includes("vscode"), x = m.includes("phpstorm"), R = Object.values(S);
+          console.log(""), R.length > 0 ? (console.log(T("Xdebug configured successfully")), console.log(
+            ue("Updated IDE config: ") + R.join(" ")
           ), console.log(
-            ae("Playground source root: ") + ".playground-xdebug-root" + q(
-              Pt(
+            ue("Playground source root: ") + ".playground-xdebug-root" + Y(
+              $t(
                 " – you can set breakpoints and preview Playground's VFS structure in there."
               )
             )
           )) : (console.log(T("Xdebug configuration failed.")), console.log(
             "No IDE-specific project settings directory was found in the current working directory."
-          )), console.log(""), y && P.vscode && (console.log(T("VS Code / Cursor instructions:")), console.log(
+          )), console.log(""), b && S.vscode && (console.log(T("VS Code / Cursor instructions:")), console.log(
             "  1. Ensure you have installed an IDE extension for PHP Debugging"
           ), console.log(
             `     (The ${T("PHP Debug")} extension by ${T(
@@ -1231,37 +1356,37 @@ async function St(e) {
           ), console.log(
             "  2. Open the Run and Debug panel on the left sidebar"
           ), console.log(
-            `  3. Select "${q(
-              M
+            `  3. Select "${Y(
+              W
             )}" from the dropdown`
           ), console.log('  3. Click "start debugging"'), console.log(
             "  5. Set a breakpoint. For example, in .playground-xdebug-root/wordpress/index.php"
           ), console.log(
             "  6. Visit Playground in your browser to hit the breakpoint"
-          ), x && console.log("")), x && P.phpstorm && (console.log(T("PhpStorm instructions:")), console.log(
-            `  1. Choose "${q(
-              M
+          ), x && console.log("")), x && S.phpstorm && (console.log(T("PhpStorm instructions:")), console.log(
+            `  1. Choose "${Y(
+              W
             )}" debug configuration in the toolbar`
           ), console.log("  2. Click the debug button (bug icon)`"), console.log(
             "  3. Set a breakpoint. For example, in .playground-xdebug-root/wordpress/index.php"
           ), console.log(
             "  4. Visit Playground in your browser to hit the breakpoint"
           )), console.log("");
-        } catch (w) {
+        } catch (f) {
           throw new Error("Could not configure Xdebug", {
-            cause: w
+            cause: f
           });
         }
       }
-      const me = h.dirname(I.path), fe = 2 * 24 * 60 * 60 * 1e3;
-      ht(
-        G,
-        fe,
-        me
+      const we = p.dirname($.path), ge = 2 * 24 * 60 * 60 * 1e3;
+      yt(
+        K,
+        ge,
+        we
       );
-      const H = h.join(I.path, "internal");
-      z(H);
-      const we = [
+      const _ = p.join($.path, "internal");
+      G(_);
+      const ye = [
         "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
@@ -1272,14 +1397,14 @@ async function St(e) {
         "tmp",
         "home"
       ];
-      for (const d of we) {
-        const w = (m) => m.vfsPath === `/${d}`;
-        if (!(e["mount-before-install"]?.some(w) || e.mount?.some(w))) {
-          const m = h.join(
-            I.path,
+      for (const d of ye) {
+        const f = (m) => m.vfsPath === `/${d}`;
+        if (!(e["mount-before-install"]?.some(f) || e.mount?.some(f))) {
+          const m = p.join(
+            $.path,
             d
           );
-          z(m), e["mount-before-install"] === void 0 && (e["mount-before-install"] = []), e["mount-before-install"].unshift({
+          G(m), e["mount-before-install"] === void 0 && (e["mount-before-install"] = []), e["mount-before-install"].unshift({
             vfsPath: `/${d}`,
             hostPath: m
           });
@@ -1287,144 +1412,144 @@ async function St(e) {
       }
       if (e["mount-before-install"])
         for (const d of e["mount-before-install"])
-          g.debug(
+          y.debug(
             `Mount before WP install: ${d.vfsPath} -> ${d.hostPath}`
           );
       if (e.mount)
         for (const d of e.mount)
-          g.debug(
+          y.debug(
             `Mount after WP install: ${d.vfsPath} -> ${d.hostPath}`
           );
-      let $;
-      e["experimental-blueprints-v2-runner"] ? $ = new lt(e, {
-        siteUrl: E,
-        processIdSpaceLength: L,
+      let E;
+      e["experimental-blueprints-v2-runner"] ? E = new mt(e, {
+        siteUrl: k,
+        processIdSpaceLength: M,
         cliOutput: o
-      }) : ($ = new pt(e, {
-        siteUrl: E,
-        processIdSpaceLength: L,
+      }) : (E = new wt(e, {
+        siteUrl: k,
+        processIdSpaceLength: M,
         cliOutput: o
-      }), typeof e.blueprint == "string" && (e.blueprint = await at({
+      }), typeof e.blueprint == "string" && (e.blueprint = await pt({
         sourceString: e.blueprint,
         blueprintMayReadAdjacentFiles: e["blueprint-may-read-adjacent-files"] === !0
       })));
-      let V = !1;
-      const R = async function() {
-        V || (V = !0, await Promise.all(
+      let H = !1;
+      const D = async function() {
+        H || (H = !0, await Promise.all(
           [...s].map(
-            async ([w, P]) => {
-              await P.dispose(), await w.terminate();
+            async ([f, S]) => {
+              await S.dispose(), await f.terminate();
             }
           )
-        ), a && await new Promise((w) => a.close(w)), await I.cleanup());
-      }, ge = kt(
-        W,
-        $.getWorkerType(),
-        ({ exitCode: d, workerIndex: w }) => {
-          V || d === 0 && g.error(
-            `Worker ${w} exited with code ${d}
+        ), w && await new Promise((f) => w.close(f)), await $.cleanup());
+      }, be = Bt(
+        C,
+        E.getWorkerType(),
+        ({ exitCode: d, workerIndex: f }) => {
+          H || d === 0 && y.error(
+            `Worker ${f} exited with code ${d}
 `
           );
         }
       );
       o.startProgress("Starting...");
       try {
-        const d = await ge, w = await le(l);
+        const d = await be, f = await de(l);
         {
-          const m = d.shift(), y = await $.bootAndSetUpInitialPlayground(
+          const m = d.shift(), b = await E.bootAndSetUpInitialPlayground(
             m.phpPort,
-            w,
-            H
+            f,
+            _
           );
           if (s.set(
             m.worker,
-            y
-          ), await y.isReady(), u = !0, t = new it(y), !e["experimental-blueprints-v2-runner"]) {
-            const x = await $.compileInputBlueprint(
+            b
+          ), await b.isReady(), u = !0, t = new dt(b), !e["experimental-blueprints-v2-runner"]) {
+            const x = await E.compileInputBlueprint(
               e["additional-blueprint-steps"] || []
             );
-            x && await ke(
+            x && await $e(
               x,
-              y
+              b
             );
           }
           if (e.command === "build-snapshot") {
-            await Tt(r, e.outfile), o.printStatus(`Exported to ${e.outfile}`), await R();
+            await Lt(r, e.outfile), o.printStatus(`Exported to ${e.outfile}`), await D();
             return;
           } else if (e.command === "run-blueprint") {
-            o.finishProgress("Done"), await R();
+            o.finishProgress("Done"), await D();
             return;
           }
-          await t.removeWorker(y), await y.dispose(), await m.worker.terminate(), s.delete(m.worker);
+          await t.removeWorker(b), await b.dispose(), await m.worker.terminate(), s.delete(m.worker);
         }
-        const P = L;
+        const S = M;
         return [r] = await Promise.all(
-          d.map(async (m, y) => {
-            const x = P + y * L, D = await le(l), N = await $.bootPlayground({
+          d.map(async (m, b) => {
+            const x = S + b * M, R = await de(l), V = await E.bootPlayground({
               worker: m,
-              fileLockManagerPort: D,
+              fileLockManagerPort: R,
               firstProcessId: x,
-              nativeInternalDirPath: H
+              nativeInternalDirPath: _
             });
             return s.set(
               m.worker,
-              N
-            ), t.addWorker(N), N;
+              V
+            ), t.addWorker(V), V;
           })
-        ), o.finishProgress(), o.printReady(S, k), e.xdebug && e.experimentalDevtools && (await Ne({
+        ), o.finishProgress(), o.printReady(h, I), e.xdebug && e.experimentalDevtools && (await Ve({
           phpInstance: r,
           phpRoot: "/wordpress"
         })).start(), {
           playground: r,
-          server: a,
-          serverUrl: S,
-          [Symbol.asyncDispose]: R,
-          [bt]: {
-            workerThreadCount: k,
-            getWorkerNumberFromProcessId: (m) => Math.floor(m / L)
+          server: w,
+          serverUrl: h,
+          [Symbol.asyncDispose]: D,
+          [kt]: {
+            workerThreadCount: I,
+            getWorkerNumberFromProcessId: (m) => Math.floor(m / M)
           }
         };
       } catch (d) {
         if (e.verbosity !== "debug")
           throw d;
-        let w = "";
-        throw await r?.fileExists(ee) && (w = await r.readFileAsText(ee)), await R(), new Error(w, { cause: d });
+        let f = "";
+        throw await r?.fileExists(re) && (f = await r.readFileAsText(re)), await D(), new Error(f, { cause: d });
       }
     },
-    async handleRequest(a) {
+    async handleRequest(w) {
       if (!u)
-        return Y.forHttpCode(
+        return z.forHttpCode(
           502,
           "WordPress is not ready yet"
         );
-      if (b) {
-        b = !1;
-        const f = {
+      if (v) {
+        v = !1;
+        const a = {
           "Content-Type": ["text/plain"],
           "Content-Length": ["0"],
-          Location: [a.url]
+          Location: [w.url]
         };
-        return a.headers?.cookie?.includes(
+        return w.headers?.cookie?.includes(
           "playground_auto_login_already_happened"
-        ) && (f["Set-Cookie"] = [
+        ) && (a["Set-Cookie"] = [
           "playground_auto_login_already_happened=1; Max-Age=0; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Path=/"
-        ]), new Y(302, f, new Uint8Array());
+        ]), new z(302, a, new Uint8Array());
       }
-      return await t.handleRequest(a);
+      return await t.handleRequest(w);
     }
   });
-  return v && e.command === "start" && !e.skipBrowser && $t(v.serverUrl), v;
+  return P && e.command === "start" && !e.skipBrowser && Ct(P.serverUrl), P;
 }
-function xt(e) {
+function Tt(e) {
   let t = { ...e, command: "server" };
-  e.noAutoMount || (t.autoMount = h.resolve(process.cwd(), t.path ?? ""), t = de(t), delete t.autoMount);
-  const r = ne(
+  e.noAutoMount || (t.autoMount = p.resolve(process.cwd(), t.path ?? ""), t = pe(t), delete t.autoMount);
+  const r = le(
     t["mount-before-install"] || [],
     "/wordpress"
-  ) || ne(t.mount || [], "/wordpress");
+  ) || le(t.mount || [], "/wordpress");
   if (r)
     console.log("Site files stored at:", r?.hostPath), e.reset && (console.log(""), console.log(
-      vt(
+      It(
         "This site is not managed by Playground CLI and cannot be reset."
       )
     ), console.log(
@@ -1433,15 +1558,15 @@ function xt(e) {
       "You may still remove the site's directory manually if you wish."
     ), process.exit(1));
   else {
-    const s = t.autoMount || process.cwd(), o = Ge("sha256").update(s).digest("hex"), i = O.homedir(), n = h.join(
+    const s = t.autoMount || process.cwd(), o = Je("sha256").update(s).digest("hex"), i = N.homedir(), n = p.join(
       i,
       ".wordpress-playground/sites",
       o
     );
-    console.log("Site files stored at:", n), X(n) && e.reset && (console.log("Resetting site..."), $e(n, { recursive: !0 })), z(n, { recursive: !0 }), t["mount-before-install"] = [
+    console.log("Site files stored at:", n), Z(n) && e.reset && (console.log("Resetting site..."), Te(n, { recursive: !0 })), G(n, { recursive: !0 }), t["mount-before-install"] = [
       ...t["mount-before-install"] || [],
       { vfsPath: "/wordpress", hostPath: n }
-    ], t.wordpressInstallMode = Te(n).length === 0 ? (
+    ], t.wordpressInstallMode = Be(n).length === 0 ? (
       // Only download WordPress on the first run when the site directory is still
       // empty.
       "download-and-install"
@@ -1452,10 +1577,10 @@ function xt(e) {
   }
   return t;
 }
-async function kt(e, t, r) {
+async function Bt(e, t, r) {
   const s = [];
   for (let o = 0; o < e; o++) {
-    const n = It(t, { onExit: (l) => {
+    const n = Mt(t, { onExit: (l) => {
       r({
         exitCode: l,
         workerIndex: o
@@ -1465,9 +1590,9 @@ async function kt(e, t, r) {
   }
   return Promise.all(s);
 }
-function It(e, { onExit: t } = {}) {
+function Mt(e, { onExit: t } = {}) {
   let r;
-  return e === "v1" ? r = new oe(new URL("./worker-thread-v1.js", import.meta.url)) : r = new oe(new URL("./worker-thread-v2.js", import.meta.url)), new Promise((s, o) => {
+  return e === "v1" ? r = new ie(new URL("./worker-thread-v1.js", import.meta.url)) : r = new ie(new URL("./worker-thread-v2.js", import.meta.url)), new Promise((s, o) => {
     r.once("message", function(n) {
       n.command === "worker-script-initialized" && s({ worker: r, phpPort: n.phpPort });
     }), r.once("error", function(n) {
@@ -1485,12 +1610,12 @@ function It(e, { onExit: t } = {}) {
     });
   });
 }
-async function le(e) {
-  const { port1: t, port2: r } = new Be();
-  return await Me() ? be(e, null, t) : await ve(e, t), r;
+async function de(e) {
+  const { port1: t, port2: r } = new Me();
+  return await Q() ? Pe(e, null, t) : await Se(e, t), r;
 }
-function $t(e) {
-  const t = O.platform();
+function Ct(e) {
+  const t = N.platform();
   let r;
   switch (t) {
     case "darwin":
@@ -1504,10 +1629,10 @@ function $t(e) {
       break;
   }
   je(r, (s) => {
-    s && g.debug(`Could not open browser: ${s.message}`);
+    s && y.debug(`Could not open browser: ${s.message}`);
   });
 }
-async function Tt(e, t) {
+async function Lt(e, t) {
   await e.run({
     code: `<?php
 		$zip = new ZipArchive();
@@ -1529,15 +1654,16 @@ async function Tt(e, t) {
 	`
   });
   const r = await e.readFileAsBuffer("/tmp/build.zip");
-  p.writeFileSync(t, r);
+  c.writeFileSync(t, r);
 }
 export {
-  he as L,
-  gt as a,
-  bt as i,
-  Gt as m,
-  Jt as p,
-  St as r,
-  It as s
+  fe as L,
+  rr as a,
+  St as b,
+  kt as i,
+  O as m,
+  or as p,
+  Et as r,
+  Mt as s
 };
-//# sourceMappingURL=run-cli-NcKUE5gJ.js.map
+//# sourceMappingURL=run-cli-BK0MGgcU.js.map