@orkestrel/scaffold 0.0.41 → 0.0.42

package/dist/src/core/index.d.cts

@@ -233,8 +233,9 @@ export declare const BIN_ENTRY_PATH = "src/bin/main.ts";
  * `src` selects published library environments and `app` selects private
  * runtime environments. The two axes are independent, so library-only,
  * application-only, and mixed workspaces are all first class. `dependencies`
- * and `peers` are runtime `@orkestrel/*` packages; `extras` are
- * package-specific development dependencies and may carry any valid npm name.
+ * are runtime `@orkestrel/*` packages. A peer in the `@orkestrel` scope is a
+ * fleet pin; every other peer is a floor. `extras` are package-specific
+ * development dependencies and may carry any valid npm name.
  * `bin`, `setup`, `guides`, `distribution`, `integration`, `conformance`,
  * `service`, `vendors`, `global`, and `showcase` are structural facts: each is
  * set only when the workspace physically ships the directory or exact-case file
@@ -303,7 +304,10 @@ export declare function blueprintToConfigArtifacts(blueprint: Blueprint): readon
  * each declared axis adds the set its host needs. A declared extra or peer is
  * applied after those, so a workspace that pins a range for a package the
  * conditional sets also name gets the range it declared. An extra that restates
- * a shared toolchain pin never reaches here, because the gate refuses it.
+ * a shared toolchain pin never reaches here, because the gate refuses it. A peer
+ * that names a development tool already selected keeps that tool's pin, because
+ * the peer's floor states what consumers may supply rather than what this workspace
+ * develops against.
  *
  * A peer is declared here as well as under `peerDependencies`, because a peer is
  * not installed by the workspace that declares it and developing against one
