rspress-plugin-api-extractor 0.1.2 → 0.2.0

package/index.d.ts

@@ -1,831 +1,901 @@
-import { ApiItemKind } from '@microsoft/api-extractor-model';
-import type { ApiModel } from '@microsoft/api-extractor-model';
-import { RspressPlugin } from '@rspress/shared';
-import { Schema } from 'effect';
-
-/**
- * RSPress plugin for generating API documentation from API Extractor model
- * files. Config helpers are available under `ApiExtractorPlugin.api`.
- */
-export declare const ApiExtractorPlugin: typeof ApiExtractorPluginImpl & {
-    api: {
-        fromFolder: typeof fromFolder;
-        fromModelsDir: typeof fromModelsDir;
-    };
-};
-
-/**
- * RSPress plugin for generating API documentation from API Extractor model files
- */
-declare function ApiExtractorPluginImpl(rawOptions: ApiExtractorPluginOptions): RspressPlugin;
-
-export declare const ApiExtractorPluginOptions: Schema.mutable<Schema.Struct<{
-    api: Schema.optional<Schema.mutable<Schema.Struct<{
-        packageName: typeof Schema.String;
-        name: Schema.optional<typeof Schema.String>;
-        baseRoute: Schema.optional<typeof Schema.String>;
-        apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
-        model: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        versions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>, Schema.mutable<Schema.Struct<{
-            model: Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>;
-            packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-            categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-                displayName: typeof Schema.String;
-                singularName: typeof Schema.String;
-                folderName: typeof Schema.String;
-                itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-                tsdocModifier: Schema.optional<typeof Schema.String>;
-                collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-                    default: () => number[];
-                }>;
-            }>>>>>;
-            source: Schema.optional<Schema.mutable<Schema.Struct<{
-                url: typeof Schema.String;
-                ref: Schema.optional<typeof Schema.String>;
-            }>>>;
-            externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-                name: typeof Schema.String;
-                version: typeof Schema.String;
-                tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-                compilerOptions: Schema.optional<typeof Schema.Unknown>;
-            }>>>>>;
-            autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-                dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => false;
-                }>;
-                devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => false;
-                }>;
-                peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-            }>>>;
-            ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-                url: typeof Schema.String;
-                secureUrl: Schema.optional<typeof Schema.String>;
-                type: Schema.optional<typeof Schema.String>;
-                width: Schema.optional<typeof Schema.Number>;
-                height: Schema.optional<typeof Schema.Number>;
-                alt: Schema.optional<typeof Schema.String>;
-            }>>]>>;
-            llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-                enabled: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                scopes: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-                    default: () => true;
-                }>;
-                copyButtonText: Schema.optionalWith<typeof Schema.String, {
-                    default: () => string;
-                }>;
-                viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-                    default: () => ["markdownLink", "chatgpt", "claude"];
-                }>;
-            }>>>;
-            tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-            compilerOptions: Schema.optional<typeof Schema.Unknown>;
-        }>>]>>>>;
-        theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-            light: typeof Schema.String;
-            dark: typeof Schema.String;
-        }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
-        categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-            displayName: typeof Schema.String;
-            singularName: typeof Schema.String;
-            folderName: typeof Schema.String;
-            itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-            tsdocModifier: Schema.optional<typeof Schema.String>;
-            collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-                default: () => number[];
-            }>;
-        }>>>>>;
-        source: Schema.optional<Schema.mutable<Schema.Struct<{
-            url: typeof Schema.String;
-            ref: Schema.optional<typeof Schema.String>;
-        }>>>;
-        externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-            name: typeof Schema.String;
-            version: typeof Schema.String;
-            tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-            compilerOptions: Schema.optional<typeof Schema.Unknown>;
-        }>>>>>;
-        autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-            dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => false;
-            }>;
-            devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => false;
-            }>;
-            peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-        }>>>;
-        ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-            url: typeof Schema.String;
-            secureUrl: Schema.optional<typeof Schema.String>;
-            type: Schema.optional<typeof Schema.String>;
-            width: Schema.optional<typeof Schema.Number>;
-            height: Schema.optional<typeof Schema.Number>;
-            alt: Schema.optional<typeof Schema.String>;
-        }>>]>>;
-        llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-            enabled: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            scopes: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            copyButtonText: Schema.optionalWith<typeof Schema.String, {
-                default: () => string;
-            }>;
-            viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-                default: () => ["markdownLink", "chatgpt", "claude"];
-            }>;
-        }>>>;
-        tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        compilerOptions: Schema.optional<typeof Schema.Unknown>;
-    }>>>;
-    apis: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-        packageName: typeof Schema.String;
-        name: Schema.optional<typeof Schema.String>;
-        baseRoute: Schema.optional<typeof Schema.String>;
-        apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
-        model: Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>;
-        packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-            light: typeof Schema.String;
-            dark: typeof Schema.String;
-        }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
-        categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-            displayName: typeof Schema.String;
-            singularName: typeof Schema.String;
-            folderName: typeof Schema.String;
-            itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-            tsdocModifier: Schema.optional<typeof Schema.String>;
-            collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-                default: () => number[];
-            }>;
-        }>>>>>;
-        source: Schema.optional<Schema.mutable<Schema.Struct<{
-            url: typeof Schema.String;
-            ref: Schema.optional<typeof Schema.String>;
-        }>>>;
-        externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-            name: typeof Schema.String;
-            version: typeof Schema.String;
-            tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-            compilerOptions: Schema.optional<typeof Schema.Unknown>;
-        }>>>>>;
-        autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-            dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => false;
-            }>;
-            devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => false;
-            }>;
-            peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-        }>>>;
-        ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-            url: typeof Schema.String;
-            secureUrl: Schema.optional<typeof Schema.String>;
-            type: Schema.optional<typeof Schema.String>;
-            width: Schema.optional<typeof Schema.Number>;
-            height: Schema.optional<typeof Schema.Number>;
-            alt: Schema.optional<typeof Schema.String>;
-        }>>]>>;
-        llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-            enabled: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            scopes: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            copyButtonText: Schema.optionalWith<typeof Schema.String, {
-                default: () => string;
-            }>;
-            viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-                default: () => ["markdownLink", "chatgpt", "claude"];
-            }>;
-        }>>>;
-        tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        compilerOptions: Schema.optional<typeof Schema.Unknown>;
-    }>>>>>;
-    siteUrl: Schema.optional<typeof Schema.String>;
-    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        secureUrl: Schema.optional<typeof Schema.String>;
-        type: Schema.optional<typeof Schema.String>;
-        width: Schema.optional<typeof Schema.Number>;
-        height: Schema.optional<typeof Schema.Number>;
-        alt: Schema.optional<typeof Schema.String>;
-    }>>]>>;
-    defaultCategories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-        displayName: typeof Schema.String;
-        singularName: typeof Schema.String;
-        folderName: typeof Schema.String;
-        itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-        tsdocModifier: Schema.optional<typeof Schema.String>;
-        collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-            default: () => number[];
-        }>;
-    }>>>>>;
-    errors: Schema.optional<Schema.mutable<Schema.Struct<{
-        example: Schema.optional<Schema.Literal<["suppress", "show"]>>;
-    }>>>;
-    llmsPlugin: Schema.optional<Schema.Union<[typeof Schema.Boolean, Schema.mutable<Schema.Struct<{
-        enabled: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        scopes: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        copyButtonText: Schema.optionalWith<typeof Schema.String, {
-            default: () => string;
-        }>;
-        viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-            default: () => ["markdownLink", "chatgpt", "claude"];
-        }>;
-    }>>]>>;
-    logLevel: Schema.optional<Schema.Literal<["none", "info", "verbose", "debug", "warn", "error"]>>;
-    performance: Schema.optional<Schema.mutable<Schema.Struct<{
-        thresholds: Schema.optional<Schema.mutable<Schema.Struct<{
-            slowCodeBlock: Schema.optionalWith<typeof Schema.Number, {
-                default: () => number;
-            }>;
-            slowPageGeneration: Schema.optionalWith<typeof Schema.Number, {
-                default: () => number;
-            }>;
-            slowApiLoad: Schema.optionalWith<typeof Schema.Number, {
-                default: () => number;
-            }>;
-            slowFileOperation: Schema.optionalWith<typeof Schema.Number, {
-                default: () => number;
-            }>;
-            slowHttpRequest: Schema.optionalWith<typeof Schema.Number, {
-                default: () => number;
-            }>;
-            slowDbOperation: Schema.optionalWith<typeof Schema.Number, {
-                default: () => number;
-            }>;
-        }>>>;
-        showInsights: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        trackDetailedMetrics: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-    }>>>;
-}>>;
-
-export declare type ApiExtractorPluginOptions = Schema.Schema.Type<typeof ApiExtractorPluginOptions>;
-
-/**
- * How to derive each API's `baseRoute`. One of:
- *
- * - omitted — defaults to the template `"{dirname}"`
- * - a template string — supports the `{dirname}` and `{packageName}` tokens,
- *   e.g. `"reference/{dirname}"`. A leading slash is normalized in.
- * - a callback — `(info) => string` for full control.
- *
- * Note: the `{packageName}` token is interpolated verbatim, so for a scoped
- * package it yields the scope too (e.g. `@scope/bar`), which is rarely what you
- * want inside a URL path. Prefer `{dirname}` (the folder name, which is the
- * unscoped name in the rslib-builder layout) or the callback form.
- */
-export declare type BaseRoute = string | ((info: FolderInfo) => string);
-
-export declare const CategoryConfig: Schema.mutable<Schema.Struct<{
-    displayName: typeof Schema.String;
-    singularName: typeof Schema.String;
-    folderName: typeof Schema.String;
-    itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-    tsdocModifier: Schema.optional<typeof Schema.String>;
-    collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => true;
-    }>;
-    collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => true;
-    }>;
-    overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-        default: () => number[];
-    }>;
-}>>;
-
-/**
- * Consumer-facing type uses Encoded (input shape with optional fields).
- * Schema.decode fills in defaults at runtime.
- */
-export declare type CategoryConfig = Schema.Schema.Encoded<typeof CategoryConfig>;
-
-/**
- * Built-in default categories
- */
-export declare const DEFAULT_CATEGORIES: Record<string, CategoryConfig>;
-
-/** Metadata discovered from a single rslib-builder localPaths package folder. */
-export declare interface FolderInfo {
-    /** Absolute path to the package folder. */
-    dir: string;
-    /** Last path segment of `dir`, e.g. "sdk". */
-    dirname: string;
-    /** package.json "name", e.g. "vitest-agent-sdk" or "\@scope/pkg". */
-    packageName: string;
-    /** package.json "version" (empty string if absent). */
-    version: string;
-    /** Absolute path to the resolved *.api.json model. */
-    modelPath: string;
-}
-
-/**
- * Build a `MultiApiConfig` by discovering fields from a single package folder
- * produced by `@savvy-web/rslib-builder`'s `localPaths` option.
- */
-declare function fromFolder(dir: string, overrides?: FromFolderOptions): MultiApiConfig;
-
-/** Overrides for `fromFolder`. Any MultiApiConfig field wins over discovery. */
-export declare type FromFolderOptions = Omit<Partial<MultiApiConfig>, "baseRoute"> & {
-    baseRoute?: BaseRoute;
-    /** Base for resolving a relative `dir`. Defaults to process.cwd(). */
-    cwd?: string;
-};
-
-/**
- * Strictly scan a parent directory of package folders and build one
- * `MultiApiConfig` per subfolder. Every non-dotfile subdirectory MUST be a
- * valid model folder. `options` (minus `cwd`) is applied as shared defaults.
- */
-declare function fromModelsDir(parentDir: string, options?: FromModelsDirOptions): MultiApiConfig[];
-
-/** Shared defaults for `fromModelsDir`, applied to every discovered entry. */
-export declare type FromModelsDirOptions = FromFolderOptions;
-
-/**
- * Result from a model loader function
- */
-export declare interface LoadedModel {
-    /** The API model */
-    model: ApiModel;
-    /** Optional source config returned by the loader */
-    source?: SourceConfig;
-}
-
-export declare const LogLevel: Schema.Literal<["none", "info", "verbose", "debug", "warn", "error"]>;
-
-export declare type LogLevel = Schema.Schema.Type<typeof LogLevel>;
-
-export declare const MultiApiConfig: Schema.mutable<Schema.Struct<{
-    packageName: typeof Schema.String;
-    name: Schema.optional<typeof Schema.String>;
-    baseRoute: Schema.optional<typeof Schema.String>;
-    apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
-    model: Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>;
-    packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-        light: typeof Schema.String;
-        dark: typeof Schema.String;
-    }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
-    categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-        displayName: typeof Schema.String;
-        singularName: typeof Schema.String;
-        folderName: typeof Schema.String;
-        itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-        tsdocModifier: Schema.optional<typeof Schema.String>;
-        collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-            default: () => number[];
-        }>;
-    }>>>>>;
-    source: Schema.optional<Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        ref: Schema.optional<typeof Schema.String>;
-    }>>>;
-    externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-        name: typeof Schema.String;
-        version: typeof Schema.String;
-        tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        compilerOptions: Schema.optional<typeof Schema.Unknown>;
-    }>>>>>;
-    autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-        dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-    }>>>;
-    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        secureUrl: Schema.optional<typeof Schema.String>;
-        type: Schema.optional<typeof Schema.String>;
-        width: Schema.optional<typeof Schema.Number>;
-        height: Schema.optional<typeof Schema.Number>;
-        alt: Schema.optional<typeof Schema.String>;
-    }>>]>>;
-    llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-        enabled: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        scopes: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        copyButtonText: Schema.optionalWith<typeof Schema.String, {
-            default: () => string;
-        }>;
-        viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-            default: () => ["markdownLink", "chatgpt", "claude"];
-        }>;
-    }>>>;
-    tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    compilerOptions: Schema.optional<typeof Schema.Unknown>;
-}>>;
-
-export declare type MultiApiConfig = Schema.Schema.Type<typeof MultiApiConfig>;
-
-export declare const OpenGraphImageConfig: Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-    url: typeof Schema.String;
-    secureUrl: Schema.optional<typeof Schema.String>;
-    type: Schema.optional<typeof Schema.String>;
-    width: Schema.optional<typeof Schema.Number>;
-    height: Schema.optional<typeof Schema.Number>;
-    alt: Schema.optional<typeof Schema.String>;
-}>>]>;
-
-export declare type OpenGraphImageConfig = Schema.Schema.Type<typeof OpenGraphImageConfig>;
-
-export declare const OpenGraphImageMetadata: Schema.mutable<Schema.Struct<{
-    url: typeof Schema.String;
-    secureUrl: Schema.optional<typeof Schema.String>;
-    type: Schema.optional<typeof Schema.String>;
-    width: Schema.optional<typeof Schema.Number>;
-    height: Schema.optional<typeof Schema.Number>;
-    alt: Schema.optional<typeof Schema.String>;
-}>>;
-
-export declare type OpenGraphImageMetadata = Schema.Schema.Type<typeof OpenGraphImageMetadata>;
-
-export declare const OpenGraphMetadata: Schema.mutable<Schema.Struct<{
-    siteUrl: typeof Schema.String;
-    pageRoute: typeof Schema.String;
-    description: typeof Schema.String;
-    publishedTime: typeof Schema.String;
-    modifiedTime: typeof Schema.String;
-    section: typeof Schema.String;
-    tags: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-    ogImage: Schema.optional<Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        secureUrl: Schema.optional<typeof Schema.String>;
-        type: Schema.optional<typeof Schema.String>;
-        width: Schema.optional<typeof Schema.Number>;
-        height: Schema.optional<typeof Schema.Number>;
-        alt: Schema.optional<typeof Schema.String>;
-    }>>>;
-    ogType: typeof Schema.String;
-}>>;
-
-export declare type OpenGraphMetadata = Schema.Schema.Type<typeof OpenGraphMetadata>;
-
-export declare const SingleApiConfig: Schema.mutable<Schema.Struct<{
-    packageName: typeof Schema.String;
-    name: Schema.optional<typeof Schema.String>;
-    baseRoute: Schema.optional<typeof Schema.String>;
-    apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
-    model: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    versions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>, Schema.mutable<Schema.Struct<{
-        model: Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>;
-        packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-            displayName: typeof Schema.String;
-            singularName: typeof Schema.String;
-            folderName: typeof Schema.String;
-            itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-            tsdocModifier: Schema.optional<typeof Schema.String>;
-            collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-                default: () => number[];
-            }>;
-        }>>>>>;
-        source: Schema.optional<Schema.mutable<Schema.Struct<{
-            url: typeof Schema.String;
-            ref: Schema.optional<typeof Schema.String>;
-        }>>>;
-        externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-            name: typeof Schema.String;
-            version: typeof Schema.String;
-            tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-            compilerOptions: Schema.optional<typeof Schema.Unknown>;
-        }>>>>>;
-        autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-            dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => false;
-            }>;
-            devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => false;
-            }>;
-            peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-        }>>>;
-        ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-            url: typeof Schema.String;
-            secureUrl: Schema.optional<typeof Schema.String>;
-            type: Schema.optional<typeof Schema.String>;
-            width: Schema.optional<typeof Schema.Number>;
-            height: Schema.optional<typeof Schema.Number>;
-            alt: Schema.optional<typeof Schema.String>;
-        }>>]>>;
-        llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-            enabled: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            scopes: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-                default: () => true;
-            }>;
-            copyButtonText: Schema.optionalWith<typeof Schema.String, {
-                default: () => string;
-            }>;
-            viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-                default: () => ["markdownLink", "chatgpt", "claude"];
-            }>;
-        }>>>;
-        tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        compilerOptions: Schema.optional<typeof Schema.Unknown>;
-    }>>]>>>>;
-    theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-        light: typeof Schema.String;
-        dark: typeof Schema.String;
-    }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
-    categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-        displayName: typeof Schema.String;
-        singularName: typeof Schema.String;
-        folderName: typeof Schema.String;
-        itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-        tsdocModifier: Schema.optional<typeof Schema.String>;
-        collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-            default: () => number[];
-        }>;
-    }>>>>>;
-    source: Schema.optional<Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        ref: Schema.optional<typeof Schema.String>;
-    }>>>;
-    externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-        name: typeof Schema.String;
-        version: typeof Schema.String;
-        tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        compilerOptions: Schema.optional<typeof Schema.Unknown>;
-    }>>>>>;
-    autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-        dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-    }>>>;
-    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        secureUrl: Schema.optional<typeof Schema.String>;
-        type: Schema.optional<typeof Schema.String>;
-        width: Schema.optional<typeof Schema.Number>;
-        height: Schema.optional<typeof Schema.Number>;
-        alt: Schema.optional<typeof Schema.String>;
-    }>>]>>;
-    llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-        enabled: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        scopes: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        copyButtonText: Schema.optionalWith<typeof Schema.String, {
-            default: () => string;
-        }>;
-        viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-            default: () => ["markdownLink", "chatgpt", "claude"];
-        }>;
-    }>>>;
-    tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    compilerOptions: Schema.optional<typeof Schema.Unknown>;
-}>>;
-
-export declare type SingleApiConfig = Schema.Schema.Type<typeof SingleApiConfig>;
-
-export declare const SourceConfig: Schema.mutable<Schema.Struct<{
-    url: typeof Schema.String;
-    ref: Schema.optional<typeof Schema.String>;
-}>>;
-
-export declare type SourceConfig = Schema.Schema.Type<typeof SourceConfig>;
-
-export declare const VersionConfig: Schema.mutable<Schema.Struct<{
-    model: Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>;
-    packageJson: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
-        displayName: typeof Schema.String;
-        singularName: typeof Schema.String;
-        folderName: typeof Schema.String;
-        itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
-        tsdocModifier: Schema.optional<typeof Schema.String>;
-        collapsible: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        collapsed: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
-            default: () => number[];
-        }>;
-    }>>>>>;
-    source: Schema.optional<Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        ref: Schema.optional<typeof Schema.String>;
-    }>>>;
-    externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-        name: typeof Schema.String;
-        version: typeof Schema.String;
-        tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-        compilerOptions: Schema.optional<typeof Schema.Unknown>;
-    }>>>>>;
-    autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
-        dependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-    }>>>;
-    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
-        url: typeof Schema.String;
-        secureUrl: Schema.optional<typeof Schema.String>;
-        type: Schema.optional<typeof Schema.String>;
-        width: Schema.optional<typeof Schema.Number>;
-        height: Schema.optional<typeof Schema.Number>;
-        alt: Schema.optional<typeof Schema.String>;
-    }>>]>>;
-    llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
-        enabled: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        scopes: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        copyButtonText: Schema.optionalWith<typeof Schema.String, {
-            default: () => string;
-        }>;
-        viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
-            default: () => ["markdownLink", "chatgpt", "claude"];
-        }>;
-    }>>>;
-    tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown), readonly [], never>>;
-    compilerOptions: Schema.optional<typeof Schema.Unknown>;
-}>>;
-
-export declare type VersionConfig = Schema.Schema.Type<typeof VersionConfig>;
-
-export { }
+import { ApiItemKind, ApiModel } from "@microsoft/api-extractor-model";
+import { Schema } from "effect";
+import { RspressPlugin } from "@rspress/core";
+
+//#region src/schemas/config.d.ts
+declare const LogLevel: Schema.Literal<["none", "info", "verbose", "debug", "warn", "error"]>;
+type LogLevel = Schema.Schema.Type<typeof LogLevel>;
+declare const CategoryConfig: Schema.mutable<Schema.Struct<{
+  displayName: typeof Schema.String;
+  singularName: typeof Schema.String;
+  folderName: typeof Schema.String;
+  itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+  tsdocModifier: Schema.optional<typeof Schema.String>;
+  collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => true;
+  }>;
+  collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => true;
+  }>;
+  overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+    default: () => number[];
+  }>;
+}>>;
+/**
+ * Consumer-facing type uses Encoded (input shape with optional fields).
+ * Schema.decode fills in defaults at runtime.
+ */
+type CategoryConfig = Schema.Schema.Encoded<typeof CategoryConfig>;
+declare const SourceConfig: Schema.mutable<Schema.Struct<{
+  url: typeof Schema.String;
+  ref: Schema.optional<typeof Schema.String>;
+}>>;
+type SourceConfig = Schema.Schema.Type<typeof SourceConfig>;
+/**
+ * Built-in default categories
+ */
+declare const DEFAULT_CATEGORIES: Record<string, CategoryConfig>;
+declare const VersionConfig: Schema.mutable<Schema.Struct<{
+  model: Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>;
+  packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+    displayName: typeof Schema.String;
+    singularName: typeof Schema.String;
+    folderName: typeof Schema.String;
+    itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+    tsdocModifier: Schema.optional<typeof Schema.String>;
+    collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+      default: () => number[];
+    }>;
+  }>>>>>;
+  source: Schema.optional<Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+  }>>>;
+  externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+    name: typeof Schema.String;
+    version: typeof Schema.String;
+    tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    compilerOptions: Schema.optional<typeof Schema.Unknown>;
+  }>>>>>;
+  autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+    dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+    devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+    peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+  }>>>;
+  ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    secureUrl: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<typeof Schema.String>;
+    width: Schema.optional<typeof Schema.Number>;
+    height: Schema.optional<typeof Schema.Number>;
+    alt: Schema.optional<typeof Schema.String>;
+  }>>]>>;
+  llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+    enabled: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    scopes: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    copyButtonText: Schema.optionalWith<typeof Schema.String, {
+      default: () => string;
+    }>;
+    viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+      default: () => ["markdownLink", "chatgpt", "claude"];
+    }>;
+  }>>>;
+  tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  compilerOptions: Schema.optional<typeof Schema.Unknown>;
+}>>;
+type VersionConfig = Schema.Schema.Type<typeof VersionConfig>;
+declare const SingleApiConfig: Schema.mutable<Schema.Struct<{
+  packageName: typeof Schema.String;
+  name: Schema.optional<typeof Schema.String>;
+  baseRoute: Schema.optional<typeof Schema.String>;
+  apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
+  model: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  versions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>, Schema.mutable<Schema.Struct<{
+    model: Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>;
+    packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+      displayName: typeof Schema.String;
+      singularName: typeof Schema.String;
+      folderName: typeof Schema.String;
+      itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+      tsdocModifier: Schema.optional<typeof Schema.String>;
+      collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+        default: () => number[];
+      }>;
+    }>>>>>;
+    source: Schema.optional<Schema.mutable<Schema.Struct<{
+      url: typeof Schema.String;
+      ref: Schema.optional<typeof Schema.String>;
+    }>>>;
+    externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+      name: typeof Schema.String;
+      version: typeof Schema.String;
+      tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+      compilerOptions: Schema.optional<typeof Schema.Unknown>;
+    }>>>>>;
+    autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+      dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+      }>;
+      devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+      }>;
+      peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+    }>>>;
+    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+      url: typeof Schema.String;
+      secureUrl: Schema.optional<typeof Schema.String>;
+      type: Schema.optional<typeof Schema.String>;
+      width: Schema.optional<typeof Schema.Number>;
+      height: Schema.optional<typeof Schema.Number>;
+      alt: Schema.optional<typeof Schema.String>;
+    }>>]>>;
+    llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+      enabled: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      scopes: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      copyButtonText: Schema.optionalWith<typeof Schema.String, {
+        default: () => string;
+      }>;
+      viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+        default: () => ["markdownLink", "chatgpt", "claude"];
+      }>;
+    }>>>;
+    tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    compilerOptions: Schema.optional<typeof Schema.Unknown>;
+  }>>]>>>>;
+  theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+    light: typeof Schema.String;
+    dark: typeof Schema.String;
+  }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
+  categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+    displayName: typeof Schema.String;
+    singularName: typeof Schema.String;
+    folderName: typeof Schema.String;
+    itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+    tsdocModifier: Schema.optional<typeof Schema.String>;
+    collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+      default: () => number[];
+    }>;
+  }>>>>>;
+  source: Schema.optional<Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+  }>>>;
+  externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+    name: typeof Schema.String;
+    version: typeof Schema.String;
+    tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    compilerOptions: Schema.optional<typeof Schema.Unknown>;
+  }>>>>>;
+  autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+    dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+    devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+    peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+  }>>>;
+  ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    secureUrl: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<typeof Schema.String>;
+    width: Schema.optional<typeof Schema.Number>;
+    height: Schema.optional<typeof Schema.Number>;
+    alt: Schema.optional<typeof Schema.String>;
+  }>>]>>;
+  llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+    enabled: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    scopes: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    copyButtonText: Schema.optionalWith<typeof Schema.String, {
+      default: () => string;
+    }>;
+    viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+      default: () => ["markdownLink", "chatgpt", "claude"];
+    }>;
+  }>>>;
+  tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  compilerOptions: Schema.optional<typeof Schema.Unknown>;
+}>>;
+type SingleApiConfig = Schema.Schema.Type<typeof SingleApiConfig>;
+declare const MultiApiConfig: Schema.mutable<Schema.Struct<{
+  packageName: typeof Schema.String;
+  name: Schema.optional<typeof Schema.String>;
+  baseRoute: Schema.optional<typeof Schema.String>;
+  apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
+  model: Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>;
+  packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+    light: typeof Schema.String;
+    dark: typeof Schema.String;
+  }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
+  categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+    displayName: typeof Schema.String;
+    singularName: typeof Schema.String;
+    folderName: typeof Schema.String;
+    itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+    tsdocModifier: Schema.optional<typeof Schema.String>;
+    collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+      default: () => number[];
+    }>;
+  }>>>>>;
+  source: Schema.optional<Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    ref: Schema.optional<typeof Schema.String>;
+  }>>>;
+  externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+    name: typeof Schema.String;
+    version: typeof Schema.String;
+    tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    compilerOptions: Schema.optional<typeof Schema.Unknown>;
+  }>>>>>;
+  autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+    dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+    devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+    peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+  }>>>;
+  ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    secureUrl: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<typeof Schema.String>;
+    width: Schema.optional<typeof Schema.Number>;
+    height: Schema.optional<typeof Schema.Number>;
+    alt: Schema.optional<typeof Schema.String>;
+  }>>]>>;
+  llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+    enabled: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    scopes: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    copyButtonText: Schema.optionalWith<typeof Schema.String, {
+      default: () => string;
+    }>;
+    viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+      default: () => ["markdownLink", "chatgpt", "claude"];
+    }>;
+  }>>>;
+  tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+  compilerOptions: Schema.optional<typeof Schema.Unknown>;
+}>>;
+type MultiApiConfig = Schema.Schema.Type<typeof MultiApiConfig>;
+declare const PluginOptions: Schema.mutable<Schema.Struct<{
+  api: Schema.optional<Schema.mutable<Schema.Struct<{
+    packageName: typeof Schema.String;
+    name: Schema.optional<typeof Schema.String>;
+    baseRoute: Schema.optional<typeof Schema.String>;
+    apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
+    model: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    versions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>, Schema.mutable<Schema.Struct<{
+      model: Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>;
+      packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+      categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+        displayName: typeof Schema.String;
+        singularName: typeof Schema.String;
+        folderName: typeof Schema.String;
+        itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+        tsdocModifier: Schema.optional<typeof Schema.String>;
+        collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+          default: () => number[];
+        }>;
+      }>>>>>;
+      source: Schema.optional<Schema.mutable<Schema.Struct<{
+        url: typeof Schema.String;
+        ref: Schema.optional<typeof Schema.String>;
+      }>>>;
+      externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+        name: typeof Schema.String;
+        version: typeof Schema.String;
+        tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+        compilerOptions: Schema.optional<typeof Schema.Unknown>;
+      }>>>>>;
+      autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+        dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => false;
+        }>;
+        devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => false;
+        }>;
+        peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+      }>>>;
+      ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+        url: typeof Schema.String;
+        secureUrl: Schema.optional<typeof Schema.String>;
+        type: Schema.optional<typeof Schema.String>;
+        width: Schema.optional<typeof Schema.Number>;
+        height: Schema.optional<typeof Schema.Number>;
+        alt: Schema.optional<typeof Schema.String>;
+      }>>]>>;
+      llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+        enabled: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        scopes: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+          default: () => true;
+        }>;
+        copyButtonText: Schema.optionalWith<typeof Schema.String, {
+          default: () => string;
+        }>;
+        viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+          default: () => ["markdownLink", "chatgpt", "claude"];
+        }>;
+      }>>>;
+      tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+      compilerOptions: Schema.optional<typeof Schema.Unknown>;
+    }>>]>>>>;
+    theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+      light: typeof Schema.String;
+      dark: typeof Schema.String;
+    }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
+    categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+      displayName: typeof Schema.String;
+      singularName: typeof Schema.String;
+      folderName: typeof Schema.String;
+      itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+      tsdocModifier: Schema.optional<typeof Schema.String>;
+      collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+        default: () => number[];
+      }>;
+    }>>>>>;
+    source: Schema.optional<Schema.mutable<Schema.Struct<{
+      url: typeof Schema.String;
+      ref: Schema.optional<typeof Schema.String>;
+    }>>>;
+    externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+      name: typeof Schema.String;
+      version: typeof Schema.String;
+      tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+      compilerOptions: Schema.optional<typeof Schema.Unknown>;
+    }>>>>>;
+    autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+      dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+      }>;
+      devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+      }>;
+      peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+    }>>>;
+    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+      url: typeof Schema.String;
+      secureUrl: Schema.optional<typeof Schema.String>;
+      type: Schema.optional<typeof Schema.String>;
+      width: Schema.optional<typeof Schema.Number>;
+      height: Schema.optional<typeof Schema.Number>;
+      alt: Schema.optional<typeof Schema.String>;
+    }>>]>>;
+    llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+      enabled: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      scopes: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      copyButtonText: Schema.optionalWith<typeof Schema.String, {
+        default: () => string;
+      }>;
+      viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+        default: () => ["markdownLink", "chatgpt", "claude"];
+      }>;
+    }>>>;
+    tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    compilerOptions: Schema.optional<typeof Schema.Unknown>;
+  }>>>;
+  apis: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+    packageName: typeof Schema.String;
+    name: Schema.optional<typeof Schema.String>;
+    baseRoute: Schema.optional<typeof Schema.String>;
+    apiFolder: Schema.optional<Schema.Union<[typeof Schema.String, typeof Schema.Null]>>;
+    model: Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>;
+    packageJson: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    theme: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+      light: typeof Schema.String;
+      dark: typeof Schema.String;
+    }>>, Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>]>>;
+    categories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+      displayName: typeof Schema.String;
+      singularName: typeof Schema.String;
+      folderName: typeof Schema.String;
+      itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+      tsdocModifier: Schema.optional<typeof Schema.String>;
+      collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+        default: () => number[];
+      }>;
+    }>>>>>;
+    source: Schema.optional<Schema.mutable<Schema.Struct<{
+      url: typeof Schema.String;
+      ref: Schema.optional<typeof Schema.String>;
+    }>>>;
+    externalPackages: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+      name: typeof Schema.String;
+      version: typeof Schema.String;
+      tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+      compilerOptions: Schema.optional<typeof Schema.Unknown>;
+    }>>>>>;
+    autoDetectDependencies: Schema.optional<Schema.mutable<Schema.Struct<{
+      dependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+      }>;
+      devDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+      }>;
+      peerDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      autoDependencies: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+    }>>>;
+    ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+      url: typeof Schema.String;
+      secureUrl: Schema.optional<typeof Schema.String>;
+      type: Schema.optional<typeof Schema.String>;
+      width: Schema.optional<typeof Schema.Number>;
+      height: Schema.optional<typeof Schema.Number>;
+      alt: Schema.optional<typeof Schema.String>;
+    }>>]>>;
+    llmsPlugin: Schema.optional<Schema.mutable<Schema.Struct<{
+      enabled: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      scopes: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => true;
+      }>;
+      copyButtonText: Schema.optionalWith<typeof Schema.String, {
+        default: () => string;
+      }>;
+      viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+        default: () => ["markdownLink", "chatgpt", "claude"];
+      }>;
+    }>>>;
+    tsconfig: Schema.optional<Schema.declare<string | ((...args: Array<unknown>) => unknown) | URL, string | ((...args: Array<unknown>) => unknown) | URL, readonly [], never>>;
+    compilerOptions: Schema.optional<typeof Schema.Unknown>;
+  }>>>>>;
+  siteUrl: Schema.optional<typeof Schema.String>;
+  ogImage: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    secureUrl: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<typeof Schema.String>;
+    width: Schema.optional<typeof Schema.Number>;
+    height: Schema.optional<typeof Schema.Number>;
+    alt: Schema.optional<typeof Schema.String>;
+  }>>]>>;
+  defaultCategories: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
+    displayName: typeof Schema.String;
+    singularName: typeof Schema.String;
+    folderName: typeof Schema.String;
+    itemKinds: Schema.optional<Schema.mutable<Schema.Array$<Schema.declare<ApiItemKind, ApiItemKind, readonly [], never>>>>;
+    tsdocModifier: Schema.optional<typeof Schema.String>;
+    collapsible: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    collapsed: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    overviewHeaders: Schema.optionalWith<Schema.mutable<Schema.Array$<typeof Schema.Number>>, {
+      default: () => number[];
+    }>;
+  }>>>>>;
+  errors: Schema.optional<Schema.mutable<Schema.Struct<{
+    example: Schema.optional<Schema.Literal<["suppress", "show"]>>;
+  }>>>;
+  llmsPlugin: Schema.optional<Schema.Union<[typeof Schema.Boolean, Schema.mutable<Schema.Struct<{
+    enabled: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    scopes: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    apiTxt: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showCopyButton: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    showViewOptions: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    copyButtonText: Schema.optionalWith<typeof Schema.String, {
+      default: () => string;
+    }>;
+    viewOptions: Schema.optionalWith<Schema.mutable<Schema.Array$<Schema.Literal<["markdownLink", "chatgpt", "claude"]>>>, {
+      default: () => ["markdownLink", "chatgpt", "claude"];
+    }>;
+  }>>]>>;
+  logLevel: Schema.optional<Schema.Literal<["none", "info", "verbose", "debug", "warn", "error"]>>;
+  performance: Schema.optional<Schema.mutable<Schema.Struct<{
+    thresholds: Schema.optional<Schema.mutable<Schema.Struct<{
+      slowCodeBlock: Schema.optionalWith<typeof Schema.Number, {
+        default: () => number;
+      }>;
+      slowPageGeneration: Schema.optionalWith<typeof Schema.Number, {
+        default: () => number;
+      }>;
+      slowApiLoad: Schema.optionalWith<typeof Schema.Number, {
+        default: () => number;
+      }>;
+      slowFileOperation: Schema.optionalWith<typeof Schema.Number, {
+        default: () => number;
+      }>;
+      slowHttpRequest: Schema.optionalWith<typeof Schema.Number, {
+        default: () => number;
+      }>;
+      slowDbOperation: Schema.optionalWith<typeof Schema.Number, {
+        default: () => number;
+      }>;
+    }>>>;
+    showInsights: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+    trackDetailedMetrics: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>;
+  }>>>;
+}>>;
+type PluginOptions = Schema.Schema.Type<typeof PluginOptions>;
+//#endregion
+//#region src/schemas/opengraph.d.ts
+declare const OpenGraphImageMetadata: Schema.mutable<Schema.Struct<{
+  url: typeof Schema.String;
+  secureUrl: Schema.optional<typeof Schema.String>;
+  type: Schema.optional<typeof Schema.String>;
+  width: Schema.optional<typeof Schema.Number>;
+  height: Schema.optional<typeof Schema.Number>;
+  alt: Schema.optional<typeof Schema.String>;
+}>>;
+type OpenGraphImageMetadata = Schema.Schema.Type<typeof OpenGraphImageMetadata>;
+declare const OpenGraphImageConfig: Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Struct<{
+  url: typeof Schema.String;
+  secureUrl: Schema.optional<typeof Schema.String>;
+  type: Schema.optional<typeof Schema.String>;
+  width: Schema.optional<typeof Schema.Number>;
+  height: Schema.optional<typeof Schema.Number>;
+  alt: Schema.optional<typeof Schema.String>;
+}>>]>;
+type OpenGraphImageConfig = Schema.Schema.Type<typeof OpenGraphImageConfig>;
+declare const OpenGraphMetadata: Schema.mutable<Schema.Struct<{
+  siteUrl: typeof Schema.String;
+  pageRoute: typeof Schema.String;
+  description: typeof Schema.String;
+  publishedTime: typeof Schema.String;
+  modifiedTime: typeof Schema.String;
+  section: typeof Schema.String;
+  tags: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+  ogImage: Schema.optional<Schema.mutable<Schema.Struct<{
+    url: typeof Schema.String;
+    secureUrl: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<typeof Schema.String>;
+    width: Schema.optional<typeof Schema.Number>;
+    height: Schema.optional<typeof Schema.Number>;
+    alt: Schema.optional<typeof Schema.String>;
+  }>>>;
+  ogType: typeof Schema.String;
+}>>;
+type OpenGraphMetadata = Schema.Schema.Type<typeof OpenGraphMetadata>;
+//#endregion
+//#region src/config-helpers.d.ts
+/** Metadata discovered from a single rslib-builder localPaths package folder. */
+interface DirInfo {
+  /** Absolute path to the package folder. */
+  dir: string;
+  /** Last path segment of `dir`, e.g. "sdk". */
+  dirname: string;
+  /** package.json "name", e.g. "vitest-agent-sdk" or "\@scope/pkg". */
+  packageName: string;
+  /** package.json "version" (empty string if absent). */
+  version: string;
+  /** Absolute path to the resolved *.api.json model. */
+  modelPath: string;
+}
+/**
+ * How to derive an API's `baseRoute`. One of:
+ *
+ * - omitted — leaves `baseRoute` unset so the plugin applies its own
+ *   context-aware default: the API folder root (`/api`) under the single-API
+ *   `api:` option, or `/{packageName}/api` under the multi-API `apis:` option.
+ * - a template string — supports the `{dirname}` and `{packageName}` tokens,
+ *   e.g. `"reference/{dirname}"`. A leading slash is normalized in.
+ * - a callback — `(info) => string` for full control.
+ *
+ * Note: the `{packageName}` token is interpolated verbatim, so for a scoped
+ * package it yields the scope too (e.g. `@scope/bar`), which is rarely what you
+ * want inside a URL path. Prefer `{dirname}` (the folder name, which is the
+ * unscoped name in the rslib-builder layout) or the callback form.
+ */
+type BaseRoute = string | ((info: DirInfo) => string);
+/** Overrides for `api.fromDir`. Any MultiApiConfig field wins over discovery. */
+type FromDirOptions = Omit<Partial<MultiApiConfig>, "baseRoute"> & {
+  baseRoute?: BaseRoute; /** Base for resolving a relative `dir`. Defaults to process.cwd(). */
+  cwd?: string;
+};
+/**
+ * Build a `MultiApiConfig` by discovering fields from a single package folder
+ * produced by `@savvy-web/rslib-builder`'s `localPaths` option. Exposed as
+ * `ApiExtractorPlugin.api.fromDir`; the returned config can be passed to the
+ * single-API `api:` option or used as an element of the multi-API `apis:` array.
+ *
+ * `baseRoute` is intentionally left unset unless overridden, so the plugin
+ * applies its own context-aware default (`/api` under `api:`,
+ * `/{packageName}/api` under `apis:`). See {@link BaseRoute}.
+ */
+declare function fromDir(dir: string, overrides?: FromDirOptions): MultiApiConfig;
+/**
+ * Strictly scan a parent directory of package folders and build one
+ * `MultiApiConfig` per subfolder. Exposed as `ApiExtractorPlugin.apis.fromDir`;
+ * the returned array is intended for the multi-API `apis:` option. Every
+ * non-dotfile subdirectory MUST be a valid model folder. `options` (minus
+ * `cwd`) is applied as shared defaults to each `api.fromDir` call.
+ */
+declare function fromParentDir(parentDir: string, options?: FromDirOptions): MultiApiConfig[];
+//#endregion
+//#region src/internal-types.d.ts
+/**
+ * Result from a model loader function
+ */
+interface LoadedModel {
+  /** The API model */
+  model: ApiModel;
+  /** Optional source config returned by the loader */
+  source?: SourceConfig;
+}
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * RSPress plugin for generating API documentation from API Extractor model files
+ */
+declare function ApiExtractorPluginImpl(rawOptions: PluginOptions): RspressPlugin;
+/**
+ * RSPress plugin for generating API documentation from API Extractor model
+ * files. Config helpers are available under `ApiExtractorPlugin.api` (single
+ * package → one config for the `api:` option) and `ApiExtractorPlugin.apis`
+ * (parent directory → array for the `apis:` option).
+ */
+declare const ApiExtractorPlugin: typeof ApiExtractorPluginImpl & {
+  api: {
+    fromDir: typeof fromDir;
+  };
+  apis: {
+    fromDir: typeof fromParentDir;
+  };
+};
+//#endregion
+//#region src/serve.d.ts
+/** Which RSPress server `serve` runs. */
+type ServeMode = "dev" | "preview";
+/** Options for {@link serve}. All fields are optional with sensible defaults. */
+interface ServeOptions {
+  /** Which RSPress server to run. Defaults to `"dev"`. */
+  mode?: ServeMode;
+  /**
+   * Port to serve on. Defaults to `process.env.DEV_PORT` (dev mode only) or
+   * `4173`. Preview mode ignores `DEV_PORT` unless `port` is passed explicitly.
+   */
+  port?: number;
+  /**
+   * Open a browser once the server is ready. Defaults to `true`, unless the
+   * `NO_OPEN` environment variable is set. Browser opening is best-effort.
+   */
+  open?: boolean;
+  /** Path to open in the browser, relative to the server root. Defaults to `"/"`. */
+  openPath?: string;
+  /** Package manager used to invoke the `rspress` CLI. Defaults to `"pnpm"`. */
+  packageManager?: string;
+  /** Working directory for the server process. Defaults to `process.cwd()`. */
+  cwd?: string;
+  /**
+   * Predicate over combined stdout/stderr deciding when the server is "ready"
+   * (and the browser should open). Defaults to a mode-specific heuristic — see
+   * {@link isServerReady}.
+   */
+  readyWhen?: (output: string) => boolean;
+}
+/** Fully resolved {@link ServeOptions} with defaults applied. */
+interface ResolvedServeConfig {
+  mode: ServeMode;
+  port: number;
+  open: boolean;
+  openPath: string;
+  packageManager: string;
+  cwd: string;
+  /** Arguments passed to the package manager, e.g. `["rspress", "dev", "--port", "4173"]`. */
+  args: string[];
+  /** The fully-qualified URL to open in the browser. */
+  url: string;
+  /** Resolved readiness predicate. */
+  isReady: (output: string) => boolean;
+}
+/**
+ * Readiness heuristic over a chunk of server output. Both RSPress `dev` and
+ * `preview` print a `Local:` address line once the server is listening, which
+ * is the reliable cross-mode signal. `dev` additionally prints a
+ * "ready ... built in" line, kept as a fallback in case the address-line format
+ * changes. Pure and exported so it can be unit-tested and reused as a
+ * {@link ServeOptions.readyWhen} building block.
+ */
+declare function isServerReady(mode: ServeMode, output: string): boolean;
+/**
+ * Resolve {@link ServeOptions} into a concrete {@link ResolvedServeConfig},
+ * applying all defaults. Pure (modulo reading `process.env`) and exported so
+ * the resolution logic can be unit-tested without spawning a server.
+ */
+declare function resolveServeConfig(options?: ServeOptions): ResolvedServeConfig;
+/**
+ * Run an RSPress `dev` or `preview` server, freeing the port first and opening a
+ * browser once the server is ready. A drop-in replacement for the per-site
+ * `dev.mts` / `preview.mts` scripts:
+ *
+ * ```ts
+ * import { serve } from "rspress-plugin-api-extractor";
+ *
+ * await serve({ mode: "dev", openPath: "/api/" });
+ * ```
+ *
+ * This runs the server for the lifetime of the host process and calls
+ * `process.exit` when the server exits (matching a top-level script runner). The
+ * returned promise resolves once the server is ready and the browser has been
+ * opened; it does not resolve when the server stops. Port-freeing and browser
+ * opening are best-effort and never reject.
+ */
+declare function serve(options?: ServeOptions): Promise<void>;
+//#endregion
+export { ApiExtractorPlugin, type PluginOptions as ApiExtractorPluginOptions, type BaseRoute, type CategoryConfig, DEFAULT_CATEGORIES, type DirInfo, type FromDirOptions, type LoadedModel, type LogLevel, type MultiApiConfig, type OpenGraphImageConfig, type OpenGraphImageMetadata, type OpenGraphMetadata, type ResolvedServeConfig, type ServeMode, type ServeOptions, type SingleApiConfig, type SourceConfig, type VersionConfig, isServerReady, resolveServeConfig, serve };
+//# sourceMappingURL=index.d.ts.map