@opetope/react 0.13.0 → 0.15.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/command-hook-controller.ts","../src/command-hook.ts","../src/idle-subscription.ts","../src/selection-hooks.ts","../src/model-selection-snapshot.ts","../src/model-selection-store.ts","../src/model-hook.ts","../src/requires-models.ts","../src/resource-hook.ts","../src/slot.tsx"],"sourcesContent":["import { CommandError } from '@opetope/core';\nimport { compatibleAbortReason, isCancellation, reportDetachedError } from '@opetope/core/internal';\nimport type { CommandInputArgs, CallRunOptions } from '@opetope/core/internal';\n\nimport type { CommandOutcome } from './command';\nimport { ContributionError } from './errors';\n\ntype CommandRunOptions<Output> = Readonly<{\n  onFailure?: (error: unknown) => PromiseLike<void> | void;\n  onSuccess?: (value: Output) => PromiseLike<void> | void;\n  signal?: AbortSignal;\n}>;\n\ntype CommandRun<Input, Output> = {\n  (input: Input, options?: CommandRunOptions<Output>): Promise<CommandOutcome<Output>>;\n  (...args: [...CommandInputArgs<Input>, options?: CommandRunOptions<Output>]): Promise<CommandOutcome<Output>>;\n};\n\ntype CommandInvoker = Readonly<{\n  run: (input: never, options?: CallRunOptions<unknown>) => Promise<unknown>;\n}>;\n\ntype CommandNotification<Output> = (inFlight: boolean, outcome?: CommandOutcome<Output>) => void;\n\ntype CommandRequest<Input, Output> = {\n  input: Input | undefined;\n  options: CommandRunOptions<Output> | undefined;\n  readonly promise: Promise<CommandOutcome<Output>>;\n  resolve: ((outcome: CommandOutcome<Output>) => void) | undefined;\n};\n\nfunction failureOutcome<Output>(options: CommandRunOptions<Output> | undefined, error: unknown): CommandOutcome<never> {\n  if (isCancellation(error)) return { reason: error, kind: 'cancelled' };\n\n  try {\n    const notification = options?.onFailure?.(error);\n\n    if (notification !== undefined) void Promise.resolve(notification).catch(reportDetachedError);\n  } catch (callbackError) {\n    reportDetachedError(callbackError);\n  }\n\n  return { error, kind: 'failed' };\n}\n\nfunction runOptions<Output>(options: CommandRunOptions<Output> | undefined): CallRunOptions<Output> | undefined {\n  const onSuccess = options?.onSuccess;\n  const signal = options?.signal;\n\n  if (onSuccess === undefined) return signal === undefined ? undefined : { signal };\n\n  return signal === undefined ? { onSuccess } : { onSuccess, signal };\n}\n\nfunction requestOf<Input, Output>(\n  input: Input,\n  options: CommandRunOptions<Output> | undefined,\n): CommandRequest<Input, Output> {\n  let resolve!: (outcome: CommandOutcome<Output>) => void;\n  const promise = new Promise<CommandOutcome<Output>>(settle => {\n    resolve = settle;\n  });\n\n  return { input, options: options === undefined ? undefined : { ...options }, promise, resolve };\n}\n\nfunction settle<Input, Output>(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n  const resolve = request.resolve;\n  request.input = undefined;\n  request.options = undefined;\n  request.resolve = undefined;\n  resolve?.(outcome);\n}\n\n/**\n * D203: the consumer keeps a status, not a schedule. Every `run` reaches the command, and what the command was\n * declared with — `concurrency`, `memoize`, `dedupe` — decides what happens to it. What stays\n * local is what only this consumer knows: whether it is mounted, its own input signal, and the outcome it shows.\n */\nclass CommandHookController<Input, Output> {\n  readonly run: CommandRun<Input, Output> = ((input: Input, options?: CommandRunOptions<Output>) => {\n    if (this.notify === undefined) {\n      return Promise.resolve({\n        reason: new ContributionError('inactive', 'Command consumer is not mounted.'),\n        kind: 'cancelled' as const,\n      });\n    }\n\n    const aborted = this.cancelledInput(options);\n\n    if (aborted !== undefined) return Promise.resolve(aborted);\n\n    const request = requestOf(input, options);\n    this.start(request);\n\n    return request.promise;\n  }) as CommandRun<Input, Output>;\n  private inFlight = 0;\n  private notify: CommandNotification<Output> | undefined;\n\n  constructor(private readonly invoker: CommandInvoker) {}\n\n  attach(notify: CommandNotification<Output>): () => void {\n    this.notify = notify;\n\n    return () => {\n      if (this.notify !== notify) return;\n\n      this.notify = undefined;\n    };\n  }\n\n  synchronize(): void {\n    this.notify?.(this.inFlight > 0);\n  }\n\n  private aborted(signal: AbortSignal): CommandOutcome<never> {\n    return {\n      reason: new CommandError('cancelled', 'Command input was cancelled.', compatibleAbortReason(signal)),\n      kind: 'cancelled',\n    };\n  }\n\n  private cancelledInput(options: CommandRunOptions<Output> | undefined): CommandOutcome<never> | undefined {\n    return options?.signal?.aborted === true ? this.aborted(options.signal) : undefined;\n  }\n\n  private finish(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n    if (request.resolve === undefined) return;\n\n    this.inFlight -= 1;\n    settle(request, outcome);\n    this.notify?.(this.inFlight > 0, outcome);\n  }\n\n  private invoke(request: CommandRequest<Input, Output>): void {\n    let invocation: Promise<Output>;\n\n    try {\n      invocation = this.invoker.run(request.input as never, runOptions(request.options) as never) as Promise<Output>;\n      request.input = undefined;\n    } catch (error) {\n      this.finish(request, failureOutcome(request.options, error));\n\n      return;\n    }\n\n    void invocation.then(\n      value => this.finish(request, { kind: 'ok', value }),\n      (error: unknown) => this.finish(request, failureOutcome(request.options, error)),\n    );\n  }\n\n  private start(request: CommandRequest<Input, Output>): void {\n    this.inFlight += 1;\n    // Reserve the flight before publishing: a reentrant run must already see this consumer as busy.\n    this.notify?.(true);\n    this.invoke(request);\n  }\n}\n\nexport { CommandHookController };\nexport type { CommandInvoker, CommandRun };\n","import { useInsertionEffect, useLayoutEffect, useMemo, useState } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker, CommandRun } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { useFrame } from './mount-context';\n\n/** D292: a cancellation is not an answer of the product, so it never settles into the outcome this hook shows. */\ntype SettledOutcome<Output> = Exclude<CommandOutcome<Output>, { readonly kind: 'cancelled' }>;\n\ninterface CommandHookStatus<Output> {\n  readonly inFlight: boolean;\n  readonly outcome: SettledOutcome<Output> | undefined;\n}\n\nconst emptyStatus: CommandHookStatus<never> = { inFlight: false, outcome: undefined };\n\ntype CommandHook<Input, Output> = CommandHookStatus<Output> & {\n  readonly run: CommandRun<Input, Output>;\n};\n\ntype CommandHookState<Input, Output> = CommandHookStatus<Output> & {\n  readonly slot: CommandHookController<Input, Output>;\n};\n\n/** D292: a cancellation moves nothing, so it is the same non-event as a notification without an outcome at all. */\nfunction settledOutcome<Output>(outcome: CommandOutcome<Output> | undefined): SettledOutcome<Output> | undefined {\n  return outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n}\n\nfunction unchangedState<Input, Output>(\n  current: CommandHookState<Input, Output>,\n  slot: CommandHookController<Input, Output>,\n  inFlight: boolean,\n  settled: SettledOutcome<Output> | undefined,\n): boolean {\n  return settled === undefined && current.slot === slot && current.inFlight === inFlight;\n}\n\nfunction nextState<Input, Output>(\n  current: CommandHookState<Input, Output>,\n  slot: CommandHookController<Input, Output>,\n  inFlight: boolean,\n  outcome?: CommandOutcome<Output>,\n): CommandHookState<Input, Output> {\n  const settled = settledOutcome(outcome);\n\n  if (unchangedState(current, slot, inFlight, settled)) return current;\n\n  // A new run clears nothing: the previous answer stays readable while its retry is in flight.\n  const previous = current.slot === slot ? current.outcome : undefined;\n\n  return { inFlight, outcome: settled ?? previous, slot };\n}\n\nfunction useCommandSlot<Input, Output>(invoker: CommandInvoker): CommandHookController<Input, Output> {\n  // Slots are inert until commit. An interrupted render cannot fence the committed source or admit its own work.\n  const [slots] = useState(() => new WeakMap<object, CommandHookController<Input, Output>>());\n  let slot = slots.get(invoker);\n\n  if (slot === undefined) {\n    slot = new CommandHookController(invoker);\n    slots.set(invoker, slot);\n  }\n\n  return slot;\n}\n\n/**\n * The status half of a consumer, apart from what it is a consumer of. D321 gives a resource the same two verbs a\n * command has, so the same three React hooks answer for them: the state of this consumer, the attachment that moves\n * it, and the synchronisation of a slot that was already busy when this mount arrived.\n */\nfunction useCommandStatus<Input, Output>(\n  currentSlot: CommandHookController<Input, Output>,\n): CommandHook<Input, Output> {\n  const [hookState, setHookState] = useState<CommandHookState<Input, Output>>(() => ({\n    inFlight: false,\n    outcome: undefined,\n    slot: currentSlot,\n  }));\n  useInsertionEffect(\n    () =>\n      currentSlot.attach((inFlight, outcome) =>\n        setHookState(current => nextState(current, currentSlot, inFlight, outcome)),\n      ),\n    [currentSlot],\n  );\n  useLayoutEffect(() => currentSlot.synchronize(), [currentSlot]);\n  const { inFlight, outcome } = hookState.slot === currentSlot ? hookState : emptyStatus;\n  const run = currentSlot.run;\n\n  return useMemo(() => ({ inFlight, outcome, run }), [inFlight, outcome, run]);\n}\n\nfunction useCommand<Input, Output>(command: Command<Input, Output>): CommandHook<Input, Output> {\n  const frame = useFrame();\n  const record = frame.commandRecords.get(command);\n\n  if (record === undefined) {\n    throw new ContributionError('missing', `Command ${command.id} is not bound in this contribution.`);\n  }\n\n  return useCommandStatus(useCommandSlot<Input, Output>(record.invoker));\n}\n\nexport { useCommand, useCommandStatus };\nexport type { CommandHook };\n","const idleRelease = (): void => undefined;\nconst subscribeIdle = (): (() => void) => idleRelease;\nconst idleRevision = (): number => 0;\n\nexport { idleRevision, subscribeIdle };\n","import { useInsertionEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport type { CommandHook } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { idleRevision, subscribeIdle } from './idle-subscription';\nimport type { SelectedResource } from './model-selection-snapshot';\nimport { useFrame } from './mount-context';\nimport type { Frame } from './mount-frame';\nimport { resourceInvokers } from './resource-command';\nimport type { ResourceInvokers } from './resource-command';\n\ntype CommandSelection = Readonly<Record<string, Command<never, unknown>>>;\ntype ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;\n/** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */\ntype SelectedResourceHook = Readonly<{\n  pagination: Readonly<{ loadNext: CommandHook<never, unknown>; state: unknown }> | undefined;\n  refresh: CommandHook<never, unknown>;\n  reset: CommandHook<never, unknown>;\n  retry: CommandHook<never, unknown>;\n  state: unknown;\n}>;\ntype SelectionHooks = Readonly<Record<PropertyKey, CommandHook<never, unknown> | SelectedResourceHook>>;\n\nconst emptyHooks: SelectionHooks = Object.freeze({});\n\ntype CommandEntry = {\n  detach: (() => void) | undefined;\n  hook: CommandHook<never, unknown>;\n  readonly invoker: CommandInvoker;\n  readonly slot: CommandHookController<never, unknown>;\n};\n\n/** D359: one key of a selection, four consumers. The record is the value; `entries` still holds one entry per key. */\ntype ResourceEntry = {\n  /** D359: the value this key hands the render, kept on the record so a still frame is the same object again. */\n  hook: SelectedResourceHook;\n  readonly kind: 'resource';\n  readonly loadNext: CommandEntry;\n  /** Whether the declaration carried the pagination capability at all. */\n  readonly paginated: boolean;\n  readonly refresh: CommandEntry;\n  readonly reset: CommandEntry;\n  readonly retry: CommandEntry;\n};\n\ntype SelectionEntry = CommandEntry | ResourceEntry;\n\nfunction isResourceEntry(entry: SelectionEntry): entry is ResourceEntry {\n  return 'kind' in entry;\n}\n\nfunction createEntry(invoker: CommandInvoker): CommandEntry {\n  const slot = new CommandHookController<never, unknown>(invoker);\n\n  return { detach: undefined, hook: { inFlight: false, outcome: undefined, run: slot.run }, invoker, slot };\n}\n\nfunction unchangedHook(previous: CommandHook<never, unknown>, next: CommandHook<never, unknown>): boolean {\n  return previous.inFlight === next.inFlight && Object.is(previous.outcome, next.outcome);\n}\n\nfunction updateEntry(entry: CommandEntry, inFlight: boolean, outcome?: CommandOutcome<unknown>): boolean {\n  const previous = entry.hook;\n\n  if (outcome === undefined && previous.inFlight === inFlight) return false;\n\n  // D292: only a settled non-cancelled outcome replaces the one this key shows; a retry keeps the previous answer.\n  const settled = outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n  const next = { inFlight, outcome: settled ?? previous.outcome, run: previous.run };\n\n  if (unchangedHook(previous, next)) return false;\n\n  entry.hook = next;\n\n  return true;\n}\n\nfunction selectEntry(previous: SelectionEntry | undefined, invoker: CommandInvoker): CommandEntry {\n  return previous !== undefined && !isResourceEntry(previous) && previous.invoker === invoker\n    ? previous\n    : createEntry(invoker);\n}\n\nfunction resourceHook(entry: Omit<ResourceEntry, 'hook'>, selected: SelectedResource): SelectedResourceHook {\n  return {\n    pagination: entry.paginated ? { loadNext: entry.loadNext.hook, state: selected.pagination } : undefined,\n    refresh: entry.refresh.hook,\n    reset: entry.reset.hook,\n    retry: entry.retry.hook,\n    state: selected.state,\n  };\n}\n\nfunction createResourceEntry(invokers: ResourceInvokers, selected: SelectedResource): ResourceEntry {\n  const parts = {\n    kind: 'resource' as const,\n    loadNext: createEntry(invokers.loadNext),\n    paginated: selected.pagination !== undefined,\n    refresh: createEntry(invokers.refresh),\n    reset: createEntry(invokers.reset),\n    retry: createEntry(invokers.retry),\n  };\n\n  return { ...parts, hook: resourceHook(parts, selected) };\n}\n\n/** The four commands of a Resource: the three verbs every one has, and `loadNext` only where one was declared. */\nfunction unchangedResourceCommands(entry: ResourceEntry): boolean {\n  const { hook } = entry;\n\n  return (\n    hook.refresh === entry.refresh.hook &&\n    hook.reset === entry.reset.hook &&\n    hook.retry === entry.retry.hook &&\n    (!entry.paginated || hook.pagination?.loadNext === entry.loadNext.hook)\n  );\n}\n\n/** What this selection read: the state of the Resource, and the state of its capability where it has one. */\nfunction unchangedResourceState(entry: ResourceEntry, selected: SelectedResource): boolean {\n  return Object.is(entry.hook.state, selected.state) && Object.is(entry.hook.pagination?.state, selected.pagination);\n}\n\nfunction unchangedResourceHook(entry: ResourceEntry, selected: SelectedResource): boolean {\n  return unchangedResourceCommands(entry) && unchangedResourceState(entry, selected);\n}\n\n/**\n * S6/D359: the same Resource that did not move answers the same object, so a child under `memo` is not re-rendered by\n * the mere act of reading it. Every part is a render input, so this is a memo and not a piece of state.\n */\nfunction selectResourceEntry(\n  previous: SelectionEntry | undefined,\n  invokers: ResourceInvokers,\n  selected: SelectedResource,\n): ResourceEntry {\n  if (previous === undefined || !isResourceEntry(previous) || previous.refresh.invoker !== invokers.refresh) {\n    return createResourceEntry(invokers, selected);\n  }\n\n  if (!unchangedResourceHook(previous, selected)) previous.hook = resourceHook(previous, selected);\n\n  return previous;\n}\n\nfunction commandEntries(entry: SelectionEntry): readonly CommandEntry[] {\n  return isResourceEntry(entry) ? [entry.refresh, entry.reset, entry.retry, entry.loadNext] : [entry];\n}\n\nfunction detachEntry(entry: SelectionEntry): void {\n  for (const command of commandEntries(entry)) {\n    command.detach?.();\n    command.detach = undefined;\n  }\n}\n\nfunction hookOf(entry: SelectionEntry): CommandHook<never, unknown> | SelectedResourceHook {\n  return entry.hook;\n}\n\n/** Selection is inert during render; only a committed selection can admit work or discard an old queue. */\nclass CommandGroup {\n  private entries = new Map<PropertyKey, SelectionEntry>();\n  /** One set of invokers per Resource identity, so `run` keeps its reference across renders (D359). */\n  private readonly invokers = new WeakMap<object, ResourceInvokers>();\n  private readonly listeners = new Set<() => void>();\n  private revision = 0;\n\n  close(): void {\n    for (const entry of this.entries.values()) detachEntry(entry);\n\n    this.entries.clear();\n  }\n\n  commit(selected: Map<PropertyKey, SelectionEntry>): void {\n    for (const [key, entry] of this.entries) {\n      if (selected.get(key) !== entry) detachEntry(entry);\n    }\n\n    this.entries = selected;\n\n    for (const entry of selected.values()) this.attachEntry(entry);\n  }\n\n  /** S7: the attach runs on every commit, so the verbs are named rather than gathered into an array. */\n  private attachEntry(entry: SelectionEntry): void {\n    if (isResourceEntry(entry)) {\n      this.attachCommand(entry.refresh);\n      this.attachCommand(entry.retry);\n      this.attachCommand(entry.reset);\n      this.attachCommand(entry.loadNext);\n\n      return;\n    }\n\n    this.attachCommand(entry);\n  }\n\n  private attachCommand(command: CommandEntry): void {\n    command.detach ??= command.slot.attach((inFlight, outcome) => {\n      if (!updateEntry(command, inFlight, outcome)) return;\n\n      this.revision += 1;\n\n      for (const listener of this.listeners) listener();\n    });\n  }\n\n  getSnapshot = (): number => this.revision;\n\n  /**\n   * D321: two outcomes no longer, but two kinds. A command that is not bound is still a `ContributionError`; a\n   * resource never appears in `frame.commandRecords`, so it is prepared from its own identity instead.\n   */\n  prepare(commands: CommandSelection, resources: ResourceSelection, frame: Frame): Map<PropertyKey, SelectionEntry> {\n    const selected = new Map<PropertyKey, SelectionEntry>();\n\n    for (const key of Reflect.ownKeys(commands)) {\n      if (!Object.prototype.propertyIsEnumerable.call(commands, key)) continue;\n\n      const command = (commands as Readonly<Record<PropertyKey, Command<never, unknown>>>)[key];\n      const record = command === undefined ? undefined : frame.commandRecords.get(command);\n\n      if (record === undefined) {\n        throw new ContributionError('missing', `Command at ${String(key)} is not bound in this contribution.`);\n      }\n\n      selected.set(key, selectEntry(this.entries.get(key), record.invoker));\n    }\n\n    for (const [key, resource] of resources) {\n      const invokers = resourceInvokers(resource.resource, this.invokers);\n\n      selected.set(key, selectResourceEntry(this.entries.get(key), invokers, resource));\n    }\n\n    return selected;\n  }\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n\n    return () => {\n      this.listeners.delete(listener);\n    };\n  };\n}\n\nfunction useCommandGroup(commands: CommandSelection, resources: ResourceSelection): CommandGroup | undefined {\n  const groupRef = useRef<CommandGroup | undefined>(undefined);\n  const populated =\n    resources.size > 0 ||\n    Reflect.ownKeys(commands).some(key => Object.prototype.propertyIsEnumerable.call(commands, key));\n\n  return populated ? (groupRef.current ??= new CommandGroup()) : undefined;\n}\n\n/** The consumers of one selection: a command per key, and the two verbs of a resource per key (D321). */\nfunction useSelectionHooks(commands: CommandSelection, resources: ResourceSelection): SelectionHooks {\n  const frame = useFrame();\n  const group = useCommandGroup(commands, resources);\n  const getSnapshot = group?.getSnapshot ?? idleRevision;\n  useSyncExternalStore(group?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n  const selected = group?.prepare(commands, resources, frame);\n  useInsertionEffect(() => () => group?.close(), [group]);\n  useInsertionEffect(() => {\n    if (selected !== undefined) group?.commit(selected);\n  });\n  useLayoutEffect(() => {\n    if (selected === undefined) return;\n\n    // S7: the same branch as the attach — this runs after every commit, and the arrays were pure allocation.\n    for (const entry of selected.values()) {\n      if (isResourceEntry(entry)) {\n        entry.refresh.slot.synchronize();\n        entry.retry.slot.synchronize();\n        entry.reset.slot.synchronize();\n        entry.loadNext.slot.synchronize();\n      } else entry.slot.synchronize();\n    }\n  });\n\n  return selected === undefined\n    ? emptyHooks\n    : Object.fromEntries([...selected].map(([key, entry]) => [key, hookOf(entry)]));\n}\n\nexport { useSelectionHooks };\nexport type { SelectionHooks };\n","import type { Readable, ResourceView } from '@opetope/core';\nimport {\n  isCallTarget,\n  isReadable,\n  isResourceView,\n  resourceViewDemands,\n  resourceViewReadable,\n} from '@opetope/core/internal';\nimport type { ResourceDemand } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\nimport type { AnyCommand } from './model-binding';\nimport { isResource } from './resource-command';\nimport type { AnyResource } from './resource-command';\n\ninterface SelectionRead {\n  <Value>(source: Readable<Value>): Value;\n  <Value, Selected>(source: Readable<Value>, select: (value: Value) => Selected): Selected;\n}\n\ninterface SelectionAcquire {\n  <Value>(view: ResourceView<Value>): Value;\n  <Value, Selected>(view: ResourceView<Value>, select: (value: Value) => Selected): Selected;\n}\n\ntype SelectionContext = Readonly<{ acquire: SelectionAcquire; read: SelectionRead }>;\ntype NonSelectionRecord =\n  | readonly unknown[]\n  | ((...arguments_: never[]) => unknown)\n  | (abstract new (...arguments_: never[]) => unknown)\n  | Date\n  | PromiseLike<unknown>\n  | ReadonlyMap<unknown, unknown>\n  | ReadonlySet<unknown>\n  | RegExp\n  | WeakMap<object, unknown>\n  | WeakSet<object>;\n/** A named interface needs no open index signature; container and callable results are not field selections. */\ntype SelectionShape<Selected extends object> = Selected extends NonSelectionRecord ? never : Selected;\ntype SelectionRecord = Readonly<Record<PropertyKey, unknown>>;\n/**\n * D359: the Resource a field selected, and what this selection read from it — its state, and the state of its\n * pagination capability when it has one. Both are read passively: a selection takes no lease by reading.\n */\ntype SelectedResource = Readonly<{ pagination: unknown; resource: AnyResource; state: unknown }>;\ntype SelectionSnapshot = Readonly<{\n  commands: Readonly<Record<PropertyKey, AnyCommand>>;\n  /** The set the mount leases; two keys naming one resource are one lease. */\n  leases: ReadonlySet<ResourceDemand>;\n  resources: ReadonlyMap<PropertyKey, SelectedResource>;\n  sources: ReadonlySet<Readable<unknown>>;\n  values: SelectionRecord;\n}>;\n\nconst noResources: ReadonlyMap<PropertyKey, SelectedResource> = new Map();\n\n/**\n * D363: what this mount read last and the snapshot it answered with. It belongs to the mount and not to the reader:\n * React may discard the `useMemo` that builds the reader, and a memory kept there would be empty exactly when it is\n * needed. D364: it no longer remembers which sources ended — a source whose owner retired stops instead of refusing,\n * so it answers its last value on every read and there is nothing to remember or to step around.\n */\ntype SelectionMemory = {\n  model: unknown;\n  observed: Map<Readable<unknown>, unknown> | undefined;\n  select: unknown;\n  snapshot: SelectionSnapshot;\n};\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction readSource<Value>(source: Readable<Value>, sources: Map<Readable<unknown>, unknown>): Value {\n  if (!isReadable(source)) {\n    throw new ContributionError('binding-invalid', 'Model selection read requires a Readable.');\n  }\n\n  if (sources.has(source)) return sources.get(source) as Value;\n\n  // D364: a refusal here is the source's own failure and belongs to the render, because no lifetime ends in one.\n  const value: unknown = source.getSnapshot();\n  sources.set(source, value);\n\n  return value as Value;\n}\n\nfunction readPassively(source: Readable<unknown>, sources: Map<Readable<unknown>, unknown>): unknown {\n  if (sources.has(source)) return sources.get(source);\n\n  const value: unknown = source.getSnapshot();\n  sources.set(source, value);\n\n  return value;\n}\n\n/** D359: the predicate that answers the question the type of the field asked, and the read that leases nothing. */\nfunction classifyResource(\n  key: PropertyKey,\n  value: unknown,\n  resources: Map<PropertyKey, SelectedResource>,\n  sources: Map<Readable<unknown>, unknown>,\n): void {\n  if (!isResource(value)) return;\n\n  const resource = value as AnyResource;\n  const capability = (\n    resource as { readonly pagination?: { readonly state: Readable<unknown> } | ResourceView<unknown> }\n  ).pagination;\n\n  resources.set(key, {\n    pagination: capability === undefined ? undefined : readPassively(resourceViewReadable(capability), sources),\n    resource,\n    state: readPassively(resourceViewReadable(resource), sources),\n  });\n}\n\nfunction selectedResources(resources: Map<PropertyKey, SelectedResource>): ReadonlyMap<PropertyKey, SelectedResource> {\n  return resources.size === 0 ? noResources : resources;\n}\n\ntype CollectedSelection = Readonly<{\n  leases: ReadonlySet<ResourceDemand>;\n  resources: ReadonlyMap<PropertyKey, SelectedResource>;\n  values: SelectionRecord;\n}>;\n\nfunction collectResourceDemands(\n  resources: ReadonlyMap<PropertyKey, SelectedResource>,\n  leases: Set<ResourceDemand>,\n): void {\n  for (const { resource } of resources.values()) {\n    if (isResourceView(resource)) {\n      for (const demand of resourceViewDemands(resource)) leases.add(demand);\n    } else {\n      leases.add(resource);\n    }\n  }\n}\n\n/**\n * D359: recognition happens in the one pass that already walks the selection. `Resource` is a structural contract\n * (D199) and the type of a selected field promises `ResourceHook` for anything that satisfies it, so the predicate\n * this uses answers the same question the type asked. Reading the state here also puts it among `sources`, so its\n * publication invalidates the fast path of this reader exactly as a read source does.\n */\nfunction collectSelection(\n  select: (context: SelectionContext) => object,\n  sources: Map<Readable<unknown>, unknown>,\n): CollectedSelection {\n  const leases = new Set<ResourceDemand>();\n  const read = <Value, Selected>(source: Readable<Value>, project?: (value: Value) => Selected) => {\n    const value = readSource(source, sources);\n\n    return project === undefined ? value : project(value);\n  };\n  const acquire = <Value, Selected>(view: ResourceView<Value>, project?: (value: Value) => Selected) => {\n    if (!isResourceView(view))\n      throw new ContributionError('binding-invalid', 'Model selection acquire requires a ResourceView.');\n    for (const demand of resourceViewDemands(view)) leases.add(demand);\n    return read(view.observe(), project);\n  };\n  const selected = select({ acquire, read });\n\n  if (typeof selected !== 'object' || selected === null || Array.isArray(selected)) {\n    throw new ContributionError('binding-invalid', 'Model selection requires a record.');\n  }\n\n  const entries: (readonly [PropertyKey, unknown])[] = [];\n  const resources = new Map<PropertyKey, SelectedResource>();\n\n  for (const key of Reflect.ownKeys(selected)) {\n    if (!Object.prototype.propertyIsEnumerable.call(selected, key)) continue;\n\n    const value = (selected as SelectionRecord)[key];\n\n    entries.push([key, value]);\n    classifyResource(key, value, resources, sources);\n  }\n\n  // `__proto__` is a key like any other here, and only a defined property keeps it one (D214).\n  collectResourceDemands(resources, leases);\n  return { leases, resources: selectedResources(resources), values: Object.fromEntries(entries) };\n}\n\n/**\n * D359: `values` keeps the Resource itself — a stable reference — so a selection that holds one is compared by\n * `Object.is` exactly as before. What moves is the state behind it, and that is compared here: without this the\n * selection would be «equal», the previous state would be kept, and a published Resource would reach no render.\n */\nfunction equalResources(\n  previous: ReadonlyMap<PropertyKey, SelectedResource>,\n  next: ReadonlyMap<PropertyKey, SelectedResource>,\n): boolean {\n  if (previous.size !== next.size) return false;\n\n  for (const [key, selected] of next) {\n    const before = previous.get(key);\n\n    if (\n      before?.resource !== selected.resource ||\n      !Object.is(before.state, selected.state) ||\n      !Object.is(before.pagination, selected.pagination)\n    ) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction equalMembers<Value>(previous: ReadonlySet<Value>, next: ReadonlySet<Value>): boolean {\n  if (previous.size !== next.size) return false;\n  for (const value of next) if (!previous.has(value)) return false;\n  return true;\n}\n\nfunction equalSelection(\n  previous: SelectionSnapshot,\n  values: SelectionRecord,\n  sources: ReadonlySet<Readable<unknown>>,\n  resources: ReadonlyMap<PropertyKey, SelectedResource>,\n  leases: ReadonlySet<ResourceDemand>,\n) {\n  const keys = Reflect.ownKeys(values);\n  const previousKeys = Reflect.ownKeys(previous.values);\n\n  if (keys.length !== previousKeys.length) return false;\n  if (!equalMembers(previous.sources, sources)) return false;\n  if (!equalMembers(previous.leases, leases)) return false;\n\n  if (!equalResources(previous.resources, resources)) return false;\n\n  return keys.every((key, index) => previousKeys[index] === key && Object.is(previous.values[key], values[key]));\n}\n\ntype ModelSelector<Model> = (model: Model, context: SelectionContext) => object;\ntype SelectionReaderRef<Model> = { readonly current: ModelSelector<Model> | undefined };\n\nconst emptySelectionSnapshot: SelectionSnapshot = {\n  commands: {},\n  leases: noLeases,\n  resources: noResources,\n  sources: new Set(),\n  values: {},\n};\n\nfunction selectionCommands(values: SelectionRecord): Readonly<Record<PropertyKey, AnyCommand>> {\n  return Object.fromEntries(\n    Reflect.ownKeys(values)\n      .filter(key => isCallTarget(values[key]))\n      .map(key => [key, values[key]]),\n  ) as Readonly<Record<PropertyKey, AnyCommand>>;\n}\n\n/**\n * The fast path re-reads what it observed. D364: a source that stopped answers the same value it answered last, so\n * it compares equal and costs one read — there is no terminal source to record and step around any more.\n */\nfunction observedUnchanged(observed: Map<Readable<unknown>, unknown>): boolean {\n  for (const [source, value] of observed) {\n    if (!Object.is(source.getSnapshot(), value)) return false;\n  }\n\n  return true;\n}\n\n/** D363: the memory of one mount, empty until its first read and reset when the reader is built for another model. */\nfunction createSelectionMemory(): SelectionMemory {\n  return { model: undefined, observed: undefined, select: undefined, snapshot: emptySelectionSnapshot };\n}\n\n/**\n * D214: one reader per model, not per render. The author's selector arrives through a ref, so an inline arrow does not\n * rebuild the reader; the fast path — nothing observed has moved — belongs to the selector that computed the snapshot,\n * so a new selector is always called again, its result compared field by field, and an equal selection keeps the\n * previous snapshot. A rejected or abandoned render still changes nothing: only a committed selection subscribes.\n *\n * D363: what the reader remembers lives in the mount's memory, so a reader React rebuilt — because it discarded the\n * memo — still knows what this selection read last.\n */\nfunction createSelectionSnapshot<Model>(\n  model: Model,\n  selectRef: SelectionReaderRef<Model>,\n  memory: SelectionMemory,\n): () => SelectionSnapshot {\n  if (memory.model !== model) {\n    memory.model = model;\n    memory.observed = undefined;\n    memory.select = undefined;\n    memory.snapshot = emptySelectionSnapshot;\n  }\n\n  return () => {\n    const select = selectRef.current;\n\n    if (select === undefined) return emptySelectionSnapshot;\n\n    const observed = memory.observed;\n\n    if (observed !== undefined && memory.select === select && observedUnchanged(observed)) {\n      return memory.snapshot;\n    }\n\n    const nextObserved = new Map<Readable<unknown>, unknown>();\n    const { leases, resources, values } = collectSelection(context => select(model, context), nextObserved);\n    const sources = new Set(nextObserved.keys());\n\n    if (observed === undefined || !equalSelection(memory.snapshot, values, sources, resources, leases)) {\n      memory.snapshot = {\n        commands: selectionCommands(values),\n        leases,\n        resources,\n        sources,\n        values,\n      };\n    }\n\n    memory.observed = nextObserved;\n    memory.select = select;\n\n    return memory.snapshot;\n  };\n}\n\nexport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot };\nexport type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionShape, SelectionSnapshot };\n","import type { Readable } from '@opetope/core';\nimport { createAggregateError } from '@opetope/core/internal';\n\nimport type { ResourceDemand } from '@opetope/core/internal';\n\ntype Subscription = { dispose: (() => void) | undefined };\ntype Listener = Readonly<{ notify: () => void }>;\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction releaseSubscriptions(subscriptions: Iterable<Subscription>, failures: unknown[] = []): void {\n  for (const subscription of subscriptions) {\n    const dispose = subscription.dispose;\n    subscription.dispose = undefined;\n\n    try {\n      dispose?.();\n    } catch (error) {\n      failures.push(error);\n    }\n  }\n\n  if (failures.length === 1) throw failures[0];\n\n  if (failures.length > 1) throw createAggregateError(failures, 'Model selection sources failed to release.');\n}\n\n/** A subscription set, not a scheduler: source notifications use React's snapshot consistency check. */\nclass ModelSelectionStore {\n  private enabled = false;\n  /** D359: one lease per Resource identity, diffed like a subscription, so an unchanged selection takes none. */\n  private readonly leases = new Map<ResourceDemand, Subscription>();\n  private readonly listeners = new Set<Listener>();\n  private retained: ReadonlySet<ResourceDemand> = noLeases;\n  private sources: ReadonlySet<Readable<unknown>> = new Set();\n  private readonly subscriptions = new Map<Readable<unknown>, Subscription>();\n\n  close(): void {\n    this.enabled = false;\n    this.sources = new Set();\n    this.retained = noLeases;\n    this.releaseAll();\n  }\n\n  commit(sources: ReadonlySet<Readable<unknown>>, retained: ReadonlySet<ResourceDemand> = noLeases): void {\n    this.sources = sources;\n    this.retained = retained;\n    this.enabled = true;\n\n    try {\n      this.synchronize();\n    } catch (error) {\n      this.releaseAll([error]);\n    }\n  }\n\n  subscribe = (notify: () => void): (() => void) => {\n    const listener = { notify };\n    this.listeners.add(listener);\n\n    try {\n      this.synchronize();\n    } catch (error) {\n      this.listeners.delete(listener);\n      this.releaseAll([error]);\n    }\n\n    return () => {\n      this.listeners.delete(listener);\n\n      if (this.listeners.size === 0) this.releaseAll();\n    };\n  };\n\n  private add(source: Readable<unknown>): void {\n    const subscription: Subscription = { dispose: undefined };\n    // Reserve before foreign code: a synchronous notification may replace or close this selection.\n    this.subscriptions.set(source, subscription);\n    const dispose = source.subscribe(this.notify);\n\n    if (typeof dispose !== 'function') throw new TypeError('Model selection source must return a disposer.');\n\n    if (this.subscriptions.get(source) === subscription) subscription.dispose = dispose;\n    else dispose();\n  }\n\n  private notify = (): void => {\n    for (const listener of [...this.listeners]) {\n      if (this.listeners.has(listener)) listener.notify();\n    }\n  };\n\n  private releaseAll(failures?: unknown[]): void {\n    const held = [...this.subscriptions.values(), ...this.leases.values()];\n    this.subscriptions.clear();\n    this.leases.clear();\n    releaseSubscriptions(held, failures);\n  }\n\n  private removeUnselected(): void {\n    const removed: Subscription[] = [];\n\n    for (const [source, subscription] of this.subscriptions) {\n      if (this.sources.has(source)) continue;\n\n      this.subscriptions.delete(source);\n      removed.push(subscription);\n    }\n\n    for (const [resource, lease] of this.leases) {\n      if (this.retained.has(resource)) continue;\n\n      this.leases.delete(resource);\n      removed.push(lease);\n    }\n\n    releaseSubscriptions(removed);\n  }\n\n  /**\n   * D321: `retain()` is reentrant — it reaches `activate()`, the target subscription, the first read and the\n   * publication that follows, all synchronously — and a listener woken there may rebuild or close this selection.\n   * The record is reserved first, the lease is taken second, and it is kept only if the record is still this one.\n   */\n  private retain(resource: ResourceDemand): void {\n    const lease: Subscription = { dispose: undefined };\n    this.leases.set(resource, lease);\n    const release = resource.acquire();\n\n    if (typeof release !== 'function') throw new TypeError('Model selection resource must answer a release disposer.');\n\n    if (this.leases.get(resource) === lease) lease.dispose = release;\n    else release();\n  }\n\n  /** Foreign code inside a subscription or a lease may replace this selection, so both loops ask again. */\n  private ready(): boolean {\n    return this.enabled && this.listeners.size > 0;\n  }\n\n  private retainSelected(): void {\n    for (const resource of this.retained) {\n      if (!this.ready()) return;\n\n      if (this.retained.has(resource) && !this.leases.has(resource)) this.retain(resource);\n    }\n  }\n\n  private subscribeSources(): void {\n    for (const source of this.sources) {\n      if (!this.ready()) return;\n\n      if (this.sources.has(source) && !this.subscriptions.has(source)) this.add(source);\n    }\n  }\n\n  private synchronize(): void {\n    this.removeUnselected();\n    this.subscribeSources();\n    this.retainSelected();\n  }\n}\n\nexport { ModelSelectionStore };\n","import { useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command, ModelOf, PaginatedResource, Resource } from '@opetope/core';\n\nimport type { CommandHook } from './command-hook';\nimport { useSelectionHooks } from './selection-hooks';\nimport type { SelectionHooks } from './selection-hooks';\nimport { ContributionError } from './errors';\nimport { subscribeIdle } from './idle-subscription';\nimport type { AnyModel } from './model-binding';\nimport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot } from './model-selection-snapshot';\nimport type {\n  ModelSelector,\n  SelectionContext,\n  SelectionMemory,\n  SelectionShape,\n  SelectionSnapshot,\n} from './model-selection-snapshot';\nimport { ModelSelectionStore } from './model-selection-store';\nimport { useFrame } from './mount-context';\nimport type { PaginatedResourceHook, ResourceHook, ResourceKey } from './resource-command';\n\n/**\n * D359: a field whose value is a Resource answers the hook `useResource` answers, and the mount leases it exactly as\n * `useResource` does. `read(resource.state)` is unchanged — it hands out the state and leases nothing — so naming one\n * Resource both ways registers it twice: the subscription and the lease are independent.\n */\ntype SelectedValue<Value> =\n  Value extends Command<infer Input, infer Output>\n    ? CommandHook<Input, Output>\n    : Value extends PaginatedResource<\n          infer Data,\n          infer Key extends ResourceKey,\n          infer Cursor extends ResourceKey,\n          'consumers' | 'owner'\n        >\n      ? PaginatedResourceHook<Data, Key, Cursor>\n      : Value extends Resource<infer Data, infer Key extends ResourceKey, 'consumers' | 'owner'>\n        ? ResourceHook<Data, Key>\n        : Value;\ntype ModelSelection<Selected> = { readonly [Key in keyof Selected]: SelectedValue<Selected[Key]> };\n\nconst readEmptySnapshot = () => emptySelectionSnapshot;\n\nfunction useSelectionStore(selected: boolean): ModelSelectionStore | undefined {\n  const storeRef = useRef<ModelSelectionStore | undefined>(undefined);\n\n  return selected ? (storeRef.current ??= new ModelSelectionStore()) : undefined;\n}\n\n/**\n * Two branches of one key: the consumer this selection prepared — a bound command, or the verbs, the state and the\n * capability of a selected Resource — and otherwise the value the selector wrote. S6/D359: the Resource branch is\n * assembled on the record and not here, so a key whose state did not move hands back the very same object.\n */\nfunction mergeSelection(snapshot: SelectionSnapshot, hooks: SelectionHooks): unknown {\n  return Object.fromEntries(\n    Reflect.ownKeys(snapshot.values).map(key => [\n      key,\n      Object.prototype.hasOwnProperty.call(hooks, key) ? hooks[key] : snapshot.values[key],\n    ]),\n  );\n}\n\n/** D205: resolve only a granted model, explicitly read data, and reuse the ordinary per-key command consumers. */\nfunction useModel<Declaration extends AnyModel>(declaration: Declaration): ModelOf<Declaration>;\nfunction useModel<Declaration extends AnyModel, const Selected extends object>(\n  declaration: Declaration,\n  select: (model: ModelOf<Declaration>, context: SelectionContext) => Selected & SelectionShape<Selected>,\n): ModelSelection<Selected>;\nfunction useModel<Declaration extends AnyModel>(\n  declaration: Declaration,\n  select?: (model: ModelOf<Declaration>, context: SelectionContext) => object,\n): unknown {\n  const frame = useFrame();\n\n  if (!frame.models.has(declaration)) {\n    throw new ContributionError('missing', `Model ${declaration.id} is not granted to this contribution.`);\n  }\n\n  const model = frame.models.get(declaration) as ModelOf<Declaration>;\n  const store = useSelectionStore(select !== undefined);\n  // D214: the selector of this render, read by a reader that belongs to the model. Writing the latest callback into\n  // a ref is what `useSyncExternalStoreWithSelector` does: the reader only reads it, and never writes to it.\n  const selectRef = useRef<ModelSelector<ModelOf<Declaration>> | undefined>(undefined);\n  selectRef.current = select;\n  const selected = select !== undefined;\n  // D363: the memory of this selection belongs to the mount, so a reader React rebuilt keeps what it read last.\n  const memoryRef = useRef<SelectionMemory | undefined>(undefined);\n  const memory = (memoryRef.current ??= createSelectionMemory());\n  const getSnapshot = useMemo(\n    () => (selected ? createSelectionSnapshot(model, selectRef, memory) : readEmptySnapshot),\n    [memory, model, selected],\n  );\n  const snapshot = useSyncExternalStore(store?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n  const hooks = useSelectionHooks(snapshot.commands, snapshot.resources);\n  useLayoutEffect(() => () => store?.close(), [store]);\n  // D359: a lease is taken in commit and never in a render, and the store diffs the set by identity.\n  useLayoutEffect(() => store?.commit(snapshot.sources, snapshot.leases), [snapshot, store]);\n\n  if (select === undefined) return model;\n\n  return mergeSelection(snapshot, hooks);\n}\n\nexport { useModel };\n","import type { FunctionComponent } from 'react';\n\nimport type { ModelIdentity } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\n\ntype AnyModel = ModelIdentity;\n\n/**\n * The marker a component uses to state which UI models of its contribution it reads. `slot` checks by type that the\n * contribution grants every model of this list — it may grant more, because the mount serves its whole instance.\n *\n * The runtime authority is the mount frame, not this marker: `useModel` resolves against what the mount was given\n * and refuses anything else. The lint rule `opetope/require-declared-models` checks visible contribution sites and\n * each reader of a per-mount model within the same module. Imported implementations and dynamic declaration lists\n * remain unknown to this syntactic check (D85, D158, D250).\n */\ntype ComponentRequiringModels<Props, Models extends readonly AnyModel[]> = FunctionComponent<Props> & {\n  readonly requires: Models;\n};\n\nfunction requiresModels<const Models extends readonly AnyModel[]>(\n  models: Models,\n): <Props>(component: FunctionComponent<Props>) => ComponentRequiringModels<Props, Models> {\n  const declared = Object.freeze([...models]) as unknown as Models;\n\n  return <Props>(component: FunctionComponent<Props>): ComponentRequiringModels<Props, Models> => {\n    const existing = (component as { readonly requires?: readonly AnyModel[] }).requires;\n\n    if (existing !== undefined) {\n      throw new ContributionError('duplicate', 'Component already declares the models it requires.');\n    }\n\n    Object.defineProperty(component, 'requires', { enumerable: false, value: declared });\n\n    return component as ComponentRequiringModels<Props, Models>;\n  };\n}\n\nexport { requiresModels };\n","import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from 'react';\n\nimport type { PaginatedResource, PaginationState, Readable, Resource } from '@opetope/core';\nimport type { ResourceKey } from '@opetope/core/internal';\nimport { acquireResourceDemand, resourceViewReadable } from '@opetope/core/internal';\n\nimport { useCommandStatus } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport { createResourceInvokers, paginationOf } from './resource-command';\nimport type { AnyResource, PaginatedResourceHook, ResourceHook, ResourcePaginationHook } from './resource-command';\n\ntype ResourceSlots = Readonly<{\n  loadNext: CommandHookController<void, unknown>;\n  refresh: CommandHookController<void, unknown>;\n  reset: CommandHookController<void, unknown>;\n  retry: CommandHookController<void, unknown>;\n}>;\n\n/**\n * D359: one set of controllers per Resource identity, exactly as `useCommandSlot` keeps one per invoker. The slots are\n * what the set of invokers is kept alive by, so one map answers for all four. Slots are inert until commit, so an\n * interrupted render neither admits work nor resets the status of the committed one.\n */\nfunction useResourceSlots(resource: AnyResource): ResourceSlots {\n  const [cache] = useState(() => new WeakMap<object, ResourceSlots>());\n  const existing = cache.get(resource);\n\n  if (existing !== undefined) return existing;\n\n  const invokers = createResourceInvokers(resource);\n  const slots: ResourceSlots = {\n    loadNext: new CommandHookController<void, unknown>(invokers.loadNext),\n    refresh: new CommandHookController<void, unknown>(invokers.refresh),\n    reset: new CommandHookController<void, unknown>(invokers.reset),\n    retry: new CommandHookController<void, unknown>(invokers.retry),\n  };\n  cache.set(resource, slots);\n\n  return slots;\n}\n\nconst unavailablePagination: PaginationState<ResourceKey> = Object.freeze({\n  kind: 'unavailable',\n  reason: 'resource-not-ready',\n});\nconst noPaginationSource: Readable<PaginationState<ResourceKey>> = Object.freeze({\n  getSnapshot: () => unavailablePagination,\n  subscribe: () => () => undefined,\n});\n\n/**\n * D359: the state of a Resource, the lease that keeps it open for as long as this component is mounted, and its verbs\n * as commands. The number of React hooks here does not depend on the Resource: a declaration without `pagination`\n * subscribes to a constant source and keeps a `loadNext` that answers `skipped`.\n */\nfunction useResource<Data, Key extends ResourceKey, Cursor extends ResourceKey>(\n  resource: PaginatedResource<Data, Key, Cursor, 'consumers' | 'owner'>,\n): PaginatedResourceHook<Data, Key, Cursor>;\nfunction useResource<Data, Key extends ResourceKey>(\n  resource: Resource<Data, Key, 'consumers' | 'owner'>,\n): ResourceHook<Data, Key>;\nfunction useResource<Data, Key extends ResourceKey>(\n  resource: Resource<Data, Key, 'consumers' | 'owner'>,\n): ResourceHook<Data, Key> {\n  const handle = resource as unknown as AnyResource;\n  const capability = paginationOf(handle);\n  const subscribe = useCallback(\n    (listener: () => void) => resourceViewReadable(resource).subscribe(listener),\n    [resource],\n  );\n  /*\n   * D364: `resource.state` is a total `Readable` for the life of the object this hook holds — a retired one answers\n   * `idle('retired')` — so the read needs no memory of its own. What it can still refuse is a producer failure, a\n   * broken `nextCursor` among them (D356), and that belongs to the render (G13).\n   */\n  const getState = useMemo(() => () => resourceViewReadable(resource).getSnapshot(), [resource]);\n  const state = useSyncExternalStore(subscribe, getState, getState);\n  const paginationSource: Readable<PaginationState<ResourceKey>> =\n    capability === undefined ? noPaginationSource : resourceViewReadable(capability);\n  const subscribePagination = useCallback(\n    (listener: () => void) => paginationSource.subscribe(listener),\n    [paginationSource],\n  );\n  const getPaginationState = useMemo(() => () => paginationSource.getSnapshot(), [paginationSource]);\n  const paginationState = useSyncExternalStore(subscribePagination, getPaginationState, getPaginationState);\n\n  // D349: the lease is taken in a commit effect, so an interrupted render opens nothing.\n  useEffect(() => acquireResourceDemand(resource), [resource]);\n\n  const slots = useResourceSlots(handle);\n  const refresh = useCommandStatus(slots.refresh);\n  const retry = useCommandStatus(slots.retry);\n  const reset = useCommandStatus(slots.reset);\n  const loadNext = useCommandStatus(slots.loadNext);\n  const pagination = useMemo(\n    () =>\n      capability === undefined\n        ? undefined\n        : ({ loadNext, state: paginationState } as unknown as ResourcePaginationHook<ResourceKey>),\n    [capability, loadNext, paginationState],\n  );\n\n  return useMemo(\n    () => ({ pagination, refresh, reset, retry, state }) as ResourceHook<Data, Key>,\n    [pagination, refresh, reset, retry, state],\n  );\n}\n\nexport { useResource };\n","import type { ComponentType, ReactNode } from 'react';\nimport { createElement, Fragment } from 'react';\n\nimport type { DeclarationId } from '@opetope/core';\nimport { declarationId } from '@opetope/core';\nimport type { ContributionTarget } from '@opetope/core/internal';\nimport { createContributionTarget } from '@opetope/core/internal';\nimport type { ContributionModel } from '@opetope/runtime/internal';\n\nimport { contributionAuthority, ContributionMount } from './contribution-frame';\nimport { useReadable } from './readable-hooks';\n\ntype SlotProperties = object | undefined;\ntype EmptySlotProperties = Readonly<Record<string, never>>;\ntype SlotComponentProperties<Props extends SlotProperties> = [Props] extends [undefined]\n  ? EmptySlotProperties\n  : Extract<Props, object>;\n\n/**\n * What a contribution publishes: the component, the optional props adapter and the optional UI models the mount\n * creates. Without an adapter the component takes the slot props; with one it takes exactly the adapter result (D85).\n */\ntype SlotContribution<Props extends SlotProperties = undefined> = {\n  readonly Component: ComponentType<never>;\n  readonly models?: readonly ContributionModel[];\n  readonly props?: (slotProps: SlotComponentProperties<Props>) => object;\n};\n\ntype SlotTarget<Props extends SlotProperties = undefined> = ContributionTarget<SlotContribution<Props>>;\n\ntype SwitchSlotTarget<Route extends string, Props extends SlotProperties = undefined> = ((\n  route: Route,\n) => SlotTarget<Props>) & {\n  readonly id: DeclarationId;\n};\n\ntype SlotRenderProps<Props extends SlotProperties> = [Props] extends [undefined]\n  ? {\n      readonly props?: never;\n      readonly target: SlotTarget<Props>;\n    }\n  : {\n      readonly props: SlotComponentProperties<Props>;\n      readonly target: SlotTarget<Props>;\n    };\n\nconst emptySlotProperties: EmptySlotProperties = Object.freeze({});\n\n/** D280: a slot is a name, so it takes its id as the first argument. */\nfunction defineSlot<Props extends SlotProperties = undefined>(id: string): SlotTarget<Props> {\n  return createContributionTarget<SlotContribution<Props>>(id, 'slot');\n}\n\nfunction defineSwitchSlot<Route extends string, Props extends SlotProperties = undefined>(\n  id: string,\n): SwitchSlotTarget<Route, Props> {\n  const declared = declarationId(id);\n  const targets = new Map<Route, SlotTarget<Props>>();\n\n  const switchSlot = (route: Route): SlotTarget<Props> => {\n    const existing = targets.get(route);\n\n    if (existing !== undefined) return existing;\n\n    const target = defineSlot<Props>(`${declared}/${route}`);\n    targets.set(route, target);\n\n    return target;\n  };\n\n  Object.defineProperty(switchSlot, 'id', { enumerable: true, value: declared });\n\n  return Object.freeze(switchSlot) as SwitchSlotTarget<Route, Props>;\n}\n\n/**\n * Every contribution renders inside its own mount: the models its generation owns plus the UI models it declared,\n * created on mount and closed on unmount (D70, D85).\n */\nfunction Slot<Props extends SlotProperties>(options: SlotRenderProps<Props>): ReactNode {\n  const entries = useReadable(options.target.entries);\n  const slotProps: object = 'props' in options ? (options.props ?? emptySlotProperties) : emptySlotProperties;\n\n  if (entries.length === 0) return null;\n\n  return entries.map(entry =>\n    createElement(\n      Fragment,\n      { key: entry.id },\n      createElement(ContributionMount, {\n        authority: contributionAuthority(entry),\n        contribution: entry.value,\n        contributionId: entry.id,\n        slotProps,\n        targetId: options.target.id,\n      }),\n    ),\n  );\n}\n\nexport { defineSlot, defineSwitchSlot, Slot };\nexport type { SlotComponentProperties, SlotContribution, SlotProperties, SlotTarget, SwitchSlotTarget };\n"],"names":["failureOutcome","options","error","isCancellation","notification","_a","reportDetachedError","callbackError","runOptions","onSuccess","signal","requestOf","input","resolve","promise","settle","request","outcome","CommandHookController","ContributionError","aborted","invoker","notify","CommandError","compatibleAbortReason","invocation","value","emptyStatus","settledOutcome","unchangedState","current","slot","inFlight","settled","nextState","previous","useCommandSlot","slots","useState","useCommandStatus","currentSlot","hookState","setHookState","useInsertionEffect","useLayoutEffect","run","useMemo","useCommand","command","record","useFrame","idleRelease","subscribeIdle","idleRevision","emptyHooks","isResourceEntry","entry","createEntry","unchangedHook","next","updateEntry","selectEntry","resourceHook","selected","createResourceEntry","invokers","parts","unchangedResourceCommands","hook","unchangedResourceState","unchangedResourceHook","selectResourceEntry","commandEntries","detachEntry","hookOf","CommandGroup","key","listener","commands","resources","frame","resource","resourceInvokers","useCommandGroup","groupRef","useRef","useSelectionHooks","group","getSnapshot","useSyncExternalStore","noResources","noLeases","readSource","source","sources","isReadable","readPassively","classifyResource","isResource","capability","resourceViewReadable","selectedResources","collectResourceDemands","leases","isResourceView","demand","resourceViewDemands","collectSelection","select","read","project","view","entries","equalResources","before","equalMembers","equalSelection","values","keys","previousKeys","index","emptySelectionSnapshot","selectionCommands","isCallTarget","observedUnchanged","observed","createSelectionMemory","createSelectionSnapshot","model","selectRef","memory","nextObserved","context","releaseSubscriptions","subscriptions","failures","subscription","dispose","createAggregateError","ModelSelectionStore","retained","held","removed","lease","release","readEmptySnapshot","useSelectionStore","storeRef","mergeSelection","snapshot","hooks","useModel","declaration","store","memoryRef","requiresModels","models","declared","component","useResourceSlots","cache","existing","createResourceInvokers","unavailablePagination","noPaginationSource","useResource","handle","paginationOf","subscribe","useCallback","getState","state","paginationSource","subscribePagination","getPaginationState","paginationState","useEffect","acquireResourceDemand","refresh","retry","reset","loadNext","pagination","emptySlotProperties","defineSlot","id","createContributionTarget","defineSwitchSlot","declarationId","targets","switchSlot","route","target","Slot","useReadable","slotProps","createElement","Fragment","ContributionMount","contributionAuthority"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/command-hook-controller.ts","../src/command-hook.ts","../src/idle-subscription.ts","../src/resource-verb-hook.ts","../src/selection-hooks.ts","../src/model-selection-snapshot.ts","../src/model-hook.ts","../src/requires-models.ts","../src/resource-hook.ts","../src/slot.tsx"],"sourcesContent":["import { CommandError } from '@opetope/core';\nimport { compatibleAbortReason, isCancellation, reportDetachedError } from '@opetope/core/internal';\nimport type { CommandInputArgs, CallRunOptions } from '@opetope/core/internal';\n\nimport type { CommandOutcome } from './command';\nimport { ContributionError } from './errors';\n\n/**\n * D474: a callback's answer is not awaited and changes nothing — the run has already settled — so any value is\n * accepted, and a rejected promise among them is reported like a throw, detached from the outcome it watched.\n */\ntype CommandRunOptions<Output> = Readonly<{\n  /** Called with a failure that is not a cancellation; its answer is not awaited, and a throw or rejection is reported. */\n  onFailure?: (error: unknown) => unknown;\n  /** Called with the body's value; its answer is not awaited and changes no outcome, and a throw or rejection is reported. */\n  onSuccess?: (value: Output) => unknown;\n  /** Cancels this run's wait: the run answers `cancelled`, and an already-aborted signal never reaches the command. */\n  signal?: AbortSignal;\n}>;\n\n/*\n * D474: the options element of the spread form is `CommandRunOptions<Output> | undefined`, so a wrapper that forwards\n * `...args: [...CommandInputArgs<Input>, options?: …]` compiles under `exactOptionalPropertyTypes`, where a spread\n * optional element reads as possibly `undefined`.\n */\n/**\n * The options element of the spread form is `CommandRunOptions<Output> | undefined`.\n */\ntype CommandRun<Input, Output> = {\n  (input: Input, options?: CommandRunOptions<Output>): Promise<CommandOutcome<Output>>;\n  (\n    ...args: [...CommandInputArgs<Input>, options?: CommandRunOptions<Output> | undefined]\n  ): Promise<CommandOutcome<Output>>;\n};\n\ntype CommandInvoker = Readonly<{\n  run: (input: never, options?: CallRunOptions<unknown>) => Promise<unknown>;\n}>;\n\ntype CommandNotification<Output> = (inFlight: boolean, outcome?: CommandOutcome<Output>) => void;\n\ntype CommandRequest<Input, Output> = {\n  input: Input | undefined;\n  options: CommandRunOptions<Output> | undefined;\n  readonly promise: Promise<CommandOutcome<Output>>;\n  resolve: ((outcome: CommandOutcome<Output>) => void) | undefined;\n};\n\nfunction failureOutcome<Output>(options: CommandRunOptions<Output> | undefined, error: unknown): CommandOutcome<never> {\n  if (isCancellation(error)) return { reason: error, kind: 'cancelled' };\n\n  try {\n    const notification = options?.onFailure?.(error);\n\n    if (notification !== undefined) void Promise.resolve(notification).catch(reportDetachedError);\n  } catch (callbackError) {\n    reportDetachedError(callbackError);\n  }\n\n  return { error, kind: 'failed' };\n}\n\nfunction runOptions<Output>(options: CommandRunOptions<Output> | undefined): CallRunOptions<Output> | undefined {\n  const onSuccess = options?.onSuccess;\n  const signal = options?.signal;\n\n  if (onSuccess === undefined) return signal === undefined ? undefined : { signal };\n\n  return signal === undefined ? { onSuccess } : { onSuccess, signal };\n}\n\nfunction requestOf<Input, Output>(\n  input: Input,\n  options: CommandRunOptions<Output> | undefined,\n): CommandRequest<Input, Output> {\n  let resolve!: (outcome: CommandOutcome<Output>) => void;\n  const promise = new Promise<CommandOutcome<Output>>(settle => {\n    resolve = settle;\n  });\n\n  return { input, options: options === undefined ? undefined : { ...options }, promise, resolve };\n}\n\nfunction settle<Input, Output>(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n  const resolve = request.resolve;\n  request.input = undefined;\n  request.options = undefined;\n  request.resolve = undefined;\n  resolve?.(outcome);\n}\n\n/**\n * D203: the consumer keeps a status, not a schedule. Every `run` reaches the command, and what the command was\n * declared with — `concurrency`, `memoize`, `dedupe` — decides what happens to it. What stays\n * local is what only this consumer knows: whether it is mounted, its own input signal, and the outcome it shows.\n */\nclass CommandHookController<Input, Output> {\n  readonly run: CommandRun<Input, Output> = ((input: Input, options?: CommandRunOptions<Output>) => {\n    if (this.notify === undefined) {\n      return Promise.resolve({\n        reason: new ContributionError('inactive', 'Command consumer is not mounted.'),\n        kind: 'cancelled' as const,\n      });\n    }\n\n    const aborted = this.cancelledInput(options);\n\n    if (aborted !== undefined) return Promise.resolve(aborted);\n\n    const request = requestOf(input, options);\n    this.start(request);\n\n    return request.promise;\n  }) as CommandRun<Input, Output>;\n  private inFlight = 0;\n  private notify: CommandNotification<Output> | undefined;\n\n  constructor(private readonly invoker: CommandInvoker) {}\n\n  attach(notify: CommandNotification<Output>): () => void {\n    this.notify = notify;\n\n    return () => {\n      if (this.notify !== notify) return;\n\n      this.notify = undefined;\n    };\n  }\n\n  synchronize(): void {\n    this.notify?.(this.inFlight > 0);\n  }\n\n  private aborted(signal: AbortSignal): CommandOutcome<never> {\n    return {\n      reason: new CommandError('cancelled', 'Command input was cancelled.', compatibleAbortReason(signal)),\n      kind: 'cancelled',\n    };\n  }\n\n  private cancelledInput(options: CommandRunOptions<Output> | undefined): CommandOutcome<never> | undefined {\n    return options?.signal?.aborted === true ? this.aborted(options.signal) : undefined;\n  }\n\n  private finish(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n    if (request.resolve === undefined) return;\n\n    this.inFlight -= 1;\n    settle(request, outcome);\n    this.notify?.(this.inFlight > 0, outcome);\n  }\n\n  private invoke(request: CommandRequest<Input, Output>): void {\n    let invocation: Promise<Output>;\n\n    try {\n      invocation = this.invoker.run(request.input as never, runOptions(request.options) as never) as Promise<Output>;\n      request.input = undefined;\n    } catch (error) {\n      this.finish(request, failureOutcome(request.options, error));\n\n      return;\n    }\n\n    void invocation.then(\n      value => this.finish(request, { kind: 'ok', value }),\n      (error: unknown) => this.finish(request, failureOutcome(request.options, error)),\n    );\n  }\n\n  private start(request: CommandRequest<Input, Output>): void {\n    this.inFlight += 1;\n    // Reserve the flight before publishing: a reentrant run must already see this consumer as busy.\n    this.notify?.(true);\n    this.invoke(request);\n  }\n}\n\nexport { CommandHookController };\nexport type { CommandInvoker, CommandRun };\n","import { useInsertionEffect, useLayoutEffect, useMemo, useState } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker, CommandRun } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { useFrame } from './mount-context';\n\n/** D292: a cancellation is not an answer of the product, so it never settles into the outcome this hook shows. */\ntype SettledOutcome<Output> = Exclude<CommandOutcome<Output>, { readonly kind: 'cancelled' }>;\n\ninterface CommandHookStatus<Output> {\n  readonly inFlight: boolean;\n  readonly outcome: SettledOutcome<Output> | undefined;\n}\n\nconst emptyStatus: CommandHookStatus<never> = { inFlight: false, outcome: undefined };\n\ntype CommandHook<Input, Output> = CommandHookStatus<Output> & {\n  readonly run: CommandRun<Input, Output>;\n};\n\ntype CommandHookState<Input, Output> = CommandHookStatus<Output> & {\n  readonly slot: CommandHookController<Input, Output>;\n};\n\n/** D292: a cancellation moves nothing, so it is the same non-event as a notification without an outcome at all. */\nfunction settledOutcome<Output>(outcome: CommandOutcome<Output> | undefined): SettledOutcome<Output> | undefined {\n  return outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n}\n\nfunction unchangedState<Input, Output>(\n  current: CommandHookState<Input, Output>,\n  slot: CommandHookController<Input, Output>,\n  inFlight: boolean,\n  settled: SettledOutcome<Output> | undefined,\n): boolean {\n  return settled === undefined && current.slot === slot && current.inFlight === inFlight;\n}\n\nfunction nextState<Input, Output>(\n  current: CommandHookState<Input, Output>,\n  slot: CommandHookController<Input, Output>,\n  inFlight: boolean,\n  outcome?: CommandOutcome<Output>,\n): CommandHookState<Input, Output> {\n  const settled = settledOutcome(outcome);\n\n  if (unchangedState(current, slot, inFlight, settled)) return current;\n\n  // A new run clears nothing: the previous answer stays readable while its retry is in flight.\n  const previous = current.slot === slot ? current.outcome : undefined;\n\n  return { inFlight, outcome: settled ?? previous, slot };\n}\n\nfunction useCommandSlot<Input, Output>(invoker: CommandInvoker): CommandHookController<Input, Output> {\n  // Slots are inert until commit. An interrupted render cannot fence the committed source or admit its own work.\n  const [slots] = useState(() => new WeakMap<object, CommandHookController<Input, Output>>());\n  let slot = slots.get(invoker);\n\n  if (slot === undefined) {\n    slot = new CommandHookController(invoker);\n    slots.set(invoker, slot);\n  }\n\n  return slot;\n}\n\n/**\n * A command consumer keeps its own status, attaches to its current slot and synchronizes a slot that was already\n * busy when this mount arrived.\n */\nfunction useCommandStatus<Input, Output>(\n  currentSlot: CommandHookController<Input, Output>,\n): CommandHook<Input, Output> {\n  const [hookState, setHookState] = useState<CommandHookState<Input, Output>>(() => ({\n    inFlight: false,\n    outcome: undefined,\n    slot: currentSlot,\n  }));\n  useInsertionEffect(\n    () =>\n      currentSlot.attach((inFlight, outcome) =>\n        setHookState(current => nextState(current, currentSlot, inFlight, outcome)),\n      ),\n    [currentSlot],\n  );\n  useLayoutEffect(() => currentSlot.synchronize(), [currentSlot]);\n  const { inFlight, outcome } = hookState.slot === currentSlot ? hookState : emptyStatus;\n  const run = currentSlot.run;\n\n  return useMemo(() => ({ inFlight, outcome, run }), [inFlight, outcome, run]);\n}\n\nfunction useCommand<Input, Output>(command: Command<Input, Output>): CommandHook<Input, Output> {\n  const frame = useFrame();\n  const record = frame.commandRecords.get(command);\n\n  if (record === undefined) {\n    throw new ContributionError('missing', `Command ${command.id} is not bound in this contribution.`);\n  }\n\n  return useCommandStatus(useCommandSlot<Input, Output>(record.invoker));\n}\n\nexport { useCommand };\nexport type { CommandHook };\n","const idleRelease = (): void => undefined;\nconst subscribeIdle = (): (() => void) => idleRelease;\nconst idleRevision = (): number => 0;\n\nexport { idleRevision, subscribeIdle };\n","import { useInsertionEffect, useLayoutEffect, useMemo, useState } from 'react';\n\nimport type { ResourceOperationOutcome } from '@opetope/core';\n\n/** A Resource verb answers its own outcome; only its consumer owns this wait and status. */\ntype ResourceVerbHook = Readonly<{\n  inFlight: boolean;\n  outcome: ResourceOperationOutcome | undefined;\n  run: () => Promise<ResourceOperationOutcome>;\n}>;\n\ntype VerbNotification = (inFlight: boolean, outcome?: ResourceOperationOutcome) => void;\n\ntype VerbWaiter = {\n  active: boolean;\n  next: VerbWaiter | undefined;\n  previous: VerbWaiter | undefined;\n  reject: ((error: unknown) => void) | undefined;\n  resolve: ((outcome: ResourceOperationOutcome) => void) | undefined;\n};\n\nconst cancelled: ResourceOperationOutcome = Object.freeze({ kind: 'cancelled' });\n\n/**\n * Only Resource verbs use this controller. A detached consumer settles its own waits without cancelling the\n * materialization's work. The linked waiters add no retained collection to a Resource hook that never runs a verb.\n */\nclass ResourceVerbController {\n  private inFlight = 0;\n  private notify: VerbNotification | undefined;\n  private pending: VerbWaiter | undefined;\n\n  readonly run = (): Promise<ResourceOperationOutcome> => {\n    if (this.notify === undefined) return Promise.resolve(cancelled);\n\n    let resolve!: (outcome: ResourceOperationOutcome) => void;\n    let reject!: (error: unknown) => void;\n    const answer = new Promise<ResourceOperationOutcome>((settle, refuse) => {\n      resolve = settle;\n      reject = refuse;\n    });\n    const waiter: VerbWaiter = { active: true, next: this.pending, previous: undefined, reject, resolve };\n    if (this.pending !== undefined) this.pending.previous = waiter;\n    this.pending = waiter;\n    this.inFlight += 1;\n    this.notify(true);\n\n    // A synchronous subscriber may detach while the busy status is published.\n    if (!waiter.active) return answer;\n\n    let operation: Promise<ResourceOperationOutcome>;\n\n    try {\n      operation = Promise.resolve(this.start());\n    } catch (error) {\n      this.fail(waiter, error);\n\n      return answer;\n    }\n\n    void operation.then(\n      outcome => this.finish(waiter, outcome),\n      (error: unknown) => this.fail(waiter, error),\n    );\n\n    return answer;\n  };\n\n  constructor(private readonly start: () => Promise<ResourceOperationOutcome>) {}\n\n  attach(notify: VerbNotification): () => void {\n    this.notify = notify;\n\n    return () => {\n      if (this.notify !== notify) return;\n\n      this.notify = undefined;\n      let current = this.pending;\n      this.pending = undefined;\n      this.inFlight = 0;\n\n      while (current !== undefined) {\n        const next = current.next;\n        current.active = false;\n        current.next = undefined;\n        current.previous = undefined;\n        const resolve = current.resolve;\n        current.resolve = undefined;\n        current.reject = undefined;\n        resolve?.(cancelled);\n        current = next;\n      }\n    };\n  }\n\n  synchronize(): void {\n    this.notify?.(this.inFlight > 0);\n  }\n\n  private unlink(waiter: VerbWaiter): boolean {\n    if (!waiter.active) return false;\n\n    waiter.active = false;\n    if (waiter.previous === undefined) this.pending = waiter.next;\n    else waiter.previous.next = waiter.next;\n    if (waiter.next !== undefined) waiter.next.previous = waiter.previous;\n    waiter.next = undefined;\n    waiter.previous = undefined;\n    this.inFlight -= 1;\n\n    return true;\n  }\n\n  private finish(waiter: VerbWaiter, outcome: ResourceOperationOutcome): void {\n    if (!this.unlink(waiter)) return;\n\n    const resolve = waiter.resolve;\n    waiter.resolve = undefined;\n    waiter.reject = undefined;\n    resolve?.(outcome);\n    this.notify?.(this.inFlight > 0, outcome);\n  }\n\n  private fail(waiter: VerbWaiter, error: unknown): void {\n    if (!this.unlink(waiter)) return;\n\n    const reject = waiter.reject;\n    waiter.resolve = undefined;\n    waiter.reject = undefined;\n    reject?.(error);\n    this.notify?.(this.inFlight > 0);\n  }\n}\n\ntype VerbHookState = ResourceVerbHook & { readonly slot: ResourceVerbController };\nconst emptyStatus = Object.freeze({ inFlight: false, outcome: undefined });\n\n/** D292: a cancelled wait does not replace the last product answer, even when the promise returns `cancelled`. */\nfunction visibleOutcome(outcome?: ResourceOperationOutcome): ResourceOperationOutcome | undefined {\n  return outcome?.kind === 'cancelled' ? undefined : outcome;\n}\n\nfunction nextState(\n  current: VerbHookState,\n  slot: ResourceVerbController,\n  inFlight: boolean,\n  outcome?: ResourceOperationOutcome,\n): VerbHookState {\n  const previous = current.slot === slot ? current.outcome : undefined;\n  const settled = visibleOutcome(outcome);\n\n  if (current.slot === slot && current.inFlight === inFlight && settled === undefined) return current;\n\n  return { inFlight, outcome: settled ?? previous, run: slot.run, slot };\n}\n\nfunction useResourceVerbStatus(slot: ResourceVerbController): ResourceVerbHook {\n  const [hookState, setHookState] = useState<VerbHookState>(() => ({\n    inFlight: false,\n    outcome: undefined,\n    run: slot.run,\n    slot,\n  }));\n  useInsertionEffect(\n    () => slot.attach((inFlight, outcome) => setHookState(current => nextState(current, slot, inFlight, outcome))),\n    [slot],\n  );\n  useLayoutEffect(() => slot.synchronize(), [slot]);\n  const { inFlight, outcome } = hookState.slot === slot ? hookState : emptyStatus;\n  const { run } = slot;\n\n  return useMemo(() => ({ inFlight, outcome, run }), [inFlight, outcome, run]);\n}\n\nexport { ResourceVerbController, useResourceVerbStatus };\nexport type { ResourceVerbHook };\n","import { useInsertionEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport type { CommandHook } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { idleRevision, subscribeIdle } from './idle-subscription';\nimport type { SelectedResource } from './model-selection-snapshot';\nimport { useFrame } from './mount-context';\nimport type { Frame } from './mount-frame';\nimport { resourceInvokers } from './resource-command';\nimport type { ResourceInvokers } from './resource-command';\nimport { ResourceVerbController } from './resource-verb-hook';\nimport type { ResourceVerbHook } from './resource-verb-hook';\n\ntype CommandSelection = Readonly<Record<string, Command<never, unknown>>>;\ntype ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;\n/** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */\ntype SelectedResourceHook = Readonly<{\n  pagination: Readonly<{ loadNext: ResourceInvokers['loadNext']; state: unknown }> | undefined;\n  refresh: ResourceVerbHook;\n  reset: ResourceVerbHook;\n  retry: ResourceVerbHook;\n  state: unknown;\n}>;\ntype SelectionHooks = Readonly<Record<PropertyKey, CommandHook<never, unknown> | SelectedResourceHook>>;\n\nconst emptyHooks: SelectionHooks = Object.freeze({});\n\ntype CommandEntry = {\n  detach: (() => void) | undefined;\n  hook: CommandHook<never, unknown>;\n  readonly invoker: CommandInvoker;\n  readonly slot: CommandHookController<never, unknown>;\n};\n\ntype ResourceVerbEntry = {\n  detach: (() => void) | undefined;\n  hook: ResourceVerbHook;\n  readonly invoker: ResourceInvokers['refresh'];\n  readonly slot: ResourceVerbController;\n};\n\n/**\n * D359: one key of a selection, three consumers. The record is the value; `entries` still holds one entry per key.\n * D486: `loadNext` is no command consumer — it is the stable function of the Resource, with no status of its own.\n */\ntype ResourceEntry = {\n  /** D359: the value this key hands the render, kept on the record so a still frame is the same object again. */\n  readonly hook: SelectedResourceHook;\n  readonly kind: 'resource';\n  readonly loadNext: ResourceInvokers['loadNext'];\n  readonly refresh: ResourceVerbEntry;\n  readonly reset: ResourceVerbEntry;\n  readonly retry: ResourceVerbEntry;\n};\n\ntype SelectionEntry = CommandEntry | ResourceEntry;\n\nfunction isResourceEntry(entry: SelectionEntry): entry is ResourceEntry {\n  return 'kind' in entry;\n}\n\nfunction createEntry(invoker: CommandInvoker): CommandEntry {\n  const slot = new CommandHookController<never, unknown>(invoker);\n\n  return { detach: undefined, hook: { inFlight: false, outcome: undefined, run: slot.run }, invoker, slot };\n}\n\nfunction createVerbEntry(invoker: ResourceInvokers['refresh']): ResourceVerbEntry {\n  const slot = new ResourceVerbController(invoker);\n\n  return { detach: undefined, hook: { inFlight: false, outcome: undefined, run: slot.run }, invoker, slot };\n}\n\nfunction unchangedHook(\n  previous: { readonly inFlight: boolean; readonly outcome: unknown },\n  next: { readonly inFlight: boolean; readonly outcome: unknown },\n): boolean {\n  return previous.inFlight === next.inFlight && Object.is(previous.outcome, next.outcome);\n}\n\nfunction updateEntry(entry: CommandEntry, inFlight: boolean, outcome?: CommandOutcome<unknown>): boolean {\n  const previous = entry.hook;\n\n  if (outcome === undefined && previous.inFlight === inFlight) return false;\n\n  // D292: only a settled non-cancelled outcome replaces the one this key shows; a retry keeps the previous answer.\n  const settled = outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n  const next = { inFlight, outcome: settled ?? previous.outcome, run: previous.run };\n\n  if (unchangedHook(previous, next)) return false;\n\n  entry.hook = next;\n\n  return true;\n}\n\nfunction updateVerbEntry(entry: ResourceVerbEntry, inFlight: boolean, outcome?: ResourceVerbHook['outcome']): boolean {\n  const previous = entry.hook;\n  const settled = outcome?.kind === 'cancelled' ? undefined : outcome;\n\n  if (settled === undefined && previous.inFlight === inFlight) return false;\n\n  const next = { inFlight, outcome: settled ?? previous.outcome, run: previous.run };\n\n  if (unchangedHook(previous, next)) return false;\n\n  entry.hook = next;\n\n  return true;\n}\n\nfunction selectEntry(previous: SelectionEntry | undefined, invoker: CommandInvoker): CommandEntry {\n  return previous !== undefined && !isResourceEntry(previous) && previous.invoker === invoker\n    ? previous\n    : createEntry(invoker);\n}\n\nfunction resourceHook(entry: Omit<ResourceEntry, 'hook'>, selected: SelectedResource): SelectedResourceHook {\n  return {\n    pagination:\n      selected.pagination === undefined ? undefined : { loadNext: entry.loadNext, state: selected.pagination },\n    refresh: entry.refresh.hook,\n    reset: entry.reset.hook,\n    retry: entry.retry.hook,\n    state: selected.state,\n  };\n}\n\nfunction createResourceEntry(invokers: ResourceInvokers, selected: SelectedResource): ResourceEntry {\n  const parts = {\n    kind: 'resource' as const,\n    loadNext: invokers.loadNext,\n    refresh: createVerbEntry(invokers.refresh),\n    reset: createVerbEntry(invokers.reset),\n    retry: createVerbEntry(invokers.retry),\n  };\n\n  return { ...parts, hook: resourceHook(parts, selected) };\n}\n\n/** The three commands of a Resource, which every one has. */\nfunction unchangedResourceCommands(entry: ResourceEntry): boolean {\n  const { hook } = entry;\n\n  return hook.refresh === entry.refresh.hook && hook.reset === entry.reset.hook && hook.retry === entry.retry.hook;\n}\n\n/** What this selection read: the state of the Resource, and the state of its capability where it has one. */\nfunction unchangedResourceState(entry: ResourceEntry, selected: SelectedResource): boolean {\n  return Object.is(entry.hook.state, selected.state) && Object.is(entry.hook.pagination?.state, selected.pagination);\n}\n\nfunction unchangedResourceHook(entry: ResourceEntry, selected: SelectedResource): boolean {\n  return unchangedResourceCommands(entry) && unchangedResourceState(entry, selected);\n}\n\n/**\n * S6/D359: the same Resource that did not move answers the same object, so a child under `memo` is not re-rendered by\n * the mere act of reading it. Every part is a render input, so this is a memo and not a piece of state.\n */\nfunction selectResourceEntry(\n  previous: SelectionEntry | undefined,\n  invokers: ResourceInvokers,\n  selected: SelectedResource,\n): ResourceEntry {\n  if (previous === undefined || !isResourceEntry(previous) || previous.refresh.invoker !== invokers.refresh) {\n    return createResourceEntry(invokers, selected);\n  }\n\n  // Preparing a suspended render must not replace the hook on the committed entry. The three command consumers are\n  // still the same logical consumers; only the selected Resource wrapper is new until commit.\n  return unchangedResourceHook(previous, selected) ? previous : { ...previous, hook: resourceHook(previous, selected) };\n}\n\nfunction detachEntry(entry: SelectionEntry): void {\n  if (isResourceEntry(entry)) {\n    for (const verb of [entry.refresh, entry.reset, entry.retry]) {\n      verb.detach?.();\n      verb.detach = undefined;\n    }\n\n    return;\n  }\n\n  entry.detach?.();\n  entry.detach = undefined;\n}\n\nfunction sameResourceConsumers(previous: ResourceEntry, next: ResourceEntry): boolean {\n  return previous.refresh === next.refresh && previous.reset === next.reset && previous.retry === next.retry;\n}\n\nfunction sameConsumers(previous: SelectionEntry, next: SelectionEntry | undefined): boolean {\n  if (previous === next) return true;\n  if (next === undefined || !isResourceEntry(previous) || !isResourceEntry(next)) return false;\n\n  return sameResourceConsumers(previous, next);\n}\n\nfunction hookOf(entry: SelectionEntry): CommandHook<never, unknown> | SelectedResourceHook {\n  return entry.hook;\n}\n\n/** Selection is inert during render; only a committed selection can admit work or discard an old queue. */\nclass CommandGroup {\n  private entries = new Map<PropertyKey, SelectionEntry>();\n  /** One set of invokers per Resource identity, so `run` keeps its reference across renders (D359). */\n  private readonly invokers = new WeakMap<object, ResourceInvokers>();\n  private readonly listeners = new Set<() => void>();\n  private revision = 0;\n\n  close(): void {\n    for (const entry of this.entries.values()) detachEntry(entry);\n\n    this.entries.clear();\n  }\n\n  commit(selected: Map<PropertyKey, SelectionEntry>): void {\n    for (const [key, entry] of this.entries) {\n      if (!sameConsumers(entry, selected.get(key))) detachEntry(entry);\n    }\n\n    this.entries = selected;\n\n    for (const entry of selected.values()) this.attachEntry(entry);\n  }\n\n  /** S7: the attach runs on every commit, so the verbs are named rather than gathered into an array. */\n  private attachEntry(entry: SelectionEntry): void {\n    if (isResourceEntry(entry)) {\n      this.attachVerb(entry.refresh);\n      this.attachVerb(entry.retry);\n      this.attachVerb(entry.reset);\n\n      return;\n    }\n\n    this.attachCommand(entry);\n  }\n\n  private attachCommand(command: CommandEntry): void {\n    command.detach ??= command.slot.attach((inFlight, outcome) => {\n      if (!updateEntry(command, inFlight, outcome)) return;\n\n      this.revision += 1;\n\n      for (const listener of this.listeners) listener();\n    });\n  }\n\n  private attachVerb(verb: ResourceVerbEntry): void {\n    verb.detach ??= verb.slot.attach((inFlight, outcome) => {\n      if (!updateVerbEntry(verb, inFlight, outcome)) return;\n\n      this.revision += 1;\n\n      for (const listener of this.listeners) listener();\n    });\n  }\n\n  getSnapshot = (): number => this.revision;\n\n  /**\n   * D321: two outcomes no longer, but two kinds. A command that is not bound is still a `ContributionError`; a\n   * resource never appears in `frame.commandRecords`, so it is prepared from its own identity instead.\n   */\n  prepare(commands: CommandSelection, resources: ResourceSelection, frame: Frame): Map<PropertyKey, SelectionEntry> {\n    const selected = new Map<PropertyKey, SelectionEntry>();\n\n    for (const key of Reflect.ownKeys(commands)) {\n      if (!Object.prototype.propertyIsEnumerable.call(commands, key)) continue;\n\n      const command = (commands as Readonly<Record<PropertyKey, Command<never, unknown>>>)[key];\n      const record = command === undefined ? undefined : frame.commandRecords.get(command);\n\n      if (record === undefined) {\n        throw new ContributionError('missing', `Command at ${String(key)} is not bound in this contribution.`);\n      }\n\n      selected.set(key, selectEntry(this.entries.get(key), record.invoker));\n    }\n\n    for (const [key, resource] of resources) {\n      const invokers = resourceInvokers(resource.resource, this.invokers);\n\n      selected.set(key, selectResourceEntry(this.entries.get(key), invokers, resource));\n    }\n\n    return selected;\n  }\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n\n    return () => {\n      this.listeners.delete(listener);\n    };\n  };\n}\n\nfunction useCommandGroup(commands: CommandSelection, resources: ResourceSelection): CommandGroup | undefined {\n  const groupRef = useRef<CommandGroup | undefined>(undefined);\n  const populated =\n    resources.size > 0 ||\n    Reflect.ownKeys(commands).some(key => Object.prototype.propertyIsEnumerable.call(commands, key));\n\n  return populated ? (groupRef.current ??= new CommandGroup()) : undefined;\n}\n\n/** The consumers of one selection: a command per key, and the two verbs of a resource per key (D321). */\nfunction useSelectionHooks(commands: CommandSelection, resources: ResourceSelection): SelectionHooks {\n  const frame = useFrame();\n  const group = useCommandGroup(commands, resources);\n  const getSnapshot = group?.getSnapshot ?? idleRevision;\n  useSyncExternalStore(group?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n  const selected = group?.prepare(commands, resources, frame);\n  useInsertionEffect(() => () => group?.close(), [group]);\n  useInsertionEffect(() => {\n    if (selected !== undefined) group?.commit(selected);\n  });\n  useLayoutEffect(() => {\n    if (selected === undefined) return;\n\n    // S7: the same branch as the attach — this runs after every commit, and the arrays were pure allocation.\n    for (const entry of selected.values()) {\n      if (isResourceEntry(entry)) {\n        entry.refresh.slot.synchronize();\n        entry.retry.slot.synchronize();\n        entry.reset.slot.synchronize();\n      } else entry.slot.synchronize();\n    }\n  });\n\n  return selected === undefined\n    ? emptyHooks\n    : Object.fromEntries([...selected].map(([key, entry]) => [key, hookOf(entry)]));\n}\n\nexport { useSelectionHooks };\nexport type { SelectionHooks };\n","import type { Readable, ResourceView } from '@opetope/core';\nimport {\n  enterSelectorEvaluation,\n  isCallTarget,\n  isReadable,\n  isResourceView,\n  leaveSelectorEvaluation,\n  resourceViewDemands,\n  resourceViewReadable,\n} from '@opetope/core/internal';\nimport type { ResourceDemand } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\nimport type { AnyCommand } from './model-binding';\nimport { isResource } from './resource-command';\nimport type { AnyResource } from './resource-command';\n\ntype SelectionValue<Candidate> =\n  Candidate extends ResourceView<infer Value> ? Value : Candidate extends Readable<infer Value> ? Value : never;\n\ninterface SelectionRead {\n  <Candidate extends Readable<unknown> | ResourceView<unknown>>(source: Candidate): SelectionValue<Candidate>;\n  <Candidate extends Readable<unknown> | ResourceView<unknown>, Selected>(\n    source: Candidate,\n    select: (value: SelectionValue<Candidate>) => Selected,\n  ): Selected;\n}\n\n/** The tracked reader passed to a `useModel` selector. Reading a view records demand for commit. */\ntype SelectionContext = Readonly<{\n  /** Read a source for this selection, tracking it so the selection updates when it changes. */\n  read: SelectionRead;\n}>;\n\ntype SelectionRecord = Readonly<Record<PropertyKey, unknown>>;\n/**\n * D359: the Resource a field selected, and what this selection read from it — its state, and the state of its\n * pagination capability when it has one. Both are read passively: a selection takes no lease by reading.\n */\ntype SelectedResource = Readonly<{ pagination: unknown; resource: AnyResource; state: unknown }>;\ntype SelectionSnapshot = Readonly<{\n  commands: Readonly<Record<PropertyKey, AnyCommand>>;\n  /** The set the mount leases; two keys naming one resource are one lease. */\n  leases: ReadonlySet<ResourceDemand>;\n  resources: ReadonlyMap<PropertyKey, SelectedResource>;\n  sources: ReadonlySet<Readable<unknown>>;\n  values: SelectionRecord;\n}>;\n\nconst noResources: ReadonlyMap<PropertyKey, SelectedResource> = new Map();\n\n/**\n * D363: what this mount read last and the snapshot it answered with. It belongs to the mount and not to the reader:\n * React may discard the `useMemo` that builds the reader, and a memory kept there would be empty exactly when it is\n * needed. D364: it no longer remembers which sources ended — a source whose owner retired stops instead of refusing,\n * so it answers its last value on every read and there is nothing to remember or to step around.\n */\ntype SelectionMemory = {\n  model: unknown;\n  observed: Map<Readable<unknown>, unknown> | undefined;\n  select: unknown;\n  snapshot: SelectionSnapshot;\n};\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction readSource<Value>(source: Readable<Value>, sources: Map<Readable<unknown>, unknown>): Value {\n  if (!isReadable(source)) {\n    throw new ContributionError('binding-invalid', 'Model selection read requires a Readable or ResourceView.');\n  }\n\n  if (sources.has(source)) return sources.get(source) as Value;\n\n  // D364: a refusal here is the source's own failure and belongs to the render, because no lifetime ends in one.\n  const value: unknown = source.getSnapshot();\n  sources.set(source, value);\n\n  return value as Value;\n}\n\nfunction readPassively(source: Readable<unknown>, sources: Map<Readable<unknown>, unknown>): unknown {\n  if (sources.has(source)) return sources.get(source);\n\n  const value: unknown = source.getSnapshot();\n  sources.set(source, value);\n\n  return value;\n}\n\n/** D525: the built-in containers a selection result may not be, beside an array and a thenable. */\nconst CONTAINERS: readonly (abstract new (...args: never[]) => object)[] = [Date, Map, Set, RegExp, WeakMap, WeakSet];\n\n/** D525: what the types no longer refuse as a selection result, refused here as it was there. */\nfunction isContainer(value: object): boolean {\n  if (Array.isArray(value) || typeof (value as { readonly then?: unknown }).then === 'function') return true;\n\n  for (const container of CONTAINERS) if (value instanceof container) return true;\n\n  return false;\n}\n\n/**\n * D525: a field of the result that is still a source would hand the component the source object — a truth test always\n * passes and a render never updates — so the selection refuses it by name. The types no longer check the result, and\n * this is where the refusal stands, in development and in production alike. A Resource is a field by D359 and answers\n * its hook; a Command answers its hook too. Only the field itself is asked, so a source one level down passes.\n */\nfunction refuseSource(key: PropertyKey, value: unknown): void {\n  if (isReadable(value)) {\n    throw new TypeError(`A selector returned a Readable in field \"${String(key)}\": read(source) inside the selector.`);\n  }\n  if (isResourceView(value)) {\n    throw new TypeError(\n      `A selector returned a ResourceView in field \"${String(key)}\": read(view) inside the selector, or select the Resource.`,\n    );\n  }\n}\n\n/** D359: the predicate that answers the question the type of the field asked, and the read that leases nothing. */\nfunction classifyResource(\n  key: PropertyKey,\n  value: unknown,\n  resources: Map<PropertyKey, SelectedResource>,\n  sources: Map<Readable<unknown>, unknown>,\n): void {\n  if (!isResource(value)) {\n    refuseSource(key, value);\n\n    return;\n  }\n\n  const resource = value as AnyResource;\n  const capability = (\n    resource as { readonly pagination?: { readonly state: Readable<unknown> } | ResourceView<unknown> }\n  ).pagination;\n\n  resources.set(key, {\n    pagination: capability === undefined ? undefined : readPassively(resourceViewReadable(capability), sources),\n    resource,\n    state: readPassively(resourceViewReadable(resource), sources),\n  });\n}\n\nfunction selectedResources(resources: Map<PropertyKey, SelectedResource>): ReadonlyMap<PropertyKey, SelectedResource> {\n  return resources.size === 0 ? noResources : resources;\n}\n\ntype CollectedSelection = Readonly<{\n  leases: ReadonlySet<ResourceDemand>;\n  resources: ReadonlyMap<PropertyKey, SelectedResource>;\n  values: SelectionRecord;\n}>;\n\nfunction collectResourceDemands(\n  resources: ReadonlyMap<PropertyKey, SelectedResource>,\n  leases: Set<ResourceDemand>,\n): void {\n  for (const { resource } of resources.values()) {\n    if (isResourceView(resource)) {\n      for (const demand of resourceViewDemands(resource)) leases.add(demand);\n    } else {\n      leases.add(resource);\n    }\n  }\n}\n\n/**\n * D359: recognition happens in the one pass that already walks the selection. `Resource` is a structural contract\n * (D199) and the type of a selected field promises `ResourceHook` for anything that satisfies it, so the predicate\n * this uses answers the same question the type asked. Reading the state here also puts it among `sources`, so its\n * publication invalidates the fast path of this reader exactly as a read source does.\n */\nfunction collectSelection(\n  select: (context: SelectionContext) => object,\n  sources: Map<Readable<unknown>, unknown>,\n): CollectedSelection {\n  const leases = new Set<ResourceDemand>();\n  let open = true;\n  const read = <Value, Selected>(\n    source: Readable<Value> | ResourceView<Value>,\n    project?: (value: Value) => Selected,\n  ) => {\n    // D518: what a selection read belongs to the snapshot it built; a reader kept past it would add demand to a\n    // committed snapshot nobody compares again.\n    if (!open)\n      throw new TypeError(\"A selector's read was called after the selector returned: read inside the selector.\");\n\n    let readable: Readable<Value>;\n    if (isResourceView(source)) {\n      for (const demand of resourceViewDemands(source)) leases.add(demand);\n      readable = source.observe();\n    } else {\n      readable = source;\n    }\n    const value = readSource(readable, sources);\n\n    return project === undefined ? value : project(value);\n  };\n  enterSelectorEvaluation();\n  try {\n    const selected = select({ read });\n\n    if (typeof selected !== 'object' || selected === null || isContainer(selected)) {\n      throw new ContributionError(\n        'binding-invalid',\n        'Model selection requires a record of named fields, not an array, a promise or another container.',\n      );\n    }\n\n    const entries: (readonly [PropertyKey, unknown])[] = [];\n    const resources = new Map<PropertyKey, SelectedResource>();\n\n    for (const key of Reflect.ownKeys(selected)) {\n      if (!Object.prototype.propertyIsEnumerable.call(selected, key)) continue;\n\n      const value = (selected as SelectionRecord)[key];\n\n      entries.push([key, value]);\n      classifyResource(key, value, resources, sources);\n    }\n\n    // `__proto__` is a key like any other here, and only a defined property keeps it one (D214).\n    collectResourceDemands(resources, leases);\n    return { leases, resources: selectedResources(resources), values: Object.fromEntries(entries) };\n  } finally {\n    open = false;\n    leaveSelectorEvaluation();\n  }\n}\n\n/**\n * D359: `values` keeps the Resource itself — a stable reference — so a selection that holds one is compared by\n * `Object.is` exactly as before. What moves is the state behind it, and that is compared here: without this the\n * selection would be «equal», the previous state would be kept, and a published Resource would reach no render.\n */\nfunction equalResources(\n  previous: ReadonlyMap<PropertyKey, SelectedResource>,\n  next: ReadonlyMap<PropertyKey, SelectedResource>,\n): boolean {\n  if (previous.size !== next.size) return false;\n\n  for (const [key, selected] of next) {\n    const before = previous.get(key);\n\n    if (\n      before?.resource !== selected.resource ||\n      !Object.is(before.state, selected.state) ||\n      !Object.is(before.pagination, selected.pagination)\n    ) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction equalMembers<Value>(previous: ReadonlySet<Value>, next: ReadonlySet<Value>): boolean {\n  if (previous.size !== next.size) return false;\n  for (const value of next) if (!previous.has(value)) return false;\n  return true;\n}\n\nfunction equalSelection(\n  previous: SelectionSnapshot,\n  values: SelectionRecord,\n  sources: ReadonlySet<Readable<unknown>>,\n  resources: ReadonlyMap<PropertyKey, SelectedResource>,\n  leases: ReadonlySet<ResourceDemand>,\n) {\n  const keys = Reflect.ownKeys(values);\n  const previousKeys = Reflect.ownKeys(previous.values);\n\n  if (keys.length !== previousKeys.length) return false;\n  if (!equalMembers(previous.sources, sources)) return false;\n  if (!equalMembers(previous.leases, leases)) return false;\n\n  if (!equalResources(previous.resources, resources)) return false;\n\n  return keys.every((key, index) => previousKeys[index] === key && Object.is(previous.values[key], values[key]));\n}\n\ntype ModelSelector<Model> = (model: Model, context: SelectionContext) => object;\ntype SelectionReaderRef<Model> = { readonly current: ModelSelector<Model> | undefined };\n\nconst emptySelectionSnapshot: SelectionSnapshot = {\n  commands: {},\n  leases: noLeases,\n  resources: noResources,\n  sources: new Set(),\n  values: {},\n};\n\nfunction selectionCommands(values: SelectionRecord): Readonly<Record<PropertyKey, AnyCommand>> {\n  return Object.fromEntries(\n    Reflect.ownKeys(values)\n      .filter(key => isCallTarget(values[key]))\n      .map(key => [key, values[key]]),\n  ) as Readonly<Record<PropertyKey, AnyCommand>>;\n}\n\n/**\n * The fast path re-reads what it observed. D364: a source that stopped answers the same value it answered last, so\n * it compares equal and costs one read — there is no terminal source to record and step around any more.\n */\nfunction observedUnchanged(observed: Map<Readable<unknown>, unknown>): boolean {\n  enterSelectorEvaluation();\n  try {\n    for (const [source, value] of observed) {\n      if (!Object.is(source.getSnapshot(), value)) return false;\n    }\n\n    return true;\n  } finally {\n    leaveSelectorEvaluation();\n  }\n}\n\n/** D363: the memory of one mount, empty until its first read and reset when the reader is built for another model. */\nfunction createSelectionMemory(): SelectionMemory {\n  return { model: undefined, observed: undefined, select: undefined, snapshot: emptySelectionSnapshot };\n}\n\n/**\n * D214: one reader per model, not per render. The author's selector arrives through a ref, so an inline arrow does not\n * rebuild the reader; the fast path — nothing observed has moved — belongs to the selector that computed the snapshot,\n * so a new selector is always called again, its result compared field by field, and an equal selection keeps the\n * previous snapshot. A rejected or abandoned render still changes nothing: only a committed selection subscribes.\n *\n * D363: what the reader remembers lives in the mount's memory, so a reader React rebuilt — because it discarded the\n * memo — still knows what this selection read last.\n */\nfunction createSelectionSnapshot<Model>(\n  model: Model,\n  selectRef: SelectionReaderRef<Model>,\n  memory: SelectionMemory,\n): () => SelectionSnapshot {\n  if (memory.model !== model) {\n    memory.model = model;\n    memory.observed = undefined;\n    memory.select = undefined;\n    memory.snapshot = emptySelectionSnapshot;\n  }\n\n  return () => {\n    const select = selectRef.current;\n\n    if (select === undefined) return emptySelectionSnapshot;\n\n    const observed = memory.observed;\n\n    if (observed !== undefined && memory.select === select && observedUnchanged(observed)) {\n      return memory.snapshot;\n    }\n\n    const nextObserved = new Map<Readable<unknown>, unknown>();\n    const { leases, resources, values } = collectSelection(context => select(model, context), nextObserved);\n    const sources = new Set(nextObserved.keys());\n\n    if (observed === undefined || !equalSelection(memory.snapshot, values, sources, resources, leases)) {\n      memory.snapshot = {\n        commands: selectionCommands(values),\n        leases,\n        resources,\n        sources,\n        values,\n      };\n    }\n\n    memory.observed = nextObserved;\n    memory.select = select;\n\n    return memory.snapshot;\n  };\n}\n\nexport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot };\nexport type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionSnapshot };\n","import { useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command, ModelOf, PaginatedResource, Resource } from '@opetope/core';\n\nimport type { CommandHook } from './command-hook';\nimport { useSelectionHooks } from './selection-hooks';\nimport type { SelectionHooks } from './selection-hooks';\nimport { ContributionError } from './errors';\nimport { subscribeIdle } from './idle-subscription';\nimport type { AnyModel } from './model-binding';\nimport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot } from './model-selection-snapshot';\nimport type { ModelSelector, SelectionContext, SelectionMemory, SelectionSnapshot } from './model-selection-snapshot';\nimport { ModelSelectionStore } from './model-selection-store';\nimport { useFrame } from './mount-context';\nimport type { PaginatedResourceHook, ResourceHook, ResourceKey } from './resource-command';\nimport type { RefusedSelection, SelectorModel } from './selector-sources';\n\n/**\n * D359: a field whose value is a Resource answers the hook `useResource` answers, and the mount leases it exactly as\n * `useResource` does. `read(resource.state)` is unchanged — it hands out the state and leases nothing — so naming one\n * Resource both ways registers it twice: the subscription and the lease are independent.\n */\ntype SelectedValue<Value> =\n  Value extends Command<infer Input, infer Output>\n    ? CommandHook<Input, Output>\n    : Value extends PaginatedResource<\n          infer Data,\n          infer Key extends ResourceKey,\n          infer Cursor extends ResourceKey,\n          'consumers' | 'model'\n        >\n      ? PaginatedResourceHook<Data, Key, Cursor>\n      : Value extends Resource<infer Data, infer Key extends ResourceKey, 'consumers' | 'model'>\n        ? ResourceHook<Data, Key>\n        : Value;\ntype ModelSelection<Selected> = { readonly [Key in keyof Selected]: SelectedValue<Selected[Key]> };\n\nconst readEmptySnapshot = () => emptySelectionSnapshot;\n\nfunction useSelectionStore(selected: boolean): ModelSelectionStore | undefined {\n  const storeRef = useRef<ModelSelectionStore | undefined>(undefined);\n\n  return selected ? (storeRef.current ??= new ModelSelectionStore()) : undefined;\n}\n\ntype SelectionResult = Readonly<Record<PropertyKey, unknown>>;\n\n/**\n * Two branches of one key: the consumer this selection prepared — a bound command, or the verbs, the state and the\n * capability of a selected Resource — and otherwise the value the selector wrote. S6/D359: the Resource branch is\n * assembled on the record and not here, so a key whose state did not move hands back the very same object.\n */\nfunction selectedValue(snapshot: SelectionSnapshot, hooks: SelectionHooks, key: PropertyKey): unknown {\n  return Object.prototype.hasOwnProperty.call(hooks, key) ? hooks[key] : snapshot.values[key];\n}\n\nfunction mergeSelection(\n  snapshot: SelectionSnapshot,\n  hooks: SelectionHooks,\n  committed: SelectionResult | undefined,\n): SelectionResult {\n  const keys = Reflect.ownKeys(snapshot.values);\n\n  if (committed !== undefined) {\n    const oldKeys = Reflect.ownKeys(committed);\n\n    if (keys.length === oldKeys.length) {\n      let equal = true;\n      for (let index = 0; index < keys.length; index += 1) {\n        const key = keys[index]!;\n        if (key !== oldKeys[index] || !Object.is(committed[key], selectedValue(snapshot, hooks, key))) {\n          equal = false;\n          break;\n        }\n      }\n      if (equal) return committed;\n    }\n  }\n\n  return Object.fromEntries(keys.map(key => [key, selectedValue(snapshot, hooks, key)]));\n}\n\n/** Read a granted model; a selection reads sources through `read` and binds Command or Resource fields. */\nfunction useModel<Declaration extends AnyModel>(declaration: Declaration): ModelOf<Declaration>;\nfunction useModel<Declaration extends AnyModel, const Selected extends object = RefusedSelection>(\n  declaration: Declaration,\n  select: (model: SelectorModel<ModelOf<Declaration>>, context: SelectionContext) => Selected,\n): ModelSelection<Selected>;\nfunction useModel<Declaration extends AnyModel>(\n  declaration: Declaration,\n  select?: (model: SelectorModel<ModelOf<Declaration>>, context: SelectionContext) => object,\n): unknown {\n  const frame = useFrame();\n\n  if (!frame.models.has(declaration)) {\n    throw new ContributionError('missing', `Model ${declaration.id} is not granted to this contribution.`);\n  }\n\n  const model = frame.models.get(declaration) as SelectorModel<ModelOf<Declaration>>;\n  const store = useSelectionStore(select !== undefined);\n  // D214: the selector of this render, read by a reader that belongs to the model. Writing the latest callback into\n  // a ref is what `useSyncExternalStoreWithSelector` does: the reader only reads it, and never writes to it.\n  const selectRef = useRef<ModelSelector<SelectorModel<ModelOf<Declaration>>> | undefined>(undefined);\n  selectRef.current = select;\n  const selected = select !== undefined;\n  // D363: the memory of this selection belongs to the mount, so a reader React rebuilt keeps what it read last.\n  const memoryRef = useRef<SelectionMemory | undefined>(undefined);\n  const memory = (memoryRef.current ??= createSelectionMemory());\n  const getSnapshot = useMemo(\n    () => (selected ? createSelectionSnapshot(model, selectRef, memory) : readEmptySnapshot),\n    [memory, model, selected],\n  );\n  const snapshot = useSyncExternalStore(store?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n  const hooks = useSelectionHooks(snapshot.commands, snapshot.resources);\n  useLayoutEffect(() => () => store?.close(), [store]);\n  // D359: a lease is taken in commit and never in a render, and the store diffs the set by identity.\n  useLayoutEffect(() => store?.commit(snapshot.sources, snapshot.leases), [snapshot, store]);\n\n  // An abandoned render may prepare another record, but only a committed render replaces the comparison baseline.\n  const committedResult = useRef<SelectionResult | undefined>(undefined);\n  const result = selected ? mergeSelection(snapshot, hooks, committedResult.current) : undefined;\n  useLayoutEffect(() => {\n    committedResult.current = result;\n  }, [result]);\n\n  if (select === undefined) return model;\n\n  return result;\n}\n\nexport { useModel };\n","import type { FunctionComponent } from 'react';\n\nimport type { ModelIdentity } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\n\ntype AnyModel = ModelIdentity;\n\n/*\n * The marker a component uses to state which UI models of its contribution it reads. `slot` checks by type that the\n * contribution grants every model of this list — it may grant more, because the mount serves its whole instance.\n *\n * The runtime authority is the mount frame, not this marker: `useModel` resolves against what the mount was given\n * and refuses anything else. The lint rule `opetope/require-declared-models` checks visible contribution sites and\n * each reader of a per-mount model within the same module. Imported implementations and dynamic declaration lists\n * remain unknown to this syntactic check (D85, D158, D250).\n */\n/**\n * The marker a component uses to state which UI models of its contribution it reads.\n */\ntype ComponentRequiringModels<Props, Models extends readonly AnyModel[]> = FunctionComponent<Props> & {\n  readonly requires: Models;\n};\n\n/*\n * Declares the UI models a component reads and returns the same component marked with them, so `slot` can check by\n * type that the contribution grants each one. Marking a component that already declares its models throws.\n *\n * Write the component as a top-level function and wrap it after — `function CountView() { … }`, then\n * `export const Count = requiresModels([CountModel])(CountView)`: React Compiler in infer mode does not compile a\n * component written inside the call.\n */\n/**\n * Declares the UI models a component reads and returns the same component marked with them, so `slot` can check by type that the contribution grants each one.\n */\nfunction requiresModels<const Models extends readonly AnyModel[]>(\n  models: Models,\n): <Props>(component: FunctionComponent<Props>) => ComponentRequiringModels<Props, Models> {\n  const declared = Object.freeze([...models]) as unknown as Models;\n\n  return <Props>(component: FunctionComponent<Props>): ComponentRequiringModels<Props, Models> => {\n    const existing = (component as { readonly requires?: readonly AnyModel[] }).requires;\n\n    if (existing !== undefined) {\n      throw new ContributionError('duplicate', 'Component already declares the models it requires.');\n    }\n\n    Object.defineProperty(component, 'requires', { enumerable: false, value: declared });\n\n    return component as ComponentRequiringModels<Props, Models>;\n  };\n}\n\nexport { requiresModels };\n","import { useCallback, useLayoutEffect, useMemo, useState, useSyncExternalStore } from 'react';\n\nimport type { PaginatedResource, PaginationState, Readable, Resource } from '@opetope/core';\nimport type { ResourceKey } from '@opetope/core/internal';\nimport { resourceViewDemands, resourceViewReadable } from '@opetope/core/internal';\n\nimport { ModelSelectionStore } from './model-selection-store';\nimport { createResourceInvokers, paginationOf } from './resource-command';\nimport type { AnyResource, PaginatedResourceHook, ResourceHook, ResourcePaginationHook } from './resource-command';\nimport { ResourceVerbController, useResourceVerbStatus } from './resource-verb-hook';\n\ntype ResourceSlots = Readonly<{\n  /** D486: the stable function of `pagination.loadNext`, kept with the verbs of the same Resource identity. */\n  loadNext: (options?: { readonly retry?: boolean }) => Promise<unknown>;\n  refresh: ResourceVerbController;\n  reset: ResourceVerbController;\n  retry: ResourceVerbController;\n}>;\n\n/**\n * D359: one set of controllers per Resource identity, exactly as `useCommandSlot` keeps one per invoker. The slots are\n * what the set of invokers is kept alive by, so one map answers for all three verbs and `loadNext`. Slots are inert\n * until commit, so an interrupted render neither admits work nor resets the status of the committed one.\n */\nfunction useResourceSlots(resource: AnyResource): ResourceSlots {\n  const [cache] = useState(() => new WeakMap<object, ResourceSlots>());\n  const existing = cache.get(resource);\n\n  if (existing !== undefined) return existing;\n\n  const invokers = createResourceInvokers(resource);\n  const slots: ResourceSlots = {\n    loadNext: invokers.loadNext,\n    refresh: new ResourceVerbController(invokers.refresh),\n    reset: new ResourceVerbController(invokers.reset),\n    retry: new ResourceVerbController(invokers.retry),\n  };\n  cache.set(resource, slots);\n\n  return slots;\n}\n\nconst unavailablePagination: PaginationState<ResourceKey> = Object.freeze({\n  kind: 'unavailable',\n  reason: 'resource-not-ready',\n});\nconst noPaginationSource: Readable<PaginationState<ResourceKey>> = Object.freeze({\n  getSnapshot: () => unavailablePagination,\n  subscribe: () => () => undefined,\n});\n\n/** Lease a Resource for this committed component and read its state and optional pagination. */\nfunction useResource<Data, Key extends ResourceKey, Cursor extends ResourceKey>(\n  resource: PaginatedResource<Data, Key, Cursor, 'consumers' | 'model'>,\n): PaginatedResourceHook<Data, Key, Cursor>;\nfunction useResource<Data, Key extends ResourceKey>(\n  resource: Resource<Data, Key, 'consumers' | 'model'>,\n): ResourceHook<Data, Key>;\nfunction useResource<Data, Key extends ResourceKey>(\n  resource: Resource<Data, Key, 'consumers' | 'model'>,\n): ResourceHook<Data, Key> {\n  const handle = resource as unknown as AnyResource;\n  const capability = paginationOf(handle);\n  const [store] = useState(() => new ModelSelectionStore());\n  const stateSource = useMemo(() => resourceViewReadable(resource), [resource]);\n  const subscribe = useCallback((listener: () => void) => store.subscribe(listener), [store]);\n  /*\n   * D364: `resource.state` is a total `Readable` for the life of the object this hook holds — a retired one answers\n   * `idle('retired')` — so the read needs no memory of its own. What it can still refuse is a producer failure, a\n   * broken `cursor` among them (D356), and that belongs to the render (G13).\n   */\n  const getState = useMemo(() => () => stateSource.getSnapshot(), [stateSource]);\n  const state = useSyncExternalStore(subscribe, getState, getState);\n  const paginationSource: Readable<PaginationState<ResourceKey>> =\n    capability === undefined ? noPaginationSource : resourceViewReadable(capability);\n  const subscribePagination = useCallback(\n    (listener: () => void) => paginationSource.subscribe(listener),\n    [paginationSource],\n  );\n  const getPaginationState = useMemo(() => () => paginationSource.getSnapshot(), [paginationSource]);\n  const paginationState = useSyncExternalStore(subscribePagination, getPaginationState, getPaginationState);\n\n  // Acquire in layout for a committed Resource. The store releases with its passive subscription, so a Suspense\n  // hide that disconnects layout effects keeps the mounted component's lease.\n  useLayoutEffect(() => {\n    store.commit(new Set([stateSource]), new Set(resourceViewDemands(resource)));\n  }, [resource, stateSource, store]);\n\n  const slots = useResourceSlots(handle);\n  const refresh = useResourceVerbStatus(slots.refresh);\n  const retry = useResourceVerbStatus(slots.retry);\n  const reset = useResourceVerbStatus(slots.reset);\n  const { loadNext } = slots;\n  const pagination = useMemo(\n    () =>\n      capability === undefined\n        ? undefined\n        : ({ loadNext, state: paginationState } as unknown as ResourcePaginationHook<ResourceKey>),\n    [capability, loadNext, paginationState],\n  );\n\n  return useMemo(() => ({ pagination, refresh, reset, retry, state }), [pagination, refresh, reset, retry, state]);\n}\n\nexport { useResource };\n","import type { ComponentType, ReactNode } from 'react';\nimport { createElement, Fragment } from 'react';\n\nimport type { DeclarationId } from '@opetope/core';\nimport { declarationId } from '@opetope/core';\nimport type { ContributionTarget } from '@opetope/core/internal';\nimport { createContributionTarget } from '@opetope/core/internal';\nimport type { ContributionModel } from '@opetope/runtime/internal';\n\nimport { contributionAuthority, ContributionMount } from './contribution-frame';\nimport { useReadable } from './readable-hooks';\n\ntype SlotProperties = object | undefined;\ntype EmptySlotProperties = Readonly<Record<string, never>>;\ntype SlotComponentProperties<Props extends SlotProperties> = [Props] extends [undefined]\n  ? EmptySlotProperties\n  : Extract<Props, object>;\n\n/**\n * Contribution component and adapter published for a Slot target.\n */\ntype SlotContribution<Props extends SlotProperties = undefined> = {\n  readonly Component: ComponentType<never>;\n  readonly models?: readonly ContributionModel[];\n  readonly props?: (slotProps: SlotComponentProperties<Props>) => object;\n};\n\ntype SlotTarget<Props extends SlotProperties = undefined> = ContributionTarget<SlotContribution<Props>>;\n\ntype SwitchSlotTarget<Route extends string, Props extends SlotProperties = undefined> = ((\n  route: Route,\n) => SlotTarget<Props>) & {\n  readonly id: DeclarationId;\n};\n\ntype SlotRenderProps<Props extends SlotProperties> = [Props] extends [undefined]\n  ? {\n      readonly props?: 'this slot has no props: omit the props field';\n      readonly target: SlotTarget<Props>;\n    }\n  : {\n      readonly props: SlotComponentProperties<Props>;\n      readonly target: SlotTarget<Props>;\n    };\n\nconst emptySlotProperties: EmptySlotProperties = Object.freeze({});\n\n/**\n * Declare a typed Slot target by its id.\n */\nfunction defineSlot<Props extends SlotProperties = undefined>(id: string): SlotTarget<Props> {\n  return createContributionTarget<SlotContribution<Props>>(id, 'slot');\n}\n\nfunction defineSwitchSlot<Route extends string, Props extends SlotProperties = undefined>(\n  id: string,\n): SwitchSlotTarget<Route, Props> {\n  const declared = declarationId(id);\n  const targets = new Map<Route, SlotTarget<Props>>();\n\n  const switchSlot = (route: Route): SlotTarget<Props> => {\n    const existing = targets.get(route);\n\n    if (existing !== undefined) return existing;\n\n    const target = defineSlot<Props>(`${declared}/${route}`);\n    targets.set(route, target);\n\n    return target;\n  };\n\n  Object.defineProperty(switchSlot, 'id', { enumerable: true, value: declared });\n\n  return Object.freeze(switchSlot) as SwitchSlotTarget<Route, Props>;\n}\n\n/**\n * Render the published contributions of a Slot target within their owning mounts.\n */\nfunction Slot<Props extends SlotProperties>(\n  options: SlotRenderProps<NoInfer<Props>> & { readonly target: SlotTarget<Props> },\n): ReactNode {\n  const entries = useReadable(options.target.entries);\n  const slotProps: object =\n    'props' in options ? ((options.props as object | undefined) ?? emptySlotProperties) : emptySlotProperties;\n\n  if (entries.length === 0) return null;\n\n  return entries.map(entry =>\n    createElement(\n      Fragment,\n      { key: entry.id },\n      createElement(ContributionMount, {\n        authority: contributionAuthority(entry),\n        contribution: entry.value,\n        contributionId: entry.id,\n        slotProps,\n        targetId: options.target.id,\n      }),\n    ),\n  );\n}\n\nexport { defineSlot, defineSwitchSlot, Slot };\nexport type { SlotComponentProperties, SlotContribution, SlotProperties, SlotTarget, SwitchSlotTarget };\n"],"names":["failureOutcome","options","error","isCancellation","notification","_a","reportDetachedError","callbackError","runOptions","onSuccess","signal","requestOf","input","resolve","promise","settle","request","outcome","CommandHookController","ContributionError","aborted","invoker","notify","CommandError","compatibleAbortReason","invocation","value","emptyStatus","settledOutcome","unchangedState","current","slot","inFlight","settled","nextState","previous","useCommandSlot","slots","useState","useCommandStatus","currentSlot","hookState","setHookState","useInsertionEffect","useLayoutEffect","run","useMemo","useCommand","command","record","useFrame","idleRelease","subscribeIdle","idleRevision","cancelled","ResourceVerbController","reject","answer","refuse","waiter","operation","start","next","visibleOutcome","useResourceVerbStatus","emptyHooks","isResourceEntry","entry","createEntry","createVerbEntry","unchangedHook","updateEntry","updateVerbEntry","selectEntry","resourceHook","selected","createResourceEntry","invokers","parts","unchangedResourceCommands","hook","unchangedResourceState","unchangedResourceHook","selectResourceEntry","detachEntry","verb","_b","sameResourceConsumers","sameConsumers","hookOf","CommandGroup","key","listener","commands","resources","frame","resource","resourceInvokers","useCommandGroup","groupRef","useRef","useSelectionHooks","group","getSnapshot","useSyncExternalStore","noResources","noLeases","readSource","source","sources","isReadable","readPassively","CONTAINERS","isContainer","container","refuseSource","isResourceView","classifyResource","isResource","capability","resourceViewReadable","selectedResources","collectResourceDemands","leases","demand","resourceViewDemands","collectSelection","select","open","read","project","readable","enterSelectorEvaluation","entries","leaveSelectorEvaluation","equalResources","before","equalMembers","equalSelection","values","keys","previousKeys","index","emptySelectionSnapshot","selectionCommands","isCallTarget","observedUnchanged","observed","createSelectionMemory","createSelectionSnapshot","model","selectRef","memory","nextObserved","context","readEmptySnapshot","useSelectionStore","storeRef","ModelSelectionStore","selectedValue","snapshot","hooks","mergeSelection","committed","oldKeys","equal","useModel","declaration","store","memoryRef","committedResult","result","requiresModels","models","declared","component","useResourceSlots","cache","existing","createResourceInvokers","unavailablePagination","noPaginationSource","useResource","handle","paginationOf","stateSource","subscribe","useCallback","getState","state","paginationSource","subscribePagination","getPaginationState","paginationState","refresh","retry","reset","loadNext","pagination","emptySlotProperties","defineSlot","id","createContributionTarget","defineSwitchSlot","declarationId","targets","switchSlot","route","target","Slot","useReadable","slotProps","createElement","Fragment","ContributionMount","contributionAuthority"],"mappings":"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"}

package/dist/integration.d.ts

@@ -1,6 +1,2 @@
 export { ContributionBoundary } from './contribution-isolation.js';
 export type { ContributionBoundaryProps, ContributionErrorContent, ContributionFailure, } from './contribution-isolation.js';
-export { FeatureBoundary, FeatureBoundaryError, useFeatureRetry } from './feature-boundary.js';
-export type { FeatureBoundaryProps } from './feature-boundary.js';
-export { useFeature } from './feature-demand.js';
-export type { FeatureDemandLease, FeatureDemandResult, FeatureDemandSource, FeatureDemandState, } from './feature-demand.js';

package/dist/integration.js

@@ -1,2 +1,2 @@
-import{a as M}from"./contribution-isolation-Bzfbt4iM.js";import{jsx as C}from"react/jsx-runtime";import{useCallback as f,useSyncExternalStore as E,useMemo as h,useEffect as x,useState as S,createContext as B,useContext as g}from"react";const y=()=>{};function b(e){const r=f(t=>e.subscribe(t),[e]),u=f(()=>e.getState(),[e]),d=E(r,u,u),n=h(()=>({current:null,source:e}),[e]);x(()=>{const t=e.acquire();return t.settled.catch(y),()=>{t.release().catch(y)}},[e]);const o=f(()=>{if(n.current!==null)return n.current.settled;let t=()=>{};const s={lease:null,settled:new Promise(p=>{t=p})},c=()=>{n.current===s&&(n.current=null),t()};n.current=s;let i;try{i=n.source.acquire()}catch{return c(),s.settled}return s.lease=i,i.settled.catch(y).finally(c),i.release().catch(y),s.settled},[n]);return h(()=>Object.freeze({retry:o,state:d}),[o,d])}const F=B(void 0);class v extends Error{code;name="FeatureBoundaryError";constructor(r,u){super(u),this.code=r}}function w(){const e=g(F);if(e===void 0)throw new v("missing","Feature error hooks may only be used by the error subtree of a FeatureBoundary.");return e}function q(){return w().retry}function j({children:e,demand:r,error:u,fallback:d}){const{retry:n,state:o}=b(r),[t,s]=S(),c=f(()=>{const a={},m=()=>s(l=>(l==null?void 0:l.attempt)===a?void 0:l);s({attempt:a,demand:r});try{n().finally(m)}catch(l){throw m(),l}},[r,n]),i=h(()=>({retry:c}),[c]),p=(t==null?void 0:t.demand)===r;if(x(()=>{s(a=>a===void 0||a.demand===r&&o.instance===null?a:void 0)},[r,o.instance]),o.instance!==null)return typeof e=="function"?e(o.instance):e;if(o.error!==null&&!p){const a=typeof u=="function"?u({error:o.error,retry:c}):u;return C(F,{value:i,children:a})}return d}export{M as ContributionBoundary,j as FeatureBoundary,v as FeatureBoundaryError,b as useFeature,q as useFeatureRetry};
+import{C as n}from"./contribution-isolation-Ig70xFiC.js";export{n as ContributionBoundary};
 //# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"integration.js","sources":["../src/feature-demand.ts","../src/feature-boundary.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useSyncExternalStore } from 'react';\n\ninterface FeatureDemandLease {\n  readonly release: () => Promise<void>;\n  readonly settled: Promise<void>;\n}\n\ninterface FeatureDemandState<Ready> {\n  readonly error: unknown | null;\n  readonly instance: Ready | null;\n}\n\ninterface FeatureDemandSource<Ready> {\n  acquire(): FeatureDemandLease;\n  getState(): FeatureDemandState<Ready>;\n  subscribe(listener: () => void): () => void;\n}\n\ninterface FeatureDemandResult<Ready> {\n  /** Resolves when the attempt it started has settled, in success and in failure alike (D198). */\n  readonly retry: () => Promise<void>;\n  readonly state: FeatureDemandState<Ready>;\n}\n\nconst ignoreFailure = (): void => undefined;\n\nfunction useFeature<Ready>(source: FeatureDemandSource<Ready>): FeatureDemandResult<Ready> {\n  const subscribe = useCallback((listener: () => void) => source.subscribe(listener), [source]);\n  const getSnapshot = useCallback(() => source.getState(), [source]);\n  const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  const retrying = useMemo<{\n    current: { lease: FeatureDemandLease | null; readonly settled: Promise<void> } | null;\n    readonly source: FeatureDemandSource<Ready>;\n  }>(() => ({ current: null, source }), [source]);\n\n  useEffect(() => {\n    const demand = source.acquire();\n    void demand.settled.catch(ignoreFailure);\n\n    return () => void demand.release().catch(ignoreFailure);\n  }, [source]);\n\n  const retry = useCallback((): Promise<void> => {\n    // Single-flight per source: a second call joins the attempt already running instead of starting another.\n    if (retrying.current !== null) return retrying.current.settled;\n\n    // D198: `acquire` runs foreign code, and a host that answers it synchronously may call `retry` again. The\n    // attempt is reserved with its own promise before that call, so the reentrant caller joins this attempt\n    // instead of taking a second lease of its own.\n    let settle = (): void => undefined;\n    const attempt = {\n      lease: null as FeatureDemandLease | null,\n      settled: new Promise<void>(resolve => {\n        settle = resolve;\n      }),\n    };\n    const finish = (): void => {\n      if (retrying.current === attempt) retrying.current = null;\n\n      settle();\n    };\n    retrying.current = attempt;\n\n    let lease: FeatureDemandLease;\n\n    try {\n      lease = retrying.source.acquire();\n    } catch {\n      // D198: `retry` answers with the promise of the attempt it started, and an acquisition that refused is an\n      // attempt that is over. The refusal belongs to the state the source publishes, which is where the caller\n      // reads it; throwing it back here would leave every caller of `retry` waiting for an attempt that ended.\n      finish();\n\n      return attempt.settled;\n    }\n\n    attempt.lease = lease;\n    void lease.settled.catch(ignoreFailure).finally(finish);\n    void lease.release().catch(ignoreFailure);\n\n    return attempt.settled;\n  }, [retrying]);\n\n  return useMemo(() => Object.freeze({ retry, state }), [retry, state]);\n}\n\nexport { useFeature };\nexport type { FeatureDemandLease, FeatureDemandResult, FeatureDemandSource, FeatureDemandState };\n","import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport { useFeature } from './feature-demand';\nimport type { FeatureDemandSource } from './feature-demand';\n\n/**\n * D177: a branch may be a node or a render callback. The callback receives what only the boundary knows — the ready\n * instance, or the failure with the retry that belongs to this demand — so a ready consumer needs no second\n * `useFeature` and no second lease. A function is never a `ReactNode`, so the two forms cannot be confused.\n */\ntype FeatureBoundaryChildren<Ready> = ((instance: Ready) => ReactNode) | ReactNode;\ntype FeatureBoundaryErrorContent =\n  | ((context: { readonly error: unknown; readonly retry: () => void }) => ReactNode)\n  | ReactNode;\n\n/** The boundary keeps the feature open while it is mounted; its UI enters the host through slots (D85). */\ntype FeatureBoundaryProps<Ready = unknown> = {\n  readonly children: FeatureBoundaryChildren<Ready>;\n  readonly demand: FeatureDemandSource<Ready>;\n  readonly error: FeatureBoundaryErrorContent;\n  readonly fallback: ReactNode;\n};\n\n/** Only `retry` is read: the error itself belongs to the `error` subtree a host already renders (D142). */\ntype FeatureBoundaryErrorContext = {\n  readonly retry: () => void;\n};\n\n/** D198: the error is hidden for the life of the attempt that was started, not until the error object changes. */\ntype SuppressedError = {\n  readonly attempt: object;\n  readonly demand: object;\n};\n\nconst ErrorContext = createContext<FeatureBoundaryErrorContext | undefined>(undefined);\n\n/** One class per subject with the state in `code` (D69): the boundary is its own subject, not a feature failure. */\nclass FeatureBoundaryError extends Error {\n  override readonly name = 'FeatureBoundaryError';\n\n  constructor(\n    readonly code: 'missing',\n    message: string,\n  ) {\n    super(message);\n  }\n}\n\nfunction useBoundaryErrorContext(): FeatureBoundaryErrorContext {\n  const context = useContext(ErrorContext);\n\n  if (context === undefined) {\n    throw new FeatureBoundaryError(\n      'missing',\n      'Feature error hooks may only be used by the error subtree of a FeatureBoundary.',\n    );\n  }\n\n  return context;\n}\n\nfunction useFeatureRetry(): () => void {\n  return useBoundaryErrorContext().retry;\n}\n\nfunction FeatureBoundary<Ready>({ children, demand, error, fallback }: FeatureBoundaryProps<Ready>): ReactNode {\n  const { retry: requestRetry, state } = useFeature(demand);\n  const [suppressed, setSuppressed] = useState<SuppressedError>();\n  const retry = useCallback(() => {\n    const attempt = {};\n    // The attempt is over: whatever it ended with, including the very same error object, is the answer to show.\n    const reveal = (): void => setSuppressed(current => (current?.attempt === attempt ? undefined : current));\n    setSuppressed({ attempt, demand });\n\n    try {\n      void requestRetry().finally(reveal);\n    } catch (error) {\n      // A retry that refuses synchronously has no promise to settle, and an error hidden by it would never be\n      // shown again: the suppression is lifted here before the refusal goes back to whoever asked (D198).\n      reveal();\n\n      throw error;\n    }\n  }, [demand, requestRetry]);\n  const errorContext = useMemo(() => ({ retry }), [retry]);\n  const errorIsSuppressed = suppressed?.demand === demand;\n\n  useEffect(() => {\n    // A suppression outlives neither its source nor a ready feature: only the attempt of this demand may hide it.\n    setSuppressed(current =>\n      current === undefined || (current.demand === demand && state.instance === null) ? current : undefined,\n    );\n  }, [demand, state.instance]);\n\n  // Only the branch that is shown runs its callback: an abandoned branch renders nothing and computes nothing.\n  if (state.instance !== null) return typeof children === 'function' ? children(state.instance) : children;\n\n  if (state.error !== null && !errorIsSuppressed) {\n    const content = typeof error === 'function' ? error({ error: state.error, retry }) : error;\n\n    return <ErrorContext value={errorContext}>{content}</ErrorContext>;\n  }\n\n  return fallback;\n}\n\nexport { FeatureBoundary, FeatureBoundaryError, useFeatureRetry };\nexport type { FeatureBoundaryProps };\n"],"names":["ignoreFailure","useFeature","source","subscribe","useCallback","listener","getSnapshot","state","useSyncExternalStore","retrying","useMemo","useEffect","demand","retry","settle","attempt","resolve","finish","lease","ErrorContext","createContext","FeatureBoundaryError","code","message","useBoundaryErrorContext","context","useContext","useFeatureRetry","FeatureBoundary","children","error","fallback","requestRetry","suppressed","setSuppressed","useState","reveal","current","errorContext","errorIsSuppressed","content","_jsx"],"mappings":"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"}
+{"version":3,"file":"integration.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/model-hook.d.ts

@@ -1,18 +1,19 @@
 import type { Command, ModelOf, PaginatedResource, Resource } from '@opetope/core';
 import type { CommandHook } from './command-hook.js';
 import type { AnyModel } from './model-binding.js';
-import type { SelectionContext, SelectionShape } from './model-selection-snapshot.js';
+import type { SelectionContext } from './model-selection-snapshot.js';
 import type { PaginatedResourceHook, ResourceHook, ResourceKey } from './resource-command.js';
+import type { RefusedSelection, SelectorModel } from './selector-sources.js';
 /**
  * D359: a field whose value is a Resource answers the hook `useResource` answers, and the mount leases it exactly as
  * `useResource` does. `read(resource.state)` is unchanged — it hands out the state and leases nothing — so naming one
  * Resource both ways registers it twice: the subscription and the lease are independent.
  */
-type SelectedValue<Value> = Value extends Command<infer Input, infer Output> ? CommandHook<Input, Output> : Value extends PaginatedResource<infer Data, infer Key extends ResourceKey, infer Cursor extends ResourceKey, 'consumers' | 'owner'> ? PaginatedResourceHook<Data, Key, Cursor> : Value extends Resource<infer Data, infer Key extends ResourceKey, 'consumers' | 'owner'> ? ResourceHook<Data, Key> : Value;
+type SelectedValue<Value> = Value extends Command<infer Input, infer Output> ? CommandHook<Input, Output> : Value extends PaginatedResource<infer Data, infer Key extends ResourceKey, infer Cursor extends ResourceKey, 'consumers' | 'model'> ? PaginatedResourceHook<Data, Key, Cursor> : Value extends Resource<infer Data, infer Key extends ResourceKey, 'consumers' | 'model'> ? ResourceHook<Data, Key> : Value;
 type ModelSelection<Selected> = {
     readonly [Key in keyof Selected]: SelectedValue<Selected[Key]>;
 };
-/** D205: resolve only a granted model, explicitly read data, and reuse the ordinary per-key command consumers. */
+/** Read a granted model; a selection reads sources through `read` and binds Command or Resource fields. */
 declare function useModel<Declaration extends AnyModel>(declaration: Declaration): ModelOf<Declaration>;
-declare function useModel<Declaration extends AnyModel, const Selected extends object>(declaration: Declaration, select: (model: ModelOf<Declaration>, context: SelectionContext) => Selected & SelectionShape<Selected>): ModelSelection<Selected>;
+declare function useModel<Declaration extends AnyModel, const Selected extends object = RefusedSelection>(declaration: Declaration, select: (model: SelectorModel<ModelOf<Declaration>>, context: SelectionContext) => Selected): ModelSelection<Selected>;
 export { useModel };

package/dist/model-selection-snapshot.d.ts

@@ -2,21 +2,16 @@ import type { Readable, ResourceView } from '@opetope/core';
 import type { ResourceDemand } from '@opetope/core/internal';
 import type { AnyCommand } from './model-binding.js';
 import type { AnyResource } from './resource-command.js';
+type SelectionValue<Candidate> = Candidate extends ResourceView<infer Value> ? Value : Candidate extends Readable<infer Value> ? Value : never;
 interface SelectionRead {
-    <Value>(source: Readable<Value>): Value;
-    <Value, Selected>(source: Readable<Value>, select: (value: Value) => Selected): Selected;
-}
-interface SelectionAcquire {
-    <Value>(view: ResourceView<Value>): Value;
-    <Value, Selected>(view: ResourceView<Value>, select: (value: Value) => Selected): Selected;
+    <Candidate extends Readable<unknown> | ResourceView<unknown>>(source: Candidate): SelectionValue<Candidate>;
+    <Candidate extends Readable<unknown> | ResourceView<unknown>, Selected>(source: Candidate, select: (value: SelectionValue<Candidate>) => Selected): Selected;
 }
+/** The tracked reader passed to a `useModel` selector. Reading a view records demand for commit. */
 type SelectionContext = Readonly<{
-    acquire: SelectionAcquire;
+    /** Read a source for this selection, tracking it so the selection updates when it changes. */
     read: SelectionRead;
 }>;
-type NonSelectionRecord = readonly unknown[] | ((...arguments_: never[]) => unknown) | (abstract new (...arguments_: never[]) => unknown) | Date | PromiseLike<unknown> | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> | RegExp | WeakMap<object, unknown> | WeakSet<object>;
-/** A named interface needs no open index signature; container and callable results are not field selections. */
-type SelectionShape<Selected extends object> = Selected extends NonSelectionRecord ? never : Selected;
 type SelectionRecord = Readonly<Record<PropertyKey, unknown>>;
 /**
  * D359: the Resource a field selected, and what this selection read from it — its state, and the state of its
@@ -65,4 +60,4 @@ declare function createSelectionMemory(): SelectionMemory;
  */
 declare function createSelectionSnapshot<Model>(model: Model, selectRef: SelectionReaderRef<Model>, memory: SelectionMemory): () => SelectionSnapshot;
 export { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot };
-export type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionShape, SelectionSnapshot };
+export type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionSnapshot };

package/dist/readable-hooks.d.ts

@@ -1,10 +1,7 @@
-import type { Readable } from '@opetope/core';
-import type { EqualityOption } from '@opetope/core/internal';
+import type { Readable, Resource, ResourceKey, ResourceView } from '@opetope/core';
+type SourceValue<Source> = Source extends ResourceView<infer Value> ? Value : Source extends Readable<infer Value> ? Value : never;
 /**
- * D279: the source and the selection are positional; `equals` is the one modifier, spelled as in Core — including
- * D348's rule for where the comparator is read, so a named non-generic one compiles here as it does in `derive`.
+ * Subscribe to a Readable or lease a ResourceView for this committed mount.
  */
-export declare function useSelector<Value, Selected>(readable: Readable<Value>, select: (value: NoInfer<Value>) => Selected, options?: {
-    readonly equals?: EqualityOption<NoInfer<Selected>>;
-}): Selected;
-export declare function useReadable<Value>(readable: Readable<Value>): Value;
+export declare function useReadable<Source extends Readable<unknown> | Resource<unknown, ResourceKey, 'consumers' | 'model'> | ResourceView<unknown>>(source: Source extends Readable<unknown> | ResourceView<unknown> ? Source : 'read resource.state, or select the Resource in useModel'): SourceValue<Source>;
+export {};

package/dist/requires-models.d.ts

@@ -2,16 +2,13 @@ import type { FunctionComponent } from 'react';
 import type { ModelIdentity } from '@opetope/core/internal';
 type AnyModel = ModelIdentity;
 /**
- * The marker a component uses to state which UI models of its contribution it reads. `slot` checks by type that the
- * contribution grants every model of this list — it may grant more, because the mount serves its whole instance.
- *
- * The runtime authority is the mount frame, not this marker: `useModel` resolves against what the mount was given
- * and refuses anything else. The lint rule `opetope/require-declared-models` checks visible contribution sites and
- * each reader of a per-mount model within the same module. Imported implementations and dynamic declaration lists
- * remain unknown to this syntactic check (D85, D158, D250).
+ * The marker a component uses to state which UI models of its contribution it reads.
  */
 type ComponentRequiringModels<Props, Models extends readonly AnyModel[]> = FunctionComponent<Props> & {
     readonly requires: Models;
 };
+/**
+ * Declares the UI models a component reads and returns the same component marked with them, so `slot` can check by type that the contribution grants each one.
+ */
 declare function requiresModels<const Models extends readonly AnyModel[]>(models: Models): <Props>(component: FunctionComponent<Props>) => ComponentRequiringModels<Props, Models>;
 export { requiresModels };