@liteforge/runtime 0.1.0

package/dist/control-flow.js

@@ -0,0 +1,452 @@
+/**
+ * LiteForge Control Flow Components
+ *
+ * Components for conditional rendering and list iteration.
+ * These handle DOM insertion/removal reactively based on signals.
+ */
+import { effect } from '@liteforge/core';
+import { isComponentFactory } from './component.js';
+/**
+ * Discriminate a dynamic component value into a tagged union.
+ * This helps TypeScript narrow types that can't be narrowed with type guards alone.
+ */
+function discriminateDynamicComponent(comp) {
+    if (comp === null) {
+        return { kind: 'null' };
+    }
+    if (isComponentFactory(comp)) {
+        // Safe cast: isComponentFactory checks for __liteforge_component
+        return { kind: 'factory', value: comp };
+    }
+    // If it's not null and not a ComponentFactory, it must be a RenderFunction
+    return { kind: 'render', value: comp };
+}
+/**
+ * Conditionally render children based on a condition.
+ * When the condition is truthy, the truthy value is passed to the children callback.
+ *
+ * @typeParam T - The type returned by the `when` getter
+ *
+ * @example
+ * ```ts
+ * // Boolean condition
+ * Show({
+ *   when: () => isLoggedIn(),
+ *   fallback: () => document.createTextNode('Please log in'),
+ *   children: () => createWelcomeMessage(),
+ * })
+ *
+ * // Value-based condition with type narrowing
+ * Show({
+ *   when: () => currentUser(),  // User | null
+ *   children: (user) => (       // user is User, guaranteed non-null
+ *     <h1>{user.name}</h1>
+ *   ),
+ * })
+ * ```
+ */
+// Debug counter for Show instances
+let showInstanceId = 0;
+export function Show(config) {
+    const { when, fallback, children } = config;
+    // Create a marker comment for positioning
+    const instanceId = ++showInstanceId;
+    const marker = document.createComment(`Show:${instanceId}`);
+    let currentNode = null;
+    let lastValue;
+    let hasRendered = false;
+    // Resolve the condition to a function
+    const getValue = () => {
+        if (typeof when === 'function') {
+            return when();
+        }
+        return when;
+    };
+    // Update content based on condition
+    function updateContent() {
+        const parentElement = marker.parentNode;
+        if (!parentElement)
+            return;
+        const value = getValue();
+        // Value unchanged (by reference) → nothing to do
+        // This handles: same primitive (boolean true/false/null), same object reference
+        // Prevents re-rendering when isAdmin() returns same boolean but effect re-runs
+        if (hasRendered && Object.is(value, lastValue)) {
+            return;
+        }
+        lastValue = value;
+        hasRendered = true;
+        // Remove old node if it exists
+        if (currentNode && currentNode.parentNode) {
+            currentNode.parentNode.removeChild(currentNode);
+            currentNode = null;
+        }
+        // Create and insert new node
+        const isTruthy = Boolean(value);
+        const newNode = isTruthy
+            ? children(value)
+            : fallback?.() ?? null;
+        if (newNode) {
+            parentElement.insertBefore(newNode, marker.nextSibling);
+            currentNode = newNode;
+        }
+    }
+    // Set up reactive effect for updates
+    // We use requestAnimationFrame to ensure the marker is in the DOM
+    // before the first update (replaces problematic MutationObserver)
+    effect(() => {
+        // Read the value to track dependencies
+        getValue();
+        // Only update if marker is in DOM
+        if (marker.parentNode) {
+            updateContent();
+        }
+        else {
+            // Marker not in DOM yet - schedule check for next frame
+            requestAnimationFrame(() => {
+                if (marker.parentNode) {
+                    updateContent();
+                }
+            });
+        }
+    });
+    return marker;
+}
+/**
+ * Render a list of items with keyed reconciliation.
+ *
+ * @typeParam T - The item type, inferred from the `each` array
+ *
+ * @example
+ * ```ts
+ * For({
+ *   each: () => users(),
+ *   key: 'id',
+ *   children: (user, index) => {
+ *     return document.createTextNode(`${index}: ${user.name}`);
+ *   },
+ *   fallback: () => document.createTextNode('No users'),
+ * })
+ * ```
+ */
+export function For(config) {
+    const { each, key, children, fallback } = config;
+    // Create a marker comment for positioning
+    const marker = document.createComment('For');
+    let items = [];
+    let fallbackNode = null;
+    let isInitialized = false;
+    // Resolve the list to a function
+    const getList = () => {
+        if (typeof each === 'function') {
+            return each();
+        }
+        return each;
+    };
+    // Get key for an item
+    const getKey = (item, index) => {
+        if (key === undefined) {
+            // For primitives without explicit key, use the value itself to enable proper reconciliation
+            // This allows detecting when items at the same index have different values
+            if (typeof item === 'string' || typeof item === 'number') {
+                return `${index}:${item}`;
+            }
+            // For objects without key, fall back to index (no reconciliation benefit)
+            return index;
+        }
+        if (typeof key === 'function') {
+            return key(item, index);
+        }
+        return String(item[key]);
+    };
+    // Remove fallback node if present
+    function removeFallback() {
+        if (fallbackNode && fallbackNode.parentNode) {
+            fallbackNode.parentNode.removeChild(fallbackNode);
+            fallbackNode = null;
+        }
+    }
+    // Reconcile the list
+    function updateList() {
+        const parentElement = marker.parentNode;
+        if (!parentElement)
+            return;
+        const list = getList();
+        // Handle empty list with fallback
+        if (list.length === 0) {
+            // Remove all existing items
+            for (const oldItem of items) {
+                if (oldItem.node.parentNode) {
+                    oldItem.node.parentNode.removeChild(oldItem.node);
+                }
+            }
+            items = [];
+            // Show fallback if provided
+            if (fallback && !fallbackNode) {
+                fallbackNode = fallback();
+                parentElement.insertBefore(fallbackNode, marker.nextSibling);
+            }
+            return;
+        }
+        // Remove fallback if list has items
+        removeFallback();
+        // Build a map of existing items by key
+        const existingByKey = new Map();
+        for (const item of items) {
+            existingByKey.set(item.key, item);
+        }
+        // Build new items list
+        const newItems = [];
+        const newKeys = new Set();
+        for (let i = 0; i < list.length; i++) {
+            const item = list[i];
+            const itemKey = getKey(item, i);
+            newKeys.add(itemKey);
+            const existing = existingByKey.get(itemKey);
+            if (existing) {
+                // Reuse existing item, update index
+                existing.item = item;
+                existing.index = i;
+                newItems.push(existing);
+            }
+            else {
+                // Create new item - pass plain index number
+                const node = children(item, i);
+                newItems.push({ item, key: itemKey, node, index: i });
+            }
+        }
+        // Remove items that are no longer in the list
+        for (const oldItem of items) {
+            if (!newKeys.has(oldItem.key)) {
+                if (oldItem.node.parentNode) {
+                    oldItem.node.parentNode.removeChild(oldItem.node);
+                }
+            }
+        }
+        // Insert/reorder items in the DOM
+        // We need to maintain the correct order after the marker
+        let prevNode = marker;
+        for (const newItem of newItems) {
+            const { node } = newItem;
+            const expectedPosition = prevNode.nextSibling;
+            if (node !== expectedPosition) {
+                // Node is either not in DOM or in wrong position
+                if (node.parentNode) {
+                    node.parentNode.removeChild(node);
+                }
+                parentElement.insertBefore(node, prevNode.nextSibling);
+            }
+            prevNode = node;
+        }
+        items = newItems;
+    }
+    // Use MutationObserver to detect when marker is added to DOM
+    const observer = new MutationObserver(() => {
+        if (marker.parentNode && !isInitialized) {
+            isInitialized = true;
+            observer.disconnect();
+            updateList();
+        }
+    });
+    observer.observe(document, { childList: true, subtree: true });
+    // Set up reactive effect for updates
+    effect(() => {
+        // Read the list to track dependencies
+        getList();
+        // Only update if marker is in DOM
+        if (marker.parentNode) {
+            updateList();
+        }
+    });
+    return marker;
+}
+/**
+ * Render the first matching case, or fallback.
+ *
+ * @example
+ * ```ts
+ * Switch({
+ *   fallback: () => document.createTextNode('Unknown'),
+ *   children: [
+ *     Match({ when: () => status() === 'loading', children: () => Spinner() }),
+ *     Match({ when: () => status() === 'error', children: () => ErrorView() }),
+ *     Match({ when: () => status() === 'success', children: () => SuccessView() }),
+ *   ],
+ * })
+ * ```
+ */
+export function Switch(config) {
+    const { fallback, children } = config;
+    const marker = document.createComment('Switch');
+    let currentNode = null;
+    let currentIndex = -1;
+    let isInitialized = false;
+    function findMatchIndex() {
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (!child)
+                continue;
+            const condition = typeof child.when === 'function' ? child.when() : child.when;
+            if (condition) {
+                return i;
+            }
+        }
+        return fallback ? -2 : -1; // -2 = fallback, -1 = no match
+    }
+    function updateSwitch() {
+        const parentElement = marker.parentNode;
+        if (!parentElement)
+            return;
+        const matchedIndex = findMatchIndex();
+        // Only update if the matched case changed
+        if (matchedIndex !== currentIndex) {
+            // Remove old node
+            if (currentNode && currentNode.parentNode) {
+                currentNode.parentNode.removeChild(currentNode);
+                currentNode = null;
+            }
+            // Insert new node
+            let render;
+            if (matchedIndex >= 0) {
+                render = children[matchedIndex]?.render;
+            }
+            else if (matchedIndex === -2) {
+                render = fallback;
+            }
+            if (render) {
+                currentNode = render();
+                parentElement.insertBefore(currentNode, marker.nextSibling);
+            }
+            currentIndex = matchedIndex;
+        }
+    }
+    // Use MutationObserver to detect when marker is added to DOM
+    const observer = new MutationObserver(() => {
+        if (marker.parentNode && !isInitialized) {
+            isInitialized = true;
+            observer.disconnect();
+            updateSwitch();
+        }
+    });
+    observer.observe(document, { childList: true, subtree: true });
+    // Set up reactive effect
+    effect(() => {
+        // Read all conditions to track dependencies
+        for (const child of children) {
+            if (typeof child.when === 'function') {
+                child.when();
+            }
+        }
+        if (marker.parentNode) {
+            updateSwitch();
+        }
+    });
+    return marker;
+}
+/**
+ * Helper to create a Match case for Switch.
+ *
+ * @example
+ * ```ts
+ * Match({
+ *   when: () => status() === 'active',
+ *   children: () => <span>Active</span>,
+ * })
+ * ```
+ */
+export function Match(config) {
+    return { when: config.when, render: config.children };
+}
+/**
+ * Dynamically render a component based on a signal.
+ *
+ * @example
+ * ```ts
+ * Dynamic({
+ *   component: () => currentView(),
+ *   props: () => ({ id: currentId() }),
+ * })
+ * ```
+ */
+export function Dynamic(config) {
+    const { component, props } = config;
+    const marker = document.createComment('Dynamic');
+    let currentNode = null;
+    let currentComponent = null;
+    let currentInstance = null;
+    let isInitialized = false;
+    const getComponent = () => {
+        return component();
+    };
+    const getProps = () => {
+        if (typeof props === 'function') {
+            return props();
+        }
+        return (props ?? {});
+    };
+    function updateDynamic() {
+        const parentElement = marker.parentNode;
+        if (!parentElement)
+            return;
+        const comp = getComponent();
+        const currentProps = getProps();
+        // Check if component changed
+        if (comp !== currentComponent) {
+            // Unmount old component/remove old node
+            if (currentInstance) {
+                currentInstance.unmount();
+                currentInstance = null;
+            }
+            if (currentNode && currentNode.parentNode) {
+                currentNode.parentNode.removeChild(currentNode);
+                currentNode = null;
+            }
+            // Mount new component using discriminated union for proper type narrowing
+            const discriminated = discriminateDynamicComponent(comp);
+            if (discriminated.kind === 'factory') {
+                currentInstance = discriminated.value(currentProps);
+                // Create a temporary container to get the node
+                const tempContainer = document.createElement('div');
+                currentInstance.mount(tempContainer);
+                const node = tempContainer.firstChild;
+                if (node) {
+                    tempContainer.removeChild(node);
+                    parentElement.insertBefore(node, marker.nextSibling);
+                    currentNode = node;
+                }
+            }
+            else if (discriminated.kind === 'render') {
+                currentNode = discriminated.value();
+                if (currentNode) {
+                    parentElement.insertBefore(currentNode, marker.nextSibling);
+                }
+            }
+            // kind === 'null' means no component to mount
+            currentComponent = comp;
+        }
+        else if (currentInstance) {
+            // Same component, just update props
+            currentInstance.updateProps(currentProps);
+        }
+    }
+    // Use MutationObserver to detect when marker is added to DOM
+    const observer = new MutationObserver(() => {
+        if (marker.parentNode && !isInitialized) {
+            isInitialized = true;
+            observer.disconnect();
+            updateDynamic();
+        }
+    });
+    observer.observe(document, { childList: true, subtree: true });
+    // Set up reactive effect
+    effect(() => {
+        // Read to track dependencies
+        getComponent();
+        getProps();
+        if (marker.parentNode) {
+            updateDynamic();
+        }
+    });
+    return marker;
+}
+//# sourceMappingURL=control-flow.js.map

