@askrjs/askr 0.0.28 → 0.0.29

package/dist/runtime/component.js

@@ -1 +1,462 @@
-import{globalScheduler as p}from"./scheduler.js";import{withContext as T}from"./context.js";import{finalizeReadableSubscriptions as v,cleanupReadableSubscriptions as k}from"./readable.js";import{logger as f}from"../dev/logger.js";import{incDevCounter as m,setDevValue as h}from"./dev-namespace.js";import{isBulkCommitActive as x}from"./fastlane.js";import"../renderer/index.js";import{evaluate as g}from"../renderer/evaluate.js";import{cleanupInstancesUnder as _}from"../renderer/cleanup.js";function D(e,t,r,u){const n={id:e,fn:t,props:r,target:u,mounted:!1,abortController:new AbortController,stateValues:[],evaluationGeneration:0,notifyUpdate:null,_pendingFlushTask:void 0,_pendingRunTask:void 0,_enqueueRun:void 0,stateIndexCheck:-1,expectedStateIndices:[],firstRenderComplete:!1,mountOperations:[],cleanupFns:[],hasPendingUpdate:!1,ownerFrame:null,ssr:!1,cleanupStrict:!1,isRoot:!1,_currentRenderToken:void 0,lastRenderToken:0,_pendingReadSources:new Set,_lastReadSources:new Set,devWarningsEmitted:new Set};return n._pendingRunTask=()=>{n.hasPendingUpdate=!1,I(n)},n._enqueueRun=()=>{n.hasPendingUpdate||(n.hasPendingUpdate=!0,p.enqueue(n._pendingRunTask))},n._pendingFlushTask=n._pendingRunTask,n}let l=null,s=0;function E(){return l}function K(e){l=e}function B(e){const t=E();if(t){if(x())return;t.mountOperations.push(e)}}function C(e){if(e.isRoot){for(const t of e.mountOperations){const r=t();r instanceof Promise?r.then(u=>{typeof u=="function"&&e.cleanupFns.push(u)}):typeof r=="function"&&e.cleanupFns.push(r)}e.mountOperations=[]}}function H(e,t){e.target=t;try{t instanceof Element&&(t.__ASKR_INSTANCE=e)}catch(u){}e.notifyUpdate=e._enqueueRun;const r=!e.mounted;e.mounted=!0,r&&e.mountOperations.length>0&&C(e)}let S=0;function I(e){e.notifyUpdate=e._enqueueRun,e._currentRenderToken=++S,e._pendingReadSources=new Set;const t=e.target?e.target.innerHTML:"",r=R(e);if(r instanceof Promise)throw new Error("Async components are not supported. Components must be synchronous.");{const u=globalThis.__ASKR_FASTLANE;try{if(u?.tryRuntimeFastLaneSync?.(e,r))return}catch{}p.enqueue(()=>{if(!e.target&&e._placeholder){if(r==null){c(e);return}const n=e._placeholder,d=n.parentNode;if(!d){f.warn("[Askr] placeholder no longer in DOM, cannot render component");return}const o=document.createElement("div"),i=l;l=e;try{g(r,o),d.replaceChild(o,n),e.target=o,e._placeholder=void 0,o.__ASKR_INSTANCE=e,c(e)}finally{l=i}return}if(e.target){let n=[];try{const d=!e.mounted,o=l;l=e,n=Array.from(e.target.childNodes);try{g(r,e.target)}catch(i){try{const a=Array.from(e.target.childNodes);for(const w of a)try{_(w)}catch(y){f.warn("[Askr] error cleaning up failed commit children:",y)}}catch(a){}try{m("__DOM_REPLACE_COUNT"),h("__LAST_DOM_REPLACE_STACK_COMPONENT_RESTORE",new Error().stack)}catch(a){}throw e.target.replaceChildren(...n),i}finally{l=o}c(e),e.mounted=!0,d&&e.mountOperations.length>0&&C(e)}catch(d){try{const o=Array.from(e.target.childNodes);for(const i of o)try{_(i)}catch(a){f.warn("[Askr] error cleaning up partial children during rollback:",a)}}catch(o){}try{try{m("__DOM_REPLACE_COUNT"),h("__LAST_DOM_REPLACE_STACK_COMPONENT_ROLLBACK",new Error().stack)}catch(o){}e.target.replaceChildren(...n)}catch{e.target.innerHTML=t}throw d}}})}}function V(e){const t=e._currentRenderToken!==void 0,r=e._currentRenderToken,u=e._pendingReadSources;t||(e._currentRenderToken=++S,e._pendingReadSources=new Set);try{const n=R(e);return t||c(e),n}finally{e._currentRenderToken=r,e._pendingReadSources=u??new Set}}function R(e){e.stateIndexCheck=-1;for(const t of e.stateValues)t&&(t._hasBeenRead=!1);e._pendingReadSources=new Set,l=e,s=0;try{const r={signal:e.abortController.signal},u={parent:e.ownerFrame,values:null},n=T(u,()=>e.fn(e.props,r)),d=Date.now()-0;d>5&&(`${d}`,void 0),e.firstRenderComplete||(e.firstRenderComplete=!0);for(let o=0;o<e.stateValues.length;o++){const i=e.stateValues[o];if(i&&!i._hasBeenRead)try{const a=e.fn?.name||"<anonymous>";`${o}`,`${a}${o}`}catch{`${o}`}}return n}finally{l=null}}function A(e){e.abortController=new AbortController,e.notifyUpdate=e._enqueueRun,p.enqueue(e._pendingRunTask)}function z(){return l}function W(){if(!l)throw new Error("getSignal() can only be called during component render execution. Ensure you are calling this from inside your component function.");return l.abortController.signal}function c(e){v(e)}function b(){return s++}function j(e,t){const r=b();if(r<e.stateIndexCheck)throw new Error(`Hook index violation: ${t}() call at index ${r}, but previously saw index ${e.stateIndexCheck}. This happens when render-scoped hooks are called conditionally (inside if/for/etc). Move all ${t}() calls to the top level of your component function, before any conditionals.`);if(e.stateIndexCheck=r,e.firstRenderComplete){if(!e.expectedStateIndices.includes(r))throw new Error(`Hook order violation: ${t}() called at index ${r}, but this index was not in the first render's sequence [${e.expectedStateIndices.join(", ")}]. This usually means ${t}() is inside a conditional or loop. Move all render-scoped hooks to the top level of your component function.`)}else e.expectedStateIndices.push(r);return r}function G(){return s}function J(){s=0}function Q(e){s=e}function X(e){A(e)}function Y(e){const t=[];for(const r of e.cleanupFns)try{r()}catch(u){e.cleanupStrict&&t.push(u)}if(e.cleanupFns=[],t.length>0)throw new AggregateError(t,`Cleanup failed for component ${e.id}`);k(e),e.abortController.abort(),e.notifyUpdate=null,e.mounted=!1}export{j as claimHookIndex,Y as cleanupComponent,D as createComponentInstance,A as executeComponent,c as finalizeReadSubscriptions,E as getCurrentComponentInstance,z as getCurrentInstance,G as getCurrentStateIndex,b as getNextStateIndex,W as getSignal,X as mountComponent,H as mountInstanceInline,B as registerMountOperation,V as renderComponentInline,J as resetStateIndex,K as setCurrentComponentInstance,Q as setStateIndex};
+import { isDevelopmentEnvironment, isProductionEnvironment } from "../common/env.js";
+import { logger } from "../dev/logger.js";
+import { globalScheduler } from "./scheduler.js";
+import { withContext } from "./context.js";
+import { cleanupReadableSubscriptions, finalizeReadableSubscriptions } from "./readable.js";
+import { incDevCounter, setDevValue } from "./dev-namespace.js";
+import { isBulkCommitActive } from "./fastlane.js";
+import { cleanupInstancesUnder } from "../renderer/cleanup.js";
+import { evaluate } from "../renderer/evaluate.js";
+import "../renderer/index.js";
+//#region src/runtime/component.ts
+/**
+* Register a mount operation that will run after the component is mounted
+* Used by operations (task, on, timer, etc) to execute after render completes
+*/
+function createComponentInstance(id, fn, props, target) {
+	const instance = {
+		id,
+		fn,
+		props,
+		target,
+		mounted: false,
+		abortController: null,
+		stateValues: [],
+		evaluationGeneration: 0,
+		notifyUpdate: null,
+		_pendingFlushTask: void 0,
+		_pendingRunTask: void 0,
+		_enqueueRun: void 0,
+		stateIndexCheck: -1,
+		expectedStateIndices: [],
+		firstRenderComplete: false,
+		mountOperations: [],
+		cleanupFns: [],
+		hasPendingUpdate: false,
+		ownerFrame: null,
+		ssr: false,
+		cleanupStrict: false,
+		isRoot: false,
+		_currentRenderToken: void 0,
+		lastRenderToken: 0,
+		_pendingReadSources: void 0,
+		_lastReadSources: void 0,
+		devWarningsEmitted: void 0
+	};
+	instance._pendingRunTask = () => {
+		instance.hasPendingUpdate = false;
+		runComponent(instance);
+	};
+	instance._enqueueRun = () => {
+		if (!instance.hasPendingUpdate) {
+			instance.hasPendingUpdate = true;
+			globalScheduler.enqueue(instance._pendingRunTask);
+		}
+	};
+	instance._pendingFlushTask = instance._pendingRunTask;
+	return instance;
+}
+let currentInstance = null;
+let stateIndex = 0;
+function ensureAbortController(instance) {
+	let controller = instance.abortController;
+	if (!controller || controller.signal.aborted) {
+		controller = new AbortController();
+		instance.abortController = controller;
+	}
+	return controller;
+}
+function getCurrentComponentInstance() {
+	return currentInstance;
+}
+function setCurrentComponentInstance(instance) {
+	currentInstance = instance;
+}
+function registerMountOperation(operation) {
+	const instance = getCurrentComponentInstance();
+	if (instance) {
+		if (isBulkCommitActive()) {
+			if (isDevelopmentEnvironment()) throw new Error("registerMountOperation called during bulk commit fast-lane");
+			return;
+		}
+		instance.mountOperations.push(operation);
+	}
+}
+/**
+* Execute all mount operations for a component
+* These run after the component is rendered and mounted to the DOM
+*/
+function executeMountOperations(instance) {
+	if (!instance.isRoot) return;
+	const mountOperations = instance.mountOperations;
+	if (mountOperations.length === 0) return;
+	for (const operation of mountOperations) {
+		const result = operation();
+		if (result instanceof Promise) result.then((cleanup) => {
+			if (typeof cleanup === "function") instance.cleanupFns.push(cleanup);
+		});
+		else if (typeof result === "function") instance.cleanupFns.push(result);
+	}
+	instance.mountOperations = [];
+}
+function mountInstanceInline(instance, target) {
+	instance.target = target;
+	try {
+		if (target instanceof Element) {
+			const host = target;
+			const nextInstances = (host.__ASKR_INSTANCES ?? []).filter((entry) => entry !== instance);
+			nextInstances.push(instance);
+			host.__ASKR_INSTANCES = nextInstances;
+			host.__ASKR_INSTANCE = nextInstances[0] ?? instance;
+		}
+	} catch (err) {}
+	instance.notifyUpdate = instance._enqueueRun;
+	const wasFirstMount = !instance.mounted;
+	instance.mounted = true;
+	if (wasFirstMount && instance.mountOperations.length > 0) executeMountOperations(instance);
+}
+/**
+* Run a component synchronously: execute function, handle result
+* This is the internal workhorse that manages async continuations and generation tracking.
+* Must always be called through the scheduler.
+*
+* ACTOR INVARIANT: This function is enqueued as a task, never called directly.
+*/
+let _globalRenderCounter = 0;
+function resetRenderState(instance) {
+	instance.stateIndexCheck = -1;
+	for (const state of instance.stateValues) if (state) state._hasBeenRead = false;
+	instance._pendingReadSources = void 0;
+}
+function nextRenderToken() {
+	return ++_globalRenderCounter;
+}
+function renderScopedComponent(instance, startStateIndex, render) {
+	const savedInstance = currentInstance;
+	const savedStateIndex = stateIndex;
+	instance.notifyUpdate = instance._enqueueRun;
+	resetRenderState(instance);
+	instance._currentRenderToken = nextRenderToken();
+	currentInstance = instance;
+	stateIndex = startStateIndex;
+	let didComplete = false;
+	try {
+		const result = withContext({
+			parent: instance.ownerFrame,
+			values: null
+		}, render);
+		didComplete = true;
+		return result;
+	} finally {
+		if (!didComplete) {
+			instance._pendingReadSources = void 0;
+			instance._currentRenderToken = void 0;
+		}
+		currentInstance = savedInstance;
+		stateIndex = savedStateIndex;
+	}
+}
+function runComponent(instance) {
+	instance.notifyUpdate = instance._enqueueRun;
+	instance._currentRenderToken = nextRenderToken();
+	instance._pendingReadSources = void 0;
+	const domSnapshot = instance.target ? instance.target.innerHTML : "";
+	const result = executeComponentSync(instance);
+	if (result instanceof Promise) throw new Error("Async components are not supported. Components must be synchronous.");
+	else {
+		const fastlaneBridge = globalThis.__ASKR_FASTLANE;
+		try {
+			if (fastlaneBridge?.tryRuntimeFastLaneSync?.(instance, result)) {
+				warnUnusedStateReads(instance);
+				return;
+			}
+		} catch (err) {
+			if (isDevelopmentEnvironment()) throw err;
+		}
+		globalScheduler.enqueue(() => {
+			if (!instance.target && instance._placeholder) {
+				if (result === null || result === void 0) {
+					finalizeReadSubscriptions(instance);
+					warnUnusedStateReads(instance);
+					return;
+				}
+				const placeholder = instance._placeholder;
+				const parent = placeholder.parentNode;
+				if (!parent) {
+					logger.warn("[Askr] placeholder no longer in DOM, cannot render component");
+					return;
+				}
+				const host = document.createElement("div");
+				const executionFrame = {
+					parent: instance.ownerFrame,
+					values: null
+				};
+				const oldInstance = currentInstance;
+				currentInstance = instance;
+				try {
+					withContext(executionFrame, () => {
+						evaluate(result, host);
+					});
+					parent.replaceChild(host, placeholder);
+					instance.target = host;
+					instance._placeholder = void 0;
+					host.__ASKR_INSTANCE = instance;
+					finalizeReadSubscriptions(instance);
+					warnUnusedStateReads(instance);
+				} finally {
+					currentInstance = oldInstance;
+				}
+				return;
+			}
+			if (instance.target) {
+				let oldChildren = [];
+				try {
+					const wasFirstMount = !instance.mounted;
+					const oldInstance = currentInstance;
+					currentInstance = instance;
+					const executionFrame = {
+						parent: instance.ownerFrame,
+						values: null
+					};
+					oldChildren = Array.from(instance.target.childNodes);
+					try {
+						withContext(executionFrame, () => {
+							evaluate(result, instance.target);
+						});
+					} catch (e) {
+						try {
+							const newChildren = Array.from(instance.target.childNodes);
+							for (const n of newChildren) try {
+								cleanupInstancesUnder(n);
+							} catch (err) {
+								logger.warn("[Askr] error cleaning up failed commit children:", err);
+							}
+						} catch (_err) {}
+						try {
+							incDevCounter("__DOM_REPLACE_COUNT");
+							setDevValue("__LAST_DOM_REPLACE_STACK_COMPONENT_RESTORE", (/* @__PURE__ */ new Error()).stack);
+						} catch (e) {}
+						instance.target.replaceChildren(...oldChildren);
+						throw e;
+					} finally {
+						currentInstance = oldInstance;
+					}
+					finalizeReadSubscriptions(instance);
+					warnUnusedStateReads(instance);
+					instance.mounted = true;
+					if (wasFirstMount && instance.mountOperations.length > 0) executeMountOperations(instance);
+				} catch (renderError) {
+					try {
+						const currentChildren = Array.from(instance.target.childNodes);
+						for (const n of currentChildren) try {
+							cleanupInstancesUnder(n);
+						} catch (err) {
+							logger.warn("[Askr] error cleaning up partial children during rollback:", err);
+						}
+					} catch (_err) {}
+					try {
+						incDevCounter("__DOM_REPLACE_COUNT");
+						setDevValue("__LAST_DOM_REPLACE_STACK_COMPONENT_ROLLBACK", (/* @__PURE__ */ new Error()).stack);
+						instance.target.replaceChildren(...oldChildren);
+					} catch {
+						instance.target.innerHTML = domSnapshot;
+					}
+					throw renderError;
+				}
+			}
+		});
+	}
+}
+/**
+* Execute a component's render function synchronously.
+* Returns either a vnode/promise immediately (does NOT render).
+* Rendering happens separately through runComponent.
+*/
+function renderComponentInline(instance) {
+	const hadToken = instance._currentRenderToken !== void 0;
+	const prevToken = instance._currentRenderToken;
+	const prevPendingReads = instance._pendingReadSources;
+	if (!hadToken) {
+		instance._currentRenderToken = nextRenderToken();
+		instance._pendingReadSources = void 0;
+	}
+	try {
+		const result = executeComponentSync(instance);
+		if (!hadToken) finalizeReadSubscriptions(instance);
+		return result;
+	} finally {
+		instance._currentRenderToken = prevToken;
+		instance._pendingReadSources = prevPendingReads;
+	}
+}
+function warnUnusedStateReads(instance) {
+	for (let i = 0; i < instance.stateValues.length; i++) {
+		const state = instance.stateValues[i];
+		const hasCommittedUsage = (state?._readers?.size ?? 0) > 0 || (state?._derivedSubscribers?.size ?? 0) > 0;
+		if (state && !state._hasBeenRead && !hasCommittedUsage) try {
+			const name = instance.fn?.name || "<anonymous>";
+			warnInstanceOnce(instance, `unused-state:${i}`, `[askr] Unused state variable detected in ${name} at index ${i}. State should be read during render or removed.`);
+		} catch {
+			warnInstanceOnce(instance, `unused-state:${i}`, `[askr] Unused state variable detected. State should be read during render or removed.`);
+		}
+	}
+}
+function executeComponentSync(instance) {
+	resetRenderState(instance);
+	incDevCounter("componentRuns");
+	incDevCounter("componentReruns");
+	currentInstance = instance;
+	stateIndex = 0;
+	try {
+		const renderStartTime = isDevelopmentEnvironment() ? Date.now() : 0;
+		const context = { get signal() {
+			return ensureAbortController(instance).signal;
+		} };
+		const result = withContext({
+			parent: instance.ownerFrame,
+			values: null
+		}, () => instance.fn(instance.props, context));
+		const renderTime = Date.now() - renderStartTime;
+		if (renderTime > 5) warnInstanceOnce(instance, "slow-render", `[askr] Slow render detected: ${renderTime}ms. Consider optimizing component performance.`);
+		if (!instance.firstRenderComplete) instance.firstRenderComplete = true;
+		return result;
+	} finally {
+		currentInstance = null;
+	}
+}
+/**
+* Public entry point: Execute component with full lifecycle (execute + render)
+* Handles both initial mount and re-execution. Always enqueues through scheduler.
+* Single entry point to avoid lifecycle divergence.
+*/
+function executeComponent(instance) {
+	instance.abortController = null;
+	instance.notifyUpdate = instance._enqueueRun;
+	globalScheduler.enqueue(instance._pendingRunTask);
+}
+function getCurrentInstance() {
+	return currentInstance;
+}
+/**
+* Get the abort signal for the current component
+* Used to cancel async operations on unmount/navigation
+*
+* The signal is guaranteed to be aborted when:
+* - Component unmounts
+* - Navigation occurs (different route)
+* - Parent is destroyed
+*
+* IMPORTANT: getSignal() must be called during component render execution.
+* It captures the current component instance from context.
+*
+* @returns AbortSignal that will be aborted when component unmounts
+* @throws Error if called outside component execution
+*
+* @example
+* ```ts
+* // ✅ Correct: called during render, used in async operation
+* export async function UserPage({ id }: { id: string }) {
+*   const signal = getSignal();
+*   const user = await fetch(`/api/users/${id}`, { signal });
+*   return <div>{user.name}</div>;
+* }
+*
+* // ✅ Correct: passed to event handler
+* export function Button() {
+*   const signal = getSignal();
+*   return {
+*     type: 'button',
+*     props: {
+*       onClick: async () => {
+*         const data = await fetch(url, { signal });
+*       }
+*     }
+*   };
+* }
+*
+* // ❌ Wrong: called outside component context
+* const signal = getSignal(); // Error: not in component
+* ```
+*/
+function getSignal() {
+	if (!currentInstance) throw new Error("getSignal() can only be called during component render execution. Ensure you are calling this from inside your component function.");
+	return ensureAbortController(currentInstance).signal;
+}
+/**
+* Finalize read subscriptions for an instance after a successful commit.
+* - Update per-state readers map to point to this instance's last committed token
+* - Remove this instance from states it no longer reads
+* This is deterministic and runs synchronously with commit to ensure
+* subscribers are only notified when they actually read a state in their
+* last committed render.
+*/
+function finalizeReadSubscriptions(instance) {
+	finalizeReadableSubscriptions(instance);
+}
+function getNextStateIndex() {
+	return stateIndex++;
+}
+function claimHookIndex(instance, hookName) {
+	const index = getNextStateIndex();
+	if (index < instance.stateIndexCheck) throw new Error(`Hook index violation: ${hookName}() call at index ${index}, but previously saw index ${instance.stateIndexCheck}. This happens when render-scoped hooks are called conditionally (inside if/for/etc). Move all ${hookName}() calls to the top level of your component function, before any conditionals.`);
+	instance.stateIndexCheck = index;
+	if (instance.firstRenderComplete) {
+		if (!instance.expectedStateIndices.includes(index)) throw new Error(`Hook order violation: ${hookName}() called at index ${index}, but this index was not in the first render's sequence [${instance.expectedStateIndices.join(", ")}]. This usually means ${hookName}() is inside a conditional or loop. Move all render-scoped hooks to the top level of your component function.`);
+	} else instance.expectedStateIndices.push(index);
+	return index;
+}
+function getCurrentStateIndex() {
+	return stateIndex;
+}
+/**
+* Mount a component instance.
+* This is just an alias to executeComponent() to maintain API compatibility.
+* All lifecycle logic is unified in executeComponent().
+*/
+function mountComponent(instance) {
+	executeComponent(instance);
+}
+/**
+* Clean up component — abort pending operations
+* Called on unmount or route change
+*/
+function cleanupComponent(instance) {
+	const ownedChildScopes = instance._ownedChildScopes;
+	if (ownedChildScopes && ownedChildScopes.size > 0) {
+		instance._ownedChildScopes = /* @__PURE__ */ new Set();
+		for (const scope of ownedChildScopes) scope.dispose();
+	}
+	const cleanupErrors = [];
+	const cleanupFns = instance.cleanupFns;
+	for (const cleanup of cleanupFns) try {
+		cleanup();
+	} catch (err) {
+		if (instance.cleanupStrict) cleanupErrors.push(err);
+		else if (isDevelopmentEnvironment()) logger.warn("[Askr] cleanup function threw:", err);
+	}
+	instance.cleanupFns = [];
+	if (cleanupErrors.length > 0) throw new AggregateError(cleanupErrors, `Cleanup failed for component ${instance.id}`);
+	cleanupReadableSubscriptions(instance);
+	if (instance.abortController && !instance.abortController.signal.aborted) instance.abortController.abort();
+	instance.abortController = null;
+	instance.notifyUpdate = null;
+	instance._placeholder = void 0;
+	instance.mounted = false;
+}
+function registerOwnedChildScope(instance, scope) {
+	(instance._ownedChildScopes ??= /* @__PURE__ */ new Set()).add(scope);
+}
+function unregisterOwnedChildScope(instance, scope) {
+	instance._ownedChildScopes?.delete(scope);
+}
+function warnInstanceOnce(instance, key, message) {
+	if (isProductionEnvironment()) return;
+	const warnings = instance.devWarningsEmitted ??= /* @__PURE__ */ new Set();
+	if (warnings.has(key)) return;
+	warnings.add(key);
+	logger.warn(message);
+}
+//#endregion
+export { claimHookIndex, cleanupComponent, createComponentInstance, finalizeReadSubscriptions, getCurrentComponentInstance, getCurrentInstance, getCurrentStateIndex, getSignal, mountComponent, mountInstanceInline, registerMountOperation, registerOwnedChildScope, renderComponentInline, renderScopedComponent, setCurrentComponentInstance, unregisterOwnedChildScope, warnUnusedStateReads };
+
+//# sourceMappingURL=component.js.map

