@pibbl/core 0.0.1

package/dist/lib/scheduler/realm-scheduler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/scheduler/realm-scheduler.ts"],
+  "sourcesContent": ["import type { ManualSchedulerDriver } from './testing.js';\nimport { RootRenderTransaction } from '../render-transaction.js';\nimport { executeRender } from \"../execute-render.js\";\nimport { GLOBAL_STATE, NO_PENDING_ROOT } from \"../global-state.js\";\nimport {\n  createSignalCommitBatch,\n  flushPendingComputedValidations,\n  hasPendingComputedValidations,\n  setSignalGraphPlanWorkNotifier,\n  withDirectSignalWriteForbidden,\n} from \"../signals/graph.js\";\nimport type { PibblInstance, PibblRenderTransaction } from \"../types.js\";\nimport { runTeardown } from \"../teardowns.js\";\nimport type {\n  PibblAdvanceLane,\n  PibblAdvanceParticipant,\n  PibblBeginCommand,\n  PibblBeginCommandHandle,\n  PibblFrameCommitAcknowledgement,\n  PibblFrameCompletion,\n  PibblFramePhase,\n  PibblFrameSnapshot,\n  RealmSchedulerSnapshot,\n  PibblSchedulerTraceCollector,\n  PibblSchedulerTraceRecord,\n  SchedulerDriver,\n} from \"./types.js\";\n\ninterface InstanceRenderJob {\n  readonly instance: PibblInstance;\n  readonly firstRevision: number;\n  readonly revision: number;\n  readonly pendingRoot: PibblInstance[\"pendingRoot\"];\n  readonly pendingRootRevision: number;\n  readonly pendingUpdateParents: boolean;\n}\n\ninterface PendingInstanceWork {\n  /** Earliest accepted revision not yet completed in this eligibility bucket. */\n  firstRevision: number;\n  revision: number;\n  pendingRoot: PibblInstance[\"pendingRoot\"];\n  pendingRootRevision: number;\n  pendingUpdateParents: boolean;\n}\n\ninterface InstanceRenderRequest {\n  readonly pendingRoot: PibblInstance[\"pendingRoot\"];\n  readonly pendingUpdateParents: boolean;\n}\n\ninterface RootRenderJob {\n  readonly root: PibblInstance;\n  readonly instances: InstanceRenderJob[];\n}\n\ninterface RootTransaction extends PibblRenderTransaction {\n  finish(success: boolean): void;\n}\n\ninterface AdvanceRegistration {\n  readonly participant: PibblAdvanceParticipant;\n  readonly lane: PibblAdvanceLane;\n  readonly registrationOrder: number;\n  readonly requestsFrames: boolean;\n  active: boolean;\n}\n\ninterface BeginCommandRegistration {\n  readonly accepted: {\n    readonly sequence: number;\n    readonly command: PibblBeginCommand;\n  };\n  active: boolean;\n  owned: boolean;\n}\n\ninterface OrderedPlaybackCompletion {\n  readonly registrationOrder: number;\n  readonly sequence: number;\n  readonly callback: PibblFrameCompletion;\n}\n\nexport interface RendererParticipantOwner {\n  readonly instance: PibblInstance;\n  isActive(): boolean;\n}\n\ninterface RendererParticipantWorkRequest {\n  readonly key: object;\n  readonly kind: \"resource\" | \"draw\" | \"compose\";\n  readonly run: PibblFrameCompletion;\n}\n\ninterface RendererParticipantWorkRegistration {\n  readonly owner: RendererParticipantOwner;\n  request: RendererParticipantWorkRequest;\n  readonly order: number;\n}\n\ninterface RendererParticipantCompletion {\n  readonly owner: RendererParticipantOwner;\n  readonly callback: PibblFrameCompletion;\n  readonly order: number;\n}\n\nconst registeredRoots = new Set<PibblInstance>();\n// A running frame drains only current work. Late work is promoted after\n// Complete, so equal owner/key requests never coalesce across frame epochs.\nconst currentInstanceWork = new Map<PibblInstance, PendingInstanceWork>();\nconst nextInstanceWork = new Map<PibblInstance, PendingInstanceWork>();\nconst advanceRegistrations = new Set<AdvanceRegistration>();\nconst ADVANCE_LANE_ORDER = { animation: 0, physics: 1 } as const;\nconst beginCommands: BeginCommandRegistration[] = [];\nconst frameCompletions: PibblFrameCompletion[] = [];\nconst reactionCompletions: PibblFrameCompletion[] = [];\nconst currentRendererWorkByOwner = new Map<\n  RendererParticipantOwner,\n  Map<object, RendererParticipantWorkRegistration>\n>();\nconst nextRendererWorkByOwner = new Map<\n  RendererParticipantOwner,\n  Map<object, RendererParticipantWorkRegistration>\n>();\nconst currentRendererParticipantCompletions: RendererParticipantCompletion[] =\n  [];\nconst nextRendererParticipantCompletions: RendererParticipantCompletion[] = [];\n\nlet phase: PibblFramePhase = \"idle\";\nlet pendingHostFrame: number | undefined;\nlet currentFrame: PibblFrameSnapshot | undefined;\nlet nextFrameId = 0;\nlet nextAdvanceRegistrationOrder = 0;\nlet nextWorkRevision = 0;\nlet nextRendererWorkOrder = 0;\nlet nextRendererCompletionOrder = 0;\nlet schedulerDriver: SchedulerDriver | undefined;\nlet createdRootRegistrations = 0;\nlet releasedRootRegistrations = 0;\nlet createdBeginCommands = 0;\nlet releasedBeginCommands = 0;\nlet createdCompletionCallbacks = 0;\nlet releasedCompletionCallbacks = 0;\nlet currentFramePlanAdmissionDepth = 0;\nlet nextBeginCommandSequence = 0;\nlet currentFramePlaybackCompletions: PibblFrameCompletion[] | undefined;\nlet currentFrameCommitAcknowledgements:\n  PibblFrameCommitAcknowledgement[] | undefined;\nlet currentFrameOrderedPlaybackCompletions:\n  OrderedPlaybackCompletion[] | undefined;\nlet nextOrderedPlaybackCompletionSequence = 0;\nlet schedulerTraceCollector: PibblSchedulerTraceCollector | undefined;\nlet schedulerTraceExclusive = false;\n\nsetSignalGraphPlanWorkNotifier(syncSignalGraphPlanWork);\n\nexport function registerRootInstance(instance: PibblInstance): void {\n  if (!instance.parent && !registeredRoots.has(instance)) {\n    registeredRoots.add(instance);\n    createdRootRegistrations++;\n  }\n}\n\nexport function unregisterRootInstance(instance: PibblInstance): void {\n  if (registeredRoots.delete(instance)) {\n    releasedRootRegistrations++;\n  }\n  removeRootWork(instance);\n  cancelIdleHostFrame();\n}\n\nexport function requestInstanceRender(\n  instance: PibblInstance,\n  request: InstanceRenderRequest = {\n    pendingRoot: NO_PENDING_ROOT,\n    pendingUpdateParents: false,\n  },\n): number {\n  const revision = ++nextWorkRevision;\n  const target = shouldDeferNewFrameWork()\n    ? nextInstanceWork\n    : currentInstanceWork;\n  if (\n    target === currentInstanceWork &&\n    request.pendingRoot !== NO_PENDING_ROOT\n  ) {\n    supersedeDeferredRootPayloads(instance, revision);\n  }\n  let current: PibblInstance | undefined = instance;\n  while (current) {\n    current.requestedRenderRevision = revision;\n    mergePendingInstanceWork(target, current, {\n      firstRevision: revision,\n      revision,\n      pendingRoot: current === instance ? request.pendingRoot : NO_PENDING_ROOT,\n      pendingRootRevision:\n        current === instance && request.pendingRoot !== NO_PENDING_ROOT\n          ? revision\n          : 0,\n      pendingUpdateParents:\n        current === instance && request.pendingUpdateParents,\n    });\n    synchronizeInstancePendingState(current);\n    current = current.parent\n      ? GLOBAL_STATE.pibblInstances.get(current.parent)\n      : undefined;\n  }\n  requestHostFrameIfNeeded();\n  return revision;\n}\n\n/** Whether an instance has work that has not yet completed a successful render. */\nexport function hasPendingInstanceRender(instance: PibblInstance): boolean {\n  return (\n    instance.requestedRenderRevision > instance.completedRenderRevision &&\n    !(phase === \"render\" && nextInstanceWork.has(instance))\n  );\n}\n\nexport function registerAdvanceParticipant(\n  participant: PibblAdvanceParticipant,\n  lane: PibblAdvanceLane = \"animation\",\n  requestsFrames = true,\n): () => void {\n  const registration: AdvanceRegistration = {\n    participant,\n    lane,\n    registrationOrder: ++nextAdvanceRegistrationOrder,\n    requestsFrames,\n    active: true,\n  };\n  advanceRegistrations.add(registration);\n  requestHostFrameIfNeeded();\n  return () => {\n    if (!registration.active) return;\n    registration.active = false;\n    advanceRegistrations.delete(registration);\n    cancelIdleHostFrame();\n  };\n}\n\n/** Queues immutable, realm-ordered work for the next frozen Begin prefix. */\nexport function queueBeginCommand(\n  command: PibblBeginCommand,\n): PibblBeginCommandHandle {\n  const sequence = ++nextBeginCommandSequence;\n  const registration: BeginCommandRegistration = {\n    accepted: Object.freeze({ sequence, command }),\n    active: true,\n    owned: true,\n  };\n  beginCommands.push(registration);\n  createdBeginCommands++;\n  requestHostFrameIfNeeded();\n  return Object.freeze({\n    sequence,\n    cancel(): void {\n      if (!registration.active) return;\n      registration.active = false;\n      const index = beginCommands.indexOf(registration);\n      if (index >= 0) {\n        beginCommands.splice(index, 1);\n        releaseBeginCommand(registration);\n      }\n      cancelIdleHostFrame();\n    },\n  });\n}\n\n/** Queues scheduler-owned work for Complete in the currently advancing frame. */\nexport function queueCurrentFrameCompletion(\n  callback: PibblFrameCompletion,\n): () => void {\n  if (\n    currentFramePlaybackCompletions === undefined ||\n    (phase !== \"begin\" && phase !== \"advance\")\n  ) {\n    return queueFrameCompletion(callback);\n  }\n  currentFramePlaybackCompletions.push(callback);\n  createdCompletionCallbacks++;\n  return createFrameCompletionCancellation(callback);\n}\n\n/** Registers playback state adoption against this frame's explicit Commit outcome. */\nexport function queueCurrentFrameCommitAcknowledgement(\n  callback: PibblFrameCommitAcknowledgement,\n): () => void {\n  if (\n    currentFrameCommitAcknowledgements === undefined ||\n    (phase !== \"begin\" && phase !== \"advance\")\n  ) {\n    throw new Error(\n      \"Pibbl frame Commit acknowledgements may only be queued during Begin or Advance.\",\n    );\n  }\n  currentFrameCommitAcknowledgements.push(callback);\n  createdCompletionCallbacks++;\n  let active = true;\n  return () => {\n    if (!active) return;\n    active = false;\n    const acknowledgements = currentFrameCommitAcknowledgements;\n    const index = acknowledgements?.indexOf(callback) ?? -1;\n    if (index < 0) return;\n    acknowledgements!.splice(index, 1);\n    releasedCompletionCallbacks++;\n    cancelIdleHostFrame();\n  };\n}\n\n/** Queues one playback delivery ordered by run identity, then source insertion. */\nexport function queueCurrentFrameOrderedPlaybackCompletion(\n  registrationOrder: number,\n  callback: PibblFrameCompletion,\n): void {\n  if (currentFrameOrderedPlaybackCompletions === undefined) {\n    queueFrameCompletion(callback);\n    return;\n  }\n  currentFrameOrderedPlaybackCompletions.push({\n    registrationOrder,\n    sequence: ++nextOrderedPlaybackCompletionSequence,\n    callback,\n  });\n  createdCompletionCallbacks++;\n}\n\nexport function queueFrameCompletion(callback: PibblFrameCompletion): () => void {\n  frameCompletions.push(callback);\n  createdCompletionCallbacks++;\n  requestHostFrameIfNeeded();\n  return createFrameCompletionCancellation(callback);\n}\n\n/** Queues signal-driven imperative work for an eligible Complete phase. */\nexport function queueReactionCompletion(\n  callback: PibblFrameCompletion,\n): () => void {\n  reactionCompletions.push(callback);\n  createdCompletionCallbacks++;\n  requestHostFrameIfNeeded();\n  return createFrameCompletionCancellation(callback, reactionCompletions);\n}\n\n/** @internal Emits one immutable fact only while a source-only collector is installed. */\nexport function recordSchedulerTrace(record: PibblSchedulerTraceRecord): void {\n  const collector = schedulerTraceCollector;\n  if (collector === undefined) return;\n  try {\n    collector(Object.freeze(record));\n  } catch {\n    if (schedulerTraceCollector === collector) {\n      schedulerTraceCollector = undefined;\n      schedulerTraceExclusive = false;\n    }\n  }\n}\n\nexport function requestRendererParticipantWork(\n  owner: RendererParticipantOwner,\n  request: RendererParticipantWorkRequest,\n): void {\n  if (!owner.isActive()) return;\n  const rendererWorkByOwner = shouldDeferNewFrameWork()\n    ? nextRendererWorkByOwner\n    : currentRendererWorkByOwner;\n  let workByKey = rendererWorkByOwner.get(owner);\n  if (!workByKey) {\n    workByKey = new Map();\n    rendererWorkByOwner.set(owner, workByKey);\n  }\n  const existing = workByKey.get(request.key);\n  if (existing) {\n    existing.request = request;\n  } else {\n    workByKey.set(request.key, {\n      owner,\n      request,\n      order: ++nextRendererWorkOrder,\n    });\n  }\n  requestInstanceRender(owner.instance);\n}\n\nexport function queueRendererParticipantComplete(\n  owner: RendererParticipantOwner,\n  callback: PibblFrameCompletion,\n): void {\n  if (!owner.isActive()) return;\n  const completions = shouldDeferNewFrameWork()\n    ? nextRendererParticipantCompletions\n    : currentRendererParticipantCompletions;\n  completions.push({\n    owner,\n    callback,\n    order: ++nextRendererCompletionOrder,\n  });\n  createdCompletionCallbacks++;\n  requestHostFrameIfNeeded();\n}\n\nexport function removeRendererParticipantOwner(\n  owner: RendererParticipantOwner,\n): void {\n  currentRendererWorkByOwner.delete(owner);\n  nextRendererWorkByOwner.delete(owner);\n  for (const completions of [\n    currentRendererParticipantCompletions,\n    nextRendererParticipantCompletions,\n  ]) {\n    for (let index = completions.length - 1; index >= 0; index--) {\n      if (completions[index].owner === owner) {\n        completions.splice(index, 1);\n        releasedCompletionCallbacks++;\n      }\n    }\n  }\n  cancelIdleHostFrame();\n}\n\nexport function getCurrentFrameSnapshot(): PibblFrameSnapshot | undefined {\n  return GLOBAL_STATE.frameSnapshot ?? currentFrame;\n}\n\n/**\n * Returns a diagnostic snapshot of the shared realm scheduler without advancing it.\n *\n * @returns Current scheduler counters and pending-work state. See {@link RealmSchedulerSnapshot}.\n *\n * @see {@link ManualSchedulerDriver}\n */\nexport function snapshotRealmScheduler(): RealmSchedulerSnapshot {\n  return Object.freeze({\n    phase,\n    pendingHostFrames: pendingHostFrame === undefined ? 0 : 1,\n    registeredRoots: registeredRoots.size,\n    advanceParticipants: advanceRegistrations.size,\n    completionCallbacks:\n      frameCompletions.length +\n      reactionCompletions.length +\n      (currentFrameCommitAcknowledgements?.length ?? 0) +\n      (currentFramePlaybackCompletions?.length ?? 0) +\n      (currentFrameOrderedPlaybackCompletions?.length ?? 0) +\n      currentRendererParticipantCompletions.length +\n      nextRendererParticipantCompletions.length,\n    createdRootRegistrations,\n    releasedRootRegistrations,\n    createdBeginCommands,\n    releasedBeginCommands,\n    createdCompletionCallbacks,\n    releasedCompletionCallbacks,\n    dirtyInstances: countDirtyInstances(),\n    dirtyRoots: countDirtyRoots(),\n    registeredAdvanceParticipants: advanceRegistrations.size,\n    queuedFrameCompletions: frameCompletions.length,\n    queuedReactionCompletions: reactionCompletions.length,\n    queuedBeginCommands: beginCommands.length,\n    currentFrame,\n  });\n}\n\nexport function installSchedulerDriverForTest(\n  driver: SchedulerDriver,\n): () => void {\n  if (pendingHostFrame !== undefined || phase !== \"idle\") {\n    throw new Error(\n      \"Cannot replace the Pibbl scheduler driver while a frame is active.\",\n    );\n  }\n  const previous = schedulerDriver;\n  schedulerDriver = driver;\n  return () => {\n    if (pendingHostFrame !== undefined || phase !== \"idle\") {\n      throw new Error(\n        \"Cannot restore the Pibbl scheduler driver while a frame is active.\",\n      );\n    }\n    schedulerDriver = previous;\n  };\n}\n\n/** @internal Test/diagnostic seam; production retains no trace history. */\nexport function installSchedulerTraceCollectorForTest(\n  collector: PibblSchedulerTraceCollector,\n  exclusive = false,\n): () => void {\n  if (schedulerTraceExclusive || (exclusive && schedulerTraceCollector !== undefined)) {\n    throw new Error('Scheduler trace collector is already owned.');\n  }\n  const previous = schedulerTraceCollector;\n  schedulerTraceCollector = collector;\n  schedulerTraceExclusive = exclusive;\n  return () => {\n    if (schedulerTraceCollector === collector) {\n      schedulerTraceCollector = previous;\n      schedulerTraceExclusive = false;\n    }\n  };\n}\n\nfunction requestHostFrameIfNeeded(): void {\n  if (pendingHostFrame !== undefined || phase !== \"idle\" || !hasFrameWork()) {\n    return;\n  }\n  const driver = getSchedulerDriver();\n  pendingHostFrame = driver.requestFrame(runFrame);\n}\n\nfunction runFrame(hostTime: number): void {\n  pendingHostFrame = undefined;\n  const snapshot = Object.freeze({\n    frameId: ++nextFrameId,\n    hostTime,\n    logicalTime: hostTime,\n  });\n  currentFrame = snapshot;\n  const errors: unknown[] = [];\n  const transactions: Array<{\n    root: PibblInstance;\n    transaction: RootTransaction;\n    success: boolean;\n  }> = [];\n\n  phase = \"begin\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, phase, ...snapshot });\n  let rootJobs = captureRootJobs();\n  const commands = beginCommands.splice(0);\n  const completions = frameCompletions.splice(0);\n  const batch = createSignalCommitBatch();\n  currentFramePlaybackCompletions = [];\n  currentFrameCommitAcknowledgements = [];\n  currentFrameOrderedPlaybackCompletions = [];\n  for (const registration of commands) {\n    if (!registration.active) {\n      releaseBeginCommand(registration);\n      continue;\n    }\n    registration.active = false;\n    const { command, sequence } = registration.accepted;\n    try {\n      command(snapshot, batch, sequence);\n    } catch (error) {\n      batch.discardWriter(command);\n      errors.push(error);\n    } finally {\n      releaseBeginCommand(registration);\n    }\n  }\n  const registrations = Object.freeze(\n    Array.from(advanceRegistrations).sort(\n      (a, b) =>\n        ADVANCE_LANE_ORDER[a.lane] - ADVANCE_LANE_ORDER[b.lane] ||\n        a.registrationOrder - b.registrationOrder,\n    ),\n  );\n\n  phase = \"advance\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, phase, ...snapshot });\n  for (const registration of registrations) {\n    if (!registration.active) continue;\n    const { participant } = registration;\n    try {\n      withDirectSignalWriteForbidden(\n        \"Cannot write to a signal directly during Pibbl scheduler Advance; stage it through the provided batch.\",\n        () => participant(snapshot, batch),\n      );\n    } catch (error) {\n      batch.discardWriter(participant);\n      errors.push(error);\n    }\n  }\n\n  phase = \"commit\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, phase, ...snapshot });\n  let commitApplied = false;\n  try {\n    withCurrentFramePlanAdmission(() =>\n      batch.commit(() => {\n        commitApplied = true;\n      }),\n    );\n  } catch (error) {\n    errors.push(error);\n  }\n  const commitAcknowledgements = currentFrameCommitAcknowledgements;\n  currentFrameCommitAcknowledgements = undefined;\n  const commitOutcome = Object.freeze({ applied: commitApplied });\n  for (const acknowledgement of commitAcknowledgements) {\n    try {\n      acknowledgement(snapshot, commitOutcome);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      releasedCompletionCallbacks++;\n    }\n  }\n\n  phase = \"plan\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, commitApplied, phase, ...snapshot });\n  try {\n    withCurrentFramePlanAdmission(flushPendingComputedValidations);\n  } catch (error) {\n    errors.push(error);\n  }\n  rootJobs = mergeRootJobs(rootJobs, captureRootJobs());\n  const executableInstances = new Set(\n    rootJobs.flatMap((rootJob) =>\n      rootJob.instances.map((instanceJob) => instanceJob.instance),\n    ),\n  );\n  const blockedRendererOwners = new Set<RendererParticipantOwner>();\n  const rendererWork = captureRendererParticipantWork(\n    executableInstances,\n    blockedRendererOwners,\n  );\n  const rendererCompletions = captureRendererParticipantCompletions(\n    blockedRendererOwners,\n  );\n  const retryRendererOwners = new Set<RendererParticipantOwner>();\n\n  phase = \"render\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, commitApplied, phase, ...snapshot });\n  for (const rootJob of rootJobs) {\n    if (\n      !registeredRoots.has(rootJob.root) ||\n      rootJob.root.mainTeardowns.closed\n    ) {\n      continue;\n    }\n    const transaction = createRootTransaction();\n    const transactionRecord = {\n      root: rootJob.root,\n      transaction,\n      success: false,\n    };\n    transactions.push(transactionRecord);\n    rootJob.root.eventRoot.renderTransaction = transaction;\n    let failedInstance: PibblInstance | undefined;\n    let rendererFailed = false;\n    try {\n      for (let jobIndex = 0; jobIndex < rootJob.instances.length; jobIndex++) {\n        const job = rootJob.instances[jobIndex];\n        if (job.instance.mainTeardowns.closed) continue;\n        const participantWork = rendererWork.get(job.instance);\n        const resourceFailures = runRendererParticipantStage(\n          participantWork,\n          \"resource\",\n          snapshot,\n        );\n        if (resourceFailures.length > 0) {\n          restoreRendererParticipantFailure(\n            rootJob,\n            rendererWork,\n            jobIndex,\n            retryRendererOwners,\n          );\n          errors.push(...resourceFailures);\n          rendererFailed = true;\n          break;\n        }\n        const drawFailures = runRendererParticipantStage(\n          participantWork,\n          \"draw\",\n          snapshot,\n        );\n        if (drawFailures.length > 0) {\n          restoreRendererParticipantFailure(\n            rootJob,\n            rendererWork,\n            jobIndex,\n            retryRendererOwners,\n          );\n          errors.push(...drawFailures);\n          rendererFailed = true;\n          break;\n        }\n        try {\n          executeRender(\n            job.instance.canvas,\n            snapshot.logicalTime,\n            job.pendingRoot,\n            false,\n            snapshot,\n          );\n          const composeFailures = runRendererParticipantStage(\n            participantWork,\n            \"compose\",\n            snapshot,\n          );\n          if (composeFailures.length > 0) {\n            restoreRendererParticipantFailure(\n              rootJob,\n              rendererWork,\n              jobIndex,\n              retryRendererOwners,\n            );\n            errors.push(...composeFailures);\n            rendererFailed = true;\n            break;\n          }\n        } catch (error) {\n          failedInstance = job.instance;\n          throw error;\n        }\n        completeInstanceRenderRevision(job.instance, job.revision);\n      }\n      transactionRecord.success = !rendererFailed;\n    } catch (error) {\n      if (failedInstance && failedInstance !== rootJob.root) {\n        restoreRootJob(rootJob);\n      }\n      errors.push(error);\n    }\n  }\n\n  phase = \"complete\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, commitApplied, phase, ...snapshot });\n  const reactions = reactionCompletions.splice(0);\n  for (const record of transactions) {\n    try {\n      record.transaction.finish(record.success);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      if (record.root.eventRoot.renderTransaction === record.transaction) {\n        record.root.eventRoot.renderTransaction = undefined;\n      }\n    }\n  }\n  for (const reaction of reactions) {\n    try {\n      reaction(snapshot);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      releasedCompletionCallbacks++;\n    }\n  }\n  for (const completion of completions) {\n    try {\n      completion(snapshot);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      releasedCompletionCallbacks++;\n    }\n  }\n  const playbackCompletions = currentFramePlaybackCompletions;\n  for (const completion of playbackCompletions) {\n    try {\n      completion(snapshot);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      releasedCompletionCallbacks++;\n    }\n  }\n  currentFramePlaybackCompletions = undefined;\n  const orderedPlaybackCompletions = currentFrameOrderedPlaybackCompletions;\n  currentFrameOrderedPlaybackCompletions = undefined;\n  orderedPlaybackCompletions.sort(\n    (left, right) =>\n      left.registrationOrder - right.registrationOrder ||\n      left.sequence - right.sequence,\n  );\n  for (const completion of orderedPlaybackCompletions) {\n    try {\n      completion.callback(snapshot);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      releasedCompletionCallbacks++;\n    }\n  }\n  for (const completion of rendererCompletions) {\n    if (!completion.owner.isActive()) {\n      releasedCompletionCallbacks++;\n      continue;\n    }\n    if (retryRendererOwners.has(completion.owner)) {\n      nextRendererParticipantCompletions.push(completion);\n      continue;\n    }\n    try {\n      completion.callback(snapshot);\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      releasedCompletionCallbacks++;\n    }\n  }\n  batch.clear();\n  currentFrame = undefined;\n  phase = \"idle\";\n  if (schedulerTraceCollector) recordSchedulerTrace({ kind: 'scheduler-phase', collectedErrors: errors.length, commitApplied, phase, ...snapshot, errorCount: errors.length });\n  promoteNextFrameWork();\n  requestHostFrameIfNeeded();\n  throwCollectedErrors(errors);\n}\n\nfunction releaseBeginCommand(registration: BeginCommandRegistration): void {\n  if (!registration.owned) return;\n  registration.owned = false;\n  releasedBeginCommands++;\n}\n\nfunction createFrameCompletionCancellation(\n  callback: PibblFrameCompletion,\n  ownedCompletions?: PibblFrameCompletion[],\n): () => void {\n  let active = true;\n  return () => {\n    if (!active) return;\n    active = false;\n    for (const completions of ownedCompletions === undefined\n      ? [frameCompletions, currentFramePlaybackCompletions]\n      : [ownedCompletions]) {\n      const index = completions?.indexOf(callback) ?? -1;\n      if (index < 0) continue;\n      completions!.splice(index, 1);\n      releasedCompletionCallbacks++;\n      cancelIdleHostFrame();\n      return;\n    }\n  };\n}\n\nfunction captureRootJobs(): RootRenderJob[] {\n  const requested = Array.from(currentInstanceWork);\n  currentInstanceWork.clear();\n  const jobsByRoot = new Map<PibblInstance, InstanceRenderJob[]>();\n  for (const [instance, work] of requested) {\n    synchronizeInstancePendingState(instance);\n    if (instance.mainTeardowns.closed) continue;\n    const root = findRoot(instance);\n    if (!root || !registeredRoots.has(root)) continue;\n    const jobs = jobsByRoot.get(root) ?? [];\n    jobs.push({\n      instance,\n      firstRevision: work.firstRevision,\n      revision: work.revision,\n      pendingRoot: work.pendingRoot,\n      pendingRootRevision: work.pendingRootRevision,\n      pendingUpdateParents: work.pendingUpdateParents,\n    });\n    jobsByRoot.set(root, jobs);\n  }\n\n  const result: RootRenderJob[] = [];\n  for (const root of registeredRoots) {\n    const jobs = jobsByRoot.get(root);\n    if (!jobs) continue;\n    jobs.sort(\n      (left, right) =>\n        instanceDepth(right.instance) - instanceDepth(left.instance),\n    );\n    result.push({ root, instances: jobs });\n  }\n  return result;\n}\n\nfunction mergeRootJobs(\n  initial: RootRenderJob[],\n  planned: RootRenderJob[],\n): RootRenderJob[] {\n  const plannedByRoot = new Map(\n    planned.map((job) => [job.root, job.instances]),\n  );\n  const merged: RootRenderJob[] = [];\n  for (const root of registeredRoots) {\n    const initialJob = initial.find((job) => job.root === root);\n    const plannedInstances = plannedByRoot.get(root);\n    if (!initialJob && !plannedInstances) continue;\n    const byInstance = new Map<PibblInstance, InstanceRenderJob>();\n    for (const job of initialJob?.instances ?? []) {\n      byInstance.set(job.instance, job);\n    }\n    for (const job of plannedInstances ?? []) {\n      const existing = byInstance.get(job.instance);\n      byInstance.set(\n        job.instance,\n        existing\n          ? {\n              instance: job.instance,\n              firstRevision: Math.min(\n                existing.firstRevision,\n                job.firstRevision,\n              ),\n              revision: Math.max(existing.revision, job.revision),\n              pendingRoot:\n                job.pendingRootRevision > existing.pendingRootRevision\n                  ? job.pendingRoot\n                  : existing.pendingRoot,\n              pendingRootRevision: Math.max(\n                existing.pendingRootRevision,\n                job.pendingRootRevision,\n              ),\n              pendingUpdateParents:\n                existing.pendingUpdateParents || job.pendingUpdateParents,\n            }\n          : job,\n      );\n    }\n    const instances = Array.from(byInstance.values());\n    instances.sort(\n      (left, right) =>\n        instanceDepth(right.instance) - instanceDepth(left.instance),\n    );\n    merged.push({ root, instances });\n  }\n  return merged;\n}\n\nfunction findRoot(instance: PibblInstance): PibblInstance | undefined {\n  let current: PibblInstance | undefined = instance;\n  while (current?.parent) {\n    current = GLOBAL_STATE.pibblInstances.get(current.parent);\n  }\n  return current;\n}\n\nfunction supersedeDeferredRootPayloads(\n  ancestor: PibblInstance,\n  revision: number,\n): void {\n  for (const [instance, deferred] of nextInstanceWork) {\n    if (\n      deferred.pendingRootRevision > 0 &&\n      deferred.pendingRootRevision < revision &&\n      isInstanceWithin(instance, ancestor)\n    ) {\n      // A later sanctioned ancestor root owns the retained subtree. Preserve\n      // the older revision/composition job, but never let its obsolete root\n      // payload overwrite the newer tree in the following frame.\n      deferred.pendingRoot = NO_PENDING_ROOT;\n      deferred.pendingRootRevision = 0;\n      synchronizeInstancePendingState(instance);\n    }\n  }\n}\n\nfunction isInstanceWithin(\n  instance: PibblInstance,\n  ancestor: PibblInstance,\n): boolean {\n  let current: PibblInstance | undefined = instance;\n  while (current) {\n    if (current === ancestor) return true;\n    current = current.parent\n      ? GLOBAL_STATE.pibblInstances.get(current.parent)\n      : undefined;\n  }\n  return false;\n}\n\nfunction restoreRootJob(rootJob: RootRenderJob): void {\n  if (!registeredRoots.has(rootJob.root) || rootJob.root.mainTeardowns.closed) {\n    return;\n  }\n  for (const job of rootJob.instances) {\n    const { instance } = job;\n    if (\n      instance.mainTeardowns.closed ||\n      GLOBAL_STATE.pibblInstances.get(instance.canvas) !== instance\n    ) {\n      continue;\n    }\n    mergePendingInstanceWork(nextInstanceWork, instance, job);\n    synchronizeInstancePendingState(instance);\n  }\n}\n\nfunction instanceDepth(instance: PibblInstance): number {\n  let depth = 0;\n  let current: PibblInstance | undefined = instance;\n  while (current?.parent) {\n    depth++;\n    current = GLOBAL_STATE.pibblInstances.get(current.parent);\n  }\n  return depth;\n}\n\nfunction removeRootWork(root: PibblInstance): void {\n  for (const workByInstance of [currentInstanceWork, nextInstanceWork]) {\n    for (const instance of workByInstance.keys()) {\n      if (findRoot(instance) === root) {\n        workByInstance.delete(instance);\n        synchronizeInstancePendingState(instance);\n      }\n    }\n  }\n}\n\nfunction countDirtyRoots(): number {\n  const roots = new Set<PibblInstance>();\n  for (const workByInstance of [currentInstanceWork, nextInstanceWork]) {\n    for (const instance of workByInstance.keys()) {\n      const root = findRoot(instance);\n      if (root && registeredRoots.has(root)) roots.add(root);\n    }\n  }\n  return roots.size;\n}\n\nfunction countDirtyInstances(): number {\n  return new Set([...currentInstanceWork.keys(), ...nextInstanceWork.keys()])\n    .size;\n}\n\nfunction hasActiveAdvanceParticipant(): boolean {\n  for (const registration of advanceRegistrations)\n    if (registration.requestsFrames) return true;\n  return false;\n}\n\nfunction hasFrameWork(): boolean {\n  return (\n    currentInstanceWork.size > 0 ||\n    nextInstanceWork.size > 0 ||\n    hasPendingComputedValidations() ||\n    beginCommands.length > 0 ||\n    hasActiveAdvanceParticipant() ||\n    frameCompletions.length > 0 ||\n    reactionCompletions.length > 0 ||\n    currentRendererWorkByOwner.size > 0 ||\n    nextRendererWorkByOwner.size > 0 ||\n    currentRendererParticipantCompletions.length > 0 ||\n    nextRendererParticipantCompletions.length > 0\n  );\n}\n\nfunction captureRendererParticipantWork(\n  executableInstances: ReadonlySet<PibblInstance>,\n  blockedOwners: Set<RendererParticipantOwner>,\n): Map<PibblInstance, RendererParticipantWorkRegistration[]> {\n  const byInstance = new Map<\n    PibblInstance,\n    RendererParticipantWorkRegistration[]\n  >();\n  for (const [owner, workByKey] of currentRendererWorkByOwner) {\n    if (!owner.isActive()) {\n      currentRendererWorkByOwner.delete(owner);\n      continue;\n    }\n    if (!executableInstances.has(owner.instance)) {\n      blockedOwners.add(owner);\n      continue;\n    }\n    const work = byInstance.get(owner.instance) ?? [];\n    for (const registration of workByKey.values()) {\n      work.push(registration);\n    }\n    currentRendererWorkByOwner.delete(owner);\n    if (work.length > 0) byInstance.set(owner.instance, work);\n  }\n  const kindOrder = { resource: 0, draw: 1, compose: 2 } as const;\n  for (const work of byInstance.values()) {\n    work.sort(\n      (left, right) =>\n        kindOrder[left.request.kind] - kindOrder[right.request.kind] ||\n        left.order - right.order,\n    );\n  }\n  return byInstance;\n}\n\nfunction captureRendererParticipantCompletions(\n  blockedOwners: ReadonlySet<RendererParticipantOwner>,\n): RendererParticipantCompletion[] {\n  const captured: RendererParticipantCompletion[] = [];\n  for (let index = 0; index < currentRendererParticipantCompletions.length;) {\n    const completion = currentRendererParticipantCompletions[index];\n    if (blockedOwners.has(completion.owner)) {\n      index++;\n      continue;\n    }\n    currentRendererParticipantCompletions.splice(index, 1);\n    captured.push(completion);\n  }\n  captured.sort((left, right) => left.order - right.order);\n  return captured;\n}\n\nfunction runRendererParticipantStage(\n  work: RendererParticipantWorkRegistration[] | undefined,\n  kind: RendererParticipantWorkRequest[\"kind\"],\n  snapshot: PibblFrameSnapshot,\n): unknown[] {\n  const errors: unknown[] = [];\n  if (!work) return errors;\n  for (const registration of work) {\n    if (registration.request.kind !== kind || !registration.owner.isActive()) {\n      continue;\n    }\n    try {\n      registration.request.run(snapshot);\n    } catch (error) {\n      errors.push(error);\n    }\n  }\n  return errors;\n}\n\nfunction restoreRendererParticipantFailure(\n  rootJob: RootRenderJob,\n  rendererWork: Map<PibblInstance, RendererParticipantWorkRegistration[]>,\n  failedJobIndex: number,\n  retryOwners: Set<RendererParticipantOwner>,\n): void {\n  restoreRootJob(rootJob);\n  const ownersToRequest = new Set<RendererParticipantOwner>();\n  for (\n    let jobIndex = failedJobIndex;\n    jobIndex < rootJob.instances.length;\n    jobIndex++\n  ) {\n    const work = rendererWork.get(rootJob.instances[jobIndex].instance);\n    if (!work) continue;\n    for (const registration of work) {\n      const { owner, request } = registration;\n      if (!owner.isActive()) continue;\n      let workByKey = nextRendererWorkByOwner.get(owner);\n      if (!workByKey) {\n        workByKey = new Map();\n        nextRendererWorkByOwner.set(owner, workByKey);\n      }\n      if (!workByKey.has(request.key)) {\n        workByKey.set(request.key, registration);\n      }\n      ownersToRequest.add(owner);\n      retryOwners.add(owner);\n    }\n  }\n  for (const owner of ownersToRequest) {\n    requestInstanceRender(owner.instance);\n  }\n}\n\nfunction mergePendingInstanceWork(\n  target: Map<PibblInstance, PendingInstanceWork>,\n  instance: PibblInstance,\n  incoming: PendingInstanceWork,\n): void {\n  const existing = target.get(instance);\n  if (!existing) {\n    target.set(instance, { ...incoming });\n    return;\n  }\n  existing.firstRevision = Math.min(\n    existing.firstRevision,\n    incoming.firstRevision,\n  );\n  existing.revision = Math.max(existing.revision, incoming.revision);\n  if (incoming.pendingRootRevision > existing.pendingRootRevision) {\n    existing.pendingRoot = incoming.pendingRoot;\n    existing.pendingRootRevision = incoming.pendingRootRevision;\n  }\n  existing.pendingUpdateParents ||= incoming.pendingUpdateParents;\n}\n\nfunction synchronizeInstancePendingState(instance: PibblInstance): void {\n  const current = currentInstanceWork.get(instance);\n  const next = nextInstanceWork.get(instance);\n  const rootSource = !current\n    ? next\n    : !next\n      ? current\n      : current.pendingRootRevision >= next.pendingRootRevision\n        ? current\n        : next;\n  instance.pendingRoot = rootSource ? rootSource.pendingRoot : NO_PENDING_ROOT;\n  instance.pendingUpdateParents = Boolean(\n    current?.pendingUpdateParents || next?.pendingUpdateParents,\n  );\n}\n\nexport function completeInstanceRenderRevision(\n  instance: PibblInstance,\n  revision: number,\n): void {\n  const pendingFirstRevisions = [\n    currentInstanceWork.get(instance)?.firstRevision,\n    nextInstanceWork.get(instance)?.firstRevision,\n  ].filter((value): value is number => value !== undefined);\n  if (pendingFirstRevisions.length === 0) {\n    instance.completedRenderRevision = instance.requestedRenderRevision;\n    return;\n  }\n  // Revisions are global request order. Do not advance across an older hole\n  // that was deferred before newer Commit/Plan work joined this frame.\n  if (Math.min(...pendingFirstRevisions) > revision) {\n    instance.completedRenderRevision = Math.max(\n      instance.completedRenderRevision,\n      revision,\n    );\n  }\n}\n\nfunction promoteNextFrameWork(): void {\n  const pendingInstances = new Set<PibblInstance>();\n  for (const [instance, work] of nextInstanceWork) {\n    mergePendingInstanceWork(currentInstanceWork, instance, work);\n    pendingInstances.add(instance);\n  }\n  nextInstanceWork.clear();\n  for (const instance of pendingInstances) {\n    synchronizeInstancePendingState(instance);\n  }\n\n  for (const [owner, nextWorkByKey] of nextRendererWorkByOwner) {\n    let currentWorkByKey = currentRendererWorkByOwner.get(owner);\n    if (!currentWorkByKey) {\n      currentWorkByKey = new Map();\n      currentRendererWorkByOwner.set(owner, currentWorkByKey);\n    }\n    for (const [key, registration] of nextWorkByKey) {\n      const existing = currentWorkByKey.get(key);\n      if (existing) {\n        existing.request = registration.request;\n      } else {\n        currentWorkByKey.set(key, registration);\n      }\n    }\n  }\n  nextRendererWorkByOwner.clear();\n\n  currentRendererParticipantCompletions.push(\n    ...nextRendererParticipantCompletions,\n  );\n  currentRendererParticipantCompletions.sort(\n    (left, right) => left.order - right.order,\n  );\n  nextRendererParticipantCompletions.length = 0;\n}\n\nfunction cancelIdleHostFrame(): void {\n  if (pendingHostFrame === undefined || hasFrameWork()) return;\n  const frame = pendingHostFrame;\n  pendingHostFrame = undefined;\n  runTeardown(() => getSchedulerDriver().cancelFrame(frame));\n}\n\nfunction syncSignalGraphPlanWork(): void {\n  if (hasPendingComputedValidations()) {\n    requestHostFrameIfNeeded();\n  } else {\n    cancelIdleHostFrame();\n  }\n}\n\nfunction withCurrentFramePlanAdmission<T>(callback: () => T): T {\n  currentFramePlanAdmissionDepth++;\n  try {\n    return callback();\n  } finally {\n    currentFramePlanAdmissionDepth--;\n  }\n}\n\nfunction shouldDeferNewFrameWork(): boolean {\n  return (\n    phase !== \"idle\" &&\n    phase !== \"begin\" &&\n    currentFramePlanAdmissionDepth === 0\n  );\n}\n\nfunction getSchedulerDriver(): SchedulerDriver {\n  return (\n    schedulerDriver ?? {\n      requestFrame: (callback) => globalThis.requestAnimationFrame(callback),\n      cancelFrame: (frameId) => globalThis.cancelAnimationFrame(frameId),\n    }\n  );\n}\n\nfunction createRootTransaction(): RootTransaction {\n  return new RootRenderTransaction();\n}\n\nfunction throwCollectedErrors(errors: unknown[]): void {\n  if (errors.length === 1) throw errors[0];\n  if (errors.length > 1) {\n    throw new AggregateError(errors, \"Multiple Pibbl frame operations failed.\");\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/scheduler/renderer-participant.d.ts

@@ -0,0 +1,257 @@
+import type { pibblInternalQueueSimulationBegin } from "./simulation-participant.js";
+import type { WritableSignal } from '../signals/types.js';
+import type { PibblEventHandlers, PibblEventTargetOptions, PibblEventTargetSnapshot, PibblPointerEvents } from '../events/types.js';
+declare const internalRenderOwnerBrand: unique symbol;
+/**
+ * Opaque ownership identity for renderer scheduling and cleanup.
+ *
+ * @see {@link pibblInternalCreateSignalConsumer}
+ * @see {@link pibblInternalCurrentRenderOwner}
+ * @see {@link pibblInternalOnRenderFinish}
+ */
+export interface PibblInternalRenderOwner {
+    readonly [internalRenderOwnerBrand]: true;
+}
+/**
+ * Shared scheduler frame identity, logical timing, and admission context.
+ *
+ * @see {@link pibblInternalCurrentFrame}
+ * @see {@link pibblInternalQueueBegin}
+ * @see {@link pibblInternalQueueComplete}
+ */
+export interface PibblInternalFrame {
+    /** Identifier of the shared scheduler frame. See {@link PibblInternalFrame}. */
+    readonly frameId: number;
+    /** Logical scheduler time in milliseconds. See {@link PibblInternalFrame}. */
+    readonly logicalTime: number;
+}
+/**
+ * Staged signal writes published together during scheduler Commit.
+ *
+ * @see {@link WritableSignal}
+ * @see {@link pibblInternalQueueBegin}
+ * @see {@link pibblInternalRegisterAdvance}
+ * @see {@link pibblInternalQueueSimulationBegin}
+ */
+export interface PibblInternalSignalBatch {
+    /**
+     * Reads the current committed values required by this integration. See
+     * {@link PibblInternalSignalBatch}.
+     * @param signal - Signal whose staged or committed value should be read. See
+     * {@link WritableSignal} .
+     * @returns The current batch value, falling back to the committed signal value.
+     */
+    read<T>(signal: WritableSignal<T>): T;
+    /**
+     * Stages a signal write for publication during Commit. See {@link PibblInternalSignalBatch}.
+     * @param signal - Signal that will receive the value during Commit. See {@link WritableSignal}.
+     * @param value - Value to stage.
+     * @param writer - Identity used to attribute and discard staged writes.
+     */
+    stage<T>(signal: WritableSignal<T>, value: T, writer: object): void;
+    /**
+     * Discards writes belonging to the specified writer. See {@link PibblInternalSignalBatch}.
+     * @param writer - Writer identity whose pending writes should be discarded.
+     */
+    discardWriter(writer: object): void;
+}
+/**
+ * Sequence identity and cancellation capability for a queued scheduler command.
+ *
+ * @see {@link pibblInternalQueueBegin}
+ */
+export interface PibblInternalCommandHandle {
+    /**
+     * Sequence number assigned when the scheduler command is queued. See
+     * {@link PibblInternalCommandHandle}.
+     */
+    readonly sequence: number;
+    /**
+     * Cancels this queued command before it is admitted by the scheduler. See
+     * {@link PibblInternalCommandHandle}.
+     */
+    cancel(): void;
+}
+/**
+ * Ordered renderer stages around one owning Canvas instance traversal.
+ * Every active callback in a stage runs in registration order. If one or more
+ * callbacks fail, their errors are reported in that order, later dependent
+ * stages are skipped, the root transaction fails, the instance revision stays
+ * incomplete, and the failed batch plus unexecuted batches later in the same
+ * root are retried on the next realm frame. Complete callbacks for those
+ * retried owners are deferred until a successful frame. Other owners and roots
+ * still complete normally.
+ *
+ * @see {@link pibblInternalRequestRendererWork}
+ */
+export type PibblInternalRendererWorkKind = 'resource' | 'draw' | 'compose';
+/**
+ * Dependency tracking and disposal operations for an integration-owned signal consumer.
+ *
+ * @see {@link pibblInternalCreateSignalConsumer}
+ */
+export interface PibblInternalSignalConsumer {
+    /**
+     * Evaluates a callback while collecting signal dependencies for this consumer. See
+     * {@link PibblInternalSignalConsumer}.
+     * @param read - Synchronous computation whose signal dependencies are collected.
+     * @returns The computation's return value.
+     */
+    collect<T>(read: () => T): T;
+    /**
+     * Acknowledges the consumer's current invalidation as processed. See
+     * {@link PibblInternalSignalConsumer}.
+     */
+    markClean(): void;
+    /** Releases resources owned by this mounted object. See {@link PibblInternalSignalConsumer}. */
+    dispose(): void;
+}
+/**
+ * Returns the active render owner required by official integration scheduling operations.
+ *
+ * @returns The render owner for the current runtime context. See {@link PibblInternalRenderOwner}.
+ *
+ * @see {@link PibblInternalRenderOwner}
+ */
+export declare function pibblInternalCurrentRenderOwner(): PibblInternalRenderOwner;
+/**
+ * Creates an owner-scoped dependency consumer for an official renderer integration.
+ *
+ * @param options - Render owner, optional diagnostic name, and invalidation callback. See
+ * {@link PibblInternalRenderOwner} .
+ * @returns A consumer that tracks signal dependencies and owns their cleanup. See
+ * {@link PibblInternalSignalConsumer} .
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalSignalConsumer}
+ */
+export declare function pibblInternalCreateSignalConsumer(options: {
+    owner: PibblInternalRenderOwner;
+    debugName?: string;
+    invalidate(): void;
+}): PibblInternalSignalConsumer;
+/**
+ * Requests keyed renderer work in the shared scheduler without creating a second frame loop.
+ *
+ * @param owner - Owner whose renderer work is being requested. See {@link PibblInternalRenderOwner}.
+ * @param request - Work identity, renderer category, and frame callback. See
+ * {@link PibblInternalRendererWorkKind} , {@link PibblInternalFrame} .
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalRendererWorkKind}
+ * @see {@link PibblInternalFrame}
+ */
+export declare function pibblInternalRequestRendererWork(owner: PibblInternalRenderOwner, request: {
+    key: object;
+    kind: PibblInternalRendererWorkKind;
+    run(frame: PibblInternalFrame): void;
+}): void;
+/**
+ * Rejects commands issued from runtime evaluation contexts that forbid mutation.
+ *
+ * @see {@link pibblInternalQueueBegin}
+ */
+export declare function pibblInternalAssertCommandAllowed(): void;
+/**
+ * Queues an owner-scoped Begin command and returns a cancellation handle.
+ *
+ * @param owner - Owner admitting the command. See {@link PibblInternalRenderOwner}.
+ * @param callback - Begin-phase callback receiving frame, staged writes, and command sequence. See
+ * {@link PibblInternalFrame} , {@link PibblInternalSignalBatch} .
+ * @returns A handle that can cancel the queued command. See {@link PibblInternalCommandHandle}.
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalFrame}
+ * @see {@link PibblInternalSignalBatch}
+ * @see {@link PibblInternalCommandHandle}
+ */
+export declare function pibblInternalQueueBegin(owner: PibblInternalRenderOwner, callback: (frame: PibblInternalFrame, batch: PibblInternalSignalBatch, sequence: number) => void): PibblInternalCommandHandle;
+/**
+ * Registers renderer work for shared-frame Advance and returns its unregister callback.
+ *
+ * @param owner - Owner of the advancing work. See {@link PibblInternalRenderOwner}.
+ * @param callback - Advance callback receiving the frame and staged signal writes. See
+ * {@link PibblInternalFrame} , {@link PibblInternalSignalBatch} .
+ * @returns A function unregistering the Advance callback.
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalFrame}
+ * @see {@link PibblInternalSignalBatch}
+ */
+export declare function pibblInternalRegisterAdvance(owner: PibblInternalRenderOwner, callback: (frame: PibblInternalFrame, batch: PibblInternalSignalBatch) => void): () => void;
+/**
+ * Registers acknowledgement of the current frame's committed staged writes.
+ *
+ * @param owner - Owner of the pending commit. See {@link PibblInternalRenderOwner}.
+ * @param callback - Callback receiving the frame and whether the commit was applied. See
+ * {@link PibblInternalFrame} .
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalFrame}
+ */
+export declare function pibblInternalQueueCurrentCommit(owner: PibblInternalRenderOwner, callback: (frame: PibblInternalFrame, outcome: Readonly<{
+    applied: boolean;
+}>) => void): void;
+/**
+ * Queues an owner-scoped completion callback in the current scheduler transaction.
+ *
+ * @param owner - Owner of the completion work. See {@link PibblInternalRenderOwner}.
+ * @param callback - Callback invoked during Complete with the shared frame. See
+ * {@link PibblInternalFrame} .
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalFrame}
+ */
+export declare function pibblInternalQueueCurrentComplete(owner: PibblInternalRenderOwner, callback: (frame: PibblInternalFrame) => void): void;
+/**
+ * Marks the owning renderer dirty and requests shared scheduler work.
+ *
+ * @param owner - Owner whose renderer should become dirty. See {@link PibblInternalRenderOwner}.
+ *
+ * @see {@link PibblInternalRenderOwner}
+ */
+export declare function pibblInternalRequestRender(owner: PibblInternalRenderOwner): void;
+/**
+ * Registers a callback reporting the outcome of the owner's render transaction.
+ *
+ * @param owner - Owner of the rendering transaction. See {@link PibblInternalRenderOwner}.
+ * @param callback - Callback receiving whether the transaction succeeded.
+ *
+ * @see {@link PibblInternalRenderOwner}
+ */
+export declare function pibblInternalOnRenderFinish(owner: PibblInternalRenderOwner, callback: (success: boolean) => void): void;
+/**
+ * Registers one painted logical target with its handlers, geometry, and participation policy.
+ *
+ * @param handlers - Handlers for the painted target. See {@link PibblEventHandlers}.
+ * @param options - Hit geometry and focus metadata. See {@link PibblEventTargetOptions}.
+ * @param pointerEvents - Pointer participation policy; defaults to auto. See
+ * {@link PibblPointerEvents} .
+ * @returns The painted event target snapshot. See {@link PibblEventTargetSnapshot}.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link PibblEventTargetOptions}
+ * @see {@link PibblPointerEvents}
+ * @see {@link PibblEventTargetSnapshot}
+ */
+export declare function pibblInternalPaintTarget(handlers: PibblEventHandlers, options: PibblEventTargetOptions, pointerEvents?: PibblPointerEvents): PibblEventTargetSnapshot;
+/**
+ * Returns timing and phase information for the current shared scheduler frame.
+ *
+ * @returns The shared scheduler frame for the active phase. See {@link PibblInternalFrame}.
+ *
+ * @see {@link PibblInternalFrame}
+ */
+export declare function pibblInternalCurrentFrame(): PibblInternalFrame;
+/**
+ * Queues an owner-scoped callback for a scheduler Complete phase.
+ *
+ * @param owner - Owner of the completion work. See {@link PibblInternalRenderOwner}.
+ * @param callback - Callback invoked during Complete with the shared frame. See
+ * {@link PibblInternalFrame} .
+ *
+ * @see {@link PibblInternalRenderOwner}
+ * @see {@link PibblInternalFrame}
+ */
+export declare function pibblInternalQueueComplete(owner: PibblInternalRenderOwner, callback: (frame: PibblInternalFrame) => void): void;
+export {};

package/dist/lib/scheduler/renderer-participant.js

@@ -0,0 +1,216 @@
+import {
+  GLOBAL_STATE
+} from "../global-state.js";
+import {
+  collectSignalReads,
+  createSignalRenderConsumer,
+  disposeSignalRenderConsumer
+} from "../signals/render-consumer.js";
+import {
+  assertSignalCommandAllowed
+} from "../signals/graph.js";
+import { usePaintTarget } from "../hooks/use-paint-target.js";
+import {
+  getCurrentFrameSnapshot,
+  queueBeginCommand,
+  queueCurrentFrameCommitAcknowledgement,
+  queueCurrentFrameCompletion,
+  queueRendererParticipantComplete,
+  registerAdvanceParticipant,
+  removeRendererParticipantOwner,
+  requestInstanceRender,
+  requestRendererParticipantWork
+} from "./realm-scheduler.js";
+const ownersByComponent = /* @__PURE__ */ new WeakMap();
+const ownerStates = /* @__PURE__ */ new WeakMap();
+function pibblInternalCurrentRenderOwner() {
+  const component = GLOBAL_STATE.componentRefs;
+  const instance = GLOBAL_STATE.currentPibblInstance;
+  if (!component || !instance) {
+    throw new Error(
+      "pibblInternalCurrentRenderOwner() is only available during Pibbl component evaluation."
+    );
+  }
+  const existing = ownersByComponent.get(component);
+  if (existing) return existing;
+  const owner = {};
+  const state = {};
+  const schedulerOwner = {
+    instance,
+    isActive: () => state.active && isCurrentOwner(state)
+  };
+  Object.assign(state, {
+    component,
+    instance,
+    schedulerOwner,
+    consumers: /* @__PURE__ */ new Set(),
+    beginCommands: /* @__PURE__ */ new Set(),
+    advanceRegistrations: /* @__PURE__ */ new Set(),
+    active: true
+  });
+  ownersByComponent.set(component, owner);
+  ownerStates.set(owner, state);
+  component.teardowns.add(() => disposeRenderOwner(owner));
+  return owner;
+}
+function pibblInternalCreateSignalConsumer(options) {
+  const ownerState = requireActiveOwner(options.owner);
+  let disposed = false;
+  const signalConsumer = createSignalRenderConsumer({
+    debugName: options.debugName ?? `official renderer (${ownerState.component.id})`,
+    invalidate: () => {
+      if (!disposed && ownerState.schedulerOwner.isActive()) {
+        options.invalidate();
+      }
+    }
+  });
+  const consumer = {
+    collect(read) {
+      if (disposed) {
+        throw new Error("Cannot collect signal reads with a disposed Pibbl renderer consumer.");
+      }
+      requireActiveOwner(options.owner);
+      return collectSignalReads(signalConsumer, () => read());
+    },
+    markClean() {
+      if (!disposed) signalConsumer.markClean();
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      ownerState.consumers.delete(consumer);
+      disposeSignalRenderConsumer(signalConsumer);
+    }
+  };
+  ownerState.consumers.add(consumer);
+  return consumer;
+}
+function pibblInternalRequestRendererWork(owner, request) {
+  const state = requireActiveOwner(owner);
+  requestRendererParticipantWork(state.schedulerOwner, request);
+}
+function pibblInternalAssertCommandAllowed() {
+  assertSignalCommandAllowed();
+}
+function pibblInternalQueueBegin(owner, callback) {
+  const state = requireActiveOwner(owner);
+  let handle;
+  const schedulerHandle = queueBeginCommand((frame, batch, sequence) => {
+    state.beginCommands.delete(handle);
+    if (!state.schedulerOwner.isActive()) return;
+    callback(frame, batch, sequence);
+  });
+  handle = Object.freeze({
+    sequence: schedulerHandle.sequence,
+    cancel() {
+      state.beginCommands.delete(handle);
+      schedulerHandle.cancel();
+    }
+  });
+  state.beginCommands.add(handle);
+  return handle;
+}
+function pibblInternalRegisterAdvance(owner, callback) {
+  const state = requireActiveOwner(owner);
+  let released = false;
+  const unregister = registerAdvanceParticipant((frame, batch) => {
+    if (!state.schedulerOwner.isActive()) return;
+    callback(frame, batch);
+  });
+  const release = () => {
+    if (released) return;
+    released = true;
+    state.advanceRegistrations.delete(release);
+    unregister();
+  };
+  state.advanceRegistrations.add(release);
+  return release;
+}
+function pibblInternalQueueCurrentCommit(owner, callback) {
+  const state = requireActiveOwner(owner);
+  queueCurrentFrameCommitAcknowledgement((frame, outcome) => {
+    if (!state.schedulerOwner.isActive()) return;
+    callback(frame, outcome);
+  });
+}
+function pibblInternalQueueCurrentComplete(owner, callback) {
+  const state = requireActiveOwner(owner);
+  queueCurrentFrameCompletion((frame) => {
+    if (!state.schedulerOwner.isActive()) return;
+    callback(frame);
+  });
+}
+function pibblInternalRequestRender(owner) {
+  const state = requireActiveOwner(owner);
+  requestInstanceRender(state.instance);
+}
+function pibblInternalOnRenderFinish(owner, callback) {
+  const state = requireActiveOwner(owner);
+  if (GLOBAL_STATE.componentRefs !== state.component || GLOBAL_STATE.currentPibblInstance !== state.instance || !GLOBAL_STATE.renderTransaction) {
+    throw new Error(
+      "pibblInternalOnRenderFinish() requires its owner to be the currently evaluating Pibbl component."
+    );
+  }
+  GLOBAL_STATE.renderTransaction.onFinish((success) => {
+    if (success && !state.schedulerOwner.isActive()) return;
+    callback(success);
+  });
+}
+function pibblInternalPaintTarget(handlers, options, pointerEvents = "auto") {
+  return usePaintTarget(handlers, options, pointerEvents);
+}
+function pibblInternalCurrentFrame() {
+  const frame = getCurrentFrameSnapshot();
+  if (!frame) {
+    throw new Error("pibblInternalCurrentFrame() requires a current Pibbl frame.");
+  }
+  return frame;
+}
+function pibblInternalQueueComplete(owner, callback) {
+  const state = requireActiveOwner(owner);
+  queueRendererParticipantComplete(state.schedulerOwner, callback);
+}
+function requireActiveOwner(owner) {
+  const state = ownerStates.get(owner);
+  if (!state || !state.active || !isCurrentOwner(state)) {
+    throw new TypeError("Expected an active Pibbl internal render owner.");
+  }
+  return state;
+}
+function isCurrentOwner(state) {
+  return !state.component.teardowns.closed && !state.instance.mainTeardowns.closed && GLOBAL_STATE.pibblInstances.get(state.instance.canvas) === state.instance && state.instance.refs.get(state.component.id) === state.component;
+}
+function disposeRenderOwner(owner) {
+  const state = ownerStates.get(owner);
+  if (!state || !state.active) return;
+  state.active = false;
+  for (const command of Array.from(state.beginCommands)) {
+    command.cancel();
+  }
+  state.beginCommands.clear();
+  for (const release of Array.from(state.advanceRegistrations)) {
+    release();
+  }
+  state.advanceRegistrations.clear();
+  removeRendererParticipantOwner(state.schedulerOwner);
+  for (const consumer of Array.from(state.consumers)) {
+    consumer.dispose();
+  }
+  state.consumers.clear();
+}
+export {
+  pibblInternalAssertCommandAllowed,
+  pibblInternalCreateSignalConsumer,
+  pibblInternalCurrentFrame,
+  pibblInternalCurrentRenderOwner,
+  pibblInternalOnRenderFinish,
+  pibblInternalPaintTarget,
+  pibblInternalQueueBegin,
+  pibblInternalQueueComplete,
+  pibblInternalQueueCurrentCommit,
+  pibblInternalQueueCurrentComplete,
+  pibblInternalRegisterAdvance,
+  pibblInternalRequestRender,
+  pibblInternalRequestRendererWork
+};
+//# sourceMappingURL=renderer-participant.js.map