@pibbl/core 0.0.1

package/dist/lib/signals/graph.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/signals/graph.ts"],
+  "sourcesContent": ["import type {\n  Signal,\n  SignalEquals,\n  SignalOptions,\n  WritableSignal,\n} from './types.js';\nimport type { PibblRenderTransaction } from '../types.js';\nimport {\n  beginReactiveCollection,\n  collectReactiveDependency,\n  finishReactiveCollection,\n  linkReactiveEdgeToSource,\n  notifyReactiveEdges,\n  unlinkReactiveEdgeFromSource,\n  type ReactiveEdge,\n  type ReactiveNotificationCursor,\n  type SignalDependencyConsumer,\n} from './edge.js';\n\nconst signalNodes = new WeakMap<object, SignalNode<unknown>>();\nconst signalValues = new WeakSet<object>();\n\ntype ComputedState = 'clean' | 'check' | 'evaluating';\n\ninterface ComputedSignalNode<T>\n  extends SignalNode<T>, SignalDependencyConsumer {\n  readonly kind: 'computed';\n  compute(): T;\n  state: ComputedState;\n  hasValue: boolean;\n  hasError: boolean;\n  error: unknown;\n  invalidate(): void;\n  validate(): void;\n  observedCount: number;\n  pendingValidation: boolean;\n  observe(): () => void;\n  adoptCandidate(\n    candidate: ComputedSignalNode<T>,\n    compute: () => T,\n    changed: boolean,\n    readers: ReadonlySet<SignalDependencyCollector>,\n  ): void;\n  replaceCompute(compute: () => T, invalidate: boolean): void;\n}\n\n/** @internal One isolated formula generation owned by a render transaction. */\nexport interface ComputedFormulaCandidate<T> {\n  readonly signal: Signal<T>;\n  readonly readers: Set<SignalDependencyCollector>;\n  changed: boolean;\n  evaluated: boolean;\n  value: T | undefined;\n}\n\nexport interface SignalNode<T> {\n  value: T;\n  equals: SignalEquals<T>;\n  debugName: string | undefined;\n  version: number;\n  observerHead: ReactiveEdge | undefined;\n  observerTail: ReactiveEdge | undefined;\n  observerCount: number;\n  activeObserverCursor: ReactiveNotificationCursor | undefined;\n  observe?(): () => void;\n  validate?(): void;\n}\n\ntype SignalRenderProvisionStatus = 'pending' | 'success' | 'failure';\n\ninterface SignalRenderProvisionEntry {\n  readonly transaction: PibblRenderTransaction;\n  value: unknown;\n  status: SignalRenderProvisionStatus;\n}\n\ninterface SignalRenderProvisionState {\n  baseValue: unknown;\n  readonly entries: SignalRenderProvisionEntry[];\n  readonly entriesByTransaction: Map<\n    PibblRenderTransaction,\n    SignalRenderProvisionEntry\n  >;\n}\n\nexport interface SignalDependencyCollector {\n  addDependency(node: SignalNode<unknown>): void;\n}\n\nexport type SignalWriteOperation = 'direct' | 'staged';\n\nexport type SignalWritePolicy = (\n  node: SignalNode<unknown>,\n  operation: SignalWriteOperation,\n) => void;\n\n/** @internal Authorization seam owned by the animation writer-lease registry. */\nexport interface SignalWriterLeasePolicy {\n  assertDirectWriteAllowed(node: SignalNode<unknown>): void;\n  captureStagedWrite(\n    node: SignalNode<unknown>,\n    writer: object,\n  ): unknown;\n  assertStagedWriteAllowed(\n    node: SignalNode<unknown>,\n    writer: object,\n    authorization: unknown,\n  ): void;\n}\n\nlet activeSignalDependencyCollector: SignalDependencyCollector | undefined;\nconst writePolicyStack: SignalWritePolicy[] = [];\nconst computedStack: ComputedSignalNode<unknown>[] = [];\nfunction createSignalNodeState<T>(\n  value: T,\n  equals: SignalEquals<T>,\n  debugName: string | undefined,\n): SignalNode<T> {\n  return {\n    value,\n    equals,\n    debugName,\n    version: 0,\n    observerHead: undefined,\n    observerTail: undefined,\n    observerCount: 0,\n    activeObserverCursor: undefined,\n  };\n}\n\nconst commandAssertionNode = createSignalNodeState<unknown>(\n  undefined,\n  Object.is,\n  undefined,\n);\nconst activeSignalRenderProvisions = new WeakMap<\n  SignalNode<unknown>,\n  SignalRenderProvisionState\n>();\nconst pendingComputedValidations = new Set<ComputedSignalNode<unknown>>();\nlet flushingPendingComputedValidations = false;\nlet rendererConsumers = 0;\nlet rendererEdges = 0;\nlet createdRendererConsumers = 0;\nlet releasedRendererConsumers = 0;\nlet createdRendererEdges = 0;\nlet releasedRendererEdges = 0;\nlet signalCommitNotifications = 0;\nlet planComputedValidations = 0;\nlet computedSourceEdges = 0;\nlet createdComputedSourceEdges = 0;\nlet releasedComputedSourceEdges = 0;\nlet lazyRendererConsumers = 0;\nlet reusedRendererEdges = 0;\nlet plainInputResolutions = 0;\nlet signalInputResolutions = 0;\nlet shallowInputCopies = 0;\nlet receiverInputProvisions = 0;\nlet adoptedReceiverInputProvisions = 0;\nlet rolledBackReceiverInputProvisions = 0;\nlet batchedObserverInvalidations = 0;\nlet reactionConsumers = 0;\nlet reactionEdges = 0;\nlet reactionRuns = 0;\nlet reactionCleanups = 0;\nlet reactionFailures = 0;\nlet signalGraphPlanWorkNotifier: (() => void) | undefined;\nlet signalWriterLeasePolicy: SignalWriterLeasePolicy | undefined;\n\ninterface PublicSignalBatchEntry {\n  readonly value: unknown;\n  readonly computedHasError: boolean | undefined;\n  readonly computedError: unknown;\n}\n\ninterface PublicSignalBatchState {\n  readonly entries: Map<SignalNode<unknown>, PublicSignalBatchEntry>;\n  readonly failures: unknown[];\n}\n\nlet activePublicSignalBatch: PublicSignalBatchState | undefined;\n\nexport interface SignalGraphSnapshot {\n  readonly rendererConsumers: number;\n  readonly rendererEdges: number;\n  readonly computedSourceEdges: number;\n  readonly pendingComputedValidations: number;\n  readonly createdRendererConsumers: number;\n  readonly releasedRendererConsumers: number;\n  readonly createdRendererEdges: number;\n  readonly releasedRendererEdges: number;\n  readonly signalCommitNotifications: number;\n  readonly planComputedValidations: number;\n  readonly createdComputedSourceEdges: number;\n  readonly releasedComputedSourceEdges: number;\n  readonly lazyRendererConsumers: number;\n  readonly reusedRendererEdges: number;\n  readonly plainInputResolutions: number;\n  readonly signalInputResolutions: number;\n  readonly shallowInputCopies: number;\n  readonly receiverInputProvisions: number;\n  readonly adoptedReceiverInputProvisions: number;\n  readonly rolledBackReceiverInputProvisions: number;\n  readonly batchedObserverInvalidations: number;\n  readonly reactionConsumers: number;\n  readonly reactionEdges: number;\n  readonly reactionRuns: number;\n  readonly reactionCleanups: number;\n  readonly reactionFailures: number;\n}\n\n/** @internal Deterministic ownership and structural evidence for tests. */\nexport function signalGraphSnapshot(): SignalGraphSnapshot {\n  return Object.freeze({\n    rendererConsumers,\n    rendererEdges,\n    computedSourceEdges,\n    pendingComputedValidations: pendingComputedValidations.size,\n    createdRendererConsumers,\n    releasedRendererConsumers,\n    createdRendererEdges,\n    releasedRendererEdges,\n    signalCommitNotifications,\n    planComputedValidations,\n    createdComputedSourceEdges,\n    releasedComputedSourceEdges,\n    lazyRendererConsumers,\n    reusedRendererEdges,\n    plainInputResolutions,\n    signalInputResolutions,\n    shallowInputCopies,\n    receiverInputProvisions,\n    adoptedReceiverInputProvisions,\n    rolledBackReceiverInputProvisions,\n    batchedObserverInvalidations,\n    reactionConsumers,\n    reactionEdges,\n    reactionRuns,\n    reactionCleanups,\n    reactionFailures,\n  });\n}\n\n/** @internal Records one component consumer materialized by its first read. */\nexport function recordLazyRendererConsumerCreated(): void {\n  lazyRendererConsumers++;\n}\n\n/** @internal Records one render edge reused by recollection or restoration. */\nexport function recordRendererEdgeReused(restored = false): void {\n  if (restored) rendererEdges++;\n  reusedRendererEdges++;\n}\n\n/** @internal Records one declared plain input that took the identity path. */\nexport function recordPlainInputResolution(): void {\n  plainInputResolutions++;\n}\n\n/** @internal Records one declared signal-valued input read. */\nexport function recordSignalInputResolution(): void {\n  signalInputResolutions++;\n}\n\n/** @internal Records one copy-on-signal props or style object. */\nexport function recordShallowInputCopy(): void {\n  shallowInputCopies++;\n}\n\n/** @internal Records one pre-evaluation receiver input provision. */\nexport function recordReceiverInputProvisionCreated(): void {\n  receiverInputProvisions++;\n}\n\n/** @internal Records one provision adopted by its receiver generation. */\nexport function recordReceiverInputProvisionAdopted(): void {\n  receiverInputProvisions--;\n  adoptedReceiverInputProvisions++;\n}\n\n/** @internal Records one provision discarded without publication. */\nexport function recordReceiverInputProvisionRolledBack(): void {\n  receiverInputProvisions--;\n  rolledBackReceiverInputProvisions++;\n}\n\n/** @internal Adds one already-read source to the active dependency collector. */\nexport function trackSignalDependency(node: SignalNode<unknown>): void {\n  activeSignalDependencyCollector?.addDependency(node);\n}\n\n/** @internal Records one observer invalidation deduplicated by a public batch. */\nexport function recordBatchedObserverInvalidation(): void {\n  batchedObserverInvalidations++;\n}\n\n/** @internal Records one live component-owned reaction consumer. */\nexport function recordReactionConsumerCreated(): void {\n  reactionConsumers++;\n}\n\n/** @internal Records final release of one reaction consumer. */\nexport function recordReactionConsumerReleased(): void {\n  reactionConsumers--;\n}\n\n/** @internal Records one live reaction source edge. */\nexport function recordReactionEdgeCreated(): void {\n  reactionEdges++;\n}\n\n/** @internal Records release of one reaction source edge. */\nexport function recordReactionEdgeReleased(): void {\n  reactionEdges--;\n}\n\n/** @internal Records one reaction setup attempt. */\nexport function recordReactionRun(): void {\n  reactionRuns++;\n}\n\n/** @internal Records one exact cleanup generation execution. */\nexport function recordReactionCleanup(): void {\n  reactionCleanups++;\n}\n\n/** @internal Records one setup or cleanup failure. */\nexport function recordReactionFailure(): void {\n  reactionFailures++;\n}\n\n/** @internal Records one live renderer consumer for test diagnostics. */\nexport function recordRendererConsumerCreated(): void {\n  rendererConsumers++;\n  createdRendererConsumers++;\n}\n\n/** @internal Records release of one renderer consumer for test diagnostics. */\nexport function recordRendererConsumerReleased(): void {\n  rendererConsumers--;\n  releasedRendererConsumers++;\n}\n\n/** @internal Records one live renderer dependency edge for test diagnostics. */\nexport function recordRendererEdgeCreated(): void {\n  rendererEdges++;\n  createdRendererEdges++;\n}\n\n/** @internal Records release of one renderer dependency edge for tests. */\nexport function recordRendererEdgeReleased(): void {\n  rendererEdges--;\n  releasedRendererEdges++;\n}\n\n/**\n * Runs a synchronous callback while coalescing signal notifications until the outer batch\n * completes.\n *\n * @param callback - Synchronous work whose signal notifications are grouped.\n * @returns The callback's return value.\n *\n * @see {@link signal}\n * @see {@link computed}\n * @see {@link WritableSignal}\n */\nexport function batch<T>(callback: () => T): T {\n  if (activePublicSignalBatch !== undefined) return callback();\n\n  const state: PublicSignalBatchState = {\n    entries: new Map(),\n    failures: [],\n  };\n  activePublicSignalBatch = state;\n  let result!: T;\n  let callbackFailure: unknown;\n  let callbackFailed = false;\n  try {\n    result = callback();\n  } catch (error) {\n    callbackFailed = true;\n    callbackFailure = error;\n  }\n\n  const notificationFailures = flushPublicSignalBatch(state);\n  if (callbackFailed) {\n    if (notificationFailures.length === 0) throw callbackFailure;\n    throw new AggregateError(\n      [callbackFailure, ...notificationFailures],\n      'Pibbl signal batch callback and observer notifications failed.',\n    );\n  }\n  throwSignalObserverFailures(notificationFailures);\n  return result;\n}\n\nfunction recordPublicBatchEntry(node: SignalNode<unknown>): void {\n  const state = activePublicSignalBatch;\n  if (state === undefined || state.entries.has(node)) return;\n  const computedNode = isComputedSignalNode(node) ? node : undefined;\n  state.entries.set(node, {\n    value: node.value,\n    computedHasError: computedNode?.hasError,\n    computedError: computedNode?.error,\n  });\n}\n\nfunction flushPublicSignalBatch(state: PublicSignalBatchState): unknown[] {\n  try {\n    flushPendingComputedValidations();\n  } catch (error) {\n    if (\n      error instanceof AggregateError &&\n      error.message === 'Pibbl signal observer notifications failed.'\n    ) {\n      state.failures.push(...error.errors);\n    } else {\n      state.failures.push(error);\n    }\n  }\n\n  const seen = new Set<SignalDependencyConsumer>();\n  const consumers: Array<{\n    readonly consumer: SignalDependencyConsumer;\n    readonly source: SignalNode<unknown>;\n  }> = [];\n  for (const [source, entry] of state.entries) {\n    let unchanged = false;\n    try {\n      unchanged = publicBatchEntryEquals(source, entry);\n    } catch (error) {\n      state.failures.push(error);\n    }\n    if (unchanged) continue;\n    signalCommitNotifications++;\n    for (\n      let edge = source.observerHead;\n      edge !== undefined;\n      edge = edge.sourceNext\n    ) {\n      const consumer = edge.consumer;\n      if (consumer.propagateInvalidation === true) continue;\n      if (seen.has(consumer)) {\n        recordBatchedObserverInvalidation();\n        continue;\n      }\n      seen.add(consumer);\n      consumers.push({ consumer, source });\n    }\n  }\n\n  activePublicSignalBatch = undefined;\n  for (const { consumer, source } of consumers) {\n    try {\n      consumer.notify(source);\n    } catch (error) {\n      state.failures.push(error);\n    }\n  }\n  return state.failures;\n}\n\nfunction publicBatchEntryEquals(\n  node: SignalNode<unknown>,\n  entry: PublicSignalBatchEntry,\n): boolean {\n  if (isComputedSignalNode(node)) {\n    if (node.hasError !== entry.computedHasError) return false;\n    if (node.hasError && node.error !== entry.computedError) return false;\n  }\n  return node.equals(entry.value, node.value);\n}\n\nfunction computedWriteErrorLabel(node: SignalNode<unknown>): string {\n  return node.debugName === undefined ?\n    'Cannot write to a signal while evaluating a computed signal.' :\n    `Cannot write to a signal while evaluating computed signal \"${node.debugName}\".`;\n}\n\nfunction notifySignalObservers(node: SignalNode<unknown>): unknown[] {\n  const batchState = activePublicSignalBatch;\n  if (batchState !== undefined) {\n    batchState.failures.push(...notifyComputedInvalidationObservers(node));\n    return [];\n  }\n  signalCommitNotifications++;\n  return notifyReactiveEdges(node);\n}\n\nfunction notifyComputedInvalidationObservers(node: SignalNode<unknown>): unknown[] {\n  return notifyReactiveEdges(\n    node,\n    consumer => consumer.propagateInvalidation === true,\n  );\n}\n\nfunction notifyRendererInvalidationObservers(node: SignalNode<unknown>): unknown[] {\n  return notifyReactiveEdges(\n    node,\n    consumer => consumer.renderInvalidation === true,\n  );\n}\n\nfunction throwSignalObserverFailures(failures: readonly unknown[]): void {\n  if (failures.length > 0) {\n    throw new AggregateError(failures, 'Pibbl signal observer notifications failed.');\n  }\n}\n\n/**\n * Creates a synchronous writable signal with configurable equality and an optional diagnostic\n * name.\n *\n * @param initialValue - Value stored before the first write.\n * @param options - Equality comparison and optional diagnostic name. See {@link SignalOptions}.\n * @returns A writable signal holding the initial value. See {@link WritableSignal}.\n *\n * @see {@link SignalOptions}\n * @see {@link WritableSignal}\n */\nexport function signal<T>(\n  initialValue: T,\n  options: SignalOptions<T> = {},\n): WritableSignal<T> {\n  const equals = options.equals ?? Object.is;\n  const debugName = options.debugName;\n  const node = createSignalNodeState(initialValue, equals, debugName);\n\n  let readonlySignal: Signal<T> | undefined;\n  const read = (): T => {\n    activeSignalDependencyCollector?.addDependency(node as SignalNode<unknown>);\n    return node.value;\n  };\n  const assertWriteAllowed = (): void => {\n    writePolicyStack[writePolicyStack.length - 1]?.(\n      node as SignalNode<unknown>,\n      'direct',\n    );\n    signalWriterLeasePolicy?.assertDirectWriteAllowed(node as SignalNode<unknown>);\n  };\n  const commit = (nextValue: T): void => {\n    if (node.equals(node.value, nextValue)) {\n      return;\n    }\n\n    recordPublicBatchEntry(node as SignalNode<unknown>);\n    node.value = nextValue;\n    node.version++;\n    throwSignalObserverFailures(notifySignalObservers(node as SignalNode<unknown>));\n  };\n  const writable = {\n    get: read,\n    set(nextValue: T): void {\n      assertWriteAllowed();\n      commit(nextValue);\n    },\n    update(updateValue: (current: T) => T): void {\n      assertWriteAllowed();\n      commit(updateValue(node.value));\n    },\n    asReadonly(): Signal<T> {\n      if (readonlySignal === undefined) {\n        readonlySignal = { get: read } as Signal<T>;\n        signalValues.add(readonlySignal);\n        signalNodes.set(readonlySignal, node as SignalNode<unknown>);\n      }\n      return readonlySignal;\n    },\n  } as WritableSignal<T>;\n\n  signalValues.add(writable);\n  signalNodes.set(writable, node as SignalNode<unknown>);\n  return writable;\n}\n\n/**\n * @internal Presents a provisional value to reads and computed dependencies\n * during one render without publishing an ordinary signal notification.\n * This is reserved for a not-yet-successfully-mounted owner whose render\n * transaction owns acceptance or restoration of every overlapping preview.\n */\nexport function provisionSignalValueForRender<T>(\n  value: WritableSignal<T>,\n  nextValue: T,\n  transaction: PibblRenderTransaction,\n): void {\n  const node = getSignalNode(value) as SignalNode<unknown>;\n  const publishComputedVersion = (next: unknown): void => {\n    node.value = next;\n    node.version++;\n    throwSignalObserverFailures(\n      notifyComputedInvalidationObservers(node),\n    );\n  };\n  let state = activeSignalRenderProvisions.get(node);\n  if (state === undefined) {\n    state = {\n      baseValue: node.value,\n      entries: [],\n      entriesByTransaction: new Map(),\n    };\n    activeSignalRenderProvisions.set(node, state);\n  }\n\n  const effectiveEntry = (): SignalRenderProvisionEntry | undefined => {\n    for (let index = state.entries.length - 1; index >= 0; index--) {\n      const entry = state.entries[index];\n      if (entry.status !== 'failure') return entry;\n    }\n    return undefined;\n  };\n  const publishEffectiveValue = (\n    forceEntry?: SignalRenderProvisionEntry,\n  ): boolean => {\n    const entry = effectiveEntry();\n    const effectiveValue = entry?.value ?? state.baseValue;\n    if (\n      (forceEntry !== undefined && entry === forceEntry) ||\n      !Object.is(node.value, effectiveValue)\n    ) {\n      publishComputedVersion(effectiveValue);\n      return true;\n    }\n    return false;\n  };\n\n  let entry = state.entriesByTransaction.get(transaction);\n  if (entry === undefined) {\n    entry = { transaction, value: nextValue, status: 'pending' };\n    state.entries.push(entry);\n    state.entriesByTransaction.set(transaction, entry);\n    const provisionState = state;\n    const provisionEntry = entry;\n    transaction.onFinish(success => {\n      if (provisionEntry.status !== 'pending') return;\n      provisionEntry.status = success ? 'success' : 'failure';\n\n      while (\n        provisionState.entries[0]?.status !== 'pending' &&\n        provisionState.entries.length > 0\n      ) {\n        const settled = provisionState.entries.shift()!;\n        provisionState.entriesByTransaction.delete(settled.transaction);\n        if (settled.status === 'success') {\n          provisionState.baseValue = settled.value;\n        }\n      }\n\n      const effectiveValueChanged = publishEffectiveValue();\n      if (!success && effectiveValueChanged) {\n        throwSignalObserverFailures(notifyRendererInvalidationObservers(node));\n      }\n      if (provisionState.entries.length === 0) {\n        activeSignalRenderProvisions.delete(node);\n      }\n    });\n  }\n  entry.value = nextValue;\n  publishEffectiveValue(entry);\n}\n\n/**\n * Creates a lazy, cached readonly signal whose dependencies are tracked during evaluation.\n *\n * @param compute - Synchronous calculation whose signal reads become dependencies.\n * @param options - Equality comparison and optional diagnostic name. See {@link SignalOptions}.\n * @returns A readonly, lazy, cached signal that recomputes when its dependencies change. See\n * {@link Signal} .\n *\n * @see {@link SignalOptions}\n * @see {@link Signal}\n */\nexport function computed<T>(\n  compute: () => T,\n  options: SignalOptions<T> = {},\n): Signal<T> {\n  const node = Object.assign(\n    createSignalNodeState(\n      undefined as T,\n      options.equals ?? Object.is,\n      options.debugName,\n    ),\n    {\n    kind: 'computed',\n    compute,\n    state: 'check',\n    hasValue: false,\n    hasError: false,\n    error: undefined,\n    dependencyHead: undefined,\n    dependencyTail: undefined,\n    dependencyFreeHead: undefined,\n    dependencyFreeCount: 0,\n    dependencyCount: 0,\n    dependencyHighWater: 0,\n    collectionCursor: undefined,\n    collectionGeneration: 0,\n    observedCount: 0,\n    pendingValidation: false,\n    propagateInvalidation: true,\n    addDependency(dependency: SignalNode<unknown>): void {\n      if (\n        !isComputedSignalNode(dependency) ||\n        dependency.state !== 'evaluating'\n      ) {\n        collectReactiveDependency(node, dependency);\n      }\n    },\n    notify: () => {},\n    observe: () => () => {},\n    invalidate: () => {},\n    validate: () => {},\n    adoptCandidate: () => {},\n    replaceCompute: () => {},\n    },\n  ) as ComputedSignalNode<T>;\n\n  const notifyObservers = (): unknown[] => {\n    return notifySignalObservers(node as SignalNode<unknown>);\n  };\n\n  const enqueueValidation = (): void => {\n    if (node.observedCount === 0 || node.pendingValidation) {\n      return;\n    }\n    node.pendingValidation = true;\n    const wasEmpty = pendingComputedValidations.size === 0;\n    pendingComputedValidations.add(node as ComputedSignalNode<unknown>);\n    if (wasEmpty) signalGraphPlanWorkNotifier?.();\n  };\n\n  const removePendingValidation = (): void => {\n    if (!node.pendingValidation) return;\n    node.pendingValidation = false;\n    pendingComputedValidations.delete(node as ComputedSignalNode<unknown>);\n    if (pendingComputedValidations.size === 0) signalGraphPlanWorkNotifier?.();\n  };\n\n  const invalidate = (): void => {\n    if (node.state !== 'clean') {\n      return;\n    }\n    node.state = 'check';\n    enqueueValidation();\n    throwSignalObserverFailures(\n      notifyComputedInvalidationObservers(node as SignalNode<unknown>),\n    );\n  };\n  node.notify = invalidate;\n\n  const acquireDependency = (edge: ReactiveEdge): void => {\n    if (edge.sourceLinked) return;\n    const dependency = edge.source!;\n    linkReactiveEdgeToSource(edge, dependency.observe?.());\n    computedSourceEdges++;\n    createdComputedSourceEdges++;\n  };\n\n  const releaseDependency = (edge: ReactiveEdge): void => {\n    if (!edge.sourceLinked) return;\n    unlinkReactiveEdgeFromSource(edge);\n    computedSourceEdges--;\n    releasedComputedSourceEdges++;\n  };\n\n  const acquireDependencies = (): void => {\n    for (\n      let edge = node.dependencyHead;\n      edge !== undefined;\n      edge = edge.consumerNext\n    ) {\n      acquireDependency(edge);\n    }\n  };\n\n  const releaseDependencies = (): void => {\n    for (\n      let edge = node.dependencyHead;\n      edge !== undefined;\n      edge = edge.consumerNext\n    ) {\n      releaseDependency(edge);\n    }\n  };\n\n  const finishDependencies = (): void => {\n    finishReactiveCollection(\n      node,\n      edge => {\n        if (node.observedCount > 0) acquireDependency(edge);\n        edge.observedVersion = edge.source!.version;\n        edge.collectionKind = undefined;\n      },\n      releaseDependency,\n    );\n  };\n\n  const cycleError = (): Error => {\n    const start = computedStack.indexOf(node as ComputedSignalNode<unknown>);\n    const cycle = [...computedStack.slice(start), node as ComputedSignalNode<unknown>]\n      .map(computedNode => computedNode.debugName ?? '<computed>')\n      .join(' -> ');\n    return new Error(`Pibbl computed cycle: ${cycle}`);\n  };\n\n  const evaluate = (): void => {\n    if (node.state === 'evaluating') {\n      throw cycleError();\n    }\n\n    beginReactiveCollection(node);\n    node.state = 'evaluating';\n    computedStack.push(node as ComputedSignalNode<unknown>);\n    let changed: boolean;\n    try {\n      const result = withSignalWriteForbidden(\n        computedWriteErrorLabel(node as SignalNode<unknown>),\n        () => {\n          const nextValue = withSignalTracking(node, node.compute);\n          return {\n            nextValue,\n            changed: !node.hasValue || node.hasError ||\n              !node.equals(node.value, nextValue),\n          };\n        },\n      );\n\n      changed = result.changed;\n      if (changed) {\n        recordPublicBatchEntry(node as SignalNode<unknown>);\n        node.value = result.nextValue;\n        node.version++;\n      }\n      node.hasValue = true;\n      node.hasError = false;\n      node.error = undefined;\n    } catch (error) {\n      changed = !node.hasError || node.error !== error;\n      if (changed) recordPublicBatchEntry(node as SignalNode<unknown>);\n      node.hasError = true;\n      node.error = error;\n    } finally {\n      computedStack.pop();\n      finishDependencies();\n      node.state = 'clean';\n    }\n    if (changed) {\n      if (node.hasError) node.version++;\n      throwSignalObserverFailures(notifyObservers());\n    }\n  };\n\n  const validate = (): void => {\n    if (node.state === 'evaluating') {\n      throw cycleError();\n    }\n\n    let dependencyChanged = false;\n    if (node.state === 'clean' && node.observedCount > 0) return;\n    for (\n      let edge = node.dependencyHead;\n      edge !== undefined;\n      edge = edge.consumerNext\n    ) {\n      const dependency = edge.source!;\n      dependency.validate?.();\n      if (dependency.version !== edge.observedVersion) {\n        dependencyChanged = true;\n      }\n    }\n    if (node.state === 'clean' && !dependencyChanged) return;\n    if (dependencyChanged || node.dependencyCount === 0 || !node.hasValue) {\n      evaluate();\n    } else {\n      node.state = 'clean';\n    }\n  };\n\n  const hasChangedDependencyVersion = (): boolean => {\n    for (\n      let edge = node.dependencyHead;\n      edge !== undefined;\n      edge = edge.consumerNext\n    ) {\n      if (edge.source!.version !== edge.observedVersion) return true;\n    }\n    return false;\n  };\n\n  node.invalidate = invalidate;\n  node.validate = validate;\n\n  node.replaceCompute = (nextCompute, shouldInvalidate): void => {\n    node.compute = nextCompute;\n    if (shouldInvalidate) invalidate();\n  };\n\n  node.adoptCandidate = (\n    candidate,\n    nextCompute,\n    changed,\n    readers,\n  ): void => {\n    if (!candidate.hasValue || candidate.hasError) {\n      throw new Error('Cannot adopt an unevaluated computed formula candidate.');\n    }\n    node.compute = nextCompute;\n    beginReactiveCollection(node);\n    for (\n      let edge = candidate.dependencyHead;\n      edge !== undefined;\n      edge = edge.consumerNext\n    ) {\n      collectReactiveDependency(node, edge.source!);\n    }\n    finishDependencies();\n    removePendingValidation();\n    node.state = 'clean';\n    node.hasValue = true;\n    node.hasError = false;\n    node.error = undefined;\n    if (!changed) return;\n\n    recordPublicBatchEntry(node as SignalNode<unknown>);\n    node.value = candidate.value;\n    node.version++;\n    signalCommitNotifications++;\n    throwSignalObserverFailures(notifyReactiveEdges(\n      node as SignalNode<unknown>,\n      consumer => !readers.has(consumer),\n    ));\n  };\n\n  node.observe = (): (() => void) => {\n    node.observedCount++;\n    if (node.observedCount === 1) {\n      acquireDependencies();\n      if (\n        node.state === 'clean' &&\n        hasChangedDependencyVersion()\n      ) {\n        node.state = 'check';\n      }\n    }\n    if (node.state === 'check') {\n      enqueueValidation();\n    }\n\n    let detached = false;\n    return () => {\n      if (detached) {\n        return;\n      }\n      detached = true;\n      node.observedCount--;\n      if (node.observedCount === 0) {\n        removePendingValidation();\n        releaseDependencies();\n      }\n    };\n  };\n\n  const readonly: Signal<T> = {\n    get(): T {\n      activeSignalDependencyCollector?.addDependency(\n        node as SignalNode<unknown>,\n      );\n      validate();\n      removePendingValidation();\n      if (node.hasError) {\n        throw node.error;\n      }\n      return node.value;\n    },\n  } as Signal<T>;\n\n  signalValues.add(readonly);\n  signalNodes.set(readonly, node as SignalNode<unknown>);\n  return readonly;\n}\n\n/** @internal Creates a nominal alias that retains one computed graph identity. */\nexport function createComputedSignalAlias<T>(\n  target: Signal<T>,\n  read: () => T,\n): Signal<T> {\n  const node = requireComputedSignalNode(target);\n  const alias = { get: read } as Signal<T>;\n  signalValues.add(alias);\n  signalNodes.set(alias, node as SignalNode<unknown>);\n  return alias;\n}\n\n/** @internal Creates one unobserved formula generation for transactional render. */\nexport function createComputedFormulaCandidate<T>(\n  target: Signal<T>,\n  compute: () => T,\n): ComputedFormulaCandidate<T> {\n  const node = requireComputedSignalNode(target);\n  return {\n    signal: computed(compute, {\n      equals: node.equals,\n      debugName: node.debugName,\n    }),\n    readers: new Set(),\n    changed: false,\n    evaluated: false,\n    value: undefined,\n  };\n}\n\n/** @internal Reads a provisional formula while attributing the stable node. */\nexport function readComputedFormulaCandidate<T>(\n  target: Signal<T>,\n  candidate: ComputedFormulaCandidate<T>,\n): T {\n  const node = requireComputedSignalNode(target);\n  const reader = activeSignalDependencyCollector;\n  reader?.addDependency(node as SignalNode<unknown>);\n  if (reader !== undefined) candidate.readers.add(reader);\n  if (!candidate.evaluated) {\n    const value = untracked(() => candidate.signal.get());\n    candidate.changed = !node.hasValue || node.hasError ||\n      !node.equals(node.value, value);\n    candidate.value = value;\n    candidate.evaluated = true;\n  }\n  return candidate.value as T;\n}\n\n/** @internal Publishes an evaluated formula generation after render success. */\nexport function adoptComputedFormulaCandidate<T>(\n  target: Signal<T>,\n  candidate: ComputedFormulaCandidate<T>,\n  compute: () => T,\n): void {\n  const node = requireComputedSignalNode(target);\n  const candidateNode = requireComputedSignalNode(candidate.signal);\n  node.adoptCandidate(\n    candidateNode,\n    compute,\n    candidate.changed,\n    candidate.readers,\n  );\n}\n\n/** @internal Refreshes a committed formula and optionally invalidates its cache. */\nexport function replaceComputedFormula<T>(\n  target: Signal<T>,\n  compute: () => T,\n  invalidate: boolean,\n): void {\n  requireComputedSignalNode(target).replaceCompute(compute, invalidate);\n}\n\nfunction requireComputedSignalNode<T>(\n  value: Signal<T>,\n): ComputedSignalNode<T> {\n  const node = getSignalNode(value);\n  if (!isComputedSignalNode(node as SignalNode<unknown>)) {\n    throw new TypeError('Expected a computed signal.');\n  }\n  return node as ComputedSignalNode<T>;\n}\n\n/** @internal Called during the scheduler Plan phase. */\nexport function flushPendingComputedValidations(): void {\n  if (flushingPendingComputedValidations) {\n    return;\n  }\n\n  flushingPendingComputedValidations = true;\n  const attempted = new Set<ComputedSignalNode<unknown>>();\n  const failures: unknown[] = [];\n  try {\n    while (pendingComputedValidations.size > 0) {\n      const node = Array.from(pendingComputedValidations)\n        .find(candidate => !attempted.has(candidate));\n      if (node === undefined) {\n        break;\n      }\n      attempted.add(node);\n      node.pendingValidation = false;\n      pendingComputedValidations.delete(node);\n      if (pendingComputedValidations.size === 0) signalGraphPlanWorkNotifier?.();\n      if (node.observedCount > 0) {\n        planComputedValidations++;\n        try {\n          node.validate();\n        } catch (error) {\n          if (\n            error instanceof AggregateError &&\n            error.message === 'Pibbl signal observer notifications failed.'\n          ) {\n            failures.push(...error.errors);\n          } else {\n            failures.push(error);\n          }\n          if (node.state === 'check') enqueueComputedValidation(node);\n        }\n      }\n    }\n  } finally {\n    flushingPendingComputedValidations = false;\n  }\n  throwSignalObserverFailures(failures);\n}\n\n/** @internal Whether the realm scheduler has graph Plan work to service. */\nexport function hasPendingComputedValidations(): boolean {\n  return pendingComputedValidations.size > 0;\n}\n\n/** @internal Connects graph liveness to its host-agnostic scheduler owner. */\nexport function setSignalGraphPlanWorkNotifier(notifier: () => void): void {\n  signalGraphPlanWorkNotifier = notifier;\n  if (pendingComputedValidations.size > 0) notifier();\n}\n\n/**\n * Runs a callback without recording its signal reads as dependencies of the current consumer.\n *\n * @param callback - Synchronous work whose reads should not register dependencies.\n * @returns The callback's return value.\n *\n * @see {@link Signal}\n * @see {@link computed}\n */\nexport function untracked<T>(callback: () => T): T {\n  const previous = activeSignalDependencyCollector;\n  activeSignalDependencyCollector = undefined;\n  try {\n    return callback();\n  } finally {\n    activeSignalDependencyCollector = previous;\n  }\n}\n\n/**\n * Checks the nominal Pibbl signal identity rather than accepting objects that merely have a get\n * method.\n *\n * @param value - Value to check for Pibbl's nominal signal brand.\n * @returns True if the value is a Pibbl signal, narrowing its type accordingly. See {@link Signal}.\n *\n * @see {@link Signal}\n */\nexport function isSignal(value: unknown): value is Signal<unknown> {\n  return typeof value === 'object' && value !== null && signalValues.has(value);\n}\n\nexport function getSignalNode<T>(value: Signal<T>): SignalNode<T> {\n  const node =\n    typeof value === 'object' && value !== null ? signalNodes.get(value) :\n      undefined;\n  if (node === undefined) {\n    throw new TypeError('Expected a signal created by signal().');\n  }\n  return node as SignalNode<T>;\n}\n\ninterface StagedSignalValue {\n  readonly node: SignalNode<unknown>;\n  value: unknown;\n  writer: object;\n  authorization: unknown;\n  provenance: object | undefined;\n  previous: StagedSignalValue | undefined;\n}\n\ninterface SignalCommitBatchState {\n  readonly staged: Map<SignalNode<unknown>, StagedSignalValue>;\n  readonly lifecycles: Map<object, SignalCommitLifecycle>;\n}\n\n/** @internal Couples a non-signal resource publication to a staged writer. */\nexport interface SignalCommitLifecycle {\n  /** Runs after all fallible commit validation and before signal observers. */\n  apply(): void;\n  /** Restores a completed apply if a later writer cannot publish. */\n  rollback?(): void;\n  /** Releases a candidate when its writer never reaches Commit. */\n  abort(): void;\n}\n\nconst signalCommitBatchStates = new WeakMap<\n  SignalCommitBatch,\n  SignalCommitBatchState\n>();\n\nexport interface SignalCommitBatch {\n  read<T>(signal: WritableSignal<T>): T;\n  stage<T>(signal: WritableSignal<T>, value: T, writer: object): void;\n  registerLifecycle(writer: object, lifecycle: SignalCommitLifecycle): void;\n  discardWriter(writer: object): void;\n  commit(onApplied?: () => void): void;\n  clear(): void;\n}\n\nexport function createSignalCommitBatch(): SignalCommitBatch {\n  const staged = new Map<SignalNode<unknown>, StagedSignalValue>();\n\n  const batch: SignalCommitBatch = {\n    read<T>(value: WritableSignal<T>): T {\n      const node = getSignalNode(value) as SignalNode<T>;\n      const candidate = staged.get(node as SignalNode<unknown>);\n      return candidate === undefined ? node.value : candidate.value as T;\n    },\n    stage<T>(value: WritableSignal<T>, nextValue: T, writer: object): void {\n      stageSignalCommitBatchCandidate(\n        staged,\n        value,\n        nextValue,\n        writer,\n        undefined,\n      );\n    },\n    registerLifecycle(writer: object, lifecycle: SignalCommitLifecycle): void {\n      const prior = state.lifecycles.get(writer);\n      if (prior) abortLifecycle(prior);\n      state.lifecycles.set(writer, lifecycle);\n    },\n    discardWriter(writer: object): void {\n      for (const [node, candidate] of staged) {\n        if (candidate.writer === writer) {\n          staged.delete(node);\n        }\n      }\n      const lifecycle = state.lifecycles.get(writer);\n      state.lifecycles.delete(writer);\n      if (lifecycle) abortLifecycle(lifecycle);\n    },\n    commit(onApplied?: () => void): void {\n      const candidates = [...staged.values()];\n      staged.clear();\n      try {\n        for (const candidate of candidates) {\n          signalWriterLeasePolicy?.assertStagedWriteAllowed(\n            candidate.node,\n            candidate.writer,\n            candidate.authorization,\n          );\n        }\n\n        const changed: StagedSignalValue[] = [];\n        for (const candidate of candidates) {\n          const node = candidate.node;\n          if (!node.equals(node.value, candidate.value)) {\n            changed.push(candidate);\n          }\n        }\n\n        const changedWriters = new Set(changed.map(candidate => candidate.writer));\n        const applied: SignalCommitLifecycle[] = [];\n        for (const candidate of candidates) {\n          const lifecycle = state.lifecycles.get(candidate.writer);\n          state.lifecycles.delete(candidate.writer);\n          if (!lifecycle) continue;\n          if (!changedWriters.has(candidate.writer)) {\n            abortLifecycle(lifecycle);\n            continue;\n          }\n          try {\n            lifecycle.apply();\n            applied.push(lifecycle);\n          } catch (error) {\n            abortLifecycle(lifecycle);\n            for (const appliedLifecycle of applied.reverse()) {\n              try { appliedLifecycle.rollback?.(); } catch {}\n              abortLifecycle(appliedLifecycle);\n            }\n            throw error;\n          }\n        }\n        for (const candidate of changed) {\n          const node = candidate.node;\n          recordPublicBatchEntry(node);\n          node.value = candidate.value;\n          node.version++;\n        }\n        onApplied?.();\n        const failures: unknown[] = [];\n        for (const candidate of changed) {\n          failures.push(...notifySignalObservers(candidate.node));\n        }\n        for (const lifecycle of state.lifecycles.values()) abortLifecycle(lifecycle);\n        state.lifecycles.clear();\n        throwSignalObserverFailures(failures);\n      } catch (error) {\n        for (const lifecycle of state.lifecycles.values()) abortLifecycle(lifecycle);\n        state.lifecycles.clear();\n        throw error;\n      }\n    },\n    clear(): void {\n      staged.clear();\n      for (const lifecycle of state.lifecycles.values()) abortLifecycle(lifecycle);\n      state.lifecycles.clear();\n    },\n  };\n  const state: SignalCommitBatchState = { staged, lifecycles: new Map() };\n  signalCommitBatchStates.set(batch, state);\n  return batch;\n}\n\nfunction abortLifecycle(lifecycle: SignalCommitLifecycle): void {\n  try {\n    lifecycle.abort();\n  } catch {\n    // Abort is cleanup for an already failing or discarded transaction. It must\n    // not replace the originating scheduler/commit failure.\n  }\n}\n\n/** @internal Stages a candidate with rollback provenance for one owner. */\nexport function stageSignalCommitBatchWithProvenance<T>(\n  batch: SignalCommitBatch,\n  provenance: object,\n  signal: WritableSignal<T>,\n  value: T,\n  writer: object,\n): void {\n  stageSignalCommitBatchCandidate(\n    requireSignalCommitBatchState(batch).staged,\n    signal,\n    value,\n    writer,\n    provenance,\n  );\n}\n\n/** @internal Discards only candidates staged with one owner's provenance. */\nexport function discardSignalCommitBatchProvenance(\n  batch: SignalCommitBatch,\n  provenance: object,\n): void {\n  discardSignalCommitBatchCandidates(\n    requireSignalCommitBatchState(batch).staged,\n    candidate => candidate.provenance === provenance,\n  );\n}\n\n/** @internal Applies friend discardWriter semantics inside one owner provenance. */\nexport function discardSignalCommitBatchWriterForProvenance(\n  batch: SignalCommitBatch,\n  provenance: object,\n  writer: object,\n): void {\n  discardSignalCommitBatchCandidates(\n    requireSignalCommitBatchState(batch).staged,\n    candidate =>\n      candidate.provenance === provenance && candidate.writer === writer,\n  );\n}\n\nfunction stageSignalCommitBatchCandidate<T>(\n  staged: Map<SignalNode<unknown>, StagedSignalValue>,\n  value: WritableSignal<T>,\n  nextValue: T,\n  writer: object,\n  provenance: object | undefined,\n): void {\n  const node = getSignalNode(value) as SignalNode<T>;\n  const unknownNode = node as SignalNode<unknown>;\n  writePolicyStack[writePolicyStack.length - 1]?.(unknownNode, 'staged');\n  staged.set(unknownNode, {\n    node: unknownNode,\n    value: nextValue,\n    writer,\n    authorization: signalWriterLeasePolicy?.captureStagedWrite(\n      unknownNode,\n      writer,\n    ),\n    provenance,\n    previous: staged.get(unknownNode),\n  });\n}\n\nfunction requireSignalCommitBatchState(\n  batch: SignalCommitBatch,\n): SignalCommitBatchState {\n  const state = signalCommitBatchStates.get(batch);\n  if (!state) throw new TypeError('Expected a Pibbl signal Commit batch.');\n  return state;\n}\n\nfunction discardSignalCommitBatchCandidates(\n  staged: Map<SignalNode<unknown>, StagedSignalValue>,\n  discard: (candidate: StagedSignalValue) => boolean,\n): void {\n  for (const [node, candidate] of staged) {\n    const retained = discardStagedSignalCandidates(candidate, discard);\n    if (retained === undefined) staged.delete(node);\n    else staged.set(node, retained);\n  }\n}\n\nfunction discardStagedSignalCandidates(\n  candidate: StagedSignalValue | undefined,\n  discard: (candidate: StagedSignalValue) => boolean,\n): StagedSignalValue | undefined {\n  const retained: StagedSignalValue[] = [];\n  let current = candidate;\n  while (current !== undefined) {\n    if (!discard(current)) retained.push(current);\n    current = current.previous;\n  }\n  let previous: StagedSignalValue | undefined;\n  for (let index = retained.length - 1; index >= 0; index--) {\n    retained[index].previous = previous;\n    previous = retained[index];\n  }\n  return previous;\n}\n\nexport function withSignalTracking<T>(\n  collector: SignalDependencyCollector,\n  callback: () => T,\n): T {\n  const previous = activeSignalDependencyCollector;\n  activeSignalDependencyCollector = collector;\n  try {\n    return callback();\n  } finally {\n    activeSignalDependencyCollector = previous;\n  }\n}\n\nexport function withSignalWritePolicy<T>(\n  policy: SignalWritePolicy,\n  callback: () => T,\n): T {\n  writePolicyStack.push(policy);\n  try {\n    return callback();\n  } finally {\n    writePolicyStack.pop();\n  }\n}\n\nexport function withSignalWriteForbidden<T>(\n  reason: string,\n  callback: () => T,\n): T {\n  return withSignalWritePolicy(() => {\n    throw new Error(reason);\n  }, callback);\n}\n\nexport function withDirectSignalWriteForbidden<T>(\n  reason: string,\n  callback: () => T,\n): T {\n  return withSignalWritePolicy((_node, operation) => {\n    if (operation === 'direct') throw new Error(reason);\n  }, callback);\n}\n\n/** @internal Checks the active direct-write policy without mutating a signal. */\nexport function assertSignalCommandAllowed(): void {\n  writePolicyStack[writePolicyStack.length - 1]?.(\n    commandAssertionNode,\n    'direct',\n  );\n}\n\n/** @internal Preflight a direct signal writer without changing values or versions. */\nexport function assertDirectSignalWriteAllowed(value: Signal<unknown>): void {\n  const node = getSignalNode(value);\n  writePolicyStack[writePolicyStack.length - 1]?.(node, 'direct');\n  signalWriterLeasePolicy?.assertDirectWriteAllowed(node);\n}\n\n/** @internal Installs the singleton policy that validates active writer leases. */\nexport function installSignalWriterLeasePolicy(\n  policy: SignalWriterLeasePolicy,\n): void {\n  if (signalWriterLeasePolicy !== undefined && signalWriterLeasePolicy !== policy) {\n    throw new Error('Pibbl signal writer-lease policy is already installed.');\n  }\n  signalWriterLeasePolicy = policy;\n}\n\nfunction isComputedSignalNode(\n  node: SignalNode<unknown>,\n): node is ComputedSignalNode<unknown> {\n  return 'kind' in node && node.kind === 'computed';\n}\n\nfunction enqueueComputedValidation(node: ComputedSignalNode<unknown>): void {\n  if (node.observedCount === 0 || node.pendingValidation) return;\n  node.pendingValidation = true;\n  const wasEmpty = pendingComputedValidations.size === 0;\n  pendingComputedValidations.add(node);\n  if (wasEmpty) signalGraphPlanWorkNotifier?.();\n}\n"],
+  "mappings": "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",
+  "names": ["entry", "batch", "signal"]
+}

