@aussieljk/forkbook 0.0.0-stage → 0.0.1-2

package/dist/_node-chunks/chunk-U5W53R2J.js

@@ -0,0 +1,1011 @@
+import CJS_COMPAT_NODE_URL_ro17f80mg6k from 'node:url';
+import CJS_COMPAT_NODE_PATH_ro17f80mg6k from 'node:path';
+import CJS_COMPAT_NODE_MODULE_ro17f80mg6k from "node:module";
+
+var __filename = CJS_COMPAT_NODE_URL_ro17f80mg6k.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_ro17f80mg6k.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_ro17f80mg6k.createRequire(import.meta.url);
+
+// ------------------------------------------------------------
+// end of CJS compatibility banner, injected by Forkbook's esbuild configuration
+// ------------------------------------------------------------
+import {
+  require_picocolors
+} from "./chunk-2BUPBPFB.js";
+import {
+  __toESM
+} from "./chunk-CXRU72ET.js";
+
+// src/server-errors.ts
+var import_picocolors = __toESM(require_picocolors(), 1);
+import { dedent } from "ts-dedent";
+
+// src/shared/open-service/errors.ts
+function formatIssuePath(path) {
+  return path?.length ? path.map((segment) => {
+    let key = typeof segment == "object" && segment !== null && "key" in segment ? segment.key : segment;
+    return typeof key == "number" ? `[${key}]` : `.${String(key)}`;
+  }).join("").replace(/^\./, "") : "";
+}
+function formatIssues(issues) {
+  return issues.map((issue) => {
+    let path = formatIssuePath(issue.path);
+    return path === "" ? issue.message : `${path}: ${issue.message}`;
+  }).join(`
+`);
+}
+
+// src/storybook-error.ts
+function parseErrorCode({
+  code,
+  category
+}) {
+  let paddedCode = String(code).padStart(4, "0");
+  return `SB_${category}_${paddedCode}`;
+}
+function appendErrorRef(url) {
+  if (/^(?!.*storybook\.js\.org)|[?&]ref=error\b/.test(url))
+    return url;
+  try {
+    let urlObj = new URL(url);
+    return urlObj.searchParams.set("ref", "error"), urlObj.toString();
+  } catch {
+    return url;
+  }
+}
+var StorybookError = class _StorybookError extends Error {
+  constructor(props) {
+    super(
+      _StorybookError.getFullMessage(props),
+      props.cause === void 0 ? void 0 : { cause: props.cause }
+    );
+    /**
+     * Data associated with the error. Used to provide additional information in the error message or
+     * to be passed to telemetry.
+     */
+    this.data = {};
+    /** Flag used to easily determine if the error originates from Forkbook. */
+    this.fromStorybook = !0;
+    /**
+     * Flag used to determine if the error is handled by us and should therefore not be shown to the
+     * user.
+     */
+    this.isHandledError = !1;
+    /**
+     * A collection of sub errors which relate to a parent error.
+     *
+     * Sub-errors are used to represent multiple related errors that occurred together. When a
+     * StorybookError with sub-errors is sent to telemetry, both the parent error and each sub-error
+     * are sent as separate telemetry events. This allows for better error tracking and debugging.
+     *
+     * @example
+     *
+     * ```ts
+     * const error1 = new SomeError();
+     * const error2 = new AnotherError();
+     * const parentError = new ParentError({
+     *   // ... other props
+     *   subErrors: [error1, error2],
+     * });
+     * ```
+     */
+    this.subErrors = [];
+    this.category = props.category, this.documentation = props.documentation ?? !1, this.code = props.code, this.isHandledError = props.isHandledError ?? !1, this.agentFacing = props.agentFacing ?? !1, this.name = props.name, this.subErrors = props.subErrors ?? [];
+  }
+  get fullErrorCode() {
+    return parseErrorCode({ code: this.code, category: this.category });
+  }
+  /** Overrides the default `Error.name` property in the format: SB_<CATEGORY>_<CODE>. */
+  get name() {
+    let errorName = this._name || this.constructor.name;
+    return `${this.fullErrorCode} (${errorName})`;
+  }
+  set name(name) {
+    this._name = name;
+  }
+  /** Generates the error message along with additional documentation link (if applicable). */
+  static getFullMessage({
+    documentation,
+    code,
+    category,
+    message
+  }) {
+    let page;
+    return documentation === !0 ? page = `https://storybook.js.org/error/${parseErrorCode({ code, category })}?ref=error` : typeof documentation == "string" ? page = appendErrorRef(documentation) : Array.isArray(documentation) && (page = `
+${documentation.map((doc) => `	- ${appendErrorRef(doc)}`).join(`
+`)}`), `${message}${page != null ? `
+
+More info: ${page}
+` : ""}`;
+  }
+};
+
+// src/server-errors.ts
+var Category = /* @__PURE__ */ ((Category2) => (Category2.CLI = "CLI", Category2.CLI_INIT = "CLI_INIT", Category2.CLI_ADD = "CLI_ADD", Category2.CODEMOD = "CODEMOD", Category2.CORE_SERVER = "CORE-SERVER", Category2.CSF_PLUGIN = "CSF-PLUGIN", Category2.CSF_TOOLS = "CSF-TOOLS", Category2.CORE_COMMON = "CORE-COMMON", Category2.NODE_LOGGER = "NODE-LOGGER", Category2.TELEMETRY = "TELEMETRY", Category2.BUILDER_MANAGER = "BUILDER-MANAGER", Category2.BUILDER_VITE = "BUILDER-VITE", Category2.SOURCE_LOADER = "SOURCE-LOADER", Category2.POSTINSTALL = "POSTINSTALL", Category2.DOCS_TOOLS = "DOCS-TOOLS", Category2.FRAMEWORK_NEXTJS = "FRAMEWORK_NEXTJS", Category2.FRAMEWORK_REACT_VITE = "FRAMEWORK_REACT-VITE", Category2))(Category || {}), NxProjectDetectedError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "NxProjectDetectedError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 1,
+      documentation: "https://nx.dev/nx-api/storybook#generating-storybook-configuration",
+      message: dedent`
+        We have detected Nx in your project. Nx has its own Forkbook initializer, so please use it instead.
+        Run "nx g @nx/storybook:configuration <your-project-name>" to add Forkbook to a given Nx app or lib.`
+    });
+  }
+}, MissingFrameworkFieldError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "MissingFrameworkFieldError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 1,
+      documentation: "https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#new-framework-api",
+      message: dedent`
+        Could not find a 'framework' field in Forkbook config.
+        
+        Set it to '@aussieljk/forkbook/react-vite' or '@aussieljk/forkbook/nextjs-vite'.`
+    });
+  }
+}, InvalidFrameworkNameError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "InvalidFrameworkNameError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 2,
+      documentation: "https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#new-framework-api",
+      message: dedent`
+        Invalid value of '${data.frameworkName}' in the 'framework' field of Forkbook config.
+        
+        Set it to '@aussieljk/forkbook/react-vite' or '@aussieljk/forkbook/nextjs-vite'.
+      `
+    });
+    this.data = data;
+  }
+}, CouldNotEvaluateFrameworkError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "CouldNotEvaluateFrameworkError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 3,
+      documentation: "",
+      message: dedent`
+        Could not evaluate the '${data.frameworkName}' package from the 'framework' field of Forkbook config.
+        
+        Are you sure it's a valid package and is installed?`
+    });
+    this.data = data;
+  }
+}, ConflictingStaticDirConfigError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "ConflictingStaticDirConfigError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 1,
+      documentation: "https://storybook.js.org/docs/configure/integration/images-and-assets#serving-static-files-via-storybook-configuration",
+      message: dedent`
+        Forkbook encountered a conflict when trying to serve statics. You have configured both:
+        * Forkbook's option in the config file: 'staticDirs'
+        * Forkbook's (deprecated) CLI flag: '--staticDir' or '-s'
+        
+        Please remove the CLI flag from your storybook script and use only the 'staticDirs' option instead.`
+    });
+  }
+}, InvalidStoriesEntryError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "InvalidStoriesEntryError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 4,
+      documentation: "https://storybook.js.org/docs/faq#can-i-have-a-storybook-with-no-local-stories",
+      message: dedent`
+        Forkbook could not index your stories.
+        Your main configuration does not contain a 'stories' field, or it resolved to an empty array.
+        
+        Please check your main configuration file and make sure it exports a 'stories' field that is not an empty array.`
+    });
+  }
+}, OpenServiceValidationError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceValidationError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 5,
+      message: `Invalid ${data.phase} for ${data.kind} "${data.serviceId}.${data.name}":
+${formatIssues(
+        data.issues
+      )}`
+    });
+    this.data = data;
+  }
+}, OpenServiceDuplicateRegistrationError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceDuplicateRegistrationError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 6,
+      message: `A service with id "${data.serviceId}" is already registered.`
+    });
+    this.data = data;
+  }
+}, OpenServiceMissingServiceError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceMissingServiceError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 7,
+      message: `No registered service with id "${data.serviceId}" exists in this environment.`
+    });
+    this.data = data;
+  }
+}, OpenServiceInternalServiceError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceInternalServiceError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 19,
+      message: `Service "${data.serviceId}" is internal. Pass { internal: true } to getService() only if you intentionally depend on an unstable OSA surface. Internal services may change without notice.`
+    });
+    this.data = data;
+  }
+}, OpenServiceUnimplementedOperationError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceUnimplementedOperationError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 8,
+      message: `${data.kind[0].toUpperCase()}${data.kind.slice(1)} "${data.serviceId}.${data.name}" is not implemented for this environment.`
+    });
+    this.data = data;
+  }
+}, OpenServiceInvalidStaticPathError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceInvalidStaticPathError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 10,
+      message: `Invalid static path "${data.path}" for query "${data.serviceId}.${data.name}": use a relative path with forward slashes and no ".." segments.`
+    });
+    this.data = data;
+  }
+}, OpenServiceAsyncSchemaError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceAsyncSchemaError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 9,
+      message: `Async schema for ${data.kind} "${data.serviceId}.${data.name}" (${data.phase}): query input and output schemas must validate synchronously.`
+    });
+    this.data = data;
+  }
+}, OpenServiceLoadedDrainExceededError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceLoadedDrainExceededError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 11,
+      message: `Query "${data.serviceId}.${data.name}".loaded(...) did not settle after ${data.iterations} drain iterations. Check for handlers that keep discovering new dependencies after every state change.`
+    });
+    this.data = data;
+  }
+}, OpenServiceDocgenMissingComponentError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceDocgenMissingComponentError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 12,
+      message: `No story or attached docs entry was found for component id "${data.id}". The docgen service can only return docs for components that are present in the story index.`
+    });
+    this.data = data;
+  }
+}, OpenServiceMissingChannelError = class extends StorybookError {
+  constructor(data = {}) {
+    super({
+      name: "OpenServiceMissingChannelError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 13,
+      message: data.serviceId ? `Cannot register service "${data.serviceId}": the Forkbook addons channel is not installed in this runtime.` : "The Forkbook addons channel is not installed in this runtime."
+    });
+    this.data = data;
+  }
+}, OpenServiceRemoteCommandDisconnectedError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceRemoteCommandDisconnectedError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 14,
+      message: `Service "${data.serviceId}" was unregistered before a remote command resolved.`
+    });
+    this.data = data;
+  }
+}, OpenServiceRemoteCommandUnhandledError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceRemoteCommandUnhandledError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 15,
+      message: data.delegated ? `The Forkbook this runtime is attached to did not acknowledge remote command "${data.serviceId}.${data.commandName}" in time \u2014 it may be busy or unreachable. Retry; note the command may still have executed on that instance.` : `No runtime acknowledged remote command "${data.serviceId}.${data.commandName}"; its handler is not implemented in any connected runtime.`
+    });
+    this.data = data;
+  }
+}, OpenServiceRemoteCommandConfigDriftError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceRemoteCommandConfigDriftError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 30,
+      message: `The Forkbook this runtime is attached to reported it has no handler for remote command "${data.serviceId}.${data.commandName}". The two processes are running different configurations (for example a feature flag enabled in one but not the other). Restart the attached Forkbook with a configuration matching this process.`
+    });
+    this.data = data;
+  }
+}, OpenServiceAsyncRecipeError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "OpenServiceAsyncRecipeError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 31,
+      message: "setState recipes must be synchronous. A write after an await would change state without authoring a sync entry. Split the command into one setState per synchronous step."
+    });
+  }
+}, OpenServiceCyclicStateError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "OpenServiceCyclicStateError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 32,
+      message: "Service state must be JSON-serializable, but the value is cyclic or nested more than 256 levels deep. Store an id and look the value up in a query instead of a reference."
+    });
+  }
+}, OpenServiceOperationNameCollisionError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceOperationNameCollisionError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 16,
+      message: `Service "${data.serviceId}" cannot register "${data.operationName}" as both a query and a command.`
+    });
+    this.data = data;
+  }
+}, OpenServiceMissingOriginError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceMissingOriginError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 17,
+      message: `Method "${data.toolsetId}.${data.methodName}" requires a Forkbook server origin. Run it against a live Forkbook so the adapter can provide ctx.origin.`
+    });
+    this.data = data;
+  }
+};
+function describeUnknownStoryIds(unknownIds) {
+  let plural = unknownIds.length === 1 ? "ID is" : "IDs are";
+  return `Refusing to publish review: ${unknownIds.length} story ${plural} not backed by a story entry in the live Forkbook index (docs entries cannot be review slots):`;
+}
+var OpenServiceUnknownStoryIdsError = class extends StorybookError {
+  constructor(data) {
+    let list = data.unknownIds.map((id) => `- ${id}`).join(`
+`);
+    super({
+      name: "OpenServiceUnknownStoryIdsError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 18,
+      message: `${describeUnknownStoryIds(data.unknownIds)}
+${list}`
+    });
+    this.data = data;
+  }
+}, OpenServiceTestRunTimeoutError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceTestRunTimeoutError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 21,
+      message: `Timed out after ${data.timeoutMs}ms waiting for addon-vitest response to test run "${data.requestId}". Ensure @aussieljk/forkbook/addon-vitest is installed and responding.`
+    });
+    this.data = data;
+  }
+}, OpenServiceServicesAppliedTwiceError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "OpenServiceServicesAppliedTwiceError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 22,
+      message: dedent`The "services" preset property was applied twice, but should only be applied once.
+        Multiple code paths applying it will cause service and toolset registration to fail.`
+    });
+  }
+}, OpenServiceMissingToolsetError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceMissingToolsetError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 23,
+      message: `No registered toolset with id "${data.toolsetId}" exists in this environment.`
+    });
+    this.data = data;
+  }
+}, OpenServiceDuplicateToolsetError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceDuplicateToolsetError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 24,
+      message: `A toolset with id "${data.toolsetId}" is already registered. Each public toolset must be registered exactly once.`
+    });
+    this.data = data;
+  }
+}, OpenServiceModuleGraphUnavailableError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceModuleGraphUnavailableError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 25,
+      message: data.reason,
+      agentFacing: !0
+    });
+    this.data = data;
+  }
+}, OpenServiceToolsetOutputMismatchError = class extends StorybookError {
+  constructor(data) {
+    let serialized;
+    try {
+      serialized = JSON.stringify(data.issues)?.slice(0, 2e3) ?? String(data.issues);
+    } catch {
+      serialized = `${data.issues.length} issue(s) that could not be serialized`;
+    }
+    super({
+      name: "OpenServiceToolsetOutputMismatchError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 26,
+      message: `Toolset output did not match its published output schema: ${serialized}`
+    });
+    this.data = data;
+  }
+}, OpenServiceInvalidToolsetMethodIdError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceInvalidToolsetMethodIdError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 28,
+      message: `Invalid toolset method id "${data.methodId}". Expected exactly one separator: toolsetId.methodName.`
+    });
+    this.data = data;
+  }
+}, OpenServiceDuplicateToolNameError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "OpenServiceDuplicateToolNameError",
+      category: "CORE-COMMON" /* CORE_COMMON */,
+      code: 29,
+      message: data.transport === "mcp" ? `Derived MCP tool name "${data.derivedName}" collides between "${data.first}" and "${data.second}". Rename one toolset id or method key.` : `Derived CLI method name "${data.derivedName}" collides between "${data.first}" and "${data.second}" in the same toolset. Rename one method key.`
+    });
+    this.data = data;
+  }
+};
+var CriticalPresetLoadError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "CriticalPresetLoadError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 2,
+      documentation: "",
+      message: dedent`
+        Forkbook failed to load the following preset: ${data.presetName}.
+        
+        Please check whether your setup is correct, the Forkbook dependencies (and their peer dependencies) are installed correctly and there are no package version clashes.
+        
+        If you believe this is a bug, please open an issue on Github.
+        
+        ${data.error.stack || data.error.message}`
+    });
+    this.data = data;
+  }
+}, MissingBuilderError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "MissingBuilderError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 3,
+      documentation: "https://github.com/storybookjs/storybook/issues/24071",
+      message: dedent`
+        Forkbook could not find a builder configuration for your project. 
+        Builders normally come from a framework package e.g. '@aussieljk/forkbook/react-vite', or from builder packages e.g. '@aussieljk/forkbook/builder-vite'.
+        
+        - Does your main config file contain a 'framework' field configured correctly?
+        - Is the Forkbook framework package installed correctly?
+        - If you don't use a framework, does your main config contain a 'core.builder' configured correctly?
+        - Are you in a monorepo and perhaps the framework package is hoisted incorrectly?
+        
+        If you believe this is a bug, please describe your issue in detail on Github.`
+    });
+  }
+}, GoogleFontsDownloadError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "GoogleFontsDownloadError",
+      category: "FRAMEWORK_NEXTJS" /* FRAMEWORK_NEXTJS */,
+      code: 1,
+      documentation: "https://storybook.js.org/docs/get-started/frameworks/nextjs#nextjs-font-optimization",
+      message: dedent`
+        Failed to fetch \`${data.fontFamily}\` from Google Fonts with URL: \`${data.url}\``
+    });
+    this.data = data;
+  }
+}, GoogleFontsLoadingError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "GoogleFontsLoadingError",
+      category: "FRAMEWORK_NEXTJS" /* FRAMEWORK_NEXTJS */,
+      code: 2,
+      documentation: "https://storybook.js.org/docs/get-started/frameworks/nextjs#nextjs-font-optimization",
+      message: dedent`
+        An error occurred when trying to load Google Fonts with URL \`${data.url}\`.
+        
+        ${data.error instanceof Error ? data.error.message : ""}`
+    });
+    this.data = data;
+  }
+}, NoMatchingExportError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "NoMatchingExportError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 4,
+      documentation: "",
+      message: dedent`
+        There was an exports mismatch error when trying to build Forkbook.
+        Please check whether the versions of your Forkbook packages match whenever possible, as this might be the cause.
+        
+        Problematic example:
+        { "@aussieljk/forkbook/react": "7.5.3", "@aussieljk/forkbook/react-vite": "7.4.5", "@aussieljk/forkbook": "7.3.0" }
+        
+        Correct example:
+        { "@aussieljk/forkbook/react": "7.5.3", "@aussieljk/forkbook/react-vite": "7.5.3", "@aussieljk/forkbook": "7.5.3" }`
+    });
+    this.data = data;
+  }
+}, MainFileMissingError = class extends StorybookError {
+  constructor(data) {
+    let map = {
+      storybook: {
+        helperMessage: "You can pass a --config-dir flag to tell Forkbook, where your main.js|ts file is located at.",
+        documentation: "https://storybook.js.org/docs/configure?ref=error"
+      },
+      vitest: {
+        helperMessage: "You can pass a configDir plugin option to tell where your main.js|ts file is located at.",
+        // TODO: add proper docs once available
+        documentation: "https://storybook.js.org/docs/configure?ref=error"
+      }
+    }, { documentation, helperMessage } = map[data.source || "storybook"];
+    super({
+      name: "MainFileMissingError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 6,
+      documentation,
+      message: dedent`
+        No configuration files have been found in your configDir: ${import_picocolors.default.yellow(data.location)}.
+        Forkbook needs a "main.js|ts" file, please add it.
+        
+        ${helperMessage}`
+    });
+    this.data = data;
+  }
+}, MainFileEvaluationError = class extends StorybookError {
+  constructor(data) {
+    let errorText = import_picocolors.default.white(
+      (data.error.stack || data.error.message).replaceAll(process.cwd(), "")
+    );
+    super({
+      name: "MainFileEvaluationError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 7,
+      message: dedent`
+        Forkbook couldn't evaluate your ${import_picocolors.default.yellow(data.location)} file.
+        
+        Original error:
+        ${errorText}`
+    });
+    this.data = data;
+  }
+}, StatusTypeIdMismatchError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "StatusTypeIdMismatchError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 16,
+      message: `Status has typeId "${data.status.typeId}" but was added to store with typeId "${data.typeId}". Full status: ${JSON.stringify(
+        data.status,
+        null,
+        2
+      )}`
+    });
+    this.data = data;
+  }
+}, NoFreePortError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "NoFreePortError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      // Note: 17 is taken by OxcParseError in ../oxc-parser/errors.ts
+      code: 18,
+      message: dedent`
+        Unable to find a free port for Forkbook's dev server${data.requestedPort ? ` (requested port: ${data.requestedPort})` : ""}.
+        Your environment appears to block Forkbook from listening on network ports.
+        If you are running Forkbook in a sandboxed or restricted shell, allow binding to localhost ports and try again.`
+    });
+    this.data = data;
+  }
+}, StorybookDevServerDisconnectedError = class extends StorybookError {
+  constructor(data = {}) {
+    super({
+      name: "StorybookDevServerDisconnectedError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 19,
+      message: dedent`
+        Forkbook dev server disconnected${data.code ? ` (close code ${data.code}${data.reason ? `: ${data.reason}` : ""})` : ""}.
+        Any request that was still in flight has been abandoned.
+        Make sure the dev server is still running, then try again.`
+    });
+    this.data = data;
+  }
+}, GenerateNewProjectOnInitError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "GenerateNewProjectOnInitError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 3,
+      documentation: "",
+      message: dedent`
+        There was an error while using ${data.packageManager} to create a new ${data.projectType} project.
+        
+        ${data.error instanceof Error ? data.error.message : ""}`
+    });
+    this.data = data;
+  }
+};
+function createMinimumReleaseAgeHandledErrorMessage(data) {
+  if ("message" in data)
+    return data.message;
+  let followUp = data.minimumReleaseAgeExclusionsConfigName ? `To fix this, either wait for the configured age window to pass and rerun the command, or add the blocked packages to ${data.packageManagerName}'s ${data.minimumReleaseAgeExclusionsConfigName} setting.` : "To fix this, either wait for the configured age window to pass and rerun the command, or rerun Forkbook with an older compatible release.";
+  return dedent`
+    ${data.packageManagerName} blocked package installation because your project uses ${data.minimumReleaseAgeConfigName}.
+    ${data.failedPackage ? `
+Failed package: ${data.failedPackage}
+` : ""}
+    ${followUp}
+  `;
+}
+var MinimumReleaseAgeHandledError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "MinimumReleaseAgeHandledError",
+      category: "CLI" /* CLI */,
+      isHandledError: !0,
+      code: 2,
+      cause: data.cause,
+      message: createMinimumReleaseAgeHandledErrorMessage(data)
+    });
+    this.data = data;
+  }
+}, AddonVitestPostinstallPrerequisiteCheckError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "AddonVitestPostinstallPrerequisiteCheckError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      isHandledError: !0,
+      code: 4,
+      documentation: "",
+      message: "The prerequisite check for the Vitest addon failed."
+    });
+    this.data = data;
+  }
+}, AddonVitestPostinstallWorkspaceUpdateError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "AddonVitestPostinstallWorkspaceUpdateError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      isHandledError: !0,
+      code: 8,
+      documentation: "https://storybook.js.org/docs/writing-tests/integrations/vitest-addon#manual-setup-advanced",
+      message: dedent`
+        Could not update existing Vitest workspace file: ${data.filePath}
+        Please refer to the documentation to complete the setup manually.
+      `
+    });
+    this.data = data;
+  }
+}, AddonVitestPostinstallConfigUpdateError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "AddonVitestPostinstallConfigUpdateError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      isHandledError: !0,
+      code: 9,
+      documentation: "https://storybook.js.org/docs/writing-tests/integrations/vitest-addon#manual-setup-advanced",
+      message: dedent`
+        Unable to update existing Vitest config file: ${data.filePath}
+        Please refer to the documentation to complete the setup manually.
+      `
+    });
+    this.data = data;
+  }
+}, AddonVitestPostinstallError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "AddonVitestPostinstallError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      isHandledError: !0,
+      code: 5,
+      message: "The Vitest addon setup failed.",
+      subErrors: data.errors
+    });
+    this.data = data;
+  }
+}, NoStatsForViteDevError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "NoStatsForViteDevError",
+      category: "BUILDER-VITE" /* BUILDER_VITE */,
+      code: 1,
+      message: dedent`
+        Unable to write preview stats as the Vite builder does not support stats in dev mode.
+        
+        Please remove the \`--stats-json\` flag when running in dev mode.`
+    });
+  }
+}, ViteModuleGraphSubscriptionError = class extends StorybookError {
+  constructor() {
+    super({
+      name: "ViteModuleGraphSubscriptionError",
+      category: "BUILDER-VITE" /* BUILDER_VITE */,
+      code: 2,
+      message: "Vite module graph listeners must be registered before the builder starts."
+    });
+  }
+}, FindPackageVersionsError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "FindPackageVersionsError",
+      category: "CLI" /* CLI */,
+      code: 1,
+      message: dedent`
+        Unable to find versions of "${data.packageName}" using ${data.packageManager}
+        ${data.error && `Reason: ${data.error}`}`
+    });
+    this.data = data;
+  }
+}, IncompatiblePostCssConfigError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "IncompatiblePostCssConfigError",
+      category: "FRAMEWORK_NEXTJS" /* FRAMEWORK_NEXTJS */,
+      code: 3,
+      message: dedent`
+        Incompatible PostCSS configuration format detected.
+
+        Next.js uses an array-based format for plugins which is not compatible with Vite:
+        
+        // ❌ Incompatible format (used by Next.js)
+        const config = {
+          plugins: ["@tailwindcss/postcss"],
+        };
+        
+        Please transform your PostCSS config to use the object-based format, which is compatible with Next.js and Vite:
+        
+        // ✅ Compatible format (works with Next.js and Vite)
+        const config = {
+          plugins: {
+            "@tailwindcss/postcss": {},
+          },
+        };
+        
+        Original error: ${data.error.message}
+      `
+    });
+    this.data = data;
+  }
+}, SavingGlobalSettingsFileError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "SavingGlobalSettingsFileError",
+      category: "CORE-SERVER" /* CORE_SERVER */,
+      code: 1,
+      message: dedent`
+        Unable to save global settings file to ${data.filePath}
+        ${data.error && `Reason: ${data.error}`}`
+    });
+    this.data = data;
+  }
+};
+function formatExecaCommand(data) {
+  return [data.command, ...data.args].join(" ");
+}
+function formatExecaFailureDetails(data) {
+  let trimmedLogs = data.logs.trim();
+  return trimmedLogs || (data.exitCode != null ? `Process exited with code ${data.exitCode}` : data.signal ? `Process was killed with signal ${data.signal}` : "No additional output was captured.");
+}
+function createExecaCommandFailedMessage(data) {
+  return dedent`
+    Command failed: ${formatExecaCommand(data)}
+
+    ${formatExecaFailureDetails(data)}`;
+}
+var ExecaCommandFailedError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "ExecaCommandFailedError",
+      category: "CLI" /* CLI */,
+      code: 3,
+      cause: data.cause,
+      message: createExecaCommandFailedMessage(data)
+    });
+    this.data = data;
+  }
+}, PackageInstallFailedError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PackageInstallFailedError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 10,
+      cause: data.cause,
+      message: dedent`
+        Failed to install dependencies using ${data.command}.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+}, PackageInstallDependencyConflictError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PackageInstallDependencyConflictError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 11,
+      cause: data.cause,
+      message: dedent`
+        Dependency installation failed because of a version conflict.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+}, PackageInstallMissingManifestError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PackageInstallMissingManifestError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 12,
+      cause: data.cause,
+      message: dedent`
+        Dependency installation failed because no package.json was found in the current directory.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+}, PnpmIgnoredBuildsError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PnpmIgnoredBuildsError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 13,
+      cause: data.cause,
+      message: dedent`
+        pnpm blocked postinstall scripts for one or more packages.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+}, PnpmNoTtyModulesDirError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PnpmNoTtyModulesDirError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 14,
+      cause: data.cause,
+      message: dedent`
+        pnpm aborted while removing the modules directory because no TTY was available.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+}, PackageManagerBinaryNotFoundError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PackageManagerBinaryNotFoundError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 15,
+      cause: data.cause,
+      message: dedent`
+        Forkbook could not find the "${data.command}" command on your PATH.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+}, PlaywrightInstallFailedError = class extends StorybookError {
+  constructor(data) {
+    super({
+      name: "PlaywrightInstallFailedError",
+      category: "CLI_INIT" /* CLI_INIT */,
+      code: 16,
+      cause: data.cause,
+      message: dedent`
+        Failed to install Playwright browser binaries.
+
+        ${formatExecaFailureDetails(data)}`
+    });
+    this.data = data;
+  }
+};
+
+export {
+  formatIssues,
+  StorybookError,
+  Category,
+  NxProjectDetectedError,
+  MissingFrameworkFieldError,
+  InvalidFrameworkNameError,
+  CouldNotEvaluateFrameworkError,
+  ConflictingStaticDirConfigError,
+  InvalidStoriesEntryError,
+  OpenServiceValidationError,
+  OpenServiceDuplicateRegistrationError,
+  OpenServiceMissingServiceError,
+  OpenServiceInternalServiceError,
+  OpenServiceUnimplementedOperationError,
+  OpenServiceInvalidStaticPathError,
+  OpenServiceAsyncSchemaError,
+  OpenServiceLoadedDrainExceededError,
+  OpenServiceDocgenMissingComponentError,
+  OpenServiceMissingChannelError,
+  OpenServiceRemoteCommandDisconnectedError,
+  OpenServiceRemoteCommandUnhandledError,
+  OpenServiceRemoteCommandConfigDriftError,
+  OpenServiceAsyncRecipeError,
+  OpenServiceCyclicStateError,
+  OpenServiceOperationNameCollisionError,
+  OpenServiceMissingOriginError,
+  describeUnknownStoryIds,
+  OpenServiceUnknownStoryIdsError,
+  OpenServiceTestRunTimeoutError,
+  OpenServiceServicesAppliedTwiceError,
+  OpenServiceMissingToolsetError,
+  OpenServiceDuplicateToolsetError,
+  OpenServiceModuleGraphUnavailableError,
+  OpenServiceToolsetOutputMismatchError,
+  OpenServiceInvalidToolsetMethodIdError,
+  OpenServiceDuplicateToolNameError,
+  CriticalPresetLoadError,
+  MissingBuilderError,
+  GoogleFontsDownloadError,
+  GoogleFontsLoadingError,
+  NoMatchingExportError,
+  MainFileMissingError,
+  MainFileEvaluationError,
+  StatusTypeIdMismatchError,
+  NoFreePortError,
+  StorybookDevServerDisconnectedError,
+  GenerateNewProjectOnInitError,
+  MinimumReleaseAgeHandledError,
+  AddonVitestPostinstallPrerequisiteCheckError,
+  AddonVitestPostinstallWorkspaceUpdateError,
+  AddonVitestPostinstallConfigUpdateError,
+  AddonVitestPostinstallError,
+  NoStatsForViteDevError,
+  ViteModuleGraphSubscriptionError,
+  FindPackageVersionsError,
+  IncompatiblePostCssConfigError,
+  SavingGlobalSettingsFileError,
+  formatExecaCommand,
+  formatExecaFailureDetails,
+  ExecaCommandFailedError,
+  PackageInstallFailedError,
+  PackageInstallDependencyConflictError,
+  PackageInstallMissingManifestError,
+  PnpmIgnoredBuildsError,
+  PnpmNoTtyModulesDirError,
+  PackageManagerBinaryNotFoundError,
+  PlaywrightInstallFailedError
+};