@elurjs/core 3.6.1 → 3.7.0-beta.0

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

@@ -1,410 +1,2 @@
-import { effect as e } from "./signals.js";
-import { ELUR_RENDER_PROTOCOL as t, ELUR_TEMPLATE_DESCRIPTOR as n, isElurTemplate as r, isKeyedList as i } from "./elur/template/types.js";
-import { isElurComponent as a } from "./lifecycle.js";
-import { _captureContextSnapshot as o, _popComponentContext as s, _pushComponentContext as c } from "./context.js";
-import { deserializeRepeatKey as l, normalizeRepeatKey as u, serializeRepeatKey as d } from "./elur/template/keyed.js";
-import { createKeyedMount as f, reconcileKeyedList as p } from "./elur/template/keyed-diff.js";
-import { sanitizeUrl as m } from "./elur/template/sanitize.js";
-import { activateDelegatedEvent as h, isDelegableEvent as g } from "./elur/template/bindings.js";
-//#region src/elur/hydrate/index.ts
-function _(e, t, r = {}) {
-	try {
-		if (a(e)) return v(e, t, r);
-		let i = e[n];
-		return i || j(r, -1, "descriptor", "Template has no hydration descriptor"), { unmount: y(i, t, r) };
-	} catch (n) {
-		if (r.mismatch === "throw") throw n;
-		return r.mismatch !== "remount" && console.warn("[elur] Hydration mismatch; remounting root:", n), t.replaceChildren(), { unmount: a(e) ? e.render()._render(t, null) : e._render(t, null) };
-	}
-}
-function v(e, t, r) {
-	c();
-	let i = () => {};
-	try {
-		try {
-			e.onInit?.();
-		} catch (t) {
-			if (e.onError) e.onError(t);
-			else throw t;
-		}
-		let a = e.render()[n];
-		a || j(r, -1, "descriptor", "Component template has no hydration descriptor"), i = y(a, t, r);
-	} finally {
-		s();
-	}
-	let a = e.onMount?.();
-	return { unmount() {
-		e.onUnmount?.(), typeof a == "function" && a(), i();
-	} };
-}
-function y(e, t, n, r) {
-	let i = b(t, r), a = [];
-	for (let t = 0; t < e.contexts.length; t++) {
-		let r = e.contexts[t], o = e.values[t];
-		if (r.type === "event") {
-			let e = i.events.get(t);
-			e || j(n, t, "event", `Missing event marker ${t}`), e.removeAttribute(`data-elur-e-${t}`), a.push(S(e, r.eventName, r.modifiers, o));
-			continue;
-		}
-		if (r.type === "attr") {
-			let e = i.attributes.get(t);
-			e || j(n, t, "attribute", `Missing attribute marker ${t}`), e.removeAttribute(`data-elur-a-${t}`), a.push(C(e, r.attrName, r.url === !0, o));
-			continue;
-		}
-		let s = i.nodes.get(t);
-		s || j(n, t, "node", `Missing node marker ${t}`);
-		let c = w(s, o, n, i.keyed.get(t), i.arrayItems.get(t));
-		c && a.push(c);
-	}
-	return () => {
-		for (let e = a.length - 1; e >= 0; e--) a[e]();
-	};
-}
-function b(e, t) {
-	let n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), c = [], l = [], u = [], d = document.createTreeWalker(e, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_COMMENT), f;
-	for (; f = d.nextNode();) {
-		if (t && !x(f, t)) continue;
-		if (f.nodeType === Node.COMMENT_NODE) {
-			let e = f, t = /^elur-(\d+)$/.exec(e.data);
-			if (t) {
-				let n = Number(t[1]);
-				c.length === 0 && r.set(n, e), c.push(n);
-				continue;
-			}
-			let i = /^elur-end-(\d+)$/.exec(e.data);
-			if (i) {
-				let t = Number(i[1]);
-				if (c.pop() === t && c.length === 0) {
-					let i = r.get(t);
-					i && n.set(t, {
-						start: i,
-						end: e
-					});
-				}
-				continue;
-			}
-			let a = /^elur-ki:(.+)$/.exec(e.data);
-			if (a) {
-				let t = a[1];
-				l.length === 0 && c.length === 1 ? l.push({
-					start: e,
-					serializedKey: t,
-					parentIndex: c[c.length - 1]
-				}) : l.push({
-					start: e,
-					serializedKey: t,
-					parentIndex: -1
-				});
-				continue;
-			}
-			if (e.data === "elur-ke") {
-				let t = l.pop();
-				if (t) {
-					if (t.parentIndex >= 0) {
-						let n = o.get(t.parentIndex) ?? [];
-						n.push({
-							start: t.start,
-							end: e,
-							serializedKey: t.serializedKey
-						}), o.set(t.parentIndex, n);
-					}
-				} else throw Error("[elur] Hydration marker mismatch: orphan keyed end marker (elur-ke)");
-				continue;
-			}
-			if (e.data === "elur-ai") {
-				u.length === 0 && c.length === 1 ? u.push({
-					start: e,
-					parentIndex: c[c.length - 1]
-				}) : u.push({
-					start: e,
-					parentIndex: -1
-				});
-				continue;
-			}
-			if (e.data === "elur-aiend") {
-				let t = u.pop();
-				if (t && t.parentIndex >= 0) {
-					let n = s.get(t.parentIndex) ?? [];
-					n.push({
-						start: t.start,
-						end: e
-					}), s.set(t.parentIndex, n);
-				}
-				continue;
-			}
-			continue;
-		}
-		if (c.length > 0) continue;
-		let e = f;
-		for (let t of Array.from(e.attributes)) {
-			let n = /^data-elur-e-(\d+)$/.exec(t.name);
-			n && a.set(Number(n[1]), e);
-			let r = /^data-elur-a-(\d+)$/.exec(t.name);
-			r && i.set(Number(r[1]), e);
-		}
-	}
-	return {
-		nodes: n,
-		attributes: i,
-		events: a,
-		keyed: o,
-		arrayItems: s
-	};
-}
-function x(e, t) {
-	let n = document.createRange();
-	return n.setStartAfter(t.start), n.setEndBefore(t.end), n.intersectsNode(e);
-}
-function S(e, t, n, r) {
-	if (typeof r != "function") throw TypeError(`Event "${t}" requires a function`);
-	let i = r;
-	if (g(t) && !n.includes("capture") && !n.includes("once") && document.body.contains(e)) return h(e, t, n, i);
-	let a = {
-		once: n.includes("once"),
-		capture: n.includes("capture"),
-		passive: n.includes("passive")
-	}, o = (e) => {
-		n.includes("prevent") && e.preventDefault(), n.includes("stop") && e.stopPropagation(), !(n.includes("self") && e.target !== e.currentTarget) && i(e);
-	};
-	return e.addEventListener(t, o, a), () => e.removeEventListener(t, o, a);
-}
-function C(t, n, r, i) {
-	if (n === "ref") {
-		let e = i;
-		return e.el = t, () => {
-			e.el = null;
-		};
-	}
-	let a = (n === "value" || n === "checked" || n === "selected") && n in t, o = !0, s = !1, c = (e) => {
-		if (a) if (!o) t[n] = e ?? "";
-		else {
-			let r = t[n];
-			if (String(r) !== String(e ?? "") && !s) {
-				s = !0;
-				let e = n === "checked" || n === "selected" ? "change" : "input";
-				queueMicrotask(() => {
-					s = !1, t.dispatchEvent(new Event(e, { bubbles: !0 }));
-				});
-			}
-		}
-		else if (e == null || e === !1) t.removeAttribute(n);
-		else {
-			let i = r ? m(String(e)) : String(e);
-			t.setAttribute(n, i);
-		}
-		o = !1;
-	};
-	return typeof i == "function" ? e(() => c(i())) : (c(i), () => {});
-}
-function w(t, n, r, a, s) {
-	if (typeof n != "function") return T(t, n, r, a, s);
-	let c = !0, l, u = k(t), d = null, m = o(), h = f(m), g = (e) => {
-		console.warn(`[elur] repeat(): duplicate key "${e}". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);
-	}, _ = e(() => {
-		let e = n();
-		if (i(e)) {
-			if (c && !d) {
-				let n = E(e, a, r);
-				d = {
-					state: n.state,
-					prevOrder: n.prevOrder
-				}, l = n.cleanup, p({
-					zoneStart: t.start,
-					anchor: t.end,
-					state: d.state,
-					prevOrder: d.prevOrder,
-					list: e,
-					mount: h,
-					ctxSnapshot: m,
-					onDuplicateKey: g
-				}), u = null, c = !1;
-				return;
-			}
-			d || (l?.(), A(t), d = {
-				state: /* @__PURE__ */ new Map(),
-				prevOrder: []
-			}, l = () => {
-				for (let e of d.state.values()) e.cleanup();
-			}), p({
-				zoneStart: t.start,
-				anchor: t.end,
-				state: d.state,
-				prevOrder: d.prevOrder,
-				list: e,
-				mount: h,
-				ctxSnapshot: m,
-				onDuplicateKey: g
-			}), u = null, c = !1;
-			return;
-		}
-		d && (l?.(), A(t), d = null, l = void 0), typeof e == "string" || typeof e == "number" || typeof e == "bigint" ? u ? u.nodeValue !== String(e) && (u.nodeValue = String(e)) : (u = document.createTextNode(String(e)), t.end.parentNode.insertBefore(u, t.end)) : c ? l = T(t, e, r, a, s) : (l?.(), A(t), l = O(t, e), u = k(t)), c = !1;
-	});
-	return () => {
-		_(), l?.();
-	};
-}
-function T(e, l, u, d, m) {
-	if (i(l)) {
-		let t = o(), n = E(l, d, u);
-		return p({
-			zoneStart: e.start,
-			anchor: e.end,
-			state: n.state,
-			prevOrder: n.prevOrder,
-			list: l,
-			mount: f(t),
-			ctxSnapshot: t,
-			onDuplicateKey: (e) => {
-				console.warn(`[elur] repeat(): duplicate key "${e}". Keys must be unique; the previous entry leaks (orphaned nodes + live effects).`);
-			}
-		}), n.cleanup;
-	}
-	if (Array.isArray(l)) {
-		let t = [], n = m !== void 0 && m.length > 0;
-		for (let r = 0; r < l.length; r++) {
-			let i = l[r], a = m?.[r];
-			if (n && a) {
-				let e = T(a, i, u);
-				e && t.push(e);
-			} else if (n) {
-				let n = O(e, i);
-				n && t.push(n);
-			} else {
-				let n = T(e, i, u);
-				n && t.push(n);
-			}
-		}
-		return t.length ? () => {
-			for (let e = t.length - 1; e >= 0; e--) t[e]();
-		} : void 0;
-	}
-	if (r(l)) {
-		let t = l[n];
-		return t || j(u, -1, "descriptor", "Nested template has no hydration descriptor"), y(t, e.start.parentNode, u, e);
-	}
-	if (a(l)) {
-		c();
-		let t;
-		try {
-			try {
-				l.onInit?.();
-			} catch (e) {
-				if (l.onError) l.onError(e);
-				else throw e;
-			}
-			let r = l.render()[n];
-			r || j(u, -1, "descriptor", "Nested component has no hydration descriptor");
-			let i = y(r, e.start.parentNode, u, e), a = l.onMount?.();
-			t = () => {
-				l.onUnmount?.(), typeof a == "function" && a(), i();
-			};
-		} finally {
-			s();
-		}
-		return t;
-	}
-	if (typeof l == "object" && l) {
-		let n = l[t];
-		if (n?.hydrateDom) return n.hydrateDom({
-			parent: e.start.parentNode,
-			bounds: e,
-			context: u.context,
-			render: (t) => T(e, t, u)
-		}) ?? void 0;
-	}
-}
-function E(e, t, n) {
-	let r = /* @__PURE__ */ new Map(), i = [];
-	if (!t || t.length === 0) return {
-		state: r,
-		prevOrder: i,
-		cleanup: () => {}
-	};
-	let a = /* @__PURE__ */ new Map();
-	for (let t = 0; t < e.items.length; t++) {
-		let n = u(e.keyFn(e.items[t], t), t), r = d(n);
-		a.has(r) && console.warn(`[elur] repeat(): duplicate client key "${n}" during hydration. Keys must be unique; entries after the first leak.`), a.set(r, t);
-	}
-	for (let o of t) {
-		let t = a.get(o.serializedKey);
-		if (t === void 0) {
-			D(o);
-			continue;
-		}
-		let s = e.items[t], c = u(e.keyFn(s, t), t);
-		if (d(c) !== o.serializedKey && console.warn(`[elur] repeat(): hydration key mismatch at index ${t} (${l(o.serializedKey)} != ${c}). The SSR item is adopted by position.`), r.has(c)) {
-			console.warn(`[elur] repeat(): duplicate key "${c}" during hydration; removing duplicate SSR node.`), D(o);
-			continue;
-		}
-		let f = e.renderFn(s, t), p = T({
-			start: o.start,
-			end: o.end
-		}, f, n);
-		r.set(c, {
-			start: o.start,
-			end: o.end,
-			cleanup: p ?? (() => {})
-		}), i.push(c);
-	}
-	return {
-		state: r,
-		prevOrder: i,
-		cleanup: () => {
-			for (let e of r.values()) e.cleanup();
-		}
-	};
-}
-function D(e) {
-	let t = e.start.nextSibling;
-	for (; t && t !== e.end;) {
-		let e = t.nextSibling;
-		t.parentNode?.removeChild(t), t = e;
-	}
-	e.start.parentNode?.removeChild(e.start), e.end.parentNode?.removeChild(e.end);
-}
-function O(e, t) {
-	if (t == null || t === !1 || t === !0) return;
-	if (Array.isArray(t)) {
-		let n = [];
-		for (let r of t) {
-			let t = O(e, r);
-			t && n.push(t);
-		}
-		return n.length ? () => {
-			for (let e = n.length - 1; e >= 0; e--) n[e]();
-		} : void 0;
-	}
-	if (r(t)) return t._render(e.end.parentNode, e.end);
-	if (a(t)) return t.render()._render(e.end.parentNode, e.end);
-	let n = document.createTextNode(String(t));
-	return e.end.parentNode.insertBefore(n, e.end), () => n.parentNode?.removeChild(n);
-}
-function k(e) {
-	let t = e.start.nextSibling;
-	for (; t && t !== e.end;) {
-		if (t.nodeType === Node.TEXT_NODE) return t;
-		t = t.nextSibling;
-	}
-	return null;
-}
-function A(e) {
-	let t = e.start.nextSibling;
-	for (; t && t !== e.end;) {
-		let e = t.nextSibling;
-		t.parentNode?.removeChild(t), t = e;
-	}
-}
-function j(e, t, n, r) {
-	let i = {
-		index: t,
-		kind: n,
-		message: r
-	};
-	e.onMismatch?.(i);
-	let a = /* @__PURE__ */ Error(`[elur] Hydration marker mismatch: ${r}`);
-	throw Object.assign(a, { mismatch: i }), a;
-}
-//#endregion
-export { _ as hydrate };
-
-//# sourceMappingURL=hydrate.js.map
+import { _hydrateNodeRange as e, hydrate as t } from "./elur/next-2/hydrate.js";
+export { e as _hydrateNodeRange, t as hydrate };

package/dist/lib/elur/lifecycle.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{__isElurComponent=!0;children;_debugName;_slots=new Map;setChildren(e){return this.children=e,this}setSlot(e,t){return this._slots.set(e,t),this}slot(e){return this._slots.get(e)}setDebugName(e){return this._debugName=e,this}};function t(e){return typeof e==`object`&&!!e&&e.__isElurComponent===!0}var n=Symbol.for(`@elurjs/core/reactivity-state`);function r(){let e=globalThis,t=e[n];return t||(t={},e[n]=t),t}function i(e){let t=e.componentDebugHookSet;if(!t||t.size===0){e.componentDebugHooks=null;return}if(t.size===1){e.componentDebugHooks=t.values().next().value??null;return}e.componentDebugHooks={onMountStart(e){for(let n of t)n.onMountStart?.(e)},onMountEnd(e){for(let n of t)n.onMountEnd?.(e)},onUnmount(e){for(let n of t)n.onUnmount?.(e)}}}function a(e){let t=r(),n=new Set;e&&n.add(e),t.componentDebugHookSet=n,i(t)}function o(e){let t=r(),n=t.componentDebugHookSet;return n||(n=new Set,t.componentDebugHooks&&n.add(t.componentDebugHooks),t.componentDebugHookSet=n),n.add(e),i(t),()=>{n.delete(e),i(t)}}function s(e){r().componentDebugHooks?.onMountStart?.(e)}function c(e){r().componentDebugHooks?.onMountEnd?.(e)}function l(e){r().componentDebugHooks?.onUnmount?.(e)}exports.ElurComponent=e,exports._addComponentDebugHooks=o,exports._debugComponentMountEnd=c,exports._debugComponentMountStart=s,exports._debugComponentUnmount=l,exports._setComponentDebugHooks=a,exports.isElurComponent=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{__isElurComponent=!0;children;_debugName;_slots=new Map;setChildren(e){return this.children=e,this}setSlot(e,t){return this._slots.set(e,t),this}slot(e){return this._slots.get(e)}_controllers;addController(e){(this._controllers??=[]).push(e)}setDebugName(e){return this._debugName=e,this}};function t(e){return typeof e==`object`&&!!e&&e.__isElurComponent===!0}var n=Symbol.for(`@elurjs/core/reactivity-state`);function r(){let e=globalThis,t=e[n];return t||(t={},e[n]=t),t}function i(e){let t=e.componentDebugHookSet;if(!t||t.size===0){e.componentDebugHooks=null;return}if(t.size===1){e.componentDebugHooks=t.values().next().value??null;return}e.componentDebugHooks={onMountStart(e){for(let n of t)n.onMountStart?.(e)},onMountEnd(e){for(let n of t)n.onMountEnd?.(e)},onUnmount(e){for(let n of t)n.onUnmount?.(e)}}}function a(e){let t=r(),n=new Set;e&&n.add(e),t.componentDebugHookSet=n,i(t)}function o(e){let t=r(),n=t.componentDebugHookSet;return n||(n=new Set,t.componentDebugHooks&&n.add(t.componentDebugHooks),t.componentDebugHookSet=n),n.add(e),i(t),()=>{n.delete(e),i(t)}}function s(e){r().componentDebugHooks?.onMountStart?.(e)}function c(e){r().componentDebugHooks?.onMountEnd?.(e)}function l(e){r().componentDebugHooks?.onUnmount?.(e)}exports.ElurComponent=e,exports._addComponentDebugHooks=o,exports._debugComponentMountEnd=c,exports._debugComponentMountStart=s,exports._debugComponentUnmount=l,exports._setComponentDebugHooks=a,exports.isElurComponent=t;
 //# sourceMappingURL=lifecycle.cjs.map

package/dist/lib/elur/lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.cjs","names":[],"sources":["../../src/elur/lifecycle.ts"],"sourcesContent":["import type { ElurTemplate } from \"./template/index.js\";\n\n// --- ElurChildren ---\n\n/** Valid child content for components. */\nexport type ElurChildren =\n    | ElurTemplate\n    | ElurComponent\n    | Array<ElurTemplate | ElurComponent>\n    | null\n    | undefined;\n\n// --- ElurComponent ---\n\n/** Base class for components with lifecycle hooks. */\nexport abstract class ElurComponent {\n    /** @internal */\n    readonly __isElurComponent = true as const;\n\n    /** Default slot — child content injected by the parent. */\n    children?: ElurChildren;\n\n    /** Optional label used by devtools. Falls back to class name. */\n    _debugName?: string;\n\n    /** @internal */\n    private _slots = new Map<string, ElurChildren>();\n\n    /** Sets the default slot content. Returns `this` for chaining. */\n    setChildren(content: ElurChildren): this {\n        this.children = content;\n        return this;\n    }\n\n    /** Sets a named slot. Returns `this` for chaining. */\n    setSlot(name: string, content: ElurChildren): this {\n        this._slots.set(name, content);\n        return this;\n    }\n\n    /** Returns content for a named slot. */\n    slot(name: string): ElurChildren {\n        return this._slots.get(name);\n    }\n\n    /** Sets an explicit devtools display name. Returns `this` for chaining. */\n    setDebugName(name: string): this {\n        this._debugName = name;\n        return this;\n    }\n\n    /** Returns the component template. Called once on mount; updates happen via signals. */\n    abstract render(): ElurTemplate;\n\n    /** Called before `render()` — no DOM yet. Errors are caught by `onError` if present. */\n    onInit?(): void;\n\n    /** Server-only lifecycle hook. Runs during SSR after `onInit()`; never on the client. */\n    onServerRender?(): void;\n\n    /** Called after DOM insertion. May return a cleanup function. */\n    onMount?(): (() => void) | void;\n\n    /** Called before DOM removal. */\n    onUnmount?(): void;\n\n    /** Catches errors thrown in `onInit` and `onMount`. */\n    onError?(err: unknown): void;\n}\n\n// --- Type guard ---\n\n/** @internal */\nexport function isElurComponent(v: unknown): v is ElurComponent {\n    return (\n        v != null &&\n        typeof v === \"object\" &&\n        (v as Record<string, unknown>).__isElurComponent === true\n    );\n}\n\n// --- Devtools component tracking (internal) ---\n\nexport interface _ComponentDebugHooks {\n    onMountStart?: (inst: ElurComponent) => void;\n    onMountEnd?: (inst: ElurComponent) => void;\n    onUnmount?: (inst: ElurComponent) => void;\n}\n\n/**\n * The registry lives in the shared reactivity global state\n * (`Symbol.for(\"@elurjs/core/reactivity-state\")`) rather than in module-local\n * state, so hooks work even when the package ends up duplicated in a bundle.\n */\ninterface _ComponentHookState {\n    componentDebugHooks?: _ComponentDebugHooks | null;\n    componentDebugHookSet?: Set<_ComponentDebugHooks>;\n}\n\nconst _reactivityStateKey = Symbol.for(\"@elurjs/core/reactivity-state\");\n\nfunction _hookState(): _ComponentHookState {\n    const g = globalThis as Record<PropertyKey, unknown>;\n    let state = g[_reactivityStateKey] as _ComponentHookState | undefined;\n    if (!state) {\n        // reactivity.ts merges its defaults into this object when it loads.\n        state = {};\n        g[_reactivityStateKey] = state;\n    }\n    return state;\n}\n\n/** Single dispatcher on the hot path; the set is only for bookkeeping. */\nfunction _syncComponentDebugHooks(state: _ComponentHookState): void {\n    const set = state.componentDebugHookSet;\n    if (!set || set.size === 0) {\n        state.componentDebugHooks = null;\n        return;\n    }\n    if (set.size === 1) {\n        state.componentDebugHooks = set.values().next().value ?? null;\n        return;\n    }\n    state.componentDebugHooks = {\n        onMountStart(inst) {\n            for (const hooks of set) hooks.onMountStart?.(inst);\n        },\n        onMountEnd(inst) {\n            for (const hooks of set) hooks.onMountEnd?.(inst);\n        },\n        onUnmount(inst) {\n            for (const hooks of set) hooks.onUnmount?.(inst);\n        },\n    };\n}\n\nexport function _setComponentDebugHooks(hooks: _ComponentDebugHooks | null): void {\n    const state = _hookState();\n    const set = new Set<_ComponentDebugHooks>();\n    if (hooks) set.add(hooks);\n    state.componentDebugHookSet = set;\n    _syncComponentDebugHooks(state);\n}\n\n/**\n * @internal — Adds a component debug hook subscriber WITHOUT replacing\n * existing ones (unlike `_setComponentDebugHooks`). Returns an unsubscribe\n * function. Zero cost when no subscribers are registered.\n */\nexport function _addComponentDebugHooks(hooks: _ComponentDebugHooks): () => void {\n    const state = _hookState();\n    let set = state.componentDebugHookSet;\n    if (!set) {\n        set = new Set<_ComponentDebugHooks>();\n        if (state.componentDebugHooks) set.add(state.componentDebugHooks);\n        state.componentDebugHookSet = set;\n    }\n    set.add(hooks);\n    _syncComponentDebugHooks(state);\n    return () => {\n        set.delete(hooks);\n        _syncComponentDebugHooks(state);\n    };\n}\n\nexport function _debugComponentMountStart(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountStart?.(inst);\n}\n\nexport function _debugComponentMountEnd(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountEnd?.(inst);\n}\n\nexport function _debugComponentUnmount(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onUnmount?.(inst);\n}\n"],"mappings":"mEAeA,IAAsB,EAAtB,KAAoC,CAEhC,kBAA6B,GAG7B,SAGA,WAGA,OAAiB,IAAI,IAGrB,YAAY,EAA6B,CAErC,MADA,MAAK,SAAW,EACT,KAIX,QAAQ,EAAc,EAA6B,CAE/C,OADA,KAAK,OAAO,IAAI,EAAM,EAAQ,CACvB,KAIX,KAAK,EAA4B,CAC7B,OAAO,KAAK,OAAO,IAAI,EAAK,CAIhC,aAAa,EAAoB,CAE7B,MADA,MAAK,WAAa,EACX,OAyBf,SAAgB,EAAgB,EAAgC,CAC5D,OAEI,OAAO,GAAM,YADb,GAEC,EAA8B,oBAAsB,GAsB7D,IAAM,EAAsB,OAAO,IAAI,gCAAgC,CAEvE,SAAS,GAAkC,CACvC,IAAM,EAAI,WACN,EAAQ,EAAE,GAMd,OALK,IAED,EAAQ,EAAE,CACV,EAAE,GAAuB,GAEtB,EAIX,SAAS,EAAyB,EAAkC,CAChE,IAAM,EAAM,EAAM,sBAClB,GAAI,CAAC,GAAO,EAAI,OAAS,EAAG,CACxB,EAAM,oBAAsB,KAC5B,OAEJ,GAAI,EAAI,OAAS,EAAG,CAChB,EAAM,oBAAsB,EAAI,QAAQ,CAAC,MAAM,CAAC,OAAS,KACzD,OAEJ,EAAM,oBAAsB,CACxB,aAAa,EAAM,CACf,IAAK,IAAM,KAAS,EAAK,EAAM,eAAe,EAAK,EAEvD,WAAW,EAAM,CACb,IAAK,IAAM,KAAS,EAAK,EAAM,aAAa,EAAK,EAErD,UAAU,EAAM,CACZ,IAAK,IAAM,KAAS,EAAK,EAAM,YAAY,EAAK,EAEvD,CAGL,SAAgB,EAAwB,EAA0C,CAC9E,IAAM,EAAQ,GAAY,CACpB,EAAM,IAAI,IACZ,GAAO,EAAI,IAAI,EAAM,CACzB,EAAM,sBAAwB,EAC9B,EAAyB,EAAM,CAQnC,SAAgB,EAAwB,EAAyC,CAC7E,IAAM,EAAQ,GAAY,CACtB,EAAM,EAAM,sBAQhB,OAPK,IACD,EAAM,IAAI,IACN,EAAM,qBAAqB,EAAI,IAAI,EAAM,oBAAoB,CACjE,EAAM,sBAAwB,GAElC,EAAI,IAAI,EAAM,CACd,EAAyB,EAAM,KAClB,CACT,EAAI,OAAO,EAAM,CACjB,EAAyB,EAAM,EAIvC,SAAgB,EAA0B,EAA2B,CACjE,GAAY,CAAC,qBAAqB,eAAe,EAAK,CAG1D,SAAgB,EAAwB,EAA2B,CAC/D,GAAY,CAAC,qBAAqB,aAAa,EAAK,CAGxD,SAAgB,EAAuB,EAA2B,CAC9D,GAAY,CAAC,qBAAqB,YAAY,EAAK"}
+{"version":3,"file":"lifecycle.cjs","names":[],"sources":["../../src/elur/lifecycle.ts"],"sourcesContent":["import type { ElurTemplate } from \"./template/index.js\";\n\n// --- ElurChildren ---\n\n/** Valid child content for components. */\nexport type ElurChildren =\n    | ElurTemplate\n    | ElurComponent\n    | Array<ElurTemplate | ElurComponent>\n    | null\n    | undefined;\n\n// --- ElurComponent ---\n\n/** Base class for components with lifecycle hooks. */\n/**\n * A.21: controller de ciclo de vida (patrón Lit) — lógica reutilizable\n * enganchada a la instancia (ResizeObserver, focus, recursos, Ionic…).\n * Los hooks corren dentro del owner del componente.\n */\nexport interface ComponentController {\n    /** Antes de render() — sin DOM. */\n    hostInit?(): void;\n    /** Tras el commit DOM. */\n    hostMounted?(): void;\n    /** attach() — la instancia vuelve al DOM. */\n    hostActivate?(): void;\n    /** detach() — la instancia sale del DOM sin disponerse. */\n    hostDeactivate?(): void;\n    /** Antes del disposal del owner. */\n    hostUnmount?(): void;\n}\n\nexport abstract class ElurComponent {\n    /** @internal */\n    readonly __isElurComponent = true as const;\n\n    /** Default slot — child content injected by the parent. */\n    children?: ElurChildren;\n\n    /** Optional label used by devtools. Falls back to class name. */\n    _debugName?: string;\n\n    /** @internal */\n    private _slots = new Map<string, ElurChildren>();\n\n    /** Sets the default slot content. Returns `this` for chaining. */\n    setChildren(content: ElurChildren): this {\n        this.children = content;\n        return this;\n    }\n\n    /** Sets a named slot. Returns `this` for chaining. */\n    setSlot(name: string, content: ElurChildren): this {\n        this._slots.set(name, content);\n        return this;\n    }\n\n    /** Returns content for a named slot. */\n    slot(name: string): ElurChildren {\n        return this._slots.get(name);\n    }\n\n    /**\n     * A.21: controllers registrados — consumidos por el kernel en mount.\n     * @internal\n     */\n    _controllers?: ComponentController[];\n\n    /**\n     * A.21: registra un controller (patrón Lit). Llamar en el constructor;\n     * los hooks corren dentro del owner de la instancia.\n     */\n    addController(c: ComponentController): void {\n        (this._controllers ??= []).push(c);\n    }\n\n    /** Sets an explicit devtools display name. Returns `this` for chaining. */\n    setDebugName(name: string): this {\n        this._debugName = name;\n        return this;\n    }\n\n    /** Returns the component template. Called once on mount; updates happen via signals. */\n    abstract render(): ElurTemplate;\n\n    /** Called before `render()` — no DOM yet. Errors are caught by `onError` if present. */\n    onInit?(): void;\n\n    /** Server-only lifecycle hook. Runs during SSR after `onInit()`; never on the client. */\n    onServerRender?(): void;\n\n    /** Called after DOM insertion. May return a cleanup function. */\n    onMount?(): (() => void) | void;\n\n    /** Called before DOM removal. */\n    onUnmount?(): void;\n\n    /** Catches errors thrown in `onInit` and `onMount`. */\n    onError?(err: unknown): void;\n}\n\n// --- Type guard ---\n\n/** @internal */\nexport function isElurComponent(v: unknown): v is ElurComponent {\n    return (\n        v != null &&\n        typeof v === \"object\" &&\n        (v as Record<string, unknown>).__isElurComponent === true\n    );\n}\n\n// --- Devtools component tracking (internal) ---\n\nexport interface _ComponentDebugHooks {\n    onMountStart?: (inst: ElurComponent) => void;\n    onMountEnd?: (inst: ElurComponent) => void;\n    onUnmount?: (inst: ElurComponent) => void;\n}\n\n/**\n * The registry lives in the shared reactivity global state\n * (`Symbol.for(\"@elurjs/core/reactivity-state\")`) rather than in module-local\n * state, so hooks work even when the package ends up duplicated in a bundle.\n */\ninterface _ComponentHookState {\n    componentDebugHooks?: _ComponentDebugHooks | null;\n    componentDebugHookSet?: Set<_ComponentDebugHooks>;\n}\n\nconst _reactivityStateKey = Symbol.for(\"@elurjs/core/reactivity-state\");\n\nfunction _hookState(): _ComponentHookState {\n    const g = globalThis as Record<PropertyKey, unknown>;\n    let state = g[_reactivityStateKey] as _ComponentHookState | undefined;\n    if (!state) {\n        // reactivity.ts merges its defaults into this object when it loads.\n        state = {};\n        g[_reactivityStateKey] = state;\n    }\n    return state;\n}\n\n/** Single dispatcher on the hot path; the set is only for bookkeeping. */\nfunction _syncComponentDebugHooks(state: _ComponentHookState): void {\n    const set = state.componentDebugHookSet;\n    if (!set || set.size === 0) {\n        state.componentDebugHooks = null;\n        return;\n    }\n    if (set.size === 1) {\n        state.componentDebugHooks = set.values().next().value ?? null;\n        return;\n    }\n    state.componentDebugHooks = {\n        onMountStart(inst) {\n            for (const hooks of set) hooks.onMountStart?.(inst);\n        },\n        onMountEnd(inst) {\n            for (const hooks of set) hooks.onMountEnd?.(inst);\n        },\n        onUnmount(inst) {\n            for (const hooks of set) hooks.onUnmount?.(inst);\n        },\n    };\n}\n\nexport function _setComponentDebugHooks(hooks: _ComponentDebugHooks | null): void {\n    const state = _hookState();\n    const set = new Set<_ComponentDebugHooks>();\n    if (hooks) set.add(hooks);\n    state.componentDebugHookSet = set;\n    _syncComponentDebugHooks(state);\n}\n\n/**\n * @internal — Adds a component debug hook subscriber WITHOUT replacing\n * existing ones (unlike `_setComponentDebugHooks`). Returns an unsubscribe\n * function. Zero cost when no subscribers are registered.\n */\nexport function _addComponentDebugHooks(hooks: _ComponentDebugHooks): () => void {\n    const state = _hookState();\n    let set = state.componentDebugHookSet;\n    if (!set) {\n        set = new Set<_ComponentDebugHooks>();\n        if (state.componentDebugHooks) set.add(state.componentDebugHooks);\n        state.componentDebugHookSet = set;\n    }\n    set.add(hooks);\n    _syncComponentDebugHooks(state);\n    return () => {\n        set.delete(hooks);\n        _syncComponentDebugHooks(state);\n    };\n}\n\nexport function _debugComponentMountStart(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountStart?.(inst);\n}\n\nexport function _debugComponentMountEnd(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountEnd?.(inst);\n}\n\nexport function _debugComponentUnmount(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onUnmount?.(inst);\n}\n"],"mappings":"mEAiCA,IAAsB,EAAtB,KAAoC,CAEhC,kBAA6B,GAG7B,SAGA,WAGA,OAAiB,IAAI,IAGrB,YAAY,EAA6B,CAErC,MADA,MAAK,SAAW,EACT,KAIX,QAAQ,EAAc,EAA6B,CAE/C,OADA,KAAK,OAAO,IAAI,EAAM,EAAQ,CACvB,KAIX,KAAK,EAA4B,CAC7B,OAAO,KAAK,OAAO,IAAI,EAAK,CAOhC,aAMA,cAAc,EAA8B,EACvC,KAAK,eAAiB,EAAE,EAAE,KAAK,EAAE,CAItC,aAAa,EAAoB,CAE7B,MADA,MAAK,WAAa,EACX,OAyBf,SAAgB,EAAgB,EAAgC,CAC5D,OAEI,OAAO,GAAM,YADb,GAEC,EAA8B,oBAAsB,GAsB7D,IAAM,EAAsB,OAAO,IAAI,gCAAgC,CAEvE,SAAS,GAAkC,CACvC,IAAM,EAAI,WACN,EAAQ,EAAE,GAMd,OALK,IAED,EAAQ,EAAE,CACV,EAAE,GAAuB,GAEtB,EAIX,SAAS,EAAyB,EAAkC,CAChE,IAAM,EAAM,EAAM,sBAClB,GAAI,CAAC,GAAO,EAAI,OAAS,EAAG,CACxB,EAAM,oBAAsB,KAC5B,OAEJ,GAAI,EAAI,OAAS,EAAG,CAChB,EAAM,oBAAsB,EAAI,QAAQ,CAAC,MAAM,CAAC,OAAS,KACzD,OAEJ,EAAM,oBAAsB,CACxB,aAAa,EAAM,CACf,IAAK,IAAM,KAAS,EAAK,EAAM,eAAe,EAAK,EAEvD,WAAW,EAAM,CACb,IAAK,IAAM,KAAS,EAAK,EAAM,aAAa,EAAK,EAErD,UAAU,EAAM,CACZ,IAAK,IAAM,KAAS,EAAK,EAAM,YAAY,EAAK,EAEvD,CAGL,SAAgB,EAAwB,EAA0C,CAC9E,IAAM,EAAQ,GAAY,CACpB,EAAM,IAAI,IACZ,GAAO,EAAI,IAAI,EAAM,CACzB,EAAM,sBAAwB,EAC9B,EAAyB,EAAM,CAQnC,SAAgB,EAAwB,EAAyC,CAC7E,IAAM,EAAQ,GAAY,CACtB,EAAM,EAAM,sBAQhB,OAPK,IACD,EAAM,IAAI,IACN,EAAM,qBAAqB,EAAI,IAAI,EAAM,oBAAoB,CACjE,EAAM,sBAAwB,GAElC,EAAI,IAAI,EAAM,CACd,EAAyB,EAAM,KAClB,CACT,EAAI,OAAO,EAAM,CACjB,EAAyB,EAAM,EAIvC,SAAgB,EAA0B,EAA2B,CACjE,GAAY,CAAC,qBAAqB,eAAe,EAAK,CAG1D,SAAgB,EAAwB,EAA2B,CAC/D,GAAY,CAAC,qBAAqB,aAAa,EAAK,CAGxD,SAAgB,EAAuB,EAA2B,CAC9D,GAAY,CAAC,qBAAqB,YAAY,EAAK"}

package/dist/lib/elur/lifecycle.d.cts

@@ -2,6 +2,23 @@ import type { ElurTemplate } from "./template/index.js";
 /** Valid child content for components. */
 export type ElurChildren = ElurTemplate | ElurComponent | Array<ElurTemplate | ElurComponent> | null | undefined;
 /** Base class for components with lifecycle hooks. */
+/**
+ * A.21: controller de ciclo de vida (patrón Lit) — lógica reutilizable
+ * enganchada a la instancia (ResizeObserver, focus, recursos, Ionic…).
+ * Los hooks corren dentro del owner del componente.
+ */
+export interface ComponentController {
+    /** Antes de render() — sin DOM. */
+    hostInit?(): void;
+    /** Tras el commit DOM. */
+    hostMounted?(): void;
+    /** attach() — la instancia vuelve al DOM. */
+    hostActivate?(): void;
+    /** detach() — la instancia sale del DOM sin disponerse. */
+    hostDeactivate?(): void;
+    /** Antes del disposal del owner. */
+    hostUnmount?(): void;
+}
 export declare abstract class ElurComponent {
     /** @internal */
     readonly __isElurComponent: true;
@@ -17,6 +34,16 @@ export declare abstract class ElurComponent {
     setSlot(name: string, content: ElurChildren): this;
     /** Returns content for a named slot. */
     slot(name: string): ElurChildren;
+    /**
+     * A.21: controllers registrados — consumidos por el kernel en mount.
+     * @internal
+     */
+    _controllers?: ComponentController[];
+    /**
+     * A.21: registra un controller (patrón Lit). Llamar en el constructor;
+     * los hooks corren dentro del owner de la instancia.
+     */
+    addController(c: ComponentController): void;
     /** Sets an explicit devtools display name. Returns `this` for chaining. */
     setDebugName(name: string): this;
     /** Returns the component template. Called once on mount; updates happen via signals. */

package/dist/lib/elur/lifecycle.d.ts

@@ -2,6 +2,23 @@ import type { ElurTemplate } from "./template/index.js";
 /** Valid child content for components. */
 export type ElurChildren = ElurTemplate | ElurComponent | Array<ElurTemplate | ElurComponent> | null | undefined;
 /** Base class for components with lifecycle hooks. */
+/**
+ * A.21: controller de ciclo de vida (patrón Lit) — lógica reutilizable
+ * enganchada a la instancia (ResizeObserver, focus, recursos, Ionic…).
+ * Los hooks corren dentro del owner del componente.
+ */
+export interface ComponentController {
+    /** Antes de render() — sin DOM. */
+    hostInit?(): void;
+    /** Tras el commit DOM. */
+    hostMounted?(): void;
+    /** attach() — la instancia vuelve al DOM. */
+    hostActivate?(): void;
+    /** detach() — la instancia sale del DOM sin disponerse. */
+    hostDeactivate?(): void;
+    /** Antes del disposal del owner. */
+    hostUnmount?(): void;
+}
 export declare abstract class ElurComponent {
     /** @internal */
     readonly __isElurComponent: true;
@@ -17,6 +34,16 @@ export declare abstract class ElurComponent {
     setSlot(name: string, content: ElurChildren): this;
     /** Returns content for a named slot. */
     slot(name: string): ElurChildren;
+    /**
+     * A.21: controllers registrados — consumidos por el kernel en mount.
+     * @internal
+     */
+    _controllers?: ComponentController[];
+    /**
+     * A.21: registra un controller (patrón Lit). Llamar en el constructor;
+     * los hooks corren dentro del owner de la instancia.
+     */
+    addController(c: ComponentController): void;
     /** Sets an explicit devtools display name. Returns `this` for chaining. */
     setDebugName(name: string): this;
     /** Returns the component template. Called once on mount; updates happen via signals. */

package/dist/lib/elur/lifecycle.js

@@ -13,6 +13,10 @@ var e = class {
 	slot(e) {
 		return this._slots.get(e);
 	}
+	_controllers;
+	addController(e) {
+		(this._controllers ??= []).push(e);
+	}
 	setDebugName(e) {
 		return this._debugName = e, this;
 	}

package/dist/lib/elur/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","names":[],"sources":["../../src/elur/lifecycle.ts"],"sourcesContent":["import type { ElurTemplate } from \"./template/index.js\";\n\n// --- ElurChildren ---\n\n/** Valid child content for components. */\nexport type ElurChildren =\n    | ElurTemplate\n    | ElurComponent\n    | Array<ElurTemplate | ElurComponent>\n    | null\n    | undefined;\n\n// --- ElurComponent ---\n\n/** Base class for components with lifecycle hooks. */\nexport abstract class ElurComponent {\n    /** @internal */\n    readonly __isElurComponent = true as const;\n\n    /** Default slot — child content injected by the parent. */\n    children?: ElurChildren;\n\n    /** Optional label used by devtools. Falls back to class name. */\n    _debugName?: string;\n\n    /** @internal */\n    private _slots = new Map<string, ElurChildren>();\n\n    /** Sets the default slot content. Returns `this` for chaining. */\n    setChildren(content: ElurChildren): this {\n        this.children = content;\n        return this;\n    }\n\n    /** Sets a named slot. Returns `this` for chaining. */\n    setSlot(name: string, content: ElurChildren): this {\n        this._slots.set(name, content);\n        return this;\n    }\n\n    /** Returns content for a named slot. */\n    slot(name: string): ElurChildren {\n        return this._slots.get(name);\n    }\n\n    /** Sets an explicit devtools display name. Returns `this` for chaining. */\n    setDebugName(name: string): this {\n        this._debugName = name;\n        return this;\n    }\n\n    /** Returns the component template. Called once on mount; updates happen via signals. */\n    abstract render(): ElurTemplate;\n\n    /** Called before `render()` — no DOM yet. Errors are caught by `onError` if present. */\n    onInit?(): void;\n\n    /** Server-only lifecycle hook. Runs during SSR after `onInit()`; never on the client. */\n    onServerRender?(): void;\n\n    /** Called after DOM insertion. May return a cleanup function. */\n    onMount?(): (() => void) | void;\n\n    /** Called before DOM removal. */\n    onUnmount?(): void;\n\n    /** Catches errors thrown in `onInit` and `onMount`. */\n    onError?(err: unknown): void;\n}\n\n// --- Type guard ---\n\n/** @internal */\nexport function isElurComponent(v: unknown): v is ElurComponent {\n    return (\n        v != null &&\n        typeof v === \"object\" &&\n        (v as Record<string, unknown>).__isElurComponent === true\n    );\n}\n\n// --- Devtools component tracking (internal) ---\n\nexport interface _ComponentDebugHooks {\n    onMountStart?: (inst: ElurComponent) => void;\n    onMountEnd?: (inst: ElurComponent) => void;\n    onUnmount?: (inst: ElurComponent) => void;\n}\n\n/**\n * The registry lives in the shared reactivity global state\n * (`Symbol.for(\"@elurjs/core/reactivity-state\")`) rather than in module-local\n * state, so hooks work even when the package ends up duplicated in a bundle.\n */\ninterface _ComponentHookState {\n    componentDebugHooks?: _ComponentDebugHooks | null;\n    componentDebugHookSet?: Set<_ComponentDebugHooks>;\n}\n\nconst _reactivityStateKey = Symbol.for(\"@elurjs/core/reactivity-state\");\n\nfunction _hookState(): _ComponentHookState {\n    const g = globalThis as Record<PropertyKey, unknown>;\n    let state = g[_reactivityStateKey] as _ComponentHookState | undefined;\n    if (!state) {\n        // reactivity.ts merges its defaults into this object when it loads.\n        state = {};\n        g[_reactivityStateKey] = state;\n    }\n    return state;\n}\n\n/** Single dispatcher on the hot path; the set is only for bookkeeping. */\nfunction _syncComponentDebugHooks(state: _ComponentHookState): void {\n    const set = state.componentDebugHookSet;\n    if (!set || set.size === 0) {\n        state.componentDebugHooks = null;\n        return;\n    }\n    if (set.size === 1) {\n        state.componentDebugHooks = set.values().next().value ?? null;\n        return;\n    }\n    state.componentDebugHooks = {\n        onMountStart(inst) {\n            for (const hooks of set) hooks.onMountStart?.(inst);\n        },\n        onMountEnd(inst) {\n            for (const hooks of set) hooks.onMountEnd?.(inst);\n        },\n        onUnmount(inst) {\n            for (const hooks of set) hooks.onUnmount?.(inst);\n        },\n    };\n}\n\nexport function _setComponentDebugHooks(hooks: _ComponentDebugHooks | null): void {\n    const state = _hookState();\n    const set = new Set<_ComponentDebugHooks>();\n    if (hooks) set.add(hooks);\n    state.componentDebugHookSet = set;\n    _syncComponentDebugHooks(state);\n}\n\n/**\n * @internal — Adds a component debug hook subscriber WITHOUT replacing\n * existing ones (unlike `_setComponentDebugHooks`). Returns an unsubscribe\n * function. Zero cost when no subscribers are registered.\n */\nexport function _addComponentDebugHooks(hooks: _ComponentDebugHooks): () => void {\n    const state = _hookState();\n    let set = state.componentDebugHookSet;\n    if (!set) {\n        set = new Set<_ComponentDebugHooks>();\n        if (state.componentDebugHooks) set.add(state.componentDebugHooks);\n        state.componentDebugHookSet = set;\n    }\n    set.add(hooks);\n    _syncComponentDebugHooks(state);\n    return () => {\n        set.delete(hooks);\n        _syncComponentDebugHooks(state);\n    };\n}\n\nexport function _debugComponentMountStart(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountStart?.(inst);\n}\n\nexport function _debugComponentMountEnd(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountEnd?.(inst);\n}\n\nexport function _debugComponentUnmount(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onUnmount?.(inst);\n}\n"],"mappings":";AAeA,IAAsB,IAAtB,MAAoC;CAEhC,oBAA6B;CAG7B;CAGA;CAGA,yBAAiB,IAAI,KAA2B;CAGhD,YAAY,GAA6B;AAErC,SADA,KAAK,WAAW,GACT;;CAIX,QAAQ,GAAc,GAA6B;AAE/C,SADA,KAAK,OAAO,IAAI,GAAM,EAAQ,EACvB;;CAIX,KAAK,GAA4B;AAC7B,SAAO,KAAK,OAAO,IAAI,EAAK;;CAIhC,aAAa,GAAoB;AAE7B,SADA,KAAK,aAAa,GACX;;;AAyBf,SAAgB,EAAgB,GAAgC;AAC5D,QAEI,OAAO,KAAM,cADb,KAEC,EAA8B,sBAAsB;;AAsB7D,IAAM,IAAsB,OAAO,IAAI,gCAAgC;AAEvE,SAAS,IAAkC;CACvC,IAAM,IAAI,YACN,IAAQ,EAAE;AAMd,QALK,MAED,IAAQ,EAAE,EACV,EAAE,KAAuB,IAEtB;;AAIX,SAAS,EAAyB,GAAkC;CAChE,IAAM,IAAM,EAAM;AAClB,KAAI,CAAC,KAAO,EAAI,SAAS,GAAG;AACxB,IAAM,sBAAsB;AAC5B;;AAEJ,KAAI,EAAI,SAAS,GAAG;AAChB,IAAM,sBAAsB,EAAI,QAAQ,CAAC,MAAM,CAAC,SAAS;AACzD;;AAEJ,GAAM,sBAAsB;EACxB,aAAa,GAAM;AACf,QAAK,IAAM,KAAS,EAAK,GAAM,eAAe,EAAK;;EAEvD,WAAW,GAAM;AACb,QAAK,IAAM,KAAS,EAAK,GAAM,aAAa,EAAK;;EAErD,UAAU,GAAM;AACZ,QAAK,IAAM,KAAS,EAAK,GAAM,YAAY,EAAK;;EAEvD;;AAGL,SAAgB,EAAwB,GAA0C;CAC9E,IAAM,IAAQ,GAAY,EACpB,oBAAM,IAAI,KAA2B;AAG3C,CAFI,KAAO,EAAI,IAAI,EAAM,EACzB,EAAM,wBAAwB,GAC9B,EAAyB,EAAM;;AAQnC,SAAgB,EAAwB,GAAyC;CAC7E,IAAM,IAAQ,GAAY,EACtB,IAAM,EAAM;AAQhB,QAPK,MACD,oBAAM,IAAI,KAA2B,EACjC,EAAM,uBAAqB,EAAI,IAAI,EAAM,oBAAoB,EACjE,EAAM,wBAAwB,IAElC,EAAI,IAAI,EAAM,EACd,EAAyB,EAAM,QAClB;AAET,EADA,EAAI,OAAO,EAAM,EACjB,EAAyB,EAAM;;;AAIvC,SAAgB,EAA0B,GAA2B;AACjE,IAAY,CAAC,qBAAqB,eAAe,EAAK;;AAG1D,SAAgB,EAAwB,GAA2B;AAC/D,IAAY,CAAC,qBAAqB,aAAa,EAAK;;AAGxD,SAAgB,EAAuB,GAA2B;AAC9D,IAAY,CAAC,qBAAqB,YAAY,EAAK"}
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../src/elur/lifecycle.ts"],"sourcesContent":["import type { ElurTemplate } from \"./template/index.js\";\n\n// --- ElurChildren ---\n\n/** Valid child content for components. */\nexport type ElurChildren =\n    | ElurTemplate\n    | ElurComponent\n    | Array<ElurTemplate | ElurComponent>\n    | null\n    | undefined;\n\n// --- ElurComponent ---\n\n/** Base class for components with lifecycle hooks. */\n/**\n * A.21: controller de ciclo de vida (patrón Lit) — lógica reutilizable\n * enganchada a la instancia (ResizeObserver, focus, recursos, Ionic…).\n * Los hooks corren dentro del owner del componente.\n */\nexport interface ComponentController {\n    /** Antes de render() — sin DOM. */\n    hostInit?(): void;\n    /** Tras el commit DOM. */\n    hostMounted?(): void;\n    /** attach() — la instancia vuelve al DOM. */\n    hostActivate?(): void;\n    /** detach() — la instancia sale del DOM sin disponerse. */\n    hostDeactivate?(): void;\n    /** Antes del disposal del owner. */\n    hostUnmount?(): void;\n}\n\nexport abstract class ElurComponent {\n    /** @internal */\n    readonly __isElurComponent = true as const;\n\n    /** Default slot — child content injected by the parent. */\n    children?: ElurChildren;\n\n    /** Optional label used by devtools. Falls back to class name. */\n    _debugName?: string;\n\n    /** @internal */\n    private _slots = new Map<string, ElurChildren>();\n\n    /** Sets the default slot content. Returns `this` for chaining. */\n    setChildren(content: ElurChildren): this {\n        this.children = content;\n        return this;\n    }\n\n    /** Sets a named slot. Returns `this` for chaining. */\n    setSlot(name: string, content: ElurChildren): this {\n        this._slots.set(name, content);\n        return this;\n    }\n\n    /** Returns content for a named slot. */\n    slot(name: string): ElurChildren {\n        return this._slots.get(name);\n    }\n\n    /**\n     * A.21: controllers registrados — consumidos por el kernel en mount.\n     * @internal\n     */\n    _controllers?: ComponentController[];\n\n    /**\n     * A.21: registra un controller (patrón Lit). Llamar en el constructor;\n     * los hooks corren dentro del owner de la instancia.\n     */\n    addController(c: ComponentController): void {\n        (this._controllers ??= []).push(c);\n    }\n\n    /** Sets an explicit devtools display name. Returns `this` for chaining. */\n    setDebugName(name: string): this {\n        this._debugName = name;\n        return this;\n    }\n\n    /** Returns the component template. Called once on mount; updates happen via signals. */\n    abstract render(): ElurTemplate;\n\n    /** Called before `render()` — no DOM yet. Errors are caught by `onError` if present. */\n    onInit?(): void;\n\n    /** Server-only lifecycle hook. Runs during SSR after `onInit()`; never on the client. */\n    onServerRender?(): void;\n\n    /** Called after DOM insertion. May return a cleanup function. */\n    onMount?(): (() => void) | void;\n\n    /** Called before DOM removal. */\n    onUnmount?(): void;\n\n    /** Catches errors thrown in `onInit` and `onMount`. */\n    onError?(err: unknown): void;\n}\n\n// --- Type guard ---\n\n/** @internal */\nexport function isElurComponent(v: unknown): v is ElurComponent {\n    return (\n        v != null &&\n        typeof v === \"object\" &&\n        (v as Record<string, unknown>).__isElurComponent === true\n    );\n}\n\n// --- Devtools component tracking (internal) ---\n\nexport interface _ComponentDebugHooks {\n    onMountStart?: (inst: ElurComponent) => void;\n    onMountEnd?: (inst: ElurComponent) => void;\n    onUnmount?: (inst: ElurComponent) => void;\n}\n\n/**\n * The registry lives in the shared reactivity global state\n * (`Symbol.for(\"@elurjs/core/reactivity-state\")`) rather than in module-local\n * state, so hooks work even when the package ends up duplicated in a bundle.\n */\ninterface _ComponentHookState {\n    componentDebugHooks?: _ComponentDebugHooks | null;\n    componentDebugHookSet?: Set<_ComponentDebugHooks>;\n}\n\nconst _reactivityStateKey = Symbol.for(\"@elurjs/core/reactivity-state\");\n\nfunction _hookState(): _ComponentHookState {\n    const g = globalThis as Record<PropertyKey, unknown>;\n    let state = g[_reactivityStateKey] as _ComponentHookState | undefined;\n    if (!state) {\n        // reactivity.ts merges its defaults into this object when it loads.\n        state = {};\n        g[_reactivityStateKey] = state;\n    }\n    return state;\n}\n\n/** Single dispatcher on the hot path; the set is only for bookkeeping. */\nfunction _syncComponentDebugHooks(state: _ComponentHookState): void {\n    const set = state.componentDebugHookSet;\n    if (!set || set.size === 0) {\n        state.componentDebugHooks = null;\n        return;\n    }\n    if (set.size === 1) {\n        state.componentDebugHooks = set.values().next().value ?? null;\n        return;\n    }\n    state.componentDebugHooks = {\n        onMountStart(inst) {\n            for (const hooks of set) hooks.onMountStart?.(inst);\n        },\n        onMountEnd(inst) {\n            for (const hooks of set) hooks.onMountEnd?.(inst);\n        },\n        onUnmount(inst) {\n            for (const hooks of set) hooks.onUnmount?.(inst);\n        },\n    };\n}\n\nexport function _setComponentDebugHooks(hooks: _ComponentDebugHooks | null): void {\n    const state = _hookState();\n    const set = new Set<_ComponentDebugHooks>();\n    if (hooks) set.add(hooks);\n    state.componentDebugHookSet = set;\n    _syncComponentDebugHooks(state);\n}\n\n/**\n * @internal — Adds a component debug hook subscriber WITHOUT replacing\n * existing ones (unlike `_setComponentDebugHooks`). Returns an unsubscribe\n * function. Zero cost when no subscribers are registered.\n */\nexport function _addComponentDebugHooks(hooks: _ComponentDebugHooks): () => void {\n    const state = _hookState();\n    let set = state.componentDebugHookSet;\n    if (!set) {\n        set = new Set<_ComponentDebugHooks>();\n        if (state.componentDebugHooks) set.add(state.componentDebugHooks);\n        state.componentDebugHookSet = set;\n    }\n    set.add(hooks);\n    _syncComponentDebugHooks(state);\n    return () => {\n        set.delete(hooks);\n        _syncComponentDebugHooks(state);\n    };\n}\n\nexport function _debugComponentMountStart(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountStart?.(inst);\n}\n\nexport function _debugComponentMountEnd(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onMountEnd?.(inst);\n}\n\nexport function _debugComponentUnmount(inst: ElurComponent): void {\n    _hookState().componentDebugHooks?.onUnmount?.(inst);\n}\n"],"mappings":";AAiCA,IAAsB,IAAtB,MAAoC;CAEhC,oBAA6B;CAG7B;CAGA;CAGA,yBAAiB,IAAI,KAA2B;CAGhD,YAAY,GAA6B;AAErC,SADA,KAAK,WAAW,GACT;;CAIX,QAAQ,GAAc,GAA6B;AAE/C,SADA,KAAK,OAAO,IAAI,GAAM,EAAQ,EACvB;;CAIX,KAAK,GAA4B;AAC7B,SAAO,KAAK,OAAO,IAAI,EAAK;;CAOhC;CAMA,cAAc,GAA8B;AACxC,GAAC,KAAK,iBAAiB,EAAE,EAAE,KAAK,EAAE;;CAItC,aAAa,GAAoB;AAE7B,SADA,KAAK,aAAa,GACX;;;AAyBf,SAAgB,EAAgB,GAAgC;AAC5D,QAEI,OAAO,KAAM,cADb,KAEC,EAA8B,sBAAsB;;AAsB7D,IAAM,IAAsB,OAAO,IAAI,gCAAgC;AAEvE,SAAS,IAAkC;CACvC,IAAM,IAAI,YACN,IAAQ,EAAE;AAMd,QALK,MAED,IAAQ,EAAE,EACV,EAAE,KAAuB,IAEtB;;AAIX,SAAS,EAAyB,GAAkC;CAChE,IAAM,IAAM,EAAM;AAClB,KAAI,CAAC,KAAO,EAAI,SAAS,GAAG;AACxB,IAAM,sBAAsB;AAC5B;;AAEJ,KAAI,EAAI,SAAS,GAAG;AAChB,IAAM,sBAAsB,EAAI,QAAQ,CAAC,MAAM,CAAC,SAAS;AACzD;;AAEJ,GAAM,sBAAsB;EACxB,aAAa,GAAM;AACf,QAAK,IAAM,KAAS,EAAK,GAAM,eAAe,EAAK;;EAEvD,WAAW,GAAM;AACb,QAAK,IAAM,KAAS,EAAK,GAAM,aAAa,EAAK;;EAErD,UAAU,GAAM;AACZ,QAAK,IAAM,KAAS,EAAK,GAAM,YAAY,EAAK;;EAEvD;;AAGL,SAAgB,EAAwB,GAA0C;CAC9E,IAAM,IAAQ,GAAY,EACpB,oBAAM,IAAI,KAA2B;AAG3C,CAFI,KAAO,EAAI,IAAI,EAAM,EACzB,EAAM,wBAAwB,GAC9B,EAAyB,EAAM;;AAQnC,SAAgB,EAAwB,GAAyC;CAC7E,IAAM,IAAQ,GAAY,EACtB,IAAM,EAAM;AAQhB,QAPK,MACD,oBAAM,IAAI,KAA2B,EACjC,EAAM,uBAAqB,EAAI,IAAI,EAAM,oBAAoB,EACjE,EAAM,wBAAwB,IAElC,EAAI,IAAI,EAAM,EACd,EAAyB,EAAM,QAClB;AAET,EADA,EAAI,OAAO,EAAM,EACjB,EAAyB,EAAM;;;AAIvC,SAAgB,EAA0B,GAA2B;AACjE,IAAY,CAAC,qBAAqB,eAAe,EAAK;;AAG1D,SAAgB,EAAwB,GAA2B;AAC/D,IAAY,CAAC,qBAAqB,aAAa,EAAK;;AAGxD,SAAgB,EAAuB,GAA2B;AAC9D,IAAY,CAAC,qBAAqB,YAAY,EAAK"}