@elurjs/core 3.5.0

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

@@ -0,0 +1,132 @@
+import { _debugComponentMountEnd as e, _debugComponentMountStart as t, _debugComponentUnmount as n } from "../../lifecycle.js";
+import { _popComponentContext as r, _pushComponentContext as i, _withComponentContext as a } from "../../context.js";
+//#region src/elur/template/mount-helpers.ts
+function o(a, o, s) {
+	t(a), i();
+	let c;
+	try {
+		try {
+			a.onInit?.();
+		} catch (e) {
+			if (a.onError) a.onError(e);
+			else throw e;
+		}
+		c = a.render()._render(o, s);
+	} finally {
+		e(a), r();
+	}
+	let l;
+	try {
+		let e = a.onMount?.();
+		typeof e == "function" && (l = e);
+	} catch (e) {
+		if (a.onError) a.onError(e);
+		else throw e;
+	}
+	return () => {
+		try {
+			a.onUnmount?.();
+		} catch {}
+		try {
+			l?.();
+		} catch {}
+		c(), n(a);
+	};
+}
+function s(a, o, s) {
+	t(a), i();
+	let c;
+	try {
+		try {
+			a.onInit?.();
+		} catch {}
+		c = a.render()._render(o, s);
+	} finally {
+		e(a), r();
+	}
+	let l;
+	try {
+		let e = a.onMount?.();
+		typeof e == "function" && (l = e);
+	} catch {}
+	return () => {
+		try {
+			a.onUnmount?.();
+		} catch {}
+		try {
+			l?.();
+		} catch {}
+		c(), n(a);
+	};
+}
+function c(r, i, o, s) {
+	t(r);
+	let c;
+	try {
+		a(s, () => {
+			try {
+				r.onInit?.();
+			} catch (e) {
+				if (r.onError) r.onError(e);
+				else throw e;
+			}
+			c = r.render()._render(i, o);
+		});
+	} finally {
+		e(r);
+	}
+	let l;
+	try {
+		let e = r.onMount?.();
+		typeof e == "function" && (l = e);
+	} catch (e) {
+		if (r.onError) r.onError(e);
+		else throw e;
+	}
+	return () => {
+		try {
+			r.onUnmount?.();
+		} catch {}
+		try {
+			l?.();
+		} catch {}
+		c(), n(r);
+	};
+}
+function l(a, o, s, c, l) {
+	t(a), i();
+	let u;
+	try {
+		try {
+			a.onInit?.();
+		} catch (e) {
+			if (a.onError) a.onError(e);
+			else throw e;
+		}
+		u = a.render()._render(o, s);
+	} finally {
+		e(a), r();
+	}
+	let d;
+	c.push(() => {
+		try {
+			let e = a.onMount?.();
+			typeof e == "function" && (d = e);
+		} catch (e) {
+			if (a.onError) a.onError(e);
+			else throw e;
+		}
+	}), l.push(() => {
+		try {
+			a.onUnmount?.();
+		} catch {}
+		try {
+			d?.();
+		} catch {}
+		u(), n(a);
+	});
+}
+//#endregion
+export { o as _mountComponent, l as _mountComponentDeferred, s as _mountComponentSilent, c as _mountComponentWithCtx };
+
+//# sourceMappingURL=mount-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount-helpers.js","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":";;;AAsBA,SAAgB,EACZ,GACA,GACA,GACU;AAEV,CADA,EAA0B,EAAK,EAC/B,GAAuB;CACvB,IAAI;AACJ,KAAI;AACA,MAAI;AAAE,KAAK,UAAU;WAAW,GAAG;AAAE,OAAI,EAAK,QAAS,GAAK,QAAQ,EAAE;OAAO,OAAM;;AACnF,MAAgB,EAAK,QAAQ,CAAC,QAAQ,GAAQ,EAAO;WAC/C;AAEN,EADA,EAAwB,EAAK,EAC7B,GAAsB;;CAE1B,IAAI;AACJ,KAAI;EACA,IAAM,IAAM,EAAK,WAAW;AAC5B,EAAI,OAAO,KAAQ,eAAY,IAAe;UACzC,GAAG;AACR,MAAI,EAAK,QAAS,GAAK,QAAQ,EAAE;MAAO,OAAM;;AAElD,cAAa;AACT,MAAI;AAAE,KAAK,aAAa;UAAU;AAClC,MAAI;AAAE,QAAgB;UAAU;AAEhC,EADA,GAAe,EACf,EAAuB,EAAK;;;AASpC,SAAgB,EACZ,GACA,GACA,GACU;AAEV,CADA,EAA0B,EAAK,EAC/B,GAAuB;CACvB,IAAI;AACJ,KAAI;AACA,MAAI;AAAE,KAAK,UAAU;UAAU;AAC/B,MAAgB,EAAK,QAAQ,CAAC,QAAQ,GAAQ,EAAO;WAC/C;AAEN,EADA,EAAwB,EAAK,EAC7B,GAAsB;;CAE1B,IAAI;AACJ,KAAI;EACA,IAAM,IAAM,EAAK,WAAW;AAC5B,EAAI,OAAO,KAAQ,eAAY,IAAW;SACtC;AACR,cAAa;AACT,MAAI;AAAE,KAAK,aAAa;UAAU;AAClC,MAAI;AAAE,QAAY;UAAU;AAE5B,EADA,GAAe,EACf,EAAuB,EAAK;;;AAUpC,SAAgB,EACZ,GACA,GACA,GACA,GACU;AACV,GAA0B,EAAK;CAC/B,IAAI;AACJ,KAAI;AACA,IAAsB,SAAmB;AACrC,OAAI;AAAE,MAAK,UAAU;YAAW,GAAG;AAAE,QAAI,EAAK,QAAS,GAAK,QAAQ,EAAE;QAAO,OAAM;;AACnF,OAAgB,EAAK,QAAQ,CAAC,QAAQ,GAAQ,EAAO;IACvD;WACI;AACN,IAAwB,EAAK;;CAEjC,IAAI;AACJ,KAAI;EACA,IAAM,IAAM,EAAK,WAAW;AAC5B,EAAI,OAAO,KAAQ,eAAY,IAAe;UACzC,GAAG;AACR,MAAI,EAAK,QAAS,GAAK,QAAQ,EAAE;MAAO,OAAM;;AAElD,cAAa;AACT,MAAI;AAAE,KAAK,aAAa;UAAU;AAClC,MAAI;AAAE,QAAgB;UAAU;AAEhC,EADA,GAAe,EACf,EAAuB,EAAK;;;AAWpC,SAAgB,EACZ,GACA,GACA,GACA,GACA,GACI;AAEJ,CADA,EAA0B,EAAK,EAC/B,GAAuB;CACvB,IAAI;AACJ,KAAI;AACA,MAAI;AAAE,KAAK,UAAU;WAAW,GAAG;AAAE,OAAI,EAAK,QAAS,GAAK,QAAQ,EAAE;OAAO,OAAM;;AACnF,MAAgB,EAAK,QAAQ,CAAC,QAAQ,GAAQ,EAAO;WAC/C;AAEN,EADA,EAAwB,EAAK,EAC7B,GAAsB;;CAE1B,IAAI;AASJ,CARA,EAAe,WAAW;AACtB,MAAI;GACA,IAAM,IAAM,EAAK,WAAW;AAC5B,GAAI,OAAO,KAAQ,eAAY,IAAe;WACzC,GAAG;AACR,OAAI,EAAK,QAAS,GAAK,QAAQ,EAAE;OAAO,OAAM;;GAEpD,EACF,EAAS,WAAW;AAChB,MAAI;AAAE,KAAK,aAAa;UAAU;AAClC,MAAI;AAAE,QAAgB;UAAU;AAEhC,EADA,GAAe,EACf,EAAuB,EAAK;GAC9B"}

package/dist/lib/elur/template/node-binding.cjs

