@zpress/config 0.2.2 → 0.3.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,14 @@ 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?: string;
+    readonly iconColor?: string;
+    readonly scope?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly badge?: {
+        readonly src: string;
+        readonly alt: string;
     };
 }
 
@@ -76,11 +62,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>;
 
@@ -102,80 +101,23 @@ export declare type Discovery = FlatDiscoveryConfig | RecursiveDiscoveryConfig;
 
 /**
  * Content discovery configuration for auto-generating pages from files.
+ *
+ * Schema: `discoverySchema` in schema.ts validates this shape.
  */
 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 from?: string;
     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 sort?: 'default' | 'alpha' | 'filename' | ((a: ResolvedPage, b: ResolvedPage) => number);
+    readonly exclude?: readonly string[];
     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;
+    readonly recursive?: boolean;
+    readonly indexFile?: 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,15 +129,15 @@ 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?: string;
 }
 
 /**
- * Relative file path from repo root (e.g. `"docs/guides/add-api-route.md"`)
+ * File-system path (absolute or relative).
  */
 declare type FilePath = string;
 
@@ -208,12 +150,15 @@ export declare interface FlatDiscoveryConfig extends DiscoveryConfig {
 
 /**
  * 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 +168,18 @@ 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"`)
- */
-declare type GlobPattern = string;
-
-/**
- * Hero section configuration override.
+ * A single call-to-action button on the home page hero.
+ *
+ * Schema: `heroActionSchema` in schema.ts validates this shape.
  */
-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 HeroAction {
+    readonly theme: 'brand' | 'alt';
+    readonly text: string;
+    readonly link: string;
 }
 
 export { ICON_COLORS }
@@ -328,9 +246,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 +266,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').
      */
-    prefix: UrlPath;
+    readonly prefix: 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<{
@@ -383,10 +316,6 @@ export declare const pathsSchema: z.ZodObject<{
  */
 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;
 }
 
@@ -396,21 +325,9 @@ 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 +336,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,7 +358,8 @@ 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
@@ -499,192 +380,86 @@ export declare type Result<T, E = Error> = readonly [E, null] | readonly [null,
  * ```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' },
- *   ],
- * }
- * ```
  */
-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 link?: string;
+    readonly from?: string;
+    readonly prefix?: 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 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;
+    readonly sort?: 'default' | 'alpha' | 'filename' | ((a: ResolvedPage, b: ResolvedPage) => number);
+    readonly recursive?: boolean;
+    readonly indexFile?: string;
+    readonly icon?: string;
+    readonly iconColor?: string;
+    readonly card?: CardConfig;
+    readonly isolated?: boolean;
     /**
-     * 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 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 card?: CardConfig;
-    /**
-     * SEO meta tag overrides for this page.
-     * Merges with site-level SEO config.
-     */
-    readonly seo?: SeoConfig;
 }
 
 /**
  * SEO meta tag configuration.
+ * No schema — this is a type-only definition used for future extension.
  */
 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';
 }
 
+/**
+ * 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 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?: string | {
+        readonly id: string;
+        readonly color: string;
+    };
+}
+
 export { THEME_NAMES }
 
 export { ThemeColors }
@@ -696,6 +471,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 +502,7 @@ export declare type TitleConfig = string | {
 };
 
 /**
- * URL path (e.g. `"/guides/add-api-route"`)
+ * URL path segment (e.g. `"/api"`, `"/guides/auth"`).
  */
 declare type UrlPath = string;
 
@@ -740,68 +517,40 @@ 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' },
- *   },
+ *   discovery: { from: 'docs/*.md', title: { from: 'auto' } },
  * }
  * ```
  */
-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?: string;
+    readonly iconColor?: string;
+    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 prefix: string;
     readonly discovery?: Discovery;
-    /**
-     * Explicit child sections. Can be combined with discovery — explicit children override glob-discovered pages.
-     */
     readonly items?: readonly Section[];
-    /**
-     * Make this item's section collapsible in the sidebar.
-     */
-    readonly collapsible?: boolean;
+    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
@@ -815,109 +564,37 @@ export declare interface Workspace extends Entry {
  * }
  * ```
  */
