@warp-drive-mirror/core 5.10.0-alpha.2 → 5.10.0-alpha.21

package/dist/unpkg/{prod-deprecated/-private-207KndDu.js → dev/-private-BiuED7nc.js}

@@ -1,12 +1,14 @@
-import { t as getOrSetGlobal } from "./-private-JmhZBKGb.js";
+import { getOrSetGlobal } from "./types/-private.js";
 
-//#region src/reactive/-private/symbols.ts
+// src/reactive/-private/symbols.ts
 const SOURCE = getOrSetGlobal("SOURCE", Symbol("#source"));
 const Destroy = getOrSetGlobal("Destroy", Symbol.dispose || Symbol.for("Dispose"));
 /**
 * Symbol for the method used to request a mutable copy of an otherwise
 * immutable {@link ReactiveResource}.
 *
+* @summary Deprecated symbol-keyed method on a ReactiveResource that resolves with an editable copy;
+* use `checkout` instead.
 * @deprecated use the {@link checkout} utility function instead.
 */
 const Checkout = getOrSetGlobal("Checkout", Symbol("Checkout"));
@@ -17,6 +19,5 @@ const Commit = getOrSetGlobal("Commit", Symbol("Commit"));
 */
 const Context = getOrSetGlobal("Context", Symbol("Context"));
 
-//#endregion
 export { SOURCE as a, Destroy as i, Commit as n, Context as r, Checkout as t };
-//# sourceMappingURL=-private-207KndDu.js.map
+//# sourceMappingURL=-private-BiuED7nc.js.map

package/dist/unpkg/{dev-deprecated/-private-BO-nArRb.js.map → dev/-private-BiuED7nc.js.map}

