yugoo-design 0.1.2 → 0.2.0

package/payload/shared/scripts/{studio-instance-composition-ClAJ72-M.mjs → studio-instance-composition-BJzYMyvV.mjs}

@@ -1,8 +1,8 @@
-import { dt as parseFrontmatter, ft as parseKitMounts, jt as require_dist, lt as loadDesignBundle, pt as parseMindsetSkillNames, ut as loadDesignKit } from "./core-entry-B6zaTh1o.mjs";
-import { t as finalizeStudioPanelPreview } from "./panel-preview-CPGv8nTe.mjs";
+import { Pt as require_dist, ft as loadDesignBundle, gt as parseMindsetSkillNames, ht as parseKitMounts, mt as parseFrontmatter, pt as loadDesignKit } from "./core-entry-DESmwP78.mjs";
+import { t as finalizeStudioPanelPreview } from "./panel-preview-BeVRYFk1.mjs";
 import { isAbsolute, relative, resolve, sep } from "node:path";
 import { randomUUID } from "node:crypto";
-//#region packages/companion/src/studio-instance-composition.mjs
+//#region packages/studio/src/node/studio-instance-composition.mjs
 /** Core-backed Studio adapters over trusted captures; no filesystem, installation or execution port. */
 var import_dist = require_dist();
 const MAX_TREE_BYTES = 16777216;
@@ -16,7 +16,7 @@ const pinOf = (value) => {
 		version: value.version
 	};
 };
