doxum 0.1.31 → 0.1.32

package/README.md

@@ -354,14 +354,22 @@ projection dependencies by name:
 const cardContent = derive.keyed(
   items,
   {
+    metadata: { source: metadataByItemId },
     record: { source: records, key: item => item.recordId },
     view: activeView,
     fields: visibleFields,
   },
-  (item, itemId, { record, view, fields }) => renderCard(itemId, item, record, view, fields)
+  (item, itemId, { metadata, record, view, fields }) =>
+    renderCard(itemId, item, metadata, record, view, fields)
 );
 ```
 
+Use `{ source }` when driver and dependency use the same key. It directly binds driver
+key `K` to source key `K`, requires the driver key type to be assignable to the source
+key type, and avoids a redundant `key: (_value, id) => id` selector. Source value or
+membership changes invalidate only the driver entry with that key; source order-only
+changes do not invalidate it.
+
 For `{ source, key }` dependencies, the Runtime owns output-key → source-key bindings
 and reverse invalidation. A missing source entry resolves to `undefined` but remains
 bound, so adding it later invalidates the dependent output keys. An ordinary projection

package/dist/advanced.cjs

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

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

@@ -113,6 +113,11 @@ type SingularKeyedDependency<DriverKey extends string, DriverValue, SourceKey ex
   readonly key: (value: DriverValue, key: DriverKey) => Synchronous<SourceKey | undefined>;
   readonly keys?: never;
 };
+type SameKeyedDependency<SourceKey extends string, SourceValue> = {
+  readonly source: KeyedProjection<SourceKey, SourceValue>;
+  readonly key?: never;
+  readonly keys?: never;
+};
 type PluralKeyedDependency<DriverKey extends string, DriverValue, SourceKey extends string, SourceValue> = {
   readonly source: KeyedProjection<SourceKey, SourceValue>;
   readonly keys: (value: DriverValue, key: DriverKey) => Synchronous<readonly SourceKey[]>;
@@ -122,8 +127,15 @@ type KeyedDependency<DriverKey extends string, DriverValue> = (Projection<unknow
   readonly source?: never;
   readonly key?: never;
   readonly keys?: never;
-}) | SingularKeyedDependency<DriverKey, DriverValue, string, unknown> | PluralKeyedDependency<DriverKey, DriverValue, string, unknown>;
-type KeyedDependencies<DriverKey extends string, DriverValue, D extends object> = { readonly [P in keyof D]: P extends string ? KeyedDependency<DriverKey, DriverValue> : never };
+}) | SameKeyedDependency<string, unknown> | SingularKeyedDependency<DriverKey, DriverValue, string, unknown> | PluralKeyedDependency<DriverKey, DriverValue, string, unknown>;
+type SameKeyConstraint<DriverKey extends string, Dependency> = Dependency extends {
+  readonly source: KeyedProjection<infer SourceKey extends string, unknown>;
+} ? Dependency extends {
+  readonly key: unknown;
+} | {
+  readonly keys: 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>;
   readonly keys: (...args: never[]) => unknown;
@@ -132,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-B3E65M1E.d.cts.map
+//# sourceMappingURL=dependency-B1qIJJBL.d.cts.map

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

@@ -113,6 +113,11 @@ type SingularKeyedDependency<DriverKey extends string, DriverValue, SourceKey ex
   readonly key: (value: DriverValue, key: DriverKey) => Synchronous<SourceKey | undefined>;
   readonly keys?: never;
 };
+type SameKeyedDependency<SourceKey extends string, SourceValue> = {
+  readonly source: KeyedProjection<SourceKey, SourceValue>;
+  readonly key?: never;
+  readonly keys?: never;
+};
 type PluralKeyedDependency<DriverKey extends string, DriverValue, SourceKey extends string, SourceValue> = {
   readonly source: KeyedProjection<SourceKey, SourceValue>;
   readonly keys: (value: DriverValue, key: DriverKey) => Synchronous<readonly SourceKey[]>;
@@ -122,8 +127,15 @@ type KeyedDependency<DriverKey extends string, DriverValue> = (Projection<unknow
   readonly source?: never;
   readonly key?: never;
   readonly keys?: never;
-}) | SingularKeyedDependency<DriverKey, DriverValue, string, unknown> | PluralKeyedDependency<DriverKey, DriverValue, string, unknown>;
-type KeyedDependencies<DriverKey extends string, DriverValue, D extends object> = { readonly [P in keyof D]: P extends string ? KeyedDependency<DriverKey, DriverValue> : never };
+}) | SameKeyedDependency<string, unknown> | SingularKeyedDependency<DriverKey, DriverValue, string, unknown> | PluralKeyedDependency<DriverKey, DriverValue, string, unknown>;
+type SameKeyConstraint<DriverKey extends string, Dependency> = Dependency extends {
+  readonly source: KeyedProjection<infer SourceKey extends string, unknown>;
+} ? Dependency extends {
+  readonly key: unknown;
+} | {
+  readonly keys: 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>;
   readonly keys: (...args: never[]) => unknown;
@@ -132,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-BYbdDHNa.d.ts.map
+//# sourceMappingURL=dependency-BRgPvyN6.d.ts.map

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_transform = require("./transform-B6YxfR0R.cjs");
+const require_transform = require("./transform-CENhTaVN.cjs");
 const require_record = require("./record-ChYUi8PP.cjs");
 const require_driver = require("./driver-CN3dGxQI.cjs");
 //#region core/src/schema/model.ts

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { $ as table, A as ParseError, B as DocumentListConfig, C as Read, D as ChangeSet, E as Change, F as CollectionPath, G as ReadonlyValue, H as DocumentTreeValue, I as PathValueOf, J as field, K as Schema, L as SchemaPath, M as parse, N as CollectionEntry, O as MemberChange, P as CollectionId, Q as optional, R as DocumentAddress, S as Draft, T as snapshot, U as Infer, V as DocumentTreeNode, W as ObjectSchema, X as map, Y as list, Z as object, _ as Unsubscribe, a as DocumentProblem, b as CollectionImpact, c as HistoryState, d as OperationResult, et as tree, f as ReadonlyDocument, g as Readable, h as TransactionResult, i as DocumentDisposedError, j as ParseIssue, k as ValueTransition, l as LocalHistory, m as TransactionRejected, n as DocumentCommit, o as DocumentReentrancyError, p as Synchronous, q as Validator, r as DocumentDiagnostic, s as DocumentRuntime, t as CommitSource, tt as variant, u as ObserverError, v as MutationIssue, w as replace, x as DocumentImpact, y as MutationIssueCode, z as DocumentAnchor } from "./contract-CNR6BS75.cjs";
-import { _ as ProjectionDisposedError, a as Input, f as ExternalCollectionEvent, g as ExternalValueSource, h as ExternalValueEvent, i as CollectionInputDraft, m as ExternalCollectionSource, n as KeyedDependencyValues, o as KeyedProjection, p as ExternalCollectionRead, r as CollectionInput, s as Projection, t as KeyedDependencies, v as ProjectionError } from "./dependency-B3E65M1E.cjs";
+import { _ as ProjectionDisposedError, a as Input, f as ExternalCollectionEvent, g as ExternalValueSource, h as ExternalValueEvent, i as CollectionInputDraft, m as ExternalCollectionSource, n as KeyedDependencyValues, o as KeyedProjection, p as ExternalCollectionRead, r as CollectionInput, s as Projection, t as KeyedDependencies, v as ProjectionError } from "./dependency-B1qIJJBL.cjs";
 
 //#region core/src/runtime.d.ts
 declare const createDocument: <S extends ObjectSchema<object>>(input: {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { $ as table, A as ParseError, B as DocumentListConfig, C as Read, D as ChangeSet, E as Change, F as CollectionPath, G as ReadonlyValue, H as DocumentTreeValue, I as PathValueOf, J as field, K as Schema, L as SchemaPath, M as parse, N as CollectionEntry, O as MemberChange, P as CollectionId, Q as optional, R as DocumentAddress, S as Draft, T as snapshot, U as Infer, V as DocumentTreeNode, W as ObjectSchema, X as map, Y as list, Z as object, _ as Unsubscribe, a as DocumentProblem, b as CollectionImpact, c as HistoryState, d as OperationResult, et as tree, f as ReadonlyDocument, g as Readable, h as TransactionResult, i as DocumentDisposedError, j as ParseIssue, k as ValueTransition, l as LocalHistory, m as TransactionRejected, n as DocumentCommit, o as DocumentReentrancyError, p as Synchronous, q as Validator, r as DocumentDiagnostic, s as DocumentRuntime, t as CommitSource, tt as variant, u as ObserverError, v as MutationIssue, w as replace, x as DocumentImpact, y as MutationIssueCode, z as DocumentAnchor } from "./contract-COgxO5sv.js";
-import { _ as ProjectionDisposedError, a as Input, f as ExternalCollectionEvent, g as ExternalValueSource, h as ExternalValueEvent, i as CollectionInputDraft, m as ExternalCollectionSource, n as KeyedDependencyValues, o as KeyedProjection, p as ExternalCollectionRead, r as CollectionInput, s as Projection, t as KeyedDependencies, v as ProjectionError } from "./dependency-BYbdDHNa.js";
+import { _ as ProjectionDisposedError, a as Input, f as ExternalCollectionEvent, g as ExternalValueSource, h as ExternalValueEvent, i as CollectionInputDraft, m as ExternalCollectionSource, n as KeyedDependencyValues, o as KeyedProjection, p as ExternalCollectionRead, r as CollectionInput, s as Projection, t as KeyedDependencies, v as ProjectionError } from "./dependency-BRgPvyN6.js";
 
 //#region core/src/runtime.d.ts
 declare const createDocument: <S extends ObjectSchema<object>>(input: {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as ownProjections, C as snapshotDependencyValue, D as defineProcessor, E as snapshotCollectionView, M as projectionRef, N as profile, O as defineSource, S as compileProjectionDependencies, T as mapRead, _ as createCollectionChange, a as createKeyedDependencyRuntime, b as sameArray, c as assertScope, d as ProjectionDisposedError, f as ProjectionError, g as collectionHasStructuralChange, h as collectionChangeTouchesKey, i as compileKeyedDependencies, j as producerOf, k as isProjection, l as assertSynchronous, m as collectionChangeIntersects, n as keyedAbsent, o as outputKind, r as assertKeyedProjection, s as createKeyRelation, t as createKeyedTransform, u as createScheduler, v as diffCollection, w as collectionView, x as snapshotArray, y as iterableMatchesArray } from "./transform-BQY9I6il.js";
+import { A as ownProjections, C as snapshotDependencyValue, D as defineProcessor, E as snapshotCollectionView, M as projectionRef, N as profile, O as defineSource, S as compileProjectionDependencies, T as mapRead, _ as createCollectionChange, a as createKeyedDependencyRuntime, b as sameArray, c as assertScope, d as ProjectionDisposedError, f as ProjectionError, g as collectionHasStructuralChange, h as collectionChangeTouchesKey, i as compileKeyedDependencies, j as producerOf, k as isProjection, l as assertSynchronous, m as collectionChangeIntersects, n as keyedAbsent, o as outputKind, r as assertKeyedProjection, s as createKeyRelation, t as createKeyedTransform, u as createScheduler, v as diffCollection, w as collectionView, x as snapshotArray, y as iterableMatchesArray } from "./transform-gOtqcdHe.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";
 //#region core/src/schema/model.ts

package/dist/{transform-B6YxfR0R.cjs → transform-CENhTaVN.cjs}

@@ -750,7 +750,7 @@ const assertKeyedProjection = (projection, role) => {
 	if (outputKind(projection) !== "collection") throw new TypeError(`${role} must be a keyed collection projection.`);
 };
 const compileDynamicDependency = (value, label) => {
-	if (!require_record.isPlainObject(value) || isProjection(value)) throw new TypeError(`${label} dependencies must be projections or singular/plural keyed lookups.`);
+	if (!require_record.isPlainObject(value) || isProjection(value)) throw new TypeError(`${label} dependencies must be projections or keyed lookups.`);
 	const candidate = {};
 	const allowed = new Set([
 		"source",
@@ -768,11 +768,15 @@ const compileDynamicDependency = (value, label) => {
 		if (name === "keys") hasKeys = true;
 	}
 	if (!isProjection(candidate.source)) throw new TypeError(`${label} dynamic keyed dependency source must be a projection.`);
-	if (hasKey === hasKeys) throw new TypeError(`${label} dynamic keyed dependency must declare exactly one of key or keys.`);
+	if (hasKey && hasKeys) throw new TypeError(`${label} dynamic keyed dependency must not declare both key and keys.`);
+	assertKeyedProjection(candidate.source, `${label} dynamic keyed dependency source`);
+	if (!hasKey && !hasKeys) return {
+		kind: "same",
+		projection: candidate.source
+	};
 	const singular = hasKey;
 	const selector = singular ? candidate.key : candidate.keys;
 	if (typeof selector !== "function") throw new TypeError(`${label} dynamic keyed dependency selector must be a function.`);
-	assertKeyedProjection(candidate.source, `${label} dynamic keyed dependency source`);
 	return singular ? {
 		kind: "one",
 		projection: candidate.source,
@@ -833,18 +837,28 @@ const selectedKeys = (dependency, value, key) => {
 };
 const emptyValues = Object.freeze(Object.create(null));
 const createKeyedDependencyRuntime = (compiled) => {
-	const states = compiled.entries.map((entry, index) => entry.kind === "global" ? {
-		kind: "global",
-		entry,
-		sourceIndex: index + 1,
-		revision: -1,
-		globalValue: void 0
-	} : {
-		kind: "dynamic",
-		entry,
-		sourceIndex: index + 1,
-		relation: createKeyRelation(),
-		revision: -1
+	const states = compiled.entries.map((entry, index) => {
+		const sourceIndex = index + 1;
+		if (entry.kind === "global") return {
+			kind: "global",
+			entry,
+			sourceIndex,
+			revision: -1,
+			globalValue: void 0
+		};
+		if (entry.kind === "same") return {
+			kind: "same",
+			entry,
+			sourceIndex,
+			revision: -1
+		};
+		return {
+			kind: "dynamic",
+			entry,
+			sourceIndex,
+			relation: createKeyRelation(),
+			revision: -1
+		};
 	});
 	let driverRevision = -1;
 	return {
@@ -863,9 +877,13 @@ const createKeyedDependencyRuntime = (compiled) => {
 					values[state.entry.name] = state.globalValue;
 					continue;
 				}
-				const dependency = state.entry;
 				const source = sources[state.sourceIndex];
 				if (source.kind !== "collection") throw new TypeError("Dynamic keyed dependency resolved to a non-collection source.");
+				if (state.kind === "same") {
+					values[state.entry.name] = source.read.get(driverKey);
+					continue;
+				}
+				const dependency = state.entry;
 				if (dependency.kind === "one") {
 					const selected = selectedKey(dependency, driverValue, driverKey);
 					state.relation.replaceOne(driverKey, selected);
@@ -897,6 +915,12 @@ const createKeyedDependencyRuntime = (compiled) => {
 					all = true;
 					continue;
 				}
+				if (state.kind === "same") {
+					for (const entry of source.change.added) dirty.add(entry.key);
+					for (const entry of source.change.updated) dirty.add(entry.key);
+					for (const entry of source.change.removed) dirty.add(entry.key);
+					continue;
+				}
 				for (const entry of source.change.added) for (const dependent of state.relation.reverse(entry.key) ?? []) dirty.add(dependent);
 				for (const entry of source.change.updated) for (const dependent of state.relation.reverse(entry.key) ?? []) dirty.add(dependent);
 				for (const entry of source.change.removed) for (const dependent of state.relation.reverse(entry.key) ?? []) dirty.add(dependent);
@@ -917,7 +941,7 @@ const createKeyedDependencyRuntime = (compiled) => {
 			for (const state of states) {
 				state.revision = -1;
 				if (state.kind === "global") state.globalValue = void 0;
-				else state.relation.clear();
+				else if (state.kind === "dynamic") state.relation.clear();
 			}
 			driverRevision = -1;
 		}
@@ -1228,4 +1252,4 @@ Object.defineProperty(exports, "snapshotDependencyValue", {
 	}
 });
 
-//# sourceMappingURL=transform-B6YxfR0R.cjs.map
+//# sourceMappingURL=transform-CENhTaVN.cjs.map