@opetope/react 0.10.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/CHANGELOG.md +121 -0
  2. package/README.md +10 -6
  3. package/README.ru.md +10 -6
  4. package/dist/contribution-frame-DkNmjChZ.js.map +1 -1
  5. package/dist/index.js +1 -1
  6. package/dist/index.js.map +1 -1
  7. package/dist/model-selection-snapshot.d.ts +20 -3
  8. package/dist/testing.d.ts +1 -1
  9. package/dist/testing.js +2 -2
  10. package/dist/testing.js.map +1 -1
  11. package/package.json +5 -5
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":["../src/command-hook-controller.ts","../src/command-hook.ts","../src/idle-subscription.ts","../src/commands-hook.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 { CallError } from '@opetope/core';\nimport { compatibleAbortReason, isCancellation, reportDetachedError } from '@opetope/core/internal';\nimport type { CallInputArgs, 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: [...CallInputArgs<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, status: '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, status: '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 call, and the policy the call was\n * created with — `queue`, `latest`, `parallel`, `once`, `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 status: '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 CallError('cancelled', 'Command input was cancelled.', compatibleAbortReason(signal)),\n status: '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, { status: '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 { Call } 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 status: '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.status === '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: Call<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 { Call } 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, Call<never, unknown>>>;\ntype ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;\ntype HookOf<Command> = Command extends Call<infer Input, infer Output> ? CommandHook<Input, Output> : never;\ntype CommandsHook<Commands> = {\n readonly [Key in keyof Commands]: HookOf<Commands[Key]>;\n};\n/** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */\ntype SelectedResourceHook = Readonly<{\n invalidate: CommandHook<never, unknown>;\n pagination: Readonly<{ loadNext: CommandHook<never, unknown>; state: unknown }> | undefined;\n refresh: 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({});\nconst noResources: ResourceSelection = new Map();\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 invalidate: CommandEntry;\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 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.status === '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 invalidate: entry.invalidate.hook,\n pagination: entry.paginated ? { loadNext: entry.loadNext.hook, state: selected.pagination } : undefined,\n refresh: entry.refresh.hook,\n retry: entry.retry.hook,\n state: selected.state,\n };\n}\n\nfunction createResourceEntry(invokers: ResourceInvokers, selected: SelectedResource): ResourceEntry {\n const parts = {\n invalidate: createEntry(invokers.invalidate),\n kind: 'resource' as const,\n loadNext: createEntry(invokers.loadNext),\n paginated: selected.pagination !== undefined,\n refresh: createEntry(invokers.refresh),\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.retry === entry.retry.hook &&\n hook.invalidate === entry.invalidate.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.retry, entry.invalidate, 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.invalidate);\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, Call<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.invalidate.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\nfunction useCommands<Commands extends { readonly [Key in keyof Commands]: Call<never, unknown> }>(\n commands: Commands,\n): CommandsHook<Commands> {\n return useSelectionHooks(commands, noResources) as CommandsHook<Commands>;\n}\n\nexport { useCommands, useSelectionHooks };\nexport type { SelectionHooks };\n","import type { Readable } from '@opetope/core';\nimport { isCallTarget, isReadable } 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\ntype SelectionContext = Readonly<{ 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<AnyResource>;\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 * G13: a render may race the retirement of the owner, and a retired materialization closes its state by the general\n * Readable contract. A selection answers the closed record rather than throwing, so the tree unmounts instead of\n * failing in the middle of a render.\n */\nconst closedSelection = Symbol('opetope.selection-closed-state');\n\n/** The fast path re-reads what it observed, and a source the owner closed answers the same closed record. */\nfunction readCurrent(source: Readable<unknown>): unknown {\n try {\n return source.getSnapshot();\n } catch {\n return closedSelection;\n }\n}\nconst noLeases: ReadonlySet<AnyResource> = 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 const value = source.getSnapshot();\n sources.set(source, value);\n\n return 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 let value: unknown;\n\n try {\n value = source.getSnapshot();\n } catch {\n value = closedSelection;\n }\n\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 = (resource as { readonly pagination?: { readonly state: Readable<unknown> } }).pagination;\n\n resources.set(key, {\n pagination: capability === undefined ? undefined : readPassively(capability.state, sources),\n resource,\n state: readPassively(resource.state, 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 resources: ReadonlyMap<PropertyKey, SelectedResource>;\n values: SelectionRecord;\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 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 selected = select({ 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 return { 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 equalSelection(\n previous: SelectionSnapshot,\n values: SelectionRecord,\n sources: ReadonlySet<Readable<unknown>>,\n resources: ReadonlyMap<PropertyKey, SelectedResource>,\n) {\n const keys = Reflect.ownKeys(values);\n const previousKeys = Reflect.ownKeys(previous.values);\n\n if (keys.length !== previousKeys.length || sources.size !== previous.sources.size) return false;\n\n for (const source of sources) if (!previous.sources.has(source)) 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\nfunction selectionLeases(resources: ReadonlyMap<PropertyKey, SelectedResource>): ReadonlySet<AnyResource> {\n if (resources.size === 0) return noLeases;\n\n const leased = new Set<AnyResource>();\n\n for (const selected of resources.values()) leased.add(selected.resource);\n\n return leased;\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 */\nfunction createSelectionSnapshot<Model>(model: Model, selectRef: SelectionReaderRef<Model>): () => SelectionSnapshot {\n let observed: Map<Readable<unknown>, unknown> | undefined;\n let observedSelect: ModelSelector<Model> | undefined;\n let snapshot: SelectionSnapshot = emptySelectionSnapshot;\n\n return () => {\n const select = selectRef.current;\n\n if (select === undefined) return emptySelectionSnapshot;\n\n if (\n observed !== undefined &&\n observedSelect === select &&\n [...observed].every(([source, value]) => Object.is(readCurrent(source), value))\n ) {\n return snapshot;\n }\n\n const nextObserved = new Map<Readable<unknown>, unknown>();\n const { resources, values } = collectSelection(context => select(model, context), nextObserved);\n const sources = new Set(nextObserved.keys());\n\n if (observed === undefined || !equalSelection(snapshot, values, sources, resources)) {\n snapshot = {\n commands: selectionCommands(values),\n leases: selectionLeases(resources),\n resources,\n sources,\n values,\n };\n }\n\n observed = nextObserved;\n observedSelect = select;\n\n return snapshot;\n };\n}\n\nexport { createSelectionSnapshot, emptySelectionSnapshot };\nexport type { ModelSelector, SelectedResource, SelectionContext, SelectionShape, SelectionSnapshot };\n","import type { Readable } from '@opetope/core';\nimport { createAggregateError } from '@opetope/core/internal';\n\nimport type { AnyResource } from './resource-command';\n\ntype Subscription = { dispose: (() => void) | undefined };\ntype Listener = Readonly<{ notify: () => void }>;\n\nconst noLeases: ReadonlySet<AnyResource> = 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<AnyResource, Subscription>();\n private readonly listeners = new Set<Listener>();\n private retained: ReadonlySet<AnyResource> = 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<AnyResource> = 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: AnyResource): 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 { Call, ModelOf, PaginatedResource, Resource } from '@opetope/core';\n\nimport type { CommandHook } from './command-hook';\nimport { useSelectionHooks } from './commands-hook';\nimport type { SelectionHooks } from './commands-hook';\nimport { ContributionError } from './errors';\nimport { subscribeIdle } from './idle-subscription';\nimport type { AnyModel } from './model-binding';\nimport { createSelectionSnapshot, emptySelectionSnapshot } from './model-selection-snapshot';\nimport type { ModelSelector, SelectionContext, SelectionShape, SelectionSnapshot } 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 Call<infer Input, infer Output>\n ? CommandHook<Input, Output>\n : Value extends PaginatedResource<infer Data, infer Key extends ResourceKey, infer Cursor extends ResourceKey>\n ? PaginatedResourceHook<Data, Key, Cursor>\n : Value extends Resource<infer Data, infer Key extends ResourceKey>\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 const getSnapshot = useMemo(\n () => (selected ? createSelectionSnapshot(model, selectRef) : readEmptySnapshot),\n [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';\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 invalidate: CommandHookController<void, unknown>;\n loadNext: CommandHookController<void, unknown>;\n refresh: 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 invalidate: new CommandHookController<void, unknown>(invokers.invalidate),\n loadNext: new CommandHookController<void, unknown>(invokers.loadNext),\n refresh: new CommandHookController<void, unknown>(invokers.refresh),\n retry: new CommandHookController<void, unknown>(invokers.retry),\n };\n cache.set(resource, slots);\n\n return slots;\n}\n\n/**\n * G13: a render may race the retirement of the model that owns the Resource, and a retired Resource closes its state\n * by the general Readable contract. Reading it then throws, so this render answers the last state it saw — which is\n * what `useReadable` does for a closed source — and the unmount that follows releases the lease.\n */\nfunction lastGoodSnapshot<Value>(source: Readable<Value>, fallback: Value): () => Value {\n let last = fallback;\n\n return (): Value => {\n try {\n last = source.getSnapshot();\n } catch {\n // The owner closed this source; the previous value is the honest answer until this tree unmounts.\n }\n\n return last;\n };\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>,\n): PaginatedResourceHook<Data, Key, Cursor>;\nfunction useResource<Data, Key extends ResourceKey>(resource: Resource<Data, Key>): ResourceHook<Data, Key>;\nfunction useResource<Data, Key extends ResourceKey>(resource: Resource<Data, Key>): ResourceHook<Data, Key> {\n const handle = resource as unknown as AnyResource;\n const capability = paginationOf(handle);\n const subscribe = useCallback((listener: () => void) => resource.state.subscribe(listener), [resource]);\n const getState = useMemo(() => lastGoodSnapshot(resource.state, { kind: 'idle', reason: 'unleased' }), [resource]);\n const state = useSyncExternalStore(subscribe, getState, getState);\n const paginationSource: Readable<PaginationState<ResourceKey>> =\n (capability?.state as Readable<PaginationState<ResourceKey>> | undefined) ?? noPaginationSource;\n const subscribePagination = useCallback(\n (listener: () => void) => paginationSource.subscribe(listener),\n [paginationSource],\n );\n const getPaginationState = useMemo(\n () => lastGoodSnapshot(paginationSource, unavailablePagination),\n [paginationSource],\n );\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(() => resource.acquire(), [resource]);\n\n const slots = useResourceSlots(handle);\n const refresh = useCommandStatus(slots.refresh);\n const retry = useCommandStatus(slots.retry);\n const invalidate = useCommandStatus(slots.invalidate);\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 () => ({ invalidate, pagination, refresh, retry, state }) as ResourceHook<Data, Key>,\n [invalidate, pagination, refresh, 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","CallError","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","noResources","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","useCommands","closedSelection","readCurrent","source","noLeases","readSource","sources","isReadable","readPassively","classifyResource","isResource","capability","selectedResources","collectSelection","select","project","entries","equalResources","before","equalSelection","values","keys","previousKeys","index","emptySelectionSnapshot","selectionCommands","isCallTarget","selectionLeases","leased","createSelectionSnapshot","model","selectRef","observed","observedSelect","snapshot","nextObserved","context","releaseSubscriptions","subscriptions","failures","subscription","dispose","createAggregateError","ModelSelectionStore","retained","held","removed","lease","release","readEmptySnapshot","useSelectionStore","storeRef","mergeSelection","hooks","useModel","declaration","store","requiresModels","models","declared","component","useResourceSlots","cache","existing","createResourceInvokers","lastGoodSnapshot","fallback","last","unavailablePagination","noPaginationSource","useResource","handle","paginationOf","subscribe","useCallback","getState","state","paginationSource","subscribePagination","getPaginationState","paginationState","useEffect","refresh","retry","invalidate","loadNext","pagination","emptySlotProperties","defineSlot","id","createContributionTarget","defineSwitchSlot","declarationId","targets","switchSlot","route","target","Slot","useReadable","slotProps","createElement","Fragment","ContributionMount","contributionAuthority"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sources":["../src/command-hook-controller.ts","../src/command-hook.ts","../src/idle-subscription.ts","../src/commands-hook.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 { CallError } from '@opetope/core';\nimport { compatibleAbortReason, isCancellation, reportDetachedError } from '@opetope/core/internal';\nimport type { CallInputArgs, 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: [...CallInputArgs<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, status: '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, status: '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 call, and the policy the call was\n * created with — `queue`, `latest`, `parallel`, `once`, `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 status: '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 CallError('cancelled', 'Command input was cancelled.', compatibleAbortReason(signal)),\n status: '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, { status: '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 { Call } 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 status: '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.status === '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: Call<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 { Call } 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, Call<never, unknown>>>;\ntype ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;\ntype HookOf<Command> = Command extends Call<infer Input, infer Output> ? CommandHook<Input, Output> : never;\ntype CommandsHook<Commands> = {\n readonly [Key in keyof Commands]: HookOf<Commands[Key]>;\n};\n/** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */\ntype SelectedResourceHook = Readonly<{\n invalidate: CommandHook<never, unknown>;\n pagination: Readonly<{ loadNext: CommandHook<never, unknown>; state: unknown }> | undefined;\n refresh: 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({});\nconst noResources: ResourceSelection = new Map();\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 invalidate: CommandEntry;\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 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.status === '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 invalidate: entry.invalidate.hook,\n pagination: entry.paginated ? { loadNext: entry.loadNext.hook, state: selected.pagination } : undefined,\n refresh: entry.refresh.hook,\n retry: entry.retry.hook,\n state: selected.state,\n };\n}\n\nfunction createResourceEntry(invokers: ResourceInvokers, selected: SelectedResource): ResourceEntry {\n const parts = {\n invalidate: createEntry(invokers.invalidate),\n kind: 'resource' as const,\n loadNext: createEntry(invokers.loadNext),\n paginated: selected.pagination !== undefined,\n refresh: createEntry(invokers.refresh),\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.retry === entry.retry.hook &&\n hook.invalidate === entry.invalidate.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.retry, entry.invalidate, 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.invalidate);\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, Call<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.invalidate.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\nfunction useCommands<Commands extends { readonly [Key in keyof Commands]: Call<never, unknown> }>(\n commands: Commands,\n): CommandsHook<Commands> {\n return useSelectionHooks(commands, noResources) as CommandsHook<Commands>;\n}\n\nexport { useCommands, useSelectionHooks };\nexport type { SelectionHooks };\n","import type { Readable } from '@opetope/core';\nimport { isCallTarget, isReadable } 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\ntype SelectionContext = Readonly<{ 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<AnyResource>;\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<AnyResource> = 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 = (resource as { readonly pagination?: { readonly state: Readable<unknown> } }).pagination;\n\n resources.set(key, {\n pagination: capability === undefined ? undefined : readPassively(capability.state, sources),\n resource,\n state: readPassively(resource.state, 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 resources: ReadonlyMap<PropertyKey, SelectedResource>;\n values: SelectionRecord;\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 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 selected = select({ 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 return { 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 equalSelection(\n previous: SelectionSnapshot,\n values: SelectionRecord,\n sources: ReadonlySet<Readable<unknown>>,\n resources: ReadonlyMap<PropertyKey, SelectedResource>,\n) {\n const keys = Reflect.ownKeys(values);\n const previousKeys = Reflect.ownKeys(previous.values);\n\n if (keys.length !== previousKeys.length || sources.size !== previous.sources.size) return false;\n\n for (const source of sources) if (!previous.sources.has(source)) 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\nfunction selectionLeases(resources: ReadonlyMap<PropertyKey, SelectedResource>): ReadonlySet<AnyResource> {\n if (resources.size === 0) return noLeases;\n\n const leased = new Set<AnyResource>();\n\n for (const selected of resources.values()) leased.add(selected.resource);\n\n return leased;\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 { 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)) {\n memory.snapshot = {\n commands: selectionCommands(values),\n leases: selectionLeases(resources),\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 { AnyResource } from './resource-command';\n\ntype Subscription = { dispose: (() => void) | undefined };\ntype Listener = Readonly<{ notify: () => void }>;\n\nconst noLeases: ReadonlySet<AnyResource> = 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<AnyResource, Subscription>();\n private readonly listeners = new Set<Listener>();\n private retained: ReadonlySet<AnyResource> = 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<AnyResource> = 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: AnyResource): 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 { Call, ModelOf, PaginatedResource, Resource } from '@opetope/core';\n\nimport type { CommandHook } from './command-hook';\nimport { useSelectionHooks } from './commands-hook';\nimport type { SelectionHooks } from './commands-hook';\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 Call<infer Input, infer Output>\n ? CommandHook<Input, Output>\n : Value extends PaginatedResource<infer Data, infer Key extends ResourceKey, infer Cursor extends ResourceKey>\n ? PaginatedResourceHook<Data, Key, Cursor>\n : Value extends Resource<infer Data, infer Key extends ResourceKey>\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';\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 invalidate: CommandHookController<void, unknown>;\n loadNext: CommandHookController<void, unknown>;\n refresh: 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 invalidate: new CommandHookController<void, unknown>(invokers.invalidate),\n loadNext: new CommandHookController<void, unknown>(invokers.loadNext),\n refresh: new CommandHookController<void, unknown>(invokers.refresh),\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>,\n): PaginatedResourceHook<Data, Key, Cursor>;\nfunction useResource<Data, Key extends ResourceKey>(resource: Resource<Data, Key>): ResourceHook<Data, Key>;\nfunction useResource<Data, Key extends ResourceKey>(resource: Resource<Data, Key>): ResourceHook<Data, Key> {\n const handle = resource as unknown as AnyResource;\n const capability = paginationOf(handle);\n const subscribe = useCallback((listener: () => void) => resource.state.subscribe(listener), [resource]);\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(() => () => resource.state.getSnapshot(), [resource]);\n const state = useSyncExternalStore(subscribe, getState, getState);\n const paginationSource: Readable<PaginationState<ResourceKey>> =\n (capability?.state as Readable<PaginationState<ResourceKey>> | undefined) ?? noPaginationSource;\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(() => resource.acquire(), [resource]);\n\n const slots = useResourceSlots(handle);\n const refresh = useCommandStatus(slots.refresh);\n const retry = useCommandStatus(slots.retry);\n const invalidate = useCommandStatus(slots.invalidate);\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 () => ({ invalidate, pagination, refresh, retry, state }) as ResourceHook<Data, Key>,\n [invalidate, pagination, refresh, 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","CallError","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","noResources","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","useCommands","noLeases","readSource","source","sources","isReadable","readPassively","classifyResource","isResource","capability","selectedResources","collectSelection","select","project","entries","equalResources","before","equalSelection","values","keys","previousKeys","index","emptySelectionSnapshot","selectionCommands","isCallTarget","selectionLeases","leased","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","refresh","retry","invalidate","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/model-selection-snapshot.d.ts CHANGED
@@ -29,17 +29,34 @@ type SelectionSnapshot = Readonly<{
29
29
  sources: ReadonlySet<Readable<unknown>>;
30
30
  values: SelectionRecord;
31
31
  }>;
32
+ /**
33
+ * D363: what this mount read last and the snapshot it answered with. It belongs to the mount and not to the reader:
34
+ * React may discard the `useMemo` that builds the reader, and a memory kept there would be empty exactly when it is
35
+ * needed. D364: it no longer remembers which sources ended — a source whose owner retired stops instead of refusing,
36
+ * so it answers its last value on every read and there is nothing to remember or to step around.
37
+ */
38
+ type SelectionMemory = {
39
+ model: unknown;
40
+ observed: Map<Readable<unknown>, unknown> | undefined;
41
+ select: unknown;
42
+ snapshot: SelectionSnapshot;
43
+ };
32
44
  type ModelSelector<Model> = (model: Model, context: SelectionContext) => object;
33
45
  type SelectionReaderRef<Model> = {
34
46
  readonly current: ModelSelector<Model> | undefined;
35
47
  };
36
48
  declare const emptySelectionSnapshot: SelectionSnapshot;
49
+ /** D363: the memory of one mount, empty until its first read and reset when the reader is built for another model. */
50
+ declare function createSelectionMemory(): SelectionMemory;
37
51
  /**
38
52
  * D214: one reader per model, not per render. The author's selector arrives through a ref, so an inline arrow does not
39
53
  * rebuild the reader; the fast path — nothing observed has moved — belongs to the selector that computed the snapshot,
40
54
  * so a new selector is always called again, its result compared field by field, and an equal selection keeps the
41
55
  * previous snapshot. A rejected or abandoned render still changes nothing: only a committed selection subscribes.
56
+ *
57
+ * D363: what the reader remembers lives in the mount's memory, so a reader React rebuilt — because it discarded the
58
+ * memo — still knows what this selection read last.
42
59
  */
43
- declare function createSelectionSnapshot<Model>(model: Model, selectRef: SelectionReaderRef<Model>): () => SelectionSnapshot;
44
- export { createSelectionSnapshot, emptySelectionSnapshot };
45
- export type { ModelSelector, SelectedResource, SelectionContext, SelectionShape, SelectionSnapshot };
60
+ declare function createSelectionSnapshot<Model>(model: Model, selectRef: SelectionReaderRef<Model>, memory: SelectionMemory): () => SelectionSnapshot;
61
+ export { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot };
62
+ export type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionShape, SelectionSnapshot };
package/dist/testing.d.ts CHANGED
@@ -3,7 +3,7 @@
3
3
  * contribution binding a mount reads, so the React name keeps meaning the stronger thing it has always meant. The
4
4
  * core fixture is the same Call without that binding, and a test that wants it names `@opetope/core/testing` (D300).
5
5
  */
6
- export { CallTimeoutError, eventually, openModel, runCall, settled, testReadable, waitFor, WaitTimeoutError, yieldTurn, } from '@opetope/runtime/testing';
6
+ export { CallTimeoutError, eventually, openModel, runCall, settled, testReadable, testResourceEpoch, waitFor, WaitTimeoutError, yieldTurn, } from '@opetope/runtime/testing';
7
7
  export type { CallInputArgs, EventuallyOptions, ModelInstance, OpenModelOptions, RunCallOptions, SettleTarget, WaitOptions, } from '@opetope/runtime/testing';
8
8
  export { createScenario } from './scenario.js';
9
9
  export { ScenarioTimeoutError } from './scenario-diagnostics.js';
package/dist/testing.js CHANGED
@@ -1,4 +1,4 @@
1
- import{CallTimeoutError as ye,WaitTimeoutError as Se,eventually as ge,openModel as ve,runCall as $e,settled as ke,testReadable as Me,waitFor as Ce,yieldTurn as je}from"@opetope/runtime/testing";import{hasOwn as F,createAggregateError as x}from"@opetope/core/internal";import{openApplication as _}from"@opetope/runtime";import{createInspectionSession as N}from"@opetope/runtime/internal";import{createElement as B}from"react";import{declarationId as H}from"@opetope/core";import{command as W}from"@opetope/core/testing";import{e as q,a as P,b as D,M as L}from"./contribution-frame-DkNmjChZ.js";function U(e){if(e.state.kind==="ready")return[];const t=e.state.kind==="waiting"?` (${e.state.reason})`:"";return[`Feature ${e.label}: ${e.state.kind}${t}.`]}function G(e){if(e.lane===null)return`Call ${e.declaration}: ${e.state}; lane parallel; blockers none (parallel).`;const t=e.lane.blockedBy==="unknown"?"unknown":e.lane.blockedBy.join(", ");return`Call ${e.declaration}: ${e.state}; lane ${e.lane.declaration}; blockers ${t}.`}function J(e){if(e===void 0)return["Runtime activity: unknown."];const t=[];return(e.freshness==="stale"||e.truncated)&&t.push(`Activity: ${e.freshness}${e.truncated?", truncated":""}; completeness unknown.`),[...t,...e.features.map(n=>`Feature ${n.feature}: ${n.phase}; body ${n.body}; host demand unknown.`),...e.calls.map(G),...e.resources.map(n=>`Resource ${n.id}: ${n.state}; leases ${String(n.leases)}.`)]}function K(e){const t=[...e.runtime.conditions.flatMap(n=>n.state.kind==="true"?[]:[`Condition ${n.label}: ${n.state.kind}.`]),...e.runtime.instances.flatMap(U),...J(e.activity)];return t.length===0?"No registered runtime blocker observed; external UI and host work are unknown.":t.join(`
1
+ import{CallTimeoutError as ye,WaitTimeoutError as Se,eventually as ge,openModel as ve,runCall as $e,settled as ke,testReadable as Me,testResourceEpoch as Ce,waitFor as je,yieldTurn as Ee}from"@opetope/runtime/testing";import{hasOwn as F,createAggregateError as x}from"@opetope/core/internal";import{openApplication as _}from"@opetope/runtime";import{createInspectionSession as N}from"@opetope/runtime/internal";import{createElement as B}from"react";import{declarationId as H}from"@opetope/core";import{command as W}from"@opetope/core/testing";import{e as q,a as P,b as D,M as L}from"./contribution-frame-DkNmjChZ.js";function U(e){if(e.state.kind==="ready")return[];const t=e.state.kind==="waiting"?` (${e.state.reason})`:"";return[`Feature ${e.label}: ${e.state.kind}${t}.`]}function G(e){if(e.lane===null)return`Call ${e.declaration}: ${e.state}; lane parallel; blockers none (parallel).`;const t=e.lane.blockedBy==="unknown"?"unknown":e.lane.blockedBy.join(", ");return`Call ${e.declaration}: ${e.state}; lane ${e.lane.declaration}; blockers ${t}.`}function J(e){if(e===void 0)return["Runtime activity: unknown."];const t=[];return(e.freshness==="stale"||e.truncated)&&t.push(`Activity: ${e.freshness}${e.truncated?", truncated":""}; completeness unknown.`),[...t,...e.features.map(n=>`Feature ${n.feature}: ${n.phase}; body ${n.body}; host demand unknown.`),...e.calls.map(G),...e.resources.map(n=>`Resource ${n.id}: ${n.state}; leases ${String(n.leases)}.`)]}function K(e){const t=[...e.runtime.conditions.flatMap(n=>n.state.kind==="true"?[]:[`Condition ${n.label}: ${n.state.kind}.`]),...e.runtime.instances.flatMap(U),...J(e.activity)];return t.length===0?"No registered runtime blocker observed; external UI and host work are unknown.":t.join(`
2
2
  `)}class T extends Error{label;timeoutMs;snapshot;history;code="timeout";constructor(t,n,r,o){super(`Scenario timed out after ${String(n)}ms: ${t}.
3
- ${K(r)}`),this.label=t,this.timeoutMs=n,this.snapshot=r,this.history=o,this.name="ScenarioTimeoutError"}}function Q(e,t){return!t||e===void 0?!1:e.closed&&!e.truncated}function V(e,t,n){if(e===void 0)return["Runtime activity is unavailable."];const r=[];return e.truncated&&r.push("The activity snapshot is truncated."),e.freshness==="stale"&&!t&&r.push("The activity snapshot is stale."),n||r.push("Successful application and mount cleanup has not been observed."),Object.freeze(r)}function X(e,t){return e===void 0||e.truncated||e.freshness==="stale"&&!t?{calls:"unknown",features:"unknown",resources:"unknown"}:{calls:e.calls.length,features:e.features.length,resources:e.resources.length}}function Y(e,t){const n=e.activity,r=Q(n,t);return Object.freeze({...X(n,r),closed:t,reasons:V(n,r,t),scope:"registered-runtime",status:r?"complete":"unknown"})}class Z{released;get closed(){return this.completion!==void 0}available=!1;completion;handle;reject;resolve;constructor(t){this.released=t}close=()=>this.completion!==void 0?this.completion:(this.completion=new Promise((t,n)=>{this.resolve=t,this.reject=n}),this.available&&this.releaseAvailable(),this.completion);provide(t){this.available=!0,this.handle=t,this.closed&&this.releaseAvailable()}finish(t,n){const r=this.resolve,o=this.reject;this.resolve=void 0,this.reject=void 0,this.released(t,n),t?o==null||o(n):r==null||r()}releaseAvailable(){const t=this.handle;this.handle=void 0,this.available=!1;try{Promise.resolve(t==null?void 0:t.unmount()).then(()=>this.finish(!1),n=>this.finish(!0,n))}catch(n){this.finish(!0,n)}}}const ee=H("testing.contribution");function te(e){return q(W(e))}function O(e,t={}){const n=t.models??[];let r=t.props??{};const o=new Set,w={getSnapshot:()=>r,subscribe:i=>(o.add(i),()=>o.delete(i))},c=t.contribution,s=t.reporter,l=s===void 0?void 0:{models:[],reporter:s};return Object.freeze({close:()=>{r={},o.clear()},Slot:()=>{const i=P(e.entries),d=P(w);return(c===void 0?i.map(p=>[p.id,p.value,D(p)??l]):[[ee,c,l]]).map(([p,f,k])=>B(L,{authority:k,contribution:f,contributionId:p,fixtures:n,key:p,slotProps:d,targetId:e.id}))},updateProps:i=>{r=i;for(const d of[...o])d()}})}function ne(e,t={}){const n=O(e,t);return Object.freeze({Slot:n.Slot,updateProps:n.updateProps})}function C(e,t){if(!Number.isFinite(e)||e<=0||e>2147483647)throw new RangeError(`${t} must be a finite duration from 0 (exclusive) to 2147483647ms.`);return e}class re{source;listeners=new Set;pending=new Set;constructor(t){this.source=t}cancel(){for(const t of[...this.pending])t(new Error("Scenario is closing."))}deadline(t,n,r=this.source.timeoutMs){return C(r,"Scenario timeoutMs"),new Promise((o,w)=>{const c=setTimeout(()=>w(this.timeout(n,r)),r);Promise.resolve(t).then(s=>{clearTimeout(c),o(s)},s=>{clearTimeout(c),w(s)})})}notify=()=>{for(const t of[...this.listeners])t()};waitFor(t,n){const r=C(n.timeoutMs??this.source.timeoutMs,"Scenario timeoutMs"),o=C(n.pollIntervalMs??10,"Scenario pollIntervalMs");return new Promise((w,c)=>{let s=!1,l=()=>{};const y=(f,k=f!==void 0)=>{s||(s=!0,l(),k?c(f):w())},i=()=>{if(!s)try{t(this.source.getSnapshot())&&y()}catch(f){y(f,!0)}},d=f=>y(f),v=setTimeout(()=>y(this.timeout(n.label??"waitFor",r)),r),p=setInterval(i,o);l=()=>{clearTimeout(v),clearInterval(p),this.listeners.delete(i),this.pending.delete(d)},this.listeners.add(i),this.pending.add(d),i()})}timeout(t,n){return new T(t,n,this.source.getSnapshot(),this.source.history())}}function I(e,t){if(!Number.isSafeInteger(e)||e<1||e>1e4)throw new RangeError(`${t} must be an integer from 1 to 10000.`);return e}function oe(e){if(e===null||typeof e!="object"||!("mount"in e)||typeof e.mount!="function")throw new TypeError("Scenario requires a host.mount(Component) adapter.")}function se(e){return{...e.cleanupFailure===void 0?{}:{cleanupFailure:e.cleanupFailure},...F(e,"conditions")?{conditions:e.conditions}:{},...F(e,"imports")?{imports:e.imports}:{},reporter:e.reporter}}function ie(e,t){const n=C(t.timeoutMs??1e3,"Scenario timeoutMs"),r=I(t.historyCapacity??64,"Scenario historyCapacity"),o=I(t.activityCapacity??256,"Scenario activityCapacity");let w=t.host;oe(w);let c=_(e,se(t)),s;try{s=N(c,{activityCapacity:o,ringCapacity:r})}catch(u){throw c.ready.catch(()=>{}),c.close().catch(()=>{}),u}let l="open",y=!1,i=!1;const d=[],v=new Set,p=[],f=()=>s.getSnapshot(),k=()=>Object.freeze([...d]),$=new re({getSnapshot:f,history:k,timeoutMs:n}),j=()=>{if(!i){i=!0;try{const u=f(),m=d[d.length-1];((m==null?void 0:m.stateRevision)!==u.stateRevision||m.activity!==u.activity)&&(d.push(u),d.length>r&&d.shift())}finally{i=!1}$.notify()}},R=s.subscribe(j);j();const E=$.deadline(c.ready,"application ready");E.catch(()=>{});let M,S;const A=()=>{if(M!==void 0)return M;let u,m;M=new Promise((a,h)=>{u=a,m=h}),l="closing",$.cancel();const g=[];try{g.push(c.close())}catch(a){g.push(Promise.reject(a))}return g.push(...[...v].map(a=>a.close())),Promise.allSettled(g).then(a=>{const h=[...new Set([...p,...a.flatMap(b=>b.status==="rejected"?[b.reason]:[])])];p.length=0,l="closed";try{j()}catch(b){h.push(b)}finally{R(),s.close(),v.clear(),c=void 0,w=void 0}y=h.length===0,h.length===0?u():m(x(h,"Scenario cleanup failed."))}),M};return Object.freeze({close:()=>{if(S!==void 0)return S;const u=A();return S!==void 0||(S=$.deadline(u,"scenario close"),S.catch(()=>{l==="closing"&&(S=void 0)})),S},getSnapshot:f,history:k,mount:(u,m={})=>{if(l!=="open")throw new Error("Scenario is closing.");const g=O(u,m),a=new Z((b,z)=>{v.delete(a),g.close(),b&&p.push(z)});v.add(a);let h;try{if(h=w.mount(g.Slot),h===null||typeof h!="object"||typeof h.unmount!="function")throw new TypeError("Scenario host.mount must return an unmount() handle.");a.provide(h)}catch(b){throw a.provide(void 0),a.close().catch(()=>{}),b}return Object.freeze({host:h,unmount:a.close,updateProps:b=>{if(l!=="open"||a.closed)throw new Error("Scenario mount is closed.");g.updateProps(b),$.notify()}})},notify:()=>{l==="open"&&$.notify()},ownership:()=>Y(f(),y),ready:E,waitFor:(u,m={})=>l!=="open"?Promise.reject(new Error("Scenario is closing.")):$.waitFor(u,m)})}export{ye as CallTimeoutError,T as ScenarioTimeoutError,Se as WaitTimeoutError,te as command,ie as createScenario,ge as eventually,ve as openModel,ne as renderSlot,$e as runCall,ke as settled,Me as testReadable,Ce as waitFor,je as yieldTurn};
3
+ ${K(r)}`),this.label=t,this.timeoutMs=n,this.snapshot=r,this.history=o,this.name="ScenarioTimeoutError"}}function Q(e,t){return!t||e===void 0?!1:e.closed&&!e.truncated}function V(e,t,n){if(e===void 0)return["Runtime activity is unavailable."];const r=[];return e.truncated&&r.push("The activity snapshot is truncated."),e.freshness==="stale"&&!t&&r.push("The activity snapshot is stale."),n||r.push("Successful application and mount cleanup has not been observed."),Object.freeze(r)}function X(e,t){return e===void 0||e.truncated||e.freshness==="stale"&&!t?{calls:"unknown",features:"unknown",resources:"unknown"}:{calls:e.calls.length,features:e.features.length,resources:e.resources.length}}function Y(e,t){const n=e.activity,r=Q(n,t);return Object.freeze({...X(n,r),closed:t,reasons:V(n,r,t),scope:"registered-runtime",status:r?"complete":"unknown"})}class Z{released;get closed(){return this.completion!==void 0}available=!1;completion;handle;reject;resolve;constructor(t){this.released=t}close=()=>this.completion!==void 0?this.completion:(this.completion=new Promise((t,n)=>{this.resolve=t,this.reject=n}),this.available&&this.releaseAvailable(),this.completion);provide(t){this.available=!0,this.handle=t,this.closed&&this.releaseAvailable()}finish(t,n){const r=this.resolve,o=this.reject;this.resolve=void 0,this.reject=void 0,this.released(t,n),t?o==null||o(n):r==null||r()}releaseAvailable(){const t=this.handle;this.handle=void 0,this.available=!1;try{Promise.resolve(t==null?void 0:t.unmount()).then(()=>this.finish(!1),n=>this.finish(!0,n))}catch(n){this.finish(!0,n)}}}const ee=H("testing.contribution");function te(e){return q(W(e))}function O(e,t={}){const n=t.models??[];let r=t.props??{};const o=new Set,w={getSnapshot:()=>r,subscribe:i=>(o.add(i),()=>o.delete(i))},c=t.contribution,s=t.reporter,l=s===void 0?void 0:{models:[],reporter:s};return Object.freeze({close:()=>{r={},o.clear()},Slot:()=>{const i=P(e.entries),d=P(w);return(c===void 0?i.map(p=>[p.id,p.value,D(p)??l]):[[ee,c,l]]).map(([p,f,k])=>B(L,{authority:k,contribution:f,contributionId:p,fixtures:n,key:p,slotProps:d,targetId:e.id}))},updateProps:i=>{r=i;for(const d of[...o])d()}})}function ne(e,t={}){const n=O(e,t);return Object.freeze({Slot:n.Slot,updateProps:n.updateProps})}function C(e,t){if(!Number.isFinite(e)||e<=0||e>2147483647)throw new RangeError(`${t} must be a finite duration from 0 (exclusive) to 2147483647ms.`);return e}class re{source;listeners=new Set;pending=new Set;constructor(t){this.source=t}cancel(){for(const t of[...this.pending])t(new Error("Scenario is closing."))}deadline(t,n,r=this.source.timeoutMs){return C(r,"Scenario timeoutMs"),new Promise((o,w)=>{const c=setTimeout(()=>w(this.timeout(n,r)),r);Promise.resolve(t).then(s=>{clearTimeout(c),o(s)},s=>{clearTimeout(c),w(s)})})}notify=()=>{for(const t of[...this.listeners])t()};waitFor(t,n){const r=C(n.timeoutMs??this.source.timeoutMs,"Scenario timeoutMs"),o=C(n.pollIntervalMs??10,"Scenario pollIntervalMs");return new Promise((w,c)=>{let s=!1,l=()=>{};const y=(f,k=f!==void 0)=>{s||(s=!0,l(),k?c(f):w())},i=()=>{if(!s)try{t(this.source.getSnapshot())&&y()}catch(f){y(f,!0)}},d=f=>y(f),v=setTimeout(()=>y(this.timeout(n.label??"waitFor",r)),r),p=setInterval(i,o);l=()=>{clearTimeout(v),clearInterval(p),this.listeners.delete(i),this.pending.delete(d)},this.listeners.add(i),this.pending.add(d),i()})}timeout(t,n){return new T(t,n,this.source.getSnapshot(),this.source.history())}}function R(e,t){if(!Number.isSafeInteger(e)||e<1||e>1e4)throw new RangeError(`${t} must be an integer from 1 to 10000.`);return e}function oe(e){if(e===null||typeof e!="object"||!("mount"in e)||typeof e.mount!="function")throw new TypeError("Scenario requires a host.mount(Component) adapter.")}function se(e){return{...e.cleanupFailure===void 0?{}:{cleanupFailure:e.cleanupFailure},...F(e,"conditions")?{conditions:e.conditions}:{},...F(e,"imports")?{imports:e.imports}:{},reporter:e.reporter}}function ie(e,t){const n=C(t.timeoutMs??1e3,"Scenario timeoutMs"),r=R(t.historyCapacity??64,"Scenario historyCapacity"),o=R(t.activityCapacity??256,"Scenario activityCapacity");let w=t.host;oe(w);let c=_(e,se(t)),s;try{s=N(c,{activityCapacity:o,ringCapacity:r})}catch(u){throw c.ready.catch(()=>{}),c.close().catch(()=>{}),u}let l="open",y=!1,i=!1;const d=[],v=new Set,p=[],f=()=>s.getSnapshot(),k=()=>Object.freeze([...d]),$=new re({getSnapshot:f,history:k,timeoutMs:n}),j=()=>{if(!i){i=!0;try{const u=f(),m=d[d.length-1];((m==null?void 0:m.stateRevision)!==u.stateRevision||m.activity!==u.activity)&&(d.push(u),d.length>r&&d.shift())}finally{i=!1}$.notify()}},I=s.subscribe(j);j();const E=$.deadline(c.ready,"application ready");E.catch(()=>{});let M,S;const A=()=>{if(M!==void 0)return M;let u,m;M=new Promise((a,h)=>{u=a,m=h}),l="closing",$.cancel();const g=[];try{g.push(c.close())}catch(a){g.push(Promise.reject(a))}return g.push(...[...v].map(a=>a.close())),Promise.allSettled(g).then(a=>{const h=[...new Set([...p,...a.flatMap(b=>b.status==="rejected"?[b.reason]:[])])];p.length=0,l="closed";try{j()}catch(b){h.push(b)}finally{I(),s.close(),v.clear(),c=void 0,w=void 0}y=h.length===0,h.length===0?u():m(x(h,"Scenario cleanup failed."))}),M};return Object.freeze({close:()=>{if(S!==void 0)return S;const u=A();return S!==void 0||(S=$.deadline(u,"scenario close"),S.catch(()=>{l==="closing"&&(S=void 0)})),S},getSnapshot:f,history:k,mount:(u,m={})=>{if(l!=="open")throw new Error("Scenario is closing.");const g=O(u,m),a=new Z((b,z)=>{v.delete(a),g.close(),b&&p.push(z)});v.add(a);let h;try{if(h=w.mount(g.Slot),h===null||typeof h!="object"||typeof h.unmount!="function")throw new TypeError("Scenario host.mount must return an unmount() handle.");a.provide(h)}catch(b){throw a.provide(void 0),a.close().catch(()=>{}),b}return Object.freeze({host:h,unmount:a.close,updateProps:b=>{if(l!=="open"||a.closed)throw new Error("Scenario mount is closed.");g.updateProps(b),$.notify()}})},notify:()=>{l==="open"&&$.notify()},ownership:()=>Y(f(),y),ready:E,waitFor:(u,m={})=>l!=="open"?Promise.reject(new Error("Scenario is closing.")):$.waitFor(u,m)})}export{ye as CallTimeoutError,T as ScenarioTimeoutError,Se as WaitTimeoutError,te as command,ie as createScenario,ge as eventually,ve as openModel,ne as renderSlot,$e as runCall,ke as settled,Me as testReadable,Ce as testResourceEpoch,je as waitFor,Ee as yieldTurn};
4
4
  //# sourceMappingURL=testing.js.map