@@ -0,0 +1,2 @@
+const e=require(`../../signals.cjs`),t=require(`./types.cjs`),n=require(`../../lifecycle.cjs`),r=require(`../../context.cjs`),i=require(`./mount-helpers.cjs`),a=require(`./keyed-diff.cjs`),o=require(`./dom-write.cjs`);function s(s,c,l,u){if(typeof c!=`function`){if(typeof c==`object`&&c&&c[t.ELUR_RENDER_PROTOCOL]!=null){let e=c[t.ELUR_RENDER_PROTOCOL];if(e.mountDom){let t=e.mountDom({parent:s.parentNode,before:s});t&&l.push(t);return}}if(n.isElurComponent(c))i._mountComponentDeferred(c,s.parentNode,s,u,l);else if(t.isElurTemplate(c))l.push(c._render(s.parentNode,s));else if(t.isKeyedList(c)){let e=r._captureContextSnapshot(),t=new Map,n=document.createTextNode(``);s.parentNode.insertBefore(n,s),a.reconcileKeyedList({zoneStart:n,anchor:s,state:t,prevOrder:[],list:c,mount:a.createKeyedMount(e),ctxSnapshot:e,onDuplicateKey:e=>{console.warn(`[elur] repeat(): duplicate key "${e}". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`)}}),l.push(()=>{for(let e of t.values())e.cleanup();t.clear()})}else if(Array.isArray(c))for(let e of c)n.isElurComponent(e)?i._mountComponentDeferred(e,s.parentNode,s,u,l):t.isElurTemplate(e)?e._render(s.parentNode,s):e!=null&&e!==!1&&s.parentNode.insertBefore(document.createTextNode(String(e)),s);else c!=null&&c!==!1&&s.parentNode.insertBefore(document.createTextNode(String(c)),s);return}let d=null,f=null,p=null,m=[],h=null,g=r._captureContextSnapshot(),_=a.createKeyedMount(g),v=!1,y=``,b=!0,x=e.effect(()=>{let e=c();if(typeof e==`string`||typeof e==`number`){y=String(e);let t=()=>{v=!1,f&&=(f(),null),d?d.nodeValue=y:(d=document.createTextNode(y),s.parentNode.insertBefore(d,s))};b?(b=!1,t()):v||(v=!0,o.queueDOMWrite(t));return}if(v=!1,b=!1,d&&=(d.parentNode?.removeChild(d),null),f&&=(f(),null),!(e==null||e===!1))if(typeof e==`object`&&e&&e[t.ELUR_RENDER_PROTOCOL]!=null){let n=e[t.ELUR_RENDER_PROTOCOL];n.mountDom?f=n.mountDom({parent:s.parentNode,before:s})??null:(d=document.createTextNode(String(e)),s.parentNode.insertBefore(d,s))}else if(t.isElurTemplate(e))f=e._render(s.parentNode,s);else if(n.isElurComponent(e))f=i._mountComponentWithCtx(e,s.parentNode,s,g);else if(t.isKeyedList(e))p||(p=new Map,h=document.createTextNode(``),s.parentNode.insertBefore(h,s)),a.reconcileKeyedList({zoneStart:h,anchor:s,state:p,prevOrder:m,list:e,mount:_,onDuplicateKey:e=>{console.warn(`[elur] repeat(): duplicate key "${e}". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`)}});else if(Array.isArray(e)){let r=[];for(let a of e)if(n.isElurComponent(a))r.push(i._mountComponent(a,s.parentNode,s));else if(t.isElurTemplate(a))r.push(a._render(s.parentNode,s));else if(a!=null&&a!==!1){let e=document.createTextNode(String(a));s.parentNode.insertBefore(e,s),r.push(()=>e.parentNode?.removeChild(e))}f=()=>r.forEach(e=>e())}else d=document.createTextNode(String(e)),s.parentNode.insertBefore(d,s)});l.push(()=>{if(x(),f&&=(f(),null),d&&=(d.parentNode?.removeChild(d),null),p){for(let e of p.values())e.cleanup();p=null,h=null}})}exports.activateNodeBinding=s;
+//# sourceMappingURL=node-binding.cjs.map

package/dist/lib/elur/template/node-binding.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-binding.cjs","names":[],"sources":["../../../../src/elur/template/node-binding.ts"],"sourcesContent":["import { effect } from \"../reactivity.js\";\nimport { isElurComponent } from \"../lifecycle.js\";\nimport { _captureContextSnapshot } from \"../context.js\";\nimport type { KEntry } from \"./types.js\";\nimport type { RepeatKey } from \"./keyed.js\";\nimport { isElurTemplate, isKeyedList, ELUR_RENDER_PROTOCOL } from \"./types.js\";\nimport {\n    _mountComponent,\n    _mountComponentWithCtx,\n    _mountComponentDeferred,\n} from \"./mount-helpers.js\";\nimport { createKeyedMount, reconcileKeyedList } from \"./keyed-diff.js\";\nimport { queueDOMWrite } from \"./dom-write.js\";\n\n// =============================================================================\n// --- Reactive node binding ---\n// =============================================================================\n\n/**\n * Activates a reactive node binding at `anchor`.\n * Handles: text, ElurTemplate, ElurComponent, KeyedList, Array, and static values.\n * Pushes dispose functions into `disposes`.\n */\nexport function activateNodeBinding(\n    anchor: Text,\n    value: unknown,\n    disposes: Array<() => void>,\n    postMountHooks: Array<() => void>,\n): void {\n    if (typeof value !== \"function\") {\n        if (value != null && typeof value === \"object\" && (value as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] != null) {\n            const proto = (value as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] as { mountDom?: (ctx: import(\"./types.js\").DomProtocolContext) => (() => void) | void };\n            if (proto.mountDom) {\n                const cleanup = proto.mountDom({\n                    parent: anchor.parentNode!,\n                    before: anchor,\n                });\n                if (cleanup) disposes.push(cleanup);\n                return;\n            }\n        }\n        if (isElurComponent(value)) {\n            _mountComponentDeferred(value, anchor.parentNode!, anchor, postMountHooks, disposes);\n        } else if (isElurTemplate(value)) {\n            disposes.push(value._render(anchor.parentNode!, anchor));\n        } else if (isKeyedList(value)) {\n            // Static keyed list (`repeat(...)` directly, without a getter):\n            // mirror the reactive path so a direct keyed value never falls\n            // through to `String(value)`.\n            const ctxSnapshot = _captureContextSnapshot();\n            const keyedState = new Map<RepeatKey, KEntry>();\n            const keyedZoneStart = document.createTextNode(\"\");\n            anchor.parentNode!.insertBefore(keyedZoneStart, anchor);\n            reconcileKeyedList({\n                zoneStart: keyedZoneStart,\n                anchor,\n                state: keyedState,\n                prevOrder: [],\n                list: value,\n                mount: createKeyedMount(ctxSnapshot),\n                ctxSnapshot,\n                onDuplicateKey: (key) => {\n                    console.warn(`[elur] repeat(): duplicate key \"${key}\". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);\n                },\n            });\n            disposes.push(() => {\n                for (const entry of keyedState.values()) {\n                    entry.cleanup();\n                }\n                keyedState.clear();\n            });\n        } else if (Array.isArray(value)) {\n            for (const item of value) {\n                if (isElurComponent(item)) {\n                    _mountComponentDeferred(item, anchor.parentNode!, anchor, postMountHooks, disposes);\n                } else if (isElurTemplate(item)) {\n                    item._render(anchor.parentNode!, anchor);\n                } else if (item != null && item !== false) {\n                    anchor.parentNode!.insertBefore(\n                        document.createTextNode(String(item)),\n                        anchor\n                    );\n                }\n            }\n        } else if (value != null && value !== false) {\n            anchor.parentNode!.insertBefore(\n                document.createTextNode(String(value)),\n                anchor\n            );\n        }\n        return;\n    }\n\n    // Reactive function path\n    let textNode: Text | null = null;\n    let innerCleanup: (() => void) | null = null;\n\n    type Key = RepeatKey;\n    let keyedState: Map<Key, KEntry> | null = null;\n    let prevKeyOrder: Key[] = [];\n    let keyedZoneStart: Node | null = null;\n\n    const ctxSnapshot = _captureContextSnapshot();\n    const keyedMount = createKeyedMount(ctxSnapshot);\n\n    let _textQueued = false;\n    let _pendingText = \"\";\n    let _isFirstText = true;\n\n    const dispose = effect(() => {\n        const v = (value as () => unknown)();\n\n        if (typeof v === \"string\" || typeof v === \"number\") {\n            _pendingText = String(v);\n\n            const update = () => {\n                _textQueued = false;\n                if (innerCleanup) {\n                    innerCleanup();\n                    innerCleanup = null;\n                }\n                if (!textNode) {\n                    textNode = document.createTextNode(_pendingText);\n                    anchor.parentNode!.insertBefore(textNode, anchor);\n                } else {\n                    textNode.nodeValue = _pendingText;\n                }\n            };\n\n            if (_isFirstText) {\n                _isFirstText = false;\n                update();\n            } else if (!_textQueued) {\n                _textQueued = true;\n                queueDOMWrite(update);\n            }\n            return;\n        }\n\n        _textQueued = false;\n        _isFirstText = false;\n\n        if (textNode) {\n            textNode.parentNode?.removeChild(textNode);\n            textNode = null;\n        }\n        if (innerCleanup) {\n            innerCleanup();\n            innerCleanup = null;\n        }\n\n        if (v == null || v === false) {\n            // Empty\n        } else if (v != null && typeof v === \"object\" && (v as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] != null) {\n            const proto = (v as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] as { mountDom?: (ctx: import(\"./types.js\").DomProtocolContext) => (() => void) | void };\n            if (proto.mountDom) {\n                innerCleanup = proto.mountDom({ parent: anchor.parentNode!, before: anchor }) ?? null;\n            } else {\n                textNode = document.createTextNode(String(v));\n                anchor.parentNode!.insertBefore(textNode, anchor);\n            }\n        } else if (isElurTemplate(v)) {\n            innerCleanup = v._render(anchor.parentNode!, anchor);\n        } else if (isElurComponent(v)) {\n            innerCleanup = _mountComponentWithCtx(v, anchor.parentNode!, anchor, ctxSnapshot);\n        } else if (isKeyedList(v)) {\n\n            if (!keyedState) {\n                keyedState = new Map();\n                keyedZoneStart = document.createTextNode(\"\");\n                anchor.parentNode!.insertBefore(keyedZoneStart, anchor);\n            }\n\n            reconcileKeyedList({\n                zoneStart: keyedZoneStart!,\n                anchor,\n                state: keyedState,\n                prevOrder: prevKeyOrder,\n                list: v,\n                mount: keyedMount,\n                onDuplicateKey: (key) => {\n                    console.warn(`[elur] repeat(): duplicate key \"${key}\". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);\n                },\n            });\n        } else if (Array.isArray(v)) {\n            const cleanups: Array<() => void> = [];\n            for (const item of v) {\n                if (isElurComponent(item)) {\n                    cleanups.push(_mountComponent(item, anchor.parentNode!, anchor));\n                } else if (isElurTemplate(item)) {\n                    cleanups.push(item._render(anchor.parentNode!, anchor));\n                } else if (item != null && item !== false) {\n                    const t = document.createTextNode(String(item));\n                    anchor.parentNode!.insertBefore(t, anchor);\n                    cleanups.push(() => t.parentNode?.removeChild(t));\n                }\n            }\n            innerCleanup = () => cleanups.forEach((c) => c());\n        } else {\n            textNode = document.createTextNode(String(v));\n            anchor.parentNode!.insertBefore(textNode, anchor);\n        }\n    });\n\n    disposes.push(() => {\n        dispose();\n        if (innerCleanup) {\n            innerCleanup();\n            innerCleanup = null;\n        }\n        if (textNode) {\n            textNode.parentNode?.removeChild(textNode);\n            textNode = null;\n        }\n        if (keyedState) {\n            for (const entry of keyedState.values()) {\n                entry.cleanup();\n            }\n            keyedState = null;\n            keyedZoneStart = null;\n        }\n    });\n}\n"],"mappings":"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"}

