@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/cli/adapters/cli-command-adapter-handler.test.js.map

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

package/dist/src/cli/adapters/cli-command-adapter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * CLI adapter — converts a `CommandDefinition` into a yargs `CommandModule`.
+ *
+ * Responsibilities:
+ *   - Maps `ArgDefinition` records to yargs positionals/options
+ *   - Injects universal args based on scope and safety
+ *   - Wraps handler in connect → resolve → fn → disconnect lifecycle
+ *   - Dispatches results to a `ResultReporter` (stdout / file / watch redraw)
+ *   - Honors `--output` (file write), `--open`, `--watch`, `--interval`
+ */
+import type { CommandModule } from 'yargs';
+import { BridgeConnection } from '../../bridge/index.js';
+import type { CommandDefinition } from '../../commands/framework/define-command.js';
+/** Args injected by the adapter (not defined on CommandDefinition). */
+export interface AdapterArgs {
+    target?: string;
+    context?: string;
+    format?: string;
+    output?: string;
+    open?: boolean;
+    watch?: boolean;
+    interval?: number;
+}
+/**
+ * Optional lifecycle override for testing. When provided, the adapter
+ * calls these instead of `BridgeConnection.connectAsync`.
+ */
+export interface CliLifecycleProvider {
+    connectAsync(opts: {
+        timeoutMs?: number;
+        remoteHost?: string;
+        local?: boolean;
+        waitForSessions?: boolean;
+    }): Promise<BridgeConnection>;
+}
+export declare function buildYargsCommand(def: CommandDefinition, options?: {
+    lifecycle?: CliLifecycleProvider;
+}): CommandModule;
+//# sourceMappingURL=cli-command-adapter.d.ts.map

package/dist/src/cli/adapters/cli-command-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-adapter.d.ts","sourceRoot":"","sources":["../../../../src/cli/adapters/cli-command-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAC;AAOjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAGpF,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,IAAI,EAAE;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/B;AAgHD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,EACtB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,oBAAoB,CAAA;CAAE,GAC7C,aAAa,CA+Ff"}

package/dist/src/cli/adapters/cli-command-adapter.js

