@storybook/addon-docs 10.2.0-alpha.9 → 10.2.0-beta.0

package/dist/mdx-loader.js

@@ -1,20 +1,20 @@
-import CJS_COMPAT_NODE_URL_vha0rbla5wk from 'node:url';
-import CJS_COMPAT_NODE_PATH_vha0rbla5wk from 'node:path';
-import CJS_COMPAT_NODE_MODULE_vha0rbla5wk from "node:module";
+import CJS_COMPAT_NODE_URL_01k6pddjk2qr from 'node:url';
+import CJS_COMPAT_NODE_PATH_01k6pddjk2qr from 'node:path';
+import CJS_COMPAT_NODE_MODULE_01k6pddjk2qr from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_vha0rbla5wk.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_vha0rbla5wk.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_vha0rbla5wk.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_01k6pddjk2qr.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_01k6pddjk2qr.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_01k6pddjk2qr.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
 // ------------------------------------------------------------
 import {
   compile
-} from "./_node-chunks/chunk-43QYHLJV.js";
-import "./_node-chunks/chunk-YI66PKT4.js";
-import "./_node-chunks/chunk-5AZDHS7P.js";
-import "./_node-chunks/chunk-3UNO4NZF.js";
+} from "./_node-chunks/chunk-QRHGYQPV.js";
+import "./_node-chunks/chunk-JA736U6F.js";
+import "./_node-chunks/chunk-V6MI33O5.js";
+import "./_node-chunks/chunk-6BX4ITXI.js";
 
 // src/mdx-loader.ts
 var DEFAULT_RENDERER = `

package/dist/preset.js

@@ -1,20 +1,20 @@
-import CJS_COMPAT_NODE_URL_vha0rbla5wk from 'node:url';
-import CJS_COMPAT_NODE_PATH_vha0rbla5wk from 'node:path';
-import CJS_COMPAT_NODE_MODULE_vha0rbla5wk from "node:module";
+import CJS_COMPAT_NODE_URL_01k6pddjk2qr from 'node:url';
+import CJS_COMPAT_NODE_PATH_01k6pddjk2qr from 'node:path';
+import CJS_COMPAT_NODE_MODULE_01k6pddjk2qr from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_vha0rbla5wk.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_vha0rbla5wk.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_vha0rbla5wk.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_01k6pddjk2qr.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_01k6pddjk2qr.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_01k6pddjk2qr.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
 // ------------------------------------------------------------
-import "./_node-chunks/chunk-3UNO4NZF.js";
+import "./_node-chunks/chunk-6BX4ITXI.js";
 
 // src/preset.ts
 import { isAbsolute as isAbsolute2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { logger } from "storybook/internal/node-logger";
+import { logger as logger2 } from "storybook/internal/node-logger";
 
 // ../../core/src/shared/utils/module.ts
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -149,12 +149,12 @@ function normalizeWindowsPath(input = "") {
   return input && input.replace(/\\/g, "/").replace(_DRIVE_LETTER_START_RE, (r) => r.toUpperCase());
 }
 var _UNC_REGEX = /^[/\\]{2}/, _IS_ABSOLUTE_RE = /^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^[A-Za-z]:[/\\]/, _DRIVE_LETTER_RE = /^[A-Za-z]:$/;
-var normalize = function(path2) {
-  if (path2.length === 0)
+var normalize = function(path3) {
+  if (path3.length === 0)
     return ".";
-  path2 = normalizeWindowsPath(path2);
-  let isUNCPath = path2.match(_UNC_REGEX), isPathAbsolute = isAbsolute(path2), trailingSeparator = path2[path2.length - 1] === "/";
-  return path2 = normalizeString(path2, !isPathAbsolute), path2.length === 0 ? isPathAbsolute ? "/" : trailingSeparator ? "./" : "." : (trailingSeparator && (path2 += "/"), _DRIVE_LETTER_RE.test(path2) && (path2 += "/"), isUNCPath ? isPathAbsolute ? `//${path2}` : `//./${path2}` : isPathAbsolute && !isAbsolute(path2) ? `/${path2}` : path2);
+  path3 = normalizeWindowsPath(path3);
+  let isUNCPath = path3.match(_UNC_REGEX), isPathAbsolute = isAbsolute(path3), trailingSeparator = path3[path3.length - 1] === "/";
+  return path3 = normalizeString(path3, !isPathAbsolute), path3.length === 0 ? isPathAbsolute ? "/" : trailingSeparator ? "./" : "." : (trailingSeparator && (path3 += "/"), _DRIVE_LETTER_RE.test(path3) && (path3 += "/"), isUNCPath ? isPathAbsolute ? `//${path3}` : `//./${path3}` : isPathAbsolute && !isAbsolute(path3) ? `/${path3}` : path3);
 }, join = function(...arguments_) {
   if (arguments_.length === 0)
     return ".";
@@ -163,11 +163,11 @@ var normalize = function(path2) {
     argument && argument.length > 0 && (joined === void 0 ? joined = argument : joined += `/${argument}`);
   return joined === void 0 ? "." : normalize(joined.replace(/\/\/+/g, "/"));
 };
-function normalizeString(path2, allowAboveRoot) {
+function normalizeString(path3, allowAboveRoot) {
   let res = "", lastSegmentLength = 0, lastSlash = -1, dots = 0, char = null;
-  for (let index = 0; index <= path2.length; ++index) {
-    if (index < path2.length)
-      char = path2[index];
+  for (let index = 0; index <= path3.length; ++index) {
+    if (index < path3.length)
+      char = path3[index];
     else {
       if (char === "/")
         break;
@@ -187,7 +187,7 @@ function normalizeString(path2, allowAboveRoot) {
         }
         allowAboveRoot && (res += res.length > 0 ? "/.." : "..", lastSegmentLength = 2);
       } else
-        res.length > 0 ? res += `/${path2.slice(lastSlash + 1, index)}` : res = path2.slice(lastSlash + 1, index), lastSegmentLength = index - lastSlash - 1;
+        res.length > 0 ? res += `/${path3.slice(lastSlash + 1, index)}` : res = path3.slice(lastSlash + 1, index), lastSegmentLength = index - lastSlash - 1;
       lastSlash = index, dots = 0;
     } else char === "." && dots !== -1 ? ++dots : dots = -1;
   }
@@ -212,6 +212,85 @@ var importMetaResolve = (...args) => typeof import.meta.resolve != "function" &&
   }
 };
 
+// src/manifest.ts
+import * as fs from "node:fs/promises";
+import * as path2 from "node:path";
+import { groupBy } from "storybook/internal/common";
+import { Tag, analyzeMdx } from "storybook/internal/core-server";
+import { logger } from "storybook/internal/node-logger";
+async function createDocsManifestEntry(entry) {
+  let absolutePath = path2.join(process.cwd(), entry.importPath);
+  try {
+    let content = await fs.readFile(absolutePath, "utf-8"), { summary } = await analyzeMdx(content);
+    return {
+      id: entry.id,
+      name: entry.name,
+      path: entry.importPath,
+      title: entry.title,
+      content,
+      ...summary && { summary }
+    };
+  } catch (err) {
+    return {
+      id: entry.id,
+      name: entry.name,
+      path: entry.importPath,
+      title: entry.title,
+      error: {
+        name: err instanceof Error ? err.name : "Error",
+        message: err instanceof Error ? err.message : String(err)
+      }
+    };
+  }
+}
+async function extractUnattachedDocsEntries(entries) {
+  if (entries.length === 0)
+    return {};
+  let entriesWithContent = await Promise.all(entries.map(createDocsManifestEntry));
+  return Object.fromEntries(entriesWithContent.map((entry) => [entry.id, entry]));
+}
+async function extractAttachedDocsEntries(entries, existingComponents) {
+  if (!existingComponents || entries.length === 0)
+    return existingComponents;
+  let entriesWithContent = await Promise.all(entries.map(createDocsManifestEntry));
+  for (let docsEntry of entriesWithContent) {
+    let componentId = docsEntry.id.split("--")[0], component = existingComponents.components[componentId];
+    component && (component.docs || (component.docs = {}), component.docs[docsEntry.id] = docsEntry);
+  }
+  return existingComponents;
+}
+var manifests = async (existingManifests = {}, { manifestEntries }) => {
+  let startPerformance = performance.now(), docsEntries = manifestEntries.filter(
+    (entry) => entry.type === "docs"
+  );
+  if (docsEntries.length === 0)
+    return existingManifests;
+  let { attachedEntries = [], unattachedEntries = [] } = groupBy(docsEntries, (entry) => {
+    switch (!0) {
+      case entry.tags?.includes(Tag.UNATTACHED_MDX):
+        return "unattachedEntries";
+      case entry.tags?.includes(Tag.ATTACHED_MDX):
+        return "attachedEntries";
+      default:
+        return "ignored";
+    }
+  });
+  if (unattachedEntries.length === 0 && attachedEntries.length === 0)
+    return existingManifests;
+  let existingManifestsWithDocs = existingManifests, [unattachedDocs, updatedComponents] = await Promise.all([
+    extractUnattachedDocsEntries(unattachedEntries),
+    extractAttachedDocsEntries(attachedEntries, existingManifestsWithDocs.components)
+  ]), processedCount = unattachedEntries.length + attachedEntries.length;
+  logger.verbose(
+    `Docs manifest generation took ${performance.now() - startPerformance}ms for ${processedCount} entries (${unattachedEntries.length} unattached, ${attachedEntries.length} attached)`
+  );
+  let result = { ...existingManifestsWithDocs };
+  return Object.keys(unattachedDocs).length > 0 && (result.docs = {
+    v: 0,
+    docs: unattachedDocs
+  }), updatedComponents && (result.components = updatedComponents), result;
+};
+
 // src/preset.ts
 var getResolvedReact = async (options) => {
   let resolvedReact2 = await options.presets.apply("resolvedReact", {});
@@ -227,7 +306,7 @@ var getResolvedReact = async (options) => {
   };
 };
 async function webpack(webpackConfig = {}, options) {
-  let { module = {} } = webpackConfig, { csfPluginOptions = {}, mdxPluginOptions = {} } = options, enrichCsf = await options.presets.apply("experimental_enrichCsf"), rehypeSlug = (await import("./_node-chunks/rehype-slug-O7HUORBA.js")).default, rehypeExternalLinks = (await import("./_node-chunks/rehype-external-links-ZPBLZPHM.js")).default, mdxLoaderOptions = await options.presets.apply("mdxLoaderOptions", {
+  let { module = {} } = webpackConfig, { csfPluginOptions = {}, mdxPluginOptions = {} } = options, enrichCsf = await options.presets.apply("experimental_enrichCsf"), rehypeSlug = (await import("./_node-chunks/rehype-slug-X4CX3DCY.js")).default, rehypeExternalLinks = (await import("./_node-chunks/rehype-external-links-BKM5LEVM.js")).default, mdxLoaderOptions = await options.presets.apply("mdxLoaderOptions", {
     ...mdxPluginOptions,
     mdxCompileOptions: {
       providerImportSource: import.meta.resolve("@storybook/addon-docs/mdx-react-shim"),
@@ -239,7 +318,7 @@ async function webpack(webpackConfig = {}, options) {
       ]
     }
   });
-  logger.info("Addon-docs: using MDX3");
+  logger2.info("Addon-docs: using MDX3");
   let { react, reactDom, mdx } = await getResolvedReact(options), alias;
   return Array.isArray(webpackConfig.resolve?.alias) ? (alias = [...webpackConfig.resolve?.alias], alias.push(
     {
@@ -303,7 +382,7 @@ var docs = (input = {}, options) => {
 }, addons = [
   import.meta.resolve("@storybook/react-dom-shim/preset")
 ], viteFinal = async (config, options) => {
-  let { plugins = [] } = config, { mdxPlugin } = await import("./_node-chunks/mdx-plugin-AJ33BARZ.js"), { react, reactDom, mdx } = await getResolvedReact(options), packageDeduplicationPlugin = {
+  let { plugins = [] } = config, { mdxPlugin } = await import("./_node-chunks/mdx-plugin-LGUWTE7W.js"), { react, reactDom, mdx } = await getResolvedReact(options), packageDeduplicationPlugin = {
     name: "storybook:package-deduplication",
     enforce: "pre",
     config: () => ({
@@ -334,6 +413,7 @@ var docs = (input = {}, options) => {
 export {
   addons,
   docsX as docs,
+  manifests as experimental_manifests,
   optimizeViteDeps,
   resolvedReact,
   viteFinal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storybook/addon-docs",
-  "version": "10.2.0-alpha.9",
+  "version": "10.2.0-beta.0",
   "description": "Storybook Docs: Document UI components automatically with stories and MDX",
   "keywords": [
     "docs",
@@ -80,9 +80,9 @@
   ],
   "dependencies": {
     "@mdx-js/react": "^3.0.0",
-    "@storybook/csf-plugin": "10.2.0-alpha.9",
-    "@storybook/icons": "^2.0.0",
-    "@storybook/react-dom-shim": "10.2.0-alpha.9",
+    "@storybook/csf-plugin": "10.2.0-beta.0",
+    "@storybook/icons": "^2.0.1",
+    "@storybook/react-dom-shim": "10.2.0-beta.0",
     "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",
     "ts-dedent": "^2.0.0"
@@ -93,7 +93,7 @@
     "@types/color-convert": "^2.0.0",
     "@types/react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
     "color-convert": "^2.0.1",
-    "es-toolkit": "^1.36.0",
+    "es-toolkit": "^1.43.0",
     "github-slugger": "^2.0.0",
     "markdown-to-jsx": "^7.7.2",
     "memoizerific": "^1.11.3",
@@ -105,11 +105,11 @@
     "rehype-slug": "^6.0.0",
     "telejson": "8.0.0",
     "tocbot": "^4.20.1",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "vite": "^7.0.4"
   },
   "peerDependencies": {
-    "storybook": "^10.2.0-alpha.9"
+    "storybook": "^10.2.0-beta.0"
   },
   "publishConfig": {
     "access": "public"

package/dist/_browser-chunks/chunk-FYME3FCW.js

@@ -1,209 +0,0 @@
-// ../../../node_modules/es-toolkit/dist/function/debounce.mjs
-function debounce(func, debounceMs, { signal, edges } = {}) {
-  let pendingThis, pendingArgs = null, leading = edges != null && edges.includes("leading"), trailing = edges == null || edges.includes("trailing"), invoke = () => {
-    pendingArgs !== null && (func.apply(pendingThis, pendingArgs), pendingThis = void 0, pendingArgs = null);
-  }, onTimerEnd = () => {
-    trailing && invoke(), cancel();
-  }, timeoutId = null, schedule = () => {
-    timeoutId != null && clearTimeout(timeoutId), timeoutId = setTimeout(() => {
-      timeoutId = null, onTimerEnd();
-    }, debounceMs);
-  }, cancelTimer = () => {
-    timeoutId !== null && (clearTimeout(timeoutId), timeoutId = null);
-  }, cancel = () => {
-    cancelTimer(), pendingThis = void 0, pendingArgs = null;
-  }, flush = () => {
-    cancelTimer(), invoke();
-  }, debounced = function(...args) {
-    if (signal?.aborted)
-      return;
-    pendingThis = this, pendingArgs = args;
-    let isFirstCall = timeoutId == null;
-    schedule(), leading && isFirstCall && invoke();
-  };
-  return debounced.schedule = schedule, debounced.cancel = cancel, debounced.flush = flush, signal?.addEventListener("abort", cancel, { once: !0 }), debounced;
-}
-
-// src/blocks/controls/helpers.ts
-var getControlId = (value) => `control-${value.replace(/\s+/g, "-")}`, getControlSetterButtonId = (value) => `set-${value.replace(/\s+/g, "-")}`;
-
-// ../../../node_modules/es-toolkit/dist/function/partial.mjs
-function partial(func, ...partialArgs) {
-  return partialImpl(func, placeholderSymbol, ...partialArgs);
-}
-function partialImpl(func, placeholder, ...partialArgs) {
-  let partialed = function(...providedArgs) {
-    let providedArgsIndex = 0, substitutedArgs = partialArgs.slice().map((arg) => arg === placeholder ? providedArgs[providedArgsIndex++] : arg), remainingArgs = providedArgs.slice(providedArgsIndex);
-    return func.apply(this, substitutedArgs.concat(remainingArgs));
-  };
-  return func.prototype && (partialed.prototype = Object.create(func.prototype)), partialed;
-}
-var placeholderSymbol = Symbol("partial.placeholder");
-partial.placeholder = placeholderSymbol;
-
-// ../../../node_modules/es-toolkit/dist/function/partialRight.mjs
-function partialRight(func, ...partialArgs) {
-  return partialRightImpl(func, placeholderSymbol2, ...partialArgs);
-}
-function partialRightImpl(func, placeholder, ...partialArgs) {
-  let partialedRight = function(...providedArgs) {
-    let placeholderLength = partialArgs.filter((arg) => arg === placeholder).length, rangeLength = Math.max(providedArgs.length - placeholderLength, 0), remainingArgs = providedArgs.slice(0, rangeLength), providedArgsIndex = rangeLength, substitutedArgs = partialArgs.slice().map((arg) => arg === placeholder ? providedArgs[providedArgsIndex++] : arg);
-    return func.apply(this, remainingArgs.concat(substitutedArgs));
-  };
-  return func.prototype && (partialedRight.prototype = Object.create(func.prototype)), partialedRight;
-}
-var placeholderSymbol2 = Symbol("partialRight.placeholder");
-partialRight.placeholder = placeholderSymbol2;
-
-// ../../../node_modules/es-toolkit/dist/function/asyncNoop.mjs
-async function asyncNoop() {
-}
-
-// ../../../node_modules/es-toolkit/dist/function/identity.mjs
-function identity(x) {
-  return x;
-}
-
-// ../../../node_modules/es-toolkit/dist/function/memoize.mjs
-function memoize(fn, options = {}) {
-  let { cache = /* @__PURE__ */ new Map(), getCacheKey } = options, memoizedFn = function(arg) {
-    let key = getCacheKey ? getCacheKey(arg) : arg;
-    if (cache.has(key))
-      return cache.get(key);
-    let result = fn.call(this, arg);
-    return cache.set(key, result), result;
-  };
-  return memoizedFn.cache = cache, memoizedFn;
-}
-
-// ../../../node_modules/es-toolkit/dist/function/noop.mjs
-function noop() {
-}
-
-// ../../../node_modules/es-toolkit/dist/function/once.mjs
-function once(func) {
-  let called = !1, cache;
-  return function(...args) {
-    return called || (called = !0, cache = func(...args)), cache;
-  };
-}
-
-// ../../../node_modules/es-toolkit/dist/error/AbortError.mjs
-var AbortError = class extends Error {
-  constructor(message = "The operation was aborted") {
-    super(message), this.name = "AbortError";
-  }
-};
-
-// ../../../node_modules/es-toolkit/dist/promise/delay.mjs
-function delay(ms, { signal } = {}) {
-  return new Promise((resolve, reject) => {
-    let abortError = () => {
-      reject(new AbortError());
-    }, abortHandler = () => {
-      clearTimeout(timeoutId), abortError();
-    };
-    if (signal?.aborted)
-      return abortError();
-    let timeoutId = setTimeout(() => {
-      signal?.removeEventListener("abort", abortHandler), resolve();
-    }, ms);
-    signal?.addEventListener("abort", abortHandler, { once: !0 });
-  });
-}
-
-// ../../../node_modules/es-toolkit/dist/function/retry.mjs
-var DEFAULT_DELAY = 0, DEFAULT_RETRIES = Number.POSITIVE_INFINITY;
-async function retry(func, _options) {
-  let delay$1, retries, signal;
-  typeof _options == "number" ? (delay$1 = DEFAULT_DELAY, retries = _options, signal = void 0) : (delay$1 = _options?.delay ?? DEFAULT_DELAY, retries = _options?.retries ?? DEFAULT_RETRIES, signal = _options?.signal);
-  let error;
-  for (let attempts = 0; attempts < retries; attempts++) {
-    if (signal?.aborted)
-      throw error ?? new Error("The retry operation was aborted due to an abort signal.");
-    try {
-      return await func();
-    } catch (err) {
-      error = err;
-      let currentDelay = typeof delay$1 == "function" ? delay$1(attempts) : delay$1;
-      await delay(currentDelay);
-    }
-  }
-  throw error;
-}
-
-// ../../../node_modules/es-toolkit/dist/function/ary.mjs
-function ary(func, n) {
-  return function(...args) {
-    return func.apply(this, args.slice(0, n));
-  };
-}
-
-// ../../../node_modules/es-toolkit/dist/function/unary.mjs
-function unary(func) {
-  return ary(func, 1);
-}
-
-// ../../../node_modules/es-toolkit/dist/function/negate.mjs
-function negate(func) {
-  return ((...args) => !func(...args));
-}
-
-// ../../../node_modules/es-toolkit/dist/function/flow.mjs
-function flow(...funcs) {
-  return function(...args) {
-    let result = funcs.length ? funcs[0].apply(this, args) : args[0];
-    for (let i = 1; i < funcs.length; i++)
-      result = funcs[i].call(this, result);
-    return result;
-  };
-}
-
-// ../../../node_modules/es-toolkit/dist/function/flowRight.mjs
-function flowRight(...funcs) {
-  return flow(...funcs.reverse());
-}
-
-// ../../../node_modules/es-toolkit/dist/function/rest.mjs
-function rest(func, startIndex = func.length - 1) {
-  return function(...args) {
-    let rest2 = args.slice(startIndex), params = args.slice(0, startIndex);
-    for (; params.length < startIndex; )
-      params.push(void 0);
-    return func.apply(this, [...params, rest2]);
-  };
-}
-
-// ../../../node_modules/es-toolkit/dist/function/after.mjs
-function after(n, func) {
-  if (!Number.isInteger(n) || n < 0)
-    throw new Error("n must be a non-negative integer.");
-  let counter = 0;
-  return (...args) => {
-    if (++counter >= n)
-      return func(...args);
-  };
-}
-
-export {
-  partialImpl,
-  partialRightImpl,
-  AbortError,
-  asyncNoop,
-  identity,
-  memoize,
-  noop,
-  once,
-  delay,
-  retry,
-  ary,
-  unary,
-  negate,
-  debounce,
-  flow,
-  flowRight,
-  rest,
-  after,
-  getControlId,
-  getControlSetterButtonId
-};