@10up/wp-vite-plugins 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/cli.js

@@ -1,628 +0,0 @@
-#!/usr/bin/env node
-import { realpathSync, readFileSync, existsSync } from 'fs';
-import { dirname, join, resolve, isAbsolute, parse, sep } from 'path';
-import { fileURLToPath } from 'url';
-import { spawn } from 'child_process';
-import { rm } from 'fs/promises';
-
-var DEFAULT_BUILD_ARGS = ["build", "--no-emptyOutDir", "--no-clearScreen"];
-var DEFAULT_WATCH_ARGS = ["build", "--watch", "--no-emptyOutDir", "--no-clearScreen"];
-var BIN_CANDIDATES = ["vite", "vp"];
-function spawnPass(options) {
-  const { pass, stdout, stderr } = options;
-  const child = spawn(options.bin, options.argv, {
-    cwd: options.cwd,
-    env: {
-      ...process.env,
-      ...options.env,
-      WP_VITE_RUNNER: options.runner,
-      WP_VITE_PASS: pass,
-      // Kept for the documented watch-only guard:
-      // `emptyOutDir: !isModulePass && !process.env.WP_VITE_UNIFIED_WATCH`.
-      ...options.runner === "watch" ? { WP_VITE_UNIFIED_WATCH: "1" } : {}
-    },
-    stdio: options.inherit ? "inherit" : ["ignore", "pipe", "pipe"],
-    // .cmd shims are not directly executable on Windows.
-    shell: process.platform === "win32"
-  });
-  if (options.inherit) {
-    const result2 = new Promise((settle) => {
-      let settled = false;
-      const finish = (passResult) => {
-        if (settled) return;
-        settled = true;
-        settle(passResult);
-      };
-      child.on("error", (error) => {
-        stderr.write(`[wp-vite] the ${pass} pass failed to start: ${error.message}
-`);
-        finish({ pass, code: null, signal: null, error });
-      });
-      child.on("close", (code, signal) => finish({ pass, code, signal }));
-    });
-    return { pass, child, result: result2 };
-  }
-  const outPrefixer = createLinePrefixer(`[${pass}] `, (text) => stdout.write(text));
-  const errPrefixer = createLinePrefixer(`[${pass}] `, (text) => stderr.write(text));
-  child.stdout?.setEncoding("utf8");
-  child.stdout?.on("data", (chunk) => outPrefixer.write(chunk));
-  child.stderr?.setEncoding("utf8");
-  child.stderr?.on("data", (chunk) => errPrefixer.write(chunk));
-  const result = new Promise((settle) => {
-    let settled = false;
-    const finish = (passResult) => {
-      if (settled) return;
-      settled = true;
-      outPrefixer.flush();
-      errPrefixer.flush();
-      settle(passResult);
-    };
-    child.on("error", (error) => {
-      stderr.write(`[wp-vite] the ${pass} pass failed to start: ${error.message}
-`);
-      finish({ pass, code: null, signal: null, error });
-    });
-    child.on("close", (code, signal) => finish({ pass, code, signal }));
-  });
-  return { pass, child, result };
-}
-function passArgs(base, pass, modulesMode, extra = []) {
-  return [...base, ...pass === "modules" ? ["--mode", modulesMode] : [], ...extra];
-}
-function forwardSignals(handler) {
-  const bound = ["SIGINT", "SIGTERM"].map(
-    (signal) => [signal, () => handler(signal)]
-  );
-  for (const [signal, listener] of bound) process.on(signal, listener);
-  return () => {
-    for (const [signal, listener] of bound) process.off(signal, listener);
-  };
-}
-function describeExit(code, signal) {
-  if (signal) return `signal ${signal}`;
-  if (code === null) return "unknown cause";
-  return `exit code ${code}`;
-}
-var SIGNAL_EXIT_CODES = {
-  SIGINT: 130,
-  SIGTERM: 143,
-  SIGHUP: 129,
-  SIGQUIT: 131
-};
-function signalExitCode(signal) {
-  if (!signal) return 1;
-  return SIGNAL_EXIT_CODES[signal] ?? 1;
-}
-function passExitCode(result) {
-  if (result.error) return 1;
-  if (result.code !== null) return result.code;
-  return signalExitCode(result.signal);
-}
-var VITE_CONFIG_FILES = [
-  "vite.config.ts",
-  "vite.config.mts",
-  "vite.config.cts",
-  "vite.config.js",
-  "vite.config.mjs",
-  "vite.config.cjs"
-];
-function detectModulePass(options = {}) {
-  if (typeof options.modules === "boolean") {
-    return {
-      modules: options.modules,
-      reason: `explicit --${options.modules ? "modules" : "no-modules"} flag`
-    };
-  }
-  const cwd = resolve(options.cwd ?? process.cwd());
-  const modulesMode = options.modulesMode ?? "modules";
-  const escapedMode = escapeRegExp(modulesMode);
-  const scriptMatch = new RegExp(`(?:--mode[=\\s]+|(?:^|\\s)-m\\s+)${escapedMode}(?![\\w-])`);
-  const packageJson = readJson(join(cwd, "package.json"));
-  const scripts = packageJson?.scripts;
-  if (scripts && typeof scripts === "object") {
-    for (const [name, command] of Object.entries(scripts)) {
-      if (typeof command === "string" && scriptMatch.test(command)) {
-        return {
-          modules: true,
-          reason: `package.json script "${name}" runs --mode ${modulesMode}`
-        };
-      }
-    }
-  }
-  const configMatch = new RegExp(`(['"\`])${escapedMode}\\1`);
-  for (const fileName of VITE_CONFIG_FILES) {
-    const filePath = join(cwd, fileName);
-    const source = readFileIfExists(filePath);
-    if (source === null) continue;
-    if (configMatch.test(source)) {
-      return { modules: true, reason: `${fileName} mentions the "${modulesMode}" mode` };
-    }
-    return {
-      modules: false,
-      reason: `${fileName} never mentions the "${modulesMode}" mode`
-    };
-  }
-  return {
-    modules: false,
-    reason: `no package.json script or Vite config mentions the "${modulesMode}" mode`
-  };
-}
-function resolveViteBin(cwd = process.cwd(), candidates = BIN_CANDIDATES) {
-  const searched = [];
-  for (const binDir of nodeModulesBinDirs(cwd)) {
-    for (const name of candidates) {
-      for (const fileName of binFileNames(name)) {
-        const candidatePath = join(binDir, fileName);
-        searched.push(candidatePath);
-        if (existsSync(candidatePath)) return { name, path: candidatePath };
-      }
-    }
-  }
-  throw new Error(
-    `[wp-vite] could not find a Vite binary (${candidates.join(" or ")}) in any node_modules/.bin above ${cwd}. Install vite in the package, or pass --bin <name|path>. Looked at:
-  ${searched.join("\n  ")}`
-  );
-}
-function resolveBin(bin, cwd) {
-  if (!bin) return resolveViteBin(cwd).path;
-  if (isAbsolute(bin) || bin.includes("/") || bin.includes("\\")) return bin;
-  try {
-    return resolveViteBin(cwd, [bin]).path;
-  } catch {
-    return bin;
-  }
-}
-function nodeModulesBinDirs(from) {
-  const dirs = [];
-  let current = resolve(from);
-  const { root } = parse(current);
-  while (true) {
-    dirs.push(join(current, "node_modules", ".bin"));
-    if (current === root) break;
-    const parent = dirname(current);
-    if (parent === current) break;
-    current = parent;
-  }
-  return dirs;
-}
-function binFileNames(name) {
-  return process.platform === "win32" ? [`${name}.cmd`, name] : [name];
-}
-async function cleanOutDir(outDir = "dist", cwd = process.cwd()) {
-  const base = resolve(cwd);
-  const target = isAbsolute(outDir) ? resolve(outDir) : resolve(base, outDir);
-  if (target === parse(target).root || target === base || !target.startsWith(base + sep)) {
-    throw new Error(
-      `[wp-vite] refusing to clean ${target}: the out dir must be inside ${base}`
-    );
-  }
-  await rm(target, { recursive: true, force: true });
-  return target;
-}
-var ESCAPE = String.fromCharCode(27);
-var ERASE_SEQUENCE = new RegExp(`^(?:${ESCAPE}\\[[0-2]?[KJ])+`);
-function createLinePrefixer(prefix, write) {
-  let buffer = "";
-  const emit = (line) => {
-    const withoutCrlf = line.endsWith("\r") ? line.slice(0, -1) : line;
-    const rendered = withoutCrlf.split("\r").pop() ?? "";
-    const content = rendered.replace(ERASE_SEQUENCE, "");
-    write(content.length === 0 ? "\n" : `${prefix}${content}
-`);
-  };
-  return {
-    write(chunk) {
-      buffer += chunk;
-      const lines = buffer.split("\n");
-      buffer = lines.pop() ?? "";
-      for (const line of lines) emit(line);
-    },
-    flush() {
-      if (buffer.length === 0) return;
-      const pending = buffer;
-      buffer = "";
-      emit(pending);
-    }
-  };
-}
-function parseCliArgs(argv) {
-  const parsed = {
-    command: void 0,
-    options: {},
-    help: false,
-    version: false,
-    unknown: []
-  };
-  const passthrough = [];
-  let index = 0;
-  for (; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg === "--") {
-      passthrough.push(...argv.slice(index + 1));
-      break;
-    }
-    if (!arg.startsWith("-")) {
-      if (parsed.command === void 0) parsed.command = arg;
-      else parsed.unknown.push(arg);
-      continue;
-    }
-    const equalsAt = arg.indexOf("=");
-    const flag = equalsAt === -1 ? arg : arg.slice(0, equalsAt);
-    const inlineValue = equalsAt === -1 ? void 0 : arg.slice(equalsAt + 1);
-    const takeValue = () => {
-      if (inlineValue !== void 0) return inlineValue;
-      const next = argv[index + 1];
-      if (next === void 0 || next.startsWith("-")) return void 0;
-      index += 1;
-      return next;
-    };
-    switch (flag) {
-      case "-h":
-      case "--help":
-        parsed.help = true;
-        break;
-      case "-v":
-      case "--version":
-        parsed.version = true;
-        break;
-      case "--out-dir":
-      case "--outDir": {
-        const value = takeValue();
-        if (value === void 0) parsed.unknown.push(`${flag} (missing value)`);
-        else parsed.options.outDir = value;
-        break;
-      }
-      case "--modules-mode":
-      case "--modulesMode": {
-        const value = takeValue();
-        if (value === void 0) parsed.unknown.push(`${flag} (missing value)`);
-        else parsed.options.modulesMode = value;
-        break;
-      }
-      case "--bin": {
-        const value = takeValue();
-        if (value === void 0) parsed.unknown.push(`${flag} (missing value)`);
-        else parsed.options.bin = value;
-        break;
-      }
-      case "--cwd": {
-        const value = takeValue();
-        if (value === void 0) parsed.unknown.push(`${flag} (missing value)`);
-        else parsed.options.cwd = value;
-        break;
-      }
-      case "--modules":
-        parsed.options.modules = true;
-        break;
-      case "--no-modules":
-        parsed.options.modules = false;
-        break;
-      case "--clean":
-        parsed.options.clean = true;
-        break;
-      case "--no-clean":
-        parsed.options.clean = false;
-        break;
-      default:
-        parsed.unknown.push(flag);
-    }
-  }
-  if (passthrough.length > 0) parsed.options.args = passthrough;
-  return parsed;
-}
-async function prepareRun(options, runner) {
-  const cwd = resolve(options.cwd ?? process.cwd());
-  const outDir = options.outDir ?? "dist";
-  const modulesMode = options.modulesMode ?? "modules";
-  const stdout = options.stdout ?? process.stdout;
-  const stderr = options.stderr ?? process.stderr;
-  const bin = resolveBin(options.bin, cwd);
-  const detection = detectModulePass({ cwd, modulesMode, modules: options.modules });
-  const passes = detection.modules ? ["script", "modules"] : ["script"];
-  if (options.clean !== false) {
-    const cleaned = await cleanOutDir(outDir, cwd);
-    stdout.write(`[wp-vite] cleaned ${cleaned}
-`);
-  }
-  stdout.write(
-    `[wp-vite] module pass ${detection.modules ? "enabled" : "disabled"} \u2014 ${detection.reason}; ${runner === "watch" ? "watching" : "building"} ${passes.join(runner === "watch" ? " + " : " then ")} via ${bin}
-`
-  );
-  return { cwd, bin, modulesMode, passes, stdout, stderr };
-}
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function readFileIfExists(filePath) {
-  try {
-    return readFileSync(filePath, "utf8");
-  } catch {
-    return null;
-  }
-}
-function readJson(filePath) {
-  const source = readFileIfExists(filePath);
-  if (source === null) return null;
-  try {
-    return JSON.parse(source);
-  } catch {
-    return null;
-  }
-}
-
-// src/build.ts
-async function build(options = {}) {
-  const { cwd, bin, modulesMode, passes, stdout, stderr } = await prepareRun(options, "build");
-  let current;
-  let interrupted = false;
-  let interruptCode = 0;
-  const disposeSignals = options.handleSignals === false ? () => {
-  } : forwardSignals((signal) => {
-    if (interrupted) return;
-    interrupted = true;
-    interruptCode = signalExitCode(signal);
-    if (current && current.exitCode === null && current.signalCode === null) {
-      current.kill(signal);
-    }
-  });
-  try {
-    for (const [index, pass] of passes.entries()) {
-      if (interrupted) {
-        stderr.write(`[wp-vite] interrupted \u2014 skipping the ${pass} pass
-`);
-        return interruptCode;
-      }
-      const spawned = spawnPass({
-        pass,
-        runner: "build",
-        bin,
-        cwd,
-        argv: passArgs(
-          options.buildArgs ?? DEFAULT_BUILD_ARGS,
-          pass,
-          modulesMode,
-          options.args ?? []
-        ),
-        env: options.env,
-        stdout,
-        stderr
-      });
-      current = spawned.child;
-      const result = await spawned.result;
-      current = void 0;
-      const code = passExitCode(result);
-      if (code === 0) continue;
-      const skipped = passes.slice(index + 1);
-      stderr.write(
-        `[wp-vite] the ${pass} pass failed (${describeExit(result.code, result.signal)})` + (skipped.length > 0 ? ` \u2014 skipping the ${skipped.join(" and ")} pass` : "") + "\n"
-      );
-      return code;
-    }
-    stdout.write(
-      passes.length > 1 ? `[wp-vite] built ${passes.join(" + ")} into one dist
-` : `[wp-vite] built the ${passes[0]} pass
-`
-    );
-    return 0;
-  } finally {
-    disposeSignals();
-  }
-}
-var DEFAULT_DEV_ARGS = ["dev", "--no-clearScreen"];
-async function dev(options = {}) {
-  const cwd = resolve(options.cwd ?? process.cwd());
-  const stdout = options.stdout ?? process.stdout;
-  const stderr = options.stderr ?? process.stderr;
-  const bin = resolveBin(options.bin, cwd);
-  if (options.clean === true) {
-    const cleaned = await cleanOutDir(options.outDir ?? "dist", cwd);
-    stdout.write(`[wp-vite] cleaned ${cleaned}
-`);
-  }
-  stdout.write(`[wp-vite] starting the dev server via ${bin}
-`);
-  let current;
-  let interrupted = false;
-  const disposeSignals = options.handleSignals === false ? () => {
-  } : forwardSignals((signal) => {
-    if (interrupted) return;
-    interrupted = true;
-    if (current && current.exitCode === null && current.signalCode === null) {
-      current.kill(signal);
-    }
-  });
-  try {
-    const spawned = spawnPass({
-      pass: "dev",
-      runner: "dev",
-      bin,
-      cwd,
-      argv: [...options.devArgs ?? DEFAULT_DEV_ARGS, ...options.args ?? []],
-      env: options.env,
-      stdout,
-      stderr,
-      inherit: options.inherit !== false
-    });
-    current = spawned.child;
-    const result = await spawned.result;
-    current = void 0;
-    if (interrupted) return 0;
-    const code = passExitCode(result);
-    if (code !== 0) {
-      stderr.write(
-        `[wp-vite] the dev server exited (${describeExit(result.code, result.signal)})
-`
-      );
-    }
-    return code;
-  } finally {
-    disposeSignals();
-  }
-}
-
-// src/watch.ts
-async function watch(options = {}) {
-  const { cwd, bin, modulesMode, passes, stdout, stderr } = await prepareRun(options, "watch");
-  const children = [];
-  let shuttingDown = false;
-  let exitCode = 0;
-  const shutdown = (signal) => {
-    shuttingDown = true;
-    for (const child of children) {
-      if (child.exitCode === null && child.signalCode === null) child.kill(signal);
-    }
-  };
-  const disposeSignals = options.handleSignals === false ? () => {
-  } : forwardSignals((signal) => {
-    if (shuttingDown) return;
-    exitCode = 0;
-    shutdown(signal);
-  });
-  const spawned = passes.map(
-    (pass) => spawnPass({
-      pass,
-      runner: "watch",
-      bin,
-      cwd,
-      argv: passArgs(
-        options.buildArgs ?? DEFAULT_WATCH_ARGS,
-        pass,
-        modulesMode,
-        options.args ?? []
-      ),
-      env: options.env,
-      stdout,
-      stderr
-    })
-  );
-  children.push(...spawned.map(({ child }) => child));
-  let running = spawned.length;
-  try {
-    await Promise.all(
-      spawned.map(async ({ pass, result }) => {
-        const passResult = await result;
-        running -= 1;
-        if (shuttingDown) return;
-        const unexpected = passResult.error != null || passResult.code === null || passResult.code !== 0 || running > 0;
-        if (!unexpected) return;
-        exitCode = passResult.code && passResult.code !== 0 ? passResult.code : 1;
-        stderr.write(
-          `[wp-vite] the ${pass} pass exited unexpectedly (${describeExit(passResult.code, passResult.signal)}) \u2014 stopping
-`
-        );
-        shutdown("SIGTERM");
-      })
-    );
-    return exitCode;
-  } finally {
-    disposeSignals();
-  }
-}
-
-// src/cli.ts
-var HELP = `
-  wp-vite \u2014 build helpers for @10up/wp-vite-plugins
-
-  Usage
-    $ wp-vite build [options] [-- <extra vite args>]
-    $ wp-vite watch [options] [-- <extra vite args>]
-    $ wp-vite dev   [options] [-- <extra vite args>]
-
-  \`build\` and \`watch\` drive the two passes of a dual-pass WordPress build \u2014
-  the script pass (\`vite build\`) and, when the package has module entries, the
-  module pass (\`vite build --mode modules\`) \u2014 from a single process, after
-  cleaning the out dir exactly once.
-
-    build   Runs the script pass to completion, then the module pass.
-            Fails fast: a failing pass skips the rest and exits with its code.
-    watch   Runs both passes concurrently as \`--watch\` processes and stays
-            alive until interrupted.
-    dev     Starts ONE \`vite\` dev server (no second pass \u2014 the wpDevServer
-            plugin serves classic scripts and Script Modules from the same
-            server) and writes the hot file WordPress reads. Does not clean
-            the out dir unless you ask with --clean.
-
-  Options
-    --out-dir <dir>       Directory cleaned once at startup (default: dist).
-                          Must match \`build.outDir\` in the Vite config.
-    --modules             Force the module pass on. (build/watch)
-    --no-modules          Force the module pass off. (build/watch)
-    --modules-mode <mode> \`--mode\` value for the module pass (default: modules).
-    --bin <name|path>     Vite CLI to run (default: vite, else vp).
-    --clean               Clean the out dir at startup (dev: off by default).
-    --no-clean            Skip the startup clean of the out dir.
-    --cwd <dir>           Package directory to run in (default: cwd).
-    -h, --help            Show this message.
-    -v, --version         Show the package version.
-
-  Examples
-    $ wp-vite build
-    $ wp-vite watch
-    $ wp-vite dev
-    $ wp-vite build --bin vp --out-dir build
-    $ wp-vite watch -- --minify false
-    $ wp-vite dev -- --port 5199
-`;
-async function runCli(argv) {
-  const parsed = parseCliArgs(argv);
-  if (parsed.version) {
-    process.stdout.write(`${readPackageVersion()}
-`);
-    return 0;
-  }
-  if (parsed.help || parsed.command === void 0) {
-    process.stdout.write(`${HELP.trim()}
-`);
-    return parsed.command === void 0 && !parsed.help ? 1 : 0;
-  }
-  if (parsed.unknown.length > 0) {
-    process.stderr.write(`[wp-vite] unknown argument(s): ${parsed.unknown.join(", ")}
-`);
-    process.stderr.write(`${HELP.trim()}
-`);
-    return 1;
-  }
-  if (parsed.command !== "build" && parsed.command !== "watch" && parsed.command !== "dev") {
-    process.stderr.write(`[wp-vite] unknown command: ${parsed.command}
-`);
-    process.stderr.write(`${HELP.trim()}
-`);
-    return 1;
-  }
-  try {
-    if (parsed.command === "build") return await build(parsed.options);
-    if (parsed.command === "watch") return await watch(parsed.options);
-    return await dev(parsed.options);
-  } catch (error) {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  }
-}
-function readPackageVersion() {
-  const here = dirname(fileURLToPath(import.meta.url));
-  for (const candidate of [join(here, "..", "package.json"), join(here, "package.json")]) {
-    try {
-      const parsed = JSON.parse(readFileSync(candidate, "utf8"));
-      if (typeof parsed.version === "string") return parsed.version;
-    } catch {
-    }
-  }
-  return "unknown";
-}
-function isEntryPoint() {
-  const entry = process.argv[1];
-  if (!entry) return false;
-  try {
-    return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(entry);
-  } catch {
-    return false;
-  }
-}
-if (isEntryPoint()) {
-  process.exitCode = await runCli(process.argv.slice(2));
-}
-
-export { runCli };
-//# sourceMappingURL=cli.js.map
-//# sourceMappingURL=cli.js.map