@orkestrel/scaffold 0.0.11 → 0.0.13

package/dist/host/guides/src/scaffold.md

@@ -1098,7 +1098,7 @@ along the three `ViteMachinery` axes:
 | Machinery                                                         | Emitted when                         |
 | ----------------------------------------------------------------- | ------------------------------------ |
 | CSS pipeline (`ENVIRONMENT_CSS`, `preprocessCSS`, `isCSSRequest`) | a `src` or `app` browser environment |
-| Playwright provider and `hasChromium`                             | a `src` or `app` browser environment |
+| Playwright provider and `resolveChromium`                         | a `src` or `app` browser environment |
 | Vue plugin, HTML boundary, browser development server             | an `app` browser environment         |
 | Output containment (`outputBoundary`, `enforceOutputPath`)        | anything the workspace builds        |
 

package/dist/src/core/index.cjs

@@ -227,11 +227,11 @@ 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.11";
+var SCAFFOLD_RANGE = "^0.0.12";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
-	"@orkestrel/guide": "^0.0.7",
+	"@orkestrel/guide": "^0.0.8",
 	"@orkestrel/scaffold": SCAFFOLD_RANGE,
 	"@types/node": "^26.1.2",
 	oxfmt: "^0.61.0",
@@ -610,7 +610,7 @@ function catalogNames(text) {
 *
 * @param header - The header cell strings, in column order.
 * @param rows - The body rows, each a list of cell strings matching `header`'s column count.
-* @param align - Optional per-column alignment; defaults every column to `'none'`.
+* @param align - Optional per-column alignment; defaults every column to `null` (no alignment).
 * @remarks
 * Builds a `TableNode` (each cell parsed with `parseInline`) and serializes it
 * through `renderMarkdown`, which contributes the structure — `\|`-escaping any
@@ -629,13 +629,14 @@ function catalogNames(text) {
 */
 function alignTable(header, rows, align) {
 	const columns = header.length;
-	const alignment = align ?? header.map(() => "none");
-	const lines = (0, _orkestrel_markdown.renderMarkdown)({
+	const alignment = align ?? header.map(() => null);
+	const node = {
 		element: "table",
 		header: header.map((cell) => (0, _orkestrel_markdown.parseInline)(cell)),
 		rows: rows.map((row) => row.map((cell) => (0, _orkestrel_markdown.parseInline)(cell))),
 		align: alignment
-	}).split("\n");
+	};
+	const lines = (0, _orkestrel_markdown.renderMarkdown)(node).split("\n");
 	const headerCells = splitTableRow(lines[0] ?? "");
 	const bodyCells = lines.slice(2).map((line) => splitTableRow(line));
 	const widths = [];
@@ -698,11 +699,11 @@ function padCell(text, width) {
 /**
 * Build one delimiter-row cell for a GFM table column.
 *
-* @param columnAlign - The column's `TableAlign`.
+* @param columnAlign - The column's `TableAlign`, or `null` for no alignment.
 * @param width - The column's codepoint width.
 * @remarks
 * `'left'` prefixes `:`, `'right'` suffixes `:`, `'center'` wraps both ends,
-* `'none'` is plain dashes — one dash per width unit, `:` markers consuming
+* `null` is plain dashes — one dash per width unit, `:` markers consuming
 * a dash slot rather than adding to `width`.
 * @returns The delimiter cell string for this column.
 *
@@ -5875,7 +5876,7 @@ ${renderedProjects}
 ${fitsPrintWidth(inlineRegistrations) ? inlineRegistrations : `		[
 ${renderedRegistrations.map((registration) => `			${registration},`).join("\n")}
 		],`}
-		hasChromium,
+		chromiumPath !== undefined,
 		process.argv,
 	),`;
 }
@@ -7252,11 +7253,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 +7652,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 +7785,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 +7951,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 +8080,7 @@ ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 			},
 			browser: {
 				enabled: true,
-				provider: playwright(),
+				provider: playwright(chromiumOptions),
 				instances: [{ browser: 'chromium', headless: true }],
 			},
 			fileParallelism: false,