-export declare interface WorkspaceCategory extends Entry {
-    /**
-     * Workspace items in this category.
-     */
+export declare interface WorkspaceCategory {
+    readonly title: TitleConfig;
+    readonly description: string;
+    readonly icon: string;
     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 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 actions?: readonly HeroAction[];
     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 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;
 }
 
@@ -1098,13 +775,13 @@ export declare const zpressConfigSchema: z.ZodObject<{
     apps: 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>;
@@ -1125,15 +802,15 @@ export declare const zpressConfigSchema: 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>>;
+                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;
             }>]>>;
-            sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["alpha", "filename"]>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
+            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">>;
             frontmatter: z.ZodOptional<z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1183,7 +860,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1200,15 +877,15 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
         }, {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1225,21 +902,37 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        }>>;
+        items: z.ZodOptional<z.ZodArray<z.ZodType<Section, z.ZodTypeDef, Section>, "many">>;
+        openapi: z.ZodOptional<z.ZodObject<{
+            spec: z.ZodString;
+            prefix: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            sidebarLayout: z.ZodOptional<z.ZodEnum<["method-path", "title"]>>;
+        }, "strict", z.ZodTypeAny, {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
+        }, {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | 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;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         prefix: string;
-        items?: unknown[] | undefined;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -1250,7 +943,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1267,20 +960,26 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | 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;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -1291,7 +990,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1308,23 +1007,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"> | undefined;
-            recursive?: boolean | undefined;
-            indexFile?: string | undefined;
-            sort?: "filename" | "alpha" | ((...args: unknown[]) => unknown) | undefined;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | undefined;
     }>, "many">>;
     packages: 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>;
@@ -1345,15 +1050,15 @@ export declare const zpressConfigSchema: 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>>;
+                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;
             }>]>>;
-            sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["alpha", "filename"]>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
+            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">>;
             frontmatter: z.ZodOptional<z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1403,7 +1108,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1420,15 +1125,15 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
         }, {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1445,21 +1150,37 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        }>>;
+        items: z.ZodOptional<z.ZodArray<z.ZodType<Section, z.ZodTypeDef, Section>, "many">>;
+        openapi: z.ZodOptional<z.ZodObject<{
+            spec: z.ZodString;
+            prefix: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            sidebarLayout: z.ZodOptional<z.ZodEnum<["method-path", "title"]>>;
+        }, "strict", z.ZodTypeAny, {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
+        }, {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | 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;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         prefix: string;
-        items?: unknown[] | undefined;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -1470,7 +1191,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1487,20 +1208,26 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | 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;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -1511,7 +1238,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1528,36 +1255,42 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | 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>>;
+            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;
         }>]>;
         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>>;
+                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>;
@@ -1578,15 +1311,15 @@ export declare const zpressConfigSchema: 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>>;
+                    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;
                 }>]>>;
-                sort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["alpha", "filename"]>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
+                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">>;
                 frontmatter: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1636,7 +1369,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectOutputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1653,15 +1386,15 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
             }, {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectInputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1678,21 +1411,37 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            }>>;
+            items: z.ZodOptional<z.ZodArray<z.ZodType<Section, z.ZodTypeDef, Section>, "many">>;
+            openapi: z.ZodOptional<z.ZodObject<{
+                spec: z.ZodString;
+                prefix: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                sidebarLayout: z.ZodOptional<z.ZodEnum<["method-path", "title"]>>;
+            }, "strict", z.ZodTypeAny, {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
+            }, {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | 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;
+                transform?: ((text: string, slug: string) => string) | undefined;
             };
             description: string;
             prefix: string;
-            items?: unknown[] | undefined;
+            items?: Section[] | undefined;
             icon?: string | undefined;
             iconColor?: string | undefined;
             tags?: string[] | undefined;
