illimi-runtime 1.0.0-a

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codizium
+
+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,130 @@
+# Illimi Runtime
+
+Illimi Runtime provides the browser-side functionality to render Illimi templates. It handles DOM creation, event binding, state management, and client-side routing.
+
+## Features
+
+- **DOM Rendering**: Creates actual DOM elements from VNodes
+- **Event Binding**: Handles `f-on:*` directives for DOM events
+- **State Reactivity**: Simple reactive state management
+- **Client-Side Router**: History-based routing with component-level hot module replacement
+- **jQuery Bridge**: Optional integration with jQuery
+
+## Installation
+
+```bash
+npm install illimi-runtime
+```
+
+## Usage
+
+### Basic Rendering
+
+```typescript
+import { mount } from 'illimi-runtime';
+import { createVDOM } from 'illimi-core';
+
+const state = {
+  message: 'Hello, World!',
+  items: ['Apple', 'Banana', 'Cherry']
+};
+
+const vnode = createVDOM(templateIR, state);
+mount(document.getElementById('app')!, vnode, state);
+```
+
+### Router Setup
+
+```typescript
+import { createRouter } from 'illimi-runtime';
+
+const router = createRouter({
+  root: document.getElementById('app')!,
+  getState: () => window.__STATE__,
+  routes: [
+    { path: '/', page: () => import('./pages/home.illimi.html') },
+    { path: '/about', page: () => import('./pages/about.illimi.html') },
+    { path: '/users/:id', page: () => import('./pages/user.illimi.html') }
+  ]
+});
+
+router.start();
+```
+
+### State Management
+
+```typescript
+// Define reactive state
+const state = {
+  count: 0,
+  increment() {
+    this.count++;
+    notify(); // Trigger re-render
+  },
+  subscribe(fn) {
+    subscribers.add(fn);
+  }
+};
+
+function notify() {
+  subscribers.forEach(fn => fn());
+}
+```
+
+## API
+
+### `mount(container: Element, vnode: VNode, state: object): void`
+
+Mounts a VNode tree to a DOM container with the given state.
+
+### `createRouter(options: RouterOptions): Router`
+
+Creates a client-side router instance.
+
+**Router Options:**
+- `root` - Root DOM element for mounting pages
+- `getState` - Function that returns the current application state
+- `routes` - Array of route definitions
+
+**Route Definition:**
+```typescript
+interface Route {
+  path: string;           // Route path (supports :param for params)
+  page: () => Promise<any>;  // Function that returns a page module
+}
+```
+
+### Router Methods
+
+- `start()` - Start the router and navigate to the initial path
+- `navigate(path: string)` - Navigate to a path programmatically
+- `getCurrentPath()` - Get the current route path
+
+## Event Binding
+
+The runtime handles `f-on:*` directives automatically:
+
+```html
+<button f-on:click="increment">Click me</button>
+<input f-on:input="handleInput">
+<form f-on:submit="handleSubmit">
+```
+
+## Direct Runtime Evaluation
+
+The evaluator function can be used to evaluate expressions at runtime:
+
+```typescript
+import { evaluate } from 'illimi-runtime';
+
+const scope = { 
+  state: { price: 100, quantity: 2 },
+  locals: {} 
+};
+
+const result = evaluate('price * quantity', scope); // Returns 200
+```
+
+## License
+
+MIT

package/dist/directives/bind.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Illimi Runtime - f-bind Directive
+ *
+ * Handles attribute/property binding.
+ */
+import type { Directive, Scope } from './types.js';
+export declare function executeBind(el: HTMLElement, dir: Directive, scope: Scope): void;
+//# sourceMappingURL=bind.d.ts.map

package/dist/directives/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../src/directives/bind.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAoCnD,wBAAgB,WAAW,CACzB,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,KAAK,GACX,IAAI,CAyCN"}

package/dist/directives/bind.js