package/dist/lib/elur/template/node-binding.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Activates a reactive node binding at `anchor`.
+ * Handles: text, ElurTemplate, ElurComponent, KeyedList, Array, and static values.
+ * Pushes dispose functions into `disposes`.
+ */
+export declare function activateNodeBinding(anchor: Text, value: unknown, disposes: Array<() => void>, postMountHooks: Array<() => void>): void;

package/dist/lib/elur/template/node-binding.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Activates a reactive node binding at `anchor`.
+ * Handles: text, ElurTemplate, ElurComponent, KeyedList, Array, and static values.
+ * Pushes dispose functions into `disposes`.
+ */
+export declare function activateNodeBinding(anchor: Text, value: unknown, disposes: Array<() => void>, postMountHooks: Array<() => void>): void;

package/dist/lib/elur/template/node-binding.js

@@ -0,0 +1,95 @@
+import { effect as e } from "../../signals.js";
+import { ELUR_RENDER_PROTOCOL as t, isElurTemplate as n, isKeyedList as r } from "./types.js";
+import { isElurComponent as i } from "../../lifecycle.js";
+import { _captureContextSnapshot as a } from "../../context.js";
+import { _mountComponent as o, _mountComponentDeferred as s, _mountComponentWithCtx as c } from "./mount-helpers.js";
+import { createKeyedMount as l, reconcileKeyedList as u } from "./keyed-diff.js";
+import { queueDOMWrite as d } from "./dom-write.js";
+//#region src/elur/template/node-binding.ts
+function f(f, p, m, h) {
+	if (typeof p != "function") {
+		if (typeof p == "object" && p && p[t] != null) {
+			let e = p[t];
+			if (e.mountDom) {
+				let t = e.mountDom({
+					parent: f.parentNode,
+					before: f
+				});
+				t && m.push(t);
+				return;
+			}
+		}
+		if (i(p)) s(p, f.parentNode, f, h, m);
+		else if (n(p)) m.push(p._render(f.parentNode, f));
+		else if (r(p)) {
+			let e = a(), t = /* @__PURE__ */ new Map(), n = document.createTextNode("");
+			f.parentNode.insertBefore(n, f), u({
+				zoneStart: n,
+				anchor: f,
+				state: t,
+				prevOrder: [],
+				list: p,
+				mount: l(e),
+				ctxSnapshot: e,
+				onDuplicateKey: (e) => {
+					console.warn(`[elur] repeat(): duplicate key "${e}". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);
+				}
+			}), m.push(() => {
+				for (let e of t.values()) e.cleanup();
+				t.clear();
+			});
+		} else if (Array.isArray(p)) for (let e of p) i(e) ? s(e, f.parentNode, f, h, m) : n(e) ? e._render(f.parentNode, f) : e != null && e !== !1 && f.parentNode.insertBefore(document.createTextNode(String(e)), f);
+		else p != null && p !== !1 && f.parentNode.insertBefore(document.createTextNode(String(p)), f);
+		return;
+	}
+	let g = null, _ = null, v = null, y = [], b = null, x = a(), S = l(x), C = !1, w = "", T = !0, E = e(() => {
+		let e = p();
+		if (typeof e == "string" || typeof e == "number") {
+			w = String(e);
+			let t = () => {
+				C = !1, _ &&= (_(), null), g ? g.nodeValue = w : (g = document.createTextNode(w), f.parentNode.insertBefore(g, f));
+			};
+			T ? (T = !1, t()) : C || (C = !0, d(t));
+			return;
+		}
+		if (C = !1, T = !1, g &&= (g.parentNode?.removeChild(g), null), _ &&= (_(), null), !(e == null || e === !1)) if (typeof e == "object" && e && e[t] != null) {
+			let n = e[t];
+			n.mountDom ? _ = n.mountDom({
+				parent: f.parentNode,
+				before: f
+			}) ?? null : (g = document.createTextNode(String(e)), f.parentNode.insertBefore(g, f));
+		} else if (n(e)) _ = e._render(f.parentNode, f);
+		else if (i(e)) _ = c(e, f.parentNode, f, x);
+		else if (r(e)) v || (v = /* @__PURE__ */ new Map(), b = document.createTextNode(""), f.parentNode.insertBefore(b, f)), u({
+			zoneStart: b,
+			anchor: f,
+			state: v,
+			prevOrder: y,
+			list: e,
+			mount: S,
+			onDuplicateKey: (e) => {
+				console.warn(`[elur] repeat(): duplicate key "${e}". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);
+			}
+		});
+		else if (Array.isArray(e)) {
+			let t = [];
+			for (let r of e) if (i(r)) t.push(o(r, f.parentNode, f));
+			else if (n(r)) t.push(r._render(f.parentNode, f));
+			else if (r != null && r !== !1) {
+				let e = document.createTextNode(String(r));
+				f.parentNode.insertBefore(e, f), t.push(() => e.parentNode?.removeChild(e));
+			}
+			_ = () => t.forEach((e) => e());
+		} else g = document.createTextNode(String(e)), f.parentNode.insertBefore(g, f);
+	});
+	m.push(() => {
+		if (E(), _ &&= (_(), null), g &&= (g.parentNode?.removeChild(g), null), v) {
+			for (let e of v.values()) e.cleanup();
+			v = null, b = null;
+		}
+	});
+}
+//#endregion
+export { f as activateNodeBinding };
+
+//# sourceMappingURL=node-binding.js.map

