@justscale/core 0.1.0

package/dist/cli/generators/ide.js

@@ -0,0 +1,179 @@
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Attempt to run `code --install-extension <path>` and return whether it worked. */
+function installVSCodeExtension(extensionPath) {
+    try {
+        const bin = process.platform === 'win32' ? 'code.cmd' : 'code';
+        execSync(`${bin} --install-extension "${extensionPath}" --force`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Find the justscale VS Code extension bundled with @justscale/vscode. */
+function findVSCodeExtension(projectRoot) {
+    const candidates = [
+        join(projectRoot, 'node_modules/@justscale/vscode'),
+        join(projectRoot, '../node_modules/@justscale/vscode'),
+    ];
+    return candidates.find(p => existsSync(join(p, 'package.json')));
+}
+export function generateJetBrainsConfig(projectRoot) {
+    const ideaDir = join(projectRoot, '.idea');
+    mkdirSync(ideaDir, { recursive: true });
+    const generated = [];
+    // TypeScript config — point to JustScale compiler
+    const tsConfigPath = join(ideaDir, 'typescript.xml');
+    if (!existsSync(tsConfigPath)) {
+        writeFileSync(tsConfigPath, `<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="TypeScriptCompilerConfiguration">
+    <option name="useService" value="true" />
+    <option name="typeScriptServiceDirectory" value="$PROJECT_DIR$/node_modules/@justscale/typescript" />
+    <option name="versionType" value="SERVICE_DIRECTORY" />
+  </component>
+</project>
+`);
+        generated.push('.idea/typescript.xml');
+    }
+    // LSP configuration for proto files (JetBrains 2023.2+ with LSP support plugin)
+    const lspConfigPath = join(ideaDir, 'justscale-lsp.xml');
+    if (!existsSync(lspConfigPath)) {
+        writeFileSync(lspConfigPath, `<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <!--
+    JustScale Proto LSP (requires JetBrains 2023.2+ with Language Server Protocol plugin)
+    Plugin: https://plugins.jetbrains.com/plugin/10209-language-server-protocol-client
+
+    The justscale-lsp binary is installed with @justscale/typescript.
+    Configure via: Settings → Languages & Frameworks → Language Server Protocol
+      Command: node_modules/.bin/justscale-lsp
+      File patterns: *.proto
+  -->
+  <component name="JustScaleLSP">
+    <option name="serverBin" value="$PROJECT_DIR$/node_modules/.bin/justscale-lsp" />
+    <option name="filePatterns" value="*.proto" />
+  </component>
+</project>
+`);
+        generated.push('.idea/justscale-lsp.xml');
+    }
+    // Run configurations
+    const runConfigDir = join(ideaDir, 'runConfigurations');
+    mkdirSync(runConfigDir, { recursive: true });
+    const runConfigs = {
+        'just_dev.xml': runConfig('just dev', 'dev'),
+        'just_build.xml': runConfig('just build', 'build'),
+        'just_test.xml': runConfig('just test', 'test'),
+    };
+    for (const [filename, content] of Object.entries(runConfigs)) {
+        const path = join(runConfigDir, filename);
+        if (!existsSync(path)) {
+            writeFileSync(path, content);
+            generated.push(`.idea/runConfigurations/${filename}`);
+        }
+    }
+    return generated;
+}
+function runConfig(name, command) {
+    return `<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="${name}" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="${command}" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>
+`;
+}
+export function generateVSCodeConfig(projectRoot) {
+    const vscodeDir = join(projectRoot, '.vscode');
+    mkdirSync(vscodeDir, { recursive: true });
+    const generated = [];
+    const settingsPath = join(vscodeDir, 'settings.json');
+    const tsdk = './node_modules/@justscale/typescript/lib';
+    const defaultSettings = {
+        'typescript.tsdk': tsdk,
+        'typescript.enablePromptUseWorkspaceTsdk': true,
+        // Associate .proto files with the proto3 language so the LSP activates
+        'files.associations': { '*.proto': 'proto3' },
+    };
+    if (existsSync(settingsPath)) {
+        try {
+            const existing = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            let updated = false;
+            for (const [key, value] of Object.entries(defaultSettings)) {
+                if (existing[key] === undefined) {
+                    existing[key] = value;
+                    updated = true;
+                }
+            }
+            if (updated) {
+                writeFileSync(settingsPath, JSON.stringify(existing, null, 2) + '\n');
+                generated.push('.vscode/settings.json (updated)');
+            }
+        }
+        catch {
+            // malformed json — leave it alone
+        }
+    }
+    else {
+        writeFileSync(settingsPath, JSON.stringify(defaultSettings, null, 2) + '\n');
+        generated.push('.vscode/settings.json');
+    }
+    const launchPath = join(vscodeDir, 'launch.json');
+    if (!existsSync(launchPath)) {
+        writeFileSync(launchPath, JSON.stringify({
+            version: '0.2.0',
+            configurations: [
+                {
+                    type: 'node',
+                    request: 'launch',
+                    name: 'just dev',
+                    runtimeExecutable: 'npx',
+                    runtimeArgs: ['just', 'dev'],
+                    cwd: '${workspaceFolder}',
+                    console: 'integratedTerminal',
+                },
+            ],
+        }, null, 2) + '\n');
+        generated.push('.vscode/launch.json');
+    }
+    const extensionsPath = join(vscodeDir, 'extensions.json');
+    const recommendations = ['dbaeumer.vscode-eslint', 'justscale.justscale-vscode'];
+    if (existsSync(extensionsPath)) {
+        try {
+            const existing = JSON.parse(readFileSync(extensionsPath, 'utf-8'));
+            const existing_recs = existing.recommendations ?? [];
+            const missing = recommendations.filter(r => !existing_recs.includes(r));
+            if (missing.length > 0) {
+                existing.recommendations = [...existing_recs, ...missing];
+                writeFileSync(extensionsPath, JSON.stringify(existing, null, 2) + '\n');
+                generated.push('.vscode/extensions.json (updated)');
+            }
+        }
+        catch {
+            // malformed — leave it
+        }
+    }
+    else {
+        writeFileSync(extensionsPath, JSON.stringify({ recommendations }, null, 2) + '\n');
+        generated.push('.vscode/extensions.json');
+    }
+    // Install VS Code extension for proto LSP if code CLI is available
+    const extPath = findVSCodeExtension(projectRoot);
+    if (extPath) {
+        const installed = installVSCodeExtension(extPath);
+        if (installed) {
+            generated.push('JustScale VS Code extension installed');
+        }
+    }
+    return generated;
+}
+//# sourceMappingURL=ide.js.map

package/dist/cli/generators/ide.js.map

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

package/dist/cli/generators/index.d.ts

@@ -0,0 +1,5 @@
+export { detectSystem, type SystemInfo } from './detect.js';
+export { generateJetBrainsConfig, generateVSCodeConfig } from './ide.js';
+export { generateClaudeConfig, generateCursorConfig } from './ai.js';
+export { generateGitHubActions, generateGitLabCI } from './ci.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/cli/generators/index.js

@@ -0,0 +1,5 @@
+export { detectSystem } from './detect.js';
+export { generateJetBrainsConfig, generateVSCodeConfig } from './ide.js';
+export { generateClaudeConfig, generateCursorConfig } from './ai.js';
+export { generateGitHubActions, generateGitLabCI } from './ci.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @justscale/cli
+ *
+ * CLI Route Factory Plugin
+ *
+ * Provides the Cli route factory for building command-line interfaces.
+ * Supports builder pattern with middleware, typed input/output, and
+ * interactive I/O.
+ *
+ * @example Controller with subcommands
+ * ```typescript
+ * import { createController } from "@justscale/core";
+ * import "@justscale/cli";
+ * import { z } from "zod";
+ *
+ * const MigrateArgs = z.object({
+ *   direction: z.enum(['up', 'down']),
+ *   steps: z.number().default(1),
+ *   verbose: z.boolean().default(false),
+ * });
+ *
+ * const MigrateResult = z.object({
+ *   applied: z.number(),
+ *   pending: z.number(),
+ * });
+ *
+ * export const DbController = createController('db', {
+ *   routes: ({ Cli }) => ({
+ *     migrate: Cli('migrate')
+ *       .input(MigrateArgs)
+ *       .returns(MigrateResult)
+ *       .handle(async ({ args, io }) => {
+ *         const spinner = io.spinner('Running migrations...');
+ *         // ... run migrations
+ *         spinner.success('Migrations complete');
+ *         io.result({ applied: 3, pending: 0 });
+ *       }),
+ *
+ *     seed: Cli('seed')
+ *       .input(z.object({ file: z.string().optional() }))
+ *       .handle(async ({ args, io }) => {
+ *         io.log('Seeding database...');
+ *       }),
+ *   }),
+ * });
+ * ```
+ *
+ * @example Running the CLI
+ * ```typescript
+ * import { createApp } from "@justscale/core";
+ * import { run } from "@justscale/cli";
+ * import { DbController } from "./controllers/db";
+ *
+ * const app = createApp({
+ *   controllers: [DbController],
+ * });
+ *
+ * // Terminal execution
+ * await run(app, { name: 'mycli' });
+ * // $ mycli db migrate up --verbose
+ *
+ * // Programmatic invocation
+ * import { invoke } from "@justscale/cli";
+ * const result = await invoke(app, 'db migrate', { direction: 'up' });
+ * ```
+ */
+import './types.js';
+export { Cli } from './factory.js';
+export { createCliRouteBuilder, INPUT_SCHEMA, getInputSchema, type CliRouteBuilder, type CliRouteDef, type CliMethod, type CliBaseContext, } from './builder/index.js';
+export { run, invoke, createClient, type RunOptions, type RunResult, } from './runner.js';
+export { createTerminalIO, createMockIO, type CliIO, type TerminalIOOptions, type ProgressBar, type Spinner, type TableColumn, } from './io.js';
+export { extractArgDefs, parseArgv, generateHelp, matchCommand, type ArgDef, type ParsedArgs, } from './parser.js';
+export type { CliFactory, CliContext, CliRouteContext, CliRouteHandler, } from './types.js';
+export { RESULT_SCHEMA, getResultSchema } from './types.js';
+export { createLocalAdapter, type CliAdapter } from './adapter.js';
+export { registerCliHandlers } from './cluster.js';
+export { CliService, LazyCliService, createCliService, type ICliService, } from './service.js';
+export { arg, cliArgs, extractCliMeta, getCliMeta, hasCliMeta, getPositionalArgs, getFlagArgs, type CliFieldMeta, type CliArg, type CliArgsShape, } from './args.js';
+import './types.js';
+import './cluster.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAKH,OAAO,YAAY,CAAC;AAGpB,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,GAAG,EACH,MAAM,EACN,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,GAAG,EACH,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,YAAY,CAAC;AAGpB,OAAO,cAAc,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,88 @@
+/**
+ * @justscale/cli
+ *
+ * CLI Route Factory Plugin
+ *
+ * Provides the Cli route factory for building command-line interfaces.
+ * Supports builder pattern with middleware, typed input/output, and
+ * interactive I/O.
+ *
+ * @example Controller with subcommands
+ * ```typescript
+ * import { createController } from "@justscale/core";
+ * import "@justscale/cli";
+ * import { z } from "zod";
+ *
+ * const MigrateArgs = z.object({
+ *   direction: z.enum(['up', 'down']),
+ *   steps: z.number().default(1),
+ *   verbose: z.boolean().default(false),
+ * });
+ *
+ * const MigrateResult = z.object({
+ *   applied: z.number(),
+ *   pending: z.number(),
+ * });
+ *
+ * export const DbController = createController('db', {
+ *   routes: ({ Cli }) => ({
+ *     migrate: Cli('migrate')
+ *       .input(MigrateArgs)
+ *       .returns(MigrateResult)
+ *       .handle(async ({ args, io }) => {
+ *         const spinner = io.spinner('Running migrations...');
+ *         // ... run migrations
+ *         spinner.success('Migrations complete');
+ *         io.result({ applied: 3, pending: 0 });
+ *       }),
+ *
+ *     seed: Cli('seed')
+ *       .input(z.object({ file: z.string().optional() }))
+ *       .handle(async ({ args, io }) => {
+ *         io.log('Seeding database...');
+ *       }),
+ *   }),
+ * });
+ * ```
+ *
+ * @example Running the CLI
+ * ```typescript
+ * import { createApp } from "@justscale/core";
+ * import { run } from "@justscale/cli";
+ * import { DbController } from "./controllers/db";
+ *
+ * const app = createApp({
+ *   controllers: [DbController],
+ * });
+ *
+ * // Terminal execution
+ * await run(app, { name: 'mycli' });
+ * // $ mycli db migrate up --verbose
+ *
+ * // Programmatic invocation
+ * import { invoke } from "@justscale/cli";
+ * const result = await invoke(app, 'db migrate', { direction: 'up' });
+ * ```
+ */
+import { registerRouteFactory } from '../core/index.js';
+import { Cli } from './factory.js';
+// Side-effect import to apply module augmentation (SupportedMethods)
+import './types.js';
+// Re-export everything
+export { Cli } from './factory.js';
+export { createCliRouteBuilder, INPUT_SCHEMA, getInputSchema, } from './builder/index.js';
+export { run, invoke, createClient, } from './runner.js';
+export { createTerminalIO, createMockIO, } from './io.js';
+export { extractArgDefs, parseArgv, generateHelp, matchCommand, } from './parser.js';
+export { RESULT_SCHEMA, getResultSchema } from './types.js';
+export { createLocalAdapter } from './adapter.js';
+export { registerCliHandlers } from './cluster.js';
+export { CliService, LazyCliService, createCliService, } from './service.js';
+export { arg, cliArgs, extractCliMeta, getCliMeta, hasCliMeta, getPositionalArgs, getFlagArgs, } from './args.js';
+// Import types for augmentation side effect
+import './types.js';
+// Import cluster integration - auto-registers CLI as transport plugin
+import './cluster.js';
+// Register the Cli factory
+registerRouteFactory('Cli', Cli);
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,qEAAqE;AACrE,OAAO,YAAY,CAAC;AAEpB,uBAAuB;AACvB,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,cAAc,GAKf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,GAAG,EACH,MAAM,EACN,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,YAAY,GAMb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,YAAY,GAGb,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAmB,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,GAAG,EACH,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,GAIZ,MAAM,WAAW,CAAC;AAEnB,4CAA4C;AAC5C,OAAO,YAAY,CAAC;AAEpB,sEAAsE;AACtE,OAAO,cAAc,CAAC;AAEtB,2BAA2B;AAC3B,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC"}

package/dist/cli/io.d.ts

@@ -0,0 +1,131 @@
+/**
+ * CLI I/O Interface
+ *
+ * Abstraction for CLI input/output that can be backed by:
+ * - Real terminal (stdin/stdout with readline)
+ * - Remote connection (WebSocket, SSH)
+ * - Mock for testing
+ */
+import type { z } from 'zod';
+/**
+ * Progress bar interface for long-running operations
+ */
+export interface ProgressBar {
+    /** Update progress (0-100) */
+    update(percent: number): void;
+    /** Update with message */
+    update(percent: number, message: string): void;
+    /** Complete the progress bar */
+    complete(): void;
+    /** Fail the progress bar */
+    fail(message?: string): void;
+}
+/**
+ * Spinner interface for indeterminate operations
+ */
+export interface Spinner {
+    /** Update spinner text */
+    text(message: string): void;
+    /** Mark as success and stop */
+    success(message?: string): void;
+    /** Mark as failure and stop */
+    fail(message?: string): void;
+    /** Stop without status */
+    stop(): void;
+}
+/**
+ * Table column definition
+ */
+export interface TableColumn<T> {
+    key: keyof T;
+    header?: string;
+    width?: number;
+    align?: 'left' | 'right' | 'center';
+}
+/**
+ * CLI I/O interface - the primary way to interact with the user
+ *
+ * @typeParam TResult - The type of the structured result (set by .returns())
+ */
+export interface CliIO<TResult = void> {
+    /** Write text (no newline) */
+    write(text: string): void;
+    /** Write line with newline */
+    log(message: string): void;
+    /** Write warning (yellow) */
+    warn(message: string): void;
+    /** Write error (red, to stderr) */
+    error(message: string): void;
+    /** Write debug message (only if verbose mode) */
+    debug(message: string): void;
+    /**
+     * Send structured result.
+     * Typed by .returns() schema - validated at runtime.
+     * This is the "return value" of the command for programmatic use.
+     */
+    result(data: TResult): void;
+    /** Prompt for text input */
+    prompt(question: string): Promise<string>;
+    /** Prompt with default value */
+    prompt(question: string, defaultValue: string): Promise<string>;
+    /** Prompt for confirmation (y/n) */
+    confirm(question: string): Promise<boolean>;
+    /** Prompt for confirmation with default */
+    confirm(question: string, defaultValue: boolean): Promise<boolean>;
+    /** Select from list of options */
+    select<T extends string>(question: string, choices: T[]): Promise<T>;
+    /** Select from list with labels */
+    select<T extends string>(question: string, choices: {
+        value: T;
+        label: string;
+    }[]): Promise<T>;
+    /** Multi-select from list */
+    multiSelect<T extends string>(question: string, choices: T[]): Promise<T[]>;
+    /** Prompt for password (hidden input) */
+    password(question: string): Promise<string>;
+    /** Create a progress bar */
+    progress(label: string, total?: number): ProgressBar;
+    /** Create a spinner for indeterminate operations */
+    spinner(label: string): Spinner;
+    /** Render a table */
+    table<T extends Record<string, unknown>>(data: T[], columns?: (keyof T)[] | TableColumn<T>[]): void;
+    /** Print a horizontal rule */
+    hr(): void;
+    /** Print empty line */
+    newline(): void;
+    /** Check if running in interactive mode (TTY) */
+    readonly isInteractive: boolean;
+    /** Check if verbose mode is enabled */
+    readonly isVerbose: boolean;
+}
+/**
+ * Options for creating a terminal IO
+ */
+export interface TerminalIOOptions {
+    /** Enable verbose output */
+    verbose?: boolean;
+    /** Custom stdin (default: process.stdin) */
+    stdin?: NodeJS.ReadStream;
+    /** Custom stdout (default: process.stdout) */
+    stdout?: NodeJS.WriteStream;
+    /** Custom stderr (default: process.stderr) */
+    stderr?: NodeJS.WriteStream;
+    /** Result schema for validation */
+    resultSchema?: z.ZodType;
+    /** Callback when result() is called */
+    onResult?: (data: unknown) => void;
+}
+/**
+ * Create a terminal-based CliIO implementation
+ */
+export declare function createTerminalIO<TResult = void>(options?: TerminalIOOptions): CliIO<TResult>;
+/**
+ * Create a mock CliIO for testing
+ */
+export declare function createMockIO<TResult = void>(): CliIO<TResult> & {
+    output: string[];
+    errors: string[];
+    results: unknown[];
+    setInputs(inputs: string[]): void;
+};
+//# sourceMappingURL=io.d.ts.map

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

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