-const samePin = (a, b) => a.name === b.name && a.version === b.version;
+const samePin = (a, b) => a.name === b.name;
 const sourceIdOf = (value) => {
 	if (typeof value !== "string" || !value || value.length > 4096 || /[\u0000-\u001f\u007f]/u.test(value)) throw new Error("Trusted Bundle source identity is required.");
 	return value;
@@ -117,11 +117,41 @@ function scalarEdit(source, key, value, allowInsert = false) {
 	const indent = source.slice(start, first.range[0]), newline = source.includes("\r\n") ? "\r\n" : "\n";
 	return source.slice(0, start) + `${indent}${key}: ${encoded}${newline}` + source.slice(start);
 }
-async function projectMindset(source, kit, mounts, describeBundle) {
+function projectRelationIdentifiers(source, from, to) {
+	if (from === to || !source.trim()) return source;
+	const document = (0, import_dist.parseDocument)(source);
+	if (document.errors.length || !(0, import_dist.isMap)(document.contents)) throw new Error("Studio cannot project malformed relations.yaml.");
+	const relations = document.get("relations", true), edits = [];
+	const rebase = (node, separator) => {
+		if (!(0, import_dist.isScalar)(node) || typeof node.value !== "string" || !node.range || !node.value.startsWith(`${from}${separator}`)) return;
+		edits.push({
+			start: node.range[0],
+			end: node.range[1],
+			value: JSON.stringify(to + node.value.slice(from.length))
+		});
+	};
+	if ((0, import_dist.isSeq)(relations)) for (const relation of relations.items) {
+		if (!(0, import_dist.isMap)(relation)) continue;
+		for (const key of [
+			"type",
+			"meaning",
+			"inverse"
+		]) rebase(relation.get(key, true), ":");
+		for (const key of ["domain", "range"]) {
+			const values = relation.get(key, true);
+			if ((0, import_dist.isSeq)(values)) for (const value of values.items) rebase(value, "/");
+		}
+	}
+	for (const edit of edits.sort((a, b) => b.start - a.start)) source = source.slice(0, edit.start) + edit.value + source.slice(edit.end);
+	return source;
+}
+async function projectMindset(source, kit, mounts, describeBundle, allowEmptyDraft = false) {
 	const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
 	if (!match) throw new Error("Kit Mindset requires explicit YAML frontmatter.");
 	const parsed = parseFrontmatter(source, "mindset.md");
-	parseMindsetSkillNames(parsed.body, String(parsed.meta.name));
+	const catalogs = [...parsed.body.matchAll(/<design_skills>\s*([\s\S]*?)\s*<\/design_skills>/g)];
+	const emptyDraft = allowEmptyDraft && catalogs.length === 1 && catalogs[0][1].trim() === "";
+	if (!emptyDraft) parseMindsetSkillNames(parsed.body, String(parsed.meta.name));
 	let frontmatter = scalarEdit(match[1], "name", kit.name);
 	frontmatter = scalarEdit(frontmatter, "version", kit.version);
 	const frontStart = source.indexOf(match[1]), frontEnd = frontStart + match[1].length;
@@ -132,7 +162,7 @@ async function projectMindset(source, kit, mounts, describeBundle) {
 	const start = marker + 15;
 	const end = renamed.indexOf("</design_skills>", start);
 	const block = renamed.slice(start, end), headings = [...block.matchAll(/^##\s+(.+?)\s*$/gm)];
-	if (end < start || headings.length === 0) throw new Error("Mindset generated Bundle catalog is empty or malformed.");
+	if (end < start || headings.length === 0 && !emptyDraft) throw new Error("Mindset generated Bundle catalog is empty or malformed.");
 	const sections = new Map(headings.map((heading, index) => [heading[1], block.slice(heading.index, headings[index + 1]?.index ?? block.length)]));
 	const newline = renamed.includes("\r\n") ? "\r\n" : "\n";
 	const selected = [];
@@ -143,9 +173,9 @@ async function projectMindset(source, kit, mounts, describeBundle) {
 		const escaped = description.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\n", newline);
 		selected.push(`## ${mount.bindingKey}${newline}${newline}${escaped}${newline}${newline}`);
 	}
-	const generated = block.slice(0, headings[0].index) + selected.join("");
+	const generated = block.slice(0, headings[0]?.index ?? block.length) + selected.join("");
 	const projected = renamed.slice(0, start) + generated + renamed.slice(end);
-	const names = parseMindsetSkillNames(parseFrontmatter(projected, "mindset.md").body, kit.name);
+	const names = allowEmptyDraft && mounts.length === 0 ? [] : parseMindsetSkillNames(parseFrontmatter(projected, "mindset.md").body, kit.name);
 	if (JSON.stringify(names) !== JSON.stringify(mounts.map((mount) => mount.bindingKey))) throw new Error("Generated Mindset catalog differs from Kit mounts.");
 	return projected;
 }
@@ -175,8 +205,9 @@ function createStudioInstanceAdapters(trusted) {
 			source,
 			content: await loadDesignBundle(source.fs, {
 				rootDir: source.root,
-				sourceId: sourceIdOf(sourceId)
-			}, pinOf(expected))
+				sourceId: sourceIdOf(sourceId),
+				current: true
+			}, { name: pinOf(expected).name })
 		};
 	};
 	const compileKit = async ({ kit, kitFiles, mounts, resolveBundle }) => {
@@ -189,9 +220,14 @@ function createStudioInstanceAdapters(trusted) {
 			bindingKey: mount.bindingKey,
 			...pinOf(mount.bundle ?? mount)
 		}));
-		if (JSON.stringify(declared) !== JSON.stringify(selected)) throw new Error("Selected mounts differ from authoritative kit.yaml.");
+		const membership = (mounts) => mounts.map(({ bindingKey, name }) => ({
+			bindingKey,
+			name
+		}));
+		if (JSON.stringify(membership(declared)) !== JSON.stringify(membership(selected))) throw new Error("Selected mounts differ from authoritative kit.yaml.");
 		const loaded = await loadDesignKit(source.fs, source.root, {
 			sourceId: `local:kit:${expected.name}`,
+			current: true,
 			resolveBundle: async (pin) => {
 				if (!declared.some((mount) => samePin(mount, pin))) throw new Error("Core requested an undeclared Bundle.");
 				const capture = await resolveBundle(pin);
@@ -234,7 +270,9 @@ function createStudioInstanceAdapters(trusted) {
 				compiled = retained.content.skill;
 				if (runtimeName !== void 0 && compiled.name !== runtimeName) return failure("preview.bundle_pin", "The retained runtime name does not match the selected Bundle.");
 			} else {
-				const captured = await resolveBundle(bundle);
+				const requested = parseKitMounts(memorySource(kitFiles).text("kit.yaml")).find((mount) => mount.name === bundle.name);
+				if (!requested) return failure("preview.bundle_pin", "The Bundle is outside the Kit declaration.");
+				const captured = await resolveBundle(requested);
 				if (!captured) return failure("preview.bundle_pin", "The retained Bundle source is missing.");
 				const selected = {
 					files: structuredClone(captured.files),
@@ -246,7 +284,7 @@ function createStudioInstanceAdapters(trusted) {
 					kitFiles,
 					mounts,
 					resolveBundle: (pin) => samePin(pin, bundle) ? Promise.resolve(selected) : resolveBundle(pin)
-				})).skills.find((skill) => (skill.catalogName ?? skill.name) === bundle.name && String(skill.version) === bundle.version);
+				})).skills.find((skill) => (skill.catalogName ?? skill.name) === bundle.name);
 				retained = { source: memorySource(selected.files) };
 			}
 			if (!compiled) return failure("preview.bundle_pin", "The source does not match the selected Bundle version.");