package/dist/lib/elur/template/node-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-binding.js","names":[],"sources":["../../../../src/elur/template/node-binding.ts"],"sourcesContent":["import { effect } from \"../reactivity.js\";\nimport { isElurComponent } from \"../lifecycle.js\";\nimport { _captureContextSnapshot } from \"../context.js\";\nimport type { KEntry } from \"./types.js\";\nimport type { RepeatKey } from \"./keyed.js\";\nimport { isElurTemplate, isKeyedList, ELUR_RENDER_PROTOCOL } from \"./types.js\";\nimport {\n    _mountComponent,\n    _mountComponentWithCtx,\n    _mountComponentDeferred,\n} from \"./mount-helpers.js\";\nimport { createKeyedMount, reconcileKeyedList } from \"./keyed-diff.js\";\nimport { queueDOMWrite } from \"./dom-write.js\";\n\n// =============================================================================\n// --- Reactive node binding ---\n// =============================================================================\n\n/**\n * Activates a reactive node binding at `anchor`.\n * Handles: text, ElurTemplate, ElurComponent, KeyedList, Array, and static values.\n * Pushes dispose functions into `disposes`.\n */\nexport function activateNodeBinding(\n    anchor: Text,\n    value: unknown,\n    disposes: Array<() => void>,\n    postMountHooks: Array<() => void>,\n): void {\n    if (typeof value !== \"function\") {\n        if (value != null && typeof value === \"object\" && (value as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] != null) {\n            const proto = (value as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] as { mountDom?: (ctx: import(\"./types.js\").DomProtocolContext) => (() => void) | void };\n            if (proto.mountDom) {\n                const cleanup = proto.mountDom({\n                    parent: anchor.parentNode!,\n                    before: anchor,\n                });\n                if (cleanup) disposes.push(cleanup);\n                return;\n            }\n        }\n        if (isElurComponent(value)) {\n            _mountComponentDeferred(value, anchor.parentNode!, anchor, postMountHooks, disposes);\n        } else if (isElurTemplate(value)) {\n            disposes.push(value._render(anchor.parentNode!, anchor));\n        } else if (isKeyedList(value)) {\n            // Static keyed list (`repeat(...)` directly, without a getter):\n            // mirror the reactive path so a direct keyed value never falls\n            // through to `String(value)`.\n            const ctxSnapshot = _captureContextSnapshot();\n            const keyedState = new Map<RepeatKey, KEntry>();\n            const keyedZoneStart = document.createTextNode(\"\");\n            anchor.parentNode!.insertBefore(keyedZoneStart, anchor);\n            reconcileKeyedList({\n                zoneStart: keyedZoneStart,\n                anchor,\n                state: keyedState,\n                prevOrder: [],\n                list: value,\n                mount: createKeyedMount(ctxSnapshot),\n                ctxSnapshot,\n                onDuplicateKey: (key) => {\n                    console.warn(`[elur] repeat(): duplicate key \"${key}\". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);\n                },\n            });\n            disposes.push(() => {\n                for (const entry of keyedState.values()) {\n                    entry.cleanup();\n                }\n                keyedState.clear();\n            });\n        } else if (Array.isArray(value)) {\n            for (const item of value) {\n                if (isElurComponent(item)) {\n                    _mountComponentDeferred(item, anchor.parentNode!, anchor, postMountHooks, disposes);\n                } else if (isElurTemplate(item)) {\n                    item._render(anchor.parentNode!, anchor);\n                } else if (item != null && item !== false) {\n                    anchor.parentNode!.insertBefore(\n                        document.createTextNode(String(item)),\n                        anchor\n                    );\n                }\n            }\n        } else if (value != null && value !== false) {\n            anchor.parentNode!.insertBefore(\n                document.createTextNode(String(value)),\n                anchor\n            );\n        }\n        return;\n    }\n\n    // Reactive function path\n    let textNode: Text | null = null;\n    let innerCleanup: (() => void) | null = null;\n\n    type Key = RepeatKey;\n    let keyedState: Map<Key, KEntry> | null = null;\n    let prevKeyOrder: Key[] = [];\n    let keyedZoneStart: Node | null = null;\n\n    const ctxSnapshot = _captureContextSnapshot();\n    const keyedMount = createKeyedMount(ctxSnapshot);\n\n    let _textQueued = false;\n    let _pendingText = \"\";\n    let _isFirstText = true;\n\n    const dispose = effect(() => {\n        const v = (value as () => unknown)();\n\n        if (typeof v === \"string\" || typeof v === \"number\") {\n            _pendingText = String(v);\n\n            const update = () => {\n                _textQueued = false;\n                if (innerCleanup) {\n                    innerCleanup();\n                    innerCleanup = null;\n                }\n                if (!textNode) {\n                    textNode = document.createTextNode(_pendingText);\n                    anchor.parentNode!.insertBefore(textNode, anchor);\n                } else {\n                    textNode.nodeValue = _pendingText;\n                }\n            };\n\n            if (_isFirstText) {\n                _isFirstText = false;\n                update();\n            } else if (!_textQueued) {\n                _textQueued = true;\n                queueDOMWrite(update);\n            }\n            return;\n        }\n\n        _textQueued = false;\n        _isFirstText = false;\n\n        if (textNode) {\n            textNode.parentNode?.removeChild(textNode);\n            textNode = null;\n        }\n        if (innerCleanup) {\n            innerCleanup();\n            innerCleanup = null;\n        }\n\n        if (v == null || v === false) {\n            // Empty\n        } else if (v != null && typeof v === \"object\" && (v as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] != null) {\n            const proto = (v as Record<PropertyKey, unknown>)[ELUR_RENDER_PROTOCOL] as { mountDom?: (ctx: import(\"./types.js\").DomProtocolContext) => (() => void) | void };\n            if (proto.mountDom) {\n                innerCleanup = proto.mountDom({ parent: anchor.parentNode!, before: anchor }) ?? null;\n            } else {\n                textNode = document.createTextNode(String(v));\n                anchor.parentNode!.insertBefore(textNode, anchor);\n            }\n        } else if (isElurTemplate(v)) {\n            innerCleanup = v._render(anchor.parentNode!, anchor);\n        } else if (isElurComponent(v)) {\n            innerCleanup = _mountComponentWithCtx(v, anchor.parentNode!, anchor, ctxSnapshot);\n        } else if (isKeyedList(v)) {\n\n            if (!keyedState) {\n                keyedState = new Map();\n                keyedZoneStart = document.createTextNode(\"\");\n                anchor.parentNode!.insertBefore(keyedZoneStart, anchor);\n            }\n\n            reconcileKeyedList({\n                zoneStart: keyedZoneStart!,\n                anchor,\n                state: keyedState,\n                prevOrder: prevKeyOrder,\n                list: v,\n                mount: keyedMount,\n                onDuplicateKey: (key) => {\n                    console.warn(`[elur] repeat(): duplicate key \"${key}\". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);\n                },\n            });\n        } else if (Array.isArray(v)) {\n            const cleanups: Array<() => void> = [];\n            for (const item of v) {\n                if (isElurComponent(item)) {\n                    cleanups.push(_mountComponent(item, anchor.parentNode!, anchor));\n                } else if (isElurTemplate(item)) {\n                    cleanups.push(item._render(anchor.parentNode!, anchor));\n                } else if (item != null && item !== false) {\n                    const t = document.createTextNode(String(item));\n                    anchor.parentNode!.insertBefore(t, anchor);\n                    cleanups.push(() => t.parentNode?.removeChild(t));\n                }\n            }\n            innerCleanup = () => cleanups.forEach((c) => c());\n        } else {\n            textNode = document.createTextNode(String(v));\n            anchor.parentNode!.insertBefore(textNode, anchor);\n        }\n    });\n\n    disposes.push(() => {\n        dispose();\n        if (innerCleanup) {\n            innerCleanup();\n            innerCleanup = null;\n        }\n        if (textNode) {\n            textNode.parentNode?.removeChild(textNode);\n            textNode = null;\n        }\n        if (keyedState) {\n            for (const entry of keyedState.values()) {\n                entry.cleanup();\n            }\n            keyedState = null;\n            keyedZoneStart = null;\n        }\n    });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+const e=require(`../../lifecycle.cjs`),t=require(`../../context.cjs`),n=require(`./mount-helpers.cjs`);function r(){return{__isPortalOutlet:!0,_container:null}}function i(e){return{__isElurTemplate:!0,mount(e){let t=typeof e==`string`?document.querySelector(e)??document.body:e;return{unmount:this._render(t,null)}},_render(t,n){let r=document.createElement(`div`);return r.setAttribute(`data-elur-outlet`,``),e._container=r,t.insertBefore(r,n),()=>{e._container=null,r.remove()}}}}function a(t,r=document.body){return{__isElurTemplate:!0,mount(e){let t=typeof e==`string`?document.querySelector(e)??document.body:e;return{unmount:this._render(t,null)}},_render(i,a){let o;return o=typeof r==`string`?document.querySelector(r)??document.body:r instanceof Element?r:`__isPortalOutlet`in r?r._container??document.body:r.el??document.body,e.isElurComponent(t)?n._mountComponent(t,o,null):t._render(o,null)}}}var o=t.createInjectionKey(`elur:portal-outlet`);function s(e){t.provide(o,e)}function c(){return t.inject(o)}exports.createPortalOutlet=r,exports.injectOutlet=c,exports.portal=a,exports.portalOutlet=i,exports.provideOutlet=s;
+//# sourceMappingURL=portal.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal.cjs","names":[],"sources":["../../../../src/elur/template/portal.ts"],"sourcesContent":["import { isElurComponent } from \"../lifecycle.js\";\nimport type { ElurComponent } from \"../lifecycle.js\";\nimport { provide, inject, createInjectionKey } from \"../context.js\";\nimport type { ElurTemplate, ElurMountHandle, ElurRef, PortalOutlet } from \"./types.js\";\nimport { _mountComponent } from \"./mount-helpers.js\";\n\n// =============================================================================\n// --- PortalOutlet ---\n// =============================================================================\n\n/** Creates a PortalOutlet token for decoupled portal targeting. */\nexport function createPortalOutlet(): PortalOutlet {\n    return { __isPortalOutlet: true as const, _container: null };\n}\n\n/** Declares the DOM anchor for a PortalOutlet inside a template. */\nexport function portalOutlet(outlet: PortalOutlet): ElurTemplate {\n    return {\n        __isElurTemplate: true as const,\n        mount(container: Element | string): ElurMountHandle {\n            const el =\n                typeof container === \"string\"\n                    ? (document.querySelector(container) ?? document.body)\n                    : container;\n            const cleanup = this._render(el, null);\n            return { unmount: cleanup };\n        },\n        _render(parent: Node, before: Node | null): () => void {\n            const el = document.createElement(\"div\");\n            el.setAttribute(\"data-elur-outlet\", \"\");\n            outlet._container = el;\n            parent.insertBefore(el, before);\n            return () => {\n                outlet._container = null;\n                el.remove();\n            };\n        },\n    };\n}\n\n// =============================================================================\n// --- portal() ---\n// =============================================================================\n\n/**\n * Renders `content` into `target` instead of the current tree position.\n * Useful for modals, tooltips, and overlays that must escape overflow clipping.\n * Returns a ElurTemplate — works inside reactive conditionals.\n *\n * @param content  Template or component to render.\n * @param target   CSS selector, Element, PortalOutlet, or ElurRef. Defaults to `document.body`.\n */\nexport function portal(\n    content: ElurTemplate | ElurComponent,\n    target: Element | string | PortalOutlet | ElurRef<Element> = document.body\n): ElurTemplate {\n    return {\n        __isElurTemplate: true as const,\n\n        mount(container: Element | string): ElurMountHandle {\n            const el =\n                typeof container === \"string\"\n                    ? (document.querySelector(container) ?? document.body)\n                    : container;\n            const cleanup = this._render(el, null);\n            return { unmount: cleanup };\n        },\n\n        _render(_parent: Node, _before: Node | null): () => void {\n            let targetEl: Element;\n            if (typeof target === \"string\") {\n                targetEl = document.querySelector(target) ?? document.body;\n            } else if (target instanceof Element) {\n                targetEl = target;\n            } else if (\"__isPortalOutlet\" in target) {\n                targetEl = (target as PortalOutlet)._container ?? document.body;\n            } else {\n                targetEl = (target as ElurRef<Element>).el ?? document.body;\n            }\n\n            if (isElurComponent(content)) {\n                return _mountComponent(content, targetEl, null);\n            }\n\n            return content._render(targetEl, null);\n        },\n    };\n}\n\n// =============================================================================\n// --- Portal outlet via provide/inject ---\n// =============================================================================\n\nconst _OUTLET_KEY = createInjectionKey<PortalOutlet>(\"elur:portal-outlet\");\n\n/** Provides a PortalOutlet to descendant components via dependency injection. */\nexport function provideOutlet(outlet: PortalOutlet): void {\n    provide(_OUTLET_KEY, outlet);\n}\n\n/** Injects the nearest PortalOutlet provided by an ancestor. */\nexport function injectOutlet(): PortalOutlet | undefined {\n    return inject(_OUTLET_KEY);\n}\n"],"mappings":"uGAWA,SAAgB,GAAmC,CAC/C,MAAO,CAAE,iBAAkB,GAAe,WAAY,KAAM,CAIhE,SAAgB,EAAa,EAAoC,CAC7D,MAAO,CACH,iBAAkB,GAClB,MAAM,EAA8C,CAChD,IAAM,EACF,OAAO,GAAc,SACd,SAAS,cAAc,EAAU,EAAI,SAAS,KAC/C,EAEV,MAAO,CAAE,QADO,KAAK,QAAQ,EAAI,KAAK,CACX,EAE/B,QAAQ,EAAc,EAAiC,CACnD,IAAM,EAAK,SAAS,cAAc,MAAM,CAIxC,OAHA,EAAG,aAAa,mBAAoB,GAAG,CACvC,EAAO,WAAa,EACpB,EAAO,aAAa,EAAI,EAAO,KAClB,CACT,EAAO,WAAa,KACpB,EAAG,QAAQ,GAGtB,CAeL,SAAgB,EACZ,EACA,EAA6D,SAAS,KAC1D,CACZ,MAAO,CACH,iBAAkB,GAElB,MAAM,EAA8C,CAChD,IAAM,EACF,OAAO,GAAc,SACd,SAAS,cAAc,EAAU,EAAI,SAAS,KAC/C,EAEV,MAAO,CAAE,QADO,KAAK,QAAQ,EAAI,KAAK,CACX,EAG/B,QAAQ,EAAe,EAAkC,CACrD,IAAI,EAeJ,MAdA,CAOI,EAPA,OAAO,GAAW,SACP,SAAS,cAAc,EAAO,EAAI,SAAS,KAC/C,aAAkB,QACd,EACJ,qBAAsB,EACjB,EAAwB,YAAc,SAAS,KAE/C,EAA4B,IAAM,SAAS,KAGvD,EAAA,gBAAgB,EAAQ,CACjB,EAAA,gBAAgB,EAAS,EAAU,KAAK,CAG5C,EAAQ,QAAQ,EAAU,KAAK,EAE7C,CAOL,IAAM,EAAc,EAAA,mBAAiC,qBAAqB,CAG1E,SAAgB,EAAc,EAA4B,CACtD,EAAA,QAAQ,EAAa,EAAO,CAIhC,SAAgB,GAAyC,CACrD,OAAO,EAAA,OAAO,EAAY"}

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

