launch-unity 0.12.0 → 0.13.0

package/dist/launch.d.ts

@@ -26,5 +26,5 @@ 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): void;
+export declare function launch(opts: LaunchResolvedOptions): Promise<void>;
 //# 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,wBAAgB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CA4BxD"}
+{"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"}

package/dist/launch.js

@@ -9,7 +9,7 @@ import { rm } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { promisify } from "node:util";
-import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists } from "./unityHub.js";
+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;
@@ -695,7 +695,7 @@ export function findUnityProjectBfs(rootDir, maxDepth) {
     }
     return undefined;
 }
-export function launch(opts) {
+export async function launch(opts) {
     const { projectPath, platform, unityArgs, unityVersion } = opts;
     const unityPath = getUnityPath(unityVersion);
     console.log(`Detected Unity version: ${unityVersion}`);
@@ -711,6 +711,10 @@ export function launch(opts) {
     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);
     }
@@ -774,7 +778,7 @@ async function main() {
         unityArgs: options.unityArgs,
         unityVersion,
     };
-    launch(resolved);
+    await launch(resolved);
     // Best-effort update of Unity Hub's lastModified timestamp.
     const now = new Date();
     try {

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 } from "./unityHub.js";
+import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs } from "./unityHub.js";
 export type LaunchOptions = {
     subcommand?: "update";
     projectPath?: string;
@@ -30,6 +30,6 @@ 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): void;
-export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists };
+export declare function launch(opts: LaunchResolvedOptions): Promise<void>;
+export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs };
 //# 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,MAAM,eAAe,CAAC;AAExF,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,wBAAgB,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CA4BxD;AAGD,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,CAAC"}
+{"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"}

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 } from "./unityHub.js";
+import { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs } 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;
@@ -533,7 +533,7 @@ export function findUnityProjectBfs(rootDir, maxDepth) {
     }
     return undefined;
 }
-export function launch(opts) {
+export async function launch(opts) {
     const { projectPath, platform, unityArgs, unityVersion } = opts;
     const unityPath = getUnityPath(unityVersion);
     console.log(`Detected Unity version: ${unityVersion}`);
@@ -547,6 +547,10 @@ export function launch(opts) {
     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);
     }
@@ -554,4 +558,4 @@ export function launch(opts) {
     child.unref();
 }
 // Re-export Unity Hub functions
-export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists };
+export { ensureProjectEntryAndUpdate, updateLastModifiedIfExists, getProjectCliArgs, parseCliArgs };

package/dist/unityHub.d.ts

@@ -1,3 +1,5 @@
 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 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":"AAiFA,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"}
+{"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"}

package/dist/unityHub.js

@@ -1,6 +1,7 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
+import assert from "node:assert";
 const resolveUnityHubProjectFiles = () => {
     if (process.platform === "darwin") {
         const home = process.env.HOME;
@@ -168,3 +169,99 @@ export const updateLastModifiedIfExists = async (projectPath, when) => {
         return;
     }
 };
+const resolveUnityHubProjectsInfoFile = () => {
+    if (process.platform === "darwin") {
+        const home = process.env.HOME;
+        if (!home) {
+            return undefined;
+        }
+        return join(home, "Library", "Application Support", "UnityHub", "projectsInfo.json");
+    }
+    if (process.platform === "win32") {
+        const appData = process.env.APPDATA;
+        if (!appData) {
+            return undefined;
+        }
+        return join(appData, "UnityHub", "projectsInfo.json");
+    }
+    return undefined;
+};
+export const parseCliArgs = (cliArgsString) => {
+    assert(cliArgsString !== null && cliArgsString !== undefined, "cliArgsString must not be null");
+    const trimmed = cliArgsString.trim();
+    if (trimmed.length === 0) {
+        return [];
+    }
+    const tokens = [];
+    let current = "";
+    let inQuote = null;
+    for (const char of trimmed) {
+        if (inQuote !== null) {
+            if (char === inQuote) {
+                tokens.push(current);
+                current = "";
+                inQuote = null;
+            }
+            else {
+                current += char;
+            }
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            inQuote = char;
+            continue;
+        }
+        if (char === " ") {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    return tokens;
+};
+export const getProjectCliArgs = async (projectPath) => {
+    assert(projectPath !== null && projectPath !== undefined, "projectPath must not be null");
+    const infoFilePath = resolveUnityHubProjectsInfoFile();
+    if (!infoFilePath) {
+        logDebug("projectsInfo.json path could not be resolved.");
+        return [];
+    }
+    logDebug(`Reading projectsInfo.json: ${infoFilePath}`);
+    let content;
+    try {
+        content = await readFile(infoFilePath, "utf8");
+    }
+    catch {
+        logDebug("projectsInfo.json not found or not readable.");
+        return [];
+    }
+    let json;
+    try {
+        json = JSON.parse(content);
+    }
+    catch {
+        logDebug("projectsInfo.json parse failed.");
+        return [];
+    }
+    const normalizedProjectPath = normalizePath(projectPath);
+    const projectKey = Object.keys(json).find((key) => pathsEqual(key, normalizedProjectPath));
+    if (!projectKey) {
+        logDebug(`No entry found for project: ${normalizedProjectPath}`);
+        return [];
+    }
+    const projectInfo = json[projectKey];
+    const cliArgsString = projectInfo?.cliArgs;
+    if (!cliArgsString || cliArgsString.trim().length === 0) {
+        logDebug("cliArgs is empty or not defined.");
+        return [];
+    }
+    const parsed = parseCliArgs(cliArgsString);
+    logDebug(`Parsed Unity Hub cliArgs: ${JSON.stringify(parsed)}`);
+    return parsed;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "launch-unity",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Open a Unity project with the matching Editor version (macOS/Windows)",
   "type": "module",
   "main": "dist/index.js",
@@ -45,16 +45,16 @@
     "node": ">=18"
   },
   "devDependencies": {
-    "@types/node": "25.0.10",
-    "@typescript-eslint/eslint-plugin": "8.53.0",
-    "@typescript-eslint/parser": "8.53.0",
+    "@types/node": "25.2.0",
+    "@typescript-eslint/eslint-plugin": "8.54.0",
+    "@typescript-eslint/parser": "8.54.0",
     "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",
     "prettier": "3.8.1",
     "typescript": "5.9.3"
   },
   "dependencies": {
-    "typescript-eslint": "8.53.1"
+    "typescript-eslint": "8.54.0"
   },
   "overrides": {
     "js-yaml": "4.1.1"