@@ -260,10 +298,14 @@ function createStudioInstanceAdapters(trusted) {
 			}
 			return finalizeStudioPanelPreview({
 				compiled,
-				bundle,
+				bundle: {
+					...bundle,
+					version: String(compiled.version)
+				},
 				...kit === void 0 ? {} : { kit },
 				revision,
-				sampleSource: sample
+				sampleSource: sample,
+				readSampleResource: (path) => retained.source.entries.some((file) => file.path === path) ? retained.source.text(path) : void 0
 			});
 		} catch (error) {
 			return failure("preview.definition", error instanceof Error ? error.message : String(error));
@@ -282,7 +324,9 @@ function createStudioInstanceAdapters(trusted) {
 				result.push({
 					...pin,
 					title: captured.title,
-					runtimeName: captured.runtimeName
+					runtimeName: captured.runtimeName,
+					...captured.description === void 0 ? {} : { description: captured.description },
+					...captured.displayDescription === void 0 ? {} : { displayDescription: { ...captured.displayDescription } }
 				});
 			}
 			return result;
@@ -294,7 +338,9 @@ function createStudioInstanceAdapters(trusted) {
 				files: source.entries,
 				sourceId: raw.sourceId,
 				title: { ...content.skill.title },
-				runtimeName: content.skill.name
+				runtimeName: content.skill.name,
+				...typeof content.skill.description === "string" ? { description: content.skill.description } : {},
+				...content.skill.pickerDescription ? { displayDescription: { ...content.skill.pickerDescription } } : {}
 			};
 		},
 		async captureKit(value) {
@@ -314,55 +360,112 @@ function createStudioInstanceAdapters(trusted) {
 			};
 		}
 	};
