illimi-core 1.0.0

package/dist/vdom/vnode.d.ts

@@ -0,0 +1,52 @@
+/**
+ * FeedJS Core - VDOM Node Types
+ *
+ * Defines the Virtual DOM (VDOM) node structure.
+ * VDOM is platform-agnostic and represents the renderable tree.
+ */
+import type { IRNode } from '../ir/transform.js';
+export declare const FragmentSymbol: unique symbol;
+export declare const TextSymbol: unique symbol;
+export interface VNode {
+    type: string | symbol;
+    props: VNodeProps | null;
+    children: VNodeChild;
+    key: string;
+    interpolation?: string;
+    directives?: Array<{
+        type: string;
+        name: string;
+        value: string;
+        expression: string;
+        modifiers?: string[];
+    }>;
+}
+export interface VNodeProps {
+    [key: string]: VNodePropValue;
+}
+export type VNodePropValue = string | number | boolean | null | undefined;
+export type VNodeChild = VNode[] | string | null;
+export interface VNodeState {
+    [key: string]: unknown;
+}
+/**
+ * Create a VDOM node from IR
+ *
+ * @param ir - The IR node(s) to convert
+ * @param state - The current state for evaluating expressions
+ * @returns VNode
+ */
+export declare function createVDOM(ir: IRNode | IRNode[], state: VNodeState): VNode;
+/**
+ * Check if VNode is a text node
+ */
+export declare function isTextVNode(node: VNode): boolean;
+/**
+ * Check if VNode is a fragment
+ */
+export declare function isFragment(node: VNode): boolean;
+/**
+ * Get the type name of a VNode
+ */
+export declare function getVNodeType(node: VNode): string;
+//# sourceMappingURL=vnode.d.ts.map

package/dist/vdom/vnode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vnode.d.ts","sourceRoot":"","sources":["../../src/vdom/vnode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,eAAO,MAAM,cAAc,eAAgC,CAAC;AAC5D,eAAO,MAAM,UAAU,eAA4B,CAAC;AAGpD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC;CACJ;AAGD,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAG1E,MAAM,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;AAGjD,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,CAS1E;AAwLD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAOhD"}

package/dist/vdom/vnode.js