@@ -0,0 +1,19 @@
+import type { ElurComponent } from "../lifecycle.js";
+import type { ElurTemplate, ElurRef, PortalOutlet } from "./types.js";
+/** Creates a PortalOutlet token for decoupled portal targeting. */
+export declare function createPortalOutlet(): PortalOutlet;
+/** Declares the DOM anchor for a PortalOutlet inside a template. */
+export declare function portalOutlet(outlet: PortalOutlet): ElurTemplate;
+/**
+ * Renders `content` into `target` instead of the current tree position.
+ * Useful for modals, tooltips, and overlays that must escape overflow clipping.
+ * Returns a ElurTemplate — works inside reactive conditionals.
+ *
+ * @param content  Template or component to render.
+ * @param target   CSS selector, Element, PortalOutlet, or ElurRef. Defaults to `document.body`.
+ */
+export declare function portal(content: ElurTemplate | ElurComponent, target?: Element | string | PortalOutlet | ElurRef<Element>): ElurTemplate;
+/** Provides a PortalOutlet to descendant components via dependency injection. */
+export declare function provideOutlet(outlet: PortalOutlet): void;
+/** Injects the nearest PortalOutlet provided by an ancestor. */
+export declare function injectOutlet(): PortalOutlet | undefined;

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

@@ -0,0 +1,19 @@
+import type { ElurComponent } from "../lifecycle.js";
+import type { ElurTemplate, ElurRef, PortalOutlet } from "./types.js";
+/** Creates a PortalOutlet token for decoupled portal targeting. */
+export declare function createPortalOutlet(): PortalOutlet;
+/** Declares the DOM anchor for a PortalOutlet inside a template. */
+export declare function portalOutlet(outlet: PortalOutlet): ElurTemplate;
+/**
+ * Renders `content` into `target` instead of the current tree position.
+ * Useful for modals, tooltips, and overlays that must escape overflow clipping.
+ * Returns a ElurTemplate — works inside reactive conditionals.
+ *
+ * @param content  Template or component to render.
+ * @param target   CSS selector, Element, PortalOutlet, or ElurRef. Defaults to `document.body`.
+ */
+export declare function portal(content: ElurTemplate | ElurComponent, target?: Element | string | PortalOutlet | ElurRef<Element>): ElurTemplate;
+/** Provides a PortalOutlet to descendant components via dependency injection. */
+export declare function provideOutlet(outlet: PortalOutlet): void;
+/** Injects the nearest PortalOutlet provided by an ancestor. */
+export declare function injectOutlet(): PortalOutlet | undefined;

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

