@zpress/config 0.2.2 → 0.4.0

package/dist/index.d.ts

@@ -22,8 +22,8 @@ export { BuiltInThemeName }
  * Controls how an entry appears as a card on its parent section's
  * auto-generated landing page.
  *
- * When present, the landing page uses workspace-style cards
- * (icon + scope + name + description + tags + optional badge).
+ * Schema: `cardConfigSchema` in schema.ts validates this shape.
+ * A compile-time guard in schema.ts ensures these stay in sync.
  *
  * @example
  * ```ts
@@ -37,28 +37,13 @@ export { BuiltInThemeName }
  * ```
  */
 export declare interface CardConfig {
-    /**
-     * Icon configuration — Iconify identifier string or `{ id, color }` object.
-     */
-    icon?: IconConfig;
-    /**
-     * Scope label shown above the name (e.g. `"apps/"`).
-     */
-    scope?: string;
-    /**
-     * Short description shown on the card. Overrides auto-extracted description.
-     */
-    description?: string;
-    /**
-     * Technology tags shown at the bottom of the card.
-     */
-    tags?: string[];
-    /**
-     * Deploy badge image shown in the card header.
-     */
-    badge?: {
-        src: string;
-        alt: string;
+    readonly icon?: IconConfig;
+    readonly scope?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly badge?: {
+        readonly src: string;
+        readonly alt: string;
     };
 }
 
@@ -76,11 +61,24 @@ export declare interface ConfigError {
     }[];
 }
 
+/**
+ * Create a ConfigError with the given type and message.
+ *
+ * @param type - The error type discriminant
+ * @param message - Human-readable error message
+ * @returns A ConfigError object
+ */
 export declare function configError(type: ConfigErrorType, message: string): ConfigError;
 
+/**
+ * Convert a Zod validation error into a ConfigError.
+ *
+ * @param zodError - The ZodError produced by a failed safeParse call
+ * @returns A ConfigError with type `'validation_failed'` and mapped issue list
+ */
 export declare function configErrorFromZod(zodError: ZodError): ConfigError;
 
-export declare type ConfigErrorType = 'not_found' | 'parse_error' | 'validation_failed' | 'empty_sections' | 'missing_field' | 'invalid_entry' | 'invalid_section' | 'invalid_field' | 'invalid_icon' | 'invalid_theme' | 'duplicate_prefix' | 'unknown';
+export declare type ConfigErrorType = 'not_found' | 'parse_error' | 'validation_failed' | 'empty_sections' | 'missing_field' | 'invalid_entry' | 'invalid_section' | 'invalid_field' | 'invalid_icon' | 'invalid_theme' | 'duplicate_prefix' | 'invalid_openapi' | 'unknown';
 
 export declare type ConfigResult<T> = Result<T, ConfigError>;
 
@@ -95,87 +93,10 @@ export declare type ConfigResult<T> = Result<T, ConfigError>;
  */
 export declare function defineConfig(config: ZpressConfig): ZpressConfig;
 
-/**
- * Unified discovery configuration with properly typed recursion dependency.
- */
-export declare type Discovery = FlatDiscoveryConfig | RecursiveDiscoveryConfig;
-
-/**
- * Content discovery configuration for auto-generating pages from files.
- */
-declare interface DiscoveryConfig {
-    /**
-     * Content source — file path or glob pattern.
-     * - **No wildcards** → single file (e.g. `"docs/overview.md"`)
-     * - **With wildcards** → auto-discover children (e.g. `"docs/*.md"`)
-     */
-    readonly from?: string | GlobPattern;
-    /**
-     * Title configuration for auto-discovered children.
-     * @default { from: 'auto' }
-     */
-    readonly title?: TitleConfig;
-    /**
-     * Sort order for auto-discovered children.
-     * - `"alpha"` — alphabetical by derived title (default)
-     * - `"filename"` — alphabetical by filename
-     * - Custom comparator function
-     */
-    readonly sort?: 'alpha' | 'filename' | ((a: ResolvedPage, b: ResolvedPage) => number);
-    /**
-     * Exclude globs, scoped to this discovery's `from` glob.
-     */
-    readonly exclude?: readonly GlobPattern[];
-    /**
-     * Frontmatter injected at build time for all discovered pages.
-     */
-    readonly frontmatter?: Frontmatter;
-}
-
-/**
- * Base type for all config entries — shared display metadata.
- *
- * All types in the information architecture (Section, Workspace, WorkspaceCategory, Feature)
- * extend this base to inherit common display fields.
- */
-export declare interface Entry {
-    /**
-     * Display title shown in UI (sidebar, nav, cards).
-     * Can be a static string or a configuration for deriving from files.
-     */
-    readonly title: string | TitleConfig;
-    /**
-     * Icon configuration — Iconify identifier string or `{ id, color }` object.
-     *
-     * Accepts either:
-     * - **String**: Iconify identifier (e.g. `"devicon:hono"`, `"pixelarticons:device-mobile"`)
-     *   - Color defaults to purple (first in rotation)
-     *   - Find icons at https://icon-sets.iconify.design/
-     * - **Object**: `{ id: IconId, color: IconColor }`
-     *   - Explicit color from 8-color palette
-     *
-     * Auto-generated section cards rotate through these colors:
-     * purple → blue → green → amber → cyan → red → pink → slate
-     *
-     * @example
-     * ```ts
-     * icon: 'devicon:react'  // Uses purple (default)
-     * icon: { id: 'devicon:nextjs', color: 'blue' }  // Explicit blue
-     * ```
-     */
-    readonly icon?: IconConfig;
-    /**
-     * Short description for cards and summaries.
-     */
-    readonly description?: string;
-}
-
 /**
  * Explicit feature card for the home page.
  *
- * When `features` is provided on the config, these replace the
- * auto-generated feature cards that are normally derived from
- * top-level sections.
+ * Schema: `featureSchema` in schema.ts validates this shape.
  *
  * @example
  * ```ts
@@ -187,33 +108,48 @@ export declare interface Entry {
  * }
  * ```
  */
