@rcrsr/rill 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andre Bremer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+<p align="center">
+  <img src="docs/assets/logo.png" alt="rill logo" width="280">
+</p>
+
+*Embeddable workflow language for LLM orchestration*
+
+> [!WARNING]
+> **This language is experimental.** While usable, there may be significant bugs. Breaking changes will occur until v1.0.
+
+## Why rill?
+
+rill enables platform builders to make their apps scriptable without exposing arbitrary code execution.
+
+rill solves for AI platforms what Lua solves for game engines and Liquid solves for e-commerce: safe, user-authored logic.
+
+- **Embeddable.** Zero dependencies. Runs in browser or backend. [Integration](docs/14_host-integration.md) only requires a few lines of code.
+- **Sandboxed.** Users can only call functions you explicitly provide. No filesystem, no network, no `eval()` disasters.
+- **Bounded execution.** Retry limits prevent exhausting LLM usage limits because of runaway loops.
+- **Consistent, clean syntax.** Ships with [EBNF grammar](docs/15_grammar.ebnf). LLMs can write rill scripts for your users.
+- **Built-in LLM output parsing.** [Auto-detect](docs/10_parsing.md) JSON, XML, YAML, checklists.
+
+## Who is this for?
+
+**Platform builders** who want power users to define custom LLM workflows without hand-coding each one.
+
+rill is not a general-purpose language and it's intentionally constrained. For general application development, you'll want TypeScript, Python, or Go.
+
+## Quick Start
+
+```typescript
+import { parse, execute, createRuntimeContext } from '@rcrsr/rill';
+
+const script = `
+  prompt("Analyze this code for issues")
+    -> .contains("ERROR") ? error($) ! "Analysis complete"
+`;
+
+const ctx = createRuntimeContext({
+  functions: {
+    prompt: async (args) => await callYourLLM(args[0]),
+    error: (args) => { throw new Error(String(args[0])); },
+  },
+});
+
+const result = await execute(parse(script), ctx);
+```
+
+## Language Overview
+
+### Pipes
+
+Data flows forward through pipes (`app::*` denotes an application-specific host function call).
+
+```rill
+app::prompt("analyze this code") -> .trim -> log
+```
+
+### Pattern-Driven Conditionals
+
+Branch based on content patterns. Ideal for parsing LLM output.
+
+```rill
+app::prompt("analyze code")
+  -> .contains("ERROR") ? app::error() ! app::process()
+```
+
+### Bounded Loops
+
+Retry with limits. Prevents runaway execution.
+
+```rill
+# While loop: condition @ body
+0 -> ($ < 3) @ { $ + 1 }  # Result: 3
+```
+
+```rill
+# Iteration with each
+["a.txt", "b.txt"] -> each { "Processing: {$}" -> log }
+```
+
+### Closures
+
+First-class functions with captured environment.
+
+```rill
+|x| ($x * 2) :> $double
+[1, 2, 3] -> map $double  # [2, 4, 6]
+5 -> $double              # 10
+```
+
+### Parallel Execution
+
+Fan out work concurrently. Results preserve order.
+
+```rill
+# Parallel map with closure
+["security", "performance", "style"] -> map |aspect| {
+  app::prompt("Review for {$aspect} issues")
+}
+```
+
+```rill
+# Parallel filter with method
+["critical bug", "minor note", "critical fix"] -> filter .contains("critical")
+```
+
+### LLM Output Parsing
+
+Built-in functions for extracting structured data from LLM responses.
+
+```rill
+# Auto-detect format (JSON, XML, YAML, checklist)
+"[1, 2, 3]" -> parse_auto -> .data  # [1, 2, 3]
+```
+
+```rill
+# Extract fenced code blocks
+"```json\n[1,2]\n```" -> parse_fence("json") -> parse_json
+```
+
+```rill
+# Extract XML tags
+"<answer>42</answer>" -> parse_xml("answer")  # "42"
+```
+
+### String Interpolation
+
+Embed expressions in strings. Heredoc for multi-line.
+
+```rill
+"world" -> "Hello, {$}!" -> log  # Hello, world!
+```
+
+```rill
+"x + 1" :> $code
+<<EOF
+Analyze: {$code}
+Return: PASS or FAIL
+EOF
+```
+
+## Core Syntax
+
+| Syntax | Description |
+|--------|-------------|
+| `->` | Pipe data forward |
+| `:>` | Capture and continue |
+| `$` | Current pipe value |
+| `.field` | Property access on `$` |
+| `cond ? a ! b` | Conditional |
+| `cond @ { }` | While loop |
+| `@ { } ? cond` | Do-while loop |
+| `each`, `map`, `filter` | Collection operators |
+| `fold(init)` | Reduction |
+| `\|args\| { }` | Closure |
+
+## Language Characteristics
+
+- **Value-based.** No references. Deep copy, value comparison.
+- **No null/undefined.** Empty values valid, "no value" doesn't exist.
+- **No exceptions.** Singular control flow. Explicit error handling.
+- **Immutable types.** Variables lock type on first assignment.
+- **Transparently async.** No async/await. Parallel execution automatic.
+
+## Use Cases
+
+- **User-defined workflows.** Let power users script automation in your app.
+- **Multi-phase pipelines.** Chain steps with review gates.
+- **Parallel agent fan-out.** Launch specialists concurrently.
+- **Edit-Review loops.** Iterate until approval or max attempts.
+
+See [Examples](docs/12_examples.md) for complete workflow patterns.
+
+## Documentation
+
+See [docs/00_INDEX.md](docs/00_INDEX.md) for full navigation.
+
+| Document | Description |
+|----------|-------------|
+| [Guide](docs/01_guide.md) | Beginner introduction |
+| [Reference](docs/11_reference.md) | Language specification |
+| [Examples](docs/12_examples.md) | Workflow patterns |
+| [Host Integration](docs/14_host-integration.md) | Embedding API |
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Rill CLI - Run rill scripts from the command line
+ *
+ * Usage:
+ *   npx tsx src/cli.ts <script.rill>
+ *   npx tsx src/cli.ts -e "code"
+ *   echo "code" | npx tsx src/cli.ts -
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/cli.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Rill CLI - Run rill scripts from the command line
+ *
+ * Usage:
+ *   npx tsx src/cli.ts <script.rill>
+ *   npx tsx src/cli.ts -e "code"
+ *   echo "code" | npx tsx src/cli.ts -
+ */
+import * as fs from 'fs';
+import { createRuntimeContext, execute, parse, } from './index.js';
+function formatOutput(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return JSON.stringify(value, null, 2);
+}
+async function run(source) {
+    const ctx = createRuntimeContext({
+        callbacks: {
+            onLog: (value) => console.log(formatOutput(value)),
+        },
+    });
+    try {
+        const ast = parse(source);
+        const result = await execute(ast, ctx);
+        console.log(formatOutput(result.value));
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.error('Usage: rill <script.rill> | rill -e "code" | rill -');
+        process.exit(1);
+    }
+    let source;
+    const arg0 = args[0];
+    if (arg0 === '-e') {
+        // Inline code: rill -e "code"
+        if (!args[1]) {
+            console.error('Missing code after -e');
+            process.exit(1);
+        }
+        source = args[1];
+    }
+    else if (arg0 === '-') {
+        // Stdin: echo "code" | rill -
+        source = fs.readFileSync(0, 'utf-8');
+    }
+    else {
+        // File: rill script.rill
+        if (!fs.existsSync(arg0)) {
+            console.error(`File not found: ${arg0}`);
+            process.exit(1);
+        }
+        source = fs.readFileSync(arg0, 'utf-8');
+    }
+    await run(source);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,OAAO,EACP,KAAK,GAEN,MAAM,YAAY,CAAC;AAEpB,SAAS,YAAY,CAAC,KAAgB;IACpC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,MAAc;IAC/B,MAAM,GAAG,GAAG,oBAAoB,CAAC;QAC/B,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;SACnD;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IAEtB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,8BAA8B;QAC9B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;SAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACxB,8BAA8B;QAC9B,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/demo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Rill Runtime Demo
+ * Simple test to verify parser + runtime integration
+ */
+export {};
+//# sourceMappingURL=demo.d.ts.map

package/dist/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../src/demo.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/demo.js

@@ -0,0 +1,121 @@
+/**
+ * Rill Runtime Demo
+ * Simple test to verify parser + runtime integration
+ */
+import { createRuntimeContext, execute, parse, } from './index.js';
+/** Safely stringify a RillValue */
+function fmt(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+const logs = [];
+const ctx = createRuntimeContext({
+    variables: {
+        name: 'World',
+        items: ['apple', 'banana', 'cherry'],
+        count: 3,
+    },
+    functions: {
+        greet: (args) => {
+            const name = args[0];
+            const str = typeof name === 'string' ? name : JSON.stringify(name);
+            return `Hello, ${str}!`;
+        },
+        double: (args) => (typeof args[0] === 'number' ? args[0] * 2 : 0),
+    },
+    callbacks: {
+        onLog: (value) => {
+            logs.push(fmt(value));
+        },
+    },
+});
+async function runDemo() {
+    console.log('=== Rill Runtime Demo ===\n');
+    // Test 1: Simple pipe chain with function (bare name, no parens)
+    console.log('Test 1: Pipe chain with bare function name');
+    const script1 = parse('"World" -> greet');
+    const result1 = await execute(script1, ctx);
+    console.log(`  Result: ${fmt(result1.value)}\n`);
+    // Test 2: Variable access (bare function name)
+    console.log('Test 2: Variable access with bare function');
+    const script2 = parse('$name -> greet');
+    const result2 = await execute(script2, ctx);
+    console.log(`  Result: ${fmt(result2.value)}\n`);
+    // Test 3: Function calls (log)
+    console.log('Test 3: Function calls');
+    logs.length = 0;
+    const script3 = parse('"Hello" -> log');
+    await execute(script3, ctx);
+    console.log(`  Logged: ${logs.join(', ')}\n`);
+    // Test 4: Conditional with .empty
+    console.log('Test 4: Conditional with .empty check');
+    const script4 = parse(`
+    "" -> .empty ? "was empty" ! "was not empty"
+  `);
+    const result4 = await execute(script4, ctx);
+    console.log(`  Result: ${fmt(result4.value)}\n`);
+    // Test 5: Conditional - non-empty case
+    console.log('Test 5: Conditional - non-empty case');
+    const script5 = parse(`
+    "hello" -> .empty ? "was empty" ! "was not empty"
+  `);
+    const result5 = await execute(script5, ctx);
+    console.log(`  Result: ${fmt(result5.value)}\n`);
+    // Test 6: For loop
+    console.log('Test 6: For loop over array');
+    const script6 = parse(`
+    $items -> @{
+      $ -> log
+    }
+  `);
+    logs.length = 0;
+    await execute(script6, ctx);
+    console.log(`  Logged: ${logs.join(', ')}\n`);
+    // Test 7: While loop (new syntax: cond @ body)
+    console.log('Test 7: While loop');
+    const script7 = parse(`
+    1 -> $x
+    ($x < 100) @ {
+      $x -> log
+      $x -> double -> $x
+    }
+    $x
+  `);
+    logs.length = 0;
+    const result7 = await execute(script7, ctx);
+    console.log(`  Logged: ${logs.join(', ')}`);
+    console.log(`  Final: ${fmt(result7.value)}\n`);
+    // Test 8: Variable capture (bare function name)
+    console.log('Test 8: Variable capture with bare function');
+    const script8 = parse(`
+    "captured value" -> $myVar
+    $myVar -> greet
+  `);
+    const result8 = await execute(script8, ctx);
+    console.log(`  Result: ${fmt(result8.value)}`);
+    console.log(`  Captured vars: ${JSON.stringify(result8.variables)}\n`);
+    // Test 9: Tuple and dict literals
+    console.log('Test 9: Tuple and dict literals');
+    const script9 = parse('[1, 2, 3]');
+    const result9 = await execute(script9, ctx);
+    console.log(`  Tuple: ${fmt(result9.value)}\n`);
+    // Test 10: String interpolation
+    console.log('Test 10: String interpolation');
+    const script10 = parse('"Hello, {$name}!"');
+    const result10 = await execute(script10, ctx);
+    console.log(`  Result: ${fmt(result10.value)}\n`);
+    // Test 11: Pipe var interpolation
+    console.log('Test 11: Pipe var interpolation');
+    const script11 = parse('"Hello" -> { "Greeting: {$}" }');
+    const result11 = await execute(script11, ctx);
+    console.log(`  Result: ${fmt(result11.value)}\n`);
+    console.log('=== All tests complete ===');
+}
+runDemo().catch(console.error);
+//# sourceMappingURL=demo.js.map

package/dist/demo.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Rill Module
+ * Exports lexer, parser, runtime, and AST types
+ */
+export { LexerError, tokenize } from './lexer/index.js';
+export { parse, parseWithRecovery } from './parser/index.js';
+export type { ParseResult, ErrorNode } from './types.js';
+export { type ApplicationCallable, BreakSignal, callable, type CallableFn, type CaptureEvent, createRuntimeContext, createStepper, type ErrorEvent, execute, type ExecutionResult, type ExecutionStepper, type HostCallEvent, type HostFunctionDefinition, type HostFunctionParam, type FunctionReturnEvent, isApplicationCallable, isTuple, isCallable, isDict, isReservedMethod, isRuntimeCallable, isScriptCallable, type ObservabilityCallbacks, RESERVED_DICT_METHODS, ReturnSignal, type RillTuple, type RillCallable, type RillValue, type RuntimeCallable, type RuntimeCallbacks, type RuntimeContext, type RuntimeOptions, type ScriptCallable, type StepEndEvent, type StepResult, type StepStartEvent, validateHostFunctionArgs, } from './runtime/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,KAAK,mBAAmB,EACxB,WAAW,EACX,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,oBAAoB,EACpB,aAAa,EACb,KAAK,UAAU,EACf,OAAO,EACP,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,qBAAqB,EACrB,OAAO,EACP,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Rill Module
+ * Exports lexer, parser, runtime, and AST types
+ */
+export { LexerError, tokenize } from './lexer/index.js';
+export { parse, parseWithRecovery } from './parser/index.js';
+export { BreakSignal, callable, createRuntimeContext, createStepper, execute, isApplicationCallable, isTuple, isCallable, isDict, isReservedMethod, isRuntimeCallable, isScriptCallable, RESERVED_DICT_METHODS, ReturnSignal, validateHostFunctionArgs, } from './runtime/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAEL,WAAW,EACX,QAAQ,EAGR,oBAAoB,EACpB,aAAa,EAEb,OAAO,EAOP,qBAAqB,EACrB,OAAO,EACP,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAEhB,qBAAqB,EACrB,YAAY,EAYZ,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/lexer/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lexer Errors
+ */
+import type { SourceLocation } from '../types.js';
+export declare class LexerError extends Error {
+    readonly location: SourceLocation;
+    constructor(message: string, location: SourceLocation);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lexer/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lexer/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,qBAAa,UAAW,SAAQ,KAAK;aAGjB,QAAQ,EAAE,cAAc;gBADxC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,cAAc;CAK3C"}

package/dist/lexer/errors.js

@@ -0,0 +1,12 @@
+/**
+ * Lexer Errors
+ */
+export class LexerError extends Error {
+    location;
+    constructor(message, location) {
+        super(`${message} at line ${location.line}, column ${location.column}`);
+        this.location = location;
+        this.name = 'LexerError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lexer/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lexer/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IAFlB,YACE,OAAe,EACC,QAAwB;QAExC,KAAK,CAAC,GAAG,OAAO,YAAY,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAFxD,aAAQ,GAAR,QAAQ,CAAgB;QAGxC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/lexer/helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Lexer Helper Functions
+ * Character classification and token construction
+ */
+import type { SourceLocation, Token, TokenType } from '../types.js';
+import { type LexerState } from './state.js';
+export declare function isDigit(ch: string): boolean;
+export declare function isIdentifierStart(ch: string): boolean;
+export declare function isIdentifierChar(ch: string): boolean;
+export declare function isWhitespace(ch: string): boolean;
+export declare function makeToken(type: TokenType, value: string, start: SourceLocation, end: SourceLocation): Token;
+/** Advance n times and return a token */
+export declare function advanceAndMakeToken(state: LexerState, n: number, type: TokenType, value: string, start: SourceLocation): Token;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/lexer/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/lexer/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3C;AAMD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,cAAc,GAClB,KAAK,CAEP;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GACpB,KAAK,CAGP"}

package/dist/lexer/helpers.js

@@ -0,0 +1,30 @@
+/**
+ * Lexer Helper Functions
+ * Character classification and token construction
+ */
+import { advance, currentLocation } from './state.js';
+export function isDigit(ch) {
+    return ch >= '0' && ch <= '9';
+}
+function isLetter(ch) {
+    return (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z');
+}
+export function isIdentifierStart(ch) {
+    return isLetter(ch) || ch === '_';
+}
+export function isIdentifierChar(ch) {
+    return isIdentifierStart(ch) || isDigit(ch);
+}
+export function isWhitespace(ch) {
+    return ch === ' ' || ch === '\t' || ch === '\r';
+}
+export function makeToken(type, value, start, end) {
+    return { type, value, span: { start, end } };
+}
+/** Advance n times and return a token */
+export function advanceAndMakeToken(state, n, type, value, start) {
+    for (let i = 0; i < n; i++)
+        advance(state);
+    return makeToken(type, value, start, currentLocation(state));
+}
+//# sourceMappingURL=helpers.js.map

package/dist/lexer/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/lexer/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAEvE,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC;AAChC,CAAC;AAED,SAAS,QAAQ,CAAC,EAAU;IAC1B,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,iBAAiB,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAe,EACf,KAAa,EACb,KAAqB,EACrB,GAAmB;IAEnB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,CAAS,EACT,IAAe,EACf,KAAa,EACb,KAAqB;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/lexer/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Lexer Module
+ * Converts source text into tokens
+ */
+export { LexerError } from './errors.js';
+export { createLexerState, type LexerState } from './state.js';
+export { nextToken, tokenize } from './tokenizer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lexer/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lexer/index.js

@@ -0,0 +1,8 @@
+/**
+ * Lexer Module
+ * Converts source text into tokens
+ */
+export { LexerError } from './errors.js';
+export { createLexerState } from './state.js';
+export { nextToken, tokenize } from './tokenizer.js';
+//# sourceMappingURL=index.js.map

package/dist/lexer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lexer/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lexer/operators.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Operator Lookup Tables
+ */
+import type { TokenType } from '../types.js';
+/** Two-character operator lookup table */
+export declare const TWO_CHAR_OPERATORS: Record<string, TokenType>;
+/** Single-character operator lookup table */
+export declare const SINGLE_CHAR_OPERATORS: Record<string, TokenType>;
+/** Keyword lookup table */
+export declare const KEYWORDS: Record<string, TokenType>;
+//# sourceMappingURL=operators.d.ts.map

package/dist/lexer/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/lexer/operators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAcxD,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAwB3D,CAAC;AAEF,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAS9C,CAAC"}