package/dist/lib/signals/input-provision.d.ts

@@ -0,0 +1,3 @@
+import type { PibblRenderTransaction } from '../types.js';
+export declare function withReceiverInputProvision<T>(transaction: PibblRenderTransaction | undefined, receiver: object | undefined, callback: () => T): T;
+export declare function adoptReceiverInputProvision(transaction: PibblRenderTransaction | undefined, receiver: object): void;

package/dist/lib/signals/input-provision.js

@@ -0,0 +1,67 @@
+import { GLOBAL_STATE } from "../global-state.js";
+import { getPrimitiveReceiverToken } from "../element/metadata.js";
+import {
+  recordReceiverInputProvisionAdopted,
+  recordReceiverInputProvisionCreated,
+  recordReceiverInputProvisionRolledBack,
+  trackSignalDependency,
+  untracked,
+  withSignalTracking
+} from "./graph.js";
+const transactionProvisions = /* @__PURE__ */ new WeakMap();
+function withReceiverInputProvision(transaction, receiver, callback) {
+  if (!transaction || !receiver) return untracked(callback);
+  if (currentComponentOwnsReceiver(receiver)) return callback();
+  let provision;
+  const collector = {
+    addDependency(node) {
+      if (provision === void 0) {
+        provision = createProvision(transaction, receiver);
+      }
+      if (!provision.nodes.includes(node)) provision.nodes.push(node);
+    }
+  };
+  return withSignalTracking(collector, callback);
+}
+function adoptReceiverInputProvision(transaction, receiver) {
+  if (!transaction) return;
+  const receivers = transactionProvisions.get(transaction);
+  const provision = receivers?.get(receiver);
+  if (!provision || provision.settled) return;
+  provision.settled = true;
+  receivers.delete(receiver);
+  for (const node of provision.nodes) trackSignalDependency(node);
+  provision.nodes.length = 0;
+  recordReceiverInputProvisionAdopted();
+}
+function createProvision(transaction, receiver) {
+  let receivers = transactionProvisions.get(transaction);
+  if (!receivers) {
+    receivers = /* @__PURE__ */ new WeakMap();
+    transactionProvisions.set(transaction, receivers);
+  }
+  let provision = receivers.get(receiver);
+  if (provision) return provision;
+  provision = { nodes: [], settled: false };
+  receivers.set(receiver, provision);
+  recordReceiverInputProvisionCreated();
+  const ownedProvision = provision;
+  transaction.onFinish(() => {
+    if (ownedProvision.settled) return;
+    ownedProvision.settled = true;
+    receivers.delete(receiver);
+    ownedProvision.nodes.length = 0;
+    recordReceiverInputProvisionRolledBack();
+  });
+  return provision;
+}
+function currentComponentOwnsReceiver(receiver) {
+  const component = GLOBAL_STATE.componentRefs;
+  if (!component) return false;
+  return (getPrimitiveReceiverToken(component.element) ?? component) === receiver;
+}
+export {
+  adoptReceiverInputProvision,
+  withReceiverInputProvision
+};
+//# sourceMappingURL=input-provision.js.map

