doxum 0.1.40 → 0.1.42

package/README.md

@@ -276,8 +276,8 @@ runtime.dispose();
 
 The stable vocabulary is `read` for a synchronous current value, `select` for a
 `Readable`, and `observe` for declaring a lazy source boundary. `ProjectionRuntime`
-exposes `read`, `select`, `items`, `update`, `batch`, `scope` and `dispose`.
-`ProjectionScope` mirrors `read`, `select`, `items`, `update`, `batch` and `dispose`, plus
+exposes `read`, `select`, `items`, `update`, `batch`, `scope`, `onDispose` and `dispose`.
+`ProjectionScope` mirrors `read`, `select`, `items`, `update`, `batch`, `onDispose` and `dispose`, plus
 `own(definitionOrTree)` for lifecycle ownership of lazy projection definitions.
 
 ### Commands inside a batch
@@ -638,8 +638,40 @@ values. Ordinary source resets preserve retained state when one exists. If a pro
 faults, the Runtime owns recovery, recreates declared state, and performs a reset
 evaluation. Stateless processors use the same recovery path without a state object.
 
+### Projection disposal
+
+`runtime.dispose()`, `scope.dispose()` and Doxum unsubscribe functions are idempotent.
+A parent Runtime ends its scopes, so later component cleanup can safely dispose them
+again. Every subscription registration is independent, including registrations with
+the same callback; an old unsubscribe cannot cancel a later subscription.
+
+`runtime.onDispose(cleanup)` / `scope.onDispose(cleanup)` register synchronous,
+cancellable callbacks. The returned function unregisters that callback without
+executing it. Owner callbacks run in LIFO order; Runtime shutdown runs child scope
+callbacks before its own while all projections remain readable. Cleanup may read
+current values and unsubscribe, but cannot update, batch, subscribe or register new
+resources. Perform domain writes before disposal. After callbacks, consumers and
+producers are released, then source connections; failures do not prevent remaining
+cleanup, and are thrown after disposal completes. Repeated disposal does not retry
+failed callbacks. Reads, commands and new subscriptions still throw after disposal.
+
 ### React
 
