@wp-playground/cli 3.0.43 → 3.0.44

package/{run-cli-NcKUE5gJ.js → run-cli-DOpShCrT.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 te } from "@php-wasm/logger";
+import { PHPResponse as z, consumeAPI as U, SupportedPHPVersions as re, printDebugDetails as be, exposeAPI as ve, exposeSyncAPI as Pe } from "@php-wasm/universal";
+import { resolveRemoteBlueprint as Se, resolveRuntimeConfiguration as oe, compileBlueprintV1 as xe, isBlueprintBundle as ke, runBlueprintV1Steps as Ie } from "@wp-playground/blueprints";
+import { zipDirectory as $e, RecommendedPHPVersion as F } from "@wp-playground/common";
+import c, { existsSync as X, rmdirSync as Ee, mkdirSync as G, readdirSync as Te } from "fs";
+import { MessageChannel as Be, Worker as se } from "worker_threads";
+import { createNodeFsMountHandler as Ce, FileLockManagerForNode as Le } from "@php-wasm/node";
+import p, { basename as A, join as de } 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 Me } from "os";
+import { jspi as De } 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(":");
@@ -29,14 +29,14 @@ function _(e) {
 				Expected format: /host/path:/vfs/path.
 				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;
+    const [o, n] = s;
     if (!X(o))
       throw new Error(`Host path does not exist: ${o}`);
-    t.push({ hostPath: o, vfsPath: i });
+    t.push({ hostPath: o, vfsPath: n });
   }
   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 = [];