package/dist/control-flow.js.map

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

package/dist/h.d.ts

@@ -0,0 +1,53 @@
+/**
+ * LiteForge h() Function
+ *
+ * The hyperscript function that creates DOM elements from JSX.
+ * Handles both HTML elements and components, with support for
+ * reactive props and children via getter functions.
+ *
+ * @example
+ * ```ts
+ * // HTML element
+ * h('div', { class: 'container' }, 'Hello')
+ *
+ * // Reactive prop
+ * h('div', { class: () => theme() }, 'Text')
+ *
+ * // Component
+ * h(MyComponent, { name: 'John' })
+ *
+ * // Fragment
+ * h(Fragment, null, h('div', null, 'A'), h('div', null, 'B'))
+ * ```
+ */
+import type { ComponentFactory, RenderFunction } from './types.js';
+/**
+ * Fragment represents a list of children without a wrapper element.
+ * Use with h(Fragment, null, ...children) or JSX <>...</>
+ */
+export declare const Fragment: unique symbol;
+/** Props can be static values or getter functions for reactivity */
+type PropValue = unknown | (() => unknown);
+/** Props object passed to h() */
+type Props = Record<string, PropValue> | null;
+/** Child can be a node, string, number, getter, or component */
+type HChild = Node | string | number | boolean | null | undefined | (() => HChild) | HChild[];
+/**
+ * Function component type that accepts props.
+ * The bivariant hack uses a method signature which TypeScript checks bivariantly.
+ */
+type FunctionComponent<P = Record<string, unknown>> = {
+    bivarianceHack(props: P): Node;
+}['bivarianceHack'];
+/** Tag can be HTML element name, Component, Fragment, or render function */
+type Tag = string | typeof Fragment | ComponentFactory<Record<string, unknown>> | FunctionComponent | RenderFunction;
+/**
+ * Create a DOM node from JSX-like arguments.
+ *
+ * @param tag - Element name, Component, or Fragment
+ * @param props - Props object or null
+ * @param children - Child nodes
+ */
+export declare function h(tag: Tag, props: Props, ...children: HChild[]): Node;
+export {};
+//# sourceMappingURL=h.d.ts.map

package/dist/h.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h.d.ts","sourceRoot":"","sources":["../src/h.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOnE;;;GAGG;AACH,eAAO,MAAM,QAAQ,eAAmC,CAAC;AAMzD,oEAAoE;AACpE,KAAK,SAAS,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AAE3C,iCAAiC;AACjC,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;AAE9C,gEAAgE;AAChE,KAAK,MAAM,GACP,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,CAAC,MAAM,MAAM,CAAC,GACd,MAAM,EAAE,CAAC;AAEb;;;GAGG;AACH,KAAK,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACpD,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAChC,CAAC,gBAAgB,CAAC,CAAC;AAEpB,4EAA4E;AAC5E,KAAK,GAAG,GACJ,MAAM,GACN,OAAO,QAAQ,GACf,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAGzC,iBAAiB,GACjB,cAAc,CAAC;AAMnB;;;;;;GAMG;AACH,wBAAgB,CAAC,CACf,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,GAAG,QAAQ,EAAE,MAAM,EAAE,GACpB,IAAI,CAaN"}