binja 0.1.0 → 0.1.1

package/README.md

@@ -25,6 +25,7 @@
 
 | Feature | binja | Other JS engines |
 |---------|-----------|------------------|
+| **AOT Compilation** | ✅ 160x faster | ❌ |
 | Django DTL Compatible | ✅ 100% | ❌ Partial |
 | Jinja2 Compatible | ✅ Full | ⚠️ Limited |
 | Template Inheritance | ✅ | ⚠️ |
@@ -37,107 +38,32 @@
 
 ## Benchmarks
 
-Tested on MacBook Pro M2, Bun 1.1.x, rendering 1000 iterations.
+Tested on Mac Studio M1 Max, Bun 1.3.5, 10,000 iterations.
 
-### Simple Template
-```
-{{ name }} - {{ title|upper }}
-```
+### Two Rendering Modes
 
-| Engine | Ops/sec | Relative |
-|--------|---------|----------|
-| **binja** | **142,857** | **1.0x** |
-| Nunjucks | 45,662 | 3.1x slower |
-| EJS | 38,461 | 3.7x slower |
-| Handlebars | 52,631 | 2.7x slower |
+| Mode | Function | Best For | vs Nunjucks |
+|------|----------|----------|-------------|
+| **Runtime** | `render()` | Development | **3.7x faster** |
+| **AOT** | `compile()` | Production | **160x faster** |
 
-### Complex Template (loops, conditions, filters)
-```django
-{% for item in items %}
-  {% if item.active %}
-    {{ item.name|title }} - ${{ item.price|floatformat:2 }}
-  {% endif %}
-{% endfor %}
-```
+### Performance Comparison
 
-| Engine | Ops/sec | Relative |
-|--------|---------|----------|
-| **binja** | **28,571** | **1.0x** |
-| Nunjucks | 8,928 | 3.2x slower |
-| EJS | 12,500 | 2.3x slower |
-| Handlebars | 15,384 | 1.9x slower |
-
-### Template Inheritance
-```django
-{% extends "base.html" %}
-{% block content %}...{% endblock %}
-```
-
-| Engine | Ops/sec | Relative |
-|--------|---------|----------|
-| **binja** | **18,518** | **1.0x** |
-| Nunjucks | 6,250 | 3.0x slower |
-| EJS | N/A | Not supported |
-| Handlebars | N/A | Not supported |
-
-### Memory Usage
-
-| Engine | Heap (MB) | RSS (MB) |
-|--------|-----------|----------|
-| **binja** | **12.4** | **45.2** |
-| Nunjucks | 28.6 | 89.4 |
-| EJS | 18.2 | 62.1 |
+| Benchmark | Nunjucks | binja Runtime | binja AOT |
+|-----------|----------|---------------|-----------|
+| Simple Template | 95K ops/s | 290K ops/s | **14.3M ops/s** |
+| Complex Template | 28K ops/s | 103K ops/s | **1.07M ops/s** |
+| Nested Loops | 27K ops/s | 130K ops/s | **1.75M ops/s** |
+| HTML Escaping | 65K ops/s | 241K ops/s | **2.23M ops/s** |
+| Conditionals | 27K ops/s | 126K ops/s | **22.8M ops/s** |
+| Large Dataset (100 items) | 21K ops/s | 36K ops/s | **202K ops/s** |
 
 ### Run Benchmarks
 
 ```bash
-bun run benchmark
+bun run full-benchmark.ts
 ```
 
-<details>
-<summary>📊 Full Benchmark Code</summary>
-
-```typescript
-import { Environment } from 'binja'
-
-const env = new Environment()
-const iterations = 1000
-
-// Simple benchmark
-const simpleTemplate = '{{ name }} - {{ title|upper }}'
-const simpleContext = { name: 'John', title: 'hello world' }
-
-console.time('Simple Template')
-for (let i = 0; i < iterations; i++) {
-  await env.renderString(simpleTemplate, simpleContext)
-}
-console.timeEnd('Simple Template')
-
-// Complex benchmark
-const complexTemplate = `
-{% for item in items %}
-  {% if item.active %}
-    {{ item.name|title }} - ${{ item.price|floatformat:2 }}
-  {% endif %}
-{% endfor %}
-`
-const complexContext = {
-  items: Array.from({ length: 50 }, (_, i) => ({
-    name: `product ${i}`,
-    price: Math.random() * 100,
-    active: Math.random() > 0.3
-  }))
-}
-
-console.time('Complex Template')
-for (let i = 0; i < iterations; i++) {
-  await env.renderString(complexTemplate, complexContext)
-}
-console.timeEnd('Complex Template')
-```
-
-</details>
-
 ---
 
 ## Installation
