doxum 0.1.41 → 0.1.42

package/dist/index.js

@@ -1,6 +1,6 @@
-import { A as ownProjections, C as snapshotProjectionValues, D as defineProcessor, E as snapshotCollectionView, M as projectionRef, N as profile, O as defineSource, S as compileProjectionDependencies, T as mapRead, _ as assertSynchronous, a as collectionChangeTouchesKey, b as ProjectionError, c as assertKeyedProjection, d as outputKind, f as createKeyRelation, g as assertScope, h as snapshotArray, i as collectionChangeIntersects, j as producerOf, k as isProjection, l as compileKeyedDependencies, m as sameArray, n as keyedAbsent, o as collectionHasStructuralChange, p as iterableMatchesArray, s as createCollectionChange, t as createKeyedTransform, u as createKeyedDependencyRuntime, v as createScheduler, w as collectionView, x as collectKeyedInvalidation, y as ProjectionDisposedError } from "./transform-CKJ1ivhz.js";
+import { A as ownProjections, C as snapshotProjectionValues, D as defineProcessor, E as snapshotCollectionView, M as projectionRef, N as profile, O as defineSource, S as compileProjectionDependencies, T as mapRead, _ as assertSynchronous, a as collectionChangeTouchesKey, b as ProjectionError, c as assertKeyedProjection, d as outputKind, f as createKeyRelation, g as assertScope, h as snapshotArray, i as collectionChangeIntersects, j as producerOf, k as isProjection, l as compileKeyedDependencies, m as sameArray, n as keyedAbsent, o as collectionHasStructuralChange, p as iterableMatchesArray, s as createCollectionChange, t as createKeyedTransform, u as createKeyedDependencyRuntime, v as createScheduler, w as collectionView, x as collectKeyedInvalidation, y as ProjectionDisposedError } from "./transform-BvDYPUMm.js";
 import { n as isPlainObject, r as isRecord, t as installOwn } from "./record-B2yRhYsc.js";
-import { c as AddressIndex, d as invalidValue, f as children, g as validate, h as parent, i as contextOf, l as MutationRejected, m as is, o as decodeChanges, p as contains$1, r as bindContext, s as sealChanges, t as assertRuntimeWritable, u as fail } from "./driver-B7RR-VfX.js";
+import { _ as validate, c as addListener, d as fail, f as invalidValue, g as parent, h as is, i as contextOf, l as AddressIndex, m as contains$1, o as decodeChanges, p as children, r as bindContext, s as sealChanges, t as assertRuntimeWritable, u as MutationRejected } from "./driver-B7Hu6D0u.js";
 //#region core/src/schema/model.ts
 const schemaNodeOf = (schema) => schema;
 const collectionEntryNode = (node) => node.kind === "map" || node.kind === "table" || node.kind === "list" ? node.value : void 0;
