@orkestrel/scaffold 0.0.82 → 0.0.84

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.82",
+	version: "0.0.84",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -95,25 +95,26 @@ var package_default = {
 	},
 	dependencies: {
 		"@orkestrel/console": "^0.0.15",
-		"@orkestrel/contract": "^0.0.18",
+		"@orkestrel/contract": "^0.0.19",
 		"@orkestrel/emitter": "^0.0.11",
-		"@orkestrel/markdown": "^0.0.16",
+		"@orkestrel/markdown": "^0.0.17",
 		"@orkestrel/process": "^0.0.14",
 		"@orkestrel/template": "^0.0.9"
 	},
 	devDependencies: {
 		"@microsoft/api-extractor": "^7.59.3",
-		"@orkestrel/guide": "^0.0.21",
-		"@orkestrel/html": "^0.0.11",
+		"@orkestrel/browser": "^0.0.20",
+		"@orkestrel/guide": "^0.0.22",
+		"@orkestrel/html": "^0.0.12",
 		"@orkestrel/probe": "^0.0.19",
 		"@orkestrel/test": "^0.0.24",
-		"@types/node": "^26.6.3",
+		"@types/node": "^26.6.4",
 		"@vitest/browser-playwright": "^4.1.11",
 		"oxfmt": "^0.71.0",
 		"oxlint": "^1.86.0",
 		"playwright": "^1.63.0",
 		"typescript": "^6.0.3",
-		"vite": "^8.3.1",
+		"vite": "^8.3.2",
 		"vitest": "^4.1.11"
 	},
 	engines: { "node": ">=22.18.0" }
@@ -662,6 +663,41 @@ var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 	"@vitest/browser-playwright": package_default.devDependencies["@vitest/browser-playwright"],
 	playwright: package_default.devDependencies.playwright
 });
+/**
+* Names the development dependency a browser or styles surface adds.
+*
+* @remarks
+* The package ships the `browse` binary, an MCP server that drives a rendered page and records
+* journeys, and `.claude/rules/quality.md` § Instruments names its registration.
+* `blueprintToDevDependencies` names the blueprints that receive it, and it withholds the
+* dependency from the workspaces {@link BROWSE_UPSTREAM} lists.
+*/
+var BROWSE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/browser": package_default.devDependencies["@orkestrel/browser"] });
+/**
+* Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen.
+*
+* @remarks
+* A workspace this list names cannot declare `@orkestrel/browser`, because the declaration closes
+* a dependency cycle through the browser package's runtime dependencies. The list is the closure
+* of `dependencies` and `peerDependencies` over the installed manifests, sorted by name, and moves
+* with the `@orkestrel/browser` pin.
+*/
+var BROWSE_UPSTREAM = Object.freeze([
+	"@orkestrel/abort",
+	"@orkestrel/codec",
+	"@orkestrel/contract",
+	"@orkestrel/emitter",
+	"@orkestrel/html",
+	"@orkestrel/markdown",
+	"@orkestrel/mcp",
+	"@orkestrel/process",
+	"@orkestrel/router",
+	"@orkestrel/server",
+	"@orkestrel/sse",
+	"@orkestrel/timeout",
+	"@orkestrel/tool",
+	"@orkestrel/websocket"
+]);
 /** Names the development dependency every private `app` environment adds. */
 var APP_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/contract": package_default.dependencies["@orkestrel/contract"] });
 /** Lists the development dependencies a private browser application adds. */
