@orkestrel/scaffold 0.0.17 → 0.0.19

package/dist/host/manifest.json

@@ -1,5 +1,35 @@
 {
 	"entries": [
+		{
+			"storage": "agents/skills/enterprise-bootstrap/SKILL.md",
+			"destination": ".agents/skills/enterprise-bootstrap/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/agents/openai.yaml",
+			"destination": ".agents/skills/enterprise-bootstrap/agents/openai.yaml",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/bootstrap-reference.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/bootstrap-reference.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/components.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/components.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/frontend-design.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/frontend-design.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/utilities.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/utilities.md",
+			"executable": false
+		},
 		{
 			"storage": "agents/skills/orkestrel-align-packages/SKILL.md",
 			"destination": ".agents/skills/orkestrel-align-packages/SKILL.md",
@@ -31,8 +61,18 @@
 			"executable": false
 		},
 		{
-			"storage": "agents/skills/orkestrel-build-application/references/application.md",
-			"destination": ".agents/skills/orkestrel-build-application/references/application.md",
+			"storage": "agents/skills/orkestrel-debrief/SKILL.md",
+			"destination": ".agents/skills/orkestrel-debrief/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-debrief/agents/openai.yaml",
+			"destination": ".agents/skills/orkestrel-debrief/agents/openai.yaml",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-debrief/references/field-testing.md",
+			"destination": ".agents/skills/orkestrel-debrief/references/field-testing.md",
 			"executable": false
 		},
 		{
@@ -66,8 +106,18 @@
 			"executable": false
 		},
 		{
-			"storage": "claude/agents/application.md",
-			"destination": ".claude/agents/application.md",
+			"storage": "agents/skills/orkestrel-polish-surface/SKILL.md",
+			"destination": ".agents/skills/orkestrel-polish-surface/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-polish-surface/agents/openai.yaml",
+			"destination": ".agents/skills/orkestrel-polish-surface/agents/openai.yaml",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-polish-surface/references/capture-harness.md",
+			"destination": ".agents/skills/orkestrel-polish-surface/references/capture-harness.md",
 			"executable": false
 		},
 		{
@@ -175,6 +225,11 @@
 			"destination": ".claude/settings.json",
 			"executable": false
 		},
+		{
+			"storage": "claude/skills/enterprise-bootstrap/SKILL.md",
+			"destination": ".claude/skills/enterprise-bootstrap/SKILL.md",
+			"executable": false
+		},
 		{
 			"storage": "claude/skills/orkestrel-align-packages/SKILL.md",
 			"destination": ".claude/skills/orkestrel-align-packages/SKILL.md",
@@ -185,19 +240,24 @@
 			"destination": ".claude/skills/orkestrel-build-application/SKILL.md",
 			"executable": false
 		},
+		{
+			"storage": "claude/skills/orkestrel-debrief/SKILL.md",
+			"destination": ".claude/skills/orkestrel-debrief/SKILL.md",
+			"executable": false
+		},
 		{
 			"storage": "claude/skills/orkestrel-harden-package/SKILL.md",
 			"destination": ".claude/skills/orkestrel-harden-package/SKILL.md",
 			"executable": false
 		},
 		{
-			"storage": "codex/agents/analyst.toml",
-			"destination": ".codex/agents/analyst.toml",
+			"storage": "claude/skills/orkestrel-polish-surface/SKILL.md",
+			"destination": ".claude/skills/orkestrel-polish-surface/SKILL.md",
 			"executable": false
 		},
 		{
-			"storage": "codex/agents/application.toml",
-			"destination": ".codex/agents/application.toml",
+			"storage": "codex/agents/analyst.toml",
+			"destination": ".codex/agents/analyst.toml",
 			"executable": false
 		},
 		{
@@ -349,22 +409,33 @@
 	"roots": [
 		".agents",
 		".agents/skills",
+		".agents/skills/enterprise-bootstrap",
+		".agents/skills/enterprise-bootstrap/agents",
+		".agents/skills/enterprise-bootstrap/references",
 		".agents/skills/orkestrel-align-packages",
 		".agents/skills/orkestrel-align-packages/agents",
 		".agents/skills/orkestrel-align-packages/references",
 		".agents/skills/orkestrel-build-application",
 		".agents/skills/orkestrel-build-application/agents",
-		".agents/skills/orkestrel-build-application/references",
+		".agents/skills/orkestrel-debrief",
+		".agents/skills/orkestrel-debrief/agents",
+		".agents/skills/orkestrel-debrief/references",
 		".agents/skills/orkestrel-harden-package",
 		".agents/skills/orkestrel-harden-package/agents",
 		".agents/skills/orkestrel-harden-package/references",
+		".agents/skills/orkestrel-polish-surface",
+		".agents/skills/orkestrel-polish-surface/agents",
+		".agents/skills/orkestrel-polish-surface/references",
 		".claude",
 		".claude/agents",
 		".claude/rules",
 		".claude/skills",
+		".claude/skills/enterprise-bootstrap",
 		".claude/skills/orkestrel-align-packages",
 		".claude/skills/orkestrel-build-application",
+		".claude/skills/orkestrel-debrief",
 		".claude/skills/orkestrel-harden-package",
+		".claude/skills/orkestrel-polish-surface",
 		".codex",
 		".codex/agents",
 		".cursor",

package/dist/host/tests/setupPolicy.ts

@@ -240,7 +240,7 @@ export function isSelfContained(source: ts.SourceFile): boolean {
 			const clause = statement.importClause
 			const named = clause?.namedBindings
 			const erased =
-				clause?.isTypeOnly === true ||
+				clause?.phaseModifier === ts.SyntaxKind.TypeKeyword ||
 				(clause !== undefined &&
 					clause.name === undefined &&
 					named !== undefined &&
@@ -248,8 +248,9 @@ export function isSelfContained(source: ts.SourceFile): boolean {
 					named.elements.length > 0 &&
 					named.elements.every((element) => element.isTypeOnly))
 			if (erased) continue
-			if (!ts.isStringLiteral(statement.moduleSpecifier)) return false
-			const specifier = statement.moduleSpecifier.text
+			const moduleSpecifier = statement.moduleSpecifier
+			if (!ts.isStringLiteral(moduleSpecifier)) return false
+			const specifier = moduleSpecifier.text
 			if (!specifier.startsWith('node:') || !isBuiltin(specifier)) return false
 			builtin = true
 		}

package/dist/src/core/index.cjs

@@ -145,6 +145,8 @@ var HOST_PATHS = Object.freeze([
 var SERVICE_SCRIPT_PATH = "scripts/service.sh";
 /** The consumer-owned Vitest global-setup module shared by its independently selected projects. */
 var GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
+/** The consumer-owned Vite wrapper whose physical presence enables the optional app showcase. */
+var SHOWCASE_CONFIG_PATH = "configs/app/vite.showcase.config.ts";
 /** The package-name RegExp — lowercase alphanumeric-with-hyphens, letter-first. */
 var NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
 /** Maximum bare workspace name length beneath the generated `@orkestrel/` scope. */
@@ -227,7 +229,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.17";
+var SCAFFOLD_RANGE = "^0.0.19";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
@@ -427,7 +429,7 @@ function member(name, category, summary, environment = "core") {
 * `version` / `engines` default `DEFAULT_VERSION` / `DEFAULT_ENGINES`,
 * `src` defaults `['core']`, and `app` / `keywords` / `dependencies` /
 * `peers` / `extras` / `overrides` default `[]`, and `bin` / `integration` /
-* `service` / `global` default `false`. `description` is OMITTED entirely
+* `service` / `global` / `showcase` default `false`. `description` is OMITTED entirely
 * when absent, so the result round-trips the exact-record `Blueprint` guard.
 * @returns A complete `Blueprint`.
 *
@@ -453,7 +455,8 @@ function blueprint(name, options) {
 		bin: options?.bin ?? false,
 		integration: options?.integration ?? false,
 		service: options?.service ?? false,
-		global: options?.global ?? false
+		global: options?.global ?? false,
+		showcase: options?.showcase ?? false
 	};
 	return options?.description === void 0 ? base : {
 		...base,
@@ -1361,6 +1364,11 @@ function validateBlueprint(spec) {
 		text: "At least one src or app environment is required",
 		blocking: true
 	});
+	if (spec.showcase && !spec.app.includes("browser")) questions.push({
+		field: "showcase",
+		text: "Showcase requires the app browser environment",
+		blocking: true
+	});
 	if (spec.src.length > 0) {
 		for (const environment of spec.src) if (!ENVIRONMENTS.includes(environment)) questions.push({
 			field: "src",
@@ -1824,7 +1832,8 @@ function blueprintShape() {
 		bin: (0, _orkestrel_contract.booleanShape)(),
 		integration: (0, _orkestrel_contract.booleanShape)(),
 		service: (0, _orkestrel_contract.booleanShape)(),
-		global: (0, _orkestrel_contract.booleanShape)()
+		global: (0, _orkestrel_contract.booleanShape)(),
+		showcase: (0, _orkestrel_contract.booleanShape)()
 	});
 }
 /**
@@ -4467,9 +4476,7 @@ describe('createApplication', () => {
 			'x'.repeat(204),
 			\`\${' '.repeat(MAX_APPLICATION_NAME_INPUT_LENGTH)}x\`,
 		]) {
-			expect(() => Reflect.apply(createApplication, undefined, [value])).toThrowError(
-				ApplicationError,
-			)
+			expect(() => Reflect.apply(createApplication, undefined, [value])).toThrow(ApplicationError)
 		}
 		const error = new ApplicationError('CONFIG', 'invalid')
 		expect(isApplicationError(error)).toBe(true)
@@ -4544,7 +4551,7 @@ describe('createBrowserApplication', () => {
 			{ name: 'x'.repeat(204) },
 			{ name: \`\${' '.repeat(MAX_BROWSER_APPLICATION_NAME_INPUT_LENGTH)}x\` },
 		]) {
-			expect(() => Reflect.apply(createBrowserApplication, undefined, [value])).toThrowError(
+			expect(() => Reflect.apply(createBrowserApplication, undefined, [value])).toThrow(
 				BrowserApplicationError,
 			)
 		}
@@ -4569,14 +4576,14 @@ describe('createBrowserApplication', () => {
 		const revocable = Proxy.revocable({}, {})
 		revocable.revoke()
 
-		expect(() => parseBrowserApplicationOptions(accessor)).toThrowError(BrowserApplicationError)
+		expect(() => parseBrowserApplicationOptions(accessor)).toThrow(BrowserApplicationError)
 		expect(reads).toBe(0)
-		expect(() => Reflect.apply(createBrowserApplication, undefined, [hostile])).toThrowError(
+		expect(() => Reflect.apply(createBrowserApplication, undefined, [hostile])).toThrow(
+			BrowserApplicationError,
+		)
+		expect(() => Reflect.apply(createBrowserApplication, undefined, [revocable.proxy])).toThrow(
 			BrowserApplicationError,
 		)
-		expect(() =>
-			Reflect.apply(createBrowserApplication, undefined, [revocable.proxy]),
-		).toThrowError(BrowserApplicationError)
 		expect(isBrowserApplicationError(new BrowserApplicationError('CONFIG', 'invalid'))).toBe(true)
 		expect(isBrowserApplicationError(new Error('plain'))).toBe(false)
 		expect(isBrowserApplicationError(revocable.proxy)).toBe(false)
@@ -4679,20 +4686,20 @@ describe('ApplicationServer', () => {
 	})
 
 	it('validates direct options before allocating a listener', () => {
-		expect(() => createApplicationServer({ host: ' ' })).toThrowError(
+		expect(() => createApplicationServer({ host: ' ' })).toThrow(
 			expect.objectContaining({ code: 'CONFIG' }),
 		)
-		expect(() => createApplicationServer({ port: Number.NaN })).toThrowError(
+		expect(() => createApplicationServer({ port: Number.NaN })).toThrow(
 			expect.objectContaining({ code: 'CONFIG' }),
 		)
-		expect(() => createApplicationServer({ port: -1 })).toThrowError(
+		expect(() => createApplicationServer({ port: -1 })).toThrow(
 			expect.objectContaining({ code: 'CONFIG' }),
 		)
-		expect(() => createApplicationServer({ timeout: 0 })).toThrowError(
+		expect(() => createApplicationServer({ timeout: 0 })).toThrow(
 			expect.objectContaining({ code: 'CONFIG' }),
 		)
 		for (const value of [null, 42, [], { host: 42 }, { port: [42] }]) {
-			expect(() => Reflect.apply(createApplicationServer, undefined, [value])).toThrowError(
+			expect(() => Reflect.apply(createApplicationServer, undefined, [value])).toThrow(
 				expect.objectContaining({ code: 'CONFIG' }),
 			)
 		}
@@ -4712,14 +4719,10 @@ describe('ApplicationServer', () => {
 			expect(server.port).toBe(0)
 
 			process.env.APP_PORT = '1e3'
-			expect(() => createApplicationServer()).toThrowError(
-				expect.objectContaining({ code: 'CONFIG' }),
-			)
+			expect(() => createApplicationServer()).toThrow(expect.objectContaining({ code: 'CONFIG' }))
 			process.env.APP_PORT = '0'
 			process.env.APP_START_TIMEOUT = '0'
-			expect(() => createApplicationServer()).toThrowError(
-				expect.objectContaining({ code: 'CONFIG' }),
-			)
+			expect(() => createApplicationServer()).toThrow(expect.objectContaining({ code: 'CONFIG' }))
 		} finally {
 			if (previousHost === undefined) delete process.env.APP_HOST
 			else process.env.APP_HOST = previousHost
@@ -5088,15 +5091,13 @@ describe('application environment parsers', () => {
 		'999.999.999.999',
 		\`\${'a'.repeat(64)}.example\`,
 	])('rejects hostile APP_HOST value %s before listener allocation', (value) => {
-		expect(() => parseApplicationHost(value)).toThrowError(
-			expect.objectContaining({ code: 'CONFIG' }),
-		)
+		expect(() => parseApplicationHost(value)).toThrow(expect.objectContaining({ code: 'CONFIG' }))
 	})
 
 	it.each([null, 42, [], { port: [42] }, { timeout: 0 }])(
 		'rejects hostile option container or leaf value %#',
 		(value) => {
-			expect(() => parseApplicationServerOptions(value)).toThrowError(
+			expect(() => parseApplicationServerOptions(value)).toThrow(
 				expect.objectContaining({ code: 'CONFIG' }),
 			)
 		},
@@ -5119,7 +5120,7 @@ describe('application environment parsers', () => {
 	])(
 		'rejects inherited, unknown, symbolic, accessor, instance, and hostile proxy options %#',
 		(value) => {
-			expect(() => parseApplicationServerOptions(value)).toThrowError(
+			expect(() => parseApplicationServerOptions(value)).toThrow(
 				expect.objectContaining({ code: 'CONFIG' }),
 			)
 		},
@@ -5569,6 +5570,7 @@ function devDependenciesFor(spec) {
 		...dependencies,
 		...spec.src.includes("browser") ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
 		...spec.app.includes("browser") ? APP_BROWSER_DEV_DEPENDENCIES : {},
+		...spec.showcase ? { "vite-plugin-singlefile": "^2.3.3" } : {},
 		...spec.bin ? { "@vitest/browser-playwright": SOURCE_BROWSER_DEV_DEPENDENCIES["@vitest/browser-playwright"] } : {}
 	};
 }
@@ -5630,7 +5632,7 @@ function packageManifest(spec) {
 	}
 	if (spec.bin) scripts["test:src:bin"] = "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:bin";
 	if (spec.integration) scripts["test:integration"] = "vitest run --config vite.config.ts --no-cache --reporter=dot --project integration";
-	if (spec.bin && spec.integration) scripts["test:equivalence"] = "node -e \"const c=require('node:child_process'),n=process.platform==='win32'?'npm.cmd':'npm',r=c.spawnSync(n,['run','test:integration'],{stdio:'inherit',env:{...process.env,SCAFFOLD_BOUNDARY_EQUIVALENCE:'1'}});process.exit(r.status??1)\"";
+	if (spec.bin && spec.integration) scripts["test:equivalence"] = "node -e \"const c=require('node:child_process'),p=process.env.npm_execpath;if(p===undefined)process.exit(1);const r=c.spawnSync(process.execPath,[p,'run','test:integration'],{stdio:'inherit',env:{...process.env,SCAFFOLD_BOUNDARY_EQUIVALENCE:'1'}});process.exit(r.status??1)\"";
 	if (spec.service) scripts["test:service"] = "vitest run --config vite.config.ts --no-cache --reporter=dot --project service";
 	if (spec.app.length > 0) {
 		scripts["test:app"] = "vitest run --config vite.config.ts --no-cache --reporter=dot " + spec.app.map((environment) => `--project ${APP_MATRIX[environment].project}`).join(" ");
@@ -5652,7 +5654,14 @@ function packageManifest(spec) {
 		const runtime = spec.app.filter((environment) => environment !== "core");
 		scripts["build:app"] = runtime.length > 0 ? runtime.map((environment) => `npm run build:app:${environment}`).join(" && ") : "npm run check:app:core";
 		for (const environment of runtime) scripts[`build:app:${environment}`] = `vite build --config configs/app/vite.${environment}.config.ts`;
-		if (spec.app.includes("browser")) scripts.dev = "vite --config configs/app/vite.browser.config.ts";
+		if (spec.app.includes("browser")) {
+			scripts.dev = "vite --config configs/app/vite.browser.config.ts";
+			if (spec.showcase) {
+				scripts.showcase = `vite --config ${SHOWCASE_CONFIG_PATH}`;
+				scripts["build:showcase"] = `vite build --config ${SHOWCASE_CONFIG_PATH}`;
+				scripts.show = "npm run build:showcase && npm run copy dist/showcase/index.html demo/showcase.html";
+			}
+		}
 		if (spec.app.includes("server")) {
 			scripts.serve = "node dist/app/server/main.cjs";
 			scripts["serve:build"] = "npm run build:app:server && npm run serve";
@@ -5724,6 +5733,7 @@ function rootTsconfig(src, app = []) {
 			target: "ESNext",
 			module: "ESNext",
 			moduleResolution: "bundler",
+			allowImportingTsExtensions: true,
 			lib: [
 				"ESNext",
 				"DOM",
@@ -5769,20 +5779,22 @@ function rootTsconfig(src, app = []) {
 * @param src - The declared published `Environment[]`.
 * @param app - The declared application `Environment[]`, defaulting to none.
 * @param bin - Whether the workspace also builds its own executable.
+* @param showcase - Whether the workspace carries its optional app showcase.
 * @returns The machinery set the generated header renders.
 *
 * @example
 * ```ts
-* viteMachinery(['core']) // { browser: false, vue: false, output: true }
-* viteMachinery([], ['core']) // { browser: false, vue: false, output: false }
+* viteMachinery(['core']) // { browser: false, vue: false, output: true, showcase: false }
+* viteMachinery([], ['core']) // { browser: false, vue: false, output: false, showcase: false }
 * ```
 */
-function viteMachinery(src, app = [], bin = false) {
+function viteMachinery(src, app = [], bin = false, showcase = false) {
 	const unbuilt = src.length === 0 && app.length > 0 && !bin && app.every((environment) => environment === "core");
 	return {
 		browser: src.includes("browser") || app.includes("browser"),
 		vue: app.includes("browser"),
-		output: !unbuilt
+		output: !unbuilt,
+		showcase: showcase && app.includes("browser")
 	};
 }
 /**
@@ -5896,7 +5908,7 @@ ${renderedRegistrations.map((registration) => `			${registration},`).join("\n")}
 * ```
 */
 function viteHeader(machinery) {
-	const { browser: needsBrowser, vue: needsVue, output: needsOutput } = machinery;
+	const { browser: needsBrowser, vue: needsVue, output: needsOutput, showcase: needsShowcase } = machinery;
 	const playwrightTypeImports = needsBrowser ? `import type { PlaywrightProviderOptions } from '@vitest/browser-playwright'
 ` : "";
 	const playwrightImports = needsBrowser ? `import { playwright } from '@vitest/browser-playwright'
@@ -5904,6 +5916,8 @@ import { chromium } from 'playwright'
 ` : "";
 	const vueImports = needsVue ? `import vue from '@vitejs/plugin-vue'
 import { parse as parseVue } from 'vue/compiler-sfc'
+` : "";
+	const showcaseImports = needsShowcase ? `import { viteSingleFile } from 'vite-plugin-singlefile'
 ` : "";
 	const viteTypeImports = needsVue ? `import type {
 	CSSOptions,
@@ -6963,6 +6977,31 @@ ${EXPORT_KEYWORD} function finalizeHtml(): Plugin {
 	}
 }
 
+` : ""}${needsShowcase ? `${EXPORT_KEYWORD} ${CONST_KEYWORD} SHOWCASE_SECURITY_POLICY =
+	"base-uri 'none'; object-src 'none'; script-src 'self' 'unsafe-inline'; script-src-attr 'none'; style-src 'self' 'unsafe-inline'"
+
+${EXPORT_KEYWORD} function showcaseHtml(): Plugin {
+	return {
+		name: 'orkestrel-showcase-html',
+		enforce: 'post',
+		transformIndexHtml: {
+			order: 'post',
+			handler(html, context) {
+				if (!isBrowserHtmlEntry(context.filename)) return undefined
+				if (!html.includes(HTML_SECURITY_META)) {
+					throw new Error('[orkestrel-showcase] Browser HTML must retain its security policy')
+				}
+				const stamp = new Date().toISOString()
+				return html.replace(
+					HTML_SECURITY_META,
+					HTML_SECURITY_META.replace(HTML_SECURITY_POLICY, SHOWCASE_SECURITY_POLICY) +
+						\`\\n\\t\\t<meta name="build-id" content="\${stamp}" />\`,
+				)
+			},
+		},
+	}
+}
+
 ` : ""}${EXPORT_KEYWORD} async function environmentAssetSources(
 	code: string,
 	id: string,
@@ -7274,7 +7313,7 @@ ${needsBrowser ? `import {
 	resolve as resolvePath,
 	sep,
 } from 'node:path'` : `import { 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. */
+${playwrightImports}${vueImports}${showcaseImports}${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',
@@ -7824,6 +7863,7 @@ ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 				outDir: 'dist/src/server',
 				target: 'node22',
 				rolldownOptions: {
+					platform: 'node',
 					external: (id: string) => id.startsWith('node:') || id.startsWith('@orkestrel/'),
 				},
 			},
@@ -7947,6 +7987,7 @@ ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 					outDir: 'dist/src/server',
 					target: 'node22',
 					rolldownOptions: {
+						platform: 'node',
 						external: (id: string) =>
 							id === '@src/core' || id.startsWith('node:') || id.startsWith('@orkestrel/'),
 						output: [
@@ -8021,7 +8062,7 @@ ${renderedTest}
 */
 function applicationViteConfig(src, app, facts = {}) {
 	const hasSourceCore = src.includes("core");
-	const machinery = viteMachinery(src, app, facts.bin === true);
+	const machinery = viteMachinery(src, app, facts.bin === true, facts.showcase === true);
 	const header = viteHeader(machinery);
 	const blocks = [];
 	if (src.includes("core")) blocks.push(`
@@ -8131,6 +8172,7 @@ ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 				outDir: 'dist/src/server',
 				target: 'node22',
 				rolldownOptions: {
+					platform: 'node',
 					external: (id: string) =>
 						${coreExternal}id.startsWith('node:') || id.startsWith('@orkestrel/'),${coreOutput}
 				},
@@ -8165,8 +8207,98 @@ ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 		config ?? {},
 	)
 `);
-	if (app.includes("browser")) blocks.push(`
-${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
+	if (app.includes("browser")) blocks.push(facts.showcase === true ? `
+${FUNCTION_KEYWORD} applicationBrowser(showcase: boolean): UserConfig {
+	const output = showcase ? 'dist/showcase' : 'dist/app/browser'
+	return {
+		resolve,
+		css: ENVIRONMENT_CSS,
+		html: environmentHtml(),
+		plugins: [
+			restoreHtml(),
+			outputBoundary(output),
+			environmentBoundary('app/browser'),
+			vue(),
+			prepareHtml(),
+			finalizeHtml(),
+			...(showcase
+				? [
+						viteSingleFile({
+							removeViteModuleLoader: true,
+							useRecommendedBuildConfig: true,
+						}),
+						showcaseHtml(),
+					]
+				: []),
+		],
+		root: resolveWorkspacePath('app/browser'),
+		publicDir: false,
+		server: {
+			fs: {
+				strict: true,
+				allow: [...browserServerRoots()],
+			},
+		},
+		build: {
+			...(showcase
+				? {
+						cssMinify: 'lightningcss',
+						minify: 'oxc',
+						modulePreload: false,
+						reportCompressedSize: false,
+						sourcemap: false,
+						target: 'esnext',
+					}
+				: { assetsInlineLimit: 0 }),
+			emptyOutDir: true,
+			outDir: resolveWorkspacePath(output),
+			rolldownOptions: {
+				input: resolveWorkspacePath('${APP_MATRIX.browser.entry}'),
+			},
+		},
+		test: {
+			name: { label: '${APP_MATRIX.browser.project}', color: 'blue' },
+			root: resolveWorkspacePath('.'),
+			dir: resolveWorkspacePath('.'),
+			include: ['tests/app/browser/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
+			deps: {
+				optimizer: {
+					client: {
+						enabled: true,
+						include: ['vue', ...BROWSER_TEST_DEPENDENCIES],
+					},
+				},
+			},
+			browser: {
+				enabled: true,
+				provider: playwright(browserOptions),
+				instances: [{ browser: 'chromium', headless: true }],
+			},
+			fileParallelism: false,
+		},
+	}
+}
+
+${EXPORT_KEYWORD} function appBrowser(...config: never[]): UserConfig {
+	if (config.length > 0) {
+		throw new Error(
+			'[orkestrel-environment-boundary] Browser configuration overrides are not permitted by the generated boundary',
+		)
+	}
+	return applicationBrowser(false)
+}
+
+${EXPORT_KEYWORD} function appShowcase(...config: never[]): UserConfig {
+	if (config.length > 0) {
+		throw new Error(
+			'[orkestrel-environment-boundary] Showcase configuration overrides are not permitted by the generated boundary',
+		)
+	}
+	return applicationBrowser(true)
+}
+` : `
+${EXPORT_KEYWORD} function appBrowser(...config: never[]): UserConfig {
 	if (config.length > 0) {
 		throw new Error(
 			'[orkestrel-environment-boundary] Browser configuration overrides are not permitted by the generated boundary',
@@ -8309,7 +8441,7 @@ import {
 	outputBoundary,
 	srcCore,
 	resolveWorkspacePath,
-} from '../../vite.config'
+} from '../../vite.config.ts'
 
 export default defineConfig(
 	srcCore({
@@ -8394,7 +8526,7 @@ function srcViteConfig(environment) {
 	const anchor = environment === "browser" ? "srcBrowser" : "srcServer";
 	return `import { defineConfig } from 'vite'
 import dts from 'vite-plugin-dts'
-import { ${anchor}, resolveWorkspacePath } from '../../vite.config'
+import { ${anchor}, resolveWorkspacePath } from '../../vite.config.ts'
 
 // Types are bundled inline by vite-plugin-dts (see configs/src/vite.core.config.ts
 // for the same pattern).
@@ -8447,7 +8579,7 @@ function binTsconfig() {
 */
 function binViteConfig() {
 	return `import { defineConfig } from 'vite'
-import { srcBin } from '../../vite.config'
+import { srcBin } from '../../vite.config.ts'
 
 // The \`scaffold\` executable build — a single ESM lib file, no declarations (an
 // executable ships no types), with the \`#!/usr/bin/env node\` shebang re-emitted via
@@ -8514,7 +8646,7 @@ function appTsconfig(environment, hasCore) {
 function appViteConfig(environment) {
 	const anchor = environment === "browser" ? "appBrowser" : "appServer";
 	return `import { defineConfig } from 'vite'
-import { ${anchor} } from '../../vite.config'
+import { ${anchor} } from '../../vite.config.ts'
 
 export default defineConfig(${anchor}())
 `;
@@ -8646,6 +8778,17 @@ function configArtifacts(spec) {
 			});
 		}
 	}
+	if (spec.showcase) artifacts.push({
+		path: SHOWCASE_CONFIG_PATH,
+		group: "configs",
+		origin: "computed",
+		environment: "browser",
+		content: `import { defineConfig } from 'vite'
+import { appShowcase } from '../../vite.config.ts'
+
+export default defineConfig(appShowcase())
+`
+	});
 	return artifacts;
 }
 /**
@@ -9829,6 +9972,7 @@ exports.PlanManager = PlanManager;
 exports.SCAFFOLD_RANGE = SCAFFOLD_RANGE;
 exports.SERVICE_SCRIPT_PATH = SERVICE_SCRIPT_PATH;
 exports.SETUP_NODE_ACTION_SHA = SETUP_NODE_ACTION_SHA;
+exports.SHOWCASE_CONFIG_PATH = SHOWCASE_CONFIG_PATH;
 exports.SOURCE_BROWSER_DEV_DEPENDENCIES = SOURCE_BROWSER_DEV_DEPENDENCIES;
 exports.SRC_MATRIX = SRC_MATRIX;
 exports.SYNC_BASELINE_PATTERN = SYNC_BASELINE_PATTERN;