@@ -1 +1 @@
-{"version":3,"file":"-private-BO-nArRb.js","names":["getOrSetGlobal","SOURCE","Symbol","Destroy","dispose","for","Checkout","Commit","Context"],"sources":["../../../src/reactive/-private/symbols.ts"],"sourcesContent":["///////////////////\n///// WARNING /////\n///////////////////\n\nimport { getOrSetGlobal } from '../../types/-private';\n\n// Great, got your attention with that warning didn't we?\n// Good. Here's the deal: typescript treats symbols as unique types.\n// If by accident a module creating a symbol is processed more than\n// once, the symbol will be different in each processing. This will\n// cause a type error.\n// It could also cause a runtime error if the symbol is used innapropriately.\n// However, this case is extremely hard to hit and would require other things\n// to go wrong first.\n//\n// So, why do the warning? And why do we lie about the types of the symbols?\n//\n// Because we intentionally create multiple copies of them within the types\n// at build time. This is because we rollup our d.ts files in order to give\n// our consumers a better experience.\n//\n// However, no tool today supports rolling up d.ts files with multiple entry\n// points correctly. The tool we use currently (vite-plugin-dts) uses @microsoft/api-extractor\n// which creates a fully unique stand-alone types file per-entry-point. Thus\n// every entry point that uses one of these symbols somewhere will have accidentally\n// created a new symbol type.\n//\n// This cast allows us to rollup these types using this tool while not encountering\n// the unique symbol type issue.\n//\n// Note that none of these symbols are part of the public API, these are used for\n// debugging DX and as a safe way to provide an intimate contract on public objects.\n\nexport const SOURCE: '___(unique) Symbol(SOURCE)' = getOrSetGlobal('SOURCE', Symbol('#source'));\n\nexport const Destroy: '___(unique) Symbol(Destroy)' = getOrSetGlobal(\n  'Destroy',\n  Symbol.dispose || Symbol.for('Dispose')\n);\n/**\n * Symbol for the method used to request a mutable copy of an otherwise\n * immutable {@link ReactiveResource}.\n *\n * @deprecated use the {@link checkout} utility function instead.\n */\nexport const Checkout: '___(unique) Symbol(Checkout)' = getOrSetGlobal('Checkout', Symbol('Checkout'));\nexport const Commit: '___(unique) Symbol(Commit)' = getOrSetGlobal('Commit', Symbol('Commit'));\n\n/**\n * Symbol used to stash the internal field/resource context (schema, store,\n * mutability, etc.) on a {@link ReactiveResource} or reactive field instance.\n */\nexport const Context: '___(unique) Symbol(Context)' = getOrSetGlobal('Context', Symbol('Context'));\n"],"mappings":";;;AAiCA,MAAaC,SAAuCD,eAAe,UAAUE,OAAO,SAAS,CAAC;AAE9F,MAAaC,UAAyCH,eACpD,WACAE,OAAOE,WAAWF,OAAOG,IAAI,SAAS,CACxC;;;;;;;AAOA,MAAaC,WAA2CN,eAAe,YAAYE,OAAO,UAAU,CAAC;AACrG,MAAaK,SAAuCP,eAAe,UAAUE,OAAO,QAAQ,CAAC;;;;;AAM7F,MAAaM,UAAyCR,eAAe,WAAWE,OAAO,SAAS,CAAC"}
+{"version":3,"file":"-private-BiuED7nc.js","names":["getOrSetGlobal","SOURCE","Symbol","Destroy","dispose","for","Checkout","Commit","Context"],"sources":["../../../src/reactive/-private/symbols.ts"],"sourcesContent":["///////////////////\n///// WARNING /////\n///////////////////\n\nimport { getOrSetGlobal } from '../../types/-private';\n\n// Great, got your attention with that warning didn't we?\n// Good. Here's the deal: typescript treats symbols as unique types.\n// If by accident a module creating a symbol is processed more than\n// once, the symbol will be different in each processing. This will\n// cause a type error.\n// It could also cause a runtime error if the symbol is used innapropriately.\n// However, this case is extremely hard to hit and would require other things\n// to go wrong first.\n//\n// So, why do the warning? And why do we lie about the types of the symbols?\n//\n// Because we intentionally create multiple copies of them within the types\n// at build time. This is because we rollup our d.ts files in order to give\n// our consumers a better experience.\n//\n// However, no tool today supports rolling up d.ts files with multiple entry\n// points correctly. The tool we use currently (vite-plugin-dts) uses @microsoft/api-extractor\n// which creates a fully unique stand-alone types file per-entry-point. Thus\n// every entry point that uses one of these symbols somewhere will have accidentally\n// created a new symbol type.\n//\n// This cast allows us to rollup these types using this tool while not encountering\n// the unique symbol type issue.\n//\n// Note that none of these symbols are part of the public API, these are used for\n// debugging DX and as a safe way to provide an intimate contract on public objects.\n\nexport const SOURCE: '___(unique) Symbol(SOURCE)' = getOrSetGlobal('SOURCE', Symbol('#source'));\n\nexport const Destroy: '___(unique) Symbol(Destroy)' = getOrSetGlobal(\n  'Destroy',\n  Symbol.dispose || Symbol.for('Dispose')\n);\n/**\n * Symbol for the method used to request a mutable copy of an otherwise\n * immutable {@link ReactiveResource}.\n *\n * @summary Deprecated symbol-keyed method on a ReactiveResource that resolves with an editable copy;\n * use `checkout` instead.\n * @deprecated use the {@link checkout} utility function instead.\n */\nexport const Checkout: '___(unique) Symbol(Checkout)' = getOrSetGlobal('Checkout', Symbol('Checkout'));\nexport const Commit: '___(unique) Symbol(Commit)' = getOrSetGlobal('Commit', Symbol('Commit'));\n\n/**\n * Symbol used to stash the internal field/resource context (schema, store,\n * mutability, etc.) on a {@link ReactiveResource} or reactive field instance.\n */\nexport const Context: '___(unique) Symbol(Context)' = getOrSetGlobal('Context', Symbol('Context'));\n"],"mappings":";;;AAiCA,MAAaC,SAAuCD,eAAe,UAAUE,OAAO,SAAS,CAAC;AAE9F,MAAaC,UAAyCH,eACpD,WACAE,OAAOE,WAAWF,OAAOG,IAAI,SAAS,CACxC;;;;;;;;;AASA,MAAaC,WAA2CN,eAAe,YAAYE,OAAO,UAAU,CAAC;AACrG,MAAaK,SAAuCP,eAAe,UAAUE,OAAO,QAAQ,CAAC;;;;;AAM7F,MAAaM,UAAyCR,eAAe,WAAWE,OAAO,SAAS,CAAC"}

package/dist/unpkg/dev/configure.js

@@ -1,3 +1,3 @@
-import { M as setupSignals } from "./-private-CM5N2rtZ.js";
+import { M as registerSignals, N as setupSignals } from "./-private-B4pCmkq-.js";
 
-export { setupSignals };
+export { registerSignals, setupSignals };

package/dist/unpkg/dev/graph/-private.js