@@ -0,0 +1,241 @@
+/**
+ * CLI adapter — converts a `CommandDefinition` into a yargs `CommandModule`.
+ *
+ * Responsibilities:
+ *   - Maps `ArgDefinition` records to yargs positionals/options
+ *   - Injects universal args based on scope and safety
+ *   - Wraps handler in connect → resolve → fn → disconnect lifecycle
+ *   - Dispatches results to a `ResultReporter` (stdout / file / watch redraw)
+ *   - Honors `--output` (file write), `--open`, `--watch`, `--interval`
+ */
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { buildResultReporter, formatJson, } from '@quenty/cli-output-helpers/reporting';
+import { BridgeConnection } from '../../bridge/index.js';
+import { toYargsOptions } from '../../commands/framework/arg-builder.js';
+/** Extract only command-specific args from the full argv object. */
+function extractCommandArgs(argv, def) {
+    const commandArgs = {};
+    for (const name of Object.keys(def.args)) {
+        if (name in argv) {
+            commandArgs[name] = argv[name];
+        }
+    }
+    return commandArgs;
+}
+/** Execute a command's handler with appropriate connection lifecycle. */
+async function executeCommandAsync(def, commandArgs, argv, connect, existingConnection) {
+    if (def.scope === 'standalone') {
+        return def.handler(commandArgs);
+    }
+    // Reuse existing connection if provided (watch mode), otherwise connect fresh
+    const connection = existingConnection ??
+        (await connect({
+            timeoutMs: argv.timeout,
+            remoteHost: argv.remote,
+            local: argv.local,
+            waitForSessions: def.scope === 'connection',
+        }));
+    try {
+        if (def.scope === 'session') {
+            const session = await connection.resolveSessionAsync(argv.target, argv.context);
+            return await def.handler(session, commandArgs);
+        }
+        return await def.handler(connection, commandArgs);
+    }
+    finally {
+        if (!existingConnection) {
+            await connection.disconnectAsync();
+        }
+    }
+}
+/** Inject version/diagnostic warnings into JSON result objects. */
+function injectWarnings(result) {
+    const warnings = globalThis.__studioBridgeWarnings;
+    if (!warnings || warnings.length === 0)
+        return result;
+    if (typeof result === 'object' && result !== null && !Array.isArray(result)) {
+        return { ...result, _warnings: warnings };
+    }
+    return result;
+}
+/**
+ * Render a command result for stdout/file output. `--format=json` (or any
+ * explicit non-text format) routes through the command's `json` override or
+ * falls back to `formatJson`. Anything else (default, `--format=text`)
+ * routes through the command's `format` callback, then `result.summary`,
+ * then JSON as a last resort.
+ */
+function renderResult(def, result, explicitFormat) {
+    if (explicitFormat === 'json') {
+        if (def.cli?.json)
+            return def.cli.json(result);
+        return formatJson(injectWarnings(result), { pretty: process.stdout.isTTY });
+    }
+    if (def.cli?.format)
+        return def.cli.format(result);
+    if (typeof result === 'object' && result !== null && 'summary' in result) {
+        return result.summary;
+    }
+    return formatJson(result);
+}
+/**
+ * Extract a Buffer from the result's binary field, or undefined if no
+ * binary field is configured / extractable / requested. When `--format=json`
+ * is explicit the user wants JSON not raw bytes — return undefined so the
+ * file reporter falls back to text rendering.
+ */
+function extractBinaryBuffer(def, result, format) {
+    if (format === 'json')
+        return undefined;
+    const binaryField = def.cli?.binaryField;
+    if (!binaryField)
+        return undefined;
+    if (typeof result !== 'object' || result === null)
+        return undefined;
+    const data = result[binaryField];
+    if (typeof data !== 'string')
+        return undefined;
+    return Buffer.from(data, 'base64');
+}
+export function buildYargsCommand(def, options) {
+    const { positionals, options: yargsOptions } = toYargsOptions(def.args);
+    const positionalSuffix = positionals
+        .map((p) => (p.options.demandOption ? `<${p.name}>` : `[${p.name}]`))
+        .join(' ');
+    const command = positionalSuffix
+        ? `${def.name} ${positionalSuffix}`
+        : def.name;
+    return {
+        command,
+        describe: def.description,
+        builder: (yargs) => {
+            for (const pos of positionals) {
+                yargs.positional(pos.name, pos.options);
+            }
+            for (const [name, opt] of Object.entries(yargsOptions)) {
+                yargs.option(name, opt);
+            }
+            if (def.scope === 'session' || def.scope === 'connection') {
+                yargs.option('target', {
+                    alias: 't',
+                    type: 'string',
+                    describe: 'Target session ID (or "all" for broadcast)',
+                });
+                yargs.option('context', {
+                    type: 'string',
+                    describe: 'Target context (edit, client, server)',
+                    choices: ['edit', 'client', 'server'],
+                });
+            }
+            yargs.option('format', {
+                type: 'string',
+                choices: ['text', 'json'],
+                describe: 'Output format',
+            });
+            yargs.option('output', {
+                alias: 'o',
+                type: 'string',
+                describe: 'Write output to file',
+            });
+            yargs.option('open', {
+                type: 'boolean',
+                default: false,
+                describe: 'Open output file after writing',
+            });
+            if (def.safety === 'read') {
+                yargs.option('watch', {
+                    alias: 'w',
+                    type: 'boolean',
+                    default: false,
+                    describe: 'Watch for changes',
+                });
+                yargs.option('interval', {
+                    type: 'number',
+                    default: 1000,
+                    describe: 'Watch interval in milliseconds',
+                });
+            }
+            return yargs;
+        },
+        handler: async (argv) => {
+            const commandArgs = extractCommandArgs(argv, def);
+            const explicitFormat = argv.format;
+            const reporter = buildResultReporter({
+                outputPath: argv.output,
+                watch: !!argv.watch && def.safety === 'read',
+                open: argv.open,
+                intervalMs: argv.interval,
+                render: (result) => renderResult(def, result, explicitFormat),
+                binary: (result) => extractBinaryBuffer(def, result, explicitFormat),
+            });
+            const connect = options?.lifecycle?.connectAsync.bind(options.lifecycle) ??
+                BridgeConnection.connectAsync.bind(BridgeConnection);
+            try {
+                if (argv.watch && def.safety === 'read') {
+                    await runWatchModeAsync(def, commandArgs, argv, reporter, connect);
+                }
+                else {
+                    await runOnceAsync(def, commandArgs, argv, reporter, connect);
+                }
+            }
+            catch (err) {
+                OutputHelper.error(err instanceof Error ? err.message : String(err));
+                process.exit(1);
+            }
+        },
+    };
+}
+async function runOnceAsync(def, commandArgs, argv, reporter, connect) {
+    const result = await executeCommandAsync(def, commandArgs, argv, connect);
+    await reporter.startAsync();
+    reporter.onResult(result);
+    await reporter.stopAsync();
+    if (typeof result === 'object' &&
+        result !== null &&
+        'success' in result &&
+        !result.success) {
+        process.exit(1);
+    }
+}
+async function runWatchModeAsync(def, commandArgs, argv, reporter, connect) {
+    const intervalMs = argv.interval ?? 1000;
+    // Standalone commands run without a persistent connection
+    const connection = def.scope === 'standalone'
+        ? undefined
+        : await connect({
+            timeoutMs: argv.timeout,
+            remoteHost: argv.remote,
+            local: argv.local,
+            waitForSessions: def.scope === 'connection',
+        });
+    let stopped = false;
+    const cleanup = () => {
+        stopped = true;
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    try {
+        await reporter.startAsync();
+        let result = await executeCommandAsync(def, commandArgs, argv, connect, connection);
+        reporter.onResult(result);
+        while (!stopped) {
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+            if (stopped)
+                break;
+            try {
+                result = await executeCommandAsync(def, commandArgs, argv, connect, connection);
+                reporter.onResult(result);
+            }
+            catch {
+                // Swallow transient errors during polling
+            }
+        }
+    }
+    finally {
+        await reporter.stopAsync();
+        if (connection) {
+            await connection.disconnectAsync();
+        }
+    }
+}
+//# sourceMappingURL=cli-command-adapter.js.map

package/dist/src/cli/adapters/cli-command-adapter.js.map

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

package/dist/src/cli/adapters/cli-command-adapter.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the CLI command adapter.
+ */
+export {};
+//# sourceMappingURL=cli-command-adapter.test.d.ts.map

package/dist/src/cli/adapters/cli-command-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-adapter.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/adapters/cli-command-adapter.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/cli/adapters/cli-command-adapter.test.js

@@ -0,0 +1,188 @@
+/**
+ * Unit tests for the CLI command adapter.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { buildYargsCommand } from './cli-command-adapter.js';
+import { defineCommand, } from '../../commands/framework/define-command.js';
+import { arg } from '../../commands/framework/arg-builder.js';
+function sessionCommand(overrides = {}) {
+    return defineCommand({
+        group: 'console',
+        name: overrides.name ?? 'exec',
+        description: 'Execute code',
+        category: 'execution',
+        safety: overrides.safety ?? 'mutate',
+        scope: 'session',
+        args: {
+            code: arg.positional({ description: 'Luau source code' }),
+            timeout: arg.option({
+                description: 'Timeout',
+                type: 'number',
+                alias: 'T',
+            }),
+        },
+        handler: async (_session, _args) => ({ success: true }),
+    });
+}
+function standaloneCommand() {
+    return defineCommand({
+        group: null,
+        name: 'serve',
+        description: 'Start the bridge server',
+        category: 'infrastructure',
+        safety: 'none',
+        scope: 'standalone',
+        args: {
+            port: arg.option({
+                description: 'Port number',
+                type: 'number',
+                default: 38741,
+            }),
+        },
+        handler: async () => ({ started: true }),
+    });
+}
+function connectionCommand() {
+    return defineCommand({
+        group: 'process',
+        name: 'list',
+        description: 'List sessions',
+        category: 'infrastructure',
+        safety: 'read',
+        scope: 'connection',
+        args: {},
+        handler: async () => ({ sessions: [] }),
+    });
+}
+/** Mock yargs Argv object that records calls. */
+function createMockYargs() {
+    const positionals = {};
+    const options = {};
+    const mock = {
+        positionals,
+        options,
+        positional: vi.fn((name, opts) => {
+            positionals[name] = opts;
+            return mock;
+        }),
+        option: vi.fn((name, opts) => {
+            options[name] = opts;
+            return mock;
+        }),
+        demandCommand: vi.fn(() => mock),
+    };
+    return mock;
+}
+describe('buildYargsCommand', () => {
+    describe('command string', () => {
+        it('includes positional args in command string', () => {
+            const module = buildYargsCommand(sessionCommand());
+            expect(module.command).toBe('exec <code>');
+        });
+        it('produces simple command string with no positionals', () => {
+            const module = buildYargsCommand(standaloneCommand());
+            expect(module.command).toBe('serve');
+        });
+        it('uses command description', () => {
+            const module = buildYargsCommand(sessionCommand());
+            expect(module.describe).toBe('Execute code');
+        });
+    });
+    describe('builder — arg registration', () => {
+        it('registers positional args', () => {
+            const module = buildYargsCommand(sessionCommand());
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.positionals.code).toBeDefined();
+            expect(yargs.positionals.code.describe).toBe('Luau source code');
+            expect(yargs.positionals.code.type).toBe('string');
+            expect(yargs.positionals.code.demandOption).toBe(true);
+        });
+        it('registers command-specific options', () => {
+            const module = buildYargsCommand(sessionCommand());
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.timeout).toBeDefined();
+            expect(yargs.options.timeout.describe).toBe('Timeout');
+            expect(yargs.options.timeout.type).toBe('number');
+            expect(yargs.options.timeout.alias).toBe('T');
+        });
+    });
+    describe('builder — universal args', () => {
+        it('injects --target and --context for session-scoped commands', () => {
+            const module = buildYargsCommand(sessionCommand());
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.target).toBeDefined();
+            expect(yargs.options.target.alias).toBe('t');
+            expect(yargs.options.context).toBeDefined();
+        });
+        it('injects --target and --context for connection-scoped commands', () => {
+            const module = buildYargsCommand(connectionCommand());
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.target).toBeDefined();
+            expect(yargs.options.context).toBeDefined();
+        });
+        it('does not inject --target for standalone commands', () => {
+            const module = buildYargsCommand(standaloneCommand());
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.target).toBeUndefined();
+            expect(yargs.options.context).toBeUndefined();
+        });
+        it('always injects --format, --output, --open', () => {
+            const module = buildYargsCommand(standaloneCommand());
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.format).toBeDefined();
+            expect(yargs.options.output).toBeDefined();
+            expect(yargs.options.open).toBeDefined();
+        });
+        it('injects --watch and --interval for read-safety commands', () => {
+            const module = buildYargsCommand(connectionCommand()); // safety: 'read'
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.watch).toBeDefined();
+            expect(yargs.options.watch.alias).toBe('w');
+            expect(yargs.options.interval).toBeDefined();
+            expect(yargs.options.interval.default).toBe(1000);
+        });
+        it('does not inject --watch for mutate-safety commands', () => {
+            const module = buildYargsCommand(sessionCommand({ safety: 'mutate' }));
+            const yargs = createMockYargs();
+            module.builder(yargs);
+            expect(yargs.options.watch).toBeUndefined();
+            expect(yargs.options.interval).toBeUndefined();
+        });
+    });
+    describe('handler — standalone', () => {
+        it('calls standalone handler with extracted args', async () => {
+            const handler = vi.fn().mockResolvedValue({ started: true });
+            const cmd = defineCommand({
+                group: null,
+                name: 'serve',
+                description: 'Start server',
+                category: 'infrastructure',
+                safety: 'none',
+                scope: 'standalone',
+                args: {
+                    port: arg.option({
+                        description: 'Port',
+                        type: 'number',
+                        default: 38741,
+                    }),
+                },
+                handler,
+            });
+            const module = buildYargsCommand(cmd);
+            await module.handler({
+                port: 9999,
+                verbose: false,
+                timeout: 120000,
+            });
+            expect(handler).toHaveBeenCalledWith({ port: 9999 });
+        });
+    });
+});
+//# sourceMappingURL=cli-command-adapter.test.js.map

