@madojs/mado 0.5.0

package/dist/src/html/bindings.js

@@ -0,0 +1,304 @@
+/**
+ * Bindings: how values end up in DOM nodes after template cloning.
+ * All binding types are described in one place so that adding
+ * a new one (e.g. `??=` or `style.<prop>`) is intentional and visible.
+ *
+ * Split into two groups:
+ *   - bindChild  — child binding (text / node / array / TemplateResult / each)
+ *   - bindAttr   — attribute / event / DOM property / boolean
+ *
+ * Reactivity: if a value is a function (signal/computed), we wrap it
+ * in effect(); the returned Disposer goes into the instance's disposers list
+ * so that on update()/dispose() everything is properly cleaned up.
+ */
+import { effect } from "../signal.js";
+import { isEachResult } from "../each.js";
+import { warnOnce } from "../diagnostics.js";
+import { isTemplateResult, } from "./template-types.js";
+/**
+ * Ownership invariant:
+ * - ChildState owns everything inserted before its anchor for that binding.
+ * - Plain nodes are tracked in current.
+ * - Nested TemplateResult instances are tracked in currentInsts and must be
+ *   dispose()'d before removing current nodes, because they can own deeper
+ *   anchors/effects/nodes not visible to the parent instance.
+ * - each() owns its own InstantiatedTemplate entries through eachEntries.
+ */
+export function createChildState(anchor) {
+    return {
+        anchor,
+        current: [],
+        currentInsts: [],
+        isEach: false,
+        eachEntries: new Map(),
+        eachOrder: [],
+    };
+}
+export function disposeChildState(st) {
+    if (st.isEach) {
+        for (const entry of st.eachEntries.values())
+            entry.inst.dispose();
+        st.eachEntries.clear();
+        st.eachOrder = [];
+        st.isEach = false;
+    }
+    clearCurrent(st);
+}
+/**
+ * Bind a value to a child binding. If value is a function (signal),
+ * subscribe via effect(); otherwise render once.
+ *
+ * instantiateFn is passed as a parameter to avoid circular
+ * dependency bindings ↔ template.
+ */
+export function bindChild(st, value, disposers, instantiateFn) {
+    if (typeof value === "function") {
+        const d = effect(() => {
+            renderChild(st, value(), instantiateFn);
+        });
+        disposers.push(d);
+        return;
+    }
+    renderChild(st, value, instantiateFn);
+}
+function renderChild(st, value, instantiateFn) {
+    // each result: apply keyed reconciliation
+    if (isEachResult(value)) {
+        applyEach(st, value, instantiateFn);
+        return;
+    }
+    // switching from each mode to normal: remove each entries
+    if (st.isEach) {
+        for (const entry of st.eachEntries.values())
+            entry.inst.dispose();
+        st.eachEntries.clear();
+        st.eachOrder = [];
+        st.isEach = false;
+    }
+    // normal branch: clear + recreate
+    clearCurrent(st);
+    const parent = st.anchor.parentNode;
+    if (!parent)
+        return;
+    const append = (node) => {
+        parent.insertBefore(node, st.anchor);
+        st.current.push(node);
+    };
+    const handle = (v) => {
+        if (v == null || v === false || v === true)
+            return;
+        if (v instanceof Node) {
+            append(v);
+            return;
+        }
+        if (isTemplateResult(v)) {
+            const inst = instantiateFn(v);
+            const inserted = [...inst.fragment.childNodes];
+            parent.insertBefore(inst.fragment, st.anchor);
+            st.currentInsts.push(inst);
+            for (const n of inserted)
+                st.current.push(n);
+            return;
+        }
+        if (Array.isArray(v)) {
+            for (const item of v)
+                handle(item);
+            return;
+        }
+        append(document.createTextNode(String(v)));
+    };
+    handle(value);
+}
+function clearCurrent(st) {
+    for (const inst of st.currentInsts.splice(0))
+        inst.dispose();
+    for (const n of st.current)
+        n.parentNode?.removeChild(n);
+    st.current = [];
+}
+/**
+ * Keyed reconciliation: apply an EachResult to a ChildState.
+ *
+ * Algorithm (simple and readable, O(n) by keys):
+ * 1. If switched from "normal" mode — first clear old content.
+ * 2. Build new Map nextEntries: for each item
+ *      - if key existed — reuse entry, call inst.update(values).
+ *      - if key is new — instantiate(template).
+ * 3. Remove entries for keys no longer in the new list.
+ * 4. Place nodes in the correct order via insertBefore(node, refNode).
+ *    refNode is determined by position: iterate from the end to start,
+ *    ref = top node of the next entry (or st.anchor for the last).
+ */
+function applyEach(st, result, instantiateFn) {
+    // Switching from the normal branch to each: clear previous content first.
+    if (!st.isEach && (st.current.length > 0 || st.currentInsts.length > 0)) {
+        clearCurrent(st);
+    }
+    st.isEach = true;
+    const parent = st.anchor.parentNode;
+    if (!parent)
+        return;
+    const items = result.items;
+    const keyOf = result.keyOf;
+    const renderFn = result.render;
+    // 1) Build new keys and entries.
+    const newEntries = new Map();
+    const newOrder = [];
+    const seen = new Set();
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        let key = keyOf(item, i);
+        if (seen.has(key)) {
+            key = `${String(key)}__dup_${i}`;
+        }
+        seen.add(key);
+        const tpl = renderFn(item, i);
+        const prev = st.eachEntries.get(key);
+        if (prev) {
+            // same key → try updating the same instance.
+            // If the template changed (different strings) — recreate.
+            const sameTemplate = prev.inst._strings === tpl.strings;
+            if (sameTemplate) {
+                prev.inst.update(tpl.values);
+                newEntries.set(key, prev);
+            }
+            else {
+                prev.inst.dispose();
+                const inst = instantiateFn(tpl);
+                const nodes = [...inst.fragment.childNodes];
+                // The fragment is not inserted yet; reorder below will place it.
+                newEntries.set(key, { inst, nodes });
+            }
+        }
+        else {
+            const inst = instantiateFn(tpl);
+            const nodes = [...inst.fragment.childNodes];
+            newEntries.set(key, { inst, nodes });
+        }
+        newOrder.push(key);
+    }
+    // 2) remove entries for keys no longer present
+    for (const [oldKey, oldEntry] of st.eachEntries) {
+        if (!newEntries.has(oldKey)) {
+            oldEntry.inst.dispose();
+        }
+    }
+    // 3) place nodes in the correct order.
+    // Iterate from the end: for each entry insertBefore(node, ref),
+    // where ref is the first node of the next entry, or st.anchor for the last.
+    let refNode = st.anchor;
+    for (let i = newOrder.length - 1; i >= 0; i--) {
+        const key = newOrder[i];
+        const entry = newEntries.get(key);
+        // Insert entry nodes before refNode in the correct order.
+        // Go from last to first so every node ends up before refNode in order.
+        for (let j = entry.nodes.length - 1; j >= 0; j--) {
+            const n = entry.nodes[j];
+            // insertBefore moves the node if it is already in the DOM.
+            if (n.parentNode !== parent || n.nextSibling !== refNode) {
+                parent.insertBefore(n, refNode);
+            }
+            refNode = n;
+        }
+    }
+    st.eachEntries = newEntries;
+    st.eachOrder = newOrder;
+}
+// ---------- Attribute binding ----------
+/**
+ * Apply a value to an attr binding. Route by prefix:
+ *   @event     → addEventListener
+ *   .prop      → el[prop] = value
+ *   ?attr      → toggleAttribute by truthy/falsy
+ *   otherwise  → setAttribute / removeAttribute (with multi-part support)
+ */
+export function bindAttr(el, spec, values, disposers) {
+    const name = spec.name;
+    const isMulti = spec.isMulti;
+    // event — single only, no interpolation (meaningless)
+    if (name.startsWith("@")) {
+        if (isMulti) {
+            throw new Error(`[mado] event binding ${name} does not support interpolation.`);
+        }
+        const evt = name.slice(1);
+        const handler = values[spec.slots[0]];
+        el.addEventListener(evt, handler);
+        disposers.push(() => el.removeEventListener(evt, handler));
+        return;
+    }
+    // .prop — DOM property (single only)
+    if (name.startsWith(".")) {
+        if (isMulti) {
+            throw new Error(`[mado] property binding ${name} does not support interpolation.`);
+        }
+        const prop = name.slice(1);
+        const v = values[spec.slots[0]];
+        applyReactive(v, disposers, (vv) => {
+            el[prop] = vv;
+        });
+        return;
+    }
+    // ?attr — boolean attribute (single only)
+    if (name.startsWith("?")) {
+        if (isMulti) {
+            throw new Error(`[mado] boolean binding ${name} does not support interpolation.`);
+        }
+        const attrName = name.slice(1);
+        const v = values[spec.slots[0]];
+        applyReactive(v, disposers, (vv) => {
+            if (vv)
+                el.setAttribute(attrName, "");
+            else
+                el.removeAttribute(attrName);
+        });
+        return;
+    }
+    // ordinary attribute
+    if (!isMulti) {
+        warnBooleanAttrIfNeeded(name);
+        const v = values[spec.slots[0]];
+        applyReactive(v, disposers, (vv) => {
+            if (vv == null || vv === false)
+                el.removeAttribute(name);
+            else
+                el.setAttribute(name, vv === true ? "" : String(vv));
+        });
+        return;
+    }
+    // multi-part: assemble from spec.strings + values[spec.slots[i]].
+    // If at least one part is a function (signal), we need an effect.
+    const hasReactive = spec.slots.some((s) => typeof values[s] === "function");
+    const compute = () => {
+        let out = spec.strings[0] ?? "";
+        for (let i = 0; i < spec.slots.length; i++) {
+            const v = values[spec.slots[i]];
+            const resolved = typeof v === "function" ? v() : v;
+            out += resolved == null ? "" : String(resolved);
+            out += spec.strings[i + 1] ?? "";
+        }
+        return out;
+    };
+    if (hasReactive) {
+        const d = effect(() => el.setAttribute(name, compute()));
+        disposers.push(d);
+    }
+    else {
+        el.setAttribute(name, compute());
+    }
+}
+function warnBooleanAttrIfNeeded(name) {
+    if (name !== "disabled" && name !== "checked")
+        return;
+    warnOnce(`boolean-attr-${name}`, `Use ?${name}= for a boolean attribute. ${name}=\${...} sets a string attribute and often behaves incorrectly.`);
+}
+/** Universal wrapper: if a function — subscribe, otherwise apply once. */
+function applyReactive(value, disposers, apply) {
+    if (typeof value === "function") {
+        const d = effect(() => apply(value()));
+        disposers.push(d);
+    }
+    else {
+        apply(value);
+    }
+}
+//# sourceMappingURL=bindings.js.map