package/dist/lib/signals/input-provision.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/signals/input-provision.ts"],
+  "sourcesContent": ["import type { PibblRenderTransaction } from '../types.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { getPrimitiveReceiverToken } from '../element/metadata.js';\nimport {\n  recordReceiverInputProvisionAdopted,\n  recordReceiverInputProvisionCreated,\n  recordReceiverInputProvisionRolledBack,\n  trackSignalDependency,\n  untracked,\n  withSignalTracking,\n  type SignalDependencyCollector,\n  type SignalNode,\n} from './graph.js';\n\ninterface ReceiverInputProvision {\n  readonly nodes: SignalNode<unknown>[];\n  settled: boolean;\n}\n\nconst transactionProvisions = new WeakMap<\n  PibblRenderTransaction,\n  WeakMap<object, ReceiverInputProvision>\n>();\n\nexport function withReceiverInputProvision<T>(\n  transaction: PibblRenderTransaction | undefined,\n  receiver: object | undefined,\n  callback: () => T,\n): T {\n  if (!transaction || !receiver) return untracked(callback);\n  if (currentComponentOwnsReceiver(receiver)) return callback();\n\n  let provision: ReceiverInputProvision | undefined;\n  const collector: SignalDependencyCollector = {\n    addDependency(node): void {\n      if (provision === undefined) {\n        provision = createProvision(transaction, receiver);\n      }\n      if (!provision.nodes.includes(node)) provision.nodes.push(node);\n    },\n  };\n  return withSignalTracking(collector, callback);\n}\n\nexport function adoptReceiverInputProvision(\n  transaction: PibblRenderTransaction | undefined,\n  receiver: object,\n): void {\n  if (!transaction) return;\n  const receivers = transactionProvisions.get(transaction);\n  const provision = receivers?.get(receiver);\n  if (!provision || provision.settled) return;\n\n  provision.settled = true;\n  receivers!.delete(receiver);\n  for (const node of provision.nodes) trackSignalDependency(node);\n  provision.nodes.length = 0;\n  recordReceiverInputProvisionAdopted();\n}\n\nfunction createProvision(\n  transaction: PibblRenderTransaction,\n  receiver: object,\n): ReceiverInputProvision {\n  let receivers = transactionProvisions.get(transaction);\n  if (!receivers) {\n    receivers = new WeakMap();\n    transactionProvisions.set(transaction, receivers);\n  }\n  let provision = receivers.get(receiver);\n  if (provision) return provision;\n\n  provision = { nodes: [], settled: false };\n  receivers.set(receiver, provision);\n  recordReceiverInputProvisionCreated();\n  const ownedProvision = provision;\n  transaction.onFinish(() => {\n    if (ownedProvision.settled) return;\n    ownedProvision.settled = true;\n    receivers!.delete(receiver);\n    ownedProvision.nodes.length = 0;\n    recordReceiverInputProvisionRolledBack();\n  });\n  return provision;\n}\n\nfunction currentComponentOwnsReceiver(receiver: object): boolean {\n  const component = GLOBAL_STATE.componentRefs;\n  if (!component) return false;\n  return (getPrimitiveReceiverToken(component.element) ?? component) === receiver;\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAOP,MAAM,wBAAwB,oBAAI,QAGhC;AAEK,SAAS,2BACd,aACA,UACA,UACG;AACH,MAAI,CAAC,eAAe,CAAC,SAAU,QAAO,UAAU,QAAQ;AACxD,MAAI,6BAA6B,QAAQ,EAAG,QAAO,SAAS;AAE5D,MAAI;AACJ,QAAM,YAAuC;AAAA,IAC3C,cAAc,MAAY;AACxB,UAAI,cAAc,QAAW;AAC3B,oBAAY,gBAAgB,aAAa,QAAQ;AAAA,MACnD;AACA,UAAI,CAAC,UAAU,MAAM,SAAS,IAAI,EAAG,WAAU,MAAM,KAAK,IAAI;AAAA,IAChE;AAAA,EACF;AACA,SAAO,mBAAmB,WAAW,QAAQ;AAC/C;AAEO,SAAS,4BACd,aACA,UACM;AACN,MAAI,CAAC,YAAa;AAClB,QAAM,YAAY,sBAAsB,IAAI,WAAW;AACvD,QAAM,YAAY,WAAW,IAAI,QAAQ;AACzC,MAAI,CAAC,aAAa,UAAU,QAAS;AAErC,YAAU,UAAU;AACpB,YAAW,OAAO,QAAQ;AAC1B,aAAW,QAAQ,UAAU,MAAO,uBAAsB,IAAI;AAC9D,YAAU,MAAM,SAAS;AACzB,sCAAoC;AACtC;AAEA,SAAS,gBACP,aACA,UACwB;AACxB,MAAI,YAAY,sBAAsB,IAAI,WAAW;AACrD,MAAI,CAAC,WAAW;AACd,gBAAY,oBAAI,QAAQ;AACxB,0BAAsB,IAAI,aAAa,SAAS;AAAA,EAClD;AACA,MAAI,YAAY,UAAU,IAAI,QAAQ;AACtC,MAAI,UAAW,QAAO;AAEtB,cAAY,EAAE,OAAO,CAAC,GAAG,SAAS,MAAM;AACxC,YAAU,IAAI,UAAU,SAAS;AACjC,sCAAoC;AACpC,QAAM,iBAAiB;AACvB,cAAY,SAAS,MAAM;AACzB,QAAI,eAAe,QAAS;AAC5B,mBAAe,UAAU;AACzB,cAAW,OAAO,QAAQ;AAC1B,mBAAe,MAAM,SAAS;AAC9B,2CAAuC;AAAA,EACzC,CAAC;AACD,SAAO;AACT;AAEA,SAAS,6BAA6B,UAA2B;AAC/D,QAAM,YAAY,aAAa;AAC/B,MAAI,CAAC,UAAW,QAAO;AACvB,UAAQ,0BAA0B,UAAU,OAAO,KAAK,eAAe;AACzE;",
+  "names": []
+}

