Add SPA session validation and buglist, update migration docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

node_modules/playwright-core/lib/cli/program.js

@@ -72,47 +72,6 @@ Examples:
   $ codegen
   $ codegen --target=python
   $ codegen -b webkit https://example.com`);
-function suggestedBrowsersToInstall() {
-  return import_server.registry.executables().filter((e) => e.installType !== "none" && e.type !== "tool").map((e) => e.name).join(", ");
-}
-function defaultBrowsersToInstall(options) {
-  let executables = import_server.registry.defaultExecutables();
-  if (options.noShell)
-    executables = executables.filter((e) => e.name !== "chromium-headless-shell");
-  if (options.onlyShell)
-    executables = executables.filter((e) => e.name !== "chromium");
-  return executables;
-}
-function checkBrowsersToInstall(args, options) {
-  if (options.noShell && options.onlyShell)
-    throw new Error(`Only one of --no-shell and --only-shell can be specified`);
-  const faultyArguments = [];
-  const executables = [];
-  const handleArgument = (arg) => {
-    const executable = import_server.registry.findExecutable(arg);
-    if (!executable || executable.installType === "none")
-      faultyArguments.push(arg);
-    else
-      executables.push(executable);
-    if (executable?.browserName === "chromium")
-      executables.push(import_server.registry.findExecutable("ffmpeg"));
-  };
-  for (const arg of args) {
-    if (arg === "chromium") {
-      if (!options.onlyShell)
-        handleArgument("chromium");
-      if (!options.noShell)
-        handleArgument("chromium-headless-shell");
-    } else {
-      handleArgument(arg);
-    }
-  }
-  if (process.platform === "win32")
-    executables.push(import_server.registry.findExecutable("winldd"));
-  if (faultyArguments.length)
-    throw new Error(`Invalid installation targets: ${faultyArguments.map((name) => `'${name}'`).join(", ")}. Expecting one of: ${suggestedBrowsersToInstall()}`);
-  return executables;
-}
 function printInstalledBrowsers(browsers2) {
   const browserPaths = /* @__PURE__ */ new Set();
   for (const browser of browsers2)
@@ -166,8 +125,6 @@ Playwright version: ${version}`);
   }
 }
 import_utilsBundle.program.command("install [browser...]").description("ensure browsers necessary for this version of Playwright are installed").option("--with-deps", "install system dependencies for browsers").option("--dry-run", "do not execute installation, only print information").option("--list", "prints list of browsers from all playwright installations").option("--force", "force reinstall of stable browser channels").option("--only-shell", "only install headless shell when installing chromium").option("--no-shell", "do not install chromium headless shell").action(async function(args, options) {
-  if (options.shell === false)
-    options.noShell = true;
   if ((0, import_utils.isLikelyNpxGlobal)()) {
     console.error((0, import_ascii.wrapInASCIIBox)([
       `WARNING: It looks like you are running 'npx playwright install' without first`,
@@ -189,8 +146,10 @@ import_utilsBundle.program.command("install [browser...]").description("ensure b
     ].join("\n"), 1));
   }
   try {
-    const hasNoArguments = !args.length;
-    const executables = hasNoArguments ? defaultBrowsersToInstall(options) : checkBrowsersToInstall(args, options);
+    if (options.shell === false && options.onlyShell)
+      throw new Error(`Only one of --no-shell and --only-shell can be specified`);
+    const shell = options.shell === false ? "no" : options.onlyShell ? "only" : void 0;
+    const executables = import_server.registry.resolveBrowsers(args, { shell });
     if (options.withDeps)
       await import_server.registry.installDeps(executables, !!options.dryRun);
     if (options.dryRun && options.list)
@@ -212,8 +171,8 @@ import_utilsBundle.program.command("install [browser...]").description("ensure b
       const browsers2 = await import_server.registry.listInstalledBrowsers();
       printGroupedByPlaywrightVersion(browsers2);
     } else {
-      const forceReinstall = hasNoArguments ? false : !!options.force;
-      await import_server.registry.install(executables, forceReinstall);
+      const force = args.length === 0 ? false : !!options.force;
+      await import_server.registry.install(executables, { force });
       await import_server.registry.validateHostRequirementsForExecutablesIfNeeded(executables, process.env.PW_LANG_NAME || "javascript").catch((e) => {
         e.name = "Playwright Host validation warning";
         console.error(e);
@@ -231,7 +190,7 @@ Examples:
     Install default browsers.
 
   - $ install chrome firefox
-    Install custom browsers, supports ${suggestedBrowsersToInstall()}.`);
+    Install custom browsers, supports ${import_server.registry.suggestedBrowsersToInstall()}.`);
 import_utilsBundle.program.command("uninstall").description("Removes browsers used by this installation of Playwright from the system (chromium, firefox, webkit, ffmpeg). This does not include branded channels.").option("--all", "Removes all browsers used by any Playwright installation from the system.").action(async (options) => {
   delete process.env.PLAYWRIGHT_SKIP_BROWSER_GC;
   await import_server.registry.uninstall(!!options.all).then(({ numberOfBrowsersLeft }) => {
@@ -244,10 +203,7 @@ To uninstall Playwright browsers for all installations, re-run with --all flag.`
 });
 import_utilsBundle.program.command("install-deps [browser...]").description("install dependencies necessary to run browsers (will ask for sudo permissions)").option("--dry-run", "Do not execute installation commands, only print them").action(async function(args, options) {
   try {
-    if (!args.length)
-      await import_server.registry.installDeps(defaultBrowsersToInstall({}), !!options.dryRun);
-    else
-      await import_server.registry.installDeps(checkBrowsersToInstall(args, {}), !!options.dryRun);
+    await import_server.registry.installDeps(import_server.registry.resolveBrowsers(args, {}), !!options.dryRun);
   } catch (e) {
     console.log(`Failed to install browser dependencies
 ${e}`);
@@ -259,7 +215,7 @@ Examples:
     Install dependencies for default browsers.
 
   - $ install-deps chrome firefox
-    Install dependencies for specific browsers, supports ${suggestedBrowsersToInstall()}.`);
+    Install dependencies for specific browsers, supports ${import_server.registry.suggestedBrowsersToInstall()}.`);
 const browsers = [
   { alias: "cr", name: "Chromium", type: "chromium" },
   { alias: "ff", name: "Firefox", type: "firefox" },
@@ -304,7 +260,7 @@ Examples:
 import_utilsBundle.program.command("run-driver", { hidden: true }).action(function(options) {
   (0, import_driver.runDriver)();
 });
-import_utilsBundle.program.command("run-server").option("--port <port>", "Server port").option("--host <host>", "Server host").option("--path <path>", "Endpoint Path", "/").option("--max-clients <maxClients>", "Maximum clients").option("--mode <mode>", 'Server mode, either "default" or "extension"').action(function(options) {
+import_utilsBundle.program.command("run-server", { hidden: true }).option("--port <port>", "Server port").option("--host <host>", "Server host").option("--path <path>", "Endpoint Path", "/").option("--max-clients <maxClients>", "Maximum clients").option("--mode <mode>", 'Server mode, either "default" or "extension"').action(function(options) {
   (0, import_driver.runServer)({
     port: options.port ? +options.port : void 0,
     host: options.host,
@@ -319,7 +275,7 @@ import_utilsBundle.program.command("print-api-json", { hidden: true }).action(fu
 import_utilsBundle.program.command("launch-server", { hidden: true }).requiredOption("--browser <browserName>", 'Browser name, one of "chromium", "firefox" or "webkit"').option("--config <path-to-config-file>", "JSON file with launchServer options").action(function(options) {
   (0, import_driver.launchBrowserServer)(options.browser, options.config);
 });
-import_utilsBundle.program.command("show-trace [trace...]").option("-b, --browser <browserType>", "browser to use, one of cr, chromium, ff, firefox, wk, webkit", "chromium").option("-h, --host <host>", "Host to serve trace on; specifying this option opens trace in a browser tab").option("-p, --port <port>", "Port to serve trace on, 0 for any free port; specifying this option opens trace in a browser tab").option("--stdin", "Accept trace URLs over stdin to update the viewer").description("show trace viewer").action(function(traces, options) {
+import_utilsBundle.program.command("show-trace [trace]").option("-b, --browser <browserType>", "browser to use, one of cr, chromium, ff, firefox, wk, webkit", "chromium").option("-h, --host <host>", "Host to serve trace on; specifying this option opens trace in a browser tab").option("-p, --port <port>", "Port to serve trace on, 0 for any free port; specifying this option opens trace in a browser tab").option("--stdin", "Accept trace URLs over stdin to update the viewer").description("show trace viewer").action(function(trace, options) {
   if (options.browser === "cr")
     options.browser = "chromium";
   if (options.browser === "ff")
@@ -332,12 +288,13 @@ import_utilsBundle.program.command("show-trace [trace...]").option("-b, --browse
     isServer: !!options.stdin
   };
   if (options.port !== void 0 || options.host !== void 0)
-    (0, import_traceViewer.runTraceInBrowser)(traces, openOptions).catch(logErrorAndExit);
+    (0, import_traceViewer.runTraceInBrowser)(trace, openOptions).catch(logErrorAndExit);
   else
-    (0, import_traceViewer.runTraceViewerApp)(traces, options.browser, openOptions, true).catch(logErrorAndExit);
+    (0, import_traceViewer.runTraceViewerApp)(trace, options.browser, openOptions, true).catch(logErrorAndExit);
 }).addHelpText("afterAll", `
 Examples:
 
+  $ show-trace
   $ show-trace https://example.com/trace.zip`);
 async function launchContext(options, extraOptions) {
   validateOptions(options);