@orkestrel/scaffold 0.0.12 → 0.0.14

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

@@ -2276,7 +2276,7 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare function rootViteConfig(src: readonly Environment[], facts?: ViteFacts): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.12";
+ export declare const SCAFFOLD_RANGE = "^0.0.14";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).

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

@@ -2276,7 +2276,7 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare function rootViteConfig(src: readonly Environment[], facts?: ViteFacts): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.12";
+ export declare const SCAFFOLD_RANGE = "^0.0.14";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).

package/dist/src/core/index.js

@@ -226,7 +226,7 @@ var DEFAULT_VERSION = "0.0.1";
 /** The `engines.node` range the `blueprint` builder fills. */
 var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
-var SCAFFOLD_RANGE = "^0.0.12";
+var SCAFFOLD_RANGE = "^0.0.14";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
@@ -5875,7 +5875,7 @@ ${renderedProjects}
 ${fitsPrintWidth(inlineRegistrations) ? inlineRegistrations : `		[
 ${renderedRegistrations.map((registration) => `			${registration},`).join("\n")}
 		],`}
-		hasChromium,
+		chromiumPath !== undefined,
 		process.argv,
 	),`;
 }
@@ -7252,11 +7252,66 @@ import {
 	fstatSync,
 	lstatSync,
 	openSync,
-	readSync,
+${needsBrowser ? "	readdirSync,\n" : ""}	readSync,
 	realpathSync,
-} from 'node:fs'
-import { dirname, isAbsolute, relative, resolve as resolvePath, sep } from 'node:path'
-${playwrightImports}${vueImports}${needsBrowser ? `\n${CONST_KEYWORD} hasChromium = existsSync(chromium.executablePath())\n` : ""}
+${needsBrowser ? "	statSync,\n" : ""}} from 'node:fs'
+import { ${needsBrowser ? "basename, " : ""}dirname, isAbsolute, relative, resolve as resolvePath, sep } from 'node:path'
+${playwrightImports}${vueImports}${needsBrowser ? `\n/** Chromium executable layouts inside a \`chromium-<revision>\` browsers-directory entry, per platform. */
+${EXPORT_KEYWORD} ${CONST_KEYWORD} CHROMIUM_LAYOUTS = Object.freeze([
+	'chrome-linux/chrome',
+	'chrome-linux64/chrome',
+	'chrome-win/chrome.exe',
+	'chrome-win64/chrome.exe',
+	'chrome-mac/Chromium.app/Contents/MacOS/Chromium',
+	'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium',
+])
+
+/**
+ * Resolve a launchable Chromium executable: the pinned revision when installed,
+ * otherwise a \`chromium\` / \`chromium.exe\` alias or any other \`chromium-*\`
+ * revision under the same Playwright browsers directory. A pinned-revision miss
+ * is not Chromium absence — managed containers ship one usable build (often
+ * behind a revision-agnostic alias) for many Playwright versions.
+ */
+${EXPORT_KEYWORD} function resolveChromium(pinned: string): string | undefined {
+	if (existsSync(pinned)) return pinned
+	let revisionRoot = dirname(pinned)
+	for (;;) {
+		if (/^chromium-\\d+$/.test(basename(revisionRoot))) break
+		const parent = dirname(revisionRoot)
+		if (parent === revisionRoot) return undefined
+		revisionRoot = parent
+	}
+	const browsersRoot = dirname(revisionRoot)
+	for (const alias of ['chromium', 'chromium.exe']) {
+		const candidate = resolvePath(browsersRoot, alias)
+		if (existsSync(candidate) && statSync(candidate).isFile()) return candidate
+	}
+	let entries: readonly string[]
+	try {
+		entries = readdirSync(browsersRoot)
+	} catch {
+		return undefined
+	}
+	const revisions = entries
+		.filter((entry) => /^chromium-\\d+$/.test(entry))
+		.sort((a, b) => Number(b.slice('chromium-'.length)) - Number(a.slice('chromium-'.length)))
+	for (const revision of revisions) {
+		for (const layout of CHROMIUM_LAYOUTS) {
+			const candidate = resolvePath(browsersRoot, revision, layout)
+			if (existsSync(candidate)) return candidate
+		}
+	}
+	return undefined
+}
+
+${CONST_KEYWORD} chromiumPinned = chromium.executablePath()
+${CONST_KEYWORD} chromiumPath = resolveChromium(chromiumPinned)
+${CONST_KEYWORD} chromiumOptions =
+	chromiumPath === undefined || chromiumPath === chromiumPinned
+		? {}
+		: { launchOptions: { executablePath: chromiumPath } }
+` : ""}
 ${EXPORT_KEYWORD} function resolveWorkspacePath(relativePath: string): string {
 	return fileURLToPath(new URL(relativePath, import.meta.url))
 }
@@ -7596,7 +7651,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 						}),
 				browser: {
 					enabled: true,
-					provider: playwright(),
+					provider: playwright(chromiumOptions),
 					instances: [{ browser: 'chromium', headless: true }],
 				},
 				fileParallelism: false,
@@ -7729,7 +7784,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 							}),
 					browser: {
 						enabled: true,
-						provider: playwright(),
+						provider: playwright(chromiumOptions),
 						instances: [{ browser: 'chromium', headless: true }],
 					},
 					fileParallelism: false,
@@ -7895,7 +7950,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 						}),
 				browser: {
 					enabled: true,
-					provider: playwright(),
+					provider: playwright(chromiumOptions),
 					instances: [{ browser: 'chromium', headless: true }],
 				},
 				fileParallelism: false,
@@ -8024,7 +8079,7 @@ ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 			},
 			browser: {
 				enabled: true,
-				provider: playwright(),
+				provider: playwright(chromiumOptions),
 				instances: [{ browser: 'chromium', headless: true }],
 			},
 			fileParallelism: false,
@@ -8597,8 +8652,8 @@ ${EXPORT_KEYWORD} ${FUNCTION_KEYWORD} exportsFor(specifier: string): readonly st
 function testArtifacts(spec, pascal) {
 	const hasBrowser = spec.src.includes("browser") || spec.app.includes("browser");
 	const hasVue = spec.app.includes("browser");
-	const browserPolicySpecifier = hasBrowser ? ", existsSync" : "";
-	const browserPolicyImport = hasBrowser ? "import { chromium } from 'playwright'" : "";
+	const browserPolicySpecifier = hasBrowser ? ", accessSync, constants as FS_CONSTANTS, statSync" : "";
+	const browserPolicyImport = hasBrowser ? "import { chromium } from 'playwright'\nimport { resolveChromium } from '../vite.config.js'" : "";
 	const vuePolicyImport = hasVue ? "import { parse as parseVue } from 'vue/compiler-sfc'" : "";
 	const workspacePolicyAssertion = hasVue ? `expect(
 			inspectCodingWorkspace(process.cwd(), (path, content) => {
@@ -8610,12 +8665,13 @@ function testArtifacts(spec, pascal) {
 			}),
 		).toEqual([])` : "expect(inspectCodingWorkspace(process.cwd())).toEqual([])";
 	const browserPolicyTest = hasBrowser ? `
-	it.skipIf(!existsSync(chromium.executablePath()))(
-		'runs browser suites only when the real Chromium executable is installed',
-		() => {
-			expect(existsSync(chromium.executablePath())).toBe(true)
-		},
-	)` : "";
+	it('resolves Chromium only to a real executable file', () => {
+		const chromiumPath = resolveChromium(chromium.executablePath())
+		if (chromiumPath === undefined) return
+
+		expect(statSync(chromiumPath).isFile()).toBe(true)
+		expect(() => accessSync(chromiumPath, FS_CONSTANTS.X_OK)).not.toThrow()
+	})` : "";
 	const artifacts = [fillArtifact("tests/setup.ts", "tests", "setup", {}), fillArtifact("tests/policy.test.ts", "tests", "policyTest", {
 		browserPolicySpecifier,
 		browserPolicyImport,