@@ -0,0 +1,49 @@
+import { isElurComponent as e } from "../../lifecycle.js";
+import { createInjectionKey as t, inject as n, provide as r } from "../../context.js";
+import { _mountComponent as i } from "./mount-helpers.js";
+//#region src/elur/template/portal.ts
+function a() {
+	return {
+		__isPortalOutlet: !0,
+		_container: null
+	};
+}
+function o(e) {
+	return {
+		__isElurTemplate: !0,
+		mount(e) {
+			let t = typeof e == "string" ? document.querySelector(e) ?? document.body : e;
+			return { unmount: this._render(t, null) };
+		},
+		_render(t, n) {
+			let r = document.createElement("div");
+			return r.setAttribute("data-elur-outlet", ""), e._container = r, t.insertBefore(r, n), () => {
+				e._container = null, r.remove();
+			};
+		}
+	};
+}
+function s(t, n = document.body) {
+	return {
+		__isElurTemplate: !0,
+		mount(e) {
+			let t = typeof e == "string" ? document.querySelector(e) ?? document.body : e;
+			return { unmount: this._render(t, null) };
+		},
+		_render(r, a) {
+			let o;
+			return o = typeof n == "string" ? document.querySelector(n) ?? document.body : n instanceof Element ? n : "__isPortalOutlet" in n ? n._container ?? document.body : n.el ?? document.body, e(t) ? i(t, o, null) : t._render(o, null);
+		}
+	};
+}
+var c = t("elur:portal-outlet");
+function l(e) {
+	r(c, e);
+}
+function u() {
+	return n(c);
+}
+//#endregion
+export { a as createPortalOutlet, u as injectOutlet, s as portal, o as portalOutlet, l as provideOutlet };
+
+//# sourceMappingURL=portal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","names":[],"sources":["../../../../src/elur/template/portal.ts"],"sourcesContent":["import { isElurComponent } from \"../lifecycle.js\";\nimport type { ElurComponent } from \"../lifecycle.js\";\nimport { provide, inject, createInjectionKey } from \"../context.js\";\nimport type { ElurTemplate, ElurMountHandle, ElurRef, PortalOutlet } from \"./types.js\";\nimport { _mountComponent } from \"./mount-helpers.js\";\n\n// =============================================================================\n// --- PortalOutlet ---\n// =============================================================================\n\n/** Creates a PortalOutlet token for decoupled portal targeting. */\nexport function createPortalOutlet(): PortalOutlet {\n    return { __isPortalOutlet: true as const, _container: null };\n}\n\n/** Declares the DOM anchor for a PortalOutlet inside a template. */\nexport function portalOutlet(outlet: PortalOutlet): ElurTemplate {\n    return {\n        __isElurTemplate: true as const,\n        mount(container: Element | string): ElurMountHandle {\n            const el =\n                typeof container === \"string\"\n                    ? (document.querySelector(container) ?? document.body)\n                    : container;\n            const cleanup = this._render(el, null);\n            return { unmount: cleanup };\n        },\n        _render(parent: Node, before: Node | null): () => void {\n            const el = document.createElement(\"div\");\n            el.setAttribute(\"data-elur-outlet\", \"\");\n            outlet._container = el;\n            parent.insertBefore(el, before);\n            return () => {\n                outlet._container = null;\n                el.remove();\n            };\n        },\n    };\n}\n\n// =============================================================================\n// --- portal() ---\n// =============================================================================\n\n/**\n * Renders `content` into `target` instead of the current tree position.\n * Useful for modals, tooltips, and overlays that must escape overflow clipping.\n * Returns a ElurTemplate — works inside reactive conditionals.\n *\n * @param content  Template or component to render.\n * @param target   CSS selector, Element, PortalOutlet, or ElurRef. Defaults to `document.body`.\n */\nexport function portal(\n    content: ElurTemplate | ElurComponent,\n    target: Element | string | PortalOutlet | ElurRef<Element> = document.body\n): ElurTemplate {\n    return {\n        __isElurTemplate: true as const,\n\n        mount(container: Element | string): ElurMountHandle {\n            const el =\n                typeof container === \"string\"\n                    ? (document.querySelector(container) ?? document.body)\n                    : container;\n            const cleanup = this._render(el, null);\n            return { unmount: cleanup };\n        },\n\n        _render(_parent: Node, _before: Node | null): () => void {\n            let targetEl: Element;\n            if (typeof target === \"string\") {\n                targetEl = document.querySelector(target) ?? document.body;\n            } else if (target instanceof Element) {\n                targetEl = target;\n            } else if (\"__isPortalOutlet\" in target) {\n                targetEl = (target as PortalOutlet)._container ?? document.body;\n            } else {\n                targetEl = (target as ElurRef<Element>).el ?? document.body;\n            }\n\n            if (isElurComponent(content)) {\n                return _mountComponent(content, targetEl, null);\n            }\n\n            return content._render(targetEl, null);\n        },\n    };\n}\n\n// =============================================================================\n// --- Portal outlet via provide/inject ---\n// =============================================================================\n\nconst _OUTLET_KEY = createInjectionKey<PortalOutlet>(\"elur:portal-outlet\");\n\n/** Provides a PortalOutlet to descendant components via dependency injection. */\nexport function provideOutlet(outlet: PortalOutlet): void {\n    provide(_OUTLET_KEY, outlet);\n}\n\n/** Injects the nearest PortalOutlet provided by an ancestor. */\nexport function injectOutlet(): PortalOutlet | undefined {\n    return inject(_OUTLET_KEY);\n}\n"],"mappings":";;;;AAWA,SAAgB,IAAmC;AAC/C,QAAO;EAAE,kBAAkB;EAAe,YAAY;EAAM;;AAIhE,SAAgB,EAAa,GAAoC;AAC7D,QAAO;EACH,kBAAkB;EAClB,MAAM,GAA8C;GAChD,IAAM,IACF,OAAO,KAAc,WACd,SAAS,cAAc,EAAU,IAAI,SAAS,OAC/C;AAEV,UAAO,EAAE,SADO,KAAK,QAAQ,GAAI,KAAK,EACX;;EAE/B,QAAQ,GAAc,GAAiC;GACnD,IAAM,IAAK,SAAS,cAAc,MAAM;AAIxC,UAHA,EAAG,aAAa,oBAAoB,GAAG,EACvC,EAAO,aAAa,GACpB,EAAO,aAAa,GAAI,EAAO,QAClB;AAET,IADA,EAAO,aAAa,MACpB,EAAG,QAAQ;;;EAGtB;;AAeL,SAAgB,EACZ,GACA,IAA6D,SAAS,MAC1D;AACZ,QAAO;EACH,kBAAkB;EAElB,MAAM,GAA8C;GAChD,IAAM,IACF,OAAO,KAAc,WACd,SAAS,cAAc,EAAU,IAAI,SAAS,OAC/C;AAEV,UAAO,EAAE,SADO,KAAK,QAAQ,GAAI,KAAK,EACX;;EAG/B,QAAQ,GAAe,GAAkC;GACrD,IAAI;AAeJ,UAdA,AAOI,IAPA,OAAO,KAAW,WACP,SAAS,cAAc,EAAO,IAAI,SAAS,OAC/C,aAAkB,UACd,IACJ,sBAAsB,IACjB,EAAwB,cAAc,SAAS,OAE/C,EAA4B,MAAM,SAAS,MAGvD,EAAgB,EAAQ,GACjB,EAAgB,GAAS,GAAU,KAAK,GAG5C,EAAQ,QAAQ,GAAU,KAAK;;EAE7C;;AAOL,IAAM,IAAc,EAAiC,qBAAqB;AAG1E,SAAgB,EAAc,GAA4B;AACtD,GAAQ,GAAa,EAAO;;AAIhC,SAAgB,IAAyC;AACrD,QAAO,EAAO,EAAY"}

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

@@ -0,0 +1,2 @@
+const e=require(`./types.cjs`);function t(t){return{[e.ELUR_RENDER_PROTOCOL]:{renderServer(){return t},mountDom({parent:e,before:n}){let r=document.createElement(`template`);r.innerHTML=t;let i=document.createTextNode(``),a=document.createTextNode(``);return e.insertBefore(i,n),e.insertBefore(r.content,n),e.insertBefore(a,n),()=>{let e=i.nextSibling;for(;e&&e!==a;){let t=e.nextSibling;e.parentNode?.removeChild(e),e=t}i.parentNode?.removeChild(i),a.parentNode?.removeChild(a)}},hydrateDom(){return()=>{}}}}}exports.raw=t;
+//# sourceMappingURL=raw.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raw.cjs","names":[],"sources":["../../../../src/elur/template/raw.ts"],"sourcesContent":["import { ELUR_RENDER_PROTOCOL, type ElurRenderProtocol } from \"./types.js\";\n\n/**\n * Marks a string as trusted raw HTML. Only use with sanitized/trusted content;\n * the markup is emitted verbatim on the server and mounted verbatim on the client\n * without escaping. This is the only explicit trusted path for raw HTML.\n */\nexport function raw(htmlString: string): { [ELUR_RENDER_PROTOCOL]: ElurRenderProtocol } {\n    return {\n        [ELUR_RENDER_PROTOCOL]: {\n            renderServer() {\n                return htmlString;\n            },\n            mountDom({ parent, before }) {\n                const template = document.createElement(\"template\");\n                template.innerHTML = htmlString;\n                const start = document.createTextNode(\"\");\n                const end = document.createTextNode(\"\");\n                parent.insertBefore(start, before);\n                parent.insertBefore(template.content, before);\n                parent.insertBefore(end, before);\n                return () => {\n                    let node: Node | null = start.nextSibling;\n                    while (node && node !== end) {\n                        const next = node.nextSibling;\n                        node.parentNode?.removeChild(node);\n                        node = next;\n                    }\n                    start.parentNode?.removeChild(start);\n                    end.parentNode?.removeChild(end);\n                };\n            },\n            hydrateDom() {\n                // The SSR markup is already present in the DOM; nothing to adopt.\n                return () => { };\n            },\n        },\n    };\n}"],"mappings":"+BAOA,SAAgB,EAAI,EAAoE,CACpF,MAAO,EACF,EAAA,sBAAuB,CACpB,cAAe,CACX,OAAO,GAEX,SAAS,CAAE,SAAQ,UAAU,CACzB,IAAM,EAAW,SAAS,cAAc,WAAW,CACnD,EAAS,UAAY,EACrB,IAAM,EAAQ,SAAS,eAAe,GAAG,CACnC,EAAM,SAAS,eAAe,GAAG,CAIvC,OAHA,EAAO,aAAa,EAAO,EAAO,CAClC,EAAO,aAAa,EAAS,QAAS,EAAO,CAC7C,EAAO,aAAa,EAAK,EAAO,KACnB,CACT,IAAI,EAAoB,EAAM,YAC9B,KAAO,GAAQ,IAAS,GAAK,CACzB,IAAM,EAAO,EAAK,YAClB,EAAK,YAAY,YAAY,EAAK,CAClC,EAAO,EAEX,EAAM,YAAY,YAAY,EAAM,CACpC,EAAI,YAAY,YAAY,EAAI,GAGxC,YAAa,CAET,UAAa,IAEpB,CACJ"}

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

@@ -0,0 +1,9 @@
+import { ELUR_RENDER_PROTOCOL, type ElurRenderProtocol } from "./types.js";
+/**
+ * Marks a string as trusted raw HTML. Only use with sanitized/trusted content;
+ * the markup is emitted verbatim on the server and mounted verbatim on the client
+ * without escaping. This is the only explicit trusted path for raw HTML.
+ */
+export declare function raw(htmlString: string): {
+    [ELUR_RENDER_PROTOCOL]: ElurRenderProtocol;
+};

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