@@ -1703,7 +1452,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             discovery?: {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectOutputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1720,20 +1469,26 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            } | undefined;
+            openapi?: {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
             } | 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;
+            items?: Section[] | undefined;
             icon?: string | undefined;
             iconColor?: string | undefined;
             tags?: string[] | undefined;
@@ -1744,7 +1499,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             discovery?: {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectInputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1761,28 +1516,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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            } | undefined;
+            openapi?: {
+                prefix: 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;
         items: {
             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;
+            items?: Section[] | undefined;
             icon?: string | undefined;
             iconColor?: string | undefined;
             tags?: string[] | undefined;
@@ -1793,7 +1554,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             discovery?: {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectOutputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1810,11 +1571,17 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            } | undefined;
+            openapi?: {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
             } | undefined;
         }[];
         icon: string;
@@ -1822,17 +1589,17 @@ export declare const zpressConfigSchema: z.ZodObject<{
     }, {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         items: {
             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;
+            items?: Section[] | undefined;
             icon?: string | undefined;
             iconColor?: string | undefined;
             tags?: string[] | undefined;
@@ -1843,7 +1610,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             discovery?: {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectInputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1860,11 +1627,17 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            } | undefined;
+            openapi?: {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
             } | undefined;
         }[];
         icon: string;
@@ -1873,13 +1646,13 @@ export declare const zpressConfigSchema: 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;
         }>]>;
         description: z.ZodString;
         link: z.ZodOptional<z.ZodString>;
@@ -1887,7 +1660,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         link?: string | undefined;
@@ -1895,32 +1668,142 @@ export declare const zpressConfigSchema: z.ZodObject<{
     }, {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         link?: string | undefined;
         icon?: string | undefined;
     }>, "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">>;
