@rcrsr/rill-cli 0.6.0

package/dist/cli-error-formatter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CLI Error Formatter
+ * Format enriched errors for human-readable, JSON, or compact output
+ */
+import type { SourceSpan, CallFrame } from '@rcrsr/rill';
+import type { EnrichedError } from './cli-error-enrichment.js';
+export type { CallFrame, EnrichedError };
+/**
+ * Format options for error output.
+ */
+export interface FormatOptions {
+    readonly format: 'human' | 'json' | 'compact';
+    readonly verbose: boolean;
+    readonly includeCallStack: boolean;
+    readonly maxCallStackDepth: number;
+}
+/**
+ * Format enriched error for output.
+ *
+ * Constraints:
+ * - Human format: multi-line with snippet and caret underline
+ * - JSON format: LSP Diagnostic compatible
+ * - Compact format: single line for CI output
+ *
+ * @param error - Enriched error with context
+ * @param options - Format options
+ * @returns Formatted error string
+ * @throws {TypeError} Unknown format
+ */
+export declare function formatError(error: EnrichedError, options: FormatOptions): string;
+/**
+ * Render caret underline for error span.
+ *
+ * Constraints:
+ * - Single-char: single ^
+ * - Multi-char same line: ^^^^^ (length = span width)
+ * - Multi-line: ^^^^^ (continues) on first line only
+ *
+ * @param span - Error span
+ * @param lineContent - Content of the line
+ * @returns Caret underline string
+ * @throws {RangeError} Invalid span (start after end)
+ */
+export declare function renderCaretUnderline(span: SourceSpan, lineContent: string): string;
+//# sourceMappingURL=cli-error-formatter.d.ts.map

package/dist/cli-error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error-formatter.d.ts","sourceRoot":"","sources":["../src/cli-error-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,aAAa,GACrB,MAAM,CAmBR;AA8MD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CA2BR"}

package/dist/cli-error-formatter.js