-export declare interface Feature extends Entry {
-    /**
-     * Link target when the card is clicked.
-     */
-    readonly link: string;
+export declare interface Feature {
+    readonly title: TitleConfig;
+    readonly description: string;
+    readonly link?: string;
+    readonly icon?: IconConfig;
 }
 
 /**
- * Relative file path from repo root (e.g. `"docs/guides/add-api-route.md"`)
+ * File-system path (absolute or relative).
  */
 declare type FilePath = string;
 
 /**
- * Flat (non-recursive) discovery configuration.
+ * Site footer shown below all page content.
+ *
+ * Schema: `footerConfigSchema` in schema.ts validates this shape.
+ *
+ * @example
+ * ```ts
+ * footer: {
+ *   message: 'Built with zpress',
+ *   copyright: 'Copyright © 2025 Acme Inc.',
+ * }
+ * ```
  */
-export declare interface FlatDiscoveryConfig extends DiscoveryConfig {
-    readonly recursive?: false;
+export declare interface FooterConfig {
+    readonly message?: string;
+    readonly copyright?: string;
+    readonly socials?: boolean;
 }
 
 /**
  * Rspress frontmatter fields injectable at build time.
+ *
+ * Schema: `frontmatterSchema` in schema.ts validates this shape.
+ * The index signature allows arbitrary extra fields (schema uses `.passthrough()`).
  */
 export declare interface Frontmatter {
     readonly title?: string;
     readonly titleTemplate?: string | boolean;
     readonly description?: string;
-    readonly layout?: 'doc' | 'page' | 'home' | (string & {});
+    readonly layout?: string;
     readonly sidebar?: boolean;
     readonly aside?: boolean | 'left';
     readonly outline?: false | number | [number, number] | 'deep';
@@ -223,45 +159,44 @@ export declare interface Frontmatter {
     readonly footer?: boolean;
     readonly pageClass?: string;
     readonly head?: readonly [string, Record<string, string>][];
-    /**
-     * Arbitrary extra fields merged into frontmatter.
-     */
     readonly [key: string]: unknown;
 }
 
 /**
- * Glob pattern (e.g. `"docs/guides/*.md"`)
+ * A single call-to-action button on the home page hero.
+ *
+ * Schema: `heroActionSchema` in schema.ts validates this shape.
  */
-declare type GlobPattern = string;
+export declare interface HeroAction {
+    readonly theme: 'brand' | 'alt';
+    readonly text: string;
+    readonly link: string;
+}
 
 /**
- * Hero section configuration override.
+ * Home page layout customization.
+ *
+ * Schema: `homeConfigSchema` in schema.ts validates this shape.
+ *
+ * @example
+ * ```ts
+ * home: {
+ *   features: { columns: 3, truncate: { description: 2 } },
+ *   workspaces: { columns: 2, truncate: { title: 1, description: 2 } },
+ * }
+ * ```
  */
-export declare interface HeroConfig {
-    /**
-     * Main hero title. Overrides site title on home page.
-     */
-    readonly title?: string;
-    /**
-     * Hero subtitle/headline. Overrides site description on home page.
-     */
-    readonly subtitle?: string;
-    /**
-     * Hero tagline. Overrides site tagline on home page.
-     */
-    readonly tagline?: string;
-    /**
-     * Hero image path. Defaults to "/banner.svg".
-     */
-    readonly image?: string;
-    /**
-     * Call-to-action buttons.
-     */
-    readonly actions?: readonly {
-        readonly theme: 'brand' | 'alt';
-        readonly text: string;
-        readonly link: string;
-    }[];
+export declare interface HomeConfig {
+    readonly features?: HomeGridConfig;
+    readonly workspaces?: HomeGridConfig;
+}
+
+/**
+ * Layout and styling options for a card grid section on the home page.
+ */
+export declare interface HomeGridConfig {
+    readonly columns?: 1 | 2 | 3 | 4;
+    readonly truncate?: TruncateConfig;
 }
 
 export { ICON_COLORS }
@@ -293,10 +228,19 @@ export declare type IconConfig = IconId | {
 };
 
 /**
- * Iconify icon identifier (e.g. `"devicon:hono"`, `"pixelarticons:device-mobile"`).
- * Find icons at https://icon-sets.iconify.design/
+ * Iconify icon identifier — `"prefix:name"` where prefix matches an installed set.
+ *
+ * @example `"devicon:hono"`, `"pixelarticons:device-mobile"`
+ * @see https://icon-sets.iconify.design/
+ */
+export declare type IconId = `${IconPrefix}:${string}`;
+
+/**
+ * Installed Iconify icon-set prefixes.
+ *
+ * Must stay in sync with `@iconify-json/*` packages in root `package.json`.
  */
-export declare type IconId = string;
+export declare type IconPrefix = 'catppuccin' | 'devicon' | 'logos' | 'material-icon-theme' | 'mdi' | 'pixelarticons' | 'simple-icons' | 'skill-icons' | 'vscode-icons';
 
 export { isBuiltInIconColor }
 
@@ -328,9 +272,15 @@ export declare interface LoadConfigOptions {
     readonly configFile?: string;
 }
 
+/**
+ * Navigation item for the top nav bar.
+ *
+ * Schema: `navItemSchema` in schema.ts validates this shape.
+ * The schema uses `z.ZodType<NavItem>` to enforce consistency.
+ */
 export declare interface NavItem {
     readonly title: string;
-    readonly link?: UrlPath;
+    readonly link?: string;
     readonly items?: readonly NavItem[];
     readonly activeMatch?: string;
 }
@@ -342,16 +292,25 @@ export declare interface OpenAPIConfig {
     /**
      * Path to openapi.json relative to repo root.
      */
-    spec: FilePath;
+    readonly spec: FilePath;
     /**
-     * URL prefix for API operation pages (e.g., '/api').
+     * URL path for API operation pages (e.g., '/api').
      */
-    prefix: UrlPath;
+    readonly path: UrlPath;
     /**
      * Sidebar group title.
      * @default 'API Reference'
      */
-    title?: string;
+    readonly title?: string;
+    /**
+     * How operations appear in the sidebar.
+     *
+     * - `'method-path'` — shows `GET /users` with method badge and path in code font
+     * - `'title'` — shows the operation summary (e.g., "List Users")
+     *
+     * @default 'method-path'
+     */
+    readonly sidebarLayout?: 'method-path' | 'title';
 }
 
 export declare const pathsSchema: z.ZodObject<{
@@ -377,40 +336,15 @@ export declare const pathsSchema: z.ZodObject<{
     cacheDir: string;
 }>;
 
-/**
- * Recursive directory-based discovery configuration.
- * Type-enforces that `indexFile` only exists when `recursive: true`.
- */
-export declare interface RecursiveDiscoveryConfig extends DiscoveryConfig {
-    readonly recursive: true;
-    /**
-     * Filename (without extension) used as the section header page in each directory.
-     * @default "overview"
-     */
-    readonly indexFile?: string;
-}
-
 export { resolveDefaultColorMode }
 
 /**
  * A fully resolved page after the sync engine processes the config.
  */
 export declare interface ResolvedPage {
-    /**
-     * Display title.
-     */
     readonly title: string;
-    /**
-     * Output URL path.
-     */
-    readonly link: UrlPath;
-    /**
-     * Source file path (undefined for virtual pages).
-     */
-    readonly source?: FilePath;
-    /**
-     * Merged frontmatter.
-     */
+    readonly link: string;
+    readonly source?: string;
     readonly frontmatter: Frontmatter;
 }
 
@@ -419,48 +353,11 @@ export declare interface ResolvedPage {
  */
 export declare interface ResolvedSection {
     readonly title: string;
-    readonly link?: UrlPath;
+    readonly link?: string;
     readonly collapsible?: boolean;
     readonly items: readonly (ResolvedPage | ResolvedSection)[];
 }
 
-/**
- * zpress — unified information architecture config.
- *
- * The IA tree IS the config. Each node defines what it is, where its
- * content comes from, and where it sits in the sidebar — all in one place.
- * Source `.md` files are never edited.
- *
- * @example
- * ```ts
- * import { defineConfig } from '@zpress/core'
- *
- * export default defineConfig({
- *   title: 'My Docs',
- *   sections: [
- *     {
- *       title: 'Introduction',
- *       items: [
- *         { title: 'Architecture', link: '/architecture', from: 'docs/architecture.md' },
- *         { title: 'Structure', link: '/structure', from: 'docs/structure.md' },
- *       ],
- *     },
- *     {
- *       title: 'Guides',
- *       prefix: '/guides',
- *       from: 'docs/guides/*.md',
- *     },
- *     {
- *       title: 'API Reference',
- *       items: [
- *         { title: 'Overview', link: '/api/overview', content: '# API\n...' },
- *         { title: 'Routes', link: '/api/routes', from: 'apps/api/docs/routes.md' },
- *       ],
- *     },
- *   ],
- * })
- * ```
- */
 /**
  * Result type for error handling without exceptions.
  *
@@ -478,16 +375,17 @@ export declare type Result<T, E = Error> = readonly [E, null] | readonly [null,
 /**
  * A single node in the information architecture (sidebar/nav tree).
  *
- * Goes in `config.sections` array. Can be a page, section, or both.
+ * Schema: `entrySchema` in schema.ts validates this shape.
+ * The schema uses `z.ZodType<Section>` to enforce consistency.
  *
  * **Page — explicit file**:
  * ```ts
- * { title: 'Architecture', link: '/architecture', from: 'docs/architecture.md' }
+ * { title: 'Architecture', path: '/architecture', include: 'docs/architecture.md' }
  * ```
  *
  * **Page — inline/generated content**:
  * ```ts
- * { title: 'Overview', link: '/api/overview', content: '# API Overview\n...' }
+ * { title: 'Overview', path: '/api/overview', content: '# API Overview\n...' }
  * ```
  *
  * **Section — explicit children**:
@@ -497,194 +395,93 @@ export declare type Result<T, E = Error> = readonly [E, null] | readonly [null,
  *
  * **Section — auto-discovered from glob**:
  * ```ts
- * { title: 'Guides', prefix: '/guides', from: 'docs/guides/*.md' }
- * ```
- *
- * **Section — mix of explicit + auto-discovered**:
- * ```ts
- * {
- *   title: 'Guides',
- *   prefix: '/guides',
- *   from: 'docs/guides/*.md',
- *   items: [
- *     { title: 'Getting Started', link: '/guides/start', from: 'docs/intro.md' },
- *   ],
- * }
+ * { title: 'Guides', path: '/guides', include: 'docs/guides/*.md' }
  * ```
  */
-export declare interface Section extends Entry {
-    /**
-     * Output URL path.
-     * - Pages: exact URL (e.g. `"/guides/add-api-route"`)
-     * - Sections: optional — makes the section header clickable
-     */
-    readonly link?: UrlPath;
-    /**
-     * Content source — file path or glob, relative to repo root.
-     *
-     * - **No wildcards** → single file (e.g. `"docs/architecture.md"`)
-     * - **With wildcards** → auto-discover children (e.g. `"docs/guides/*.md"`)
-     */
-    readonly from?: FilePath | GlobPattern;
-    /**
-     * URL prefix for auto-discovered children.
-     * Used with glob `from` — each discovered file gets `prefix + "/" + slug`.
-     *
-     * @example
-     * `prefix: "/guides"` + file `add-api-route.md` → `/guides/add-api-route`
-     */
-    readonly prefix?: UrlPath;
-    /**
-     * Inline markdown or async content generator.
-     * For virtual pages that have no source `.md` file.
-     * Mutually exclusive with `from`.
-     */
+export declare interface Section {
+    readonly title: TitleConfig;
+    readonly description?: string;
+    readonly path?: string;
+    readonly include?: string | readonly string[];
     readonly content?: string | (() => string | Promise<string>);
-    /**
-     * Child entries — pages and/or sub-sections.
-     */
     readonly items?: readonly Section[];
-    /**
-     * Landing page generation strategy for sections with children.
-     *
-     * - `"auto"` (default) — generate cards from children, or promote overview/index if found
-     * - `"cards"` — always generate cards, never promote overview files
-     * - `"overview"` — only use overview file if found, no auto-generation
-     * - `false` — disable landing page (section header not clickable unless explicit `from`)
-     *
-     * Only applies to sections with `items`.
-     * Requires `link` to be set.
-     */
-    readonly landing?: 'auto' | 'cards' | 'overview' | false;
-    /**
-     * Make this section collapsible in the sidebar.
-     *
-     * - `true` — always collapsible
-     * - `false` — never collapsible (keeps deep sections always-open)
-     * - `undefined` (default) — auto-collapsible when depth > 1
-     */
+    readonly landing?: boolean;
     readonly collapsible?: boolean;
-    /**
-     * Exclude globs, scoped to this section's `from` glob.
-     */
-    readonly exclude?: readonly GlobPattern[];
-    /**
-     * Hide from sidebar. Page is still built and routable.
-     * Useful for pages that should exist but not clutter navigation.
-     */
+    readonly exclude?: readonly string[];
     readonly hidden?: boolean;
-    /**
-     * Isolate this section into its own Rspress sidebar namespace.
-     *
-     * When `true`, the section's children appear under a dedicated sidebar
-     * keyed by `link` (e.g. `"/apps/"`) instead of the root `"/"` sidebar.
-     * This mirrors how the OpenAPI reference already works.
-     *
-     * Note: Isolated sections are excluded from `nav: "auto"` generation.
-     *
-     * Requires `link` to be set.
-     * @default false
-     */
-    readonly isolated?: boolean;
-    /**
-     * Frontmatter injected at build time.
-     * - On a page: applied to that page.
-     * - On a section: applied to all pages within.
-     */
     readonly frontmatter?: Frontmatter;
-    /**
-     * How to derive `title` for auto-discovered children.
-     * - `"filename"` — kebab-to-title from filename (default)
-     * - `"heading"` — first `# heading` in the file
-     * - `"frontmatter"` — `title` field from YAML frontmatter, falls back to heading
-     * - `"auto"` — frontmatter > heading > filename fallback chain
-     *
-     * @deprecated Use `title: { from: 'auto' }` instead
-     */
-    readonly titleFrom?: 'filename' | 'heading' | 'frontmatter' | 'auto';
-    /**
-     * Transform function applied to auto-derived title (from `titleFrom`).
-     * Called after title derivation for glob-discovered and recursive children.
-     * Does NOT apply to sections with explicit `title` string (those are already user-controlled).
-     *
-     * @param title - The derived title (from heading or filename)
-     * @param slug - The filename slug (without extension)
-     * @returns Transformed title for sidebar display
-     *
-     * @deprecated Use `title: { from: 'auto', transform: ... }` instead
-     */
-    readonly titleTransform?: (title: string, slug: string) => string;
-    /**
-     * Sort order for auto-discovered children.
-     * - `"alpha"` — alphabetical by derived title (default)
-     * - `"filename"` — alphabetical by filename
-     * - Custom comparator function
-     */
-    readonly sort?: 'alpha' | 'filename' | ((a: ResolvedPage, b: ResolvedPage) => number);
-    /**
-     * Enable recursive directory-based nesting for glob patterns.
-     * When true, directory structure under the glob base drives sidebar nesting:
-     * - The `indexFile` (default `"overview"`) in a directory becomes the section header page
-     * - Other `.md` files become children
-     * - Sub-directories become nested collapsible sections
-     *
-     * Requires `from` with a recursive glob (e.g. `"docs/**\/*.md"`) and `prefix`.
-     * @default false
-     */
+    readonly sort?: 'default' | 'alpha' | 'filename' | ((a: ResolvedPage, b: ResolvedPage) => number);
     readonly recursive?: boolean;
-    /**
-     * Filename (without extension) used as the section header page in each directory.
-     * Only meaningful when `recursive` is true.
-     * @default "overview"
-     */
-    readonly indexFile?: string;
-    /**
-     * Card display metadata for the parent section's auto-generated landing page.
-     *
-     * When present on child sections, the parent's landing page uses
-     * workspace-style cards instead of the default simple cards.
-     */
+    readonly entryFile?: string;
+    readonly icon?: IconConfig;
     readonly card?: CardConfig;
-    /**
-     * SEO meta tag overrides for this page.
-     * Merges with site-level SEO config.
-     */
-    readonly seo?: SeoConfig;
+    readonly standalone?: boolean;
 }
 
 /**
- * SEO meta tag configuration.
+ * Sidebar configuration.
+ *
+ * Schema: `sidebarConfigSchema` in schema.ts validates this shape.
+ *
+ * @example
+ * ```ts
+ * sidebar: {
+ *   above: [
+ *     { text: 'Home', link: '/', icon: 'pixelarticons:home' },
+ *   ],
+ *   below: [
+ *     { text: 'GitHub', link: 'https://github.com/...', icon: 'pixelarticons:github' },
+ *     { text: 'Discord', link: 'https://discord.gg/...', icon: 'pixelarticons:message' },
+ *   ],
+ * }
+ * ```
  */
-export declare interface SeoConfig {
-    /**
-     * Meta title (for `<title>` tag and og:title).
-     * Falls back to site title or page title.
-     */
-    readonly title?: string;
-    /**
-     * Meta description (for description and og:description).
-     * Falls back to site description or auto-generated from content.
-     */
-    readonly description?: string;
-    /**
-     * Open Graph image URL.
-     * Falls back to `/og-image.png` (auto-generated from banner.svg).
-     */
-    readonly image?: string;
-    /**
-     * OG site name. Defaults to site title.
-     */
-    readonly siteName?: string;
-    /**
-     * OG locale (e.g. "en_US"). Defaults to "en_US".
-     */
-    readonly locale?: string;
-    /**
-     * Twitter card type. Defaults to "summary_large_image".
-     */
-    readonly twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player';
+export declare interface SidebarConfig {
+    readonly above?: readonly SidebarLink[];
+    readonly below?: readonly SidebarLink[];
+}
+
+/**
+ * A persistent link rendered above or below the sidebar nav tree.
+ *
+ * Schema: `sidebarLinkSchema` in schema.ts validates this shape.
+ */
+export declare interface SidebarLink {
+    readonly text: string;
+    readonly link: string;
+    readonly icon?: IconConfig;
+    readonly style?: 'brand' | 'alt' | 'ghost';
+    readonly shape?: 'square' | 'rounded' | 'circle';
 }
 
+/**
+ * A social link shown in the navigation bar.
+ *
+ * Schema: `socialLinkSchema` in schema.ts validates this shape.
+ *
+ * @example
+ * ```ts
+ * socialLinks: [
+ *   { icon: 'github', mode: 'link', content: 'https://github.com/acme' },
+ *   { icon: 'discord', mode: 'link', content: 'https://discord.gg/acme' },
+ * ]
+ * ```
+ */
+export declare interface SocialLink {
+    readonly icon: SocialLinkIcon | {
+        readonly svg: string;
+    };
+    readonly mode: 'link' | 'text' | 'img' | 'dom';
+    readonly content: string;
+}
+
+/**
+ * Built-in social link icon identifier.
+ *
+ * Rspress supports these icons out of the box via `virtual-social-links`.
+ */
+export declare type SocialLinkIcon = 'lark' | 'discord' | 'facebook' | 'github' | 'instagram' | 'linkedin' | 'slack' | 'x' | 'youtube' | 'wechat' | 'qq' | 'juejin' | 'zhihu' | 'bilibili' | 'weibo' | 'gitlab' | 'X' | 'bluesky' | 'npm';
+
 export { THEME_NAMES }
 
 export { ThemeColors }
@@ -696,6 +493,8 @@ export { ThemeName }
 /**
  * Title configuration — static or derived from source files.
  *
+ * Schema: `titleConfigSchema` in schema.ts validates this shape.
+ *
  * **Static title**:
  * ```ts
  * title: "Getting Started"
@@ -725,7 +524,18 @@ export declare type TitleConfig = string | {
 };
 
 /**
- * URL path (e.g. `"/guides/add-api-route"`)
+ * Text truncation configuration for card content.
+ *
+ * Values represent the maximum number of visible lines before
+ * overflow is clipped with an ellipsis via CSS `line-clamp`.
+ */
+export declare interface TruncateConfig {
+    readonly title?: number;
+    readonly description?: number;
+}
+
+/**
+ * URL path segment (e.g. `"/api"`, `"/guides/auth"`).
  */
 declare type UrlPath = string;
 
@@ -740,185 +550,90 @@ export declare function validateConfig(config: unknown): ConfigResult<ZpressConf
 /**
  * Workspace item representing an app or package in the monorepo.
  *
- * Used as the single source of truth for workspace metadata — home page cards,
- * landing page cards, and introduction bullets all derive from these arrays.
+ * Schema: `workspaceItemSchema` in schema.ts validates this shape.
  *
  * @example
  * ```ts
  * {
  *   title: 'API',
  *   icon: 'devicon:hono',
- *   description: 'Hono REST API serving all client applications with RPC-typed routes',
+ *   description: 'Hono REST API serving all client applications',
  *   tags: ['hono', 'react', 'vercel'],
- *   badge: { src: '/logos/vercel.svg', alt: 'Vercel' },
- *   prefix: '/apps/api',
- *   discovery: {
- *     from: 'docs/*.md',
- *     title: { from: 'auto' },
- *   },
+ *   path: '/apps/api',
+ *   include: 'docs/*.md',
+ *   sort: 'alpha',
  * }
  * ```
  */
-export declare interface Workspace extends Entry {
-    /**
-     * URL prefix for this workspace item's documentation (e.g. "/apps/api").
-     */
-    readonly prefix: string;
-    /**
-     * Technology tags — kebab-case keys resolved by the UI TechTag component.
-     * Each tag maps to an Iconify icon and display label.
-     */
+export declare interface Workspace {
+    readonly title: TitleConfig;
+    readonly icon?: IconConfig;
+    readonly description: string;
     readonly tags?: readonly string[];
-    /**
-     * Deploy badge image for the card header.
-     */
     readonly badge?: {
         readonly src: string;
         readonly alt: string;
     };
-    /**
-     * Content discovery configuration for this workspace item's documentation.
-     * The `from` field is **relative to the workspace base path** (derived from `prefix`).
-     *
-     * For example, `prefix: "/apps/api"` + `discovery.from: "docs/*.md"`
-     * resolves to `apps/api/docs/*.md` (repo-root relative).
-     *
-     * @default { from: "docs/*.md", title: { from: 'auto' } }
-     */
-    readonly discovery?: Discovery;
-    /**
-     * Explicit child sections. Can be combined with discovery — explicit children override glob-discovered pages.
-     */
+    readonly path: string;
+    readonly include?: string | readonly string[];
     readonly items?: readonly Section[];
-    /**
-     * Make this item's section collapsible in the sidebar.
-     */
-    readonly collapsible?: boolean;
+    readonly sort?: 'default' | 'alpha' | 'filename' | ((a: ResolvedPage, b: ResolvedPage) => number);
+    readonly exclude?: readonly string[];
+    readonly recursive?: boolean;
+    readonly entryFile?: string;
+    readonly frontmatter?: Frontmatter;
+    readonly openapi?: OpenAPIConfig;
 }
 
 /**
  * Custom workspace category grouping apps/packages.
  *
- * Lets users define arbitrary groups beyond the built-in `apps` and `packages`
- * (e.g. "Services", "Tools", "Integrations") that receive the same
- * card/landing-page treatment.
+ * Schema: `workspaceGroupSchema` in schema.ts validates this shape.
  *
  * @example
  * ```ts
  * {
  *   title: 'Integrations',
  *   description: 'Third-party service connectors',
- *   icon: 'pixelarticons:integration',
+ *   icon: 'mdi:puzzle',
  *   items: [
- *     { title: 'Stripe', description: 'Payment processing', prefix: '/integrations/stripe' },
+ *     { title: 'Stripe', description: 'Payment processing', path: '/integrations/stripe' },
  *   ],
  * }
  * ```
  */
-export declare interface WorkspaceCategory extends Entry {
-    /**
-     * Workspace items in this category.
-     */
+export declare interface WorkspaceCategory {
+    readonly title: TitleConfig;
+    readonly description?: string;
+    readonly icon: IconId;
     readonly items: readonly Workspace[];
-    /**
-     * URL prefix override for the category's landing page.
-     * Defaults to `/${slugify(title)}` when omitted.
-     */
     readonly link?: string;
 }
 
 /**
- * @deprecated Use `WorkspaceCategory` instead
- */
-export declare type WorkspaceGroup = WorkspaceCategory;
-
-/**
- * @deprecated Use `Workspace` instead
+ * zpress configuration.
+ *
+ * Schema: `zpressConfigSchema` in schema.ts validates this shape.
+ * The information architecture tree IS the config — each node defines
+ * what it is, where its content comes from, and where it sits in the sidebar.
  */
-export declare type WorkspaceItem = Workspace;
-
 export declare interface ZpressConfig {
-    /**
-     * Site title.
-     */
     readonly title?: string;
-    /**
-     * Site meta description. Used as the hero headline on the home page.
-     */
     readonly description?: string;
-    /**
-     * Theme configuration.
-     * Controls the visual theme, color mode, and optional color overrides.
-     */
     readonly theme?: ThemeConfig;
-    /**
-     * Path to a custom favicon file served from `.zpress/public/`.
-     * When omitted, defaults to the auto-generated `/icon.svg`.
-     */
-    readonly icon?: string;
-    /**
-     * Hero tagline displayed below the headline on the home page.
-     * When omitted, the tagline is not rendered.
-     */
+    readonly icon?: IconId;
     readonly tagline?: string;
-    /**
-     * Hero section override for the home page.
-     * When omitted, uses site-level title, description, and tagline.
-     */
-    readonly hero?: HeroConfig;
-    /**
-     * SEO meta tag configuration for the entire site.
-     * Individual sections can override with their own seo config.
-     */
-    readonly seo?: SeoConfig;
-    /**
-     * Workspace apps — deployable services that make up the platform.
-     * Single source of truth for app metadata used on the home page,
-     * landing pages, and introduction page.
-     */
-    readonly apps?: readonly Workspace[];
-    /**
-     * Workspace packages — shared libraries consumed by apps.
-     * Single source of truth for package metadata used on the home page,
-     * landing pages, and introduction page.
-     */
-    readonly packages?: readonly Workspace[];
-    /**
-     * Custom workspace groups — arbitrary named groups of workspace items.
-     * Each group receives the same card/landing-page treatment as apps and packages.
-     * Rendered after apps and packages, in array order.
-     */
+    readonly actions?: readonly HeroAction[];
     readonly workspaces?: readonly WorkspaceCategory[];
-    /**
-     * Explicit feature cards for the home page.
-     *
-     * When provided, these replace the auto-generated feature cards
-     * that are normally derived from top-level sections.
-     * When omitted, features are auto-generated from sections with icons.
-     */
     readonly features?: readonly Feature[];
-    /**
-     * The information architecture.
-     * Defines content sources, sidebar structure, and routing in a single tree.
-     */
+    readonly sidebar?: SidebarConfig;
     readonly sections: readonly Section[];
-    /**
-     * Top navigation bar.
-     * - `"auto"` (default) — one nav item per top-level non-isolated section
-     * - Array — explicit nav items
-     *
-     * Note: Sections with `isolated: true` are excluded from auto nav generation.
-     * @default "auto"
-     */
     readonly nav?: 'auto' | readonly NavItem[];
-    /**
-     * Globs to exclude globally across all sources.
-     */
-    readonly exclude?: readonly GlobPattern[];
-    /**
-     * OpenAPI spec integration for interactive API docs.
-     */
+    readonly exclude?: readonly string[];
     readonly openapi?: OpenAPIConfig;
+    readonly home?: HomeConfig;
+    readonly socialLinks?: readonly SocialLink[];
+    readonly footer?: FooterConfig;
 }
 
 export declare const zpressConfigSchema: z.ZodObject<{
@@ -1093,48 +808,61 @@ export declare const zpressConfigSchema: z.ZodObject<{
             homeBg?: string | undefined;
         } | undefined;
     }>>;
-    icon: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>>;
     tagline: z.ZodOptional<z.ZodString>;
-    apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    workspaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
         title: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-            transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+            transform: z.ZodOptional<z.ZodType<(text: string, slug: string) => string, z.ZodTypeDef, (text: string, slug: string) => string>>;
         }, "strict", z.ZodTypeAny, {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         }, {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         }>]>;
-        icon: z.ZodOptional<z.ZodString>;
-        iconColor: z.ZodOptional<z.ZodString>;
-        description: z.ZodString;
-        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        badge: z.ZodOptional<z.ZodObject<{
-            src: z.ZodString;
-            alt: z.ZodString;
-        }, "strict", z.ZodTypeAny, {
-            alt: string;
-            src: string;
-        }, {
-            alt: string;
-            src: string;
-        }>>;
-        prefix: z.ZodString;
-        discovery: z.ZodOptional<z.ZodObject<{
-            from: z.ZodOptional<z.ZodString>;
-            title: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>;
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodUnion<[z.ZodString, z.ZodObject<{
                 from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-                transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+                transform: z.ZodOptional<z.ZodType<(text: string, slug: string) => string, z.ZodTypeDef, (text: string, slug: string) => string>>;
             }, "strict", z.ZodTypeAny, {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             }, {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
+            }>]>;
+            icon: z.ZodOptional<z.ZodUnion<[z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>, z.ZodObject<{
+                id: z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>;
+                color: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            }, {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             }>]>>;
-            sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["alpha", "filename"]>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
+            description: z.ZodString;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            badge: z.ZodOptional<z.ZodObject<{
+                src: z.ZodString;
+                alt: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                alt: string;
+                src: string;
+            }, {
+                alt: string;
+                src: string;
+            }>>;
+            path: z.ZodString;
+            include: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            items: z.ZodOptional<z.ZodArray<z.ZodType<Section, z.ZodTypeDef, Section>, "many">>;
+            sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "alpha", "filename"]>, z.ZodType<(a: ResolvedPage, b: ResolvedPage) => number, z.ZodTypeDef, (a: ResolvedPage, b: ResolvedPage) => number>]>>;
             exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            recursive: z.ZodOptional<z.ZodBoolean>;
+            entryFile: z.ZodOptional<z.ZodString>;
             frontmatter: z.ZodOptional<z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
                 titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -1178,13 +906,29 @@ export declare const zpressConfigSchema: z.ZodObject<{
                 pageClass: z.ZodOptional<z.ZodString>;
                 head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
             }, z.ZodTypeAny, "passthrough">>>;
-            recursive: z.ZodOptional<z.ZodBoolean>;
-            indexFile: z.ZodOptional<z.ZodString>;
+            openapi: z.ZodOptional<z.ZodObject<{
+                spec: z.ZodString;
+                path: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                sidebarLayout: z.ZodOptional<z.ZodEnum<["method-path", "title"]>>;
+            }, "strict", z.ZodTypeAny, {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            }, {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            }>>;
         }, "strict", z.ZodTypeAny, {
-            title?: string | {
+            title: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            } | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
+            };
+            description: string;
+            path: string;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
                 titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -1200,16 +944,34 @@ export declare const zpressConfigSchema: z.ZodObject<{
                 pageClass: z.ZodOptional<z.ZodString>;
                 head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
+            items?: Section[] | undefined;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            tags?: string[] | undefined;
+            badge?: {
+                alt: string;
+                src: string;
+            } | undefined;
+            include?: string | string[] | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            entryFile?: string | undefined;
+            openapi?: {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            } | undefined;
         }, {
-            title?: string | {
+            title: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            } | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
+            };
+            description: string;
+            path: string;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
                 titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -1225,33 +987,41 @@ export declare const zpressConfigSchema: z.ZodObject<{
                 pageClass: z.ZodOptional<z.ZodString>;
                 head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
+            items?: Section[] | undefined;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            tags?: string[] | undefined;
+            badge?: {
+                alt: string;
+                src: string;
+            } | undefined;
+            include?: string | string[] | undefined;
             exclude?: string[] | undefined;
-        }>>;
-        items: z.ZodOptional<z.ZodArray<z.ZodType<unknown, z.ZodTypeDef, unknown>, "many">>;
+            recursive?: boolean | undefined;
+            entryFile?: string | undefined;
+            openapi?: {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            } | undefined;
+        }>, "many">;
+        link: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
-        } | undefined;
-        discovery?: {
-            title?: string | {
+        items: {
+            title: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            } | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
+            };
+            description: string;
+            path: string;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
                 titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -1267,32 +1037,43 @@ export declare const zpressConfigSchema: z.ZodObject<{
                 pageClass: z.ZodOptional<z.ZodString>;
                 head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
+            items?: Section[] | undefined;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            tags?: string[] | undefined;
+            badge?: {
+                alt: string;
+                src: string;
+            } | undefined;
+            include?: string | string[] | undefined;
             exclude?: string[] | undefined;
-        } | undefined;
+            recursive?: boolean | undefined;
+            entryFile?: string | undefined;
+            openapi?: {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            } | undefined;
+        }[];
+        icon: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+        description?: string | undefined;
+        link?: string | undefined;
     }, {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
-        } | undefined;
-        discovery?: {
-            title?: string | {
+        items: {
+            title: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            } | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
+            };
+            description: string;
+            path: string;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
                 titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -1308,621 +1089,444 @@ export declare const zpressConfigSchema: z.ZodObject<{
                 pageClass: z.ZodOptional<z.ZodString>;
                 head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
+            items?: Section[] | undefined;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            tags?: string[] | undefined;
+            badge?: {
+                alt: string;
+                src: string;
+            } | undefined;
+            include?: string | string[] | undefined;
             exclude?: string[] | undefined;
-        } | undefined;
+            recursive?: boolean | undefined;
+            entryFile?: string | undefined;
+            openapi?: {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            } | undefined;
+        }[];
+        icon: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+        description?: string | undefined;
+        link?: string | undefined;
     }>, "many">>;
-    packages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    features: z.ZodOptional<z.ZodArray<z.ZodObject<{
         title: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-            transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+            transform: z.ZodOptional<z.ZodType<(text: string, slug: string) => string, z.ZodTypeDef, (text: string, slug: string) => string>>;
         }, "strict", z.ZodTypeAny, {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         }, {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         }>]>;
-        icon: z.ZodOptional<z.ZodString>;
-        iconColor: z.ZodOptional<z.ZodString>;
         description: z.ZodString;
-        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        badge: z.ZodOptional<z.ZodObject<{
-            src: z.ZodString;
-            alt: z.ZodString;
+        link: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodUnion<[z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>, z.ZodObject<{
+            id: z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>;
+            color: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            alt: string;
-            src: string;
+            id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+            color: string;
         }, {
-            alt: string;
-            src: string;
-        }>>;
-        prefix: z.ZodString;
-        discovery: z.ZodOptional<z.ZodObject<{
-            from: z.ZodOptional<z.ZodString>;
-            title: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
-                from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-                transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+            id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+            color: string;
+        }>]>>;
+    }, "strict", z.ZodTypeAny, {
+        title: string | {
+            from: "auto" | "filename" | "heading" | "frontmatter";
+            transform?: ((text: string, slug: string) => string) | undefined;
+        };
+        description: string;
+        link?: string | undefined;
+        icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+            id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+            color: string;
+        } | undefined;
+    }, {
+        title: string | {
+            from: "auto" | "filename" | "heading" | "frontmatter";
+            transform?: ((text: string, slug: string) => string) | undefined;
+        };
+        description: string;
+        link?: string | undefined;
+        icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+            id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+            color: string;
+        } | undefined;
+    }>, "many">>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        theme: z.ZodEnum<["brand", "alt"]>;
+        text: z.ZodString;
+        link: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
+    }, {
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
+    }>, "many">>;
+    sidebar: z.ZodOptional<z.ZodObject<{
+        above: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            link: z.ZodString;
+            icon: z.ZodOptional<z.ZodUnion<[z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>, z.ZodObject<{
+                id: z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>;
+                color: z.ZodString;
             }, "strict", z.ZodTypeAny, {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             }, {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             }>]>>;
-            sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["alpha", "filename"]>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
-            exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            frontmatter: z.ZodOptional<z.ZodObject<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough">>>;
-            recursive: z.ZodOptional<z.ZodBoolean>;
-            indexFile: z.ZodOptional<z.ZodString>;
+            style: z.ZodOptional<z.ZodEnum<["brand", "alt", "ghost"]>>;
+            shape: z.ZodOptional<z.ZodEnum<["square", "rounded", "circle"]>>;
         }, "strict", z.ZodTypeAny, {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             } | undefined;
