@opetope/react 0.13.0 → 0.15.0

package/dist/resource-command.d.ts

@@ -1,21 +1,14 @@
-/**
- * D359: the verbs of a Resource, dressed as the commands a button already knows, and the recognition that answers
- * «is this selected field a Resource». A consumer keeps a status — `inFlight` until the operation settles, the
- * settled `outcome` — while the Resource stays owned by the model that declared it: cancelling this wait cancels the
- * wait and not the load.
- */
 import type { PaginationOutcome, PaginationState, Resource, ResourceOperationOutcome, ResourcePagination, ResourceState } from '@opetope/core';
 import type { ResourceKey } from '@opetope/core/internal';
-import type { CommandHook } from './command-hook.js';
-import type { CommandInvoker } from './command-hook-controller.js';
+import type { ResourceVerbHook } from './resource-verb-hook.js';
 /**
  * D439: the widest Resource, and the name says so. `Resource<never, ResourceKey>` said the opposite in both
  * arguments — `never` is the narrowest `Data` a reader can be handed and a named `Key` *requires* `state.key`, so
  * hardly any member of the family fitted it. Nothing was refused, because every value reaches this name through a
  * cast, which is exactly why the name could drift. `ResourceKeyField<never>` requires no field, so
- * `Resource<unknown, never, 'consumers' | 'owner'>` is the one form every Resource satisfies — keyed or not, paginated or not.
+ * `Resource<unknown, never, 'consumers' | 'model'>` is the one form every Resource satisfies — keyed or not, paginated or not.
  */
-type AnyResource = Resource<unknown, never, 'consumers' | 'owner'>;
+type AnyResource = Resource<unknown, never, 'consumers' | 'model'>;
 /**
  * D349, D359: a Resource is a structural contract a host may implement with an ordinary object, so the question the
  * type of a selected field asked is answered by the runtime that owns it — the registry of the materializations it
@@ -24,37 +17,43 @@ type AnyResource = Resource<unknown, never, 'consumers' | 'owner'>;
  * throws.
  */
 declare function isResource(value: unknown): boolean;
-/** D356: the nested capability, with `loadNext` as a command and the projected pagination state beside it. */
+/**
+ * The nested capability — the projected pagination state and a stable `loadNext`.
+ */
 type ResourcePaginationHook<Cursor extends ResourceKey> = Readonly<{
-    loadNext: CommandHook<void, PaginationOutcome<Cursor>>;
+    loadNext: (options?: {
+        readonly retry?: boolean;
+    }) => Promise<PaginationOutcome<Cursor>>;
     state: PaginationState<Cursor>;
 }>;
 /**
- * D359: what `useResource` answers, and what a field of a `useModel` selection whose value is a Resource answers.
- * The verbs never reject (a Resource answers an outcome), so the ordinary path of `outcome` is
- * `{ kind: 'ok', value }`; `failed` stays in the type because the controller turns a synchronous throw of an
- * invoker into it, and the wrapper below carries its own test that it never throws synchronously.
+ * What `useResource` answers, and what a field of a `useModel` selection whose value is a Resource answers.
  */
 type ResourceHook<Data, Key extends ResourceKey = never> = Readonly<{
-    /** Present when the declaration carried `pagination`; `undefined` for every other Resource. */
+    /**
+     * Present when the Resource was paginated (`ctx.resource.paginate`); `undefined` for every other Resource.
+     */
     pagination: ResourcePaginationHook<ResourceKey> | undefined;
-    refresh: CommandHook<void, ResourceOperationOutcome>;
-    reset: CommandHook<void, ResourceOperationOutcome>;
-    retry: CommandHook<void, ResourceOperationOutcome>;
+    refresh: ResourceVerbHook;
+    reset: ResourceVerbHook;
+    retry: ResourceVerbHook;
     state: ResourceState<Data, Key>;
 }>;
 type PaginatedResourceHook<Data, Key extends ResourceKey, Cursor extends ResourceKey> = Omit<ResourceHook<Data, Key>, 'pagination'> & Readonly<{
     pagination: ResourcePaginationHook<Cursor>;
 }>;
 type ResourceInvokers = Readonly<{
-    loadNext: CommandInvoker;
-    refresh: CommandInvoker;
-    reset: CommandInvoker;
-    retry: CommandInvoker;
+    /** D486: not a command — the stable function `pagination.loadNext` is, one per Resource identity. */
+    loadNext: (options?: {
+        readonly retry?: boolean;
+    }) => Promise<unknown>;
+    refresh: () => Promise<ResourceOperationOutcome>;
+    reset: () => Promise<ResourceOperationOutcome>;
+    retry: () => Promise<ResourceOperationOutcome>;
 }>;
-declare function paginationOf(resource: AnyResource): ResourcePagination<ResourceKey, 'consumers' | 'owner'> | undefined;
+declare function paginationOf(resource: AnyResource): ResourcePagination<ResourceKey, 'consumers' | 'model'> | undefined;
 /**
- * One set per Resource identity. `selectEntry` and `useCommandSlot` both pick their controller by the identity of the
+ * One set per Resource identity. Selected and standalone hooks both pick their controller by the identity of the
  * invoker, so a set rebuilt on every render would reset `inFlight`, drop `outcome` and change `run` — which is why it
  * is memoised against the Resource itself and never assembled during a render.
  */

