launch-unity 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -3,5 +3,5 @@
  * Exports core functions for programmatic usage.
  * Uses lib.ts which has no CLI side effects.
  */
-export { LaunchOptions, LaunchResolvedOptions, UnityProcessInfo, parseArgs, findUnityProjectBfs, getUnityVersion, launch, findRunningUnityProcess, focusUnityProcess, killRunningUnity, handleStaleLockfile, ensureProjectEntryAndUpdate, updateLastModifiedIfExists, } from './lib.js';
+export { LaunchOptions, LaunchResolvedOptions, UnityProcessInfo, OrchestrateOptions, OrchestrateResult, parseArgs, findUnityProjectBfs, getUnityVersion, launch, orchestrateLaunch, findRunningUnityProcess, focusUnityProcess, killRunningUnity, quitRunningUnity, handleStaleLockfile, ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs, groupCliArgs, } from './lib.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAEhB,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,MAAM,EACN,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAEjB,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -5,4 +5,4 @@
  */
 export { 
 // Functions
-parseArgs, findUnityProjectBfs, getUnityVersion, launch, findRunningUnityProcess, focusUnityProcess, killRunningUnity, handleStaleLockfile, ensureProjectEntryAndUpdate, updateLastModifiedIfExists, } from './lib.js';
+parseArgs, findUnityProjectBfs, getUnityVersion, launch, orchestrateLaunch, findRunningUnityProcess, focusUnityProcess, killRunningUnity, quitRunningUnity, handleStaleLockfile, ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs, groupCliArgs, } from './lib.js';

package/dist/launch.d.ts

@@ -1,30 +1,3 @@
 #!/usr/bin/env node
-export type LaunchOptions = {
-    subcommand?: "update";
-    projectPath?: string;
-    platform?: string | undefined;
-    unityArgs: string[];
-    searchMaxDepth: number;
-    restart: boolean;
-    addUnityHub: boolean;
-    favoriteUnityHub: boolean;
-};
-export type LaunchResolvedOptions = {
-    projectPath: string;
-    platform?: string | undefined;
-    unityArgs: string[];
-    unityVersion: string;
-};
-export type UnityProcessInfo = {
-    pid: number;
-    projectPath: string;
-};
-export declare function parseArgs(argv: string[]): LaunchOptions;
-export declare function getUnityVersion(projectPath: string): string;
-export declare function findRunningUnityProcess(projectPath: string): Promise<UnityProcessInfo | undefined>;
-export declare function focusUnityProcess(pid: number): Promise<void>;
-export declare function handleStaleLockfile(projectPath: string): Promise<void>;
-export declare function killRunningUnity(projectPath: string): Promise<void>;
-export declare function findUnityProjectBfs(rootDir: string, maxDepth: number): string | undefined;
-export declare function launch(opts: LaunchResolvedOptions): Promise<void>;
+export {};
 //# sourceMappingURL=launch.d.ts.map

package/dist/launch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":";AAeA,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAyJF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAqHvD;AAyCD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAe3D;AA2ND,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAIxG;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;AA4CD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB5E;AAiCD,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBzE;AAgDD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqDzF;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCvE"}
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":""}

package/dist/launch.js

@@ -3,22 +3,11 @@
   launch-unity: Open a Unity project with the matching Editor version.
   Platforms: macOS, Windows
 */
-import { execFile, spawn } from "node:child_process";
-import { existsSync, readFileSync, readdirSync, lstatSync, realpathSync } from "node:fs";
-import { rm } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { readFileSync, realpathSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { promisify } from "node:util";
-import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs } from "./unityHub.js";
-const execFileAsync = promisify(execFile);
-const UNITY_EXECUTABLE_PATTERN_MAC = /Unity\.app\/Contents\/MacOS\/Unity/i;
-const UNITY_EXECUTABLE_PATTERN_WINDOWS = /Unity\.exe/i;
-const PROJECT_PATH_PATTERN = /-(?:projectPath|projectpath)(?:=|\s+)("[^"]+"|'[^']+'|[^\s"']+)/i;
-const PROCESS_LIST_COMMAND_MAC = "ps";
-const PROCESS_LIST_ARGS_MAC = ["-axo", "pid=,command=", "-ww"];
-const WINDOWS_POWERSHELL = "powershell";
-const UNITY_LOCKFILE_NAME = "UnityLockfile";
-const TEMP_DIRECTORY_NAME = "Temp";
+import { orchestrateLaunch } from "./lib.js";
 const npmExecutableName = () => {
     return process.platform === "win32" ? "npm.cmd" : "npm";
 };
@@ -130,7 +119,7 @@ const compareSemverTriplet = (left, right) => {
     }
     return 0;
 };