package/dist/src/cli/adapters/cli-command-adapter.test.js.map

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

package/dist/src/cli/adapters/group-builder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Group builder — converts a `CommandRegistry` into yargs `CommandModule`
+ * entries with grouped subcommands.
+ *
+ * Grouped commands become parent commands with subcommands:
+ *   `console exec <code>`  →  `console` parent, `exec` subcommand
+ *
+ * Top-level commands (group = null) are returned as standalone modules:
+ *   `serve`, `mcp`, `terminal`
+ */
+import type { CommandModule } from 'yargs';
+import type { CommandRegistry } from '../../commands/framework/command-registry.js';
+import type { CliLifecycleProvider } from './cli-command-adapter.js';
+export interface GroupBuilderOptions {
+    lifecycle?: CliLifecycleProvider;
+}
+export interface GroupBuilderResult {
+    /** Parent commands for each group (e.g. `console <command>`). */
+    groups: CommandModule[];
+    /** Top-level commands with no group (e.g. `serve`, `mcp`). */
+    topLevel: CommandModule[];
+}
+/**
+ * Build yargs command modules from a registry. Returns grouped parent
+ * commands and top-level standalone commands separately so the caller
+ * can register them independently.
+ */
+export declare function buildGroupCommands(registry: CommandRegistry, options?: GroupBuilderOptions): GroupBuilderResult;
+//# sourceMappingURL=group-builder.d.ts.map