-            frontmatter?: z.objectOutputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
         }, {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             } | undefined;
-            frontmatter?: z.objectInputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
-        }>>;
-        items: z.ZodOptional<z.ZodArray<z.ZodType<unknown, z.ZodTypeDef, unknown>, "many">>;
-    }, "strict", z.ZodTypeAny, {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
-        } | undefined;
-        discovery?: {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }>, "many">>;
+        below: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            link: z.ZodString;
+            icon: z.ZodOptional<z.ZodUnion<[z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>, z.ZodObject<{
+                id: z.ZodType<`catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`, z.ZodTypeDef, `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`>;
+                color: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            }, {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            }>]>>;
+            style: z.ZodOptional<z.ZodEnum<["brand", "alt", "ghost"]>>;
+            shape: z.ZodOptional<z.ZodEnum<["square", "rounded", "circle"]>>;
+        }, "strict", z.ZodTypeAny, {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             } | undefined;
-            frontmatter?: z.objectOutputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
-        } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }, {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        above?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
     }, {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
-        } | undefined;
-        discovery?: {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+        above?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
             } | undefined;
-            frontmatter?: z.objectInputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
-        } | undefined;
-    }>, "many">>;
-    workspaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        title: z.ZodUnion<[z.ZodString, z.ZodObject<{
-            from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-            transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-        }, "strict", z.ZodTypeAny, {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        }, {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        }>]>;
-        description: z.ZodString;
-        icon: z.ZodString;
-        items: z.ZodArray<z.ZodObject<{
-            title: z.ZodUnion<[z.ZodString, z.ZodObject<{
-                from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-                transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-            }, "strict", z.ZodTypeAny, {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            }, {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            }>]>;
-            icon: z.ZodOptional<z.ZodString>;
-            iconColor: z.ZodOptional<z.ZodString>;
-            description: z.ZodString;
-            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            badge: z.ZodOptional<z.ZodObject<{
-                src: z.ZodString;
-                alt: z.ZodString;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+    }>>;
+    sections: z.ZodArray<z.ZodType<Section, z.ZodTypeDef, Section>, "many">;
+    nav: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"auto">, z.ZodArray<z.ZodType<NavItem, z.ZodTypeDef, NavItem>, "many">]>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    home: z.ZodOptional<z.ZodObject<{
+        features: z.ZodOptional<z.ZodObject<{
+            columns: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+            truncate: z.ZodOptional<z.ZodObject<{
+                title: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodNumber>;
             }, "strict", z.ZodTypeAny, {
-                alt: string;
-                src: string;
+                title?: number | undefined;
+                description?: number | undefined;
             }, {
-                alt: string;
-                src: string;
+                title?: number | undefined;
+                description?: number | undefined;
             }>>;
-            prefix: z.ZodString;
-            discovery: z.ZodOptional<z.ZodObject<{
-                from: z.ZodOptional<z.ZodString>;
-                title: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
-                    from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-                    transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-                }, "strict", z.ZodTypeAny, {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                }, {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                }>]>>;
-                sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["alpha", "filename"]>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
-                exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-                frontmatter: z.ZodOptional<z.ZodObject<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough">>>;
-                recursive: z.ZodOptional<z.ZodBoolean>;
-                indexFile: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
+            } | undefined;
+        }, {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
+            } | undefined;
+        }>>;
+        workspaces: z.ZodOptional<z.ZodObject<{
+            columns: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+            truncate: z.ZodOptional<z.ZodObject<{
+                title: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodNumber>;
             }, "strict", z.ZodTypeAny, {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectOutputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+                title?: number | undefined;
+                description?: number | undefined;
             }, {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectInputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+                title?: number | undefined;
+                description?: number | undefined;
             }>>;
-            items: z.ZodOptional<z.ZodArray<z.ZodType<unknown, z.ZodTypeDef, unknown>, "many">>;
         }, "strict", z.ZodTypeAny, {
-            title: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            };
-            description: string;
-            prefix: string;
-            items?: unknown[] | undefined;
-            icon?: string | undefined;
-            iconColor?: string | undefined;
-            tags?: string[] | undefined;
-            badge?: {
-                alt: string;
-                src: string;
-            } | undefined;
-            discovery?: {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectOutputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
         }, {
-            title: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            };
-            description: string;
-            prefix: string;
-            items?: unknown[] | undefined;
-            icon?: string | undefined;
-            iconColor?: string | undefined;
-            tags?: string[] | undefined;
-            badge?: {
-                alt: string;
-                src: string;
-            } | undefined;
-            discovery?: {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectInputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-        }>, "many">;
-        link: z.ZodOptional<z.ZodString>;
+        }>>;
     }, "strict", z.ZodTypeAny, {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        items: {
-            title: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            };
-            description: string;
-            prefix: string;
-            items?: unknown[] | undefined;
-            icon?: string | undefined;
-            iconColor?: string | undefined;
-            tags?: string[] | undefined;
-            badge?: {
-                alt: string;
-                src: string;
+        features?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-            discovery?: {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectOutputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+        } | undefined;
+        workspaces?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-        }[];
-        icon: string;
-        link?: string | undefined;
+        } | undefined;
     }, {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        items: {
-            title: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            };
-            description: string;
-            prefix: string;
-            items?: unknown[] | undefined;
-            icon?: string | undefined;
-            iconColor?: string | undefined;
-            tags?: string[] | undefined;
-            badge?: {
-                alt: string;
-                src: string;
+        features?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-            discovery?: {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectInputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+        } | undefined;
+        workspaces?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-        }[];
-        icon: string;
-        link?: string | undefined;
-    }>, "many">>;
-    features: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        title: z.ZodUnion<[z.ZodString, z.ZodObject<{
-            from: z.ZodEnum<["auto", "filename", "heading", "frontmatter"]>;
-            transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        } | undefined;
+    }>>;
+    socialLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        icon: z.ZodUnion<[z.ZodEnum<["lark", "discord", "facebook", "github", "instagram", "linkedin", "slack", "x", "youtube", "wechat", "qq", "juejin", "zhihu", "bilibili", "weibo", "gitlab", "X", "bluesky", "npm"]>, z.ZodObject<{
+            svg: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            svg: string;
         }, {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            svg: string;
         }>]>;
