@askrjs/askr 0.0.50 → 0.0.52

package/dist/runtime/control.js

@@ -1,15 +1,100 @@
 import { getCurrentInstance } from "./component-scope.js";
+import { registerLifecycleTransaction } from "./lifecycle-batch.js";
+import "./component-lifecycle.js";
 import "./component.js";
-import { createChildScope, disposeChildScope } from "./child-scope.js";
+import { captureChildScopeTransactionSnapshot, createChildScope, disposeChildScope, restoreChildScopeTransactionSnapshot } from "./child-scope.js";
 //#region src/runtime/control.ts
 const SHOW_TRUTHY_KEY = "__show-truthy__";
 const SHOW_FALLBACK_KEY = "__show-fallback__";
 const CASE_FALLBACK_KEY = "__case-fallback__";
-function disposeBranchScope(state, scope) {
+function getBranchScopes(state) {
+	const scopes = [];
+	if (state.activeScope) scopes.push(state.activeScope);
+	if (state instanceof Object && "fallbackScope" in state) {
+		if (state.fallbackScope) scopes.push(state.fallbackScope);
+	}
+	if (state instanceof Object && "truthyScope" in state) {
+		if (state.truthyScope) scopes.push(state.truthyScope);
+	}
+	return scopes;
+}
+function beginControlTransaction(state) {
+	if (state._transaction) return state._transaction;
+	const scopeSnapshots = /* @__PURE__ */ new Map();
+	for (const scope of getBranchScopes(state)) scopeSnapshots.set(scope, captureChildScopeTransactionSnapshot(scope));
+	const transaction = {
+		state,
+		snapshot: {
+			activeKey: state.activeKey,
+			activeScope: state.activeScope,
+			activeVNodes: state.activeVNodes.slice(),
+			lastRemovedNodes: state.lastRemovedNodes.slice(),
+			lastRemovedRanges: state.lastRemovedRanges.slice(),
+			scopeSnapshots,
+			fallbackScope: "fallbackScope" in state ? state.fallbackScope : void 0,
+			truthyScope: "truthyScope" in state ? state.truthyScope : void 0
+		},
+		removedScopes: [],
+		shouldClearDomUpdateState: false,
+		registered: false
+	};
+	state._transaction = transaction;
+	transaction.registered = registerLifecycleTransaction(transaction, () => commitControlTransaction(state, transaction), () => rollbackControlTransaction(state, transaction));
+	return transaction;
+}
+function stageBranchRemoval(state, scope) {
 	if (!scope) return;
+	const transaction = state._transaction;
+	if (transaction && !transaction.removedScopes.includes(scope)) transaction.removedScopes.push(scope);
+	else if (!transaction) disposeChildScope(scope);
 	const removedDom = scope.dom;
-	disposeChildScope(scope);
 	if (removedDom) state.lastRemovedNodes.push(removedDom);
+	if (scope.range) state.lastRemovedRanges.push(scope.range);
+}
+function commitControlTransaction(state, transaction) {
+	if (state._transaction !== transaction) return;
+	const errors = [];
+	for (const scope of transaction.removedScopes) try {
+		disposeChildScope(scope);
+	} catch (error) {
+		errors.push(error);
+	}
+	if (transaction.shouldClearDomUpdateState) {
+		if ("truthyScope" in state && state.truthyScope) state.truthyScope.needsDomUpdate = false;
+		if ("fallbackScope" in state && state.fallbackScope) state.fallbackScope.needsDomUpdate = false;
+		if (state.activeScope) state.activeScope.needsDomUpdate = false;
+		state.lastRemovedNodes = [];
+		state.lastRemovedRanges = [];
+	}
+	state._transaction = null;
+	if (errors.length > 0) throw new AggregateError(errors, "Control branch cleanup failed");
+}
+function rollbackControlTransaction(state, transaction) {
+	if (state._transaction !== transaction) return;
+	const committedScopes = new Set(transaction.snapshot.scopeSnapshots.keys());
+	const currentScopes = getBranchScopes(state);
+	const errors = [];
+	for (const scope of currentScopes) {
+		if (committedScopes.has(scope)) continue;
+		try {
+			disposeChildScope(scope);
+		} catch (error) {
+			errors.push(error);
+		}
+	}
+	state.activeKey = transaction.snapshot.activeKey;
+	state.activeScope = transaction.snapshot.activeScope;
+	state.activeVNodes = transaction.snapshot.activeVNodes;
+	state.lastRemovedNodes = transaction.snapshot.lastRemovedNodes;
+	state.lastRemovedRanges = transaction.snapshot.lastRemovedRanges;
+	if ("truthyScope" in state) state.truthyScope = transaction.snapshot.truthyScope ?? null;
+	if ("fallbackScope" in state) state.fallbackScope = transaction.snapshot.fallbackScope ?? null;
+	for (const [scope, snapshot] of transaction.snapshot.scopeSnapshots) restoreChildScopeTransactionSnapshot(scope, snapshot);
+	state._transaction = null;
+	if (errors.length > 0) throw new AggregateError(errors, "Control branch rollback cleanup failed");
+}
+function finishImmediateControlTransaction(state, transaction) {
+	if (state._transaction === transaction && !transaction.registered) commitControlTransaction(state, transaction);
 }
 function createBranchScope(state, key) {
 	return createChildScope(state.parentInstance, key, () => {
@@ -28,9 +113,11 @@ function createShowState(value, renderTruthy, renderFallback) {
 		activeVNodes: [],
 		fallbackScope: null,
 		lastRemovedNodes: [],
+		lastRemovedRanges: [],
 		parentInstance: getCurrentInstance(),
 		_enqueueBoundaryCommit: null,
 		_hasPendingBoundaryCommit: false,
+		_transaction: null,
 		renderFallback,
 		renderTruthy,
 		selectedValue: value,
@@ -38,46 +125,59 @@ function createShowState(value, renderTruthy, renderFallback) {
 	};
 }
 function evaluateShowState(state) {
+	const transaction = beginControlTransaction(state);
 	state.lastRemovedNodes = [];
-	if (state.selectedValue) {
-		if (state.fallbackScope) {
-			disposeBranchScope(state, state.fallbackScope);
-			state.fallbackScope = null;
-		}
-		const truthyScope = state.truthyScope ?? createBranchScope(state, SHOW_TRUTHY_KEY);
-		state.truthyScope = truthyScope;
-		state.activeScope = truthyScope;
-		state.activeKey = SHOW_TRUTHY_KEY;
-		const vnode = truthyScope.render(() => state.renderTruthy(state.selectedValue));
-		state.activeVNodes = vnode == null || vnode === false ? [] : [vnode];
-		return state.activeVNodes;
-	}
-	if (state.truthyScope) {
-		disposeBranchScope(state, state.truthyScope);
-		state.truthyScope = null;
-	}
-	if (!state.renderFallback) {
-		if (state.fallbackScope) {
-			disposeBranchScope(state, state.fallbackScope);
-			state.fallbackScope = null;
+	state.lastRemovedRanges = [];
+	try {
+		if (state.selectedValue) {
+			if (state.fallbackScope) {
+				stageBranchRemoval(state, state.fallbackScope);
+				state.fallbackScope = null;
+			}
+			const truthyScope = state.truthyScope ?? createBranchScope(state, SHOW_TRUTHY_KEY);
+			state.truthyScope = truthyScope;
+			state.activeScope = truthyScope;
+			state.activeKey = SHOW_TRUTHY_KEY;
+			const vnode = truthyScope.render(() => state.renderTruthy(state.selectedValue));
+			state.activeVNodes = vnode == null || vnode === false ? [] : [vnode];
+		} else {
+			if (state.truthyScope) {
+				stageBranchRemoval(state, state.truthyScope);
+				state.truthyScope = null;
+			}
+			if (!state.renderFallback) {
+				if (state.fallbackScope) {
+					stageBranchRemoval(state, state.fallbackScope);
+					state.fallbackScope = null;
+				}
+				state.activeKey = null;
+				state.activeScope = null;
+				state.activeVNodes = [];
+			} else {
+				const fallbackScope = state.fallbackScope ?? createBranchScope(state, SHOW_FALLBACK_KEY);
+				state.fallbackScope = fallbackScope;
+				state.activeScope = fallbackScope;
+				state.activeKey = SHOW_FALLBACK_KEY;
+				const vnode = fallbackScope.render(state.renderFallback);
+				state.activeVNodes = vnode == null || vnode === false ? [] : [vnode];
+			}
 		}
-		state.activeKey = null;
-		state.activeScope = null;
-		state.activeVNodes = [];
+		finishImmediateControlTransaction(state, transaction);
 		return state.activeVNodes;
+	} catch (error) {
+		rollbackControlTransaction(state, transaction);
+		throw error;
 	}
-	const fallbackScope = state.fallbackScope ?? createBranchScope(state, SHOW_FALLBACK_KEY);
-	state.fallbackScope = fallbackScope;
-	state.activeScope = fallbackScope;
-	state.activeKey = SHOW_FALLBACK_KEY;
-	const vnode = fallbackScope.render(state.renderFallback);
-	state.activeVNodes = vnode == null || vnode === false ? [] : [vnode];
-	return state.activeVNodes;
 }
 function clearShowDomUpdateState(state) {
 	if (state.truthyScope) state.truthyScope.needsDomUpdate = false;
 	if (state.fallbackScope) state.fallbackScope.needsDomUpdate = false;
+	if (state._transaction) {
+		state._transaction.shouldClearDomUpdateState = true;
+		return;
+	}
 	state.lastRemovedNodes = [];
+	state.lastRemovedRanges = [];
 }
 function createCaseState(matches, fallback) {
 	return {
@@ -87,40 +187,53 @@ function createCaseState(matches, fallback) {
 		activeVNodes: [],
 		fallback,
 		lastRemovedNodes: [],
+		lastRemovedRanges: [],
 		matches,
 		parentInstance: getCurrentInstance(),
 		_enqueueBoundaryCommit: null,
-		_hasPendingBoundaryCommit: false
+		_hasPendingBoundaryCommit: false,
+		_transaction: null
 	};
 }
 function evaluateCaseState(state) {
+	const transaction = beginControlTransaction(state);
 	state.lastRemovedNodes = [];
-	const selectedMatch = state.matches.find((candidate) => Boolean(candidate.when)) ?? null;
-	const nextKey = selectedMatch?.key ?? (state.fallback ? CASE_FALLBACK_KEY : null);
-	if (nextKey === null) {
-		if (state.activeScope) disposeBranchScope(state, state.activeScope);
-		state.activeKey = null;
-		state.activeScope = null;
-		state.activeVNodes = [];
+	state.lastRemovedRanges = [];
+	try {
+		const selectedMatch = state.matches.find((candidate) => Boolean(candidate.when)) ?? null;
+		const nextKey = selectedMatch?.key ?? (state.fallback ? CASE_FALLBACK_KEY : null);
+		if (nextKey === null) {
+			if (state.activeScope) stageBranchRemoval(state, state.activeScope);
+			state.activeKey = null;
+			state.activeScope = null;
+			state.activeVNodes = [];
+		} else {
+			if (state.activeScope && state.activeKey !== nextKey) {
+				stageBranchRemoval(state, state.activeScope);
+				state.activeScope = null;
+			}
+			const activeScope = state.activeScope ?? createBranchScope(state, nextKey);
+			state.activeKey = nextKey;
+			state.activeScope = activeScope;
+			const renderBranch = selectedMatch?.render ?? state.fallback;
+			const vnode = renderBranch ? activeScope.render(renderBranch) : null;
+			state.activeVNodes = vnode == null || vnode === false ? [] : [vnode];
+		}
+		finishImmediateControlTransaction(state, transaction);
 		return state.activeVNodes;
+	} catch (error) {
+		rollbackControlTransaction(state, transaction);
+		throw error;
 	}
-	if (state.activeScope && state.activeKey !== nextKey) {
-		disposeBranchScope(state, state.activeScope);
-		state.activeScope = null;
-	}
-	const activeScope = state.activeScope ?? createBranchScope(state, nextKey);
-	state.activeKey = nextKey;
-	state.activeScope = activeScope;
-	const renderBranch = selectedMatch?.render ?? state.fallback;
-	const vnode = renderBranch ? activeScope.render(renderBranch) : null;
-	state.activeVNodes = vnode == null || vnode === false ? [] : [vnode];
-	return state.activeVNodes;
 }
 function clearCaseDomUpdateState(state) {
 	if (state.activeScope) state.activeScope.needsDomUpdate = false;
+	if (state._transaction) {
+		state._transaction.shouldClearDomUpdateState = true;
+		return;
+	}
 	state.lastRemovedNodes = [];
+	state.lastRemovedRanges = [];
 }
 //#endregion
 export { clearCaseDomUpdateState, clearShowDomUpdateState, createCaseState, createShowState, evaluateCaseState, evaluateShowState };
-
-//# sourceMappingURL=control.js.map

package/dist/runtime/derive.d.ts

@@ -13,5 +13,4 @@ type SnapshotSource<T> = {
 declare function derive<TOut>(fn: () => TOut): Derived<TOut>;
 declare function derive<TIn, TOut>(source: SnapshotSource<TIn> | TIn | (() => TIn), map: (value: TIn) => TOut): Derived<TOut | null>;
 //#endregion
-export { Derived, derive };
-//# sourceMappingURL=derive.d.ts.map
+export { Derived, derive };

package/dist/runtime/derive.js

@@ -138,5 +138,3 @@ function derive(source, map) {
 }
 //#endregion
 export { derive };
-
-//# sourceMappingURL=derive.js.map

package/dist/runtime/dev-namespace.d.ts

@@ -0,0 +1,30 @@
+//#region src/runtime/dev-namespace.d.ts
+/**
+ * Dev-only namespace helpers for diagnostics
+ *
+ * Centralizes the repetitive globalThis.__ASKR__ access pattern
+ * used throughout runtime for dev-mode diagnostics.
+ */
+type DevNamespace = Record<string, unknown>;
+/**
+ * Get or create the __ASKR__ dev namespace on globalThis.
+ * Returns empty object in production to avoid allocations.
+ */
+declare const getDevNamespace: () => DevNamespace;
+/**
+ * Set a value in the dev namespace (no-op in production).
+ */
+declare const setDevValue: (key: string, value: unknown) => void;
+/**
+ * Get a value from the dev namespace (returns undefined in production).
+ */
+declare const getDevValue: <T>(key: string) => T | undefined;
+/**
+ * Delete a value from the dev namespace (no-op in production).
+ */
+declare const deleteDevValue: (key: string) => void;
+/**
+ * Increment a counter in the dev namespace (no-op in production).
+ * Safely handles non-number values by resetting to 1.
+ */
+declare const incDevCounter: (key: string) => void;

package/dist/runtime/dev-namespace.js

@@ -6,52 +6,59 @@ import { isProductionEnvironment } from "../common/env.js";
 * Centralizes the repetitive globalThis.__ASKR__ access pattern
 * used throughout runtime for dev-mode diagnostics.
 */
-/**
-* Get or create the __ASKR__ dev namespace on globalThis.
-* Returns empty object in production to avoid allocations.
-*/
-function getDevNamespace() {
-	if (isProductionEnvironment()) return {};
+const PRODUCTION_BUILD_ENABLED = isProductionEnvironment();
+const EMPTY_DEV_NAMESPACE = {};
+function getOrCreateDevNamespace() {
 	try {
 		const g = globalThis;
 		if (!g.__ASKR__) g.__ASKR__ = {};
 		return g.__ASKR__;
 	} catch {
-		return {};
+		return EMPTY_DEV_NAMESPACE;
 	}
 }
-/**
-* Set a value in the dev namespace (no-op in production).
-*/
-function setDevValue(key, value) {
+function getDevNamespaceLive() {
+	if (isProductionEnvironment()) return EMPTY_DEV_NAMESPACE;
+	return getOrCreateDevNamespace();
+}
+function setDevValueLive(key, value) {
 	if (isProductionEnvironment()) return;
 	try {
-		getDevNamespace()[key] = value;
+		getOrCreateDevNamespace()[key] = value;
 	} catch {}
 }
-/**
-* Get a value from the dev namespace (returns undefined in production).
-*/
-function getDevValue(key) {
+function getDevValueLive(key) {
 	if (isProductionEnvironment()) return void 0;
 	try {
-		return getDevNamespace()[key];
+		return getOrCreateDevNamespace()[key];
 	} catch {
 		return;
 	}
 }
-/**
-* Increment a counter in the dev namespace (no-op in production).
-* Safely handles non-number values by resetting to 1.
-*/
-function incDevCounter(key) {
+function incDevCounterLive(key) {
 	if (isProductionEnvironment()) return;
 	try {
-		const ns = getDevNamespace();
+		const ns = getOrCreateDevNamespace();
 		ns[key] = (typeof ns[key] === "number" ? ns[key] : 0) + 1;
 	} catch {}
 }
+/**
+* Get or create the __ASKR__ dev namespace on globalThis.
+* Returns empty object in production to avoid allocations.
+*/
+const getDevNamespace = PRODUCTION_BUILD_ENABLED ? () => EMPTY_DEV_NAMESPACE : getDevNamespaceLive;
+/**
+* Set a value in the dev namespace (no-op in production).
+*/
+const setDevValue = PRODUCTION_BUILD_ENABLED ? () => {} : setDevValueLive;
+/**
+* Get a value from the dev namespace (returns undefined in production).
+*/
+const getDevValue = PRODUCTION_BUILD_ENABLED ? () => void 0 : getDevValueLive;
+/**
+* Increment a counter in the dev namespace (no-op in production).
+* Safely handles non-number values by resetting to 1.
+*/
+const incDevCounter = PRODUCTION_BUILD_ENABLED ? () => {} : incDevCounterLive;
 //#endregion
 export { getDevNamespace, getDevValue, incDevCounter, setDevValue };
-
-//# sourceMappingURL=dev-namespace.js.map

package/dist/runtime/effect.d.ts

@@ -1,13 +1,15 @@
-import { ReadableSource } from "./readable.js";
+import { FineGrainedReadCollector, ReadableSource } from "./readable.js";
 import { SchedulerLane } from "./scheduler.js";
 
 //#region src/runtime/effect.d.ts
-interface FineGrainedEffect<T> {
+type EffectReadSources = ReadableSource<unknown> | ReadableSource<unknown>[] | Set<ReadableSource<unknown>> | null;
+interface FineGrainedEffect<T> extends FineGrainedReadCollector {
   lane: SchedulerLane;
   compute(): T;
   commit(value: T, previousValue: T | undefined): void;
   equals(previousValue: T, nextValue: T): boolean;
-  readSources: Set<ReadableSource<unknown>>;
+  readSources: EffectReadSources;
+  readSource2: ReadableSource<unknown> | null;
   isActive: boolean;
   hasValue: boolean;
   lastValue: T | undefined;
@@ -27,6 +29,7 @@ interface CreateFineGrainedEffectOptions<T> {
 }
 declare function markFineGrainedEffectsDirtySource(source: ReadableSource<unknown>): void;
 declare function createFineGrainedEffect<T>(options: CreateFineGrainedEffectOptions<T>): FineGrainedEffectHandle<T>;
+/** @internal Allocation-sensitive variant for shared renderer callbacks. */
+declare function createOwnedFineGrainedEffect<T>(lane: SchedulerLane, compute: () => T, commit: (value: T, previousValue: T | undefined) => void, equals: (previousValue: T, nextValue: T) => boolean, onError: ((error: unknown) => void) | undefined, owner: unknown): FineGrainedEffectHandle<T>;
 //#endregion
-export { CreateFineGrainedEffectOptions, FineGrainedEffectHandle };
-//# sourceMappingURL=effect.d.ts.map
+export { CreateFineGrainedEffectOptions, FineGrainedEffectHandle };