@mojir/lits 2.4.0 → 2.4.1

package/README.md

@@ -41,17 +41,47 @@ npm install --global @mojir/lits
 $ lits
 
 # Evaluate Lits code directly
-$ lits -e "5 + 3"
-$ lits -e "[1, 2, 3, 4] filter odd? map inc"
+$ lits eval "5 + 3"
+$ lits eval "[1, 2, 3, 4] filter odd? map inc"
 
 # Run a Lits file
-$ lits -f script.lits
-$ lits -f examples/factorial.lits
+$ lits run script.lits
+
+# Bundle a multi-file project into a single .json file
+$ lits bundle main.lits -o bundle.json
+
+# Run a bundle
+$ lits run-bundle bundle.json
+
+# Run tests
+$ lits test tests.test.lits
 
 # Get help
 $ lits --help
 ```
 
+**Subcommands:**
+
+| Subcommand | Description |
+|---|---|
+| `run <file>` | Run a `.lits` source file |
+| `run-bundle <file>` | Run a `.json` bundle (with validation) |
+| `eval <expression>` | Evaluate a Lits expression |
+| `bundle <entry>` | Bundle a multi-file project into a single JSON file |
+| `test <file>` | Run a `.test.lits` test file |
+| `repl` | Start an interactive REPL (default when no subcommand) |
+
+**Common options:**
+
+| Option | Applies to | Description |
+|---|---|---|
+| `-c, --context=<json>` | `run`, `run-bundle`, `eval`, `repl` | Provide context as a JSON string |
+| `-C, --context-file=<file>` | `run`, `run-bundle`, `eval`, `repl` | Provide context from a `.json` file |
+| `-s, --silent` | `run`, `run-bundle`, `eval` | Suppress printing the result |
+| `-o, --output=<file>` | `bundle` | Write bundle to file (default: stdout) |
+| `--pattern=<regex>` | `test` | Only run tests matching pattern |
+| `-l, --load=<file>` | `repl` | Preload a `.lits` file into the REPL |
+
 The REPL provides an interactive environment where you can experiment with Lits code, test functions, and explore the language features in real-time.
 
 ## Quick Start

package/dist/cli/cli.js

@@ -7,7 +7,7 @@ var readline = require('node:readline');
 var os = require('node:os');
 var process$1 = require('node:process');
 
-var version = "2.4.0";
+var version = "2.4.1";
 
 function getCodeMarker(sourceCodeInfo) {
     if (!sourceCodeInfo.position || !sourceCodeInfo.code)
@@ -34647,18 +34647,35 @@ switch (config.subcommand) {
         const lits = createLits(config.context);
         try {
             const content = fs.readFileSync(config.filename, { encoding: 'utf-8' });
-            let programOrBundle = content;
-            // Try to parse as a JSON bundle
+            const result = lits.run(content);
+            if (config.printResult) {
+                console.log(result);
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            printErrorMessage(`${error}`);
+            process.exit(1);
+        }
+        break;
+    }
+    case 'run-bundle': {
+        const lits = createLits(config.context);
+        try {
+            const content = fs.readFileSync(config.filename, { encoding: 'utf-8' });
+            let parsed;
             try {
-                const parsed = JSON.parse(content);
-                if (isLitsBundle(parsed)) {
-                    programOrBundle = parsed;
-                }
+                parsed = JSON.parse(content);
             }
             catch {
-                // Not JSON — treat as plain Lits source
+                printErrorMessage(`Invalid bundle: ${config.filename} is not valid JSON`);
+                process.exit(1);
+            }
+            if (!isLitsBundle(parsed)) {
+                printErrorMessage(`Invalid bundle: ${config.filename} is not a valid Lits bundle (expected "program" string and "fileModules" array)`);
+                process.exit(1);
             }
-            const result = lits.run(programOrBundle);
+            const result = lits.run(parsed);
             if (config.printResult) {
                 console.log(result);
             }
@@ -34786,7 +34803,7 @@ function setReplHistoryVariables(context) {
 }
 function parseOption(args, i) {
     const option = args[i];
-    if (option === '-p') {
+    if (option === '-s') {
         return { option, argument: null, count: 1 };
     }
     if (/^-[a-z]$/i.test(option))
@@ -34846,16 +34863,16 @@ function parseContextOptions(args, startIndex) {
     return { options, nextIndex: i };
 }
 function parsePrintOptions(args, startIndex) {
-    const options = { printResult: false };
+    const options = { printResult: true };
     let i = startIndex;
     while (i < args.length) {
         const parsed = parseOption(args, i);
         if (!parsed)
             break;
         switch (parsed.option) {
-            case '-p':
-            case '--print-result':
-                options.printResult = true;
+            case '-s':
+            case '--silent':
+                options.printResult = false;
                 i += parsed.count;
                 break;
             default:
@@ -34866,7 +34883,7 @@ function parsePrintOptions(args, startIndex) {
 }
 function parseRunEvalOptions(args, startIndex) {
     let context = {};
-    let printResult = false;
+    let printResult = true;
     let i = startIndex;
     while (i < args.length) {
         const parsed = parseOption(args, i);
@@ -34882,8 +34899,8 @@ function parseRunEvalOptions(args, startIndex) {
                 i = result.nextIndex;
                 break;
             }
-            case '-p':
-            case '--print-result': {
+            case '-s':
+            case '--silent': {
                 const result = parsePrintOptions(args, i);
                 printResult = result.options.printResult;
                 i = result.nextIndex;
@@ -34922,6 +34939,15 @@ function processArguments(args) {
             const { context, printResult } = parseRunEvalOptions(args, 2);
             return { subcommand: 'run', filename, context, printResult };
         }
+        case 'run-bundle': {
+            const filename = args[1];
+            if (!filename || filename.startsWith('-')) {
+                printErrorMessage('Missing filename after "run-bundle"');
+                process.exit(1);
+            }
+            const { context, printResult } = parseRunEvalOptions(args, 2);
+            return { subcommand: 'run-bundle', filename, context, printResult };
+        }
         case 'eval': {
             const expression = args[1];
             if (!expression || expression.startsWith('-')) {
@@ -35109,17 +35135,18 @@ function printUsage() {
 Usage: lits [subcommand] [options]
 
 Subcommands:
-  run <file> [options]            Run a .lits file or .json bundle
+  run <file> [options]            Run a .lits file
+  run-bundle <file> [options]     Run a .json bundle
   eval <expression> [options]     Evaluate a Lits expression
   bundle <entry> [options]        Bundle a multi-file project
   test <file> [options]           Run a .test.lits test file
   repl [options]                  Start an interactive REPL
   help                            Show this help
 
-Run/Eval options:
+Run/Run-bundle/Eval options:
   -c, --context=<json>            Context as a JSON string
   -C, --context-file=<file>       Context from a .json file
-  -p, --print-result              Print the result
+  -s, --silent                    Suppress printing the result
 
 Bundle options:
   -o, --output=<file>             Write bundle to file (default: stdout)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojir/lits",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Lits is a pure functional programming language implemented in TypeScript",
   "author": "Albert Mojir",
   "license": "MIT",