@quenty/studio-bridge 0.7.1 → 0.8.0

package/dist/src/linux/linux-fflags.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { writeFflagsAsync } from './linux-fflags.js';
+describe('writeFflagsAsync', () => {
+    let tmpDir;
+    afterEach(async () => {
+        if (tmpDir) {
+            await fs.rm(tmpDir, { recursive: true, force: true });
+        }
+    });
+    function makeConfig() {
+        const clientSettingsPath = path.join(tmpDir, 'ClientSettings', 'ClientAppSettings.json');
+        return {
+            studioDir: tmpDir,
+            winePrefix: '/tmp/fake-wine',
+            display: ':99',
+            studioExe: path.join(tmpDir, 'RobloxStudioBeta.exe'),
+            clientSettingsPath,
+            shadersDir: path.join(tmpDir, 'shaders'),
+            pluginsDir: path.join(tmpDir, 'Plugins'),
+            writeCredExe: path.join(tmpDir, 'write-cred.exe'),
+        };
+    }
+    it('writes valid JSON with all 5 required FFlags', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fflags-test-'));
+        const config = makeConfig();
+        await writeFflagsAsync(config);
+        const content = JSON.parse(await fs.readFile(config.clientSettingsPath, 'utf-8'));
+        expect(content.FFlagDebugGraphicsPreferD3D11).toBe(true);
+        expect(content.FFlagDebugGraphicsDisableVulkan).toBe(true);
+        expect(content.FFlagDebugGraphicsDisableD3D11FL10).toBe(true);
+        expect(content.FFlagDebugGraphicsDisableOpenGL).toBe(true);
+        expect(content.FIntStudioLowMemoryThresholdPercentage).toBe(0);
+    });
+    it('creates parent directories', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fflags-test-'));
+        const config = makeConfig();
+        // Directory shouldn't exist yet
+        await expect(fs.access(path.dirname(config.clientSettingsPath))).rejects.toThrow();
+        await writeFflagsAsync(config);
+        // Now it should
+        await fs.access(path.dirname(config.clientSettingsPath));
+    });
+    it('merges extra flags without dropping defaults', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fflags-test-'));
+        const config = makeConfig();
+        await writeFflagsAsync(config, { FIntCustomFlag: 42 });
+        const content = JSON.parse(await fs.readFile(config.clientSettingsPath, 'utf-8'));
+        expect(content.FIntCustomFlag).toBe(42);
+        expect(content.FFlagDebugGraphicsPreferD3D11).toBe(true);
+    });
+});
+//# sourceMappingURL=linux-fflags.test.js.map

package/dist/src/linux/linux-fflags.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-fflags.test.js","sourceRoot":"","sources":["../../../src/linux/linux-fflags.test.ts"],"names":[],"mappings":"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"}

package/dist/src/linux/linux-prerequisites.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Check system prerequisites for running Studio under Wine on Linux.
+ */
+export interface PrerequisiteResult {
+    name: string;
+    available: boolean;
+    version?: string;
+    hint?: string;
+}
+/**
+ * Check all required tools are present. Returns an array of results
+ * including version strings where parseable.
+ */
+export declare function checkPrerequisites(): PrerequisiteResult[];
+/**
+ * Returns true if all prerequisites are satisfied.
+ */
+export declare function allPrerequisitesMet(): boolean;
+/**
+ * Install missing system dependencies. Requires sudo.
+ * Only runs on Debian/Ubuntu (apt-get).
+ */
+export declare function installDependenciesAsync(): Promise<void>;
+//# sourceMappingURL=linux-prerequisites.d.ts.map

package/dist/src/linux/linux-prerequisites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-prerequisites.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-prerequisites.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAkCD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CAezD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAOD;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoE9D"}

package/dist/src/linux/linux-prerequisites.js

