@elurjs/core 3.5.0

package/dist/lib/elur/template/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","names":[],"sources":["../../../../src/elur/template/html.ts"],"sourcesContent":["import { ELUR_TEMPLATE_DESCRIPTOR, type ElurTemplate, type ElurMountHandle, type TemplateDescriptor } from \"./types.js\";\nimport { detectContext, activateBindings } from \"./bindings.js\";\nimport type { BindingContext } from \"./bindings.js\";\n\n// =============================================================================\n// --- Static HTML construction with markers ---\n// =============================================================================\n\n/**\n * Builds the static HTML string, replacing each interpolated value with\n * a comment marker (node), data-elur-e-N (event), or data-elur-a-N (attribute).\n */\nexport function buildHTML(\n    strings: readonly string[],\n    contexts: BindingContext[]\n): string {\n    const skipLeading = new Uint8Array(strings.length);\n    let result = \"\";\n\n    for (let i = 0; i < strings.length; i++) {\n        let s = strings[i];\n\n        if (skipLeading[i] === 1 && (s[0] === '\"' || s[0] === \"'\")) {\n            s = s.slice(1);\n        }\n\n        if (i < contexts.length) {\n            const ctx = contexts[i];\n\n            if (ctx.type === \"node\") {\n                result += s + `<!--elur-${i}-->`;\n            } else if (ctx.type === \"event\") {\n                const full = ctx.modifiers.length\n                    ? `${ctx.eventName}.${ctx.modifiers.join(\".\")}`\n                    : ctx.eventName;\n                const cut = `@${full}=`.length + (ctx.hadOpenQuote ? 1 : 0);\n                result += s.slice(0, -cut) + ` data-elur-e-${i}=\"${ctx.eventName}\"`;\n                if (ctx.hadOpenQuote) skipLeading[i + 1] = 1;\n            } else {\n                const cut =\n                    `${ctx.attrName}=`.length + (ctx.hadOpenQuote ? 1 : 0);\n                result += s.slice(0, -cut) + ` data-elur-a-${i}=\"${ctx.attrName}\"`;\n                if (ctx.hadOpenQuote) skipLeading[i + 1] = 1;\n            }\n        } else {\n            result += s;\n        }\n    }\n\n    return result;\n}\n\n// =============================================================================\n// --- Template cache ---\n// =============================================================================\n\ninterface DescriptorCache {\n    contexts: BindingContext[];\n}\n\ninterface TemplateCache {\n    tpl: HTMLTemplateElement;\n    pathMap: Array<{ nodeIndex: number; name?: string } | null>;\n}\n\nconst _descriptorCache = new WeakMap<TemplateStringsArray, DescriptorCache>();\nconst _templateCache = new WeakMap<TemplateStringsArray, TemplateCache>();\n\n// =============================================================================\n// --- html`` tag function ---\n// =============================================================================\n\nexport function html(\n    strings: TemplateStringsArray,\n    ...values: unknown[]\n): ElurTemplate {\n    // NOTE: Partial attribute interpolation (`class=\"btn ${size}\"`) is handled\n    // at compile time by @elurjs/vite-plugin-elur. Without the plugin,\n    // only full bindings (`class=${value}`) are supported.\n    let descriptorCache = _descriptorCache.get(strings);\n    if (!descriptorCache) {\n        const contexts: BindingContext[] = [];\n        let accumulated = \"\";\n        for (let i = 0; i < strings.length - 1; i++) {\n            accumulated += strings[i];\n            contexts.push(detectContext(accumulated));\n            accumulated += \"__elur__\";\n        }\n        descriptorCache = { contexts };\n        _descriptorCache.set(strings, descriptorCache);\n    }\n\n    const contexts = descriptorCache.contexts;\n    const descriptor: TemplateDescriptor = { version: 1, strings, values, contexts };\n\n    function getTemplateCache(): TemplateCache {\n        let cached = _templateCache.get(strings);\n        if (cached) return cached;\n        if (typeof document === \"undefined\") {\n            throw new Error(\"[elur] DOM rendering requires a document. Use elur/server on the server.\");\n        }\n\n        const tpl = document.createElement(\"template\");\n        tpl.innerHTML = buildHTML(strings, contexts);\n        const pathMap = new Array<{ nodeIndex: number; name?: string } | null>(contexts.length).fill(null);\n        const root = tpl.content;\n        const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_COMMENT);\n        let nodeIndex = 0;\n        let wNode: Node | null;\n\n        while ((wNode = walker.nextNode())) {\n            nodeIndex++;\n            if (wNode.nodeType === 8) {\n                const val = wNode.nodeValue;\n                if (val && val.startsWith(\"elur-\")) {\n                    const idx = parseInt(val.slice(5), 10);\n                    if (!isNaN(idx)) pathMap[idx] = { nodeIndex };\n                }\n            } else if (wNode.nodeType === 1) {\n                const el = wNode as Element;\n                const attrs = Array.from(el.attributes);\n                for (let i = 0; i < attrs.length; i++) {\n                    const attr = attrs[i];\n                    const name = attr.name;\n                    if (name.startsWith(\"data-elur-e-\")) {\n                        const idx = parseInt(name.slice(12), 10);\n                        if (!isNaN(idx)) pathMap[idx] = { nodeIndex, name: attr.value };\n                        el.removeAttribute(name);\n                        continue;\n                    }\n                    if (name.startsWith(\"data-elur-a-\")) {\n                        const idx = parseInt(name.slice(12), 10);\n                        if (!isNaN(idx)) pathMap[idx] = { nodeIndex, name: attr.value };\n                        el.removeAttribute(name);\n                    }\n                }\n            }\n        }\n\n        cached = { tpl, pathMap };\n        _templateCache.set(strings, cached);\n        return cached;\n    }\n\n    function _render(parent: Node, before: Node | null): () => void {\n        const { tpl, pathMap } = getTemplateCache();\n        const fragment = tpl.content.cloneNode(true) as DocumentFragment;\n\n        const { disposes, postMountHooks } = activateBindings(\n            fragment, contexts, values, pathMap\n        );\n\n        const startMarker = document.createTextNode(\"\");\n        const endMarker = document.createTextNode(\"\")\n\n        parent.insertBefore(startMarker, before);\n        parent.insertBefore(fragment, before);\n        parent.insertBefore(endMarker, before);\n\n        postMountHooks.forEach((cb) => cb());\n\n        return () => {\n            for (let i = disposes.length - 1; i >= 0; i--) {\n                disposes[i]();\n            }\n            let node = startMarker.nextSibling;\n            while (node && node !== endMarker) {\n                const next = node.nextSibling;\n                node.parentNode?.removeChild(node);\n                node = next;\n            }\n            startMarker.parentNode?.removeChild(startMarker);\n            endMarker.parentNode?.removeChild(endMarker);\n        };\n    }\n\n    const elurTemplate: ElurTemplate = {\n        __isElurTemplate: true,\n        [ELUR_TEMPLATE_DESCRIPTOR]: descriptor,\n\n        _render,\n\n        mount(container: Element | string): ElurMountHandle {\n            const el =\n                typeof container === \"string\"\n                    ? (document.querySelector(container) as Element)\n                    : container;\n\n            if (!el) {\n                throw new Error(`[elur] mount: contenedor no encontrado: ${container}`);\n            }\n\n            const cleanup = _render(el, null);\n\n            return {\n                unmount() {\n                    cleanup();\n                },\n            };\n        },\n    };\n\n    return elurTemplate;\n}\n"],"mappings":"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"}

