storybook 10.2.0-alpha.1 → 10.2.0-alpha.10

package/dist/core-server/presets/common-preset.js

@@ -1,61 +1,57 @@
-import CJS_COMPAT_NODE_URL_2297kyafub from 'node:url';
-import CJS_COMPAT_NODE_PATH_2297kyafub from 'node:path';
-import CJS_COMPAT_NODE_MODULE_2297kyafub from "node:module";
+import CJS_COMPAT_NODE_URL_1qalasm8z9n from 'node:url';
+import CJS_COMPAT_NODE_PATH_1qalasm8z9n from 'node:path';
+import CJS_COMPAT_NODE_MODULE_1qalasm8z9n from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_2297kyafub.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_2297kyafub.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_2297kyafub.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_1qalasm8z9n.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_1qalasm8z9n.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_1qalasm8z9n.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
 // ------------------------------------------------------------
-import "../../_node-chunks/chunk-JYMZJCZ7.js";
+import "../../_node-chunks/chunk-XBDIQU4P.js";
 import {
   parseStaticDir,
   sendTelemetryError,
   throttle
-} from "../../_node-chunks/chunk-GOOBGRAV.js";
-import "../../_node-chunks/chunk-LEDV47V2.js";
-import "../../_node-chunks/chunk-XEPVDCRL.js";
-import "../../_node-chunks/chunk-ZI2RAI3I.js";
-import {
-  getLastEvents,
-  getSessionId
-} from "../../_node-chunks/chunk-VR5LMO3F.js";
+} from "../../_node-chunks/chunk-JXL37VS7.js";
+import "../../_node-chunks/chunk-ZHSAQXJF.js";
+import "../../_node-chunks/chunk-TAETXAN6.js";
+import "../../_node-chunks/chunk-YCQRVBE4.js";
 import {
   globalSettings
-} from "../../_node-chunks/chunk-VFTNRF5X.js";
+} from "../../_node-chunks/chunk-QF3YWFYM.js";
 import {
   invariant
-} from "../../_node-chunks/chunk-4EZYJUAC.js";
+} from "../../_node-chunks/chunk-Q6PDB4Y6.js";
+import "../../_node-chunks/chunk-YELE6V4D.js";
 import {
   resolvePackageDir
-} from "../../_node-chunks/chunk-SR5ZYD7K.js";
-import "../../_node-chunks/chunk-TP6ICLTL.js";
+} from "../../_node-chunks/chunk-BP66TAYC.js";
 import {
   isAbsolute,
   join
-} from "../../_node-chunks/chunk-PGFQADZC.js";
+} from "../../_node-chunks/chunk-WULYWBBT.js";
 import {
   loadConfig
-} from "../../_node-chunks/chunk-77APSTTM.js";
+} from "../../_node-chunks/chunk-KP3IIE5P.js";
 import {
   require_dist
-} from "../../_node-chunks/chunk-AJUO2ZU3.js";
-import "../../_node-chunks/chunk-TX77W2KY.js";
-import "../../_node-chunks/chunk-KXDU466E.js";
+} from "../../_node-chunks/chunk-MLCI5FPI.js";
+import "../../_node-chunks/chunk-POAHHCVK.js";
+import "../../_node-chunks/chunk-EKU7ASGO.js";
 import {
   require_picocolors
-} from "../../_node-chunks/chunk-GYZQMMTN.js";
+} from "../../_node-chunks/chunk-Z2CJCEHN.js";
 import {
   __commonJS,
   __require,
   __toESM
-} from "../../_node-chunks/chunk-5NWCBUGD.js";
+} from "../../_node-chunks/chunk-LZ5NNY6S.js";
 