@@ -0,0 +1,118 @@
+/**
+ * Check system prerequisites for running Studio under Wine on Linux.
+ */
+import { execSync } from 'child_process';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+const PREREQUISITES = [
+    {
+        name: 'wine',
+        command: 'wine --version',
+        hint: 'Install Wine 11+: https://wiki.winehq.org/Download',
+    },
+    {
+        name: 'Xvfb',
+        command: 'Xvfb -help 2>&1 | head -1',
+        hint: 'apt-get install xvfb',
+    },
+    {
+        name: 'openbox',
+        command: 'openbox --version',
+        hint: 'apt-get install openbox',
+    },
+    {
+        name: 'x86_64-w64-mingw32-gcc',
+        command: 'x86_64-w64-mingw32-gcc --version',
+        hint: 'apt-get install gcc-mingw-w64-x86-64',
+    },
+    {
+        name: 'unzip',
+        command: 'unzip -v 2>&1 | head -1',
+        hint: 'apt-get install unzip',
+    },
+];
+/**
+ * Check all required tools are present. Returns an array of results
+ * including version strings where parseable.
+ */
+export function checkPrerequisites() {
+    return PREREQUISITES.map(({ name, command, hint }) => {
+        try {
+            const output = execSync(command, {
+                encoding: 'utf-8',
+                timeout: 5000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            const version = extractVersion(output);
+            return { name, available: true, version };
+        }
+        catch {
+            return { name, available: false, hint };
+        }
+    });
+}
+/**
+ * Returns true if all prerequisites are satisfied.
+ */
+export function allPrerequisitesMet() {
+    return checkPrerequisites().every((r) => r.available);
+}
+function extractVersion(output) {
+    const match = output.match(/(\d+\.\d+[\w.-]*)/);
+    return match?.[1];
+}
+/**
+ * Install missing system dependencies. Requires sudo.
+ * Only runs on Debian/Ubuntu (apt-get).
+ */
+export async function installDependenciesAsync() {
+    const { execa } = await import('execa');
+    await execa('sudo', ['dpkg', '--add-architecture', 'i386'], {
+        stdio: 'inherit',
+    });
+    // Try WineHQ repo first for latest builds, fall back to distro packages
+    let useWineHQ = false;
+    try {
+        await execa('sudo', ['mkdir', '-pm755', '/etc/apt/keyrings'], {
+            stdio: 'inherit',
+        });
+        await execa('sudo', [
+            'curl',
+            '-sL',
+            'https://dl.winehq.org/wine-builds/winehq.key',
+            '-o',
+            '/etc/apt/keyrings/winehq-archive.key',
+        ], { stdio: 'inherit' });
+        let codename = 'noble';
+        try {
+            codename = execSync('lsb_release -cs', { encoding: 'utf-8' }).trim();
+        }
+        catch {
+            // Fall back to noble (Ubuntu 24.04)
+        }
+        await execa('sudo', [
+            'curl',
+            '-sfL',
+            `https://dl.winehq.org/wine-builds/ubuntu/dists/${codename}/winehq-${codename}.sources`,
+            '-o',
+            `/etc/apt/sources.list.d/winehq-${codename}.sources`,
+        ], { stdio: 'inherit' });
+        useWineHQ = true;
+    }
+    catch {
+        OutputHelper.warn('WineHQ repo not available for this distro, using system packages');
+    }
+    await execa('sudo', ['apt-get', 'update'], { stdio: 'inherit' });
+    const winePackage = useWineHQ ? 'winehq-stable' : 'wine';
+    await execa('sudo', [
+        'apt-get',
+        'install',
+        '-y',
+        winePackage,
+        'xvfb',
+        'mesa-utils',
+        'openbox',
+        'gcc-mingw-w64-x86-64',
+        'unzip',
+    ], { stdio: 'inherit' });
+}
+//# sourceMappingURL=linux-prerequisites.js.map

package/dist/src/linux/linux-prerequisites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-prerequisites.js","sourceRoot":"","sources":["../../../src/linux/linux-prerequisites.ts"],"names":[],"mappings":"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"}

package/dist/src/linux/linux-shader-patcher.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Binary-patch GLSL shaders from #version 150 to #version 420.
+ *
+ * Mesa's llvmpipe strictly enforces the GLSL spec — shaders using
+ * unpackHalf2x16() (GLSL 4.20+) but declaring #version 150 are rejected.
+ * Both version strings are exactly 12 bytes, so the patch is a safe
+ * in-place replacement.
+ */
+import type { LinuxStudioConfig } from './linux-config.js';
+/**
+ * Patch the GLSL3 shader pack in-place, replacing all occurrences of
+ * `#version 150` with `#version 420`.
+ *
+ * Returns the number of replacements made.
+ */
+export declare function patchShadersAsync(config: LinuxStudioConfig): Promise<number>;
+//# sourceMappingURL=linux-shader-patcher.d.ts.map

package/dist/src/linux/linux-shader-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-shader-patcher.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-shader-patcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM3D;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/dist/src/linux/linux-shader-patcher.js

@@ -0,0 +1,48 @@
+/**
+ * Binary-patch GLSL shaders from #version 150 to #version 420.
+ *
+ * Mesa's llvmpipe strictly enforces the GLSL spec — shaders using
+ * unpackHalf2x16() (GLSL 4.20+) but declaring #version 150 are rejected.
+ * Both version strings are exactly 12 bytes, so the patch is a safe
+ * in-place replacement.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+const SHADER_PACK_NAME = 'shaders_glsl3.pack';
+const OLD_VERSION = Buffer.from('#version 150');
+const NEW_VERSION = Buffer.from('#version 420');
+/**
+ * Patch the GLSL3 shader pack in-place, replacing all occurrences of
+ * `#version 150` with `#version 420`.
+ *
+ * Returns the number of replacements made.
+ */
+export async function patchShadersAsync(config) {
+    const shaderPath = path.join(config.shadersDir, SHADER_PACK_NAME);
+    let data;
+    try {
+        data = await fs.readFile(shaderPath);
+    }
+    catch {
+        throw new Error(`Shader pack not found: ${shaderPath}`);
+    }
+    let count = 0;
+    let offset = 0;
+    while (true) {
+        const idx = data.indexOf(OLD_VERSION, offset);
+        if (idx === -1)
+            break;
+        NEW_VERSION.copy(data, idx);
+        count++;
+        offset = idx + NEW_VERSION.length;
+    }
+    if (count === 0) {
+        OutputHelper.verbose('Shaders already patched (no #version 150 found).');
+        return 0;
+    }
+    await fs.writeFile(shaderPath, data);
+    OutputHelper.info(`Patched ${count} shaders (#version 150 → #version 420).`);
+    return count;
+}
+//# sourceMappingURL=linux-shader-patcher.js.map

package/dist/src/linux/linux-shader-patcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-shader-patcher.js","sourceRoot":"","sources":["../../../src/linux/linux-shader-patcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAyB;IAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAElE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,MAAM;QACtB,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5B,KAAK,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,YAAY,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,YAAY,CAAC,IAAI,CAAC,WAAW,KAAK,yCAAyC,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/linux/linux-shader-patcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=linux-shader-patcher.test.d.ts.map

package/dist/src/linux/linux-shader-patcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-shader-patcher.test.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-shader-patcher.test.ts"],"names":[],"mappings":""}

package/dist/src/linux/linux-shader-patcher.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { patchShadersAsync } from './linux-shader-patcher.js';
+describe('patchShadersAsync', () => {
+    let tmpDir;
+    afterEach(async () => {
+        if (tmpDir) {
+            await fs.rm(tmpDir, { recursive: true, force: true });
+        }
+    });
+    function makeConfig() {
+        return {
+            studioDir: tmpDir,
+            winePrefix: '/tmp/fake-wine',
+            display: ':99',
+            studioExe: path.join(tmpDir, 'RobloxStudioBeta.exe'),
+            clientSettingsPath: path.join(tmpDir, 'ClientSettings', 'ClientAppSettings.json'),
+            shadersDir: path.join(tmpDir, 'shaders'),
+            pluginsDir: path.join(tmpDir, 'Plugins'),
+            writeCredExe: path.join(tmpDir, 'write-cred.exe'),
+        };
+    }
+    async function writeFakeShaderPack(content) {
+        const dir = path.join(tmpDir, 'shaders');
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(path.join(dir, 'shaders_glsl3.pack'), content);
+    }
+    it('replaces #version 150 with #version 420', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'shader-test-'));
+        const config = makeConfig();
+        // Create a fake shader pack with two occurrences
+        const data = Buffer.from('header#version 150middle#version 150tail');
+        await writeFakeShaderPack(data);
+        const count = await patchShadersAsync(config);
+        expect(count).toBe(2);
+        const patched = await fs.readFile(path.join(config.shadersDir, 'shaders_glsl3.pack'));
+        expect(patched.toString()).toBe('header#version 420middle#version 420tail');
+    });
+    it('returns 0 on second run (idempotent)', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'shader-test-'));
+        const config = makeConfig();
+        await writeFakeShaderPack(Buffer.from('data#version 150end'));
+        await patchShadersAsync(config);
+        const count = await patchShadersAsync(config);
+        expect(count).toBe(0);
+    });
+    it('throws if shader pack not found', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'shader-test-'));
+        const config = makeConfig();
+        await expect(patchShadersAsync(config)).rejects.toThrow('Shader pack not found');
+    });
+});
+//# sourceMappingURL=linux-shader-patcher.test.js.map