-export function parseArgs(argv) {
+function parseArgs(argv) {
     const args = argv.slice(2);
     const doubleDashIndex = args.indexOf("--");
     let cliArgs = doubleDashIndex >= 0 ? args.slice(0, doubleDashIndex) : args;
@@ -144,6 +133,7 @@ export function parseArgs(argv) {
     const positionals = [];
     let maxDepth = 3; // default 3; -1 means unlimited
     let restart = false;
+    let quit = false;
     let addUnityHub = false;
     let favoriteUnityHub = false;
     let platform;
@@ -161,6 +151,10 @@ export function parseArgs(argv) {
             restart = true;
             continue;
         }
+        if (arg === "-q" || arg === "--quit") {
+            quit = true;
+            continue;
+        }
         if (arg === "-u" ||
             arg === "-a" ||
             arg === "--unity-hub-entry" ||
@@ -226,6 +220,7 @@ export function parseArgs(argv) {
         unityArgs,
         searchMaxDepth: maxDepth,
         restart,
+        quit,
         addUnityHub,
         favoriteUnityHub,
     };
@@ -266,6 +261,7 @@ Options:
   -h, --help          Show this help message
   -v, --version       Show version number
   -r, --restart       Kill running Unity and restart
+  -q, --quit          Quit running Unity gracefully (force-kill on timeout)
   -p, --platform <P>  Passed to Unity as -buildTarget (e.g., StandaloneOSX, Android, iOS)
   --max-depth <N>     Search depth when PROJECT_PATH is omitted (default 3, -1 unlimited)
   -u, -a, --unity-hub-entry, --add-unity-hub
@@ -277,516 +273,25 @@ Commands:
 `;
     process.stdout.write(help);
 }
-export function getUnityVersion(projectPath) {
-    const versionFile = join(projectPath, "ProjectSettings", "ProjectVersion.txt");
-    if (!existsSync(versionFile)) {
-        console.error(`Error: ProjectVersion.txt not found at ${versionFile}`);
-        console.error("This does not appear to be a Unity project.");
-        process.exit(1);
-    }
-    const content = readFileSync(versionFile, "utf8");
-    const version = content.match(/m_EditorVersion:\s*([^\s\n]+)/)?.[1];
-    if (!version) {
-        console.error(`Error: Could not extract Unity version from ${versionFile}`);
-        process.exit(1);
-    }
-    return version;
-}
-function getUnityPathWindows(version) {
-    const candidates = [];
-    const programFiles = process.env["PROGRAMFILES"];
-    const programFilesX86 = process.env["PROGRAMFILES(X86)"];
-    const localAppData = process.env["LOCALAPPDATA"];
-    const addCandidate = (base) => {
-        if (!base) {
-            return;
-        }
-        candidates.push(join(base, "Unity", "Hub", "Editor", version, "Editor", "Unity.exe"));
-    };
-    addCandidate(programFiles);
-    addCandidate(programFilesX86);
-    addCandidate(localAppData);
-    candidates.push(join("C:\\", "Program Files", "Unity", "Hub", "Editor", version, "Editor", "Unity.exe"));
-    for (const candidate of candidates) {
-        if (existsSync(candidate)) {
-            return candidate;
-        }
-    }
-    return candidates[0] ?? join("C:\\", "Program Files", "Unity", "Hub", "Editor", version, "Editor", "Unity.exe");
-}
-function getUnityPath(version) {
-    if (process.platform === "darwin") {
-        return `/Applications/Unity/Hub/Editor/${version}/Unity.app/Contents/MacOS/Unity`;
-    }
-    if (process.platform === "win32") {
-        return getUnityPathWindows(version);
-    }
-    return `/Applications/Unity/Hub/Editor/${version}/Unity.app/Contents/MacOS/Unity`;
-}
-function ensureProjectPath(projectPath) {
-    if (!existsSync(projectPath)) {
-        console.error(`Error: Project directory not found: ${projectPath}`);
-        process.exit(1);
-    }
-}
-const removeTrailingSeparators = (target) => {
-    let trimmed = target;
-    while (trimmed.length > 1 && (trimmed.endsWith("/") || trimmed.endsWith("\\"))) {
-        trimmed = trimmed.slice(0, -1);
-    }
-    return trimmed;
-};
-const normalizePath = (target) => {
-    const resolvedPath = resolve(target);
-    const trimmed = removeTrailingSeparators(resolvedPath);
-    return trimmed;
-};
-const toComparablePath = (value) => {
-    return value.replace(/\\/g, "/").toLocaleLowerCase();
-};
-const pathsEqual = (left, right) => {
-    return toComparablePath(normalizePath(left)) === toComparablePath(normalizePath(right));
-};
-function extractProjectPath(command) {
-    const match = command.match(PROJECT_PATH_PATTERN);
-    if (!match) {
-        return undefined;
-    }
-    const raw = match[1];
-    if (!raw) {
-        return undefined;
-    }
-    const trimmed = raw.trim();
-    if (trimmed.startsWith("\"") && trimmed.endsWith("\"")) {
-        return trimmed.slice(1, -1);
-    }
-    if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
-        return trimmed.slice(1, -1);
-    }
-    return trimmed;
-}
-const isUnityAuxiliaryProcess = (command) => {
-    const normalizedCommand = command.toLowerCase();
-    if (normalizedCommand.includes("-batchmode")) {
-        return true;
-    }
-    return normalizedCommand.includes("assetimportworker");
-};
-async function listUnityProcessesMac() {
-    let stdout = "";
-    try {
-        const result = await execFileAsync(PROCESS_LIST_COMMAND_MAC, PROCESS_LIST_ARGS_MAC);
-        stdout = result.stdout;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Failed to retrieve Unity process list: ${message}`);
-        return [];
-    }
-    const lines = stdout
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-    const processes = [];
-    for (const line of lines) {
-        const match = line.match(/^(\d+)\s+(.*)$/);
-        if (!match) {
-            continue;
-        }
-        const pidValue = Number.parseInt(match[1] ?? "", 10);
-        if (!Number.isFinite(pidValue)) {
-            continue;
-        }
-        const command = match[2] ?? "";
-        if (!UNITY_EXECUTABLE_PATTERN_MAC.test(command)) {
-            continue;
-        }
-        if (isUnityAuxiliaryProcess(command)) {
-            continue;
-        }
-        const projectArgument = extractProjectPath(command);
-        if (!projectArgument) {
-            continue;
-        }
-        processes.push({
-            pid: pidValue,
-            projectPath: normalizePath(projectArgument),
-        });
-    }
-    return processes;
-}
-async function listUnityProcessesWindows() {
-    const scriptLines = [
-        "$ErrorActionPreference = 'Stop'",
-        "$processes = Get-CimInstance Win32_Process -Filter \"Name = 'Unity.exe'\" | Where-Object { $_.CommandLine }",
-        "foreach ($process in $processes) {",
-        "  $commandLine = $process.CommandLine -replace \"`r\", ' ' -replace \"`n\", ' '",
-        "  Write-Output (\"{0}|{1}\" -f $process.ProcessId, $commandLine)",
-        "}",
-    ];
-    let stdout = "";
-    try {
-        const result = await execFileAsync(WINDOWS_POWERSHELL, ["-NoProfile", "-Command", scriptLines.join("\n")]);
-        stdout = result.stdout ?? "";
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Failed to retrieve Unity process list on Windows: ${message}`);
-        return [];
-    }
-    const lines = stdout
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-    const processes = [];
-    for (const line of lines) {
-        const delimiterIndex = line.indexOf("|");
-        if (delimiterIndex < 0) {
-            continue;
-        }
-        const pidText = line.slice(0, delimiterIndex).trim();
-        const command = line.slice(delimiterIndex + 1).trim();
-        const pidValue = Number.parseInt(pidText, 10);
-        if (!Number.isFinite(pidValue)) {
-            continue;
-        }
-        if (!UNITY_EXECUTABLE_PATTERN_WINDOWS.test(command)) {
-            continue;
-        }
-        if (isUnityAuxiliaryProcess(command)) {
-            continue;
-        }
-        const projectArgument = extractProjectPath(command);
-        if (!projectArgument) {
-            continue;
-        }
-        processes.push({
-            pid: pidValue,
-            projectPath: normalizePath(projectArgument),
-        });
-    }
-    return processes;
-}
-async function listUnityProcesses() {
-    if (process.platform === "darwin") {
-        return await listUnityProcessesMac();
-    }
-    if (process.platform === "win32") {
-        return await listUnityProcessesWindows();
-    }
-    return [];
-}
-export async function findRunningUnityProcess(projectPath) {
-    const normalizedTarget = normalizePath(projectPath);
-    const processes = await listUnityProcesses();
-    return processes.find((candidate) => pathsEqual(candidate.projectPath, normalizedTarget));
-}
-export async function focusUnityProcess(pid) {
-    if (process.platform === "darwin") {
-        await focusUnityProcessMac(pid);
-        return;
-    }
-    if (process.platform === "win32") {
-        await focusUnityProcessWindows(pid);
-    }
-}
-async function focusUnityProcessMac(pid) {
-    const script = `tell application "System Events" to set frontmost of (first process whose unix id is ${pid}) to true`;
-    try {
-        await execFileAsync("osascript", ["-e", script]);
-        console.log("Brought existing Unity to the front.");
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`Failed to bring Unity to front: ${message}`);
-    }
-}
-async function focusUnityProcessWindows(pid) {
-    const addTypeLines = [
-        "Add-Type -TypeDefinition @\"",
-        "using System;",
-        "using System.Runtime.InteropServices;",
-        "public static class Win32Interop {",
-        "  [DllImport(\"user32.dll\")] public static extern bool SetForegroundWindow(IntPtr hWnd);",
-        "  [DllImport(\"user32.dll\")] public static extern bool ShowWindowAsync(IntPtr hWnd, int nCmdShow);",
-        "}",
-        "\"@",
-    ];
-    const scriptLines = [
-        "$ErrorActionPreference = 'Stop'",
-        ...addTypeLines,
-        `try { $process = Get-Process -Id ${pid} -ErrorAction Stop } catch { return }`,
-        "$handle = $process.MainWindowHandle",
-        "if ($handle -eq 0) { return }",
-        "[Win32Interop]::ShowWindowAsync($handle, 9) | Out-Null",
-        "[Win32Interop]::SetForegroundWindow($handle) | Out-Null",
-    ];
-    try {
-        await execFileAsync(WINDOWS_POWERSHELL, ["-NoProfile", "-Command", scriptLines.join("\n")]);
-        console.log("Brought existing Unity to the front.");
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`Failed to bring Unity to front on Windows: ${message}`);
-    }
-}
-export async function handleStaleLockfile(projectPath) {
-    const tempDirectoryPath = join(projectPath, TEMP_DIRECTORY_NAME);
-    const lockfilePath = join(tempDirectoryPath, UNITY_LOCKFILE_NAME);
-    if (!existsSync(lockfilePath)) {
-        return;
-    }
-    console.log(`UnityLockfile found without active Unity process: ${lockfilePath}`);
-    console.log("Assuming previous crash. Cleaning Temp directory and continuing launch.");
-    try {
-        await rm(tempDirectoryPath, { recursive: true, force: true });
-        console.log("Deleted Temp directory.");
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`Failed to delete Temp directory: ${message}`);
-    }
-    try {
-        await rm(lockfilePath, { force: true });
-        console.log("Deleted UnityLockfile.");
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`Failed to delete UnityLockfile: ${message}`);
-    }
-}
-const KILL_POLL_INTERVAL_MS = 100;
-const KILL_TIMEOUT_MS = 10000;
-function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function killProcess(pid) {
-    try {
-        process.kill(pid, "SIGKILL");
-    }
-    catch {
-        // Process already exited
-    }
-}
-async function waitForProcessExit(pid) {
-    const start = Date.now();
-    while (Date.now() - start < KILL_TIMEOUT_MS) {
-        if (!isProcessAlive(pid)) {
-            return true;
-        }
-        await new Promise((resolve) => setTimeout(resolve, KILL_POLL_INTERVAL_MS));
-    }
-    return false;
-}
-export async function killRunningUnity(projectPath) {
-    const processInfo = await findRunningUnityProcess(projectPath);
-    if (!processInfo) {
-        console.log("No running Unity process found for this project.");
-        return;
-    }
-    const pid = processInfo.pid;
-    console.log(`Killing Unity (PID: ${pid})...`);
-    killProcess(pid);
-    const exited = await waitForProcessExit(pid);
-    if (!exited) {
-        console.error(`Error: Failed to kill Unity (PID: ${pid}) within ${KILL_TIMEOUT_MS / 1000}s.`);
-        process.exit(1);
-    }
-    console.log("Unity killed.");
-}
-function hasBuildTargetArg(unityArgs) {
-    for (const arg of unityArgs) {
-        if (arg === "-buildTarget") {
-            return true;
-        }
-        if (arg.startsWith("-buildTarget=")) {
-            return true;
-        }
-    }
-    return false;
-}
-const EXCLUDED_DIR_NAMES = new Set([
-    "library",
-    "temp",
-    "logs",
-    "obj",
-    ".git",
-    "node_modules",
-    ".idea",
-    ".vscode",
-    ".vs",
-]);
-function isUnityProjectRoot(candidateDir) {
-    const versionFile = join(candidateDir, "ProjectSettings", "ProjectVersion.txt");
-    return existsSync(versionFile);
-}
-function listSubdirectoriesSorted(dir) {
-    let entries = [];
-    try {
-        const dirents = readdirSync(dir, { withFileTypes: true });
-        const subdirs = dirents
-            .filter((d) => d.isDirectory())
-            .map((d) => d.name)
-            .filter((name) => !EXCLUDED_DIR_NAMES.has(name.toLocaleLowerCase()));
-        subdirs.sort((a, b) => a.localeCompare(b));
-        entries = subdirs.map((name) => join(dir, name));
-    }
-    catch {
-        // Ignore directories we cannot read
-        entries = [];
-    }
-    return entries;
-}
-export function findUnityProjectBfs(rootDir, maxDepth) {
-    const queue = [];
-    let rootCanonical;
-    try {
-        rootCanonical = realpathSync(rootDir);
-    }
-    catch {
-        rootCanonical = rootDir;
-    }
-    queue.push({ dir: rootCanonical, depth: 0 });
-    const visited = new Set([toComparablePath(normalizePath(rootCanonical))]);
-    while (queue.length > 0) {
-        const current = queue.shift();
-        if (!current) {
-            continue;
-        }
-        const { dir, depth } = current;
-        if (isUnityProjectRoot(dir)) {
-            return normalizePath(dir);
-        }
-        const canDescend = maxDepth === -1 || depth < maxDepth;
-        if (!canDescend) {
-            continue;
-        }
-        const children = listSubdirectoriesSorted(dir);
-        for (const child of children) {
-            let childCanonical = child;
-            try {
-                const stat = lstatSync(child);
-                if (stat.isSymbolicLink()) {
-                    try {
-                        childCanonical = realpathSync(child);
-                    }
-                    catch {
-                        // Broken symlink: skip
-                        continue;
-                    }
-                }
-            }
-            catch {
-                continue;
-            }
-            const key = toComparablePath(normalizePath(childCanonical));
-            if (visited.has(key)) {
-                continue;
-            }
-            visited.add(key);
-            queue.push({ dir: childCanonical, depth: depth + 1 });
-        }
-    }
-    return undefined;
-}
-export async function launch(opts) {
-    const { projectPath, platform, unityArgs, unityVersion } = opts;
-    const unityPath = getUnityPath(unityVersion);
-    console.log(`Detected Unity version: ${unityVersion}`);
-    if (!existsSync(unityPath)) {
-        console.error(`Error: Unity ${unityVersion} not found at ${unityPath}`);
-        console.error("Please install Unity through Unity Hub.");
-        process.exit(1);
-    }
-    console.log("Opening Unity...");
-    console.log(`Project Path: ${projectPath}`);
-    const args = ["-projectPath", projectPath];
-    const unityArgsContainBuildTarget = hasBuildTargetArg(unityArgs);
-    if (platform && platform.length > 0 && !unityArgsContainBuildTarget) {
-        args.push("-buildTarget", platform);
-    }
-    const hubCliArgs = await getProjectCliArgs(projectPath);
-    if (hubCliArgs.length > 0) {
-        args.push(...hubCliArgs);
-    }
-    if (unityArgs.length > 0) {
-        args.push(...unityArgs);
-    }
-    const child = spawn(unityPath, args, { stdio: "ignore", detached: true });
-    child.unref();
-}
 async function main() {
     const options = parseArgs(process.argv);
     if (options.subcommand === "update") {
         await runSelfUpdate();
         return;
     }
-    let resolvedProjectPath = options.projectPath;
-    if (!resolvedProjectPath) {
-        const searchRoot = process.cwd();
-        const depthInfo = options.searchMaxDepth === -1 ? "unlimited" : String(options.searchMaxDepth);
-        console.log(`No PROJECT_PATH provided. Searching under ${searchRoot} (max-depth: ${depthInfo})...`);
-        const found = findUnityProjectBfs(searchRoot, options.searchMaxDepth);
-        if (!found) {
-            console.error(`Error: Unity project not found under ${searchRoot}.`);
-            process.exit(1);
-            return;
-        }
-        console.log(`Selected project: ${found}`);
-        resolvedProjectPath = found;
-    }
-    ensureProjectPath(resolvedProjectPath);
-    const unityVersion = getUnityVersion(resolvedProjectPath);
-    // Unity Hub only mode: -a or -f flags skip launching Unity
-    const unityHubOnlyMode = options.addUnityHub || options.favoriteUnityHub;
-    if (unityHubOnlyMode) {
-        console.log(`Detected Unity version: ${unityVersion}`);
-        console.log(`Project Path: ${resolvedProjectPath}`);
-        const now = new Date();
-        try {
-            await ensureProjectEntryAndUpdate(resolvedProjectPath, unityVersion, now, options.favoriteUnityHub);
-            console.log("Unity Hub entry updated.");
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.warn(`Failed to update Unity Hub: ${message}`);
-        }
-        return;
-    }
-    if (options.restart) {
-        await killRunningUnity(resolvedProjectPath);
-    }
-    else {
-        const runningProcess = await findRunningUnityProcess(resolvedProjectPath);
-        if (runningProcess) {
-            console.log(`Unity process already running for project: ${resolvedProjectPath} (PID: ${runningProcess.pid})`);
-            await focusUnityProcess(runningProcess.pid);
-            process.exit(0);
-            return;
-        }
-    }
-    await handleStaleLockfile(resolvedProjectPath);
-    const resolved = {
-        projectPath: resolvedProjectPath,
+    const result = await orchestrateLaunch({
+        projectPath: options.projectPath,
+        searchRoot: process.cwd(),
+        searchMaxDepth: options.searchMaxDepth,
         platform: options.platform,
         unityArgs: options.unityArgs,
-        unityVersion,
-    };
-    await launch(resolved);
-    // Best-effort update of Unity Hub's lastModified timestamp.
-    const now = new Date();
-    try {
-        await updateLastModifiedIfExists(resolvedProjectPath, now);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`Failed to update Unity Hub lastModified: ${message}`);
+        restart: options.restart,
+        quit: options.quit,
+        addUnityHub: options.addUnityHub,
+        favoriteUnityHub: options.favoriteUnityHub,
+    });
+    if (result.action === "focused") {
+        process.exit(0);
     }
 }
 async function runSelfUpdate() {

package/dist/lib.d.ts

@@ -2,7 +2,7 @@
  * launch-unity core library functions.
  * Pure library code without CLI entry point or side effects.
  */
-import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs } from "./unityHub.js";
+import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs, groupCliArgs } from "./unityHub.js";
 export type LaunchOptions = {
     subcommand?: "update";
     projectPath?: string;
@@ -10,6 +10,7 @@ export type LaunchOptions = {
     unityArgs: string[];
     searchMaxDepth: number;
     restart: boolean;
+    quit: boolean;
     addUnityHub: boolean;
     favoriteUnityHub: boolean;
 };
@@ -29,7 +30,40 @@ export declare function findRunningUnityProcess(projectPath: string): Promise<Un
 export declare function focusUnityProcess(pid: number): Promise<void>;
 export declare function handleStaleLockfile(projectPath: string): Promise<void>;
 export declare function killRunningUnity(projectPath: string): Promise<void>;
+export declare function quitRunningUnity(projectPath: string): Promise<void>;
 export declare function findUnityProjectBfs(rootDir: string, maxDepth: number): string | undefined;
 export declare function launch(opts: LaunchResolvedOptions): Promise<void>;
-export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs };
+export type OrchestrateOptions = {
+    projectPath?: string | undefined;
+    searchRoot: string;
+    searchMaxDepth: number;
+    platform?: string | undefined;
+    unityArgs: string[];
+    restart: boolean;
+    quit: boolean;
+    addUnityHub: boolean;
+    favoriteUnityHub: boolean;
+};
+export type OrchestrateResult = {
+    action: "launched";
+    projectPath: string;
+    unityVersion: string;
+} | {
+    action: "focused";
+    projectPath: string;
+    pid: number;
+} | {
+    action: "quit";
+    projectPath: string;
+} | {
+    action: "killed-and-launched";
+    projectPath: string;
+    unityVersion: string;
+} | {
+    action: "hub-updated";
+    projectPath: string;
+    unityVersion: string;
+};
+export declare function orchestrateLaunch(options: OrchestrateOptions): Promise<OrchestrateResult>;
+export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs, groupCliArgs };
 //# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAYF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAmHvD;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAc3D;AAoND,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAIxG;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;AA4CD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB5E;AAiCD,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBzE;AAgDD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqDzF;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCvE;AAGD,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"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"}

package/dist/lib.js

@@ -7,7 +7,7 @@ import { existsSync, readFileSync, readdirSync, lstatSync, realpathSync } from "
 import { rm } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { promisify } from "node:util";
-import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs } from "./unityHub.js";
+import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs, groupCliArgs } from "./unityHub.js";
 const execFileAsync = promisify(execFile);
 const UNITY_EXECUTABLE_PATTERN_MAC = /Unity\.app\/Contents\/MacOS\/Unity/i;
 const UNITY_EXECUTABLE_PATTERN_WINDOWS = /Unity\.exe/i;
@@ -31,6 +31,7 @@ export function parseArgs(argv) {
     const positionals = [];
     let maxDepth = 3; // default 3; -1 means unlimited
     let restart = false;
+    let quit = false;
     let addUnityHub = false;
     let favoriteUnityHub = false;
     let platform;
@@ -46,6 +47,10 @@ export function parseArgs(argv) {
             restart = true;
             continue;
         }
+        if (arg === "-q" || arg === "--quit") {
+            quit = true;
+            continue;
+        }
         if (arg === "-u" ||
             arg === "-a" ||
             arg === "--unity-hub-entry" ||
@@ -111,6 +116,7 @@ export function parseArgs(argv) {
         unityArgs,
         searchMaxDepth: maxDepth,
         restart,
+        quit,
         addUnityHub,
         favoriteUnityHub,
     };
@@ -393,9 +399,11 @@ export async function handleStaleLockfile(projectPath) {
         const message = error instanceof Error ? error.message : String(error);
         console.warn(`Failed to delete UnityLockfile: ${message}`);
     }
+    console.log();
 }
 const KILL_POLL_INTERVAL_MS = 100;
 const KILL_TIMEOUT_MS = 10000;
+const GRACEFUL_QUIT_TIMEOUT_MS = 10000;
 function isProcessAlive(pid) {
     try {
         process.kill(pid, 0);
@@ -413,9 +421,9 @@ function killProcess(pid) {
         // Process already exited
     }
 }
-async function waitForProcessExit(pid) {
+async function waitForProcessExit(pid, timeoutMs) {
     const start = Date.now();
-    while (Date.now() - start < KILL_TIMEOUT_MS) {
+    while (Date.now() - start < timeoutMs) {
         if (!isProcessAlive(pid)) {
             return true;
         }
@@ -427,16 +435,80 @@ export async function killRunningUnity(projectPath) {
     const processInfo = await findRunningUnityProcess(projectPath);
     if (!processInfo) {
         console.log("No running Unity process found for this project.");
+        console.log();
         return;
     }
     const pid = processInfo.pid;
     console.log(`Killing Unity (PID: ${pid})...`);
     killProcess(pid);
-    const exited = await waitForProcessExit(pid);
+    const exited = await waitForProcessExit(pid, KILL_TIMEOUT_MS);
     if (!exited) {
         throw new Error(`Failed to kill Unity (PID: ${pid}) within ${KILL_TIMEOUT_MS / 1000}s.`);
     }
     console.log("Unity killed.");
+    console.log();
+}
+async function sendGracefulQuitMac(pid) {
+    // System Events quit and "tell application to quit" leave UnityLockfile behind,
+    // so we send Cmd+Q keystroke to trigger Unity's normal user-initiated shutdown flow
+    const script = [
+        'tell application "System Events"',
+        `  set frontmost of (first process whose unix id is ${pid}) to true`,
+        '  keystroke "q" using {command down}',
+        "end tell",
+    ].join("\n");
+    try {
+        await execFileAsync("osascript", ["-e", script]);
+    }
+    catch {
+        // Process may have already exited
+    }
+}
+async function sendGracefulQuitWindows(pid) {
+    // process.kill(pid, "SIGTERM") forcefully kills on Windows, so use CloseMainWindow() to send WM_CLOSE
+    const scriptLines = [
+        "$ErrorActionPreference = 'Stop'",
+        `try { $proc = Get-Process -Id ${pid} -ErrorAction Stop; $proc.CloseMainWindow() | Out-Null } catch { }`,
+    ];
+    try {
+        await execFileAsync(WINDOWS_POWERSHELL, ["-NoProfile", "-Command", scriptLines.join("\n")]);
+    }
+    catch {
+        // Process may have already exited
+    }
+}
+async function sendGracefulQuit(pid) {
+    if (process.platform === "darwin") {
+        await sendGracefulQuitMac(pid);
+        return;
+    }
+    if (process.platform === "win32") {
+        await sendGracefulQuitWindows(pid);
+        return;
+    }
+}
+export async function quitRunningUnity(projectPath) {
+    const processInfo = await findRunningUnityProcess(projectPath);
+    if (!processInfo) {
+        console.log("No running Unity process found for this project.");
+        return;
+    }
+    const pid = processInfo.pid;
+    console.log(`Quitting Unity (PID: ${pid})...`);
+    await sendGracefulQuit(pid);
+    console.log(`Sent graceful quit signal. Waiting up to ${GRACEFUL_QUIT_TIMEOUT_MS / 1000}s...`);
+    const exitedGracefully = await waitForProcessExit(pid, GRACEFUL_QUIT_TIMEOUT_MS);
+    if (exitedGracefully) {
+        console.log("Unity quit gracefully.");
+        return;
+    }
+    console.log("Unity did not respond to graceful quit. Force killing...");
+    killProcess(pid);
+    const exitedAfterKill = await waitForProcessExit(pid, KILL_TIMEOUT_MS);
+    if (!exitedAfterKill) {
+        throw new Error(`Failed to kill Unity (PID: ${pid}) within ${KILL_TIMEOUT_MS / 1000}s.`);
+    }
+    console.log("Unity force killed.");
 }
 function hasBuildTargetArg(unityArgs) {
     for (const arg of unityArgs) {
@@ -536,12 +608,12 @@ export function findUnityProjectBfs(rootDir, maxDepth) {
 export async function launch(opts) {
     const { projectPath, platform, unityArgs, unityVersion } = opts;
     const unityPath = getUnityPath(unityVersion);
-    console.log(`Detected Unity version: ${unityVersion}`);
     if (!existsSync(unityPath)) {
         throw new Error(`Unity ${unityVersion} not found at ${unityPath}. Please install Unity through Unity Hub.`);
     }
     console.log("Opening Unity...");
     console.log(`Project Path: ${projectPath}`);
+    console.log(`Detected Unity version: ${unityVersion}`);
     const args = ["-projectPath", projectPath];
     const unityArgsContainBuildTarget = hasBuildTargetArg(unityArgs);
     if (platform && platform.length > 0 && !unityArgsContainBuildTarget) {
@@ -549,13 +621,103 @@ export async function launch(opts) {
     }
     const hubCliArgs = await getProjectCliArgs(projectPath);
     if (hubCliArgs.length > 0) {
+        console.log("Unity Hub launch options:");
+        for (const line of groupCliArgs(hubCliArgs)) {
+            console.log(`  ${line}`);
+        }
         args.push(...hubCliArgs);
     }
+    else {
+        console.log("Unity Hub launch options: none");
+    }
     if (unityArgs.length > 0) {
         args.push(...unityArgs);
     }
-    const child = spawn(unityPath, args, { stdio: "ignore", detached: true });
-    child.unref();
+    return new Promise((resolve, reject) => {
+        const child = spawn(unityPath, args, {
+            stdio: "ignore",
+            detached: true,
+            // Git Bash (MSYS) がWindows パスをUnix 形式に自動変換するのを防ぐ
+            env: {
+                ...process.env,
+                MSYS_NO_PATHCONV: "1",
+            },
+        });
+        const handleError = (error) => {
+            child.removeListener("spawn", handleSpawn);
+            reject(new Error(`Failed to launch Unity: ${error.message}`));
+        };
+        const handleSpawn = () => {
+            child.removeListener("error", handleError);
+            child.unref();
+            resolve();
+        };
+        child.once("error", handleError);
+        child.once("spawn", handleSpawn);
+    });
+}
+export async function orchestrateLaunch(options) {
+    if (options.quit && options.restart) {
+        throw new Error("--quit and --restart cannot be used together.");
+    }
+    let resolvedProjectPath = options.projectPath;
+    if (!resolvedProjectPath) {
+        const depthInfo = options.searchMaxDepth === -1 ? "unlimited" : String(options.searchMaxDepth);
+        console.log(`Searching for Unity project under ${options.searchRoot} (max-depth: ${depthInfo})...`);
+        const found = findUnityProjectBfs(options.searchRoot, options.searchMaxDepth);
+        if (!found) {
+            throw new Error(`Unity project not found under ${options.searchRoot}.`);
+        }
+        console.log();
+        resolvedProjectPath = found;
+    }
+    if (!existsSync(resolvedProjectPath)) {
+        throw new Error(`Project directory not found: ${resolvedProjectPath}`);
+    }
+    const unityVersion = getUnityVersion(resolvedProjectPath);
+    if (options.addUnityHub || options.favoriteUnityHub) {
+        console.log(`Detected Unity version: ${unityVersion}`);
+        console.log(`Project Path: ${resolvedProjectPath}`);
+        const now = new Date();
+        await ensureProjectEntryAndUpdate(resolvedProjectPath, unityVersion, now, options.favoriteUnityHub);
+        console.log("Unity Hub entry updated.");
+        return { action: "hub-updated", projectPath: resolvedProjectPath, unityVersion };
+    }
+    if (options.quit) {
+        await quitRunningUnity(resolvedProjectPath);
+        return { action: "quit", projectPath: resolvedProjectPath };
+    }
+    const isRestart = options.restart;
+    if (isRestart) {
+        await killRunningUnity(resolvedProjectPath);
+    }
+    else {
+        const runningProcess = await findRunningUnityProcess(resolvedProjectPath);
+        if (runningProcess) {
+            console.log(`Unity process already running for project: ${resolvedProjectPath} (PID: ${runningProcess.pid})`);
+            await focusUnityProcess(runningProcess.pid);
+            return { action: "focused", projectPath: resolvedProjectPath, pid: runningProcess.pid };
+        }
+    }
+    await handleStaleLockfile(resolvedProjectPath);
+    const resolved = {
+        projectPath: resolvedProjectPath,
+        platform: options.platform,
+        unityArgs: options.unityArgs,
+        unityVersion,
+    };
+    await launch(resolved);
+    // Hub timestamp update is non-critical external I/O; failure should not block after successful launch
+    const now = new Date();
+    try {
+        await updateLastModifiedIfExists(resolvedProjectPath, now);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Failed to update Unity Hub lastModified: ${message}`);
+    }
+    const action = isRestart ? "killed-and-launched" : "launched";
+    return { action, projectPath: resolvedProjectPath, unityVersion };
 }
 // Re-export Unity Hub functions