@@ -0,0 +1,218 @@
+/**
+ * CLI Error Formatter
+ * Format enriched errors for human-readable, JSON, or compact output
+ */
+// ============================================================
+// ERROR FORMATTING
+// ============================================================
+/**
+ * Format enriched error for output.
+ *
+ * Constraints:
+ * - Human format: multi-line with snippet and caret underline
+ * - JSON format: LSP Diagnostic compatible
+ * - Compact format: single line for CI output
+ *
+ * @param error - Enriched error with context
+ * @param options - Format options
+ * @returns Formatted error string
+ * @throws {TypeError} Unknown format
+ */
+export function formatError(error, options) {
+    // EC-5: Unknown format throws TypeError
+    if (options.format !== 'human' &&
+        options.format !== 'json' &&
+        options.format !== 'compact') {
+        throw new TypeError(`Unknown format: ${options.format}`);
+    }
+    if (options.format === 'json') {
+        return formatErrorJson(error, options);
+    }
+    if (options.format === 'compact') {
+        return formatErrorCompact(error);
+    }
+    return formatErrorHuman(error, options);
+}
+/**
+ * Format error in human-readable format.
+ *
+ * Output format:
+ * ```
+ * error[RILL-R005]: Variable foo is not defined
+ *   --> script.rill:5:10
+ *    |
+ *  3 | "start" => $begin
+ *  4 | $begin -> .upper => $upper
+ *  5 | $foo -> .len
+ *    |   ^^^^ undefined variable
+ *    |
+ *    = help: Did you mean `$begin`?
+ * ```
+ */
+function formatErrorHuman(error, options) {
+    const lines = [];
+    // Header: error[RILL-XXXX]: message
+    lines.push(`error[${error.errorId}]: ${error.message}`);
+    // Location: --> script.rill:5:10
+    if (error.span) {
+        const location = `${error.span.start.line}:${error.span.start.column}`;
+        lines.push(`  --> ${location}`);
+    }
+    // Source snippet with caret underline
+    if (error.sourceSnippet && error.sourceSnippet.lines.length > 0) {
+        lines.push('   |');
+        // Calculate padding width for line numbers
+        const maxLineNumber = Math.max(...error.sourceSnippet.lines.map((l) => l.lineNumber));
+        const lineNumberWidth = String(maxLineNumber).length;
+        for (const line of error.sourceSnippet.lines) {
+            const lineNumStr = String(line.lineNumber).padStart(lineNumberWidth, ' ');
+            lines.push(` ${lineNumStr} | ${line.content}`);
+            // Add caret underline for error lines
+            if (line.isErrorLine && error.span) {
+                const caret = renderCaretUnderline(error.span, line.content);
+                const padding = ' '.repeat(lineNumberWidth);
+                lines.push(` ${padding} | ${caret}`);
+            }
+        }
+        lines.push('   |');
+    }
+    // Suggestions: = help: Did you mean `$begin`?
+    if (error.suggestions && error.suggestions.length > 0) {
+        for (const suggestion of error.suggestions) {
+            lines.push(`   = help: ${suggestion}`);
+        }
+    }
+    // Help URL
+    if (options.verbose && error.helpUrl) {
+        lines.push(`   = see: ${error.helpUrl}`);
+    }
+    // Call stack
+    if (options.includeCallStack &&
+        error.callStack &&
+        error.callStack.length > 0) {
+        lines.push('');
+        lines.push('Call stack:');
+        const depth = Math.min(error.callStack.length, options.maxCallStackDepth);
+        for (let i = 0; i < depth; i++) {
+            const frame = error.callStack[i];
+            const location = `${frame.location.start.line}:${frame.location.start.column}`;
+            const name = frame.functionName ?? '<anonymous>';
+            const context = frame.context ? ` (${frame.context})` : '';
+            lines.push(`  ${i + 1}. ${name}${context} at ${location}`);
+        }
+        if (error.callStack.length > depth) {
+            lines.push(`  ... ${error.callStack.length - depth} more frames`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format error in JSON format (LSP Diagnostic compatible).
+ */
+function formatErrorJson(error, options) {
+    const diagnostic = {
+        errorId: error.errorId,
+        severity: 1, // Error severity in LSP (1 = Error, 2 = Warning, 3 = Information, 4 = Hint)
+        message: error.message,
+        source: 'rill',
+        code: error.errorId,
+    };
+    if (error.span) {
+        diagnostic.range = {
+            start: {
+                line: error.span.start.line - 1, // LSP uses 0-based line numbers
+                character: error.span.start.column,
+            },
+            end: {
+                line: error.span.end.line - 1, // LSP uses 0-based line numbers
+                character: error.span.end.column,
+            },
+        };
+    }
+    if (error.suggestions && error.suggestions.length > 0) {
+        diagnostic.suggestions = error.suggestions;
+    }
+    if (options.includeCallStack &&
+        error.callStack &&
+        error.callStack.length > 0) {
+        const depth = Math.min(error.callStack.length, options.maxCallStackDepth);
+        diagnostic.callStack = error.callStack.slice(0, depth).map((frame) => {
+            const callFrame = {
+                location: {
+                    start: {
+                        line: frame.location.start.line - 1,
+                        character: frame.location.start.column,
+                    },
+                    end: {
+                        line: frame.location.end.line - 1,
+                        character: frame.location.end.column,
+                    },
+                },
+            };
+            if (frame.functionName !== undefined) {
+                callFrame.functionName = frame.functionName;
+            }
+            if (frame.context !== undefined) {
+                callFrame.context = frame.context;
+            }
+            return callFrame;
+        });
+    }
+    if (options.verbose && error.helpUrl) {
+        diagnostic.helpUrl = error.helpUrl;
+    }
+    return JSON.stringify(diagnostic, null, 2);
+}
+/**
+ * Format error in compact format (single line for CI).
+ */
+function formatErrorCompact(error) {
+    const parts = [`[${error.errorId}]`, error.message];
+    if (error.span) {
+        parts.push(`at ${error.span.start.line}:${error.span.start.column}`);
+    }
+    if (error.suggestions && error.suggestions.length > 0) {
+        parts.push(`(hint: ${error.suggestions[0]})`);
+    }
+    return parts.join(' ');
+}
+// ============================================================
+// CARET UNDERLINE
+// ============================================================
+/**
+ * Render caret underline for error span.
+ *
+ * Constraints:
+ * - Single-char: single ^
+ * - Multi-char same line: ^^^^^ (length = span width)
+ * - Multi-line: ^^^^^ (continues) on first line only
+ *
+ * @param span - Error span
+ * @param lineContent - Content of the line
+ * @returns Caret underline string
+ * @throws {RangeError} Invalid span (start after end)
+ */
+export function renderCaretUnderline(span, lineContent) {
+    // EC-8: Invalid span throws RangeError
+    if (span.start.line > span.end.line ||
+        (span.start.line === span.end.line && span.start.column > span.end.column)) {
+        throw new RangeError('Span start must precede end');
+    }
+    // Calculate the width of the underline
+    const startColumn = span.start.column;
+    let endColumn;
+    if (span.start.line === span.end.line) {
+        // Single-line span: underline from start to end
+        endColumn = span.end.column;
+    }
+    else {
+        // Multi-line span: underline to end of first line
+        endColumn = lineContent.length;
+    }
+    // Build underline: spaces before, carets for the span
+    const padding = ' '.repeat(startColumn);
+    const caretCount = Math.max(1, endColumn - startColumn);
+    const carets = '^'.repeat(caretCount);
+    return padding + carets;
+}
+//# sourceMappingURL=cli-error-formatter.js.map

package/dist/cli-error-formatter.js.map

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

package/dist/cli-eval.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Rill CLI - Evaluate rill expressions
+ *
+ * Usage:
+ *   rill-eval '"hello".len'
+ *   rill-eval --help
+ *   rill-eval --version
+ */
+import { type ExecutionResult } from '@rcrsr/rill';
+/**
+ * Evaluate a Rill expression without file context
+ */
+export declare function evaluateExpression(expression: string): Promise<ExecutionResult>;
+//# sourceMappingURL=cli-eval.d.ts.map

package/dist/cli-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-eval.d.ts","sourceRoot":"","sources":["../src/cli-eval.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAuCrB;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAY1B"}

package/dist/cli-eval.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * Rill CLI - Evaluate rill expressions
+ *
+ * Usage:
+ *   rill-eval '"hello".len'
+ *   rill-eval --help
+ *   rill-eval --version
+ */
+import { createRuntimeContext, execute, parse, } from '@rcrsr/rill';
+import { formatOutput, determineExitCode, VERSION } from './cli-shared.js';
+/**
+ * Parse command-line arguments into structured command
+ */
+function parseArgs(argv) {
+    // Check for --help and --version in any position
+    if (argv.includes('--help')) {
+        return { mode: 'help' };
+    }
+    if (argv.includes('--version')) {
+        return { mode: 'version' };
+    }
+    // Check for unknown flags (anything starting with -)
+    for (const arg of argv) {
+        if (arg.startsWith('-') && arg !== '-') {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+    }
+    // If no arguments, default to help
+    if (argv.length === 0) {
+        return { mode: 'help' };
+    }
+    // First positional arg determines mode
+    const firstArg = argv[0];
+    // Eval mode: direct expression
+    return { mode: 'eval', expression: firstArg };
+}
+/**
+ * Evaluate a Rill expression without file context
+ */
+export async function evaluateExpression(expression) {
+    const ctx = createRuntimeContext({
+        callbacks: {
+            onLog: (value) => console.log(formatOutput(value)),
+        },
+    });
+    // Set pipeValue to empty list (Rill has no null concept per language spec)
+    ctx.pipeValue = [];
+    const ast = parse(expression);
+    return execute(ast, ctx);
+}
+/**
+ * Display help information
+ */
+function showHelp() {
+    console.log(`Rill Expression Evaluator
+
+Usage:
+  rill-eval <expression>      Evaluate a Rill expression
+  rill-eval --help            Show this help message
+  rill-eval --version         Show version information
+
+Examples:
+  rill-eval '"hello".len'
+  rill-eval '5 + 3'
+  rill-eval '[1, 2, 3] -> map |x|($x * 2)'`);
+}
+/**
+ * Display version information
+ */
+function showVersion() {
+    console.log(`rill-eval ${VERSION}`);
+}
+/**
+ * Entry point for rill-eval binary
+ */
+async function main() {
+    try {
+        const args = process.argv.slice(2);
+        const command = parseArgs(args);
+        if (command.mode === 'help') {
+            showHelp();
+            return;
+        }
+        if (command.mode === 'version') {
+            showVersion();
+            return;
+        }
+        if (command.mode === 'eval') {
+            const result = await evaluateExpression(command.expression);
+            const { code, message } = determineExitCode(result.value);
+            if (message !== undefined) {
+                console.log(message);
+            }
+            else {
+                console.log(formatOutput(result.value));
+            }
+            process.exit(code);
+        }
+        // Unreachable - exec mode not supported in rill-eval
+        console.error('Unexpected command mode');
+        process.exit(1);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+// Only run main if this is the entry point (not imported)
+const shouldRunMain = process.env['NODE_ENV'] !== 'test' &&
+    !process.env['VITEST'] &&
+    !process.env['VITEST_WORKER_ID'];
+if (shouldRunMain) {
+    main();
+}
+//# sourceMappingURL=cli-eval.js.map

package/dist/cli-eval.js.map

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

package/dist/cli-exec.d.ts

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * CLI Execution Entry Point
+ *
+ * Implements main(), parseArgs(), and executeScript() for rill-exec and rill-eval binaries.
+ * Handles file execution, stdin input, and module loading.
+ */
+import type { ExecutionResult } from '@rcrsr/rill';
+/**
+ * Parsed command-line arguments
+ */
+export type ParsedArgs = {
+    mode: 'exec';
+    file: string;
+    args: string[];
+    format: 'human' | 'json' | 'compact';
+    verbose: boolean;
+    maxStackDepth: number;
+} | {
+    mode: 'eval';
+    expression: string;
+} | {
+    mode: 'help' | 'version';
+} | {
+    mode: 'explain';
+    errorId: string;
+};
+/**
+ * Parse command-line arguments into structured command
+ *
+ * @param argv - Raw command-line arguments (typically process.argv.slice(2))
+ * @returns Parsed command object
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/**
+ * Execute a Rill script file with arguments and module support
+ *
+ * @param file - File path or '-' for stdin
+ * @param args - Command-line arguments to pass as $ pipe value
+ * @param options - Execution options
+ * @returns Execution result with value, variables, and source text
+ * @throws Error if file not found or execution fails
+ */
+export declare function executeScript(file: string, args: string[], options?: {
+    stdin?: boolean;
+    source?: string;
+}): Promise<ExecutionResult & {
+    source: string;
+}>;
+/**
+ * Entry point for rill-exec and rill-eval binaries
+ *
+ * Parses command-line arguments, executes scripts, and handles errors.
+ * Writes results to stdout and errors to stderr.
+ * Sets process.exit(1) on any error.
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli-exec.d.ts.map

package/dist/cli-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exec.d.ts","sourceRoot":"","sources":["../src/cli-exec.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAOH,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AAW9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsIpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiE/C;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgI1C"}