package/dist/src/linux/linux-shader-patcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-shader-patcher.test.js","sourceRoot":"","sources":["../../../src/linux/linux-shader-patcher.test.ts"],"names":[],"mappings":"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"}

package/dist/src/linux/linux-studio-installer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Download and install Roblox Studio from CDN zip packages.
+ */
+import { type LinuxStudioConfig } from './linux-config.js';
+/**
+ * Download all Studio packages from CDN and extract them to studioDir.
+ * Writes AppSettings.xml on completion.
+ */
+export declare function installStudioAsync(config: LinuxStudioConfig, version: string): Promise<void>;
+//# sourceMappingURL=linux-studio-installer.d.ts.map

package/dist/src/linux/linux-studio-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-studio-installer.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-studio-installer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAK3B;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/src/linux/linux-studio-installer.js

@@ -0,0 +1,79 @@
+/**
+ * Download and install Roblox Studio from CDN zip packages.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { ROBLOX_CDN_BASE, STUDIO_PACKAGES, } from './linux-config.js';
+import { writeInstalledVersionAsync } from './linux-version-resolver.js';
+const DOWNLOAD_DIR = '/tmp/roblox-pkgs';
+/**
+ * Download all Studio packages from CDN and extract them to studioDir.
+ * Writes AppSettings.xml on completion.
+ */
+export async function installStudioAsync(config, version) {
+    const { studioDir } = config;
+    // Clean existing install
+    await fs.rm(studioDir, { recursive: true, force: true });
+    await fs.mkdir(studioDir, { recursive: true });
+    // Ensure download cache exists
+    await fs.mkdir(DOWNLOAD_DIR, { recursive: true });
+    const packageNames = Object.keys(STUDIO_PACKAGES);
+    OutputHelper.info(`Downloading ${packageNames.length} packages...`);
+    // Download packages (sequential to avoid rate limiting)
+    for (const pkg of packageNames) {
+        await downloadPackageAsync(version, pkg);
+    }
+    OutputHelper.info('Extracting packages...');
+    // Extract each package to its target directory
+    for (const [pkg, subdir] of Object.entries(STUDIO_PACKAGES)) {
+        const target = path.join(studioDir, subdir);
+        await fs.mkdir(target, { recursive: true });
+        const zipPath = path.join(DOWNLOAD_DIR, pkg);
+        try {
+            execSync(`unzip -qo ${JSON.stringify(zipPath)} -d ${JSON.stringify(target)}`, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 60000,
+            });
+        }
+        catch {
+            OutputHelper.warn(`Failed to extract ${pkg} (non-fatal)`);
+        }
+    }
+    // Write AppSettings.xml
+    const appSettings = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<Settings>',
+        '        <ContentFolder>content</ContentFolder>',
+        '        <BaseUrl>http://www.roblox.com</BaseUrl>',
+        '</Settings>',
+    ].join('\n');
+    await fs.writeFile(path.join(studioDir, 'AppSettings.xml'), appSettings, 'utf-8');
+    // Record installed version
+    await writeInstalledVersionAsync(studioDir, version);
+    OutputHelper.info('Studio installation complete.');
+}
+async function downloadPackageAsync(version, pkg) {
+    const dest = path.join(DOWNLOAD_DIR, pkg);
+    // Skip if already downloaded
+    try {
+        const stat = await fs.stat(dest);
+        if (stat.size > 0) {
+            OutputHelper.verbose(`Cached: ${pkg}`);
+            return;
+        }
+    }
+    catch {
+        // File doesn't exist, download it
+    }
+    const url = `${ROBLOX_CDN_BASE}/${version}-${pkg}`;
+    OutputHelper.verbose(`Downloading ${pkg}...`);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download ${pkg}: ${response.status} ${response.statusText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    await fs.writeFile(dest, buffer);
+}
+//# sourceMappingURL=linux-studio-installer.js.map

package/dist/src/linux/linux-studio-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-studio-installer.js","sourceRoot":"","sources":["../../../src/linux/linux-studio-installer.ts"],"names":[],"mappings":"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"}

package/dist/src/linux/linux-studio-launcher.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Linux-specific Studio launch via Wine. Called by the process manager
+ * when `process.platform === 'linux'`.
+ */
+import type { StudioProcess } from '../process/studio-process-manager.js';
+/**
+ * Launch Studio under Wine with proper display and environment setup.
+ */
+export declare function launchStudioLinuxAsync(studioExe: string, placePath: string): Promise<StudioProcess>;
+//# sourceMappingURL=linux-studio-launcher.d.ts.map

package/dist/src/linux/linux-studio-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-studio-launcher.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-studio-launcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAiExB"}

package/dist/src/linux/linux-studio-launcher.js

@@ -0,0 +1,73 @@
+/**
+ * Linux-specific Studio launch via Wine. Called by the process manager
+ * when `process.platform === 'linux'`.
+ */
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { spawn } from 'child_process';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { resolveLinuxConfig } from './linux-config.js';
+import { buildWineEnv } from './linux-wine-env.js';
+import { ensureDisplayAsync, ensureWindowManagerAsync, } from './linux-display-manager.js';
+/**
+ * Launch Studio under Wine with proper display and environment setup.
+ */
+export async function launchStudioLinuxAsync(studioExe, placePath) {
+    const config = resolveLinuxConfig();
+    // Ensure virtual display is running
+    await ensureDisplayAsync(config);
+    await ensureWindowManagerAsync(config);
+    const env = buildWineEnv(config);
+    OutputHelper.verbose(`[StudioBridge] wine ${studioExe} "${placePath}"`);
+    // Write Wine stderr to a log file so we can diagnose launch failures.
+    const logPath = path.join(os.tmpdir(), 'studio-bridge-wine.log');
+    const logFd = fs.openSync(logPath, 'w');
+    OutputHelper.verbose(`[StudioBridge] Wine log: ${logPath}`);
+    const proc = spawn('wine', [studioExe, placePath], {
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+        env,
+    });
+    // Close our copy of the fd — the child owns it now
+    fs.closeSync(logFd);
+    // Detect early process exit (crash or failure to start)
+    proc.on('exit', (code, signal) => {
+        OutputHelper.verbose(`[StudioBridge] Wine process exited (code=${code}, signal=${signal})`);
+    });
+    // Allow our Node process to exit without waiting for Studio
+    proc.unref();
+    // Tail the Wine log in verbose mode so diagnostics appear
+    const tailProc = spawn('tail', ['-f', logPath], {
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    tailProc.stdout?.on('data', (chunk) => {
+        const lines = chunk.toString('utf-8').trim().split('\n');
+        for (const line of lines) {
+            if (line) {
+                OutputHelper.verbose(`[Wine] ${line}`);
+            }
+        }
+    });
+    tailProc.unref();
+    let killed = false;
+    const killAsync = async () => {
+        if (killed)
+            return;
+        killed = true;
+        try {
+            tailProc.kill('SIGTERM');
+        }
+        catch {
+            // Best effort
+        }
+        try {
+            proc.kill('SIGTERM');
+        }
+        catch {
+            // Best effort
+        }
+    };
+    return { process: proc, killAsync };
+}
+//# sourceMappingURL=linux-studio-launcher.js.map

package/dist/src/linux/linux-studio-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-studio-launcher.js","sourceRoot":"","sources":["../../../src/linux/linux-studio-launcher.ts"],"names":[],"mappings":"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"}

package/dist/src/linux/linux-version-resolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Resolve the latest Roblox Studio version hash from the CDN.
+ */
+/**
+ * Fetch the current Studio version string from the Roblox client settings API.
+ * Returns a version hash like "version-e095049f34844c41".
+ */
+export declare function resolveStudioVersionAsync(explicitVersion?: string): Promise<string>;
+/**
+ * Read the installed version from a .studio-version marker file.
+ * Returns undefined if no version is installed.
+ */
+export declare function readInstalledVersionAsync(studioDir: string): Promise<string | undefined>;
+/**
+ * Write the installed version to a .studio-version marker file.
+ */
+export declare function writeInstalledVersionAsync(studioDir: string, version: string): Promise<void>;
+//# sourceMappingURL=linux-version-resolver.d.ts.map

package/dist/src/linux/linux-version-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-version-resolver.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-version-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/src/linux/linux-version-resolver.js

@@ -0,0 +1,49 @@
+/**
+ * Resolve the latest Roblox Studio version hash from the CDN.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+const CLIENT_SETTINGS_URL = 'https://clientsettingscdn.roblox.com/v2/client-version/WindowsStudio64';
+/**
+ * Fetch the current Studio version string from the Roblox client settings API.
+ * Returns a version hash like "version-e095049f34844c41".
+ */
+export async function resolveStudioVersionAsync(explicitVersion) {
+    if (explicitVersion) {
+        return explicitVersion;
+    }
+    OutputHelper.verbose('Fetching latest Studio version from client settings...');
+    const response = await fetch(CLIENT_SETTINGS_URL);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Studio version: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const version = data.clientVersionUpload;
+    if (!version.startsWith('version-')) {
+        throw new Error(`Unexpected version format: ${version}`);
+    }
+    OutputHelper.verbose(`Latest Studio version: ${version} (${data.version})`);
+    return version;
+}
+/**
+ * Read the installed version from a .studio-version marker file.
+ * Returns undefined if no version is installed.
+ */
+export async function readInstalledVersionAsync(studioDir) {
+    const versionFile = path.join(studioDir, '.studio-version');
+    try {
+        return (await fs.readFile(versionFile, 'utf-8')).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Write the installed version to a .studio-version marker file.
+ */
+export async function writeInstalledVersionAsync(studioDir, version) {
+    const versionFile = path.join(studioDir, '.studio-version');
+    await fs.writeFile(versionFile, version + '\n', 'utf-8');
+}
+//# sourceMappingURL=linux-version-resolver.js.map

package/dist/src/linux/linux-version-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-version-resolver.js","sourceRoot":"","sources":["../../../src/linux/linux-version-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,mBAAmB,GACvB,wEAAwE,CAAC;AAQ3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,eAAwB;IAExB,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,OAAO,CAClB,wDAAwD,CACzD,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,mCAAmC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,YAAY,CAAC,OAAO,CAAC,0BAA0B,OAAO,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,SAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAAiB,EACjB,OAAe;IAEf,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}