storybook 9.1.0-alpha.0 → 9.1.0-alpha.10

package/dist/common/index.d.ts

@@ -2,24 +2,19 @@ import * as storybook_internal_types from 'storybook/internal/types';
 import { PresetConfig, CoreCommon_ResolvedAddonPreset, CoreCommon_ResolvedAddonVirtual, CLIOptions, LoadOptions, BuilderOptions, StorybookConfigRaw, LoadedPreset, Presets, PackageJson, CoreCommon_AddonInfo, SupportedFrameworks, SupportedRenderers, Options as Options$1, CoreCommon_StorybookInfo, Ref, StorybookConfig, StoriesEntry, NormalizedStoriesSpecifier } from 'storybook/internal/types';
 export { PackageJson } from 'storybook/internal/types';
 import { WriteStream } from 'node:fs';
-import { Stream } from 'node:stream';
+import { Buffer } from 'node:buffer';
+import { ChildProcess } from 'node:child_process';
+import { Readable, Writable, Stream } from 'node:stream';
 import { ConfigFile } from 'storybook/internal/csf-tools';
 
 declare const _default: {
     '@storybook/addon-a11y': string;
-    '@storybook/addon-actions': string;
-    '@storybook/addon-backgrounds': string;
-    '@storybook/addon-controls': string;
     '@storybook/addon-docs': string;
     '@storybook/addon-jest': string;
     '@storybook/addon-links': string;
-    '@storybook/addon-measure': string;
     '@storybook/addon-onboarding': string;
-    '@storybook/addon-outline': string;
     'storybook-addon-pseudo-states': string;
     '@storybook/addon-themes': string;
-    '@storybook/addon-toolbars': string;
-    '@storybook/addon-viewport': string;
     '@storybook/addon-vitest': string;
     '@storybook/builder-vite': string;
     '@storybook/builder-webpack5': string;
@@ -446,6 +441,211 @@ type CommonOptions<EncodingType extends EncodingOption = DefaultEncodingOption>
 	readonly verbose?: boolean;
 };
 