@@ -1,7 +1,7 @@
-import { a as setTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-BP52H-vC.js";
-import { t as getGlobalConfig } from "../runtime-DW881fpw.js";
+import { getOrSetGlobal, peekTransient, setTransient } from "../types/-private.js";
+import { t as getGlobalConfig } from "../runtime-RYvEtg99.js";
 
-//#region src/graph/-private/coerce-id.ts
+// src/graph/-private/coerce-id.ts
 function coerceId(id) {
 	((test) => {
 		if (!test) throw new Error(`Resource IDs must be a non-empty string or null. Received '${String(id)}'.`);
@@ -9,8 +9,7 @@ function coerceId(id) {
 	return id;
 }
 
-//#endregion
-//#region src/graph/-private/-utils.ts
+// src/graph/-private/-utils.ts
 /** Retrieves the private {@link Store} instance from a capabilities manager (or any object exposing `_store`). */
 function getStore(wrapper) {
 	((test) => {
@@ -41,8 +40,8 @@ function assertValidRelationshipPayload(graph, op) {
 	const { definition, identifier, state } = relationship;
 	const { type } = identifier;
 	const { field } = op;
-	const { isAsync, kind } = definition;
-	if (payload.links) console.warn(`You pushed a record of type '${type}' with a relationship '${field}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, isAsync || payload.data === null || !!payload.data || state.hasReceivedData, { id: "ds.store.push-link-for-sync-relationship" });
+	const { isAsync, isLinksMode, kind } = definition;
+	if (payload.links) console.warn(`You pushed a record of type '${type}' with a relationship '${field}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, isAsync || isLinksMode || payload.data === null || !!payload.data || state.hasReceivedData, { id: "ds.store.push-link-for-sync-relationship" });
 	else if (payload.data) {
 		if (kind === "belongsTo") {
 			((test) => {
@@ -169,8 +168,7 @@ function assertRelationshipData(store, resourceKey, data, meta) {
 	})(data === null || !data.type || store.schema.hasResource(data));
 }
 
-//#endregion
-//#region src/graph/-private/-edge-definition.ts
+// src/graph/-private/-edge-definition.ts
 const RELATIONSHIP_KINDS = [
 	"belongsTo",
 	"hasMany",
@@ -370,7 +368,7 @@ function upgradeDefinition(graph, key, propertyName, isImplicit = false) {
 		})(storeWrapper.schema.hasResource({ type: inverseType }));
 		inverseDefinition = null;
 	} else {
-		inverseKey = inverseForRelationship(getStore(storeWrapper), key, propertyName);
+		inverseKey = inverseForRelationship(getStore(storeWrapper), key, meta.name);
 		if (!inverseKey && definition.isPolymorphic && definition.inverseKey) inverseDefinition = {
 			kind: "belongsTo",
 			key: definition.inverseKey,
@@ -395,6 +393,7 @@ function upgradeDefinition(graph, key, propertyName, isImplicit = false) {
 				if (!test) throw new Error(`Expected ${inverseKey} to be a relationship`);
 			})(isRelationshipField(metaFromInverse));
 			inverseDefinition = upgradeMeta(metaFromInverse);
+			inverseKey = inverseDefinition.key;
 		}
 	}
 	if (!inverseDefinition) {
@@ -488,8 +487,7 @@ function inverseForRelationship(store, resourceKey, key) {
 	return definition.options.inverse;
 }
 
-//#endregion
-//#region src/graph/-private/debug/assert-polymorphic-type.ts
+// src/graph/-private/debug/assert-polymorphic-type.ts
 let assertPolymorphicType;
 let assertInheritedSchema;
 {
@@ -623,8 +621,7 @@ let assertInheritedSchema;
 	};
 }
 
-//#endregion
-//#region src/graph/-private/operations/replace-related-records.ts
+// src/graph/-private/operations/replace-related-records.ts
 function count(label) {
 	globalThis.__WarpDriveMetricCountData[label] = (globalThis.__WarpDriveMetricCountData[label] || 0) + 1;
 }
@@ -797,8 +794,7 @@ function flushCanonical(graph, rel, channel) {
 	if (rel.accessed) graph._scheduleLocalSync(rel, channel);
 }
 
-//#endregion
-//#region src/graph/-private/operations/replace-related-record.ts
+// src/graph/-private/operations/replace-related-record.ts
 function replaceRelatedRecord(graph, op, isRemote = false) {
 	const relationship = graph.get(op.record, op.field);
 	((test) => {
@@ -846,8 +842,7 @@ function replaceRelatedRecord(graph, op, isRemote = false) {
 	} else notifyChange(graph, relationship, "local");
 }
 
-//#endregion
-//#region src/graph/-private/-diff.ts
+// src/graph/-private/-diff.ts
 function _compare(priorLocalState, finalState, finalSet, prevState, prevSet, onAdd, onDel, remoteClearsLocal) {
 	const finalLength = finalState.length;
 	const prevLength = prevState.length;
@@ -1092,8 +1087,7 @@ function rollbackRelationship(graph, key, field, relationship) {
 	}
 }
 
-//#endregion
-//#region src/graph/-private/-state.ts
+// src/graph/-private/-state.ts
 function createState() {
 	if (getGlobalConfig().WarpDriveMirror.debug.LOG_GRAPH || globalThis.getWarpDriveRuntimeConfig().debug.LOG_GRAPH) {
 		let hasReceivedData = false;
@@ -1123,8 +1117,7 @@ function createState() {
 	};
 }
 
-//#endregion
-//#region src/graph/-private/edges/collection.ts
+// src/graph/-private/edges/collection.ts
 /**
 * Stores the graph's internal state for one side of a collection (`hasMany`) relationship.
 */
@@ -1161,8 +1154,7 @@ function legacyGetCollectionRelationshipData(source, getRemoteState) {
 	return payload;
 }
 
-//#endregion
-//#region src/graph/-private/edges/implicit.ts
+// src/graph/-private/edges/implicit.ts
 /**
 * The relationship definition (schema metadata) backing an {@link ImplicitEdge}, tagging
 * the {@link UpgradedMeta} as belonging to an implicit inverse relationship.
@@ -1207,8 +1199,7 @@ function createImplicitEdge(definition, identifier) {
 	};
 }
 
-//#endregion
-//#region src/graph/-private/edges/resource.ts
+// src/graph/-private/edges/resource.ts
 function createResourceEdge(definition, identifier) {
 	return {
 		definition,
@@ -1234,8 +1225,7 @@ function legacyGetResourceRelationshipData(source, getRemoteState) {
 	return payload;
 }
 
-//#endregion
-//#region src/graph/-private/operations/add-to-related-records.ts
+// src/graph/-private/operations/add-to-related-records.ts
 function addToRelatedRecords(graph, op, isRemote) {
 	const { record, value, index } = op;
 	const relationship = graph.get(record, op.field);
@@ -1270,8 +1260,7 @@ function addRelatedRecord(graph, relationship, record, value, index, isRemote) {
 	if (_add(graph, record, relationship, value, index, isRemote)) addToInverse(graph, value, relationship.definition.inverseKey, record, isRemote);
 }
 
-//#endregion
-//#region src/graph/-private/operations/merge-identifier.ts
+// src/graph/-private/operations/merge-identifier.ts
 function mergeIdentifier(graph, op, relationships) {
 	Object.keys(relationships).forEach((key) => {
 		const rel = relationships[key];
@@ -1333,8 +1322,7 @@ function mergeImplicit(graph, rel, op) {
 	}
 }
 
-//#endregion
-//#region src/graph/-private/operations/remove-from-related-records.ts
+// src/graph/-private/operations/remove-from-related-records.ts
 function removeFromRelatedRecords(graph, op, isRemote) {
 	const { record, value } = op;
 	const relationship = graph.get(record, op.field);
@@ -1368,8 +1356,7 @@ function removeRelatedRecord(graph, record, relationship, value, index, isRemote
 	if (_remove(graph, record, relationship, value, index, isRemote)) removeFromInverse(graph, value, relationship.definition.inverseKey, record, isRemote);
 }
 
-//#endregion
-//#region src/graph/-private/normalize-link.ts
+// src/graph/-private/normalize-link.ts
 function _normalizeLink(link) {
 	switch (typeof link) {
 		case "object": return link;
@@ -1377,8 +1364,7 @@ function _normalizeLink(link) {
 	}
 }
 
-//#endregion
-//#region src/graph/-private/operations/update-relationship.ts
+// src/graph/-private/operations/update-relationship.ts
 function updateRelationshipOperation(graph, op) {
 	const relationship = graph.get(op.record, op.field);
 	((test) => {
@@ -1449,8 +1435,7 @@ function upgradeIdentifiers(arr, cache) {
 	return arr;
 }
 
-//#endregion
-//#region src/graph/-private/graph.ts
+// src/graph/-private/graph.ts
 /**
 * A single edge (relationship field) tracked by the {@link Graph} for a resource. Which kind of edge
 * a field is depends on its relationship definition:
@@ -2097,8 +2082,7 @@ function isReordered(relationship) {
 	return false;
 }
 
-//#endregion
-//#region src/graph/-private.ts
+// src/graph/-private.ts
 /**
 Provides a performance tuned normalized graph for intelligently managing relationships between resources based on identity
 
@@ -2106,6 +2090,8 @@ While this Graph is abstract, it currently is a private implementation required
 
 We intend to make this Graph public API after some additional iteration during the 5.x timeframe, until then all APIs should be considered experimental and unstable, not fit for direct application or 3rd party library usage.
 
+@summary Experimental, private relationship graph used by the {json:api} Cache to track links between resources
+by identity.
 @module
 */
 function isStore(maybeStore) {
@@ -2132,6 +2118,5 @@ function graphFor(store) {
 	return graph;
 }
 
-//#endregion
 export { graphFor, isBelongsTo, peekGraph };
 //# sourceMappingURL=-private.js.map