@askrjs/askr 0.0.36 → 0.0.38

package/dist/runtime/selector.js

@@ -4,7 +4,8 @@ import { clearDerivedDependencySubscriptions, markReactivePropsDirtySource, mark
 import { claimHookIndex, getCurrentInstance } from "./component.js";
 //#region src/runtime/selector.ts
 const selectorCells = /* @__PURE__ */ new WeakMap();
-const dirtySelectorCells = /* @__PURE__ */ new Set();
+const selectorRecords = /* @__PURE__ */ new WeakMap();
+const dirtySelectorRecords = /* @__PURE__ */ new Set();
 let hasPendingSelectorFlush = false;
 function getSelectorStore(instance) {
 	let store = selectorCells.get(instance);
@@ -17,24 +18,24 @@ function getSelectorStore(instance) {
 function scheduleSelectorFlush() {
 	if (hasPendingSelectorFlush) return;
 	hasPendingSelectorFlush = true;
-	globalScheduler.enqueueInLane("derived", flushDirtySelectorCells);
+	globalScheduler.enqueueInLane("derived", flushDirtySelectorRecords);
 }
-function markSelectorCellDirty(cell) {
-	cell._dirty = true;
-	if (cell._scheduled) return;
-	cell._scheduled = true;
-	dirtySelectorCells.add(cell);
+function markSelectorRecordDirty(record) {
+	record._dirty = true;
+	if (record._scheduled) return;
+	record._scheduled = true;
+	dirtySelectorRecords.add(record);
 	scheduleSelectorFlush();
 }
-function flushDirtySelectorCells() {
+function flushDirtySelectorRecords() {
 	hasPendingSelectorFlush = false;
-	if (dirtySelectorCells.size === 0) return;
-	const pending = Array.from(dirtySelectorCells);
-	dirtySelectorCells.clear();
-	for (const cell of pending) {
-		cell._scheduled = false;
-		if (!cell._dirty) continue;
-		recomputeSelectorCell(cell, true);
+	if (dirtySelectorRecords.size === 0) return;
+	const pending = Array.from(dirtySelectorRecords);
+	dirtySelectorRecords.clear();
+	for (const record of pending) {
+		record._scheduled = false;
+		if (!record._dirty) continue;
+		recomputeSelectorSourceRecord(record, true);
 	}
 }
 function isObjectCandidate(value) {
@@ -48,131 +49,206 @@ function createCandidateSource(candidate) {
 	source._candidate = candidate;
 	return source;
 }
-function getCandidateSource(cell, candidate) {
+function getCandidateSource(lane, candidate) {
 	if (isObjectCandidate(candidate)) {
-		const cached = cell._objectCandidates.get(candidate);
+		const cached = lane._objectCandidates.get(candidate);
 		if (cached) return cached;
 		const created = createCandidateSource(candidate);
-		created._candidate = candidate;
-		cell._objectCandidates.set(candidate, created);
-		cell._objectCandidateSources.add(created);
+		lane._objectCandidates.set(candidate, created);
+		lane._objectCandidateSources.add(created);
 		return created;
 	}
 	const key = candidate;
-	const cached = cell._primitiveCandidates.get(key);
+	const cached = lane._primitiveCandidates.get(key);
 	if (cached) return cached;
 	const created = createCandidateSource(candidate);
-	created._candidate = candidate;
-	cell._primitiveCandidates.set(key, created);
+	lane._primitiveCandidates.set(key, created);
 	return created;
 }
+function getSelectorSourceRecord(source) {
+	const cached = selectorRecords.get(source);
+	if (cached) return cached;
+	const record = createSelectorSourceRecord(source);
+	selectorRecords.set(source, record);
+	return record;
+}
+function createSelectorSourceRecord(source) {
+	let record;
+	record = {
+		_source: source,
+		_value: void 0,
+		_hasValue: false,
+		_dirty: true,
+		_scheduled: false,
+		_evaluating: false,
+		_sources: /* @__PURE__ */ new Set(),
+		_lanes: /* @__PURE__ */ new Map(),
+		_markDirty: () => {
+			markSelectorRecordDirty(record);
+		},
+		_cleanup: () => {
+			record._scheduled = false;
+			record._dirty = false;
+			record._hasValue = false;
+			record._evaluating = false;
+			record._pendingDependencySources = void 0;
+			clearDerivedDependencySubscriptions(record, record._sources);
+			record._lanes.clear();
+			selectorRecords.delete(source);
+		}
+	};
+	return record;
+}
+function getSelectorLane(record, equals) {
+	const cached = record._lanes.get(equals);
+	if (cached) return cached;
+	const lane = createSelectorLane(record, equals);
+	record._lanes.set(equals, lane);
+	return lane;
+}
+function createSelectorLane(record, equals) {
+	const lane = {
+		_record: record,
+		_equals: equals,
+		_bindingCount: 0,
+		_primitiveCandidates: /* @__PURE__ */ new Map(),
+		_objectCandidates: /* @__PURE__ */ new WeakMap(),
+		_objectCandidateSources: /* @__PURE__ */ new Set(),
+		_cleanup: () => {
+			for (const sourceRef of lane._primitiveCandidates.values()) {
+				sourceRef._readers?.clear();
+				sourceRef._derivedSubscribers?.clear();
+			}
+			for (const sourceRef of lane._objectCandidateSources) {
+				sourceRef._readers?.clear();
+				sourceRef._derivedSubscribers?.clear();
+			}
+			lane._primitiveCandidates.clear();
+			lane._objectCandidates = /* @__PURE__ */ new WeakMap();
+			lane._objectCandidateSources.clear();
+		}
+	};
+	return lane;
+}
 function notifySelectorSource(source) {
 	incrementPerfMetric("selectorInvalidations");
 	markReadableDerivedSubscribersDirty(source);
 	markReactivePropsDirtySource(source);
 	notifyReadableReaders(source);
 }
-function notifyAllSelectorSources(cell) {
-	for (const source of cell._primitiveCandidates.values()) notifySelectorSource(source);
-	for (const source of cell._objectCandidateSources) notifySelectorSource(source);
+function notifyAllSelectorSources(lane) {
+	for (const source of lane._primitiveCandidates.values()) notifySelectorSource(source);
+	for (const source of lane._objectCandidateSources) notifySelectorSource(source);
 }
-function notifySelectorValueChange(cell, prevValue, nextValue) {
-	if (!isDefaultSelectorEquals(cell._equals)) {
-		notifyAllSelectorSources(cell);
+function notifySelectorLaneValueChange(lane, prevValue, nextValue) {
+	if (!lane._bindingCount) return;
+	if (!isDefaultSelectorEquals(lane._equals)) {
+		if (lane._equals(prevValue, nextValue)) return;
+		notifyAllSelectorSources(lane);
 		return;
 	}
 	if (!Object.is(prevValue, nextValue)) {
-		notifySelectorSource(getCandidateSource(cell, prevValue));
-		notifySelectorSource(getCandidateSource(cell, nextValue));
+		notifySelectorSource(getCandidateSource(lane, prevValue));
+		notifySelectorSource(getCandidateSource(lane, nextValue));
 	}
 }
-function recomputeSelectorCell(cell, notifyDownstream) {
-	if (!cell._dirty && cell._hasValue) return cell._value;
-	if (cell._evaluating) throw new Error("selector() cannot read itself recursively");
-	cell._evaluating = true;
-	cell._dirty = false;
-	cell._pendingDependencySources = /* @__PURE__ */ new Set();
-	const prevSources = cell._sources;
-	const hadValue = cell._hasValue;
-	const prevValue = cell._value;
+function recomputeSelectorSourceRecord(record, notifyDownstream) {
+	if (!record._dirty && record._hasValue) return record._value;
+	if (record._evaluating) throw new Error("selector() cannot read itself recursively");
+	record._evaluating = true;
+	record._dirty = false;
+	record._pendingDependencySources = /* @__PURE__ */ new Set();
+	const prevSources = record._sources;
+	const hadValue = record._hasValue;
+	const prevValue = record._value;
 	let nextValue;
 	try {
-		nextValue = withDerivedReadTracking(cell, cell._source);
+		nextValue = withDerivedReadTracking(record, record._source);
 	} catch (error) {
-		cell._dirty = true;
-		cell._pendingDependencySources = void 0;
+		record._dirty = true;
+		record._pendingDependencySources = void 0;
 		throw error;
 	} finally {
-		cell._evaluating = false;
+		record._evaluating = false;
 	}
-	const nextSources = cell._pendingDependencySources ?? /* @__PURE__ */ new Set();
-	cell._pendingDependencySources = void 0;
-	syncDerivedDependencySubscriptions(cell, prevSources, nextSources);
-	cell._sources = nextSources;
-	const valueChanged = !cell._hasValue || !cell._equals(prevValue, nextValue);
-	cell._hasValue = true;
-	cell._value = nextValue;
-	if (valueChanged && notifyDownstream && hadValue) notifySelectorValueChange(cell, prevValue, nextValue);
-	return cell._value;
-}
-function createSelectorCell(instance, hookIndex, source, equals) {
-	const perfMetricsStore = getPerfMetricsStore();
-	const cell = function selectorPredicate(candidate) {
-		recordReadableRead(getCandidateSource(cell, candidate));
+	const nextSources = record._pendingDependencySources ?? /* @__PURE__ */ new Set();
+	record._pendingDependencySources = void 0;
+	syncDerivedDependencySubscriptions(record, prevSources, nextSources);
+	record._sources = nextSources;
+	const valueChanged = !record._hasValue || !Object.is(prevValue, nextValue);
+	record._hasValue = true;
+	record._value = nextValue;
+	if (valueChanged && notifyDownstream && hadValue) for (const lane of Array.from(record._lanes.values())) notifySelectorLaneValueChange(lane, prevValue, nextValue);
+	return record._value;
+}
+function attachSelectorHookBinding(hook, source, equals) {
+	const record = getSelectorSourceRecord(source);
+	const lane = getSelectorLane(record, equals);
+	hook._source = source;
+	hook._equals = equals;
+	hook._record = record;
+	hook._lane = lane;
+	lane._bindingCount += 1;
+}
+function detachSelectorHookBinding(hook) {
+	const record = hook._record;
+	const lane = hook._lane;
+	hook._record = null;
+	hook._lane = null;
+	if (!record || !lane) return;
+	if (lane._bindingCount > 0) lane._bindingCount -= 1;
+	if (lane._bindingCount > 0) return;
+	lane._cleanup();
+	record._lanes.delete(lane._equals);
+	if (record._lanes.size === 0) record._cleanup();
+}
+function ensureSelectorHookBinding(hook) {
+	const record = hook._record;
+	const lane = hook._lane;
+	if (record && lane && lane._bindingCount > 0 && record._lanes.get(hook._equals) === lane && record._source === hook._source) return record;
+	if (hook._record || hook._lane) detachSelectorHookBinding(hook);
+	attachSelectorHookBinding(hook, hook._source, hook._equals);
+	return hook._record;
+}
+function createSelectorHook(instance, hookIndex, source, equals) {
+	const hook = function selectorPredicate(candidate) {
+		const selectorHook = hook;
+		const record = ensureSelectorHookBinding(selectorHook);
+		const lane = selectorHook._lane;
+		if (!lane) throw new Error("selector() binding could not be established.");
+		recordReadableRead(getCandidateSource(lane, candidate));
+		const perfMetricsStore = getPerfMetricsStore();
 		if (perfMetricsStore) perfMetricsStore.selectorCandidateReads += 1;
-		const selectorCell = cell;
-		const current = selectorCell._dirty || !selectorCell._hasValue ? recomputeSelectorCell(selectorCell, selectorCell._scheduled) : selectorCell._value;
-		return selectorCell._equals(current, candidate);
-	};
-	cell._owner = instance;
-	cell._hookIndex = hookIndex;
-	cell._source = source;
-	cell._equals = equals;
-	cell._value = void 0;
-	cell._hasValue = false;
-	cell._dirty = true;
-	cell._scheduled = false;
-	cell._evaluating = false;
-	cell._sources = /* @__PURE__ */ new Set();
-	cell._primitiveCandidates = /* @__PURE__ */ new Map();
-	cell._objectCandidates = /* @__PURE__ */ new WeakMap();
-	cell._objectCandidateSources = /* @__PURE__ */ new Set();
-	cell._markDirty = () => {
-		markSelectorCellDirty(cell);
+		const current = record._dirty || !record._hasValue ? recomputeSelectorSourceRecord(record, record._scheduled) : record._value;
+		return lane._equals(current, candidate);
 	};
-	cell._cleanup = () => {
-		cell._scheduled = false;
-		cell._dirty = false;
-		cell._hasValue = false;
-		dirtySelectorCells.delete(cell);
-		clearDerivedDependencySubscriptions(cell, cell._sources);
-		for (const sourceRef of cell._primitiveCandidates.values()) {
-			sourceRef._readers?.clear();
-			sourceRef._derivedSubscribers?.clear();
-		}
-		for (const sourceRef of cell._objectCandidateSources) {
-			sourceRef._readers?.clear();
-			sourceRef._derivedSubscribers?.clear();
-		}
-		cell._primitiveCandidates.clear();
-		cell._objectCandidateSources.clear();
+	hook._owner = instance;
+	hook._hookIndex = hookIndex;
+	hook._source = source;
+	hook._equals = equals;
+	hook._record = null;
+	hook._lane = null;
+	hook._cleanup = () => {
+		detachSelectorHookBinding(hook);
 	};
+	attachSelectorHookBinding(hook, source, equals);
 	(instance.cleanupFns ??= []).push(() => {
-		cell._cleanup();
+		hook._cleanup();
 		selectorCells.get(instance)?.delete(hookIndex);
 	});
-	return cell;
+	return hook;
 }
-function getOrCreateSelectorCell(instance, hookIndex, source, equals) {
+function getOrCreateSelectorHook(instance, hookIndex, source, equals) {
 	const store = getSelectorStore(instance);
 	const existing = store.get(hookIndex);
 	if (existing) {
-		existing._source = source;
-		existing._equals = equals;
-		existing._dirty = true;
+		if (existing._source !== source || existing._equals !== equals) {
+			detachSelectorHookBinding(existing);
+			attachSelectorHookBinding(existing, source, equals);
+		} else ensureSelectorHookBinding(existing);
 		return existing;
 	}
-	const created = createSelectorCell(instance, hookIndex, source, equals);
+	const created = createSelectorHook(instance, hookIndex, source, equals);
 	store.set(hookIndex, created);
 	return created;
 }
@@ -180,9 +256,10 @@ function selector(source, equals = Object.is) {
 	markReadableUsage(source);
 	const instance = getCurrentInstance();
 	if (!instance) throw new Error("selector() can only be called during component render execution. Move selector() calls to the top level of your component function.");
-	const cell = getOrCreateSelectorCell(instance, claimHookIndex(instance, "selector"), source, equals);
-	recomputeSelectorCell(cell, false);
-	return cell;
+	const hook = getOrCreateSelectorHook(instance, claimHookIndex(instance, "selector"), source, equals);
+	if (!hook._record) throw new Error("selector() record binding was not established.");
+	if (!hook._record._hasValue) recomputeSelectorSourceRecord(hook._record, false);
+	return hook;
 }
 //#endregion
 export { selector };

package/dist/runtime/selector.js.map

@@ -1 +1 @@
-{"version":3,"file":"selector.js","names":[],"sources":["../../src/runtime/selector.ts"],"sourcesContent":["import {\n  claimHookIndex,\n  getCurrentInstance,\n  type ComponentInstance,\n} from './component';\nimport { globalScheduler } from './scheduler';\nimport {\n  clearDerivedDependencySubscriptions,\n  markReadableDerivedSubscribersDirty,\n  markReadableUsage,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n  recordReadableRead,\n  syncDerivedDependencySubscriptions,\n  withDerivedReadTracking,\n  type DerivedSubscriber,\n  type ReadableSource,\n} from './readable';\nimport { getPerfMetricsStore, incrementPerfMetric } from './perf-metrics';\n\ntype PrimitiveKey =\n  | string\n  | number\n  | boolean\n  | symbol\n  | bigint\n  | null\n  | undefined;\n\nexport interface Selector<T> {\n  (candidate: T): boolean;\n}\n\ninterface SelectorCandidateSource<T> extends ReadableSource<boolean> {\n  _candidate: T;\n}\n\ntype SelectorEquals<T> = {\n  bivarianceHack(a: T, b: T): boolean;\n}['bivarianceHack'];\n\ninterface SelectorCell<T> extends Selector<T>, DerivedSubscriber {\n  _owner: ComponentInstance;\n  _hookIndex: number;\n  _source: () => T;\n  _equals: SelectorEquals<T>;\n  _value: T;\n  _hasValue: boolean;\n  _dirty: boolean;\n  _scheduled: boolean;\n  _evaluating: boolean;\n  _sources: Set<ReadableSource<unknown>>;\n  _pendingDependencySources?: Set<ReadableSource<unknown>>;\n  _primitiveCandidates: Map<PrimitiveKey, SelectorCandidateSource<T>>;\n  _objectCandidates: WeakMap<object, SelectorCandidateSource<T>>;\n  _objectCandidateSources: Set<SelectorCandidateSource<T>>;\n  _cleanup(): void;\n}\n\nconst selectorCells = new WeakMap<\n  ComponentInstance,\n  Map<number, SelectorCell<unknown>>\n>();\nconst dirtySelectorCells = new Set<SelectorCell<unknown>>();\nlet hasPendingSelectorFlush = false;\n\nfunction getSelectorStore(\n  instance: ComponentInstance\n): Map<number, SelectorCell<unknown>> {\n  let store = selectorCells.get(instance);\n  if (!store) {\n    store = new Map();\n    selectorCells.set(instance, store);\n  }\n  return store;\n}\n\nfunction scheduleSelectorFlush(): void {\n  if (hasPendingSelectorFlush) {\n    return;\n  }\n  hasPendingSelectorFlush = true;\n  globalScheduler.enqueueInLane('derived', flushDirtySelectorCells);\n}\n\nfunction markSelectorCellDirty(cell: SelectorCell<unknown>): void {\n  cell._dirty = true;\n  if (cell._scheduled) {\n    return;\n  }\n\n  cell._scheduled = true;\n  dirtySelectorCells.add(cell);\n  scheduleSelectorFlush();\n}\n\nfunction flushDirtySelectorCells(): void {\n  hasPendingSelectorFlush = false;\n\n  if (dirtySelectorCells.size === 0) {\n    return;\n  }\n\n  const pending = Array.from(dirtySelectorCells);\n  dirtySelectorCells.clear();\n\n  for (const cell of pending) {\n    cell._scheduled = false;\n    if (!cell._dirty) {\n      continue;\n    }\n    recomputeSelectorCell(cell, true);\n  }\n}\n\nfunction isObjectCandidate(value: unknown): value is object {\n  return (\n    (typeof value === 'object' && value !== null) || typeof value === 'function'\n  );\n}\n\nfunction isDefaultSelectorEquals<T>(equals: SelectorEquals<T>): boolean {\n  return equals === Object.is;\n}\n\nfunction createCandidateSource<T>(candidate: T): SelectorCandidateSource<T> {\n  const source = (() => false) as SelectorCandidateSource<T>;\n  source._candidate = candidate;\n  return source;\n}\n\nfunction getCandidateSource<T>(\n  cell: SelectorCell<T>,\n  candidate: T\n): SelectorCandidateSource<T> {\n  if (isObjectCandidate(candidate)) {\n    const cached = cell._objectCandidates.get(candidate);\n    if (cached) {\n      return cached;\n    }\n\n    const created = createCandidateSource(candidate);\n    created._candidate = candidate;\n    cell._objectCandidates.set(candidate, created);\n    cell._objectCandidateSources.add(created);\n    return created;\n  }\n\n  const key = candidate as PrimitiveKey;\n  const cached = cell._primitiveCandidates.get(key);\n  if (cached) {\n    return cached;\n  }\n\n  const created = createCandidateSource(candidate);\n  created._candidate = candidate;\n  cell._primitiveCandidates.set(key, created);\n  return created;\n}\n\nfunction notifySelectorSource(source: SelectorCandidateSource<unknown>): void {\n  incrementPerfMetric('selectorInvalidations');\n  markReadableDerivedSubscribersDirty(source);\n  markReactivePropsDirtySource(source);\n  notifyReadableReaders(source);\n}\n\nfunction notifyAllSelectorSources<T>(cell: SelectorCell<T>): void {\n  for (const source of cell._primitiveCandidates.values()) {\n    notifySelectorSource(source);\n  }\n  for (const source of cell._objectCandidateSources) {\n    notifySelectorSource(source);\n  }\n}\n\nfunction notifySelectorValueChange<T>(\n  cell: SelectorCell<T>,\n  prevValue: T,\n  nextValue: T\n): void {\n  if (!isDefaultSelectorEquals(cell._equals)) {\n    notifyAllSelectorSources(cell);\n    return;\n  }\n\n  if (!Object.is(prevValue, nextValue)) {\n    notifySelectorSource(getCandidateSource(cell, prevValue));\n    notifySelectorSource(getCandidateSource(cell, nextValue));\n  }\n}\n\nfunction recomputeSelectorCell<T>(\n  cell: SelectorCell<T>,\n  notifyDownstream: boolean\n): T {\n  if (!cell._dirty && cell._hasValue) {\n    return cell._value;\n  }\n\n  if (cell._evaluating) {\n    throw new Error('selector() cannot read itself recursively');\n  }\n\n  cell._evaluating = true;\n  cell._dirty = false;\n  cell._pendingDependencySources = new Set();\n\n  const prevSources = cell._sources;\n  const hadValue = cell._hasValue;\n  const prevValue = cell._value;\n  let nextValue: T;\n\n  try {\n    nextValue = withDerivedReadTracking(cell, cell._source);\n  } catch (error) {\n    cell._dirty = true;\n    cell._pendingDependencySources = undefined;\n    throw error;\n  } finally {\n    cell._evaluating = false;\n  }\n\n  const nextSources = cell._pendingDependencySources ?? new Set();\n  cell._pendingDependencySources = undefined;\n  syncDerivedDependencySubscriptions(cell, prevSources, nextSources);\n  cell._sources = nextSources;\n\n  const valueChanged = !cell._hasValue || !cell._equals(prevValue, nextValue);\n  cell._hasValue = true;\n  cell._value = nextValue;\n\n  if (valueChanged && notifyDownstream && hadValue) {\n    notifySelectorValueChange(cell, prevValue, nextValue);\n  }\n\n  return cell._value;\n}\n\nfunction createSelectorCell<T>(\n  instance: ComponentInstance,\n  hookIndex: number,\n  source: () => T,\n  equals: SelectorEquals<T>\n): SelectorCell<T> {\n  const perfMetricsStore = getPerfMetricsStore();\n  const cell = function selectorPredicate(candidate: T): boolean {\n    const sourceRef = getCandidateSource(cell as SelectorCell<T>, candidate);\n    recordReadableRead(sourceRef);\n    if (perfMetricsStore) {\n      perfMetricsStore.selectorCandidateReads += 1;\n    }\n    const selectorCell = cell as SelectorCell<T>;\n    const current =\n      selectorCell._dirty || !selectorCell._hasValue\n        ? recomputeSelectorCell(selectorCell, selectorCell._scheduled)\n        : selectorCell._value;\n    return selectorCell._equals(current, candidate);\n  } as SelectorCell<T>;\n\n  cell._owner = instance;\n  cell._hookIndex = hookIndex;\n  cell._source = source;\n  cell._equals = equals;\n  cell._value = undefined as T;\n  cell._hasValue = false;\n  cell._dirty = true;\n  cell._scheduled = false;\n  cell._evaluating = false;\n  cell._sources = new Set();\n  cell._primitiveCandidates = new Map();\n  cell._objectCandidates = new WeakMap();\n  cell._objectCandidateSources = new Set();\n  cell._markDirty = () => {\n    markSelectorCellDirty(cell as unknown as SelectorCell<unknown>);\n  };\n  cell._cleanup = () => {\n    cell._scheduled = false;\n    cell._dirty = false;\n    cell._hasValue = false;\n    dirtySelectorCells.delete(cell as unknown as SelectorCell<unknown>);\n    clearDerivedDependencySubscriptions(cell, cell._sources);\n    for (const sourceRef of cell._primitiveCandidates.values()) {\n      sourceRef._readers?.clear();\n      sourceRef._derivedSubscribers?.clear();\n    }\n    for (const sourceRef of cell._objectCandidateSources) {\n      sourceRef._readers?.clear();\n      sourceRef._derivedSubscribers?.clear();\n    }\n    cell._primitiveCandidates.clear();\n    cell._objectCandidateSources.clear();\n  };\n\n  (instance.cleanupFns ??= []).push(() => {\n    cell._cleanup();\n    selectorCells.get(instance)?.delete(hookIndex);\n  });\n\n  return cell;\n}\n\nfunction getOrCreateSelectorCell<T>(\n  instance: ComponentInstance,\n  hookIndex: number,\n  source: () => T,\n  equals: SelectorEquals<T>\n): SelectorCell<T> {\n  const store = getSelectorStore(instance);\n  const existing = store.get(hookIndex) as SelectorCell<T> | undefined;\n  if (existing) {\n    existing._source = source;\n    existing._equals = equals;\n    existing._dirty = true;\n    return existing;\n  }\n\n  const created = createSelectorCell(instance, hookIndex, source, equals);\n  store.set(hookIndex, created as unknown as SelectorCell<unknown>);\n  return created;\n}\n\nexport function selector<T>(\n  source: () => T,\n  equals: SelectorEquals<T> = Object.is\n): Selector<T> {\n  markReadableUsage(source);\n\n  const instance = getCurrentInstance();\n  if (!instance) {\n    throw new Error(\n      'selector() can only be called during component render execution. ' +\n        'Move selector() calls to the top level of your component function.'\n    );\n  }\n\n  const hookIndex = claimHookIndex(instance, 'selector');\n  const cell = getOrCreateSelectorCell(instance, hookIndex, source, equals);\n  recomputeSelectorCell(cell, false);\n  return cell;\n}\n"],"mappings":"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"}
+{"version":3,"file":"selector.js","names":[],"sources":["../../src/runtime/selector.ts"],"sourcesContent":["import {\n  claimHookIndex,\n  getCurrentInstance,\n  type ComponentInstance,\n} from './component';\nimport { globalScheduler } from './scheduler';\nimport {\n  clearDerivedDependencySubscriptions,\n  markReadableDerivedSubscribersDirty,\n  markReadableUsage,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n  recordReadableRead,\n  syncDerivedDependencySubscriptions,\n  withDerivedReadTracking,\n  type DerivedSubscriber,\n  type ReadableSource,\n} from './readable';\nimport { getPerfMetricsStore, incrementPerfMetric } from './perf-metrics';\n\ntype PrimitiveKey =\n  | string\n  | number\n  | boolean\n  | symbol\n  | bigint\n  | null\n  | undefined;\n\nexport interface Selector<T> {\n  (candidate: T): boolean;\n}\n\ninterface SelectorCandidateSource<T> extends ReadableSource<boolean> {\n  _candidate: T;\n}\n\ntype SelectorEquals<T> = {\n  bivarianceHack(a: T, b: T): boolean;\n}['bivarianceHack'];\n\ninterface SelectorLane<T> {\n  _record: SelectorSourceRecord<T>;\n  _equals: SelectorEquals<T>;\n  _bindingCount: number;\n  _primitiveCandidates: Map<PrimitiveKey, SelectorCandidateSource<T>>;\n  _objectCandidates: WeakMap<object, SelectorCandidateSource<T>>;\n  _objectCandidateSources: Set<SelectorCandidateSource<T>>;\n  _cleanup(): void;\n}\n\ninterface SelectorSourceRecord<T> extends DerivedSubscriber {\n  _source: () => T;\n  _value: T;\n  _hasValue: boolean;\n  _dirty: boolean;\n  _scheduled: boolean;\n  _evaluating: boolean;\n  _sources: Set<ReadableSource<unknown>>;\n  _pendingDependencySources?: Set<ReadableSource<unknown>>;\n  _lanes: Map<SelectorEquals<T>, SelectorLane<T>>;\n  _cleanup(): void;\n}\n\ninterface SelectorHook<T> extends Selector<T> {\n  _owner: ComponentInstance;\n  _hookIndex: number;\n  _source: () => T;\n  _equals: SelectorEquals<T>;\n  _record: SelectorSourceRecord<T> | null;\n  _lane: SelectorLane<T> | null;\n  _cleanup(): void;\n}\n\nconst selectorCells = new WeakMap<\n  ComponentInstance,\n  Map<number, SelectorHook<unknown>>\n>();\nconst selectorRecords = new WeakMap<\n  ReadableSource<unknown>,\n  SelectorSourceRecord<unknown>\n>();\nconst dirtySelectorRecords = new Set<SelectorSourceRecord<unknown>>();\nlet hasPendingSelectorFlush = false;\n\nfunction getSelectorStore(\n  instance: ComponentInstance\n): Map<number, SelectorHook<unknown>> {\n  let store = selectorCells.get(instance);\n  if (!store) {\n    store = new Map();\n    selectorCells.set(instance, store);\n  }\n  return store;\n}\n\nfunction scheduleSelectorFlush(): void {\n  if (hasPendingSelectorFlush) {\n    return;\n  }\n\n  hasPendingSelectorFlush = true;\n  globalScheduler.enqueueInLane('derived', flushDirtySelectorRecords);\n}\n\nfunction markSelectorRecordDirty(record: SelectorSourceRecord<unknown>): void {\n  record._dirty = true;\n  if (record._scheduled) {\n    return;\n  }\n\n  record._scheduled = true;\n  dirtySelectorRecords.add(record);\n  scheduleSelectorFlush();\n}\n\nfunction flushDirtySelectorRecords(): void {\n  hasPendingSelectorFlush = false;\n\n  if (dirtySelectorRecords.size === 0) {\n    return;\n  }\n\n  const pending = Array.from(dirtySelectorRecords);\n  dirtySelectorRecords.clear();\n\n  for (const record of pending) {\n    record._scheduled = false;\n    if (!record._dirty) {\n      continue;\n    }\n    recomputeSelectorSourceRecord(record, true);\n  }\n}\n\nfunction isObjectCandidate(value: unknown): value is object {\n  return (\n    (typeof value === 'object' && value !== null) || typeof value === 'function'\n  );\n}\n\nfunction isDefaultSelectorEquals<T>(equals: SelectorEquals<T>): boolean {\n  return equals === Object.is;\n}\n\nfunction createCandidateSource<T>(candidate: T): SelectorCandidateSource<T> {\n  const source = (() => false) as SelectorCandidateSource<T>;\n  source._candidate = candidate;\n  return source;\n}\n\nfunction getCandidateSource<T>(\n  lane: SelectorLane<T>,\n  candidate: T\n): SelectorCandidateSource<T> {\n  if (isObjectCandidate(candidate)) {\n    const cached = lane._objectCandidates.get(candidate);\n    if (cached) {\n      return cached;\n    }\n\n    const created = createCandidateSource(candidate);\n    lane._objectCandidates.set(candidate, created);\n    lane._objectCandidateSources.add(created);\n    return created;\n  }\n\n  const key = candidate as PrimitiveKey;\n  const cached = lane._primitiveCandidates.get(key);\n  if (cached) {\n    return cached;\n  }\n\n  const created = createCandidateSource(candidate);\n  lane._primitiveCandidates.set(key, created);\n  return created;\n}\n\nfunction getSelectorSourceRecord<T>(source: () => T): SelectorSourceRecord<T> {\n  const cached = selectorRecords.get(source);\n  if (cached) {\n    return cached as SelectorSourceRecord<T>;\n  }\n\n  const record = createSelectorSourceRecord(source);\n  selectorRecords.set(source, record as SelectorSourceRecord<unknown>);\n  return record;\n}\n\nfunction createSelectorSourceRecord<T>(\n  source: () => T\n): SelectorSourceRecord<T> {\n  let record!: SelectorSourceRecord<T>;\n\n  record = {\n    _source: source,\n    _value: undefined as T,\n    _hasValue: false,\n    _dirty: true,\n    _scheduled: false,\n    _evaluating: false,\n    _sources: new Set(),\n    _lanes: new Map(),\n    _markDirty: () => {\n      markSelectorRecordDirty(record as SelectorSourceRecord<unknown>);\n    },\n    _cleanup: () => {\n      record._scheduled = false;\n      record._dirty = false;\n      record._hasValue = false;\n      record._evaluating = false;\n      record._pendingDependencySources = undefined;\n      clearDerivedDependencySubscriptions(record, record._sources);\n      record._lanes.clear();\n      selectorRecords.delete(source as ReadableSource<unknown>);\n    },\n  };\n\n  return record;\n}\n\nfunction getSelectorLane<T>(\n  record: SelectorSourceRecord<T>,\n  equals: SelectorEquals<T>\n): SelectorLane<T> {\n  const cached = record._lanes.get(equals);\n  if (cached) {\n    return cached;\n  }\n\n  const lane = createSelectorLane(record, equals);\n  record._lanes.set(equals, lane);\n  return lane;\n}\n\nfunction createSelectorLane<T>(\n  record: SelectorSourceRecord<T>,\n  equals: SelectorEquals<T>\n): SelectorLane<T> {\n  const lane: SelectorLane<T> = {\n    _record: record,\n    _equals: equals,\n    _bindingCount: 0,\n    _primitiveCandidates: new Map(),\n    _objectCandidates: new WeakMap(),\n    _objectCandidateSources: new Set(),\n    _cleanup: () => {\n      for (const sourceRef of lane._primitiveCandidates.values()) {\n        sourceRef._readers?.clear();\n        sourceRef._derivedSubscribers?.clear();\n      }\n      for (const sourceRef of lane._objectCandidateSources) {\n        sourceRef._readers?.clear();\n        sourceRef._derivedSubscribers?.clear();\n      }\n      lane._primitiveCandidates.clear();\n      lane._objectCandidates = new WeakMap();\n      lane._objectCandidateSources.clear();\n    },\n  };\n\n  return lane;\n}\n\nfunction notifySelectorSource(source: SelectorCandidateSource<unknown>): void {\n  incrementPerfMetric('selectorInvalidations');\n  markReadableDerivedSubscribersDirty(source);\n  markReactivePropsDirtySource(source);\n  notifyReadableReaders(source);\n}\n\nfunction notifyAllSelectorSources<T>(lane: SelectorLane<T>): void {\n  for (const source of lane._primitiveCandidates.values()) {\n    notifySelectorSource(source);\n  }\n  for (const source of lane._objectCandidateSources) {\n    notifySelectorSource(source);\n  }\n}\n\nfunction notifySelectorLaneValueChange<T>(\n  lane: SelectorLane<T>,\n  prevValue: T,\n  nextValue: T\n): void {\n  if (!lane._bindingCount) {\n    return;\n  }\n\n  if (!isDefaultSelectorEquals(lane._equals)) {\n    if (lane._equals(prevValue, nextValue)) {\n      return;\n    }\n    notifyAllSelectorSources(lane);\n    return;\n  }\n\n  if (!Object.is(prevValue, nextValue)) {\n    notifySelectorSource(getCandidateSource(lane, prevValue));\n    notifySelectorSource(getCandidateSource(lane, nextValue));\n  }\n}\n\nfunction recomputeSelectorSourceRecord<T>(\n  record: SelectorSourceRecord<T>,\n  notifyDownstream: boolean\n): T {\n  if (!record._dirty && record._hasValue) {\n    return record._value;\n  }\n\n  if (record._evaluating) {\n    throw new Error('selector() cannot read itself recursively');\n  }\n\n  record._evaluating = true;\n  record._dirty = false;\n  record._pendingDependencySources = new Set();\n\n  const prevSources = record._sources;\n  const hadValue = record._hasValue;\n  const prevValue = record._value;\n  let nextValue: T;\n\n  try {\n    nextValue = withDerivedReadTracking(record, record._source);\n  } catch (error) {\n    record._dirty = true;\n    record._pendingDependencySources = undefined;\n    throw error;\n  } finally {\n    record._evaluating = false;\n  }\n\n  const nextSources = record._pendingDependencySources ?? new Set();\n  record._pendingDependencySources = undefined;\n  syncDerivedDependencySubscriptions(record, prevSources, nextSources);\n  record._sources = nextSources;\n\n  const valueChanged = !record._hasValue || !Object.is(prevValue, nextValue);\n  record._hasValue = true;\n  record._value = nextValue;\n\n  if (valueChanged && notifyDownstream && hadValue) {\n    for (const lane of Array.from(record._lanes.values())) {\n      notifySelectorLaneValueChange(lane, prevValue, nextValue);\n    }\n  }\n\n  return record._value;\n}\n\nfunction attachSelectorHookBinding<T>(\n  hook: SelectorHook<T>,\n  source: () => T,\n  equals: SelectorEquals<T>\n): void {\n  const record = getSelectorSourceRecord(source);\n  const lane = getSelectorLane(record, equals);\n\n  hook._source = source;\n  hook._equals = equals;\n  hook._record = record;\n  hook._lane = lane;\n  lane._bindingCount += 1;\n}\n\nfunction detachSelectorHookBinding<T>(hook: SelectorHook<T>): void {\n  const record = hook._record;\n  const lane = hook._lane;\n\n  hook._record = null;\n  hook._lane = null;\n\n  if (!record || !lane) {\n    return;\n  }\n\n  if (lane._bindingCount > 0) {\n    lane._bindingCount -= 1;\n  }\n\n  if (lane._bindingCount > 0) {\n    return;\n  }\n\n  lane._cleanup();\n  record._lanes.delete(lane._equals);\n\n  if (record._lanes.size === 0) {\n    record._cleanup();\n  }\n}\n\nfunction ensureSelectorHookBinding<T>(\n  hook: SelectorHook<T>\n): SelectorSourceRecord<T> {\n  const record = hook._record;\n  const lane = hook._lane;\n\n  if (\n    record &&\n    lane &&\n    lane._bindingCount > 0 &&\n    record._lanes.get(hook._equals) === lane &&\n    record._source === hook._source\n  ) {\n    return record;\n  }\n\n  if (hook._record || hook._lane) {\n    detachSelectorHookBinding(hook);\n  }\n\n  attachSelectorHookBinding(hook, hook._source, hook._equals);\n  return hook._record!;\n}\n\nfunction createSelectorHook<T>(\n  instance: ComponentInstance,\n  hookIndex: number,\n  source: () => T,\n  equals: SelectorEquals<T>\n): SelectorHook<T> {\n  const hook = function selectorPredicate(candidate: T): boolean {\n    const selectorHook = hook as SelectorHook<T>;\n    const record = ensureSelectorHookBinding(selectorHook);\n    const lane = selectorHook._lane;\n    if (!lane) {\n      throw new Error('selector() binding could not be established.');\n    }\n\n    const sourceRef = getCandidateSource(lane, candidate);\n    recordReadableRead(sourceRef);\n\n    const perfMetricsStore = getPerfMetricsStore();\n    if (perfMetricsStore) {\n      perfMetricsStore.selectorCandidateReads += 1;\n    }\n\n    const current =\n      record._dirty || !record._hasValue\n        ? recomputeSelectorSourceRecord(record, record._scheduled)\n        : record._value;\n\n    return lane._equals(current, candidate);\n  } as SelectorHook<T>;\n\n  hook._owner = instance;\n  hook._hookIndex = hookIndex;\n  hook._source = source;\n  hook._equals = equals;\n  hook._record = null;\n  hook._lane = null;\n  hook._cleanup = () => {\n    detachSelectorHookBinding(hook);\n  };\n\n  attachSelectorHookBinding(hook, source, equals);\n\n  (instance.cleanupFns ??= []).push(() => {\n    hook._cleanup();\n    selectorCells.get(instance)?.delete(hookIndex);\n  });\n\n  return hook;\n}\n\nfunction getOrCreateSelectorHook<T>(\n  instance: ComponentInstance,\n  hookIndex: number,\n  source: () => T,\n  equals: SelectorEquals<T>\n): SelectorHook<T> {\n  const store = getSelectorStore(instance);\n  const existing = store.get(hookIndex) as SelectorHook<T> | undefined;\n  if (existing) {\n    if (existing._source !== source || existing._equals !== equals) {\n      detachSelectorHookBinding(existing);\n      attachSelectorHookBinding(existing, source, equals);\n    } else {\n      ensureSelectorHookBinding(existing);\n    }\n    return existing;\n  }\n\n  const created = createSelectorHook(instance, hookIndex, source, equals);\n  store.set(hookIndex, created as unknown as SelectorHook<unknown>);\n  return created;\n}\n\nexport function selector<T>(\n  source: () => T,\n  equals: SelectorEquals<T> = Object.is\n): Selector<T> {\n  markReadableUsage(source);\n\n  const instance = getCurrentInstance();\n  if (!instance) {\n    throw new Error(\n      'selector() can only be called during component render execution. ' +\n        'Move selector() calls to the top level of your component function.'\n    );\n  }\n\n  const hookIndex = claimHookIndex(instance, 'selector');\n  const hook = getOrCreateSelectorHook(instance, hookIndex, source, equals);\n  if (!hook._record) {\n    throw new Error('selector() record binding was not established.');\n  }\n\n  if (!hook._record._hasValue) {\n    // Initialize the shared source once so downstream selectors can subscribe,\n    // but do not consume a pending dirty state on later renders.\n    recomputeSelectorSourceRecord(hook._record, false);\n  }\n  return hook;\n}\n"],"mappings":"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"}

package/dist/runtime/state.d.ts

@@ -12,8 +12,16 @@ interface State<T> extends ReadableSource<T> {
   (): T;
   set(value: T): void;
   set(updater: (prev: T) => T): void;
-  [Symbol.iterator](): Iterator<State<T> | State<T>['set']>;
+  [Symbol.iterator](): IterableIterator<StateTuple<T>[number]>;
 }
+/**
+ * Public setter type for state cells.
+ */
+type StateSetter<T> = State<T>['set'];
+/**
+ * Tuple-first state handle returned by `state()`.
+ */
+type StateTuple<T> = [get: State<T>, set: StateSetter<T>] & State<T>;
 /**
  * Creates a local state value for a component
  * Optimized for:
@@ -29,7 +37,7 @@ interface State<T> extends ReadableSource<T> {
  * ```ts
  * // ✅ Correct: called during render
  * export function Counter() {
- *   const count = state(0);
+ *   const [count, setCount] = state(0);
  *   return { type: 'button', children: [count()] };
  * }
  *
@@ -40,7 +48,7 @@ interface State<T> extends ReadableSource<T> {
  * }
  * ```
  */
-declare function state<T>(initialValue: T): State<T>;
+declare function state<T>(initialValue: T): StateTuple<T>;
 //#endregion
-export { State, state };
+export { State, StateSetter, StateTuple, state };
 //# sourceMappingURL=state.d.ts.map

package/dist/runtime/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","names":[],"sources":["../../src/runtime/state.ts"],"mappings":";;;;;;;;;;UAkCiB,KAAA,YAAiB,cAAA,CAAe,CAAA;EAAA,IAC3C,CAAA;EACJ,GAAA,CAAI,KAAA,EAAO,CAAA;EACX,GAAA,CAAI,OAAA,GAAU,IAAA,EAAM,CAAA,KAAM,CAAA;EAAA,CACzB,MAAA,CAAO,QAAP,KAAoB,QAAA,CAAS,KAAA,CAAM,CAAA,IAAK,KAAA,CAAM,CAAA;AAAA;;;;;;;;;;;;;;;;AA6BjD;;;;;;;;;;;iBAAgB,KAAA,GAAA,CAAS,YAAA,EAAc,CAAA,GAAI,KAAA,CAAM,CAAA"}
+{"version":3,"file":"state.d.ts","names":[],"sources":["../../src/runtime/state.ts"],"mappings":";;;;;;;;;;UAkCiB,KAAA,YAAiB,cAAA,CAAe,CAAA;EAAA,IAC3C,CAAA;EACJ,GAAA,CAAI,KAAA,EAAO,CAAA;EACX,GAAA,CAAI,OAAA,GAAU,IAAA,EAAM,CAAA,KAAM,CAAA;EAAA,CACzB,MAAA,CAAO,QAAP,KAAoB,gBAAA,CAAiB,UAAA,CAAW,CAAA;AAAA;;;;KAMvC,WAAA,MAAiB,KAAA,CAAM,CAAA;;;;KAKvB,UAAA,OAAiB,GAAA,EAAK,KAAA,CAAM,CAAA,GAAI,GAAA,EAAK,WAAA,CAAY,CAAA,KAAM,KAAA,CAAM,CAAA;;;;AALzE;;;;;;;;;AAKA;;;;;;;;;;;;;;iBA4BgB,KAAA,GAAA,CAAS,YAAA,EAAc,CAAA,GAAI,UAAA,CAAW,CAAA"}

package/dist/runtime/state.js

@@ -29,7 +29,7 @@ import { claimHookIndex, getCurrentInstance } from "./component.js";
 * ```ts
 * // ✅ Correct: called during render
 * export function Counter() {
-*   const count = state(0);
+*   const [count, setCount] = state(0);
 *   return { type: 'button', children: [count()] };
 * }
 *

package/dist/runtime/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","names":[],"sources":["../../src/runtime/state.ts"],"sourcesContent":["/**\n * State primitive for Askr components\n * Optimized for minimal overhead and fast updates\n *\n * INVARIANTS ENFORCED:\n * - state() only callable during component render (currentInstance exists)\n * - state() called at top-level only (indices must be monotonically increasing)\n * - state values persist across re-renders (stored in stateValues array)\n * - state.set() cannot be called during render (causes infinite loops)\n * - state.set() always enqueues through scheduler (never direct mutation)\n * - state.set() callback (notifyUpdate) always available\n */\n\nimport {\n  claimHookIndex,\n  getCurrentInstance,\n  type ComponentInstance,\n} from './component';\nimport { isBulkCommitActive } from './fastlane';\nimport {\n  recordReadableRead,\n  type ReadableSource,\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n} from './readable';\n\n/**\n * State value holder - callable to read, has set method to update\n * @example\n * const count = state(0);\n * count();           // read: 0\n * count.set(1);      // write: triggers re-render\n */\nexport interface State<T> extends ReadableSource<T> {\n  (): T;\n  set(value: T): void;\n  set(updater: (prev: T) => T): void;\n  [Symbol.iterator](): Iterator<State<T> | State<T>['set']>; // Allows destructuring: const [get, set] = state(0)\n}\n\n/**\n * Creates a local state value for a component\n * Optimized for:\n * - O(1) read performance\n * - Minimal allocation per state\n * - Fast scheduler integration\n *\n * IMPORTANT: state() must be called during component render execution.\n * It captures the current component instance from context.\n * Calling outside a component function will throw an error.\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render\n * export function Counter() {\n *   const count = state(0);\n *   return { type: 'button', children: [count()] };\n * }\n *\n * // ❌ Wrong: called outside component\n * const count = state(0);\n * export function BadComponent() {\n *   return { type: 'div' };\n * }\n * ```\n */\nexport function state<T>(initialValue: T): State<T> {\n  // INVARIANT: state() must be called during component render\n  const instance = getCurrentInstance();\n  if (!instance) {\n    throw new Error(\n      'state() can only be called during component render execution. ' +\n        'Move state() calls to the top level of your component function.'\n    );\n  }\n\n  const index = claimHookIndex(instance, 'state');\n  const stateValues = instance.stateValues;\n\n  // INVARIANT: Reuse existing state if it exists (fast path on re-renders)\n  // This ensures state identity and persistence and enforces ownership stability\n  if (stateValues[index]) {\n    const existing = stateValues[index] as State<T> & {\n      _owner?: ComponentInstance;\n    };\n    // Ownership must be stable: the state cell belongs to the instance that\n    // created it and must never change. This checks for accidental reuse.\n    if (existing._owner !== instance) {\n      throw new Error(\n        `State ownership violation: state() called at index ${index} is owned by a different component instance. ` +\n          `State ownership is positional and immutable.`\n      );\n    }\n    return existing as State<T>;\n  }\n\n  // Create new state (slow path, only on first render) — delegated to helper\n  const cell = createStateCell(initialValue, instance);\n\n  // INVARIANT: Store state in instance for persistence across renders\n  stateValues[index] = cell;\n\n  return cell;\n}\n\n/**\n * Internal helper: create the backing state cell (value + readers + set semantics)\n * This extraction makes it easier to later split hook wiring from storage.\n */\nfunction createStateCell<T>(\n  initialValue: T,\n  instance: ComponentInstance\n): State<T> {\n  let value = initialValue;\n\n  // Per-state reader map: component -> last-committed render token\n  const readers = new Map<ComponentInstance, number>();\n\n  // Use a function as the state object (callable directly)\n  function read(): T {\n    (read as State<T>)._hasBeenRead = true;\n    recordReadableRead(read as State<T>);\n\n    return value;\n  }\n\n  // Attach the readers map to the callable so other runtime parts can access it\n  (read as State<T>)._readers = readers;\n\n  // Record explicit ownership of this state cell. Ownership is the component\n  // instance that created the state cell and must never change for the life\n  // of the cell. We expose this for runtime invariant checks/tests.\n  (read as State<T> & { _owner?: ComponentInstance })._owner = instance;\n\n  // Attach set method directly to function\n  read.set = (newValueOrUpdater: T | ((prev: T) => T)): void => {\n    // INVARIANT: State cannot be mutated during component render\n    // (when currentInstance is non-null). It must be scheduled for consistency.\n    const currentInst = getCurrentInstance();\n    if (currentInst !== null) {\n      throw new Error(\n        `[Askr] state.set() cannot be called during component render. ` +\n          `State mutations during render break the actor model and cause infinite loops. ` +\n          `Move state updates to event handlers or use conditional rendering instead.`\n      );\n    }\n\n    // Compute new value if an updater was provided\n    let newValue: T;\n    if (typeof newValueOrUpdater === 'function') {\n      // Note: function-valued state cannot be set directly via a function argument;\n      // such an argument is treated as a functional updater (this follows the common\n      // convention from other libraries). If you need to store a function as state,\n      // wrap it in an object.\n      const updater = newValueOrUpdater as (prev: T) => T;\n      newValue = updater(value);\n    } else {\n      newValue = newValueOrUpdater as T;\n    }\n\n    // Skip work if value didn't change\n    if (Object.is(value, newValue)) return;\n\n    // If a bulk commit is active, update backing value only and DO NOT notify or enqueue.\n    // Bulk commits must be side-effect silent with respect to runtime notifications.\n    if (isBulkCommitActive()) {\n      // In bulk commit mode we must be side-effect free: update backing\n      // value only and do not notify, enqueue, or log.\n      value = newValue;\n      return;\n    }\n\n    // INVARIANT: Update the value\n    value = newValue;\n\n    markReadableDerivedSubscribersDirty(read as State<T>);\n    markReactivePropsDirtySource(read as State<T>);\n\n    // notifyUpdate may be temporarily unavailable (e.g. during hydration).\n    // We intentionally avoid logging here to keep the state mutation path\n    // side-effect free. The scheduler will process updates when the system\n    // is stable.\n    // After value change, notify only components that *read* this state in their last committed render.\n    void notifyReadableReaders(read as State<T>);\n  };\n\n  // Allow destructuring assignment: const [get, set] = state(0);\n  // The state function is iterable and yields the getter then the setter\n  (\n    read as unknown as {\n      [Symbol.iterator]?: () => Iterator<State<T> | State<T>['set']>;\n    }\n  )[Symbol.iterator] = function* (): Generator<\n    State<T> | State<T>['set'],\n    void,\n    unknown\n  > {\n    yield read;\n    yield read.set;\n  };\n\n  return read as State<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,SAAgB,MAAS,cAA2B;CAElD,MAAM,WAAW,oBAAoB;CACrC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,gIAED;CAGH,MAAM,QAAQ,eAAe,UAAU,QAAQ;CAC/C,MAAM,cAAc,SAAS;CAI7B,IAAI,YAAY,QAAQ;EACtB,MAAM,WAAW,YAAY;EAK7B,IAAI,SAAS,WAAW,UACtB,MAAM,IAAI,MACR,sDAAsD,MAAM,2FAE7D;EAEH,OAAO;;CAIT,MAAM,OAAO,gBAAgB,cAAc,SAAS;CAGpD,YAAY,SAAS;CAErB,OAAO;;;;;;AAOT,SAAS,gBACP,cACA,UACU;CACV,IAAI,QAAQ;CAGZ,MAAM,0BAAU,IAAI,KAAgC;CAGpD,SAAS,OAAU;EACjB,KAAmB,eAAe;EAClC,mBAAmB,KAAiB;EAEpC,OAAO;;CAIT,KAAmB,WAAW;CAK9B,KAAoD,SAAS;CAG7D,KAAK,OAAO,sBAAkD;EAI5D,IADoB,oBAChB,KAAgB,MAClB,MAAM,IAAI,MACR,wNAGD;EAIH,IAAI;EACJ,IAAI,OAAO,sBAAsB,YAM/B,WAAW,kBAAQ,MAAM;OAEzB,WAAW;EAIb,IAAI,OAAO,GAAG,OAAO,SAAS,EAAE;EAIhC,IAAI,oBAAoB,EAAE;GAGxB,QAAQ;GACR;;EAIF,QAAQ;EAER,oCAAoC,KAAiB;EACrD,6BAA6B,KAAiB;EAO9C,AAAK,sBAAsB,KAAiB;;CAK9C,KAIE,OAAO,YAAY,aAInB;EACA,MAAM;EACN,MAAM,KAAK;;CAGb,OAAO"}
+{"version":3,"file":"state.js","names":[],"sources":["../../src/runtime/state.ts"],"sourcesContent":["/**\n * State primitive for Askr components\n * Optimized for minimal overhead and fast updates\n *\n * INVARIANTS ENFORCED:\n * - state() only callable during component render (currentInstance exists)\n * - state() called at top-level only (indices must be monotonically increasing)\n * - state values persist across re-renders (stored in stateValues array)\n * - state.set() cannot be called during render (causes infinite loops)\n * - state.set() always enqueues through scheduler (never direct mutation)\n * - state.set() callback (notifyUpdate) always available\n */\n\nimport {\n  claimHookIndex,\n  getCurrentInstance,\n  type ComponentInstance,\n} from './component';\nimport { isBulkCommitActive } from './fastlane';\nimport {\n  recordReadableRead,\n  type ReadableSource,\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n} from './readable';\n\n/**\n * State value holder - callable to read, has set method to update\n * @example\n * const count = state(0);\n * count();           // read: 0\n * count.set(1);      // write: triggers re-render\n */\nexport interface State<T> extends ReadableSource<T> {\n  (): T;\n  set(value: T): void;\n  set(updater: (prev: T) => T): void;\n  [Symbol.iterator](): IterableIterator<StateTuple<T>[number]>; // Allows destructuring: const [get, set] = state(0)\n}\n\n/**\n * Public setter type for state cells.\n */\nexport type StateSetter<T> = State<T>['set'];\n\n/**\n * Tuple-first state handle returned by `state()`.\n */\nexport type StateTuple<T> = [get: State<T>, set: StateSetter<T>] & State<T>;\n\n/**\n * Creates a local state value for a component\n * Optimized for:\n * - O(1) read performance\n * - Minimal allocation per state\n * - Fast scheduler integration\n *\n * IMPORTANT: state() must be called during component render execution.\n * It captures the current component instance from context.\n * Calling outside a component function will throw an error.\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render\n * export function Counter() {\n *   const [count, setCount] = state(0);\n *   return { type: 'button', children: [count()] };\n * }\n *\n * // ❌ Wrong: called outside component\n * const count = state(0);\n * export function BadComponent() {\n *   return { type: 'div' };\n * }\n * ```\n */\nexport function state<T>(initialValue: T): StateTuple<T> {\n  // INVARIANT: state() must be called during component render\n  const instance = getCurrentInstance();\n  if (!instance) {\n    throw new Error(\n      'state() can only be called during component render execution. ' +\n        'Move state() calls to the top level of your component function.'\n    );\n  }\n\n  const index = claimHookIndex(instance, 'state');\n  const stateValues = instance.stateValues;\n\n  // INVARIANT: Reuse existing state if it exists (fast path on re-renders)\n  // This ensures state identity and persistence and enforces ownership stability\n  if (stateValues[index]) {\n    const existing = stateValues[index] as State<T> & {\n      _owner?: ComponentInstance;\n    };\n    // Ownership must be stable: the state cell belongs to the instance that\n    // created it and must never change. This checks for accidental reuse.\n    if (existing._owner !== instance) {\n      throw new Error(\n        `State ownership violation: state() called at index ${index} is owned by a different component instance. ` +\n          `State ownership is positional and immutable.`\n      );\n    }\n    return existing as StateTuple<T>;\n  }\n\n  // Create new state (slow path, only on first render) — delegated to helper\n  const cell = createStateCell(initialValue, instance);\n\n  // INVARIANT: Store state in instance for persistence across renders\n  stateValues[index] = cell;\n\n  return cell as StateTuple<T>;\n}\n\n/**\n * Internal helper: create the backing state cell (value + readers + set semantics)\n * This extraction makes it easier to later split hook wiring from storage.\n */\nfunction createStateCell<T>(\n  initialValue: T,\n  instance: ComponentInstance\n): State<T> {\n  let value = initialValue;\n\n  // Per-state reader map: component -> last-committed render token\n  const readers = new Map<ComponentInstance, number>();\n\n  // Use a function as the state object (callable directly)\n  function read(): T {\n    (read as State<T>)._hasBeenRead = true;\n    recordReadableRead(read as State<T>);\n\n    return value;\n  }\n\n  // Attach the readers map to the callable so other runtime parts can access it\n  (read as State<T>)._readers = readers;\n\n  // Record explicit ownership of this state cell. Ownership is the component\n  // instance that created the state cell and must never change for the life\n  // of the cell. We expose this for runtime invariant checks/tests.\n  (read as State<T> & { _owner?: ComponentInstance })._owner = instance;\n\n  // Attach set method directly to function\n  read.set = (newValueOrUpdater: T | ((prev: T) => T)): void => {\n    // INVARIANT: State cannot be mutated during component render\n    // (when currentInstance is non-null). It must be scheduled for consistency.\n    const currentInst = getCurrentInstance();\n    if (currentInst !== null) {\n      throw new Error(\n        `[Askr] state.set() cannot be called during component render. ` +\n          `State mutations during render break the actor model and cause infinite loops. ` +\n          `Move state updates to event handlers or use conditional rendering instead.`\n      );\n    }\n\n    // Compute new value if an updater was provided\n    let newValue: T;\n    if (typeof newValueOrUpdater === 'function') {\n      // Note: function-valued state cannot be set directly via a function argument;\n      // such an argument is treated as a functional updater (this follows the common\n      // convention from other libraries). If you need to store a function as state,\n      // wrap it in an object.\n      const updater = newValueOrUpdater as (prev: T) => T;\n      newValue = updater(value);\n    } else {\n      newValue = newValueOrUpdater as T;\n    }\n\n    // Skip work if value didn't change\n    if (Object.is(value, newValue)) return;\n\n    // If a bulk commit is active, update backing value only and DO NOT notify or enqueue.\n    // Bulk commits must be side-effect silent with respect to runtime notifications.\n    if (isBulkCommitActive()) {\n      // In bulk commit mode we must be side-effect free: update backing\n      // value only and do not notify, enqueue, or log.\n      value = newValue;\n      return;\n    }\n\n    // INVARIANT: Update the value\n    value = newValue;\n\n    markReadableDerivedSubscribersDirty(read as State<T>);\n    markReactivePropsDirtySource(read as State<T>);\n\n    // notifyUpdate may be temporarily unavailable (e.g. during hydration).\n    // We intentionally avoid logging here to keep the state mutation path\n    // side-effect free. The scheduler will process updates when the system\n    // is stable.\n    // After value change, notify only components that *read* this state in their last committed render.\n    void notifyReadableReaders(read as State<T>);\n  };\n\n  // Allow destructuring assignment: const [get, set] = state(0);\n  // The state function is iterable and yields the getter then the setter\n  (\n    read as unknown as {\n      [Symbol.iterator]?: () => Iterator<State<T> | State<T>['set']>;\n    }\n  )[Symbol.iterator] = function* (): Generator<\n    State<T> | State<T>['set'],\n    void,\n    unknown\n  > {\n    yield read;\n    yield read.set;\n  };\n\n  return read as State<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,SAAgB,MAAS,cAAgC;CAEvD,MAAM,WAAW,oBAAoB;CACrC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,gIAED;CAGH,MAAM,QAAQ,eAAe,UAAU,QAAQ;CAC/C,MAAM,cAAc,SAAS;CAI7B,IAAI,YAAY,QAAQ;EACtB,MAAM,WAAW,YAAY;EAK7B,IAAI,SAAS,WAAW,UACtB,MAAM,IAAI,MACR,sDAAsD,MAAM,2FAE7D;EAEH,OAAO;;CAIT,MAAM,OAAO,gBAAgB,cAAc,SAAS;CAGpD,YAAY,SAAS;CAErB,OAAO;;;;;;AAOT,SAAS,gBACP,cACA,UACU;CACV,IAAI,QAAQ;CAGZ,MAAM,0BAAU,IAAI,KAAgC;CAGpD,SAAS,OAAU;EACjB,KAAmB,eAAe;EAClC,mBAAmB,KAAiB;EAEpC,OAAO;;CAIT,KAAmB,WAAW;CAK9B,KAAoD,SAAS;CAG7D,KAAK,OAAO,sBAAkD;EAI5D,IADoB,oBAChB,KAAgB,MAClB,MAAM,IAAI,MACR,wNAGD;EAIH,IAAI;EACJ,IAAI,OAAO,sBAAsB,YAM/B,WAAW,kBAAQ,MAAM;OAEzB,WAAW;EAIb,IAAI,OAAO,GAAG,OAAO,SAAS,EAAE;EAIhC,IAAI,oBAAoB,EAAE;GAGxB,QAAQ;GACR;;EAIF,QAAQ;EAER,oCAAoC,KAAiB;EACrD,6BAA6B,KAAiB;EAO9C,AAAK,sBAAsB,KAAiB;;CAK9C,KAIE,OAAO,YAAY,aAInB;EACA,MAAM;EACN,MAAM,KAAK;;CAGb,OAAO"}

package/dist/ssg/index.d.ts

@@ -1,8 +1,3 @@
 import { DiscoveredResources, RouteConfig, RouteRenderReason, RouteRenderResult, RouteRenderStatus, SSGGenerateOptions, SSGMetadata, SSGMode, SSGOptions, SSGResult } from "./types.js";
 import { createStaticGen } from "./create-static-gen.js";
-import { batchRenderRoutes } from "./batch-render.js";
-import { getOutputFilePath } from "./route-utils.js";
-import { writeStaticFiles } from "./write-static-files.js";
-import { generateSSGResult, resultToMetadata, writeMetadata } from "./generate-metadata.js";
-import { resolveSsgData, validateRoutes } from "./resolve-ssg-data.js";
-export { type DiscoveredResources, type RouteConfig, type RouteRenderReason, type RouteRenderResult, type RouteRenderStatus, type SSGGenerateOptions, type SSGMetadata, type SSGMode, type SSGOptions, type SSGResult, batchRenderRoutes, createStaticGen, generateSSGResult, getOutputFilePath, resolveSsgData, resultToMetadata, validateRoutes, writeMetadata, writeStaticFiles };
+export { type DiscoveredResources, type RouteConfig, type RouteRenderReason, type RouteRenderResult, type RouteRenderStatus, type SSGGenerateOptions, type SSGMetadata, type SSGMode, type SSGOptions, type SSGResult, createStaticGen };

package/dist/ssg/index.js

@@ -1,7 +1,2 @@
-import { resolveSsgData, validateRoutes } from "./resolve-ssg-data.js";
-import { getOutputFilePath } from "./route-utils.js";
-import { batchRenderRoutes } from "./batch-render.js";
-import { writeStaticFiles } from "./write-static-files.js";
-import { generateSSGResult, resultToMetadata, writeMetadata } from "./generate-metadata.js";
 import { createStaticGen } from "./create-static-gen.js";
-export { batchRenderRoutes, createStaticGen, generateSSGResult, getOutputFilePath, resolveSsgData, resultToMetadata, validateRoutes, writeMetadata, writeStaticFiles };
+export { createStaticGen };

package/dist/ssr/context.d.ts

@@ -1,6 +1,7 @@
 import { Route, RouteAuthOptions } from "../common/router.js";
-import { SSRData } from "../common/ssr.js";
 import { SSRDataMissingError } from "../common/ssr-errors.js";
+import { SSRData } from "../common/ssr.js";
+
 //#region src/ssr/context.d.ts
 interface RenderContext {
   url: string;

package/dist/ssr/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/ssr/context.ts"],"mappings":";;;;UAgBiB,aAAA;EACf,GAAA;EACA,IAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;EACT,UAAA,GAAa,GAAA;EAEb,UAAA;EACA,UAAA,EAAY,MAAA;AAAA;AAAA,KAIF,UAAA,GAAa,aAAA;AAAA,iBA0BT,mBAAA,CACd,IAAA,WACA,IAAA;EACE,GAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;AAAA,IAEV,aAAA;;;;;iBAqBa,iBAAA,GAAA,CAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;AAzDvE;;;;AAAA,iBA2EgB,gBAAA,CAAA,GAAoB,aAAA;AAAA,cAQvB,aAAA,SAAa,gBAAA;AAAA,cACb,cAAA,SAAc,iBAAA;AAAA,cACd,oBAAA,SAAoB,gBAAA;AAAA,iBAEjB,iBAAA,GAAA,CAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;;;;;iBASvD,mBAAA,CAAA"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/ssr/context.ts"],"mappings":";;;;;UAgBiB,aAAA;EACf,GAAA;EACA,IAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;EACT,UAAA,GAAa,GAAA;EAEb,UAAA;EACA,UAAA,EAAY,MAAA;AAAA;AAAA,KAIF,UAAA,GAAa,aAAA;AAAA,iBAoDT,mBAAA,CACd,IAAA,WACA,IAAA;EACE,GAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;AAAA,IAEV,aAAA;;;;;iBAqBa,iBAAA,GAAA,CAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;AAnFvE;;;;AAAA,iBAsGgB,gBAAA,CAAA,GAAoB,aAAA;AAAA,cASvB,aAAA,SAAa,gBAAA;AAAA,cACb,cAAA,SAAc,iBAAA;AAAA,cACd,oBAAA,SAAoB,gBAAA;AAAA,iBAEjB,iBAAA,GAAA,CAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;;;;;iBASvD,mBAAA,CAAA"}

package/dist/ssr/context.js

@@ -1,4 +1,3 @@
-import { __require } from "../_virtual/_rolldown/runtime.js";
 import { SSRDataMissingError } from "../common/ssr-errors.js";
 import "./errors.js";
 import { clearEscapeCache } from "./escape.js";
@@ -6,16 +5,32 @@ import { clearEscapeCache } from "./escape.js";
 /**
 * SSR Context Management
 *
-* Provides concurrency-safe context for server-side rendering.
-* In Node.js, uses AsyncLocalStorage for isolation between concurrent requests.
-* Falls back to stack-based approach in non-Node environments.
+* Provides render-context storage for server-side rendering.
+* Node SSR lazily installs AsyncLocalStorage on first use; browser builds use
+* the fallback stack.
 */
-let asyncLocalStorage = null;
-try {
-	const asyncHooks = __require("async_hooks");
-	if (asyncHooks?.AsyncLocalStorage) asyncLocalStorage = new asyncHooks.AsyncLocalStorage();
-} catch {}
+let renderContextAccessor = null;
+let renderContextAccessorInitialized = false;
 let fallbackStack = null;
+function ensureRenderContextAccessor() {
+	if (renderContextAccessorInitialized) return;
+	renderContextAccessorInitialized = true;
+	if (typeof process === "undefined" || !process.versions?.node) return;
+	try {
+		const asyncHooks = new Function("return require(" + JSON.stringify("async_hooks") + ");")();
+		if (asyncHooks.AsyncLocalStorage) {
+			const asyncLocalStorage = new asyncHooks.AsyncLocalStorage();
+			renderContextAccessor = {
+				getStore() {
+					return asyncLocalStorage.getStore();
+				},
+				run(store, fn) {
+					return asyncLocalStorage.run(store, fn);
+				}
+			};
+		}
+	} catch {}
+}
 function createRenderContext(seed = 12345, opts = {}) {
 	clearEscapeCache();
 	return {
@@ -36,7 +51,8 @@ function createRenderContext(seed = 12345, opts = {}) {
 * Concurrency-safe in Node.js via AsyncLocalStorage.
 */
 function withRenderContext(ctx, fn) {
-	if (asyncLocalStorage) return asyncLocalStorage.run(ctx, fn);
+	ensureRenderContextAccessor();
+	if (renderContextAccessor) return renderContextAccessor.run(ctx, fn);
 	const prev = fallbackStack;
 	fallbackStack = ctx;
 	try {
@@ -50,7 +66,8 @@ function withRenderContext(ctx, fn) {
 * Returns null if not inside a render.
 */
 function getRenderContext() {
-	if (asyncLocalStorage) return asyncLocalStorage.getStore() ?? null;
+	ensureRenderContextAccessor();
+	if (renderContextAccessor) return renderContextAccessor.getStore() ?? null;
 	return fallbackStack;
 }
 /**