@orkestrel/scaffold 0.0.13 → 0.0.15

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

@@ -707,7 +707,6 @@ export declare function coreTsconfig(): string;
  * `configs/src/vite.core.config.ts` — inlines its own `build.lib` /
  * `rolldownOptions` (core's `srcCore` root export carries no build.lib).
  *
- * @param browser - Whether a declared browser environment enables the shared CSS pipeline.
  * @returns The core environment `vite.config.ts` file content, newline-terminated.
  *
  * @example
@@ -715,7 +714,7 @@ export declare function coreTsconfig(): string;
  * coreViteConfig().includes('srcCore(') // true
  * ```
  */
-export declare function coreViteConfig(browser?: boolean): string;
+export declare function coreViteConfig(): string;
 
 /**
  * Validate and return a `Blueprint` from plain data.
@@ -2276,7 +2275,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.15";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2788,11 +2787,14 @@ export declare function coreViteConfig(browser?: boolean): string;
   * configuration emits the environment-boundary plugin, its module-graph AST
   * audit, and stylesheet rejection, because those enforce owner-independent
   * laws. Only the host-specific pipelines below are selected by the declared
-  * environments. `browser` covers everything a declared browser environment
-  * needs — the CSS pipeline and the Playwright-backed browser test project;
-  * `vue` adds the single-file-component, HTML, and development-server
-  * machinery an application browser environment needs; `output` adds build
-  * output containment, which an application of `core` alone never builds.
+  * environments. `browser` selects the shared root machinery a declared
+  * browser environment needs: CSS analysis and the Playwright-backed browser
+  * test project. Individual `css` configuration belongs only to the
+  * `srcBrowser` and `appBrowser` factories; core and server factories never
+  * inherit it. `vue` adds the single-file-component, HTML, and
+  * development-server machinery an application browser environment needs;
+  * `output` adds build output containment, which an application of `core`
+  * alone never builds.
   */
  export declare interface ViteMachinery {
      readonly browser: boolean;

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

@@ -707,7 +707,6 @@ export declare function coreTsconfig(): string;
  * `configs/src/vite.core.config.ts` — inlines its own `build.lib` /
  * `rolldownOptions` (core's `srcCore` root export carries no build.lib).
  *
- * @param browser - Whether a declared browser environment enables the shared CSS pipeline.
  * @returns The core environment `vite.config.ts` file content, newline-terminated.
  *
  * @example
@@ -715,7 +714,7 @@ export declare function coreTsconfig(): string;
  * coreViteConfig().includes('srcCore(') // true
  * ```
  */
-export declare function coreViteConfig(browser?: boolean): string;
+export declare function coreViteConfig(): string;
 
 /**
  * Validate and return a `Blueprint` from plain data.
@@ -2276,7 +2275,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.15";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2788,11 +2787,14 @@ export declare function coreViteConfig(browser?: boolean): string;
   * configuration emits the environment-boundary plugin, its module-graph AST
   * audit, and stylesheet rejection, because those enforce owner-independent
   * laws. Only the host-specific pipelines below are selected by the declared
-  * environments. `browser` covers everything a declared browser environment
-  * needs — the CSS pipeline and the Playwright-backed browser test project;
-  * `vue` adds the single-file-component, HTML, and development-server
-  * machinery an application browser environment needs; `output` adds build
-  * output containment, which an application of `core` alone never builds.
+  * environments. `browser` selects the shared root machinery a declared
+  * browser environment needs: CSS analysis and the Playwright-backed browser
+  * test project. Individual `css` configuration belongs only to the
+  * `srcBrowser` and `appBrowser` factories; core and server factories never
+  * inherit it. `vue` adds the single-file-component, HTML, and
+  * development-server machinery an application browser environment needs;
+  * `output` adds build output containment, which an application of `core`
+  * alone never builds.
   */
  export declare interface ViteMachinery {
      readonly browser: boolean;

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.15";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
@@ -236,14 +236,14 @@ var BASE_DEV_DEPENDENCIES = Object.freeze({
 	oxfmt: "^0.61.0",
 	oxlint: "^1.76.0",
 	typescript: "^6.0.3",
-	vite: "^8.1.5",
+	vite: "~8.2.0",
 	"vite-plugin-dts": "^5.0.3",
 	vitest: "^4.1.10"
 });
 /** Additional development dependency required by a published browser source environment. */
 var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 	"@vitest/browser-playwright": "^4.1.10",
-	playwright: "^1.62.0"
+	playwright: "^1.62.1"
 });
 /** Additional development dependencies required by a private Vue browser application. */
 var APP_BROWSER_DEV_DEPENDENCIES = Object.freeze({
@@ -5936,7 +5936,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 					if (isCSSRequest(id)) {
 						const config = resolvedConfig
 						if (config === undefined) {
-							this.error('Environment boundary requires resolved Vite configuration')
+							return this.error('Environment boundary requires resolved Vite configuration')
 						}
 						const stylesheet = await preprocessCSS(restored, id, config)
 						for (const dependency of stylesheet.deps ?? []) {
@@ -5982,7 +5982,9 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 										? undefined
 										: packageRootOf(packageName, physicalSource)
 								if (packageRoot === undefined || !containedPath(packageRoot, physicalSource)) {
-									this.error('Resolved dependencies must remain inside their physical package root')
+									return this.error(
+										'Resolved dependencies must remain inside their physical package root',
+									)
 								}
 								trustedPackageRoots.add(packageRoot)
 							}
@@ -5990,7 +5992,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 						}
 						const resolvedSource = workspacePath(physicalSource)
 						if (resolvedSource === undefined) {
-							this.error('Environment modules cannot import files outside the workspace')
+							return this.error('Environment modules cannot import files outside the workspace')
 						}
 						const assetError = environmentPathError(owner, resolvedSource)
 						if (assetError !== undefined) this.error(assetError)
@@ -6019,7 +6021,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 						)
 						const resolvedSource = workspacePath(resolution?.id ?? fallbackSource)
 						if (resolvedSource === undefined) {
-							this.error('Environment modules cannot import files outside the workspace')
+							return this.error('Environment modules cannot import files outside the workspace')
 						}
 						const pathError = environmentPathError('app/browser', resolvedSource)
 						if (pathError !== undefined) this.error(pathError)
@@ -6037,7 +6039,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 					if (source === undefined) continue
 					const decodedSource = decodeAssetSource(source)
 					if (decodedSource === undefined) {
-						this.error('Vue block URLs must use valid URI encoding')
+						return this.error('Vue block URLs must use valid URI encoding')
 					}
 					const normalizedSource = decodedSource.replaceAll('\\\\', '/')
 					const sourceError = environmentSourceError('app/browser', normalizedSource)
@@ -6095,7 +6097,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 				if (isCSSRequest(id)) {
 					const config = resolvedConfig
 					if (config === undefined) {
-						this.error('Environment boundary requires resolved Vite configuration')
+						return this.error('Environment boundary requires resolved Vite configuration')
 					}
 					const stylesheet = await preprocessCSS(code, id, config)
 					for (const dependency of stylesheet.deps ?? []) {
@@ -6141,7 +6143,9 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 									? undefined
 									: packageRootOf(packageName, physicalSource)
 							if (packageRoot === undefined || !containedPath(packageRoot, physicalSource)) {
-								this.error('Resolved dependencies must remain inside their physical package root')
+								return this.error(
+									'Resolved dependencies must remain inside their physical package root',
+								)
 							}
 							trustedPackageRoots.add(packageRoot)
 						}
@@ -6149,7 +6153,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 					}
 					const resolvedSource = workspacePath(physicalSource)
 					if (resolvedSource === undefined) {
-						this.error('Environment modules cannot import files outside the workspace')
+						return this.error('Environment modules cannot import files outside the workspace')
 					}
 					const assetError = environmentPathError(owner, resolvedSource)
 					if (assetError !== undefined) this.error(assetError)
@@ -6708,7 +6712,11 @@ ${EXPORT_KEYWORD} function outputBoundary(output: string): Plugin {
 					'[orkestrel-output-boundary] Public directories are disabled; every output must come from the audited graph',
 				)
 			}