package/dist/lib/elur/template/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./elur/template/types.cjs`),t=require(`./elur/template/keyed.cjs`),n=require(`./elur/template/keyed-diff.cjs`),r=require(`./elur/template/dom-write.cjs`),i=require(`./elur/template/node-binding.cjs`),a=require(`./elur/template/sanitize.cjs`),o=require(`./elur/template/bindings.cjs`),s=require(`./elur/template/html.cjs`),c=require(`./elur/template/raw.cjs`),l=require(`./elur/template/transitions.cjs`),u=require(`./elur/template/portal.cjs`),d=require(`./elur/template/error-boundary.cjs`);exports.COMMENT=e.COMMENT,exports.ELUR_RENDER_PROTOCOL=e.ELUR_RENDER_PROTOCOL,exports.ELUR_TEMPLATE_DESCRIPTOR=e.ELUR_TEMPLATE_DESCRIPTOR,exports._activateBindingsWithNodes=o._activateBindingsWithNodes,exports._activateDelegatedEvent=o.activateDelegatedEvent,exports._activateNodeBinding=i.activateNodeBinding,exports._createKeyedMount=n.createKeyedMount,exports._ensureDelegatedEvent=o._ensureDelegatedEvent,exports._getKeyedSequence=t.getSequence,exports._queueDOMWrite=r.queueDOMWrite,exports._reconcileKeyedList=n.reconcileKeyedList,exports._setDelegatedEvent=o._setDelegatedEvent,exports.buildHTML=s.buildHTML,exports.createErrorBoundary=d.createErrorBoundary,exports.createPortalOutlet=u.createPortalOutlet,exports.html=s.html,exports.injectOutlet=u.injectOutlet,exports.isElurTemplate=e.isElurTemplate,exports.isExecutableAttrName=a.isExecutableAttrName,exports.isKeyedList=e.isKeyedList,exports.isUrlAttrName=a.isUrlAttrName,exports.portal=u.portal,exports.portalOutlet=u.portalOutlet,exports.provideOutlet=u.provideOutlet,exports.raw=c.raw,exports.ref=e.ref,exports.repeat=t.repeat,exports.sanitizeUrl=a.sanitizeUrl,exports.showWhen=o.showWhen,exports.templateFeatures=e.templateFeatures,exports.transition=l.transition;

package/dist/lib/elur/template/index.d.cts

@@ -0,0 +1,15 @@
+export type { ElurTemplate, ElurMountHandle, ElurRef, KeyedList, KEntry, PortalOutlet, ErrorFallback, TransitionContent, TemplateBindingContext, TemplateDescriptor, ElurRenderProtocol, ServerRenderProtocolContext, DomProtocolContext, HydrationProtocolContext } from "./types.js";
+export { ref, isElurTemplate, isKeyedList, COMMENT, ELUR_TEMPLATE_DESCRIPTOR, ELUR_RENDER_PROTOCOL, templateFeatures } from "./types.js";
+export { html, buildHTML } from "./html.js";
+export { raw } from "./raw.js";
+export { showWhen } from "./bindings.js";
+export { _activateBindingsWithNodes, activateDelegatedEvent as _activateDelegatedEvent, _ensureDelegatedEvent, _setDelegatedEvent, } from "./bindings.js";
+export { activateNodeBinding as _activateNodeBinding } from "./node-binding.js";
+export { queueDOMWrite as _queueDOMWrite } from "./dom-write.js";
+export { sanitizeUrl, isUrlAttrName, isExecutableAttrName } from "./sanitize.js";
+export { repeat, getSequence as _getKeyedSequence } from "./keyed.js";
+export { createKeyedMount as _createKeyedMount, reconcileKeyedList as _reconcileKeyedList, } from "./keyed-diff.js";
+export { transition } from "./transitions.js";
+export type { TransitionOptions } from "./transitions.js";
+export { portal, portalOutlet, createPortalOutlet, provideOutlet, injectOutlet } from "./portal.js";
+export { createErrorBoundary } from "./error-boundary.js";

package/dist/lib/elur/template/index.d.ts

@@ -0,0 +1,15 @@
+export type { ElurTemplate, ElurMountHandle, ElurRef, KeyedList, KEntry, PortalOutlet, ErrorFallback, TransitionContent, TemplateBindingContext, TemplateDescriptor, ElurRenderProtocol, ServerRenderProtocolContext, DomProtocolContext, HydrationProtocolContext } from "./types.js";
+export { ref, isElurTemplate, isKeyedList, COMMENT, ELUR_TEMPLATE_DESCRIPTOR, ELUR_RENDER_PROTOCOL, templateFeatures } from "./types.js";
+export { html, buildHTML } from "./html.js";
+export { raw } from "./raw.js";
+export { showWhen } from "./bindings.js";
+export { _activateBindingsWithNodes, activateDelegatedEvent as _activateDelegatedEvent, _ensureDelegatedEvent, _setDelegatedEvent, } from "./bindings.js";
+export { activateNodeBinding as _activateNodeBinding } from "./node-binding.js";
+export { queueDOMWrite as _queueDOMWrite } from "./dom-write.js";
+export { sanitizeUrl, isUrlAttrName, isExecutableAttrName } from "./sanitize.js";
+export { repeat, getSequence as _getKeyedSequence } from "./keyed.js";
+export { createKeyedMount as _createKeyedMount, reconcileKeyedList as _reconcileKeyedList, } from "./keyed-diff.js";
+export { transition } from "./transitions.js";
+export type { TransitionOptions } from "./transitions.js";
+export { portal, portalOutlet, createPortalOutlet, provideOutlet, injectOutlet } from "./portal.js";
+export { createErrorBoundary } from "./error-boundary.js";

package/dist/lib/elur/template/index.js

@@ -0,0 +1,13 @@
+import { COMMENT as e, ELUR_RENDER_PROTOCOL as t, ELUR_TEMPLATE_DESCRIPTOR as n, isElurTemplate as r, isKeyedList as i, ref as a, templateFeatures as o } from "./elur/template/types.js";
+import { getSequence as s, repeat as c } from "./elur/template/keyed.js";
+import { createKeyedMount as l, reconcileKeyedList as u } from "./elur/template/keyed-diff.js";
+import { queueDOMWrite as d } from "./elur/template/dom-write.js";
+import { activateNodeBinding as f } from "./elur/template/node-binding.js";
+import { isExecutableAttrName as p, isUrlAttrName as m, sanitizeUrl as h } from "./elur/template/sanitize.js";
+import { _activateBindingsWithNodes as g, _ensureDelegatedEvent as _, _setDelegatedEvent as v, activateDelegatedEvent as y, showWhen as b } from "./elur/template/bindings.js";
+import { buildHTML as x, html as S } from "./elur/template/html.js";
+import { raw as C } from "./elur/template/raw.js";
+import { transition as w } from "./elur/template/transitions.js";
+import { createPortalOutlet as T, injectOutlet as E, portal as D, portalOutlet as O, provideOutlet as k } from "./elur/template/portal.js";
+import { createErrorBoundary as A } from "./elur/template/error-boundary.js";
+export { e as COMMENT, t as ELUR_RENDER_PROTOCOL, n as ELUR_TEMPLATE_DESCRIPTOR, g as _activateBindingsWithNodes, y as _activateDelegatedEvent, f as _activateNodeBinding, l as _createKeyedMount, _ as _ensureDelegatedEvent, s as _getKeyedSequence, d as _queueDOMWrite, u as _reconcileKeyedList, v as _setDelegatedEvent, x as buildHTML, A as createErrorBoundary, T as createPortalOutlet, S as html, E as injectOutlet, r as isElurTemplate, p as isExecutableAttrName, i as isKeyedList, m as isUrlAttrName, D as portal, O as portalOutlet, k as provideOutlet, C as raw, a as ref, c as repeat, h as sanitizeUrl, b as showWhen, o as templateFeatures, w as transition };

package/dist/lib/elur/template/keyed-diff.cjs

@@ -0,0 +1,2 @@
+const e=require(`../../signals.cjs`),t=require(`./types.cjs`),n=require(`../../lifecycle.cjs`),r=require(`./mount-helpers.cjs`),i=require(`./keyed.cjs`);function a(e){return(i,a,o)=>{if(n.isElurComponent(i))return r._mountComponentWithCtx(i,a,o,e);if(t.isElurTemplate(i))return i._render(a,o);if(i!=null&&i!==!1){let e=document.createTextNode(String(i));return a.insertBefore(e,o),()=>e.parentNode?.removeChild(e)}return()=>{}}}function o(t){let{zoneStart:n,anchor:r,state:a,prevOrder:o,list:s,mount:c}=t,l=r.parentNode;if(!l)return;let u=s.items.map((e,t)=>s.keyFn(e,t)),d=new Set(u),f=!1;if(a.size>0){for(let e of a.keys())if(d.has(e)){f=!0;break}}if(!f){if(a.size>0){let e=document.createRange();e.setStartAfter(n),e.setEndBefore(r),e.deleteContents();for(let e of a.values())e.cleanup();a.clear()}if(u.length>0){let n=document.createDocumentFragment();e.batch(()=>{for(let e=0;e<u.length;e++){let r=u[e],i=s.items[e],o=document.createTextNode(``),l=document.createTextNode(``);n.appendChild(o),n.appendChild(l);let d=c(s.renderFn(i,e),n,l);a.has(r)&&t.onDuplicateKey?.(r),a.set(r,{start:o,end:l,cleanup:d})}}),l.insertBefore(n,r)}o.length=0,o.push(...u);return}let p=new Map;for(let e=0;e<u.length;e++)p.set(u[e],e);let m=new Int32Array(u.length),h=!1,g=0;for(let e=0;e<o.length;e++){let t=o[e],n=p.get(t);if(n===void 0){let e=a.get(t);e.cleanup();let n=e.start;for(;n;){let t=n===e.end?null:n.nextSibling;if(n.parentNode?.removeChild(n),!t)break;n=t}a.delete(t)}else m[n]=e+1,n>=g?g=n:h=!0}let _=h?i.getSequence(m):[],v=_.length-1,y=r;for(let e=u.length-1;e>=0;e--){let n=u[e];if(m[e]===0){let r=s.items[e],i=document.createTextNode(``),o=document.createTextNode(``),u=document.createDocumentFragment();u.appendChild(i),u.appendChild(o);let d=c(s.renderFn(r,e),u,o);a.has(n)&&t.onDuplicateKey?.(n),a.set(n,{start:i,end:o,cleanup:d}),l.insertBefore(u,y),y=i}else{let t=a.get(n);if(h)if(v<0||e!==_[v]){let e=t.start;for(;e;){let n=e===t.end?null:e.nextSibling;if(l.insertBefore(e,y),!n)break;e=n}}else v--;y=t.start}}o.length=0,o.push(...u)}exports.createKeyedMount=a,exports.reconcileKeyedList=o;
+//# sourceMappingURL=keyed-diff.cjs.map

package/dist/lib/elur/template/keyed-diff.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-diff.cjs","names":[],"sources":["../../../../src/elur/template/keyed-diff.ts"],"sourcesContent":["import { batch } from \"../reactivity.js\";\nimport { isElurComponent } from \"../lifecycle.js\";\nimport { _mountComponentWithCtx } from \"./mount-helpers.js\";\nimport { isElurTemplate, type KEntry, type KeyedList } from \"./types.js\";\nimport { getSequence, type RepeatKey } from \"./keyed.js\";\n\n// =============================================================================\n// --- Shared keyed list reconciliation (mount + hydrate) ---\n// =============================================================================\n\n/**\n * Mounts a single keyed item's rendered value before `endMarker` inside `parent`.\n * Used by the DOM renderer and the hydration renderer so both engines share the\n * exact same reconciliation semantics.\n */\nexport function createKeyedMount(\n    ctxSnapshot: Map<unknown, unknown>[],\n): (rendered: unknown, parent: Node, endMarker: Node) => () => void {\n    return (rendered: unknown, parent: Node, endMarker: Node): (() => void) => {\n        if (isElurComponent(rendered)) {\n            return _mountComponentWithCtx(rendered, parent, endMarker, ctxSnapshot);\n        }\n        if (isElurTemplate(rendered)) {\n            return rendered._render(parent, endMarker);\n        }\n        if (rendered != null && rendered !== false) {\n            const node = document.createTextNode(String(rendered));\n            parent.insertBefore(node, endMarker);\n            return () => node.parentNode?.removeChild(node);\n        }\n        return () => { };\n    };\n}\n\nexport interface KeyedDiffOptions {\n    /** Node marking the start of the keyed zone. */\n    zoneStart: Node;\n    /** End boundary; new content is inserted before this node. */\n    anchor: Node;\n    /** Live map of key → entry (start/end markers + cleanup). */\n    state: Map<RepeatKey, KEntry>;\n    /** Key order from the previous reconciliation pass. */\n    prevOrder: RepeatKey[];\n    /** The current keyed list value. */\n    list: KeyedList;\n    /** Mounts a freshly rendered item into the DOM. */\n    mount: (rendered: unknown, parent: Node, endMarker: Node) => () => void;\n    /** Context snapshot for component mounts inside the effect. */\n    ctxSnapshot?: Map<unknown, unknown>[];\n    /** Called when a duplicate key is encountered. */\n    onDuplicateKey?: (key: RepeatKey) => void;\n}\n\n/**\n * Reconciles a keyed list between `zoneStart` and `anchor` using the same LIS\n * algorithm used by the DOM renderer. Total replacement (O(1)) when no key\n * survives; otherwise remove/insert/move with minimal DOM operations.\n */\nexport function reconcileKeyedList(opts: KeyedDiffOptions): void {\n    const { zoneStart, anchor, state, prevOrder, list, mount } = opts;\n    const parent = anchor.parentNode;\n    if (!parent) return;\n\n    const newKeyOrder: RepeatKey[] = list.items.map((item, idx) => list.keyFn(item as never, idx));\n    const newKeySet = new Set(newKeyOrder);\n\n    let anyKeysSurvive = false;\n    if (state.size > 0) {\n        for (const k of state.keys()) {\n            if (newKeySet.has(k)) {\n                anyKeysSurvive = true;\n                break;\n            }\n        }\n    }\n\n    // 1. Initial render or total replacement (O(1) path)\n    if (!anyKeysSurvive) {\n        if (state.size > 0) {\n            const range = document.createRange();\n            range.setStartAfter(zoneStart);\n            range.setEndBefore(anchor);\n            range.deleteContents();\n            for (const entry of state.values()) entry.cleanup();\n            state.clear();\n        }\n\n        if (newKeyOrder.length > 0) {\n            const frag = document.createDocumentFragment();\n            batch(() => {\n                for (let i = 0; i < newKeyOrder.length; i++) {\n                    const key = newKeyOrder[i];\n                    const item = list.items[i];\n                    const start = document.createTextNode(\"\") as unknown as Comment;\n                    const end = document.createTextNode(\"\") as unknown as Comment;\n\n                    frag.appendChild(start);\n                    frag.appendChild(end);\n\n                    const rendered = list.renderFn(item as never, i);\n                    const cleanup = mount(rendered, frag, end);\n\n                    if (state.has(key)) opts.onDuplicateKey?.(key);\n                    state.set(key, { start, end, cleanup });\n                }\n            });\n            parent.insertBefore(frag, anchor);\n        }\n        prevOrder.length = 0;\n        prevOrder.push(...newKeyOrder);\n        return;\n    }\n\n    // 2. Reconciliation with LIS\n    const keyToNewIndex = new Map<RepeatKey, number>();\n    for (let i = 0; i < newKeyOrder.length; i++) {\n        keyToNewIndex.set(newKeyOrder[i], i);\n    }\n\n    const newIndexToOldIndexMap = new Int32Array(newKeyOrder.length);\n    let moved = false;\n    let maxNewIndexSoFar = 0;\n\n    for (let i = 0; i < prevOrder.length; i++) {\n        const key = prevOrder[i];\n        const newIndex = keyToNewIndex.get(key);\n\n        if (newIndex === undefined) {\n            const entry = state.get(key)!;\n            entry.cleanup();\n            let node: Node | null = entry.start;\n            while (node) {\n                const next: ChildNode | null = node === entry.end ? null : node.nextSibling;\n                node.parentNode?.removeChild(node);\n                if (!next) break;\n                node = next;\n            }\n            state.delete(key);\n        } else {\n            newIndexToOldIndexMap[newIndex] = i + 1;\n            if (newIndex >= maxNewIndexSoFar) {\n                maxNewIndexSoFar = newIndex;\n            } else {\n                moved = true;\n            }\n        }\n    }\n\n    const increasingNewIndexSequence = moved ? getSequence(newIndexToOldIndexMap) : [];\n    let j = increasingNewIndexSequence.length - 1;\n    let insertionPoint: Node = anchor;\n\n    for (let i = newKeyOrder.length - 1; i >= 0; i--) {\n        const key = newKeyOrder[i];\n        const isNew = newIndexToOldIndexMap[i] === 0;\n\n        if (isNew) {\n            const it = list.items[i];\n            const sMarker = document.createTextNode(\"\") as unknown as Comment;\n            const eMarker = document.createTextNode(\"\") as unknown as Comment;\n            const frag = document.createDocumentFragment();\n\n            frag.appendChild(sMarker);\n            frag.appendChild(eMarker);\n\n            const rendered = list.renderFn(it as never, i);\n            const cleanup = mount(rendered, frag, eMarker);\n\n            if (state.has(key)) opts.onDuplicateKey?.(key);\n            state.set(key, { start: sMarker, end: eMarker, cleanup });\n            parent.insertBefore(frag, insertionPoint);\n            insertionPoint = sMarker;\n        } else {\n            const entry = state.get(key)!;\n            if (moved) {\n                if (j < 0 || i !== increasingNewIndexSequence[j]) {\n                    let node: Node | null = entry.start;\n                    while (node) {\n                        const next: ChildNode | null = node === entry.end ? null : node.nextSibling;\n                        parent.insertBefore(node, insertionPoint);\n                        if (!next) break;\n                        node = next;\n                    }\n                } else {\n                    j--;\n                }\n            }\n            insertionPoint = entry.start;\n        }\n    }\n\n    prevOrder.length = 0;\n    prevOrder.push(...newKeyOrder);\n}"],"mappings":"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"}

package/dist/lib/elur/template/keyed-diff.d.cts

@@ -0,0 +1,32 @@
+import { type KEntry, type KeyedList } from "./types.js";
+import { type RepeatKey } from "./keyed.js";
+/**
+ * Mounts a single keyed item's rendered value before `endMarker` inside `parent`.
+ * Used by the DOM renderer and the hydration renderer so both engines share the
+ * exact same reconciliation semantics.
+ */
+export declare function createKeyedMount(ctxSnapshot: Map<unknown, unknown>[]): (rendered: unknown, parent: Node, endMarker: Node) => () => void;
+export interface KeyedDiffOptions {
+    /** Node marking the start of the keyed zone. */
+    zoneStart: Node;
+    /** End boundary; new content is inserted before this node. */
+    anchor: Node;
+    /** Live map of key → entry (start/end markers + cleanup). */
+    state: Map<RepeatKey, KEntry>;
+    /** Key order from the previous reconciliation pass. */
+    prevOrder: RepeatKey[];
+    /** The current keyed list value. */
+    list: KeyedList;
+    /** Mounts a freshly rendered item into the DOM. */
+    mount: (rendered: unknown, parent: Node, endMarker: Node) => () => void;
+    /** Context snapshot for component mounts inside the effect. */
+    ctxSnapshot?: Map<unknown, unknown>[];
+    /** Called when a duplicate key is encountered. */
+    onDuplicateKey?: (key: RepeatKey) => void;
+}
+/**
+ * Reconciles a keyed list between `zoneStart` and `anchor` using the same LIS
+ * algorithm used by the DOM renderer. Total replacement (O(1)) when no key
+ * survives; otherwise remove/insert/move with minimal DOM operations.
+ */
+export declare function reconcileKeyedList(opts: KeyedDiffOptions): void;

package/dist/lib/elur/template/keyed-diff.d.ts

@@ -0,0 +1,32 @@
+import { type KEntry, type KeyedList } from "./types.js";
+import { type RepeatKey } from "./keyed.js";
+/**
+ * Mounts a single keyed item's rendered value before `endMarker` inside `parent`.
+ * Used by the DOM renderer and the hydration renderer so both engines share the
+ * exact same reconciliation semantics.
+ */
+export declare function createKeyedMount(ctxSnapshot: Map<unknown, unknown>[]): (rendered: unknown, parent: Node, endMarker: Node) => () => void;
+export interface KeyedDiffOptions {
+    /** Node marking the start of the keyed zone. */
+    zoneStart: Node;
+    /** End boundary; new content is inserted before this node. */
+    anchor: Node;
+    /** Live map of key → entry (start/end markers + cleanup). */
+    state: Map<RepeatKey, KEntry>;
+    /** Key order from the previous reconciliation pass. */
+    prevOrder: RepeatKey[];
+    /** The current keyed list value. */
+    list: KeyedList;
+    /** Mounts a freshly rendered item into the DOM. */
+    mount: (rendered: unknown, parent: Node, endMarker: Node) => () => void;
+    /** Context snapshot for component mounts inside the effect. */
+    ctxSnapshot?: Map<unknown, unknown>[];
+    /** Called when a duplicate key is encountered. */
+    onDuplicateKey?: (key: RepeatKey) => void;
+}
+/**
+ * Reconciles a keyed list between `zoneStart` and `anchor` using the same LIS
+ * algorithm used by the DOM renderer. Total replacement (O(1)) when no key
+ * survives; otherwise remove/insert/move with minimal DOM operations.
+ */
+export declare function reconcileKeyedList(opts: KeyedDiffOptions): void;

package/dist/lib/elur/template/keyed-diff.js

@@ -0,0 +1,100 @@
+import { batch as e } from "../../signals.js";
+import { isElurTemplate as t } from "./types.js";
+import { isElurComponent as n } from "../../lifecycle.js";
+import { _mountComponentWithCtx as r } from "./mount-helpers.js";
+import { getSequence as i } from "./keyed.js";
+//#region src/elur/template/keyed-diff.ts
+function a(e) {
+	return (i, a, o) => {
+		if (n(i)) return r(i, a, o, e);
+		if (t(i)) return i._render(a, o);
+		if (i != null && i !== !1) {
+			let e = document.createTextNode(String(i));
+			return a.insertBefore(e, o), () => e.parentNode?.removeChild(e);
+		}
+		return () => {};
+	};
+}
+function o(t) {
+	let { zoneStart: n, anchor: r, state: a, prevOrder: o, list: s, mount: c } = t, l = r.parentNode;
+	if (!l) return;
+	let u = s.items.map((e, t) => s.keyFn(e, t)), d = new Set(u), f = !1;
+	if (a.size > 0) {
+		for (let e of a.keys()) if (d.has(e)) {
+			f = !0;
+			break;
+		}
+	}
+	if (!f) {
+		if (a.size > 0) {
+			let e = document.createRange();
+			e.setStartAfter(n), e.setEndBefore(r), e.deleteContents();
+			for (let e of a.values()) e.cleanup();
+			a.clear();
+		}
+		if (u.length > 0) {
+			let n = document.createDocumentFragment();
+			e(() => {
+				for (let e = 0; e < u.length; e++) {
+					let r = u[e], i = s.items[e], o = document.createTextNode(""), l = document.createTextNode("");
+					n.appendChild(o), n.appendChild(l);
+					let d = c(s.renderFn(i, e), n, l);
+					a.has(r) && t.onDuplicateKey?.(r), a.set(r, {
+						start: o,
+						end: l,
+						cleanup: d
+					});
+				}
+			}), l.insertBefore(n, r);
+		}
+		o.length = 0, o.push(...u);
+		return;
+	}
+	let p = /* @__PURE__ */ new Map();
+	for (let e = 0; e < u.length; e++) p.set(u[e], e);
+	let m = new Int32Array(u.length), h = !1, g = 0;
+	for (let e = 0; e < o.length; e++) {
+		let t = o[e], n = p.get(t);
+		if (n === void 0) {
+			let e = a.get(t);
+			e.cleanup();
+			let n = e.start;
+			for (; n;) {
+				let t = n === e.end ? null : n.nextSibling;
+				if (n.parentNode?.removeChild(n), !t) break;
+				n = t;
+			}
+			a.delete(t);
+		} else m[n] = e + 1, n >= g ? g = n : h = !0;
+	}
+	let _ = h ? i(m) : [], v = _.length - 1, y = r;
+	for (let e = u.length - 1; e >= 0; e--) {
+		let n = u[e];
+		if (m[e] === 0) {
+			let r = s.items[e], i = document.createTextNode(""), o = document.createTextNode(""), u = document.createDocumentFragment();
+			u.appendChild(i), u.appendChild(o);
+			let d = c(s.renderFn(r, e), u, o);
+			a.has(n) && t.onDuplicateKey?.(n), a.set(n, {
+				start: i,
+				end: o,
+				cleanup: d
+			}), l.insertBefore(u, y), y = i;
+		} else {
+			let t = a.get(n);
+			if (h) if (v < 0 || e !== _[v]) {
+				let e = t.start;
+				for (; e;) {
+					let n = e === t.end ? null : e.nextSibling;
+					if (l.insertBefore(e, y), !n) break;
+					e = n;
+				}
+			} else v--;
+			y = t.start;
+		}
+	}
+	o.length = 0, o.push(...u);
+}
+//#endregion
+export { a as createKeyedMount, o as reconcileKeyedList };
+
+//# sourceMappingURL=keyed-diff.js.map

package/dist/lib/elur/template/keyed-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-diff.js","names":[],"sources":["../../../../src/elur/template/keyed-diff.ts"],"sourcesContent":["import { batch } from \"../reactivity.js\";\nimport { isElurComponent } from \"../lifecycle.js\";\nimport { _mountComponentWithCtx } from \"./mount-helpers.js\";\nimport { isElurTemplate, type KEntry, type KeyedList } from \"./types.js\";\nimport { getSequence, type RepeatKey } from \"./keyed.js\";\n\n// =============================================================================\n// --- Shared keyed list reconciliation (mount + hydrate) ---\n// =============================================================================\n\n/**\n * Mounts a single keyed item's rendered value before `endMarker` inside `parent`.\n * Used by the DOM renderer and the hydration renderer so both engines share the\n * exact same reconciliation semantics.\n */\nexport function createKeyedMount(\n    ctxSnapshot: Map<unknown, unknown>[],\n): (rendered: unknown, parent: Node, endMarker: Node) => () => void {\n    return (rendered: unknown, parent: Node, endMarker: Node): (() => void) => {\n        if (isElurComponent(rendered)) {\n            return _mountComponentWithCtx(rendered, parent, endMarker, ctxSnapshot);\n        }\n        if (isElurTemplate(rendered)) {\n            return rendered._render(parent, endMarker);\n        }\n        if (rendered != null && rendered !== false) {\n            const node = document.createTextNode(String(rendered));\n            parent.insertBefore(node, endMarker);\n            return () => node.parentNode?.removeChild(node);\n        }\n        return () => { };\n    };\n}\n\nexport interface KeyedDiffOptions {\n    /** Node marking the start of the keyed zone. */\n    zoneStart: Node;\n    /** End boundary; new content is inserted before this node. */\n    anchor: Node;\n    /** Live map of key → entry (start/end markers + cleanup). */\n    state: Map<RepeatKey, KEntry>;\n    /** Key order from the previous reconciliation pass. */\n    prevOrder: RepeatKey[];\n    /** The current keyed list value. */\n    list: KeyedList;\n    /** Mounts a freshly rendered item into the DOM. */\n    mount: (rendered: unknown, parent: Node, endMarker: Node) => () => void;\n    /** Context snapshot for component mounts inside the effect. */\n    ctxSnapshot?: Map<unknown, unknown>[];\n    /** Called when a duplicate key is encountered. */\n    onDuplicateKey?: (key: RepeatKey) => void;\n}\n\n/**\n * Reconciles a keyed list between `zoneStart` and `anchor` using the same LIS\n * algorithm used by the DOM renderer. Total replacement (O(1)) when no key\n * survives; otherwise remove/insert/move with minimal DOM operations.\n */\nexport function reconcileKeyedList(opts: KeyedDiffOptions): void {\n    const { zoneStart, anchor, state, prevOrder, list, mount } = opts;\n    const parent = anchor.parentNode;\n    if (!parent) return;\n\n    const newKeyOrder: RepeatKey[] = list.items.map((item, idx) => list.keyFn(item as never, idx));\n    const newKeySet = new Set(newKeyOrder);\n\n    let anyKeysSurvive = false;\n    if (state.size > 0) {\n        for (const k of state.keys()) {\n            if (newKeySet.has(k)) {\n                anyKeysSurvive = true;\n                break;\n            }\n        }\n    }\n\n    // 1. Initial render or total replacement (O(1) path)\n    if (!anyKeysSurvive) {\n        if (state.size > 0) {\n            const range = document.createRange();\n            range.setStartAfter(zoneStart);\n            range.setEndBefore(anchor);\n            range.deleteContents();\n            for (const entry of state.values()) entry.cleanup();\n            state.clear();\n        }\n\n        if (newKeyOrder.length > 0) {\n            const frag = document.createDocumentFragment();\n            batch(() => {\n                for (let i = 0; i < newKeyOrder.length; i++) {\n                    const key = newKeyOrder[i];\n                    const item = list.items[i];\n                    const start = document.createTextNode(\"\") as unknown as Comment;\n                    const end = document.createTextNode(\"\") as unknown as Comment;\n\n                    frag.appendChild(start);\n                    frag.appendChild(end);\n\n                    const rendered = list.renderFn(item as never, i);\n                    const cleanup = mount(rendered, frag, end);\n\n                    if (state.has(key)) opts.onDuplicateKey?.(key);\n                    state.set(key, { start, end, cleanup });\n                }\n            });\n            parent.insertBefore(frag, anchor);\n        }\n        prevOrder.length = 0;\n        prevOrder.push(...newKeyOrder);\n        return;\n    }\n\n    // 2. Reconciliation with LIS\n    const keyToNewIndex = new Map<RepeatKey, number>();\n    for (let i = 0; i < newKeyOrder.length; i++) {\n        keyToNewIndex.set(newKeyOrder[i], i);\n    }\n\n    const newIndexToOldIndexMap = new Int32Array(newKeyOrder.length);\n    let moved = false;\n    let maxNewIndexSoFar = 0;\n\n    for (let i = 0; i < prevOrder.length; i++) {\n        const key = prevOrder[i];\n        const newIndex = keyToNewIndex.get(key);\n\n        if (newIndex === undefined) {\n            const entry = state.get(key)!;\n            entry.cleanup();\n            let node: Node | null = entry.start;\n            while (node) {\n                const next: ChildNode | null = node === entry.end ? null : node.nextSibling;\n                node.parentNode?.removeChild(node);\n                if (!next) break;\n                node = next;\n            }\n            state.delete(key);\n        } else {\n            newIndexToOldIndexMap[newIndex] = i + 1;\n            if (newIndex >= maxNewIndexSoFar) {\n                maxNewIndexSoFar = newIndex;\n            } else {\n                moved = true;\n            }\n        }\n    }\n\n    const increasingNewIndexSequence = moved ? getSequence(newIndexToOldIndexMap) : [];\n    let j = increasingNewIndexSequence.length - 1;\n    let insertionPoint: Node = anchor;\n\n    for (let i = newKeyOrder.length - 1; i >= 0; i--) {\n        const key = newKeyOrder[i];\n        const isNew = newIndexToOldIndexMap[i] === 0;\n\n        if (isNew) {\n            const it = list.items[i];\n            const sMarker = document.createTextNode(\"\") as unknown as Comment;\n            const eMarker = document.createTextNode(\"\") as unknown as Comment;\n            const frag = document.createDocumentFragment();\n\n            frag.appendChild(sMarker);\n            frag.appendChild(eMarker);\n\n            const rendered = list.renderFn(it as never, i);\n            const cleanup = mount(rendered, frag, eMarker);\n\n            if (state.has(key)) opts.onDuplicateKey?.(key);\n            state.set(key, { start: sMarker, end: eMarker, cleanup });\n            parent.insertBefore(frag, insertionPoint);\n            insertionPoint = sMarker;\n        } else {\n            const entry = state.get(key)!;\n            if (moved) {\n                if (j < 0 || i !== increasingNewIndexSequence[j]) {\n                    let node: Node | null = entry.start;\n                    while (node) {\n                        const next: ChildNode | null = node === entry.end ? null : node.nextSibling;\n                        parent.insertBefore(node, insertionPoint);\n                        if (!next) break;\n                        node = next;\n                    }\n                } else {\n                    j--;\n                }\n            }\n            insertionPoint = entry.start;\n        }\n    }\n\n    prevOrder.length = 0;\n    prevOrder.push(...newKeyOrder);\n}"],"mappings":"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"}

package/dist/lib/elur/template/keyed.cjs

@@ -0,0 +1,2 @@
+function e(e,t,n){return{__isKeyedList:!0,items:e,keyFn:t,renderFn:n}}function t(e,t){return typeof e==`string`||typeof e==`number`?e:(console.warn(`[elur] repeat(): key at index ${t} is not a string or number (got ${typeof e}); using positional fallback. Non-serializable keys cannot preserve identity across SSR/hydration.`),`__elur-key:${t}`)}function n(e){let t=new TextEncoder().encode(e),n=``;for(let e=0;e<t.length;e+=32768)n+=String.fromCharCode(...t.subarray(e,e+32768));return btoa(n)}function r(e){let t=atob(e),n=new Uint8Array(t.length);for(let e=0;e<t.length;e++)n[e]=t.charCodeAt(e);return new TextDecoder().decode(n)}function i(e){return n(JSON.stringify(e))}function a(e){try{let t=JSON.parse(r(e));if(typeof t==`string`||typeof t==`number`)return t}catch{}return e}function o(e){let t=e.slice(),n=[0],r,i,a,o,s,c=e.length;for(r=0;r<c;r++){let c=e[r];if(c!==0){if(i=n[n.length-1],e[i]<c){t[r]=i,n.push(r);continue}for(a=0,o=n.length-1;a<o;)s=a+o>>1,e[n[s]]<c?a=s+1:o=s;c<e[n[a]]&&(a>0&&(t[r]=n[a-1]),n[a]=r)}}for(a=n.length,o=n[a-1];a-- >0;)n[a]=o,o=t[o];return n}exports.deserializeRepeatKey=a,exports.getSequence=o,exports.normalizeRepeatKey=t,exports.repeat=e,exports.serializeRepeatKey=i;
+//# sourceMappingURL=keyed.cjs.map

package/dist/lib/elur/template/keyed.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed.cjs","names":[],"sources":["../../../../src/elur/template/keyed.ts"],"sourcesContent":["import type { ElurTemplate, KeyedList, KEntry } from \"./types.js\";\nimport type { ElurComponent } from \"../lifecycle.js\";\n\n// =============================================================================\n// --- repeat() ---\n// =============================================================================\n\n/**\n * Creates a keyed list for efficient DOM reconciliation.\n * Use instead of `.map()` when the list changes frequently.\n */\nexport function repeat<T>(\n    items: T[],\n    keyFn: (item: T, index: number) => string | number,\n    renderFn: (item: T, index: number) => ElurTemplate | ElurComponent\n): KeyedList<T> {\n    return { __isKeyedList: true as const, items, keyFn, renderFn };\n}\n\n// =============================================================================\n// --- Key serialization for SSR/hydration markers ---\n// =============================================================================\n\nexport type RepeatKey = string | number;\n\n/**\n * Normalizes a repeat() key to a serializable form. Keys must be strings or\n * numbers to preserve identity across SSR/hydration. Anything else produces a\n * diagnostic warning and a deterministic positional fallback so that server\n * and client agree without silent `String(key)` collisions.\n */\nexport function normalizeRepeatKey(key: unknown, index: number): RepeatKey {\n    if (typeof key === \"string\" || typeof key === \"number\") return key;\n    console.warn(\n        `[elur] repeat(): key at index ${index} is not a string or number (got ${typeof key}); ` +\n            `using positional fallback. Non-serializable keys cannot preserve identity across SSR/hydration.`,\n    );\n    return `__elur-key:${index}`;\n}\n\nexport function utf8ToBase64(value: string): string {\n    const bytes = new TextEncoder().encode(value);\n    let binary = \"\";\n    for (let i = 0; i < bytes.length; i += 0x8000) {\n        binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n    }\n    return btoa(binary);\n}\n\nexport function utf8FromBase64(value: string): string {\n    const binary = atob(value);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n    return new TextDecoder().decode(bytes);\n}\n\n/** Serializes a repeat() key for the SSR keyed marker (base64 JSON, safe for HTML comments). */\nexport function serializeRepeatKey(key: RepeatKey): string {\n    return utf8ToBase64(JSON.stringify(key));\n}\n\n/** Decodes a repeat() key from a keyed hydration marker. */\nexport function deserializeRepeatKey(serialized: string): RepeatKey {\n    try {\n        const parsed: unknown = JSON.parse(utf8FromBase64(serialized));\n        if (typeof parsed === \"string\" || typeof parsed === \"number\") return parsed;\n    } catch {\n        // fall through\n    }\n    return serialized;\n}\n\n// =============================================================================\n// --- Longest Increasing Subsequence (LIS) ---\n// =============================================================================\n\n/**\n * Returns the indices of the Longest Increasing Subsequence.\n * Used to minimize DOM operations during list diffing.\n */\nexport function getSequence(arr: Int32Array | number[]): number[] {\n    const p = arr.slice();\n    const result = [0];\n    let i, j, u, v, c;\n    const len = arr.length;\n    for (i = 0; i < len; i++) {\n        const arrI = arr[i];\n        if (arrI !== 0) {\n            j = result[result.length - 1];\n            if (arr[j] < arrI) {\n                p[i] = j;\n                result.push(i);\n                continue;\n            }\n            u = 0;\n            v = result.length - 1;\n            while (u < v) {\n                c = (u + v) >> 1;\n                if (arr[result[c]] < arrI) {\n                    u = c + 1;\n                } else {\n                    v = c;\n                }\n            }\n            if (arrI < arr[result[u]]) {\n                if (u > 0) {\n                    p[i] = result[u - 1];\n                }\n                result[u] = i;\n            }\n        }\n    }\n    u = result.length;\n    v = result[u - 1];\n    while (u-- > 0) {\n        result[u] = v;\n        v = p[v];\n    }\n    return result;\n}\n\nexport type { KEntry };\n"],"mappings":"AAWA,SAAgB,EACZ,EACA,EACA,EACY,CACZ,MAAO,CAAE,cAAe,GAAe,QAAO,QAAO,WAAU,CAenE,SAAgB,EAAmB,EAAc,EAA0B,CAMvE,OALI,OAAO,GAAQ,UAAY,OAAO,GAAQ,SAAiB,GAC/D,QAAQ,KACJ,iCAAiC,EAAM,kCAAkC,OAAO,EAAI,oGAEvF,CACM,cAAc,KAGzB,SAAgB,EAAa,EAAuB,CAChD,IAAM,EAAQ,IAAI,aAAa,CAAC,OAAO,EAAM,CACzC,EAAS,GACb,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAQ,GAAK,MACnC,GAAU,OAAO,aAAa,GAAG,EAAM,SAAS,EAAG,EAAI,MAAO,CAAC,CAEnE,OAAO,KAAK,EAAO,CAGvB,SAAgB,EAAe,EAAuB,CAClD,IAAM,EAAS,KAAK,EAAM,CACpB,EAAQ,IAAI,WAAW,EAAO,OAAO,CAC3C,IAAK,IAAI,EAAI,EAAG,EAAI,EAAO,OAAQ,IAAK,EAAM,GAAK,EAAO,WAAW,EAAE,CACvE,OAAO,IAAI,aAAa,CAAC,OAAO,EAAM,CAI1C,SAAgB,EAAmB,EAAwB,CACvD,OAAO,EAAa,KAAK,UAAU,EAAI,CAAC,CAI5C,SAAgB,EAAqB,EAA+B,CAChE,GAAI,CACA,IAAM,EAAkB,KAAK,MAAM,EAAe,EAAW,CAAC,CAC9D,GAAI,OAAO,GAAW,UAAY,OAAO,GAAW,SAAU,OAAO,OACjE,EAGR,OAAO,EAWX,SAAgB,EAAY,EAAsC,CAC9D,IAAM,EAAI,EAAI,OAAO,CACf,EAAS,CAAC,EAAE,CACd,EAAG,EAAG,EAAG,EAAG,EACV,EAAM,EAAI,OAChB,IAAK,EAAI,EAAG,EAAI,EAAK,IAAK,CACtB,IAAM,EAAO,EAAI,GACjB,GAAI,IAAS,EAAG,CAEZ,GADA,EAAI,EAAO,EAAO,OAAS,GACvB,EAAI,GAAK,EAAM,CACf,EAAE,GAAK,EACP,EAAO,KAAK,EAAE,CACd,SAIJ,IAFA,EAAI,EACJ,EAAI,EAAO,OAAS,EACb,EAAI,GACP,EAAK,EAAI,GAAM,EACX,EAAI,EAAO,IAAM,EACjB,EAAI,EAAI,EAER,EAAI,EAGR,EAAO,EAAI,EAAO,MACd,EAAI,IACJ,EAAE,GAAK,EAAO,EAAI,IAEtB,EAAO,GAAK,IAMxB,IAFA,EAAI,EAAO,OACX,EAAI,EAAO,EAAI,GACR,KAAM,GACT,EAAO,GAAK,EACZ,EAAI,EAAE,GAEV,OAAO"}

package/dist/lib/elur/template/keyed.d.cts

@@ -0,0 +1,27 @@
+import type { ElurTemplate, KeyedList, KEntry } from "./types.js";
+import type { ElurComponent } from "../lifecycle.js";
+/**
+ * Creates a keyed list for efficient DOM reconciliation.
+ * Use instead of `.map()` when the list changes frequently.
+ */
+export declare function repeat<T>(items: T[], keyFn: (item: T, index: number) => string | number, renderFn: (item: T, index: number) => ElurTemplate | ElurComponent): KeyedList<T>;
+export type RepeatKey = string | number;
+/**
+ * Normalizes a repeat() key to a serializable form. Keys must be strings or
+ * numbers to preserve identity across SSR/hydration. Anything else produces a
+ * diagnostic warning and a deterministic positional fallback so that server
+ * and client agree without silent `String(key)` collisions.
+ */
+export declare function normalizeRepeatKey(key: unknown, index: number): RepeatKey;
+export declare function utf8ToBase64(value: string): string;
+export declare function utf8FromBase64(value: string): string;
+/** Serializes a repeat() key for the SSR keyed marker (base64 JSON, safe for HTML comments). */
+export declare function serializeRepeatKey(key: RepeatKey): string;
+/** Decodes a repeat() key from a keyed hydration marker. */
+export declare function deserializeRepeatKey(serialized: string): RepeatKey;
+/**
+ * Returns the indices of the Longest Increasing Subsequence.
+ * Used to minimize DOM operations during list diffing.
+ */
+export declare function getSequence(arr: Int32Array | number[]): number[];
+export type { KEntry };

package/dist/lib/elur/template/keyed.d.ts

@@ -0,0 +1,27 @@
+import type { ElurTemplate, KeyedList, KEntry } from "./types.js";
+import type { ElurComponent } from "../lifecycle.js";
+/**
+ * Creates a keyed list for efficient DOM reconciliation.
+ * Use instead of `.map()` when the list changes frequently.
+ */
+export declare function repeat<T>(items: T[], keyFn: (item: T, index: number) => string | number, renderFn: (item: T, index: number) => ElurTemplate | ElurComponent): KeyedList<T>;
+export type RepeatKey = string | number;
+/**
+ * Normalizes a repeat() key to a serializable form. Keys must be strings or
+ * numbers to preserve identity across SSR/hydration. Anything else produces a
+ * diagnostic warning and a deterministic positional fallback so that server
+ * and client agree without silent `String(key)` collisions.
+ */
+export declare function normalizeRepeatKey(key: unknown, index: number): RepeatKey;
+export declare function utf8ToBase64(value: string): string;
+export declare function utf8FromBase64(value: string): string;
+/** Serializes a repeat() key for the SSR keyed marker (base64 JSON, safe for HTML comments). */
+export declare function serializeRepeatKey(key: RepeatKey): string;
+/** Decodes a repeat() key from a keyed hydration marker. */
+export declare function deserializeRepeatKey(serialized: string): RepeatKey;
+/**
+ * Returns the indices of the Longest Increasing Subsequence.
+ * Used to minimize DOM operations during list diffing.
+ */
+export declare function getSequence(arr: Int32Array | number[]): number[];
+export type { KEntry };

package/dist/lib/elur/template/keyed.js

@@ -0,0 +1,52 @@
+//#region src/elur/template/keyed.ts
+function e(e, t, n) {
+	return {
+		__isKeyedList: !0,
+		items: e,
+		keyFn: t,
+		renderFn: n
+	};
+}
+function t(e, t) {
+	return typeof e == "string" || typeof e == "number" ? e : (console.warn(`[elur] repeat(): key at index ${t} is not a string or number (got ${typeof e}); using positional fallback. Non-serializable keys cannot preserve identity across SSR/hydration.`), `__elur-key:${t}`);
+}
+function n(e) {
+	let t = new TextEncoder().encode(e), n = "";
+	for (let e = 0; e < t.length; e += 32768) n += String.fromCharCode(...t.subarray(e, e + 32768));
+	return btoa(n);
+}
+function r(e) {
+	let t = atob(e), n = new Uint8Array(t.length);
+	for (let e = 0; e < t.length; e++) n[e] = t.charCodeAt(e);
+	return new TextDecoder().decode(n);
+}
+function i(e) {
+	return n(JSON.stringify(e));
+}
+function a(e) {
+	try {
+		let t = JSON.parse(r(e));
+		if (typeof t == "string" || typeof t == "number") return t;
+	} catch {}
+	return e;
+}
+function o(e) {
+	let t = e.slice(), n = [0], r, i, a, o, s, c = e.length;
+	for (r = 0; r < c; r++) {
+		let c = e[r];
+		if (c !== 0) {
+			if (i = n[n.length - 1], e[i] < c) {
+				t[r] = i, n.push(r);
+				continue;
+			}
+			for (a = 0, o = n.length - 1; a < o;) s = a + o >> 1, e[n[s]] < c ? a = s + 1 : o = s;
+			c < e[n[a]] && (a > 0 && (t[r] = n[a - 1]), n[a] = r);
+		}
+	}
+	for (a = n.length, o = n[a - 1]; a-- > 0;) n[a] = o, o = t[o];
+	return n;
+}
+//#endregion
+export { a as deserializeRepeatKey, o as getSequence, t as normalizeRepeatKey, e as repeat, i as serializeRepeatKey };
+
+//# sourceMappingURL=keyed.js.map

package/dist/lib/elur/template/keyed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed.js","names":[],"sources":["../../../../src/elur/template/keyed.ts"],"sourcesContent":["import type { ElurTemplate, KeyedList, KEntry } from \"./types.js\";\nimport type { ElurComponent } from \"../lifecycle.js\";\n\n// =============================================================================\n// --- repeat() ---\n// =============================================================================\n\n/**\n * Creates a keyed list for efficient DOM reconciliation.\n * Use instead of `.map()` when the list changes frequently.\n */\nexport function repeat<T>(\n    items: T[],\n    keyFn: (item: T, index: number) => string | number,\n    renderFn: (item: T, index: number) => ElurTemplate | ElurComponent\n): KeyedList<T> {\n    return { __isKeyedList: true as const, items, keyFn, renderFn };\n}\n\n// =============================================================================\n// --- Key serialization for SSR/hydration markers ---\n// =============================================================================\n\nexport type RepeatKey = string | number;\n\n/**\n * Normalizes a repeat() key to a serializable form. Keys must be strings or\n * numbers to preserve identity across SSR/hydration. Anything else produces a\n * diagnostic warning and a deterministic positional fallback so that server\n * and client agree without silent `String(key)` collisions.\n */\nexport function normalizeRepeatKey(key: unknown, index: number): RepeatKey {\n    if (typeof key === \"string\" || typeof key === \"number\") return key;\n    console.warn(\n        `[elur] repeat(): key at index ${index} is not a string or number (got ${typeof key}); ` +\n            `using positional fallback. Non-serializable keys cannot preserve identity across SSR/hydration.`,\n    );\n    return `__elur-key:${index}`;\n}\n\nexport function utf8ToBase64(value: string): string {\n    const bytes = new TextEncoder().encode(value);\n    let binary = \"\";\n    for (let i = 0; i < bytes.length; i += 0x8000) {\n        binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n    }\n    return btoa(binary);\n}\n\nexport function utf8FromBase64(value: string): string {\n    const binary = atob(value);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n    return new TextDecoder().decode(bytes);\n}\n\n/** Serializes a repeat() key for the SSR keyed marker (base64 JSON, safe for HTML comments). */\nexport function serializeRepeatKey(key: RepeatKey): string {\n    return utf8ToBase64(JSON.stringify(key));\n}\n\n/** Decodes a repeat() key from a keyed hydration marker. */\nexport function deserializeRepeatKey(serialized: string): RepeatKey {\n    try {\n        const parsed: unknown = JSON.parse(utf8FromBase64(serialized));\n        if (typeof parsed === \"string\" || typeof parsed === \"number\") return parsed;\n    } catch {\n        // fall through\n    }\n    return serialized;\n}\n\n// =============================================================================\n// --- Longest Increasing Subsequence (LIS) ---\n// =============================================================================\n\n/**\n * Returns the indices of the Longest Increasing Subsequence.\n * Used to minimize DOM operations during list diffing.\n */\nexport function getSequence(arr: Int32Array | number[]): number[] {\n    const p = arr.slice();\n    const result = [0];\n    let i, j, u, v, c;\n    const len = arr.length;\n    for (i = 0; i < len; i++) {\n        const arrI = arr[i];\n        if (arrI !== 0) {\n            j = result[result.length - 1];\n            if (arr[j] < arrI) {\n                p[i] = j;\n                result.push(i);\n                continue;\n            }\n            u = 0;\n            v = result.length - 1;\n            while (u < v) {\n                c = (u + v) >> 1;\n                if (arr[result[c]] < arrI) {\n                    u = c + 1;\n                } else {\n                    v = c;\n                }\n            }\n            if (arrI < arr[result[u]]) {\n                if (u > 0) {\n                    p[i] = result[u - 1];\n                }\n                result[u] = i;\n            }\n        }\n    }\n    u = result.length;\n    v = result[u - 1];\n    while (u-- > 0) {\n        result[u] = v;\n        v = p[v];\n    }\n    return result;\n}\n\nexport type { KEntry };\n"],"mappings":";AAWA,SAAgB,EACZ,GACA,GACA,GACY;AACZ,QAAO;EAAE,eAAe;EAAe;EAAO;EAAO;EAAU;;AAenE,SAAgB,EAAmB,GAAc,GAA0B;AAMvE,QALI,OAAO,KAAQ,YAAY,OAAO,KAAQ,WAAiB,KAC/D,QAAQ,KACJ,iCAAiC,EAAM,kCAAkC,OAAO,EAAI,oGAEvF,EACM,cAAc;;AAGzB,SAAgB,EAAa,GAAuB;CAChD,IAAM,IAAQ,IAAI,aAAa,CAAC,OAAO,EAAM,EACzC,IAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK,MACnC,MAAU,OAAO,aAAa,GAAG,EAAM,SAAS,GAAG,IAAI,MAAO,CAAC;AAEnE,QAAO,KAAK,EAAO;;AAGvB,SAAgB,EAAe,GAAuB;CAClD,IAAM,IAAS,KAAK,EAAM,EACpB,IAAQ,IAAI,WAAW,EAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,EAAO,QAAQ,IAAK,GAAM,KAAK,EAAO,WAAW,EAAE;AACvE,QAAO,IAAI,aAAa,CAAC,OAAO,EAAM;;AAI1C,SAAgB,EAAmB,GAAwB;AACvD,QAAO,EAAa,KAAK,UAAU,EAAI,CAAC;;AAI5C,SAAgB,EAAqB,GAA+B;AAChE,KAAI;EACA,IAAM,IAAkB,KAAK,MAAM,EAAe,EAAW,CAAC;AAC9D,MAAI,OAAO,KAAW,YAAY,OAAO,KAAW,SAAU,QAAO;SACjE;AAGR,QAAO;;AAWX,SAAgB,EAAY,GAAsC;CAC9D,IAAM,IAAI,EAAI,OAAO,EACf,IAAS,CAAC,EAAE,EACd,GAAG,GAAG,GAAG,GAAG,GACV,IAAM,EAAI;AAChB,MAAK,IAAI,GAAG,IAAI,GAAK,KAAK;EACtB,IAAM,IAAO,EAAI;AACjB,MAAI,MAAS,GAAG;AAEZ,OADA,IAAI,EAAO,EAAO,SAAS,IACvB,EAAI,KAAK,GAAM;AAEf,IADA,EAAE,KAAK,GACP,EAAO,KAAK,EAAE;AACd;;AAIJ,QAFA,IAAI,GACJ,IAAI,EAAO,SAAS,GACb,IAAI,GAEP,CADA,IAAK,IAAI,KAAM,GACX,EAAI,EAAO,MAAM,IACjB,IAAI,IAAI,IAER,IAAI;AAGZ,GAAI,IAAO,EAAI,EAAO,QACd,IAAI,MACJ,EAAE,KAAK,EAAO,IAAI,KAEtB,EAAO,KAAK;;;AAMxB,MAFA,IAAI,EAAO,QACX,IAAI,EAAO,IAAI,IACR,MAAM,GAET,CADA,EAAO,KAAK,GACZ,IAAI,EAAE;AAEV,QAAO"}

package/dist/lib/elur/template/mount-helpers.cjs

@@ -0,0 +1,2 @@
+const e=require(`../../lifecycle.cjs`),t=require(`../../context.cjs`);function n(n,r,i){e._debugComponentMountStart(n),t._pushComponentContext();let a;try{try{n.onInit?.()}catch(e){if(n.onError)n.onError(e);else throw e}a=n.render()._render(r,i)}finally{e._debugComponentMountEnd(n),t._popComponentContext()}let o;try{let e=n.onMount?.();typeof e==`function`&&(o=e)}catch(e){if(n.onError)n.onError(e);else throw e}return()=>{try{n.onUnmount?.()}catch{}try{o?.()}catch{}a(),e._debugComponentUnmount(n)}}function r(n,r,i){e._debugComponentMountStart(n),t._pushComponentContext();let a;try{try{n.onInit?.()}catch{}a=n.render()._render(r,i)}finally{e._debugComponentMountEnd(n),t._popComponentContext()}let o;try{let e=n.onMount?.();typeof e==`function`&&(o=e)}catch{}return()=>{try{n.onUnmount?.()}catch{}try{o?.()}catch{}a(),e._debugComponentUnmount(n)}}function i(n,r,i,a){e._debugComponentMountStart(n);let o;try{t._withComponentContext(a,()=>{try{n.onInit?.()}catch(e){if(n.onError)n.onError(e);else throw e}o=n.render()._render(r,i)})}finally{e._debugComponentMountEnd(n)}let s;try{let e=n.onMount?.();typeof e==`function`&&(s=e)}catch(e){if(n.onError)n.onError(e);else throw e}return()=>{try{n.onUnmount?.()}catch{}try{s?.()}catch{}o(),e._debugComponentUnmount(n)}}function a(n,r,i,a,o){e._debugComponentMountStart(n),t._pushComponentContext();let s;try{try{n.onInit?.()}catch(e){if(n.onError)n.onError(e);else throw e}s=n.render()._render(r,i)}finally{e._debugComponentMountEnd(n),t._popComponentContext()}let c;a.push(()=>{try{let e=n.onMount?.();typeof e==`function`&&(c=e)}catch(e){if(n.onError)n.onError(e);else throw e}}),o.push(()=>{try{n.onUnmount?.()}catch{}try{c?.()}catch{}s(),e._debugComponentUnmount(n)})}exports._mountComponent=n,exports._mountComponentDeferred=a,exports._mountComponentSilent=r,exports._mountComponentWithCtx=i;
+//# sourceMappingURL=mount-helpers.cjs.map

package/dist/lib/elur/template/mount-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-helpers.cjs","names":[],"sources":["../../../../src/elur/template/mount-helpers.ts"],"sourcesContent":["import {\n    _debugComponentMountStart,\n    _debugComponentMountEnd,\n    _debugComponentUnmount,\n    type ElurComponent,\n} from \"../lifecycle.js\";\nimport {\n    _captureContextSnapshot,\n    _pushComponentContext,\n    _popComponentContext,\n    _withComponentContext,\n} from \"../context.js\";\n\n// =============================================================================\n// --- Component mounting helpers ---\n// =============================================================================\n\n/**\n * Renders a ElurComponent into the DOM and calls onMount immediately.\n * Propagates errors through onError (or re-throws if not present).\n * Returns a full cleanup function (onUnmount + mountCleanup + renderCleanup).\n */\nexport function _mountComponent(\n    inst: ElurComponent,\n    parent: Node,\n    before: Node | null,\n): () => void {\n    _debugComponentMountStart(inst);\n    _pushComponentContext();\n    let renderCleanup!: () => void;\n    try {\n        try { inst.onInit?.(); } catch (e) { if (inst.onError) inst.onError(e); else throw e; }\n        renderCleanup = inst.render()._render(parent, before);\n    } finally {\n        _debugComponentMountEnd(inst);\n        _popComponentContext();\n    }\n    let mountCleanup: (() => void) | undefined;\n    try {\n        const ret = inst.onMount?.();\n        if (typeof ret === \"function\") mountCleanup = ret;\n    } catch (e) {\n        if (inst.onError) inst.onError(e); else throw e;\n    }\n    return () => {\n        try { inst.onUnmount?.(); } catch { /* ignore */ }\n        try { mountCleanup?.(); } catch { /* ignore */ }\n        renderCleanup();\n        _debugComponentUnmount(inst);\n    };\n}\n\n/**\n * Same as `_mountComponent` but silently swallows all lifecycle errors.\n * Used for transition content and error boundary fallbacks where errors\n * inside the fallback/transition itself must not propagate.\n */\nexport function _mountComponentSilent(\n    inst: ElurComponent,\n    parent: Node,\n    before: Node | null,\n): () => void {\n    _debugComponentMountStart(inst);\n    _pushComponentContext();\n    let renderCleanup!: () => void;\n    try {\n        try { inst.onInit?.(); } catch { /* ignore */ }\n        renderCleanup = inst.render()._render(parent, before);\n    } finally {\n        _debugComponentMountEnd(inst);\n        _popComponentContext();\n    }\n    let mountRet: (() => void) | undefined;\n    try {\n        const ret = inst.onMount?.();\n        if (typeof ret === \"function\") mountRet = ret;\n    } catch { /* ignore */ }\n    return () => {\n        try { inst.onUnmount?.(); } catch { /* ignore */ }\n        try { mountRet?.(); } catch { /* ignore */ }\n        renderCleanup();\n        _debugComponentUnmount(inst);\n    };\n}\n\n/**\n * Renders a ElurComponent using a captured context snapshot.\n * Used for dynamic/keyed rendering inside reactive effects, where the\n * provide/inject context must be inherited from the point of declaration.\n * Calls onMount immediately. Returns a full cleanup function.\n */\nexport function _mountComponentWithCtx(\n    inst: ElurComponent,\n    parent: Node,\n    before: Node | null,\n    ctxSnapshot: ReturnType<typeof _captureContextSnapshot>,\n): () => void {\n    _debugComponentMountStart(inst);\n    let renderCleanup!: () => void;\n    try {\n        _withComponentContext(ctxSnapshot, () => {\n            try { inst.onInit?.(); } catch (e) { if (inst.onError) inst.onError(e); else throw e; }\n            renderCleanup = inst.render()._render(parent, before);\n        });\n    } finally {\n        _debugComponentMountEnd(inst);\n    }\n    let mountCleanup: (() => void) | undefined;\n    try {\n        const ret = inst.onMount?.();\n        if (typeof ret === \"function\") mountCleanup = ret;\n    } catch (e) {\n        if (inst.onError) inst.onError(e); else throw e;\n    }\n    return () => {\n        try { inst.onUnmount?.(); } catch { /* ignore */ }\n        try { mountCleanup?.(); } catch { /* ignore */ }\n        renderCleanup();\n        _debugComponentUnmount(inst);\n    };\n}\n\n/**\n * Renders a ElurComponent with *deferred* onMount — used inside `html` template\n * fragments where the DOM nodes are still in a DocumentFragment and onMount must\n * fire only after the fragment is inserted into the live document.\n *\n * Pushes the full cleanup into `disposes` and the onMount call into `postMountHooks`.\n */\nexport function _mountComponentDeferred(\n    inst: ElurComponent,\n    parent: Node,\n    before: Node | null,\n    postMountHooks: Array<() => void>,\n    disposes: Array<() => void>,\n): void {\n    _debugComponentMountStart(inst);\n    _pushComponentContext();\n    let renderCleanup!: () => void;\n    try {\n        try { inst.onInit?.(); } catch (e) { if (inst.onError) inst.onError(e); else throw e; }\n        renderCleanup = inst.render()._render(parent, before);\n    } finally {\n        _debugComponentMountEnd(inst);\n        _popComponentContext();\n    }\n    let mountCleanup: (() => void) | undefined;\n    postMountHooks.push(() => {\n        try {\n            const ret = inst.onMount?.();\n            if (typeof ret === \"function\") mountCleanup = ret;\n        } catch (e) {\n            if (inst.onError) inst.onError(e); else throw e;\n        }\n    });\n    disposes.push(() => {\n        try { inst.onUnmount?.(); } catch { /* ignore */ }\n        try { mountCleanup?.(); } catch { /* ignore */ }\n        renderCleanup();\n        _debugComponentUnmount(inst);\n    });\n}\n"],"mappings":"sEAsBA,SAAgB,EACZ,EACA,EACA,EACU,CACV,EAAA,0BAA0B,EAAK,CAC/B,EAAA,uBAAuB,CACvB,IAAI,EACJ,GAAI,CACA,GAAI,CAAE,EAAK,UAAU,OAAW,EAAG,CAAE,GAAI,EAAK,QAAS,EAAK,QAAQ,EAAE,MAAO,MAAM,EACnF,EAAgB,EAAK,QAAQ,CAAC,QAAQ,EAAQ,EAAO,QAC/C,CACN,EAAA,wBAAwB,EAAK,CAC7B,EAAA,sBAAsB,CAE1B,IAAI,EACJ,GAAI,CACA,IAAM,EAAM,EAAK,WAAW,CACxB,OAAO,GAAQ,aAAY,EAAe,SACzC,EAAG,CACR,GAAI,EAAK,QAAS,EAAK,QAAQ,EAAE,MAAO,MAAM,EAElD,UAAa,CACT,GAAI,CAAE,EAAK,aAAa,MAAU,EAClC,GAAI,CAAE,KAAgB,MAAU,EAChC,GAAe,CACf,EAAA,uBAAuB,EAAK,EASpC,SAAgB,EACZ,EACA,EACA,EACU,CACV,EAAA,0BAA0B,EAAK,CAC/B,EAAA,uBAAuB,CACvB,IAAI,EACJ,GAAI,CACA,GAAI,CAAE,EAAK,UAAU,MAAU,EAC/B,EAAgB,EAAK,QAAQ,CAAC,QAAQ,EAAQ,EAAO,QAC/C,CACN,EAAA,wBAAwB,EAAK,CAC7B,EAAA,sBAAsB,CAE1B,IAAI,EACJ,GAAI,CACA,IAAM,EAAM,EAAK,WAAW,CACxB,OAAO,GAAQ,aAAY,EAAW,QACtC,EACR,UAAa,CACT,GAAI,CAAE,EAAK,aAAa,MAAU,EAClC,GAAI,CAAE,KAAY,MAAU,EAC5B,GAAe,CACf,EAAA,uBAAuB,EAAK,EAUpC,SAAgB,EACZ,EACA,EACA,EACA,EACU,CACV,EAAA,0BAA0B,EAAK,CAC/B,IAAI,EACJ,GAAI,CACA,EAAA,sBAAsB,MAAmB,CACrC,GAAI,CAAE,EAAK,UAAU,OAAW,EAAG,CAAE,GAAI,EAAK,QAAS,EAAK,QAAQ,EAAE,MAAO,MAAM,EACnF,EAAgB,EAAK,QAAQ,CAAC,QAAQ,EAAQ,EAAO,EACvD,QACI,CACN,EAAA,wBAAwB,EAAK,CAEjC,IAAI,EACJ,GAAI,CACA,IAAM,EAAM,EAAK,WAAW,CACxB,OAAO,GAAQ,aAAY,EAAe,SACzC,EAAG,CACR,GAAI,EAAK,QAAS,EAAK,QAAQ,EAAE,MAAO,MAAM,EAElD,UAAa,CACT,GAAI,CAAE,EAAK,aAAa,MAAU,EAClC,GAAI,CAAE,KAAgB,MAAU,EAChC,GAAe,CACf,EAAA,uBAAuB,EAAK,EAWpC,SAAgB,EACZ,EACA,EACA,EACA,EACA,EACI,CACJ,EAAA,0BAA0B,EAAK,CAC/B,EAAA,uBAAuB,CACvB,IAAI,EACJ,GAAI,CACA,GAAI,CAAE,EAAK,UAAU,OAAW,EAAG,CAAE,GAAI,EAAK,QAAS,EAAK,QAAQ,EAAE,MAAO,MAAM,EACnF,EAAgB,EAAK,QAAQ,CAAC,QAAQ,EAAQ,EAAO,QAC/C,CACN,EAAA,wBAAwB,EAAK,CAC7B,EAAA,sBAAsB,CAE1B,IAAI,EACJ,EAAe,SAAW,CACtB,GAAI,CACA,IAAM,EAAM,EAAK,WAAW,CACxB,OAAO,GAAQ,aAAY,EAAe,SACzC,EAAG,CACR,GAAI,EAAK,QAAS,EAAK,QAAQ,EAAE,MAAO,MAAM,IAEpD,CACF,EAAS,SAAW,CAChB,GAAI,CAAE,EAAK,aAAa,MAAU,EAClC,GAAI,CAAE,KAAgB,MAAU,EAChC,GAAe,CACf,EAAA,uBAAuB,EAAK,EAC9B"}

package/dist/lib/elur/template/mount-helpers.d.cts

@@ -0,0 +1,29 @@
+import { type ElurComponent } from "../lifecycle.js";
+import { _captureContextSnapshot } from "../context.js";
+/**
+ * Renders a ElurComponent into the DOM and calls onMount immediately.
+ * Propagates errors through onError (or re-throws if not present).
+ * Returns a full cleanup function (onUnmount + mountCleanup + renderCleanup).
+ */
+export declare function _mountComponent(inst: ElurComponent, parent: Node, before: Node | null): () => void;
+/**
+ * Same as `_mountComponent` but silently swallows all lifecycle errors.
+ * Used for transition content and error boundary fallbacks where errors
+ * inside the fallback/transition itself must not propagate.
+ */
+export declare function _mountComponentSilent(inst: ElurComponent, parent: Node, before: Node | null): () => void;
+/**
+ * Renders a ElurComponent using a captured context snapshot.
+ * Used for dynamic/keyed rendering inside reactive effects, where the
+ * provide/inject context must be inherited from the point of declaration.
+ * Calls onMount immediately. Returns a full cleanup function.
+ */
+export declare function _mountComponentWithCtx(inst: ElurComponent, parent: Node, before: Node | null, ctxSnapshot: ReturnType<typeof _captureContextSnapshot>): () => void;
+/**
+ * Renders a ElurComponent with *deferred* onMount — used inside `html` template
+ * fragments where the DOM nodes are still in a DocumentFragment and onMount must
+ * fire only after the fragment is inserted into the live document.
+ *
+ * Pushes the full cleanup into `disposes` and the onMount call into `postMountHooks`.
+ */
+export declare function _mountComponentDeferred(inst: ElurComponent, parent: Node, before: Node | null, postMountHooks: Array<() => void>, disposes: Array<() => void>): void;

package/dist/lib/elur/template/mount-helpers.d.ts

@@ -0,0 +1,29 @@
+import { type ElurComponent } from "../lifecycle.js";
+import { _captureContextSnapshot } from "../context.js";
+/**
+ * Renders a ElurComponent into the DOM and calls onMount immediately.
+ * Propagates errors through onError (or re-throws if not present).
+ * Returns a full cleanup function (onUnmount + mountCleanup + renderCleanup).
+ */
+export declare function _mountComponent(inst: ElurComponent, parent: Node, before: Node | null): () => void;
+/**
+ * Same as `_mountComponent` but silently swallows all lifecycle errors.
+ * Used for transition content and error boundary fallbacks where errors
+ * inside the fallback/transition itself must not propagate.
+ */
+export declare function _mountComponentSilent(inst: ElurComponent, parent: Node, before: Node | null): () => void;
+/**
+ * Renders a ElurComponent using a captured context snapshot.
+ * Used for dynamic/keyed rendering inside reactive effects, where the
+ * provide/inject context must be inherited from the point of declaration.
+ * Calls onMount immediately. Returns a full cleanup function.
+ */
+export declare function _mountComponentWithCtx(inst: ElurComponent, parent: Node, before: Node | null, ctxSnapshot: ReturnType<typeof _captureContextSnapshot>): () => void;
+/**
+ * Renders a ElurComponent with *deferred* onMount — used inside `html` template
+ * fragments where the DOM nodes are still in a DocumentFragment and onMount must
+ * fire only after the fragment is inserted into the live document.
+ *
+ * Pushes the full cleanup into `disposes` and the onMount call into `postMountHooks`.
+ */
+export declare function _mountComponentDeferred(inst: ElurComponent, parent: Node, before: Node | null, postMountHooks: Array<() => void>, disposes: Array<() => void>): void;