package/dist/src/html/bindings.js.map

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

package/dist/src/html/parser.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Tagged-template parser: a state machine that turns strings[] into
+ *   { template: HTMLTemplateElement, bindings: BindingSpec[] }
+ *
+ * It does not depend on the reactive runtime (signal/each/effect), only on DOM
+ * APIs (document.createElement and walking Node trees). That makes it possible
+ * to test the parser in isolation and reuse it for bake / SSR through linkedom.
+ *
+ * Algorithm:
+ *  1. Walk strings[] char-by-char through an explicit finite state machine.
+ *     For every `${}` slot we know the current context: text, attribute,
+ *     attribute value, comment, or raw text.
+ *  2. Build the final HTML string with markers:
+ *       - `<!--mado$N-->`         for child slots
+ *       - `data-mado-bind-N="…"`  for attributes
+ *     and keep a parallel BindingSpec list that describes each slot.
+ *  3. Parse HTML through `<template>.innerHTML`, then walk() finds markers in
+ *     the DOM and fills BindingSpec.path and childIndex. Marker attributes are
+ *     removed from elements; marker comments remain as child binding anchors.
+ *  4. Cache by strings identity. TemplateStringsArray is stable for the same
+ *     tagged literal between calls.
+ */
+export declare const CHILD_MARKER_PREFIX = "mado$";
+export declare const ATTR_MARKER_PREFIX = "data-mado-bind-";
+export interface ChildBindingSpec {
+    type: "child";
+    id: number;
+    path: number[];
+    childIndex: number;
+    slot: number;
+}
+/** Attribute / event / property / boolean — can be multi-part. */
+export interface AttrBindingSpec {
+    type: "attr";
+    id: number;
+    path: number[];
+    /** Attribute name: 'class', '@click', '.value', '?disabled'. */
+    name: string;
+    /**
+     * If the attribute is single-part (the entire value = one ${}), then
+     * slots = [N], strings = ['', ''], isMulti = false.
+     * If multi-part, strings and slots alternate:
+     *   strings[0] + values[slots[0]] + strings[1] + ... + strings[k]
+     */
+    strings: string[];
+    slots: number[];
+    /** True if the value is assembled from multiple parts (static + slots). */
+    isMulti: boolean;
+}
+export type BindingSpec = ChildBindingSpec | AttrBindingSpec;
+export interface ParsedTemplate {
+    template: HTMLTemplateElement;
+    bindings: BindingSpec[];
+}
+/**
+ * Main export: parse a tagged-template literal into a ready-to-instantiate
+ * ParsedTemplate. Idempotent (cached by strings).
+ */
+export declare function parseTemplate(strings: TemplateStringsArray): ParsedTemplate;
+/**
+ * Retrieve a node by path from root. Used when instantiating
+ * a template to resolve BindingSpec.path → concrete Node in the clone.
+ */
+export declare function resolvePath(root: Node, path: number[]): Node;