@@ -0,0 +1,9 @@
+import { ELUR_RENDER_PROTOCOL, type ElurRenderProtocol } from "./types.js";
+/**
+ * Marks a string as trusted raw HTML. Only use with sanitized/trusted content;
+ * the markup is emitted verbatim on the server and mounted verbatim on the client
+ * without escaping. This is the only explicit trusted path for raw HTML.
+ */
+export declare function raw(htmlString: string): {
+    [ELUR_RENDER_PROTOCOL]: ElurRenderProtocol;
+};

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

@@ -0,0 +1,29 @@
+import { ELUR_RENDER_PROTOCOL as e } from "./types.js";
+//#region src/elur/template/raw.ts
+function t(t) {
+	return { [e]: {
+		renderServer() {
+			return t;
+		},
+		mountDom({ parent: e, before: n }) {
+			let r = document.createElement("template");
+			r.innerHTML = t;
+			let i = document.createTextNode(""), a = document.createTextNode("");
+			return e.insertBefore(i, n), e.insertBefore(r.content, n), e.insertBefore(a, n), () => {
+				let e = i.nextSibling;
+				for (; e && e !== a;) {
+					let t = e.nextSibling;
+					e.parentNode?.removeChild(e), e = t;
+				}
+				i.parentNode?.removeChild(i), a.parentNode?.removeChild(a);
+			};
+		},
+		hydrateDom() {
+			return () => {};
+		}
+	} };
+}
+//#endregion
+export { t as raw };
+
+//# sourceMappingURL=raw.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","names":[],"sources":["../../../../src/elur/template/raw.ts"],"sourcesContent":["import { ELUR_RENDER_PROTOCOL, type ElurRenderProtocol } from \"./types.js\";\n\n/**\n * Marks a string as trusted raw HTML. Only use with sanitized/trusted content;\n * the markup is emitted verbatim on the server and mounted verbatim on the client\n * without escaping. This is the only explicit trusted path for raw HTML.\n */\nexport function raw(htmlString: string): { [ELUR_RENDER_PROTOCOL]: ElurRenderProtocol } {\n    return {\n        [ELUR_RENDER_PROTOCOL]: {\n            renderServer() {\n                return htmlString;\n            },\n            mountDom({ parent, before }) {\n                const template = document.createElement(\"template\");\n                template.innerHTML = htmlString;\n                const start = document.createTextNode(\"\");\n                const end = document.createTextNode(\"\");\n                parent.insertBefore(start, before);\n                parent.insertBefore(template.content, before);\n                parent.insertBefore(end, before);\n                return () => {\n                    let node: Node | null = start.nextSibling;\n                    while (node && node !== end) {\n                        const next = node.nextSibling;\n                        node.parentNode?.removeChild(node);\n                        node = next;\n                    }\n                    start.parentNode?.removeChild(start);\n                    end.parentNode?.removeChild(end);\n                };\n            },\n            hydrateDom() {\n                // The SSR markup is already present in the DOM; nothing to adopt.\n                return () => { };\n            },\n        },\n    };\n}"],"mappings":";;AAOA,SAAgB,EAAI,GAAoE;AACpF,QAAO,GACF,IAAuB;EACpB,eAAe;AACX,UAAO;;EAEX,SAAS,EAAE,WAAQ,aAAU;GACzB,IAAM,IAAW,SAAS,cAAc,WAAW;AACnD,KAAS,YAAY;GACrB,IAAM,IAAQ,SAAS,eAAe,GAAG,EACnC,IAAM,SAAS,eAAe,GAAG;AAIvC,UAHA,EAAO,aAAa,GAAO,EAAO,EAClC,EAAO,aAAa,EAAS,SAAS,EAAO,EAC7C,EAAO,aAAa,GAAK,EAAO,QACnB;IACT,IAAI,IAAoB,EAAM;AAC9B,WAAO,KAAQ,MAAS,IAAK;KACzB,IAAM,IAAO,EAAK;AAElB,KADA,EAAK,YAAY,YAAY,EAAK,EAClC,IAAO;;AAGX,IADA,EAAM,YAAY,YAAY,EAAM,EACpC,EAAI,YAAY,YAAY,EAAI;;;EAGxC,aAAa;AAET,gBAAa;;EAEpB,EACJ"}

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

@@ -0,0 +1,2 @@
+var e=new Set([`href`,`src`,`action`,`formaction`,`xlink:href`,`poster`,`background`,`cite`,`ping`,`data`]);function t(t){return e.has(t.toLowerCase())}function n(e){let t=e.toLowerCase();return t.startsWith(`on`)||t===`srcdoc`}var r=/[\u0000-\u001F\u007F-\u009F\u2028\u2029\uFEFF]/g,i=/^(?:javascript|vbscript|livescript|mocha|data):/i,a=/^data:image\/(?:png|jpe?g|gif|webp|avif|bmp|x-icon|vnd\.microsoft\.icon)[;,]/i;function o(e){let t=e.replace(r,``).trim();return i.test(t)?/^data:/i.test(t)&&a.test(t)?e:(console.warn(`[elur] Blocked attribute URL with unsafe scheme: "${t.slice(0,48)}${t.length>48?`…`:``}"`),``):e}exports.isExecutableAttrName=n,exports.isUrlAttrName=t,exports.sanitizeUrl=o;
+//# sourceMappingURL=sanitize.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.cjs","names":[],"sources":["../../../../src/elur/template/sanitize.ts"],"sourcesContent":["// =============================================================================\n// --- Attribute value sanitization ---\n// =============================================================================\n//\n// Threat model: in Elur the attribute *name* is always authored by the developer\n// (it lives in the static part of the html`` literal and is never interpolated),\n// so it is trusted. The attribute *value* is frequently untrusted (API data,\n// user input, route params). The only attribute family where an untrusted value\n// is interpreted as executable code is URL attributes via the `javascript:`,\n// `vbscript:` and `data:text/html` schemes.\n//\n// Performance: the *classification* (`isUrlAttrName`) runs once per template at\n// compile time (cached in the BindingContext). The actual `sanitizeUrl` runs\n// only for URL attributes and only when their value changes — never for\n// `class`, `style`, `aria-*`, `data-*` or any other attribute.\n\n/**\n * Attributes whose value the browser resolves as a URL. Only these go through\n * `sanitizeUrl`. Everything else (class, style, aria-*, data-*, custom) is\n * untouched and keeps its exact original code path.\n */\nconst URL_ATTRS = new Set([\n    \"href\",\n    \"src\",\n    \"action\",\n    \"formaction\",\n    \"xlink:href\",\n    \"poster\",\n    \"background\",\n    \"cite\",\n    \"ping\",\n    \"data\", // <object data=\"...\">\n]);\n\n/** True if `name` is a URL-bearing attribute that must be scheme-checked. */\nexport function isUrlAttrName(name: string): boolean {\n    return URL_ATTRS.has(name.toLowerCase());\n}\n\n/**\n * True if `name` is an attribute that turns its value into executable code or\n * arbitrary markup (inline event handlers, `srcdoc`). In idiomatic Elur events\n * use `@click` (handled as an event binding, never as an attribute), so an\n * `on*`/`srcdoc` attribute binding is almost always a developer mistake. Used\n * only to emit a warning — never to block.\n */\nexport function isExecutableAttrName(name: string): boolean {\n    const n = name.toLowerCase();\n    return n.startsWith(\"on\") || n === \"srcdoc\";\n}\n\n// Characters the browser strips/ignores while resolving a scheme. Removing them\n// before testing the scheme prevents bypasses like \"java\\tscript:\" or leading\n// control bytes / BOM / line separators.\nconst CONTROL_RE = /[\\u0000-\\u001F\\u007F-\\u009F\\u2028\\u2029\\uFEFF]/g;\n\n// Dangerous URL schemes. `data:` is included because `data:text/html` and\n// `data:image/svg+xml` can execute script; safe raster data URIs are allowed\n// back in below.\nconst UNSAFE_SCHEME_RE = /^(?:javascript|vbscript|livescript|mocha|data):/i;\n\n// Raster image data URIs are safe (cannot execute script). SVG is intentionally\n// excluded because it can carry inline scripts.\nconst SAFE_DATA_RE = /^data:image\\/(?:png|jpe?g|gif|webp|avif|bmp|x-icon|vnd\\.microsoft\\.icon)[;,]/i;\n\n/**\n * Returns the URL unchanged if its scheme is safe; otherwise returns \"\" and\n * warns. Normalizes control characters and surrounding whitespace before the\n * scheme check so that obfuscated payloads cannot slip through.\n */\nexport function sanitizeUrl(raw: string): string {\n    const normalized = raw.replace(CONTROL_RE, \"\").trim();\n\n    if (UNSAFE_SCHEME_RE.test(normalized)) {\n        if (/^data:/i.test(normalized) && SAFE_DATA_RE.test(normalized)) {\n            return raw;\n        }\n        console.warn(\n            `[elur] Blocked attribute URL with unsafe scheme: \"${normalized.slice(0, 48)}${normalized.length > 48 ? \"…\" : \"\"}\"`,\n        );\n        return \"\";\n    }\n\n    return raw;\n}\n"],"mappings":"AAqBA,IAAM,EAAY,IAAI,IAAI,CACtB,OACA,MACA,SACA,aACA,aACA,SACA,aACA,OACA,OACA,OACH,CAAC,CAGF,SAAgB,EAAc,EAAuB,CACjD,OAAO,EAAU,IAAI,EAAK,aAAa,CAAC,CAU5C,SAAgB,EAAqB,EAAuB,CACxD,IAAM,EAAI,EAAK,aAAa,CAC5B,OAAO,EAAE,WAAW,KAAK,EAAI,IAAM,SAMvC,IAAM,EAAa,kDAKb,EAAmB,mDAInB,EAAe,gFAOrB,SAAgB,EAAY,EAAqB,CAC7C,IAAM,EAAa,EAAI,QAAQ,EAAY,GAAG,CAAC,MAAM,CAYrD,OAVI,EAAiB,KAAK,EAAW,CAC7B,UAAU,KAAK,EAAW,EAAI,EAAa,KAAK,EAAW,CACpD,GAEX,QAAQ,KACJ,qDAAqD,EAAW,MAAM,EAAG,GAAG,GAAG,EAAW,OAAS,GAAK,IAAM,GAAG,GACpH,CACM,IAGJ"}

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

