@orkestrel/scaffold 0.0.49 → 0.0.50

package/dist/src/server/index.cjs

@@ -292,6 +292,29 @@ var isDependencyNames = (0, _orkestrel_contract.andOf)(_src_core.isCollection, (
 var isPaths = (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0, _orkestrel_contract.arrayOf)(_src_core.isPath));
 /** Narrow a value to a bounded list of declared runtime dependencies. */
 var isDependencies = (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0, _orkestrel_contract.arrayOf)(_src_core.isDependency));
+/**
+* Narrow a value to one {@link ManifestRegionSet}.
+*
+* @remarks
+* The whole closed record a manifest-writing method accepts, so a caller
+* naming a region the writer does not carry is refused before any byte moves.
+* Each region is bounded by the same collection law its own list guard applies.
+*
+* @example
+* ```ts
+* import { isManifestRegionSet } from '@orkestrel/scaffold/server'
+*
+* isManifestRegionSet({ pins: { runtime: [], development: [] }, scripts: [] }) // true
+* isManifestRegionSet({ pins: { runtime: [], development: [] } }) // false
+* ```
+*/
+var isManifestRegionSet = (0, _orkestrel_contract.recordOf)({
+	pins: (0, _orkestrel_contract.recordOf)({
+		runtime: isDependencies,
+		development: isDependencies
+	}),
+	scripts: (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0, _orkestrel_contract.arrayOf)(_src_core.isManifestScript))
+});
 /** Narrow a value to a bounded list of fetched guide mirrors. */
 var isMirrors = (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0, _orkestrel_contract.arrayOf)(_src_core.isMirror));
 /** Narrow a value to a bounded list of fleet catalog rows. */
@@ -2786,26 +2809,32 @@ var Materializer = class Materializer {
 		return this.#rewrite(directory, _src_core.CATALOG_AGENT_PATH, _src_core.MAX_ARTIFACT_BYTES, this.#recatalog(accepted));
 	}
 	/**
-	* Rewrite the declared dependency ranges the caller names in the target's manifest.
+	* Rewrite the manifest regions the caller names in the target's manifest.
 	*
-	* @param dependencies - The names and ranges the manifest must declare.
+	* @param regions - The dependency ranges and script values the manifest must declare.
 	* @param target - The directory to write into.
-	* @returns The manifest path, written when a declared range moved and skipped otherwise.
+	* @returns The manifest path, written when a named region moved and skipped otherwise.
 	* @throws {@link ScaffoldError} coded `INVALID` when an argument is not the
 	* exact shape or names a package the manifest does not declare, `TARGET` when
 	* the manifest is unreadable, `WRITE` when the write cannot be staged or
 	* committed, and `DESTROYED` after teardown.
 	*
 	* @remarks
-	* No other part of the manifest is read back out or rewritten, so a consumer's
-	* own description, keywords, scripts, and formatting survive the call. Only a
-	* range already declared is rewritten: inserting a package would mean
-	* re-serializing the whole manifest, which is exactly the edit this verb
-	* promises not to make, so an undeclared name is refused by name instead.
+	* No other part of the manifest is read back out or rewritten. The method
+	* never reads or writes `peerDependencies` or `peerDependenciesMeta`. Only a
+	* range already declared in its named writable section is rewritten, so an
+	* undeclared name is refused instead of inserted.
+	*
+	* The regions refuse differently because their targets differ. A range
+	* the manifest does not declare is the caller's mistake and throws. A script
+	* holding a value the region does not accept is the workspace author's own
+	* chain, so the script region is skipped without a byte moving and the range
+	* region is still written. The advisory channel reports what the maintainer
+	* must paste.
 	*/
-	declare(dependencies, target) {
+	declare(regions, target) {
 		this.#assertAlive();
-		const accepted = this.#accept(dependencies, isDependencies, "dependencies");
+		const accepted = this.#accept(regions, isManifestRegionSet, "regions");
 		const directory = this.#accept(target, isFilesystemPath, "target");
 		return this.#rewrite(directory, "package.json", _src_core.MAX_MANIFEST_BYTES, this.#redeclare(accepted));
 	}
@@ -3342,12 +3371,14 @@ var Materializer = class Materializer {
 	#cell(note) {
 		return note.replaceAll("|", "\\|").replaceAll(/\s+/gu, " ").trim();
 	}
-	#redeclare(dependencies) {
+	#redeclare(regions) {
 		return (text) => {
-			const manifest = (0, _src_core.replaceManifestRanges)(text, dependencies);
-			if (manifest !== void 0) return manifest;
-			const missing = dependencies.find((dependency) => !text.includes(JSON.stringify(dependency.name)));
-			throw this.#error("INVALID", `The manifest does not declare ${missing?.name ?? "a requested package"}, so its range cannot be rewritten.`, missing === void 0 ? void 0 : { name: missing.name });
+			const manifest = (0, _src_core.replaceManifestRanges)(text, regions.pins);
+			if (manifest === void 0) {
+				const missing = [...regions.pins.runtime, ...regions.pins.development].find((dependency) => !text.includes(JSON.stringify(dependency.name)));
+				throw this.#error("INVALID", `The manifest does not declare ${missing?.name ?? "a requested package"}, so its range cannot be rewritten.`, missing === void 0 ? void 0 : { name: missing.name });
+			}
+			return (0, _src_core.replaceManifestScripts)(manifest, regions.scripts) ?? manifest;
 		};
 	}
 	#finish(result) {
@@ -4140,6 +4171,7 @@ exports.isHost = isHost;
 exports.isHostManifest = isHostManifest;
 exports.isInventory = isInventory;
 exports.isManifestEntry = isManifestEntry;
+exports.isManifestRegionSet = isManifestRegionSet;
 exports.isMaterializerHooks = isMaterializerHooks;
 exports.isMaterializerOptions = isMaterializerOptions;
 exports.isMirrors = isMirrors;