-        description: z.ZodString;
-        link: z.ZodOptional<z.ZodString>;
-        icon: z.ZodOptional<z.ZodString>;
+        mode: z.ZodEnum<["link", "text", "img", "dom"]>;
+        content: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+        icon: "lark" | "discord" | "facebook" | "github" | "instagram" | "linkedin" | "slack" | "x" | "youtube" | "wechat" | "qq" | "juejin" | "zhihu" | "bilibili" | "weibo" | "gitlab" | "X" | "bluesky" | "npm" | {
+            svg: string;
         };
-        description: string;
-        link?: string | undefined;
-        icon?: string | undefined;
+        content: string;
+        mode: "link" | "text" | "img" | "dom";
     }, {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+        icon: "lark" | "discord" | "facebook" | "github" | "instagram" | "linkedin" | "slack" | "x" | "youtube" | "wechat" | "qq" | "juejin" | "zhihu" | "bilibili" | "weibo" | "gitlab" | "X" | "bluesky" | "npm" | {
+            svg: string;
         };
-        description: string;
-        link?: string | undefined;
-        icon?: string | undefined;
+        content: string;
+        mode: "link" | "text" | "img" | "dom";
     }>, "many">>;
-    sections: z.ZodArray<z.ZodType<unknown, z.ZodTypeDef, unknown>, "many">;
-    nav: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"auto">, z.ZodArray<z.ZodType<unknown, z.ZodTypeDef, unknown>, "many">]>>;
-    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    footer: z.ZodOptional<z.ZodObject<{
+        message: z.ZodOptional<z.ZodString>;
+        copyright: z.ZodOptional<z.ZodString>;
+        socials: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        message?: string | undefined;
+        copyright?: string | undefined;
+        socials?: boolean | undefined;
+    }, {
+        message?: string | undefined;
+        copyright?: string | undefined;
+        socials?: boolean | undefined;
+    }>>;
     openapi: z.ZodOptional<z.ZodObject<{
         spec: z.ZodString;
-        prefix: z.ZodString;
+        path: z.ZodString;
         title: z.ZodOptional<z.ZodString>;
+        sidebarLayout: z.ZodOptional<z.ZodEnum<["method-path", "title"]>>;
     }, "strict", z.ZodTypeAny, {
-        prefix: string;
+        path: string;
         spec: string;
         title?: string | undefined;
+        sidebarLayout?: "title" | "method-path" | undefined;
     }, {
-        prefix: string;
+        path: string;
         spec: string;
         title?: string | undefined;
+        sidebarLayout?: "title" | "method-path" | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
-    sections: unknown[];
+    sections: Section[];
     title?: string | undefined;
     description?: string | undefined;
+    sidebar?: {
+        above?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+    } | undefined;
+    footer?: {
+        message?: string | undefined;
+        copyright?: string | undefined;
+        socials?: boolean | undefined;
+    } | undefined;
+    icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | undefined;
     exclude?: string[] | undefined;
-    icon?: string | undefined;
+    openapi?: {
+        path: string;
+        spec: string;
+        title?: string | undefined;
+        sidebarLayout?: "title" | "method-path" | undefined;
+    } | undefined;
+    features?: {
+        title: string | {
+            from: "auto" | "filename" | "heading" | "frontmatter";
+            transform?: ((text: string, slug: string) => string) | undefined;
+        };
+        description: string;
+        link?: string | undefined;
+        icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+            id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+            color: string;
+        } | undefined;
+    }[] | undefined;
+    workspaces?: {
+        title: string | {
+            from: "auto" | "filename" | "heading" | "frontmatter";
+            transform?: ((text: string, slug: string) => string) | undefined;
+        };
+        items: {
+            title: string | {
+                from: "auto" | "filename" | "heading" | "frontmatter";
+                transform?: ((text: string, slug: string) => string) | undefined;
+            };
+            description: string;
+            path: string;
+            frontmatter?: z.objectOutputType<{
+                title: z.ZodOptional<z.ZodString>;
+                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+                description: z.ZodOptional<z.ZodString>;
+                layout: z.ZodOptional<z.ZodString>;
+                sidebar: z.ZodOptional<z.ZodBoolean>;
+                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
+                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
+                navbar: z.ZodOptional<z.ZodBoolean>;
+                editLink: z.ZodOptional<z.ZodBoolean>;
+                lastUpdated: z.ZodOptional<z.ZodBoolean>;
+                footer: z.ZodOptional<z.ZodBoolean>;
+                pageClass: z.ZodOptional<z.ZodString>;
+                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
+            }, z.ZodTypeAny, "passthrough"> | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
+            items?: Section[] | undefined;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            tags?: string[] | undefined;
+            badge?: {
+                alt: string;
+                src: string;
+            } | undefined;
+            include?: string | string[] | undefined;
+            exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            entryFile?: string | undefined;
+            openapi?: {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            } | undefined;
+        }[];
+        icon: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+        description?: string | undefined;
+        link?: string | undefined;
+    }[] | undefined;
     theme?: {
         name: string;
         colorMode?: "dark" | "light" | "toggle" | undefined;
@@ -1961,69 +1565,99 @@ export declare const zpressConfigSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
     tagline?: string | undefined;
-    apps?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
+    actions?: {
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
+    }[] | undefined;
+    nav?: "auto" | NavItem[] | undefined;
+    home?: {
+        features?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
+            } | undefined;
         } | undefined;