+```tsx
+// runtime is owned by the application/service; this Provider owns only its scope.
+<ProjectionProvider runtime={runtime} fallback={<span>Loading…</span>}>
+  <TaskList />
+</ProjectionProvider>
+```
+
+Managed Providers acquire a scope after commit and release it on cleanup. StrictMode
+setup replay creates a fresh scope; runtime replacement also remounts the scoped subtree.
+`useProjectionScope()` returns that scope for `scope.own(...)` and `scope.onDispose(...)`.
+The initial render and SSR render `fallback` (default `null`). For synchronous SSR or
+an externally managed lifetime, use `<ProjectionProvider value={runtimeOrScope}>`;
+this mode only injects the owner and never disposes it. The two modes are mutually
+exclusive. Do not create disposable scopes in `useMemo` or revive a disposed scope.
+
 ```ts
 const task = useProjection(tasks, tasks => tasks.get(taskId), equality);
 const [mode, setMode] = useInput(filter);
@@ -648,8 +680,8 @@ const [selectedRows, updateSelectedRows] = useInput(selection);
 
 `useProjection(projection, selector, equality?)` uses the same keyed selector semantics
 as Core. `useInput` handles both scalar `Input<T>` and `CollectionInput<K,V>`; collection
-updates receive a keyed draft callback. `ProjectionProvider` accepts either a
-`ProjectionRuntime` or `ProjectionScope`.
+updates receive a keyed draft callback. Reading a root projection through a managed
+scope does not transfer its ownership; use `scope.own(...)` for local definitions.
 
 See [projection contracts](docs/projections.md).
 

package/dist/advanced.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_transform = require("./transform-8xXf0OKB.cjs");
+const require_transform = require("./transform-BPh55GWO.cjs");
 const require_record = require("./record-ChYUi8PP.cjs");
 //#region core/src/projection/advanced.ts
 const resetCollectionChange = Object.freeze({ kind: "reset" });

package/dist/advanced.d.cts

@@ -1,4 +1,4 @@
-import { c as ProjectionChange, d as CollectionRead, l as CollectionChange, n as KeyedDependencyValues, o as KeyedProjection, s as Projection, t as KeyedDependencies, u as CollectionDraft } from "./dependency-Cbf3C8eJ.cjs";
+import { c as ProjectionChange, d as CollectionRead, l as CollectionChange, n as KeyedDependencyValues, o as KeyedProjection, s as Projection, t as KeyedDependencies, u as CollectionDraft } from "./dependency-D0bo_xe_.cjs";
 
 //#region core/src/projection/collection/change.d.ts
 declare const collectionChange: {

package/dist/advanced.d.ts

@@ -1,4 +1,4 @@
-import { c as ProjectionChange, d as CollectionRead, l as CollectionChange, n as KeyedDependencyValues, o as KeyedProjection, s as Projection, t as KeyedDependencies, u as CollectionDraft } from "./dependency-DzxXGYe1.js";
+import { c as ProjectionChange, d as CollectionRead, l as CollectionChange, n as KeyedDependencyValues, o as KeyedProjection, s as Projection, t as KeyedDependencies, u as CollectionDraft } from "./dependency-BYiwTiBj.js";
 
 //#region core/src/projection/collection/change.d.ts
 declare const collectionChange: {

package/dist/advanced.js

@@ -1,4 +1,4 @@
-import { D as defineProcessor, S as compileProjectionDependencies, _ as assertSynchronous, r as collectionChange, t as createKeyedTransform, w as collectionView } from "./transform--WCn6_v0.js";
+import { D as defineProcessor, S as compileProjectionDependencies, _ as assertSynchronous, r as collectionChange, t as createKeyedTransform, w as collectionView } from "./transform-BvDYPUMm.js";
 import { n as isPlainObject } from "./record-B2yRhYsc.js";
 //#region core/src/projection/advanced.ts
 const resetCollectionChange = Object.freeze({ kind: "reset" });

package/dist/{contract-CNR6BS75.d.cts → contract-DovG1Yp-.d.cts}

@@ -509,10 +509,11 @@ type MutationIssue = {
 };
 //#endregion
 //#region core/src/readable.d.ts
+/** Ends one registration at most once; safe after owner disposal. */
 type Unsubscribe = () => void;
 type Readable<TValue> = {
   current(): TValue;
-  revision(): number;
+  revision(): number; /** Each call registers independently, even when the listener function is reused. */
   subscribe(listener: () => void): Unsubscribe;
 };
 //#endregion

package/dist/{contract-COgxO5sv.d.ts → contract-PqdXNaP8.d.ts}

@@ -509,10 +509,11 @@ type MutationIssue = {
 };
 //#endregion
 //#region core/src/readable.d.ts
+/** Ends one registration at most once; safe after owner disposal. */
 type Unsubscribe = () => void;
 type Readable<TValue> = {
   current(): TValue;
-  revision(): number;
+  revision(): number; /** Each call registers independently, even when the listener function is reused. */
   subscribe(listener: () => void): Unsubscribe;
 };
 //#endregion

package/dist/{dependency-DzxXGYe1.d.ts → dependency-BYiwTiBj.d.ts}

@@ -1,4 +1,4 @@
-import { _ as Unsubscribe, b as CollectionImpact, p as Synchronous } from "./contract-COgxO5sv.js";
+import { _ as Unsubscribe, b as CollectionImpact, p as Synchronous } from "./contract-PqdXNaP8.js";
 
 //#region core/src/projection/contract.d.ts
 /** The one processor-facing collection transition protocol. */

package/dist/{dependency-Cbf3C8eJ.d.cts → dependency-D0bo_xe_.d.cts}

@@ -1,4 +1,4 @@
-import { _ as Unsubscribe, b as CollectionImpact, p as Synchronous } from "./contract-CNR6BS75.cjs";
+import { _ as Unsubscribe, b as CollectionImpact, p as Synchronous } from "./contract-DovG1Yp-.cjs";
 
 //#region core/src/projection/contract.d.ts
 /** The one processor-facing collection transition protocol. */

package/dist/{driver-B7RR-VfX.js → driver-B7Hu6D0u.js}

@@ -208,6 +208,20 @@ var AddressIndex = class {
 	}
 };
 //#endregion
+//#region core/src/subscription.ts
+/** Each registration owns its identity, independently of callback reuse. */
+const addListener = (listeners, listener, removed) => {
+	const entry = (...args) => listener(...args);
+	listeners.add(entry);
+	let active = true;
+	return () => {
+		if (!active) return;
+		active = false;
+		listeners.delete(entry);
+		removed?.();
+	};
+};
+//#endregion
 //#region core/src/mutation/changes.ts
 const validated = /* @__PURE__ */ new WeakSet();
 const compareChanges = (a, b) => {
@@ -399,4 +413,4 @@ const installRuntimeWriteDriver = (runtime, driver) => {
 	});
 };
 //#endregion
-export { changeCount as a, AddressIndex as c, invalidValue as d, children as f, validate as g, parent as h, contextOf as i, MutationRejected as l, is as m, installRuntimeWriteDriver as n, decodeChanges as o, contains as p, bindContext as r, sealChanges as s, assertRuntimeWritable as t, fail as u };
+export { validate as _, changeCount as a, addListener as c, fail as d, invalidValue as f, parent as g, is as h, contextOf as i, AddressIndex as l, contains as m, installRuntimeWriteDriver as n, decodeChanges as o, children as p, bindContext as r, sealChanges as s, assertRuntimeWritable as t, MutationRejected as u };

package/dist/{driver-CN3dGxQI.cjs → driver-i4G4iVX0.cjs}

@@ -208,6 +208,20 @@ var AddressIndex = class {
 	}
 };
 //#endregion
+//#region core/src/subscription.ts
+/** Each registration owns its identity, independently of callback reuse. */
+const addListener = (listeners, listener, removed) => {
+	const entry = (...args) => listener(...args);
+	listeners.add(entry);
+	let active = true;
+	return () => {
+		if (!active) return;
+		active = false;
+		listeners.delete(entry);
+		removed?.();
+	};
+};
+//#endregion
 //#region core/src/mutation/changes.ts
 const validated = /* @__PURE__ */ new WeakSet();
 const compareChanges = (a, b) => {
@@ -411,6 +425,12 @@ Object.defineProperty(exports, "MutationRejected", {
 		return MutationRejected;
 	}
 });
+Object.defineProperty(exports, "addListener", {
+	enumerable: true,
+	get: function() {
+		return addListener;
+	}
+});
 Object.defineProperty(exports, "assertRuntimeWritable", {
 	enumerable: true,
 	get: function() {