+type StdoutStderrAll = string | Buffer | undefined;
+
+type ExecaReturnBase<StdoutStderrType extends StdoutStderrAll> = {
+	/**
+	The file and arguments that were run, for logging purposes.
+
+	This is not escaped and should not be executed directly as a process, including using `execa()` or `execaCommand()`.
+	*/
+	command: string;
+
+	/**
+	Same as `command` but escaped.
+
+	This is meant to be copy and pasted into a shell, for debugging purposes.
+	Since the escaping is fairly basic, this should not be executed directly as a process, including using `execa()` or `execaCommand()`.
+	*/
+	escapedCommand: string;
+
+	/**
+	The numeric exit code of the process that was run.
+	*/
+	exitCode: number;
+
+	/**
+	The output of the process on stdout.
+	*/
+	stdout: StdoutStderrType;
+
+	/**
+	The output of the process on stderr.
+	*/
+	stderr: StdoutStderrType;
+
+	/**
+	Whether the process failed to run.
+	*/
+	failed: boolean;
+
+	/**
+	Whether the process timed out.
+	*/
+	timedOut: boolean;
+
+	/**
+	Whether the process was killed.
+	*/
+	killed: boolean;
+
+	/**
+	The name of the signal that was used to terminate the process. For example, `SIGFPE`.
+
+	If a signal terminated the process, this property is defined and included in the error message. Otherwise it is `undefined`.
+	*/
+	signal?: string;
+
+	/**
+	A human-friendly description of the signal that was used to terminate the process. For example, `Floating point arithmetic error`.
+
+	If a signal terminated the process, this property is defined and included in the error message. Otherwise it is `undefined`. It is also `undefined` when the signal is very uncommon which should seldomly happen.
+	*/
+	signalDescription?: string;
+
+	/**
+	The `cwd` of the command if provided in the command options. Otherwise it is `process.cwd()`.
+	*/
+	cwd: string;
+};
+
+type ExecaSyncReturnValue<StdoutStderrType extends StdoutStderrAll = string> = {
+} & ExecaReturnBase<StdoutStderrType>;
+
+/**
+Result of a child process execution. On success this is a plain object. On failure this is also an `Error` instance.
+
+The child process fails when:
+- its exit code is not `0`
+- it was killed with a signal
+- timing out
+- being canceled
+- there's not enough memory or there are already too many child processes
+*/
+type ExecaReturnValue<StdoutStderrType extends StdoutStderrAll = string> = {
+	/**
+	The output of the process with `stdout` and `stderr` interleaved.
+
+	This is `undefined` if either:
+	- the `all` option is `false` (default value)
+	- `execaSync()` was used
+	*/
+	all?: StdoutStderrType;
+
+	/**
+	Whether the process was canceled.
+
+	You can cancel the spawned process using the [`signal`](https://github.com/sindresorhus/execa#signal-1) option.
+	*/
+	isCanceled: boolean;
+} & ExecaSyncReturnValue<StdoutStderrType>;
+
+type ExecaSyncError<StdoutStderrType extends StdoutStderrAll = string> = {
+	/**
+	Error message when the child process failed to run. In addition to the underlying error message, it also contains some information related to why the child process errored.
+
+	The child process stderr then stdout are appended to the end, separated with newlines and not interleaved.
+	*/
+	message: string;
+
+	/**
+	This is the same as the `message` property except it does not include the child process stdout/stderr.
+	*/
+	shortMessage: string;
+
+	/**
+	Original error message. This is the same as the `message` property except it includes neither the child process stdout/stderr nor some additional information added by Execa.
+
+	This is `undefined` unless the child process exited due to an `error` event or a timeout.
+	*/
+	originalMessage?: string;
+} & Error & ExecaReturnBase<StdoutStderrType>;
+
+type ExecaError<StdoutStderrType extends StdoutStderrAll = string> = {
+	/**
+	The output of the process with `stdout` and `stderr` interleaved.
+
+	This is `undefined` if either:
+	- the `all` option is `false` (default value)
+	- `execaSync()` was used
+	*/
+	all?: StdoutStderrType;
+
+	/**
+	Whether the process was canceled.
+	*/
+	isCanceled: boolean;
+} & ExecaSyncError<StdoutStderrType>;
+
+type KillOptions = {
+	/**
+	Milliseconds to wait for the child process to terminate before sending `SIGKILL`.
+
+	Can be disabled with `false`.
+
+	@default 5000
+	*/
+	forceKillAfterTimeout?: number | false;
+};
+
+type ExecaChildPromise<StdoutStderrType extends StdoutStderrAll> = {
+	/**
+	Stream combining/interleaving [`stdout`](https://nodejs.org/api/child_process.html#child_process_subprocess_stdout) and [`stderr`](https://nodejs.org/api/child_process.html#child_process_subprocess_stderr).
+
+	This is `undefined` if either:
+		- the `all` option is `false` (the default value)
+		- both `stdout` and `stderr` options are set to [`'inherit'`, `'ipc'`, `Stream` or `integer`](https://nodejs.org/dist/latest-v6.x/docs/api/child_process.html#child_process_options_stdio)
+	*/
+	all?: Readable;
+
+	catch<ResultType = never>(
+		onRejected?: (reason: ExecaError<StdoutStderrType>) => ResultType | PromiseLike<ResultType>
+	): Promise<ExecaReturnValue<StdoutStderrType> | ResultType>;
+
+	/**
+	Same as the original [`child_process#kill()`](https://nodejs.org/api/child_process.html#child_process_subprocess_kill_signal), except if `signal` is `SIGTERM` (the default value) and the child process is not terminated after 5 seconds, force it by sending `SIGKILL`. Note that this graceful termination does not work on Windows, because Windows [doesn't support signals](https://nodejs.org/api/process.html#process_signal_events) (`SIGKILL` and `SIGTERM` has the same effect of force-killing the process immediately.) If you want to achieve graceful termination on Windows, you have to use other means, such as [`taskkill`](https://github.com/sindresorhus/taskkill).
+	*/
+	kill(signal?: string, options?: KillOptions): void;
+
+	/**
+	Similar to [`childProcess.kill()`](https://nodejs.org/api/child_process.html#child_process_subprocess_kill_signal). This used to be preferred when cancelling the child process execution as the error is more descriptive and [`childProcessResult.isCanceled`](#iscanceled) is set to `true`. But now this is deprecated and you should either use `.kill()` or the `signal` option when creating the child process.
+	*/
+	cancel(): void;
+
+	/**
+	[Pipe](https://nodejs.org/api/stream.html#readablepipedestination-options) the child process's `stdout` to `target`, which can be:
+	- Another `execa()` return value
+	- A writable stream
+	- A file path string
+
+	If the `target` is another `execa()` return value, it is returned. Otherwise, the original `execa()` return value is returned. This allows chaining `pipeStdout()` then `await`ing the final result.
+
+	The `stdout` option] must be kept as `pipe`, its default value.
+	*/
+	pipeStdout?<Target extends ExecaChildPromise<StdoutStderrAll>>(target: Target): Target;
+	pipeStdout?(target: Writable | string): ExecaChildProcess<StdoutStderrType>;
+
+	/**
+	Like `pipeStdout()` but piping the child process's `stderr` instead.
+
+	The `stderr` option must be kept as `pipe`, its default value.
+	*/
+	pipeStderr?<Target extends ExecaChildPromise<StdoutStderrAll>>(target: Target): Target;
+	pipeStderr?(target: Writable | string): ExecaChildProcess<StdoutStderrType>;
+
+	/**
+	Combines both `pipeStdout()` and `pipeStderr()`.
+
+	Either the `stdout` option or the `stderr` option must be kept as `pipe`, their default value. Also, the `all` option must be set to `true`.
+	*/
+	pipeAll?<Target extends ExecaChildPromise<StdoutStderrAll>>(target: Target): Target;
+	pipeAll?(target: Writable | string): ExecaChildProcess<StdoutStderrType>;
+};
+
+type ExecaChildProcess<StdoutStderrType extends StdoutStderrAll = string> = ChildProcess &
+ExecaChildPromise<StdoutStderrType> &
+Promise<ExecaReturnValue<StdoutStderrType>>;
+
 type PackageJsonWithDepsAndDevDeps = PackageJson & Required<Pick<PackageJson, 'dependencies' | 'devDependencies'>>;
 type PackageJsonWithMaybeDeps = Partial<Pick<PackageJson, 'dependencies' | 'devDependencies' | 'peerDependencies' | 'files'>>;
 