package/dist/lib/signals/render-consumer.d.ts

@@ -0,0 +1,21 @@
+export interface SignalRenderConsumer {
+    readonly debugName: string;
+    readonly releaseCount: number;
+    markClean(): void;
+}
+export interface SignalRenderConsumerOptions {
+    debugName: string;
+    invalidate(): void;
+}
+export interface ComponentSignalRenderOwner {
+    signalConsumer: SignalRenderConsumer | undefined;
+}
+export interface ComponentSignalReadOptions extends SignalRenderConsumerOptions {
+    onMaterialize(): void;
+}
+/** @internal Opaque identity for repository-local passive ownership correlation. */
+export declare function signalRenderConsumerIdentity(consumer: SignalRenderConsumer): object | undefined;
+export declare function createSignalRenderConsumer(options: SignalRenderConsumerOptions): SignalRenderConsumer;
+export declare function collectSignalReads<T>(consumer: SignalRenderConsumer, callback: (commit: () => void) => T): T;
+export declare function collectComponentSignalReads<T>(owner: ComponentSignalRenderOwner, createOptions: () => ComponentSignalReadOptions, callback: (commit: () => void) => T): T;
+export declare function disposeSignalRenderConsumer(consumer: SignalRenderConsumer): void;

package/dist/lib/signals/render-consumer.js

