doxum 0.1.22 → 0.1.23

package/README.md

@@ -60,10 +60,14 @@ Committed observer failures are returned in `observerErrors` without rollback.
 ## Read And Observe
 
 ```ts
-import { read, snapshot } from 'doxum';
+import { read, select, snapshot } from 'doxum';
 
 const title = read(document, state => state.title);
 const tasks = read(document, state => snapshot(state.tasks));
+const selectedTitle = select(document, state => state.title);
+const stop = selectedTitle.subscribe(() => {
+  console.log(selectedTitle.current());
+});
 document.subscribe(
   path => path.tasks.item('b').title,
   commit => {
@@ -81,6 +85,10 @@ supported types, while classes/functions need application-specific handling.
 Use ordinary properties for fine-grained reads. Data callbacks read real values;
 path callbacks describe symbolic schema locations, including missing entries.
 Subscription paths compile once during registration.
+`select(document, selector, equality?)` returns a standard `Readable`. Core
+tracks exactly the document locations read by the selector, rebinds dependencies
+when selector branches change, and preserves the previous selected reference and
+publication revision when `equality` reports no result change.
 
 React integration:
 
@@ -91,9 +99,10 @@ const title = useDocumentSelector(document, state => state.title);
 const history = useHistory(document.history);
 ```
 
-React tracks fields actually read and updates dependencies when the selector
-branches. The core has no React dependency. `asReadable(document)` removes write
-capabilities while retaining selection, subscription and projection support.
+Document dependency tracking belongs to Core's `select`; the React adapter only
+subscribes to the resulting `Readable`. The core has no React dependency.
+`asReadable(document)` removes write capabilities while retaining selection,
+subscription and projection support.
 
 ## Containers And Parsing
 
@@ -395,7 +404,7 @@ It also reports structural generation advances and distinguishes captured order
 baselines from final published order copies. Architecture workloads include order
 round trips and repeated tree edits to expose costs hidden by commit-only benchmarks.
 
-Builds produce root `dist` ESM/CJS/declarations for `doxum`, `doxum/integration`,
+Builds produce root `dist` ESM/CJS/declarations for `doxum`,
 `doxum/local-sync`, `doxum/react` and `doxum/advanced`. Source ownership is described in
 [architecture](docs/architecture.md) and [AGENTS.md](AGENTS.md).
 The runtime shares one transaction lifecycle; complete mutation operations are

package/dist/{advanced-CqrR_4dh.d.ts → advanced-CLJCWkHa.d.cts}

@@ -1,4 +1,4 @@
-import { J as Infer, L as CollectionEntry, R as CollectionId, Z as ObjectNode, _ as Unsubscribe, et as PathValueOf, m as Synchronous, nt as SchemaPath, s as DocumentReadable, tt as ReadonlyValue, v as Readable, x as CollectionImpact, z as CollectionPath } from "./contract-CxiNcqMn.js";
+import { F as CollectionPath, K as ObjectNode, N as CollectionEntry, P as CollectionId, U as Infer, X as ReadonlyValue, Y as PathValueOf, Z as SchemaPath, _ as Unsubscribe, b as CollectionImpact, g as Readable, o as DocumentReadable, p as Synchronous } from "./contract-SYJFP0lM.cjs";
 
 //#region core/src/projection/contract.d.ts
 /** The one processor-facing collection transition protocol. */
@@ -173,4 +173,4 @@ declare const incremental: typeof createIncrementalValue & {
 };
 //#endregion
 export { ProjectionError as C, ProjectionDisposedError as S, ExternalCollectionEvent as _, IncrementalGroupDefine as a, ExternalValueEvent as b, IncrementalValueContext as c, Input as d, Projection as f, CollectionChange as g, observe as h, IncrementalGroupContext as i, IncrementalValueProcessor as l, input as m, IncrementalCollectionContext as n, IncrementalGroupOutputTree as o, derive as p, IncrementalCollectionProcessor as r, IncrementalGroupProcessor as s, GroupProjections as t, incremental as u, ExternalCollectionRead as v, ExternalValueSource as x, ExternalCollectionSource as y };
-//# sourceMappingURL=advanced-CqrR_4dh.d.ts.map
+//# sourceMappingURL=advanced-CLJCWkHa.d.cts.map