@@ -1200,11 +1204,11 @@ export declare class Compiler implements CompilerInterface {
          * range, in list order.
          *
          * @remarks
-         * The three declared lists differ only in the two syntaxes they accept, so the
-         * rules live here once and each caller supplies its own patterns. A runtime
-         * dependency name reaches a path through its guide mirror and is fixed to the
-         * `@orkestrel` scope; a development extra never reaches a path and admits any
-         * valid npm name.
+         * The declared lists and peer partitions differ only in the two syntaxes they
+         * accept, so the rules live here once and each caller supplies its own patterns.
+         * A runtime dependency name reaches a path through its guide mirror and is
+         * fixed to the `@orkestrel` scope. A foreign peer or development extra reaches
+         * no path and admits any valid npm name.
          *
          * Both patterns must be stateless. A global or sticky pattern carries a
          * `lastIndex` between calls, so it would answer differently for the same input
@@ -1294,18 +1298,6 @@ export declare class Compiler implements CompilerInterface {
          */
         export declare const EXECUTABLE_PATHS: readonly string[];
 
-        /**
-         * The development extra name syntax: any valid npm package name.
-         *
-         * @remarks
-         * Wider than a runtime dependency name on purpose. An extra is manifest content
-         * and never reaches a path, so it may carry any scope or no scope at all. The
-         * single optional `/` is still fixed to the one scope boundary, and neither `..`
-         * nor a backslash is admitted, so the shape cannot express a traversal even
-         * though it accepts far more names.
-         */
-        export declare const EXTRA_NAME_PATTERN: RegExp;
-
         /** The registry-only semver subset accepted for a development extra's range. */
         export declare const EXTRA_RANGE_PATTERN: RegExp;
 
@@ -1386,6 +1378,28 @@ export declare class Compiler implements CompilerInterface {
             readonly observed?: string;
         };
 
+        /**
+         * The exact three-component floor accepted for a foreign peer's range.
+         *
+         * @remarks
+         * This is independent from {@link ENGINES_PATTERN}. An engine floors the Node
+         * runtime a workspace supports, while a peer floors a tool the consumer
+         * supplies. Either obligation may change without changing the other.
+         */
+        export declare const FLOOR_RANGE_PATTERN: RegExp;
+
+        /**
+         * The package name syntax for a dependency this package does not publish.
+         *
+         * @remarks
+         * A foreign package is one this package does not publish, so its name reaches
+         * no path. It may carry any scope or no scope at all. Each name segment begins
+         * with an alphanumeric character after an optional leading `@`, and the name
+         * carries at most one `/`. No segment can therefore be `..`, and no backslash
+         * is admitted, so the shape cannot express a traversal.
+         */
+        export declare const FOREIGN_NAME_PATTERN: RegExp;
+
         /** The shared Vitest global-setup module whose presence makes a workspace `global`. */
         export declare const GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
 

package/dist/src/core/index.d.ts

@@ -233,8 +233,9 @@ export declare const BIN_ENTRY_PATH = "src/bin/main.ts";
  * `src` selects published library environments and `app` selects private
  * runtime environments. The two axes are independent, so library-only,
  * application-only, and mixed workspaces are all first class. `dependencies`
- * and `peers` are runtime `@orkestrel/*` packages; `extras` are
- * package-specific development dependencies and may carry any valid npm name.
+ * are runtime `@orkestrel/*` packages. A peer in the `@orkestrel` scope is a
+ * fleet pin; every other peer is a floor. `extras` are package-specific
+ * development dependencies and may carry any valid npm name.
  * `bin`, `setup`, `guides`, `distribution`, `integration`, `conformance`,
  * `service`, `vendors`, `global`, and `showcase` are structural facts: each is
  * set only when the workspace physically ships the directory or exact-case file
@@ -303,7 +304,10 @@ export declare function blueprintToConfigArtifacts(blueprint: Blueprint): readon
  * each declared axis adds the set its host needs. A declared extra or peer is
  * applied after those, so a workspace that pins a range for a package the
  * conditional sets also name gets the range it declared. An extra that restates
- * a shared toolchain pin never reaches here, because the gate refuses it.
+ * a shared toolchain pin never reaches here, because the gate refuses it. A peer
+ * that names a development tool already selected keeps that tool's pin, because
+ * the peer's floor states what consumers may supply rather than what this workspace
+ * develops against.
  *
  * A peer is declared here as well as under `peerDependencies`, because a peer is
  * not installed by the workspace that declares it and developing against one
@@ -1200,11 +1204,11 @@ export declare class Compiler implements CompilerInterface {
          * range, in list order.
          *
          * @remarks
-         * The three declared lists differ only in the two syntaxes they accept, so the
-         * rules live here once and each caller supplies its own patterns. A runtime
-         * dependency name reaches a path through its guide mirror and is fixed to the
-         * `@orkestrel` scope; a development extra never reaches a path and admits any
-         * valid npm name.
+         * The declared lists and peer partitions differ only in the two syntaxes they
+         * accept, so the rules live here once and each caller supplies its own patterns.
+         * A runtime dependency name reaches a path through its guide mirror and is
+         * fixed to the `@orkestrel` scope. A foreign peer or development extra reaches
+         * no path and admits any valid npm name.
          *
          * Both patterns must be stateless. A global or sticky pattern carries a
          * `lastIndex` between calls, so it would answer differently for the same input
@@ -1294,18 +1298,6 @@ export declare class Compiler implements CompilerInterface {
          */
         export declare const EXECUTABLE_PATHS: readonly string[];
 
-        /**
-         * The development extra name syntax: any valid npm package name.
-         *
-         * @remarks
-         * Wider than a runtime dependency name on purpose. An extra is manifest content
-         * and never reaches a path, so it may carry any scope or no scope at all. The
-         * single optional `/` is still fixed to the one scope boundary, and neither `..`
-         * nor a backslash is admitted, so the shape cannot express a traversal even
-         * though it accepts far more names.
-         */
-        export declare const EXTRA_NAME_PATTERN: RegExp;
-
         /** The registry-only semver subset accepted for a development extra's range. */
         export declare const EXTRA_RANGE_PATTERN: RegExp;
 
@@ -1386,6 +1378,28 @@ export declare class Compiler implements CompilerInterface {
             readonly observed?: string;
         };
 
+        /**
+         * The exact three-component floor accepted for a foreign peer's range.
+         *
+         * @remarks
+         * This is independent from {@link ENGINES_PATTERN}. An engine floors the Node
+         * runtime a workspace supports, while a peer floors a tool the consumer
+         * supplies. Either obligation may change without changing the other.
+         */
+        export declare const FLOOR_RANGE_PATTERN: RegExp;
+
+        /**
+         * The package name syntax for a dependency this package does not publish.
+         *
+         * @remarks
+         * A foreign package is one this package does not publish, so its name reaches
+         * no path. It may carry any scope or no scope at all. Each name segment begins
+         * with an alphanumeric character after an optional leading `@`, and the name
+         * carries at most one `/`. No segment can therefore be `..`, and no backslash
+         * is admitted, so the shape cannot express a traversal.
+         */
+        export declare const FOREIGN_NAME_PATTERN: RegExp;
+
         /** The shared Vitest global-setup module whose presence makes a workspace `global`. */
         export declare const GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
 

package/dist/src/core/index.js

@@ -234,16 +234,16 @@ var NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
 */
 var DEPENDENCY_NAME_PATTERN = /^@orkestrel\/[a-z][a-z0-9-]*$/;
 /**
-* The development extra name syntax: any valid npm package name.
+* The package name syntax for a dependency this package does not publish.
 *
 * @remarks
-* Wider than a runtime dependency name on purpose. An extra is manifest content
-* and never reaches a path, so it may carry any scope or no scope at all. The
-* single optional `/` is still fixed to the one scope boundary, and neither `..`
-* nor a backslash is admitted, so the shape cannot express a traversal even
-* though it accepts far more names.
+* A foreign package is one this package does not publish, so its name reaches
+* no path. It may carry any scope or no scope at all. Each name segment begins
+* with an alphanumeric character after an optional leading `@`, and the name
+* carries at most one `/`. No segment can therefore be `..`, and no backslash
+* is admitted, so the shape cannot express a traversal.
 */
-var EXTRA_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+var FOREIGN_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
 /** The exact three-component version syntax a blueprint declares. */
 var VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 /**
@@ -258,6 +258,15 @@ var VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 var ORKESTREL_RANGE_PATTERN = /^\^0\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 /** The registry-only semver subset accepted for a development extra's range. */
 var EXTRA_RANGE_PATTERN = /^(?:\^|~)?(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?$/;
+/**
+* The exact three-component floor accepted for a foreign peer's range.
+*
+* @remarks
+* This is independent from {@link ENGINES_PATTERN}. An engine floors the Node
+* runtime a workspace supports, while a peer floors a tool the consumer
+* supplies. Either obligation may change without changing the other.
+*/
+var FLOOR_RANGE_PATTERN = /^>=(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 /** The minimum-Node engine syntax a blueprint declares. */
 var ENGINES_PATTERN = /^>=(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 /** Exact lowercase hexadecimal bytes: two digits per byte, and empty content is valid. */
@@ -3016,7 +3025,10 @@ function srcToExports(src) {
 * each declared axis adds the set its host needs. A declared extra or peer is
 * applied after those, so a workspace that pins a range for a package the
 * conditional sets also name gets the range it declared. An extra that restates
-* a shared toolchain pin never reaches here, because the gate refuses it.
+* a shared toolchain pin never reaches here, because the gate refuses it. A peer
+* that names a development tool already selected keeps that tool's pin, because
+* the peer's floor states what consumers may supply rather than what this workspace
+* develops against.
 *
 * A peer is declared here as well as under `peerDependencies`, because a peer is
 * not installed by the workspace that declares it and developing against one
@@ -3049,7 +3061,7 @@ function blueprintToDevDependencies(blueprint) {
 		...blueprint.app.includes("server") ? APP_SERVER_DEV_DEPENDENCIES : {}
 	};
 	for (const extra of blueprint.extras) merged[extra.name] = extra.range;
-	for (const peer of blueprint.peers) merged[peer.name] = peer.range;
+	for (const peer of blueprint.peers) if (!Object.hasOwn(merged, peer.name)) merged[peer.name] = peer.range;
 	const own = blueprint.src.length > 0 ? `@orkestrel/${blueprint.name}` : blueprint.name;
 	const runtime = new Set(blueprint.dependencies.map((dependency) => dependency.name));
 	return Object.fromEntries(Object.entries(merged).filter(([name]) => name !== own && !runtime.has(name)).sort(([left], [right]) => compareValues(left, right)));
@@ -4138,11 +4150,11 @@ function planToFindings(plan, current) {
 * range, in list order.
 *
 * @remarks
-* The three declared lists differ only in the two syntaxes they accept, so the
-* rules live here once and each caller supplies its own patterns. A runtime
-* dependency name reaches a path through its guide mirror and is fixed to the
-* `@orkestrel` scope; a development extra never reaches a path and admits any
-* valid npm name.
+* The declared lists and peer partitions differ only in the two syntaxes they
+* accept, so the rules live here once and each caller supplies its own patterns.
+* A runtime dependency name reaches a path through its guide mirror and is
+* fixed to the `@orkestrel` scope. A foreign peer or development extra reaches
+* no path and admits any valid npm name.
 *
 * Both patterns must be stateless. A global or sticky pattern carries a
 * `lastIndex` between calls, so it would answer differently for the same input
@@ -4300,7 +4312,7 @@ function blueprintToQuestions(blueprint) {
 		message: "showcase projects a browser app, and this workspace declares none, so it emits nothing.",
 		blocking: false
 	});
-	questions.push(...dependenciesToQuestions(blueprint.dependencies, "dependencies", DEPENDENCY_NAME_PATTERN, ORKESTREL_RANGE_PATTERN), ...dependenciesToQuestions(blueprint.peers, "peers", DEPENDENCY_NAME_PATTERN, ORKESTREL_RANGE_PATTERN), ...dependenciesToQuestions(blueprint.extras, "extras", EXTRA_NAME_PATTERN, EXTRA_RANGE_PATTERN));
+	questions.push(...dependenciesToQuestions(blueprint.dependencies, "dependencies", DEPENDENCY_NAME_PATTERN, ORKESTREL_RANGE_PATTERN), ...dependenciesToQuestions(blueprint.peers.filter((peer) => peer.name.startsWith("@orkestrel/")), "peers", DEPENDENCY_NAME_PATTERN, ORKESTREL_RANGE_PATTERN), ...dependenciesToQuestions(blueprint.peers.filter((peer) => !peer.name.startsWith("@orkestrel/")), "peers", FOREIGN_NAME_PATTERN, FLOOR_RANGE_PATTERN), ...dependenciesToQuestions(blueprint.extras, "extras", FOREIGN_NAME_PATTERN, EXTRA_RANGE_PATTERN));
 	const lists = [
 		["dependencies", blueprint.dependencies],
 		["peers", blueprint.peers],
@@ -4835,6 +4847,6 @@ function createCompiler(options) {
 	return new Compiler(options);
 }
 //#endregion
-export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_NAME_PATTERN, EXTRA_RANGE_PATTERN, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, ScaffoldError, TAB_WIDTH, VERSION_PATTERN, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToGuideArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSourceArtifacts, blueprintToTestArtifacts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, createCompiler, dependenciesToQuestions, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDependency, isDependencyName, isEnvironment, isFinding, isGroup, isGroups, isHex, isMirror, isOverride, isPath, isPlan, isQuestion, isScaffoldError, isSnapshot, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, nameToHostArtifacts, nameToRewrite, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
+export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, ScaffoldError, TAB_WIDTH, VERSION_PATTERN, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToGuideArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSourceArtifacts, blueprintToTestArtifacts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, createCompiler, dependenciesToQuestions, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDependency, isDependencyName, isEnvironment, isFinding, isGroup, isGroups, isHex, isMirror, isOverride, isPath, isPlan, isQuestion, isScaffoldError, isSnapshot, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, nameToHostArtifacts, nameToRewrite, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
 
 //# sourceMappingURL=index.js.map