@@ -0,0 +1,16 @@
+/** True if `name` is a URL-bearing attribute that must be scheme-checked. */
+export declare function isUrlAttrName(name: string): boolean;
+/**
+ * True if `name` is an attribute that turns its value into executable code or
+ * arbitrary markup (inline event handlers, `srcdoc`). In idiomatic Elur events
+ * use `@click` (handled as an event binding, never as an attribute), so an
+ * `on*`/`srcdoc` attribute binding is almost always a developer mistake. Used
+ * only to emit a warning — never to block.
+ */
+export declare function isExecutableAttrName(name: string): boolean;
+/**
+ * Returns the URL unchanged if its scheme is safe; otherwise returns "" and
+ * warns. Normalizes control characters and surrounding whitespace before the
+ * scheme check so that obfuscated payloads cannot slip through.
+ */
+export declare function sanitizeUrl(raw: string): string;

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

@@ -0,0 +1,16 @@
+/** True if `name` is a URL-bearing attribute that must be scheme-checked. */
+export declare function isUrlAttrName(name: string): boolean;
+/**
+ * True if `name` is an attribute that turns its value into executable code or
+ * arbitrary markup (inline event handlers, `srcdoc`). In idiomatic Elur events
+ * use `@click` (handled as an event binding, never as an attribute), so an
+ * `on*`/`srcdoc` attribute binding is almost always a developer mistake. Used
+ * only to emit a warning — never to block.
+ */
+export declare function isExecutableAttrName(name: string): boolean;
+/**
+ * Returns the URL unchanged if its scheme is safe; otherwise returns "" and
+ * warns. Normalizes control characters and surrounding whitespace before the
+ * scheme check so that obfuscated payloads cannot slip through.
+ */
+export declare function sanitizeUrl(raw: string): string;

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

@@ -0,0 +1,29 @@
+//#region src/elur/template/sanitize.ts
+var e = new Set([
+	"href",
+	"src",
+	"action",
+	"formaction",
+	"xlink:href",
+	"poster",
+	"background",
+	"cite",
+	"ping",
+	"data"
+]);
+function t(t) {
+	return e.has(t.toLowerCase());
+}
+function n(e) {
+	let t = e.toLowerCase();
+	return t.startsWith("on") || t === "srcdoc";
+}
+var r = /[\u0000-\u001F\u007F-\u009F\u2028\u2029\uFEFF]/g, i = /^(?:javascript|vbscript|livescript|mocha|data):/i, a = /^data:image\/(?:png|jpe?g|gif|webp|avif|bmp|x-icon|vnd\.microsoft\.icon)[;,]/i;
+function o(e) {
+	let t = e.replace(r, "").trim();
+	return i.test(t) ? /^data:/i.test(t) && a.test(t) ? e : (console.warn(`[elur] Blocked attribute URL with unsafe scheme: "${t.slice(0, 48)}${t.length > 48 ? "…" : ""}"`), "") : e;
+}
+//#endregion
+export { n as isExecutableAttrName, t as isUrlAttrName, o as sanitizeUrl };
+
+//# sourceMappingURL=sanitize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","names":[],"sources":["../../../../src/elur/template/sanitize.ts"],"sourcesContent":["// =============================================================================\n// --- Attribute value sanitization ---\n// =============================================================================\n//\n// Threat model: in Elur the attribute *name* is always authored by the developer\n// (it lives in the static part of the html`` literal and is never interpolated),\n// so it is trusted. The attribute *value* is frequently untrusted (API data,\n// user input, route params). The only attribute family where an untrusted value\n// is interpreted as executable code is URL attributes via the `javascript:`,\n// `vbscript:` and `data:text/html` schemes.\n//\n// Performance: the *classification* (`isUrlAttrName`) runs once per template at\n// compile time (cached in the BindingContext). The actual `sanitizeUrl` runs\n// only for URL attributes and only when their value changes — never for\n// `class`, `style`, `aria-*`, `data-*` or any other attribute.\n\n/**\n * Attributes whose value the browser resolves as a URL. Only these go through\n * `sanitizeUrl`. Everything else (class, style, aria-*, data-*, custom) is\n * untouched and keeps its exact original code path.\n */\nconst URL_ATTRS = new Set([\n    \"href\",\n    \"src\",\n    \"action\",\n    \"formaction\",\n    \"xlink:href\",\n    \"poster\",\n    \"background\",\n    \"cite\",\n    \"ping\",\n    \"data\", // <object data=\"...\">\n]);\n\n/** True if `name` is a URL-bearing attribute that must be scheme-checked. */\nexport function isUrlAttrName(name: string): boolean {\n    return URL_ATTRS.has(name.toLowerCase());\n}\n\n/**\n * True if `name` is an attribute that turns its value into executable code or\n * arbitrary markup (inline event handlers, `srcdoc`). In idiomatic Elur events\n * use `@click` (handled as an event binding, never as an attribute), so an\n * `on*`/`srcdoc` attribute binding is almost always a developer mistake. Used\n * only to emit a warning — never to block.\n */\nexport function isExecutableAttrName(name: string): boolean {\n    const n = name.toLowerCase();\n    return n.startsWith(\"on\") || n === \"srcdoc\";\n}\n\n// Characters the browser strips/ignores while resolving a scheme. Removing them\n// before testing the scheme prevents bypasses like \"java\\tscript:\" or leading\n// control bytes / BOM / line separators.\nconst CONTROL_RE = /[\\u0000-\\u001F\\u007F-\\u009F\\u2028\\u2029\\uFEFF]/g;\n\n// Dangerous URL schemes. `data:` is included because `data:text/html` and\n// `data:image/svg+xml` can execute script; safe raster data URIs are allowed\n// back in below.\nconst UNSAFE_SCHEME_RE = /^(?:javascript|vbscript|livescript|mocha|data):/i;\n\n// Raster image data URIs are safe (cannot execute script). SVG is intentionally\n// excluded because it can carry inline scripts.\nconst SAFE_DATA_RE = /^data:image\\/(?:png|jpe?g|gif|webp|avif|bmp|x-icon|vnd\\.microsoft\\.icon)[;,]/i;\n\n/**\n * Returns the URL unchanged if its scheme is safe; otherwise returns \"\" and\n * warns. Normalizes control characters and surrounding whitespace before the\n * scheme check so that obfuscated payloads cannot slip through.\n */\nexport function sanitizeUrl(raw: string): string {\n    const normalized = raw.replace(CONTROL_RE, \"\").trim();\n\n    if (UNSAFE_SCHEME_RE.test(normalized)) {\n        if (/^data:/i.test(normalized) && SAFE_DATA_RE.test(normalized)) {\n            return raw;\n        }\n        console.warn(\n            `[elur] Blocked attribute URL with unsafe scheme: \"${normalized.slice(0, 48)}${normalized.length > 48 ? \"…\" : \"\"}\"`,\n        );\n        return \"\";\n    }\n\n    return raw;\n}\n"],"mappings":";AAqBA,IAAM,IAAY,IAAI,IAAI;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACH,CAAC;AAGF,SAAgB,EAAc,GAAuB;AACjD,QAAO,EAAU,IAAI,EAAK,aAAa,CAAC;;AAU5C,SAAgB,EAAqB,GAAuB;CACxD,IAAM,IAAI,EAAK,aAAa;AAC5B,QAAO,EAAE,WAAW,KAAK,IAAI,MAAM;;AAMvC,IAAM,IAAa,mDAKb,IAAmB,oDAInB,IAAe;AAOrB,SAAgB,EAAY,GAAqB;CAC7C,IAAM,IAAa,EAAI,QAAQ,GAAY,GAAG,CAAC,MAAM;AAYrD,QAVI,EAAiB,KAAK,EAAW,GAC7B,UAAU,KAAK,EAAW,IAAI,EAAa,KAAK,EAAW,GACpD,KAEX,QAAQ,KACJ,qDAAqD,EAAW,MAAM,GAAG,GAAG,GAAG,EAAW,SAAS,KAAK,MAAM,GAAG,GACpH,EACM,MAGJ"}