storybook 10.2.0-alpha.11 → 10.2.0-alpha.12

package/dist/manager-api/index.d.ts

@@ -5,8 +5,8 @@ import { RouterData, NavigateOptions } from 'storybook/internal/router';
 import { Addon_Types, Addon_TypesEnum, Addon_Collection, Addon_TypesMapping, Addon_BaseType, Addon_TestProviderType, Addon_PageType, Addon_WrapperType, Addon_Config, API_ProviderData, API_StateMerger, API_Provider, Globals, GlobalTypes, API_PanelPositions, API_Layout, API_LayoutCustomisations, API_UI, API_Notification, API_IframeRenderer, API_ComposedRef, API_SetRefData, API_ComposedRefUpdate, API_Refs, StoryId, API_Settings, API_HashEntry, API_ViewMode, API_LeafEntry, API_PreparedStoryIndex, API_StoryEntry, API_TestEntry, Args, API_IndexHash, API_DocsEntry, API_FilterFunction, API_LoadedRefData, API_Version, API_Versions, API_UnknownEntries, API_OptionsData, Parameters, ArgTypes, NormalizedProjectAnnotations, ProjectAnnotations, ComposedStoryFn } from 'storybook/internal/types';
 export { Addon_Type as Addon, API_ComponentEntry as ComponentEntry, API_ComposedRef as ComposedRef, API_DocsEntry as DocsEntry, API_GroupEntry as GroupEntry, API_HashEntry as HashEntry, API_IndexHash as IndexHash, API_LeafEntry as LeafEntry, API_Refs as Refs, API_RootEntry as RootEntry, API_IndexHash as StoriesHash, API_StoryEntry as StoryEntry } from 'storybook/internal/types';
 import { ThemeVars } from 'storybook/theming';
+import { OpenInEditorResponsePayload, WhatsNewData } from 'storybook/internal/core-events';
 import { toId, StoryId as StoryId$1 } from 'storybook/internal/csf';
-import { WhatsNewData } from 'storybook/internal/core-events';
 
 declare function mockChannel(): Channel;
 
@@ -81,7 +81,7 @@ type ModuleArgs = RouterData & API_ProviderData<API> & {
     store: Store;
 };
 