-        discovery?: {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+        workspaces?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-            frontmatter?: z.objectOutputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
         } | undefined;
+    } | undefined;
+    socialLinks?: {
+        icon: "lark" | "discord" | "facebook" | "github" | "instagram" | "linkedin" | "slack" | "x" | "youtube" | "wechat" | "qq" | "juejin" | "zhihu" | "bilibili" | "weibo" | "gitlab" | "X" | "bluesky" | "npm" | {
+            svg: string;
+        };
+        content: string;
+        mode: "link" | "text" | "img" | "dom";
     }[] | undefined;
-    packages?: {
+}, {
+    sections: Section[];
+    title?: string | undefined;
+    description?: string | undefined;
+    sidebar?: {
+        above?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
+            style?: "brand" | "alt" | "ghost" | undefined;
+            shape?: "square" | "rounded" | "circle" | undefined;
+        }[] | undefined;
+    } | undefined;
+    footer?: {
+        message?: string | undefined;
+        copyright?: string | undefined;
+        socials?: boolean | undefined;
+    } | undefined;
+    icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | undefined;
+    exclude?: string[] | undefined;
+    openapi?: {
+        path: string;
+        spec: string;
+        title?: string | undefined;
+        sidebarLayout?: "title" | "method-path" | undefined;
+    } | undefined;
+    features?: {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
+        link?: string | undefined;
+        icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+            id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+            color: string;
         } | undefined;