package/dist/resource-hook.d.ts

@@ -1,11 +1,7 @@
 import type { PaginatedResource, Resource } from '@opetope/core';
 import type { ResourceKey } from '@opetope/core/internal';
 import type { PaginatedResourceHook, ResourceHook } from './resource-command.js';
-/**
- * D359: the state of a Resource, the lease that keeps it open for as long as this component is mounted, and its verbs
- * as commands. The number of React hooks here does not depend on the Resource: a declaration without `pagination`
- * subscribes to a constant source and keeps a `loadNext` that answers `skipped`.
- */
-declare function useResource<Data, Key extends ResourceKey, Cursor extends ResourceKey>(resource: PaginatedResource<Data, Key, Cursor, 'consumers' | 'owner'>): PaginatedResourceHook<Data, Key, Cursor>;
-declare function useResource<Data, Key extends ResourceKey>(resource: Resource<Data, Key, 'consumers' | 'owner'>): ResourceHook<Data, Key>;
+/** Lease a Resource for this committed component and read its state and optional pagination. */
+declare function useResource<Data, Key extends ResourceKey, Cursor extends ResourceKey>(resource: PaginatedResource<Data, Key, Cursor, 'consumers' | 'model'>): PaginatedResourceHook<Data, Key, Cursor>;
+declare function useResource<Data, Key extends ResourceKey>(resource: Resource<Data, Key, 'consumers' | 'model'>): ResourceHook<Data, Key>;
 export { useResource };

package/dist/resource-verb-hook.d.ts

@@ -0,0 +1,28 @@
+import type { ResourceOperationOutcome } from '@opetope/core';
+/** A Resource verb answers its own outcome; only its consumer owns this wait and status. */
+type ResourceVerbHook = Readonly<{
+    inFlight: boolean;
+    outcome: ResourceOperationOutcome | undefined;
+    run: () => Promise<ResourceOperationOutcome>;
+}>;
+type VerbNotification = (inFlight: boolean, outcome?: ResourceOperationOutcome) => void;
+/**
+ * Only Resource verbs use this controller. A detached consumer settles its own waits without cancelling the
+ * materialization's work. The linked waiters add no retained collection to a Resource hook that never runs a verb.
+ */
+declare class ResourceVerbController {
+    private readonly start;
+    private inFlight;
+    private notify;
+    private pending;
+    readonly run: () => Promise<ResourceOperationOutcome>;
+    constructor(start: () => Promise<ResourceOperationOutcome>);
+    attach(notify: VerbNotification): () => void;
+    synchronize(): void;
+    private unlink;
+    private finish;
+    private fail;
+}
+declare function useResourceVerbStatus(slot: ResourceVerbController): ResourceVerbHook;
+export { ResourceVerbController, useResourceVerbStatus };
+export type { ResourceVerbHook };

package/dist/scenario-diagnostics.d.ts

@@ -1,6 +1,8 @@
 import type { RuntimeGraphSnapshot } from '@opetope/runtime/internal';
 import type { ScenarioOwnership } from './scenario-types.js';
