@orkestrel/scaffold 0.0.11 → 0.0.13

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

@@ -19,7 +19,7 @@ import { UnionShape } from '@orkestrel/contract';
  *
  * @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
@@ -36,7 +36,7 @@ import { UnionShape } from '@orkestrel/contract';
  * // '| API            | Kind     |\n| --------------- | -------- |\n| `createRouter` | function |'
  * ```
  */
-export declare function alignTable(header: readonly string[], rows: readonly (readonly string[])[], align?: readonly TableAlign[]): string;
+export declare function alignTable(header: readonly string[], rows: readonly (readonly string[])[], align?: readonly (TableAlign | null)[]): string;
 
 /** Additional development dependencies required by a private Vue browser application. */
 export declare const APP_BROWSER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
@@ -782,11 +782,11 @@ export declare function coreViteConfig(browser?: boolean): string;
  /**
   * 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.
   *
@@ -797,7 +797,7 @@ export declare function coreViteConfig(browser?: boolean): string;
   * delimiterCell('left', 5) // ':----'
   * ```
   */
- export declare function delimiterCell(columnAlign: TableAlign, width: number): string;
+ export declare function delimiterCell(columnAlign: TableAlign | null, width: number): string;
 
  /**
   * One runtime `@orkestrel/*` dependency.
@@ -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.11";
+ export declare const SCAFFOLD_RANGE = "^0.0.12";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).

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

@@ -19,7 +19,7 @@ import { UnionShape } from '@orkestrel/contract';
  *
  * @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
@@ -36,7 +36,7 @@ import { UnionShape } from '@orkestrel/contract';
  * // '| API            | Kind     |\n| --------------- | -------- |\n| `createRouter` | function |'
  * ```
  */
-export declare function alignTable(header: readonly string[], rows: readonly (readonly string[])[], align?: readonly TableAlign[]): string;
+export declare function alignTable(header: readonly string[], rows: readonly (readonly string[])[], align?: readonly (TableAlign | null)[]): string;
 
 /** Additional development dependencies required by a private Vue browser application. */
 export declare const APP_BROWSER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
@@ -782,11 +782,11 @@ export declare function coreViteConfig(browser?: boolean): string;
  /**
   * 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.
   *
@@ -797,7 +797,7 @@ export declare function coreViteConfig(browser?: boolean): string;
   * delimiterCell('left', 5) // ':----'
   * ```
   */
- export declare function delimiterCell(columnAlign: TableAlign, width: number): string;
+ export declare function delimiterCell(columnAlign: TableAlign | null, width: number): string;
 
  /**
   * One runtime `@orkestrel/*` dependency.
@@ -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.11";
+ export declare const SCAFFOLD_RANGE = "^0.0.12";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).

package/dist/src/core/index.js

@@ -226,11 +226,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",
@@ -609,7 +609,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
@@ -628,13 +628,14 @@ function catalogNames(text) {
 */
 function alignTable(header, rows, align) {
 	const columns = header.length;
-	const alignment = align ?? header.map(() => "none");
-	const lines = renderMarkdown({
+	const alignment = align ?? header.map(() => null);
+	const node = {
 		element: "table",
 		header: header.map((cell) => parseInline(cell)),
 		rows: rows.map((row) => row.map((cell) => parseInline(cell))),
 		align: alignment
-	}).split("\n");
+	};
+	const lines = renderMarkdown(node).split("\n");
 	const headerCells = splitTableRow(lines[0] ?? "");
 	const bodyCells = lines.slice(2).map((line) => splitTableRow(line));
 	const widths = [];
@@ -697,11 +698,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.
 *
@@ -5874,7 +5875,7 @@ ${renderedProjects}
 ${fitsPrintWidth(inlineRegistrations) ? inlineRegistrations : `		[
 ${renderedRegistrations.map((registration) => `			${registration},`).join("\n")}
 		],`}
-		hasChromium,
+		chromiumPath !== undefined,
 		process.argv,
 	),`;
 }
@@ -7251,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))
 }
@@ -7595,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,
@@ -7728,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,
@@ -7894,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,
@@ -8023,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,