@@ -0,0 +1,69 @@
+/**
+ * Illimi Runtime - f-bind Directive
+ *
+ * Handles attribute/property binding.
+ */
+import { evaluate, extractBindProperty } from './evaluator.js';
+function normalizeClass(value) {
+    if (Array.isArray(value)) {
+        return value.filter(Boolean).map(String).join(' ');
+    }
+    if (value && typeof value === 'object') {
+        return Object.entries(value)
+            .filter(([, enabled]) => Boolean(enabled))
+            .map(([className]) => className)
+            .join(' ');
+    }
+    return String(value ?? '');
+}
+function applyStyle(el, value) {
+    if (value == null) {
+        el.removeAttribute('style');
+        return;
+    }
+    if (typeof value === 'string') {
+        el.style.cssText = value;
+        return;
+    }
+    if (typeof value === 'object') {
+        for (const [prop, styleValue] of Object.entries(value)) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            el.style[prop] = styleValue == null ? '' : String(styleValue);
+        }
+    }
+}
+export function executeBind(el, dir, scope) {
+    const prop = extractBindProperty(dir.name);
+    const value = evaluate(dir.expression, scope);
+    if (prop === 'className' || prop === 'class') {
+        el.className = normalizeClass(value);
+        return;
+    }
+    if (prop === 'style') {
+        applyStyle(el, value);
+        return;
+    }
+    if (prop === 'value') {
+        el.value = String(value ?? '');
+        return;
+    }
+    if (prop === 'checked') {
+        el.checked = Boolean(value);
+        return;
+    }
+    if (value === true) {
+        el.setAttribute(prop, '');
+        return;
+    }
+    if (value === false || value === null || value === undefined) {
+        el.removeAttribute(prop);
+        return;
+    }
+    if (prop in el) {
+        // Keep DOM properties in sync when possible (value, disabled, etc).
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        el[prop] = value;
+    }
+    el.setAttribute(prop, String(value));
+}
+//# sourceMappingURL=bind.js.map

package/dist/directives/bind.js.map

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

package/dist/directives/evaluator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Illimi Runtime - Expression Evaluator
+ *
+ * Expression evaluation utility used by directives/interpolation.
+ */
+import type { Scope } from './types.js';
+/**
+ * Evaluate an expression within a scope.
+ */
+export declare function evaluate(expr: string, scope: Scope): unknown;
+/**
+ * Execute an expression as a statement.
+ * Useful for inline event expressions: count++, todos.push(item), etc.
+ */
+export declare function execute(expr: string, scope: Scope): unknown;
+/**
+ * Extract property name from bind directive.
+ */
+export declare function extractBindProperty(name: string): string;
+/**
+ * Extract event name from on directive.
+ */
+export declare function extractEventName(name: string): string;
+/**
+ * Parse for loop expressions.
+ * Supported:
+ * - item in items
+ * - item of items
+ * - (item, index) in items
+ */
+export declare function parseForExpression(expr: string): {
+    item: string;
+    index?: string;
+    source: string;
+} | null;
+/**
+ * Assign a value to a dotted path on an object (state.foo.bar).
+ */
+export declare function assignPath(target: Record<string, unknown>, path: string, value: unknown): void;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/directives/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/directives/evaluator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAUxC;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CA6B5D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAwB3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBxG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CA0B9F"}

package/dist/directives/evaluator.js