-			if (output.endsWith('/browser') && config.build.assetsInlineLimit !== 0) {
+			if (
+				output.endsWith('/browser') &&
+				config.build.lib === false &&
+				config.build.assetsInlineLimit !== 0
+			) {
 				throw new Error(
 					'[orkestrel-output-boundary] Browser assets must remain external for output auditing',
 				)
@@ -7111,7 +7119,7 @@ ${needsVue ? `		configureServer(server) {
 							? packageRootForResolved(physicalResolution)
 							: undefined
 					if (mappedPackageRoot === undefined) {
-						this.error(
+						return this.error(
 							'Dependency package imports must resolve inside an exact physical package root',
 						)
 					}
@@ -7130,7 +7138,7 @@ ${needsVue ? `		configureServer(server) {
 				const packageRoot =
 					packageName === undefined ? undefined : packageRootOf(packageName, physicalResolution)
 				if (packageRoot === undefined || !containedPath(packageRoot, physicalResolution)) {
-					this.error('Resolved dependencies must remain inside their physical package root')
+					return this.error('Resolved dependencies must remain inside their physical package root')
 				}
 				trustedPackageRoots.add(packageRoot)
 			}
@@ -7161,7 +7169,7 @@ ${needsVue ? `		configureServer(server) {
 			}
 			const code = readBoundedFile(physicalImporter, ENVIRONMENT_MODULE_BYTES)
 			if (code === undefined) {
-				this.error('Dependency module source must be a bounded regular file')
+				return this.error('Dependency module source must be a bounded regular file')
 			}
 			for (const source of await environmentAssetSources(code, id)) {
 				const normalizedSource = source.replaceAll('\\\\', '/')
@@ -7398,7 +7406,7 @@ ${EXPORT_KEYWORD} ${CONST_KEYWORD} ENVIRONMENT_CSS = Object.freeze({
 						'value' in rule && rule.value !== null && 'loc' in rule.value
 							? sources[rule.value.loc.source_index]
 							: undefined
-					if (rule.type !== 'import') return
+					if (rule.type !== 'import' || rule.value === null) return
 					const error = stylesheetAssetError(source, rule.value.url)
 					if (error !== undefined) {
 						throw new Error(\`[orkestrel-environment-boundary] \${error}\`)
@@ -7619,7 +7627,6 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 			publicDir: false,
 			plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser')],
 			build: {
-				assetsInlineLimit: 0,
 				emptyOutDir: true,
 				sourcemap: true,
 				minify: false,
@@ -7670,7 +7677,7 @@ ${renderedTest}
 ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
-			resolve,${machinery.browser ? "\n			css: ENVIRONMENT_CSS," : ""}
+			resolve,
 			publicDir: false,
 			plugins: [outputBoundary('dist/src/server'), environmentBoundary('src/server')],
 			build: {
@@ -7753,7 +7760,6 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 				publicDir: false,
 				plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser')],
 				build: {
-					assetsInlineLimit: 0,
 					lib: {
 						entry: resolveWorkspacePath('src/browser/index.ts'),
 						formats: ['es'],
@@ -7798,7 +7804,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 	srcCore(
 		mergeConfig(
-			{${machinery.browser ? "\n				css: ENVIRONMENT_CSS," : ""}
+			{
 				publicDir: false,
 				plugins: [outputBoundary('dist/src/server'), environmentBoundary('src/server')],
 				build: {
@@ -7890,7 +7896,7 @@ function applicationViteConfig(src, app, facts = {}) {
 ${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
-			resolve,${machinery.browser ? "\n			css: ENVIRONMENT_CSS," : ""}
+			resolve,
 			publicDir: false,
 			plugins: [environmentBoundary('src/core')],
 			build: { emptyOutDir: true, sourcemap: true, minify: false },
@@ -7918,7 +7924,6 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 			publicDir: false,
 			plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser')],
 			build: {
-				assetsInlineLimit: 0,
 				emptyOutDir: true,
 				sourcemap: true,
 				minify: false,
@@ -7980,7 +7985,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
-			resolve,${machinery.browser ? "\n			css: ENVIRONMENT_CSS," : ""}
+			resolve,
 			publicDir: false,
 			plugins: [outputBoundary('dist/src/server'), environmentBoundary('src/server')],
 			build: {
@@ -8014,7 +8019,7 @@ ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
-			resolve,${machinery.browser ? "\n			css: ENVIRONMENT_CSS," : ""}
+			resolve,
 			publicDir: false,
 			plugins: [environmentBoundary('app/core')],
 			test: {
@@ -8091,7 +8096,7 @@ ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 ${EXPORT_KEYWORD} const appServer = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
-			resolve,${machinery.browser ? "\n			css: ENVIRONMENT_CSS," : ""}
+			resolve,
 			publicDir: false,
 			plugins: [outputBoundary('dist/app/server'), environmentBoundary('app/server')],
 			build: {
@@ -8157,7 +8162,6 @@ function coreTsconfig() {
 * `configs/src/vite.core.config.ts` — inlines its own `build.lib` /
 * `rolldownOptions` (core's `srcCore` root export carries no build.lib).
 *
-* @param browser - Whether a declared browser environment enables the shared CSS pipeline.
 * @returns The core environment `vite.config.ts` file content, newline-terminated.
 *
 * @example
@@ -8165,11 +8169,11 @@ function coreTsconfig() {
 * coreViteConfig().includes('srcCore(') // true
 * ```
 */
-function coreViteConfig(browser = true) {
+function coreViteConfig() {
 	return `import { defineConfig } from 'vite'
 import dts from 'vite-plugin-dts'
 import {
-${browser ? "	ENVIRONMENT_CSS,\n" : ""}	environmentBoundary,
+	environmentBoundary,
 	outputBoundary,
 	srcCore,
 	resolveWorkspacePath,
@@ -8177,7 +8181,7 @@ ${browser ? "	ENVIRONMENT_CSS,\n" : ""}	environmentBoundary,
 
 export default defineConfig(
 	srcCore({
-${browser ? "		css: ENVIRONMENT_CSS,\n" : ""}		publicDir: false,
+		publicDir: false,
 		plugins: [
 			outputBoundary('dist/src/core'),
 			environmentBoundary('src/core'),
@@ -8466,7 +8470,6 @@ ${browser}
 * ```
 */
 function configArtifacts(spec) {
-	const machinery = viteMachinery(spec.src, spec.app, spec.bin);
 	const artifacts = [{
 		path: "tsconfig.json",
 		group: "configs",
@@ -8482,7 +8485,7 @@ function configArtifacts(spec) {
 		const row = SRC_MATRIX[environment];
 		for (const path of row.configs) {
 			const isTsconfig = path.endsWith(".json");
-			const content = environment === "core" ? isTsconfig ? coreTsconfig() : coreViteConfig(machinery.browser) : isTsconfig ? srcTsconfig(environment) : srcViteConfig(environment);
+			const content = environment === "core" ? isTsconfig ? coreTsconfig() : coreViteConfig() : isTsconfig ? srcTsconfig(environment) : srcViteConfig(environment);
 			artifacts.push({
 				path,
 				group: "configs",
@@ -8614,24 +8617,20 @@ function paritySpecifiers(spec) {
 	for (const environment of spec.app) modules[`@app/${environment}`] = `app/${environment}`;
 	const specifierItems = selfSpecifiers.map((specifier) => `'${specifier}'`);
 	const inlineSpecifierList = `[${specifierItems.join(", ")}]`;
-	return `${EXPORT_KEYWORD} ${CONST_KEYWORD} SELF_SPECIFIERS = ${fitsPrintWidth(`const SELF_SPECIFIERS = ${inlineSpecifierList}`) ? inlineSpecifierList : `[
-${specifierItems.map((specifier) => `\t${specifier},`).join("\n")}
-]`}
-
-${EXPORT_KEYWORD} ${CONST_KEYWORD} SPECIFIER_MODULES: Readonly<Record<string, string>> = {
-${Object.entries(modules).map(([specifier, module]) => `\t'${specifier}': '${module}',`).join("\n")}
-}
-${EXPORT_KEYWORD} ${CONST_KEYWORD} SPECIFIER_SOURCES = new Map<string, ReturnType<typeof createSource>>()
-${EXPORT_KEYWORD} ${FUNCTION_KEYWORD} exportsFor(specifier: string): readonly string[] {
-	const module = SPECIFIER_MODULES[specifier]
-	if (module === undefined) return []
-	let source = SPECIFIER_SOURCES.get(module)
-	if (source === undefined) {
-		source = createSource({ files: GUIDE_FILES, module })
-		SPECIFIER_SOURCES.set(module, source)
-	}
-	return source.exports().map((symbol) => symbol.name)
-}`;
+	const lines = fitsPrintWidth(`const SELF_SPECIFIERS = ${inlineSpecifierList}`) ? [`${EXPORT_KEYWORD} ${CONST_KEYWORD} SELF_SPECIFIERS = ${inlineSpecifierList}`] : [
+		`${EXPORT_KEYWORD} ${CONST_KEYWORD} SELF_SPECIFIERS = [`,
+		...specifierItems.map((specifier) => `\t${specifier},`),
+		"]"
+	];
+	lines.push("", [
+		EXPORT_KEYWORD,
+		CONST_KEYWORD,
+		"SPECIFIER_MODULES:",
+		"Readonly<Record<string, string>>",
+		"=",
+		"{"
+	].join(" "), ...Object.entries(modules).map(([specifier, module]) => `\t'${specifier}': '${module}',`), "}", `${EXPORT_KEYWORD} ${CONST_KEYWORD} SPECIFIER_SOURCES = new Map<string, ReturnType<typeof createSource>>()`, `${EXPORT_KEYWORD} ${FUNCTION_KEYWORD} exportsFor(specifier: string): readonly string[] {`, "	const module = SPECIFIER_MODULES[specifier]", "	if (module === undefined) return []", "	let source = SPECIFIER_SOURCES.get(module)", "	if (source === undefined) {", "		source = createSource({ files: GUIDE_FILES, module })", "		SPECIFIER_SOURCES.set(module, source)", "	}", "	return source.exports().map((symbol) => symbol.name)", "}");
+	return lines.join("\n");
 }
 /**
 * Draft the `tests` group's `template` artifacts — the shared recorder
@@ -8652,8 +8651,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) => {
@@ -8665,12 +8664,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,