package/dist/src/cli/adapters/group-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-builder.d.ts","sourceRoot":"","sources":["../../../../src/cli/adapters/group-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAgBrE,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAgCpB"}

package/dist/src/cli/adapters/group-builder.js

@@ -0,0 +1,54 @@
+/**
+ * Group builder — converts a `CommandRegistry` into yargs `CommandModule`
+ * entries with grouped subcommands.
+ *
+ * Grouped commands become parent commands with subcommands:
+ *   `console exec <code>`  →  `console` parent, `exec` subcommand
+ *
+ * Top-level commands (group = null) are returned as standalone modules:
+ *   `serve`, `mcp`, `terminal`
+ */
+import { buildYargsCommand } from './cli-command-adapter.js';
+const GROUP_DESCRIPTIONS = {
+    console: 'Execute code and view logs',
+    explorer: 'Query and modify the DataModel',
+    properties: 'Read and write instance properties',
+    viewport: 'Screenshots and camera control',
+    data: 'Load and save serialized data',
+    playtest: 'Control play test sessions',
+    process: 'Manage Studio processes',
+    plugin: 'Manage the bridge plugin',
+    action: 'Invoke a Studio action',
+    linux: 'Linux/Wine environment management',
+};
+/**
+ * Build yargs command modules from a registry. Returns grouped parent
+ * commands and top-level standalone commands separately so the caller
+ * can register them independently.
+ */
+export function buildGroupCommands(registry, options = {}) {
+    const groups = [];
+    const topLevel = [];
+    // Grouped commands → parent module with subcommands
+    for (const groupName of registry.getGroups()) {
+        const commands = registry.getByGroup(groupName);
+        const description = GROUP_DESCRIPTIONS[groupName] ?? `${groupName} commands`;
+        groups.push({
+            command: `${groupName} <command>`,
+            describe: description,
+            builder: (yargs) => {
+                for (const cmd of commands) {
+                    yargs.command(buildYargsCommand(cmd, options));
+                }
+                return yargs.demandCommand(1, `Run 'studio-bridge ${groupName} --help' for available commands`);
+            },
+            handler: () => { },
+        });
+    }
+    // Top-level commands (group = null) → standalone modules
+    for (const cmd of registry.getTopLevel()) {
+        topLevel.push(buildYargsCommand(cmd, options));
+    }
+    return { groups, topLevel };
+}
+//# sourceMappingURL=group-builder.js.map

