@storybook/cli 10.4.0-alpha.16 → 10.4.0-alpha.18

package/dist/_node-chunks/{run-EJWCFREQ.js → run-7AY5NI5G.js}

@@ -1,19 +1,19 @@
-import CJS_COMPAT_NODE_URL_sgh3w93ap7c from 'node:url';
-import CJS_COMPAT_NODE_PATH_sgh3w93ap7c from 'node:path';
-import CJS_COMPAT_NODE_MODULE_sgh3w93ap7c from "node:module";
+import CJS_COMPAT_NODE_URL_x95a390k9yf from 'node:url';
+import CJS_COMPAT_NODE_PATH_x95a390k9yf from 'node:path';
+import CJS_COMPAT_NODE_MODULE_x95a390k9yf from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_sgh3w93ap7c.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_sgh3w93ap7c.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_sgh3w93ap7c.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_x95a390k9yf.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_x95a390k9yf.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_x95a390k9yf.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
 // ------------------------------------------------------------
 import {
   instructions
-} from "./chunk-JYLYIY6L.js";
-import "./chunk-QBNIQBHH.js";
-import "./chunk-7BQI2DK6.js";
+} from "./chunk-3VND4UGR.js";
+import "./chunk-XXTFAID7.js";
+import "./chunk-E7VJSF4M.js";
 import {
   bannerComment,
   containsDirnameUsage,
@@ -31,18 +31,18 @@ import {
   up,
   updateMainConfig,
   upgradeStorybookDependencies
-} from "./chunk-QQ7E4GEX.js";
+} from "./chunk-NMHZMXV5.js";
 import {
   slash
-} from "./chunk-UKVJ7RQN.js";
+} from "./chunk-7GFZ5XLA.js";
 import {
   require_semver
-} from "./chunk-NDN75UAD.js";
+} from "./chunk-DZENT53U.js";
 import {
   __commonJS,
   __require,
   __toESM
-} from "./chunk-TZ336D6R.js";
+} from "./chunk-F7HPRHMF.js";
 
 // ../../../node_modules/envinfo/dist/envinfo.js
 var require_envinfo = __commonJS({
@@ -4696,7 +4696,7 @@ var require_cross_spawn = __commonJS({
   "../../../node_modules/cross-spawn/index.js"(exports, module) {
     "use strict";
     var cp = __require("child_process"), parse2 = require_parse(), enoent = require_enoent();
-    function spawn(command2, args, options) {
+    function spawn2(command2, args, options) {
       let parsed = parse2(command2, args, options), spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
       return enoent.hookChildProcess(spawned, parsed), spawned;
     }
@@ -4704,8 +4704,8 @@ var require_cross_spawn = __commonJS({
       let parsed = parse2(command2, args, options), result = cp.spawnSync(parsed.command, parsed.args, parsed.options);
       return result.error = result.error || enoent.verifyENOENTSync(result.status, parsed), result;
     }
-    module.exports = spawn;
-    module.exports.spawn = spawn;
+    module.exports = spawn2;
+    module.exports.spawn = spawn2;
     module.exports.sync = spawnSync4;
     module.exports._parse = parse2;
     module.exports._enoent = enoent;
@@ -4724,7 +4724,7 @@ import {
   versions as versions5
 } from "storybook/internal/common";
 import { withTelemetry } from "storybook/internal/core-server";
-import { CLI_COLORS as CLI_COLORS5, logTracker as logTracker4, logger as logger25 } from "storybook/internal/node-logger";
+import { CLI_COLORS as CLI_COLORS5, logTracker as logTracker4, logger as logger26 } from "storybook/internal/node-logger";
 import { addToGlobalContext, telemetry as telemetry3 } from "storybook/internal/telemetry";
 import { Option, program } from "commander";
 
@@ -4763,10 +4763,10 @@ function leven(first, second, options) {
 }
 
 // src/bin/run.ts
-var import_picocolors17 = __toESM(require_picocolors(), 1);
+var import_picocolors18 = __toESM(require_picocolors(), 1);
 
 // package.json
-var version = "10.4.0-alpha.16";
+var version = "10.4.0-alpha.18";
 
 // src/add.ts
 var import_semver = __toESM(require_semver(), 1);
@@ -5006,9 +5006,9 @@ var DIR_CWD = process.cwd(), require2 = createRequire2(DIR_CWD), postinstallAddo
   } catch {
     return;
   }
-  let postinstall = moduledLoaded?.default || moduledLoaded?.postinstall || moduledLoaded, logger26 = options.logger;
+  let postinstall = moduledLoaded?.default || moduledLoaded?.postinstall || moduledLoaded, logger27 = options.logger;
   if (!postinstall || typeof postinstall != "function") {
-    logger26.error(`Error finding postinstall function for ${addonName}`);
+    logger27.error(`Error finding postinstall function for ${addonName}`);
     return;
   }
   try {
@@ -5029,7 +5029,7 @@ async function add(addon, {
   configDir: userSpecifiedConfigDir,
   yes,
   skipInstall
-}, logger26 = nodeLogger) {
+}, logger27 = nodeLogger) {
   let [addonName, inputVersion] = getVersionSpecifier(addon), { mainConfig, mainConfigPath, configDir, previewConfigPath, packageManager } = await getStorybookData({
     configDir: userSpecifiedConfigDir,
     packageManagerName: pkgMgr
@@ -5039,16 +5039,16 @@ async function add(addon, {
       Unable to find storybook config directory. Please specify your Storybook config directory with the --config-dir flag.
     `);
   if (!mainConfigPath) {
-    logger26.error("Unable to find Storybook main.js config");
+    logger27.error("Unable to find Storybook main.js config");
     return;
   }
   let shouldAddToMain = !0;
-  if (checkInstalled(addonName, mainConfig) && (shouldAddToMain = !1, !yes && (logger26.log(`The Storybook addon "${addonName}" is already present in ${mainConfigPath}.`), !await prompt.confirm({
+  if (checkInstalled(addonName, mainConfig) && (shouldAddToMain = !1, !yes && (logger27.log(`The Storybook addon "${addonName}" is already present in ${mainConfigPath}.`), !await prompt.confirm({
     message: "Do you wish to install it again?"
   }))))
     return;
   let main = await readConfig(mainConfigPath);
-  logger26.log(`Verifying ${addonName}`);
+  logger27.log(`Verifying ${addonName}`);
   let version2 = inputVersion;
   if (!version2 && isCoreAddon(addonName) && (version2 = versions.storybook), !version2) {
     let latestVersion = await packageManager.latestVersion(addonName);
@@ -5057,14 +5057,14 @@ async function add(addon, {
     version2 = latestVersion;
   }
   let storybookVersion = versions.storybook, versionIsStorybook = version2 === versions.storybook;
-  isCoreAddon(addonName) && !versionIsStorybook && logger26.warn(
+  isCoreAddon(addonName) && !versionIsStorybook && logger27.warn(
     `The version of ${addonName} (${version2}) you are installing is not the same as the version of Storybook you are using (${storybookVersion}). This may lead to unexpected behavior.`
   );
   let versionRange = packageManager.getDependencyVersion("storybook")?.match(/^[~^]/)?.[0] ?? "", addonWithVersion = versionIsStorybook ? `${addonName}@${versionRange}${storybookVersion}` : isValidVersion(version2) && !version2.includes("-pr-") ? `${addonName}@^${version2}` : `${addonName}@${version2}`;
-  logger26.log(`Installing ${addonWithVersion}`), await packageManager.addDependencies(
+  logger27.log(`Installing ${addonWithVersion}`), await packageManager.addDependencies(
     { type: "devDependencies", writeOutputToFile: !1, skipInstall },
     [addonWithVersion]
-  ), shouldAddToMain && (logger26.log(`Adding '${addon}' to the "addons" field in ${mainConfigPath}`), await setupAddonInConfig({
+  ), shouldAddToMain && (logger27.log(`Adding '${addon}' to the "addons" field in ${mainConfigPath}`), await setupAddonInConfig({
     addonName,
     mainConfigCSFFile: main,
     previewConfigPath,
@@ -5073,7 +5073,7 @@ async function add(addon, {
     packageManager: packageManager.type,
     configDir,
     yes,
-    logger: logger26,
+    logger: logger27,
     prompt,
     skipInstall
   });
@@ -5083,9 +5083,9 @@ function isValidVersion(version2) {
 }
 
 // src/automigrate/index.ts
-var import_picocolors14 = __toESM(require_picocolors(), 1);
+var import_picocolors15 = __toESM(require_picocolors(), 1);
 import { versions as versions3 } from "storybook/internal/common";
-import { logTracker as logTracker2, logger as logger17, prompt as prompt3 } from "storybook/internal/node-logger";
+import { logTracker as logTracker2, logger as logger18, prompt as prompt4 } from "storybook/internal/node-logger";
 import { AutomigrateError } from "storybook/internal/server-errors";
 
 // ../../../node_modules/tiny-invariant/dist/esm/tiny-invariant.js
@@ -5100,7 +5100,7 @@ function invariant(condition, message) {
 }
 
 // src/automigrate/index.ts
-import { dedent as dedent14 } from "ts-dedent";
+import { dedent as dedent15 } from "ts-dedent";
 
 // src/doctor/index.ts
 var import_picocolors4 = __toESM(require_picocolors(), 1);
@@ -5630,7 +5630,7 @@ import { logger as logger3 } from "storybook/internal/node-logger";
 import { promises as fs } from "fs";
 var maxConcurrentTasks = Math.max(1, os.cpus().length - 1);
 async function runCodemod(globPattern = "**/*.{stories,story}.{js,jsx,ts,tsx,mjs,mjsx,mts,mtsx}", transform, { dryRun = !1, skipFormatting = !1 } = {}) {
-  let modifiedCount = 0, unmodifiedCount = 0, errorCount = 0, { globby } = await import("./globby-5IGUGWE7.js"), files = await globby(slash(globPattern), {
+  let modifiedCount = 0, unmodifiedCount = 0, errorCount = 0, { globby } = await import("./globby-V7VJJXY6.js"), files = await globby(slash(globPattern), {
     followSymbolicLinks: !0,
     ignore: ["**/node_modules/**", "**/dist/**", "**/storybook-static/**", "**/build/**"]
   });
@@ -5641,7 +5641,7 @@ Please try a different pattern.
 `
     ), new Error("No files matched");
   try {
-    let pLimit = (await import("./p-limit-VO6RWWBJ.js")).default, limit = pLimit(maxConcurrentTasks);
+    let pLimit = (await import("./p-limit-G7HGHMQY.js")).default, limit = pLimit(maxConcurrentTasks);
     await Promise.all(
       files.map(
         (file) => limit(async () => {
@@ -6484,7 +6484,7 @@ var addonA11yParameters = {
             errors.push({ file: previewFileToUpdate, error });
           }
     }
-    let { default: pLimit } = await import("./p-limit-VO6RWWBJ.js"), limit = pLimit(10);
+    let { default: pLimit } = await import("./p-limit-G7HGHMQY.js"), limit = pLimit(10);
     if (await Promise.all(
       storyFilesToUpdate.map(
         (file) => limit(async () => {
@@ -6638,7 +6638,7 @@ var addonGlobalsApi = {
   }
 };
 async function transformStoryFiles(files, options, dryRun) {
-  let errors = [], { default: pLimit } = await import("./p-limit-VO6RWWBJ.js"), limit = pLimit(10);
+  let errors = [], { default: pLimit } = await import("./p-limit-G7HGHMQY.js"), limit = pLimit(10);
   return await Promise.all(
     files.map(
       (file) => limit(async () => {
@@ -6830,7 +6830,7 @@ function transformPackageJson(content) {
   return hasChanges ? JSON.stringify(packageJson, null, 2) : null;
 }
 var transformPackageJsonFiles = async (files, dryRun) => {
-  let errors = [], { default: pLimit } = await import("./p-limit-VO6RWWBJ.js"), limit = pLimit(10);
+  let errors = [], { default: pLimit } = await import("./p-limit-G7HGHMQY.js"), limit = pLimit(10);
   return await Promise.all(
     files.map(
       (file) => limit(async () => {
@@ -6869,7 +6869,7 @@ var transformPackageJsonFiles = async (files, dryRun) => {
       dryRun
     );
     errors.push(...packageJsonErrors);
-    let { globby } = await import("./globby-5IGUGWE7.js"), configFiles = await globby([`${configDir}/**/*`]), importErrors = await transformImportFiles(
+    let { globby } = await import("./globby-V7VJJXY6.js"), configFiles = await globby([`${configDir}/**/*`]), importErrors = await transformImportFiles(
       [...storiesPaths, ...configFiles].filter(Boolean),
       {
         ...consolidatedPackages,
@@ -7225,7 +7225,7 @@ var VITE_DEFAULT_VERSION = "^7.0.0", transformMainConfig = async (mainConfigPath
       ]);
     }
     mainConfigPath && (logger11.debug("Updating main config file..."), await transformMainConfig(mainConfigPath, dryRun)), logger11.debug("Scanning and updating import statements...");
-    let { globby } = await import("./globby-5IGUGWE7.js"), configFiles = await globby([`${configDir}/**/*`]), allFiles = [...storiesPaths, ...configFiles].filter(Boolean), transformErrors = await transformImportFiles2(
+    let { globby } = await import("./globby-V7VJJXY6.js"), configFiles = await globby([`${configDir}/**/*`]), allFiles = [...storiesPaths, ...configFiles].filter(Boolean), transformErrors = await transformImportFiles2(
       allFiles,
       {
         "@storybook/nextjs": "@storybook/nextjs-vite"
@@ -7240,6 +7240,334 @@ var VITE_DEFAULT_VERSION = "^7.0.0", transformMainConfig = async (mainConfigPath
   }
 };
 
+// src/automigrate/fixes/react-vite-to-tanstack-react.ts
+import { readFile as readFile7, writeFile as writeFile6 } from "node:fs/promises";
+import { transformImportFiles as transformImportFiles3 } from "storybook/internal/common";
+import { logger as logger12, prompt as prompt3 } from "storybook/internal/node-logger";
+
+// ../../../node_modules/tinyclip/dist/index.js
+import { spawn } from "node:child_process";
+var TIMEOUT = 2e3;
+function checkUnixCommandExists(command2) {
+  return new Promise((resolve5) => {
+    let proc = spawn("which", [command2]);
+    proc.on("error", () => resolve5(!1)), proc.on("close", (code) => resolve5(code === 0));
+  });
+}
+async function getWriteCommand() {
+  switch (process.platform) {
+    case "darwin":
+      return ["pbcopy", []];
+    case "win32":
+      return ["clip", []];
+    case "linux":
+    case "freebsd":
+    case "openbsd":
+      return process.env.WSL_DISTRO_NAME ? ["clip.exe", []] : process.env.WAYLAND_DISPLAY ? ["wl-copy", []] : await checkUnixCommandExists("xsel") ? ["xsel", ["--clipboard", "--input"]] : ["xclip", ["-selection", "clipboard", "-i"]];
+    case "android":
+      return ["termux-clipboard-set", []];
+    default:
+      return;
+  }
+}
+function writeText(text) {
+  return new Promise(async (resolve5, reject) => {
+    let command2 = await getWriteCommand();
+    if (!command2)
+      return reject(new Error("No clipboard tool found"));
+    let proc = spawn(...command2, {
+      stdio: ["pipe", "ignore", "ignore"],
+      signal: AbortSignal.timeout(TIMEOUT)
+    });
+    proc.on("error", (cause) => reject(new Error("An error occurred while copying", { cause }))), proc.on("close", (code) => code === 0 ? resolve5() : reject(new Error("An unknown error occurred while copying"))), proc.stdin.write(text), proc.stdin.end();
+  });
+}
+
+// src/automigrate/fixes/react-vite-to-tanstack-react.ts
+var import_picocolors11 = __toESM(require_picocolors(), 1);
+import { dedent as dedent9 } from "ts-dedent";
+var REACT_VITE_PACKAGE = "@storybook/react-vite", TANSTACK_REACT_PACKAGE = "@storybook/tanstack-react", TANSTACK_ROUTER_DECORATOR_MARKERS = [
+  "createMemoryHistory",
+  "createRootRoute",
+  "createRouter",
+  "RouterProvider"
+], TANSTACK_ROUTER_PACKAGES = [
+  "@tanstack/react-router",
+  "@tanstack/router-core",
+  "@tanstack/start",
+  "@tanstack/react-start"
+], fileLooksLikeTanstackRouterDecorator = (content) => TANSTACK_ROUTER_PACKAGES.some(
+  (pkg) => new RegExp(`from\\s+['"]${pkg.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")}['"]`).test(content)
+) ? TANSTACK_ROUTER_DECORATOR_MARKERS.some((marker) => content.includes(marker)) : !1, detectTanstackRouterDecorator = async ({
+  previewConfigPath,
+  configDir,
+  storiesPaths
+}) => {
+  let { globby } = await import("./globby-V7VJJXY6.js"), configFiles = configDir ? await globby([`${configDir}/**/*.{ts,tsx,js,jsx,mjs,cjs}`], {
+    ignore: ["**/node_modules/**", "**/dist/**"]
+  }) : [], candidateFiles = Array.from(
+    /* @__PURE__ */ new Set([...previewConfigPath ? [previewConfigPath] : [], ...configFiles, ...storiesPaths])
+  );
+  for (let file of candidateFiles)
+    try {
+      let content = await readFile7(file, "utf-8");
+      if (fileLooksLikeTanstackRouterDecorator(content))
+        return !0;
+    } catch {
+      continue;
+    }
+  return !1;
+}, transformMainConfig2 = async (mainConfigPath, dryRun) => {
+  try {
+    let content = await readFile7(mainConfigPath, "utf-8");
+    if (!content.includes(REACT_VITE_PACKAGE))
+      return !1;
+    let transformedContent = content.replaceAll(REACT_VITE_PACKAGE, TANSTACK_REACT_PACKAGE);
+    return transformedContent !== content && !dryRun && await writeFile6(mainConfigPath, transformedContent), transformedContent !== content;
+  } catch (error) {
+    return logger12.error(`Failed to update main config at ${mainConfigPath}: ${error}`), !1;
+  }
+}, buildAiMigrationPrompt = (previewConfigPath) => dedent9`
+    You are migrating a Storybook project from the "${REACT_VITE_PACKAGE}" framework to the
+    "${TANSTACK_REACT_PACKAGE}" framework. The framework swap in .storybook/main.* and the
+    package.json dependency change have already been performed by the Storybook automigration
+    CLI — do not redo those. Your job is to clean up the user-land code that the CLI cannot
+    safely transform.
+
+    Reference documentation:
+    https://storybook.js.org/docs/get-started/frameworks/tanstack-react
+
+    # Background
+
+    "${TANSTACK_REACT_PACKAGE}" is a TanStack Router-aware Storybook framework built on top
+    of @storybook/react-vite. It mounts every story inside a TanStack Router (in-memory
+    history) automatically. Manual router setup that users previously wired into a
+    decorator is now redundant and must be removed — leaving it in place creates a nested
+    router and breaks stories.
+
+    Telltale signs of a manual decorator that must be removed (any of these in
+    preview / decorator / story files):
+      - imports from "@tanstack/react-router", "@tanstack/router-core",
+        "@tanstack/start", or "@tanstack/react-start" used to construct a router
+      - calls to createMemoryHistory(...), createRootRoute(...), createRouter(...)
+      - JSX usage of <RouterProvider router={...} />
+      - a decorator function (e.g. const withRouter = (Story) => <RouterProvider .../>)
+        wired into "decorators: [...]" of a meta or preview
+
+    # The replacement APIs from "${TANSTACK_REACT_PACKAGE}"
+
+    All of the following are exported from "${TANSTACK_REACT_PACKAGE}" — re-exporting the
+    @storybook/react primitives plus the TanStack-specific additions. Use these instead of
+    a hand-rolled router decorator. Only opt in when a story actually needs a specific
+    route — by default the framework's auto-router is enough.
+
+    1) Preview-level default route (CSF factories — recommended).
+
+       In ${previewConfigPath ?? ".storybook/preview.*"}:
+
+         import { definePreview } from '@storybook/tanstack-react';
+         import { routeTree } from '../src/routeTree.gen'; // or a custom Route
+
+         export default definePreview({
+           // optional — registers a default route for every story in the project
+           route: routeTree,
+           parameters: { /* ... */ },
+         });
+
+    2) Per-meta route via "parameters.tanstack.router" (works with both CSF factories
+       and CSF3). Most TanStack-Router-decorator removals translate to this:
+
+         // CSF factories style (preferred when the project already uses preview.meta):
+         import preview from '#.storybook/preview';
+         import { Route } from './Page';
+
+         const meta = preview.meta({
+           title: 'Example/Page',
+           parameters: {
+             tanstack: {
+               router: {
+                 route: Route,
+               },
+             },
+           },
+         });
+
+         export const Default = meta.story();
+
+         // CSF3 style:
+         import type { Meta, StoryObj } from '@storybook/tanstack-react';
+         import { Route } from './Page';
+
+         const meta = {
+           title: 'Example/Page',
+           parameters: {
+             tanstack: { router: { route: Route } },
+           },
+         } satisfies Meta<typeof Route>;
+
+         export default meta;
+         export const Default: StoryObj<typeof meta> = {};
+
+    3) Per-story override — same shape, but on a single story's "parameters" instead of
+       the meta. Useful when one story needs a different route than the others.
+
+    4) Additional "parameters.tanstack.router" fields you can use when needed:
+         - "path"           initial pathname (e.g. '/users/$id')
+         - "params"         URL params object (typed against the route)
+         - "query"          search params object (typed against the route)
+         - "routeOverrides" map of route id -> { loader / beforeLoad / validateSearch / ... }
+                            for mocking specific routes in the registered tree
+         - "useRouterContext" function that returns a custom router context per story
+
+       Do NOT introduce any of these unless the original decorator was clearly setting up
+       that exact behavior. Remove the decorator first; only port over the bits that were
+       actually doing work.
+
+    5) Type imports. If the project uses CSF3 types, switch them from "@storybook/react"
+       (or "@storybook/react-vite") to "@storybook/tanstack-react":
+
+         - import type { Meta, StoryObj } from '@storybook/react';
+         + import type { Meta, StoryObj } from '@storybook/tanstack-react';
+
+       The TanStack-aware "Meta" infers TanStack parameter types from the route in
+       "component" / parameters, giving type-safe params/query.
+
+    # Tasks (perform in order, in the user's repository)
+
+    1. Open ${previewConfigPath ?? ".storybook/preview.*"} and remove any TanStack Router
+       decorator from the "decorators" array. The decorator may be:
+         - defined inline in this file, or
+         - imported from another module (commonly .storybook/decorators.ts,
+           .storybook/withRouter.tsx, or similar) — in that case remove BOTH the
+           import + usage here AND delete the decorator definition at its source.
+       If the source decorator file becomes empty after removal, delete the file.
+
+       Confirm "definePreview" is imported from "@storybook/tanstack-react" (not
+       "@storybook/react" or "@storybook/react-vite"). If the project has a single
+       project-wide route to register, pass it via "definePreview({ route })".
+
+    2. Search the whole repository (not just .storybook/) for any *.stories.* file that
+       declares a per-story or per-meta TanStack Router decorator and remove it. If the
+       removed decorator was setting up a specific route, port that to
+       "parameters.tanstack.router" using the APIs above (route / path / params / query /
+       routeOverrides — whichever applies).
+
+    3. Drop now-unused imports of: RouterProvider, createRouter, createMemoryHistory,
+       createRootRoute, Outlet (from "@tanstack/react-router" / "@tanstack/router-core" /
+       "@tanstack/start" / "@tanstack/react-start"). Keep imports that are still
+       legitimately used elsewhere in the file (Link, useNavigate, createRoute when used
+       to build a Route passed to "parameters.tanstack.router.route", etc.).
+
+    4. Update story-type imports from "@storybook/react" / "@storybook/react-vite" to
+       "@storybook/tanstack-react" wherever the story uses TanStack router parameters,
+       so the types pick up the TanStack additions.
+
+    5. Preserve CSF factories syntax. If the file uses
+       "definePreview({...})" / "preview.meta({...})" / "meta.story(...)", keep that shape;
+       only mutate the affected fields. Do not rewrite CSF1/CSF2/CSF3 -> CSF factories or
+       vice versa.
+
+    6. Preserve all other decorators, parameters, args, argTypes, loaders, beforeEach,
+       tags, and globals exactly as they were. Only the TanStack Router decorator is
+       being removed.
+
+    7. Do not edit .storybook/main.*, package.json, or any lockfile — those are already
+       handled by the automigration CLI.
+
+    # Verification checklist before finishing
+
+      - No remaining manual "RouterProvider", "createRouter", "createMemoryHistory",
+        "createRootRoute" usage in preview, .storybook/**, or *.stories.*.
+      - "decorators" arrays no longer contain the removed TanStack Router decorator.
+      - All previously imported router symbols that are no longer referenced are gone.
+      - Story files importing TanStack-aware types use "@storybook/tanstack-react".
+      - TypeScript still compiles. Storybook still loads. Stories that don't need a
+        specific route now rely on the framework's default in-memory router; stories
+        that do specify a route do so via "parameters.tanstack.router".
+  `, reactViteToTanstackReact = {
+  id: "react-vite-to-tanstack-react",
+  link: "https://storybook.js.org/docs/get-started/frameworks/tanstack-react",
+  defaultSelected: !1,
+  async check({
+    packageManager,
+    previewConfigPath,
+    configDir,
+    storiesPaths
+  }) {
+    let allDeps = packageManager.getAllDependencies(), hasReactVitePackage = !!allDeps[REACT_VITE_PACKAGE], hasTanstackRouter = TANSTACK_ROUTER_PACKAGES.some((pkg) => !!allDeps[pkg]);
+    return !hasReactVitePackage || !hasTanstackRouter ? null : {
+      hasTanstackRouterDecorator: await detectTanstackRouterDecorator({
+        previewConfigPath,
+        configDir,
+        storiesPaths: storiesPaths ?? []
+      })
+    };
+  },
+  prompt() {
+    return `Migrate from ${REACT_VITE_PACKAGE} to ${TANSTACK_REACT_PACKAGE} (TanStack Router-aware framework)`;
+  },
+  async run({
+    result,
+    dryRun = !1,
+    mainConfigPath,
+    previewConfigPath,
+    storiesPaths,
+    configDir,
+    packageManager,
+    storybookVersion,
+    yes
+  }) {
+    if (!result)
+      return;
+    logger12.step(`Migrating from ${REACT_VITE_PACKAGE} to ${TANSTACK_REACT_PACKAGE}...`), dryRun ? logger12.debug("Dry run: Skipping package.json updates.") : (logger12.debug("Updating package.json files..."), await packageManager.removeDependencies([REACT_VITE_PACKAGE]), await packageManager.addDependencies({ type: "devDependencies", skipInstall: !0 }, [
+      `${TANSTACK_REACT_PACKAGE}@${storybookVersion}`
+    ])), mainConfigPath && (logger12.debug("Updating main config file..."), await transformMainConfig2(mainConfigPath, dryRun)), logger12.debug("Scanning and updating import statements...");
+    let { globby } = await import("./globby-V7VJJXY6.js"), configFiles = configDir ? await globby([`${configDir}/**/*.{ts,tsx,js,jsx,mjs,cjs}`], {
+      ignore: ["**/node_modules/**", "**/dist/**"]
+    }) : [], allFiles = [...storiesPaths, ...configFiles, previewConfigPath].filter(
+      Boolean
+    ), transformErrors = await transformImportFiles3(
+      allFiles,
+      {
+        [REACT_VITE_PACKAGE]: TANSTACK_REACT_PACKAGE
+      },
+      !!dryRun
+    );
+    if (transformErrors.length > 0 && (logger12.warn(`Encountered ${transformErrors.length} errors during file transformation:`), transformErrors.forEach(({ file, error }) => {
+      logger12.warn(`  - ${file}: ${error.message}`);
+    })), result.hasTanstackRouterDecorator && (logger12.logBox(
+      dedent9`
+          We detected what looks like a manual TanStack Router decorator in
+          ${import_picocolors11.default.cyan(previewConfigPath ?? ".storybook/preview")}.
+
+          ${import_picocolors11.default.bold(TANSTACK_REACT_PACKAGE)} wraps every story in a TanStack Router
+          automatically (see ${import_picocolors11.default.yellow(
+        "https://storybook.js.org/docs/get-started/frameworks/tanstack-react"
+      )}), so that decorator is no longer needed and should be removed.
+        `
+    ), yes ? !1 : await prompt3.confirm({
+      message: "Would you like a ready-to-paste AI prompt to help remove the now-unused TanStack Router decorator?",
+      initialValue: !0
+    }))) {
+      let aiPrompt = buildAiMigrationPrompt(previewConfigPath), separator = import_picocolors11.default.dim("\u2500".repeat(60)), clipboardOk = !1;
+      try {
+        await writeText(aiPrompt), clipboardOk = !0;
+      } catch {
+      }
+      logger12.logBox(
+        dedent9`${clipboardOk ? "AI migration prompt copied to clipboard. Full prompt below:" : "Clipboard not available in this environment. Copy the AI migration prompt below manually:"}
+
+            ${separator}
+            ${aiPrompt}
+            ${separator}`
+      );
+    }
+    logger12.step("Migration completed successfully!"), logger12.log(
+      "For more information, see: https://storybook.js.org/docs/get-started/frameworks/tanstack-react"
+    );
+  }
+};
+
 // src/automigrate/fixes/remove-addon-interactions.ts
 import { getAddonNames as getAddonNames5, removeAddon as removeAddon4 } from "storybook/internal/common";
 var removeAddonInteractions = {
@@ -7262,10 +7590,10 @@ var removeAddonInteractions = {
 };
 
 // src/automigrate/fixes/remove-docs-autodocs.ts
-var import_picocolors11 = __toESM(require_picocolors(), 1);
+var import_picocolors12 = __toESM(require_picocolors(), 1);
 import { Tag } from "storybook/internal/core-server";
 import { readConfig as readConfig2 } from "storybook/internal/csf-tools";
-var logger12 = {
+var logger13 = {
   log: (message) => {
     process.env.NODE_ENV !== "test" && console.log(message);
   }
@@ -7284,13 +7612,13 @@ var logger12 = {
       return null;
     }
   },
-  prompt: () => `${import_picocolors11.default.cyan("docs.autodocs")} has been removed in Storybook 9 and will be removed from your configuration.`,
+  prompt: () => `${import_picocolors12.default.cyan("docs.autodocs")} has been removed in Storybook 9 and will be removed from your configuration.`,
   async run({ result, dryRun, mainConfigPath, previewConfigPath }) {
     let { autodocs } = result;
-    logger12.log(`\u{1F504} Updating ${import_picocolors11.default.cyan("docs")} parameter in main config file...`), await updateMainConfig({ mainConfigPath, dryRun: !!dryRun }, async (main) => {
+    logger13.log(`\u{1F504} Updating ${import_picocolors12.default.cyan("docs")} parameter in main config file...`), await updateMainConfig({ mainConfigPath, dryRun: !!dryRun }, async (main) => {
       let docs = main.getFieldValue(["docs"]) || {};
       dryRun || (delete docs.autodocs, Object.keys(docs).length === 0 ? main.removeField(["docs"]) : main.setFieldValue(["docs"], docs));
-    }), autodocs === !0 && previewConfigPath && (logger12.log(`\u{1F504} Updating ${import_picocolors11.default.cyan("tags")} parameter in preview config file...`), await updateMainConfig(
+    }), autodocs === !0 && previewConfigPath && (logger13.log(`\u{1F504} Updating ${import_picocolors12.default.cyan("tags")} parameter in preview config file...`), await updateMainConfig(
       { mainConfigPath: previewConfigPath, dryRun: !!dryRun },
       async (preview) => {
         let tags = preview.getFieldValue(["tags"]) || [];
@@ -7301,7 +7629,7 @@ var logger12 = {
 };
 
 // src/automigrate/fixes/remove-essentials.ts
-import { getAddonNames as getAddonNames6, removeAddon as removeAddon5, transformImportFiles as transformImportFiles3 } from "storybook/internal/common";
+import { getAddonNames as getAddonNames6, removeAddon as removeAddon5, transformImportFiles as transformImportFiles4 } from "storybook/internal/common";
 
 // src/automigrate/fixes/remove-essentials.utils.ts
 function moveEssentialOptions(dryRun, essentialsOptions) {
@@ -7395,7 +7723,7 @@ var consolidatedAddons = {
           packageManager,
           skipInstall: !0
         });
-      let errors = await transformImportFiles3(
+      let errors = await transformImportFiles4(
         [...storiesPaths, mainConfigPath, previewConfigPath].filter(Boolean),
         consolidatedAddons,
         dryRun
@@ -7421,13 +7749,13 @@ ${errors.map(({ file, error }) => `- ${file}: ${error.message}`).join(`
 };
 
 // src/automigrate/fixes/renderer-to-framework.ts
-import { readFile as readFile7, writeFile as writeFile6 } from "node:fs/promises";
+import { readFile as readFile8, writeFile as writeFile7 } from "node:fs/promises";
 import {
   frameworkPackages as frameworkPackages4,
   frameworkToRenderer,
   rendererPackages as rendererPackages2
 } from "storybook/internal/common";
-import { logger as logger13 } from "storybook/internal/node-logger";
+import { logger as logger14 } from "storybook/internal/node-logger";
 var getAllDependencies = (packageJson) => Object.keys({
   ...packageJson.dependencies || {},
   ...packageJson.devDependencies || {}
@@ -7435,13 +7763,13 @@ var getAllDependencies = (packageJson) => Object.keys({
   let regex = new RegExp(`(['"])${renderer}(['"])`, "g");
   return regex.test(source) ? source.replace(regex, `$1${framework}$2`) : null;
 }, transformSourceFiles = async (files, renderer, framework, dryRun) => {
-  let errors = [], { default: pLimit } = await import("./p-limit-VO6RWWBJ.js"), limit = pLimit(10);
+  let errors = [], { default: pLimit } = await import("./p-limit-G7HGHMQY.js"), limit = pLimit(10);
   return await Promise.all(
     files.map(
       (file) => limit(async () => {
         try {
-          let contents = await readFile7(file, "utf-8"), transformed = replaceImports(contents, renderer, framework);
-          !dryRun && transformed && await writeFile6(file, transformed);
+          let contents = await readFile8(file, "utf-8"), transformed = replaceImports(contents, renderer, framework);
+          !dryRun && transformed && await writeFile7(file, transformed);
         } catch (error) {
           errors.push({ file, error });
         }
@@ -7450,13 +7778,13 @@ var getAllDependencies = (packageJson) => Object.keys({
   ), errors;
 }, removeRendererInPackageJson = async (packageJsonPath, renderer, dryRun) => {
   try {
-    let content = await readFile7(packageJsonPath, "utf-8"), packageJson = JSON.parse(content), hasChanges = !1;
-    return packageJson.dependencies?.[renderer] && (delete packageJson.dependencies[renderer], hasChanges = !0), packageJson.devDependencies?.[renderer] && (delete packageJson.devDependencies[renderer], hasChanges = !0), !dryRun && hasChanges && await writeFile6(packageJsonPath, JSON.stringify(packageJson, null, 2)), hasChanges;
+    let content = await readFile8(packageJsonPath, "utf-8"), packageJson = JSON.parse(content), hasChanges = !1;
+    return packageJson.dependencies?.[renderer] && (delete packageJson.dependencies[renderer], hasChanges = !0), packageJson.devDependencies?.[renderer] && (delete packageJson.devDependencies[renderer], hasChanges = !0), !dryRun && hasChanges && await writeFile7(packageJsonPath, JSON.stringify(packageJson, null, 2)), hasChanges;
   } catch (error) {
     throw new Error(`Failed to update package.json: ${error}`);
   }
 }, checkPackageJson = async (packageJsonPath) => {
-  let content = await readFile7(packageJsonPath, "utf-8"), packageJson = JSON.parse(content), dependencies = getAllDependencies(packageJson), frameworks = detectFrameworks(dependencies);
+  let content = await readFile8(packageJsonPath, "utf-8"), packageJson = JSON.parse(content), dependencies = getAllDependencies(packageJson), frameworks = detectFrameworks(dependencies);
   if (frameworks.length === 0)
     return null;
   let renderers = detectRenderers(dependencies);
@@ -7490,25 +7818,25 @@ var getAllDependencies = (packageJson) => Object.keys({
     let { result, dryRun = !1, storiesPaths, configDir } = options;
     for (let selectedFramework of result.frameworks) {
       if (!frameworkPackages4[selectedFramework]) {
-        logger13.warn(`Framework name not found for ${selectedFramework}, skipping.`);
+        logger14.warn(`Framework name not found for ${selectedFramework}, skipping.`);
         continue;
       }
       let rendererName = frameworkToRenderer[frameworkPackages4[selectedFramework]], [rendererPackage] = Object.entries(rendererPackages2).find(([, renderer]) => renderer === rendererName) ?? [];
       if (!rendererPackage) {
-        logger13.warn(`Renderer package not found for ${selectedFramework}, skipping.`);
+        logger14.warn(`Renderer package not found for ${selectedFramework}, skipping.`);
         continue;
       }
       if (rendererPackage === selectedFramework)
         continue;
-      logger13.debug(`
+      logger14.debug(`
 Migrating ${rendererPackage} to ${selectedFramework}`);
-      let { globby } = await import("./globby-5IGUGWE7.js"), configFiles = await globby([`${configDir}/**/*`]);
+      let { globby } = await import("./globby-V7VJJXY6.js"), configFiles = await globby([`${configDir}/**/*`]);
       await transformSourceFiles(
         [...storiesPaths, ...configFiles].filter(Boolean),
         rendererPackage,
         selectedFramework,
         dryRun
-      ), logger13.debug("Updating package.json files..."), await Promise.all(
+      ), logger14.debug("Updating package.json files..."), await Promise.all(
         result.packageJsonFiles.map(
           (file) => removeRendererInPackageJson(file, rendererPackage, dryRun)
         )
@@ -7521,7 +7849,7 @@ Migrating ${rendererPackage} to ${selectedFramework}`);
 import { existsSync as existsSync2 } from "node:fs";
 import { basename as basename2, dirname as dirname2, isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "node:path";
 import { findConfigFile, loadMainConfig } from "storybook/internal/common";
-import { logger as logger14 } from "storybook/internal/node-logger";
+import { logger as logger15 } from "storybook/internal/node-logger";
 
 // ../../core/src/shared/constants/config-folder.ts
 var RN_STORYBOOK_DIR = ".rnstorybook";
@@ -7571,7 +7899,7 @@ var resolveAbsoluteConfigDir = (configDir) => isAbsolute2(configDir) ? configDir
           try {
             cfg = await loadMainConfig({ configDir: dir });
           } catch (e) {
-            logger14.debug(
+            logger15.debug(
               `Failed to load Storybook main config at ${dir}: ${e instanceof Error ? e.message : String(e)}`
             );
             continue;
@@ -7595,27 +7923,27 @@ var resolveAbsoluteConfigDir = (configDir) => isAbsolute2(configDir) ? configDir
 
 // src/automigrate/fixes/rnstorybook-config.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { readFile as readFile8, rename, writeFile as writeFile7 } from "node:fs/promises";
+import { readFile as readFile9, rename, writeFile as writeFile8 } from "node:fs/promises";
 import { join as join3 } from "node:path";
-import { dedent as dedent9 } from "ts-dedent";
+import { dedent as dedent10 } from "ts-dedent";
 async function renameInFile(filePath, oldText, newText) {
   try {
-    let updatedContent = (await readFile8(filePath, "utf8")).replaceAll(oldText, newText);
-    await writeFile7(filePath, updatedContent, "utf8");
+    let updatedContent = (await readFile9(filePath, "utf8")).replaceAll(oldText, newText);
+    await writeFile8(filePath, updatedContent, "utf8");
   } catch (error) {
     console.error(`Error updating references in ${filePath}:`, error);
   }
 }
 var getDotStorybookReferences = async (searchDir) => {
   try {
-    let { globby } = await import("./globby-5IGUGWE7.js"), { readFile: readFile10 } = await import("node:fs/promises"), files = await globby(`${searchDir}/**/*`, {
+    let { globby } = await import("./globby-V7VJJXY6.js"), { readFile: readFile11 } = await import("node:fs/promises"), files = await globby(`${searchDir}/**/*`, {
       onlyFiles: !0,
       gitignore: !0
     }), referencedFiles = [];
     return await Promise.all(
       files.map(async (file) => {
         try {
-          (await readFile10(file, "utf8")).includes(".storybook") && referencedFiles.push(file);
+          (await readFile11(file, "utf8")).includes(".storybook") && referencedFiles.push(file);
         } catch {
         }
       })
@@ -7629,11 +7957,11 @@ var getDotStorybookReferences = async (searchDir) => {
   async check({ packageManager, mainConfigPath }) {
     if (!packageManager.getAllDependencies()["@storybook/react-native"])
       return null;
-    let projectDir = mainConfigPath ? join3(mainConfigPath, "..", "..") : process.cwd(), storybookDir = join3(projectDir, ".storybook"), rnStorybookDir = join3(projectDir, RN_STORYBOOK_DIR), { globby } = await import("./globby-5IGUGWE7.js"), requiresFiles = await globby(join3(storybookDir, "storybook.requires.*"));
+    let projectDir = mainConfigPath ? join3(mainConfigPath, "..", "..") : process.cwd(), storybookDir = join3(projectDir, ".storybook"), rnStorybookDir = join3(projectDir, RN_STORYBOOK_DIR), { globby } = await import("./globby-V7VJJXY6.js"), requiresFiles = await globby(join3(storybookDir, "storybook.requires.*"));
     return existsSync3(storybookDir) && requiresFiles.length > 0 && !existsSync3(rnStorybookDir) ? { storybookDir, rnStorybookDir } : null;
   },
   prompt() {
-    return dedent9`We'll rename your .storybook directory to .rnstorybook and update all references to it.`;
+    return dedent10`We'll rename your .storybook directory to .rnstorybook and update all references to it.`;
   },
   async run({ result: { storybookDir, rnStorybookDir }, dryRun, packageManager }) {
     let instanceDir = packageManager.instanceDir, dotStorybookReferences = await getDotStorybookReferences(instanceDir);
@@ -7646,8 +7974,8 @@ var getDotStorybookReferences = async (searchDir) => {
 };
 
 // src/automigrate/fixes/storybook-package-name-conflict.ts
-var import_picocolors12 = __toESM(require_picocolors(), 1);
-import { dedent as dedent10 } from "ts-dedent";
+var import_picocolors13 = __toESM(require_picocolors(), 1);
+import { dedent as dedent11 } from "ts-dedent";
 var storybookPackageNameConflict = {
   id: "storybookPackageNameConflict",
   promptType: "notification",
@@ -7657,15 +7985,15 @@ var storybookPackageNameConflict = {
     return packageName === "storybook" ? { packageName } : null;
   },
   prompt() {
-    return dedent10`
-      Your package.json ${import_picocolors12.default.cyan('"name"')} field is set to ${import_picocolors12.default.cyan('"storybook"')}.
+    return dedent11`
+      Your package.json ${import_picocolors13.default.cyan('"name"')} field is set to ${import_picocolors13.default.cyan('"storybook"')}.
 
       In npm, pnpm, or yarn workspaces this creates a symlink at
-      ${import_picocolors12.default.yellow("node_modules/storybook")} that shadows the real Storybook
-      package, causing ${import_picocolors12.default.red('"Cannot find module storybook/internal/..."')} errors.
+      ${import_picocolors13.default.yellow("node_modules/storybook")} that shadows the real Storybook
+      package, causing ${import_picocolors13.default.red('"Cannot find module storybook/internal/..."')} errors.
 
-      To fix this, rename the ${import_picocolors12.default.cyan('"name"')} field in your package.json
-      to something other than ${import_picocolors12.default.cyan('"storybook"')} (e.g. "my-storybook", "docs", "@myorg/storybook").
+      To fix this, rename the ${import_picocolors13.default.cyan('"name"')} field in your package.json
+      to something other than ${import_picocolors13.default.cyan('"storybook"')} (e.g. "my-storybook", "docs", "@myorg/storybook").
     `;
   }
 };
@@ -7675,8 +8003,8 @@ var import_semver5 = __toESM(require_semver(), 1);
 import { readFileSync as readFileSync4 } from "node:fs";
 import { dirname as dirname3 } from "node:path";
 import { isCorePackage, isSatelliteAddon } from "storybook/internal/common";
-import { logger as logger15 } from "storybook/internal/node-logger";
-import { dedent as dedent11 } from "ts-dedent";
+import { logger as logger16 } from "storybook/internal/node-logger";
+import { dedent as dedent12 } from "ts-dedent";
 async function getLatestVersions(packageManager, packages) {
   return Promise.all(
     packages.map(async ([packageName]) => ({
@@ -7687,14 +8015,14 @@ async function getLatestVersions(packageManager, packages) {
   );
 }
 function isValidVersionType(packageName, specifier) {
-  return specifier.startsWith("patch:") || specifier.startsWith("file:") || specifier.startsWith("link:") || specifier.startsWith("portal:") || specifier.startsWith("git:") || specifier.startsWith("git+") || specifier.startsWith("http:") || specifier.startsWith("https:") || specifier.startsWith("workspace:") ? (logger15.debug(`Skipping ${packageName} as it does not have a valid version type: ${specifier}`), !1) : !0;
+  return specifier.startsWith("patch:") || specifier.startsWith("file:") || specifier.startsWith("link:") || specifier.startsWith("portal:") || specifier.startsWith("git:") || specifier.startsWith("git+") || specifier.startsWith("http:") || specifier.startsWith("https:") || specifier.startsWith("workspace:") ? (logger16.debug(`Skipping ${packageName} as it does not have a valid version type: ${specifier}`), !1) : !0;
 }
 var upgradeStorybookRelatedDependencies = {
   id: "upgrade-storybook-related-dependencies",
   promptType: "auto",
   defaultSelected: !1,
   async check({ packageManager, storybookVersion }) {
-    logger15.debug("Checking for incompatible storybook packages...");
+    logger16.debug("Checking for incompatible storybook packages...");
     let analyzedPackages = await getIncompatibleStorybookPackages({
       currentStorybookVersion: storybookVersion,
       packageManager,
@@ -7715,7 +8043,7 @@ var upgradeStorybookRelatedDependencies = {
   },
   async run({ result: { upgradable }, packageManager, dryRun }) {
     if (dryRun) {
-      logger15.log(dedent11`
+      logger16.log(dedent12`
         The following would have been upgraded:
         ${upgradable.map(
         ({ packageName, afterVersion, beforeVersion }) => `${packageName}: ${beforeVersion} => ${afterVersion}`
@@ -7747,7 +8075,7 @@ import {
 } from "storybook/internal/common";
 import { readConfig as readConfig3 } from "storybook/internal/csf-tools";
 import { CommonJsConfigNotSupportedError } from "storybook/internal/server-errors";
-import { dedent as dedent12 } from "ts-dedent";
+import { dedent as dedent13 } from "ts-dedent";
 var wrapGetAbsolutePath = {
   id: "wrap-getAbsolutePath",
   link: "https://storybook.js.org/docs/faq#how-do-i-fix-module-resolution-in-special-environments",
@@ -7764,7 +8092,7 @@ var wrapGetAbsolutePath = {
     return { storybookVersion, isStorybookInMonorepo, isPnp, isConfigTypescript };
   },
   prompt() {
-    return dedent12`We have detected that you're using Storybook in a monorepo or PnP project. Some fields in your main config must be updated.`;
+    return dedent13`We have detected that you're using Storybook in a monorepo or PnP project. Some fields in your main config must be updated.`;
   },
   async run({ dryRun, mainConfigPath, result }) {
     await updateMainConfig({ dryRun: !!dryRun, mainConfigPath }, (mainConfig) => {
@@ -7796,6 +8124,7 @@ var allFixes = [
   rnOndeviceAddonsToDeviceAddons,
   migrateAddonConsole,
   nextjsToNextjsVite,
+  reactViteToTanstackReact,
   removeAddonInteractions,
   rendererToFramework,
   removeEssentials,
@@ -7808,9 +8137,9 @@ var allFixes = [
 var commandFixes = [csfFactories];
 
 // src/automigrate/helpers/logMigrationSummary.ts
-var import_picocolors13 = __toESM(require_picocolors(), 1);
-import { CLI_COLORS as CLI_COLORS2, logger as logger16 } from "storybook/internal/node-logger";
-import { dedent as dedent13 } from "ts-dedent";
+var import_picocolors14 = __toESM(require_picocolors(), 1);
+import { CLI_COLORS as CLI_COLORS2, logger as logger17 } from "storybook/internal/node-logger";
+import { dedent as dedent14 } from "ts-dedent";
 var messageDivider2 = `
 
 `, segmentDivider = `
@@ -7820,23 +8149,23 @@ var messageDivider2 = `
 `;
 function getGlossaryMessages(fixSummary, fixResults) {
   let messages2 = [];
-  return fixSummary.succeeded.length > 0 && (messages2.push(import_picocolors13.default.bold("Successful migrations:")), messages2.push(fixSummary.succeeded.map((m) => import_picocolors13.default.green(m)).join(", "))), Object.keys(fixSummary.failed).length > 0 && (messages2.push(import_picocolors13.default.bold("Failed migrations:")), messages2.push(
-    Object.entries(fixSummary.failed).map(([id, error]) => `${import_picocolors13.default.bold(import_picocolors13.default.red(id))}:
+  return fixSummary.succeeded.length > 0 && (messages2.push(import_picocolors14.default.bold("Successful migrations:")), messages2.push(fixSummary.succeeded.map((m) => import_picocolors14.default.green(m)).join(", "))), Object.keys(fixSummary.failed).length > 0 && (messages2.push(import_picocolors14.default.bold("Failed migrations:")), messages2.push(
+    Object.entries(fixSummary.failed).map(([id, error]) => `${import_picocolors14.default.bold(import_picocolors14.default.red(id))}:
 ${error}`).join(`
 `)
-  )), fixSummary.manual.length > 0 && (messages2.push(import_picocolors13.default.bold("Manual migrations:")), messages2.push(
+  )), fixSummary.manual.length > 0 && (messages2.push(import_picocolors14.default.bold("Manual migrations:")), messages2.push(
     fixSummary.manual.map(
-      (m) => fixResults[m] === "manual_succeeded" /* MANUAL_SUCCEEDED */ ? import_picocolors13.default.green(m) : import_picocolors13.default.blue(m)
+      (m) => fixResults[m] === "manual_succeeded" /* MANUAL_SUCCEEDED */ ? import_picocolors14.default.green(m) : import_picocolors14.default.blue(m)
     ).join(", ")
-  )), fixSummary.skipped.length > 0 && (messages2.push(import_picocolors13.default.bold("Skipped migrations:")), messages2.push(fixSummary.skipped.map((m) => import_picocolors13.default.cyan(m)).join(", "))), messages2;
+  )), fixSummary.skipped.length > 0 && (messages2.push(import_picocolors14.default.bold("Skipped migrations:")), messages2.push(fixSummary.skipped.map((m) => import_picocolors14.default.cyan(m)).join(", "))), messages2;
 }
 function logMigrationSummary({
   fixResults,
   fixSummary
 }) {
   let messages2 = [];
-  messages2.push(getGlossaryMessages(fixSummary, fixResults).join(messageDivider2)), messages2.push(dedent13`If you'd like to run the migrations again, you can do so by running 
-    ${import_picocolors13.default.cyan("npx storybook automigrate")}
+  messages2.push(getGlossaryMessages(fixSummary, fixResults).join(messageDivider2)), messages2.push(dedent14`If you'd like to run the migrations again, you can do so by running 
+    ${import_picocolors14.default.cyan("npx storybook automigrate")}
     
     The automigrations try to migrate common patterns in your project, but might not contain everything needed to migrate to the latest version of Storybook.
     
@@ -7847,21 +8176,21 @@ function logMigrationSummary({
   let hasNoFixes = Object.values(fixResults).every((r) => r === "unnecessary" /* UNNECESSARY */), hasFailures2 = Object.values(fixResults).some(
     (r) => r === "failed" /* FAILED */ || r === "check_failed" /* CHECK_FAILED */
   );
-  hasNoFixes ? logger16.warn("No migrations were applicable to your project") : hasFailures2 ? logger16.error("Migration check ran with failures") : logger16.step(CLI_COLORS2.success("Migration check ran successfully")), logger16.log(messages2.filter(Boolean).join(segmentDivider));
+  hasNoFixes ? logger17.warn("No migrations were applicable to your project") : hasFailures2 ? logger17.error("Migration check ran with failures") : logger17.step(CLI_COLORS2.success("Migration check ran successfully")), logger17.log(messages2.filter(Boolean).join(segmentDivider));
 }
 
 // src/automigrate/index.ts
 var logAvailableMigrations = () => {
-  let availableFixes = [...allFixes, ...commandFixes].map((f) => import_picocolors14.default.yellow(f.id)).map((x) => `- ${x}`).join(`
+  let availableFixes = [...allFixes, ...commandFixes].map((f) => import_picocolors15.default.yellow(f.id)).map((x) => `- ${x}`).join(`
 `);
-  logger17.log(dedent14`
+  logger18.log(dedent15`
     The following migrations are available:
     ${availableFixes}
   `);
 }, hasFailures = (fixResults) => Object.values(fixResults || {}).some(
   (r) => r === "failed" /* FAILED */ || r === "check_failed" /* CHECK_FAILED */
 ), doAutomigrate = async (options) => {
-  logger17.debug("Extracting storybook data...");
+  logger18.debug("Extracting storybook data...");
   let {
     mainConfig,
     mainConfigPath,
@@ -7895,7 +8224,7 @@ var logAvailableMigrations = () => {
   ) && !options.skipInstall && await packageManager.installDependencies(), outcome && !options.skipDoctor && await doctor({ configDir, packageManager: options.packageManager }), hasFailures(outcome?.fixResults)) {
     let failedMigrations = Object.entries(outcome?.fixResults ?? {}).filter(([, status]) => status === "failed" /* FAILED */ || status === "check_failed" /* CHECK_FAILED */).map(([id, status]) => {
       let statusLabel = status === "check_failed" /* CHECK_FAILED */ ? "check failed" : "failed";
-      return `${import_picocolors14.default.cyan(id)} (${statusLabel})`;
+      return `${import_picocolors15.default.cyan(id)} (${statusLabel})`;
     });
     throw new AutomigrateError({ errors: failedMigrations });
   }
@@ -7924,7 +8253,7 @@ var logAvailableMigrations = () => {
     return logAvailableMigrations(), null;
   let commandFix = commandFixes.find((f) => f.id === fixId);
   if (commandFix)
-    return logger17.step(`Running migration ${import_picocolors14.default.magenta(fixId)}..`), await commandFix.run({
+    return logger18.step(`Running migration ${import_picocolors15.default.magenta(fixId)}..`), await commandFix.run({
       mainConfigPath,
       previewConfigPath,
       packageManager,
@@ -7939,8 +8268,8 @@ var logAvailableMigrations = () => {
     }), null;
   let selectedFixes = inputFixes || allFixes.filter((fix) => !(fix.id === upgradeStorybookRelatedDependencies.id && isLatest === !1 && fixId !== upgradeStorybookRelatedDependencies.id)), fixes = fixId ? selectedFixes.filter((f) => f.id === fixId) : selectedFixes;
   if (fixId && fixes.length === 0)
-    return logger17.log(`\u{1F4ED} No migrations found for ${import_picocolors14.default.magenta(fixId)}.`), logAvailableMigrations(), null;
-  logger17.step("Checking possible migrations..");
+    return logger18.log(`\u{1F4ED} No migrations found for ${import_picocolors15.default.magenta(fixId)}.`), logAvailableMigrations(), null;
+  logger18.step("Checking possible migrations..");
   let { fixResults, fixSummary, preCheckFailure } = await runFixes({
     fixes,
     packageManager,
@@ -7981,7 +8310,7 @@ async function runFixes({
   for (let i = 0; i < fixes.length; i += 1) {
     let f = fixes[i], result;
     try {
-      logger17.debug(`Running ${import_picocolors14.default.cyan(f.id)} migration checks`), result = await f.check({
+      logger18.debug(`Running ${import_picocolors15.default.cyan(f.id)} migration checks`), result = await f.check({
         packageManager,
         configDir,
         rendererPackage,
@@ -7991,14 +8320,14 @@ async function runFixes({
         mainConfigPath,
         storiesPaths,
         hasCsfFactoryPreview
-      }), logger17.debug(`End of ${import_picocolors14.default.cyan(f.id)} migration checks`);
+      }), logger18.debug(`End of ${import_picocolors15.default.cyan(f.id)} migration checks`);
     } catch (error) {
-      logger17.warn(`\u26A0\uFE0F  failed to check fix ${import_picocolors14.default.bold(f.id)}`), error instanceof Error && (logger17.error(`
+      logger18.warn(`\u26A0\uFE0F  failed to check fix ${import_picocolors15.default.bold(f.id)}`), error instanceof Error && (logger18.error(`
 ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "check_failed" /* CHECK_FAILED */;
     }
     if (result) {
       let promptType = typeof f.promptType == "function" ? await f.promptType(result) : f.promptType ?? "auto";
-      logger17.log(`\u{1F50E} found a '${import_picocolors14.default.cyan(f.id)}' migration:`);
+      logger18.log(`\u{1F50E} found a '${import_picocolors15.default.cyan(f.id)}' migration:`);
       let getTitle = () => {
         switch (promptType) {
           case "auto":
@@ -8008,11 +8337,11 @@ ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "
           case "notification":
             return "Migration notification";
         }
-      }, currentTaskLogger = prompt3.taskLog({
+      }, currentTaskLogger = prompt4.taskLog({
         id: `automigrate-task-${f.id}`,
-        title: `${getTitle()}: ${import_picocolors14.default.cyan(f.id)}`
+        title: `${getTitle()}: ${import_picocolors15.default.cyan(f.id)}`
       });
-      logger17.logBox(f.prompt());
+      logger18.logBox(f.prompt());
       let runAnswer;
       try {
         if (dryRun)
@@ -8020,7 +8349,7 @@ ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "
         else if (yes)
           runAnswer = { fix: !0 }, promptType === "manual" && (fixResults[f.id] = "manual_succeeded" /* MANUAL_SUCCEEDED */, fixSummary.manual.push(f.id));
         else if (promptType === "manual") {
-          if (fixResults[f.id] = "manual_succeeded" /* MANUAL_SUCCEEDED */, fixSummary.manual.push(f.id), !await prompt3.confirm(
+          if (fixResults[f.id] = "manual_succeeded" /* MANUAL_SUCCEEDED */, fixSummary.manual.push(f.id), !await prompt4.confirm(
             {
               message: "Select continue once you have made the required changes, or quit to exit the migration process",
               initialValue: !0,
@@ -8036,9 +8365,9 @@ ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "
             fixResults[f.id] = "manual_skipped" /* MANUAL_SKIPPED */;
             break;
           }
-        } else promptType === "auto" ? runAnswer = { fix: yes ? !0 : await prompt3.confirm(
+        } else promptType === "auto" ? runAnswer = { fix: yes ? !0 : await prompt4.confirm(
           {
-            message: `Do you want to run the '${import_picocolors14.default.cyan(f.id)}' migration on your project?`,
+            message: `Do you want to run the '${import_picocolors15.default.cyan(f.id)}' migration on your project?`,
             initialValue: f.defaultSelected ?? !0
           },
           {
@@ -8046,7 +8375,7 @@ ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "
               throw new Error();
             }
           }
-        ) } : promptType === "notification" && (runAnswer = { fix: await prompt3.confirm(
+        ) } : promptType === "notification" && (runAnswer = { fix: await prompt4.confirm(
           {
             message: "Do you want to continue?"
           },
@@ -8074,14 +8403,14 @@ ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "
               storybookVersion,
               storiesPaths,
               yes
-            }), logger17.log(`\u2705 ran ${import_picocolors14.default.cyan(f.id)} migration`), fixResults[f.id] = "succeeded" /* SUCCEEDED */, fixSummary.succeeded.push(f.id), currentTaskLogger.success(`Ran ${import_picocolors14.default.cyan(f.id)} migration`);
+            }), logger18.log(`\u2705 ran ${import_picocolors15.default.cyan(f.id)} migration`), fixResults[f.id] = "succeeded" /* SUCCEEDED */, fixSummary.succeeded.push(f.id), currentTaskLogger.success(`Ran ${import_picocolors15.default.cyan(f.id)} migration`);
           } catch (error) {
             fixResults[f.id] = "failed" /* FAILED */;
             let errorMessage = error instanceof Error ? error.message : "Failed to run migration";
-            fixSummary.failed[f.id] = errorMessage, currentTaskLogger.error(`Error when running ${import_picocolors14.default.cyan(f.id)} migration`);
+            fixSummary.failed[f.id] = errorMessage, currentTaskLogger.error(`Error when running ${import_picocolors15.default.cyan(f.id)} migration`);
           }
         else
-          fixResults[f.id] = "skipped" /* SKIPPED */, fixSummary.skipped.push(f.id), currentTaskLogger.success(`Skipped ${import_picocolors14.default.cyan(f.id)} migration`);
+          fixResults[f.id] = "skipped" /* SKIPPED */, fixSummary.skipped.push(f.id), currentTaskLogger.success(`Skipped ${import_picocolors15.default.cyan(f.id)} migration`);
     } else
       fixResults[f.id] = fixResults[f.id] || "unnecessary" /* UNNECESSARY */;
   }
@@ -8090,14 +8419,14 @@ ${error.stack}`), fixSummary.failed[f.id] = error.message), fixResults[f.id] = "
 
 // src/link.ts
 var import_cross_spawn = __toESM(require_cross_spawn(), 1);
-import { mkdir, readFile as readFile9, writeFile as writeFile8 } from "node:fs/promises";
+import { mkdir, readFile as readFile10, writeFile as writeFile9 } from "node:fs/promises";
 import { basename as basename3, extname as extname2, join as join4 } from "node:path";
 import { executeCommand } from "storybook/internal/common";
-import { logger as logger18 } from "storybook/internal/node-logger";
+import { logger as logger19 } from "storybook/internal/node-logger";
 var link = async ({ target, local, start }) => {
   let storybookDir = process.cwd();
   try {
-    if (JSON.parse(await readFile9("package.json", { encoding: "utf8" })).name !== "@storybook/code")
+    if (JSON.parse(await readFile10("package.json", { encoding: "utf8" })).name !== "@storybook/code")
       throw new Error();
   } catch {
     throw new Error("Expected to run link from the root of the storybook monorepo");
@@ -8105,7 +8434,7 @@ var link = async ({ target, local, start }) => {
   let reproDir = target, reproName = basename3(target);
   if (!local) {
     let reprosDir = join4(storybookDir, "../storybook-repros");
-    logger18.info(`Ensuring directory ${reprosDir}`), await mkdir(reprosDir, { recursive: !0 }), logger18.info(`Cloning ${target}`), await executeCommand({
+    logger19.info(`Ensuring directory ${reprosDir}`), await mkdir(reprosDir, { recursive: !0 }), logger19.info(`Cloning ${target}`), await executeCommand({
       command: "git",
       args: ["clone", target],
       cwd: reprosDir
@@ -8117,16 +8446,16 @@ var link = async ({ target, local, start }) => {
     shell: !0
   }).stdout.toString();
   if (!/^[2-4]\./.test(version2)) {
-    logger18.warn(`\u{1F6A8} Expected yarn 2 or higher in ${reproDir}!`), logger18.warn(""), logger18.warn("Please set it up with `yarn set version berry`,"), logger18.warn(`then link '${reproDir}' with the '--local' flag.`);
+    logger19.warn(`\u{1F6A8} Expected yarn 2 or higher in ${reproDir}!`), logger19.warn(""), logger19.warn("Please set it up with `yarn set version berry`,"), logger19.warn(`then link '${reproDir}' with the '--local' flag.`);
     return;
   }
-  logger18.info(`Linking ${reproDir}`), await executeCommand({
+  logger19.info(`Linking ${reproDir}`), await executeCommand({
     command: "yarn",
     args: ["link", "--all", "--relative", storybookDir],
     cwd: reproDir
-  }), logger18.info(`Installing ${reproName}`);
+  }), logger19.info(`Installing ${reproName}`);
   let reproPackageJson = JSON.parse(
-    await readFile9(join4(reproDir, "package.json"), { encoding: "utf8" })
+    await readFile10(join4(reproDir, "package.json"), { encoding: "utf8" })
   );
   reproPackageJson.devDependencies?.vite || (reproPackageJson.devDependencies = {
     ...reproPackageJson.devDependencies,
@@ -8134,11 +8463,11 @@ var link = async ({ target, local, start }) => {
   }), reproPackageJson.devDependencies = {
     ...reproPackageJson.devDependencies,
     "@types/node": "^22"
-  }, await writeFile8(join4(reproDir, "package.json"), JSON.stringify(reproPackageJson, null, 2)), await executeCommand({
+  }, await writeFile9(join4(reproDir, "package.json"), JSON.stringify(reproPackageJson, null, 2)), await executeCommand({
     command: "yarn",
     args: ["install"],
     cwd: reproDir
-  }), start && (logger18.info(`Running ${reproName} storybook`), await executeCommand({
+  }), start && (logger19.info(`Running ${reproName} storybook`), await executeCommand({
     command: "yarn",
     args: ["run", "storybook"],
     cwd: reproDir
@@ -8146,13 +8475,13 @@ var link = async ({ target, local, start }) => {
 };
 
 // src/migrate.ts
-import { logger as logger19 } from "storybook/internal/node-logger";
+import { logger as logger20 } from "storybook/internal/node-logger";
 import { listCodemods, runCodemod as runCodemod2 } from "@storybook/codemod";
 async function migrate(migration, { glob, dryRun, list, rename: rename2, parser }) {
   if (list)
-    listCodemods().forEach((key) => logger19.log(key));
+    listCodemods().forEach((key) => logger20.log(key));
   else if (migration)
-    await runCodemod2(migration, { glob, dryRun, logger: logger19, rename: rename2, parser });
+    await runCodemod2(migration, { glob, dryRun, logger: logger20, rename: rename2, parser });
   else
     throw new Error("Migrate: please specify a migration name or --list");
 }
@@ -8169,9 +8498,9 @@ import {
   optionalEnvToBoolean as optionalEnvToBoolean2,
   versions as versions4
 } from "storybook/internal/common";
-import { logger as logger20, prompt as prompt4 } from "storybook/internal/node-logger";
-var import_picocolors15 = __toESM(require_picocolors(), 1), import_semver6 = __toESM(require_semver(), 1);
-import { dedent as dedent15 } from "ts-dedent";
+import { logger as logger21, prompt as prompt5 } from "storybook/internal/node-logger";
+var import_picocolors16 = __toESM(require_picocolors(), 1), import_semver6 = __toESM(require_semver(), 1);
+import { dedent as dedent16 } from "ts-dedent";
 
 // src/sandbox-templates.ts
 var baseTemplates = {
@@ -8286,7 +8615,8 @@ var baseTemplates = {
         features: {
           experimentalRSC: !0,
           developmentModeForBuild: !0,
-          experimentalTestSyntax: !0
+          experimentalTestSyntax: !0,
+          changeDetection: !0
         }
       },
       extraDependencies: ["server-only", "prop-types"]
@@ -8379,7 +8709,8 @@ var baseTemplates = {
         features: {
           experimentalRSC: !0,
           developmentModeForBuild: !0,
-          experimentalTestSyntax: !0
+          experimentalTestSyntax: !0,
+          changeDetection: !0
         }
       },
       extraDependencies: ["server-only", "vite", "prop-types"]
@@ -8421,7 +8752,8 @@ var baseTemplates = {
       mainConfig: {
         features: {
           developmentModeForBuild: !0,
-          experimentalTestSyntax: !0
+          experimentalTestSyntax: !0,
+          changeDetection: !0
         }
       }
     },
@@ -8552,6 +8884,46 @@ var baseTemplates = {
     },
     skipTasks: ["e2e-tests", "e2e-tests-dev", "bench", "vitest-integration"]
   },
+  "tanstack-react-router/default-ts": {
+    name: "TanStack React Router Latest (Vite | TypeScript)",
+    script: "npx @tanstack/cli@latest create {{beforeDir}} --tailwind --router-only",
+    expected: {
+      framework: "@storybook/tanstack-react",
+      renderer: "@storybook/react",
+      builder: "@storybook/builder-vite"
+    },
+    modifications: {
+      useCsfFactory: !0,
+      extraDependencies: ["prop-types"],
+      mainConfig: {
+        framework: "@storybook/tanstack-react",
+        features: {
+          experimentalTestSyntax: !0
+        }
+      }
+    },
+    skipTasks: ["bench"]
+  },
+  "tanstack-react-start/default-ts": {
+    name: "TanStack React Start Latest (Vite | TypeScript)",
+    script: "npx @tanstack/cli@latest create {{beforeDir}} --tailwind",
+    expected: {
+      framework: "@storybook/tanstack-react",
+      renderer: "@storybook/react",
+      builder: "@storybook/builder-vite"
+    },
+    modifications: {
+      useCsfFactory: !0,
+      extraDependencies: ["prop-types"],
+      mainConfig: {
+        framework: "@storybook/tanstack-react",
+        features: {
+          experimentalTestSyntax: !0
+        }
+      }
+    },
+    skipTasks: ["bench"]
+  },
   "vue3-vite/default-js": {
     name: "Vue v3 (Vite | JavaScript)",
     script: "npm create vite --yes {{beforeDir}} -- --template vue",
@@ -9035,7 +9407,9 @@ var baseTemplates = {
   "bench/react-vite-default-ts-test-build",
   "bench/react-webpack-18-ts-test-build",
   // 'ember/default-js',
-  "react-rsbuild/default-ts"
+  "react-rsbuild/default-ts",
+  "tanstack-react-router/default-ts",
+  "tanstack-react-start/default-ts"
 ], merged = [
   ...normal,
   "react-webpack/18-ts",
@@ -9081,20 +9455,20 @@ var toChoices = (c) => ({ label: allTemplates[c].name, value: c }), sandbox = as
   let selectedConfig = allTemplates[filterValue], templateId = selectedConfig ? filterValue : null, packageManager = JsPackageManagerFactory.getPackageManager({
     force: PackageManagerName.NPM
   }), latestVersion = await packageManager.latestVersion("storybook"), nextVersion = await packageManager.latestVersion("storybook@next") ?? "0.0.0", currentVersion = versions4.storybook, isPrerelease = (0, import_semver6.prerelease)(currentVersion), isOutdated = (0, import_semver6.lt)(currentVersion, isPrerelease ? nextVersion : latestVersion), downloadType = !isOutdated && init ? "after-storybook" : "before-storybook", branch = isPrerelease ? "next" : "main", messages2 = {
-    welcome: `Creating a Storybook ${import_picocolors15.default.bold(currentVersion)} sandbox..`,
-    notLatest: import_picocolors15.default.red(dedent15`
-      This version is behind the latest release, which is: ${import_picocolors15.default.bold(latestVersion)}!
+    welcome: `Creating a Storybook ${import_picocolors16.default.bold(currentVersion)} sandbox..`,
+    notLatest: import_picocolors16.default.red(dedent16`
+      This version is behind the latest release, which is: ${import_picocolors16.default.bold(latestVersion)}!
       You likely ran the init command through npx, which can use a locally cached version, to get the latest please run:
-      ${import_picocolors15.default.bold("npx storybook@latest sandbox")}
+      ${import_picocolors16.default.bold("npx storybook@latest sandbox")}
       
       You may want to CTRL+C to stop, and run with the latest version instead.
     `),
-    longInitTime: import_picocolors15.default.yellow(
+    longInitTime: import_picocolors16.default.yellow(
       "The creation of the sandbox will take longer, because we will need to run init."
     ),
-    prerelease: import_picocolors15.default.yellow("This is a pre-release version.")
+    prerelease: import_picocolors16.default.yellow("This is a pre-release version.")
   };
-  if (logger20.logBox(
+  if (logger21.logBox(
     [messages2.welcome].concat(isOutdated && !isPrerelease ? [messages2.notLatest] : []).concat(init && (isOutdated || isPrerelease) ? [messages2.longInitTime] : []).concat(isPrerelease ? [messages2.prerelease] : []).join(`
 `),
     {
@@ -9105,24 +9479,24 @@ var toChoices = (c) => ({ label: allTemplates[c].name, value: c }), sandbox = as
       let current = allTemplates[group];
       return (!filterValue || current.name.match(filterRegex) || group.match(filterRegex) || current.expected.builder.match(filterRegex) || current.expected.framework.match(filterRegex) || current.expected.renderer.match(filterRegex)) && acc.push(group), acc;
     }, []);
-    if (choices.length === 0 && (logger20.logBox(
-      dedent15`
+    if (choices.length === 0 && (logger21.logBox(
+      dedent16`
             🔎 You filtered out all templates. 🔍
 
-            After filtering all the templates with "${import_picocolors15.default.yellow(
+            After filtering all the templates with "${import_picocolors16.default.yellow(
         filterValue
       )}", we found no results. Please try again with a different filter.
 
             Available templates:
-            ${keys.map((key) => import_picocolors15.default.blue(`- ${key}`)).join(`
+            ${keys.map((key) => import_picocolors16.default.blue(`- ${key}`)).join(`
 `)}
             `.trim(),
       { borderStyle: "round", padding: 1, borderColor: "#F1618C" }
-    ), process.exit(1)), choices.length === 1 ? [templateId] = choices : (logger20.logBox(
-      dedent15`
-            🤗 Welcome to ${import_picocolors15.default.yellow("sb sandbox")}! 🤗
+    ), process.exit(1)), choices.length === 1 ? [templateId] = choices : (logger21.logBox(
+      dedent16`
+            🤗 Welcome to ${import_picocolors16.default.yellow("sb sandbox")}! 🤗
 
-            Create a ${import_picocolors15.default.green("new project")} to minimally reproduce Storybook issues.
+            Create a ${import_picocolors16.default.green("new project")} to minimally reproduce Storybook issues.
 
             1. select an environment that most closely matches your project setup.
             2. select a location for the reproduction, outside of your project.
@@ -9131,14 +9505,14 @@ var toChoices = (c) => ({ label: allTemplates[c].name, value: c }), sandbox = as
             `.trim(),
       { borderStyle: "round", padding: 1, borderColor: "#F1618C" }
     ), templateId = await promptSelectedTemplate(choices)), !!!(templateId ?? null)) {
-      logger20.error("Somehow we got no templates. Please rerun this command!");
+      logger21.error("Somehow we got no templates. Please rerun this command!");
       return;
     }
     if (selectedConfig = templateId ? allTemplates[templateId] : void 0, !selectedConfig)
       throw new Error("\u{1F6A8} Sandbox: please specify a valid template type");
   }
   let selectedDirectory = outputDirectory, outputDirectoryName = outputDirectory || templateId;
-  selectedDirectory && existsSync4(`${selectedDirectory}`) && (logger20.log(`\u26A0\uFE0F  ${selectedDirectory} already exists! Overwriting...`), await rm(selectedDirectory, { recursive: !0, force: !0 })), selectedDirectory || (selectedDirectory = await prompt4.text(
+  selectedDirectory && existsSync4(`${selectedDirectory}`) && (logger21.log(`\u26A0\uFE0F  ${selectedDirectory} already exists! Overwriting...`), await rm(selectedDirectory, { recursive: !0, force: !0 })), selectedDirectory || (selectedDirectory = await prompt5.text(
     {
       message: "Enter the output directory",
       initialValue: outputDirectoryName ?? void 0,
@@ -9146,21 +9520,21 @@ var toChoices = (c) => ({ label: allTemplates[c].name, value: c }), sandbox = as
     },
     {
       onCancel: () => {
-        logger20.log("Command cancelled by the user. Exiting..."), process.exit(1);
+        logger21.log("Command cancelled by the user. Exiting..."), process.exit(1);
       }
     }
   )), invariant(selectedDirectory);
   try {
     let templateDestination = isAbsolute3(selectedDirectory) ? selectedDirectory : join(process.cwd(), selectedDirectory);
-    logger20.log(`\u{1F3C3} Adding ${selectedConfig.name} into ${templateDestination}`), logger20.log(`\u{1F4E6} Downloading sandbox template (${import_picocolors15.default.bold(downloadType)})...`);
+    logger21.log(`\u{1F3C3} Adding ${selectedConfig.name} into ${templateDestination}`), logger21.log(`\u{1F4E6} Downloading sandbox template (${import_picocolors16.default.bold(downloadType)})...`);
     try {
       let gitPath = `storybookjs/sandboxes/tree/${branch}/${templateId}/${downloadType}`;
       if (await mkdir2(templateDestination, { recursive: !0 }), (0, import_cross_spawn2.sync)("npx", ["gitpick@4.12.4", gitPath, templateDestination, "-o"], {
         stdio: "inherit"
       }), (await readdir(templateDestination)).length === 0) {
-        let selected = import_picocolors15.default.yellow(templateId);
-        throw new Error(dedent15`
-          Template downloaded from ${import_picocolors15.default.blue(gitPath)} is empty.
+        let selected = import_picocolors16.default.yellow(templateId);
+        throw new Error(dedent16`
+          Template downloaded from ${import_picocolors16.default.blue(gitPath)} is empty.
           Are you use it exists? Or did you want to set ${selected} to inDevelopment first?
         `);
       }
@@ -9176,22 +9550,22 @@ var toChoices = (c) => ({ label: allTemplates[c].name, value: c }), sandbox = as
         }), process.chdir(before);
       }
     } catch (err) {
-      throw logger20.error(`\u{1F6A8} Failed to download sandbox template: ${String(err)}`), err;
+      throw logger21.error(`\u{1F6A8} Failed to download sandbox template: ${String(err)}`), err;
     }
-    let initMessage = init ? import_picocolors15.default.yellow(dedent15`
+    let initMessage = init ? import_picocolors16.default.yellow(dedent16`
           yarn install
           yarn storybook
-        `) : `Recreate your setup, then ${import_picocolors15.default.yellow("npx storybook@latest init")}`;
-    logger20.logBox(
-      dedent15`
+        `) : `Recreate your setup, then ${import_picocolors16.default.yellow("npx storybook@latest init")}`;
+    logger21.logBox(
+      dedent16`
         🎉 Your Storybook reproduction project is ready to use! 🎉
 
-        ${import_picocolors15.default.yellow(`cd ${selectedDirectory}`)}
+        ${import_picocolors16.default.yellow(`cd ${selectedDirectory}`)}
         ${initMessage}
 
         Once you've recreated the problem you're experiencing, please:
 
-        1. Document any additional steps in ${import_picocolors15.default.cyan("README.md")}
+        1. Document any additional steps in ${import_picocolors16.default.cyan("README.md")}
         2. Publish the repository to github
         3. Link to the repro repository in your issue
 
@@ -9200,21 +9574,21 @@ var toChoices = (c) => ({ label: allTemplates[c].name, value: c }), sandbox = as
       { rounded: !0 }
     );
   } catch (error) {
-    throw logger20.error("\u{1F6A8} Failed to create sandbox"), error;
+    throw logger21.error("\u{1F6A8} Failed to create sandbox"), error;
   }
 };
 async function promptSelectedTemplate(choices) {
-  return await prompt4.select({
+  return await prompt5.select({
     message: "Select a template",
     options: choices.map(toChoices)
   });
 }
 
 // src/ai/index.ts
-import { writeFile as writeFile9 } from "node:fs/promises";
+import { writeFile as writeFile10 } from "node:fs/promises";
 import { resolve as resolve4 } from "node:path";
-import { getPrettyPackageManagerName } from "storybook/internal/common";
-import { logger as logger22 } from "storybook/internal/node-logger";
+import { cache, getPrettyPackageManagerName } from "storybook/internal/common";
+import { logger as logger23 } from "storybook/internal/node-logger";
 import { telemetry } from "storybook/internal/telemetry";
 import { SupportedLanguage as SupportedLanguage2 } from "storybook/internal/types";
 
@@ -9223,7 +9597,7 @@ import { existsSync as existsSync6 } from "node:fs";
 import { resolve as resolve3 } from "node:path";
 import { ProjectType as ProjectType2 } from "storybook/internal/cli";
 import { HandledError, getProjectRoot } from "storybook/internal/common";
-import { logger as logger21 } from "storybook/internal/node-logger";
+import { logger as logger22 } from "storybook/internal/node-logger";
 import { NxProjectDetectedError } from "storybook/internal/server-errors";
 import { SupportedLanguage } from "storybook/internal/types";
 
@@ -9238,7 +9612,7 @@ function up2(name, options) {
 
 // ../create-storybook/src/services/ProjectTypeService.ts
 var import_semver7 = __toESM(require_semver(), 1);
-import { dedent as dedent16 } from "ts-dedent";
+import { dedent as dedent17 } from "ts-dedent";
 var ProjectTypeService = class {
   constructor(jsPackageManager) {
     this.jsPackageManager = jsPackageManager;
@@ -9251,6 +9625,11 @@ var ProjectTypeService = class {
         dependencies: ["nuxt"],
         matcherFunction: ({ dependencies }) => dependencies?.every(Boolean) ?? !0
       },
+      {
+        preset: ProjectType2.TANSTACK_REACT,
+        dependencies: ["@tanstack/start", "@tanstack/react-start", "@tanstack/react-router"],
+        matcherFunction: ({ dependencies }) => dependencies?.some(Boolean) ?? !1
+      },
       {
         preset: ProjectType2.VUE3,
         dependencies: {
@@ -9276,7 +9655,7 @@ var ProjectTypeService = class {
       },
       {
         preset: ProjectType2.REACT_NATIVE,
-        dependencies: ["react-native", "react-native-scripts"],
+        dependencies: ["react-native", "react-native-scripts", "expo"],
         matcherFunction: ({ dependencies }) => dependencies?.some(Boolean) ?? !1
       },
       {
@@ -9335,7 +9714,7 @@ var ProjectTypeService = class {
       (t10) => !["undetected", "unsupported", "nx"].includes(String(t10))
     ).includes(projectTypeProvided))
       return projectTypeProvided;
-    throw logger21.error(
+    throw logger22.error(
       `The provided project type ${projectTypeProvided} was not recognized by Storybook`
     ), new HandledError(`Unknown project type supplied: ${projectTypeProvided}`);
   }
@@ -9343,7 +9722,7 @@ var ProjectTypeService = class {
     try {
       let detectedType = await this.detectProjectType(options);
       if (detectedType === ProjectType2.UNDETECTED || detectedType === null)
-        throw logger21.error(dedent16`
+        throw logger22.error(dedent17`
           Unable to initialize Storybook in this directory.
 
           Storybook couldn't detect a supported framework or configuration for your project. Make sure you're inside a framework project (e.g., React, Vue, Svelte, Angular, Next.js) and that its dependencies are installed.
@@ -9356,7 +9735,7 @@ var ProjectTypeService = class {
         throw new NxProjectDetectedError();
       return detectedType;
     } catch (err) {
-      throw err instanceof HandledError || err instanceof NxProjectDetectedError ? err : (logger21.error(String(err)), new HandledError(err instanceof Error ? err.message : String(err)));
+      throw err instanceof HandledError || err instanceof NxProjectDetectedError ? err : (logger22.error(String(err)), new HandledError(err instanceof Error ? err.message : String(err)));
     }
   }
   async detectLanguage() {
@@ -9376,7 +9755,7 @@ var ProjectTypeService = class {
       getModulePackageJSONVersion("@typescript-eslint/parser"),
       getModulePackageJSONVersion("eslint-plugin-storybook")
     ]), satisfies = (version2, range) => version2 ? import_semver7.default.satisfies(version2, range, { includePrerelease: !0 }) : !1;
-    return isTypescriptDirectDependency && typescriptVersion ? satisfies(typescriptVersion, ">=4.9.0") && (!prettierVersion || import_semver7.default.gte(prettierVersion, "2.8.0")) && (!babelPluginTransformTypescriptVersion || satisfies(babelPluginTransformTypescriptVersion, ">=7.20.0")) && (!typescriptEslintParserVersion || satisfies(typescriptEslintParserVersion, ">=5.44.0")) && (!eslintPluginStorybookVersion || satisfies(eslintPluginStorybookVersion, ">=0.6.8")) ? language = SupportedLanguage.TYPESCRIPT : logger21.warn(
+    return isTypescriptDirectDependency && typescriptVersion ? satisfies(typescriptVersion, ">=4.9.0") && (!prettierVersion || import_semver7.default.gte(prettierVersion, "2.8.0")) && (!babelPluginTransformTypescriptVersion || satisfies(babelPluginTransformTypescriptVersion, ">=7.20.0")) && (!typescriptEslintParserVersion || satisfies(typescriptEslintParserVersion, ">=5.44.0")) && (!eslintPluginStorybookVersion || satisfies(eslintPluginStorybookVersion, ">=0.6.8")) ? language = SupportedLanguage.TYPESCRIPT : logger22.warn(
       "Detected TypeScript < 4.9 or incompatible tooling, populating with JavaScript examples"
     ) : existsSync6("tsconfig.json") && (language = SupportedLanguage.TYPESCRIPT), language;
   }
@@ -9437,7 +9816,7 @@ var ProjectTypeService = class {
 };
 
 // src/ai/setup-prompts/index.ts
-import { dedent as dedent17 } from "ts-dedent";
+import { dedent as dedent18 } from "ts-dedent";
 
 // src/ai/utils/project-overview.ts
 function getProjectOverview(projectInfo) {
@@ -9457,14 +9836,15 @@ function getProjectOverview(projectInfo) {
 }
 
 // src/ai/setup-prompts/index.ts
-var DEFAULT_PROMPT_NAME = "pattern-copy-play", CURRENTLY_USED_PROMPT = {
+var DEFAULT_PROMPT_NAME = "optimized-tests", CURRENTLY_USED_PROMPT = {
   [DEFAULT_PROMPT_NAME]: instructions
 }, FORMERLY_USED_PROMPTS = {
-  monorepo: async () => (await import("./monorepo-4B4ULRGC.js")).instructions,
-  "optimized-tests": async () => (await import("./optimized-tests-MJI5NXQA.js")).instructions,
-  "relaxed-limits": async () => (await import("./relaxed-limits-MKAIPGR2.js")).instructions,
-  setup: async () => (await import("./setup-PUNMMEGI.js")).instructions,
-  "pattern-copy-play": async () => (await import("./pattern-copy-play-JNOATHUQ.js")).instructions
+  monorepo: async () => (await import("./monorepo-TKU4OK5Y.js")).instructions,
+  "optimized-tests": async () => (await import("./optimized-tests-PTOYROOU.js")).instructions,
+  "relaxed-limits": async () => (await import("./relaxed-limits-IFYEA3SD.js")).instructions,
+  setup: async () => (await import("./setup-N65V6RFL.js")).instructions,
+  "pattern-copy-play": async () => (await import("./pattern-copy-play-Y43OOQWS.js")).instructions,
+  "monorepo-optimized-tests-relaxed-limits-no-story-deletion": async () => (await import("./monorepo-optimized-tests-relaxed-limits-no-story-deletion-XF53WCEF.js")).instructions
 }, PROMPT_NAMES = [
   ...Object.keys(CURRENTLY_USED_PROMPT),
   ...Object.keys(FORMERLY_USED_PROMPTS)
@@ -9479,7 +9859,7 @@ async function getAiSetupPrompt(projectInfo) {
 }
 async function getAiSetupMarkdownOutput(projectInfo) {
   return {
-    markdown: dedent17`
+    markdown: dedent18`
     # Storybook Setup
 
     ${getProjectOverview(projectInfo)}
@@ -9498,12 +9878,12 @@ async function aiSetup(options) {
       packageManagerName: packageManager
     });
     if (!data.frameworkPackage || !data.rendererPackage || !data.builderPackage) {
-      logger22.error(
+      logger23.error(
         "Could not detect framework, renderer, or builder from your Storybook config. Make sure you are running this command from your project root, or specify --config-dir."
       );
       return;
     }
-    let majorVersion = data.versionInstalled ? parseMajorVersion(data.versionInstalled) : void 0, language = await new ProjectTypeService(data.packageManager).detectLanguage() === SupportedLanguage2.TYPESCRIPT ? "ts" : "js";
+    let majorVersion = data.versionInstalled ? parseMajorVersion(data.versionInstalled) : void 0, language = await new ProjectTypeService(data.packageManager).detectLanguage() === SupportedLanguage2.TYPESCRIPT ? "ts" : "js", needsUserOnboarding = await cache.get("onboarding-pending", !1);
     projectInfo = {
       storybookVersion: data.versionInstalled,
       majorVersion,
@@ -9517,24 +9897,29 @@ async function aiSetup(options) {
       packageManager: data.packageManager,
       packageManagerName: getPrettyPackageManagerName(data.packageManager.type),
       language,
-      hasCsfFactoryPreview: data.hasCsfFactoryPreview
+      hasCsfFactoryPreview: data.hasCsfFactoryPreview,
+      needsUserOnboarding
     };
   } catch (err) {
-    logger22.error(
+    logger23.error(
       `Failed to read Storybook configuration: ${err instanceof Error ? err.message : String(err)}`
-    ), logger22.log(
+    ), logger23.log(
       "Make sure you are running this command from your project root, or specify --config-dir."
     );
     return;
   }
   if (projectInfo.rendererPackage !== "@storybook/react" || projectInfo.builderPackage !== "@storybook/builder-vite") {
-    logger22.log(
+    logger23.log(
       "AI-assisted setup is currently only available for projects using the React renderer with Vite builder. Detected renderer: " + projectInfo.rendererPackage + ", builder: " + projectInfo.builderPackage
     );
     return;
   }
   let markdownOutput = (await getAiSetupMarkdownOutput(projectInfo)).markdown;
-  if (await telemetry("ai-setup", {
+  if (await cache.set("ai-setup-ran", {
+    timestamp: Date.now(),
+    configDir: resolve4(projectInfo.configDir)
+  }).catch(() => {
+  }), await telemetry("ai-setup", {
     cliOptions: {
       output: output ? "file" : void 0,
       configDir: projectInfo.configDir,
@@ -9548,7 +9933,7 @@ async function aiSetup(options) {
     }
   }), output) {
     let outputPath = resolve4(output);
-    await writeFile9(outputPath, markdownOutput, "utf-8"), logger22.log(`Prompt written to ${outputPath}`);
+    await writeFile10(outputPath, markdownOutput, "utf-8"), logger23.log(`Prompt written to ${outputPath}`);
   } else
     process.stdout.write(`${markdownOutput}
 `);
@@ -9559,29 +9944,29 @@ function parseMajorVersion(version2) {
 }
 
 // src/upgrade.ts
-var import_cross_spawn3 = __toESM(require_cross_spawn(), 1), import_picocolors16 = __toESM(require_picocolors(), 1), import_semver8 = __toESM(require_semver(), 1);
+var import_cross_spawn3 = __toESM(require_cross_spawn(), 1), import_picocolors17 = __toESM(require_picocolors(), 1), import_semver8 = __toESM(require_semver(), 1);
 import { PackageManagerName as PackageManagerName2 } from "storybook/internal/common";
 import { HandledError as HandledError2, JsPackageManagerFactory as JsPackageManagerFactory2, isCorePackage as isCorePackage2 } from "storybook/internal/common";
 import {
   CLI_COLORS as CLI_COLORS4,
   createHyperlink,
   logTracker as logTracker3,
-  logger as logger24,
-  prompt as prompt6
+  logger as logger25,
+  prompt as prompt7
 } from "storybook/internal/node-logger";
 import {
   UpgradeStorybookToLowerVersionError,
   UpgradeStorybookUnknownCurrentVersionError
 } from "storybook/internal/server-errors";
 import { telemetry as telemetry2 } from "storybook/internal/telemetry";
-import { dedent as dedent18 } from "ts-dedent";
+import { dedent as dedent19 } from "ts-dedent";
 
 // src/automigrate/multi-project.ts
-import { CLI_COLORS as CLI_COLORS3, logger as logger23, prompt as prompt5 } from "storybook/internal/node-logger";
+import { CLI_COLORS as CLI_COLORS3, logger as logger24, prompt as prompt6 } from "storybook/internal/node-logger";
 import { ErrorCollector, sanitizeError } from "storybook/internal/telemetry";
 async function collectAutomigrationsAcrossProjects(options) {
   let { fixes, projects, taskLog } = options, automigrationMap = /* @__PURE__ */ new Map();
-  logger23.debug(
+  logger24.debug(
     `Starting automigration collection across ${projects.length} projects and ${fixes.length} fixes...`
   );
   function collectResult(fix, project, status, result) {
@@ -9603,10 +9988,10 @@ async function collectAutomigrationsAcrossProjects(options) {
   }
   for (let project of projects) {
     let projectName = shortenPath(project.configDir);
-    taskLog.message(`Checking automigrations for ${projectName}...`), logger23.debug(`Processing project: ${projectName}`);
+    taskLog.message(`Checking automigrations for ${projectName}...`), logger24.debug(`Processing project: ${projectName}`);
     for (let fix of fixes)
       try {
-        logger23.debug(`Checking fix ${fix.id} for project ${projectName}...`);
+        logger24.debug(`Checking fix ${fix.id} for project ${projectName}...`);
         let checkOptions = {
           packageManager: project.packageManager,
           configDir: project.configDir,
@@ -9619,9 +10004,9 @@ async function collectAutomigrationsAcrossProjects(options) {
         }, result = await fix.check(checkOptions);
         result !== null ? collectResult(fix, project, "check_succeeded", result) : collectResult(fix, project, "not_applicable");
       } catch (error) {
-        collectResult(fix, project, "check_failed"), logger23.debug(
+        collectResult(fix, project, "check_failed"), logger24.debug(
           `Failed to check fix ${fix.id} for project ${shortenPath(project.configDir)}.`
-        ), logger23.debug(`${error instanceof Error ? error.stack : String(error)}`), ErrorCollector.addError(error);
+        ), logger24.debug(`${error instanceof Error ? error.stack : String(error)}`), ErrorCollector.addError(error);
       }
   }
   let allAutomigrations = Array.from(automigrationMap.values()), applicableAutomigrations = allAutomigrations.filter(
@@ -9635,9 +10020,9 @@ async function collectAutomigrationsAcrossProjects(options) {
   );
   return taskLog.message(`
 Automigrations detected:`), successAutomigrations.forEach((fixId) => {
-    taskLog.message(`${CLI_COLORS3.success(`${logger23.SYMBOLS.success} ${fixId}`)}`);
+    taskLog.message(`${CLI_COLORS3.success(`${logger24.SYMBOLS.success} ${fixId}`)}`);
   }), failedAutomigrations.forEach((fixId) => {
-    taskLog.message(`${CLI_COLORS3.error(`${logger23.SYMBOLS.error} ${fixId}`)}`);
+    taskLog.message(`${CLI_COLORS3.error(`${logger24.SYMBOLS.error} ${fixId}`)}`);
   }), failedAutomigrations.length > 0 ? taskLog.error(
     `${failedAutomigrations.length} automigration ${failedAutomigrations.length > 1 ? "checks" : "check"} failed`
   ) : taskLog.success(
@@ -9655,12 +10040,12 @@ async function promptForAutomigrations(automigrations, options) {
   if (automigrations.length === 0)
     return [];
   if (options.dryRun)
-    return logger23.log("Detected automigrations (dry run - no changes will be made):"), automigrations.forEach(({ fix, reports: list }) => {
-      logger23.log(`  - ${fix.id} (${formatProjectDirs(list)})`);
+    return logger24.log("Detected automigrations (dry run - no changes will be made):"), automigrations.forEach(({ fix, reports: list }) => {
+      logger24.log(`  - ${fix.id} (${formatProjectDirs(list)})`);
     }), [];
   if (options.yes)
-    return logger23.log("Running all detected automigrations:"), automigrations.forEach(({ fix, reports: list }) => {
-      logger23.log(`  - ${fix.id} (${formatProjectDirs(list)})`);
+    return logger24.log("Running all detected automigrations:"), automigrations.forEach(({ fix, reports: list }) => {
+      logger24.log(`  - ${fix.id} (${formatProjectDirs(list)})`);
     }), automigrations;
   let choices = automigrations.map((am) => {
     let hint = [];
@@ -9673,7 +10058,7 @@ async function promptForAutomigrations(automigrations, options) {
 `),
       defaultSelected: am.fix.defaultSelected ?? !0
     };
-  }), selectedIds = await prompt5.multiselect({
+  }), selectedIds = await prompt6.multiselect({
     message: "Select automigrations to run",
     options: choices,
     initialValues: choices.filter((c) => c.defaultSelected).map((c) => c.value),
@@ -9704,18 +10089,18 @@ async function runAutomigrationsForProjects(selectedAutomigrations, options) {
     }
   let projectIndex = 0;
   for (let [configDir, projectAutomigration] of projectAutomigrationResults) {
-    let countPrefix = projectAutomigrationResults.size > 1 ? `(${++projectIndex}/${projectAutomigrationResults.size}) ` : "", { project } = projectAutomigration[0], projectName = shortenPath(project.configDir), taskLog = applicableAutomigrations.length > 0 ? prompt5.taskLog({
+    let countPrefix = projectAutomigrationResults.size > 1 ? `(${++projectIndex}/${projectAutomigrationResults.size}) ` : "", { project } = projectAutomigration[0], projectName = shortenPath(project.configDir), taskLog = applicableAutomigrations.length > 0 ? prompt6.taskLog({
       id: `automigrate-${projectName}`,
       title: `${countPrefix}Running automigrations for ${projectName}`
     }) : {
       message: (message) => {
-        logger23.debug(`${message}`);
+        logger24.debug(`${message}`);
       },
       error: (message) => {
-        logger23.debug(`${message}`);
+        logger24.debug(`${message}`);
       },
       success: (message) => {
-        logger23.debug(`${message}`);
+        logger24.debug(`${message}`);
       }
     }, fixResults = {}, fixFailures = {};
     for (let automigration of projectAutomigration) {
@@ -9749,11 +10134,11 @@ async function runAutomigrationsForProjects(selectedAutomigrations, options) {
             storiesPaths: project2.storiesPaths,
             yes
           };
-          await fix.run(runOptions), fixResults[fix.id] = "succeeded" /* SUCCEEDED */, taskLog.message(CLI_COLORS3.success(`${logger23.SYMBOLS.success} ${fix.id}`));
+          await fix.run(runOptions), fixResults[fix.id] = "succeeded" /* SUCCEEDED */, taskLog.message(CLI_COLORS3.success(`${logger24.SYMBOLS.success} ${fix.id}`));
         }
       } catch (error) {
         let errorMessage = (error instanceof Error ? error.stack : String(error)) ?? "Unknown error";
-        fixResults[fix.id] = "failed" /* FAILED */, fixFailures[fix.id] = sanitizeError(error), taskLog.message(CLI_COLORS3.error(`${logger23.SYMBOLS.error} ${automigration.fix.id}`)), logger23.debug(errorMessage), ErrorCollector.addError(error);
+        fixResults[fix.id] = "failed" /* FAILED */, fixFailures[fix.id] = sanitizeError(error), taskLog.message(CLI_COLORS3.error(`${logger24.SYMBOLS.error} ${automigration.fix.id}`)), logger24.debug(errorMessage), ErrorCollector.addError(error);
       }
     }
     let automigrationsWithErrors = Object.values(fixResults).filter(
@@ -9782,7 +10167,7 @@ async function runAutomigrations(projects, options) {
     beforeVersion: project.beforeVersion,
     storiesPaths: project.storiesPaths,
     hasCsfFactoryPreview: project.hasCsfFactoryPreview
-  })), detectingAutomigrationTask = prompt5.taskLog({
+  })), detectingAutomigrationTask = prompt6.taskLog({
     id: "detect-automigrations",
     title: projectAutomigrationData.length > 1 ? `Detecting automigrations for ${projectAutomigrationData.length} projects...` : "Detecting automigrations..."
   }), detectedAutomigrations = await collectAutomigrationsAcrossProjects({
@@ -9863,29 +10248,29 @@ function logUpgradeResults(projectResults, detectedAutomigrations, doctorResults
     doctorResults
   );
   if (failedProjects.length > 0) {
-    if (logTracker3.enableLogWriting(), logger24.step(
+    if (logTracker3.enableLogWriting(), logger25.step(
       "The upgrade is complete, but some projects failed to upgrade or migrate completely. Please see the debug logs for more details."
     ), successfulProjects.length > 0) {
       let successfulProjectsList = successfulProjects.map((dir) => `  \u2022 ${shortenPath(dir)}`).join(`
 `);
-      logger24.log(`${CLI_COLORS4.success("Successfully upgraded:")}
+      logger25.log(`${CLI_COLORS4.success("Successfully upgraded:")}
 ${successfulProjectsList}`);
     }
     let failedProjectsList = failedProjects.map((dir) => `  \u2022 ${shortenPath(dir)}`).join(`
 `);
-    if (logger24.log(
+    if (logger25.log(
       `${CLI_COLORS4.error("Failed to upgrade:")}
 Some automigrations failed, please check the logs in the log file for more details.
 ${failedProjectsList}`
     ), projectsWithNoFixes.length > 0) {
       let projectList = projectsWithNoFixes.map((dir) => `  \u2022 ${shortenPath(dir)}`).join(`
 `);
-      logger24.log(`${CLI_COLORS4.info("No applicable migrations:")}
+      logger25.log(`${CLI_COLORS4.info("No applicable migrations:")}
 ${projectList}`);
     }
   } else
-    Object.values(doctorResults).every((result) => result.status === "healthy") ? logger24.step(`${CLI_COLORS4.success("Your project(s) have been upgraded successfully! \u{1F389}")}`) : logger24.step(
-      `${import_picocolors16.default.yellow("Your project(s) have been upgraded successfully, but some issues were found which need your attention, please check Storybook doctor logs above.")}`
+    Object.values(doctorResults).every((result) => result.status === "healthy") ? logger25.step(`${CLI_COLORS4.success("Your project(s) have been upgraded successfully! \u{1F389}")}`) : logger25.step(
+      `${import_picocolors17.default.yellow("Your project(s) have been upgraded successfully, but some issues were found which need your attention, please check Storybook doctor logs above.")}`
     );
   let automigrationLinks = detectedAutomigrations.filter(
     (am) => Object.entries(projectResults).some(
@@ -9898,9 +10283,9 @@ ${projectList}`);
       ...automigrationLinks
     ].join(`
 `);
-    logger24.log(automigrationLinksMessage);
+    logger25.log(automigrationLinksMessage);
   }
-  logger24.log(
+  logger25.log(
     `For a full list of changes, please check our migration guide: ${CLI_COLORS4.cta("https://storybook.js.org/docs/releases/migration-guide?ref=upgrade")}`
   );
 }
@@ -9932,7 +10317,7 @@ async function sendMultiUpgradeTelemetry(options) {
       hasUserInterrupted
     });
   } catch (error) {
-    logger24.debug(`Failed to send multi-upgrade telemetry: ${String(error)}`);
+    logger25.debug(`Failed to send multi-upgrade telemetry: ${String(error)}`);
   }
 }
 async function upgrade(options) {
@@ -9940,13 +10325,13 @@ async function upgrade(options) {
   if (projectsResult === void 0 || projectsResult.selectedProjects.length === 0)
     return;
   let { allProjects, selectedProjects: storybookProjects } = projectsResult;
-  storybookProjects.length > 1 ? logger24.info(`Upgrading the following projects:
-          ${storybookProjects.map((p) => `${import_picocolors16.default.cyan(shortenPath(p.configDir))}: ${import_picocolors16.default.bold(p.beforeVersion)} -> ${import_picocolors16.default.bold(p.currentCLIVersion)}`).join(`
-`)}`) : logger24.info(
-    `Upgrading from ${import_picocolors16.default.bold(storybookProjects[0].beforeVersion)} to ${import_picocolors16.default.bold(storybookProjects[0].currentCLIVersion)}`
+  storybookProjects.length > 1 ? logger25.info(`Upgrading the following projects:
+          ${storybookProjects.map((p) => `${import_picocolors17.default.cyan(shortenPath(p.configDir))}: ${import_picocolors17.default.bold(p.beforeVersion)} -> ${import_picocolors17.default.bold(p.currentCLIVersion)}`).join(`
+`)}`) : logger25.info(
+    `Upgrading from ${import_picocolors17.default.bold(storybookProjects[0].beforeVersion)} to ${import_picocolors17.default.bold(storybookProjects[0].currentCLIVersion)}`
   );
   let automigrationResults = {}, doctorResults = {}, handleInterruption = async () => {
-    throw logger24.log(`
+    throw logger25.log(`
 
 Upgrade interrupted by user.`), allProjects.length > 1 && await sendMultiUpgradeTelemetry({
       allProjects,
@@ -9959,7 +10344,7 @@ Upgrade interrupted by user.`), allProjects.length > 1 && await sendMultiUpgrade
   process.on("SIGINT", handleInterruption), process.on("SIGTERM", handleInterruption);
   try {
     if (processAutoblockerResults(storybookProjects, (message) => {
-      logger24.error(dedent18`Blockers detected\n\n${message}`);
+      logger25.error(dedent19`Blockers detected\n\n${message}`);
     }))
       throw new HandledError2("Blockers detected");
     if (storybookProjects.some((project) => {
@@ -9971,14 +10356,14 @@ Upgrade interrupted by user.`), allProjects.length > 1 && await sendMultiUpgrade
       if (!project.beforeVersion)
         throw new UpgradeStorybookUnknownCurrentVersionError();
     }), !options.dryRun) {
-      let task = prompt6.taskLog({
+      let task = prompt7.taskLog({
         id: "upgrade-dependencies",
         title: "Fetching versions to update package.json files.."
       });
       try {
         let loggedPaths = [];
         for (let project of storybookProjects) {
-          logger24.debug(`Updating dependencies in ${shortenPath(project.configDir)}...`);
+          logger25.debug(`Updating dependencies in ${shortenPath(project.configDir)}...`);
           let newPaths = project.packageManager.packageJsonPaths.map(shortenPath).filter((path4) => !loggedPaths.includes(path4));
           newPaths.length > 0 && (task.message(newPaths.join(`
 `)), loggedPaths.push(...newPaths)), await upgradeStorybookDependencies({
@@ -9996,17 +10381,17 @@ Upgrade interrupted by user.`), allProjects.length > 1 && await sendMultiUpgrade
       }
     }
     let automigrationResults2 = {}, detectedAutomigrations = [];
-    options.skipAutomigrations ? logger24.log("Skipping automigrations (--skip-automigrations).") : { automigrationResults: automigrationResults2, detectedAutomigrations } = await runAutomigrations(
+    options.skipAutomigrations ? logger25.log("Skipping automigrations (--skip-automigrations).") : { automigrationResults: automigrationResults2, detectedAutomigrations } = await runAutomigrations(
       storybookProjects,
       options
     );
     let rootPackageManager = storybookProjects.length > 1 ? JsPackageManagerFactory2.getPackageManager({ force: options.packageManager }) : storybookProjects[0].packageManager;
-    rootPackageManager.type === "npm" ? await rootPackageManager.installDependencies({ force: !0 }) : await rootPackageManager.installDependencies(), rootPackageManager.type !== PackageManagerName2.YARN1 && rootPackageManager.isStorybookInMonorepo() && (logger24.warn(
+    rootPackageManager.type === "npm" ? await rootPackageManager.installDependencies({ force: !0 }) : await rootPackageManager.installDependencies(), rootPackageManager.type !== PackageManagerName2.YARN1 && rootPackageManager.isStorybookInMonorepo() && (logger25.warn(
       "Since you are in a monorepo, we advise you to deduplicate your dependencies. We can do this for you but it might take some time."
-    ), options.yes || await prompt6.confirm({
+    ), options.yes || await prompt7.confirm({
       message: `Execute ${rootPackageManager.getRunCommand("dedupe")}?`,
       initialValue: !0
-    }) ? rootPackageManager.type === "npm" ? await rootPackageManager.dedupeDependencies({ force: !0 }) : await rootPackageManager.dedupeDependencies() : logger24.log(
+    }) ? rootPackageManager.type === "npm" ? await rootPackageManager.dedupeDependencies({ force: !0 }) : await rootPackageManager.dedupeDependencies() : logger25.log(
       `If you find any issues running Storybook, you can run ${rootPackageManager.getRunCommand("dedupe")} manually to deduplicate your dependencies and try again.`
     ));
     let doctorProjects = storybookProjects.map((project) => ({
@@ -10015,7 +10400,7 @@ Upgrade interrupted by user.`), allProjects.length > 1 && await sendMultiUpgrade
       storybookVersion: project.currentCLIVersion,
       mainConfig: project.mainConfig
     }));
-    logger24.step("Checking the health of your project(s).."), doctorResults = await runMultiProjectDoctor(doctorProjects), displayDoctorResults(doctorResults) && logTracker3.enableLogWriting(), logUpgradeResults(automigrationResults2, detectedAutomigrations, doctorResults);
+    logger25.step("Checking the health of your project(s).."), doctorResults = await runMultiProjectDoctor(doctorProjects), displayDoctorResults(doctorResults) && logTracker3.enableLogWriting(), logUpgradeResults(automigrationResults2, detectedAutomigrations, doctorResults);
     for (let project of storybookProjects) {
       let resultData = automigrationResults2[project.configDir] || {
         automigrationStatuses: {},
@@ -10051,13 +10436,13 @@ Upgrade interrupted by user.`), allProjects.length > 1 && await sendMultiUpgrade
 // src/bin/run.ts
 addToGlobalContext("cliVersion", versions5.storybook);
 var handleCommandFailure = (logFilePath) => async (error) => {
-  error instanceof HandledError3 || logger25.error(String(error));
+  error instanceof HandledError3 || logger26.error(String(error));
   try {
     let logFile = await logTracker4.writeToFile(logFilePath);
-    logger25.log(`Debug logs are written to: ${logFile}`);
+    logger26.log(`Debug logs are written to: ${logFile}`);
   } catch {
   }
-  logger25.outro(""), process.exit(1);
+  logger26.outro(""), process.exit(1);
 }, command = (name) => program.command(name).option(
   "--disable-telemetry",
   "Disable sending telemetry data",
@@ -10067,21 +10452,21 @@ var handleCommandFailure = (logFilePath) => async (error) => {
   "Write all debug logs to the specified file at the end of the run. Defaults to debug-storybook.log when [path] is not provided"
 ).option("--loglevel <trace | debug | info | warn | error | silent>", "Define log level", "info").hook("preAction", async (self2) => {
   let options = self2.opts();
-  options.debug && logger25.setLogLevel("debug"), options.loglevel && logger25.setLogLevel(options.loglevel), options.logfile && logTracker4.enableLogWriting();
+  options.debug && logger26.setLogLevel("debug"), options.loglevel && logger26.setLogLevel(options.loglevel), options.logfile && logTracker4.enableLogWriting();
   try {
     await globalSettings();
   } catch (e) {
-    logger25.error(`Error loading global settings:
+    logger26.error(`Error loading global settings:
 ` + String(e));
   }
 }).hook("postAction", async (command2) => {
   if (logTracker4.shouldWriteLogsToFile) {
     try {
       let logFile = await logTracker4.writeToFile(command2.getOptionValue("logfile"));
-      logger25.log(`Debug logs are written to: ${logFile}`);
+      logger26.log(`Debug logs are written to: ${logFile}`);
     } catch {
     }
-    logger25.outro(CLI_COLORS5.success("Done!"));
+    logger26.outro(CLI_COLORS5.success("Done!"));
   }
 });
 command("init").description("Initialize Storybook into your project").option("-f --force", "Force add Storybook").option("-s --skip-install", "Skip installing deps").addOption(
@@ -10098,7 +10483,7 @@ command("add <addon>").description("Add an addon to your Storybook").addOption(
   )
 ).option("-c, --config-dir <dir-name>", "Directory where to load Storybook configurations from").option("--skip-install", "Skip installing deps").option("-s --skip-postinstall", "Skip package specific postinstall config modifications").option("-y --yes", "Skip prompting the user").option("--skip-doctor", "Skip doctor check").action((addonName, options) => {
   withTelemetry("add", { cliOptions: options }, async () => {
-    logger25.intro(`Setting up your project for ${addonName}`), await add(addonName, options), await telemetry3("add", { addon: addonName, source: "cli" }), logger25.outro("Done!");
+    logger26.intro(`Setting up your project for ${addonName}`), await add(addonName, options), await telemetry3("add", { addon: addonName, source: "cli" }), logger26.outro("Done!");
   }).catch(handleCommandFailure);
 });
 command("remove <addon>").description("Remove an addon from your Storybook").addOption(
@@ -10107,7 +10492,7 @@ command("remove <addon>").description("Remove an addon from your Storybook").add
   )
 ).option("-c, --config-dir <dir-name>", "Directory where to load Storybook configurations from").option("-s --skip-install", "Skip installing deps").action(
   (addonName, options) => withTelemetry("remove", { cliOptions: options }, async () => {
-    logger25.intro(`Removing ${addonName} from your Storybook`);
+    logger26.intro(`Removing ${addonName} from your Storybook`);
     let packageManager = JsPackageManagerFactory3.getPackageManager({
       configDir: options.configDir,
       force: options.packageManager
@@ -10116,7 +10501,7 @@ command("remove <addon>").description("Remove an addon from your Storybook").add
       configDir: options.configDir,
       packageManager,
       skipInstall: options.skipInstall
-    }), await telemetry3("remove", { addon: addonName, source: "cli" }), logger25.outro("Done!");
+    }), await telemetry3("remove", { addon: addonName, source: "cli" }), logger26.outro("Done!");
   }).catch(handleCommandFailure(options.logfile))
 );
 command("upgrade").description(`Upgrade your Storybook packages to v${versions5.storybook}`).addOption(
@@ -10134,12 +10519,12 @@ command("upgrade").description(`Upgrade your Storybook packages to v${versions5.
     "upgrade",
     { cliOptions: { ...options, configDir: options.configDir?.[0] } },
     async () => {
-      logger25.intro(`Storybook upgrade - v${versions5.storybook}`), await upgrade(options), logger25.outro("Storybook upgrade completed!");
+      logger26.intro(`Storybook upgrade - v${versions5.storybook}`), await upgrade(options), logger26.outro("Storybook upgrade completed!");
     }
   ).catch(handleCommandFailure(options.logfile));
 });
 command("info").description("Prints debugging information about the local environment").action(async () => {
-  logger25.log(import_picocolors17.default.bold(`
+  logger26.log(import_picocolors18.default.bold(`
 Storybook Environment Info:`));
   let activePackageManager = JsPackageManagerFactory3.getPackageManager().type.replace(/\d/, ""), output = await import_envinfo.default.run({
     System: ["OS", "CPU", "Shell"],
@@ -10148,10 +10533,10 @@ Storybook Environment Info:`));
     npmPackages: "{@storybook/*,*storybook*,sb,chromatic}",
     npmGlobalPackages: "{@storybook/*,*storybook*,sb,chromatic}"
   }), activePackageManagerLine = output.match(new RegExp(`${activePackageManager}:.*`, "i"));
-  logger25.log(
+  logger26.log(
     output.replace(
       activePackageManagerLine,
-      import_picocolors17.default.bold(`${activePackageManagerLine} <----- active`)
+      import_picocolors18.default.bold(`${activePackageManagerLine} <----- active`)
     )
   );
 });
@@ -10163,12 +10548,12 @@ command("migrate [migration]").description("Run a Storybook codemod migration on
   'Rename suffix of matching files after codemod has been applied, e.g. ".js:.ts"'
 ).action((migration, options) => {
   withTelemetry("migrate", { cliOptions: options }, async () => {
-    logger25.intro(`Running ${migration} migration`), await migrate(migration, options), logger25.outro("Migration completed");
+    logger26.intro(`Running ${migration} migration`), await migrate(migration, options), logger26.outro("Migration completed");
   }).catch(handleCommandFailure(options.logfile));
 });
 command("sandbox [filterValue]").alias("repro").description("Create a sandbox from a set of possible templates").option("-o --output <outDir>", "Define an output directory").option("--no-init", "Whether to download a template without an initialized Storybook", !1).action((filterValue, options) => {
-  logger25.intro("Creating a Storybook sandbox..."), sandbox({ filterValue, ...options }).catch(handleCommandFailure).finally(() => {
-    logger25.outro("Done!");
+  logger26.intro("Creating a Storybook sandbox..."), sandbox({ filterValue, ...options }).catch(handleCommandFailure).finally(() => {
+    logger26.outro("Done!");
   });
 });
 command("link <repo-url-or-directory>").description("Pull down a repro from a URL (or a local directory), link it, and run storybook").option("--local", "Link a local directory already in your file system").option("--no-start", "Start the storybook", !0).action(
@@ -10183,7 +10568,7 @@ command("automigrate [fixId]").description("Check storybook for incompatibilitie
   "The renderer package for the framework Storybook is using."
 ).option("--skip-doctor", "Skip doctor check").option("--glob <pattern>", "Glob pattern for story files (for csf-factories codemod)").action(async (fixId, options) => {
   withTelemetry("automigrate", { cliOptions: options }, async () => {
-    logger25.intro(fixId ? `Running ${fixId} automigration` : "Running automigrations"), await doAutomigrate({ fixId, ...options }), logger25.outro("Done");
+    logger26.intro(fixId ? `Running ${fixId} automigration` : "Running automigrations"), await doAutomigrate({ fixId, ...options }), logger26.outro("Done");
   }).catch(handleCommandFailure(options.logfile));
 });
 command("doctor").description("Check Storybook for known problems and provide suggestions or fixes").addOption(
@@ -10192,7 +10577,7 @@ command("doctor").description("Check Storybook for known problems and provide su
   )
 ).option("-c, --config-dir <dir-name>", "Directory of Storybook configuration").action(async (options) => {
   withTelemetry("doctor", { cliOptions: options }, async () => {
-    logger25.intro("Doctoring Storybook"), await doctor(options), logger25.outro("Done");
+    logger26.intro("Doctoring Storybook"), await doctor(options), logger26.outro("Done");
   }).catch(handleCommandFailure(options.logfile));
 });
 var aiCommand = command("ai").description("AI agent helpers for Storybook").option(
@@ -10213,9 +10598,9 @@ aiCommand.action(() => {
   aiCommand.outputHelp();
 });
 program.on("command:*", ([invalidCmd]) => {
-  let errorMessage = ` Invalid command: ${import_picocolors17.default.bold(invalidCmd)}.
+  let errorMessage = ` Invalid command: ${import_picocolors18.default.bold(invalidCmd)}.
  See --help for a list of available commands.`, suggestion = program.commands.map((cmd) => cmd.name()).find((cmd) => leven(cmd, invalidCmd) < 3);
   suggestion && (errorMessage += `
- Did you mean ${import_picocolors17.default.yellow(suggestion)}?`), logger25.error(errorMessage), process.exit(1);
+ Did you mean ${import_picocolors18.default.yellow(suggestion)}?`), logger26.error(errorMessage), process.exit(1);
 });
 program.usage("<command> [options]").version(String(version)).parse(process.argv);