@orkestrel/scaffold 0.0.85 → 0.0.86

package/dist/src/server/index.cjs

@@ -2145,7 +2145,8 @@ var isDependencies = (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0,
 * @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.
+* Each region is bounded by the same collection law its own list guard applies,
+* and `additions` is the one region a caller may omit.
 *
 * @example
 * ```ts
@@ -2153,6 +2154,11 @@ var isDependencies = (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0,
 *
 * isManifestRegionSet({ pins: { runtime: [], development: [] }, scripts: [] }) // true
 * isManifestRegionSet({ pins: { runtime: [], development: [] } }) // false
+* isManifestRegionSet({
+*   pins: { runtime: [], development: [] },
+*   scripts: [],
+*   additions: { runtime: [], development: [{ name: 'typescript', range: '^6.0.3' }] },
+* }) // true
 * ```
 */
 var isManifestRegionSet = (0, _orkestrel_contract.recordOf)({
@@ -2160,8 +2166,12 @@ var isManifestRegionSet = (0, _orkestrel_contract.recordOf)({
 		runtime: isDependencies,
 		development: isDependencies
 	}),
-	scripts: (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0, _orkestrel_contract.arrayOf)(_src_core.isManifestScript))
-});
+	scripts: (0, _orkestrel_contract.andOf)(_src_core.isCollection, (0, _orkestrel_contract.arrayOf)(_src_core.isManifestScript)),
+	additions: (0, _orkestrel_contract.recordOf)({
+		runtime: isDependencies,
+		development: isDependencies
+	})
+}, ["additions"]);
 /** Narrows 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));
 /** Narrows a value to a bounded list of fleet catalog rows. */
@@ -3153,11 +3163,13 @@ var Materializer = class {
 	/**
 	* Rewrites the manifest regions the caller names in the target's manifest.
 	*
-	* @param regions - The dependency ranges and script values the manifest must declare.
+	* @param regions - The dependency ranges, script values, and additions the manifest must declare.
 	* @param target - The directory to write into.
 	* @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
+	* exact shape, names a range the manifest does not declare, or names an
+	* addition the manifest already declares or whose section is not an object
+	* of version strings, `TARGET` when
 	* the manifest is unreadable, `WRITE` when the write cannot be staged or
 	* committed, and `DESTROYED` after teardown.
 	*
@@ -3165,7 +3177,10 @@ var Materializer = class {
 	* 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.
+	* undeclared pin is refused instead of inserted. An undeclared package enters
+	* the manifest only through `additions`, which inserts it into the section its
+	* list names in key order, creating that section when the manifest lacks it,
+	* before the ranges are rewritten.
 	*
 	* The regions refuse differently because their targets differ. A range
 	* the manifest does not declare is the caller's mistake and throws. A script
@@ -3769,7 +3784,16 @@ var Materializer = class {
 	}
 	#redeclare(regions) {
 		return (text) => {
-			const manifest = (0, _src_core.replaceManifestRanges)(text, regions.pins);
+			const additions = regions.additions ?? {
+				runtime: [],
+				development: []
+			};
+			const declared = (0, _src_core.insertManifestDependencies)(text, additions);
+			if (declared === void 0) {
+				const names = [...additions.runtime, ...additions.development].map(({ name }) => name);
+				throw this.#error("INVALID", `The manifest cannot declare ${names.join(", ")}: it already declares one of them, or the section that receives them is not an object of version strings.`, { names: names.length });
+			}
+			const manifest = (0, _src_core.replaceManifestRanges)(declared, 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 });