@storybook/tanstack-react 10.5.7 → 10.5.8

package/dist/_browser-chunks/{chunk-6UULZFFJ.js → chunk-TR4QWDPU.js}

@@ -9,6 +9,7 @@ import {
 var preview_exports = {};
 __export(preview_exports, {
   applyDecorators: () => applyDecorators,
+  beforeEach: () => beforeEach,
   loaders: () => loaders,
   optimizeDeps: () => optimizeDeps,
   parameters: () => parameters
@@ -16,16 +17,16 @@ __export(preview_exports, {
 import { applyDecorators as reactApplyDecorators } from "@storybook/react/entry-preview-docs";
 
 // src/routing/decorator.tsx
-import React from "react";
 import {
   createMemoryHistory,
   createRootRoute,
   createRoute as createRoute2,
   createRouter,
-  RouterProvider,
+  defaultStringifySearch,
   interpolatePath,
-  defaultStringifySearch
+  RouterProvider
 } from "@tanstack/react-router";
+import React from "react";
 
 // src/routing/duplicate-tree.ts
 import {
@@ -133,17 +134,15 @@ var StoryContext = React.createContext({ Story: () => null }), StoryFromContext
   return React.createElement(Story, null);
 }, tanstackRouteDecorator = (Story, context) => React.createElement(TanStackRouterStory, { Story, context });
 function TanStackRouterStory({ Story, context }) {
-  let routerContext = context.parameters.tanstack?.router?.useRouterContext?.({
+  let router = context.tanstackRouter, routerContext = context.parameters.tanstack?.router?.useRouterContext?.({
     storyContext: context
-  }), router = React.useMemo(
-    () => createStoryRouter({ Story: StoryFromContext, context, routerContext }),
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [context.id]
-  ), providerContext = React.useMemo(
-    () => ({
-      ...context.parameters.tanstack?.router?.context,
-      ...routerContext
-    }),
+  });
+  if (!router)
+    throw new Error(
+      "No story router found on the story context: the `routerBeforeEach` hook of @storybook/tanstack-react did not run before rendering. Note that portable stories are not supported by this framework."
+    );
+  let providerContext = React.useMemo(
+    () => routerContext,
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [context.id, routerContext]
   );
@@ -242,6 +241,30 @@ function resolveTree(Story, context) {
   };
 }
 
+// src/routing/before-each.ts
+var storyRouters = /* @__PURE__ */ new Map(), routerBeforeEach = async (context) => {
+  let cached = storyRouters.get(context.id);
+  if (cached) {
+    context.tanstackRouter = cached;
+    return;
+  }
+  let storyContext = context, parameterContext = (context.parameters.tanstack?.router ?? {}).context, routerContext = typeof parameterContext == "function" ? parameterContext({ storyContext }) : parameterContext, router = createStoryRouter({
+    Story: StoryFromContext,
+    context: storyContext,
+    routerContext
+  }), load = router.load();
+  if (context.abortSignal && !context.abortSignal.aborted ? (load.catch(() => {
+  }), await Promise.race([
+    load,
+    new Promise(
+      (resolve) => context.abortSignal.addEventListener("abort", () => resolve(), { once: !0 })
+    )
+  ])) : await load, !context.abortSignal?.aborted)
+    return storyRouters.set(context.id, router), context.tanstackRouter = router, () => {
+      storyRouters.delete(context.id);
+    };
+};
+
 // src/routing/loader.ts
 import { RootRoute as RootRoute3 } from "@tanstack/react-router";
 function getComponentFromRoute(route) {
@@ -262,7 +285,7 @@ var routeComponentLoader = (context) => {
 };
 
 // src/preview.tsx
-var loaders = [routeComponentLoader], applyDecorators = (storyFn, allDecorators) => (
+var loaders = [routeComponentLoader], beforeEach = [routerBeforeEach], applyDecorators = (storyFn, allDecorators) => (
   // reorder decorators so `jsxDecorator` is innermost, and `tanstackRouteDecorator` is just outside it
   // There is an issue if `tanstackRouteDecorator` is innermost. All stories crashes due to a bug with the jsxDecorator.
   reactApplyDecorators(storyFn, [
@@ -279,6 +302,7 @@ var loaders = [routeComponentLoader], applyDecorators = (storyFn, allDecorators)
 
 export {
   loaders,
+  beforeEach,
   applyDecorators,
   parameters,
   optimizeDeps,

package/dist/{chunk-CT6Edisg.d.ts → chunk-B0pqNVvJ.d.ts}

@@ -86,10 +86,11 @@ interface RouterParameters<TRoute = undefined, Path extends (TRoute extends AnyR
    * ```
    */
   routeOverrides?: RouteTreeOverrides;
-  context?: Record<string, unknown>;
-  /**
-   *
-   */
+  /** Object or factory; the factory runs before initial router load outside React, so loader and beforeLoad can read its values. */
+  context?: Record<string, unknown> | ((options: {
+    storyContext: Parameters<Decorator>[1];
+  }) => Record<string, unknown>);
+  /** React hook render context reaches components, not the initial loader or beforeLoad; use the context factory for loader-visible values. */
   useRouterContext?: ({
     storyContext
   }: {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as TanStackPreviewOptions, c as IsRoute, d as StoryRouteOptions, i as TanStackParameters, l as RouterParameters, n as FrameworkOptions, o as TanStackTypes, r as StorybookConfig, s as CreateStoryRouteOptions, t as DefaultStoryPath, u as StoryRouteFileOptions } from "./chunk-CT6Edisg.js";
+import { a as TanStackPreviewOptions, c as IsRoute, d as StoryRouteOptions, i as TanStackParameters, l as RouterParameters, n as FrameworkOptions, o as TanStackTypes, r as StorybookConfig, s as CreateStoryRouteOptions, t as DefaultStoryPath, u as StoryRouteFileOptions } from "./chunk-B0pqNVvJ.js";
 import { ComponentType } from "react";
 import { AddonTypes, InferTypes, PreviewAddon } from "storybook/internal/csf";
 import { Args, ArgsStoryFn, ComponentAnnotations, DecoratorFunction, Parameters, ProjectAnnotations, Renderer, StoryAnnotations } from "storybook/internal/types";

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   preview_exports
-} from "./_browser-chunks/chunk-6UULZFFJ.js";
+} from "./_browser-chunks/chunk-TR4QWDPU.js";
 import "./_browser-chunks/chunk-LTDGLEVR.js";
 import "./_browser-chunks/chunk-4BE7D4DS.js";
 

package/dist/node/index.d.ts

@@ -1,4 +1,4 @@
-import { r as StorybookConfig } from "../chunk-CT6Edisg.js";
+import { r as StorybookConfig } from "../chunk-B0pqNVvJ.js";
 
 //#region code/frameworks/tanstack-react/.dts-emit/code/frameworks/tanstack-react/src/node/index.d.ts
 declare function defineMain(config: StorybookConfig): StorybookConfig;

package/dist/node/index.js

@@ -1,10 +1,10 @@
-import CJS_COMPAT_NODE_URL_4wc9cb9s2m3 from 'node:url';
-import CJS_COMPAT_NODE_PATH_4wc9cb9s2m3 from 'node:path';
-import CJS_COMPAT_NODE_MODULE_4wc9cb9s2m3 from "node:module";
+import CJS_COMPAT_NODE_URL_466ftmvrh3c from 'node:url';
+import CJS_COMPAT_NODE_PATH_466ftmvrh3c from 'node:path';
+import CJS_COMPAT_NODE_MODULE_466ftmvrh3c from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_4wc9cb9s2m3.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_4wc9cb9s2m3.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_4wc9cb9s2m3.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_466ftmvrh3c.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_466ftmvrh3c.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_466ftmvrh3c.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration

package/dist/preset.js

@@ -1,10 +1,10 @@
-import CJS_COMPAT_NODE_URL_4wc9cb9s2m3 from 'node:url';
-import CJS_COMPAT_NODE_PATH_4wc9cb9s2m3 from 'node:path';
-import CJS_COMPAT_NODE_MODULE_4wc9cb9s2m3 from "node:module";
+import CJS_COMPAT_NODE_URL_466ftmvrh3c from 'node:url';
+import CJS_COMPAT_NODE_PATH_466ftmvrh3c from 'node:path';
+import CJS_COMPAT_NODE_MODULE_466ftmvrh3c from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_4wc9cb9s2m3.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_4wc9cb9s2m3.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_4wc9cb9s2m3.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_466ftmvrh3c.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_466ftmvrh3c.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_466ftmvrh3c.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
@@ -30,6 +30,17 @@ var dirname = function(p) {
 // src/preset.ts
 import { viteFinal as reactViteFinal } from "@storybook/react-vite/preset";
 
+// src/plugins/incompatible-plugins.ts
+var matchesPluginName = (p, matches) => {
+  if (Array.isArray(p))
+    return p.some((entry) => matchesPluginName(entry, matches));
+  let pluginRecord = p;
+  return typeof p == "object" && p !== null && "name" in pluginRecord && typeof pluginRecord.name == "string" && matches(pluginRecord.name);
+}, isTanStackStartPlugin = (p) => matchesPluginName(p, (name) => name.startsWith("tanstack-start") || name.includes("rsc:")), isCloudflareVitePlugin = (p) => matchesPluginName(
+  p,
+  (name) => name === "vite-plugin-cloudflare" || name.startsWith("vite-plugin-cloudflare:")
+);
+
 // src/plugins/server-code-elimination.ts
 import { types as t, transformSync } from "storybook/internal/babel";
 var SERVER_FN_RE = /\bcreateServerFn\b/, MIDDLEWARE_RE = /\bcreateMiddleware\b/, ISOMORPHIC_FN_RE = /\bcreateIsomorphicFn\b/, SERVER_ONLY_FN_RE = /\bcreateServerOnlyFn\b/, CLIENT_ONLY_FN_RE = /\bcreateClientOnlyFn\b/, ROUTE_FACTORY_RE = /\b(createFileRoute|createRootRoute|createRootRouteWithContext|createRoute)\b/, ROUTE_FACTORIES = /* @__PURE__ */ new Set([
@@ -413,17 +424,13 @@ var core = async (config, options) => {
   "@tanstack/react-router > @tanstack/react-store",
   "use-sync-external-store/shim/with-selector"
 ], viteFinal = async (config, options) => {
-  let reactConfig = await reactViteFinal(config, options), isTanStackStartPlugin = (p) => {
-    if (Array.isArray(p))
-      return p.some(isTanStackStartPlugin);
-    let pluginRecord = p;
-    return typeof p == "object" && p !== null && "name" in pluginRecord && typeof pluginRecord.name == "string" && (pluginRecord.name.startsWith("tanstack-start") || pluginRecord.name.includes("rsc:"));
-  }, startMockPath = fileURLToPath(import.meta.resolve("./export-mocks/start.js")), startStorageContextMockPath = fileURLToPath(
+  let reactConfig = await reactViteFinal(config, options), startMockPath = fileURLToPath(import.meta.resolve("./export-mocks/start.js")), startStorageContextMockPath = fileURLToPath(
     import.meta.resolve("./export-mocks/start-storage-context.js")
   ), routerMockPath = fileURLToPath(
     import.meta.resolve("@storybook/tanstack-react/react-router")
   ), plugins = [
-    ...(reactConfig.plugins ?? []).filter((p) => !isTanStackStartPlugin(p)),
+    // Drop user plugins that are incompatible with Storybook — see ./plugins/incompatible-plugins.ts
+    ...(reactConfig.plugins ?? []).filter((p) => !isTanStackStartPlugin(p) && !isCloudflareVitePlugin(p)),
     serverCodeEliminationPlugin({ excludeFiles: [dirname(startMockPath)] }),
     serverOnlyStubPlugin(),
     moduleInterceptionPlugin({ startMockPath, startStorageContextMockPath, routerMockPath })

package/dist/preview.d.ts

@@ -1,11 +1,12 @@
-import { i as TanStackParameters } from "./chunk-CT6Edisg.js";
-import { DecoratorFunction, LoaderFunction, Renderer } from "storybook/internal/types";
+import { i as TanStackParameters } from "./chunk-B0pqNVvJ.js";
+import { BeforeEach, DecoratorFunction, LoaderFunction, Renderer } from "storybook/internal/types";
 import { applyDecorators as applyDecorators$1 } from "@storybook/react/entry-preview-docs";
 
 //#region code/frameworks/tanstack-react/.dts-emit/code/frameworks/tanstack-react/src/preview.d.ts
 declare const loaders: LoaderFunction<Renderer>[];
+declare const beforeEach: BeforeEach<Renderer>[];
 declare const applyDecorators: (storyFn: Parameters<typeof applyDecorators$1>[0], allDecorators: DecoratorFunction[]) => any;
 declare const parameters: TanStackParameters;
 declare const optimizeDeps: string[];
 //#endregion
-export { applyDecorators, loaders, optimizeDeps, parameters };
+export { applyDecorators, beforeEach, loaders, optimizeDeps, parameters };

package/dist/preview.js

@@ -1,13 +1,15 @@
 import {
   applyDecorators,
+  beforeEach,
   loaders,
   optimizeDeps,
   parameters
-} from "./_browser-chunks/chunk-6UULZFFJ.js";
+} from "./_browser-chunks/chunk-TR4QWDPU.js";
 import "./_browser-chunks/chunk-LTDGLEVR.js";
 import "./_browser-chunks/chunk-4BE7D4DS.js";
 export {
   applyDecorators,
+  beforeEach,
   loaders,
   optimizeDeps,
   parameters

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storybook/tanstack-react",
-  "version": "10.5.7",
+  "version": "10.5.8",
   "description": "Storybook for TanStack (React, Vite): Router and Start ready Storybook framework",
   "keywords": [
     "storybook",
@@ -75,9 +75,9 @@
     "!src/**/*"
   ],
   "dependencies": {
-    "@storybook/builder-vite": "10.5.7",
-    "@storybook/react": "10.5.7",
-    "@storybook/react-vite": "10.5.7"
+    "@storybook/builder-vite": "10.5.8",
+    "@storybook/react": "10.5.8",
+    "@storybook/react-vite": "10.5.8"
   },
   "devDependencies": {
     "@tanstack/react-router": "^1.168.10",
@@ -95,7 +95,7 @@
     "@tanstack/start-client-core": "^1.167.9",
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
     "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
-    "storybook": "^10.5.7",
+    "storybook": "^10.5.8",
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {

package/template/stories/LoaderContextInjection.stories.tsx

@@ -0,0 +1,45 @@
+import React from 'react';
+
+import type { Meta, StoryObj } from '@storybook/tanstack-react';
+
+import { expect, within } from 'storybook/test';
+
+const loaderCalls: unknown[] = [];
+
+function LoaderContextViewer() {
+  return <p data-testid="loader-context">{String(loaderCalls[0] ?? 'missing')}</p>;
+}
+
+const meta = {
+  component: LoaderContextViewer,
+  parameters: {
+    tanstack: {
+      router: {
+        context: () => {
+          loaderCalls.length = 0;
+          return { injected: 'from-factory' };
+        },
+        route: {
+          loader: ({ context }: { context: unknown }) => {
+            loaderCalls.push((context as any)?.injected ?? null);
+          },
+        },
+      },
+    },
+  },
+} satisfies Meta<typeof LoaderContextViewer>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+/** Factory router context is visible to the route loader before render. */
+export const FactoryValuesReachLoader: Story = {
+  play: async ({ canvasElement }) => {
+    const canvas = within(canvasElement);
+    await expect(canvas.getByTestId('loader-context')).toHaveTextContent('from-factory');
+
+    await expect(loaderCalls.length).toBeGreaterThan(0);
+    await expect(loaderCalls.every((call) => call === 'from-factory')).toBe(true);
+  },
+};

package/template/stories/RouterContextInjection.stories.tsx

@@ -0,0 +1,45 @@
+import React from 'react';
+
+import type { Meta, StoryObj } from '@storybook/tanstack-react';
+
+import { useRouter } from '@tanstack/react-router';
+import { expect, within } from 'storybook/test';
+
+const InjectedContext = React.createContext('missing-provider');
+
+function RouterContextViewer() {
+  const router = useRouter();
+  const injected = (router.options.context as { injected?: string } | undefined)?.injected;
+  return <p data-testid="injected-router-context">{injected ?? 'missing-context'}</p>;
+}
+
+const meta = {
+  component: RouterContextViewer,
+  decorators: [
+    (Story) => (
+      <InjectedContext.Provider value="from-react-hook">
+        <Story />
+      </InjectedContext.Provider>
+    ),
+  ],
+  parameters: {
+    tanstack: {
+      router: {
+        useRouterContext: () => ({ injected: React.useContext(InjectedContext) }),
+      },
+    },
+  },
+} satisfies Meta<typeof RouterContextViewer>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+/** Hook-derived values read from a decorator's React provider must reach the story's router. */
+export const HookValuesReachRouter: Story = {
+  play: async ({ canvasElement }) => {
+    await expect(within(canvasElement).getByTestId('injected-router-context')).toHaveTextContent(
+      'from-react-hook'
+    );
+  },
+};