@@ -0,0 +1,218 @@
+import {
+  recordRendererConsumerCreated,
+  recordRendererConsumerReleased,
+  recordRendererEdgeCreated,
+  recordRendererEdgeReleased,
+  recordRendererEdgeReused,
+  recordLazyRendererConsumerCreated,
+  withSignalTracking
+} from "./graph.js";
+import {
+  beginReactiveCollection,
+  collectReactiveDependency,
+  disposeReactiveConsumer,
+  finishReactiveCollection,
+  linkReactiveEdgeToSource,
+  rollbackReactiveCollection,
+  unlinkReactiveEdgeFromSource
+} from "./edge.js";
+const consumerStates = /* @__PURE__ */ new WeakMap();
+function signalRenderConsumerIdentity(consumer) {
+  return consumerStates.get(consumer);
+}
+function createSignalRenderConsumer(options) {
+  const state = {
+    dependencyHead: void 0,
+    dependencyTail: void 0,
+    dependencyFreeHead: void 0,
+    dependencyFreeCount: 0,
+    dependencyCount: 0,
+    dependencyHighWater: 0,
+    collectionCursor: void 0,
+    collectionGeneration: 0,
+    collecting: false,
+    dirty: true,
+    disposed: false,
+    releaseCount: 0,
+    renderInvalidation: true,
+    addDependency(node) {
+      if (!state.collecting) return;
+      const cursor = state.collectionCursor;
+      if (cursor?.source === node && cursor.collectionGeneration !== state.collectionGeneration) {
+        cursor.collectionGeneration = state.collectionGeneration;
+        cursor.collectionKind = "reused";
+        state.collectionCursor = cursor.consumerNext;
+        return;
+      }
+      collectReactiveDependency(state, node);
+    },
+    notify() {
+      if (state.disposed || state.dirty) return;
+      state.dirty = true;
+      options.invalidate();
+    }
+  };
+  const consumer = {
+    debugName: options.debugName,
+    get releaseCount() {
+      return state.releaseCount;
+    },
+    markClean() {
+      if (!state.disposed) state.dirty = false;
+    }
+  };
+  consumerStates.set(consumer, state);
+  recordRendererConsumerCreated();
+  return consumer;
+}
+function collectSignalReads(consumer, callback) {
+  const state = getConsumerState(consumer);
+  if (state.disposed) {
+    return withSignalTracking(
+      { addDependency: () => {
+      } },
+      () => callback(() => {
+      })
+    );
+  }
+  beginReactiveCollection(state);
+  state.collecting = true;
+  let committed = false;
+  const commit = () => {
+    if (committed) return;
+    committed = true;
+    state.collecting = false;
+    if (!state.disposed) commitCollectedDependencies(state);
+    else rollbackReactiveCollection(state);
+  };
+  try {
+    const result = withSignalTracking(state, () => callback(commit));
+    commit();
+    return result;
+  } catch (error) {
+    if (!committed) rollbackReactiveCollection(state);
+    throw error;
+  } finally {
+    state.collecting = false;
+  }
+}
+function collectComponentSignalReads(owner, createOptions, callback) {
+  let consumer = owner.signalConsumer;
+  let state = consumer === void 0 ? void 0 : getConsumerState(consumer);
+  let provisional = false;
+  let committed = false;
+  let onMaterialize;
+  let collector;
+  if (state === void 0) {
+    collector = {
+      addDependency(node) {
+        if (committed) return;
+        if (state === void 0) {
+          const options = createOptions();
+          onMaterialize = options.onMaterialize;
+          consumer = createSignalRenderConsumer(options);
+          state = getConsumerState(consumer);
+          provisional = true;
+          recordLazyRendererConsumerCreated();
+          beginConsumerCollection(state);
+        }
+        state.addDependency(node);
+      }
+    };
+  } else {
+    beginConsumerCollection(state);
+    collector = state;
+  }
+  const commit = () => {
+    if (committed) return;
+    committed = true;
+    if (state === void 0 || consumer === void 0) return;
+    state.collecting = false;
+    commitCollectedDependencies(state);
+    if (state.dependencyCount === 0) {
+      if (owner.signalConsumer === consumer) owner.signalConsumer = void 0;
+      disposeSignalRenderConsumer(consumer);
+    } else if (provisional) {
+      owner.signalConsumer = consumer;
+      onMaterialize();
+    }
+  };
+  try {
+    const result = withSignalTracking(collector, () => callback(commit));
+    commit();
+    return result;
+  } catch (error) {
+    if (!committed && state !== void 0) {
+      rollbackReactiveCollection(state);
+      if (provisional && consumer !== void 0) {
+        disposeSignalRenderConsumer(consumer);
+      }
+    }
+    throw error;
+  } finally {
+    if (state !== void 0) state.collecting = false;
+  }
+}
+function disposeSignalRenderConsumer(consumer) {
+  const state = getConsumerState(consumer);
+  if (state.disposed) return;
+  state.disposed = true;
+  state.collectionGeneration++;
+  state.collecting = false;
+  disposeReactiveConsumer(state, releaseRendererEdge);
+  state.releaseCount++;
+  recordRendererConsumerReleased();
+}
+function getConsumerState(consumer) {
+  const state = consumerStates.get(consumer);
+  if (state === void 0) {
+    throw new TypeError("Expected a signal render consumer created by Pibbl.");
+  }
+  return state;
+}
+function beginConsumerCollection(state) {
+  beginReactiveCollection(state);
+  state.collecting = true;
+}
+function commitCollectedDependencies(state) {
+  const onlyEdge = state.dependencyHead;
+  if (onlyEdge !== void 0 && onlyEdge.consumerNext === void 0 && onlyEdge.collectionGeneration === state.collectionGeneration && onlyEdge.sourceLinked && onlyEdge.collectionKind === "reused") {
+    recordRendererEdgeReused();
+    onlyEdge.observedVersion = onlyEdge.source.version;
+    onlyEdge.collectionKind = void 0;
+    state.collectionCursor = void 0;
+    return;
+  }
+  finishReactiveCollection(
+    state,
+    (edge) => {
+      const restored = !edge.sourceLinked;
+      if (restored) {
+        const source = edge.source;
+        linkReactiveEdgeToSource(edge, source.observe?.());
+      }
+      if (edge.collectionKind === "new") {
+        recordRendererEdgeCreated();
+      } else {
+        recordRendererEdgeReused(restored);
+      }
+      edge.everPublished = true;
+      edge.observedVersion = edge.source.version;
+      edge.collectionKind = void 0;
+    },
+    releaseRendererEdge
+  );
+}
+function releaseRendererEdge(edge) {
+  if (!edge.sourceLinked) return;
+  unlinkReactiveEdgeFromSource(edge);
+  recordRendererEdgeReleased();
+}
+export {
+  collectComponentSignalReads,
+  collectSignalReads,
+  createSignalRenderConsumer,
+  disposeSignalRenderConsumer,
+  signalRenderConsumerIdentity
+};
+//# sourceMappingURL=render-consumer.js.map