@@ -0,0 +1,125 @@
+/**
+ * Illimi Runtime - Expression Evaluator
+ *
+ * Expression evaluation utility used by directives/interpolation.
+ */
+const fnCache = new Map();
+function buildCacheKey(expr, keys) {
+    return `${expr}::${keys.join('|')}`;
+}
+/**
+ * Evaluate an expression within a scope.
+ */
+export function evaluate(expr, scope) {
+    if (!expr)
+        return undefined;
+    const context = {
+        ...scope.state,
+        ...scope.locals,
+        $state: scope.state,
+        $locals: scope.locals,
+    };
+    try {
+        const keys = Object.keys(context);
+        const values = keys.map((key) => context[key]);
+        const cacheKey = buildCacheKey(expr, keys);
+        let fn = fnCache.get(cacheKey);
+        if (!fn) {
+            fn = new Function(...keys, `"use strict"; return (${expr});`);
+            fnCache.set(cacheKey, fn);
+        }
+        return fn(...values);
+    }
+    catch (error) {
+        console.error(`[Illimi] Expression evaluation error: ${expr}`, error);
+        return undefined;
+    }
+}
+/**
+ * Execute an expression as a statement.
+ * Useful for inline event expressions: count++, todos.push(item), etc.
+ */
+export function execute(expr, scope) {
+    if (!expr)
+        return undefined;
+    const context = {
+        ...scope.state,
+        ...scope.locals,
+        $state: scope.state,
+        $locals: scope.locals,
+    };
+    try {
+        const keys = Object.keys(context);
+        const values = Object.values(context);
+        const fn = new Function(...keys, `"use strict"; ${expr}`);
+        return fn(...values);
+    }
+    catch (error) {
+        console.error(`[Illimi] Expression execution error: ${expr}`, error);
+        return undefined;
+    }
+}
+/**
+ * Extract property name from bind directive.
+ */
+export function extractBindProperty(name) {
+    const prop = name.replace(/^(?:x|f)-bind:/, '');
+    if (prop === 'class')
+        return 'className';
+    return prop;
+}
+/**
+ * Extract event name from on directive.
+ */
+export function extractEventName(name) {
+    return name.replace(/^(?:x|f)-on:/, '').split('.')[0] || '';
+}
+/**
+ * Parse for loop expressions.
+ * Supported:
+ * - item in items
+ * - item of items
+ * - (item, index) in items
+ */
+export function parseForExpression(expr) {
+    const trimmed = expr.trim();
+    const match = trimmed.match(/^(?:\(\s*([A-Za-z_$][\w$]*)(?:\s*,\s*([A-Za-z_$][\w$]*))?\s*\)|([A-Za-z_$][\w$]*))\s+(?:in|of)\s+([\s\S]+)$/);
+    if (!match)
+        return null;
+    const item = match[1] || match[3] || '';
+    const index = match[2] || undefined;
+    const source = (match[4] || '').trim();
+    if (!item || !source)
+        return null;
+    if (index) {
+        return { item, index, source };
+    }
+    return { item, source };
+}
+/**
+ * Assign a value to a dotted path on an object (state.foo.bar).
+ */
+export function assignPath(target, path, value) {
+    const segments = path
+        .split('.')
+        .map((segment) => segment.trim())
+        .filter(Boolean);
+    if (segments.length === 0)
+        return;
+    let cursor = target;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const key = segments[i];
+        if (!key)
+            return;
+        const current = cursor[key];
+        if (!current || typeof current !== 'object') {
+            cursor[key] = {};
+        }
+        cursor = cursor[key];
+    }
+    const last = segments[segments.length - 1];
+    if (!last)
+        return;
+    cursor[last] = value;
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/directives/evaluator.js.map

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

package/dist/directives/for.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Illimi Runtime - f-for Directive
+ *
+ * Handles list/object rendering.
+ */
+import type { Directive, Scope } from './types.js';
+import type { VNode as FeedVNode } from 'illimi-core';
+export declare function executeFor(vnode: FeedVNode, dir: Directive, scope: Scope): Node[];
+//# sourceMappingURL=for.d.ts.map

package/dist/directives/for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"for.d.ts","sourceRoot":"","sources":["../../src/directives/for.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAiBtD,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,KAAK,GACX,IAAI,EAAE,CAwDR"}

package/dist/directives/for.js

@@ -0,0 +1,67 @@
+/**
+ * Illimi Runtime - f-for Directive
+ *
+ * Handles list/object rendering.
+ */
+import { evaluate, parseForExpression } from './evaluator.js';
+import { createNode } from '../dom/createNode.js';
+function cloneWithoutFor(vnode) {
+    const clonedChildren = Array.isArray(vnode.children)
+        ? vnode.children.map((child) => cloneWithoutFor(child))
+        : vnode.children;
+    const directives = (vnode.directives || []).filter((d) => d.type !== 'for');
+    return {
+        ...vnode,
+        children: clonedChildren,
+        directives,
+    };
+}
+export function executeFor(vnode, dir, scope) {
+    const parsed = parseForExpression(dir.expression);
+    if (!parsed) {
+        console.error(`[Illimi] Invalid f-for expression: ${dir.expression}`);
+        return [];
+    }
+    const { item, index, source } = parsed;
+    const collection = evaluate(source, scope);
+    const fragment = document.createDocumentFragment();
+    if (Array.isArray(collection)) {
+        for (let i = 0; i < collection.length; i++) {
+            const childScope = {
+                state: scope.state,
+                locals: {
+                    ...scope.locals,
+                    [item]: collection[i],
+                    [index || '$index']: i,
+                    $index: i,
+                },
+            };
+            const node = createNode(cloneWithoutFor(vnode), childScope);
+            if (node)
+                fragment.appendChild(node);
+        }
+        return [fragment];
+    }
+    if (collection && typeof collection === 'object') {
+        const entries = Object.entries(collection);
+        for (let i = 0; i < entries.length; i++) {
+            const [key, value] = entries[i] || [];
+            const childScope = {
+                state: scope.state,
+                locals: {
+                    ...scope.locals,
+                    [item]: value,
+                    [index || '$index']: key,
+                    $index: i,
+                    $key: key,
+                },
+            };
+            const node = createNode(cloneWithoutFor(vnode), childScope);
+            if (node)
+                fragment.appendChild(node);
+        }
+        return [fragment];
+    }
+    return [];
+}
+//# sourceMappingURL=for.js.map