@@ -2302,7 +2338,7 @@ declare module 'vitest' {
 	}
 }
 `,
-		sheet: `import sheet from '/dist/src/{{name}}/index.css?raw'
+		sheet: `import sheet from '{{root}}dist/src/{{name}}/index.css?raw'
 import { describe, expect, it } from 'vitest'
 import { adoptSheet, readLayerNames } from '{{setup}}'
 
@@ -5635,6 +5671,13 @@ function srcToExports(src) {
 * the peer's floor states what consumers may supply rather than what this workspace
 * develops against.
 *
+* A workspace that renders a surface receives {@link BROWSE_DEV_DEPENDENCIES}: a browser
+* environment on either axis, a sheet, or themes. A framework face counts without a clause of
+* its own, because a face is selected only on an axis that carries a browser environment.
+* A browser setup runtime alone receives nothing, because it renders no surface for `browse`
+* to drive. A workspace {@link BROWSE_UPSTREAM} names receives nothing either, because
+* `@orkestrel/browser` depends on it at runtime and the declaration would close a cycle.
+*
 * 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
 * requires it present. A runtime dependency is the opposite case and is removed:
@@ -5657,8 +5700,11 @@ function srcToExports(src) {
 */
 function blueprintToDevDependencies(blueprint) {
 	const sheets = blueprintToSheets(blueprint).length > 0 || blueprint.themes;
+	const rendered = blueprint.src.includes("browser") || blueprint.app.includes("browser") || sheets;
+	const own = blueprint.src.length > 0 || sheets ? `@orkestrel/${blueprint.name}` : blueprint.name;
 	const merged = {
 		...BASE_DEV_DEPENDENCIES,
+		...rendered && !BROWSE_UPSTREAM.includes(own) ? BROWSE_DEV_DEPENDENCIES : {},
 		...sheets ? STYLES_DEV_DEPENDENCIES : {},
 		...blueprint.src.length > 0 || blueprint.bin ? DECLARATION_DEV_DEPENDENCIES : {},
 		...blueprint.src.includes("browser") || blueprint.setup.includes("browser") || sheets ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
@@ -5670,7 +5716,6 @@ function blueprintToDevDependencies(blueprint) {
 	for (const framework of blueprintToMachinery(blueprint).frameworks) Object.assign(merged, FRAMEWORK_MATRIX[framework].dependencies);
 	for (const extra of blueprint.extras) merged[extra.name] = extra.range;
 	for (const peer of blueprint.peers) if (!Object.hasOwn(merged, peer.name)) merged[peer.name] = peer.range;
-	const own = blueprint.src.length > 0 || sheets ? `@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]) => (0, _orkestrel_contract.compareValues)(left, right)));
 }
@@ -6719,16 +6764,20 @@ function blueprintToTestArtifacts(blueprint) {
 		origin: "template",
 		content: ARTIFACT_TEMPLATES.tests.styles.proof
 	});
-	for (const name of sheets) artifacts.push({
-		path: `tests/src/${name}/index.test.ts`,
-		group: "tests",
-		ownership: "birth",
-		origin: "template",
-		content: (0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.tests.sheet, {
-			name,
-			setup: name === "styles/themes" ? "../../../setupStyles.js" : "../../setupStyles.js"
-		})
-	});
+	for (const name of sheets) {
+		const tests = "../".repeat(name.split("/").length + 1);
+		artifacts.push({
+			path: `tests/src/${name}/index.test.ts`,
+			group: "tests",
+			ownership: "birth",
+			origin: "template",
+			content: (0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.tests.sheet, {
+				name,
+				root: `${tests}../`,
+				setup: `${tests}setupStyles.js`
+			})
+		});
+	}
 	if (blueprintToMachinery(blueprint).browser) artifacts.push({
 		path: "tests/setupBrowser.ts",
 		group: "tests",
@@ -8407,6 +8456,8 @@ exports.AXES = AXES;
 exports.BASE_DEV_DEPENDENCIES = BASE_DEV_DEPENDENCIES;
 exports.BIN_CONFIGS = BIN_CONFIGS;
 exports.BIN_ENTRY_PATH = BIN_ENTRY_PATH;
+exports.BROWSE_DEV_DEPENDENCIES = BROWSE_DEV_DEPENDENCIES;
+exports.BROWSE_UPSTREAM = BROWSE_UPSTREAM;
 exports.CANON_PATHS = CANON_PATHS;
 exports.CATALOG_AGENT_PATH = CATALOG_AGENT_PATH;
 exports.CATALOG_CLOSING_MARKER = CATALOG_CLOSING_MARKER;