-    openapi: z.ZodOptional<z.ZodObject<{
-        spec: z.ZodString;
-        prefix: z.ZodString;
-        title: z.ZodOptional<z.ZodString>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        theme: z.ZodEnum<["brand", "alt"]>;
+        text: z.ZodString;
+        link: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        prefix: string;
-        spec: string;
-        title?: string | undefined;
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
     }, {
-        prefix: string;
-        spec: string;
-        title?: string | undefined;
+        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.ZodString, z.ZodObject<{
+                id: z.ZodString;
+                color: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                color: string;
+            }, {
+                id: string;
+                color: string;
+            }>]>>;
+        }, "strict", z.ZodTypeAny, {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }, {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }>, "many">>;
+        below: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            link: z.ZodString;
+            icon: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                id: z.ZodString;
+                color: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                color: string;
+            }, {
+                id: string;
+                color: string;
+            }>]>>;
+        }, "strict", z.ZodTypeAny, {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }, {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        above?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+    }, {
+        above?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | 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">>;
 }, "strict", z.ZodTypeAny, {
-    sections: unknown[];
+    sections: Section[];
     title?: string | undefined;
     description?: string | undefined;
+    sidebar?: {
+        above?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+    } | undefined;
     exclude?: string[] | undefined;
     icon?: string | undefined;
     theme?: {
@@ -1964,11 +1847,11 @@ export declare const zpressConfigSchema: z.ZodObject<{
     apps?: {
         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;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -1979,7 +1862,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -1996,21 +1879,27 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | undefined;
     }[] | undefined;
     packages?: {
         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;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -2021,7 +1910,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectOutputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -2038,27 +1927,33 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | undefined;
     }[] | undefined;
     workspaces?: {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         items: {
             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;
+            items?: Section[] | undefined;
             icon?: string | undefined;
             iconColor?: string | undefined;
             tags?: string[] | undefined;
@@ -2069,7 +1964,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             discovery?: {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectOutputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -2086,11 +1981,17 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            } | undefined;
+            openapi?: {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
             } | undefined;
         }[];
         icon: string;
@@ -2099,22 +2000,40 @@ export declare const zpressConfigSchema: z.ZodObject<{
     features?: {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         link?: string | undefined;
         icon?: string | undefined;
     }[] | undefined;
-    nav?: "auto" | unknown[] | undefined;
-    openapi?: {
-        prefix: string;
-        spec: string;
-        title?: string | undefined;
-    } | undefined;
+    actions?: {
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
+    }[] | undefined;
+    nav?: "auto" | NavItem[] | undefined;
 }, {
-    sections: unknown[];
+    sections: Section[];
     title?: string | undefined;
     description?: string | undefined;
+    sidebar?: {
+        above?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+        below?: {
+            link: string;
+            text: string;
+            icon?: string | {
+                id: string;
+                color: string;
+            } | undefined;
+        }[] | undefined;
+    } | undefined;
     exclude?: string[] | undefined;
     icon?: string | undefined;
     theme?: {
@@ -2158,11 +2077,11 @@ export declare const zpressConfigSchema: z.ZodObject<{
     apps?: {
         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;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -2173,7 +2092,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -2190,21 +2109,27 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | undefined;
     }[] | undefined;
     packages?: {
         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;
+        items?: Section[] | undefined;
         icon?: string | undefined;
         iconColor?: string | undefined;
         tags?: string[] | undefined;
@@ -2215,7 +2140,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
         discovery?: {
             title?: string | {
                 from: "auto" | "filename" | "heading" | "frontmatter";
-                transform?: ((...args: unknown[]) => unknown) | undefined;
+                transform?: ((text: string, slug: string) => string) | undefined;
             } | undefined;
             frontmatter?: z.objectInputType<{
                 title: z.ZodOptional<z.ZodString>;
@@ -2232,27 +2157,33 @@ 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;
+            sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
             from?: string | undefined;
             exclude?: string[] | undefined;
+            recursive?: boolean | undefined;
+            indexFile?: string | undefined;
+        } | undefined;
+        openapi?: {
+            prefix: string;
+            spec: string;
+            title?: string | undefined;
+            sidebarLayout?: "title" | "method-path" | undefined;
         } | undefined;
     }[] | undefined;
     workspaces?: {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         items: {
             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;
+            items?: Section[] | undefined;
             icon?: string | undefined;
             iconColor?: string | undefined;
             tags?: string[] | undefined;
@@ -2263,7 +2194,7 @@ export declare const zpressConfigSchema: z.ZodObject<{
             discovery?: {
                 title?: string | {
                     from: "auto" | "filename" | "heading" | "frontmatter";
-                    transform?: ((...args: unknown[]) => unknown) | undefined;
+                    transform?: ((text: string, slug: string) => string) | undefined;
                 } | undefined;
                 frontmatter?: z.objectInputType<{
                     title: z.ZodOptional<z.ZodString>;
@@ -2280,11 +2211,17 @@ 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;
+                sort?: "filename" | "default" | "alpha" | ((a: ResolvedPage, b: ResolvedPage) => number) | undefined;
                 from?: string | undefined;
                 exclude?: string[] | undefined;
+                recursive?: boolean | undefined;
+                indexFile?: string | undefined;
+            } | undefined;
+            openapi?: {
+                prefix: string;
+                spec: string;
+                title?: string | undefined;
+                sidebarLayout?: "title" | "method-path" | undefined;
             } | undefined;
         }[];
         icon: string;
@@ -2293,18 +2230,18 @@ export declare const zpressConfigSchema: z.ZodObject<{
     features?: {
         title: string | {
             from: "auto" | "filename" | "heading" | "frontmatter";
-            transform?: ((...args: unknown[]) => unknown) | undefined;
+            transform?: ((text: string, slug: string) => string) | undefined;
         };
         description: string;
         link?: string | undefined;
         icon?: string | undefined;
     }[] | undefined;
-    nav?: "auto" | unknown[] | undefined;
-    openapi?: {
-        prefix: string;
-        spec: string;
-        title?: string | undefined;
-    } | undefined;
+    actions?: {
+        link: string;
+        text: string;
+        theme: "brand" | "alt";
+    }[] | undefined;
+    nav?: "auto" | NavItem[] | undefined;
 }>;
 
 export { }