dsh-mnemon 0.5.42 → 0.5.44

package/lib/extension-sdk.js

@@ -1,6 +1,44 @@
 import { a as memoryConfigurationDigest, c as record, d as truncate, f as canonicalWorkspacePath, i as integer, l as stringArray, m as withMemoryStorageLock, o as migrationLineage, p as workspaceStorageId, s as receipt, t as defineMemoryStrategyConfiguration, u as text } from "./strategy-configuration-CKP2kRss.js";
 import { COMPOSABLE_MEMORY_API_VERSION, MEMORY_VIEW_EXTENSION_SLOTS } from "./contracts.js";
 import { a as defineMemoryStrategy, i as defineMemorySource, o as defineMemoryStrategyExtension, r as defineMemoryPlugin } from "./definitions-DU7MLBhu.js";
+//#region src/sdk/projection-reservation.ts
+/** Reserve complete Source-declared resident data inside the existing View ceiling. */
+function reserveMemoryProjection(spec, sources, budget) {
+	const minimums = spec.sources.map((selected) => {
+		const source = sources.find((item) => item.sourceInstanceKey === selected.sourceInstanceKey);
+		const hints = source?.hints;
+		const value = source?.capabilities.includes("project") && hints !== null && typeof hints === "object" && !Array.isArray(hints) ? hints?.minimumProjectionCharacters : void 0;
+		if (value === void 0) return 0;
+		if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw new Error("Invalid minimum projection hint");
+		return value;
+	});
+	if (minimums.every((value) => value === 0)) return spec;
+	const minimum = minimums.reduce((sum, value) => sum + value, 0);
+	if (minimum > budget) throw new Error(`Pinned memory requires ${minimum} projection characters but the View budget is ${budget}. Unpin entries or increase the View budget.`);
+	const allocation = spec.sources.map((selected, index) => Math.max(minimums[index], selected.projection?.maxCharacters ?? 0));
+	let excess = allocation.reduce((sum, value) => sum + value, 0) - budget;
+	for (let index = allocation.length - 1; index >= 0 && excess > 0; index--) {
+		const reclaimed = Math.min(excess, allocation[index] - minimums[index]);
+		allocation[index] -= reclaimed;
+		excess -= reclaimed;
+	}
+	return {
+		...spec,
+		sources: spec.sources.map((selected, index) => {
+			const { projection, ...rest } = selected;
+			const characters = allocation[index];
+			return {
+				...rest,
+				...minimums[index] > 0 ? { required: true } : {},
+				...characters === 0 ? {} : { projection: {
+					mode: projection?.mode ?? "eager",
+					maxCharacters: characters
+				} }
+			};
+		})
+	};
+}
+//#endregion
 //#region src/sdk/install.ts
 function locatedEntryId(ctx) {
 	const located = ctx.get("loader", false)?.locate(ctx.fiber)?.trim();
@@ -108,4 +146,4 @@ function defineMemoryViewExtension(definition) {
 	});
 }
 //#endregion
-export { canonicalWorkspacePath, receipt as createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, defineMemoryStrategy, defineMemoryStrategyConfiguration, defineMemoryStrategyExtension, defineMemoryViewExtension, installMemory, memoryConfigurationDigest, integer as memoryInputInteger, migrationLineage as memoryInputMigrationLineage, record as memoryInputRecord, stringArray as memoryInputStringArray, text as memoryInputText, memoryViewExtensionValues, truncate as truncateMemoryText, validateMemoryViewExtension, withMemoryStorageLock, workspaceStorageId };
+export { canonicalWorkspacePath, receipt as createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, defineMemoryStrategy, defineMemoryStrategyConfiguration, defineMemoryStrategyExtension, defineMemoryViewExtension, installMemory, memoryConfigurationDigest, integer as memoryInputInteger, migrationLineage as memoryInputMigrationLineage, record as memoryInputRecord, stringArray as memoryInputStringArray, text as memoryInputText, memoryViewExtensionValues, reserveMemoryProjection, truncate as truncateMemoryText, validateMemoryViewExtension, withMemoryStorageLock, workspaceStorageId };