-export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs };
+export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs, groupCliArgs };

package/dist/unityHub.d.ts

@@ -1,5 +1,6 @@
 export declare const ensureProjectEntryAndUpdate: (projectPath: string, version: string, when: Date, setFavorite?: boolean) => Promise<void>;
 export declare const updateLastModifiedIfExists: (projectPath: string, when: Date) => Promise<void>;
 export declare const parseCliArgs: (cliArgsString: string) => string[];
+export declare const groupCliArgs: (args: readonly string[]) => string[];
 export declare const getProjectCliArgs: (projectPath: string) => Promise<string[]>;
 //# sourceMappingURL=unityHub.d.ts.map

package/dist/unityHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unityHub.d.ts","sourceRoot":"","sources":["../src/unityHub.ts"],"names":[],"mappings":"AAwFA,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,EACnB,SAAS,MAAM,EACf,MAAM,IAAI,EACV,qBAAmB,KAClB,OAAO,CAAC,IAAI,CAgEd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,aAAa,MAAM,EACnB,MAAM,IAAI,KACT,OAAO,CAAC,IAAI,CAuDd,CAAC;AAoBF,eAAO,MAAM,YAAY,GAAI,eAAe,MAAM,KAAG,MAAM,EA6C1D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CA8C7E,CAAC"}
+{"version":3,"file":"unityHub.d.ts","sourceRoot":"","sources":["../src/unityHub.ts"],"names":[],"mappings":"AAwFA,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,EACnB,SAAS,MAAM,EACf,MAAM,IAAI,EACV,qBAAmB,KAClB,OAAO,CAAC,IAAI,CAgEd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,aAAa,MAAM,EACnB,MAAM,IAAI,KACT,OAAO,CAAC,IAAI,CAuDd,CAAC;AAoBF,eAAO,MAAM,YAAY,GAAI,eAAe,MAAM,KAAG,MAAM,EA6C1D,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,MAAM,SAAS,MAAM,EAAE,KAAG,MAAM,EAiB5D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CA8C7E,CAAC"}

package/dist/unityHub.js

@@ -225,6 +225,27 @@ export const parseCliArgs = (cliArgsString) => {
     }
     return tokens;
 };
+// "-flag value" pairs are grouped into single strings for display (e.g. ["-foo", "bar", "-baz", "qux"] -> ["-foo bar", "-baz qux"])
+export const groupCliArgs = (args) => {
+    const groups = [];
+    let current = "";
+    for (const arg of args) {
+        if (arg.startsWith("-") && current.length > 0) {
+            groups.push(current);
+            current = arg;
+        }
+        else if (current.length === 0) {
+            current = arg;
+        }
+        else {
+            current += ` ${arg}`;
+        }
+    }
+    if (current.length > 0) {
+        groups.push(current);
+    }
+    return groups;
+};
 export const getProjectCliArgs = async (projectPath) => {
     assert(projectPath !== null && projectPath !== undefined, "projectPath must not be null");
     const infoFilePath = resolveUnityHubProjectsInfoFile();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "launch-unity",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Open a Unity project with the matching Editor version (macOS/Windows)",
   "type": "module",
   "main": "dist/index.js",