-interface SubAPI$c {
+interface SubAPI$d {
     /**
      * Returns a collection of elements of a specific type.
      *
@@ -128,7 +128,7 @@ interface SubAPI$c {
     getAddonState<S>(addonId: string): S;
 }
 
-interface SubAPI$b {
+interface SubAPI$c {
     /**
      * Returns the channel object.
      *
@@ -177,7 +177,7 @@ interface SubState$9 {
     storyGlobals?: Globals;
     globalTypes?: GlobalTypes;
 }
-interface SubAPI$a {
+interface SubAPI$b {
     /**
      * Returns the current globals, which is the user globals overlaid with the story globals
      *
@@ -216,7 +216,7 @@ interface SubState$8 {
     selectedPanel: string | undefined;
     theme: ThemeVars;
 }
-interface SubAPI$9 {
+interface SubAPI$a {
     /**
      * Toggles the fullscreen mode of the Storybook UI.
      *
@@ -287,7 +287,7 @@ interface SubState$7 {
     notifications: API_Notification[];
 }
 /** The API for managing notifications. */
-interface SubAPI$8 {
+interface SubAPI$9 {
     /**
      * Adds a new notification to the list of notifications. If a notification with the same ID
      * already exists, it will be replaced.
@@ -303,6 +303,19 @@ interface SubAPI$8 {
     clearNotification: (id: string) => void;
 }
 
+/** The API for opening files in the editor. */
+interface SubAPI$8 {
+    /**
+     * Opens the file in the editor. You can optionally provide a line and column number to open at a
+     * more specific location.
+     */
+    openInEditor: (payload: {
+        file: string;
+        line?: number;
+        column?: number;
+    }) => Promise<OpenInEditorResponsePayload>;
+}
+
 interface SubAPI$7 {
     renderPreview?: API_IframeRenderer;
 }
@@ -495,6 +508,7 @@ interface API_Shortcuts {
     expandAll: API_KeyCollection;
     remount: API_KeyCollection;
     openInEditor: API_KeyCollection;
+    openInIsolation: API_KeyCollection;
     copyStoryLink: API_KeyCollection;
 }
 type API_Action = keyof API_Shortcuts;
@@ -745,6 +759,33 @@ interface SubAPI$2 {
      * @returns {void}
      */
     navigateUrl: (url: string, options: NavigateOptions) => void;
+    /**
+     * Get the manager and preview hrefs for a story.
+     *
+     * @param {string} storyId - The ID of the story to get the URL for.
+     * @param {Object} options - Options for the URL.
+     * @param {string} [options.base] - Return an absolute href based on the current origin or network
+     *   address.
+     * @param {boolean} [options.inheritArgs] - Inherit args from the current URL. If storyId matches
+     *   current story, inheritArgs defaults to true.
+     * @param {boolean} [options.inheritGlobals] - Inherit globals from the current URL. Defaults to
+     *   true.
+     * @param {QueryParams} [options.queryParams] - Query params to add to the URL.
+     * @param {string} [options.refId] - ID of the ref to get the URL for (for composed Storybooks)
+     * @param {string} [options.viewMode] - The view mode to use, defaults to 'story'.
+     * @returns {Object} Manager and preview hrefs for the story.
+     */
+    getStoryHrefs(storyId: string, options?: {
+        base?: 'origin' | 'network';
+        inheritArgs?: boolean;
+        inheritGlobals?: boolean;
+        queryParams?: QueryParams;
+        refId?: string;
+        viewMode?: API_ViewMode;
+    }): {
+        managerHref: string;
+        previewHref: string;
+    };
     /**
      * Get the value of a query parameter from the current URL.
      *
@@ -864,7 +905,7 @@ declare const ManagerContext: React.Context<{
     state: State;
 }>;
 type State = SubState$8 & SubState$3 & SubState$6 & SubState$7 & SubState$1 & SubState$2 & SubState$4 & SubState$5 & SubState$9 & SubState & RouterData & API_OptionsData & Other;
-type API = SubAPI$c & SubAPI$b & SubAPI$7 & SubAPI$3 & SubAPI$6 & SubAPI$a & SubAPI$9 & SubAPI$8 & SubAPI$4 & SubAPI$5 & SubAPI$1 & SubAPI$2 & SubAPI & Other;
+type API = SubAPI$d & SubAPI$c & SubAPI$7 & SubAPI$3 & SubAPI$6 & SubAPI$b & SubAPI$a & SubAPI$9 & SubAPI$4 & SubAPI$5 & SubAPI$1 & SubAPI$2 & SubAPI & SubAPI$8 & Other;
 interface Other {
     [key: string]: any;
 }
@@ -1746,6 +1787,31 @@ declare global {
     function __pwUnwrapObject(storyRef: WrappedStoryRef): Promise<UnwrappedJSXStoryRef | UnwrappedImportStoryRef>;
 }
 
+/** System tags used throughout Storybook for categorizing and filtering stories and docs entries. */
+declare const Tag: {
+    /** Indicates that autodocs should be generated for this component */
+    readonly AUTODOCS: "autodocs";
+    /** MDX documentation attached to a component's stories file */
+    readonly ATTACHED_MDX: "attached-mdx";
+    /** Standalone MDX documentation not attached to stories */
+    readonly UNATTACHED_MDX: "unattached-mdx";
+    /** Story has a play function */
+    readonly PLAY_FN: "play-fn";
+    /** Story has a test function */
+    readonly TEST_FN: "test-fn";
+    /** Development environment tag */
+    readonly DEV: "dev";
+    /** Test environment tag */
+    readonly TEST: "test";
+    /** Manifest generation tag */
+    readonly MANIFEST: "manifest";
+};
+/**
+ * Tags can be any string, including custom user-defined tags. The Tag constant above defines the
+ * system tags used by Storybook.
+ */
+type Tag = string;
+
 type TestProviderState = 'test-provider-state:pending' | 'test-provider-state:running' | 'test-provider-state:succeeded' | 'test-provider-state:crashed';
 type TestProviderId = string;
 type TestProviderStateByProviderId = Record<TestProviderId, TestProviderState>;
@@ -3199,11 +3265,11 @@ declare const userSettingSchema: ZodObject<{
                 mutedAt?: number | undefined;
             }>>;
         }, "strip", ZodTypeAny, {
-            controls?: {
+            autodocs?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
-            autodocs?: {
+            controls?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
@@ -3288,11 +3354,11 @@ declare const userSettingSchema: ZodObject<{
                 mutedAt?: number | undefined;
             } | undefined;
         }, {
-            controls?: {
+            autodocs?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
-            autodocs?: {
+            controls?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
@@ -3386,11 +3452,11 @@ declare const userSettingSchema: ZodObject<{
         }>>;
     }, "strip", ZodTypeAny, {
         items?: {
-            controls?: {
+            autodocs?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
-            autodocs?: {
+            controls?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
@@ -3480,11 +3546,11 @@ declare const userSettingSchema: ZodObject<{
         } | undefined;
     }, {
         items?: {
-            controls?: {
+            autodocs?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
-            autodocs?: {
+            controls?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
@@ -3581,11 +3647,11 @@ declare const userSettingSchema: ZodObject<{
     userSince?: number | undefined;
     checklist?: {
         items?: {
-            controls?: {
+            autodocs?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
-            autodocs?: {
+            controls?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
@@ -3682,11 +3748,11 @@ declare const userSettingSchema: ZodObject<{
     userSince?: number | undefined;
     checklist?: {
         items?: {
-            controls?: {
+            autodocs?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
-            autodocs?: {
+            controls?: {
                 status?: "done" | "open" | "accepted" | "skipped" | undefined;
                 mutedAt?: number | undefined;
             } | undefined;
@@ -3837,4 +3903,4 @@ declare const checklistStore: {
     disable: (value: boolean) => void;
 };
 
-export { type API, type API_EventMap, type API_KeyCollection, ActiveTabs, AddonStore, type Combo, ManagerConsumer as Consumer, type KeyboardEventLike, ManagerContext, type ManagerProviderProps, ManagerProvider as Provider, RequestResponseError, type State, type Options as StoreOptions, addons, combineParameters, controlOrMetaKey, controlOrMetaSymbol, eventMatchesShortcut, eventToShortcut, MockUniversalStore as experimental_MockUniversalStore, UniversalStore as experimental_UniversalStore, getStatusStoreByTypeId as experimental_getStatusStore, getTestProviderStoreById as experimental_getTestProviderStore, experimental_requestResponse, useStatusStore as experimental_useStatusStore, useTestProviderStore as experimental_useTestProviderStore, useUniversalStore as experimental_useUniversalStore, checklistStore as internal_checklistStore, fullStatusStore as internal_fullStatusStore, fullTestProviderStore as internal_fullTestProviderStore, universalChecklistStore as internal_universalChecklistStore, universalStatusStore as internal_universalStatusStore, universalTestProviderStore as internal_universalTestProviderStore, isMacLike, isShortcutTaken, keyToSymbol, _default as merge, mockChannel, optionOrAltSymbol, shortcutMatchesShortcut, shortcutToAriaKeyshortcuts, shortcutToHumanString, typesX as types, useAddonState, useArgTypes, useArgs, useChannel, useGlobalTypes, useGlobals, useParameter, useSharedState, useStoryPrepared, useStorybookApi, useStorybookState };
+export { type API, type API_EventMap, type API_KeyCollection, ActiveTabs, AddonStore, type Combo, ManagerConsumer as Consumer, type KeyboardEventLike, ManagerContext, type ManagerProviderProps, ManagerProvider as Provider, RequestResponseError, type State, type Options as StoreOptions, Tag, addons, combineParameters, controlOrMetaKey, controlOrMetaSymbol, eventMatchesShortcut, eventToShortcut, MockUniversalStore as experimental_MockUniversalStore, UniversalStore as experimental_UniversalStore, getStatusStoreByTypeId as experimental_getStatusStore, getTestProviderStoreById as experimental_getTestProviderStore, experimental_requestResponse, useStatusStore as experimental_useStatusStore, useTestProviderStore as experimental_useTestProviderStore, useUniversalStore as experimental_useUniversalStore, checklistStore as internal_checklistStore, fullStatusStore as internal_fullStatusStore, fullTestProviderStore as internal_fullTestProviderStore, universalChecklistStore as internal_universalChecklistStore, universalStatusStore as internal_universalStatusStore, universalTestProviderStore as internal_universalTestProviderStore, isMacLike, isShortcutTaken, keyToSymbol, _default as merge, mockChannel, optionOrAltSymbol, shortcutMatchesShortcut, shortcutToAriaKeyshortcuts, shortcutToHumanString, typesX as types, useAddonState, useArgTypes, useArgs, useChannel, useGlobalTypes, useGlobals, useParameter, useSharedState, useStoryPrepared, useStorybookApi, useStorybookState };

package/dist/manager-api/index.js

@@ -17,6 +17,12 @@ import {
   dequal,
   partition
 } from "../_browser-chunks/chunk-NQJGOFZV.js";
+import {
+  Tag
+} from "../_browser-chunks/chunk-AFVOZMXQ.js";
+import {
+  require_main
+} from "../_browser-chunks/chunk-XLJZ7AOP.js";
 import {
   isEqual
 } from "../_browser-chunks/chunk-IYCKG66Y.js";
@@ -654,7 +660,7 @@ var TITLE_PATH_SEPARATOR = /\s*\/\s*/, denormalizeStoryParameters = ({
   entries: Object.values(index.entries).reduce(
     (acc, entry) => (acc[entry.id] = {
       ...entry,
-      tags: entry.tags ? ["dev", "test", ...entry.tags] : ["dev"]
+      tags: entry.tags ? [Tag.DEV, Tag.TEST, ...entry.tags] : [Tag.DEV]
     }, acc),
     {}
   )
@@ -1460,6 +1466,7 @@ var defaultShortcuts = Object.freeze({
   expandAll: [controlOrMetaKey2(), "shift", "ArrowDown"],
   remount: ["alt", "R"],
   openInEditor: ["alt", "shift", "E"],
+  openInIsolation: ["alt", "shift", "I"],
   copyStoryLink: ["alt", "shift", "L"]
   // TODO: bring this back once we want to add shortcuts for this
   // copyStoryName: ['alt', 'shift', 'C'],
@@ -1527,7 +1534,9 @@ var init10 = ({ store: store2, fullAPI, provider }) => {
     handleShortcutFeature(feature, event) {
       let {
         ui: { enableShortcuts },
-        storyId
+        storyId,
+        refId,
+        viewMode
       } = store2.getState();
       if (enableShortcuts)
         switch (event?.preventDefault && event.preventDefault(), feature) {
@@ -1620,6 +1629,13 @@ var init10 = ({ store: store2, fullAPI, provider }) => {
             });
             break;
           }
+          case "openInIsolation": {
+            if (storyId && viewMode === "story") {
+              let { previewHref } = fullAPI.getStoryHrefs(storyId, { refId });
+              window.open(previewHref, "_blank", "noopener,noreferrer");
+            }
+            break;
+          }
           // TODO: bring this back once we want to add shortcuts for this
           // case 'copyStoryName': {
           //   const storyData = fullAPI.getCurrentStoryData();
@@ -1629,7 +1645,10 @@ var init10 = ({ store: store2, fullAPI, provider }) => {
           //   break;
           // }
           case "copyStoryLink": {
-            (0, import_copy_to_clipboard.default)(window.location.href);
+            if (storyId) {
+              let { managerHref } = fullAPI.getStoryHrefs(storyId, { refId });
+              (0, import_copy_to_clipboard.default)(managerHref);
+            }
             break;
           }
           default:
@@ -2237,11 +2256,17 @@ import {
 } from "storybook/internal/core-events";
 import { buildArgsParam, queryFromLocation } from "storybook/internal/router";
 import { global as global7 } from "@storybook/global";
-var { window: globalWindow } = global7, parseBoolean = (value) => {
+var import_picoquery = __toESM(require_main(), 1);
+var parseBoolean = (value) => {
   if (value === "true" || value === "1")
     return !0;
   if (value === "false" || value === "0")
     return !1;
+}, parseSerializedParam = (param) => Object.fromEntries(
+  param.split(";").map((pair) => pair.split(":")).map(([key, value]) => [key, encodeURIComponent(value)]).filter(([key, value]) => key && value)
+), mergeSerializedParams = (params, extraParams) => {
+  let pairs = parseSerializedParam(params), extra = parseSerializedParam(extraParams);
+  return Object.entries({ ...pairs, ...extra }).map(([key, value]) => `${key}:${value}`).join(";");
 }, prevParams, initialUrlSupport = ({
   state: { location: location2, path, viewMode, storyId: storyIdFromUrl },
   singleStory
@@ -2273,6 +2298,26 @@ var { window: globalWindow } = global7, parseBoolean = (value) => {
     let params = Object.entries(queryParams).filter(([, v]) => v).sort(([a], [b]) => a < b ? -1 : 1).map(([k, v]) => `${k}=${v}`), to = [path, ...params].join("&");
     return navigate(to, options);
   }, api = {
+    getStoryHrefs(storyId, options = {}) {
+      let { id: currentStoryId, refId: currentRefId } = fullAPI.getCurrentStoryData() ?? {}, isCurrentStory = storyId === currentStoryId && options.refId === currentRefId, { customQueryParams, location: location2, refs } = store2.getState(), {
+        base,
+        inheritArgs = isCurrentStory,
+        inheritGlobals = !0,
+        queryParams = {},
+        refId,
+        viewMode = "story"
+      } = options;
+      if (refId && !refs[refId])
+        throw new Error(`Invalid refId: ${refId}`);
+      let originAddress = global7.window.location.origin + location2.pathname, networkAddress = global7.STORYBOOK_NETWORK_ADDRESS ?? originAddress, managerBase = base === "origin" ? originAddress : base === "network" ? networkAddress : location2.pathname, previewBase = refId ? refs[refId].url + "/iframe.html" : global7.PREVIEW_URL || `${managerBase}iframe.html`, refParam = refId ? `&refId=${encodeURIComponent(refId)}` : "", { args = "", globals = "", ...otherParams } = queryParams, argsParam = inheritArgs ? mergeSerializedParams(customQueryParams?.args ?? "", args) : args, globalsParam = inheritGlobals ? mergeSerializedParams(customQueryParams?.globals ?? "", globals) : globals, customParams = (0, import_picoquery.stringify)(otherParams, {
+        nesting: !0,
+        nestingSyntax: "js"
+      });
+      return argsParam = argsParam && `&args=${argsParam}`, globalsParam = globalsParam && `&globals=${globalsParam}`, customParams = customParams && `&${customParams}`, {
+        managerHref: `${managerBase}?path=/${viewMode}/${refId ? `${refId}_` : ""}${storyId}${argsParam}${globalsParam}${customParams}`,
+        previewHref: `${previewBase}?id=${storyId}&viewMode=${viewMode}${refParam}${argsParam}${refId ? "" : globalsParam}${customParams}`
+      };
+    },
     getQueryParam(key) {
       let { customQueryParams } = store2.getState();
       return customQueryParams ? customQueryParams[key] : void 0;
@@ -2315,7 +2360,7 @@ var { window: globalWindow } = global7, parseBoolean = (value) => {
   provider.channel?.on(SET_CURRENT_STORY2, () => updateArgsParam());
   let handleOrId;
   return provider.channel?.on(STORY_ARGS_UPDATED2, () => {
-    "requestIdleCallback" in globalWindow ? (handleOrId && globalWindow.cancelIdleCallback(handleOrId), handleOrId = globalWindow.requestIdleCallback(updateArgsParam, { timeout: 1e3 })) : (handleOrId && clearTimeout(handleOrId), setTimeout(updateArgsParam, 100));
+    "requestIdleCallback" in global7.window ? (handleOrId && global7.window.cancelIdleCallback(handleOrId), handleOrId = global7.window.requestIdleCallback(updateArgsParam, { timeout: 1e3 })) : (handleOrId && clearTimeout(handleOrId), setTimeout(updateArgsParam, 100));
   }), provider.channel?.on(GLOBALS_UPDATED2, ({ userGlobals, initialGlobals }) => {
     let { path, hash = "", queryParams } = api.getUrlState(), globalsString = buildArgsParam(initialGlobals, userGlobals);
     navigateTo(`${path}${hash}`, { ...queryParams, globals: globalsString }, { replace: !0 }), api.setQueryParams({ globals: globalsString });
@@ -2337,7 +2382,7 @@ import { global as global8 } from "@storybook/global";
 import semver from "semver";
 
 // src/manager-api/version.ts
-var version = "10.2.0-alpha.11";
+var version = "10.2.0-alpha.12";
 
 // src/manager-api/modules/versions.ts
 var { VERSIONCHECK } = global8, getVersionCheckData = (0, import_memoizerific2.default)(1)(() => {
@@ -2971,6 +3016,7 @@ export {
   ManagerContext,
   ManagerProvider as Provider,
   RequestResponseError,
+  Tag,
   addons,
   combineParameters,
   controlOrMetaKey,

package/dist/mocking-utils/index.js

@@ -1,10 +1,10 @@
-import CJS_COMPAT_NODE_URL_aucdos01fk5 from 'node:url';
-import CJS_COMPAT_NODE_PATH_aucdos01fk5 from 'node:path';
-import CJS_COMPAT_NODE_MODULE_aucdos01fk5 from "node:module";
+import CJS_COMPAT_NODE_URL_0j7q77gppets from 'node:url';
+import CJS_COMPAT_NODE_PATH_0j7q77gppets from 'node:path';
+import CJS_COMPAT_NODE_MODULE_0j7q77gppets from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_aucdos01fk5.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_aucdos01fk5.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_aucdos01fk5.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_0j7q77gppets.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_0j7q77gppets.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_0j7q77gppets.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
@@ -16,8 +16,8 @@ import {
   join,
   normalize,
   resolve
-} from "../_node-chunks/chunk-MAQAZSXK.js";
-import "../_node-chunks/chunk-FWVZUHZX.js";
+} from "../_node-chunks/chunk-SEUBEMNQ.js";
+import "../_node-chunks/chunk-WMWMEGTL.js";
 
 // ../../node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
 var comma = 44, semicolon = 59, chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", intToChar = new Uint8Array(64), charToInt = new Uint8Array(128);

package/dist/node-logger/index.js

@@ -1,10 +1,10 @@
-import CJS_COMPAT_NODE_URL_aucdos01fk5 from 'node:url';
-import CJS_COMPAT_NODE_PATH_aucdos01fk5 from 'node:path';
-import CJS_COMPAT_NODE_MODULE_aucdos01fk5 from "node:module";
+import CJS_COMPAT_NODE_URL_0j7q77gppets from 'node:url';
+import CJS_COMPAT_NODE_PATH_0j7q77gppets from 'node:path';
+import CJS_COMPAT_NODE_MODULE_0j7q77gppets from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_aucdos01fk5.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_aucdos01fk5.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_aucdos01fk5.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_0j7q77gppets.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_0j7q77gppets.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_0j7q77gppets.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
@@ -22,9 +22,9 @@ import {
   once,
   prompt,
   protectUrls
-} from "../_node-chunks/chunk-5L22ATN3.js";
-import "../_node-chunks/chunk-WQ4WQYSZ.js";
-import "../_node-chunks/chunk-FWVZUHZX.js";
+} from "../_node-chunks/chunk-EO2J5FE4.js";
+import "../_node-chunks/chunk-YPYOZM4G.js";
+import "../_node-chunks/chunk-WMWMEGTL.js";
 var export_instance = import_npmlog.default;
 export {
   CLI_COLORS,

package/dist/preview/runtime.js

@@ -16101,6 +16101,7 @@ __export(preview_api_exports, {
   PreviewWithSelection: () => PreviewWithSelection,
   ReporterAPI: () => ReporterAPI,
   StoryStore: () => StoryStore,
+  Tag: () => Tag,
   UrlStore: () => UrlStore,
   WebView: () => WebView,
   addons: () => addons,
@@ -16466,6 +16467,26 @@ function splitByComma(s3) {
   return lastToken && result.push(lastToken), result;
 }
 
+// src/shared/constants/tags.ts
+var Tag = {
+  /** Indicates that autodocs should be generated for this component */
+  AUTODOCS: "autodocs",
+  /** MDX documentation attached to a component's stories file */
+  ATTACHED_MDX: "attached-mdx",
+  /** Standalone MDX documentation not attached to stories */
+  UNATTACHED_MDX: "unattached-mdx",
+  /** Story has a play function */
+  PLAY_FN: "play-fn",
+  /** Story has a test function */
+  TEST_FN: "test-fn",
+  /** Development environment tag */
+  DEV: "dev",
+  /** Test environment tag */
+  TEST: "test",
+  /** Manifest generation tag */
+  MANIFEST: "manifest"
+};
+
 // src/actions/addArgs.ts
 var addArgs_exports = {};
 __export(addArgs_exports, {
@@ -34971,7 +34992,7 @@ function prepareMeta(componentAnnotations, projectAnnotations, moduleExport) {
   };
 }
 function preparePartialAnnotations(storyAnnotations, componentAnnotations, projectAnnotations) {
-  let defaultTags = ["dev", "test"], extraTags = scope.DOCS_OPTIONS?.autodocs === !0 ? ["autodocs"] : [], overrideTags = storyAnnotations?.tags?.includes("test-fn") ? ["!autodocs"] : [], tags = combineTags(
+  let defaultTags = [Tag.DEV, Tag.TEST], extraTags = scope.DOCS_OPTIONS?.autodocs === !0 ? [Tag.AUTODOCS] : [], overrideTags = storyAnnotations?.tags?.includes(Tag.TEST_FN) ? [`!${Tag.AUTODOCS}`] : [], tags = combineTags(
     ...defaultTags,
     ...extraTags,
     ...projectAnnotations.tags ?? [],
@@ -36560,9 +36581,8 @@ function focusInInput(event) {
   let target = event.composedPath && event.composedPath()[0] || event.target;
   return /input|textarea/i.test(target.tagName) || target.getAttribute("contenteditable") !== null;
 }
-var ATTACHED_MDX_TAG = "attached-mdx", UNATTACHED_MDX_TAG = "unattached-mdx";
 function isMdxEntry({ tags }) {
-  return tags?.includes(UNATTACHED_MDX_TAG) || tags?.includes(ATTACHED_MDX_TAG);
+  return tags?.includes(Tag.UNATTACHED_MDX) || tags?.includes(Tag.ATTACHED_MDX);
 }
 function isStoryRender(r) {
   return r.type === "story";
@@ -36740,7 +36760,7 @@ var PreviewWithSelection = class extends Preview {
         initialGlobals: initialGlobals5,
         storyGlobals: {},
         userGlobals: globals
-      }), isCsfDocsRender(render) || render.entry.tags?.includes(ATTACHED_MDX_TAG)) {
+      }), isCsfDocsRender(render) || render.entry.tags?.includes(Tag.ATTACHED_MDX)) {
         if (!render.csfFiles)
           throw new MdxFileWithNoCsfReferencesError({ storyId });
         ({ parameters: parameters2 } = this.storyStoreValue.preparedMetaFromCSFFile({

package/dist/preview-api/index.d.ts

@@ -1049,4 +1049,29 @@ declare function emitTransformCode(source: string | undefined, context: ReducedS
 declare function pauseAnimations(atEnd?: boolean): CleanupCallback;
 declare function waitForAnimations(signal?: AbortSignal): Promise<void>;
 
-export { DocsContext, HooksContext, Preview, PreviewWeb, PreviewWithSelection, type PropDescriptor, type Report, ReporterAPI, type SelectionStore, StoryStore, UrlStore, type View, WebView, addons, applyHooks, combineArgs, combineParameters, composeConfigs, composeStepRunners, composeStories, composeStory, createPlaywrightTest, decorateStory, defaultDecorateStory, emitTransformCode, filterArgTypes, getCsfFactoryAnnotations, inferControls, makeDecorator, mockChannel, normalizeArrays, normalizeProjectAnnotations, normalizeStory, pauseAnimations, prepareMeta, prepareStory, sanitizeStoryContextUpdate, setDefaultProjectAnnotations, setProjectAnnotations, simulateDOMContentLoaded, simulatePageLoad, sortStoriesV7, useArgs, useCallback, useChannel, useEffect, useGlobals, useMemo, useParameter, useReducer, useRef, useState, useStoryContext, userOrAutoTitle, userOrAutoTitleFromSpecifier, waitForAnimations };
+/** System tags used throughout Storybook for categorizing and filtering stories and docs entries. */
+declare const Tag: {
+    /** Indicates that autodocs should be generated for this component */
+    readonly AUTODOCS: "autodocs";
+    /** MDX documentation attached to a component's stories file */
+    readonly ATTACHED_MDX: "attached-mdx";
+    /** Standalone MDX documentation not attached to stories */
+    readonly UNATTACHED_MDX: "unattached-mdx";
+    /** Story has a play function */
+    readonly PLAY_FN: "play-fn";
+    /** Story has a test function */
+    readonly TEST_FN: "test-fn";
+    /** Development environment tag */
+    readonly DEV: "dev";
+    /** Test environment tag */
+    readonly TEST: "test";
+    /** Manifest generation tag */
+    readonly MANIFEST: "manifest";
+};
+/**
+ * Tags can be any string, including custom user-defined tags. The Tag constant above defines the
+ * system tags used by Storybook.
+ */
+type Tag = string;
+
+export { DocsContext, HooksContext, Preview, PreviewWeb, PreviewWithSelection, type PropDescriptor, type Report, ReporterAPI, type SelectionStore, StoryStore, Tag, UrlStore, type View, WebView, addons, applyHooks, combineArgs, combineParameters, composeConfigs, composeStepRunners, composeStories, composeStory, createPlaywrightTest, decorateStory, defaultDecorateStory, emitTransformCode, filterArgTypes, getCsfFactoryAnnotations, inferControls, makeDecorator, mockChannel, normalizeArrays, normalizeProjectAnnotations, normalizeStory, pauseAnimations, prepareMeta, prepareStory, sanitizeStoryContextUpdate, setDefaultProjectAnnotations, setProjectAnnotations, simulateDOMContentLoaded, simulatePageLoad, sortStoriesV7, useArgs, useCallback, useChannel, useEffect, useGlobals, useMemo, useParameter, useReducer, useRef, useState, useStoryContext, userOrAutoTitle, userOrAutoTitleFromSpecifier, waitForAnimations };

package/dist/preview-api/index.js

@@ -48,11 +48,14 @@ import {
   useStoryContext,
   userOrAutoTitle,
   userOrAutoTitleFromSpecifier
-} from "../_browser-chunks/chunk-RBABWY22.js";
+} from "../_browser-chunks/chunk-BGSDJMFM.js";
 import {
   pauseAnimations,
   waitForAnimations
 } from "../_browser-chunks/chunk-MEXTPDJG.js";
+import {
+  Tag
+} from "../_browser-chunks/chunk-AFVOZMXQ.js";
 import "../_browser-chunks/chunk-XLJZ7AOP.js";
 import {
   combineParameters
@@ -74,6 +77,7 @@ export {
   PreviewWithSelection,
   ReporterAPI,
   StoryStore,
+  Tag,
   UrlStore,
   WebView,
   addons,

package/dist/server-errors.js

@@ -1,10 +1,10 @@
-import CJS_COMPAT_NODE_URL_aucdos01fk5 from 'node:url';
-import CJS_COMPAT_NODE_PATH_aucdos01fk5 from 'node:path';
-import CJS_COMPAT_NODE_MODULE_aucdos01fk5 from "node:module";
+import CJS_COMPAT_NODE_URL_0j7q77gppets from 'node:url';
+import CJS_COMPAT_NODE_PATH_0j7q77gppets from 'node:path';
+import CJS_COMPAT_NODE_MODULE_0j7q77gppets from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_aucdos01fk5.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_aucdos01fk5.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_aucdos01fk5.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_0j7q77gppets.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_0j7q77gppets.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_0j7q77gppets.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
@@ -46,13 +46,13 @@ import {
   WebpackCompilationError,
   WebpackInvocationError,
   WebpackMissingStatsError
-} from "./_node-chunks/chunk-TOMGRF4A.js";
+} from "./_node-chunks/chunk-VL57YBAT.js";
 import {
   StorybookError
-} from "./_node-chunks/chunk-2DZGIXSN.js";
-import "./_node-chunks/chunk-URWJMVZI.js";
-import "./_node-chunks/chunk-WQ4WQYSZ.js";
-import "./_node-chunks/chunk-FWVZUHZX.js";
+} from "./_node-chunks/chunk-HVD2LZT3.js";
+import "./_node-chunks/chunk-IQUZPWN3.js";
+import "./_node-chunks/chunk-YPYOZM4G.js";
+import "./_node-chunks/chunk-WMWMEGTL.js";
 export {
   AddonVitestPostinstallConfigUpdateError,
   AddonVitestPostinstallError,