polen 0.11.0-next.14 → 0.11.0-next.16

package/build/api/config/input.d.ts

@@ -0,0 +1,1944 @@
+import { S } from '#lib/kit-temp/effect';
+export declare const BuildArchitecture: S.Enums<{
+    readonly ssg: "ssg";
+    readonly spa: "spa";
+    readonly ssr: "ssr";
+}>;
+export type BuildArchitecture = S.Schema.Type<typeof BuildArchitecture>;
+declare const TemplateVariables: S.Struct<{
+    /**
+     * Title of the app.
+     *
+     * Used in the navigation bar and in the title tag.
+     *
+     * If not provided, Polen will try to use your project's package.json name
+     * field, converting it to title case (e.g., "my-project" → "My Project").
+     *
+     * @default Your package.json name (title-cased) or "My Developer Portal"
+     * @example
+     * ```ts
+     * // Explicit title
+     * title: 'Acme GraphQL API'
+     *
+     * // Falls back to package.json name
+     * // If package.json has { "name": "acme-graphql" }
+     * // Title will be "Acme Graphql"
+     * ```
+     */
+    title: S.optional<typeof S.String>;
+}>;
+export type TemplateVariables = S.Schema.Type<typeof TemplateVariables>;
+/**
+ * Polen configuration input.
+ *
+ * All options are optional. Polen provides sensible defaults for a great developer experience out of the box.
+ */
+export declare const ConfigInput: S.Struct<{
+    /**
+     * Name of your API/project.
+     *
+     * This is used as the default for:
+     * - Hero section title (unless overridden in home.hero.title)
+     * - Navigation bar title (unless overridden in templateVariables.title)
+     * - Page title suffix
+     *
+     * @example
+     * ```ts
+     * name: 'Pokemon API'
+     * ```
+     */
+    name: S.optional<typeof S.String>;
+    /**
+     * Description of your API/project.
+     *
+     * This is used as the default for:
+     * - Hero section description (unless overridden in home.hero.description)
+     * - Meta description tags for SEO
+     *
+     * @example
+     * ```ts
+     * description: 'Catch, train, and battle with Pokemon through our comprehensive GraphQL API'
+     * ```
+     */
+    description: S.optional<typeof S.String>;
+    schema: S.optional<S.Struct<{
+        enabled: S.optional<typeof S.Boolean>;
+        augmentations: S.optional<S.Array$<S.Struct<{
+            type: S.Literal<["description"]>;
+            on: S.Union<[S.Struct<{
+                type: S.Literal<["TargetType"]>;
+                name: typeof S.String;
+            }>, S.Struct<{
+                type: S.Literal<["TargetField"]>;
+                name: typeof S.String;
+                targetType: typeof S.String;
+            }>]>;
+            placement: S.Literal<["before", "after", "over"]>;
+            content: typeof S.String;
+        }>>>;
+        useSources: S.optional<S.Union<[S.Enums<{
+            readonly file: "file";
+            readonly directory: "directory";
+            readonly versionedDirectory: "versionedDirectory";
+            readonly memory: "memory";
+            readonly introspection: "introspection";
+            readonly introspectionFile: "introspectionFile";
+        }>, S.Array$<S.Enums<{
+            readonly file: "file";
+            readonly directory: "directory";
+            readonly versionedDirectory: "versionedDirectory";
+            readonly memory: "memory";
+            readonly introspection: "introspection";
+            readonly introspectionFile: "introspectionFile";
+        }>>]>>;
+        sources: S.optional<S.Struct<{
+            file: S.optional<S.Struct<{
+                path: S.optional<typeof S.String>;
+            }>>;
+            directory: S.optional<S.Struct<{
+                path: S.optional<typeof S.String>;
+            }>>;
+            versionedDirectory: S.optional<S.Struct<{
+                path: S.optional<typeof S.String>;
+            }>>;
+            memory: S.optional<S.Struct<{
+                revisions: S.SchemaClass<unknown, unknown, never>;
+            }>>;
+            introspection: S.optional<S.Struct<{
+                url: typeof S.String;
+                headers: S.optional<S.Record$<typeof S.String, typeof S.String>>;
+            }>>;
+            introspectionFile: S.optional<S.Struct<{
+                path: S.optional<typeof S.String>;
+            }>>;
+        }>>;
+    }>>;
+    examples: S.optional<S.Struct<{
+        enabled: S.optional<typeof S.Boolean>;
+        display: S.optional<S.Union<[S.Literal<["all"]>, S.Literal<["none"]>, S.Struct<{
+            include: S.Array$<S.transform<typeof S.String, S.SchemaClass<string, string, never>>>;
+        }>, S.Struct<{
+            exclude: S.Array$<S.transform<typeof S.String, S.SchemaClass<string, string, never>>>;
+        }>]>>;
+        diagnostics: S.optional<S.Struct<{
+            validation: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+                enabled: typeof S.Boolean;
+                dev: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+                build: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+            }>]>>;
+            unusedVersions: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+                enabled: typeof S.Boolean;
+                dev: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+                build: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+            }>]>>;
+            duplicateContent: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+                enabled: typeof S.Boolean;
+                dev: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+                build: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+            }>]>>;
+            missingVersions: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+                enabled: typeof S.Boolean;
+                dev: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+                build: S.optional<S.Struct<{
+                    enabled: S.optional<typeof S.Boolean>;
+                    severity: S.optional<S.Enums<{
+                        readonly error: "error";
+                        readonly warning: "warning";
+                        readonly info: "info";
+                    }>>;
+                }>>;
+            }>]>>;
+        }>>;
+    }>>;
+    templateVariables: S.optional<S.Struct<{
+        /**
+         * Title of the app.
+         *
+         * Used in the navigation bar and in the title tag.
+         *
+         * If not provided, Polen will try to use your project's package.json name
+         * field, converting it to title case (e.g., "my-project" → "My Project").
+         *
+         * @default Your package.json name (title-cased) or "My Developer Portal"
+         * @example
+         * ```ts
+         * // Explicit title
+         * title: 'Acme GraphQL API'
+         *
+         * // Falls back to package.json name
+         * // If package.json has { "name": "acme-graphql" }
+         * // Title will be "Acme Graphql"
+         * ```
+         */
+        title: S.optional<typeof S.String>;
+    }>>;
+    home: S.optional<S.Struct<{
+        enabled: S.optional<typeof S.Boolean>;
+        topics: S.optional<S.Array$<typeof S.String>>;
+        hero: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            title: S.optional<typeof S.String>;
+            tagline: S.optional<typeof S.String>;
+            callToActions: S.optional<S.Union<[S.Array$<S.Struct<{
+                label: typeof S.String;
+                href: typeof S.String;
+                variant: S.optional<S.Literal<["primary", "secondary"]>>;
+            }>>, S.Struct<{
+                before: S.optional<S.Array$<S.Struct<{
+                    label: typeof S.String;
+                    href: typeof S.String;
+                    variant: S.optional<S.Literal<["primary", "secondary"]>>;
+                }>>>;
+                after: S.optional<S.Array$<S.Struct<{
+                    label: typeof S.String;
+                    href: typeof S.String;
+                    variant: S.optional<S.Literal<["primary", "secondary"]>>;
+                }>>>;
+                over: S.optional<S.Array$<S.Struct<{
+                    label: typeof S.String;
+                    href: typeof S.String;
+                    variant: S.optional<S.Literal<["primary", "secondary"]>>;
+                }>>>;
+            }>]>>;
+            layout: S.optional<S.Union<[S.Literal<["asymmetric"]>, S.Literal<["cinematic"]>, S.Literal<["auto"]>]>>;
+            prompt: S.optional<typeof S.String>;
+            heroImage: S.optional<S.Union<[typeof S.String, S.Struct<{
+                src: S.optional<typeof S.String>;
+                ai: S.optional<S.Struct<{
+                    enabled: typeof S.Boolean;
+                    prompt: S.optional<typeof S.String>;
+                    style: S.optional<S.Literal<["modern", "minimalist", "abstract", "technical", "vibrant", "professional", "futuristic", "gradient", "geometric", "illustration"]>>;
+                    width: S.optional<typeof S.Number>;
+                    height: S.optional<typeof S.Number>;
+                    seed: S.optional<typeof S.Number>;
+                    nologo: S.optional<typeof S.Boolean>;
+                    cache: S.optional<typeof S.Boolean>;
+                }>>;
+            }>]>>;
+        }>]>>;
+        socialProof: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            title: S.optional<typeof S.String>;
+            logos: S.Array$<S.Union<[typeof S.String, S.Struct<{
+                name: typeof S.String;
+                src: typeof S.String;
+                href: S.optional<typeof S.String>;
+            }>]>>;
+        }>]>>;
+        socialMedia: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            posts: S.Array$<S.Struct<{
+                platform: S.Literal<["x", "twitter", "bluesky", "mastodon"]>;
+                id: typeof S.String;
+                embedCode: S.optional<typeof S.String>;
+            }>>;
+            displayMode: S.optional<S.Literal<["embed", "screenshot"]>>;
+        }>]>>;
+        examples: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            maxExamples: S.optional<typeof S.Number>;
+            title: S.optional<typeof S.String>;
+            description: S.optional<typeof S.String>;
+            only: S.optional<S.Array$<typeof S.String>>;
+            exclude: S.optional<S.Array$<typeof S.String>>;
+        }>]>>;
+        quickStart: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            tabs: S.optional<S.Array$<S.Literal<["setup", "examples", "playground"]>>>;
+            steps: S.optional<S.Array$<S.Struct<{
+                title: typeof S.String;
+                description: S.optional<typeof S.String>;
+                code: typeof S.String;
+                language: S.optional<typeof S.String>;
+            }>>>;
+            languages: S.optional<S.Array$<typeof S.String>>;
+            playground: S.optional<S.Struct<{
+                endpoint: S.optional<typeof S.String>;
+                headers: S.optional<S.Record$<typeof S.String, typeof S.String>>;
+                defaultQuery: S.optional<typeof S.String>;
+                useMockData: S.optional<typeof S.Boolean>;
+            }>>;
+        }>]>>;
+        stats: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            showSchemaStats: S.optional<typeof S.Boolean>;
+            statusEndpoint: S.optional<typeof S.String>;
+            customMetrics: S.optional<S.Array$<S.Struct<{
+                label: typeof S.String;
+                value: S.Union<[typeof S.String, typeof S.Number]>;
+                icon: S.optional<typeof S.String>;
+            }>>>;
+        }>]>>;
+        changelog: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            limit: S.optional<typeof S.Number>;
+            showVersions: S.optional<typeof S.Boolean>;
+        }>]>>;
+        resources: S.optional<S.Union<[typeof S.Boolean, S.Struct<{
+            links: S.optional<S.Array$<S.Struct<{
+                title: typeof S.String;
+                description: S.optional<typeof S.String>;
+                href: typeof S.String;
+                icon: S.optional<typeof S.String>;
+            }>>>;
+            communityLinks: S.optional<S.Array$<S.Struct<{
+                platform: typeof S.String;
+                href: typeof S.String;
+            }>>>;
+            supportContact: S.optional<S.Struct<{
+                email: S.optional<typeof S.String>;
+                href: S.optional<typeof S.String>;
+                text: S.optional<typeof S.String>;
+            }>>;
+        }>]>>;
+    }>>;
+    branding: S.optional<S.Struct<{
+        /**
+         * Specifies which theme mode the single logo.* file is designed for.
+         *
+         * This setting only applies when you provide a single logo file (e.g., `logo.svg`).
+         * It tells Polen whether your logo was designed for light or dark backgrounds,
+         * so it can automatically invert the logo colors when needed.
+         *
+         * When you provide theme-specific logos (`logo-light.svg` and `logo-dark.svg`),
+         * this setting is ignored as each logo is used directly for its respective theme.
+         *
+         * @default 'light'
+         *
+         * @example
+         * ```ts
+         * // Default: Your logo.svg has dark graphics for light backgrounds
+         * branding: {
+         *   // logoDesignedFor: 'light' // This is the default
+         * }
+         *
+         * // Your logo.svg has light/white graphics for dark backgrounds
+         * branding: {
+         *   logoDesignedFor: 'dark'
+         * }
+         * ```
+         */
+        logoDesignedFor: S.optional<S.Literal<["light", "dark"]>>;
+    }>>;
+    build: S.optional<S.Struct<{
+        /**
+         * The build architecture for your developer portal.
+         *
+         * - `ssg` - Static Site Generation: Pre-renders all pages at build time. Best for public docs.
+         * - `ssr` - Server-Side Rendering: Renders pages on each request. Enables dynamic features.
+         * - `spa` - Single Page Application: Client-side rendering only.
+         *
+         * @default 'ssg'
+         */
+        architecture: S.optional<S.Enums<{
+            readonly ssg: "ssg";
+            readonly spa: "spa";
+            readonly ssr: "ssr";
+        }>>;
+        /**
+         * Base public path for the deployed site.
+         *
+         * Use this when deploying to a subdirectory (e.g., GitHub Pages project sites).
+         *
+         * @example
+         * ```ts
+         * // Deploy to root
+         * base: '/'
+         *
+         * // Deploy to subdirectory
+         * base: '/my-project/'
+         *
+         * // PR preview deployments
+         * base: '/pr-123/'
+         * ```
+         *
+         * Must start and end with `/`.
+         *
+         * @default `/`
+         */
+        base: S.optional<typeof S.String>;
+    }>>;
+    server: S.optional<S.Struct<{
+        /**
+         * Port for the server to listen on.
+         *
+         * - In development: The port for the Vite dev server
+         * - In production SSR: The default port for the Node.js server
+         *
+         * For production SSR builds, this can be overridden at runtime
+         * using the PORT environment variable.
+         *
+         * @default 3000
+         * @example
+         * ```ts
+         * // Use a specific port
+         * server: {
+         *   port: 4000
+         * }
+         *
+         * // Or via CLI flags:
+         * // polen dev --port 4000
+         * // polen build --port 4000
+         * ```
+         */
+        port: S.optional<typeof S.Number>;
+    }>>;
+    warnings: S.optional<S.Struct<{
+        /**
+         * Warning shown when GraphQL code blocks have the `interactive` flag
+         * but no schema is configured.
+         *
+         * Interactive features require a schema to provide field validation,
+         * type information, and auto-completion.
+         *
+         * @default { enabled: true }
+         */
+        interactiveWithoutSchema: S.optional<S.Struct<{
+            /**
+             * Whether to show this warning.
+             *
+             * @default true
+             */
+            enabled: S.optional<typeof S.Boolean>;
+        }>>;
+    }>>;
+    advanced: S.optional<S.Struct<{
+        /**
+         * Enable a special module explorer for the source code that Polen assembles for your app.
+         *
+         * This opens an interactive UI to inspect the module graph and transformations.
+         * Useful for debugging build issues or understanding Polen's internals.
+         *
+         * Access the explorer at `/__inspect/` when running the dev server.
+         *
+         * Powered by [Vite Inspect](https://github.com/antfu-collective/vite-plugin-inspect).
+         *
+         * @default false
+         */
+        explorer: S.optional<typeof S.Boolean>;
+        /**
+         * Force the CLI to resolve Polen imports in your project to itself rather than
+         * to what you have installed in your project.
+         *
+         * If you are using a Polen CLI from your local project against your local project
+         * then there can be no effect from this setting.
+         *
+         * This is mostly useful for:
+         *
+         * - Development of Polen itself
+         * - Global CLI usage against ephemeral projects e.g. a directory with just a
+         *   GraphQL Schema file.
+         *
+         * @default false
+         */
+        isSelfContainedMode: S.optional<typeof S.Boolean>;
+        /**
+         * Whether to enable debug mode.
+         *
+         * When enabled the following happens:
+         *
+         * - build output is NOT minified.
+         *
+         * @default false
+         */
+        debug: S.optional<typeof S.Boolean>;
+        /**
+         * Additional {@link vite.UserConfig} that is merged with the one created by Polen using {@link Vite.mergeConfig}.
+         *
+         * @see https://vite.dev/config/
+         * @see https://vite.dev/guide/api-javascript.html#mergeconfig
+         */
+        vite: S.optional<S.transform<typeof S.Unknown, typeof S.Any>>;
+        paths: S.optional<S.Struct<{
+            devAssets: S.optional<typeof S.String>;
+        }>>;
+    }>>;
+}>;
+export type ConfigInput = S.Schema.Type<typeof ConfigInput>;
+export declare const decodeConfigInput: (i: {
+    readonly build?: {
+        readonly architecture?: "ssr" | "ssg" | "spa" | undefined;
+        readonly base?: string | undefined;
+    } | undefined;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly examples?: {
+        readonly enabled?: boolean | undefined;
+        readonly display?: "all" | "none" | {
+            readonly include: readonly string[];
+        } | {
+            readonly exclude: readonly string[];
+        } | undefined;
+        readonly diagnostics?: {
+            readonly validation?: boolean | {
+                readonly enabled: boolean;
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly unusedVersions?: boolean | {
+                readonly enabled: boolean;
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly duplicateContent?: boolean | {
+                readonly enabled: boolean;
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly missingVersions?: boolean | {
+                readonly enabled: boolean;
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly schema?: {
+        readonly enabled?: boolean | undefined;
+        readonly augmentations?: readonly {
+            readonly type: "description";
+            readonly content: string;
+            readonly on: {
+                readonly name: string;
+                readonly type: "TargetType";
+            } | {
+                readonly name: string;
+                readonly type: "TargetField";
+                readonly targetType: string;
+            };
+            readonly placement: "before" | "after" | "over";
+        }[] | undefined;
+        readonly useSources?: "file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile" | readonly ("file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile")[] | undefined;
+        readonly sources?: {
+            readonly file?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly directory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly versionedDirectory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly memory?: {
+                readonly revisions: unknown;
+            } | undefined;
+            readonly introspection?: {
+                readonly url: string;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+            } | undefined;
+            readonly introspectionFile?: {
+                readonly path?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly templateVariables?: {
+        readonly title?: string | undefined;
+    } | undefined;
+    readonly home?: {
+        readonly enabled?: boolean | undefined;
+        readonly examples?: boolean | {
+            readonly description?: string | undefined;
+            readonly title?: string | undefined;
+            readonly maxExamples?: number | undefined;
+            readonly only?: readonly string[] | undefined;
+            readonly exclude?: readonly string[] | undefined;
+        } | undefined;
+        readonly topics?: readonly string[] | undefined;
+        readonly hero?: boolean | {
+            readonly title?: string | undefined;
+            readonly tagline?: string | undefined;
+            readonly callToActions?: readonly {
+                readonly label: string;
+                readonly href: string;
+                readonly variant?: "primary" | "secondary" | undefined;
+            }[] | {
+                readonly before?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly after?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly over?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+            } | undefined;
+            readonly layout?: "asymmetric" | "cinematic" | "auto" | undefined;
+            readonly prompt?: string | undefined;
+            readonly heroImage?: string | {
+                readonly src?: string | undefined;
+                readonly ai?: {
+                    readonly enabled: boolean;
+                    readonly prompt?: string | undefined;
+                    readonly style?: "modern" | "minimalist" | "abstract" | "technical" | "vibrant" | "professional" | "futuristic" | "gradient" | "geometric" | "illustration" | undefined;
+                    readonly width?: number | undefined;
+                    readonly height?: number | undefined;
+                    readonly seed?: number | undefined;
+                    readonly nologo?: boolean | undefined;
+                    readonly cache?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        readonly socialProof?: boolean | {
+            readonly logos: readonly (string | {
+                readonly src: string;
+                readonly name: string;
+                readonly href?: string | undefined;
+            })[];
+            readonly title?: string | undefined;
+        } | undefined;
+        readonly socialMedia?: boolean | {
+            readonly posts: readonly {
+                readonly platform: "x" | "twitter" | "bluesky" | "mastodon";
+                readonly id: string;
+                readonly embedCode?: string | undefined;
+            }[];
+            readonly displayMode?: "embed" | "screenshot" | undefined;
+        } | undefined;
+        readonly quickStart?: boolean | {
+            readonly tabs?: readonly ("setup" | "examples" | "playground")[] | undefined;
+            readonly playground?: {
+                readonly endpoint?: string | undefined;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly defaultQuery?: string | undefined;
+                readonly useMockData?: boolean | undefined;
+            } | undefined;
+            readonly steps?: readonly {
+                readonly title: string;
+                readonly code: string;
+                readonly description?: string | undefined;
+                readonly language?: string | undefined;
+            }[] | undefined;
+            readonly languages?: readonly string[] | undefined;
+        } | undefined;
+        readonly stats?: boolean | {
+            readonly showSchemaStats?: boolean | undefined;
+            readonly statusEndpoint?: string | undefined;
+            readonly customMetrics?: readonly {
+                readonly label: string;
+                readonly value: string | number;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+        readonly changelog?: boolean | {
+            readonly limit?: number | undefined;
+            readonly showVersions?: boolean | undefined;
+        } | undefined;
+        readonly resources?: boolean | {
+            readonly links?: readonly {
+                readonly href: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+            readonly communityLinks?: readonly {
+                readonly href: string;
+                readonly platform: string;
+            }[] | undefined;
+            readonly supportContact?: {
+                readonly href?: string | undefined;
+                readonly email?: string | undefined;
+                readonly text?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly branding?: {
+        readonly logoDesignedFor?: "light" | "dark" | undefined;
+    } | undefined;
+    readonly server?: {
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly warnings?: {
+        readonly interactiveWithoutSchema?: {
+            readonly enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    readonly advanced?: {
+        readonly explorer?: boolean | undefined;
+        readonly isSelfContainedMode?: boolean | undefined;
+        readonly debug?: boolean | undefined;
+        readonly vite?: unknown;
+        readonly paths?: {
+            readonly devAssets?: string | undefined;
+        } | undefined;
+    } | undefined;
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => {
+    readonly build?: {
+        readonly architecture?: "ssr" | "ssg" | "spa" | undefined;
+        readonly base?: string | undefined;
+    } | undefined;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly examples?: {
+        readonly enabled?: boolean | undefined;
+        readonly display?: "all" | "none" | {
+            readonly include: readonly string[];
+        } | {
+            readonly exclude: readonly string[];
+        } | undefined;
+        readonly diagnostics?: {
+            readonly validation?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly unusedVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly duplicateContent?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly missingVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly schema?: {
+        readonly enabled?: boolean | undefined;
+        readonly augmentations?: readonly {
+            readonly type: "description";
+            readonly content: string;
+            readonly on: {
+                readonly name: string;
+                readonly type: "TargetType";
+            } | {
+                readonly name: string;
+                readonly type: "TargetField";
+                readonly targetType: string;
+            };
+            readonly placement: "before" | "after" | "over";
+        }[] | undefined;
+        readonly useSources?: "file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile" | readonly ("file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile")[] | undefined;
+        readonly sources?: {
+            readonly file?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly directory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly versionedDirectory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly memory?: {
+                readonly revisions: unknown;
+            } | undefined;
+            readonly introspection?: {
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly url: string;
+            } | undefined;
+            readonly introspectionFile?: {
+                readonly path?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly templateVariables?: {
+        readonly title?: string | undefined;
+    } | undefined;
+    readonly home?: {
+        readonly enabled?: boolean | undefined;
+        readonly examples?: boolean | {
+            readonly description?: string | undefined;
+            readonly title?: string | undefined;
+            readonly maxExamples?: number | undefined;
+            readonly only?: readonly string[] | undefined;
+            readonly exclude?: readonly string[] | undefined;
+        } | undefined;
+        readonly topics?: readonly string[] | undefined;
+        readonly hero?: boolean | {
+            readonly title?: string | undefined;
+            readonly tagline?: string | undefined;
+            readonly callToActions?: readonly {
+                readonly label: string;
+                readonly href: string;
+                readonly variant?: "primary" | "secondary" | undefined;
+            }[] | {
+                readonly before?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly after?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly over?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+            } | undefined;
+            readonly layout?: "asymmetric" | "cinematic" | "auto" | undefined;
+            readonly prompt?: string | undefined;
+            readonly heroImage?: string | {
+                readonly src?: string | undefined;
+                readonly ai?: {
+                    readonly prompt?: string | undefined;
+                    readonly enabled: boolean;
+                    readonly style?: "modern" | "minimalist" | "abstract" | "technical" | "vibrant" | "professional" | "futuristic" | "gradient" | "geometric" | "illustration" | undefined;
+                    readonly width?: number | undefined;
+                    readonly height?: number | undefined;
+                    readonly seed?: number | undefined;
+                    readonly nologo?: boolean | undefined;
+                    readonly cache?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        readonly socialProof?: boolean | {
+            readonly title?: string | undefined;
+            readonly logos: readonly (string | {
+                readonly src: string;
+                readonly name: string;
+                readonly href?: string | undefined;
+            })[];
+        } | undefined;
+        readonly socialMedia?: boolean | {
+            readonly posts: readonly {
+                readonly platform: "x" | "twitter" | "bluesky" | "mastodon";
+                readonly id: string;
+                readonly embedCode?: string | undefined;
+            }[];
+            readonly displayMode?: "embed" | "screenshot" | undefined;
+        } | undefined;
+        readonly quickStart?: boolean | {
+            readonly tabs?: readonly ("setup" | "examples" | "playground")[] | undefined;
+            readonly playground?: {
+                readonly endpoint?: string | undefined;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly defaultQuery?: string | undefined;
+                readonly useMockData?: boolean | undefined;
+            } | undefined;
+            readonly steps?: readonly {
+                readonly description?: string | undefined;
+                readonly title: string;
+                readonly code: string;
+                readonly language?: string | undefined;
+            }[] | undefined;
+            readonly languages?: readonly string[] | undefined;
+        } | undefined;
+        readonly stats?: boolean | {
+            readonly showSchemaStats?: boolean | undefined;
+            readonly statusEndpoint?: string | undefined;
+            readonly customMetrics?: readonly {
+                readonly label: string;
+                readonly value: string | number;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+        readonly changelog?: boolean | {
+            readonly limit?: number | undefined;
+            readonly showVersions?: boolean | undefined;
+        } | undefined;
+        readonly resources?: boolean | {
+            readonly links?: readonly {
+                readonly description?: string | undefined;
+                readonly href: string;
+                readonly title: string;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+            readonly communityLinks?: readonly {
+                readonly href: string;
+                readonly platform: string;
+            }[] | undefined;
+            readonly supportContact?: {
+                readonly href?: string | undefined;
+                readonly email?: string | undefined;
+                readonly text?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly branding?: {
+        readonly logoDesignedFor?: "light" | "dark" | undefined;
+    } | undefined;
+    readonly server?: {
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly warnings?: {
+        readonly interactiveWithoutSchema?: {
+            readonly enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    readonly advanced?: {
+        readonly explorer?: boolean | undefined;
+        readonly isSelfContainedMode?: boolean | undefined;
+        readonly debug?: boolean | undefined;
+        readonly vite?: any;
+        readonly paths?: {
+            readonly devAssets?: string | undefined;
+        } | undefined;
+    } | undefined;
+};
+export declare const validateConfigInput: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions) => {
+    readonly build?: {
+        readonly architecture?: "ssr" | "ssg" | "spa" | undefined;
+        readonly base?: string | undefined;
+    } | undefined;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly examples?: {
+        readonly enabled?: boolean | undefined;
+        readonly display?: "all" | "none" | {
+            readonly include: readonly string[];
+        } | {
+            readonly exclude: readonly string[];
+        } | undefined;
+        readonly diagnostics?: {
+            readonly validation?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly unusedVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly duplicateContent?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly missingVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly schema?: {
+        readonly enabled?: boolean | undefined;
+        readonly augmentations?: readonly {
+            readonly type: "description";
+            readonly content: string;
+            readonly on: {
+                readonly name: string;
+                readonly type: "TargetType";
+            } | {
+                readonly name: string;
+                readonly type: "TargetField";
+                readonly targetType: string;
+            };
+            readonly placement: "before" | "after" | "over";
+        }[] | undefined;
+        readonly useSources?: "file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile" | readonly ("file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile")[] | undefined;
+        readonly sources?: {
+            readonly file?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly directory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly versionedDirectory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly memory?: {
+                readonly revisions: unknown;
+            } | undefined;
+            readonly introspection?: {
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly url: string;
+            } | undefined;
+            readonly introspectionFile?: {
+                readonly path?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly templateVariables?: {
+        readonly title?: string | undefined;
+    } | undefined;
+    readonly home?: {
+        readonly enabled?: boolean | undefined;
+        readonly examples?: boolean | {
+            readonly description?: string | undefined;
+            readonly title?: string | undefined;
+            readonly maxExamples?: number | undefined;
+            readonly only?: readonly string[] | undefined;
+            readonly exclude?: readonly string[] | undefined;
+        } | undefined;
+        readonly topics?: readonly string[] | undefined;
+        readonly hero?: boolean | {
+            readonly title?: string | undefined;
+            readonly tagline?: string | undefined;
+            readonly callToActions?: readonly {
+                readonly label: string;
+                readonly href: string;
+                readonly variant?: "primary" | "secondary" | undefined;
+            }[] | {
+                readonly before?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly after?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly over?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+            } | undefined;
+            readonly layout?: "asymmetric" | "cinematic" | "auto" | undefined;
+            readonly prompt?: string | undefined;
+            readonly heroImage?: string | {
+                readonly src?: string | undefined;
+                readonly ai?: {
+                    readonly prompt?: string | undefined;
+                    readonly enabled: boolean;
+                    readonly style?: "modern" | "minimalist" | "abstract" | "technical" | "vibrant" | "professional" | "futuristic" | "gradient" | "geometric" | "illustration" | undefined;
+                    readonly width?: number | undefined;
+                    readonly height?: number | undefined;
+                    readonly seed?: number | undefined;
+                    readonly nologo?: boolean | undefined;
+                    readonly cache?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        readonly socialProof?: boolean | {
+            readonly title?: string | undefined;
+            readonly logos: readonly (string | {
+                readonly src: string;
+                readonly name: string;
+                readonly href?: string | undefined;
+            })[];
+        } | undefined;
+        readonly socialMedia?: boolean | {
+            readonly posts: readonly {
+                readonly platform: "x" | "twitter" | "bluesky" | "mastodon";
+                readonly id: string;
+                readonly embedCode?: string | undefined;
+            }[];
+            readonly displayMode?: "embed" | "screenshot" | undefined;
+        } | undefined;
+        readonly quickStart?: boolean | {
+            readonly tabs?: readonly ("setup" | "examples" | "playground")[] | undefined;
+            readonly playground?: {
+                readonly endpoint?: string | undefined;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly defaultQuery?: string | undefined;
+                readonly useMockData?: boolean | undefined;
+            } | undefined;
+            readonly steps?: readonly {
+                readonly description?: string | undefined;
+                readonly title: string;
+                readonly code: string;
+                readonly language?: string | undefined;
+            }[] | undefined;
+            readonly languages?: readonly string[] | undefined;
+        } | undefined;
+        readonly stats?: boolean | {
+            readonly showSchemaStats?: boolean | undefined;
+            readonly statusEndpoint?: string | undefined;
+            readonly customMetrics?: readonly {
+                readonly label: string;
+                readonly value: string | number;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+        readonly changelog?: boolean | {
+            readonly limit?: number | undefined;
+            readonly showVersions?: boolean | undefined;
+        } | undefined;
+        readonly resources?: boolean | {
+            readonly links?: readonly {
+                readonly description?: string | undefined;
+                readonly href: string;
+                readonly title: string;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+            readonly communityLinks?: readonly {
+                readonly href: string;
+                readonly platform: string;
+            }[] | undefined;
+            readonly supportContact?: {
+                readonly href?: string | undefined;
+                readonly email?: string | undefined;
+                readonly text?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly branding?: {
+        readonly logoDesignedFor?: "light" | "dark" | undefined;
+    } | undefined;
+    readonly server?: {
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly warnings?: {
+        readonly interactiveWithoutSchema?: {
+            readonly enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    readonly advanced?: {
+        readonly explorer?: boolean | undefined;
+        readonly isSelfContainedMode?: boolean | undefined;
+        readonly debug?: boolean | undefined;
+        readonly vite?: any;
+        readonly paths?: {
+            readonly devAssets?: string | undefined;
+        } | undefined;
+    } | undefined;
+};
+export declare const validateConfigInputEffect: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    readonly build?: {
+        readonly architecture?: "ssr" | "ssg" | "spa" | undefined;
+        readonly base?: string | undefined;
+    } | undefined;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly examples?: {
+        readonly enabled?: boolean | undefined;
+        readonly display?: "all" | "none" | {
+            readonly include: readonly string[];
+        } | {
+            readonly exclude: readonly string[];
+        } | undefined;
+        readonly diagnostics?: {
+            readonly validation?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly unusedVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly duplicateContent?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly missingVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly schema?: {
+        readonly enabled?: boolean | undefined;
+        readonly augmentations?: readonly {
+            readonly type: "description";
+            readonly content: string;
+            readonly on: {
+                readonly name: string;
+                readonly type: "TargetType";
+            } | {
+                readonly name: string;
+                readonly type: "TargetField";
+                readonly targetType: string;
+            };
+            readonly placement: "before" | "after" | "over";
+        }[] | undefined;
+        readonly useSources?: "file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile" | readonly ("file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile")[] | undefined;
+        readonly sources?: {
+            readonly file?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly directory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly versionedDirectory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly memory?: {
+                readonly revisions: unknown;
+            } | undefined;
+            readonly introspection?: {
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly url: string;
+            } | undefined;
+            readonly introspectionFile?: {
+                readonly path?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly templateVariables?: {
+        readonly title?: string | undefined;
+    } | undefined;
+    readonly home?: {
+        readonly enabled?: boolean | undefined;
+        readonly examples?: boolean | {
+            readonly description?: string | undefined;
+            readonly title?: string | undefined;
+            readonly maxExamples?: number | undefined;
+            readonly only?: readonly string[] | undefined;
+            readonly exclude?: readonly string[] | undefined;
+        } | undefined;
+        readonly topics?: readonly string[] | undefined;
+        readonly hero?: boolean | {
+            readonly title?: string | undefined;
+            readonly tagline?: string | undefined;
+            readonly callToActions?: readonly {
+                readonly label: string;
+                readonly href: string;
+                readonly variant?: "primary" | "secondary" | undefined;
+            }[] | {
+                readonly before?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly after?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly over?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+            } | undefined;
+            readonly layout?: "asymmetric" | "cinematic" | "auto" | undefined;
+            readonly prompt?: string | undefined;
+            readonly heroImage?: string | {
+                readonly src?: string | undefined;
+                readonly ai?: {
+                    readonly prompt?: string | undefined;
+                    readonly enabled: boolean;
+                    readonly style?: "modern" | "minimalist" | "abstract" | "technical" | "vibrant" | "professional" | "futuristic" | "gradient" | "geometric" | "illustration" | undefined;
+                    readonly width?: number | undefined;
+                    readonly height?: number | undefined;
+                    readonly seed?: number | undefined;
+                    readonly nologo?: boolean | undefined;
+                    readonly cache?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        readonly socialProof?: boolean | {
+            readonly title?: string | undefined;
+            readonly logos: readonly (string | {
+                readonly src: string;
+                readonly name: string;
+                readonly href?: string | undefined;
+            })[];
+        } | undefined;
+        readonly socialMedia?: boolean | {
+            readonly posts: readonly {
+                readonly platform: "x" | "twitter" | "bluesky" | "mastodon";
+                readonly id: string;
+                readonly embedCode?: string | undefined;
+            }[];
+            readonly displayMode?: "embed" | "screenshot" | undefined;
+        } | undefined;
+        readonly quickStart?: boolean | {
+            readonly tabs?: readonly ("setup" | "examples" | "playground")[] | undefined;
+            readonly playground?: {
+                readonly endpoint?: string | undefined;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly defaultQuery?: string | undefined;
+                readonly useMockData?: boolean | undefined;
+            } | undefined;
+            readonly steps?: readonly {
+                readonly description?: string | undefined;
+                readonly title: string;
+                readonly code: string;
+                readonly language?: string | undefined;
+            }[] | undefined;
+            readonly languages?: readonly string[] | undefined;
+        } | undefined;
+        readonly stats?: boolean | {
+            readonly showSchemaStats?: boolean | undefined;
+            readonly statusEndpoint?: string | undefined;
+            readonly customMetrics?: readonly {
+                readonly label: string;
+                readonly value: string | number;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+        readonly changelog?: boolean | {
+            readonly limit?: number | undefined;
+            readonly showVersions?: boolean | undefined;
+        } | undefined;
+        readonly resources?: boolean | {
+            readonly links?: readonly {
+                readonly description?: string | undefined;
+                readonly href: string;
+                readonly title: string;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+            readonly communityLinks?: readonly {
+                readonly href: string;
+                readonly platform: string;
+            }[] | undefined;
+            readonly supportContact?: {
+                readonly href?: string | undefined;
+                readonly email?: string | undefined;
+                readonly text?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly branding?: {
+        readonly logoDesignedFor?: "light" | "dark" | undefined;
+    } | undefined;
+    readonly server?: {
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly warnings?: {
+        readonly interactiveWithoutSchema?: {
+            readonly enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    readonly advanced?: {
+        readonly explorer?: boolean | undefined;
+        readonly isSelfContainedMode?: boolean | undefined;
+        readonly debug?: boolean | undefined;
+        readonly vite?: any;
+        readonly paths?: {
+            readonly devAssets?: string | undefined;
+        } | undefined;
+    } | undefined;
+}, import("effect/ParseResult").ParseError, never>;
+/**
+ * Deep merge two Polen config inputs.
+ * The second config (overrides) takes precedence over the first (base).
+ */
+export declare const mergeInputs: (base?: ConfigInput | undefined, overrides?: ConfigInput | undefined) => ConfigInput;
+export declare const defineConfig: (props: void | {
+    readonly build?: {
+        readonly architecture?: "ssr" | "ssg" | "spa" | undefined;
+        readonly base?: string | undefined;
+    } | undefined;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly examples?: {
+        readonly enabled?: boolean | undefined;
+        readonly display?: "all" | "none" | {
+            readonly include: readonly string[];
+        } | {
+            readonly exclude: readonly string[];
+        } | undefined;
+        readonly diagnostics?: {
+            readonly validation?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly unusedVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly duplicateContent?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly missingVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly schema?: {
+        readonly enabled?: boolean | undefined;
+        readonly augmentations?: readonly {
+            readonly type: "description";
+            readonly content: string;
+            readonly on: {
+                readonly name: string;
+                readonly type: "TargetType";
+            } | {
+                readonly name: string;
+                readonly type: "TargetField";
+                readonly targetType: string;
+            };
+            readonly placement: "before" | "after" | "over";
+        }[] | undefined;
+        readonly useSources?: "file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile" | readonly ("file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile")[] | undefined;
+        readonly sources?: {
+            readonly file?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly directory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly versionedDirectory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly memory?: {
+                readonly revisions: unknown;
+            } | undefined;
+            readonly introspection?: {
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly url: string;
+            } | undefined;
+            readonly introspectionFile?: {
+                readonly path?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly templateVariables?: {
+        readonly title?: string | undefined;
+    } | undefined;
+    readonly home?: {
+        readonly enabled?: boolean | undefined;
+        readonly examples?: boolean | {
+            readonly description?: string | undefined;
+            readonly title?: string | undefined;
+            readonly maxExamples?: number | undefined;
+            readonly only?: readonly string[] | undefined;
+            readonly exclude?: readonly string[] | undefined;
+        } | undefined;
+        readonly topics?: readonly string[] | undefined;
+        readonly hero?: boolean | {
+            readonly title?: string | undefined;
+            readonly tagline?: string | undefined;
+            readonly callToActions?: readonly {
+                readonly label: string;
+                readonly href: string;
+                readonly variant?: "primary" | "secondary" | undefined;
+            }[] | {
+                readonly before?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly after?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly over?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+            } | undefined;
+            readonly layout?: "asymmetric" | "cinematic" | "auto" | undefined;
+            readonly prompt?: string | undefined;
+            readonly heroImage?: string | {
+                readonly src?: string | undefined;
+                readonly ai?: {
+                    readonly prompt?: string | undefined;
+                    readonly enabled: boolean;
+                    readonly style?: "modern" | "minimalist" | "abstract" | "technical" | "vibrant" | "professional" | "futuristic" | "gradient" | "geometric" | "illustration" | undefined;
+                    readonly width?: number | undefined;
+                    readonly height?: number | undefined;
+                    readonly seed?: number | undefined;
+                    readonly nologo?: boolean | undefined;
+                    readonly cache?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        readonly socialProof?: boolean | {
+            readonly title?: string | undefined;
+            readonly logos: readonly (string | {
+                readonly src: string;
+                readonly name: string;
+                readonly href?: string | undefined;
+            })[];
+        } | undefined;
+        readonly socialMedia?: boolean | {
+            readonly posts: readonly {
+                readonly platform: "x" | "twitter" | "bluesky" | "mastodon";
+                readonly id: string;
+                readonly embedCode?: string | undefined;
+            }[];
+            readonly displayMode?: "embed" | "screenshot" | undefined;
+        } | undefined;
+        readonly quickStart?: boolean | {
+            readonly tabs?: readonly ("setup" | "examples" | "playground")[] | undefined;
+            readonly playground?: {
+                readonly endpoint?: string | undefined;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly defaultQuery?: string | undefined;
+                readonly useMockData?: boolean | undefined;
+            } | undefined;
+            readonly steps?: readonly {
+                readonly description?: string | undefined;
+                readonly title: string;
+                readonly code: string;
+                readonly language?: string | undefined;
+            }[] | undefined;
+            readonly languages?: readonly string[] | undefined;
+        } | undefined;
+        readonly stats?: boolean | {
+            readonly showSchemaStats?: boolean | undefined;
+            readonly statusEndpoint?: string | undefined;
+            readonly customMetrics?: readonly {
+                readonly label: string;
+                readonly value: string | number;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+        readonly changelog?: boolean | {
+            readonly limit?: number | undefined;
+            readonly showVersions?: boolean | undefined;
+        } | undefined;
+        readonly resources?: boolean | {
+            readonly links?: readonly {
+                readonly description?: string | undefined;
+                readonly href: string;
+                readonly title: string;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+            readonly communityLinks?: readonly {
+                readonly href: string;
+                readonly platform: string;
+            }[] | undefined;
+            readonly supportContact?: {
+                readonly href?: string | undefined;
+                readonly email?: string | undefined;
+                readonly text?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly branding?: {
+        readonly logoDesignedFor?: "light" | "dark" | undefined;
+    } | undefined;
+    readonly server?: {
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly warnings?: {
+        readonly interactiveWithoutSchema?: {
+            readonly enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    readonly advanced?: {
+        readonly explorer?: boolean | undefined;
+        readonly isSelfContainedMode?: boolean | undefined;
+        readonly debug?: boolean | undefined;
+        readonly vite?: any;
+        readonly paths?: {
+            readonly devAssets?: string | undefined;
+        } | undefined;
+    } | undefined;
+}, options?: S.MakeOptions) => {
+    readonly build?: {
+        readonly architecture?: "ssr" | "ssg" | "spa" | undefined;
+        readonly base?: string | undefined;
+    } | undefined;
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly examples?: {
+        readonly enabled?: boolean | undefined;
+        readonly display?: "all" | "none" | {
+            readonly include: readonly string[];
+        } | {
+            readonly exclude: readonly string[];
+        } | undefined;
+        readonly diagnostics?: {
+            readonly validation?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly unusedVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly duplicateContent?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+            readonly missingVersions?: boolean | {
+                readonly build?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+                readonly enabled: boolean;
+                readonly dev?: {
+                    readonly enabled?: boolean | undefined;
+                    readonly severity?: "error" | "warning" | "info" | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly schema?: {
+        readonly enabled?: boolean | undefined;
+        readonly augmentations?: readonly {
+            readonly type: "description";
+            readonly content: string;
+            readonly on: {
+                readonly name: string;
+                readonly type: "TargetType";
+            } | {
+                readonly name: string;
+                readonly type: "TargetField";
+                readonly targetType: string;
+            };
+            readonly placement: "before" | "after" | "over";
+        }[] | undefined;
+        readonly useSources?: "file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile" | readonly ("file" | "directory" | "versionedDirectory" | "memory" | "introspection" | "introspectionFile")[] | undefined;
+        readonly sources?: {
+            readonly file?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly directory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly versionedDirectory?: {
+                readonly path?: string | undefined;
+            } | undefined;
+            readonly memory?: {
+                readonly revisions: unknown;
+            } | undefined;
+            readonly introspection?: {
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly url: string;
+            } | undefined;
+            readonly introspectionFile?: {
+                readonly path?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly templateVariables?: {
+        readonly title?: string | undefined;
+    } | undefined;
+    readonly home?: {
+        readonly enabled?: boolean | undefined;
+        readonly examples?: boolean | {
+            readonly description?: string | undefined;
+            readonly title?: string | undefined;
+            readonly maxExamples?: number | undefined;
+            readonly only?: readonly string[] | undefined;
+            readonly exclude?: readonly string[] | undefined;
+        } | undefined;
+        readonly topics?: readonly string[] | undefined;
+        readonly hero?: boolean | {
+            readonly title?: string | undefined;
+            readonly tagline?: string | undefined;
+            readonly callToActions?: readonly {
+                readonly label: string;
+                readonly href: string;
+                readonly variant?: "primary" | "secondary" | undefined;
+            }[] | {
+                readonly before?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly after?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+                readonly over?: readonly {
+                    readonly label: string;
+                    readonly href: string;
+                    readonly variant?: "primary" | "secondary" | undefined;
+                }[] | undefined;
+            } | undefined;
+            readonly layout?: "asymmetric" | "cinematic" | "auto" | undefined;
+            readonly prompt?: string | undefined;
+            readonly heroImage?: string | {
+                readonly src?: string | undefined;
+                readonly ai?: {
+                    readonly prompt?: string | undefined;
+                    readonly enabled: boolean;
+                    readonly style?: "modern" | "minimalist" | "abstract" | "technical" | "vibrant" | "professional" | "futuristic" | "gradient" | "geometric" | "illustration" | undefined;
+                    readonly width?: number | undefined;
+                    readonly height?: number | undefined;
+                    readonly seed?: number | undefined;
+                    readonly nologo?: boolean | undefined;
+                    readonly cache?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        readonly socialProof?: boolean | {
+            readonly title?: string | undefined;
+            readonly logos: readonly (string | {
+                readonly src: string;
+                readonly name: string;
+                readonly href?: string | undefined;
+            })[];
+        } | undefined;
+        readonly socialMedia?: boolean | {
+            readonly posts: readonly {
+                readonly platform: "x" | "twitter" | "bluesky" | "mastodon";
+                readonly id: string;
+                readonly embedCode?: string | undefined;
+            }[];
+            readonly displayMode?: "embed" | "screenshot" | undefined;
+        } | undefined;
+        readonly quickStart?: boolean | {
+            readonly tabs?: readonly ("setup" | "examples" | "playground")[] | undefined;
+            readonly playground?: {
+                readonly endpoint?: string | undefined;
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | undefined;
+                readonly defaultQuery?: string | undefined;
+                readonly useMockData?: boolean | undefined;
+            } | undefined;
+            readonly steps?: readonly {
+                readonly description?: string | undefined;
+                readonly title: string;
+                readonly code: string;
+                readonly language?: string | undefined;
+            }[] | undefined;
+            readonly languages?: readonly string[] | undefined;
+        } | undefined;
+        readonly stats?: boolean | {
+            readonly showSchemaStats?: boolean | undefined;
+            readonly statusEndpoint?: string | undefined;
+            readonly customMetrics?: readonly {
+                readonly label: string;
+                readonly value: string | number;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+        readonly changelog?: boolean | {
+            readonly limit?: number | undefined;
+            readonly showVersions?: boolean | undefined;
+        } | undefined;
+        readonly resources?: boolean | {
+            readonly links?: readonly {
+                readonly description?: string | undefined;
+                readonly href: string;
+                readonly title: string;
+                readonly icon?: string | undefined;
+            }[] | undefined;
+            readonly communityLinks?: readonly {
+                readonly href: string;
+                readonly platform: string;
+            }[] | undefined;
+            readonly supportContact?: {
+                readonly href?: string | undefined;
+                readonly email?: string | undefined;
+                readonly text?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    readonly branding?: {
+        readonly logoDesignedFor?: "light" | "dark" | undefined;
+    } | undefined;
+    readonly server?: {
+        readonly port?: number | undefined;
+    } | undefined;
+    readonly warnings?: {
+        readonly interactiveWithoutSchema?: {
+            readonly enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    readonly advanced?: {
+        readonly explorer?: boolean | undefined;
+        readonly isSelfContainedMode?: boolean | undefined;
+        readonly debug?: boolean | undefined;
+        readonly vite?: any;
+        readonly paths?: {
+            readonly devAssets?: string | undefined;
+        } | undefined;
+    } | undefined;
+};
+export {};
+//# sourceMappingURL=input.d.ts.map