doxum 0.1.32 → 0.1.34

package/README.md

@@ -280,6 +280,28 @@ exposes `read`, `select`, `items`, `update`, `batch`, `scope` and `dispose`.
 `ProjectionScope` mirrors `read`, `select`, `items`, `update`, `batch` and `dispose`, plus
 `own(definitionOrTree)` for lifecycle ownership of lazy projection definitions.
 
+### Commands inside a batch
+
+`runtime.read` and `Readable.current()` read current state, including inside a batch. Derived reads evaluate necessary stale dependencies on demand; batch defers external notifications.
+
+```ts
+const count = input(0);
+const doubled = derive({ count }, ({ count }) => count * 2);
+
+function increment() {
+  runtime.update(count, runtime.read(count) + 1);
+}
+
+runtime.batch(() => {
+  increment();
+  runtime.read(doubled); // 2
+  increment();
+  runtime.read(doubled); // 4
+});
+```
+
+Nested batches notify at the outer boundary. Cross-input commands use the same reads without mirrors or borrowed reader parameters. Input equality is checked before acceptance; a failed edit leaves earlier successes intact. A batch is not a transaction, and intermediate reads may advance retained processors more than once. See [current reads and batching](docs/projections.md#current-reads-and-batching) for snapshots, net notifications and lifecycle.
+
 ### Keyed projection
 
 `derive.keyed` preserves a keyed driver's membership and order while deriving entries
@@ -400,6 +422,16 @@ key later creates a new generation. A subscribed missing item stays latent and a
 if the key is later added. Runtime batches follow the net published membership, so a
 remove/add collapsed to an update does not create a false lifecycle break.
 
+### One-to-many keyed derivation
+
+```ts
+const lines = derive.keyed.flatMap(orders, order =>
+  order.lines.map(line => [line.id, line] as const)
+);
+```
+
+Each parent returns ordered `[globalKey, value]` tuples, including zero entries. `flatMap` reuses named/dynamic keyed dependencies and only recomputes invalidated parents. Formal output order follows parent order then child order; parent-only reordering runs no selectors. Duplicate final output keys are errors, and present `undefined` is valid. Same-batch transfers preserve a global key's membership identity. Structural changes can rebuild full order; this is not a claim that every operation costs only the changed entries.
+
 ### Runtime-local keyed state
 
 Use `input.collection` for selection, expanded state, local overrides and other
@@ -421,7 +453,7 @@ Its state is owned by the `ProjectionRuntime`, not the document, history or pers
 Updates are synchronous and atomic. It publishes exact keyed `CollectionChange`
 transitions and preserves order. The optional per-entry equality defaults to `Object.is`
 and suppresses equivalent `set` operations. Callback and equality failures leave both
-the published value and the next draft unchanged.
+the current value and the next draft unchanged.
 
 The processor-facing `CollectionChange` type and `collectionChange.keys(...)` utility
 are exported by `doxum/advanced`. The utility lazily iterates incremental added,

package/dist/advanced.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_transform = require("./transform-CENhTaVN.cjs");
+const require_transform = require("./transform-Bt1Mwgrj.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-B1qIJJBL.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-Cbf3C8eJ.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-BRgPvyN6.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-DzxXGYe1.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, l as assertSynchronous, p as collectionChange, t as createKeyedTransform, w as collectionView } from "./transform-gOtqcdHe.js";
+import { D as defineProcessor, S as compileProjectionDependencies, _ as assertSynchronous, r as collectionChange, t as createKeyedTransform, w as collectionView } from "./transform-RghG_Qxs.js";
 import { n as isPlainObject } from "./record-B2yRhYsc.js";
 //#region core/src/projection/advanced.ts
 const resetCollectionChange = Object.freeze({ kind: "reset" });

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

@@ -134,7 +134,7 @@ type SameKeyConstraint<DriverKey extends string, Dependency> = Dependency extend
   readonly key: unknown;
 } | {
   readonly keys: unknown;
-} ? unknown : DriverKey extends SourceKey ? unknown : never : unknown;
+} ? unknown : [DriverKey] extends [SourceKey] ? unknown : never : unknown;
 type KeyedDependencies<DriverKey extends string, DriverValue, D extends object> = { readonly [P in keyof D]: P extends string ? KeyedDependency<DriverKey, DriverValue> & SameKeyConstraint<DriverKey, D[P]> : never };
 type KeyedDependencyValues<D extends object> = { readonly [P in keyof D]: D[P] extends {
   readonly source: KeyedProjection<infer K extends string, infer V>;
@@ -144,4 +144,4 @@ type KeyedDependencyValues<D extends object> = { readonly [P in keyof D]: D[P] e
 } ? V | undefined : D[P] extends Projection<infer T> ? T : never };
 //#endregion
 export { ProjectionDisposedError as _, Input as a, ProjectionChange as c, CollectionRead as d, ExternalCollectionEvent as f, ExternalValueSource as g, ExternalValueEvent as h, CollectionInputDraft as i, CollectionChange as l, ExternalCollectionSource as m, KeyedDependencyValues as n, KeyedProjection as o, ExternalCollectionRead as p, CollectionInput as r, Projection as s, KeyedDependencies as t, CollectionDraft as u, ProjectionError as v };
-//# sourceMappingURL=dependency-B1qIJJBL.d.cts.map
+//# sourceMappingURL=dependency-Cbf3C8eJ.d.cts.map

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

@@ -134,7 +134,7 @@ type SameKeyConstraint<DriverKey extends string, Dependency> = Dependency extend
   readonly key: unknown;
 } | {
   readonly keys: unknown;
-} ? unknown : DriverKey extends SourceKey ? unknown : never : unknown;
+} ? unknown : [DriverKey] extends [SourceKey] ? unknown : never : unknown;
 type KeyedDependencies<DriverKey extends string, DriverValue, D extends object> = { readonly [P in keyof D]: P extends string ? KeyedDependency<DriverKey, DriverValue> & SameKeyConstraint<DriverKey, D[P]> : never };
 type KeyedDependencyValues<D extends object> = { readonly [P in keyof D]: D[P] extends {
   readonly source: KeyedProjection<infer K extends string, infer V>;
@@ -144,4 +144,4 @@ type KeyedDependencyValues<D extends object> = { readonly [P in keyof D]: D[P] e
 } ? V | undefined : D[P] extends Projection<infer T> ? T : never };
 //#endregion
 export { ProjectionDisposedError as _, Input as a, ProjectionChange as c, CollectionRead as d, ExternalCollectionEvent as f, ExternalValueSource as g, ExternalValueEvent as h, CollectionInputDraft as i, CollectionChange as l, ExternalCollectionSource as m, KeyedDependencyValues as n, KeyedProjection as o, ExternalCollectionRead as p, CollectionInput as r, Projection as s, KeyedDependencies as t, CollectionDraft as u, ProjectionError as v };
-//# sourceMappingURL=dependency-BRgPvyN6.d.ts.map
+//# sourceMappingURL=dependency-DzxXGYe1.d.ts.map