@camstack/system 1.2.314 → 1.2.315

package/dist/composition-sources-DYqQLRzF.js

@@ -0,0 +1,122 @@
+const require_dist = require("./dist-DVKv5i-e.js");
+//#region src/builtins/core-blocks/composition-sources.ts
+/**
+* Describe what a composition reads and writes for SAVE-time validation
+* (D659, D663): one `listAll` per owning addon, one `getBindings` per found
+* device — shared by a device that is both a source and a target. A read that
+* fails makes the device `unreadable`, and the save is REFUSED rather than
+* stored unchecked. Refusing a save destroys nothing (D49).
+*
+* A SOURCE is described by the caps bound to it; an EXISTING TARGET by its row
+* type and each bound cap with the addon serving it — what `planComposition`
+* needs to tell a replace from an add (the composer reads it the same way, from
+* the same two reads: the slim row and `getBindings`).
+*
+* Devices are keyed by `{addonId, stableId}` — never a numeric device id,
+* which is this node's allocation and not the composition's identity.
+*/
+/** Blank binding owners are not native providers and must not turn ADD into REPLACE. */
+function normalizedNativeOwner(owner) {
+	const trimmed = owner?.trim();
+	return trimmed ? trimmed : null;
+}
+async function listOwners(ports, refs) {
+	const addons = [...new Set(refs.map((r) => r.addonId))];
+	const listed = await Promise.all(addons.map(async (addonId) => {
+		try {
+			return [addonId, await ports.listByAddon(addonId)];
+		} catch (err) {
+			return [addonId, { error: require_dist.errMsg(err) }];
+		}
+	}));
+	return new Map(listed);
+}
+function rowOf(ref, listing) {
+	if (listing === void 0) return {
+		kind: "unreadable",
+		error: `\`${ref.addonId}\` was not listed`
+	};
+	if ("error" in listing) return {
+		kind: "unreadable",
+		error: listing.error
+	};
+	const row = listing.find((r) => r.stableId === ref.stableId);
+	return row === void 0 ? { kind: "absent" } : {
+		kind: "row",
+		row
+	};
+}
+/** ONE `getBindings` per found device, whether it is read as a source, a target, or both. */
+async function readBindings(ports, deviceIds) {
+	const read = await Promise.all([...new Set(deviceIds)].map(async (deviceId) => {
+		try {
+			return [deviceId, await ports.bindings(deviceId)];
+		} catch (err) {
+			return [deviceId, { error: require_dist.errMsg(err) }];
+		}
+	}));
+	return new Map(read);
+}
+function describeSource(lookup, bindings) {
+	if (lookup.kind !== "row") return lookup;
+	const bound = bindings.get(lookup.row.id);
+	if (bound === void 0) return {
+		kind: "unreadable",
+		error: "its bindings were not read"
+	};
+	if ("error" in bound) return {
+		kind: "unreadable",
+		error: bound.error
+	};
+	return {
+		kind: "found",
+		deviceId: lookup.row.id,
+		caps: new Set(bound.map((b) => b.capName))
+	};
+}
+function describeTarget(lookup, bindings) {
+	if (lookup.kind !== "row") return lookup;
+	const { id, type } = lookup.row;
+	const bound = bindings.get(id);
+	if (bound === void 0) return {
+		kind: "unreadable",
+		error: "its bindings were not read"
+	};
+	if ("error" in bound) return {
+		kind: "unreadable",
+		error: bound.error
+	};
+	return {
+		kind: "found",
+		deviceId: id,
+		type,
+		nativeCaps: new Map(bound.flatMap((b) => {
+			const owner = normalizedNativeOwner(b.nativeAddonId);
+			return owner === null ? [] : [[b.capName, owner]];
+		}))
+	};
+}
+async function describeCompositionSources(ports, sources, targets = []) {
+	const owners = await listOwners(ports, [...sources, ...targets]);
+	const lookup = (ref) => [require_dist.compositionSourceKey(ref), rowOf(ref, owners.get(ref.addonId))];
+	const sourceRows = sources.map(lookup);
+	const targetRows = targets.map(lookup);
+	const bindings = await readBindings(ports, [...sourceRows, ...targetRows].flatMap(([, l]) => l.kind === "row" ? [l.row.id] : []));
+	return {
+		sources: new Map(sourceRows.map(([key, l]) => [key, describeSource(l, bindings)])),
+		targets: new Map(targetRows.map(([key, l]) => [key, describeTarget(l, bindings)]))
+	};
+}
+//#endregion
+Object.defineProperty(exports, "describeCompositionSources", {
+	enumerable: true,
+	get: function() {
+		return describeCompositionSources;
+	}
+});
+Object.defineProperty(exports, "normalizedNativeOwner", {
+	enumerable: true,
+	get: function() {
+		return normalizedNativeOwner;
+	}
+});

