@rcrsr/rill 0.1.0 → 0.2.0

package/dist/cli-check.js

@@ -0,0 +1,356 @@
+#!/usr/bin/env node
+/**
+ * CLI Check Entry Point
+ *
+ * Implements argument parsing for rill-check.
+ * Validates Rill source files against linting rules.
+ */
+import { VALIDATION_RULES, loadConfig, createDefaultConfig, validateScript, applyFixes, } from './check/index.js';
+import { parse } from './parser/index.js';
+import { ParseError } from './types.js';
+/**
+ * Parse command-line arguments for rill-check
+ *
+ * @param argv - Raw command-line arguments (typically process.argv.slice(2))
+ * @returns Parsed command object
+ */
+export function parseCheckArgs(argv) {
+    // Check for --help or --version flags in any position
+    if (argv.includes('--help') || argv.includes('-h')) {
+        return { mode: 'help' };
+    }
+    if (argv.includes('--version') || argv.includes('-v')) {
+        return { mode: 'version' };
+    }
+    // Extract flags
+    const fix = argv.includes('--fix');
+    const verbose = argv.includes('--verbose');
+    // Extract format flag
+    let format = 'text';
+    const formatIndex = argv.indexOf('--format');
+    if (formatIndex !== -1) {
+        const formatValue = argv[formatIndex + 1];
+        if (formatValue === 'text' || formatValue === 'json') {
+            format = formatValue;
+        }
+        else if (!formatValue || formatValue.startsWith('-')) {
+            throw new Error('--format requires argument: text or json');
+        }
+        else {
+            throw new Error(`Invalid format: ${formatValue}. Expected text or json`);
+        }
+    }
+    // Check for unknown flags
+    const knownFlags = new Set([
+        '--help',
+        '-h',
+        '--version',
+        '-v',
+        '--fix',
+        '--verbose',
+        '--format',
+    ]);
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg)
+            continue;
+        // Skip non-flag arguments
+        if (!arg.startsWith('-')) {
+            continue;
+        }
+        // Skip format value argument
+        if (i > 0 && argv[i - 1] === '--format') {
+            continue;
+        }
+        // Check if unknown flag
+        if (!knownFlags.has(arg)) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+    }
+    // Extract file path (first non-flag argument)
+    let file;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg)
+            continue;
+        // Skip flags
+        if (arg.startsWith('-')) {
+            // Skip --format and its value
+            if (arg === '--format') {
+                i++; // Skip next argument (the format value)
+            }
+            continue;
+        }
+        // First non-flag argument is the file
+        file = arg;
+        break;
+    }
+    if (!file) {
+        throw new Error('Missing file argument');
+    }
+    return { mode: 'check', file, fix, verbose, format };
+}
+// ============================================================
+// DIAGNOSTIC FORMATTING
+// ============================================================
+/**
+ * Format diagnostics for output
+ *
+ * Adapts pattern from cli-shared.ts formatError function.
+ * Text format: file:line:col: severity: message (code)
+ * JSON format: complete schema with errors array and summary
+ * Verbose mode: adds category field to diagnostics
+ *
+ * @param file - File path being checked
+ * @param diagnostics - Array of diagnostics to format
+ * @param format - Output format ('text' or 'json')
+ * @param verbose - Whether to include category and doc references
+ * @returns Formatted output string
+ */
+export function formatDiagnostics(file, diagnostics, format, verbose) {
+    if (format === 'json') {
+        return formatDiagnosticsJSON(file, diagnostics, verbose);
+    }
+    return formatDiagnosticsText(file, diagnostics);
+}
+/**
+ * Format diagnostics as text
+ * Pattern: file:line:col: severity: message (code)
+ */
+function formatDiagnosticsText(file, diagnostics) {
+    return diagnostics
+        .map((d) => {
+        const { line, column } = d.location;
+        return `${file}:${line}:${column}: ${d.severity}: ${d.message} (${d.code})`;
+    })
+        .join('\n');
+}
+/**
+ * Format diagnostics as JSON
+ * Includes file, errors array, and summary
+ */
+function formatDiagnosticsJSON(file, diagnostics, verbose) {
+    // Build category lookup map from validation rules
+    const categoryMap = new Map();
+    for (const rule of VALIDATION_RULES) {
+        categoryMap.set(rule.code, rule.category);
+    }
+    // Format each diagnostic
+    const errors = diagnostics.map((d) => {
+        const error = {
+            location: {
+                line: d.location.line,
+                column: d.location.column,
+                offset: d.location.offset,
+            },
+            severity: d.severity,
+            code: d.code,
+            message: d.message,
+            context: d.context,
+        };
+        // Add category if verbose mode
+        if (verbose) {
+            const category = categoryMap.get(d.code);
+            if (category) {
+                error['category'] = category;
+            }
+        }
+        // Add fix if present
+        if (d.fix) {
+            error['fix'] = {
+                description: d.fix.description,
+                applicable: d.fix.applicable,
+                range: {
+                    start: {
+                        line: d.fix.range.start.line,
+                        column: d.fix.range.start.column,
+                        offset: d.fix.range.start.offset,
+                    },
+                    end: {
+                        line: d.fix.range.end.line,
+                        column: d.fix.range.end.column,
+                        offset: d.fix.range.end.offset,
+                    },
+                },
+                replacement: d.fix.replacement,
+            };
+        }
+        return error;
+    });
+    // Count diagnostics by severity
+    const summary = {
+        total: diagnostics.length,
+        errors: diagnostics.filter((d) => d.severity === 'error').length,
+        warnings: diagnostics.filter((d) => d.severity === 'warning').length,
+        info: diagnostics.filter((d) => d.severity === 'info').length,
+    };
+    const output = {
+        file,
+        errors,
+        summary,
+    };
+    return JSON.stringify(output, null, 2);
+}
+// ============================================================
+// MAIN ENTRY POINT
+// ============================================================
+/**
+ * Main entry point for rill-check CLI.
+ * Orchestrates argument parsing, file reading, validation, fixing, and output.
+ */
+async function main() {
+    try {
+        // Parse command-line arguments
+        const args = parseCheckArgs(process.argv.slice(2));
+        // Handle help mode
+        if (args.mode === 'help') {
+            console.log(`rill-check - Validate Rill scripts
+
+Usage: rill-check [options] <file>
+
+Options:
+  --fix           Apply automatic fixes
+  --format <fmt>  Output format: text (default) or json
+  --verbose       Include category and documentation references
+  -h, --help      Show this help message
+  -v, --version   Show version number`);
+            process.exit(0);
+        }
+        // Handle version mode
+        if (args.mode === 'version') {
+            console.log('0.1.0');
+            process.exit(0);
+        }
+        // At this point, args.mode must be 'check'
+        // TypeScript needs explicit assertion after early returns
+        if (args.mode !== 'check') {
+            throw new Error('Unexpected mode');
+        }
+        // Load configuration from cwd (null if not present)
+        const config = loadConfig(process.cwd()) ?? createDefaultConfig();
+        // Read source file
+        let source;
+        try {
+            const fs = await import('node:fs');
+            // Check if file exists
+            if (!fs.existsSync(args.file)) {
+                console.error(`Error: File not found: ${args.file}`);
+                process.exit(2);
+            }
+            // Check if path is a directory
+            const stats = fs.statSync(args.file);
+            if (stats.isDirectory()) {
+                console.error(`Error: Path is a directory: ${args.file}`);
+                process.exit(2);
+            }
+            // Read file contents
+            source = fs.readFileSync(args.file, 'utf-8');
+        }
+        catch (err) {
+            // Handle read errors (permissions, etc.)
+            if (err instanceof Error &&
+                'code' in err &&
+                typeof err.code === 'string') {
+                const code = err.code;
+                if (code === 'ENOENT') {
+                    console.error(`Error: File not found: ${args.file}`);
+                }
+                else if (code === 'EISDIR') {
+                    console.error(`Error: Path is a directory: ${args.file}`);
+                }
+                else {
+                    console.error(`Error: Cannot read file: ${args.file}`);
+                }
+            }
+            else {
+                console.error(`Error: Cannot read file: ${args.file}`);
+            }
+            process.exit(2);
+        }
+        // Parse AST
+        let ast;
+        try {
+            ast = parse(source);
+        }
+        catch (err) {
+            // Handle parse errors
+            if (err instanceof ParseError) {
+                const location = err.location;
+                if (location) {
+                    console.error(`${args.file}:${location.line}:${location.column}: parse error: ${err.message}`);
+                }
+                else {
+                    console.error(`${args.file}: parse error: ${err.message}`);
+                }
+                // If --fix was requested, report that fixes cannot be applied
+                if (args.fix) {
+                    console.error('Cannot apply fixes: file has parse errors');
+                }
+                process.exit(3);
+            }
+            throw err; // Re-throw unexpected errors
+        }
+        // Run validation
+        const diagnostics = validateScript(ast, source, config);
+        // Apply fixes if requested
+        if (args.fix && diagnostics.length > 0) {
+            const result = applyFixes(source, diagnostics, {
+                source,
+                ast,
+                config,
+                diagnostics: [],
+                variables: new Map(),
+            });
+            // Write fixed source back to file
+            if (result.applied > 0) {
+                const fs = await import('node:fs');
+                fs.writeFileSync(args.file, result.modified, 'utf-8');
+            }
+            // Report fix results to stderr
+            if (result.applied > 0 || result.skipped > 0) {
+                if (result.applied > 0) {
+                    console.error(`Applied ${result.applied} fix${result.applied === 1 ? '' : 'es'}`);
+                }
+                if (result.skipped > 0) {
+                    console.error(`Skipped ${result.skipped} fix${result.skipped === 1 ? '' : 'es'}`);
+                }
+            }
+        }
+        // Format and output diagnostics
+        if (diagnostics.length === 0) {
+            // No errors - success
+            if (args.format === 'json') {
+                console.log(JSON.stringify({
+                    file: args.file,
+                    errors: [],
+                    summary: { total: 0, errors: 0, warnings: 0, info: 0 },
+                }, null, 2));
+            }
+            else {
+                console.log('No issues found');
+            }
+            process.exit(0);
+        }
+        else {
+            // Output diagnostics
+            const output = formatDiagnostics(args.file, diagnostics, args.format, args.verbose);
+            console.log(output);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        // Handle unexpected errors
+        if (err instanceof Error) {
+            console.error(`Error: ${err.message}`);
+        }
+        else {
+            console.error(`Error: ${String(err)}`);
+        }
+        process.exit(1);
+    }
+}
+// Only run main if this is the entry point (not imported)
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=cli-check.js.map

package/dist/cli-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-check.js","sourceRoot":"","sources":["../src/cli-check.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 './index.js';
+/**
+ * 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,YAAY,CAAC;AAwCpB;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAY1B"}

package/dist/cli-eval.js

@@ -0,0 +1,120 @@
+#!/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 './index.js';
+import { formatOutput, determineExitCode } from './cli-shared.js';
+import * as fs from 'fs';
+/**
+ * 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() {
+    // Read version from package.json
+    const packageJsonPath = new URL('../package.json', import.meta.url);
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    console.log(`rill-eval ${packageJson.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,49 @@
+#!/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 './index.js';
+/**
+ * Parsed command-line arguments
+ */
+export type ParsedArgs = {
+    mode: 'exec';
+    file: string;
+    args: string[];
+} | {
+    mode: 'eval';
+    expression: string;
+} | {
+    mode: 'help' | 'version';
+};
+/**
+ * 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 and variables
+ * @throws Error if file not found or execution fails
+ */
+export declare function executeScript(file: string, args: string[], options?: {
+    stdin?: boolean;
+}): Promise<ExecutionResult>;
+/**
+ * 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,YAAY,CAAC;AAI7D;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAuCpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,eAAe,CAAC,CA0D1B;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsE1C"}