-        discovery?: {
-            title?: string | {
+    }[] | undefined;
+    workspaces?: {
+        title: string | {
+            from: "auto" | "filename" | "heading" | "frontmatter";
+            transform?: ((text: string, slug: string) => string) | undefined;
+        };
+        items: {
+            title: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            } | undefined;
-            frontmatter?: z.objectOutputType<{
+                transform?: ((text: string, slug: string) => string) | undefined;
+            };
+            description: string;
+            path: string;
+            frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
                 titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
                 description: z.ZodOptional<z.ZodString>;
@@ -2038,85 +1672,32 @@ export declare const zpressConfigSchema: z.ZodObject<{
                 pageClass: z.ZodOptional<z.ZodString>;
                 head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
-        } | undefined;
-    }[] | undefined;
-    workspaces?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        items: {
-            title: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            };
-            description: string;
-            prefix: string;
-            items?: unknown[] | undefined;
-            icon?: string | undefined;
-            iconColor?: string | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
+            items?: Section[] | undefined;
+            icon?: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}` | {
+                id: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+                color: string;
+            } | undefined;
             tags?: string[] | undefined;
             badge?: {
                 alt: string;
                 src: string;
             } | undefined;
-            discovery?: {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectOutputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+            include?: string | string[] | undefined;
+            exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            entryFile?: string | undefined;
+            openapi?: {
+                path: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
             } | undefined;
         }[];
-        icon: string;
-        link?: string | undefined;
-    }[] | undefined;
-    features?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
+        icon: `catppuccin:${string}` | `devicon:${string}` | `logos:${string}` | `material-icon-theme:${string}` | `mdi:${string}` | `pixelarticons:${string}` | `simple-icons:${string}` | `skill-icons:${string}` | `vscode-icons:${string}`;
+        description?: string | undefined;
         link?: string | undefined;
-        icon?: string | undefined;
     }[] | undefined;
-    nav?: "auto" | unknown[] | undefined;
-    openapi?: {
-        prefix: string;
-        spec: string;
-        title?: string | undefined;
-    } | undefined;
-}, {
-    sections: unknown[];
-    title?: string | undefined;
-    description?: string | undefined;
-    exclude?: string[] | undefined;
-    icon?: string | undefined;
     theme?: {
         name?: string | undefined;
         colorMode?: "dark" | "light" | "toggle" | undefined;
@@ -2155,156 +1736,35 @@ export declare const zpressConfigSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
     tagline?: string | undefined;
-    apps?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
-        } | undefined;
-        discovery?: {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            } | undefined;
-            frontmatter?: z.objectInputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
-        } | undefined;
+    actions?: {
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
     }[] | undefined;
-    packages?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        prefix: string;
-        items?: unknown[] | undefined;
-        icon?: string | undefined;
-        iconColor?: string | undefined;
-        tags?: string[] | undefined;
-        badge?: {
-            alt: string;
-            src: string;
-        } | undefined;
-        discovery?: {
-            title?: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+    nav?: "auto" | NavItem[] | undefined;
+    home?: {
+        features?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-            frontmatter?: z.objectInputType<{
-                title: z.ZodOptional<z.ZodString>;
-                titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                description: z.ZodOptional<z.ZodString>;
-                layout: z.ZodOptional<z.ZodString>;
-                sidebar: z.ZodOptional<z.ZodBoolean>;
-                aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                navbar: z.ZodOptional<z.ZodBoolean>;
-                editLink: z.ZodOptional<z.ZodBoolean>;
-                lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                footer: z.ZodOptional<z.ZodBoolean>;
-                pageClass: z.ZodOptional<z.ZodString>;
-                head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-            }, z.ZodTypeAny, "passthrough"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-            from?: string | undefined;
-            exclude?: string[] | undefined;
         } | undefined;
-    }[] | undefined;
-    workspaces?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
-        };
-        description: string;
-        items: {
-            title: string | {
-                from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
-            };
-            description: string;
-            prefix: string;
-            items?: unknown[] | undefined;
-            icon?: string | undefined;
-            iconColor?: string | undefined;
-            tags?: string[] | undefined;
-            badge?: {
-                alt: string;
-                src: string;
-            } | undefined;
-            discovery?: {
-                title?: string | {
-                    from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
-                } | undefined;
-                frontmatter?: z.objectInputType<{
-                    title: z.ZodOptional<z.ZodString>;
-                    titleTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-                    description: z.ZodOptional<z.ZodString>;
-                    layout: z.ZodOptional<z.ZodString>;
-                    sidebar: z.ZodOptional<z.ZodBoolean>;
-                    aside: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"left">]>>;
-                    outline: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodLiteral<"deep">]>>;
-                    navbar: z.ZodOptional<z.ZodBoolean>;
-                    editLink: z.ZodOptional<z.ZodBoolean>;
-                    lastUpdated: z.ZodOptional<z.ZodBoolean>;
-                    footer: z.ZodOptional<z.ZodBoolean>;
-                    pageClass: z.ZodOptional<z.ZodString>;
-                    head: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>], null>, "many">>;
-                }, z.ZodTypeAny, "passthrough"> | undefined;
-                recursive?: boolean | undefined;
-                indexFile?: string | undefined;
-                sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
-                from?: string | undefined;
-                exclude?: string[] | undefined;
+        workspaces?: {
+            columns?: 2 | 1 | 3 | 4 | undefined;
+            truncate?: {
+                title?: number | undefined;
+                description?: number | undefined;
             } | undefined;
-        }[];
-        icon: string;
-        link?: string | undefined;
-    }[] | undefined;
-    features?: {
-        title: string | {
-            from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+        } | undefined;
+    } | undefined;
+    socialLinks?: {
+        icon: "lark" | "discord" | "facebook" | "github" | "instagram" | "linkedin" | "slack" | "x" | "youtube" | "wechat" | "qq" | "juejin" | "zhihu" | "bilibili" | "weibo" | "gitlab" | "X" | "bluesky" | "npm" | {
+            svg: string;
         };
-        description: string;
-        link?: string | undefined;
-        icon?: string | undefined;
+        content: string;
+        mode: "link" | "text" | "img" | "dom";
     }[] | undefined;
-    nav?: "auto" | unknown[] | undefined;
-    openapi?: {
-        prefix: string;
-        spec: string;
-        title?: string | undefined;
-    } | undefined;
 }>;
 
 export { }