package/dist/runtime/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","names":[],"sources":["../../src/runtime/component.ts"],"sourcesContent":["/**\n * Component instance lifecycle management\n * Internal only — users never see this\n */\n\nimport { type State } from './state';\nimport { globalScheduler } from './scheduler';\nimport type { Props } from '../common/props';\nimport type { ComponentFunction } from '../common/component';\nimport {\n  // withContext is the sole primitive for context restoration\n  withContext,\n  type ContextFrame,\n} from './context';\nimport {\n  type ReadableSource,\n  finalizeReadableSubscriptions,\n  cleanupReadableSubscriptions,\n} from './readable';\nimport {\n  isDevelopmentEnvironment,\n  isProductionEnvironment,\n} from '../common/env';\nimport { logger } from '../dev/logger';\nimport { incDevCounter, setDevValue } from './dev-namespace';\n\nexport type { ComponentFunction } from '../common/component';\n\nexport interface ComponentInstance {\n  id: string;\n  fn: ComponentFunction;\n  props: Props;\n  target: Element | null;\n  mounted: boolean;\n  abortController: AbortController | null; // Lazily created per-component abort lifecycle\n  ssr?: boolean; // Set to true for SSR temporary instances\n  // Opt-in strict cleanup mode: when true cleanup errors are aggregated and re-thrown\n  cleanupStrict?: boolean;\n  stateValues: State<unknown>[]; // Persistent state storage across renders\n  evaluationGeneration: number; // Prevents stale async evaluation completions\n  notifyUpdate: (() => void) | null; // Callback for state updates (persisted on instance)\n  // Internal: prebound helpers to avoid per-update closures (allocation hot-path)\n  _pendingFlushTask?: () => void; // Clears hasPendingUpdate and triggers notifyUpdate\n  _pendingRunTask?: () => void; // Clears hasPendingUpdate and runs component\n  _enqueueRun?: () => void; // Batches run requests and enqueues _pendingRunTask\n  stateIndexCheck: number; // Track state indices to catch conditional calls\n  expectedStateIndices: number[]; // Expected sequence of render-scoped hook indices (frozen after first render)\n  firstRenderComplete: boolean; // Flag to detect transition from first to subsequent renders\n  mountOperations: Array<\n    () => void | (() => void) | Promise<void | (() => void)>\n  >; // Operations to run when component mounts\n  cleanupFns: Array<() => void>; // Cleanup functions to run on unmount\n  hasPendingUpdate: boolean; // Flag to batch state updates (coalescing)\n  ownerFrame: ContextFrame | null; // Provider chain for this component (set by Scope, never overwritten)\n  isRoot?: boolean;\n\n  // Render-tracking for precise subscriptions (internal)\n  _currentRenderToken?: number; // Token for the in-progress render (set before render)\n  lastRenderToken?: number; // Token of the last *committed* render\n  _pendingReadSources?: Set<ReadableSource<unknown>>; // Readables read during the in-progress render\n  _lastReadSources?: Set<ReadableSource<unknown>>; // Readables read during the last committed render\n  devWarningsEmitted?: Set<string>; // Dev-only warning dedupe for this instance\n\n  // Placeholder for null-returning components. When a component initially returns\n  // null, we create a comment placeholder so updates can replace it with content.\n  _placeholder?: Comment;\n  _ownedChildScopes?: Set<{\n    key: string | number;\n    dispose(): void;\n  }>;\n}\n\nexport function createComponentInstance(\n  id: string,\n  fn: ComponentFunction,\n  props: Props,\n  target: Element | null\n): ComponentInstance {\n  const instance: ComponentInstance = {\n    id,\n    fn,\n    props,\n    target,\n    mounted: false,\n    abortController: null,\n    stateValues: [],\n    evaluationGeneration: 0,\n    notifyUpdate: null,\n    // Prebound helpers (initialized below) to avoid per-update allocations\n    _pendingFlushTask: undefined,\n    _pendingRunTask: undefined,\n    _enqueueRun: undefined,\n    stateIndexCheck: -1,\n    expectedStateIndices: [],\n    firstRenderComplete: false,\n    mountOperations: [],\n    cleanupFns: [],\n    hasPendingUpdate: false,\n    ownerFrame: null, // Will be set by renderer when vnode is marked\n    ssr: false,\n    cleanupStrict: false,\n    isRoot: false,\n\n    // Render-tracking (for precise state subscriptions)\n    _currentRenderToken: undefined,\n    lastRenderToken: 0,\n    _pendingReadSources: undefined,\n    _lastReadSources: undefined,\n    devWarningsEmitted: undefined,\n  };\n\n  // Initialize prebound helper tasks once per instance to avoid allocations\n  instance._pendingRunTask = () => {\n    // Clear pending flag when the run task executes\n    instance.hasPendingUpdate = false;\n    // Execute component run (will set up notifyUpdate before render)\n    runComponent(instance);\n  };\n\n  instance._enqueueRun = () => {\n    if (!instance.hasPendingUpdate) {\n      instance.hasPendingUpdate = true;\n      // Enqueue single run task (coalesces multiple writes)\n      globalScheduler.enqueue(instance._pendingRunTask!);\n    }\n  };\n\n  // Default state-driven updates enqueue the run task directly. Specialized\n  // runtimes (for example `For` item instances) can still override this hook.\n  instance._pendingFlushTask = instance._pendingRunTask;\n\n  return instance;\n}\n\nlet currentInstance: ComponentInstance | null = null;\nlet stateIndex = 0;\n\ntype OwnedChildScope = {\n  key: string | number;\n  dispose(): void;\n};\n\nfunction ensureAbortController(instance: ComponentInstance): AbortController {\n  let controller = instance.abortController;\n  if (!controller || controller.signal.aborted) {\n    controller = new AbortController();\n    instance.abortController = controller;\n  }\n  return controller;\n}\n\n// Export for state.ts to access\nexport function getCurrentComponentInstance(): ComponentInstance | null {\n  return currentInstance;\n}\n\n// Export for SSR to set temporary instance\nexport function setCurrentComponentInstance(\n  instance: ComponentInstance | null\n): void {\n  currentInstance = instance;\n}\n\n/**\n * Register a mount operation that will run after the component is mounted\n * Used by operations (task, on, timer, etc) to execute after render completes\n */\nimport { isBulkCommitActive } from './fastlane';\nimport { evaluate, cleanupInstancesUnder } from '../renderer';\n\nexport function registerMountOperation(\n  operation: () => void | (() => void) | Promise<void | (() => void)>\n): void {\n  const instance = getCurrentComponentInstance();\n  if (instance) {\n    // If we're in bulk-commit fast lane, registering mount operations is a\n    // violation of the fast-lane preconditions. Throw in dev, otherwise ignore\n    // silently in production (we must avoid scheduling work during bulk commit).\n    if (isBulkCommitActive()) {\n      if (isDevelopmentEnvironment()) {\n        throw new Error(\n          'registerMountOperation called during bulk commit fast-lane'\n        );\n      }\n      return;\n    }\n    instance.mountOperations.push(operation);\n  }\n}\n\n/**\n * Execute all mount operations for a component\n * These run after the component is rendered and mounted to the DOM\n */\nfunction executeMountOperations(instance: ComponentInstance): void {\n  // Only execute mount operations for root app instance. Child component\n  // operations are currently registered but should not be executed (per\n  // contract tests). They remain registered for cleanup purposes.\n  if (!instance.isRoot) return;\n\n  const mountOperations = instance.mountOperations;\n  if (mountOperations.length === 0) {\n    return;\n  }\n\n  for (const operation of mountOperations) {\n    const result = operation();\n    if (result instanceof Promise) {\n      result.then((cleanup) => {\n        if (typeof cleanup === 'function') {\n          instance.cleanupFns.push(cleanup);\n        }\n      });\n    } else if (typeof result === 'function') {\n      instance.cleanupFns.push(result);\n    }\n  }\n  // Clear the operations array so they don't run again on subsequent renders\n  instance.mountOperations = [];\n}\n\nexport function mountInstanceInline(\n  instance: ComponentInstance,\n  target: Element | null\n): void {\n  instance.target = target;\n  // Record backref on host element so renderer can clean up when the\n  // node is removed. Avoids leaks if the node is detached or replaced.\n  try {\n    if (target instanceof Element) {\n      const host = target as Element & {\n        __ASKR_INSTANCE?: ComponentInstance;\n        __ASKR_INSTANCES?: ComponentInstance[];\n      };\n      const instances = host.__ASKR_INSTANCES ?? [];\n      const nextInstances = instances.filter((entry) => entry !== instance);\n      nextInstances.push(instance);\n      host.__ASKR_INSTANCES = nextInstances;\n      host.__ASKR_INSTANCE = nextInstances[0] ?? instance;\n    }\n  } catch (err) {\n    void err;\n  }\n\n  // Ensure notifyUpdate is available for async resource completions that may\n  // try to trigger re-render. This mirrors the setup in executeComponent().\n  // Use prebound enqueue helper to avoid allocating a new closure\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  const wasFirstMount = !instance.mounted;\n  instance.mounted = true;\n  if (wasFirstMount && instance.mountOperations.length > 0) {\n    executeMountOperations(instance);\n  }\n}\n\n/**\n * Run a component synchronously: execute function, handle result\n * This is the internal workhorse that manages async continuations and generation tracking.\n * Must always be called through the scheduler.\n *\n * ACTOR INVARIANT: This function is enqueued as a task, never called directly.\n */\nlet _globalRenderCounter = 0;\n\nfunction resetRenderState(instance: ComponentInstance): void {\n  instance.stateIndexCheck = -1;\n\n  for (const state of instance.stateValues) {\n    if (state) {\n      state._hasBeenRead = false;\n    }\n  }\n\n  instance._pendingReadSources = undefined;\n}\n\nfunction nextRenderToken(): number {\n  return ++_globalRenderCounter;\n}\n\nexport function renderScopedComponent<T>(\n  instance: ComponentInstance,\n  startStateIndex: number,\n  render: () => T\n): T {\n  const savedInstance = currentInstance;\n  const savedStateIndex = stateIndex;\n\n  instance.notifyUpdate = instance._enqueueRun!;\n  resetRenderState(instance);\n  instance._currentRenderToken = nextRenderToken();\n\n  currentInstance = instance;\n  stateIndex = startStateIndex;\n\n  let didComplete = false;\n\n  try {\n    const executionFrame: ContextFrame = {\n      parent: instance.ownerFrame,\n      values: null,\n    };\n    const result = withContext(executionFrame, render);\n    didComplete = true;\n    return result;\n  } finally {\n    if (!didComplete) {\n      instance._pendingReadSources = undefined;\n      instance._currentRenderToken = undefined;\n    }\n    currentInstance = savedInstance;\n    stateIndex = savedStateIndex;\n  }\n}\n\nfunction runComponent(instance: ComponentInstance): void {\n  // CRITICAL: Ensure notifyUpdate is available for state.set() calls during this render.\n  // This must be set before executeComponentSync() runs, not after.\n  // Use prebound enqueue helper to avoid allocating per-render closures\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  // Assign a token for this in-progress render and start a fresh pending-read set\n  instance._currentRenderToken = nextRenderToken();\n  instance._pendingReadSources = undefined;\n  const domSnapshot = instance.target ? instance.target.innerHTML : '';\n\n  const result = executeComponentSync(instance);\n  if (result instanceof Promise) {\n    // Async components are not supported. Components must be synchronous and\n    // must not return a Promise from their render function.\n    throw new Error(\n      'Async components are not supported. Components must be synchronous.'\n    );\n  } else {\n    // Try runtime fast-lane synchronously; if it activates we do not enqueue\n    // follow-up work and the commit happens atomically in this task.\n    // (Runtime fast-lane has conservative preconditions.)\n    const fastlaneBridge = (\n      globalThis as {\n        __ASKR_FASTLANE?: {\n          tryRuntimeFastLaneSync?: (\n            instance: unknown,\n            result: unknown\n          ) => boolean;\n        };\n      }\n    ).__ASKR_FASTLANE;\n    try {\n      const used = fastlaneBridge?.tryRuntimeFastLaneSync?.(instance, result);\n      if (used) {\n        warnUnusedStateReads(instance);\n        return;\n      }\n    } catch (err) {\n      // If invariant check failed in dev, surface the error; otherwise fall back\n      if (isDevelopmentEnvironment()) throw err;\n    }\n\n    // Fallback: enqueue the render/commit normally\n    globalScheduler.enqueue(() => {\n      // Handle placeholder-based updates: when a component initially returned null,\n      // we created a comment placeholder. If it now has content, we need to create\n      // a host element and replace the placeholder.\n      if (!instance.target && instance._placeholder) {\n        // Component previously returned null (has placeholder), check if now has content\n        if (result === null || result === undefined) {\n          // Still null - nothing to do, keep placeholder\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n          return;\n        }\n\n        // Has content now - need to create DOM and replace placeholder\n        const placeholder = instance._placeholder;\n        const parent = placeholder.parentNode;\n        if (!parent) {\n          // Placeholder was removed from DOM - can't render\n          logger.warn(\n            '[Askr] placeholder no longer in DOM, cannot render component'\n          );\n          return;\n        }\n\n        // Create a new host element for the content\n        const host = document.createElement('div');\n        const executionFrame: ContextFrame = {\n          parent: instance.ownerFrame,\n          values: null,\n        };\n\n        // Set up instance for normal updates\n        const oldInstance = currentInstance;\n        currentInstance = instance;\n        try {\n          withContext(executionFrame, () => {\n            evaluate(result, host);\n          });\n\n          // Replace placeholder with host\n          parent.replaceChild(host, placeholder);\n\n          // Set up instance for future updates\n          instance.target = host;\n          instance._placeholder = undefined;\n          (\n            host as Element & { __ASKR_INSTANCE?: ComponentInstance }\n          ).__ASKR_INSTANCE = instance;\n\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n        } finally {\n          currentInstance = oldInstance;\n        }\n        return;\n      }\n\n      if (instance.target) {\n        let oldChildren: Node[] = [];\n        try {\n          const wasFirstMount = !instance.mounted;\n          // Ensure nested component executions during evaluation have access to\n          // the current component instance. This allows nested components to\n          // call `state()`, `resource()`, and other runtime helpers which\n          // rely on `getCurrentComponentInstance()` being available.\n          const oldInstance = currentInstance;\n          currentInstance = instance;\n          const executionFrame: ContextFrame = {\n            parent: instance.ownerFrame,\n            values: null,\n          };\n          // Capture snapshot of current children (by reference) so we can\n          // restore them on render failure without losing event listeners or\n          // instance attachments.\n          oldChildren = Array.from(instance.target.childNodes);\n\n          try {\n            withContext(executionFrame, () => {\n              evaluate(result, instance.target);\n            });\n          } catch (e) {\n            // If evaluation failed, attempt to cleanup any partially-added nodes\n            // and restore the old children to preserve listeners and instances.\n            try {\n              const newChildren = Array.from(instance.target.childNodes);\n              for (const n of newChildren) {\n                try {\n                  cleanupInstancesUnder(n);\n                } catch (err) {\n                  logger.warn(\n                    '[Askr] error cleaning up failed commit children:',\n                    err\n                  );\n                }\n              }\n            } catch (_err) {\n              void _err;\n            }\n\n            // Restore original children by re-inserting the old node references\n            // this preserves attached listeners and instance backrefs.\n            try {\n              incDevCounter('__DOM_REPLACE_COUNT');\n              setDevValue(\n                '__LAST_DOM_REPLACE_STACK_COMPONENT_RESTORE',\n                new Error().stack\n              );\n            } catch (e) {\n              void e;\n            }\n            instance.target.replaceChildren(...oldChildren);\n            throw e;\n          } finally {\n            currentInstance = oldInstance;\n          }\n\n          // Commit succeeded — finalize recorded state reads so subscriptions reflect\n          // the last *committed* render. This updates per-state reader maps\n          // deterministically and synchronously with the commit.\n          finalizeReadSubscriptions(instance);\n          warnUnusedStateReads(instance);\n\n          instance.mounted = true;\n          // Execute mount operations after first mount (do NOT run these with\n          // currentInstance set - they may perform state mutations/registrations)\n          if (wasFirstMount && instance.mountOperations.length > 0) {\n            executeMountOperations(instance);\n          }\n        } catch (renderError) {\n          // Atomic rendering: rollback on render error. Attempt non-lossy restore of\n          // original child node references to preserve listeners/instances.\n          try {\n            const currentChildren = Array.from(instance.target.childNodes);\n            for (const n of currentChildren) {\n              try {\n                cleanupInstancesUnder(n);\n              } catch (err) {\n                logger.warn(\n                  '[Askr] error cleaning up partial children during rollback:',\n                  err\n                );\n              }\n            }\n          } catch (_err) {\n            void _err;\n          }\n\n          try {\n            incDevCounter('__DOM_REPLACE_COUNT');\n            setDevValue(\n              '__LAST_DOM_REPLACE_STACK_COMPONENT_ROLLBACK',\n              new Error().stack\n            );\n            instance.target.replaceChildren(...oldChildren);\n          } catch {\n            // Fallback to innerHTML restore if replaceChildren fails for some reason.\n            instance.target.innerHTML = domSnapshot;\n          }\n\n          throw renderError;\n        }\n      }\n    });\n  }\n}\n\n/**\n * Execute a component's render function synchronously.\n * Returns either a vnode/promise immediately (does NOT render).\n * Rendering happens separately through runComponent.\n */\nexport function renderComponentInline(\n  instance: ComponentInstance\n): unknown | Promise<unknown> {\n  // Ensure inline executions (rendered during parent's evaluate) still\n  // receive a render token and have their state reads finalized so\n  // subscriptions are correctly recorded. If this function is called\n  // as part of a scheduled run, the token will already be set by\n  // runComponent and we should not overwrite it.\n  const hadToken = instance._currentRenderToken !== undefined;\n  const prevToken = instance._currentRenderToken;\n  const prevPendingReads = instance._pendingReadSources;\n  if (!hadToken) {\n    instance._currentRenderToken = nextRenderToken();\n    instance._pendingReadSources = undefined;\n  }\n\n  try {\n    const result = executeComponentSync(instance);\n    // If we set the token for inline execution, finalize subscriptions now\n    // because the component is effectively committed as part of the parent's\n    // synchronous evaluation.\n    if (!hadToken) {\n      finalizeReadSubscriptions(instance);\n    }\n    return result;\n  } finally {\n    // Restore previous token/read states for nested inline render scenarios\n    instance._currentRenderToken = prevToken;\n    instance._pendingReadSources = prevPendingReads;\n  }\n}\n\nexport function warnUnusedStateReads(instance: ComponentInstance): void {\n  for (let i = 0; i < instance.stateValues.length; i++) {\n    const state = instance.stateValues[i];\n    const hasCommittedUsage =\n      (state?._readers?.size ?? 0) > 0 ||\n      ((state as { _derivedSubscribers?: Set<unknown> } | undefined)\n        ?._derivedSubscribers?.size ?? 0) > 0;\n\n    if (state && !state._hasBeenRead && !hasCommittedUsage) {\n      try {\n        const name = instance.fn?.name || '<anonymous>';\n        warnInstanceOnce(\n          instance,\n          `unused-state:${i}`,\n          `[askr] Unused state variable detected in ${name} at index ${i}. State should be read during render or removed.`\n        );\n      } catch {\n        warnInstanceOnce(\n          instance,\n          `unused-state:${i}`,\n          `[askr] Unused state variable detected. State should be read during render or removed.`\n        );\n      }\n    }\n  }\n}\n\nfunction executeComponentSync(\n  instance: ComponentInstance\n): unknown | Promise<unknown> {\n  resetRenderState(instance);\n  incDevCounter('componentRuns');\n  incDevCounter('componentReruns');\n\n  currentInstance = instance;\n  stateIndex = 0;\n\n  try {\n    // Track render time in dev mode\n    const renderStartTime = isDevelopmentEnvironment() ? Date.now() : 0;\n\n    // Create context object with abort signal\n    const context = {\n      get signal(): AbortSignal {\n        return ensureAbortController(instance).signal;\n      },\n    };\n\n    // Execute component within its owner frame (provider chain).\n    // This ensures all context reads see the correct provider values.\n    // We create a new execution frame whose parent is the ownerFrame. The\n    // `values` map is lazily allocated to avoid per-render Map allocations\n    // for components that do not use context.\n    const executionFrame: ContextFrame = {\n      parent: instance.ownerFrame,\n      values: null,\n    };\n    const result = withContext(executionFrame, () =>\n      instance.fn(instance.props, context)\n    );\n\n    // Check render time\n    const renderTime = Date.now() - renderStartTime;\n    if (renderTime > 5) {\n      warnInstanceOnce(\n        instance,\n        'slow-render',\n        `[askr] Slow render detected: ${renderTime}ms. Consider optimizing component performance.`\n      );\n    }\n\n    // Mark first render complete after successful execution\n    // This enables hook order validation on subsequent renders\n    if (!instance.firstRenderComplete) {\n      instance.firstRenderComplete = true;\n    }\n\n    return result;\n  } finally {\n    // Synchronous path: we did not push a fresh frame, so nothing to pop here.\n    currentInstance = null;\n  }\n}\n\n/**\n * Public entry point: Execute component with full lifecycle (execute + render)\n * Handles both initial mount and re-execution. Always enqueues through scheduler.\n * Single entry point to avoid lifecycle divergence.\n */\nexport function executeComponent(instance: ComponentInstance): void {\n  // Lazily recreate abort controller only when signal is actually requested.\n  instance.abortController = null;\n\n  // Setup notifyUpdate callback using prebound helper to avoid per-call closures\n  instance.notifyUpdate = instance._enqueueRun!;\n\n  // Enqueue the initial component run\n  globalScheduler.enqueue(instance._pendingRunTask!);\n}\n\nexport function getCurrentInstance(): ComponentInstance | null {\n  return currentInstance;\n}\n\n/**\n * Get the abort signal for the current component\n * Used to cancel async operations on unmount/navigation\n *\n * The signal is guaranteed to be aborted when:\n * - Component unmounts\n * - Navigation occurs (different route)\n * - Parent is destroyed\n *\n * IMPORTANT: getSignal() must be called during component render execution.\n * It captures the current component instance from context.\n *\n * @returns AbortSignal that will be aborted when component unmounts\n * @throws Error if called outside component execution\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render, used in async operation\n * export async function UserPage({ id }: { id: string }) {\n *   const signal = getSignal();\n *   const user = await fetch(`/api/users/${id}`, { signal });\n *   return <div>{user.name}</div>;\n * }\n *\n * // ✅ Correct: passed to event handler\n * export function Button() {\n *   const signal = getSignal();\n *   return {\n *     type: 'button',\n *     props: {\n *       onClick: async () => {\n *         const data = await fetch(url, { signal });\n *       }\n *     }\n *   };\n * }\n *\n * // ❌ Wrong: called outside component context\n * const signal = getSignal(); // Error: not in component\n * ```\n */\nexport function getSignal(): AbortSignal {\n  if (!currentInstance) {\n    throw new Error(\n      'getSignal() can only be called during component render execution. ' +\n        'Ensure you are calling this from inside your component function.'\n    );\n  }\n  return ensureAbortController(currentInstance).signal;\n}\n\n/**\n * Finalize read subscriptions for an instance after a successful commit.\n * - Update per-state readers map to point to this instance's last committed token\n * - Remove this instance from states it no longer reads\n * This is deterministic and runs synchronously with commit to ensure\n * subscribers are only notified when they actually read a state in their\n * last committed render.\n */\nexport function finalizeReadSubscriptions(instance: ComponentInstance): void {\n  finalizeReadableSubscriptions(instance);\n}\n\nexport function getNextStateIndex(): number {\n  return stateIndex++;\n}\n\nexport function claimHookIndex(\n  instance: ComponentInstance,\n  hookName: string\n): number {\n  const index = getNextStateIndex();\n\n  if (index < instance.stateIndexCheck) {\n    throw new Error(\n      `Hook index violation: ${hookName}() call at index ${index}, ` +\n        `but previously saw index ${instance.stateIndexCheck}. ` +\n        `This happens when render-scoped hooks are called conditionally (inside if/for/etc). ` +\n        `Move all ${hookName}() calls to the top level of your component function, ` +\n        `before any conditionals.`\n    );\n  }\n\n  instance.stateIndexCheck = index;\n\n  if (instance.firstRenderComplete) {\n    if (!instance.expectedStateIndices.includes(index)) {\n      throw new Error(\n        `Hook order violation: ${hookName}() called at index ${index}, ` +\n          `but this index was not in the first render's sequence [${instance.expectedStateIndices.join(', ')}]. ` +\n          `This usually means ${hookName}() is inside a conditional or loop. ` +\n          `Move all render-scoped hooks to the top level of your component function.`\n      );\n    }\n  } else {\n    instance.expectedStateIndices.push(index);\n  }\n\n  return index;\n}\n\nexport function getCurrentStateIndex(): number {\n  return stateIndex;\n}\n\nexport function resetStateIndex(): void {\n  stateIndex = 0;\n}\n\nexport function setStateIndex(value: number): void {\n  stateIndex = value;\n}\n\n/**\n * Mount a component instance.\n * This is just an alias to executeComponent() to maintain API compatibility.\n * All lifecycle logic is unified in executeComponent().\n */\nexport function mountComponent(instance: ComponentInstance): void {\n  executeComponent(instance);\n}\n\n/**\n * Clean up component — abort pending operations\n * Called on unmount or route change\n */\nexport function cleanupComponent(instance: ComponentInstance): void {\n  const ownedChildScopes = instance._ownedChildScopes;\n  if (ownedChildScopes && ownedChildScopes.size > 0) {\n    instance._ownedChildScopes = new Set();\n    for (const scope of ownedChildScopes) {\n      scope.dispose();\n    }\n  }\n\n  // Execute cleanup functions (from mount effects)\n  const cleanupErrors: unknown[] = [];\n  const cleanupFns = instance.cleanupFns;\n  for (const cleanup of cleanupFns) {\n    try {\n      cleanup();\n    } catch (err) {\n      if (instance.cleanupStrict) {\n        cleanupErrors.push(err);\n      } else {\n        // Preserve previous behavior: log warnings in dev and continue\n        if (isDevelopmentEnvironment()) {\n          logger.warn('[Askr] cleanup function threw:', err);\n        }\n      }\n    }\n  }\n  instance.cleanupFns = [];\n  if (cleanupErrors.length > 0) {\n    // If strict mode, surface all cleanup errors as an AggregateError after attempting all cleanups\n    throw new AggregateError(\n      cleanupErrors,\n      `Cleanup failed for component ${instance.id}`\n    );\n  }\n\n  // Remove deterministic state subscriptions for this instance\n  cleanupReadableSubscriptions(instance);\n\n  // Abort all pending operations\n  if (instance.abortController && !instance.abortController.signal.aborted) {\n    instance.abortController.abort();\n  }\n  instance.abortController = null;\n\n  // Clear update callback to prevent dangling references and stale updates\n  instance.notifyUpdate = null;\n  instance._placeholder = undefined;\n\n  // Mark instance as unmounted so external tracking (e.g., portal host lists)\n  // can deterministically prune stale instances. Not marking this leads to\n  // retained \"mounted\" flags across cleanup boundaries which breaks\n  // owner selection in the portal fallback.\n  instance.mounted = false;\n}\n\nexport function registerOwnedChildScope(\n  instance: ComponentInstance,\n  scope: OwnedChildScope\n): void {\n  const scopes = (instance._ownedChildScopes ??= new Set());\n  scopes.add(scope);\n}\n\nexport function unregisterOwnedChildScope(\n  instance: ComponentInstance,\n  scope: OwnedChildScope\n): void {\n  instance._ownedChildScopes?.delete(scope);\n}\n\nfunction warnInstanceOnce(\n  instance: ComponentInstance,\n  key: string,\n  message: string\n): void {\n  if (isProductionEnvironment()) return;\n  const warnings = (instance.devWarningsEmitted ??= new Set());\n  if (warnings.has(key)) return;\n  warnings.add(key);\n  logger.warn(message);\n}\n"],"mappings":"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"}

package/dist/runtime/context.d.ts

@@ -1,39 +1,23 @@
-/**
- * Context system: lexical scope + render-time snapshots
- *
- * CORE SEMANTIC (Option A — Snapshot-Based):
- * ============================================
- * An async resource observes the context of the render that created it.
- * Context changes only take effect via re-render, not magically mid-await.
- *
- * This ensures:
- * - Deterministic behavior
- * - Concurrency safety
- * - Replayable execution
- * - Debuggability
- *
- * INVARIANTS:
- * - readContext() only works during component render (has currentContextFrame)
- * - Each render captures a context snapshot
- * - Async continuations see the snapshot from render start (frozen)
- * - Provider (Scope) creates a new frame that shadows parent
- * - Context updates require re-render to take effect
- */
-import type { JSXElement } from '../common/jsx';
-export type ContextKey = symbol;
-export interface Context<T> {
-    readonly key: ContextKey;
-    readonly defaultValue: T;
-    readonly Scope: (props: {
-        value: unknown;
-        children?: unknown;
-    }) => JSXElement;
+import { JSXElement } from "../common/jsx.js";
+
+//#region src/runtime/context.d.ts
+type ContextKey = symbol;
+interface Context<T> {
+  readonly key: ContextKey;
+  readonly defaultValue: T;
+  readonly Scope: (props: {
+    value: unknown;
+    children?: unknown;
+  }) => JSXElement;
 }
-export interface ContextFrame {
-    parent: ContextFrame | null;
-    values: Map<ContextKey, unknown> | null;
+interface ContextFrame {
+  parent: ContextFrame | null;
+  values: Map<ContextKey, unknown> | null;
 }
-export declare const CONTEXT_FRAME_SYMBOL: unique symbol;
+declare const CONTEXT_FRAME_SYMBOL: unique symbol;
+declare function getVNodeContextFrame(node: unknown): ContextFrame | undefined;
+declare function markVNodeWithContextFrame(node: unknown, frame: ContextFrame, overwrite?: boolean): void;
+declare function markVNodeTreeWithContextFrame(node: unknown, frame: ContextFrame | null, overwrite?: boolean): unknown;
 /**
  * Execute a function within a specific context frame.
  *
@@ -45,7 +29,7 @@ export declare const CONTEXT_FRAME_SYMBOL: unique symbol;
  *
  * This ensures no context frame remains globally active across await.
  */
-export declare function withContext<T>(frame: ContextFrame | null, fn: () => T): T;
+declare function withContext<T>(frame: ContextFrame | null, fn: () => T): T;
 /**
  * Execute an async resource step within its frozen context snapshot.
  *
@@ -55,26 +39,28 @@ export declare function withContext<T>(frame: ContextFrame | null, fn: () => T):
  * observe or rely on a live resource frame. This keeps semantics simple and
  * deterministic: async resources see only their creation-time snapshot.
  */
-export declare function withAsyncResourceContext<T>(frame: ContextFrame | null, fn: () => T): T;
-export declare function defineContext<T>(defaultValue: T): Context<T>;
-export declare function readContext<T>(context: Context<T>): T;
+declare function withAsyncResourceContext<T>(frame: ContextFrame | null, fn: () => T): T;
+declare function defineContext<T>(defaultValue: T): Context<T>;
+declare function readContext<T>(context: Context<T>): T;
 /**
  * Push a new context frame (for render entry)
  * Called by component runtime when render starts
  */
-export declare function pushContextFrame(): ContextFrame;
+declare function pushContextFrame(): ContextFrame;
 /**
  * Pop context frame (for render exit)
  * Called by component runtime when render ends
  */
-export declare function popContextFrame(): void;
+declare function popContextFrame(): void;
 /**
  * Get the current context frame for inspection (used by tests/diagnostics only)
  */
-export declare function getCurrentContextFrame(): ContextFrame | null;
+declare function getCurrentContextFrame(): ContextFrame | null;
 /**
  * Get the top of the context snapshot stack (used by runtime when deciding
  * how to link snapshots for async continuations). Returns null if stack empty.
  */
-export declare function getTopContextSnapshot(): ContextFrame | null;
+declare function getTopContextSnapshot(): ContextFrame | null;
+//#endregion
+export { Context, ContextFrame, defineContext, readContext };
 //# sourceMappingURL=context.d.ts.map