@@ -1622,10 +1622,7 @@ const createHistory = (input) => {
 			revision: () => revision,
 			subscribe: (listener) => {
 				if (disposed) throw new DocumentDisposedError();
-				listeners.add(listener);
-				return () => {
-					listeners.delete(listener);
-				};
+				return addListener(listeners, listener);
 			},
 			undo: () => {
 				input.assertIdle();
@@ -2296,6 +2293,7 @@ const addRoot = (notification, listener) => {
 	};
 	notification.root.add(entry);
 	return () => {
+		if (!entry.active) return;
 		entry.active = false;
 		if (!notification.notifying) notification.root.delete(entry);
 		else notification.cleanups.add(() => {
@@ -2669,7 +2667,9 @@ const select = (document, selector, equality = Object.is) => {
 		};
 	};
 	const installSubscription = () => {
-		unsubscribeDocument?.();
+		const stop = unsubscribeDocument;
+		unsubscribeDocument = void 0;
+		stop?.();
 		unsubscribeDocument = dependencies.length > 0 ? context.notifications.subscribeTargets(dependencies, () => {
 			const result = evaluate();
 			if (result.rebound) installSubscription();
@@ -2689,15 +2689,22 @@ const select = (document, selector, equality = Object.is) => {
 		},
 		subscribe: (listener) => {
 			ensureCurrent();
-			listeners.add(listener);
-			if (listeners.size === 1) installSubscription();
-			return () => {
-				listeners.delete(listener);
+			const unsubscribe = addListener(listeners, listener, () => {
 				if (!listeners.size) {
-					unsubscribeDocument?.();
+					const stop = unsubscribeDocument;
 					unsubscribeDocument = void 0;
+					stop?.();
 				}
-			};
+			});
+			try {
+				if (listeners.size === 1) installSubscription();
+			} catch (error) {
+				try {
+					unsubscribe();
+				} catch {}
+				throw error;
+			}
+			return unsubscribe;
 		}
 	});
 };
@@ -3687,6 +3694,33 @@ function createValueDerive(dependencies, compute, equality = Object.is) {
 }
 const derive = Object.assign(createValueDerive, { keyed: keyedDerive });
 //#endregion
+//#region core/src/projection/cleanup.ts
+/** Owner-local, cancellable LIFO callbacks. Lifecycle admission stays with the owner. */
+const createCleanupStack = () => {
+	const entries = /* @__PURE__ */ new Set();
+	return {
+		add(callback) {
+			const entry = () => {
+				assertSynchronous(callback());
+			};
+			entries.add(entry);
+			return () => {
+				entries.delete(entry);
+			};
+		},
+		drain(failures) {
+			for (const entry of [...entries].reverse()) {
+				if (!entries.delete(entry)) continue;
+				try {
+					entry();
+				} catch (error) {
+					failures.push(error);
+				}
+			}
+		}
+	};
+};
+//#endregion
 //#region core/src/projection/collection/changes.ts
 /** Net transitions for one consumer's unconsumed interval; bounded by touched keys. */
 const createCollectionChanges = () => {
@@ -4208,8 +4242,7 @@ const createCollectionOutput = (binding) => {
 		},
 		observe: (listener) => {
 			binding.check();
-			observers.add(listener);
-			return () => observers.delete(listener);
+			return addListener(observers, listener);
 		},
 		hasConsumers: () => consumers.size > 0,
 		forEachConsumer: (run) => consumers.forEach((_pending, consumer) => run(consumer)),
@@ -4241,8 +4274,7 @@ const createCollectionOutput = (binding) => {
 		},
 		subscribe: (listener) => {
 			binding.check();
-			listeners.add(listener);
-			return () => listeners.delete(listener);
+			return addListener(listeners, listener);
 		}
 	};
 };
@@ -4357,8 +4389,7 @@ const createValueOutput = (binding) => {
 		},
 		observe: (listener) => {
 			binding.check();
-			observers.add(listener);
-			return () => observers.delete(listener);
+			return addListener(observers, listener);
 		},
 		hasConsumers: () => consumers.size > 0,
 		forEachConsumer: (run) => consumers.forEach((_revision, consumer) => run(consumer)),
@@ -4387,8 +4418,7 @@ const createValueOutput = (binding) => {
 		},
 		subscribe: (listener) => {
 			binding.check();
-			listeners.add(listener);
-			return () => listeners.delete(listener);
+			return addListener(listeners, listener);
 		}
 	};
 };
@@ -4592,7 +4622,7 @@ const selectionAffects = (selection, change) => {
 const createDirectReadable = (source) => Object.freeze({
 	current: source.current,
 	revision: source.revision,
-	subscribe: (listener) => source.subscribe(() => listener())
+	subscribe: source.subscribe
 });
 /** Consumer-side selector tracking; it never mutates processor dependencies. */
 const createSelectorReadable = (source, selector, equality = Object.is) => {
@@ -4696,15 +4726,22 @@ const createSelectorReadable = (source, selector, equality = Object.is) => {
 		},
 		subscribe: (listener) => {
 			ensureCurrent();
-			listeners.add(listener);
-			installSource();
-			return () => {
-				listeners.delete(listener);
-				if (!listeners.size && unsubscribeSource) {
-					unsubscribeSource();
+			const unsubscribe = addListener(listeners, listener, () => {
+				if (!listeners.size) {
+					const stop = unsubscribeSource;
 					unsubscribeSource = void 0;
+					stop?.();
 				}
-			};
+			});
+			try {
+				installSource();
+			} catch (error) {
+				try {
+					unsubscribe();
+				} catch {}
+				throw error;
+			}
+			return unsubscribe;
 		}
 	});
 };
@@ -6002,7 +6039,7 @@ const createSourceRegistry = (scheduler) => {
 //#endregion
 //#region core/src/projection/readable/keyed.ts
 /** Runtime-owned keyed consumer family over one materialized collection output. */
-const createProjectionItems = (source, checkOwner) => {
+const createProjectionItems = (source, checkOwner, checkSubscription) => {
 	if (source.kind !== "collection") throw new TypeError("Projection items require a keyed collection projection.");
 	let disposed = false;
 	const active = /* @__PURE__ */ new Map();
@@ -6131,12 +6168,12 @@ const createProjectionItems = (source, checkOwner) => {
 			subscribe: (listener) => {
 				check();
 				ensureObserved();
-				state.listeners.add(listener);
-				if (!state.tracked && !state.ended) registerWaiting(state);
-				return () => {
-					state.listeners.delete(listener);
+				checkSubscription();
+				const unsubscribe = addListener(state.listeners, listener, () => {
 					if (!state.listeners.size && !state.tracked) unregisterWaiting(state);
-				};
+				});
+				if (!state.tracked && !state.ended) registerWaiting(state);
+				return unsubscribe;
 			}
 		});
 		return state;
@@ -6193,8 +6230,8 @@ const createProjectionItems = (source, checkOwner) => {
 		},
 		subscribe: (listener) => {
 			check();
-			keyListeners.add(listener);
-			return () => keyListeners.delete(listener);
+			checkSubscription();
+			return addListener(keyListeners, listener);
 		}
 	});
 	return {
@@ -6202,6 +6239,7 @@ const createProjectionItems = (source, checkOwner) => {
 			keys,
 			get: (key) => {
 				check();
+				checkSubscription();
 				const current = source.current();
 				if (source.revision() !== settledRevision) pendingKeys.add(key);
 				const canonical = active.get(key);
@@ -6246,6 +6284,7 @@ const createProjectionRuntime = (options) => {
 	const materialized = /* @__PURE__ */ new WeakMap();
 	const publicViews = /* @__PURE__ */ new WeakMap();
 	const scopes = /* @__PURE__ */ new Set();
+	const cleanups = createCleanupStack();
 	const rootItems = /* @__PURE__ */ new Map();
 	const disposeItemControllers = (registry, failures) => {
 		const controllers = [...registry.values()];
@@ -6275,7 +6314,7 @@ const createProjectionRuntime = (options) => {
 		const owner = definition.owner;
 		if (owner === void 0) return;
 		if (owner !== requester) throw new TypeError("Projection belongs to another scope.");
-		if (!requester?.active) throw new ProjectionDisposedError();
+		if (requester?.status === "disposed") throw new ProjectionDisposedError();
 	};
 	const rememberScoped = (definition, requester) => {
 		if (requester && definition.owner === requester) requester.materialized.push(definition);
@@ -6355,25 +6394,33 @@ const createProjectionRuntime = (options) => {
 				assertOutput(output);
 				return output.revision();
 			},
-			subscribe: output.subscribe,
-			observe: output.observe
+			subscribe: (listener) => {
+				scheduler.assertCommand();
+				return output.subscribe(listener);
+			},
+			observe: (listener) => {
+				scheduler.assertCommand();
+				return output.observe(listener);
+			}
 		});
 	};
 	const projectionItems = (projection, requester) => {
+		scheduler.assertCommand();
 		const output = resolveOutput(projection, requester);
 		if (output.kind !== "collection") throw new TypeError("Projection items require a keyed collection projection.");
 		const registry = requester?.items ?? rootItems;
 		const existing = registry.get(output);
 		if (existing) return existing.items;
 		const controller = createProjectionItems(readableSource(projection, requester), () => {
-			if (requester && !requester.active) throw new ProjectionDisposedError();
+			if (requester?.status === "disposed") throw new ProjectionDisposedError();
 			scheduler.ensureCurrent(output);
 			assertOutput(output);
-		});
+		}, scheduler.assertCommand);
 		registry.set(output, controller);
 		return controller.items;
 	};
 	const makeReadable = (projection, selector, equality, requester) => {
+		scheduler.assertCommand();
 		const source = readableSource(projection, requester);
 		return selector ? createSelectorReadable(source, selector, equality) : createDirectReadable(source);
 	};
@@ -6381,8 +6428,8 @@ const createProjectionRuntime = (options) => {
 		return makeReadable(projection, selector, equality);
 	}
 	const inputAccess = (target, requester) => {
-		scheduler.assertIdle();
-		if (requester && !requester.active) throw new ProjectionDisposedError();
+		scheduler.assertCommand();
+		if (requester?.status === "disposed") throw new ProjectionDisposedError();
 		const ref = projectionRef(target);
 		if (ref.output !== 0 || ref.producer.kind !== "source") throw new TypeError("Projection is not an input.");
 		if (ref.producer.source.kind !== "value-input" && ref.producer.source.kind !== "collection-input") throw new TypeError("Projection is not an input.");
@@ -6403,11 +6450,9 @@ const createProjectionRuntime = (options) => {
 		updateInput(target, valueOrRun);
 	}
 	const batch = (run, options) => scheduler.batch(run, options);
-	const disposeScope = (state) => {
-		if (!state.active) return;
-		scheduler.assertIdle();
-		state.active = false;
-		const failures = [];
+	const releaseScope = (state, failures) => {
+		state.status = "disposed";
+		scopes.delete(state);
 		disposeScopeConsumers(state, failures);
 		for (let index = state.materialized.length - 1; index >= 0; index--) {
 			const definition = state.materialized[index];
@@ -6422,24 +6467,38 @@ const createProjectionRuntime = (options) => {
 			}
 		}
 		state.materialized.length = 0;
-		scopes.delete(state);
+	};
+	const disposeScope = (state) => {
+		if (state.status !== "active") return;
+		scheduler.assertCommand();
+		state.status = "closing";
+		const failures = [];
+		try {
+			scheduler.cleanup(() => state.cleanups.drain(failures));
+		} catch (error) {
+			failures.push(error);
+		} finally {
+			scheduler.releaseOwned(() => releaseScope(state, failures));
+		}
 		throwCleanupFailures(failures, "Projection scope cleanup failed.");
 	};
 	const createScope = () => {
-		scheduler.assertIdle();
+		scheduler.assertCommand();
 		const state = {
-			active: true,
+			status: "active",
+			cleanups: createCleanupStack(),
 			materialized: [],
 			subscriptions: /* @__PURE__ */ new Set(),
 			items: /* @__PURE__ */ new Map()
 		};
 		scopes.add(state);
 		const assertActive = () => {
-			if (!state.active) throw new ProjectionDisposedError();
+			if (state.status === "disposed") throw new ProjectionDisposedError();
 			scheduler.assertActive();
 		};
 		function own(target) {
 			assertActive();
+			scheduler.assertCommand();
 			const projections = [];
 			const collect = (value) => {
 				if (isProjection(value)) {
@@ -6509,6 +6568,11 @@ const createProjectionRuntime = (options) => {
 			},
 			update: scopeUpdate,
 			batch: scopeBatch,
+			onDispose: (callback) => {
+				assertActive();
+				scheduler.assertCommand();
+				return state.cleanups.add(callback);
+			},
 			dispose: () => disposeScope(state)
 		});
 	};
@@ -6519,24 +6583,33 @@ const createProjectionRuntime = (options) => {
 		update,
 		batch,
 		scope: createScope,
+		onDispose: (callback) => {
+			scheduler.assertCommand();
+			return cleanups.add(callback);
+		},
 		dispose: () => {
-			if (!scheduler.active) return;
-			scheduler.assertIdle();
+			if (!scheduler.beginClose()) return;
 			const failures = [];
-			for (const scope of scopes) {
-				scope.active = false;
-				disposeScopeConsumers(scope, failures);
-				scope.materialized.length = 0;
-			}
-			scopes.clear();
-			disposeItemControllers(rootItems, failures);
+			const owned = [...scopes].reverse();
+			for (const scope of owned) scope.status = "closing";
 			try {
-				sources.dispose();
+				scheduler.cleanup(() => {
+					for (const scope of owned) scope.cleanups.drain(failures);
+					cleanups.drain(failures);
+				});
 			} catch (error) {
 				failures.push(error);
 			}
 			try {
-				scheduler.dispose();
+				scheduler.dispose(() => {
+					for (const scope of owned) {
+						scope.status = "disposed";
+						scope.materialized.length = 0;
+						disposeScopeConsumers(scope, failures);
+					}
+					scopes.clear();
+					disposeItemControllers(rootItems, failures);
+				}, sources.dispose);
 			} catch (error) {
 				failures.push(error);
 			}

package/dist/local-sync.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_record = require("./record-ChYUi8PP.cjs");
-const require_driver = require("./driver-CN3dGxQI.cjs");
+const require_driver = require("./driver-i4G4iVX0.cjs");
 //#region core/src/local-sync/error.ts
 var LocalSyncError = class extends Error {
 	code;
@@ -467,10 +467,7 @@ const attachLocalSync = async (input) => {
 				revision: () => stateRevision,
 				subscribe: (listener) => {
 					if (disposed) throw new LocalSyncError("disposed", "Local sync has been disposed.");
-					stateListeners.add(listener);
-					return () => {
-						stateListeners.delete(listener);
-					};
+					return require_driver.addListener(stateListeners, listener);
 				}
 			}),
 			flush: async () => {

package/dist/local-sync.d.cts

@@ -1,4 +1,4 @@
-import { W as ObjectSchema, g as Readable, s as DocumentRuntime } from "./contract-CNR6BS75.cjs";
+import { W as ObjectSchema, g as Readable, s as DocumentRuntime } from "./contract-DovG1Yp-.cjs";
 
 //#region core/src/local-sync/json.d.ts
 type JsonPrimitive = null | boolean | number | string;

package/dist/local-sync.d.ts

@@ -1,4 +1,4 @@
-import { W as ObjectSchema, g as Readable, s as DocumentRuntime } from "./contract-COgxO5sv.js";
+import { W as ObjectSchema, g as Readable, s as DocumentRuntime } from "./contract-PqdXNaP8.js";
 
 //#region core/src/local-sync/json.d.ts
 type JsonPrimitive = null | boolean | number | string;

package/dist/local-sync.js

@@ -1,5 +1,5 @@
 import { n as isPlainObject, r as isRecord } from "./record-B2yRhYsc.js";
-import { a as changeCount, n as installRuntimeWriteDriver, o as decodeChanges } from "./driver-B7RR-VfX.js";
+import { a as changeCount, c as addListener, n as installRuntimeWriteDriver, o as decodeChanges } from "./driver-B7Hu6D0u.js";
 //#region core/src/local-sync/error.ts
 var LocalSyncError = class extends Error {
 	code;
@@ -466,10 +466,7 @@ const attachLocalSync = async (input) => {
 				revision: () => stateRevision,
 				subscribe: (listener) => {
 					if (disposed) throw new LocalSyncError("disposed", "Local sync has been disposed.");
-					stateListeners.add(listener);
-					return () => {
-						stateListeners.delete(listener);
-					};
+					return addListener(stateListeners, listener);
 				}
 			}),
 			flush: async () => {

package/dist/react.cjs

@@ -1,9 +1,43 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let doxum = require("doxum");
 let react = require("react");
-//#region react/src/hooks.ts
+let doxum = require("doxum");
+//#region react/src/projection.ts
 const ProjectionContext = (0, react.createContext)(void 0);
-const ProjectionProvider = ProjectionContext.Provider;
+const ManagedProjectionProvider = ({ runtime, fallback, children }) => {
+	const generation = (0, react.useRef)(0);
+	const [owner, setOwner] = (0, react.useState)();
+	(0, react.useEffect)(() => {
+		const scope = runtime.scope();
+		setOwner({
+			runtime,
+			scope,
+			generation: ++generation.current
+		});
+		return () => scope.dispose();
+	}, [runtime]);
+	if (!owner || owner.runtime !== runtime) return fallback ?? null;
+	return (0, react.createElement)(ProjectionContext.Provider, {
+		value: owner.scope,
+		key: owner.generation
+	}, children);
+};
+/** runtime creates an owned scope after commit; value borrows an external owner. */
+const ProjectionProvider = (props) => {
+	if (props.runtime !== void 0) {
+		if (props.value !== void 0) throw new TypeError("ProjectionProvider accepts runtime or value, not both.");
+		return (0, react.createElement)(ManagedProjectionProvider, props);
+	}
+	if (props.value === void 0) throw new TypeError("ProjectionProvider requires runtime or value.");
+	return (0, react.createElement)(ProjectionContext.Provider, { value: props.value }, props.children);
+};
+/** Reads a scope supplied by a managed Provider or an explicitly injected scope. */
+const useProjectionScope = () => {
+	const owner = (0, react.useContext)(ProjectionContext);
+	if (!owner || !("own" in owner)) throw new Error("A ProjectionScope provider is required.");
+	return owner;
+};
+//#endregion
+//#region react/src/hooks.ts
 function useProjection(projection, selector, equality = Object.is) {
 	const owner = (0, react.useContext)(ProjectionContext);
 	if (!owner) throw new Error("ProjectionRuntime is required.");
@@ -56,4 +90,5 @@ exports.useDocumentSelector = useDocumentSelector;
 exports.useHistory = useHistory;
 exports.useInput = useInput;
 exports.useProjection = useProjection;
+exports.useProjectionScope = useProjectionScope;
 exports.useReadable = useReadable;

package/dist/react.d.cts

@@ -1,8 +1,7 @@
-import * as _$react from "react";
 import { CollectionInput, CollectionInputDraft, DocumentSelector, HistoryState, Input, LocalHistory, ObjectSchema, OperationResult, Projection, ProjectionRuntime, ProjectionScope, Readable, ReadonlyDocument } from "doxum";
+import { ReactElement, ReactNode } from "react";
 
 //#region react/src/hooks.d.ts
-declare const ProjectionProvider: _$react.Provider<ProjectionRuntime | ProjectionScope | undefined>;
 declare function useProjection<T>(projection: Projection<T>): T;
 declare function useProjection<T, R>(projection: Projection<T>, selector: (value: T) => R, equality?: (previous: R, next: R) => boolean): R;
 declare function useInput<T>(input: Input<T>): readonly [T, (value: T) => void];
@@ -14,4 +13,21 @@ declare function useHistory<TCommit>(history: LocalHistory<TCommit>): HistorySta
   redo(): OperationResult<TCommit>;
 };
 //#endregion
-export { ProjectionProvider, useDocumentSelector, useHistory, useInput, useProjection, useReadable };
+//#region react/src/projection.d.ts
+type ProjectionProviderProps = {
+  readonly children?: ReactNode;
+} & ({
+  readonly runtime: ProjectionRuntime;
+  readonly fallback?: ReactNode;
+  readonly value?: never;
+} | {
+  readonly value: ProjectionRuntime | ProjectionScope;
+  readonly runtime?: never;
+  readonly fallback?: never;
+});
+/** runtime creates an owned scope after commit; value borrows an external owner. */
+declare const ProjectionProvider: (props: ProjectionProviderProps) => ReactElement;
+/** Reads a scope supplied by a managed Provider or an explicitly injected scope. */
+declare const useProjectionScope: () => ProjectionScope;
+//#endregion
+export { ProjectionProvider, type ProjectionProviderProps, useDocumentSelector, useHistory, useInput, useProjection, useProjectionScope, useReadable };

package/dist/react.d.ts

@@ -1,8 +1,7 @@
+import { ReactElement, ReactNode } from "react";
 import { CollectionInput, CollectionInputDraft, DocumentSelector, HistoryState, Input, LocalHistory, ObjectSchema, OperationResult, Projection, ProjectionRuntime, ProjectionScope, Readable, ReadonlyDocument } from "doxum";
-import * as _$react from "react";
 
 //#region react/src/hooks.d.ts
-declare const ProjectionProvider: _$react.Provider<ProjectionRuntime | ProjectionScope | undefined>;
 declare function useProjection<T>(projection: Projection<T>): T;
 declare function useProjection<T, R>(projection: Projection<T>, selector: (value: T) => R, equality?: (previous: R, next: R) => boolean): R;
 declare function useInput<T>(input: Input<T>): readonly [T, (value: T) => void];
@@ -14,4 +13,21 @@ declare function useHistory<TCommit>(history: LocalHistory<TCommit>): HistorySta
   redo(): OperationResult<TCommit>;
 };
 //#endregion
-export { ProjectionProvider, useDocumentSelector, useHistory, useInput, useProjection, useReadable };
+//#region react/src/projection.d.ts
+type ProjectionProviderProps = {
+  readonly children?: ReactNode;
+} & ({
+  readonly runtime: ProjectionRuntime;
+  readonly fallback?: ReactNode;
+  readonly value?: never;
+} | {
+  readonly value: ProjectionRuntime | ProjectionScope;
+  readonly runtime?: never;
+  readonly fallback?: never;
+});
+/** runtime creates an owned scope after commit; value borrows an external owner. */
+declare const ProjectionProvider: (props: ProjectionProviderProps) => ReactElement;
+/** Reads a scope supplied by a managed Provider or an explicitly injected scope. */
+declare const useProjectionScope: () => ProjectionScope;
+//#endregion
+export { ProjectionProvider, type ProjectionProviderProps, useDocumentSelector, useHistory, useInput, useProjection, useProjectionScope, useReadable };

package/dist/react.js

@@ -1,8 +1,42 @@
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { select } from "doxum";
-import { createContext, useCallback, useContext, useMemo, useSyncExternalStore } from "react";
-//#region react/src/hooks.ts
+//#region react/src/projection.ts
 const ProjectionContext = createContext(void 0);
-const ProjectionProvider = ProjectionContext.Provider;
+const ManagedProjectionProvider = ({ runtime, fallback, children }) => {
+	const generation = useRef(0);
+	const [owner, setOwner] = useState();
+	useEffect(() => {
+		const scope = runtime.scope();
+		setOwner({
+			runtime,
+			scope,
+			generation: ++generation.current
+		});
+		return () => scope.dispose();
+	}, [runtime]);
+	if (!owner || owner.runtime !== runtime) return fallback ?? null;
+	return createElement(ProjectionContext.Provider, {
+		value: owner.scope,
+		key: owner.generation
+	}, children);
+};
+/** runtime creates an owned scope after commit; value borrows an external owner. */
+const ProjectionProvider = (props) => {
+	if (props.runtime !== void 0) {
+		if (props.value !== void 0) throw new TypeError("ProjectionProvider accepts runtime or value, not both.");
+		return createElement(ManagedProjectionProvider, props);
+	}
+	if (props.value === void 0) throw new TypeError("ProjectionProvider requires runtime or value.");
+	return createElement(ProjectionContext.Provider, { value: props.value }, props.children);
+};
+/** Reads a scope supplied by a managed Provider or an explicitly injected scope. */
+const useProjectionScope = () => {
+	const owner = useContext(ProjectionContext);
+	if (!owner || !("own" in owner)) throw new Error("A ProjectionScope provider is required.");
+	return owner;
+};
+//#endregion
+//#region react/src/hooks.ts
 function useProjection(projection, selector, equality = Object.is) {
 	const owner = useContext(ProjectionContext);
 	if (!owner) throw new Error("ProjectionRuntime is required.");
@@ -50,4 +84,4 @@ function useHistory(history) {
 	]);
 }
 //#endregion
-export { ProjectionProvider, useDocumentSelector, useHistory, useInput, useProjection, useReadable };
+export { ProjectionProvider, useDocumentSelector, useHistory, useInput, useProjection, useProjectionScope, useReadable };