@orkestrel/scaffold 0.0.84 → 0.0.86

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.84",
+	version: "0.0.86",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -7361,6 +7361,185 @@ function replaceManifestRanges(manifest, pins) {
 	return declaredRuntime && declaredDevelopment ? compiled : void 0;
 }
 /**
+* Inserts dependencies a package manifest does not declare into the section each one names.
+*
+* @param manifest - The manifest text to compile.
+* @param additions - The runtime and development names and ranges to declare.
+* @returns The manifest declaring every addition, or `undefined` when the text is not a
+* manifest, an addition's section is not an object or holds a value that is not a range, a name
+* is repeated, or `dependencies` or `devDependencies` already declares a name.
+*
+* @remarks
+* Runtime additions enter `dependencies` and development additions enter `devDependencies`. The
+* compiler inserts text instead of serializing the manifest, so every declared byte survives.
+* Each addition lands before the first declared key that sorts after it, or after the last
+* declared key when none does, so a section kept in key order stays in key order. An addition
+* copies the indentation of the section's first entry; an empty section takes its entries one
+* level inside the indentation of its opening line. An absent section is created as one
+* top-level key holding its additions: `devDependencies` after `dependencies`, `dependencies`
+* before `devDependencies`, and either one last in the manifest object when its sibling is
+* absent. The created key copies the indentation of the manifest's first key, and its entries sit
+* one level further in. A name either writable section already declares is the caller's mistake
+* rather than an addition, so the compiler refuses it instead of declaring a package twice.
+*
+* @example
+* ```ts
+* import { insertManifestDependencies } from '@orkestrel/scaffold'
+*
+* insertManifestDependencies('{\n\t"devDependencies": {\n\t\t"vite": "^8.3.2"\n\t}\n}\n', {
+*   runtime: [],
+*   development: [{ name: 'typescript', range: '^6.0.3' }],
+* })
+* // '{\n\t"devDependencies": {\n\t\t"typescript": "^6.0.3",\n\t\t"vite": "^8.3.2"\n\t}\n}\n'
+* ```
+*/
+function insertManifestDependencies(manifest, additions) {
+	const requested = [...additions.runtime, ...additions.development];
+	if (requested.length === 0) return manifest;
+	const parsed = (0, _orkestrel_contract.parseJSON)(manifest);
+	if (!(0, _orkestrel_contract.isRecord)(parsed)) return void 0;
+	const declared = /* @__PURE__ */ new Set();
+	for (const section of ["dependencies", "devDependencies"]) {
+		const entries = parsed[section];
+		if ((0, _orkestrel_contract.isRecord)(entries)) for (const name of Object.keys(entries)) declared.add(name);
+	}
+	const names = new Set(requested.map(({ name }) => name));
+	if (names.size !== requested.length || [...names].some((name) => declared.has(name))) return;
+	let compiled = manifest;
+	const sections = [{
+		name: "dependencies",
+		dependencies: additions.runtime
+	}, {
+		name: "devDependencies",
+		dependencies: additions.development
+	}];
+	for (const section of sections) {
+		if (section.dependencies.length === 0) continue;
+		const entries = parsed[section.name];
+		if (entries !== void 0 && (!(0, _orkestrel_contract.isRecord)(entries) || !Object.values(entries).every(_orkestrel_contract.isString))) return;
+		const ordered = [...section.dependencies].sort((left, right) => (0, _orkestrel_contract.compareValues)(left.name, right.name));
+		const lines = ordered.map(({ name, range }) => `${JSON.stringify(name)}: ${JSON.stringify(range)}`);
+		const sibling = section.name === "dependencies" ? "devDependencies" : "dependencies";
+		const located = /* @__PURE__ */ new Map();
+		let current;
+		let head = -1;
+		let root = -1;
+		let depth = 0;
+		let cursor = 0;
+		while (cursor < compiled.length && root < 0) {
+			const character = compiled.charAt(cursor);
+			if (character === "\"") {
+				const start = cursor;
+				let quote = cursor + 1;
+				while (quote < compiled.length && compiled.charAt(quote) !== "\"") quote += compiled.charAt(quote) === "\\" ? 2 : 1;
+				if (quote >= compiled.length) return void 0;
+				let colon = quote + 1;
+				while (/\s/u.test(compiled.charAt(colon))) colon += 1;
+				cursor = quote + 1;
+				if (depth !== 1 || compiled.charAt(colon) !== ":") continue;
+				if (head < 0) head = start;
+				const name = (0, _orkestrel_contract.parseJSON)(compiled.slice(start, quote + 1));
+				if (!(0, _orkestrel_contract.isString)(name) || name !== section.name && name !== sibling) continue;
+				if (located.has(name)) continue;
+				let brace = colon + 1;
+				while (/\s/u.test(compiled.charAt(brace))) brace += 1;
+				if (compiled.charAt(brace) !== "{") {
+					if (name === section.name) return void 0;
+					continue;
+				}
+				current = {
+					name,
+					start,
+					open: brace
+				};
+				depth += 1;
+				cursor = brace + 1;
+				continue;
+			}
+			if (character === "{") depth += 1;
+			else if (character === "}") {
+				depth -= 1;
+				if (depth === 1 && current !== void 0) {
+					located.set(current.name, {
+						...current,
+						close: cursor
+					});
+					current = void 0;
+				}
+				if (depth === 0) root = cursor;
+			}
+			cursor += 1;
+		}
+		const bounds = located.get(section.name);
+		if (bounds === void 0) {
+			if (entries !== void 0 || root < 0) return void 0;
+			const breaking = head < 0 ? -1 : compiled.lastIndexOf("\n", head);
+			const margin = breaking < 0 ? "" : compiled.slice(breaking + 1, head);
+			const gap = breaking < 0 || /\S/u.test(margin) ? "" : `\n${margin}`;
+			const block = `${JSON.stringify(section.name)}: {${lines.map((line) => `${gap === "" ? "" : `${gap}${margin}`}${line}`).join(",")}${gap}}`;
+			const neighbor = located.get(sibling);
+			let tail = root - 1;
+			while (tail > 0 && /\s/u.test(compiled.charAt(tail))) tail -= 1;
+			const [position, insertion] = neighbor === void 0 ? [tail + 1, compiled.charAt(tail) === "{" ? block : `,${gap}${block}`] : section.name === "devDependencies" ? [neighbor.close + 1, `,${gap}${block}`] : [neighbor.start, `${block},${gap}`];
+			compiled = compiled.slice(0, position) + insertion + compiled.slice(position);
+			continue;
+		}
+		const { open, close } = bounds;
+		const declarations = [];
+		let key;
+		let scan = open + 1;
+		while (scan < close) {
+			if (compiled.charAt(scan) !== "\"") {
+				scan += 1;
+				continue;
+			}
+			let quote = scan + 1;
+			while (quote < close && compiled.charAt(quote) !== "\"") quote += compiled.charAt(quote) === "\\" ? 2 : 1;
+			if (quote >= close) return void 0;
+			if (key === void 0) {
+				const name = (0, _orkestrel_contract.parseJSON)(compiled.slice(scan, quote + 1));
+				if (!(0, _orkestrel_contract.isString)(name)) return void 0;
+				key = {
+					name,
+					start: scan
+				};
+			} else {
+				declarations.push({
+					...key,
+					end: quote + 1
+				});
+				key = void 0;
+			}
+			scan = quote + 1;
+		}
+		const first = declarations[0];
+		const last = declarations.at(-1);
+		const edits = /* @__PURE__ */ new Map();
+		if (first === void 0 || last === void 0) {
+			const opening = compiled.lastIndexOf("\n", open);
+			let column = opening + 1;
+			while (column < open && /\s/u.test(compiled.charAt(column))) column += 1;
+			const level = opening < 0 ? "" : compiled.slice(opening + 1, column);
+			const separator = opening < 0 ? "" : `\n${level}${level}`;
+			const ending = opening < 0 ? "" : `\n${level}`;
+			compiled = `${compiled.slice(0, open + 1)}${lines.map((line) => `${separator}${line}`).join(",")}${ending}${compiled.slice(close)}`;
+			continue;
+		}
+		const newline = compiled.lastIndexOf("\n", first.start);
+		const indent = newline < 0 ? "" : compiled.slice(newline + 1, first.start);
+		const separator = newline < 0 || /\S/u.test(indent) ? "" : `\n${indent}`;
+		for (const [index, dependency] of ordered.entries()) {
+			const line = lines[index] ?? "";
+			const anchor = declarations.find((declaration) => (0, _orkestrel_contract.compareValues)(declaration.name, dependency.name) > 0);
+			const position = anchor?.start ?? last.end;
+			const text = anchor === void 0 ? `,${separator}${line}` : `${line},${separator}`;
+			edits.set(position, `${edits.get(position) ?? ""}${text}`);
+		}
+		for (const [position, text] of [...edits].sort(([left], [right]) => right - left)) compiled = compiled.slice(0, position) + text + compiled.slice(position);
+	}
+	return compiled;
+}
+/**
 * Replaces named script values in package manifest text.
 *
 * @param manifest - The manifest text to compile.
@@ -8570,6 +8749,7 @@ exports.extractRangeMajor = extractRangeMajor;
 exports.extractVersion = extractVersion;
 exports.inferDrift = inferDrift;
 exports.inferGroup = inferGroup;
+exports.insertManifestDependencies = insertManifestDependencies;
 exports.isArtifact = isArtifact;
 exports.isAudit = isAudit;
 exports.isBlueprint = isBlueprint;