@@ -476,36 +676,54 @@ declare const COMMON_ENV_VARS: {
 declare function getPackageDetails(pkg: string): [string, string?];
 interface JsPackageManagerOptions {
     cwd?: string;
+    configDir?: string;
+    storiesPaths?: string[];
 }
+type PackageJsonInfo = {
+    packageJsonPath: string;
+    operationDir: string;
+    packageJson: PackageJsonWithDepsAndDevDeps;
+};
 declare abstract class JsPackageManager {
+    #private;
     abstract readonly type: PackageManagerName;
-    abstract initPackageJson(): Promise<void>;
-    abstract getRunStorybookCommand(): string;
-    abstract getRunCommand(command: string): string;
-    abstract getRemoteRunCommand(): string;
-    readonly cwd?: string;
-    abstract getPackageJSON(packageName: string, basePath?: string): Promise<PackageJson | null>;
-    /** Get the INSTALLED version of a package from the package.json file */
-    getPackageVersion(packageName: string, basePath?: string | undefined): Promise<string | null>;
-    constructor(options?: JsPackageManagerOptions);
+    /** The path to the primary package.json file (contains the `storybook` dependency). */
+    readonly primaryPackageJson: PackageJsonInfo;
+    /** The paths to all package.json files in the project root. */
+    packageJsonPaths: string[];
     /**
-     * Detect whether Storybook gets initialized in a mono-repository/workspace environment The cwd
-     * doesn't have to be the root of the monorepo, it can be a subdirectory
-     *
-     * @returns `true`, if Storybook is initialized inside a mono-repository/workspace
+     * The path to the Storybook instance directory. This is used to find the primary package.json
+     * file in a repository.
      */
-    isStorybookInMonorepo(): boolean;
-    /** Install dependencies listed in `package.json` */
-    installDependencies(): Promise<void>;
-    packageJsonPath(): string;
-    readPackageJson(): Promise<PackageJson>;
-    writePackageJson(packageJson: PackageJson): Promise<void>;
+    readonly instanceDir: string;
+    /** The current working directory. */
+    protected readonly cwd: string;
+    /** Cache for latest version results to avoid repeated network calls. */
+    static readonly latestVersionCache: Map<string, string | null>;
+    /** Cache for installed version results to avoid repeated file system calls. */
+    static readonly installedVersionCache: Map<string, string | null>;
+    constructor(options?: JsPackageManagerOptions);
+    /** Runs arbitrary package scripts. */
+    abstract getRunCommand(command: string): string;
     /**
-     * Read the `package.json` file available in the directory the command was call from If there is
-     * no `package.json` it will create one.
+     * Run a command from a local or remote. Fetches a package from the registry without installing it
+     * as a dependency, hotloads it, and runs whatever default command binary it exposes.
      */
-    retrievePackageJson(): Promise<PackageJsonWithDepsAndDevDeps>;
-    getAllDependencies(): Promise<Partial<Record<string, string>>>;
+    abstract getRemoteRunCommand(pkg: string, args: string[], specifier?: string): string;
+    /** Get the package.json file for a given module. */
+    abstract getModulePackageJSON(packageName: string): PackageJson | null;
+    isStorybookInMonorepo(): boolean;
+    installDependencies(options?: {
+        force?: boolean;
+    }): Promise<void>;
+    dedupeDependencies(options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /** Read the `package.json` file available in the provided directory */
+    static getPackageJson(packageJsonPath: string): PackageJsonWithDepsAndDevDeps;
+    writePackageJson(packageJson: PackageJson, directory?: string): void;
+    getAllDependencies(): Record<string, string>;
+    isDependencyInstalled(dependency: string): boolean;
     /**
      * Add dependencies to a project using `yarn add` or `npm install`.
      *
@@ -523,28 +741,29 @@ declare abstract class JsPackageManager {
      * @param {Array} dependencies Contains a list of packages to add.
      */
     addDependencies(options: {
-        skipInstall?: boolean;
-        installAsDevDependencies?: boolean;
-        packageJson?: PackageJson;
+        skipInstall: true;
+        type: 'dependencies' | 'devDependencies' | 'peerDependencies';
+        writeOutputToFile?: boolean;
+        packageJsonInfo?: PackageJsonInfo;
+    } | {
+        skipInstall?: false;
+        type: 'dependencies' | 'devDependencies';
         writeOutputToFile?: boolean;
-    }, dependencies: string[]): Promise<void>;
+        packageJsonInfo?: PackageJsonInfo;
+    }, dependencies: string[]): Promise<void | ExecaChildProcess>;
     /**
-     * Remove dependencies from a project using `yarn remove` or `npm uninstall`.
+     * Removing dependencies from the package.json file, which is found first starting from the
+     * instance root. The method does not run a package manager install like `npm install`.
      *
      * @example
      *
      * ```ts
-     * removeDependencies(options, [`@storybook/react`]);
+     * removeDependencies([`@storybook/react`]);
      * ```
      *
-     * @param {Object} options Contains `skipInstall`, `packageJson` and `installAsDevDependencies`
-     *   which we use to determine how we install packages.
-     * @param {Array} dependencies Contains a list of packages to remove.
+     * @param dependencies Contains a list of packages to remove.
      */
-    removeDependencies(options: {
-        skipInstall?: boolean;
-        packageJson?: PackageJson;
-    }, dependencies: string[]): Promise<void>;
+    removeDependencies(dependencies: string[]): Promise<void>;
     /**
      * Return an array of strings matching following format: `<package_name>@<package_latest_version>`
      *
@@ -582,16 +801,36 @@ declare abstract class JsPackageManager {
      * @param packageName Name of the package
      * @param constraint Version range to use to constraint the returned version
      */
-    latestVersion(packageName: string, constraint?: string): Promise<string>;
+    latestVersion(packageName: string, constraint?: string): Promise<string | null>;
+    /**
+     * Clear the latest version cache. Useful for testing or when you want to refresh version
+     * information.
+     *
+     * @param packageName Optional package name to clear only specific entries. If not provided,
+     *   clears all cache.
+     */
+    static clearLatestVersionCache(packageName?: string): void;
+    /**
+     * Clear the installed version cache for a specific package or all packages.
+     *
+     * @param packageName Optional package name to clear from cache. If not provided, clears all.
+     */
+    clearInstalledVersionCache(packageName?: string): void;
+    /**
+     * Clear both the latest version cache and installed version cache. This should be called after
+     * any operation that modifies dependencies.
+     */
+    clearAllVersionCaches(): void;
     addStorybookCommandInScripts(options?: {
         port: number;
         preCommand?: string;
-    }): Promise<void>;
-    addScripts(scripts: Record<string, string>): Promise<void>;
-    addPackageResolutions(versions: Record<string, string>): Promise<void>;
-    protected abstract runInstall(): Promise<void>;
-    protected abstract runAddDeps(dependencies: string[], installAsDevDependencies: boolean, writeOutputToFile?: boolean): Promise<void>;
-    protected abstract runRemoveDeps(dependencies: string[]): Promise<void>;
+    }): void;
+    addScripts(scripts: Record<string, string>): void;
+    addPackageResolutions(versions: Record<string, string>): void;
+    protected abstract runInstall(options?: {
+        force?: boolean;
+    }): ExecaChildProcess;
+    protected abstract runAddDeps(dependencies: string[], installAsDevDependencies: boolean, writeOutputToFile?: boolean): ExecaChildProcess;
     protected abstract getResolutions(packageJson: PackageJson, versions: Record<string, string>): Record<string, any>;
     /**
      * Get the latest or all versions of the input package available on npmjs.com
@@ -601,8 +840,9 @@ declare abstract class JsPackageManager {
      */
     protected abstract runGetVersions<T extends boolean>(packageName: string, fetchAllVersions: T): Promise<T extends true ? string[] : string>;
     abstract getRegistryURL(): Promise<string | undefined>;