@@ -0,0 +1,206 @@
+/**
+ * FeedJS Core - VDOM Node Types
+ *
+ * Defines the Virtual DOM (VDOM) node structure.
+ * VDOM is platform-agnostic and represents the renderable tree.
+ */
+// Symbol for element type
+export const FragmentSymbol = Symbol.for('feedjs.fragment');
+export const TextSymbol = Symbol.for('feedjs.text');
+/**
+ * Create a VDOM node from IR
+ *
+ * @param ir - The IR node(s) to convert
+ * @param state - The current state for evaluating expressions
+ * @returns VNode
+ */
+export function createVDOM(ir, state) {
+    // Handle array of IR nodes
+    if (Array.isArray(ir)) {
+        // Create a fragment to hold multiple root nodes
+        const fragment = createFragmentVNode(ir, state);
+        return fragment;
+    }
+    return createVNodeFromIR(ir, state);
+}
+/**
+ * Create VNode from IR node
+ */
+function createVNodeFromIR(ir, state) {
+    if (ir.kind === 'text') {
+        return createTextVNode(ir.value ?? '', state, ir);
+    }
+    if (ir.kind === 'fragment') {
+        return createFragmentVNode(ir.children ?? [], state);
+    }
+    return createElementVNode(ir, state);
+}
+/**
+ * Create an element VNode
+ */
+function createElementVNode(ir, state) {
+    const props = {};
+    // Process static props
+    if (ir.props) {
+        for (const [key, value] of Object.entries(ir.props)) {
+            props[key] = value;
+        }
+    }
+    // Process directives
+    if (ir.directives) {
+        for (const directive of ir.directives) {
+            processDirective(directive, props, state);
+        }
+    }
+    // Process children
+    let children = null;
+    if (ir.children && ir.children.length > 0) {
+        const childNodes = [];
+        for (const childIR of ir.children) {
+            const childVNode = createVNodeFromIR(childIR, state);
+            childNodes.push(childVNode);
+        }
+        children = childNodes;
+    }
+    return {
+        type: ir.tag ?? 'div',
+        props,
+        children,
+        key: ir.key ?? '',
+        directives: ir.directives || [],
+    };
+}
+/**
+ * Create a text VNode
+ */
+function createTextVNode(value, state, ir) {
+    // Check for interpolation
+    if (ir?.interpolation) {
+        const interpValue = evaluateExpression(ir.interpolation, state);
+        return {
+            type: TextSymbol,
+            props: null,
+            children: String(interpValue ?? ''),
+            key: '',
+            interpolation: ir.interpolation,
+        };
+    }
+    // Don't evaluate at compile time - the runtime will handle directives
+    // Just store the raw value
+    return {
+        type: TextSymbol,
+        props: null,
+        children: value,
+        key: '',
+    };
+}
+/**
+ * Create a fragment VNode
+ */
+function createFragmentVNode(children, state) {
+    const childNodes = [];
+    for (const childIR of children) {
+        const childVNode = createVNodeFromIR(childIR, state);
+        childNodes.push(childVNode);
+    }
+    return {
+        type: FragmentSymbol,
+        props: null,
+        children: childNodes,
+        key: '',
+    };
+}
+/**
+ * Process a directive and update props
+ */
+function processDirective(directive, props, state) {
+    switch (directive.type) {
+        case 'text': {
+            // x-text directive - set as text content
+            const value = evaluateExpression(directive.expression ?? '', state);
+            props['x-text'] = String(value ?? '');
+            break;
+        }
+        case 'html': {
+            // x-html directive - set as raw HTML
+            const value = evaluateExpression(directive.expression ?? '', state);
+            props['x-html'] = String(value ?? '');
+            break;
+        }
+        case 'bind': {
+            // x-bind:attribute - bind attribute to expression
+            const attrName = directive.name.replace(/^(?:x|f)-bind:/, '');
+            const value = evaluateExpression(directive.expression ?? '', state);
+            props[attrName] = value == null ? '' : String(value);
+            break;
+        }
+        case 'on': {
+            // x-on:event - declare event handler
+            const eventName = directive.name.replace(/^(?:x|f)-on:/, '');
+            props[`x-on:${eventName}`] = directive.expression ?? '';
+            break;
+        }
+        case 'show': {
+            const value = evaluateExpression(directive.expression ?? '', state);
+            props['x-show'] = Boolean(value);
+            break;
+        }
+        case 'model': {
+            props['x-model'] = directive.expression ?? '';
+            break;
+        }
+        case 'if':
+        case 'else-if':
+        case 'else':
+        case 'for':
+        case 'items':
+        case 'key':
+            // These are handled at a higher level
+            break;
+    }
+}
+/**
+ * Simple expression evaluator
+ * In a real implementation, this would use a proper expression parser
+ * For now, it supports simple property access and literals
+ */
+function evaluateExpression(expr, state) {
+    if (!expr)
+        return undefined;
+    try {
+        const context = state;
+        const keys = Object.keys(context);
+        const values = Object.values(context);
+        const fn = new Function(...keys, `"use strict"; return (${expr});`);
+        return fn(...values);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check if VNode is a text node
+ */
+export function isTextVNode(node) {
+    return node.type === TextSymbol;
+}
+/**
+ * Check if VNode is a fragment
+ */
+export function isFragment(node) {
+    return node.type === FragmentSymbol;
+}
+/**
+ * Get the type name of a VNode
+ */
+export function getVNodeType(node) {
+    if (typeof node.type === 'symbol') {
+        if (node.type === TextSymbol)
+            return 'text';
+        if (node.type === FragmentSymbol)
+            return 'fragment';
+        return 'unknown';
+    }
+    return node.type;
+}
+//# sourceMappingURL=vnode.js.map

package/dist/vdom/vnode.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "illimi-core",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Core library for illimi framework - Virtual DOM and Reactivity System",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+  "build": "tsc"
+},
+  "keywords": [],
+  "authors": [
+    {
+      "name": "Rapha Panchi",
+      "email": "raphapanchi@gmail.com",
+      "url": "https://github.com/ralphxp"
+    },
+    {
+      "name": "Codizium Team",
+      "email": "hell.codizium@gmail.com",
+      "url": "https://github.com/codizium"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:codizium/illimi-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/codizium/illimi-core/issues"
+  },
+  "homepage": "https://github.com/codizium/illimi-core#readme"
+
+
+}

package/tsconfig.base.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    /* === Module System === */
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+
+    /* === Output === */
+    "target": "ES2020",
+    "outDir": "./dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+
+    /* === Project Structure === */
+    /* rootDir is set per-package in package tsconfigs */
+    "rootDir": "./src",
+
+    /* === Type Safety === */
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    /* === Interop & Stability === */
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+  "include": ["src"]
+}