-// ../node_modules/shell-quote/quote.js
+// ../../node_modules/shell-quote/quote.js
 var require_quote = __commonJS({
-  "../node_modules/shell-quote/quote.js"(exports, module) {
+  "../../node_modules/shell-quote/quote.js"(exports, module) {
     "use strict";
     module.exports = function(xs) {
       return xs.map(function(s) {
@@ -65,9 +61,9 @@ var require_quote = __commonJS({
   }
 });
 
-// ../node_modules/shell-quote/parse.js
+// ../../node_modules/shell-quote/parse.js
 var require_parse = __commonJS({
-  "../node_modules/shell-quote/parse.js"(exports, module) {
+  "../../node_modules/shell-quote/parse.js"(exports, module) {
     "use strict";
     var CONTROL = "(?:" + [
       "\\|\\|",
@@ -165,18 +161,18 @@ var require_parse = __commonJS({
   }
 });
 
-// ../node_modules/shell-quote/index.js
+// ../../node_modules/shell-quote/index.js
 var require_shell_quote = __commonJS({
-  "../node_modules/shell-quote/index.js"(exports) {
+  "../../node_modules/shell-quote/index.js"(exports) {
     "use strict";
     exports.quote = require_quote();
     exports.parse = require_parse();
   }
 });
 
-// ../node_modules/launch-editor/editor-info/macos.js
+// ../../node_modules/launch-editor/editor-info/macos.js
 var require_macos = __commonJS({
-  "../node_modules/launch-editor/editor-info/macos.js"(exports, module) {
+  "../../node_modules/launch-editor/editor-info/macos.js"(exports, module) {
     module.exports = {
       "/Applications/Atom.app/Contents/MacOS/Atom": "atom",
       "/Applications/Atom Beta.app/Contents/MacOS/Atom Beta": "/Applications/Atom Beta.app/Contents/MacOS/Atom Beta",
@@ -208,9 +204,9 @@ var require_macos = __commonJS({
   }
 });
 
-// ../node_modules/launch-editor/editor-info/linux.js
+// ../../node_modules/launch-editor/editor-info/linux.js
 var require_linux = __commonJS({
-  "../node_modules/launch-editor/editor-info/linux.js"(exports, module) {
+  "../../node_modules/launch-editor/editor-info/linux.js"(exports, module) {
     module.exports = {
       atom: "atom",
       Brackets: "brackets",
@@ -243,9 +239,9 @@ var require_linux = __commonJS({
   }
 });
 
-// ../node_modules/launch-editor/editor-info/windows.js
+// ../../node_modules/launch-editor/editor-info/windows.js
 var require_windows = __commonJS({
-  "../node_modules/launch-editor/editor-info/windows.js"(exports, module) {
+  "../../node_modules/launch-editor/editor-info/windows.js"(exports, module) {
     module.exports = [
       "Brackets.exe",
       "Code.exe",
@@ -276,9 +272,9 @@ var require_windows = __commonJS({
   }
 });
 
-// ../node_modules/launch-editor/guess.js
+// ../../node_modules/launch-editor/guess.js
 var require_guess = __commonJS({
-  "../node_modules/launch-editor/guess.js"(exports, module) {
+  "../../node_modules/launch-editor/guess.js"(exports, module) {
     var path = __require("path"), shellQuote = require_shell_quote(), childProcess = __require("child_process"), COMMON_EDITORS_MACOS = require_macos(), COMMON_EDITORS_LINUX = require_linux(), COMMON_EDITORS_WIN = require_windows();
     module.exports = function(specifiedEditor) {
       if (specifiedEditor)
@@ -336,9 +332,9 @@ var require_guess = __commonJS({
   }
 });
 
-// ../node_modules/launch-editor/get-args.js
+// ../../node_modules/launch-editor/get-args.js
 var require_get_args = __commonJS({
-  "../node_modules/launch-editor/get-args.js"(exports, module) {
+  "../../node_modules/launch-editor/get-args.js"(exports, module) {
     var path = __require("path");
     module.exports = function(editor, fileName, lineNumber, columnNumber = 1) {
       switch (path.basename(editor).replace(/\.(exe|cmd|bat)$/i, "")) {
@@ -401,9 +397,9 @@ var require_get_args = __commonJS({
   }
 });
 
-// ../node_modules/launch-editor/index.js
+// ../../node_modules/launch-editor/index.js
 var require_launch_editor = __commonJS({
-  "../node_modules/launch-editor/index.js"(exports, module) {
+  "../../node_modules/launch-editor/index.js"(exports, module) {
     var fs = __require("fs"), os = __require("os"), path = __require("path"), colors = require_picocolors(), childProcess = __require("child_process"), guessEditor = require_guess(), getArgumentsForPosition = require_get_args();
     function wrapErrorCallback(cb) {
       return (fileName, errorMessage) => {
@@ -477,7 +473,7 @@ var require_launch_editor = __commonJS({
 // src/core-server/presets/common-preset.ts
 import { existsSync as existsSync3 } from "node:fs";
 import { readFile as readFile3 } from "node:fs/promises";
-import { optionalEnvToBoolean } from "storybook/internal/common";
+import { normalizeStories, optionalEnvToBoolean } from "storybook/internal/common";
 import {
   JsPackageManagerFactory,
   getDirectoryFromWorkingDir,
@@ -486,6 +482,7 @@ import {
   loadEnvs,
   removeAddon as removeAddonBase
 } from "storybook/internal/common";
+import { StoryIndexGenerator } from "storybook/internal/core-server";
 import { readCsf as readCsf2 } from "storybook/internal/csf-tools";
 import { logger as logger4 } from "storybook/internal/node-logger";
 import { telemetry as telemetry8 } from "storybook/internal/telemetry";
@@ -518,7 +515,7 @@ import { isCsfFactoryPreview } from "storybook/internal/csf-tools";
 var import_ts_dedent = __toESM(require_dist(), 1);
 
 // src/core-server/utils/get-component-variable-name.ts
-var getComponentVariableName = async (name) => (await import("../../_node-chunks/camelcase-64II7H4U.js")).default(name.replace(/^[^a-zA-Z_$]*/, ""), { pascalCase: !0 }).replace(/[^a-zA-Z_$]+/, "");
+var getComponentVariableName = async (name) => (await import("../../_node-chunks/camelcase-P3NIWBZX.js")).default(name.replace(/^[^a-zA-Z_$]*/, ""), { pascalCase: !0 }).replace(/[^a-zA-Z_$]+/, "");
 
 // src/core-server/utils/new-story-templates/csf-factory-template.ts
 async function getCsfFactoryTemplateForNewStoryFile(data) {
@@ -783,7 +780,7 @@ async function searchFiles({
   ignoredFiles = IGNORED_FILES,
   fileExtensions = FILE_EXTENSIONS
 }) {
-  let { globby, isDynamicPattern } = await import("../../_node-chunks/globby-5XJTXKUJ.js"), hasSearchSpecialGlobChars = isDynamicPattern(searchQuery, { cwd }), searchQueryHasExtension = /(\.[a-z]+)$/i.test(searchQuery), fileExtensionsPattern = `{${fileExtensions.join(",")}}`, globbedSearchQuery = hasSearchSpecialGlobChars ? searchQuery : searchQueryHasExtension ? [`**/*${searchQuery}*`, `**/*${searchQuery}*/**`] : [
+  let { globby, isDynamicPattern } = await import("../../_node-chunks/globby-322GM5CY.js"), hasSearchSpecialGlobChars = isDynamicPattern(searchQuery, { cwd }), searchQueryHasExtension = /(\.[a-z]+)$/i.test(searchQuery), fileExtensionsPattern = `{${fileExtensions.join(",")}}`, globbedSearchQuery = hasSearchSpecialGlobChars ? searchQuery : searchQueryHasExtension ? [`**/*${searchQuery}*`, `**/*${searchQuery}*/**`] : [
     `**/*${searchQuery}*.${fileExtensionsPattern}`,
     `**/*${searchQuery}*/**/*.${fileExtensionsPattern}`
   ];
@@ -893,6 +890,8 @@ async function initOpenInEditorChannel(channel, _options, coreOptions) {
 // src/core-server/server-channel/preview-initialized-channel.ts
 import { PREVIEW_INITIALIZED } from "storybook/internal/core-events";
 import { telemetry as telemetry4 } from "storybook/internal/telemetry";
+import { getLastEvents } from "storybook/internal/telemetry";
+import { getSessionId } from "storybook/internal/telemetry";
 var makePayload = (userAgent, lastInit, sessionId) => {
   let payload = {
     userAgent,
@@ -921,71 +920,17 @@ import { experimental_UniversalStore } from "storybook/internal/core-server";
 import { logger } from "storybook/internal/node-logger";
 import { telemetry as telemetry5 } from "storybook/internal/telemetry";
 
-// ../node_modules/dequal/dist/index.mjs
-var has = Object.prototype.hasOwnProperty;
-function find(iter, tar, key) {
-  for (key of iter.keys())
-    if (dequal(key, tar)) return key;
-}
-function dequal(foo, bar) {
-  var ctor, len, tmp;
-  if (foo === bar) return !0;
-  if (foo && bar && (ctor = foo.constructor) === bar.constructor) {
-    if (ctor === Date) return foo.getTime() === bar.getTime();
-    if (ctor === RegExp) return foo.toString() === bar.toString();
-    if (ctor === Array) {
-      if ((len = foo.length) === bar.length)
-        for (; len-- && dequal(foo[len], bar[len]); ) ;
-      return len === -1;
-    }
-    if (ctor === Set) {
-      if (foo.size !== bar.size)
-        return !1;
-      for (len of foo)
-        if (tmp = len, tmp && typeof tmp == "object" && (tmp = find(bar, tmp), !tmp) || !bar.has(tmp)) return !1;
-      return !0;
-    }
-    if (ctor === Map) {
-      if (foo.size !== bar.size)
-        return !1;
-      for (len of foo)
-        if (tmp = len[0], tmp && typeof tmp == "object" && (tmp = find(bar, tmp), !tmp) || !dequal(len[1], bar.get(tmp)))
-          return !1;
-      return !0;
-    }
-    if (ctor === ArrayBuffer)
-      foo = new Uint8Array(foo), bar = new Uint8Array(bar);
-    else if (ctor === DataView) {
-      if ((len = foo.byteLength) === bar.byteLength)
-        for (; len-- && foo.getInt8(len) === bar.getInt8(len); ) ;
-      return len === -1;
-    }
-    if (ArrayBuffer.isView(foo)) {
-      if ((len = foo.byteLength) === bar.byteLength)
-        for (; len-- && foo[len] === bar[len]; ) ;
-      return len === -1;
-    }
-    if (!ctor || typeof foo == "object") {
-      len = 0;
-      for (ctor in foo)
-        if (has.call(foo, ctor) && ++len && !has.call(bar, ctor) || !(ctor in bar) || !dequal(foo[ctor], bar[ctor])) return !1;
-      return Object.keys(bar).length === len;
-    }
-  }
-  return foo !== foo && bar !== bar;
-}
-
-// ../node_modules/es-toolkit/dist/predicate/isPrimitive.mjs
+// ../../node_modules/es-toolkit/dist/predicate/isPrimitive.mjs
 function isPrimitive(value) {
   return value == null || typeof value != "object" && typeof value != "function";
 }
 
-// ../node_modules/es-toolkit/dist/predicate/isTypedArray.mjs
+// ../../node_modules/es-toolkit/dist/predicate/isTypedArray.mjs
 function isTypedArray(x) {
   return ArrayBuffer.isView(x) && !(x instanceof DataView);
 }
 
-// ../node_modules/es-toolkit/dist/object/clone.mjs
+// ../../node_modules/es-toolkit/dist/object/clone.mjs
 function clone(obj) {
   if (isPrimitive(obj))
     return obj;
@@ -1013,7 +958,7 @@ function clone(obj) {
   return obj;
 }
 
-// ../node_modules/es-toolkit/dist/predicate/isPlainObject.mjs
+// ../../node_modules/es-toolkit/dist/predicate/isPlainObject.mjs
 function isPlainObject(value) {
   if (!value || typeof value != "object")
     return !1;
@@ -1021,12 +966,12 @@ function isPlainObject(value) {
   return proto === null || proto === Object.prototype || Object.getPrototypeOf(proto) === null ? Object.prototype.toString.call(value) === "[object Object]" : !1;
 }
 
-// ../node_modules/es-toolkit/dist/_internal/isUnsafeProperty.mjs
+// ../../node_modules/es-toolkit/dist/_internal/isUnsafeProperty.mjs
 function isUnsafeProperty(key) {
   return key === "__proto__";
 }
 
-// ../node_modules/es-toolkit/dist/object/mergeWith.mjs
+// ../../node_modules/es-toolkit/dist/object/mergeWith.mjs
 function mergeWith(target, source, merge2) {
   let sourceKeys = Object.keys(source);
   for (let i = 0; i < sourceKeys.length; i++) {
@@ -1039,10 +984,10 @@ function mergeWith(target, source, merge2) {
   return target;
 }
 
-// ../node_modules/es-toolkit/dist/string/words.mjs
+// ../../node_modules/es-toolkit/dist/string/words.mjs
 var CASE_SPLIT_PATTERN = new RegExp("\\p{Lu}?\\p{Ll}+|[0-9]+|\\p{Lu}+(?!\\p{Ll})|\\p{Emoji_Presentation}|\\p{Extended_Pictographic}|\\p{L}+", "gu");
 
-// ../node_modules/es-toolkit/dist/object/toMerged.mjs
+// ../../node_modules/es-toolkit/dist/object/toMerged.mjs
 function toMerged(target, source) {
   return mergeWith(clone(target), source, function mergeRecursively(targetValue, sourceValue) {
     if (Array.isArray(sourceValue))
@@ -1117,19 +1062,27 @@ async function initializeChecklist() {
         loaded: !0
       })
     ), store.onStateChange((state, previousState) => {
-      let projectValues = {}, userValues = {};
-      Object.entries(state.items).forEach(([id, { status, mutedAt }]) => {
+      let entries = Object.entries(state.items), projectValues = {}, userValues = {};
+      entries.forEach(([id, { status, mutedAt }]) => {
         status === "done" ? projectValues[id] = { status } : (status === "accepted" || status === "skipped") && (userValues[id] = { status }), mutedAt && (userValues[id] = {
           ...userValues[id],
           mutedAt
         });
       }), saveProjectState({ items: projectValues }), saveUserState({ items: userValues, widget: state.widget });
-      let changedValues = Object.entries(state.items).filter(
-        ([key, value]) => value !== previousState.items[key]
+      let { mutedItems, statusItems } = entries.reduce(
+        (acc, [item, { mutedAt, status }]) => {
+          let prev = previousState.items[item];
+          return mutedAt !== prev?.mutedAt && acc.mutedItems.push(item), status !== prev?.status && acc.statusItems.push(item), acc;
+        },
+        { mutedItems: [], statusItems: [] }
       );
-      telemetry5("onboarding-checklist", {
-        ...changedValues.length > 0 ? { items: Object.fromEntries(changedValues) } : {},
-        ...dequal(state.widget, previousState.widget) ? {} : { widget: state.widget }
+      mutedItems.length > 0 && telemetry5("onboarding-checklist-muted", {
+        items: mutedItems,
+        completedItems: entries.reduce((acc, [id, { status }]) => status === "done" || status === "accepted" ? acc.concat([id]) : acc, []),
+        skippedItems: entries.reduce((acc, [id, { status }]) => status === "skipped" ? acc.concat([id]) : acc, [])
+      }), statusItems.forEach((item) => {
+        let { status } = state.items[item];
+        telemetry5("onboarding-checklist-status", { item, status });
       });
     });
   } catch (err) {
@@ -1478,7 +1431,7 @@ var interpolate = (string, data = {}) => Object.entries(data).reduce((acc, [k, v
     ...babelDefault,
     // This override makes sure that we will never transpile babel further down then the browsers that storybook supports.
     // This is needed to support the mount property of the context described here:
-    // https://storybook.js.org/docs/writing-tests/interaction-testing#run-code-before-each-test
+    // https://storybook.js.org/docs/writing-tests/interaction-testing#run-code-before-each-story-in-a-file
     overrides: [
       ...babelDefault?.overrides ?? [],
       {
@@ -1571,7 +1524,21 @@ var interpolate = (string, data = {}) => Object.entries(data).reduce((acc, [k, v
 }, managerEntries = async (existing) => [
   join(resolvePackageDir("storybook"), "dist/core-server/presets/common-manager.js"),
   ...existing || []
-];
+], storyIndexGeneratorPromise, storyIndexGenerator = async (_, options) => storyIndexGeneratorPromise || (storyIndexGeneratorPromise = (async () => {
+  let workingDir = process.cwd(), configDir = options.configDir, stories = await options.presets.apply("stories"), normalizedStories = normalizeStories(stories, {
+    configDir,
+    workingDir
+  }), [indexers, docs] = await Promise.all([
+    options.presets.apply("experimental_indexers", []),
+    options.presets.apply("docs")
+  ]), generator = new StoryIndexGenerator(normalizedStories, {
+    workingDir,
+    configDir,
+    indexers,
+    docs
+  });
+  return await generator.initialize(), generator;
+})(), storyIndexGeneratorPromise);
 export {
   babel,
   core,
@@ -1590,6 +1557,7 @@ export {
   previewHead,
   resolvedReact,
   staticDirs,
+  storyIndexGenerator,
   title,
   typescript
 };

package/dist/csf/index.d.ts

@@ -310,7 +310,13 @@ interface ActionsParameters {
          * @example `argTypesRegex: '^on.*'`
          */
         argTypesRegex?: string;
-        /** Remove the addon panel and disable the addon's behavior */
+        /**
+         * Removes the addon panel and turns off the feature's behavior. If you wish to turn off this
+         * feature for the entire Storybook, you can set the option in your `main.js|ts` configuration
+         * file.
+         *
+         * @see https://storybook.js.org/docs/essentials/actions#disable
+         */
         disable?: boolean;
         /**
          * Binds a standard HTML event handler to the outermost HTML element rendered by your component
@@ -320,8 +326,6 @@ interface ActionsParameters {
          * **To enable this feature, you must use the `withActions` decorator.**
          *
          * @example `handles: ['mouseover', 'click .btn']`
-         *
-         * @see https://storybook.js.org/docs/essentials/actions#action-event-handlers
          */
         handles?: string[];
     };
@@ -357,7 +361,12 @@ interface BackgroundsParameters {
     backgrounds?: {
         /** Default background color */
         default?: string;
-        /** Remove the addon panel and disable the addon's behavior */
+        /**
+         * Removes the tool and disables the feature's behavior. If you wish to turn off this feature
+         * for the entire Storybook, you can set the option in your `main.js|ts` configuration file.
+         *
+         * @see https://storybook.js.org/docs/essentials/backgrounds#disable
+         */
         disable?: boolean;
         /** Configuration for the background grid */
         grid?: GridConfig;
@@ -385,7 +394,13 @@ interface ControlsParameters {
      * @see https://storybook.js.org/docs/essentials/controls#parameters-1
      */
     controls?: {
-        /** Remove the addon panel and disable the addon's behavior */
+        /**
+         * Removes the addon panel and turns off the feature's behavior. If you wish to turn off this
+         * feature for the entire Storybook, you can set the option in your `main.js|ts` configuration
+         * file.
+         *
+         * @see https://storybook.js.org/docs/essentials/controls#disable
+         */
         disable?: boolean;
         /** Disable the ability to create or edit stories from the Controls panel */
         disableSaveFromUI?: boolean;
@@ -435,7 +450,12 @@ interface HighlightParameters {
      * @see https://storybook.js.org/docs/essentials/highlight#parameters
      */
     highlight?: {
-        /** Remove the addon panel and disable the addon's behavior */
+        /**
+         * Removes the tool and disables the feature's behavior. If you wish to turn off this feature
+         * for the entire Storybook, you can set the option in your `main.js|ts` configuration file.
+         *
+         * @see https://storybook.js.org/docs/essentials/highlight#disable
+         */
         disable?: boolean;
     };
 }
@@ -447,7 +467,12 @@ interface MeasureParameters {
      * @see https://storybook.js.org/docs/essentials/measure-and-outline#parameters
      */
     measure?: {
-        /** Remove the addon panel and disable the addon's behavior */
+        /**
+         * Removes the tool and disables the feature's behavior. If you wish to turn off this feature
+         * for the entire Storybook, you can set the option in your `main.js|ts` configuration file.
+         *
+         * @see https://storybook.js.org/docs/essentials/measure-and-outline#disable
+         */
         disable?: boolean;
     };
 }
@@ -462,7 +487,12 @@ interface OutlineParameters {
      * @see https://storybook.js.org/docs/essentials/measure-and-outline#parameters
      */
     outline?: {
-        /** Remove the addon panel and disable the addon's behavior */
+        /**
+         * Removes the tool and disables the feature's behavior. If you wish to turn off this feature
+         * for the entire Storybook, you can set the option in your `main.js|ts` configuration file.
+         *
+         * @see https://storybook.js.org/docs/essentials/measure-and-outline#disable
+         */
         disable?: boolean;
     };
 }
@@ -511,10 +541,10 @@ interface ViewportParameters {
      */
     viewport?: {
         /**
-         * Remove the addon panel and disable the addon's behavior . If you wish to turn off this addon
-         * for the entire Storybook, you should do so when registering addon-essentials
+         * Removes the tool and disables the feature's behavior. If you wish to turn off this feature
+         * for the entire Storybook, you can set the option in your `main.js|ts` configuration file.
          *
-         * @see https://storybook.js.org/docs/essentials/index#disabling-addons
+         * @see https://storybook.js.org/docs/essentials/viewport#disable
          */
         disable?: boolean;
         /**

package/dist/csf/index.js

@@ -10,24 +10,24 @@ import {
   mountDestructured,
   normalizeArrays,
   normalizeProjectAnnotations
-} from "../_browser-chunks/chunk-SS2NHR7W.js";
-import "../_browser-chunks/chunk-IPA5A322.js";
-import "../_browser-chunks/chunk-3OXGAGBE.js";
+} from "../_browser-chunks/chunk-RBABWY22.js";
+import "../_browser-chunks/chunk-MEXTPDJG.js";
+import "../_browser-chunks/chunk-XLJZ7AOP.js";
 import {
   combineParameters
-} from "../_browser-chunks/chunk-VYJQ7RU5.js";
-import "../_browser-chunks/chunk-3IAH5M2U.js";
-import "../_browser-chunks/chunk-QKODTO7K.js";
+} from "../_browser-chunks/chunk-G4M6MXF4.js";
+import "../_browser-chunks/chunk-IYCKG66Y.js";
+import "../_browser-chunks/chunk-NZMVUW5T.js";
 import {
   invariant
-} from "../_browser-chunks/chunk-AS2HQEYC.js";
-import "../_browser-chunks/chunk-YKE5S47A.js";
-import "../_browser-chunks/chunk-AIOS4NGK.js";
-import "../_browser-chunks/chunk-GFLS4VP3.js";
-import "../_browser-chunks/chunk-WJYERY3R.js";
+} from "../_browser-chunks/chunk-IWQGIXJS.js";
+import "../_browser-chunks/chunk-V2VKKSMQ.js";
+import "../_browser-chunks/chunk-SWJP5COI.js";
+import "../_browser-chunks/chunk-LCHBOIHN.js";
+import "../_browser-chunks/chunk-ZCFV7BZB.js";
 import {
   dedent
-} from "../_browser-chunks/chunk-JP7NCOJX.js";
+} from "../_browser-chunks/chunk-3LY4VQVK.js";
 import {
   HIGHLIGHT,
   MAX_Z_INDEX,
@@ -50,9 +50,9 @@ import {
   __toESM
 } from "../_browser-chunks/chunk-A242L54C.js";
 
-// ../node_modules/@ngard/tiny-isequal/index.js
+// ../../node_modules/@ngard/tiny-isequal/index.js
 var require_tiny_isequal = __commonJS({
-  "../node_modules/@ngard/tiny-isequal/index.js"(exports) {
+  "../../node_modules/@ngard/tiny-isequal/index.js"(exports) {
     Object.defineProperty(exports, "__esModule", { value: !0 }), exports.isEqual = /* @__PURE__ */ (function() {
       var e = Object.prototype.toString, r = Object.getPrototypeOf, t = Object.getOwnPropertySymbols ? function(e2) {
         return Object.keys(e2).concat(Object.getOwnPropertySymbols(e2));
@@ -1748,29 +1748,32 @@ var resetAllMocksLoader = ({ parameters: parameters2 }) => {
   traverseArgs(initialArgs);
 }, patchedFocus = !1, enhanceContext = async (context) => {
   globalThis.HTMLElement && context.canvasElement instanceof globalThis.HTMLElement && (context.canvas = within(context.canvasElement));
-  let clipboard = globalThis.window?.navigator?.clipboard;
-  if (clipboard && (context.userEvent = instrument2(
-    { userEvent: uninstrumentedUserEvent.setup() },
-    {
-      intercept: !0,
-      getKeys: (obj) => Object.keys(obj).filter((key) => key !== "eventWrapper")
-    }
-  ).userEvent, Object.defineProperty(globalThis.window.navigator, "clipboard", {
-    get: () => clipboard,
-    configurable: !0
-  }), !patchedFocus)) {
-    let originalFocus = HTMLElement.prototype.focus, currentFocus = HTMLElement.prototype.focus, focusingElements = /* @__PURE__ */ new Set();
-    Object.defineProperties(HTMLElement.prototype, {
-      focus: {
-        configurable: !0,
-        set: (newFocus) => {
-          currentFocus = newFocus;
-        },
-        get() {
-          return focusingElements.has(this) ? originalFocus : (focusingElements.add(this), setTimeout(() => focusingElements.delete(this), 0), currentFocus);
-        }
+  try {
+    let clipboard = globalThis.window?.navigator?.clipboard;
+    if (clipboard && (context.userEvent = instrument2(
+      { userEvent: uninstrumentedUserEvent.setup() },
+      {
+        intercept: !0,
+        getKeys: (obj) => Object.keys(obj).filter((key) => key !== "eventWrapper")
       }
-    }), patchedFocus = !0;
+    ).userEvent, Object.defineProperty(globalThis.window.navigator, "clipboard", {
+      get: () => clipboard,
+      configurable: !0
+    }), !patchedFocus)) {
+      let originalFocus = HTMLElement.prototype.focus, currentFocus = HTMLElement.prototype.focus, focusingElements = /* @__PURE__ */ new Set();
+      Object.defineProperties(HTMLElement.prototype, {
+        focus: {
+          configurable: !0,
+          set: (newFocus) => {
+            currentFocus = newFocus;
+          },
+          get() {
+            return focusingElements.has(this) ? originalFocus : (focusingElements.add(this), setTimeout(() => focusingElements.delete(this), 0), currentFocus);
+          }
+        }
+      }), patchedFocus = !0;
+    }
+  } catch {
   }
 }, preview_default7 = () => definePreviewAddon7({
   loaders: [resetAllMocksLoader, nameSpiesAndWrapActionsInSpies, enhanceContext]
@@ -1874,9 +1877,13 @@ function defineStory(input, meta) {
       await compose().run(context);
     },
     test(name, overridesOrTestFn, testFn) {
-      let annotations = typeof overridesOrTestFn != "function" ? overridesOrTestFn : {}, testFunction = typeof overridesOrTestFn != "function" ? testFn : overridesOrTestFn, play = mountDestructured(this.play) || mountDestructured(testFunction) ? async ({ context }) => {
-        await this.play?.(context), await testFunction(context);
-      } : async (context) => {
+      let annotations = typeof overridesOrTestFn != "function" ? overridesOrTestFn : {}, testFunction = typeof overridesOrTestFn != "function" ? testFn : overridesOrTestFn, play = mountDestructured(this.play) || mountDestructured(testFunction) ? (
+        // mount needs to be explicitly destructured
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        async ({ mount, context }) => {
+          await this.play?.(context), await testFunction(context);
+        }
+      ) : async (context) => {
         await this.play?.(context), await testFunction(context);
       }, test = this.extend({
         ...annotations,