-    abstract runPackageCommand(command: string, args: string[], cwd?: string, stdio?: string): Promise<string>;
-    abstract runPackageCommandSync(command: string, args: string[], cwd?: string, stdio?: 'inherit' | 'pipe'): string;
+    abstract runInternalCommand(command: string, args: string[], cwd?: string, stdio?: 'inherit' | 'pipe' | 'ignore'): ExecaChildProcess;
+    abstract runPackageCommand(command: string, args: string[], cwd?: string, stdio?: 'inherit' | 'pipe' | 'ignore'): ExecaChildProcess;
+    abstract runPackageCommandSync(command: string, args: string[], cwd?: string, stdio?: 'inherit' | 'pipe' | 'ignore'): string;
     abstract findInstallations(pattern?: string[]): Promise<InstallationMetadata | undefined>;
     abstract findInstallations(pattern?: string[], options?: {
         depth: number;
@@ -614,19 +854,55 @@ declare abstract class JsPackageManager {
         cwd?: string;
         ignoreError?: boolean;
     }): string;
-    /** Returns the installed (within node_modules or pnp zip) version of a specified package */
-    getInstalledVersion(packageName: string): Promise<string | null>;
+    /**
+     * Execute a command asynchronously and return the execa process. This allows you to hook into
+     * stdout/stderr streams and monitor the process.
+     *
+     * @example Const process = packageManager.executeCommand({ command: 'npm', args: ['install'] });
+     * process.stdout?.on('data', (data) => console.log(data.toString())); const result = await
+     * process;
+     */
     executeCommand({ command, args, stdio, cwd, ignoreError, env, ...execaOptions }: CommonOptions<'utf8'> & {
         command: string;
         args: string[];
         cwd?: string;
         ignoreError?: boolean;
-    }): Promise<string>;
+    }): ExecaChildProcess;
+    /** Returns the installed (within node_modules or pnp zip) version of a specified package */
+    getInstalledVersion(packageName: string): Promise<string | null>;
+    isPackageInstalled(packageName: string): Promise<boolean>;
+    /**
+     * Searches for a dependency/devDependency in all package.json files and returns the version of
+     * the dependency.
+     */
+    getDependencyVersion(dependency: string): string | null;
+    static hasStorybookDependency(packageJsonPath: string): boolean;
+    static hasAnyStorybookDependency(packageJsonPath: string): boolean;
+    /** List all package.json files starting from the given directory and stopping at the project root. */
+    static listAllPackageJsonPaths(instanceDir: string, storiesPaths?: string[]): string[];
+    static getPackageJsonInfo(packageJsonPath: string): PackageJsonInfo;
 }
 
 declare class JsPackageManagerFactory {
-    static getPackageManager({ force }?: {
+    /** Cache for package manager instances */
+    private static cache;
+    /** Generate a cache key based on the parameters */
+    private static getCacheKey;
+    /** Clear the package manager cache */
+    static clearCache(): void;
+    /**
+     * Determine which package manager type to use based on lockfiles, commands, and environment
+     *
+     * @param cwd - Current working directory
+     * @returns Package manager type as string: 'npm', 'pnpm', 'bun', 'yarn1', or 'yarn2'
+     * @throws Error if no usable package manager is found
+     */
+    static getPackageManagerType(cwd?: string): PackageManagerName;
+    static getPackageManager({ force, configDir, storiesPaths, ignoreCache, }?: {
         force?: PackageManagerName;
+        configDir?: string;
+        storiesPaths?: string[];
+        ignoreCache?: boolean;
     }, cwd?: string): JsPackageManager;
     /** Look up map of package manager proxies by name */
     private static PROXY_MAP;
@@ -788,13 +1064,13 @@ declare const rendererPackages: Record<string, string>;
 declare const frameworkPackages: Record<string, SupportedFrameworks>;
 declare const builderPackages: string[];
 declare const findConfigFile: (prefix: string, configDir: string) => string | null;
-declare const getConfigInfo: (packageJson: PackageJson, configDir?: string) => {
+declare const getConfigInfo: (configDir?: string) => {
     configDir: string;
-    mainConfig: string | null;
-    previewConfig: string | null;
-    managerConfig: string | null;
+    mainConfigPath: string | null;
+    previewConfigPath: string | null;
+    managerConfigPath: string | null;
 };
-declare const getStorybookInfo: (packageJson: PackageJson, configDir?: string) => CoreCommon_StorybookInfo;
+declare const getStorybookInfo: (configDir?: string) => CoreCommon_StorybookInfo;
 
 declare const getAutoRefs: (options: Options$1) => Promise<Record<string, Ref>>;
 declare function getRefs(options: Options$1): Promise<Record<string, Ref>>;
@@ -832,9 +1108,10 @@ declare function loadCustomPresets({ configDir }: {
     configDir: string;
 }): PresetConfig[];
 
-declare function loadMainConfig({ configDir, noCache, }: {
+declare function loadMainConfig({ configDir, noCache, cwd, }: {
     configDir: string;
     noCache?: boolean;
+    cwd?: string;
 }): Promise<StorybookConfig>;
 
 declare function loadManagerOrAddonsFile({ configDir }: {
@@ -865,12 +1142,18 @@ interface NormalizeOptions {
 declare const normalizeStories: (entries: StoriesEntry[], options: NormalizeOptions) => NormalizedStoriesSpecifier[];
 
 declare const getProjectRoot: () => string;
+declare const invalidateProjectRootCache: () => void;
 declare const nodePathsToArray: (nodePath: string) => string[];
 /** Ensures that a path starts with `./` or `../`, or is entirely `.` or `..` */
 declare function normalizeStoryPath(filename: string): string;
 
 declare function readTemplate(filename: string): Promise<string>;
 
+type RemoveAddonOptions = {
+    packageManager: JsPackageManager;
+    configDir?: string;
+    skipInstall?: boolean;
+};
 /**
  * Remove the given addon package and remove it from main.js
  *
@@ -880,11 +1163,7 @@ declare function readTemplate(filename: string): Promise<string>;
  * sb remove @storybook/addon-links
  * ```
  */
-declare function removeAddon(addon: string, options?: {
-    packageManager?: PackageManagerName;
-    cwd?: string;
-    configDir?: string;
-}): Promise<void>;
+declare function removeAddon(addon: string, options: RemoveAddonOptions): Promise<void>;
 
 /**
  * Get the path of the file or directory with input name inside the Storybook cache directory:
@@ -904,7 +1183,7 @@ declare function getPreviewHeadTemplate(configDirPath: string, interpolations?:
 
 declare function validateFrameworkName(frameworkName: string | undefined): asserts frameworkName is string;
 
-declare function validateConfigurationFiles(configDir: string): Promise<void>;
+declare function validateConfigurationFiles(configDir: string, cwd?: string): Promise<void>;
 
 /** Mimicking the satisfies operator until we can upgrade to TS4.9 */
 declare function satisfies<A>(): <T extends A>(x: T) => T;
@@ -940,8 +1219,8 @@ declare const posix: (localPath: string, seperator?: string) => string;
 
 declare const getAddonNames: (mainConfig: StorybookConfig) => string[];
 
-declare function syncStorybookAddons(mainConfig: StorybookConfig, previewConfigPath: string): Promise<void>;
-declare function getSyncedStorybookAddons(mainConfig: StorybookConfig, previewConfig: ConfigFile): Promise<ConfigFile>;
+declare function syncStorybookAddons(mainConfig: StorybookConfig, previewConfigPath: string, configDir: string): Promise<void>;
+declare function getSyncedStorybookAddons(mainConfig: StorybookConfig, previewConfig: ConfigFile, configDir: string): Promise<ConfigFile>;
 
 /**
  * Helper function to scan for files matching a glob pattern and transform them
@@ -970,4 +1249,4 @@ declare const transformImportFiles: (files: string[], renamedImports: Record<str
     error: Error;
 }[]>;
 
-export { COMMON_ENV_VARS, DEFAULT_FILES_PATTERN, type FileOptions, FileSystemCache, HandledError, type InstallationMetadata, JsPackageManager, JsPackageManagerFactory, type PackageJsonWithDepsAndDevDeps, type PackageJsonWithMaybeDeps, type PackageManagerName, type PackageMetadata, boost, builderPackages, cache, checkAddonOrder, codeLog, commandLog, commonGlobOptions, createFileSystemCache, createLogStream, extractProperFrameworkName, extractProperRendererNameFromFramework, filterPresetsConfig, findConfigFile, formatFileContent, frameworkPackages, frameworkToRenderer, getAddonNames, getAutoRefs, getBuilderOptions, getChars, getCoercedStorybookVersion, getConfigInfo, getDirectoryFromWorkingDir, getEnvConfig, getFrameworkName, getInterpretedFile, getInterpretedFileWithExt, getPackageDetails, getPresets, getPreviewBodyTemplate, getPreviewHeadTemplate, getProjectRoot, getRefs, getRendererName, getStoryId, getStoryTitle, getStorybookConfiguration, getStorybookInfo, getSyncedStorybookAddons, globToRegexp, interopRequireDefault, interpolate, isCorePackage, isPreservingSymlinks, isSatelliteAddon, loadAllPresets, loadCustomPresets, loadEnvs, loadMainConfig, loadManagerOrAddonsFile, loadPreset, loadPreviewOrConfigFile, logConfig, nodePathsToArray, normalizeStories, normalizeStoriesEntry, normalizeStoryPath, paddedLog, parseList, posix, readTemplate, removeAddon, rendererPackages, resolveAddonName, resolvePathInStorybookCache, satisfies, scanAndTransformFiles, serverRequire, serverResolve, stringifyEnvs, stringifyProcessEnvs, stripAbsNodeModulesPath, syncStorybookAddons, temporaryDirectory, temporaryFile, transformImportFiles, validateConfigurationFiles, validateFrameworkName, _default as versions };
+export { COMMON_ENV_VARS, DEFAULT_FILES_PATTERN, type FileOptions, FileSystemCache, HandledError, type InstallationMetadata, JsPackageManager, JsPackageManagerFactory, type PackageJsonInfo, type PackageJsonWithDepsAndDevDeps, type PackageJsonWithMaybeDeps, type PackageManagerName, type PackageMetadata, type RemoveAddonOptions, boost, builderPackages, cache, checkAddonOrder, codeLog, commandLog, commonGlobOptions, createFileSystemCache, createLogStream, extractProperFrameworkName, extractProperRendererNameFromFramework, filterPresetsConfig, findConfigFile, formatFileContent, frameworkPackages, frameworkToRenderer, getAddonNames, getAutoRefs, getBuilderOptions, getChars, getCoercedStorybookVersion, getConfigInfo, getDirectoryFromWorkingDir, getEnvConfig, getFrameworkName, getInterpretedFile, getInterpretedFileWithExt, getPackageDetails, getPresets, getPreviewBodyTemplate, getPreviewHeadTemplate, getProjectRoot, getRefs, getRendererName, getStoryId, getStoryTitle, getStorybookConfiguration, getStorybookInfo, getSyncedStorybookAddons, globToRegexp, interopRequireDefault, interpolate, invalidateProjectRootCache, isCorePackage, isPreservingSymlinks, isSatelliteAddon, loadAllPresets, loadCustomPresets, loadEnvs, loadMainConfig, loadManagerOrAddonsFile, loadPreset, loadPreviewOrConfigFile, logConfig, nodePathsToArray, normalizeStories, normalizeStoriesEntry, normalizeStoryPath, paddedLog, parseList, posix, readTemplate, removeAddon, rendererPackages, resolveAddonName, resolvePathInStorybookCache, satisfies, scanAndTransformFiles, serverRequire, serverResolve, stringifyEnvs, stringifyProcessEnvs, stripAbsNodeModulesPath, syncStorybookAddons, temporaryDirectory, temporaryFile, transformImportFiles, validateConfigurationFiles, validateFrameworkName, _default as versions };