package/dist/composition-sources-yonsRneP.mjs

@@ -0,0 +1,111 @@
+import { In as compositionSourceKey, Wn as errMsg } from "./dist-MzYJVCLE.mjs";
+//#region src/builtins/core-blocks/composition-sources.ts
+/**
+* Describe what a composition reads and writes for SAVE-time validation
+* (D659, D663): one `listAll` per owning addon, one `getBindings` per found
+* device — shared by a device that is both a source and a target. A read that
+* fails makes the device `unreadable`, and the save is REFUSED rather than
+* stored unchecked. Refusing a save destroys nothing (D49).
+*
+* A SOURCE is described by the caps bound to it; an EXISTING TARGET by its row
+* type and each bound cap with the addon serving it — what `planComposition`
+* needs to tell a replace from an add (the composer reads it the same way, from
+* the same two reads: the slim row and `getBindings`).
+*
+* Devices are keyed by `{addonId, stableId}` — never a numeric device id,
+* which is this node's allocation and not the composition's identity.
+*/
+/** Blank binding owners are not native providers and must not turn ADD into REPLACE. */
+function normalizedNativeOwner(owner) {
+	const trimmed = owner?.trim();
+	return trimmed ? trimmed : null;
+}
+async function listOwners(ports, refs) {
+	const addons = [...new Set(refs.map((r) => r.addonId))];
+	const listed = await Promise.all(addons.map(async (addonId) => {
+		try {
+			return [addonId, await ports.listByAddon(addonId)];
+		} catch (err) {
+			return [addonId, { error: errMsg(err) }];
+		}
+	}));
+	return new Map(listed);
+}
+function rowOf(ref, listing) {
+	if (listing === void 0) return {
+		kind: "unreadable",
+		error: `\`${ref.addonId}\` was not listed`
+	};
+	if ("error" in listing) return {
+		kind: "unreadable",
+		error: listing.error
+	};
+	const row = listing.find((r) => r.stableId === ref.stableId);
+	return row === void 0 ? { kind: "absent" } : {
+		kind: "row",
+		row
+	};
+}
+/** ONE `getBindings` per found device, whether it is read as a source, a target, or both. */
+async function readBindings(ports, deviceIds) {
+	const read = await Promise.all([...new Set(deviceIds)].map(async (deviceId) => {
+		try {
+			return [deviceId, await ports.bindings(deviceId)];
+		} catch (err) {
+			return [deviceId, { error: errMsg(err) }];
+		}
+	}));
+	return new Map(read);
+}
+function describeSource(lookup, bindings) {
+	if (lookup.kind !== "row") return lookup;
+	const bound = bindings.get(lookup.row.id);
+	if (bound === void 0) return {
+		kind: "unreadable",
+		error: "its bindings were not read"
+	};
+	if ("error" in bound) return {
+		kind: "unreadable",
+		error: bound.error
+	};
+	return {
+		kind: "found",
+		deviceId: lookup.row.id,
+		caps: new Set(bound.map((b) => b.capName))
+	};
+}
+function describeTarget(lookup, bindings) {
+	if (lookup.kind !== "row") return lookup;
+	const { id, type } = lookup.row;
+	const bound = bindings.get(id);
+	if (bound === void 0) return {
+		kind: "unreadable",
+		error: "its bindings were not read"
+	};
+	if ("error" in bound) return {
+		kind: "unreadable",
+		error: bound.error
+	};
+	return {
+		kind: "found",
+		deviceId: id,
+		type,
+		nativeCaps: new Map(bound.flatMap((b) => {
+			const owner = normalizedNativeOwner(b.nativeAddonId);
+			return owner === null ? [] : [[b.capName, owner]];
+		}))
+	};
+}
+async function describeCompositionSources(ports, sources, targets = []) {
+	const owners = await listOwners(ports, [...sources, ...targets]);
+	const lookup = (ref) => [compositionSourceKey(ref), rowOf(ref, owners.get(ref.addonId))];
+	const sourceRows = sources.map(lookup);
+	const targetRows = targets.map(lookup);
+	const bindings = await readBindings(ports, [...sourceRows, ...targetRows].flatMap(([, l]) => l.kind === "row" ? [l.row.id] : []));
+	return {
+		sources: new Map(sourceRows.map(([key, l]) => [key, describeSource(l, bindings)])),
+		targets: new Map(targetRows.map(([key, l]) => [key, describeTarget(l, bindings)]))
+	};
+}
+//#endregion
+export { normalizedNativeOwner as n, describeCompositionSources as t };