@madojs/mado 0.5.0

package/dist/src/html/parser.js

@@ -0,0 +1,521 @@
+/**
+ * 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.
+ */
+// ---------- Markers ----------
+export const CHILD_MARKER_PREFIX = "mado$";
+export const ATTR_MARKER_PREFIX = "data-mado-bind-";
+// ---------- Cache ----------
+const templateCache = new WeakMap();
+// Tags inside which HTML is not parsed.
+const RAW_TEXT_TAGS = new Set(["script", "style", "textarea", "title"]);
+/**
+ * Main export: parse a tagged-template literal into a ready-to-instantiate
+ * ParsedTemplate. Idempotent (cached by strings).
+ */
+export function parseTemplate(strings) {
+    const cached = templateCache.get(strings);
+    if (cached)
+        return cached;
+    const bindings = [];
+    let html = "";
+    let state = "TEXT";
+    let tagName = "";
+    let attr = null;
+    let rawTagName = "";
+    let nextId = 0;
+    /** Creates a child binding and adds a marker to html. */
+    const emitChildMarker = (slot) => {
+        const id = nextId++;
+        html += `<!--${CHILD_MARKER_PREFIX}${id}-->`;
+        bindings.push({
+            type: "child",
+            id,
+            path: [], // filled during walk
+            childIndex: 0,
+            slot,
+        });
+    };
+    /** Closes the current attribute and flushes it into html. */
+    const flushAttr = () => {
+        if (!attr)
+            return;
+        // Finalize the last fragment.
+        if (attr.hasValue) {
+            attr.valueParts.push(attr.current);
+        }
+        if (attr.slots.length === 0) {
+            // Static attribute: emit as-is.
+            if (!attr.hasValue) {
+                html += " " + attr.rawName;
+            }
+            else if (attr.quote) {
+                html +=
+                    " " + attr.rawName + "=" + attr.quote + attr.current + attr.quote;
+            }
+            else {
+                html += " " + attr.rawName + "=" + attr.current;
+            }
+        }
+        else {
+            // dynamic attribute — place marker, write binding
+            const id = nextId++;
+            // escape name for safe writing into a data attribute value
+            const escapedName = attr.rawName
+                .replace(/&/g, "&amp;")
+                .replace(/"/g, "&quot;");
+            html += ` ${ATTR_MARKER_PREFIX}${id}="${escapedName}"`;
+            const parts = attr.valueParts.length > 0 ? attr.valueParts : ["", ""];
+            // single-part: the attribute is entirely defined by one slot
+            // (all static fragments are empty ⇒ value = just values[slot])
+            const isMulti = attr.slots.length > 1 || parts.some((p) => p !== "");
+            bindings.push({
+                type: "attr",
+                id,
+                path: [], // filled during walk
+                name: attr.rawName,
+                strings: parts,
+                slots: attr.slots,
+                isMulti,
+            });
+        }
+        attr = null;
+    };
+    /** Processes one character of a template string. */
+    const processChar = (c, i, s) => {
+        switch (state) {
+            // ---------- TEXT ----------
+            case "TEXT": {
+                if (c === "<") {
+                    // Potential tag start.
+                    const next = s[i + 1] ?? "";
+                    if (/[a-zA-Z]/.test(next)) {
+                        html += "<";
+                        tagName = "";
+                        state = "TAG_NAME";
+                    }
+                    else if (next === "/") {
+                        html += "<";
+                        state = "CLOSE_TAG";
+                    }
+                    else if (next === "!") {
+                        // Check for <!--.
+                        if (s[i + 2] === "-" && s[i + 3] === "-") {
+                            html += "<";
+                            state = "COMMENT";
+                            // Every following char is copied into html as-is.
+                        }
+                        else {
+                            // <!doctype or <![CDATA[: treat as a normal tag-like block.
+                            html += "<";
+                            state = "CLOSE_TAG"; // Reuse CLOSE_TAG as "wait until >".
+                        }
+                    }
+                    else {
+                        // '<' does not open a tag here, e.g. "a < b".
+                        html += "&lt;";
+                    }
+                }
+                else {
+                    html += c;
+                }
+                break;
+            }
+            // ---------- TAG_NAME ----------
+            case "TAG_NAME": {
+                if (/\s/.test(c)) {
+                    html += c;
+                    state = "BEFORE_ATTR";
+                }
+                else if (c === "/") {
+                    state = "SELF_CLOSE";
+                }
+                else if (c === ">") {
+                    html += c;
+                    if (RAW_TEXT_TAGS.has(tagName.toLowerCase())) {
+                        rawTagName = tagName.toLowerCase();
+                        state = "RAW_TEXT";
+                    }
+                    else {
+                        state = "TEXT";
+                    }
+                }
+                else {
+                    tagName += c;
+                    html += c;
+                }
+                break;
+            }
+            // ---------- BEFORE_ATTR ----------
+            case "BEFORE_ATTR": {
+                if (/\s/.test(c)) {
+                    html += c;
+                }
+                else if (c === "/") {
+                    state = "SELF_CLOSE";
+                }
+                else if (c === ">") {
+                    html += c;
+                    if (RAW_TEXT_TAGS.has(tagName.toLowerCase())) {
+                        rawTagName = tagName.toLowerCase();
+                        state = "RAW_TEXT";
+                    }
+                    else {
+                        state = "TEXT";
+                    }
+                }
+                else {
+                    // Start a new attribute accumulator.
+                    attr = {
+                        rawName: c,
+                        valueParts: [],
+                        current: "",
+                        slots: [],
+                        quote: "",
+                        hasValue: false,
+                    };
+                    state = "ATTR_NAME";
+                }
+                break;
+            }
+            // ---------- ATTR_NAME ----------
+            case "ATTR_NAME": {
+                if (c === "=") {
+                    attr.hasValue = true;
+                    state = "BEFORE_ATTR_VALUE";
+                }
+                else if (/\s/.test(c)) {
+                    state = "AFTER_ATTR_NAME";
+                }
+                else if (c === "/") {
+                    flushAttr();
+                    state = "SELF_CLOSE";
+                }
+                else if (c === ">") {
+                    flushAttr();
+                    html += c;
+                    if (RAW_TEXT_TAGS.has(tagName.toLowerCase())) {
+                        rawTagName = tagName.toLowerCase();
+                        state = "RAW_TEXT";
+                    }
+                    else {
+                        state = "TEXT";
+                    }
+                }
+                else {
+                    attr.rawName += c;
+                }
+                break;
+            }
+            // ---------- AFTER_ATTR_NAME ----------
+            case "AFTER_ATTR_NAME": {
+                if (/\s/.test(c)) {
+                    // Keep skipping whitespace.
+                }
+                else if (c === "=") {
+                    attr.hasValue = true;
+                    state = "BEFORE_ATTR_VALUE";
+                }
+                else if (c === "/") {
+                    flushAttr();
+                    html += " ";
+                    state = "SELF_CLOSE";
+                }
+                else if (c === ">") {
+                    flushAttr();
+                    html += c;
+                    if (RAW_TEXT_TAGS.has(tagName.toLowerCase())) {
+                        rawTagName = tagName.toLowerCase();
+                        state = "RAW_TEXT";
+                    }
+                    else {
+                        state = "TEXT";
+                    }
+                }
+                else {
+                    // This starts a new attribute; the previous one was boolean.
+                    flushAttr();
+                    html += " ";
+                    attr = {
+                        rawName: c,
+                        valueParts: [],
+                        current: "",
+                        slots: [],
+                        quote: "",
+                        hasValue: false,
+                    };
+                    state = "ATTR_NAME";
+                }
+                break;
+            }
+            // ---------- BEFORE_ATTR_VALUE ----------
+            case "BEFORE_ATTR_VALUE": {
+                if (/\s/.test(c)) {
+                    // skip
+                }
+                else if (c === '"') {
+                    attr.quote = '"';
+                    state = "ATTR_VALUE_DQ";
+                }
+                else if (c === "'") {
+                    attr.quote = "'";
+                    state = "ATTR_VALUE_SQ";
+                }
+                else if (c === ">") {
+                    // Empty value through =
+                    flushAttr();
+                    html += c;
+                    state = "TEXT";
+                }
+                else {
+                    attr.quote = "";
+                    attr.current = c;
+                    state = "ATTR_VALUE_UNQ";
+                }
+                break;
+            }
+            // ---------- ATTR_VALUE_DQ ----------
+            case "ATTR_VALUE_DQ": {
+                if (c === '"') {
+                    flushAttr();
+                    state = "BEFORE_ATTR";
+                }
+                else {
+                    attr.current += c;
+                }
+                break;
+            }
+            // ---------- ATTR_VALUE_SQ ----------
+            case "ATTR_VALUE_SQ": {
+                if (c === "'") {
+                    flushAttr();
+                    state = "BEFORE_ATTR";
+                }
+                else {
+                    attr.current += c;
+                }
+                break;
+            }
+            // ---------- ATTR_VALUE_UNQ ----------
+            case "ATTR_VALUE_UNQ": {
+                if (/\s/.test(c)) {
+                    flushAttr();
+                    html += c;
+                    state = "BEFORE_ATTR";
+                }
+                else if (c === ">") {
+                    flushAttr();
+                    html += c;
+                    if (RAW_TEXT_TAGS.has(tagName.toLowerCase())) {
+                        rawTagName = tagName.toLowerCase();
+                        state = "RAW_TEXT";
+                    }
+                    else {
+                        state = "TEXT";
+                    }
+                }
+                else if (c === "/" && s[i + 1] === ">") {
+                    // Self-closing after an unquoted value: <x-icon name=${v}/>
+                    flushAttr();
+                    state = "SELF_CLOSE";
+                }
+                else {
+                    attr.current += c;
+                }
+                break;
+            }
+            // ---------- SELF_CLOSE ----------
+            case "SELF_CLOSE": {
+                if (c === ">") {
+                    html += "/>";
+                    state = "TEXT";
+                }
+                else if (/\s/.test(c)) {
+                    // ignore
+                }
+                else {
+                    // Not self-closing: roll back into a normal attribute.
+                    html += "/";
+                    attr = {
+                        rawName: c,
+                        valueParts: [],
+                        current: "",
+                        slots: [],
+                        quote: "",
+                        hasValue: false,
+                    };
+                    state = "ATTR_NAME";
+                }
+                break;
+            }
+            // ---------- COMMENT ----------
+            case "COMMENT": {
+                html += c;
+                // Look for '-->' by checking the last three html chars.
+                if (html.endsWith("-->") &&
+                    // Guard: it must be at least the length of "<!---->".
+                    html.length >= 7) {
+                    state = "TEXT";
+                }
+                break;
+            }
+            // ---------- RAW_TEXT ----------
+            case "RAW_TEXT": {
+                html += c;
+                // Look for the closing </tagName>.
+                const closing = "</" + rawTagName;
+                if (c === ">" && html.toLowerCase().endsWith(closing + ">")) {
+                    rawTagName = "";
+                    state = "TEXT";
+                }
+                break;
+            }
+            // ---------- CLOSE_TAG ----------
+            case "CLOSE_TAG": {
+                html += c;
+                if (c === ">") {
+                    state = "TEXT";
+                }
+                break;
+            }
+        }
+    };
+    /** Processes the slot ${...} between strings[i] and strings[i+1]. */
+    const processSlot = (slot) => {
+        switch (state) {
+            case "TEXT": {
+                emitChildMarker(slot);
+                break;
+            }
+            case "TAG_NAME":
+            case "BEFORE_ATTR":
+            case "ATTR_NAME":
+            case "AFTER_ATTR_NAME": {
+                throw new Error(`[mado] Dynamic slot in tag/attribute name position is not supported (state=${state}).`);
+            }
+            case "BEFORE_ATTR_VALUE": {
+                // <attr=${v}> without quotes: the slot is the whole value.
+                attr.quote = "";
+                attr.slots.push(slot);
+                attr.valueParts.push(attr.current);
+                attr.current = "";
+                state = "ATTR_VALUE_UNQ";
+                break;
+            }
+            case "ATTR_VALUE_DQ":
+            case "ATTR_VALUE_SQ":
+            case "ATTR_VALUE_UNQ": {
+                attr.slots.push(slot);
+                attr.valueParts.push(attr.current);
+                attr.current = "";
+                break;
+            }
+            case "COMMENT": {
+                // binding inside a static comment — ignore
+                break;
+            }
+            case "RAW_TEXT": {
+                // binding inside <script>/<style>: ignore for security
+                // (can be extended later if a real use-case arises)
+                break;
+            }
+            case "SELF_CLOSE":
+            case "CLOSE_TAG":
+            case "TAG_OPEN": {
+                throw new Error(`[mado] Dynamic slot in position ${state} is not supported.`);
+            }
+        }
+    };
+    for (let i = 0; i < strings.length; i++) {
+        const s = strings[i];
+        for (let j = 0; j < s.length; j++) {
+            processChar(s[j], j, s);
+        }
+        if (i < strings.length - 1) {
+            processSlot(i);
+        }
+    }
+    // 2) Parse the final HTML string through <template>.
+    const tpl = document.createElement("template");
+    tpl.innerHTML = html;
+    // 3) Walk content, find markers, fill path/childIndex for bindings.
+    const byId = new Map();
+    for (const b of bindings)
+        byId.set(b.id, b);
+    walk(tpl.content, [], byId);
+    const parsed = { template: tpl, bindings };
+    templateCache.set(strings, parsed);
+    return parsed;
+}
+/**
+ * Walk the template DOM: for each marker (attribute or comment)
+ * find the corresponding BindingSpec and fill its `path` (how to
+ * reach it from root) and `childIndex` (for child bindings — position
+ * of the placeholder comment among the parent's children).
+ *
+ * Marker attributes `data-mado-bind-N` are removed from elements;
+ * marker comments remain — they serve as an "anchor" for child binding.
+ */
+function walk(node, path, byId) {
+    if (node.nodeType === Node.ELEMENT_NODE) {
+        const el = node;
+        const toRemove = [];
+        for (const attr of [...el.attributes]) {
+            if (attr.name.startsWith(ATTR_MARKER_PREFIX)) {
+                const id = Number(attr.name.slice(ATTR_MARKER_PREFIX.length));
+                const b = byId.get(id);
+                if (b && b.type === "attr") {
+                    b.path = [...path];
+                }
+                toRemove.push(attr.name);
+            }
+        }
+        for (const n of toRemove)
+            el.removeAttribute(n);
+    }
+    if (node.nodeType === Node.COMMENT_NODE) {
+        const c = node;
+        if (c.data.startsWith(CHILD_MARKER_PREFIX)) {
+            const id = Number(c.data.slice(CHILD_MARKER_PREFIX.length));
+            const b = byId.get(id);
+            if (b && b.type === "child") {
+                // Path points to the parent; index is the node position among children.
+                b.path = path.slice(0, -1);
+                b.childIndex = path[path.length - 1];
+            }
+        }
+    }
+    const children = node.childNodes;
+    for (let i = 0; i < children.length; i++) {
+        walk(children[i], [...path, i], byId);
+    }
+}
+/**
+ * Retrieve a node by path from root. Used when instantiating
+ * a template to resolve BindingSpec.path → concrete Node in the clone.
+ */
+export function resolvePath(root, path) {
+    let n = root;
+    for (const i of path)
+        n = n.childNodes[i];
+    return n;
+}
+//# sourceMappingURL=parser.js.map

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

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

package/dist/src/html/template-types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Small shared type module extracted from html.ts to avoid a cycle:
+ * bindings.ts knows about TemplateResult / InstantiatedTemplate, template.ts
+ * instantiates through them, and neither module depends on the other directly
+ * (instantiate is passed into bindings as a parameter).
+ */
+export interface TemplateResult {
+    readonly _mado: true;
+    readonly strings: TemplateStringsArray;
+    readonly values: readonly unknown[];
+}
+export declare const isTemplateResult: (v: unknown) => v is TemplateResult;
+/**
+ * Ready-to-use template instance: already cloned, bindings attached, nodes
+ * extracted. Insert the fragment into the DOM, then call update() when values
+ * change and dispose() when removing it.
+ *
+ * `_strings` lets keyed each decide whether an instance can be reused
+ * (same tagged literal) or must be recreated.
+ */
+export interface InstantiatedTemplate {
+    fragment: DocumentFragment;
+    nodes: Node[];
+    update(values: readonly unknown[]): void;
+    dispose(): void;
+    _strings: TemplateStringsArray;
+}

package/dist/src/html/template-types.js

@@ -0,0 +1,8 @@
+/**
+ * Small shared type module extracted from html.ts to avoid a cycle:
+ * bindings.ts knows about TemplateResult / InstantiatedTemplate, template.ts
+ * instantiates through them, and neither module depends on the other directly
+ * (instantiate is passed into bindings as a parameter).
+ */
+export const isTemplateResult = (v) => typeof v === "object" && v !== null && v._mado === true;
+//# sourceMappingURL=template-types.js.map

package/dist/src/html/template-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-types.js","sourceRoot":"","sources":["../../../src/html/template-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAuB,EAAE,CAClE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAoB,CAAC,KAAK,KAAK,IAAI,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * Template instantiation + public `html\`\`` tag + `render()`.
+ *
+ * Data flow:
+ *   html`...`              → TemplateResult { strings, values }
+ *   parseTemplate(strings) → ParsedTemplate { template, bindings }   (cached by strings)
+ *   instantiate(result)    → InstantiatedTemplate { fragment, nodes, update, dispose }
+ *   render(result, host)   → clones or reuses instance in host
+ *
+ * Only the glue lives here: parser and bindings are in neighbour files.
+ */
+import type { InstantiatedTemplate, TemplateResult } from "./template-types.js";
+/**
+ * `html\`<div>${value}</div>\`` → template descriptor.
+ *
+ * By itself renders and parses NOTHING — this simply captures
+ * { strings, values } from the tagged-template literal. The heavy work
+ * (parsing + cloning) happens on the first `render()` /
+ * `instantiate()` call and is cached by `strings` identity.
+ */
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult;
+/**
+ * Create a ready template instance: clones the pre-parsed template,
+ * resolves all BindingSpec → concrete DOM nodes of the clone, binds
+ * initial values. The returned object is self-contained: update(values)
+ * patches only what actually changed, dispose() cleans up effects
+ * and removes nodes from the DOM.
+ *
+ * Exported (not only used from render()) so that
+ * keyed `each` reconciliation can manage instance lifetimes directly.
+ */
+export declare function instantiate(result: TemplateResult): InstantiatedTemplate;
+/**
+ * Render a TemplateResult into a container.
+ *
+ * Semantics:
+ *   - first call → instantiate + appendChild;
+ *   - repeated call with the same tagged literal (same strings identity) →
+ *     update(values), DOM is not recreated;
+ *   - repeated call with a different literal → dispose old + new instantiate.
+ *
+ * Container can be either an Element or a ShadowRoot (used
+ * in component() for rendering into a shadow tree).
+ */
+export declare function render(result: TemplateResult, container: Element | ShadowRoot): void;