package/dist/src/cli/adapters/group-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-builder.js","sourceRoot":"","sources":["../../../../src/cli/adapters/group-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,kBAAkB,GAA2B;IACjD,OAAO,EAAE,4BAA4B;IACrC,QAAQ,EAAE,gCAAgC;IAC1C,UAAU,EAAE,oCAAoC;IAChD,QAAQ,EAAE,gCAAgC;IAC1C,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,4BAA4B;IACtC,OAAO,EAAE,yBAAyB;IAClC,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,wBAAwB;IAChC,KAAK,EAAE,mCAAmC;CAC3C,CAAC;AAaF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAyB,EACzB,UAA+B,EAAE;IAEjC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,oDAAoD;IACpD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,WAAW,GACf,kBAAkB,CAAC,SAAS,CAAC,IAAI,GAAG,SAAS,WAAW,CAAC;QAE3D,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,GAAG,SAAS,YAAY;YACjC,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAQ,CAAC,CAAC;gBACxD,CAAC;gBACD,OAAO,KAAK,CAAC,aAAa,CACxB,CAAC,EACD,sBAAsB,SAAS,iCAAiC,CACjE,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;SAClB,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/src/cli/adapters/group-builder.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the group builder.
+ */
+export {};
+//# sourceMappingURL=group-builder.test.d.ts.map

package/dist/src/cli/adapters/group-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-builder.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/adapters/group-builder.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}