package/dist/directives/for.js.map

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

package/dist/directives/html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Illimi Runtime - f-html Directive
+ *
+ * Sets raw HTML content.
+ */
+import type { Directive, Scope } from './types.js';
+export declare function executeHtml(el: HTMLElement, dir: Directive, scope: Scope): void;
+//# sourceMappingURL=html.d.ts.map

package/dist/directives/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/directives/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAG/E"}

package/dist/directives/html.js

@@ -0,0 +1,11 @@
+/**
+ * Illimi Runtime - f-html Directive
+ *
+ * Sets raw HTML content.
+ */
+import { evaluate } from './evaluator.js';
+export function executeHtml(el, dir, scope) {
+    const value = evaluate(dir.expression, scope);
+    el.innerHTML = String(value ?? '');
+}
+//# sourceMappingURL=html.js.map

package/dist/directives/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/directives/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,MAAM,UAAU,WAAW,CAAC,EAAe,EAAE,GAAc,EAAE,KAAY;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9C,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/directives/if.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Illimi Runtime - f-if Directive
+ *
+ * Handles conditional rendering.
+ */
+import type { Directive, Scope } from './types.js';
+/**
+ * Execute f-if directive
+ * Returns whether to render the node
+ */
+export declare function executeIf(dir: Directive, scope: Scope): boolean;
+//# sourceMappingURL=if.d.ts.map

package/dist/directives/if.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"if.d.ts","sourceRoot":"","sources":["../../src/directives/if.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,KAAK,GACX,OAAO,CAGT"}

package/dist/directives/if.js

@@ -0,0 +1,15 @@
+/**
+ * Illimi Runtime - f-if Directive
+ *
+ * Handles conditional rendering.
+ */
+import { evaluate } from './evaluator.js';
+/**
+ * Execute f-if directive
+ * Returns whether to render the node
+ */
+export function executeIf(dir, scope) {
+    const result = evaluate(dir.expression, scope);
+    return !!result;
+}
+//# sourceMappingURL=if.js.map

package/dist/directives/if.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"if.js","sourceRoot":"","sources":["../../src/directives/if.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,GAAc,EACd,KAAY;IAEZ,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,CAAC,MAAM,CAAC;AAClB,CAAC"}

package/dist/directives/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Illimi Runtime - Directives
+ *
+ * Directive execution engine for the Illimi runtime.
+ */
+export * from './types.js';
+export * from './evaluator.js';
+export { executeText } from './text.js';
+export { executeHtml } from './html.js';
+export { executeBind } from './bind.js';
+export { executeOn } from './on.js';
+export { executeIf } from './if.js';
+export { executeFor } from './for.js';
+export { executeShow } from './show.js';
+export { executeModel } from './model.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/directives/index.js

@@ -0,0 +1,16 @@
+/**
+ * Illimi Runtime - Directives
+ *
+ * Directive execution engine for the Illimi runtime.
+ */
+export * from './types.js';
+export * from './evaluator.js';
+export { executeText } from './text.js';
+export { executeHtml } from './html.js';
+export { executeBind } from './bind.js';
+export { executeOn } from './on.js';
+export { executeIf } from './if.js';
+export { executeFor } from './for.js';
+export { executeShow } from './show.js';
+export { executeModel } from './model.js';
+//# sourceMappingURL=index.js.map

package/dist/directives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/directives/model.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Illimi Runtime - f-model Directive
+ *
+ * Two-way binding for input/select/textarea-like elements.
+ */
+import type { Directive, Scope } from './types.js';
+export declare function executeModel(el: HTMLElement, dir: Directive, scope: Scope): void;
+//# sourceMappingURL=model.d.ts.map

package/dist/directives/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/directives/model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAmBnD,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAmBhF"}