@@ -181,6 +107,37 @@ const html = await env.render('pages/home.html', {
 })
 ```
 
+### AOT Compilation (Maximum Performance)
+
+For production, use `compile()` for **160x faster** rendering:
+
+```typescript
+import { compile } from 'binja'
+
+// Compile once at startup
+const renderUser = compile('<h1>{{ name|upper }}</h1>')
+
+// Use many times (sync, extremely fast!)
+const html = renderUser({ name: 'john' })
+// Output: <h1>JOHN</h1>
+```
+
+Production example:
+
+```typescript
+import { compile } from 'binja'
+
+// Pre-compile all templates at server startup
+const templates = {
+  home: compile(await Bun.file('./views/home.html').text()),
+  user: compile(await Bun.file('./views/user.html').text()),
+}
+
+// Rendering is now synchronous and extremely fast
+app.get('/', () => templates.home({ title: 'Welcome' }))
+app.get('/user/:id', ({ params }) => templates.user({ id: params.id }))
+```
+
 ---
 
 ## Features
@@ -351,6 +308,43 @@ const html = await env.render('pages/home.html', {
 
 ---
 
+## Tests (is operator)
+
+Tests check values using the `is` operator (Jinja2 syntax):
+
+```django
+{% if value is defined %}...{% endif %}
+{% if num is even %}...{% endif %}
+{% if num is divisibleby(3) %}...{% endif %}
+{% if items is empty %}...{% endif %}
+```
+
+### Built-in Tests
+
+| Test | Description |
+|------|-------------|
+| `divisibleby(n)` | Divisible by n |
+| `even` / `odd` | Even/odd integer |
+| `number` / `integer` / `float` | Type checks |
+| `defined` / `undefined` | Variable exists |
+| `none` | Is null |
+| `empty` | Empty array/string/object |
+| `truthy` / `falsy` | Truthiness checks |
+| `string` / `mapping` / `iterable` | Type checks |
+| `gt(n)` / `lt(n)` / `ge(n)` / `le(n)` | Comparisons |
+| `eq(v)` / `ne(v)` / `sameas(v)` | Equality |
+| `upper` / `lower` | String case checks |
+
+```typescript
+import { builtinTests } from 'binja'
+
+// All 30+ built-in tests
+console.log(Object.keys(builtinTests))
+// ['divisibleby', 'even', 'odd', 'number', 'integer', ...]
+```
+
+---
+
 ## Django Compatibility
 
 binja is designed to be a drop-in replacement for Django templates:
@@ -459,31 +453,84 @@ await render('{{ script }}', {
 
 ## Performance Tips
 
-1. **Reuse Environment** - Create once, render many times
-2. **Enable caching** - Templates are cached automatically
-3. **Use Bun** - Native Bun optimizations
+1. **Use AOT in Production** - `compile()` is 160x faster than Nunjucks
+2. **Pre-compile at Startup** - Compile templates once, use many times
+3. **Reuse Environment** - For templates with `{% extends %}`, create once
+4. **Enable caching** - Templates are cached automatically
+
+```typescript
+import { compile } from 'binja'
+
+// Best: AOT compilation for static templates
+const templates = {
+  home: compile(await Bun.file('./views/home.html').text()),
+  user: compile(await Bun.file('./views/user.html').text()),
+}
+
+// Sync rendering, extremely fast
+app.get('/', () => templates.home({ title: 'Home' }))
+app.get('/user/:id', () => templates.user({ id: params.id }))
+```
+
+For templates with inheritance (`{% extends %}`):
 
 ```typescript
-// Good: Create once
-const env = new Environment({ templates: './templates' })
+import { Environment } from 'binja'
+
+// Environment with cache for inherited templates
+const env = new Environment({ templates: './views', cache: true })
 
-// Render multiple times
-app.get('/', () => env.render('home.html', data))
-app.get('/about', () => env.render('about.html', data))
+// Pre-warm cache at startup
+await env.loadTemplate('base.html')
+await env.loadTemplate('home.html')
 ```
 
 ---
 
 ## API Reference
 
-### `render(template, context)`
+### `render(template, context)` - Runtime Mode
 
-Render a template string with context.
+Render a template string with context (async, easy development).
 
 ```typescript
