storybook 9.1.0-alpha.2 → 9.1.0-alpha.4

package/dist/highlight/preview.d.ts

@@ -1,555 +1,20 @@
-import { Renderer as Renderer$1, ProjectAnnotations as ProjectAnnotations$1, StoryIdentifier, StoryContext, PartialStoryFn, LegacyStoryFn } from 'storybook/internal/csf';
-import { NormalizedProjectAnnotations, ProjectAnnotations as ProjectAnnotations$2, ComposedStoryFn } from 'storybook/internal/types';
+import * as storybook_internal_csf from 'storybook/internal/csf';
 
-/**
- * Actions represent the type of change to a location value.
- */
-declare enum Action {
-    /**
-     * A POP indicates a change to an arbitrary index in the history stack, such
-     * as a back or forward navigation. It does not describe the direction of the
-     * navigation, only that the current index changed.
-     *
-     * Note: This is the default action for newly created history objects.
-     */
-    Pop = "POP",
-    /**
-     * A PUSH indicates a new entry being added to the history stack, such as when
-     * a link is clicked and a new page loads. When this happens, all subsequent
-     * entries in the stack are lost.
-     */
-    Push = "PUSH",
-    /**
-     * A REPLACE indicates the entry at the current index in the history stack
-     * being replaced by a new one.
-     */
-    Replace = "REPLACE"
+interface HighlightTypes {
+    parameters: HighlightParameters;
 }
-/**
- * The pathname, search, and hash values of a URL.
- */
-interface Path {
-    /**
-     * A URL pathname, beginning with a /.
-     */
-    pathname: string;
+interface HighlightParameters {
     /**
-     * A URL search string, beginning with a ?.
-     */
-    search: string;
-    /**
-     * A URL fragment identifier, beginning with a #.
-     */
-    hash: string;
-}
-/**
- * An entry in a history stack. A location contains information about the
- * URL path, as well as possibly some arbitrary state and a key.
- */
-interface Location extends Path {
-    /**
-     * A value of arbitrary data associated with this location.
-     */
-    state: any;
-    /**
-     * A unique string associated with this location. May be used to safely store
-     * and retrieve data in some other storage API, like `localStorage`.
+     * Highlight configuration
      *
-     * Note: This value is always "default" on the initial location.
-     */
-    key: string;
-}
-
-/**
- * Map of routeId -> data returned from a loader/action/error
- */
-interface RouteData {
-    [routeId: string]: any;
-}
-declare enum ResultType {
-    data = "data",
-    deferred = "deferred",
-    redirect = "redirect",
-    error = "error"
-}
-/**
- * Successful result from a loader or action
- */
-interface SuccessResult {
-    type: ResultType.data;
-    data: any;
-    statusCode?: number;
-    headers?: Headers;
-}
-/**
- * Successful defer() result from a loader or action
- */
-interface DeferredResult {
-    type: ResultType.deferred;
-    deferredData: DeferredData;
-    statusCode?: number;
-    headers?: Headers;
-}
-/**
- * Redirect result from a loader or action
- */
-interface RedirectResult {
-    type: ResultType.redirect;
-    status: number;
-    location: string;
-    revalidate: boolean;
-    reloadDocument?: boolean;
-}
-/**
- * Unsuccessful result from a loader or action
- */
-interface ErrorResult {
-    type: ResultType.error;
-    error: any;
-    headers?: Headers;
-}
-/**
- * Result from a loader or action - potentially successful or unsuccessful
- */
-type DataResult = SuccessResult | DeferredResult | RedirectResult | ErrorResult;
-type LowerCaseFormMethod = "get" | "post" | "put" | "patch" | "delete";
-type UpperCaseFormMethod = Uppercase<LowerCaseFormMethod>;
-/**
- * Active navigation/fetcher form methods are exposed in lowercase on the
- * RouterState
- */
-type FormMethod = LowerCaseFormMethod;
-/**
- * In v7, active navigation/fetcher form methods are exposed in uppercase on the
- * RouterState.  This is to align with the normalization done via fetch().
- */
-type V7_FormMethod = UpperCaseFormMethod;
-type FormEncType = "application/x-www-form-urlencoded" | "multipart/form-data" | "application/json" | "text/plain";
-type JsonObject = {
-    [Key in string]: JsonValue;
-} & {
-    [Key in string]?: JsonValue | undefined;
-};
-type JsonArray = JsonValue[] | readonly JsonValue[];
-type JsonPrimitive = string | number | boolean | null;
-type JsonValue = JsonPrimitive | JsonObject | JsonArray;
-/**
- * @private
- * Internal interface to pass around for action submissions, not intended for
- * external consumption
- */
-type Submission = {
-    formMethod: FormMethod | V7_FormMethod;
-    formAction: string;
-    formEncType: FormEncType;
-    formData: FormData;
-    json: undefined;
-    text: undefined;
-} | {
-    formMethod: FormMethod | V7_FormMethod;
-    formAction: string;
-    formEncType: FormEncType;
-    formData: undefined;
-    json: JsonValue;
-    text: undefined;
-} | {
-    formMethod: FormMethod | V7_FormMethod;
-    formAction: string;
-    formEncType: FormEncType;
-    formData: undefined;
-    json: undefined;
-    text: string;
-};
-/**
- * @private
- * Arguments passed to route loader/action functions.  Same for now but we keep
- * this as a private implementation detail in case they diverge in the future.
- */
-interface DataFunctionArgs {
-    request: Request;
-    params: Params;
-    context?: any;
-}
-/**
- * Arguments passed to loader functions
- */
-interface LoaderFunctionArgs extends DataFunctionArgs {
-}
-/**
- * Arguments passed to action functions
- */
-interface ActionFunctionArgs extends DataFunctionArgs {
-}
-/**
- * Loaders and actions can return anything except `undefined` (`null` is a
- * valid return value if there is no data to return).  Responses are preferred
- * and will ease any future migration to Remix
- */
-type DataFunctionValue = Response | NonNullable<unknown> | null;
-/**
- * Route loader function signature
- */
-interface LoaderFunction {
-    (args: LoaderFunctionArgs): Promise<DataFunctionValue> | DataFunctionValue;
-}
-/**
- * Route action function signature
- */
-interface ActionFunction {
-    (args: ActionFunctionArgs): Promise<DataFunctionValue> | DataFunctionValue;
-}
-/**
- * Route shouldRevalidate function signature.  This runs after any submission
- * (navigation or fetcher), so we flatten the navigation/fetcher submission
- * onto the arguments.  It shouldn't matter whether it came from a navigation
- * or a fetcher, what really matters is the URLs and the formData since loaders
- * have to re-run based on the data models that were potentially mutated.
- */
-interface ShouldRevalidateFunction {
-    (args: {
-        currentUrl: URL;
-        currentParams: AgnosticDataRouteMatch["params"];
-        nextUrl: URL;
-        nextParams: AgnosticDataRouteMatch["params"];
-        formMethod?: Submission["formMethod"];
-        formAction?: Submission["formAction"];
-        formEncType?: Submission["formEncType"];
-        text?: Submission["text"];
-        formData?: Submission["formData"];
-        json?: Submission["json"];
-        actionResult?: DataResult;
-        defaultShouldRevalidate: boolean;
-    }): boolean;
-}
-/**
- * Keys we cannot change from within a lazy() function. We spread all other keys
- * onto the route. Either they're meaningful to the router, or they'll get
- * ignored.
- */
-type ImmutableRouteKey = "lazy" | "caseSensitive" | "path" | "id" | "index" | "children";
-type RequireOne<T, Key = keyof T> = Exclude<{
-    [K in keyof T]: K extends Key ? Omit<T, K> & Required<Pick<T, K>> : never;
-}[keyof T], undefined>;
-/**
- * lazy() function to load a route definition, which can add non-matching
- * related properties to a route
- */
-interface LazyRouteFunction<R extends AgnosticRouteObject> {
-    (): Promise<RequireOne<Omit<R, ImmutableRouteKey>>>;
-}
-/**
- * Base RouteObject with common props shared by all types of routes
- */
-type AgnosticBaseRouteObject = {
-    caseSensitive?: boolean;
-    path?: string;
-    id?: string;
-    loader?: LoaderFunction;
-    action?: ActionFunction;
-    hasErrorBoundary?: boolean;
-    shouldRevalidate?: ShouldRevalidateFunction;
-    handle?: any;
-    lazy?: LazyRouteFunction<AgnosticBaseRouteObject>;
-};
-/**
- * Index routes must not have children
- */
-type AgnosticIndexRouteObject = AgnosticBaseRouteObject & {
-    children?: undefined;
-    index: true;
-};
-/**
- * Non-index routes may have children, but cannot have index
- */
-type AgnosticNonIndexRouteObject = AgnosticBaseRouteObject & {
-    children?: AgnosticRouteObject[];
-    index?: false;
-};
-/**
- * A route object represents a logical route, with (optionally) its child
- * routes organized in a tree-like structure.
- */
-type AgnosticRouteObject = AgnosticIndexRouteObject | AgnosticNonIndexRouteObject;
-type AgnosticDataIndexRouteObject = AgnosticIndexRouteObject & {
-    id: string;
-};
-type AgnosticDataNonIndexRouteObject = AgnosticNonIndexRouteObject & {
-    children?: AgnosticDataRouteObject[];
-    id: string;
-};
-/**
- * A data route object, which is just a RouteObject with a required unique ID
- */
-type AgnosticDataRouteObject = AgnosticDataIndexRouteObject | AgnosticDataNonIndexRouteObject;
-/**
- * The parameters that were parsed from the URL path.
- */
-type Params<Key extends string = string> = {
-    readonly [key in Key]: string | undefined;
-};
-/**
- * A RouteMatch contains info about how a route matched a URL.
- */
-interface AgnosticRouteMatch<ParamKey extends string = string, RouteObjectType extends AgnosticRouteObject = AgnosticRouteObject> {
-    /**
-     * The names and values of dynamic parameters in the URL.
-     */
-    params: Params<ParamKey>;
-    /**
-     * The portion of the URL pathname that was matched.
-     */
-    pathname: string;
-    /**
-     * The portion of the URL pathname that was matched before child routes.
-     */
-    pathnameBase: string;
-    /**
-     * The route object that was used to match.
-     */
-    route: RouteObjectType;
-}
-interface AgnosticDataRouteMatch extends AgnosticRouteMatch<string, AgnosticDataRouteObject> {
-}
-declare class DeferredData {
-    private pendingKeysSet;
-    private controller;
-    private abortPromise;
-    private unlistenAbortSignal;
-    private subscribers;
-    data: Record<string, unknown>;
-    init?: ResponseInit;
-    deferredKeys: string[];
-    constructor(data: Record<string, unknown>, responseInit?: ResponseInit);
-    private trackPromise;
-    private onSettle;
-    private emit;
-    subscribe(fn: (aborted: boolean, settledKey?: string) => void): () => boolean;
-    cancel(): void;
-    resolveData(signal: AbortSignal): Promise<boolean>;
-    get done(): boolean;
-    get unwrappedData(): {};
-    get pendingKeys(): string[];
-}
-
-/**
- * State maintained internally by the router.  During a navigation, all states
- * reflect the the "old" location unless otherwise noted.
- */
-interface RouterState {
-    /**
-     * The action of the most recent navigation
+     * @see https://storybook.js.org/docs/essentials/highlight#parameters
      */
-    historyAction: Action;
-    /**
-     * The current location reflected by the router
-     */
-    location: Location;
-    /**
-     * The current set of route matches
-     */
-    matches: AgnosticDataRouteMatch[];
-    /**
-     * Tracks whether we've completed our initial data load
-     */
-    initialized: boolean;
-    /**
-     * Current scroll position we should start at for a new view
-     *  - number -> scroll position to restore to
-     *  - false -> do not restore scroll at all (used during submissions)
-     *  - null -> don't have a saved position, scroll to hash or top of page
-     */
-    restoreScrollPosition: number | false | null;
-    /**
-     * Indicate whether this navigation should skip resetting the scroll position
-     * if we are unable to restore the scroll position
-     */
-    preventScrollReset: boolean;
-    /**
-     * Tracks the state of the current navigation
-     */
-    navigation: Navigation;
-    /**
-     * Tracks any in-progress revalidations
-     */
-    revalidation: RevalidationState;
-    /**
-     * Data from the loaders for the current matches
-     */
-    loaderData: RouteData;
-    /**
-     * Data from the action for the current matches
-     */
-    actionData: RouteData | null;
-    /**
-     * Errors caught from loaders for the current matches
-     */
-    errors: RouteData | null;
-    /**
-     * Map of current fetchers
-     */
-    fetchers: Map<string, Fetcher>;
-    /**
-     * Map of current blockers
-     */
-    blockers: Map<string, Blocker>;
-}
-/**
- * Data that can be passed into hydrate a Router from SSR
- */
-type HydrationState = Partial<Pick<RouterState, "loaderData" | "actionData" | "errors">>;
-/**
- * Potential states for state.navigation
- */
-type NavigationStates = {
-    Idle: {
-        state: "idle";
-        location: undefined;
-        formMethod: undefined;
-        formAction: undefined;
-        formEncType: undefined;
-        formData: undefined;
-        json: undefined;
-        text: undefined;
-    };
-    Loading: {
-        state: "loading";
-        location: Location;
-        formMethod: Submission["formMethod"] | undefined;
-        formAction: Submission["formAction"] | undefined;
-        formEncType: Submission["formEncType"] | undefined;
-        formData: Submission["formData"] | undefined;
-        json: Submission["json"] | undefined;
-        text: Submission["text"] | undefined;
-    };
-    Submitting: {
-        state: "submitting";
-        location: Location;
-        formMethod: Submission["formMethod"];
-        formAction: Submission["formAction"];
-        formEncType: Submission["formEncType"];
-        formData: Submission["formData"];
-        json: Submission["json"];
-        text: Submission["text"];
-    };
-};
-type Navigation = NavigationStates[keyof NavigationStates];
-type RevalidationState = "idle" | "loading";
-/**
- * Potential states for fetchers
- */
-type FetcherStates<TData = any> = {
-    Idle: {
-        state: "idle";
-        formMethod: undefined;
-        formAction: undefined;
-        formEncType: undefined;
-        text: undefined;
-        formData: undefined;
-        json: undefined;
-        data: TData | undefined;
-        " _hasFetcherDoneAnything "?: boolean;
-    };
-    Loading: {
-        state: "loading";
-        formMethod: Submission["formMethod"] | undefined;
-        formAction: Submission["formAction"] | undefined;
-        formEncType: Submission["formEncType"] | undefined;
-        text: Submission["text"] | undefined;
-        formData: Submission["formData"] | undefined;
-        json: Submission["json"] | undefined;
-        data: TData | undefined;
-        " _hasFetcherDoneAnything "?: boolean;
-    };
-    Submitting: {
-        state: "submitting";
-        formMethod: Submission["formMethod"];
-        formAction: Submission["formAction"];
-        formEncType: Submission["formEncType"];
-        text: Submission["text"];
-        formData: Submission["formData"];
-        json: Submission["json"];
-        data: TData | undefined;
-        " _hasFetcherDoneAnything "?: boolean;
-    };
-};
-type Fetcher<TData = any> = FetcherStates<TData>[keyof FetcherStates<TData>];
-interface BlockerBlocked {
-    state: "blocked";
-    reset(): void;
-    proceed(): void;
-    location: Location;
-}
-interface BlockerUnblocked {
-    state: "unblocked";
-    reset: undefined;
-    proceed: undefined;
-    location: undefined;
-}
-interface BlockerProceeding {
-    state: "proceeding";
-    reset: undefined;
-    proceed: undefined;
-    location: Location;
-}
-type Blocker = BlockerUnblocked | BlockerBlocked | BlockerProceeding;
-
-/**
- * NOTE: If you refactor this to split up the modules into separate files,
- * you'll need to update the rollup config for react-router-dom-v5-compat.
- */
-
-declare global {
-    var __staticRouterHydrationData: HydrationState | undefined;
-}
-
-declare global {
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
-interface Renderer extends Renderer$1 {
-}
-
-type MaybePromise<T> = Promise<T> | T;
-type TeardownRenderToCanvas = () => MaybePromise<void>;
-type RenderToCanvas<TRenderer extends Renderer> = (context: RenderContext<TRenderer>, element: TRenderer['canvasElement']) => MaybePromise<void | TeardownRenderToCanvas>;
-interface ProjectAnnotations<TRenderer extends Renderer> extends ProjectAnnotations$1<TRenderer> {
-    addons?: ProjectAnnotations<TRenderer>[];
-    testingLibraryRender?: (...args: never[]) => {
-        unmount: () => void;
+    highlight?: {
+        /** Remove the addon panel and disable the addon's behavior */
+        disable?: boolean;
     };
-    renderToCanvas?: RenderToCanvas<TRenderer>;
-}
-declare type RenderContext<TRenderer extends Renderer = Renderer> = StoryIdentifier & {
-    showMain: () => void;
-    showError: (error: {
-        title: string;
-        description: string;
-    }) => void;
-    showException: (err: Error) => void;
-    forceRemount: boolean;
-    storyContext: StoryContext<TRenderer>;
-    storyFn: PartialStoryFn<TRenderer>;
-    unboundStoryFn: LegacyStoryFn<TRenderer>;
-};
-
-declare global {
-    var globalProjectAnnotations: NormalizedProjectAnnotations<any>;
-    var defaultProjectAnnotations: ProjectAnnotations$2<any>;
-}
-type WrappedStoryRef = {
-    __pw_type: 'jsx' | 'importRef';
-};
-type UnwrappedJSXStoryRef = {
-    __pw_type: 'jsx';
-    type: UnwrappedImportStoryRef;
-};
-type UnwrappedImportStoryRef = ComposedStoryFn;
-declare global {
-    function __pwUnwrapObject(storyRef: WrappedStoryRef): Promise<UnwrappedJSXStoryRef | UnwrappedImportStoryRef>;
 }
 
-declare const _default: () => ProjectAnnotations<Renderer>;
+declare const _default: () => storybook_internal_csf.PreviewAddon<HighlightTypes>;
 
-export { _default as default };
+export { type HighlightTypes, _default as default };

package/dist/highlight/preview.js

@@ -2,13 +2,14 @@ var pe = Object.defineProperty;
 var c = (s, e) => pe(s, "name", { value: e, configurable: !0 });
 
 // src/highlight/preview.ts
-import { addons as le, definePreview as fe } from "storybook/preview-api";
+import { definePreviewAddon as fe } from "storybook/internal/csf";
+import { addons as le } from "storybook/preview-api";
 
 // src/highlight/useHighlights.ts
 import { STORY_RENDER_PHASE_CHANGED as he } from "storybook/internal/core-events";
 
 // src/highlight/constants.ts
-var _ = "storybook/highlight", U = `${_}/add`, K = `${_}/remove`, J = `${_}/reset`, Q = `${_}/scroll-into-view`, F = 2147483647, L = 28;
+var _ = "storybook/highlight", U = `${_}/add`, K = `${_}/remove`, J = `${_}/reset`, Q = `${_}/scroll-into-view`, F = 2147483647, T = 28;
 
 // src/highlight/icons.ts
 var G = {
@@ -85,7 +86,7 @@ var ue = "svg,path,rect,circle,line,polyline,polygon,ellipse,text".split(","), b
     menu: Array.isArray(e) ? e.every(Array.isArray) ? e : [e] : void 0
   };
 }, "normalizeOptions"), me = /* @__PURE__ */ c((s) => s instanceof Function, "isFunction"), S = /* @__PURE__ */ new Map(), C = /* @__PURE__ */ new Map(),
-R = /* @__PURE__ */ new Map(), T = /* @__PURE__ */ c((s) => {
+R = /* @__PURE__ */ new Map(), L = /* @__PURE__ */ c((s) => {
   let e = Symbol();
   return C.set(e, []), S.set(e, s), { get: /* @__PURE__ */ c(() => S.get(e), "get"), set: /* @__PURE__ */ c((u) => {
     let m = S.get(e), f = me(u) ? u(m) : u;
@@ -150,7 +151,7 @@ menu: u }]) => {
   if (!e || !d)
     return !1;
   let { left: l, top: r, width: p, height: u } = s;
-  u < L && (r = r - Math.round((L - u) / 2), u = L), p < L && (l = l - Math.round((L - p) / 2), p = L), e.style.position === "fixed" && (l +=
+  u < T && (r = r - Math.round((T - u) / 2), u = T), p < T && (l = l - Math.round((T - p) / 2), p = T), e.style.position === "fixed" && (l +=
   window.scrollX, r += window.scrollY);
   let { x: m, y: f } = d;
   return m >= l && m <= l + p && f >= r && f <= r + u;
@@ -192,8 +193,8 @@ var g = "storybook-highlights-menu", ie = "storybook-highlights-root", ge = "sto
   if (globalThis.__STORYBOOK_HIGHLIGHT_INITIALIZED)
     return;
   globalThis.__STORYBOOK_HIGHLIGHT_INITIALIZED = !0;
-  let { document: e } = globalThis, d = T([]), l = T(/* @__PURE__ */ new Map()), r = T([]), p = T(), u = T(), m = T([]), f = T([]), E = T(),
-  w = T(), v = e.getElementById(ie);
+  let { document: e } = globalThis, d = L([]), l = L(/* @__PURE__ */ new Map()), r = L([]), p = L(), u = L(), m = L([]), f = L([]), E = L(),
+  w = L(), v = e.getElementById(ie);
   d.subscribe(() => {
     v || (v = b("div", { id: ie }), e.body.appendChild(v));
   }), d.subscribe((n) => {
@@ -325,8 +326,8 @@ var g = "storybook-highlights-menu", ie = "storybook-highlights-root", ge = "sto
         }), Object.assign(h.children[0].style, {
           width: "100%",
           height: "100%",
-          minHeight: `${L}px`,
-          minWidth: `${L}px`,
+          minHeight: `${T}px`,
+          minWidth: `${T}px`,
           boxSizing: "content-box",
           padding: h.style.outlineWidth || "0px"
         }), V(h);
@@ -568,7 +569,7 @@ ue", Helvetica, Arial, sans-serif;
 
 // src/highlight/preview.ts
 globalThis?.FEATURES?.highlight && le?.ready && le.ready().then(re);
-var $e = /* @__PURE__ */ c(() => fe({}), "default");
+var Se = /* @__PURE__ */ c(() => fe({}), "default");
 export {
-  $e as default
+  Se as default
 };