@storybook/addon-docs 10.5.0-alpha.1 → 10.5.0-alpha.10

package/dist/ember/index.js

@@ -1,4 +1,4 @@
-import "../_browser-chunks/chunk-SL3VIQZ3.js";
+import "../_browser-chunks/chunk-UAWMPV5J.js";
 
 // src/ember/index.ts
 var setJSONDoc = (jsondoc) => {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as storybook_internal_csf from 'storybook/internal/csf';
 import React$1, { ReactElement, ComponentType } from 'react';
-import { Renderer, DocsContextProps, ModuleExport, ModuleExports, DocsRenderFunction } from 'storybook/internal/types';
+import { Renderer, DocsContextProps, ModuleExport, ModuleExports, Args, PreparedStory, DocsRenderFunction } from 'storybook/internal/types';
 import { ThemeVars } from 'storybook/theming';
 
 interface TocbotOptions {
@@ -65,6 +65,12 @@ type StoryBlockParameters = {
      */
     of: ModuleExport;
 };
+type StoriesBlockParameters = {
+    /**
+     * Custom filter function for determining which stories to include in a <Stories> block
+     */
+    filter?: <TRenderer extends Renderer = Renderer, TArgs = Args>(Story: PreparedStory<TRenderer>, Context: ReturnType<DocsContextProps['getStoryContext']>) => boolean;
+};
 type ControlsBlockParameters = {
     /** Exclude specific properties from the Controls panel */
     exclude?: string[] | RegExp;
@@ -96,6 +102,7 @@ type CanvasBlockParameters = {
      * buttons that do anything you specify in the onClick function.
      */
     additionalActions?: {
+        ariaLabel?: string;
         className?: string;
         disabled?: boolean;
         onClick: () => void;
@@ -217,17 +224,33 @@ interface DocsParameters {
          */
         source?: Partial<SourceBlockParameters>;
         /**
-         * Story configuration
+         * Story block configuration
          *
          * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-story
          */
         story?: Partial<StoryBlockParameters>;
+        /**
+         * Stories block configuration
+         *
+         * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-stories
+         */
+        stories?: Partial<StoriesBlockParameters>;
         /**
          * The subtitle displayed when shown in docs page
          *
          * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-subtitle
          */
         subtitle?: string;
+        /**
+         * The BCP-47 language tag applied to Storybook-rendered docs prose (descriptions, titles,
+         * ArgTypes description cells, free MDX prose).
+         *
+         * Storybook's own chrome stays English regardless. Inherited project → meta (page-level) or
+         * project → meta → story (per-story prose).
+         *
+         * @default 'en'
+         */
+        lang?: string;
         /**
          * Override the default theme
          *

package/dist/index.js

@@ -3,8 +3,8 @@ import {
 } from "./_browser-chunks/chunk-OATZR77O.js";
 import {
   preview_exports
-} from "./_browser-chunks/chunk-S4QKU6I5.js";
-import "./_browser-chunks/chunk-SL3VIQZ3.js";
+} from "./_browser-chunks/chunk-6Z2O5XYJ.js";
+import "./_browser-chunks/chunk-UAWMPV5J.js";
 
 // src/index.ts
 import { definePreviewAddon } from "storybook/internal/csf";

package/dist/manager.js

@@ -1,26 +1,30 @@
 import {
   Source
 } from "./_browser-chunks/chunk-SPXYZZB5.js";
-import "./_browser-chunks/chunk-SL3VIQZ3.js";
+import "./_browser-chunks/chunk-UAWMPV5J.js";
 
 // src/manager.tsx
 import React, { useEffect, useState } from "react";
 import { AddonPanel } from "storybook/internal/components";
 import { addons, types, useChannel, useParameter } from "storybook/manager-api";
 import { ignoreSsrWarning, styled, useTheme } from "storybook/theming";
-
-// ../../core/src/docs-tools/shared.ts
-var ADDON_ID = "storybook/docs", PANEL_ID = `${ADDON_ID}/panel`, PARAM_KEY = "docs", SNIPPET_RENDERED = `${ADDON_ID}/snippet-rendered`;
-
-// src/manager.tsx
+import {
+  ADDON_ID,
+  PANEL_ID,
+  PARAM_KEY,
+  shouldWaitForServiceSnippet,
+  SNIPPET_RENDERED
+} from "storybook/internal/docs-tools";
 var CodePanel = ({
   active,
   lastEvent,
-  currentStoryId
+  currentStoryId,
+  storyParameters,
+  storyPrepared
 }) => {
-  let [codeSnippet, setSourceCode] = useState({
-    source: lastEvent?.source,
-    format: lastEvent?.format ?? void 0
+  let lastEventMatchesCurrentStory = lastEvent?.id === currentStoryId, [codeSnippet, setSourceCode] = useState({
+    source: lastEventMatchesCurrentStory ? lastEvent?.source : void 0,
+    format: lastEventMatchesCurrentStory ? lastEvent?.format ?? void 0 : void 0
   }), parameter = useParameter(PARAM_KEY, {
     source: { code: "" },
     theme: "dark"
@@ -30,21 +34,16 @@ var CodePanel = ({
       source: void 0,
       format: void 0
     });
-  }, [currentStoryId]), useChannel({
-    [SNIPPET_RENDERED]: ({ source, format }) => {
-      setSourceCode({ source, format });
-    }
-  });
-  let isDark = useTheme().base !== "light";
-  return React.createElement(AddonPanel, { active: !!active }, React.createElement(SourceStyles, null, React.createElement(
-    Source,
+  }, [currentStoryId]), useChannel(
     {
-      ...parameter.source,
-      code: parameter.source?.code || codeSnippet.source || parameter.source?.originalSource,
-      format: codeSnippet.format,
-      dark: isDark
-    }
-  )));
+      [SNIPPET_RENDERED]: ({ id, source, format }) => {
+        id !== void 0 && id !== currentStoryId || setSourceCode({ source, format });
+      }
+    },
+    [currentStoryId]
+  );
+  let isDark = useTheme().base !== "light", awaitingServiceSnippet = shouldWaitForServiceSnippet(storyParameters, storyPrepared), code = parameter.source?.code || codeSnippet.source || (awaitingServiceSnippet ? "" : parameter.source?.originalSource);
+  return React.createElement(AddonPanel, { active: !!active }, React.createElement(SourceStyles, null, React.createElement(Source, { ...parameter.source, code, format: codeSnippet.format, dark: isDark })));
 };
 addons.register(ADDON_ID, (api) => {
   addons.add(PANEL_ID, {
@@ -68,7 +67,16 @@ addons.register(ADDON_ID, (api) => {
     match: ({ viewMode }) => viewMode === "story",
     render: ({ active }) => {
       let channel = api.getChannel(), currentStory = api.getCurrentStoryData(), lastEvent = channel?.last(SNIPPET_RENDERED)?.[0];
-      return React.createElement(CodePanel, { currentStoryId: currentStory?.id, lastEvent, active });
+      return React.createElement(
+        CodePanel,
+        {
+          currentStoryId: currentStory?.id,
+          storyParameters: currentStory?.parameters,
+          storyPrepared: currentStory?.prepared,
+          lastEvent,
+          active
+        }
+      );
     }
   });
 });

package/dist/mdx-loader.js

@@ -1,20 +1,20 @@
-import CJS_COMPAT_NODE_URL_gfstvrkbvmd from 'node:url';
-import CJS_COMPAT_NODE_PATH_gfstvrkbvmd from 'node:path';
-import CJS_COMPAT_NODE_MODULE_gfstvrkbvmd from "node:module";
+import CJS_COMPAT_NODE_URL_73jg7cechs from 'node:url';
+import CJS_COMPAT_NODE_PATH_73jg7cechs from 'node:path';
+import CJS_COMPAT_NODE_MODULE_73jg7cechs from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_gfstvrkbvmd.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_gfstvrkbvmd.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_gfstvrkbvmd.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_73jg7cechs.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_73jg7cechs.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_73jg7cechs.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
 // ------------------------------------------------------------
 import {
   compile
-} from "./_node-chunks/chunk-2P7DRLLN.js";
-import "./_node-chunks/chunk-CHBEJILX.js";
-import "./_node-chunks/chunk-ER2HZR2B.js";
-import "./_node-chunks/chunk-QT5SF4ZG.js";
+} from "./_node-chunks/chunk-4PS7XBET.js";
+import "./_node-chunks/chunk-DVPTS3HN.js";
+import "./_node-chunks/chunk-NOY765A3.js";
+import "./_node-chunks/chunk-KLL5RTY5.js";
 
 // src/mdx-loader.ts
 var DEFAULT_RENDERER = `