+import { render } from 'binja'
+
 const html = await render('Hello {{ name }}', { name: 'World' })
 ```
 
+### `compile(template, options?)` - AOT Mode
+
+Compile a template to an optimized function (sync, **160x faster**).
+
+```typescript
+import { compile } from 'binja'
+
+// Compile once
+const renderGreeting = compile('<h1>{{ name|upper }}</h1>')
+
+// Use many times (sync!)
+const html = renderGreeting({ name: 'world' }) // <h1>WORLD</h1>
+```
+
+**Supported:** Variables, filters, conditions, loops, set/with, comments.
+**Not supported:** `{% extends %}`, `{% include %}` (use Environment for these).
+
+### `compileToCode(template, options?)`
+
+Generate JavaScript code string for build tools.
+
+```typescript
+import { compileToCode } from 'binja'
+
+const code = compileToCode('<h1>{{ title }}</h1>', {
+  functionName: 'renderHeader'
+})
+
+// Save to file for bundling
+await Bun.write('./compiled/header.js', code)
+```
+
 ### `Environment`
 
 Create a configured template environment.
@@ -496,6 +543,7 @@ env.render(name, context)      // Render template file
 env.renderString(str, context) // Render template string
 env.addFilter(name, fn)        // Add custom filter
 env.addGlobal(name, value)     // Add global variable
+env.loadTemplate(name)         // Pre-load template (for cache warming)
 ```
 
 ---
@@ -725,4 +773,3 @@ See [LICENSE](./LICENSE) for details.
 <p align="center">
   Made with ❤️ for the Bun ecosystem
 </p>
-# binja

package/dist/compiler/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AOT Compiler for binja templates
+ * Generates optimized JavaScript functions from AST
+ */
+import type { TemplateNode } from '../parser/nodes';
+export interface CompileOptions {
+    /** Function name (default: 'render') */
+    functionName?: string;
+    /** Include runtime helpers inline (default: true) */
+    inlineHelpers?: boolean;
+    /** Minify output (default: false) */
+    minify?: boolean;
+    /** Auto-escape HTML (default: true) */
+    autoescape?: boolean;
+}
+/**
+ * Compile AST to JavaScript code string
+ */
+export declare function compileToString(ast: TemplateNode, options?: CompileOptions): string;
+/**
+ * Compile AST to executable function
+ */
+export declare function compileToFunction(ast: TemplateNode, options?: CompileOptions): (ctx: Record<string, any>) => string;
+declare const runtimeHelpers: {
+    escape: (value: any) => string;
+    isTruthy: (value: any) => boolean;
+    toArray: (value: any) => any[];
+    applyFilter: (name: string, value: any, ...args: any[]) => any;
+    applyTest: (name: string, value: any, ...args: any[]) => boolean;
+};
+export { runtimeHelpers };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAEV,YAAY,EAqBb,MAAM,iBAAiB,CAAA;AAIxB,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAGvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAUvH;AAGD,QAAA,MAAM,cAAc;oBACF,GAAG,KAAG,MAAM;sBAQV,GAAG,KAAG,OAAO;qBAad,GAAG,KAAG,GAAG,EAAE;wBAWR,MAAM,SAAS,GAAG,WAAW,GAAG,EAAE,KAAG,GAAG;sBAM1C,MAAM,SAAS,GAAG,WAAW,GAAG,EAAE,KAAG,OAAO;CAK/D,CAAA;AAyaD,OAAO,EAAE,cAAc,EAAE,CAAA"}

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

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

package/dist/index.d.ts

@@ -21,6 +21,7 @@
  */
 import { TemplateNode } from './parser';
 import { FilterFunction } from './filters';
+import { CompileOptions } from './compiler';
 export interface EnvironmentOptions {
     /** Template directory path */
     templates?: string;
@@ -95,6 +96,28 @@ export declare function render(source: string, context?: Record<string, any>, op
 export declare function Template(source: string, options?: EnvironmentOptions): {
     render(context?: Record<string, any>): Promise<string>;
 };
+/**
+ * Compile a template to an optimized JavaScript function (AOT mode)
+ * Returns a sync function that is 10-50x faster than runtime rendering
+ *
+ * @example
+ * ```typescript
+ * const renderUser = compile('<h1>{{ name|upper }}</h1>')
+ * const html = renderUser({ name: 'world' }) // <h1>WORLD</h1>
+ * ```
+ */
+export declare function compile(source: string, options?: CompileOptions): (ctx: Record<string, any>) => string;
+/**
+ * Compile a template to JavaScript code string (for build tools/CLI)
+ * The generated code can be saved to a file and imported directly
+ *
+ * @example
+ * ```typescript
+ * const code = compileToCode('<h1>{{ name }}</h1>', { functionName: 'renderHeader' })
+ * // Returns: "function renderHeader(__ctx) { ... }"
+ * ```
+ */
+export declare function compileToCode(source: string, options?: CompileOptions): string;
 export { Lexer, TokenType } from './lexer';
 export type { Token } from './lexer';
 export { Parser } from './parser';
@@ -102,4 +125,7 @@ export type { TemplateNode, ASTNode, ExpressionNode } from './parser/nodes';
 export { Runtime, Context } from './runtime';
 export { builtinFilters } from './filters';
 export type { FilterFunction } from './filters';
+export type { CompileOptions } from './compiler';
+export { builtinTests } from './tests';
+export type { TestFunction } from './tests';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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