@askrjs/askr 0.0.47 → 0.0.49

package/dist/runtime/readable.js

@@ -1,5 +1,6 @@
-import { globalScheduler } from "./scheduler.js";
-import { getCurrentInstance } from "./component.js";
+import { enqueueRuntimeTask, markRuntimeReactivePropsDirtySource } from "./access.js";
+import { getCurrentInstance } from "./component-scope.js";
+import "./component.js";
 //#region src/runtime/readable.ts
 function markReadableUsage(source) {
 	if (source && typeof source === "function" && ("_hasBeenRead" in source || "_readers" in source)) {
@@ -16,10 +17,10 @@ function scheduleReadableInstanceUpdate(instance) {
 	instance.hasPendingUpdate = true;
 	const task = instance._pendingFlushTask;
 	if (task) {
-		globalScheduler.enqueue(task);
+		enqueueRuntimeTask(task);
 		return;
 	}
-	globalScheduler.enqueue(() => {
+	enqueueRuntimeTask(() => {
 		instance.hasPendingUpdate = false;
 		instance.notifyUpdate?.();
 	});
@@ -135,7 +136,7 @@ function markReadableDerivedSubscribersDirty(source) {
 }
 function markReactivePropsDirtySource(source) {
 	try {
-		globalThis.__ASKR_RENDERER?.markReactivePropsDirtySource?.(source);
+		markRuntimeReactivePropsDirtySource(source);
 	} catch {}
 }
 function notifyReadableReaders(source, skipInstance) {

package/dist/runtime/readable.js.map

@@ -1 +1 @@
-{"version":3,"file":"readable.js","names":[],"sources":["../../src/runtime/readable.ts"],"sourcesContent":["import { globalScheduler } from './scheduler';\nimport { getCurrentInstance, type ComponentInstance } from './component';\n\nexport interface DerivedSubscriber {\n  _markDirty(): void;\n  _pendingDependencySources?: Set<ReadableSource<unknown>>;\n}\n\nexport interface ReadableSource<T = unknown> {\n  (): T;\n  _hasBeenRead?: boolean;\n  _hasEverBeenRead?: boolean;\n  _readers?: Map<ComponentInstance, number>;\n  _derivedSubscribers?: Set<DerivedSubscriber>;\n  _version?: number;\n}\n\nexport function markReadableUsage(source: unknown): void {\n  if (\n    source &&\n    typeof source === 'function' &&\n    ('_hasBeenRead' in source || '_readers' in source)\n  ) {\n    const readable = source as ReadableSource<unknown>;\n    readable._hasBeenRead = true;\n    readable._hasEverBeenRead = true;\n  }\n}\n\ntype RendererBridge = {\n  markReactivePropsDirtySource?: (source: ReadableSource<unknown>) => void;\n};\n\nlet currentDerivedSubscriber: DerivedSubscriber | null = null;\nlet suppressComponentReadTrackingDepth = 0;\nlet currentFineGrainedReadSources: Set<ReadableSource<unknown>> | null = null;\n\nfunction scheduleReadableInstanceUpdate(instance: ComponentInstance): void {\n  if (instance.hasPendingUpdate) {\n    return;\n  }\n\n  instance.hasPendingUpdate = true;\n  const task = instance._pendingFlushTask;\n  if (task) {\n    globalScheduler.enqueue(task);\n    return;\n  }\n\n  globalScheduler.enqueue(() => {\n    instance.hasPendingUpdate = false;\n    instance.notifyUpdate?.();\n  });\n}\n\nexport function recordReadableRead(source: ReadableSource<unknown>): void {\n  source._hasEverBeenRead = true;\n\n  if (currentFineGrainedReadSources) {\n    currentFineGrainedReadSources.add(source);\n    return;\n  }\n\n  if (currentDerivedSubscriber) {\n    if (!currentDerivedSubscriber._pendingDependencySources) {\n      currentDerivedSubscriber._pendingDependencySources = new Set();\n    }\n    currentDerivedSubscriber._pendingDependencySources.add(source);\n  }\n\n  if (suppressComponentReadTrackingDepth > 0) {\n    return;\n  }\n\n  const inst = getCurrentInstance();\n  if (!inst || inst._currentRenderToken === undefined) {\n    return;\n  }\n\n  if (!inst._pendingReadSources) {\n    inst._pendingReadSources = new Set();\n  }\n  inst._pendingReadSources.add(source);\n\n  const sourceVersion = source._version ?? 0;\n  let pendingVersions = inst._pendingReadSourceVersions;\n  if (!pendingVersions) {\n    pendingVersions = new Map();\n    inst._pendingReadSourceVersions = pendingVersions;\n  }\n  pendingVersions.set(source, sourceVersion);\n}\n\nexport function withFineGrainedReadTracking<T>(\n  pendingSources: Set<ReadableSource<unknown>>,\n  fn: () => T\n): T {\n  const previousPendingSources = currentFineGrainedReadSources;\n  currentFineGrainedReadSources = pendingSources;\n\n  try {\n    return fn();\n  } finally {\n    currentFineGrainedReadSources = previousPendingSources;\n  }\n}\n\nexport function finalizeReadableSubscriptions(\n  instance: ComponentInstance\n): void {\n  const newSet = instance._pendingReadSources;\n  const token = instance._currentRenderToken;\n  const pendingVersions = instance._pendingReadSourceVersions;\n\n  finalizeReadableSubscriptionsFromSnapshot(\n    instance,\n    token,\n    newSet,\n    pendingVersions\n  );\n  instance._pendingReadSources = undefined;\n  instance._currentRenderToken = undefined;\n  instance._pendingReadSourceVersions = undefined;\n}\n\nexport function finalizeReadableSubscriptionsFromSnapshot(\n  instance: ComponentInstance,\n  token: number | undefined,\n  newSet: Set<ReadableSource<unknown>> | undefined,\n  pendingReadSourceVersions:\n    | Map<ReadableSource<unknown>, number>\n    | undefined = instance._pendingReadSourceVersions\n): void {\n  if (token === undefined) {\n    return;\n  }\n\n  const oldSet = instance._lastReadSources;\n  const pendingVersions = pendingReadSourceVersions;\n  let needsFollowUpUpdate = false;\n\n  if (oldSet) {\n    for (const source of oldSet) {\n      if (!newSet?.has(source)) {\n        source._readers?.delete(instance);\n      }\n    }\n  }\n\n  instance.lastRenderToken = token;\n\n  if (newSet) {\n    for (const source of newSet) {\n      // Replay only for sources already owned by this instance, or for its\n      // first committed read set. Newly entered branches in mounted components\n      // keep their existing scheduler-visible intermediate states.\n      if (pendingVersions && (!oldSet || oldSet.has(source))) {\n        const sourceVersion = source._version ?? 0;\n        const readVersion = pendingVersions.get(source);\n        if (readVersion !== undefined && sourceVersion !== readVersion) {\n          needsFollowUpUpdate = true;\n        }\n      }\n\n      let readers = source._readers;\n      if (!readers) {\n        readers = new Map();\n        source._readers = readers;\n      }\n      readers.set(instance, instance.lastRenderToken ?? 0);\n    }\n  }\n\n  instance._lastReadSources = newSet ?? new Set();\n\n  if (needsFollowUpUpdate) {\n    scheduleReadableInstanceUpdate(instance);\n  }\n}\n\nexport function cleanupReadableSubscriptions(\n  instance: ComponentInstance\n): void {\n  const sources = instance._lastReadSources;\n  if (!sources || sources.size === 0) {\n    instance._pendingReadSources = undefined;\n    instance._pendingReadSourceVersions = undefined;\n    return;\n  }\n\n  for (const source of sources) {\n    source._readers?.delete(instance);\n  }\n  instance._lastReadSources = new Set();\n  instance._pendingReadSources = undefined;\n  instance._pendingReadSourceVersions = undefined;\n}\n\nexport function withDerivedReadTracking<T>(\n  subscriber: DerivedSubscriber,\n  fn: () => T\n): T {\n  const prevDerivedSubscriber = currentDerivedSubscriber;\n  currentDerivedSubscriber = subscriber;\n  suppressComponentReadTrackingDepth += 1;\n\n  try {\n    return fn();\n  } finally {\n    suppressComponentReadTrackingDepth -= 1;\n    currentDerivedSubscriber = prevDerivedSubscriber;\n  }\n}\n\nexport function syncDerivedDependencySubscriptions(\n  subscriber: DerivedSubscriber,\n  prevSources: Set<ReadableSource<unknown>>,\n  nextSources: Set<ReadableSource<unknown>>\n): void {\n  for (const source of prevSources) {\n    if (!nextSources.has(source)) {\n      source._derivedSubscribers?.delete(subscriber);\n    }\n  }\n\n  for (const source of nextSources) {\n    let subscribers = source._derivedSubscribers;\n    if (!subscribers) {\n      subscribers = new Set();\n      source._derivedSubscribers = subscribers;\n    }\n    subscribers.add(subscriber);\n  }\n}\n\nexport function clearDerivedDependencySubscriptions(\n  subscriber: DerivedSubscriber,\n  sources: Set<ReadableSource<unknown>>\n): void {\n  for (const source of sources) {\n    source._derivedSubscribers?.delete(subscriber);\n  }\n  sources.clear();\n}\n\nexport function markReadableDerivedSubscribersDirty(\n  source: ReadableSource<unknown>\n): void {\n  const subscribers = source._derivedSubscribers;\n  if (!subscribers || subscribers.size === 0) {\n    return;\n  }\n\n  for (const subscriber of subscribers) {\n    subscriber._markDirty();\n  }\n}\n\nexport function markReactivePropsDirtySource(\n  source: ReadableSource<unknown>\n): void {\n  try {\n    (\n      globalThis as {\n        __ASKR_RENDERER?: RendererBridge;\n      }\n    ).__ASKR_RENDERER?.markReactivePropsDirtySource?.(source);\n  } catch {\n    // Keep readable notifications side-effect safe.\n  }\n}\n\nexport function notifyReadableReaders(\n  source: ReadableSource<unknown>,\n  skipInstance?: ComponentInstance | null\n): boolean {\n  source._version = (source._version ?? 0) + 1;\n  const readers = source._readers;\n  let didScheduleUpdate = false;\n\n  if (!readers || readers.size === 0) {\n    return false;\n  }\n\n  for (const [instance, token] of readers) {\n    if (skipInstance && instance === skipInstance) {\n      continue;\n    }\n    if (instance.lastRenderToken !== token) {\n      continue;\n    }\n    if (instance.hasPendingUpdate) {\n      continue;\n    }\n\n    scheduleReadableInstanceUpdate(instance);\n    didScheduleUpdate = true;\n  }\n\n  return didScheduleUpdate;\n}\n"],"mappings":";;;AAiBA,SAAgB,kBAAkB,QAAuB;CACvD,IACE,UACA,OAAO,WAAW,eACjB,kBAAkB,UAAU,cAAc,SAC3C;EACA,MAAM,WAAW;EACjB,SAAS,eAAe;EACxB,SAAS,mBAAmB;CAC9B;AACF;AAMA,IAAI,2BAAqD;AACzD,IAAI,qCAAqC;AACzC,IAAI,gCAAqE;AAEzE,SAAS,+BAA+B,UAAmC;CACzE,IAAI,SAAS,kBACX;CAGF,SAAS,mBAAmB;CAC5B,MAAM,OAAO,SAAS;CACtB,IAAI,MAAM;EACR,gBAAgB,QAAQ,IAAI;EAC5B;CACF;CAEA,gBAAgB,cAAc;EAC5B,SAAS,mBAAmB;EAC5B,SAAS,eAAe;CAC1B,CAAC;AACH;AAEA,SAAgB,mBAAmB,QAAuC;CACxE,OAAO,mBAAmB;CAE1B,IAAI,+BAA+B;EACjC,8BAA8B,IAAI,MAAM;EACxC;CACF;CAEA,IAAI,0BAA0B;EAC5B,IAAI,CAAC,yBAAyB,2BAC5B,yBAAyB,4CAA4B,IAAI,IAAI;EAE/D,yBAAyB,0BAA0B,IAAI,MAAM;CAC/D;CAEA,IAAI,qCAAqC,GACvC;CAGF,MAAM,OAAO,mBAAmB;CAChC,IAAI,CAAC,QAAQ,KAAK,wBAAwB,QACxC;CAGF,IAAI,CAAC,KAAK,qBACR,KAAK,sCAAsB,IAAI,IAAI;CAErC,KAAK,oBAAoB,IAAI,MAAM;CAEnC,MAAM,gBAAgB,OAAO,YAAY;CACzC,IAAI,kBAAkB,KAAK;CAC3B,IAAI,CAAC,iBAAiB;EACpB,kCAAkB,IAAI,IAAI;EAC1B,KAAK,6BAA6B;CACpC;CACA,gBAAgB,IAAI,QAAQ,aAAa;AAC3C;AAEA,SAAgB,4BACd,gBACA,IACG;CACH,MAAM,yBAAyB;CAC/B,gCAAgC;CAEhC,IAAI;EACF,OAAO,GAAG;CACZ,UAAU;EACR,gCAAgC;CAClC;AACF;AAEA,SAAgB,8BACd,UACM;CACN,MAAM,SAAS,SAAS;CACxB,MAAM,QAAQ,SAAS;CACvB,MAAM,kBAAkB,SAAS;CAEjC,0CACE,UACA,OACA,QACA,eACF;CACA,SAAS,sBAAsB;CAC/B,SAAS,sBAAsB;CAC/B,SAAS,6BAA6B;AACxC;AAEA,SAAgB,0CACd,UACA,OACA,QACA,4BAEgB,SAAS,4BACnB;CACN,IAAI,UAAU,QACZ;CAGF,MAAM,SAAS,SAAS;CACxB,MAAM,kBAAkB;CACxB,IAAI,sBAAsB;CAE1B,IAAI,QACF;OAAK,MAAM,UAAU,QACnB,IAAI,CAAC,QAAQ,IAAI,MAAM,GACrB,OAAO,UAAU,OAAO,QAAQ;CAEpC;CAGF,SAAS,kBAAkB;CAE3B,IAAI,QACF,KAAK,MAAM,UAAU,QAAQ;EAI3B,IAAI,oBAAoB,CAAC,UAAU,OAAO,IAAI,MAAM,IAAI;GACtD,MAAM,gBAAgB,OAAO,YAAY;GACzC,MAAM,cAAc,gBAAgB,IAAI,MAAM;GAC9C,IAAI,gBAAgB,UAAa,kBAAkB,aACjD,sBAAsB;EAE1B;EAEA,IAAI,UAAU,OAAO;EACrB,IAAI,CAAC,SAAS;GACZ,0BAAU,IAAI,IAAI;GAClB,OAAO,WAAW;EACpB;EACA,QAAQ,IAAI,UAAU,SAAS,mBAAmB,CAAC;CACrD;CAGF,SAAS,mBAAmB,0BAAU,IAAI,IAAI;CAE9C,IAAI,qBACF,+BAA+B,QAAQ;AAE3C;AAEA,SAAgB,6BACd,UACM;CACN,MAAM,UAAU,SAAS;CACzB,IAAI,CAAC,WAAW,QAAQ,SAAS,GAAG;EAClC,SAAS,sBAAsB;EAC/B,SAAS,6BAA6B;EACtC;CACF;CAEA,KAAK,MAAM,UAAU,SACnB,OAAO,UAAU,OAAO,QAAQ;CAElC,SAAS,mCAAmB,IAAI,IAAI;CACpC,SAAS,sBAAsB;CAC/B,SAAS,6BAA6B;AACxC;AAEA,SAAgB,wBACd,YACA,IACG;CACH,MAAM,wBAAwB;CAC9B,2BAA2B;CAC3B,sCAAsC;CAEtC,IAAI;EACF,OAAO,GAAG;CACZ,UAAU;EACR,sCAAsC;EACtC,2BAA2B;CAC7B;AACF;AAEA,SAAgB,mCACd,YACA,aACA,aACM;CACN,KAAK,MAAM,UAAU,aACnB,IAAI,CAAC,YAAY,IAAI,MAAM,GACzB,OAAO,qBAAqB,OAAO,UAAU;CAIjD,KAAK,MAAM,UAAU,aAAa;EAChC,IAAI,cAAc,OAAO;EACzB,IAAI,CAAC,aAAa;GAChB,8BAAc,IAAI,IAAI;GACtB,OAAO,sBAAsB;EAC/B;EACA,YAAY,IAAI,UAAU;CAC5B;AACF;AAEA,SAAgB,oCACd,YACA,SACM;CACN,KAAK,MAAM,UAAU,SACnB,OAAO,qBAAqB,OAAO,UAAU;CAE/C,QAAQ,MAAM;AAChB;AAEA,SAAgB,oCACd,QACM;CACN,MAAM,cAAc,OAAO;CAC3B,IAAI,CAAC,eAAe,YAAY,SAAS,GACvC;CAGF,KAAK,MAAM,cAAc,aACvB,WAAW,WAAW;AAE1B;AAEA,SAAgB,6BACd,QACM;CACN,IAAI;EACF,WAIE,iBAAiB,+BAA+B,MAAM;CAC1D,QAAQ,CAER;AACF;AAEA,SAAgB,sBACd,QACA,cACS;CACT,OAAO,YAAY,OAAO,YAAY,KAAK;CAC3C,MAAM,UAAU,OAAO;CACvB,IAAI,oBAAoB;CAExB,IAAI,CAAC,WAAW,QAAQ,SAAS,GAC/B,OAAO;CAGT,KAAK,MAAM,CAAC,UAAU,UAAU,SAAS;EACvC,IAAI,gBAAgB,aAAa,cAC/B;EAEF,IAAI,SAAS,oBAAoB,OAC/B;EAEF,IAAI,SAAS,kBACX;EAGF,+BAA+B,QAAQ;EACvC,oBAAoB;CACtB;CAEA,OAAO;AACT"}
+{"version":3,"file":"readable.js","names":[],"sources":["../../src/runtime/readable.ts"],"sourcesContent":["import {\n  enqueueRuntimeTask,\n  markRuntimeReactivePropsDirtySource,\n} from './access';\nimport { getCurrentInstance, type ComponentInstance } from './component';\n\nexport interface DerivedSubscriber {\n  _markDirty(): void;\n  _pendingDependencySources?: Set<ReadableSource<unknown>>;\n}\n\nexport interface ReadableSource<T = unknown> {\n  (): T;\n  _hasBeenRead?: boolean;\n  _hasEverBeenRead?: boolean;\n  _readers?: Map<ComponentInstance, number>;\n  _derivedSubscribers?: Set<DerivedSubscriber>;\n  _version?: number;\n}\n\nexport function markReadableUsage(source: unknown): void {\n  if (\n    source &&\n    typeof source === 'function' &&\n    ('_hasBeenRead' in source || '_readers' in source)\n  ) {\n    const readable = source as ReadableSource<unknown>;\n    readable._hasBeenRead = true;\n    readable._hasEverBeenRead = true;\n  }\n}\n\nlet currentDerivedSubscriber: DerivedSubscriber | null = null;\nlet suppressComponentReadTrackingDepth = 0;\nlet currentFineGrainedReadSources: Set<ReadableSource<unknown>> | null = null;\n\nfunction scheduleReadableInstanceUpdate(instance: ComponentInstance): void {\n  if (instance.hasPendingUpdate) {\n    return;\n  }\n\n  instance.hasPendingUpdate = true;\n  const task = instance._pendingFlushTask;\n  if (task) {\n    enqueueRuntimeTask(task);\n    return;\n  }\n\n  enqueueRuntimeTask(() => {\n    instance.hasPendingUpdate = false;\n    instance.notifyUpdate?.();\n  });\n}\n\nexport function recordReadableRead(source: ReadableSource<unknown>): void {\n  source._hasEverBeenRead = true;\n\n  if (currentFineGrainedReadSources) {\n    currentFineGrainedReadSources.add(source);\n    return;\n  }\n\n  if (currentDerivedSubscriber) {\n    if (!currentDerivedSubscriber._pendingDependencySources) {\n      currentDerivedSubscriber._pendingDependencySources = new Set();\n    }\n    currentDerivedSubscriber._pendingDependencySources.add(source);\n  }\n\n  if (suppressComponentReadTrackingDepth > 0) {\n    return;\n  }\n\n  const inst = getCurrentInstance();\n  if (!inst || inst._currentRenderToken === undefined) {\n    return;\n  }\n\n  if (!inst._pendingReadSources) {\n    inst._pendingReadSources = new Set();\n  }\n  inst._pendingReadSources.add(source);\n\n  const sourceVersion = source._version ?? 0;\n  let pendingVersions = inst._pendingReadSourceVersions;\n  if (!pendingVersions) {\n    pendingVersions = new Map();\n    inst._pendingReadSourceVersions = pendingVersions;\n  }\n  pendingVersions.set(source, sourceVersion);\n}\n\nexport function withFineGrainedReadTracking<T>(\n  pendingSources: Set<ReadableSource<unknown>>,\n  fn: () => T\n): T {\n  const previousPendingSources = currentFineGrainedReadSources;\n  currentFineGrainedReadSources = pendingSources;\n\n  try {\n    return fn();\n  } finally {\n    currentFineGrainedReadSources = previousPendingSources;\n  }\n}\n\nexport function finalizeReadableSubscriptions(\n  instance: ComponentInstance\n): void {\n  const newSet = instance._pendingReadSources;\n  const token = instance._currentRenderToken;\n  const pendingVersions = instance._pendingReadSourceVersions;\n\n  finalizeReadableSubscriptionsFromSnapshot(\n    instance,\n    token,\n    newSet,\n    pendingVersions\n  );\n  instance._pendingReadSources = undefined;\n  instance._currentRenderToken = undefined;\n  instance._pendingReadSourceVersions = undefined;\n}\n\nexport function finalizeReadableSubscriptionsFromSnapshot(\n  instance: ComponentInstance,\n  token: number | undefined,\n  newSet: Set<ReadableSource<unknown>> | undefined,\n  pendingReadSourceVersions:\n    | Map<ReadableSource<unknown>, number>\n    | undefined = instance._pendingReadSourceVersions\n): void {\n  if (token === undefined) {\n    return;\n  }\n\n  const oldSet = instance._lastReadSources;\n  const pendingVersions = pendingReadSourceVersions;\n  let needsFollowUpUpdate = false;\n\n  if (oldSet) {\n    for (const source of oldSet) {\n      if (!newSet?.has(source)) {\n        source._readers?.delete(instance);\n      }\n    }\n  }\n\n  instance.lastRenderToken = token;\n\n  if (newSet) {\n    for (const source of newSet) {\n      // Replay only for sources already owned by this instance, or for its\n      // first committed read set. Newly entered branches in mounted components\n      // keep their existing scheduler-visible intermediate states.\n      if (pendingVersions && (!oldSet || oldSet.has(source))) {\n        const sourceVersion = source._version ?? 0;\n        const readVersion = pendingVersions.get(source);\n        if (readVersion !== undefined && sourceVersion !== readVersion) {\n          needsFollowUpUpdate = true;\n        }\n      }\n\n      let readers = source._readers;\n      if (!readers) {\n        readers = new Map();\n        source._readers = readers;\n      }\n      readers.set(instance, instance.lastRenderToken ?? 0);\n    }\n  }\n\n  instance._lastReadSources = newSet ?? new Set();\n\n  if (needsFollowUpUpdate) {\n    scheduleReadableInstanceUpdate(instance);\n  }\n}\n\nexport function cleanupReadableSubscriptions(\n  instance: ComponentInstance\n): void {\n  const sources = instance._lastReadSources;\n  if (!sources || sources.size === 0) {\n    instance._pendingReadSources = undefined;\n    instance._pendingReadSourceVersions = undefined;\n    return;\n  }\n\n  for (const source of sources) {\n    source._readers?.delete(instance);\n  }\n  instance._lastReadSources = new Set();\n  instance._pendingReadSources = undefined;\n  instance._pendingReadSourceVersions = undefined;\n}\n\nexport function withDerivedReadTracking<T>(\n  subscriber: DerivedSubscriber,\n  fn: () => T\n): T {\n  const prevDerivedSubscriber = currentDerivedSubscriber;\n  currentDerivedSubscriber = subscriber;\n  suppressComponentReadTrackingDepth += 1;\n\n  try {\n    return fn();\n  } finally {\n    suppressComponentReadTrackingDepth -= 1;\n    currentDerivedSubscriber = prevDerivedSubscriber;\n  }\n}\n\nexport function syncDerivedDependencySubscriptions(\n  subscriber: DerivedSubscriber,\n  prevSources: Set<ReadableSource<unknown>>,\n  nextSources: Set<ReadableSource<unknown>>\n): void {\n  for (const source of prevSources) {\n    if (!nextSources.has(source)) {\n      source._derivedSubscribers?.delete(subscriber);\n    }\n  }\n\n  for (const source of nextSources) {\n    let subscribers = source._derivedSubscribers;\n    if (!subscribers) {\n      subscribers = new Set();\n      source._derivedSubscribers = subscribers;\n    }\n    subscribers.add(subscriber);\n  }\n}\n\nexport function clearDerivedDependencySubscriptions(\n  subscriber: DerivedSubscriber,\n  sources: Set<ReadableSource<unknown>>\n): void {\n  for (const source of sources) {\n    source._derivedSubscribers?.delete(subscriber);\n  }\n  sources.clear();\n}\n\nexport function markReadableDerivedSubscribersDirty(\n  source: ReadableSource<unknown>\n): void {\n  const subscribers = source._derivedSubscribers;\n  if (!subscribers || subscribers.size === 0) {\n    return;\n  }\n\n  for (const subscriber of subscribers) {\n    subscriber._markDirty();\n  }\n}\n\nexport function markReactivePropsDirtySource(\n  source: ReadableSource<unknown>\n): void {\n  try {\n    markRuntimeReactivePropsDirtySource(source);\n  } catch {\n    // Keep readable notifications side-effect safe.\n  }\n}\n\nexport function notifyReadableReaders(\n  source: ReadableSource<unknown>,\n  skipInstance?: ComponentInstance | null\n): boolean {\n  source._version = (source._version ?? 0) + 1;\n  const readers = source._readers;\n  let didScheduleUpdate = false;\n\n  if (!readers || readers.size === 0) {\n    return false;\n  }\n\n  for (const [instance, token] of readers) {\n    if (skipInstance && instance === skipInstance) {\n      continue;\n    }\n    if (instance.lastRenderToken !== token) {\n      continue;\n    }\n    if (instance.hasPendingUpdate) {\n      continue;\n    }\n\n    scheduleReadableInstanceUpdate(instance);\n    didScheduleUpdate = true;\n  }\n\n  return didScheduleUpdate;\n}\n"],"mappings":"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"}

package/dist/runtime/resource-cell.js

@@ -2,7 +2,7 @@ import { logger } from "../dev/logger.js";
 import { withAsyncResourceContext } from "./context.js";
 import { isPromiseLike } from "../common/promise.js";
 import { brandSnapshotSource } from "./snapshot-source.js";
-import { getSSRBridge } from "./ssr-bridge.js";
+import { throwSSRDataMissing } from "../common/render-context.js";
 //#region src/runtime/resource-cell.ts
 /**
 * Pure, component-agnostic ResourceCell state machine.
@@ -70,7 +70,7 @@ var ResourceCell = class {
 			if (notify) this.notifySubscribers();
 			return;
 		}
-		if (ssr) getSSRBridge().throwSSRDataMissing();
+		if (ssr) throwSSRDataMissing();
 		Promise.resolve(result).then((val) => {
 			if (this.generation !== generation) return;
 			if (this.controller !== controller) return;

package/dist/runtime/resource-cell.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-cell.js","names":[],"sources":["../../src/runtime/resource-cell.ts"],"sourcesContent":["import { withAsyncResourceContext, type ContextFrame } from './context';\nimport { logger } from '../dev/logger';\nimport { getSSRBridge } from './ssr-bridge';\nimport {\n  brandSnapshotSource,\n  type SnapshotSourceBrand,\n} from './snapshot-source';\nimport { isPromiseLike } from '../common/promise';\n\n/**\n * Pure, component-agnostic ResourceCell state machine.\n * - Holds value/pending/error/generation/controller\n * - Exposes a stable `snapshot` object: { value, pending, error, refresh }\n * - Uses `withAsyncResourceContext` to bind the synchronous execution step\n *   to a captured frame. Continuations after await do not see the frame.\n */\nexport class ResourceCell<U> {\n  value: U | null = null;\n  pending = true;\n  error: Error | null = null;\n  generation = 0;\n  controller: AbortController | null = null;\n  deps: readonly unknown[] | null = null;\n  resourceFrame: ContextFrame | null = null;\n\n  // Optional debug label set by caller (component name) to improve logs\n  ownerName?: string;\n\n  private subscribers = new Set<() => void>();\n  private disposed = false;\n\n  readonly snapshot: {\n    value: U | null;\n    pending: boolean;\n    error: Error | null;\n    refresh: () => void;\n  } & SnapshotSourceBrand;\n\n  private fn: (opts: { signal: AbortSignal }) => PromiseLike<U> | U;\n\n  constructor(\n    fn: (opts: { signal: AbortSignal }) => PromiseLike<U> | U,\n    deps: readonly unknown[] | null,\n    resourceFrame: ContextFrame | null\n  ) {\n    this.fn = fn;\n    this.deps = deps ? deps.slice() : null;\n    this.resourceFrame = resourceFrame;\n    this.snapshot = brandSnapshotSource({\n      value: null,\n      pending: true,\n      error: null,\n      refresh: () => this.refresh(),\n    });\n  }\n\n  setLoader(fn: (opts: { signal: AbortSignal }) => PromiseLike<U> | U): void {\n    this.fn = fn;\n  }\n\n  subscribe(cb: () => void): () => void {\n    this.subscribers.add(cb);\n    return () => this.subscribers.delete(cb);\n  }\n\n  private notifySubscribers() {\n    this.snapshot.value = this.value;\n    this.snapshot.pending = this.pending;\n    this.snapshot.error = this.error;\n    for (const cb of this.subscribers) cb();\n  }\n\n  start(ssr = false, notify = true) {\n    if (this.disposed) {\n      return;\n    }\n\n    const generation = this.generation;\n\n    this.controller?.abort();\n    const controller = new AbortController();\n    this.controller = controller;\n    this.pending = true;\n    this.error = null;\n    if (notify) this.notifySubscribers();\n\n    let result: PromiseLike<U> | U;\n    try {\n      // Execute only the synchronous step inside the frozen resource frame.\n      result = withAsyncResourceContext(this.resourceFrame, () =>\n        this.fn({ signal: controller.signal })\n      );\n    } catch (err) {\n      this.pending = false;\n      this.error = err as Error;\n      if (notify) this.notifySubscribers();\n      return;\n    }\n\n    if (!isPromiseLike<U>(result)) {\n      this.value = result as U;\n      this.pending = false;\n      this.error = null;\n      if (notify) this.notifySubscribers();\n      return;\n    }\n\n    if (ssr) {\n      // During SSR async results are disallowed\n      getSSRBridge().throwSSRDataMissing();\n    }\n\n    Promise.resolve(result)\n      .then((val) => {\n        if (this.generation !== generation) return;\n        if (this.controller !== controller) return;\n        // A loader that does not reject on abort (e.g. a plain Promise) would\n        // otherwise commit its value after the fetch was cancelled by a deps\n        // change, refresh(), or unmount. Mirror the AbortError guard used in\n        // the rejection path so an aborted fetch's resolution stays inert.\n        if (controller.signal.aborted) return;\n        this.value = val;\n        this.pending = false;\n        this.error = null;\n        this.notifySubscribers();\n      })\n      .catch((err) => {\n        if (this.generation !== generation) return;\n        if (this.controller !== controller) return;\n\n        const isAbortError =\n          controller.signal.aborted ||\n          (err instanceof Error && err.name === 'AbortError') ||\n          (typeof DOMException !== 'undefined' &&\n            err instanceof DOMException &&\n            err.name === 'AbortError');\n\n        if (isAbortError) {\n          return;\n        }\n\n        this.pending = false;\n        this.error = err as Error;\n        try {\n          if (this.ownerName) {\n            logger.error(\n              `[Askr] Async resource error in ${this.ownerName}:`,\n              err\n            );\n          } else {\n            logger.error('[Askr] Async resource error:', err);\n          }\n        } catch {\n          /* ignore logging errors */\n        }\n        this.notifySubscribers();\n      });\n  }\n\n  refresh() {\n    if (this.disposed) {\n      return;\n    }\n\n    this.generation++;\n    this.controller?.abort();\n    this.start();\n  }\n\n  abort() {\n    this.controller?.abort();\n  }\n\n  dispose() {\n    if (this.disposed) {\n      return;\n    }\n\n    this.disposed = true;\n    this.controller?.abort();\n    this.subscribers.clear();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,eAAb,MAA6B;CAwB3B,YACE,IACA,MACA,eACA;eA3BgB;iBACR;eACY;oBACT;oBACwB;cACH;uBACG;qCAKf,IAAI,IAAgB;kBACvB;EAgBjB,KAAK,KAAK;EACV,KAAK,OAAO,OAAO,KAAK,MAAM,IAAI;EAClC,KAAK,gBAAgB;EACrB,KAAK,WAAW,oBAAoB;GAClC,OAAO;GACP,SAAS;GACT,OAAO;GACP,eAAe,KAAK,QAAQ;EAC9B,CAAC;CACH;CAEA,UAAU,IAAiE;EACzE,KAAK,KAAK;CACZ;CAEA,UAAU,IAA4B;EACpC,KAAK,YAAY,IAAI,EAAE;EACvB,aAAa,KAAK,YAAY,OAAO,EAAE;CACzC;CAEA,oBAA4B;EAC1B,KAAK,SAAS,QAAQ,KAAK;EAC3B,KAAK,SAAS,UAAU,KAAK;EAC7B,KAAK,SAAS,QAAQ,KAAK;EAC3B,KAAK,MAAM,MAAM,KAAK,aAAa,GAAG;CACxC;CAEA,MAAM,MAAM,OAAO,SAAS,MAAM;EAChC,IAAI,KAAK,UACP;EAGF,MAAM,aAAa,KAAK;EAExB,KAAK,YAAY,MAAM;EACvB,MAAM,aAAa,IAAI,gBAAgB;EACvC,KAAK,aAAa;EAClB,KAAK,UAAU;EACf,KAAK,QAAQ;EACb,IAAI,QAAQ,KAAK,kBAAkB;EAEnC,IAAI;EACJ,IAAI;GAEF,SAAS,yBAAyB,KAAK,qBACrC,KAAK,GAAG,EAAE,QAAQ,WAAW,OAAO,CAAC,CACvC;EACF,SAAS,KAAK;GACZ,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,IAAI,QAAQ,KAAK,kBAAkB;GACnC;EACF;EAEA,IAAI,CAAC,cAAiB,MAAM,GAAG;GAC7B,KAAK,QAAQ;GACb,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,IAAI,QAAQ,KAAK,kBAAkB;GACnC;EACF;EAEA,IAAI,KAEF,aAAa,CAAC,CAAC,oBAAoB;EAGrC,QAAQ,QAAQ,MAAM,CAAC,CACpB,MAAM,QAAQ;GACb,IAAI,KAAK,eAAe,YAAY;GACpC,IAAI,KAAK,eAAe,YAAY;GAKpC,IAAI,WAAW,OAAO,SAAS;GAC/B,KAAK,QAAQ;GACb,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,KAAK,kBAAkB;EACzB,CAAC,CAAC,CACD,OAAO,QAAQ;GACd,IAAI,KAAK,eAAe,YAAY;GACpC,IAAI,KAAK,eAAe,YAAY;GASpC,IANE,WAAW,OAAO,WACjB,eAAe,SAAS,IAAI,SAAS,gBACrC,OAAO,iBAAiB,eACvB,eAAe,gBACf,IAAI,SAAS,cAGf;GAGF,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,IAAI;IACF,IAAI,KAAK,WACP,OAAO,MACL,kCAAkC,KAAK,UAAU,IACjD,GACF;SAEA,OAAO,MAAM,gCAAgC,GAAG;GAEpD,QAAQ,CAER;GACA,KAAK,kBAAkB;EACzB,CAAC;CACL;CAEA,UAAU;EACR,IAAI,KAAK,UACP;EAGF,KAAK;EACL,KAAK,YAAY,MAAM;EACvB,KAAK,MAAM;CACb;CAEA,QAAQ;EACN,KAAK,YAAY,MAAM;CACzB;CAEA,UAAU;EACR,IAAI,KAAK,UACP;EAGF,KAAK,WAAW;EAChB,KAAK,YAAY,MAAM;EACvB,KAAK,YAAY,MAAM;CACzB;AACF"}
+{"version":3,"file":"resource-cell.js","names":[],"sources":["../../src/runtime/resource-cell.ts"],"sourcesContent":["import { withAsyncResourceContext, type ContextFrame } from './context';\nimport { logger } from '../dev/logger';\nimport {\n  brandSnapshotSource,\n  type SnapshotSourceBrand,\n} from './snapshot-source';\nimport { isPromiseLike } from '../common/promise';\nimport { throwSSRDataMissing } from '../common/render-context';\n\n/**\n * Pure, component-agnostic ResourceCell state machine.\n * - Holds value/pending/error/generation/controller\n * - Exposes a stable `snapshot` object: { value, pending, error, refresh }\n * - Uses `withAsyncResourceContext` to bind the synchronous execution step\n *   to a captured frame. Continuations after await do not see the frame.\n */\nexport class ResourceCell<U> {\n  value: U | null = null;\n  pending = true;\n  error: Error | null = null;\n  generation = 0;\n  controller: AbortController | null = null;\n  deps: readonly unknown[] | null = null;\n  resourceFrame: ContextFrame | null = null;\n\n  // Optional debug label set by caller (component name) to improve logs\n  ownerName?: string;\n\n  private subscribers = new Set<() => void>();\n  private disposed = false;\n\n  readonly snapshot: {\n    value: U | null;\n    pending: boolean;\n    error: Error | null;\n    refresh: () => void;\n  } & SnapshotSourceBrand;\n\n  private fn: (opts: { signal: AbortSignal }) => PromiseLike<U> | U;\n\n  constructor(\n    fn: (opts: { signal: AbortSignal }) => PromiseLike<U> | U,\n    deps: readonly unknown[] | null,\n    resourceFrame: ContextFrame | null\n  ) {\n    this.fn = fn;\n    this.deps = deps ? deps.slice() : null;\n    this.resourceFrame = resourceFrame;\n    this.snapshot = brandSnapshotSource({\n      value: null,\n      pending: true,\n      error: null,\n      refresh: () => this.refresh(),\n    });\n  }\n\n  setLoader(fn: (opts: { signal: AbortSignal }) => PromiseLike<U> | U): void {\n    this.fn = fn;\n  }\n\n  subscribe(cb: () => void): () => void {\n    this.subscribers.add(cb);\n    return () => this.subscribers.delete(cb);\n  }\n\n  private notifySubscribers() {\n    this.snapshot.value = this.value;\n    this.snapshot.pending = this.pending;\n    this.snapshot.error = this.error;\n    for (const cb of this.subscribers) cb();\n  }\n\n  start(ssr = false, notify = true) {\n    if (this.disposed) {\n      return;\n    }\n\n    const generation = this.generation;\n\n    this.controller?.abort();\n    const controller = new AbortController();\n    this.controller = controller;\n    this.pending = true;\n    this.error = null;\n    if (notify) this.notifySubscribers();\n\n    let result: PromiseLike<U> | U;\n    try {\n      // Execute only the synchronous step inside the frozen resource frame.\n      result = withAsyncResourceContext(this.resourceFrame, () =>\n        this.fn({ signal: controller.signal })\n      );\n    } catch (err) {\n      this.pending = false;\n      this.error = err as Error;\n      if (notify) this.notifySubscribers();\n      return;\n    }\n\n    if (!isPromiseLike<U>(result)) {\n      this.value = result as U;\n      this.pending = false;\n      this.error = null;\n      if (notify) this.notifySubscribers();\n      return;\n    }\n\n    if (ssr) {\n      // During SSR async results are disallowed\n      throwSSRDataMissing();\n    }\n\n    Promise.resolve(result)\n      .then((val) => {\n        if (this.generation !== generation) return;\n        if (this.controller !== controller) return;\n        // A loader that does not reject on abort (e.g. a plain Promise) would\n        // otherwise commit its value after the fetch was cancelled by a deps\n        // change, refresh(), or unmount. Mirror the AbortError guard used in\n        // the rejection path so an aborted fetch's resolution stays inert.\n        if (controller.signal.aborted) return;\n        this.value = val;\n        this.pending = false;\n        this.error = null;\n        this.notifySubscribers();\n      })\n      .catch((err) => {\n        if (this.generation !== generation) return;\n        if (this.controller !== controller) return;\n\n        const isAbortError =\n          controller.signal.aborted ||\n          (err instanceof Error && err.name === 'AbortError') ||\n          (typeof DOMException !== 'undefined' &&\n            err instanceof DOMException &&\n            err.name === 'AbortError');\n\n        if (isAbortError) {\n          return;\n        }\n\n        this.pending = false;\n        this.error = err as Error;\n        try {\n          if (this.ownerName) {\n            logger.error(\n              `[Askr] Async resource error in ${this.ownerName}:`,\n              err\n            );\n          } else {\n            logger.error('[Askr] Async resource error:', err);\n          }\n        } catch {\n          /* ignore logging errors */\n        }\n        this.notifySubscribers();\n      });\n  }\n\n  refresh() {\n    if (this.disposed) {\n      return;\n    }\n\n    this.generation++;\n    this.controller?.abort();\n    this.start();\n  }\n\n  abort() {\n    this.controller?.abort();\n  }\n\n  dispose() {\n    if (this.disposed) {\n      return;\n    }\n\n    this.disposed = true;\n    this.controller?.abort();\n    this.subscribers.clear();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,eAAb,MAA6B;CAwB3B,YACE,IACA,MACA,eACA;eA3BgB;iBACR;eACY;oBACT;oBACwB;cACH;uBACG;qCAKf,IAAI,IAAgB;kBACvB;EAgBjB,KAAK,KAAK;EACV,KAAK,OAAO,OAAO,KAAK,MAAM,IAAI;EAClC,KAAK,gBAAgB;EACrB,KAAK,WAAW,oBAAoB;GAClC,OAAO;GACP,SAAS;GACT,OAAO;GACP,eAAe,KAAK,QAAQ;EAC9B,CAAC;CACH;CAEA,UAAU,IAAiE;EACzE,KAAK,KAAK;CACZ;CAEA,UAAU,IAA4B;EACpC,KAAK,YAAY,IAAI,EAAE;EACvB,aAAa,KAAK,YAAY,OAAO,EAAE;CACzC;CAEA,oBAA4B;EAC1B,KAAK,SAAS,QAAQ,KAAK;EAC3B,KAAK,SAAS,UAAU,KAAK;EAC7B,KAAK,SAAS,QAAQ,KAAK;EAC3B,KAAK,MAAM,MAAM,KAAK,aAAa,GAAG;CACxC;CAEA,MAAM,MAAM,OAAO,SAAS,MAAM;EAChC,IAAI,KAAK,UACP;EAGF,MAAM,aAAa,KAAK;EAExB,KAAK,YAAY,MAAM;EACvB,MAAM,aAAa,IAAI,gBAAgB;EACvC,KAAK,aAAa;EAClB,KAAK,UAAU;EACf,KAAK,QAAQ;EACb,IAAI,QAAQ,KAAK,kBAAkB;EAEnC,IAAI;EACJ,IAAI;GAEF,SAAS,yBAAyB,KAAK,qBACrC,KAAK,GAAG,EAAE,QAAQ,WAAW,OAAO,CAAC,CACvC;EACF,SAAS,KAAK;GACZ,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,IAAI,QAAQ,KAAK,kBAAkB;GACnC;EACF;EAEA,IAAI,CAAC,cAAiB,MAAM,GAAG;GAC7B,KAAK,QAAQ;GACb,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,IAAI,QAAQ,KAAK,kBAAkB;GACnC;EACF;EAEA,IAAI,KAEF,oBAAoB;EAGtB,QAAQ,QAAQ,MAAM,CAAC,CACpB,MAAM,QAAQ;GACb,IAAI,KAAK,eAAe,YAAY;GACpC,IAAI,KAAK,eAAe,YAAY;GAKpC,IAAI,WAAW,OAAO,SAAS;GAC/B,KAAK,QAAQ;GACb,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,KAAK,kBAAkB;EACzB,CAAC,CAAC,CACD,OAAO,QAAQ;GACd,IAAI,KAAK,eAAe,YAAY;GACpC,IAAI,KAAK,eAAe,YAAY;GASpC,IANE,WAAW,OAAO,WACjB,eAAe,SAAS,IAAI,SAAS,gBACrC,OAAO,iBAAiB,eACvB,eAAe,gBACf,IAAI,SAAS,cAGf;GAGF,KAAK,UAAU;GACf,KAAK,QAAQ;GACb,IAAI;IACF,IAAI,KAAK,WACP,OAAO,MACL,kCAAkC,KAAK,UAAU,IACjD,GACF;SAEA,OAAO,MAAM,gCAAgC,GAAG;GAEpD,QAAQ,CAER;GACA,KAAK,kBAAkB;EACzB,CAAC;CACL;CAEA,UAAU;EACR,IAAI,KAAK,UACP;EAGF,KAAK;EACL,KAAK,YAAY,MAAM;EACvB,KAAK,MAAM;CACb;CAEA,QAAQ;EACN,KAAK,YAAY,MAAM;CACzB;CAEA,UAAU;EACR,IAAI,KAAK,UACP;EAGF,KAAK,WAAW;EAChB,KAAK,YAAY,MAAM;EACvB,KAAK,YAAY,MAAM;CACzB;AACF"}

package/dist/runtime/resource-operation.d.ts

@@ -0,0 +1,13 @@
+//#region src/runtime/resource-operation.d.ts
+interface ResourceResult<T> {
+  value: T | null;
+  pending: boolean;
+  error: Error | null;
+  refresh(): void;
+}
+declare function resource<T, const TDeps extends readonly unknown[]>(fn: (opts: {
+  signal: AbortSignal;
+}) => PromiseLike<T> | T, deps: TDeps): ResourceResult<T>;
+//#endregion
+export { ResourceResult, resource };
+//# sourceMappingURL=resource-operation.d.ts.map

package/dist/runtime/resource-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-operation.d.ts","names":[],"sources":["../../src/runtime/resource-operation.ts"],"mappings":";UAiBiB,cAAA;EACf,KAAA,EAAO,CAAA;EACP,OAAA;EACA,KAAA,EAAO,KAAK;EACZ,OAAA;AAAA;AAAA,iBAGc,QAAA,4CACd,EAAA,GAAK,IAAA;EAAQ,MAAA,EAAQ,WAAA;AAAA,MAAkB,WAAA,CAAY,CAAA,IAAK,CAAA,EACxD,IAAA,EAAM,KAAA,GACL,cAAA,CAAe,CAAA"}

package/dist/runtime/resource-operation.js

@@ -0,0 +1,170 @@
+import { enqueueRuntimeLane } from "./access.js";
+import { getCurrentContextFrame } from "./context.js";
+import { getCurrentComponentInstance } from "./component-scope.js";
+import "./component.js";
+import { state } from "./state.js";
+import { brandSnapshotSource } from "./snapshot-source.js";
+import { SSRDataMissingError } from "../common/ssr-errors.js";
+import { getActiveRenderContext, getCurrentRenderData, getNextRenderKey, throwSSRDataMissing } from "../common/render-context.js";
+import { ResourceCell } from "./resource-cell.js";
+//#region src/runtime/resource-operation.ts
+/**
+* Resource primitive — simple, deterministic async primitive
+* Usage: resource(fn, deps)
+* - fn receives { signal }
+* - captures execution context once at creation (synchronous step only)
+* - executes at most once per generation; stale async results are ignored
+* - refresh() cancels in-flight execution, increments generation and re-runs
+* - exposes { value, pending, error, refresh }
+* - during SSR, async results are disallowed and will throw synchronously
+*/
+function resource(fn, deps = []) {
+	const instance = getCurrentComponentInstance();
+	const inst = instance;
+	if (!instance) {
+		const renderData = getCurrentRenderData();
+		if (renderData) {
+			const key = getNextRenderKey();
+			if (!(key in renderData)) throwSSRDataMissing();
+			const val = renderData[key];
+			return brandSnapshotSource({
+				value: val,
+				pending: false,
+				error: null,
+				refresh: () => {}
+			});
+		}
+		if (getActiveRenderContext()) throwSSRDataMissing();
+		throw new Error("[Askr] resource() must be called during component render inside an app. Do not create resources at module scope or outside render.");
+	}
+	const renderData = getCurrentRenderData();
+	if (renderData) {
+		const key = getNextRenderKey();
+		if (!(key in renderData)) throwSSRDataMissing();
+		const val = renderData[key];
+		const h = state({
+			cell: void 0,
+			snapshot: brandSnapshotSource({
+				value: val,
+				pending: false,
+				error: null,
+				refresh: () => {}
+			})
+		})();
+		h.snapshot.value = val;
+		h.snapshot.pending = false;
+		h.snapshot.error = null;
+		return h.snapshot;
+	}
+	const holder = state({
+		cell: void 0,
+		snapshot: brandSnapshotSource({
+			value: null,
+			pending: true,
+			error: null,
+			refresh: () => {}
+		})
+	});
+	const h = holder();
+	if (!h.cell) {
+		const cell = new ResourceCell(fn, deps, getCurrentContextFrame());
+		cell.ownerName = inst.fn?.name || "<anonymous>";
+		h.cell = cell;
+		h.snapshot = cell.snapshot;
+		const unsubscribe = cell.subscribe(() => {
+			const cur = holder();
+			cur.snapshot.value = cell.snapshot.value;
+			cur.snapshot.pending = cell.snapshot.pending;
+			cur.snapshot.error = cell.snapshot.error;
+			holder.set(cur);
+			try {
+				inst.notifyUpdate?.();
+			} catch {}
+		});
+		(inst.cleanupFns ??= []).push(() => {
+			unsubscribe();
+			cell.dispose();
+		});
+		if (inst.ssr) {
+			cell.start(true, false);
+			if (!cell.pending) {
+				const cur = holder();
+				cur.snapshot.value = cell.value;
+				cur.snapshot.pending = cell.pending;
+				cur.snapshot.error = cell.error;
+			}
+		} else {
+			const scheduledGeneration = cell.generation;
+			enqueueRuntimeLane("post", () => {
+				if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) return;
+				try {
+					cell.start(false, false);
+				} catch (err) {
+					const cur = holder();
+					cur.snapshot.value = cell.value;
+					cur.snapshot.pending = cell.pending;
+					cur.snapshot.error = err ?? null;
+					holder.set(cur);
+					inst.notifyUpdate?.();
+					return;
+				}
+				if (!cell.pending) {
+					const cur = holder();
+					cur.snapshot.value = cell.value;
+					cur.snapshot.pending = cell.pending;
+					cur.snapshot.error = cell.error;
+					holder.set(cur);
+					inst.notifyUpdate?.();
+				}
+			});
+		}
+	}
+	const cell = h.cell;
+	cell.setLoader(fn);
+	if (!cell.deps || cell.deps.length !== deps.length || cell.deps.some((d, i) => !Object.is(d, deps[i]))) {
+		cell.deps = deps.slice();
+		cell.generation++;
+		cell.pending = true;
+		cell.error = null;
+		h.snapshot.pending = true;
+		h.snapshot.error = null;
+		try {
+			if (inst.ssr) {
+				cell.start(true, false);
+				if (!cell.pending) {
+					const cur = holder();
+					cur.snapshot.value = cell.value;
+					cur.snapshot.pending = cell.pending;
+					cur.snapshot.error = cell.error;
+				}
+			} else {
+				const scheduledGeneration = cell.generation;
+				enqueueRuntimeLane("post", () => {
+					if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) return;
+					cell.start(false, false);
+					if (!cell.pending) {
+						const cur = holder();
+						cur.snapshot.value = cell.value;
+						cur.snapshot.pending = cell.pending;
+						cur.snapshot.error = cell.error;
+						holder.set(cur);
+						inst.notifyUpdate?.();
+					}
+				});
+			}
+		} catch (err) {
+			if (err instanceof SSRDataMissingError) throw err;
+			cell.error = err;
+			cell.pending = false;
+			const cur = holder();
+			cur.snapshot.value = cell.value;
+			cur.snapshot.pending = cell.pending;
+			cur.snapshot.error = cell.error;
+		}
+	}
+	return h.snapshot;
+}
+//#endregion
+export { resource };
+
+//# sourceMappingURL=resource-operation.js.map

package/dist/runtime/resource-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-operation.js","names":[],"sources":["../../src/runtime/resource-operation.ts"],"sourcesContent":["import {\n  getCurrentComponentInstance,\n  type ComponentInstance,\n} from './component';\nimport { getCurrentContextFrame } from './context';\nimport { ResourceCell } from './resource-cell';\nimport { state } from './state';\nimport { enqueueRuntimeLane } from './access';\nimport { brandSnapshotSource } from './snapshot-source';\nimport { SSRDataMissingError } from '../common/ssr-errors';\nimport {\n  getActiveRenderContext,\n  getCurrentRenderData,\n  getNextRenderKey,\n  throwSSRDataMissing,\n} from '../common/render-context';\n\nexport interface ResourceResult<T> {\n  value: T | null;\n  pending: boolean;\n  error: Error | null;\n  refresh(): void;\n}\n\nexport function resource<T, const TDeps extends readonly unknown[]>(\n  fn: (opts: { signal: AbortSignal }) => PromiseLike<T> | T,\n  deps: TDeps\n): ResourceResult<T>;\n\n/**\n * Resource primitive — simple, deterministic async primitive\n * Usage: resource(fn, deps)\n * - fn receives { signal }\n * - captures execution context once at creation (synchronous step only)\n * - executes at most once per generation; stale async results are ignored\n * - refresh() cancels in-flight execution, increments generation and re-runs\n * - exposes { value, pending, error, refresh }\n * - during SSR, async results are disallowed and will throw synchronously\n */\nexport function resource<T>(\n  fn: (opts: { signal: AbortSignal }) => PromiseLike<T> | T,\n  deps: readonly unknown[] = []\n): ResourceResult<T> {\n  const instance = getCurrentComponentInstance();\n  // Create a non-null alias early so it can be used in nested closures\n  // without TypeScript complaining about possible null access.\n  const inst = instance as ComponentInstance;\n\n  if (!instance) {\n    // If we're in a synchronous SSR render that has resolved data, use it.\n    const renderData = getCurrentRenderData();\n    if (renderData) {\n      const key = getNextRenderKey();\n      if (!(key in renderData)) {\n        throwSSRDataMissing();\n      }\n      const val = renderData[key] as T;\n      return brandSnapshotSource({\n        value: val,\n        pending: false,\n        error: null,\n        refresh: () => {},\n      }) as ResourceResult<T>;\n    }\n\n    // If we are in an SSR render pass without supplied data, throw for clarity.\n    const ssrCtx = getActiveRenderContext();\n    if (ssrCtx) {\n      throwSSRDataMissing();\n    }\n\n    // No active component instance and not in SSR render with data.\n    // Autopilot invariant: resources must be created during render within an app.\n    throw new Error(\n      '[Askr] resource() must be called during component render inside an app. ' +\n        'Do not create resources at module scope or outside render.'\n    );\n  }\n\n  // Internal ResourceCell — pure state machine now moved to its own module\n  // to keep component wiring separate and ensure no component access here.\n  // (See ./resource-cell.ts)\n\n  // If we're in a synchronous SSR render that was supplied resolved data, use it\n  const renderData = getCurrentRenderData();\n  if (renderData) {\n    // Deterministic key generation: the collection step and render step use\n    // the same incremental key generation to align resources.\n    const key = getNextRenderKey();\n    if (!(key in renderData)) {\n      throwSSRDataMissing();\n    }\n\n    // Commit synchronous value from render data and return a stable snapshot\n    const val = renderData[key] as T;\n\n    const holder = state<{\n      cell?: ResourceCell<T>;\n      snapshot: ResourceResult<T>;\n    }>({\n      cell: undefined,\n      snapshot: brandSnapshotSource({\n        value: val,\n        pending: false,\n        error: null,\n        refresh: () => {},\n      }) as ResourceResult<T>,\n    });\n\n    const h = holder();\n    h.snapshot.value = val;\n    h.snapshot.pending = false;\n    h.snapshot.error = null;\n    return h.snapshot;\n  }\n\n  // Persist a holder so the snapshot identity is stable across renders.\n  const holder = state<{ cell?: ResourceCell<T>; snapshot: ResourceResult<T> }>(\n    {\n      cell: undefined,\n      snapshot: brandSnapshotSource({\n        value: null,\n        pending: true,\n        error: null,\n        refresh: () => {},\n      }) as ResourceResult<T>,\n    }\n  );\n\n  const h = holder();\n\n  // Initialize cell on first call\n  if (!h.cell) {\n    const frame = getCurrentContextFrame();\n    const cell = new ResourceCell<T>(fn, deps, frame);\n    // Attach debug label (component name) for richer logs\n    cell.ownerName = inst.fn?.name || '<anonymous>';\n    h.cell = cell;\n    h.snapshot = cell.snapshot as ResourceResult<T>;\n\n    // Subscribe and schedule component updates when cell changes\n    const unsubscribe = cell.subscribe(() => {\n      const cur = holder();\n      cur.snapshot.value = cell.snapshot.value;\n      cur.snapshot.pending = cell.snapshot.pending;\n      cur.snapshot.error = cell.snapshot.error;\n      holder.set(cur);\n      try {\n        inst.notifyUpdate?.();\n      } catch {\n        // ignore\n      }\n    });\n\n    // Cleanup on unmount\n    (inst.cleanupFns ??= []).push(() => {\n      unsubscribe();\n      cell.dispose();\n    });\n\n    // Render invariant: do NOT start async work during render on the client.\n    // SSR remains strict/synchronous and must throw immediately if async is encountered.\n    if (inst.ssr) {\n      // SSR: must run synchronously so missing data throws during render\n      cell.start(true, false);\n      if (!cell.pending) {\n        const cur = holder();\n        cur.snapshot.value = cell.value;\n        cur.snapshot.pending = cell.pending;\n        cur.snapshot.error = cell.error;\n      }\n    } else {\n      // Client: start after render via scheduler (never inline)\n      const scheduledGeneration = cell.generation;\n      enqueueRuntimeLane('post', () => {\n        if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) {\n          return;\n        }\n\n        try {\n          cell.start(false, false);\n        } catch (err) {\n          // Non-SSR: reflect synchronous errors into snapshot via manual update\n          const cur = holder();\n          cur.snapshot.value = cell.value;\n          cur.snapshot.pending = cell.pending;\n          cur.snapshot.error = (err as Error) ?? null;\n          holder.set(cur);\n          inst.notifyUpdate?.();\n          return;\n        }\n\n        // If the resource completed synchronously, subscribers were not notified.\n        // Force a re-render so the component can observe the value.\n        if (!cell.pending) {\n          const cur = holder();\n          cur.snapshot.value = cell.value;\n          cur.snapshot.pending = cell.pending;\n          cur.snapshot.error = cell.error;\n          holder.set(cur);\n          inst.notifyUpdate?.();\n        }\n      });\n    }\n  }\n\n  const cell = h.cell!;\n  cell.setLoader(fn);\n\n  // Detect dependency changes and refresh immediately\n  const depsChanged =\n    !cell.deps ||\n    cell.deps.length !== deps.length ||\n    cell.deps.some((d, i) => !Object.is(d, deps[i]));\n\n  if (depsChanged) {\n    cell.deps = deps.slice();\n    cell.generation++;\n    cell.pending = true;\n    cell.error = null;\n\n    // Synchronously reflect the pending state into the stable snapshot so the\n    // render that triggered the deps change can surface a loading indicator.\n    // The async start() runs with notify=false and the deps-change branch never\n    // re-published the snapshot, so without this a deps-driven refetch jumped\n    // straight from the old value to the new value, never exposing pending.\n    // Stale-while-revalidate: the previous value is retained until the new\n    // fetch resolves.\n    h.snapshot.pending = true;\n    h.snapshot.error = null;\n    try {\n      if (inst.ssr) {\n        cell.start(true, false);\n        if (!cell.pending) {\n          const cur = holder();\n          cur.snapshot.value = cell.value;\n          cur.snapshot.pending = cell.pending;\n          cur.snapshot.error = cell.error;\n        }\n      } else {\n        const scheduledGeneration = cell.generation;\n        enqueueRuntimeLane('post', () => {\n          if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) {\n            return;\n          }\n\n          cell.start(false, false);\n          if (!cell.pending) {\n            const cur = holder();\n            cur.snapshot.value = cell.value;\n            cur.snapshot.pending = cell.pending;\n            cur.snapshot.error = cell.error;\n            holder.set(cur);\n            inst.notifyUpdate?.();\n          }\n        });\n      }\n    } catch (err) {\n      if (err instanceof SSRDataMissingError) throw err;\n      cell.error = err as Error;\n      cell.pending = false;\n      const cur = holder();\n      cur.snapshot.value = cell.value;\n      cur.snapshot.pending = cell.pending;\n      cur.snapshot.error = cell.error;\n      // Do not call holder.set() here; this is still render.\n    }\n  }\n\n  // Return the stable snapshot object owned by the cell\n  return h.snapshot;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,SACd,IACA,OAA2B,CAAC,GACT;CACnB,MAAM,WAAW,4BAA4B;CAG7C,MAAM,OAAO;CAEb,IAAI,CAAC,UAAU;EAEb,MAAM,aAAa,qBAAqB;EACxC,IAAI,YAAY;GACd,MAAM,MAAM,iBAAiB;GAC7B,IAAI,EAAE,OAAO,aACX,oBAAoB;GAEtB,MAAM,MAAM,WAAW;GACvB,OAAO,oBAAoB;IACzB,OAAO;IACP,SAAS;IACT,OAAO;IACP,eAAe,CAAC;GAClB,CAAC;EACH;EAIA,IADe,uBACX,GACF,oBAAoB;EAKtB,MAAM,IAAI,MACR,oIAEF;CACF;CAOA,MAAM,aAAa,qBAAqB;CACxC,IAAI,YAAY;EAGd,MAAM,MAAM,iBAAiB;EAC7B,IAAI,EAAE,OAAO,aACX,oBAAoB;EAItB,MAAM,MAAM,WAAW;EAevB,MAAM,IAbS,MAGZ;GACD,MAAM;GACN,UAAU,oBAAoB;IAC5B,OAAO;IACP,SAAS;IACT,OAAO;IACP,eAAe,CAAC;GAClB,CAAC;EACH,CAEU,CAAA,CAAO;EACjB,EAAE,SAAS,QAAQ;EACnB,EAAE,SAAS,UAAU;EACrB,EAAE,SAAS,QAAQ;EACnB,OAAO,EAAE;CACX;CAGA,MAAM,SAAS,MACb;EACE,MAAM;EACN,UAAU,oBAAoB;GAC5B,OAAO;GACP,SAAS;GACT,OAAO;GACP,eAAe,CAAC;EAClB,CAAC;CACH,CACF;CAEA,MAAM,IAAI,OAAO;CAGjB,IAAI,CAAC,EAAE,MAAM;EAEX,MAAM,OAAO,IAAI,aAAgB,IAAI,MADvB,uBAC6B,CAAK;EAEhD,KAAK,YAAY,KAAK,IAAI,QAAQ;EAClC,EAAE,OAAO;EACT,EAAE,WAAW,KAAK;EAGlB,MAAM,cAAc,KAAK,gBAAgB;GACvC,MAAM,MAAM,OAAO;GACnB,IAAI,SAAS,QAAQ,KAAK,SAAS;GACnC,IAAI,SAAS,UAAU,KAAK,SAAS;GACrC,IAAI,SAAS,QAAQ,KAAK,SAAS;GACnC,OAAO,IAAI,GAAG;GACd,IAAI;IACF,KAAK,eAAe;GACtB,QAAQ,CAER;EACF,CAAC;EAGD,CAAC,KAAK,eAAe,CAAC,EAAA,CAAG,WAAW;GAClC,YAAY;GACZ,KAAK,QAAQ;EACf,CAAC;EAID,IAAI,KAAK,KAAK;GAEZ,KAAK,MAAM,MAAM,KAAK;GACtB,IAAI,CAAC,KAAK,SAAS;IACjB,MAAM,MAAM,OAAO;IACnB,IAAI,SAAS,QAAQ,KAAK;IAC1B,IAAI,SAAS,UAAU,KAAK;IAC5B,IAAI,SAAS,QAAQ,KAAK;GAC5B;EACF,OAAO;GAEL,MAAM,sBAAsB,KAAK;GACjC,mBAAmB,cAAc;IAC/B,IAAI,CAAC,KAAK,gBAAgB,KAAK,eAAe,qBAC5C;IAGF,IAAI;KACF,KAAK,MAAM,OAAO,KAAK;IACzB,SAAS,KAAK;KAEZ,MAAM,MAAM,OAAO;KACnB,IAAI,SAAS,QAAQ,KAAK;KAC1B,IAAI,SAAS,UAAU,KAAK;KAC5B,IAAI,SAAS,QAAS,OAAiB;KACvC,OAAO,IAAI,GAAG;KACd,KAAK,eAAe;KACpB;IACF;IAIA,IAAI,CAAC,KAAK,SAAS;KACjB,MAAM,MAAM,OAAO;KACnB,IAAI,SAAS,QAAQ,KAAK;KAC1B,IAAI,SAAS,UAAU,KAAK;KAC5B,IAAI,SAAS,QAAQ,KAAK;KAC1B,OAAO,IAAI,GAAG;KACd,KAAK,eAAe;IACtB;GACF,CAAC;EACH;CACF;CAEA,MAAM,OAAO,EAAE;CACf,KAAK,UAAU,EAAE;CAQjB,IAJE,CAAC,KAAK,QACN,KAAK,KAAK,WAAW,KAAK,UAC1B,KAAK,KAAK,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,GAAG,KAAK,EAAE,CAAC,GAEhC;EACf,KAAK,OAAO,KAAK,MAAM;EACvB,KAAK;EACL,KAAK,UAAU;EACf,KAAK,QAAQ;EASb,EAAE,SAAS,UAAU;EACrB,EAAE,SAAS,QAAQ;EACnB,IAAI;GACF,IAAI,KAAK,KAAK;IACZ,KAAK,MAAM,MAAM,KAAK;IACtB,IAAI,CAAC,KAAK,SAAS;KACjB,MAAM,MAAM,OAAO;KACnB,IAAI,SAAS,QAAQ,KAAK;KAC1B,IAAI,SAAS,UAAU,KAAK;KAC5B,IAAI,SAAS,QAAQ,KAAK;IAC5B;GACF,OAAO;IACL,MAAM,sBAAsB,KAAK;IACjC,mBAAmB,cAAc;KAC/B,IAAI,CAAC,KAAK,gBAAgB,KAAK,eAAe,qBAC5C;KAGF,KAAK,MAAM,OAAO,KAAK;KACvB,IAAI,CAAC,KAAK,SAAS;MACjB,MAAM,MAAM,OAAO;MACnB,IAAI,SAAS,QAAQ,KAAK;MAC1B,IAAI,SAAS,UAAU,KAAK;MAC5B,IAAI,SAAS,QAAQ,KAAK;MAC1B,OAAO,IAAI,GAAG;MACd,KAAK,eAAe;KACtB;IACF,CAAC;GACH;EACF,SAAS,KAAK;GACZ,IAAI,eAAe,qBAAqB,MAAM;GAC9C,KAAK,QAAQ;GACb,KAAK,UAAU;GACf,MAAM,MAAM,OAAO;GACnB,IAAI,SAAS,QAAQ,KAAK;GAC1B,IAAI,SAAS,UAAU,KAAK;GAC5B,IAAI,SAAS,QAAQ,KAAK;EAE5B;CACF;CAGA,OAAO,EAAE;AACX"}

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,42 @@
+import { ReadableSource } from "./readable.js";
+import { ComponentInstance } from "./component-internal.js";
+import { Scheduler } from "./scheduler.js";
+
+//#region src/runtime/runtime.d.ts
+interface RuntimeKeyedReorderDecision {
+  useFastPath: boolean;
+  totalKeyed: number;
+  totalChildren: number;
+  currentKeyCount: number;
+  moveCount: number;
+  lisLen: number;
+  hasPropChanges: boolean;
+  isWholeKeyedList: boolean;
+}
+interface RuntimeRendererHost {
+  evaluate(node: unknown, target: Element | null, context?: object, retainedOwner?: ComponentInstance): void;
+  cleanupInstancesUnder(node: Node): void;
+  teardownNodeSubtree(root: Element): void;
+  populateKeyMapForElement(parent: Element): void;
+  getKeyMapForElement(parent: Element): Map<string | number, Element> | undefined;
+  isKeyedReorderFastPathEligible(parent: Element, children: unknown[], oldKeyMap: Map<string | number, Element> | undefined): RuntimeKeyedReorderDecision;
+  markReactivePropsDirtySource(source: ReadableSource<unknown>): void;
+}
+interface AskrRuntimeOptions {
+  scheduler?: Scheduler;
+  renderer?: RuntimeRendererHost;
+}
+declare class AskrRuntime {
+  readonly scheduler: Scheduler;
+  private rendererHost;
+  constructor(options?: AskrRuntimeOptions);
+  get renderer(): RuntimeRendererHost;
+  configureRenderer(renderer: RuntimeRendererHost): void;
+}
+declare const defaultRuntime: AskrRuntime;
+declare function createRuntime(options?: AskrRuntimeOptions): AskrRuntime;
+declare function getDefaultRuntime(): AskrRuntime;
+declare function configureRuntimeRenderer(renderer: RuntimeRendererHost, runtime?: AskrRuntime): void;
+//#endregion
+export { AskrRuntime, AskrRuntimeOptions, RuntimeKeyedReorderDecision, RuntimeRendererHost, createRuntime, getDefaultRuntime };
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../src/runtime/runtime.ts"],"mappings":";;;;;UAIiB,2BAAA;EACf,WAAA;EACA,UAAA;EACA,aAAA;EACA,eAAA;EACA,SAAA;EACA,MAAA;EACA,cAAA;EACA,gBAAA;AAAA;AAAA,UAGe,mBAAA;EACf,QAAA,CACE,IAAA,WACA,MAAA,EAAQ,OAAA,SACR,OAAA,WACA,aAAA,GAAgB,iBAAA;EAElB,qBAAA,CAAsB,IAAA,EAAM,IAAA;EAC5B,mBAAA,CAAoB,IAAA,EAAM,OAAA;EAC1B,wBAAA,CAAyB,MAAA,EAAQ,OAAA;EACjC,mBAAA,CACE,MAAA,EAAQ,OAAA,GACP,GAAA,kBAAqB,OAAA;EACxB,8BAAA,CACE,MAAA,EAAQ,OAAA,EACR,QAAA,aACA,SAAA,EAAW,GAAA,kBAAqB,OAAA,gBAC/B,2BAAA;EACH,4BAAA,CAA6B,MAAA,EAAQ,cAAA;AAAA;AAAA,UAGtB,kBAAA;EACf,SAAA,GAAY,SAAA;EACZ,QAAA,GAAW,mBAAmB;AAAA;AAAA,cA4CnB,WAAA;EAAA,SACF,SAAA,EAAW,SAAA;EAAA,QACZ,YAAA;cAEI,OAAA,GAAS,kBAAA;EAAA,IAKjB,QAAA,IAAY,mBAAA;EAIhB,iBAAA,CAAkB,QAAA,EAAU,mBAAA;AAAA;AAAA,cAKjB,cAAA,EAAc,WAEzB;AAAA,iBAEc,aAAA,CAAc,OAAA,GAAS,kBAAA,GAA0B,WAAW;AAAA,iBAI5D,iBAAA,IAAqB,WAAW;AAAA,iBAIhC,wBAAA,CACd,QAAA,EAAU,mBAAA,EACV,OAAA,GAAS,WAA4B"}

package/dist/runtime/runtime.js

@@ -0,0 +1,59 @@
+import { globalScheduler } from "./scheduler.js";
+//#region src/runtime/runtime.ts
+function createMissingRendererHost() {
+	const missing = (method) => {
+		throw new Error(`[Askr] renderer host is not configured; cannot call ${method}().`);
+	};
+	return {
+		evaluate() {
+			missing("evaluate");
+		},
+		cleanupInstancesUnder() {
+			missing("cleanupInstancesUnder");
+		},
+		teardownNodeSubtree() {
+			missing("teardownNodeSubtree");
+		},
+		populateKeyMapForElement() {},
+		getKeyMapForElement() {},
+		isKeyedReorderFastPathEligible() {
+			return {
+				useFastPath: false,
+				totalKeyed: 0,
+				totalChildren: 0,
+				currentKeyCount: 0,
+				moveCount: 0,
+				lisLen: 0,
+				hasPropChanges: false,
+				isWholeKeyedList: false
+			};
+		},
+		markReactivePropsDirtySource() {}
+	};
+}
+var AskrRuntime = class {
+	constructor(options = {}) {
+		this.scheduler = options.scheduler ?? globalScheduler;
+		this.rendererHost = options.renderer ?? createMissingRendererHost();
+	}
+	get renderer() {
+		return this.rendererHost;
+	}
+	configureRenderer(renderer) {
+		this.rendererHost = renderer;
+	}
+};
+const defaultRuntime = new AskrRuntime({ scheduler: globalScheduler });
+function createRuntime(options = {}) {
+	return new AskrRuntime(options);
+}
+function getDefaultRuntime() {
+	return defaultRuntime;
+}
+function configureRuntimeRenderer(renderer, runtime = defaultRuntime) {
+	runtime.configureRenderer(renderer);
+}
+//#endregion
+export { AskrRuntime, configureRuntimeRenderer, createRuntime, defaultRuntime, getDefaultRuntime };
+
+//# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":[],"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { globalScheduler, type Scheduler } from './scheduler';\nimport type { ComponentInstance } from './component';\nimport type { ReadableSource } from './readable';\n\nexport interface RuntimeKeyedReorderDecision {\n  useFastPath: boolean;\n  totalKeyed: number;\n  totalChildren: number;\n  currentKeyCount: number;\n  moveCount: number;\n  lisLen: number;\n  hasPropChanges: boolean;\n  isWholeKeyedList: boolean;\n}\n\nexport interface RuntimeRendererHost {\n  evaluate(\n    node: unknown,\n    target: Element | null,\n    context?: object,\n    retainedOwner?: ComponentInstance\n  ): void;\n  cleanupInstancesUnder(node: Node): void;\n  teardownNodeSubtree(root: Element): void;\n  populateKeyMapForElement(parent: Element): void;\n  getKeyMapForElement(\n    parent: Element\n  ): Map<string | number, Element> | undefined;\n  isKeyedReorderFastPathEligible(\n    parent: Element,\n    children: unknown[],\n    oldKeyMap: Map<string | number, Element> | undefined\n  ): RuntimeKeyedReorderDecision;\n  markReactivePropsDirtySource(source: ReadableSource<unknown>): void;\n}\n\nexport interface AskrRuntimeOptions {\n  scheduler?: Scheduler;\n  renderer?: RuntimeRendererHost;\n}\n\nfunction createMissingRendererHost(): RuntimeRendererHost {\n  const missing = (method: string): never => {\n    throw new Error(\n      `[Askr] renderer host is not configured; cannot call ${method}().`\n    );\n  };\n\n  return {\n    evaluate() {\n      missing('evaluate');\n    },\n    cleanupInstancesUnder() {\n      missing('cleanupInstancesUnder');\n    },\n    teardownNodeSubtree() {\n      missing('teardownNodeSubtree');\n    },\n    populateKeyMapForElement() {\n      // Fast-lane callers treat an empty key map as a normal decline.\n    },\n    getKeyMapForElement() {\n      return undefined;\n    },\n    isKeyedReorderFastPathEligible() {\n      return {\n        useFastPath: false,\n        totalKeyed: 0,\n        totalChildren: 0,\n        currentKeyCount: 0,\n        moveCount: 0,\n        lisLen: 0,\n        hasPropChanges: false,\n        isWholeKeyedList: false,\n      };\n    },\n    markReactivePropsDirtySource() {\n      // Reactive prop tracking is renderer-owned and optional for runtimes.\n    },\n  };\n}\n\nexport class AskrRuntime {\n  readonly scheduler: Scheduler;\n  private rendererHost: RuntimeRendererHost;\n\n  constructor(options: AskrRuntimeOptions = {}) {\n    this.scheduler = options.scheduler ?? globalScheduler;\n    this.rendererHost = options.renderer ?? createMissingRendererHost();\n  }\n\n  get renderer(): RuntimeRendererHost {\n    return this.rendererHost;\n  }\n\n  configureRenderer(renderer: RuntimeRendererHost): void {\n    this.rendererHost = renderer;\n  }\n}\n\nexport const defaultRuntime = new AskrRuntime({\n  scheduler: globalScheduler,\n});\n\nexport function createRuntime(options: AskrRuntimeOptions = {}): AskrRuntime {\n  return new AskrRuntime(options);\n}\n\nexport function getDefaultRuntime(): AskrRuntime {\n  return defaultRuntime;\n}\n\nexport function configureRuntimeRenderer(\n  renderer: RuntimeRendererHost,\n  runtime: AskrRuntime = defaultRuntime\n): void {\n  runtime.configureRenderer(renderer);\n}\n"],"mappings":";;AAyCA,SAAS,4BAAiD;CACxD,MAAM,WAAW,WAA0B;EACzC,MAAM,IAAI,MACR,uDAAuD,OAAO,IAChE;CACF;CAEA,OAAO;EACL,WAAW;GACT,QAAQ,UAAU;EACpB;EACA,wBAAwB;GACtB,QAAQ,uBAAuB;EACjC;EACA,sBAAsB;GACpB,QAAQ,qBAAqB;EAC/B;EACA,2BAA2B,CAE3B;EACA,sBAAsB,CAEtB;EACA,iCAAiC;GAC/B,OAAO;IACL,aAAa;IACb,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,WAAW;IACX,QAAQ;IACR,gBAAgB;IAChB,kBAAkB;GACpB;EACF;EACA,+BAA+B,CAE/B;CACF;AACF;AAEA,IAAa,cAAb,MAAyB;CAIvB,YAAY,UAA8B,CAAC,GAAG;EAC5C,KAAK,YAAY,QAAQ,aAAa;EACtC,KAAK,eAAe,QAAQ,YAAY,0BAA0B;CACpE;CAEA,IAAI,WAAgC;EAClC,OAAO,KAAK;CACd;CAEA,kBAAkB,UAAqC;EACrD,KAAK,eAAe;CACtB;AACF;AAEA,MAAa,iBAAiB,IAAI,YAAY,EAC5C,WAAW,gBACb,CAAC;AAED,SAAgB,cAAc,UAA8B,CAAC,GAAgB;CAC3E,OAAO,IAAI,YAAY,OAAO;AAChC;AAEA,SAAgB,oBAAiC;CAC/C,OAAO;AACT;AAEA,SAAgB,yBACd,UACA,UAAuB,gBACjB;CACN,QAAQ,kBAAkB,QAAQ;AACpC"}

package/dist/runtime/scheduler.d.ts

@@ -11,7 +11,9 @@
  */
 type Task = () => void;
 type SchedulerLane = 'derived' | 'component' | 'reactive' | 'post';
+type SchedulerBulkCommitProbe = () => boolean;
 declare class Scheduler {
+  private bulkCommitProbe;
   private lanes;
   private running;
   private inHandler;
@@ -22,6 +24,8 @@ declare class Scheduler {
   private allowSyncProgress;
   private waiters;
   private taskCount;
+  setBulkCommitProbe(probe: SchedulerBulkCommitProbe): void;
+  private isBulkCommitActive;
   private hasPendingTasks;
   private getPendingTaskCount;
   private compactLane;
@@ -60,5 +64,5 @@ declare const globalScheduler: Scheduler;
 declare function isSchedulerExecuting(): boolean;
 declare function scheduleEventHandler(handler: EventListener): EventListener;
 //#endregion
-export { SchedulerLane, scheduleEventHandler };
+export { Scheduler, SchedulerBulkCommitProbe, SchedulerLane, scheduleEventHandler };
 //# sourceMappingURL=scheduler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","names":[],"sources":["../../src/runtime/scheduler.ts"],"mappings":";;;;;;AAkBS;AACT;;;;KADK,IAAA;AAAA,KACO,aAAA;AAAA,cA8BC,SAAA;EAAA,QACH,KAAA;EAAA,QAOA,OAAA;EAAA,QACA,SAAA;EAAA,QACA,KAAA;EAAA,QACA,cAAA;EAAA,QAGA,YAAA;EAAA,QAGA,aAAA;EAAA,QAGA,iBAAA;EAAA,QAGA,OAAA;EAAA,QAQA,SAAA;EAAA,QAEA,eAAA;EAAA,QAUA,mBAAA;EAAA,QASA,WAAA;EAAA,QAmBA,iBAAA;EA4BR,OAAA,CAAQ,IAAA,EAAM,IAAA;EAId,aAAA,CAAc,IAAA,EAAM,aAAA,EAAe,IAAA,EAAM,IAAA;EAuBzC,KAAA;EA4FA,mBAAA,IAAuB,EAAA,QAAU,CAAA,GAAI,CAAA;EAyCrC,YAAA,CAAa,aAAA,WAAwB,SAAA,YAAmB,OAAA;EAgCxD,QAAA;;;;;;;;;;;;;;;;EAsBA,eAAA;EAIA,aAAA;EAMA,iBAAA,IAAqB,EAAA,QAAU,CAAA,EAAG,SAAA,sBAAwC,CAAA;EAmB1E,YAAA,CAAa,CAAA;EAOb,WAAA;EAIA,WAAA;EAKA,qBAAA;EAAA,QAgCQ,cAAA;AAAA;AAAA,cAmBG,eAAA,EAAe,SAAkB;AAAA,iBAE9B,oBAAA;AAAA,iBAIA,oBAAA,CAAqB,OAAA,EAAS,aAAA,GAAgB,aAAa"}
+{"version":3,"file":"scheduler.d.ts","names":[],"sources":["../../src/runtime/scheduler.ts"],"mappings":";;;;;;AAkBS;AACT;;;;KADK,IAAA;AAAA,KACO,aAAA;AAAA,KACA,wBAAA;AAAA,cAcC,SAAA;EAAA,QACH,eAAA;EAAA,QAEA,KAAA;EAAA,QAOA,OAAA;EAAA,QACA,SAAA;EAAA,QACA,KAAA;EAAA,QACA,cAAA;EAAA,QAGA,YAAA;EAAA,QAGA,aAAA;EAAA,QAGA,iBAAA;EAAA,QAGA,OAAA;EAAA,QAQA,SAAA;EAER,kBAAA,CAAmB,KAAA,EAAO,wBAAA;EAAA,QAIlB,kBAAA;EAAA,QASA,eAAA;EAAA,QAUA,mBAAA;EAAA,QASA,WAAA;EAAA,QAmBA,iBAAA;EAgCR,OAAA,CAAQ,IAAA,EAAM,IAAA;EAId,aAAA,CAAc,IAAA,EAAM,aAAA,EAAe,IAAA,EAAM,IAAA;EAuBzC,KAAA;EA4FA,mBAAA,IAAuB,EAAA,QAAU,CAAA,GAAI,CAAA;EAyCrC,YAAA,CAAa,aAAA,WAAwB,SAAA,YAAmB,OAAA;EAgCxD,QAAA;;;;;;;;;;;;;;;;EAsBA,eAAA;EAIA,aAAA;EAMA,iBAAA,IAAqB,EAAA,QAAU,CAAA,EAAG,SAAA,sBAAwC,CAAA;EAmB1E,YAAA,CAAa,CAAA;EAOb,WAAA;EAIA,WAAA;EAKA,qBAAA;EAAA,QAgCQ,cAAA;AAAA;AAAA,cAmBG,eAAA,EAAe,SAAkB;AAAA,iBAE9B,oBAAA;AAAA,iBAIA,oBAAA,CAAqB,OAAA,EAAS,aAAA,GAAgB,aAAa"}

package/dist/runtime/scheduler.js

@@ -20,16 +20,9 @@ const SCHEDULER_LANES = [
 	"reactive",
 	"post"
 ];
-function isBulkCommitActive() {
-	try {
-		const fb = globalThis.__ASKR_FASTLANE;
-		return typeof fb?.isBulkCommitActive === "function" ? !!fb.isBulkCommitActive() : false;
-	} catch (e) {
-		return false;
-	}
-}
 var Scheduler = class {
 	constructor() {
+		this.bulkCommitProbe = () => false;
 		this.lanes = {
 			derived: {
 				tasks: [],
@@ -58,6 +51,16 @@ var Scheduler = class {
 		this.waiters = [];
 		this.taskCount = 0;
 	}
+	setBulkCommitProbe(probe) {
+		this.bulkCommitProbe = probe;
+	}
+	isBulkCommitActive() {
+		try {
+			return this.bulkCommitProbe();
+		} catch (e) {
+			return false;
+		}
+	}
 	hasPendingTasks() {
 		for (const lane of SCHEDULER_LANES) {
 			const queue = this.lanes[lane];
@@ -86,11 +89,11 @@ var Scheduler = class {
 		queue.head = 0;
 	}
 	scheduleFlushKick() {
-		if (this.running || this.kickScheduled || this.inHandler || this.allowSyncProgress || isBulkCommitActive() || !this.hasPendingTasks()) return;
+		if (this.running || this.kickScheduled || this.inHandler || this.allowSyncProgress || this.isBulkCommitActive() || !this.hasPendingTasks()) return;
 		this.kickScheduled = true;
 		queueMicrotask(() => {
 			this.kickScheduled = false;
-			if (this.running || isBulkCommitActive() || !this.hasPendingTasks()) return;
+			if (this.running || this.isBulkCommitActive() || !this.hasPendingTasks()) return;
 			try {
 				this.flush();
 			} catch (err) {
@@ -105,7 +108,7 @@ var Scheduler = class {
 	}
 	enqueueInLane(lane, task) {
 		assertSchedulingPrecondition(typeof task === "function", "enqueue() requires a function");
-		if (isBulkCommitActive() && !this.allowSyncProgress) {
+		if (this.isBulkCommitActive() && !this.allowSyncProgress) {
 			if (isDevelopmentEnvironment()) throw new Error("[Scheduler] enqueue() during bulk commit (not allowed)");
 			return;
 		}
@@ -116,7 +119,7 @@ var Scheduler = class {
 	flush() {
 		invariant(!this.running, "[Scheduler] flush() called while already running");
 		if (isDevelopmentEnvironment()) {
-			if (isBulkCommitActive() && !this.allowSyncProgress) throw new Error("[Scheduler] flush() started during bulk commit (not allowed)");
+			if (this.isBulkCommitActive() && !this.allowSyncProgress) throw new Error("[Scheduler] flush() started during bulk commit (not allowed)");
 		}
 		this.running = true;
 		this.depth = 0;
@@ -201,7 +204,7 @@ var Scheduler = class {
 					queueLen: this.getPendingTaskCount(),
 					running: this.running,
 					inHandler: this.inHandler,
-					bulk: isBulkCommitActive(),
+					bulk: this.isBulkCommitActive(),
 					namespace: ns
 				};
 				reject(/* @__PURE__ */ new Error(`waitForFlush timeout ${timeoutMs}ms: ${JSON.stringify(diag)}`));
@@ -299,9 +302,6 @@ var Scheduler = class {
 	}
 };
 const globalScheduler = new Scheduler();
-function isSchedulerExecuting() {
-	return globalScheduler.isExecuting();
-}
 function scheduleEventHandler(handler) {
 	return (event) => {
 		try {
@@ -314,6 +314,6 @@ function scheduleEventHandler(handler) {
 	};
 }
 //#endregion
-export { globalScheduler, isSchedulerExecuting, scheduleEventHandler };
+export { Scheduler, globalScheduler, scheduleEventHandler };
 
 //# sourceMappingURL=scheduler.js.map