@quenty/studio-bridge 0.1.1-canary.656.73a74af.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 0.1.1-canary.656.73a74af.0 (2026-02-17)
+
+
+### Features
+
+* Add a terminal mode to studio-bridge for easier debugging ([92cdca9](https://github.com/Quenty/NevermoreEngine/commit/92cdca97ee6ece9a8622559f8846f59b831788de))
+* Add initial studio-bridge package that can replace run-in-roblox ([aec737f](https://github.com/Quenty/NevermoreEngine/commit/aec737fd0eb3f2b045fc469a2b46f833de84a24b))
+* Refactor studio bridge ([8afe642](https://github.com/Quenty/NevermoreEngine/commit/8afe6424b6635eaa0155734c085934051de88da6))
+* Use reporting system for studio bridge too (a bit ugly) ([20b675c](https://github.com/Quenty/NevermoreEngine/commit/20b675cb22cb46c88b556f4afdda2700dd1258dd))
+* Use yargs in studio-bridge cli ([2203601](https://github.com/Quenty/NevermoreEngine/commit/220360168e79d57cd576150134949d8f2325a38f))

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2014-2026 James Onnen (Quenty)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# @quenty/studio-bridge
+
+WebSocket-based bridge for running Luau scripts in Roblox Studio.
+
+## How It Works
+
+```
+┌─────────────┐    WebSocket     ┌──────────────────┐
+│   Node.js   │◄───────────────►│  Studio Plugin    │
+│   Server    │   ws://localhost │  (auto-injected)  │
+│             │                  │                   │
+│ 1. Start WS │                  │ 4. Connect + hello│
+│ 2. Inject   │                  │ 5. Run script     │
+│    plugin   │                  │ 6. Stream output  │
+│ 3. Launch   │                  │ 7. scriptComplete │
+│    Studio   │                  │                   │
+└─────────────┘                  └──────────────────┘
+```
+
+1. Start WebSocket server on a random port
+2. Build a `.rbxm` plugin via `rojo build --plugin` with the port and session ID baked in
+3. Plugin is placed in Studio's plugins folder, launch Studio
+4. Plugin connects, handshakes with session ID
+5. Server sends `execute` with Luau script, plugin runs it via `loadstring()` + `xpcall()`
+6. Plugin streams `LogService` output back as batched messages
+7. Plugin sends `scriptComplete` — server can send another `execute` or `shutdown`
+
+The session ID (random UUID) prevents stale plugins from previous runs from interfering.
+
+## CLI
+
+```bash
+# Run a script file
+studio-bridge run test.lua
+
+# Run inline script
+studio-bridge exec 'print("hello world")'
+
+# With a specific place file (builds a minimal place via rojo if omitted)
+studio-bridge run test.lua --place build/test.rbxl
+
+# Interactive terminal mode (keeps Studio alive between executions)
+studio-bridge terminal
+
+# Terminal mode with initial script
+studio-bridge terminal --place build/test.rbxl --script init.lua
+
+# Debug output
+studio-bridge run test.lua --verbose
+```
+
+### Global Options
+
+| Option | Alias | Default | Description |
+|--------|-------|---------|-------------|
+| `--place` | `-p` | — | Path to a `.rbxl` place file (builds minimal place via rojo if omitted) |
+| `--timeout` | — | `120000` | Timeout in milliseconds |
+| `--verbose` | — | `false` | Show internal debug output |
+| `--logs` / `--no-logs` | — | `true` | Show execution logs in spinner mode |
+
+### Terminal Mode
+
+Keeps Studio alive and provides an interactive REPL. Type Luau, see results, repeat — no re-launch between executions.
+
+```
+$ studio-bridge terminal --place build/test.rbxl
+Studio connected.
+
+────────────────────────────────────────────────────────
+❯ print("hello")
+────────────────────────────────────────────────────────
+  ctrl+enter to run · ctrl+c to clear · .help for commands
+```
+
+| Key | Action |
+|-----|--------|
+| Enter | New line |
+| Ctrl+Enter | Execute buffer |
+| Ctrl+C | Clear buffer (exit if empty) |
+| Ctrl+D | Exit |
+
+| Command | Description |
+|---------|-------------|
+| `.help` | Show keybindings and commands |
+| `.exit` | Exit terminal mode |
+| `.run <file>` | Execute a Luau file |
+| `.clear` | Clear the editor buffer |
+
+## API
+
+```typescript
+import { StudioBridge } from '@quenty/studio-bridge';
+
+const bridge = new StudioBridge({ placePath: './build/test.rbxl' });
+await bridge.startAsync();
+
+const result = await bridge.executeAsync({
+  scriptContent: 'print("Hello from studio-bridge!")',
+  timeoutMs: 90_000,
+  onOutput: (level, body) => console.log(`[${level}] ${body}`),
+});
+
+console.log(result.success); // boolean
+console.log(result.logs);    // all captured output, newline-separated
+
+// Can call executeAsync() again without relaunching Studio
+await bridge.stopAsync();
+```
+
+### `StudioBridgeServerOptions`
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `placePath` | `string` | — | Path to `.rbxl` file (auto-builds via rojo if omitted) |
+| `timeoutMs` | `number` | `120_000` | Default timeout for operations |
+| `onPhase` | `(phase) => void` | — | Progress callback: `building`, `launching`, `connecting`, `executing`, `done` |
+| `sessionId` | `string` | auto UUID | Session ID for concurrent isolation |
+
+### `ExecuteOptions`
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `scriptContent` | `string` | required | Luau source code to execute |
+| `timeoutMs` | `number` | inherited | Timeout for this execution |
+| `onOutput` | `(level, body) => void` | — | Called for each log message |
+
+### `StudioBridgeResult`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `success` | `boolean` | `true` if the script ran without errors |
+| `logs` | `string` | All captured output, newline-separated |
+
+## WebSocket Protocol
+
+All messages are JSON: `{ "type": string, "payload": object }`.
+
+**Plugin to Server:**
+
+| Type | Payload | Description |
+|------|---------|-------------|
+| `hello` | `{ sessionId }` | Handshake |
+| `output` | `{ messages: [{ level, body }] }` | Batched log output |
+| `scriptComplete` | `{ success, error? }` | Script finished |
+
+Output levels: `"Print"`, `"Info"`, `"Warning"`, `"Error"` (matches `Enum.MessageType`).
+
+**Server to Plugin:**
+
+| Type | Payload | Description |
+|------|---------|-------------|
+| `welcome` | `{ sessionId }` | Handshake accepted |
+| `execute` | `{ script }` | Luau script to run |
+| `shutdown` | `{}` | Disconnect |
+
+## Testing
+
+```bash
+pnpm test              # Unit tests (no Studio needed)
+pnpm test:watch        # Watch mode
+pnpm test:integration  # End-to-end (requires Studio)
+```
+
+| Layer | What it tests | Studio? |
+|-------|--------------|---------|
+| Unit (`pnpm test`) | Protocol, template substitution, path resolution, WebSocket lifecycle | No |
+| Integration (`pnpm test:integration`) | Full pipeline: rojo build, plugin injection, Studio launch, output capture | Yes |
+
+## Platform Support
+
+| Platform | Studio Location | Plugins Folder |
+|----------|----------------|----------------|
+| Windows | `%LOCALAPPDATA%\Roblox\Versions\*\RobloxStudioBeta.exe` | `%LOCALAPPDATA%\Roblox\Plugins\` |
+| macOS | `/Applications/RobloxStudio.app/Contents/MacOS/RobloxStudioBeta` | `~/Documents/Roblox/Plugins/` |
+
+## Future Plans
+
+- **StudioTestService integration** — Use `ExecuteRunModeAsync()` / `EndTest()` for better isolation vs. `loadstring()`
+- **Structured test results** — Protocol extension for typed result messages instead of log parsing

package/dist/src/cli/args/global-args.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Global arguments available to all studio-bridge commands.
+ */
+export interface StudioBridgeGlobalArgs {
+    verbose: boolean;
+    place?: string;
+    timeout: number;
+    logs: boolean;
+}
+//# sourceMappingURL=global-args.d.ts.map

package/dist/src/cli/args/global-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-args.d.ts","sourceRoot":"","sources":["../../../../src/cli/args/global-args.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/src/cli/args/global-args.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=global-args.js.map

package/dist/src/cli/args/global-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-args.js","sourceRoot":"","sources":["../../../../src/cli/args/global-args.ts"],"names":[],"mappings":""}

package/dist/src/cli/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for @quenty/studio-bridge.
+ *
+ * Usage:
+ *   studio-bridge run <file.lua>
+ *   studio-bridge exec 'print("hello")'
+ *   studio-bridge terminal [--script <file.lua>]
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/src/cli/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for @quenty/studio-bridge.
+ *
+ * Usage:
+ *   studio-bridge run <file.lua>
+ *   studio-bridge exec 'print("hello")'
+ *   studio-bridge terminal [--script <file.lua>]
+ */
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { VersionChecker } from '@quenty/nevermore-cli-helpers';
+import { RunCommand } from './commands/run-command.js';
+import { ExecCommand } from './commands/exec-command.js';
+import { TerminalCommand } from './commands/terminal/terminal-command.js';
+const versionData = await VersionChecker.checkForUpdatesAsync({
+    humanReadableName: 'Studio Bridge',
+    packageName: '@quenty/studio-bridge',
+    registryUrl: 'https://registry.npmjs.org/',
+    packageJsonPath: join(dirname(fileURLToPath(import.meta.url)), '../../../package.json'),
+});
+yargs(hideBin(process.argv))
+    .scriptName('studio-bridge')
+    .version((versionData
+    ? VersionChecker.getVersionDisplayName(versionData)
+    : undefined))
+    .option('place', {
+    alias: 'p',
+    description: 'Path to a .rbxl place file (builds a minimal place via rojo if omitted)',
+    type: 'string',
+    global: true,
+})
+    .option('timeout', {
+    description: 'Timeout in milliseconds',
+    type: 'number',
+    default: 120_000,
+    global: true,
+})
+    .option('verbose', {
+    description: 'Show internal debug output',
+    type: 'boolean',
+    default: false,
+    global: true,
+})
+    .option('logs', {
+    description: 'Show execution logs in spinner mode',
+    type: 'boolean',
+    default: true,
+    global: true,
+})
+    .middleware((argv) => {
+    OutputHelper.setVerbose(argv.verbose);
+})
+    .usage(OutputHelper.formatInfo('Usage: $0 <command> [options]'))
+    .command(new ExecCommand())
+    .command(new RunCommand())
+    .command(new TerminalCommand())
+    .recommendCommands()
+    .demandCommand(1, OutputHelper.formatHint("Hint: See 'studio-bridge help' for more help"))
+    .wrap(null)
+    .strict().argv;
+//# sourceMappingURL=cli.js.map

package/dist/src/cli/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,oBAAoB,CAAC;IAC5D,iBAAiB,EAAE,eAAe;IAClC,WAAW,EAAE,uBAAuB;IACpC,WAAW,EAAE,6BAA6B;IAC1C,eAAe,EAAE,IAAI,CACnB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvC,uBAAuB,CACxB;CACF,CAAC,CAAC;AAEH,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB,UAAU,CAAC,eAAe,CAAC;KAC3B,OAAO,CACN,CAAC,WAAW;IACV,CAAC,CAAC,cAAc,CAAC,qBAAqB,CAAC,WAAW,CAAC;IACnD,CAAC,CAAC,SAAS,CAAQ,CACtB;KACA,MAAM,CAAC,OAAO,EAAE;IACf,KAAK,EAAE,GAAG;IACV,WAAW,EACT,yEAAyE;IAC3E,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,IAAI;CACb,CAAC;KACD,MAAM,CAAC,SAAS,EAAE;IACjB,WAAW,EAAE,yBAAyB;IACtC,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;CACb,CAAC;KACD,MAAM,CAAC,SAAS,EAAE;IACjB,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,IAAI;CACb,CAAC;KACD,MAAM,CAAC,MAAM,EAAE;IACd,WAAW,EAAE,qCAAqC;IAClD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;CACb,CAAC;KACD,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;IACnB,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,OAAkB,CAAC,CAAC;AACnD,CAAC,CAAC;KACD,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC;KAC/D,OAAO,CAAC,IAAI,WAAW,EAAS,CAAC;KACjC,OAAO,CAAC,IAAI,UAAU,EAAS,CAAC;KAChC,OAAO,CAAC,IAAI,eAAe,EAAS,CAAC;KACrC,iBAAiB,EAAE;KACnB,aAAa,CACZ,CAAC,EACD,YAAY,CAAC,UAAU,CAAC,8CAA8C,CAAC,CACxE;KACA,IAAI,CAAC,IAAI,CAAC;KACV,MAAM,EAAE,CAAC,IAAI,CAAC"}

package/dist/src/cli/commands/exec-command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `studio-bridge exec <code>` — execute inline Luau code in Roblox Studio.
+ */
+import { Argv, CommandModule } from 'yargs';
+import type { StudioBridgeGlobalArgs } from '../args/global-args.js';
+export interface ExecArgs extends StudioBridgeGlobalArgs {
+    code: string;
+}
+export declare class ExecCommand<T> implements CommandModule<T, ExecArgs> {
+    command: string;
+    describe: string;
+    builder: (args: Argv<T>) => Argv<ExecArgs>;
+    handler: (args: ExecArgs) => Promise<void>;
+}
+//# sourceMappingURL=exec-command.d.ts.map

package/dist/src/cli/commands/exec-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/exec-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAMrE,MAAM,WAAW,QAAS,SAAQ,sBAAsB;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC;IACxD,OAAO,SAAiB;IACxB,QAAQ,SAA+C;IAEvD,OAAO,GAAI,MAAM,IAAI,CAAC,CAAC,CAAC,KAOd,IAAI,CAAC,QAAQ,CAAC,CAC7B;IAEK,OAAO,GAAU,MAAM,QAAQ,mBAgBpC;CACH"}

package/dist/src/cli/commands/exec-command.js

@@ -0,0 +1,35 @@
+/**
+ * `studio-bridge exec <code>` — execute inline Luau code in Roblox Studio.
+ */
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { executeScriptAsync, resolvePlacePathAsync, } from '../script-executor.js';
+export class ExecCommand {
+    command = 'exec <code>';
+    describe = 'Execute inline Luau code in Roblox Studio';
+    builder = (args) => {
+        args.positional('code', {
+            describe: 'Luau code to execute',
+            type: 'string',
+            demandOption: true,
+        });
+        return args;
+    };
+    handler = async (args) => {
+        try {
+            const placePath = await resolvePlacePathAsync(args.place);
+            await executeScriptAsync({
+                scriptContent: args.code,
+                packageName: 'script',
+                placePath,
+                timeoutMs: args.timeout,
+                verbose: args.verbose,
+                showLogs: args.logs,
+            });
+        }
+        catch (err) {
+            OutputHelper.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    };
+}
+//# sourceMappingURL=exec-command.js.map

package/dist/src/cli/commands/exec-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-command.js","sourceRoot":"","sources":["../../../../src/cli/commands/exec-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,OAAO,WAAW;IACf,OAAO,GAAG,aAAa,CAAC;IACxB,QAAQ,GAAG,2CAA2C,CAAC;IAEvD,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE;QACjC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE,sBAAsB;YAChC,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,OAAO,IAAsB,CAAC;IAChC,CAAC,CAAC;IAEK,OAAO,GAAG,KAAK,EAAE,IAAc,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE1D,MAAM,kBAAkB,CAAC;gBACvB,aAAa,EAAE,IAAI,CAAC,IAAI;gBACxB,WAAW,EAAE,QAAQ;gBACrB,SAAS;gBACT,SAAS,EAAE,IAAI,CAAC,OAAO;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;CACH"}

package/dist/src/cli/commands/run-command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `studio-bridge run <file>` — execute a Luau script file in Roblox Studio.
+ */
+import { Argv, CommandModule } from 'yargs';
+import type { StudioBridgeGlobalArgs } from '../args/global-args.js';
+export interface RunArgs extends StudioBridgeGlobalArgs {
+    file: string;
+}
+export declare class RunCommand<T> implements CommandModule<T, RunArgs> {
+    command: string;
+    describe: string;
+    builder: (args: Argv<T>) => Argv<RunArgs>;
+    handler: (args: RunArgs) => Promise<void>;
+}
+//# sourceMappingURL=run-command.d.ts.map

package/dist/src/cli/commands/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/run-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAMrE,MAAM,WAAW,OAAQ,SAAQ,sBAAsB;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC;IACtD,OAAO,SAAgB;IACvB,QAAQ,SAAiD;IAEzD,OAAO,GAAI,MAAM,IAAI,CAAC,CAAC,CAAC,KAOd,IAAI,CAAC,OAAO,CAAC,CAC5B;IAEK,OAAO,GAAU,MAAM,OAAO,mBA6BnC;CACH"}

package/dist/src/cli/commands/run-command.js

@@ -0,0 +1,47 @@
+/**
+ * `studio-bridge run <file>` — execute a Luau script file in Roblox Studio.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { executeScriptAsync, resolvePlacePathAsync, } from '../script-executor.js';
+export class RunCommand {
+    command = 'run <file>';
+    describe = 'Execute a Luau script file in Roblox Studio';
+    builder = (args) => {
+        args.positional('file', {
+            describe: 'Path to a Luau script file',
+            type: 'string',
+            demandOption: true,
+        });
+        return args;
+    };
+    handler = async (args) => {
+        try {
+            const scriptPath = path.resolve(args.file);
+            let scriptContent;
+            try {
+                scriptContent = await fs.readFile(scriptPath, 'utf-8');
+            }
+            catch {
+                OutputHelper.error(`Could not read script file: ${scriptPath}`);
+                process.exit(1);
+            }
+            const placePath = await resolvePlacePathAsync(args.place);
+            const packageName = path.basename(args.file, path.extname(args.file));
+            await executeScriptAsync({
+                scriptContent,
+                packageName,
+                placePath,
+                timeoutMs: args.timeout,
+                verbose: args.verbose,
+                showLogs: args.logs,
+            });
+        }
+        catch (err) {
+            OutputHelper.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    };
+}
+//# sourceMappingURL=run-command.js.map

package/dist/src/cli/commands/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../../../src/cli/commands/run-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,OAAO,UAAU;IACd,OAAO,GAAG,YAAY,CAAC;IACvB,QAAQ,GAAG,6CAA6C,CAAC;IAEzD,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE;QACjC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE,4BAA4B;YACtC,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,OAAO,IAAqB,CAAC;IAC/B,CAAC,CAAC;IAEK,OAAO,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,aAAqB,CAAC;YAC1B,IAAI,CAAC;gBACH,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,CAAC,KAAK,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;gBAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAC/B,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAC;YAEF,MAAM,kBAAkB,CAAC;gBACvB,aAAa;gBACb,WAAW;gBACX,SAAS;gBACT,SAAS,EAAE,IAAI,CAAC,OAAO;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;CACH"}

package/dist/src/cli/commands/terminal/terminal-command.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `studio-bridge terminal` — interactive REPL mode for executing Luau
+ * scripts repeatedly in a persistent Studio session.
+ */
+import { Argv, CommandModule } from 'yargs';
+import type { StudioBridgeGlobalArgs } from '../../args/global-args.js';
+export interface TerminalArgs extends StudioBridgeGlobalArgs {
+    script?: string;
+    'script-text'?: string;
+}
+export declare class TerminalCommand<T> implements CommandModule<T, TerminalArgs> {
+    command: string;
+    describe: string;
+    builder: (args: Argv<T>) => Argv<TerminalArgs>;
+    handler: (args: TerminalArgs) => Promise<void>;
+}
+//# sourceMappingURL=terminal-command.d.ts.map

package/dist/src/cli/commands/terminal/terminal-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-command.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/terminal/terminal-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGxE,MAAM,WAAW,YAAa,SAAQ,sBAAsB;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,EAAE,YAAY,CAAC;IAChE,OAAO,SAAc;IACrB,QAAQ,SACgE;IAExE,OAAO,GAAI,MAAM,IAAI,CAAC,CAAC,CAAC,KAad,IAAI,CAAC,YAAY,CAAC,CACjC;IAEK,OAAO,GAAU,MAAM,YAAY,mBAgBxC;CACH"}

package/dist/src/cli/commands/terminal/terminal-command.js

@@ -0,0 +1,41 @@
+/**
+ * `studio-bridge terminal` — interactive REPL mode for executing Luau
+ * scripts repeatedly in a persistent Studio session.
+ */
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { resolvePlacePathAsync } from '../../script-executor.js';
+export class TerminalCommand {
+    command = 'terminal';
+    describe = 'Interactive terminal mode — keep Studio alive and execute scripts via REPL';
+    builder = (args) => {
+        args.option('script', {
+            alias: 's',
+            describe: 'Path to a Luau script to run on connect',
+            type: 'string',
+        });
+        args.option('script-text', {
+            alias: 't',
+            describe: 'Inline Luau code to run on connect',
+            type: 'string',
+        });
+        return args;
+    };
+    handler = async (args) => {
+        try {
+            const placePath = await resolvePlacePathAsync(args.place);
+            const { runTerminalMode } = await import('./terminal-mode.js');
+            await runTerminalMode({
+                placePath,
+                scriptPath: args.script,
+                scriptText: args['script-text'],
+                timeoutMs: args.timeout,
+                verbose: args.verbose,
+            });
+        }
+        catch (err) {
+            OutputHelper.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    };
+}
+//# sourceMappingURL=terminal-command.js.map

package/dist/src/cli/commands/terminal/terminal-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-command.js","sourceRoot":"","sources":["../../../../../src/cli/commands/terminal/terminal-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOjE,MAAM,OAAO,eAAe;IACnB,OAAO,GAAG,UAAU,CAAC;IACrB,QAAQ,GACb,4EAA4E,CAAC;IAExE,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;YACpB,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,yCAAyC;YACnD,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;YACzB,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,oCAAoC;YAC9C,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,OAAO,IAA0B,CAAC;IACpC,CAAC,CAAC;IAEK,OAAO,GAAG,KAAK,EAAE,IAAkB,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE1D,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/D,MAAM,eAAe,CAAC;gBACpB,SAAS;gBACT,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;gBAC/B,SAAS,EAAE,IAAI,CAAC,OAAO;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;CACH"}

package/dist/src/cli/commands/terminal/terminal-editor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Raw-mode multi-line terminal editor with ANSI rendering.
+ *
+ * Provides a Claude Code-inspired input UI with:
+ * - Multi-line editing (Enter = newline, Ctrl+Enter = submit)
+ * - Cursor movement (arrows, Home/End)
+ * - Dot-commands (.help, .exit, .run <file>, .clear)
+ * - Status bar with keybinding hints
+ */
+import { EventEmitter } from 'events';
+export interface TerminalEditorEvents {
+    submit: [buffer: string];
+    exit: [];
+}
+export declare class TerminalEditor extends EventEmitter {
+    private _lines;
+    private _cursorRow;
+    private _cursorCol;
+    private _renderedLineCount;
+    /** Terminal row (0-indexed from top of rendered block) where the cursor sits */
+    private _cursorTerminalRow;
+    private _active;
+    private _onKeypress;
+    private _onResize;
+    constructor();
+    start(): void;
+    stop(): void;
+    private _handleInput;
+    private _bufferText;
+    private _insertText;
+    private _insertNewline;
+    private _deleteBackward;
+    private _deleteForward;
+    private _moveCursorHorizontal;
+    private _moveCursorVertical;
+    private _submit;
+    private _handleDotCommand;
+    private _runFile;
+    private _clearEditor;
+    private _eraseRendered;
+    _render(): void;
+}
+//# sourceMappingURL=terminal-editor.d.ts.map

package/dist/src/cli/commands/terminal/terminal-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-editor.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/terminal/terminal-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAQtC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,IAAI,EAAE,EAAE,CAAC;CACV;AA0BD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,gFAAgF;IAChF,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,SAAS,CAA2B;;IAU5C,KAAK,IAAI,IAAI;IAkBb,IAAI,IAAI,IAAI;IAgCZ,OAAO,CAAC,YAAY;IA6HpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,iBAAiB;YA+DX,QAAQ;IAiBtB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAqBtB,OAAO,IAAI,IAAI;CAgDhB"}