-/** D206: the failure carries the producer's same data-only graph/activity facts, without product payloads. */
+/**
+ * The failure carries the producer's same data-only graph/activity facts, without product payloads.
+ */
 declare class ScenarioTimeoutError extends Error {
     readonly label: string;
     readonly timeoutMs: number;

package/dist/scenario-slot.d.ts

@@ -1,18 +1,15 @@
 import type { FC } from 'react';
-import type { Command } from '@opetope/core';
 import type { ModelFixture } from './contribution-frame.js';
 import type { SlotComponentProperties, SlotContribution, SlotProperties, SlotTarget } from './slot.js';
 /**
- * Two forms, as `renderRoot` had (D19): without `contribution` the harness mounts what the target published, with it
- * the harness mounts one fixture contribution so a component test needs no generation.
+ * Two forms, as `renderRoot` had: without `contribution` the harness mounts what the target published.
  */
 type SlotTestFixture<Props extends SlotProperties> = {
     readonly contribution?: SlotContribution<Props>;
     readonly models?: readonly ModelFixture[];
     readonly props?: SlotComponentProperties<Props>;
     /**
-     * Where a contained mount failure is reported (D256). A component test has no feature to report to, so without it
-     * the failure is detached and the assertion has nothing to read.
+     * Where a contained mount failure is reported.
      */
     readonly reporter?: (error: unknown) => void;
 };
@@ -20,15 +17,6 @@ interface SlotTestHarness<Props extends SlotProperties> {
     readonly Slot: FC;
     readonly updateProps: (props: SlotComponentProperties<Props>) => void;
 }
-/**
- * A command a fixture publishes: the test writes the body, the harness gives it the identity a model requires. The
- * Command itself is the core fixture (D300); what this word adds, and what keeps it in the React package, is the
- * contribution binding a mount reads (D285).
- */
-declare function command<Input = void, Output = void>(run: (context: {
-    readonly input: Input;
-    readonly signal: AbortSignal;
-}) => Output | PromiseLike<Output>): Command<Input, Output>;
 /**
  * Mounts the contributions of one slot the way a host does, with optional model fixtures for a component test. D19 and D85: the same
  * ContributionMount is shared by component tests and the application scenario harness (D206).
@@ -36,6 +24,9 @@ declare function command<Input = void, Output = void>(run: (context: {
 declare function createSlotHarness<Props extends SlotProperties>(target: SlotTarget<Props>, fixture?: SlotTestFixture<Props>): SlotTestHarness<Props> & {
     readonly close: () => void;
 };
+/**
+ * Mounts one slot contribution under the React test harness.
+ */
 declare function renderSlot<Props extends SlotProperties>(target: SlotTarget<Props>, fixture?: SlotTestFixture<Props>): SlotTestHarness<Props>;
-export { command, createSlotHarness, renderSlot };
+export { createSlotHarness, renderSlot };
 export type { SlotTestFixture, SlotTestHarness };

package/dist/scenario-types.d.ts

@@ -1,25 +1,46 @@
 import type { FC } from 'react';
-import type { Application, ApplicationConditionBinding } from '@opetope/runtime';
-import type { OpenApplicationOptions, RuntimeGraphSnapshot } from '@opetope/runtime/internal';
+import type { Readable, ResourceView } from '@opetope/core';
+import type { Application, ApplicationConditionBinding, ApplicationImportBinding, ErrorReporter } from '@opetope/runtime';
+import type { ApplicationBindingOptions, OpenApplicationOptions, RuntimeGraphSnapshot } from '@opetope/runtime/internal';
 import type { SlotComponentProperties, SlotProperties, SlotTarget } from './slot.js';
 type ScenarioFeatures = Application extends Application<infer Features> ? Features : never;
 interface ScenarioHostMount {
     unmount(): PromiseLike<void> | void;
 }
-/** The test owns its renderer; the package has no dependency on a DOM renderer or a test runner. */
+/**
+ * The test owns its renderer; the package has no dependency on a DOM renderer or a test runner.
+ */
 interface ScenarioHost<Mounted extends ScenarioHostMount> {
     mount(Component: FC): Mounted;
 }
-type ScenarioOptions<Features extends ScenarioFeatures, Mounted extends ScenarioHostMount, Bindings extends readonly ApplicationConditionBinding[] = readonly ApplicationConditionBinding[]> = OpenApplicationOptions<Features, Bindings> & {
+type ScenarioOptions<Features extends ScenarioFeatures, Mounted extends ScenarioHostMount, Bindings extends readonly ApplicationConditionBinding[] = readonly ApplicationConditionBinding[], Imports extends readonly ApplicationImportBinding[] = readonly ApplicationImportBinding[], Choice extends ErrorReporter | 'collect' = ErrorReporter | 'collect'> = Omit<OpenApplicationOptions<Features, Bindings, Imports>, 'reporter' | 'conditions' | 'imports'> & ApplicationBindingOptions<Features, Bindings, Imports> & {
+    /** Where the application's failures go: a function, or `'collect'` for a readonly `reported` list. */
+    readonly reporter: Choice;
+} & {
+    /**
+     * Records of physical activity an observation keeps, an integer from 1 to 10000.
+     * @default 256
+     */
     readonly activityCapacity?: number;
+    /**
+     * Snapshots `history()` keeps, an integer from 1 to 10000.
+     * @default 64
+     */
     readonly historyCapacity?: number;
+    /** The test-owned renderer: `mount(Component)` answers a handle with `unmount()`. */
     readonly host: ScenarioHost<Mounted>;
+    /** Deadline of readiness and of every wait without its own; the `configureTesting` default otherwise. */
     readonly timeoutMs?: number;
 };
 interface ScenarioWaitOptions {
+    /** Names the wait in its `ScenarioTimeoutError`. */
     readonly label?: string;
-    /** Polls a predicate that also reads external UI state; inspection notifications always wake it immediately. */
+    /**
+     * Polls a predicate that also reads external UI state; inspection notifications always wake it immediately.
+     * @default 10
+     */
     readonly pollIntervalMs?: number;
+    /** Deadline of this wait; the scenario's `timeoutMs`, then the `configureTesting` default otherwise. */
     readonly timeoutMs?: number;
 }
 interface ScenarioMount<Props extends SlotProperties, Mounted extends ScenarioHostMount> {
@@ -38,20 +59,52 @@ type ScenarioOwnership = Readonly<{
     features: 'unknown' | number;
     reasons: readonly string[];
     resources: 'unknown' | number;
-    /** This is not a GC leak assertion and does not claim coverage of arbitrary host or UI resources. */
+    /**
+     * This is not a GC leak assertion and does not claim coverage of arbitrary host or UI resources.
+     */
     scope: 'registered-runtime';
     status: 'complete' | 'unknown';
 }>;
-interface Scenario<Mounted extends ScenarioHostMount> {
+type ScenarioAnswer<Value> = Exclude<Value, false | null | undefined>;
+type ScenarioWaitSource<Value> = Readable<Value> | ResourceView<Value>;
+/**
+ * A source whose every value answers needs a decision.
+ */
+type ScenarioNullableAnswer<Value> = unknown extends Value ? unknown : [Extract<Value, false | null | undefined>] extends [never] ? {
+    readonly 'waitFor(source) requires accept when every source value is an answer': true;
+} : unknown;
+/**
+ * A read answers now or not at all.
+ */
+type ScenarioSyncOnly<Value> = 0 extends 1 & Value ? unknown : [Extract<Value, PromiseLike<unknown>>] extends [never] ? unknown : {
+    readonly 'waitFor reads synchronously and a promise would answer its first attempt: await the read inside eventually': never;
+};
+/**
+ * Without a decision, the function and the source share one signature, so the refusal of either half is the one
+ * printed. The name stands in the first line: spelled out, the snapshot type would fill it before the refusal.
+ */
+type ScenarioReadWithoutAccept<Value> = (((snapshot: RuntimeGraphSnapshot) => Value) & ScenarioSyncOnly<Value>) | (ScenarioWaitSource<Value> & ScenarioNullableAnswer<Value> & ScenarioSyncOnly<Value>);
+interface ScenarioBase<Mounted extends ScenarioHostMount> {
     close(): Promise<void>;
     getSnapshot(): RuntimeGraphSnapshot;
     history(): readonly RuntimeGraphSnapshot[];
     mount<Props extends SlotProperties>(target: SlotTarget<Props>, ...arguments_: ScenarioMountArguments<Props>): ScenarioMount<Props, Mounted>;
-    /** Wakes predicates after an external fixture changes; it publishes no runtime event. */
+    /**
+     * Wakes predicates after an external fixture changes; it publishes no runtime event.
+     */
     notify(): void;
     ownership(): ScenarioOwnership;
-    /** A deadline does not close the application: a test can inspect a loading body and then release its fixture. */
+    /**
+     * A deadline does not close the application: a test can inspect a loading body and then release its fixture.
+     */
     readonly ready: Promise<void>;
-    waitFor(predicate: (snapshot: RuntimeGraphSnapshot) => boolean, options?: ScenarioWaitOptions): Promise<void>;
+    waitFor<Value>(read: ScenarioReadWithoutAccept<Value>, options?: ScenarioWaitOptions): Promise<ScenarioAnswer<Value>>;
+    waitFor<Value, Narrowed extends Value>(source: ScenarioWaitSource<Value> & ScenarioSyncOnly<Value>, accept: (value: Value) => value is Narrowed, options?: ScenarioWaitOptions): Promise<Narrowed>;
+    waitFor<Value>(source: ScenarioWaitSource<Value> & ScenarioSyncOnly<Value>, accept: (value: Value) => boolean, options?: ScenarioWaitOptions): Promise<Value>;
+    waitFor<Value, Narrowed extends Value>(read: ((snapshot: RuntimeGraphSnapshot) => Value) & ScenarioSyncOnly<Value>, accept: (value: Value) => value is Narrowed, options?: ScenarioWaitOptions): Promise<Narrowed>;
+    waitFor<Value>(read: ((snapshot: RuntimeGraphSnapshot) => Value) & ScenarioSyncOnly<Value>, accept: (value: Value) => boolean, options?: ScenarioWaitOptions): Promise<Value>;
 }
-export type { Scenario, ScenarioFeatures, ScenarioHost, ScenarioHostMount, ScenarioMount, ScenarioOptions, ScenarioOwnership, ScenarioWaitOptions, };
+type Scenario<Mounted extends ScenarioHostMount, Choice extends ErrorReporter | 'collect' = ErrorReporter> = ScenarioBase<Mounted> & (Choice extends 'collect' ? Readonly<{
+    reported: readonly unknown[];
+}> : {});
+export type { Scenario, ScenarioFeatures, ScenarioHost, ScenarioHostMount, ScenarioMount, ScenarioOptions, ScenarioOwnership, ScenarioReadWithoutAccept, ScenarioWaitOptions, };

package/dist/scenario-wait.d.ts

@@ -6,6 +6,13 @@ interface ScenarioWaitSource {
     readonly history: () => readonly RuntimeGraphSnapshot[];
     readonly timeoutMs: number;
 }
+type ScenarioWaitRead = {
+    readonly kind: 'source';
+    readonly read: () => unknown;
+} | {
+    readonly kind: 'graph';
+    readonly read: (snapshot: RuntimeGraphSnapshot) => unknown;
+};
 declare class ScenarioWaiters {
     private readonly source;
     private readonly listeners;
@@ -14,7 +21,7 @@ declare class ScenarioWaiters {
     cancel(): void;
     deadline<Value>(result: PromiseLike<Value>, label: string, timeoutMs?: number): Promise<Value>;
     readonly notify: () => void;
-    waitFor(predicate: (snapshot: RuntimeGraphSnapshot) => boolean, options: ScenarioWaitOptions): Promise<void>;
+    waitFor(request: ScenarioWaitRead, accept: ((value: unknown) => boolean) | undefined, options: ScenarioWaitOptions): Promise<unknown>;
     private timeout;
 }
 export { positiveDuration, ScenarioWaiters };

package/dist/scenario.d.ts

@@ -1,5 +1,7 @@
-import type { Application, ApplicationConditionBinding } from '@opetope/runtime';
+import type { Application, ApplicationConditionBinding, ApplicationImportBinding, ErrorReporter } from '@opetope/runtime';
 import type { Scenario, ScenarioFeatures, ScenarioHostMount, ScenarioOptions } from './scenario-types.js';
-/** D206: one real application, its existing inspection session and renderer-owned Slot ingress. */
-declare function createScenario<const Features extends ScenarioFeatures, Mounted extends ScenarioHostMount, const Bindings extends readonly ApplicationConditionBinding[] = readonly []>(application: Application<Features>, options: ScenarioOptions<NoInfer<Features>, Mounted, Bindings>): Scenario<Mounted>;
+/**
+ * One real application, its existing inspection session and renderer-owned Slot ingress.
+ */
+declare function createScenario<const Features extends ScenarioFeatures, Mounted extends ScenarioHostMount, const Bindings extends readonly ApplicationConditionBinding[] = readonly [], const Imports extends readonly ApplicationImportBinding[] = readonly [], const Choice extends ErrorReporter | 'collect' = ErrorReporter>(application: Application<Features>, options: ScenarioOptions<NoInfer<Features>, Mounted, Bindings, Imports, Choice>): Scenario<Mounted, Choice>;
 export { createScenario };

package/dist/selection-hooks.d.ts

@@ -1,17 +1,19 @@
 import type { Command } from '@opetope/core';
 import type { CommandHook } from './command-hook.js';
 import type { SelectedResource } from './model-selection-snapshot.js';
+import type { ResourceInvokers } from './resource-command.js';
+import type { ResourceVerbHook } from './resource-verb-hook.js';
 type CommandSelection = Readonly<Record<string, Command<never, unknown>>>;
 type ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;
 /** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */
 type SelectedResourceHook = Readonly<{
     pagination: Readonly<{
-        loadNext: CommandHook<never, unknown>;
+        loadNext: ResourceInvokers['loadNext'];
         state: unknown;
     }> | undefined;
-    refresh: CommandHook<never, unknown>;
-    reset: CommandHook<never, unknown>;
-    retry: CommandHook<never, unknown>;
+    refresh: ResourceVerbHook;
+    reset: ResourceVerbHook;
+    retry: ResourceVerbHook;
     state: unknown;
 }>;
 type SelectionHooks = Readonly<Record<PropertyKey, CommandHook<never, unknown> | SelectedResourceHook>>;

package/dist/selector-sources.d.ts

@@ -0,0 +1,64 @@
+import type { Readable, ResourceView } from '@opetope/core';
+import type { State } from '@opetope/core/internal';
+/**
+ * D476: the refusals of a selector. Each is the instruction, as D401 writes a refusal; a string literal behind an alias
+ * prints as the literal, so the sentence reaches the message. A string and not a record, because a `this` of a record
+ * type reaches TS7 as a missing property that prints the sentence twice and never says `this`.
+ */
+type SnapshotRefusal = 'getSnapshot() in a selector never updates: use read(source)';
+type SubscribeRefusal = 'a selector subscribes to a source through read(source)';
+type LeaseRefusal = 'select the Resource as a field, or read(view), and the component leases it';
+type StateWriteRefusal = 'a selector reads; write in a command';
+/**
+ * D476: what a selector sees in place of a `Readable` field. It is still a `Readable` — `this` is not compared where
+ * the target signature declares none — so `derive`, `selectByKey` and a selector annotated with the model keep taking
+ * it, while a direct read refuses its receiver: `read` is the one read in a selector that subscribes the component to
+ * what it read, and `getSnapshot()` there answers the first value forever. An alias of an object type and not an
+ * interface, so a declaration file that meets it prints its structure instead of refusing an unexported name.
+ */
+type Source<Value> = {
+    getSnapshot(this: SnapshotRefusal): Value;
+    subscribe(this: SubscribeRefusal, listener: () => void): () => void;
+};
+type Guarded<Member, Refusal> = Member extends (...arguments_: infer Arguments) => infer Result ? (this: Refusal, ...arguments_: Arguments) => Result : Member;
+/** D476, D519: the members a selector may not call on a source, each with its refusal. */
+type ReadRefusals = {
+    readonly acquire: LeaseRefusal;
+    readonly getSnapshot: SnapshotRefusal;
+    readonly subscribe: SubscribeRefusal;
+};
+type GuardedMembers = ReadRefusals & {
+    readonly close: StateWriteRefusal;
+    readonly set: StateWriteRefusal;
+    readonly update: StateWriteRefusal;
+};
+/**
+ * D476: a source with more members than `Readable` — a Resource, a view, a collection, a pagination capability — keeps
+ * every one of them, and only the reads and the lease refuse a direct call. `observe()`, `state` and the members of a
+ * collection answer sources of the same kind. What `read` hands back is a value and is not guarded, and neither is
+ * what a factory field answers: a factory keeps its own signature, generic and overloaded ones included. D519: the
+ * writes of a `State` refuse too. The six refusals are one lookup and not a chain of six conditionals, which costs
+ * the `selectors` workload 141 instantiations less for the same refusals.
+ */
+type InSelector<Field> = {
+    readonly [Key in keyof Field]: Key extends keyof GuardedMembers ? Key extends keyof ReadRefusals ? Guarded<Field[Key], ReadRefusals[Key]> : Field extends State<infer _Value> ? Guarded<Field[Key], StateWriteRefusal> : FieldInSelector<Field[Key]> : Key extends 'observe' ? Field[Key] extends () => infer Observed ? () => FieldInSelector<Observed> : Field[Key] : FieldInSelector<Field[Key]>;
+};
+type FieldInSelector<Member> = Member extends Readable<infer Value> ? [Exclude<keyof Member, keyof Readable<Value>>] extends [never] ? Source<Value> : InSelector<Member> : Member extends ResourceView<unknown> | Readonly<{
+    state: Readable<unknown>;
+}> ? InSelector<Member> : Member;
+/**
+ * The model a selector receives.
+ */
+type SelectorModel<Model> = {
+    readonly [Key in keyof Model]: FieldInSelector<Model[Key]>;
+};
+/**
+ * D476: what a refused call answers. TypeScript resolves a refused call again without its selector, so the selection
+ * type is not inferred there: destructuring stays silent, and a field that is used says the selection was refused.
+ */
+type RefusedSelection = {
+    readonly [Field in PropertyKey]: {
+        readonly 'this selection is refused: fix the error its selector reports': never;
+    };
+};
+export type { RefusedSelection, SelectorModel };

package/dist/slot.d.ts

@@ -6,8 +6,7 @@ type SlotProperties = object | undefined;
 type EmptySlotProperties = Readonly<Record<string, never>>;
 type SlotComponentProperties<Props extends SlotProperties> = [Props] extends [undefined] ? EmptySlotProperties : Extract<Props, object>;
 /**
- * What a contribution publishes: the component, the optional props adapter and the optional UI models the mount
- * creates. Without an adapter the component takes the slot props; with one it takes exactly the adapter result (D85).
+ * Contribution component and adapter published for a Slot target.
  */
 type SlotContribution<Props extends SlotProperties = undefined> = {
     readonly Component: ComponentType<never>;
@@ -19,19 +18,22 @@ type SwitchSlotTarget<Route extends string, Props extends SlotProperties = undef
     readonly id: DeclarationId;
 };
 type SlotRenderProps<Props extends SlotProperties> = [Props] extends [undefined] ? {
-    readonly props?: never;
+    readonly props?: 'this slot has no props: omit the props field';
     readonly target: SlotTarget<Props>;
 } : {
     readonly props: SlotComponentProperties<Props>;
     readonly target: SlotTarget<Props>;
 };
-/** D280: a slot is a name, so it takes its id as the first argument. */
+/**
+ * Declare a typed Slot target by its id.
+ */
 declare function defineSlot<Props extends SlotProperties = undefined>(id: string): SlotTarget<Props>;
 declare function defineSwitchSlot<Route extends string, Props extends SlotProperties = undefined>(id: string): SwitchSlotTarget<Route, Props>;
 /**
- * Every contribution renders inside its own mount: the models its generation owns plus the UI models it declared,
- * created on mount and closed on unmount (D70, D85).
+ * Render the published contributions of a Slot target within their owning mounts.
  */
-declare function Slot<Props extends SlotProperties>(options: SlotRenderProps<Props>): ReactNode;
+declare function Slot<Props extends SlotProperties>(options: SlotRenderProps<NoInfer<Props>> & {
+    readonly target: SlotTarget<Props>;
+}): ReactNode;
 export { defineSlot, defineSwitchSlot, Slot };
 export type { SlotComponentProperties, SlotContribution, SlotProperties, SlotTarget, SwitchSlotTarget };

package/dist/testing.d.ts

@@ -1,12 +1,6 @@
-/**
- * Every word of the entry below, except one: `command` is shadowed here by the fixture that also registers the
- * contribution binding a mount reads, so the React name keeps meaning the stronger thing it has always meant. The
- * core fixture is the same Command without that binding, and a test that wants it names `@opetope/core/testing` (D300).
- */
-export { CommandTimeoutError, eventually, openModel, runCommand, settled, testReadable, testResourceEpoch, waitFor, WaitTimeoutError, yieldTurn, } from '@opetope/runtime/testing';
-export type { CommandInputArgs, EventuallyOptions, ModelInstance, OpenModelOptions, RunCommandOptions, SettleTarget, WaitOptions, } from '@opetope/runtime/testing';
+/** React test entry for scenario ownership and slot rendering. */
 export { createScenario } from './scenario.js';
 export { ScenarioTimeoutError } from './scenario-diagnostics.js';
-export { command, renderSlot } from './scenario-slot.js';
+export { renderSlot } from './scenario-slot.js';
 export type { SlotTestFixture, SlotTestHarness } from './scenario-slot.js';
 export type { Scenario, ScenarioHost, ScenarioHostMount, ScenarioMount, ScenarioOptions, ScenarioOwnership, ScenarioWaitOptions, } from './scenario-types.js';

package/dist/testing.js

@@ -1,4 +1,4 @@
-import{CommandTimeoutError as ye,WaitTimeoutError as ge,eventually as Se,openModel as ve,runCommand as $e,settled as ke,testReadable as Me,testResourceEpoch as Ce,waitFor as je,yieldTurn as Ee}from"@opetope/runtime/testing";import{hasOwn as E,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-Bh104T5Z.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`Command ${e.declaration}: ${e.state}; lane parallel; blockers none (parallel).`;const t=e.lane.blockedBy==="unknown"?"unknown":e.lane.blockedBy.join(", ");return`Command ${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(`
-`)}class T extends Error{label;timeoutMs;snapshot;history;code="timeout";constructor(t,n,r,o){super(`Scenario timed out after ${String(n)}ms: ${t}.
-${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},...E(e,"conditions")?{conditions:e.conditions}:{},...E(e,"grace")?{grace:e.grace}:{},...E(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 F=$.deadline(c.ready,"application ready");F.catch(()=>{});let M,g;const A=()=>{if(M!==void 0)return M;let u,m;M=new Promise((a,h)=>{u=a,m=h}),l="closing",$.cancel();const S=[];try{S.push(c.close())}catch(a){S.push(Promise.reject(a))}return S.push(...[...v].map(a=>a.close())),Promise.allSettled(S).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(g!==void 0)return g;const u=A();return g!==void 0||(g=$.deadline(u,"scenario close"),g.catch(()=>{l==="closing"&&(g=void 0)})),g},getSnapshot:f,history:k,mount:(u,m={})=>{if(l!=="open")throw new Error("Scenario is closing.");const S=O(u,m),a=new Z((b,z)=>{v.delete(a),S.close(),b&&p.push(z)});v.add(a);let h;try{if(h=w.mount(S.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.");S.updateProps(b),$.notify()}})},notify:()=>{l==="open"&&$.notify()},ownership:()=>Y(f(),y),ready:F,waitFor:(u,m={})=>l!=="open"?Promise.reject(new Error("Scenario is closing.")):$.waitFor(u,m)})}export{ye as CommandTimeoutError,T as ScenarioTimeoutError,ge as WaitTimeoutError,te as command,ie as createScenario,Se as eventually,ve as openModel,ne as renderSlot,$e as runCommand,ke as settled,Me as testReadable,Ce as testResourceEpoch,je as waitFor,Ee as yieldTurn};
+import{hasOwn as E,isResourceView as R,createAggregateError as D}from"@opetope/core/internal";import{openApplication as L}from"@opetope/runtime";import{createInspectionSession as U,testingTimeoutMs as G}from"@opetope/runtime/internal";import{createElement as J}from"react";import{declarationId as K}from"@opetope/core";import{u as I,c as Q,M as X}from"./contribution-frame-D7_DN6Y2.js";function Y(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 Z(e){if(e.lane===null)return`Command ${e.declaration}: ${e.state}; lane parallel; blockers none (parallel).`;const t=e.lane.blockedBy==="unknown"?"unknown":e.lane.blockedBy.join(", ");return`Command ${e.declaration}: ${e.state}; lane ${e.lane.declaration}; blockers ${t}.`}function q(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(Z),...e.resources.map(n=>`Resource ${n.id}: ${n.state}; leases ${String(n.leases)}.`)]}function ee(e){const t=[...e.runtime.conditions.flatMap(n=>n.state.kind==="true"?[]:[`Condition ${n.label}: ${n.state.kind}.`]),...e.runtime.instances.flatMap(Y),...q(e.activity)];return t.length===0?"No registered runtime blocker observed; external UI and host work are unknown.":t.join(`
+`)}class z extends Error{label;timeoutMs;snapshot;history;code="timeout";constructor(t,n,r,a){super(`Scenario timed out after ${String(n)}ms: ${t}.
+${ee(r)}`),this.label=t,this.timeoutMs=n,this.snapshot=r,this.history=a,this.name="ScenarioTimeoutError"}}function te(e,t){return!t||e===void 0?!1:e.closed&&!e.truncated}function ne(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 re(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 oe(e,t){const n=e.activity,r=te(n,t);return Object.freeze({...re(n,r),closed:t,reasons:ne(n,r,t),scope:"registered-runtime",status:r?"complete":"unknown"})}class se{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,a=this.reject;this.resolve=void 0,this.reject=void 0,this.released(t,n),t?a==null||a(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 ie=K("testing.contribution");function A(e,t={}){const n=t.models??[];let r=t.props??{};const a=new Set,m={getSnapshot:()=>r,subscribe:o=>(a.add(o),()=>a.delete(o))},w=t.contribution,h=t.reporter,u=h===void 0?void 0:{models:[],reporter:h};return Object.freeze({close:()=>{r={},a.clear()},Slot:()=>{const o=I(e.entries),S=I(m);return(w===void 0?o.map(s=>[s.id,s.value,Q(s)??u]):[[ie,w,u]]).map(([s,$,M])=>J(X,{authority:M,contribution:$,contributionId:s,fixtures:n,key:s,slotProps:S,targetId:e.id}))},updateProps:o=>{r=o;for(const S of[...a])S()}})}function ce(e,t={}){const n=A(e,t);return Object.freeze({Slot:n.Slot,updateProps:n.updateProps})}function F(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 ae{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 F(r,"Scenario timeoutMs"),new Promise((a,m)=>{const w=setTimeout(()=>m(this.timeout(n,r)),r);Promise.resolve(t).then(h=>{clearTimeout(w),a(h)},h=>{clearTimeout(w),m(h)})})}notify=()=>{for(const t of[...this.listeners])t()};waitFor(t,n,r){const a=F(r.timeoutMs??this.source.timeoutMs,"Scenario timeoutMs"),m=F(r.pollIntervalMs??10,"Scenario pollIntervalMs"),w=t.kind==="source"?t.read:()=>t.read(this.source.getSnapshot()),h=(u,g)=>{if(u!==null&&(typeof u=="object"||typeof u=="function")&&typeof Reflect.get(u,"then")=="function")throw new TypeError(`Scenario.waitFor ${g} synchronously; put an awaited read inside eventually.`);return u};return new Promise((u,g)=>{let o=!1,S=()=>{};const k=(l,y=!1)=>{o||(o=!0,S(),y?g(l):u(l))},s=()=>{if(!o)try{const l=h(w(),"reads");(n===void 0?l!==!1&&l!==null&&l!==void 0:h(n(l),"decides"))&&k(l)}catch(l){k(l,!0)}},$=l=>k(l,!0),M=setTimeout(()=>k(this.timeout(r.label??(t.kind==="source"?"waitFor(source)":"waitFor"),a),!0),a),v=setInterval(s,m);S=()=>{clearTimeout(M),clearInterval(v),this.listeners.delete(s),this.pending.delete($)},this.listeners.add(s),this.pending.add($),s()})}timeout(t,n){return new z(t,n,this.source.getSnapshot(),this.source.history())}}function x(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 ue(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 le(e){return R(e)?!0:(typeof e!="object"||e===null)&&typeof e!="function"?!1:"getSnapshot"in e&&typeof e.getSnapshot=="function"}function de(e,t){return{...e.cleanupFailure===void 0?{}:{cleanupFailure:e.cleanupFailure},...E(e,"conditions")?{conditions:e.conditions}:{},...E(e,"grace")?{grace:e.grace}:{},...E(e,"imports")?{imports:e.imports}:{},reporter:t}}function fe(e){if(e!=="collect")return{reporter:e};const t=[];return{reported:t,reporter:n=>{t.push(n)}}}function pe(e,t){const n=t.timeoutMs;n!==void 0&&F(n,"Scenario timeoutMs");const r=x(t.historyCapacity??64,"Scenario historyCapacity"),a=x(t.activityCapacity??256,"Scenario activityCapacity");let m=t.host;ue(m);const{reported:w,reporter:h}=fe(t.reporter);let u=L(e,de(t,h)),g;try{g=U(u,{activityCapacity:a,ringCapacity:r})}catch(i){throw u.ready.catch(()=>{}),u.close().catch(()=>{}),i}let o="open",S=!1,k=!1;const s=[],$=new Set,M=[],v=()=>g.getSnapshot(),l=()=>Object.freeze([...s]),y=new ae({getSnapshot:v,history:l,get timeoutMs(){return n??G()}}),P=()=>{if(!k){k=!0;try{const i=v(),f=s[s.length-1];((f==null?void 0:f.stateRevision)!==i.stateRevision||f.activity!==i.activity)&&(s.push(i),s.length>r&&s.shift())}finally{k=!1}y.notify()}},_=g.subscribe(P);P();const O=y.deadline(u.ready,"application ready");O.catch(()=>{});let C,j;const N=()=>{if(C!==void 0)return C;let i,f;C=new Promise((c,d)=>{i=c,f=d}),o="closing",y.cancel();const b=[];try{b.push(u.close())}catch(c){b.push(Promise.reject(c))}return b.push(...[...$].map(c=>c.close())),Promise.allSettled(b).then(c=>{const d=[...new Set([...M,...c.flatMap(p=>p.status==="rejected"?[p.reason]:[])])];M.length=0,o="closed";try{P()}catch(p){d.push(p)}finally{_(),g.close(),$.clear(),u=void 0,m=void 0}S=d.length===0,d.length===0?i():f(D(d,"Scenario cleanup failed."))}),C},W=()=>{if(j!==void 0)return j;const i=N();return j!==void 0||(j=y.deadline(i,"scenario close"),j.catch(()=>{o==="closing"&&(j=void 0)})),j},B=(i,f={})=>{if(o!=="open")throw new Error("Scenario is closing.");const b=A(i,f),c=new se((p,V)=>{$.delete(c),b.close(),p&&M.push(V)});$.add(c);let d;try{if(d=m.mount(b.Slot),d===null||typeof d!="object"||typeof d.unmount!="function")throw new TypeError("Scenario host.mount must return an unmount() handle.");c.provide(d)}catch(p){throw c.provide(void 0),c.close().catch(()=>{}),p}return Object.freeze({host:d,unmount:c.close,updateProps:p=>{if(o!=="open"||c.closed)throw new Error("Scenario mount is closed.");b.updateProps(p),y.notify()}})};function H(i,f,b){if(o!=="open")return Promise.reject(new Error("Scenario is closing."));const c=typeof f=="function"?f:void 0,d=(c===void 0?f:b)??{},p=R(i)?{kind:"source",read:()=>i.observe().getSnapshot()}:le(i)?{kind:"source",read:()=>i.getSnapshot()}:{kind:"graph",read:i};return y.waitFor(p,c,d)}const T={close:W,getSnapshot:v,history:l,mount:B,notify:()=>{o==="open"&&y.notify()},ownership:()=>oe(v(),S),ready:O,waitFor:H};return w!==void 0&&Object.defineProperty(T,"reported",{enumerable:!0,get:()=>Object.freeze([...w])}),Object.freeze(T)}export{z as ScenarioTimeoutError,pe as createScenario,ce as renderSlot};
 //# sourceMappingURL=testing.js.map