-	return {
-		catalog,
-		composition: {
-			async forkBundle({ files, from, to, runtimeName }) {
-				from = pinOf(from);
-				to = pinOf(to);
-				if (to.name === from.name || to.version !== from.version) throw new Error("A fork requires a new catalog identity and preserves its source version.");
-				const before = await loadBundle(files, `studio:fork-source:${from.name}`, from);
-				if (before.content.skill.name !== runtimeName) throw new Error("Fork runtime name does not match its retained source.");
-				const presentation = before.content.skill.metadata?.skillManifest?.presentation;
-				if (presentation?.mode === "native" || presentation?.mode === "auto" && presentation.renderer && !before.content.skill.metadata?.panelYaml) throw new Error("Native-only Bundles cannot be forked: the new identity has no trusted native renderer authority.");
-				const manifest = scalarEdit(before.source.text("skill.yaml"), "identity", to.name, true);
-				const next = before.source.entries.map((file) => file.path === "skill.yaml" ? entry(file.path, manifest) : file);
-				const after = await loadBundle(next, `local:bundle:${to.name}`, to);
-				if (after.content.skill.name !== runtimeName || after.content.skill.content !== before.content.skill.content) throw new Error("A fork cannot alter the runtime name or Bundle method.");
-				return next;
-			},
-			async projectMounts({ kit, kitFiles, mounts, resolveBundle = (pin) => trusted.captureBundle(pin) }) {
-				kit = pinOf(kit);
-				const declaration = (0, import_dist.stringify)({
-					version: 1,
-					mounts: mounts.map((mount) => ({
-						bindingKey: mount.bindingKey,
-						...pinOf(mount)
-					}))
-				});
-				const normalized = parseKitMounts(declaration), source = memorySource(kitFiles);
-				const budget = {
-					bytes: 0,
-					files: 0
-				};
-				const mindset = await projectMindset(source.text("mindset.md"), kit, normalized, async (mount) => {
+	const composition = {
+		loadKit: compileKit,
+		async forkBundle({ files, from, to, runtimeName }) {
+			from = pinOf(from);
+			to = pinOf(to);
+			if (to.name === from.name || to.version !== from.version) throw new Error("A fork requires a new catalog identity and preserves its source version.");
+			const before = await loadBundle(files, `studio:fork-source:${from.name}`, from);
+			if (before.content.skill.name !== runtimeName) throw new Error("Fork runtime name does not match its retained source.");
+			const presentation = before.content.skill.metadata?.skillManifest?.presentation;
+			if (presentation?.mode === "native" || presentation?.mode === "auto" && presentation.renderer && !before.content.skill.metadata?.panelYaml) throw new Error("Native-only Bundles cannot be forked: the new identity has no trusted native renderer authority.");
+			const manifest = scalarEdit(before.source.text("skill.yaml"), "identity", to.name, true);
+			const next = before.source.entries.map((file) => file.path === "skill.yaml" ? entry(file.path, manifest) : file);
+			const after = await loadBundle(next, `local:bundle:${to.name}`, to);
+			if (after.content.skill.name !== runtimeName || after.content.skill.content !== before.content.skill.content) throw new Error("A fork cannot alter the runtime name or Bundle method.");
+			return next;
+		},
+		async projectMounts({ kit, kitFiles, mounts, allowEmptyDraft = false, resolveBundle = (pin) => trusted.captureBundle(pin) }) {
+			kit = pinOf(kit);
+			const declaration = (0, import_dist.stringify)({
+				version: 1,
+				mounts: mounts.map((mount) => ({
+					bindingKey: mount.bindingKey,
+					...pinOf(mount)
+				}))
+			});
+			const normalized = allowEmptyDraft && mounts.length === 0 ? [] : parseKitMounts(declaration), source = memorySource(kitFiles);
+			const budget = {
+				bytes: 0,
+				files: 0
+			};
+			const originalMindset = source.text("mindset.md");
+			let mindset;
+			try {
+				mindset = await projectMindset(originalMindset, kit, normalized, async (mount) => {
 					const captured = await resolveBundle(pinOf(mount));
 					if (!captured) throw new Error(`Missing exact Bundle ${mount.name}@${mount.version} for catalog projection.`);
 					const loaded = await loadBundle(captured.files, captured.sourceId, mount, budget);
 					if (loaded.content.skill.name !== mount.bindingKey) throw new Error("Bundle bindingKey must preserve the runtime name.");
 					return loaded.content.skill.description;
-				});
-				return [
-					...source.entries.filter((file) => !["kit.yaml", "mindset.md"].includes(file.path)),
-					entry("mindset.md", mindset),
-					entry("kit.yaml", declaration)
-				];
-			},
-			async validateKit(input) {
-				await compileKit(input);
-			},
-			preview: typeof trusted.preview === "function" ? (input) => trusted.preview(input) : previewRetained
-		}
+				}, allowEmptyDraft);
+			} catch (error) {
+				if (!allowEmptyDraft) throw error;
+				return [...composition.projectSourceIdentity({
+					kind: "kit",
+					files: source.entries,
+					identity: kit
+				}).filter((file) => file.path !== "kit.yaml"), entry("kit.yaml", declaration)];
+			}
+			const originalName = String(parseFrontmatter(originalMindset, "mindset.md").meta.name);
+			return [
+				...source.entries.filter((file) => !["kit.yaml", "mindset.md"].includes(file.path)).map((file) => {
+					if (file.path !== "relations.yaml" || originalName === kit.name) return file;
+					source.text(file.path);
+					const text = Buffer.from(file.base64, "base64").toString("utf8");
+					const projected = projectRelationIdentifiers(text, originalName, kit.name);
+					return projected === text ? file : entry(file.path, projected);
+				}),
+				entry("mindset.md", mindset),
+				entry("kit.yaml", declaration)
+			];
+		},
+		projectSourceIdentity({ kind, files, identity }) {
+			const source = memorySource(files);
+			if (kind === "bundle") return source.entries.map((file) => {
+				if (file.path !== "skill.yaml") return file;
+				try {
+					return entry(file.path, scalarEdit(source.text(file.path), "identity", identity.name, true));
+				} catch {
+					return file;
+				}
+			});
+			let originalName;
+			return source.entries.map((file) => {
+				if (file.path !== "mindset.md") return file;
+				try {
+					const text = source.text(file.path), match = /^(?:\uFEFF)?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text);
+					if (!match) return file;
+					originalName = parseFrontmatter(text, "mindset.md").meta.name;
+					let frontmatter = scalarEdit(match[1], "name", identity.name, true);
+					frontmatter = scalarEdit(frontmatter, "version", identity.version, true);
+					const start = text.indexOf(match[1]);
+					return entry(file.path, text.slice(0, start) + frontmatter + text.slice(start + match[1].length));
+				} catch {
+					return file;
+				}
+			}).map((file) => {
+				if (file.path !== "relations.yaml" || typeof originalName !== "string" || originalName === identity.name) return file;
+				try {
+					return entry(file.path, projectRelationIdentifiers(source.text(file.path), originalName, identity.name));
+				} catch {
+					return file;
+				}
+			});
+		},
+		async validateBundle({ bundle, bundleFiles, sourceId, runtimeName }) {
+			const { content } = await loadBundle(bundleFiles, sourceId, bundle);
+			if (content.skill.name !== runtimeName) throw new Error("Bundle runtime name differs from the retained method.");
+		},
+		async validateKit(input) {
+			await compileKit(input);
+		},
+		preview: typeof trusted.preview === "function" ? (input) => trusted.preview(input) : previewRetained
+	};
+	return {
+		catalog,
+		composition
 	};
 }
 //#endregion