@orkestrel/scaffold 0.0.93 → 0.0.94

package/dist/host/guides/scaffold.md

@@ -2098,8 +2098,13 @@ Nothing is fixed except the manifest.
   once into `browserOptions` and passes that to every `playwright()` provider it configures. The
   precedence is `PLAYWRIGHT_EXECUTABLE_PATH`, `PLAYWRIGHT_WS_ENDPOINT`, `PLAYWRIGHT_CHANNEL`, the
   managed Playwright Chromium, the container's bundled Chromium, a verified system channel, then the
-  platform default. An installed pinned revision returns empty options, so Playwright keeps its own
-  launch defaults. A pinned revision that is not installed falls through to a `chromium` alias or a
+  platform default. Set `PLAYWRIGHT_SCROLLBARS=classic` only for runs that measure scrollbar
+  compensation, never for a standing gate. Every Chromium launch in that run omits Playwright's
+  `--hide-scrollbars` default argument so classic scrollbars can take layout space in every case.
+  An empty or unset value preserves the launch defaults; any other value throws an `Error`.
+  Pairing `classic` with `PLAYWRIGHT_WS_ENDPOINT` throws an `Error`, even with an executable
+  override, because the server owns the launch. An installed pinned revision returns empty options
+  unless `classic` is set. A pinned revision that is not installed falls through to a `chromium` alias or a
   sibling `chromium-*` revision under the same browsers directory, because a managed container ships
   one usable build for many Playwright versions. It is its own file rather than a block in the
   vendored `configs/helpers.ts`, which every workspace receives byte-identical while only a browser

package/dist/host/manifest.json

@@ -1042,7 +1042,7 @@
 			"storage": "guides/scaffold.md",
 			"destination": "guides/scaffold.md",
 			"executable": false,
-			"digest": "02922fe230a3d85e58ad16aa9e3b2e93afd42e9d3d66b88f60bbd68b1b90e19e"
+			"digest": "a5c97efa111d3fe4832380638c025b9cd4f536819b595753c463d7ef2f094889"
 		},
 		{
 			"storage": "guides/sea.md",
@@ -2144,5 +2144,5 @@
 			]
 		}
 	],
-	"digest": "561d787211d1f705e038c6ae37fb2ceaf3d9aa147444ec06d90a129ca9c46966"
+	"digest": "ffc221eacdfb7e9c96f1374ebb04666839c32a4fe53d02979f8cae0a0e2b4e7b"
 }

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.93",
+	version: "0.0.94",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -2171,11 +2171,18 @@ export function resolveSystemBrowser(
  * discovery and is returned exactly as given: none of those environment values is checked
  * against the filesystem, because verifying an override would defeat the override. The pinned
  * managed revision outranks anything found on the host because it is deterministic. The installed
- * pinned revision returns empty options so Playwright keeps its own default launch semantics. Only
- * a discovered system channel is verified before it is named. The platform default is unverified
+ * pinned revision returns empty options unless \`PLAYWRIGHT_SCROLLBARS=classic\` is set. Only a
+ * discovered system channel is verified before it is named. The platform default is unverified
  * as well and exists only as a last resort: Windows takes \`msedge\`, which ships with the OS and
  * never collides with a foreground Chrome.
  *
+ * Set \`PLAYWRIGHT_SCROLLBARS=classic\` only for runs that measure scrollbar compensation, never
+ * for a standing gate. Every Chromium launch in that run omits Playwright's \`--hide-scrollbars\`
+ * default argument so classic scrollbars can take layout space in every case. An empty or unset
+ * value preserves the launch defaults; any other value throws an \`Error\`. Pairing \`classic\`
+ * with \`PLAYWRIGHT_WS_ENDPOINT\` throws an \`Error\`, even with an executable override, because the
+ * server owns the launch.
+ *
  * The resolver and the gate cover Chromium alone. Reopen engine selection when another
  * Playwright engine is installed and launches on the host with a \`captureFrame\` reading
  * back at its declared size, or when a journey or style divergence is recorded.
@@ -2191,26 +2198,38 @@ export function resolveBrowser(
 	environment: NodeJS.ProcessEnv,
 	root: string = BUNDLED_BROWSERS_ROOT,
 ): PlaywrightProviderOptions {
+	const scrollbars = environment.PLAYWRIGHT_SCROLLBARS
+	if (scrollbars !== undefined && scrollbars.length > 0 && scrollbars !== 'classic') {
+		throw new Error('PLAYWRIGHT_SCROLLBARS must be classic or empty')
+	}
+	const endpoint = environment.PLAYWRIGHT_WS_ENDPOINT
+	if (scrollbars === 'classic' && endpoint !== undefined && endpoint.length > 0) {
+		throw new Error('PLAYWRIGHT_SCROLLBARS=classic cannot be used with PLAYWRIGHT_WS_ENDPOINT')
+	}
+	const launch: PlaywrightProviderOptions['launchOptions'] =
+		scrollbars === 'classic' ? { ignoreDefaultArgs: ['--hide-scrollbars'] } : {}
 	const executable = environment.PLAYWRIGHT_EXECUTABLE_PATH
 	if (executable !== undefined && executable.length > 0) {
-		return { launchOptions: { executablePath: executable } }
+		return { launchOptions: { executablePath: executable, ...launch } }
 	}
-	const endpoint = environment.PLAYWRIGHT_WS_ENDPOINT
 	if (endpoint !== undefined && endpoint.length > 0) {
 		return { connectOptions: { wsEndpoint: endpoint } }
 	}
 	const requested = environment.PLAYWRIGHT_CHANNEL
 	if (requested !== undefined && requested.length > 0) {
-		return { launchOptions: { channel: requested } }
+		return { launchOptions: { channel: requested, ...launch } }
 	}
 	const managed = pinned === undefined ? undefined : resolveManagedBrowser(pinned)
 	if (managed !== undefined) {
-		return managed === pinned ? {} : { launchOptions: { executablePath: managed } }
+		if (managed === pinned) return scrollbars === 'classic' ? { launchOptions: launch } : {}
+		return { launchOptions: { executablePath: managed, ...launch } }
 	}
 	const bundled = resolveBundledBrowser(platform, root)
-	if (bundled !== undefined) return { launchOptions: { executablePath: bundled } }
+	if (bundled !== undefined) return { launchOptions: { executablePath: bundled, ...launch } }
 	const fallback = platform === 'win32' ? 'msedge' : 'chrome'
-	return { launchOptions: { channel: resolveSystemBrowser(platform, environment) ?? fallback } }
+	return {
+		launchOptions: { channel: resolveSystemBrowser(platform, environment) ?? fallback, ...launch },
+	}
 }
 `
 });