package/dist/lib/signals/render-consumer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/signals/render-consumer.ts"],
+  "sourcesContent": ["import {\n  recordRendererConsumerCreated,\n  recordRendererConsumerReleased,\n  recordRendererEdgeCreated,\n  recordRendererEdgeReleased,\n  recordRendererEdgeReused,\n  recordLazyRendererConsumerCreated,\n  type SignalDependencyCollector,\n  type SignalNode,\n  withSignalTracking,\n} from './graph.js';\nimport {\n  beginReactiveCollection,\n  collectReactiveDependency,\n  disposeReactiveConsumer,\n  finishReactiveCollection,\n  linkReactiveEdgeToSource,\n  rollbackReactiveCollection,\n  unlinkReactiveEdgeFromSource,\n  type ReactiveEdge,\n  type SignalDependencyConsumer,\n} from './edge.js';\n\nexport interface SignalRenderConsumer {\n  readonly debugName: string;\n  readonly releaseCount: number;\n  markClean(): void;\n}\n\nexport interface SignalRenderConsumerOptions {\n  debugName: string;\n  invalidate(): void;\n}\n\nexport interface ComponentSignalRenderOwner {\n  signalConsumer: SignalRenderConsumer | undefined;\n}\n\nexport interface ComponentSignalReadOptions extends SignalRenderConsumerOptions {\n  onMaterialize(): void;\n}\n\ninterface ConsumerState extends SignalDependencyConsumer {\n  collecting: boolean;\n  dirty: boolean;\n  disposed: boolean;\n  releaseCount: number;\n}\n\nconst consumerStates = new WeakMap<SignalRenderConsumer, ConsumerState>();\n\n/** @internal Opaque identity for repository-local passive ownership correlation. */\nexport function signalRenderConsumerIdentity(consumer: SignalRenderConsumer): object | undefined {\n  return consumerStates.get(consumer);\n}\n\nexport function createSignalRenderConsumer(\n  options: SignalRenderConsumerOptions,\n): SignalRenderConsumer {\n  const state: ConsumerState = {\n    dependencyHead: undefined,\n    dependencyTail: undefined,\n    dependencyFreeHead: undefined,\n    dependencyFreeCount: 0,\n    dependencyCount: 0,\n    dependencyHighWater: 0,\n    collectionCursor: undefined,\n    collectionGeneration: 0,\n    collecting: false,\n    dirty: true,\n    disposed: false,\n    releaseCount: 0,\n    renderInvalidation: true,\n    addDependency(node): void {\n      if (!state.collecting) return;\n      const cursor = state.collectionCursor;\n      if (\n        cursor?.source === node &&\n        cursor.collectionGeneration !== state.collectionGeneration\n      ) {\n        cursor.collectionGeneration = state.collectionGeneration;\n        cursor.collectionKind = 'reused';\n        state.collectionCursor = cursor.consumerNext;\n        return;\n      }\n      collectReactiveDependency(state, node);\n    },\n    notify(): void {\n      if (state.disposed || state.dirty) return;\n      state.dirty = true;\n      options.invalidate();\n    },\n  };\n\n  const consumer: SignalRenderConsumer = {\n    debugName: options.debugName,\n    get releaseCount(): number {\n      return state.releaseCount;\n    },\n    markClean(): void {\n      if (!state.disposed) state.dirty = false;\n    },\n  };\n\n  consumerStates.set(consumer, state);\n  recordRendererConsumerCreated();\n  return consumer;\n}\n\nexport function collectSignalReads<T>(\n  consumer: SignalRenderConsumer,\n  callback: (commit: () => void) => T,\n): T {\n  const state = getConsumerState(consumer);\n  if (state.disposed) {\n    return withSignalTracking(\n      { addDependency: () => {} },\n      () => callback(() => {}),\n    );\n  }\n\n  beginReactiveCollection(state);\n  state.collecting = true;\n  let committed = false;\n  const commit = (): void => {\n    if (committed) return;\n    committed = true;\n    state.collecting = false;\n    if (!state.disposed) commitCollectedDependencies(state);\n    else rollbackReactiveCollection(state);\n  };\n  try {\n    const result = withSignalTracking(state, () => callback(commit));\n    commit();\n    return result;\n  } catch (error) {\n    if (!committed) rollbackReactiveCollection(state);\n    throw error;\n  } finally {\n    state.collecting = false;\n  }\n}\n\nexport function collectComponentSignalReads<T>(\n  owner: ComponentSignalRenderOwner,\n  createOptions: () => ComponentSignalReadOptions,\n  callback: (commit: () => void) => T,\n): T {\n  let consumer = owner.signalConsumer;\n  let state = consumer === undefined ? undefined : getConsumerState(consumer);\n  let provisional = false;\n  let committed = false;\n  let onMaterialize: (() => void) | undefined;\n\n  let collector: SignalDependencyCollector;\n  if (state === undefined) {\n    collector = {\n      addDependency(node: SignalNode<unknown>): void {\n        if (committed) return;\n        if (state === undefined) {\n          const options = createOptions();\n          onMaterialize = options.onMaterialize;\n          consumer = createSignalRenderConsumer(options);\n          state = getConsumerState(consumer);\n          provisional = true;\n          recordLazyRendererConsumerCreated();\n          beginConsumerCollection(state);\n        }\n        state.addDependency(node);\n      },\n    };\n  } else {\n    beginConsumerCollection(state);\n    collector = state;\n  }\n  const commit = (): void => {\n    if (committed) return;\n    committed = true;\n    if (state === undefined || consumer === undefined) return;\n    state.collecting = false;\n    commitCollectedDependencies(state);\n    if (state.dependencyCount === 0) {\n      if (owner.signalConsumer === consumer) owner.signalConsumer = undefined;\n      disposeSignalRenderConsumer(consumer);\n    } else if (provisional) {\n      owner.signalConsumer = consumer;\n      onMaterialize!();\n    }\n  };\n\n  try {\n    const result = withSignalTracking(collector, () => callback(commit));\n    commit();\n    return result;\n  } catch (error) {\n    if (!committed && state !== undefined) {\n      rollbackReactiveCollection(state);\n      if (provisional && consumer !== undefined) {\n        disposeSignalRenderConsumer(consumer);\n      }\n    }\n    throw error;\n  } finally {\n    if (state !== undefined) state.collecting = false;\n  }\n}\n\nexport function disposeSignalRenderConsumer(consumer: SignalRenderConsumer): void {\n  const state = getConsumerState(consumer);\n  if (state.disposed) return;\n  state.disposed = true;\n  state.collectionGeneration++;\n  state.collecting = false;\n  disposeReactiveConsumer(state, releaseRendererEdge);\n  state.releaseCount++;\n  recordRendererConsumerReleased();\n}\n\nfunction getConsumerState(consumer: SignalRenderConsumer): ConsumerState {\n  const state = consumerStates.get(consumer);\n  if (state === undefined) {\n    throw new TypeError('Expected a signal render consumer created by Pibbl.');\n  }\n  return state;\n}\n\nfunction beginConsumerCollection(state: ConsumerState): void {\n  beginReactiveCollection(state);\n  state.collecting = true;\n}\n\nfunction commitCollectedDependencies(state: ConsumerState): void {\n  const onlyEdge = state.dependencyHead;\n  if (\n    onlyEdge !== undefined &&\n    onlyEdge.consumerNext === undefined &&\n    onlyEdge.collectionGeneration === state.collectionGeneration &&\n    onlyEdge.sourceLinked &&\n    onlyEdge.collectionKind === 'reused'\n  ) {\n    recordRendererEdgeReused();\n    onlyEdge.observedVersion = onlyEdge.source!.version;\n    onlyEdge.collectionKind = undefined;\n    state.collectionCursor = undefined;\n    return;\n  }\n  finishReactiveCollection(\n    state,\n    edge => {\n      const restored = !edge.sourceLinked;\n      if (restored) {\n        const source = edge.source!;\n        linkReactiveEdgeToSource(edge, source.observe?.());\n      }\n      if (edge.collectionKind === 'new') {\n        recordRendererEdgeCreated();\n      } else {\n        recordRendererEdgeReused(restored);\n      }\n      edge.everPublished = true;\n      edge.observedVersion = edge.source!.version;\n      edge.collectionKind = undefined;\n    },\n    releaseRendererEdge,\n  );\n}\n\nfunction releaseRendererEdge(edge: ReactiveEdge): void {\n  if (!edge.sourceLinked) return;\n  unlinkReactiveEdgeFromSource(edge);\n  recordRendererEdgeReleased();\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/signals/resolve-signal-value.d.ts

@@ -0,0 +1,10 @@
+import type { SignalValue } from './types.js';
+/**
+ * Returns a literal input unchanged or reads its current value when it is a Pibbl signal.
+ *
+ * @param value - Literal value or signal to read. See {@link SignalValue}.
+ * @returns The literal value, or the signal's current value.
+ *
+ * @see {@link SignalValue}
+ */
+export declare function resolveSignalValue<T>(value: SignalValue<T>): T;

package/dist/lib/signals/resolve-signal-value.js

@@ -0,0 +1,17 @@
+import {
+  isSignal,
+  recordPlainInputResolution,
+  recordSignalInputResolution
+} from "./graph.js";
+function resolveSignalValue(value) {
+  if (isSignal(value)) {
+    recordSignalInputResolution();
+    return value.get();
+  }
+  recordPlainInputResolution();
+  return value;
+}
+export {
+  resolveSignalValue
+};
+//# sourceMappingURL=resolve-signal-value.js.map

package/dist/lib/signals/resolve-signal-value.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/signals/resolve-signal-value.ts"],
+  "sourcesContent": ["import {\n  isSignal,\n  recordPlainInputResolution,\n  recordSignalInputResolution,\n} from './graph.js';\nimport type { SignalValue } from './types.js';\n\n/**\n * Returns a literal input unchanged or reads its current value when it is a Pibbl signal.\n *\n * @param value - Literal value or signal to read. See {@link SignalValue}.\n * @returns The literal value, or the signal's current value.\n *\n * @see {@link SignalValue}\n */\nexport function resolveSignalValue<T>(value: SignalValue<T>): T {\n  if (isSignal(value)) {\n    recordSignalInputResolution();\n    return value.get() as T;\n  }\n  recordPlainInputResolution();\n  return value;\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,SAAS,mBAAsB,OAA0B;AAC9D,MAAI,SAAS,KAAK,GAAG;AACnB,gCAA4B;AAC5B,WAAO,MAAM,IAAI;AAAA,EACnB;AACA,6BAA2B;AAC3B,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/signals/types.d.ts

@@ -0,0 +1,80 @@
+import type { batch, computed, signal } from "./graph.js";
+import type { resolveSignalValue } from "./resolve-signal-value.js";
+import type { usePlayback } from "../hooks/use-playback.js";
+/**
+ * Compares previous and next values to decide whether a signal change should be published.
+ *
+ * @param previous - Previously stored value.
+ * @param next - Proposed replacement value.
+ * @returns True when the values are equivalent and a change should be suppressed.
+ *
+ * @see {@link SignalOptions}
+ */
+export type SignalEquals<T> = (previous: T, next: T) => boolean;
+declare const signalBrand: unique symbol;
+/**
+ * Equality comparison and diagnostic naming options for a signal.
+ *
+ * @see {@link SignalEquals}
+ * @see {@link computed}
+ * @see {@link signal}
+ */
+export interface SignalOptions<T> {
+    /** Compares old and new values to suppress equivalent updates; defaults to Object.is. See {@link SignalEquals}. */
+    equals?: SignalEquals<T>;
+    /** Optional label used in diagnostics. See {@link SignalOptions}. */
+    debugName?: string;
+}
+/**
+ * A readonly reactive value; get records a dependency when called by a tracked consumer.
+ *
+ * @see {@link SignalValue}
+ * @see {@link WritableSignal}
+ * @see {@link computed}
+ */
+export interface Signal<T> {
+    readonly [signalBrand]: T;
+    /**
+     * Reads the current value and records a dependency in the active tracked consumer. See
+     * {@link Signal}.
+     * @returns The current value, recording a dependency when called from a tracked consumer.
+     */
+    get(): T;
+}
+/**
+ * A literal value or a signal supplying that value to a receiver-owned input.
+ *
+ * @see {@link Signal}
+ * @see {@link resolveSignalValue}
+ * @see {@link usePlayback}
+ */
+export type SignalValue<T> = T | Signal<T>;
+/**
+ * A signal with synchronous replacement and update operations and a readonly view.
+ *
+ * @see {@link Signal}
+ * @see {@link batch}
+ * @see {@link signal}
+ */
+export interface WritableSignal<T> extends Signal<T> {
+    /**
+     * Synchronously replaces the value, publishing only when the equality comparison reports a
+     * change. See {@link WritableSignal}.
+     * @param value - Replacement value to compare with the currently stored value.
+     */
+    set(value: T): void;
+    /**
+     * Computes a replacement from the current value and applies the signal's equality policy. See
+     * {@link WritableSignal}.
+     * @param update - Synchronous function receiving the current value and returning its
+     * replacement.
+     */
+    update(update: (current: T) => T): void;
+    /**
+     * Returns a readonly signal view of this same reactive value. See {@link Signal}.
+     * @returns A readonly view of the same signal, without set or update operations. See
+     * {@link Signal} .
+     */
+    asReadonly(): Signal<T>;
+}
+export {};