littlewing 0.3.0 → 0.3.1

package/README.md

@@ -8,7 +8,7 @@ A minimal, high-performance arithmetic expression language with a complete lexer
 - 📦 **Tiny Bundle** - 3.61 KB gzipped, zero dependencies
 - 🌐 **Browser Ready** - 100% ESM, no Node.js APIs
 - 🔒 **Type-Safe** - Strict TypeScript with full type coverage
-- ✅ **Thoroughly Tested** - 71 tests, 97.66% coverage
+- ✅ **Thoroughly Tested** - 106 tests, 97.66% coverage
 - 📐 **Math Expressions** - Numbers, dates, operators, functions, variables
 - 🎯 **Clean API** - Intuitive dual API (class-based + functional)
 - 📝 **Well Documented** - Complete JSDoc and examples
@@ -183,6 +183,24 @@ const ast = parseSource("2 + 3 * 4");
 // Returns: BinaryOp(+, NumberLiteral(2), BinaryOp(*, ...))
 ```
 
+#### `generate(node: ASTNode): string`
+
+Convert an AST node back to source code. Intelligently adds parentheses only when necessary to preserve semantics.
+
+```typescript
+import { generate, ast } from "littlewing";
+
+// From AST builders
+const expr = ast.multiply(ast.add(ast.number(2), ast.number(3)), ast.number(4));
+generate(expr); // → "(2 + 3) * 4"
+
+// Round-trip: parse → generate → parse
+const code = "2 + 3 * 4";
+const tree = parseSource(code);
+const regenerated = generate(tree); // → "2 + 3 * 4"
+parseSource(regenerated); // Same AST structure
+```
+
 ### Classes
 
 #### `Lexer`
@@ -219,6 +237,17 @@ const executor = new Executor(context);
 const result = executor.execute(ast);
 ```
 
+#### `CodeGenerator`
+
+Convert AST nodes back to source code. Handles operator precedence and associativity automatically.
+
+```typescript
+import { CodeGenerator } from "littlewing";
+
+const generator = new CodeGenerator();
+const code = generator.generate(ast);
+```
+
 ### AST Builders
 
 The `ast` namespace provides convenient functions for building AST nodes:
@@ -256,37 +285,6 @@ import { defaultContext } from "littlewing";
 (milliseconds, seconds, minutes, hours, days);
 ```
 
-## Type Definitions
-
-### ExecutionContext
-
-```typescript
-interface ExecutionContext {
-	functions?: Record<string, (...args: any[]) => number | Date>;
-	variables?: Record<string, number | Date>;
-}
-```
-
-### RuntimeValue
-
-```typescript
-type RuntimeValue = number | Date | unknown;
-```
-
-### ASTNode
-
-```typescript
-type ASTNode =
-	| Program
-	| NumberLiteral
-	| StringLiteral
-	| Identifier
-	| BinaryOp
-	| UnaryOp
-	| FunctionCall
-	| Assignment;
-```
-
 ## Examples
 
 ### Calculator
@@ -362,14 +360,14 @@ execute("kilometers(5)", context); // → 8.0467
 
 ### Bundle Size
 
-- Raw: 16.70 KB
-- Gzipped: **3.61 KB**
+- Raw: 21.06 KB
+- Gzipped: **4.26 KB**
 - Zero dependencies
 
 ### Test Coverage
 
-- 71 comprehensive tests
-- 97.66% code coverage
+- 106 comprehensive tests
+- 95.99% code coverage
 - All edge cases handled
 
 ## Type Safety
@@ -408,7 +406,3 @@ MIT
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
-
----
-
-Made with ❤️ by the littlewing team

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "littlewing",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "A minimal, high-performance arithmetic expression language with lexer, parser, and executor. Optimized for browsers with zero dependencies and type-safe execution.",
 	"keywords": [
 		"arithmetic",