@@ -45,17 +45,17 @@ function se(e) {
     if (!X(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 = {
@@ -77,7 +77,7 @@ const ie = {
 		`
   }
 };
-function de(e) {
+function ce(e) {
   const t = e.autoMount, r = [...e.mount || []], s = [...e["mount-before-install"] || []], o = {
     ...e,
     mount: r,
@@ -86,110 +86,183 @@ function de(e) {
       ...e["additional-blueprint-steps"] || []
     ]
   };
-  if (tt(t)) {
-    const n = `/wordpress/wp-content/plugins/${A(t)}`;
+  if (rt(t)) {
+    const i = `/wordpress/wp-content/plugins/${A(t)}`;
     r.push({
       hostPath: t,
-      vfsPath: n,
+      vfsPath: i,
       autoMounted: !0
     }), o["additional-blueprint-steps"].push({
       step: "activatePlugin",
       pluginPath: `/wordpress/wp-content/plugins/${A(t)}`
     });
-  } else if (et(t)) {
-    const i = A(t), n = `/wordpress/wp-content/themes/${i}`;
+  } else if (tt(t)) {
+    const n = A(t), i = `/wordpress/wp-content/themes/${n}`;
     r.push({
       hostPath: t,
-      vfsPath: n,
+      vfsPath: i,
       autoMounted: !0
     }), o["additional-blueprint-steps"].push(
       e["experimental-blueprints-v2-runner"] ? {
         step: "activateTheme",
-        themeDirectoryName: i
+        themeDirectoryName: n
       } : {
         step: "activateTheme",
-        themeFolderName: i
+        themeFolderName: n
       }
     );
-  } else if (Ke(t)) {
-    const i = p.readdirSync(t);
-    for (const n of i)
-      n !== "index.php" && r.push({
-        hostPath: `${t}/${n}`,
-        vfsPath: `/wordpress/wp-content/${n}`,
+  } else if (et(t)) {
+    const n = c.readdirSync(t);
+    for (const i of n)
+      i !== "index.php" && r.push({
+        hostPath: `${t}/${i}`,
+        vfsPath: `/wordpress/wp-content/${i}`,
         autoMounted: !0
       });
     o["additional-blueprint-steps"].push(ie);
-  } else Je(t) && (s.push({
+  } 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"));
   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(de(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");
-    return !!r.exec(i);
+    const n = c.readFileSync(de(e, o), "utf8");
+    return !!r.exec(n);
   });
 }
-async function rt(e) {
-  const t = We(), r = await new Promise((i, n) => {
+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 nt(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 n = Number(o);
+    if (isNaN(n))
+      throw new Error(
+        `Invalid number value for constant "${s}": "${o}". Must be a valid number.`
+      );
+    t[s.trim()] = n;
+  }
+  return t;
+}
+function it(e = {}, t = {}, r = {}) {
+  const s = {}, o = /* @__PURE__ */ new Set(), n = (i, l) => {
+    for (const u in i) {
+      if (o.has(u))
+        throw new Error(
+          `Constant "${u}" is defined multiple times across different --define-${l} flags`
+        );
+      o.add(u), s[u] = i[u];
+    }
+  };
+  return n(e, "string"), n(t, "bool"), n(r, "number"), s;
+}
+function O(e) {
+  return it(
+    e.define,
+    e["define-bool"],
+    e["define-number"]
+  );
+}
+async function at(e) {
+  const t = We(), r = await new Promise((n, i) => {
     const l = t.listen(e.port, () => {
       const u = l.address();
-      u === null || typeof u == "string" ? n(new Error("Server address is not available")) : i(l);
+      u === null || typeof u == "string" ? i(new Error("Server address is not available")) : n(l);
     });
   });
-  t.use("/", async (i, n) => {
+  t.use("/", async (n, i) => {
     let l;
     try {
       l = await e.handleRequest({
-        url: i.url,
-        headers: st(i),
-        method: i.method,
-        body: await ot(i)
+        url: n.url,
+        headers: ut(n),
+        method: n.method,
+        body: await lt(n)
       });
     } catch (u) {
-      g.error(u), l = Y.forHttpCode(500);
+      y.error(u), l = z.forHttpCode(500);
     }
-    n.statusCode = l.httpStatusCode;
+    i.statusCode = l.httpStatusCode;
     for (const u in l.headers)
-      n.setHeader(u, l.headers[u]);
-    n.end(l.bytes);
+      i.setHeader(u, l.headers[u]);
+    i.end(l.bytes);
   });
   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);
   }
@@ -211,8 +284,8 @@ class it {
   async handleRequest(t) {
     let r = this.workerLoads[0];
     for (let o = 1; o < this.workerLoads.length; o++) {
-      const i = this.workerLoads[o];
-      i.activeRequests.size < r.activeRequests.size && (r = i);
+      const n = this.workerLoads[o];
+      n.activeRequests.size < r.activeRequests.size && (r = n);
     }
     const s = r.worker.request(t);
     return r.activeRequests.add(s), s.url = t.url, s.finally(() => {
@@ -220,44 +293,44 @@ 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 Se(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 n = c.readFileSync(r, "utf-8");
       try {
-        JSON.parse(i);
+        JSON.parse(n);
       } catch {
         throw new Error(
           `Blueprint file at ${r} is not a valid JSON file`
         );
       }
-      const n = h.dirname(r), l = new De(n);
-      return new Ae([
+      const i = p.dirname(r), l = new Ae(i);
+      return new Ue([
         new Fe({
-          "blueprint.json": i
+          "blueprint.json": n
         }),
         /**
          * Wrap the NodeJS filesystem to prevent access to local files
@@ -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,9 +363,9 @@ class lt {
     return "v2";
   }
   async bootAndSetUpInitialPlayground(t, r, s) {
-    const o = F(t);
+    const o = U(t);
     await o.useFileLockManager(r);
-    const i = {
+    const n = {
       ...this.args,
       phpVersion: this.phpVersion,
       siteUrl: this.siteUrl,
@@ -309,9 +382,10 @@ 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;
+    return await o.bootAndSetUpInitialWorker(n), o;
   }
   async bootPlayground({
     worker: t,
@@ -319,9 +393,9 @@ class lt {
     firstProcessId: s,
     nativeInternalDirPath: o
   }) {
-    const i = F(t.phpPort);
-    await i.useFileLockManager(r);
-    const n = {
+    const n = U(t.phpPort);
+    await n.useFileLockManager(r);
+    const i = {
       ...this.args,
       phpVersion: this.phpVersion,
       siteUrl: this.siteUrl,
@@ -332,13 +406,14 @@ class lt {
       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;
+    return await n.bootWorker(i), n;
   }
 }
-const Q = h.join(O.homedir(), ".wordpress-playground");
-async function ut(e) {
+const Q = p.join(N.homedir(), ".wordpress-playground");
+async function ht(e) {
   return await pe(
     "https://github.com/WordPress/sqlite-database-integration/archive/refs/heads/develop.zip",
     "sqlite.zip",
@@ -346,28 +421,28 @@ async function ut(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);
+  const s = p.join(Q, t);
+  return B.existsSync(s) || (B.ensureDirSync(Q), await ft(e, s, r)), me(s);
 }
-async function dt(e, t, r) {
-  const o = (await r.monitorFetch(fetch(e))).body.getReader(), i = `${t}.partial`, n = B.createWriteStream(i);
+async function ft(e, t, r) {
+  const o = (await r.monitorFetch(fetch(e))).body.getReader(), n = `${t}.partial`, i = B.createWriteStream(n);
   for (; ; ) {
     const { done: l, value: u } = await o.read();
-    if (u && n.write(u), l)
+    if (u && i.write(u), l)
       break;
   }
-  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);
+  i.close(), i.closed || await new Promise((l, u) => {
+    i.on("finish", () => {
+      B.renameSync(n, t), l(null);
+    }), i.on("error", (v) => {
+      B.removeSync(n), u(v);
     });
   });
 }
-function ce(e, t) {
+function me(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;
   }
@@ -375,51 +450,51 @@ class pt {
     return "v1";
   }
   async bootAndSetUpInitialPlayground(t, r, s) {
-    let o, i, n;
-    const l = new Oe();
+    let o, n, i;
+    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: L, total: Z } = I.detail, W = Math.floor(
+          Math.min(100, 100 * L / Z)
         );
-        E = C === 100, this.cliOutput.updateProgress(
+        k = W === 100, this.cliOutput.updateProgress(
           "Downloading WordPress",
-          C
+          W
         );
-      }), o = await Ve(this.args.wp), n = h.join(
+      }), o = await He(this.args.wp), i = p.join(
         Q,
         `prebuilt-wp-content-for-wp-${o.version}.zip`
-      ), i = p.existsSync(n) ? ce(n) : await pe(
+      ), n = c.existsSync(i) ? me(i) : await pe(
         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 oe(
       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(),
+      wordPressZip: n && await n.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,
       // We do not enable Xdebug by default for the initial worker
@@ -427,11 +502,12 @@ class pt {
       // 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(
-      n,
-      await Ie(c, "/wordpress")
-    )), c;
+      nativeInternalDirPath: s,
+      constants: O(this.args)
+    }), i && !this.args["mount-before-install"] && !c.existsSync(i) && (this.cliOutput.updateProgress("Caching WordPress for next boot"), c.writeFileSync(
+      i,
+      await $e(g, "/wordpress")
+    )), g;
   }
   async bootPlayground({
     worker: t,
@@ -439,15 +515,15 @@ class pt {
     firstProcessId: s,
     nativeInternalDirPath: o
   }) {
-    const i = F(
+    const n = U(
       t.phpPort
     );
-    await i.isConnected();
-    const n = await re(
+    await n.isConnected();
+    const i = await oe(
       this.getEffectiveBlueprint()
     );
-    return await i.useFileLockManager(r), await i.bootWorker({
-      phpVersion: n.phpVersion,
+    return await n.useFileLockManager(r), await n.bootWorker({
+      phpVersion: i.phpVersion,
       siteUrl: this.siteUrl,
       mountsBeforeWpInstall: this.args["mount-before-install"] || [],
       mountsAfterWpInstall: this.args.mount || [],
@@ -460,38 +536,39 @@ class pt {
       internalCookieStore: this.args.internalCookieStore,
       withIntl: this.args.intl,
       withXdebug: !!this.args.xdebug,
-      nativeInternalDirPath: o
-    }), await i.isReady(), i;
+      nativeInternalDirPath: o,
+      constants: O(this.args)
+    }), await n.isReady(), n;
   }
   async compileInputBlueprint(t) {
-    const r = this.getEffectiveBlueprint(), s = new He();
-    let o = "", i = !1;
-    return s.addEventListener("progress", (n) => {
-      if (i)
+    const r = this.getEffectiveBlueprint(), s = new _e();
+    let o = "", n = !1;
+    return s.addEventListener("progress", (i) => {
+      if (n)
         return;
-      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, {
+      n = i.detail.progress === 100;
+      const l = Math.floor(i.detail.progress);
+      o = i.detail.caption || o || "Running Blueprint", this.cliOutput.updateProgress(o.trim(), l);
+    }), await xe(r, {
       progress: s,
       additionalSteps: t
     });
   }
   getEffectiveBlueprint() {
     const t = this.args.blueprint;
-    return xe(t) ? t : {
+    return ke(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,83 +580,83 @@ 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(
-          `Failed to delete stale Playground temp dir: ${i}`,
+    (n) => new Promise((i) => {
+      c.rm(n, { recursive: !0 }, (l) => {
+        l ? y.warn(
+          `Failed to delete stale Playground temp dir: ${n}`,
           l
-        ) : g.info(
-          `Deleted stale Playground temp dir: ${i}`
-        ), n();
+        ) : y.info(
+          `Deleted stale Playground temp dir: ${n}`
+        ), i();
       });
     })
   );
   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 = [];
-    for (const i of s)
-      await ft(
+    const s = c.readdirSync(r).map((n) => p.join(r, n)), o = [];
+    for (const n of s)
+      await vt(
         e,
         t,
-        i
-      ) && o.push(i);
+        n
+      ) && o.push(n);
     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(
+  const n = o.match(
     new RegExp(`^(.+)${e}(\\d+)-`)
   );
-  if (!i)
+  if (!n)
     return !1;
-  const n = {
-    executableName: i[1],
-    pid: i[2]
+  const i = {
+    executableName: n[1],
+    pid: n[2]
   };
-  if (await wt(n.pid, n.executableName))
+  if (await Pt(i.pid, i.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,
           // Remove path from executable name in the results.
           clean: !0
         },
-        (i, n) => {
-          i ? o(i) : s(n);
+        (n, i) => {
+          n ? o(n) : s(i);
         }
       );
     }
   );
   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 +670,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";
@@ -647,9 +724,9 @@ ${t}
     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)
       for (const o of t.mounts) {
-        const i = o.autoMounted ? ` ${this.dim("(auto-mount)")}` : "";
+        const n = o.autoMounted ? ` ${this.dim("(auto-mount)")}` : "";
         r.push(
-          `${this.dim("Mount")} ${o.hostPath} ${this.dim("→")} ${o.vfsPath}${i}`
+          `${this.dim("Mount")} ${o.hostPath} ${this.dim("→")} ${o.vfsPath}${n}`
         );
       }
     t.blueprint && r.push(`${this.dim("Blueprint")} ${t.blueprint}`), this.writeStream.write(r.join(`
@@ -737,7 +814,7 @@ const he = {
   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 +824,62 @@ async function Jt(e) {
       php: {
         describe: "PHP version to use.",
         type: "string",
-        default: U,
-        choices: te
+        default: F,
+        choices: re
       },
       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: nt
+      },
       // @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",
@@ -904,7 +1002,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 ?? Me().length - 1
       },
       "experimental-devtools": {
         describe: "Enable experimental browser development tools.",
@@ -919,8 +1017,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: re
       },
       wp: {
         describe: "WordPress version to use.",
@@ -966,7 +1064,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,14 +1075,18 @@ 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.",
         type: "string",
         default: "wordpress.zip"
       }
-    }, i = Re(e).usage("Usage: wp-playground <command> [options]").command(
+    }, n = Re(e).usage("Usage: wp-playground <command> [options]").command(
       "start",
       "Start a local WordPress server with automatic project detection (recommended)",
       (a) => a.usage(
@@ -1022,13 +1124,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 +1138,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,44 +1187,47 @@ 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."
         );
       return !0;
     });
-    i.wrap(i.terminalWidth());
-    const n = await i.argv, l = n._[0];
+    n.wrap(n.terminalWidth());
+    const i = await n.argv, l = i._[0];
     ["start", "run-blueprint", "server", "build-snapshot"].includes(
       l
-    ) || (i.showHelp(), process.exit(1));
-    const u = {
-      ...n,
+    ) || (n.showHelp(), process.exit(1));
+    const u = i.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 = {
+      ...i,
+      define: u,
       command: l,
       mount: [
-        ...n.mount || [],
-        ...n["mount-dir"] || []
+        ...i.mount || [],
+        ...i["mount-dir"] || []
       ],
       "mount-before-install": [
-        ...n["mount-before-install"] || [],
-        ...n["mount-dir-before-install"] || []
+        ...i["mount-before-install"] || [],
+        ...i["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);
+      be(t);
     else {
       const s = [];
       let o = t;
@@ -1136,27 +1241,27 @@ Examples:
     process.exit(1);
   }
 }
-function ne(e, t) {
+function ae(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, le = (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 = ce(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(he).find(
+      (a) => a.name === e.verbosity
     ).severity;
-    g.setSeverityFilterLevel(a);
+    y.setSeverityFilterLevel(w);
   }
   e.intl || (e.intl = !0);
-  const o = new yt({
+  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,
@@ -1167,42 +1272,42 @@ async function St(e) {
     ],
     blueprint: typeof e.blueprint == "string" ? e.blueprint : void 0
   }));
-  const i = e.command === "server" ? e.port ?? 9400 : 0, n = O.platform() === "win32" ? (
+  const n = e.command === "server" ? e.port ?? 9400 : 0, i = 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({
-    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" ? (
+  }), l = new Le(i);
+  let u = !1, v = !0;
+  const P = await at({
+    port: n,
+    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, L = 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, W = 2 ** 31 - 1, C = Math.floor(
+        W / L
+      ), J = "-playground-cli-site-", $ = await gt(J);
+      y.debug(`Native temp dir for VFS root: ${$.path}`);
+      const M = "WP Playground CLI - Listen for Xdebug", K = ".playground-xdebug-root", ee = p.join(process.cwd(), K);
+      if (await Ge(ee), e.xdebug && e.experimentalUnsafeIdeIntegration) {
         await Qe(
-          I.path,
-          K,
+          $.path,
+          ee,
           process.platform
         );
         const d = {
-          hostPath: h.join(".", h.sep, J),
+          hostPath: p.join(".", p.sep, K),
           vfsPath: "/"
         };
         try {
           await Xe(M, process.cwd());
-          const w = typeof e.xdebug == "object" ? e.xdebug : void 0, P = await Ze({
+          const f = typeof e.xdebug == "object" ? e.xdebug : void 0, S = await Ze({
             name: M,
-            host: c,
-            port: f,
+            host: g,
+            port: a,
             ides: e.experimentalUnsafeIdeIntegration,
             cwd: process.cwd(),
             mounts: [
@@ -1210,19 +1315,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(
+            le("Updated IDE config: ") + R.join(" ")
           ), console.log(
-            ae("Playground source root: ") + ".playground-xdebug-root" + q(
-              Pt(
+            le("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,15 +1336,15 @@ async function St(e) {
           ), console.log(
             "  2. Open the Run and Debug panel on the left sidebar"
           ), console.log(
-            `  3. Select "${q(
+            `  3. Select "${Y(
               M
             )}" 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(
+          ), x && console.log("")), x && S.phpstorm && (console.log(T("PhpStorm instructions:")), console.log(
+            `  1. Choose "${Y(
               M
             )}" debug configuration in the toolbar`
           ), console.log("  2. Click the debug button (bug icon)`"), console.log(
@@ -1247,21 +1352,21 @@ async function St(e) {
           ), 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 fe = p.dirname($.path), we = 2 * 24 * 60 * 60 * 1e3;
+      yt(
+        J,
+        we,
+        fe
       );
-      const H = h.join(I.path, "internal");
-      z(H);
-      const we = [
+      const _ = p.join($.path, "internal");
+      G(_);
+      const ge = [
         "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 +1377,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 ge) {
+        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 +1392,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: C,
         cliOutput: o
-      }) : ($ = new pt(e, {
-        siteUrl: E,
-        processIdSpaceLength: L,
+      }) : (E = new wt(e, {
+        siteUrl: k,
+        processIdSpaceLength: C,
         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());
+      }, ye = Bt(
+        L,
+        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 ye, f = await ue(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 Ie(
               x,
-              y
+              b
             );
           }
           if (e.command === "build-snapshot") {
-            await Tt(r, e.outfile), o.printStatus(`Exported to ${e.outfile}`), await R();
+            await Wt(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 = C;
         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 * C, R = await ue(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 / C)
           }
         };
       } 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(te) && (f = await r.readFileAsText(te)), 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 && Lt(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 = ce(t), delete t.autoMount);
+  const r = ae(
     t["mount-before-install"] || [],
     "/wordpress"
-  ) || ne(t.mount || [], "/wordpress");
+  ) || ae(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 +1538,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(
-      i,
+    const s = t.autoMount || process.cwd(), o = Je("sha256").update(s).digest("hex"), n = N.homedir(), i = p.join(
+      n,
       ".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:", i), X(i) && e.reset && (console.log("Resetting site..."), Ee(i, { recursive: !0 })), G(i, { recursive: !0 }), t["mount-before-install"] = [
       ...t["mount-before-install"] || [],
-      { vfsPath: "/wordpress", hostPath: n }
-    ], t.wordpressInstallMode = Te(n).length === 0 ? (
+      { vfsPath: "/wordpress", hostPath: i }
+    ], t.wordpressInstallMode = Te(i).length === 0 ? (
       // Only download WordPress on the first run when the site directory is still
       // empty.
       "download-and-install"
@@ -1452,45 +1557,45 @@ 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 i = Ct(t, { onExit: (l) => {
       r({
         exitCode: l,
         workerIndex: o
       });
     } });
-    s.push(n);
+    s.push(i);
   }
   return Promise.all(s);
 }
-function It(e, { onExit: t } = {}) {
+function Ct(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) => {
-    r.once("message", function(n) {
-      n.command === "worker-script-initialized" && s({ worker: r, phpPort: n.phpPort });
-    }), r.once("error", function(n) {
-      console.error(n);
+  return e === "v1" ? r = new se(new URL("./worker-thread-v1.js", import.meta.url)) : r = new se(new URL("./worker-thread-v2.js", import.meta.url)), new Promise((s, o) => {
+    r.once("message", function(i) {
+      i.command === "worker-script-initialized" && s({ worker: r, phpPort: i.phpPort });
+    }), r.once("error", function(i) {
+      console.error(i);
       const l = new Error(
-        `Worker failed to load worker. ${n.message ? `Original error: ${n.message}` : ""}`
+        `Worker failed to load worker. ${i.message ? `Original error: ${i.message}` : ""}`
       );
       o(l);
     });
-    let i = !1;
+    let n = !1;
     r.once("spawn", () => {
-      i = !0;
-    }), r.once("exit", (n) => {
-      i || o(new Error(`Worker exited before spawning: ${n}`)), t?.(n);
+      n = !0;
+    }), r.once("exit", (i) => {
+      n || o(new Error(`Worker exited before spawning: ${i}`)), t?.(i);
     });
   });
 }
-async function le(e) {
+async function ue(e) {
   const { port1: t, port2: r } = new Be();
-  return await Me() ? be(e, null, t) : await ve(e, t), r;
+  return await De() ? ve(e, null, t) : await Pe(e, t), r;
 }
-function $t(e) {
-  const t = O.platform();
+function Lt(e) {
+  const t = N.platform();
   let r;
   switch (t) {
     case "darwin":
@@ -1504,10 +1609,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 Wt(e, t) {
   await e.run({
     code: `<?php
 		$zip = new ZipArchive();
@@ -1529,15 +1634,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
+  rr as a,
+  St as b,
+  kt as i,
+  O as m,
+  or as p,
+  Et as r,
+  Ct as s
 };
-//# sourceMappingURL=run-cli-NcKUE5gJ.js.map
+//# sourceMappingURL=run-cli-DOpShCrT.js.map