@zpress/core 0.5.0 → 0.6.1

package/dist/index.d.ts

@@ -1,3 +1,38 @@
+import { CardConfig } from '@zpress/config';
+import { COLOR_MODES } from '@zpress/config';
+import { ColorMode } from '@zpress/config';
+import { ConfigError } from '@zpress/config';
+import { configError } from '@zpress/config';
+import { ConfigResult } from '@zpress/config';
+import { Discovery } from '@zpress/config';
+import { Entry } from '@zpress/config';
+import { Feature } from '@zpress/config';
+import { FlatDiscoveryConfig } from '@zpress/config';
+import { Frontmatter } from '@zpress/config';
+import { HeroConfig } from '@zpress/config';
+import { IconColor } from '@zpress/config';
+import { IconConfig } from '@zpress/config';
+import { loadConfig } from '@zpress/config';
+import { NavItem } from '@zpress/config';
+import { OpenAPIConfig } from '@zpress/config';
+import { RecursiveDiscoveryConfig } from '@zpress/config';
+import { resolveDefaultColorMode } from '@zpress/config';
+import { ResolvedPage } from '@zpress/config';
+import { ResolvedSection } from '@zpress/config';
+import { Result } from '@zpress/config';
+import { Section } from '@zpress/config';
+import { SeoConfig } from '@zpress/config';
+import { THEME_NAMES } from '@zpress/config';
+import { ThemeColors } from '@zpress/config';
+import { ThemeConfig } from '@zpress/config';
+import { ThemeName } from '@zpress/config';
+import { TitleConfig } from '@zpress/config';
+import { Workspace } from '@zpress/config';
+import { WorkspaceCategory } from '@zpress/config';
+import { WorkspaceGroup } from '@zpress/config';
+import { WorkspaceItem } from '@zpress/config';
+import { ZpressConfig } from '@zpress/config';
+
 /**
  * Input configuration for asset generation, extracted from ZpressConfig.
  */
@@ -20,87 +55,17 @@ export declare interface AssetError {
  */
 export declare type AssetResult<T> = Result<T, AssetError>;
 
-/**
- * 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).
- *
- * @example
- * ```ts
- * card: {
- *   icon: 'devicon:hono',
- *   iconColor: 'api',
- *   scope: 'apps/',
- *   description: 'Hono REST API with RPC-typed routes',
- *   tags: ['Hono', 'REST', 'Serverless'],
- *   badge: { src: '/logos/vercel.svg', alt: 'Vercel' },
- * }
- * ```
- */
-export declare interface CardConfig {
-    /**
-     * Iconify identifier for the card icon (e.g. 'devicon:hono').
-     */
-    icon?: string;
-    /**
-     * CSS class suffix for the icon color (maps to `.workspace-icon--{color}`).
-     */
-    iconColor?: string;
-    /**
-     * 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;
-    };
-}
+export { CardConfig }
 
-/**
- * All valid color modes — used for validation.
- */
-export declare const COLOR_MODES: readonly ColorMode[];
+export { COLOR_MODES }
 
-/**
- * How dark/light mode is controlled.
- */
-export declare type ColorMode = 'dark' | 'light' | 'toggle';
+export { ColorMode }
 
-/**
- * Error produced during config validation in `defineConfig`.
- */
-export declare interface ConfigError {
-    readonly _tag: 'ConfigError';
-    readonly type: 'empty_sections' | 'missing_field' | 'duplicate_prefix' | 'invalid_icon' | 'invalid_entry' | 'invalid_theme';
-    readonly message: string;
-}
+export { ConfigError }
 
-/**
- * Create a `ConfigError` value.
- *
- * @param type - Error classification
- * @param message - Human-readable description
- * @returns A frozen `ConfigError` object
- */
-export declare function configError(type: ConfigError['type'], message: string): ConfigError;
+export { configError }
 
-/**
- * Convenience alias for config validation results.
- */
-export declare type ConfigResult<T> = readonly [ConfigError, null] | readonly [null, T];
+export { ConfigResult }
 
 /**
  * Create all derived project paths from a resolved directory.
@@ -120,229 +85,15 @@ export declare function createPaths(dir: string): Paths;
  */
 export declare function defineConfig(config: ZpressConfig): ZpressConfig;
 
-/**
- * A single node in the information architecture.
- *
- * What you provide determines what it is:
- *
- * **Page — explicit file**
- * ```ts
- * { text: 'Architecture', link: '/architecture', from: 'docs/architecture.md' }
- * ```
- *
- * **Page — inline/generated content**
- * ```ts
- * { text: 'Overview', link: '/api/overview', content: '# API Overview\n...' }
- * ```
- *
- * **Section — explicit children**
- * ```ts
- * { text: 'Guides', items: [ ... ] }
- * ```
- *
- * **Section — auto-discovered from glob**
- * ```ts
- * { text: 'Guides', prefix: '/guides', from: 'docs/guides/*.md' }
- * ```
- *
- * **Section — mix of explicit + auto-discovered**
- * ```ts
- * {
- *   text: 'Guides',
- *   prefix: '/guides',
- *   from: 'docs/guides/*.md',
- *   items: [
- *     { text: 'Getting Started', link: '/guides/start', from: 'docs/intro.md' },
- *   ],
- * }
- * ```
- */
-export declare interface Entry {
-    /**
-     * Display text in sidebar and nav.
-     */
-    readonly text: string;
-    /**
-     * 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`.
-     */
-    readonly content?: string | (() => string | Promise<string>);
-    /**
-     * Child entries — pages and/or sub-sections.
-     */
-    readonly items?: readonly Entry[];
-    /**
-     * Make this section collapsible in the sidebar.
-     * Sections at depth > 1 are collapsible by default.
-     * Set to `false` to keep a deep section always-open.
-     */
-    readonly collapsible?: boolean;
-    /**
-     * Exclude globs, scoped to this entry'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 hidden?: 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 `text` 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
-     */
-    readonly textFrom?: 'filename' | 'heading' | 'frontmatter';
-    /**
-     * Transform function applied to auto-derived text (from `textFrom`).
-     * Called after text derivation for glob-discovered and recursive children.
-     * Does NOT apply to entries with explicit `text` (those are already user-controlled).
-     *
-     * @param text - The derived text (from heading or filename)
-     * @param slug - The filename slug (without extension)
-     * @returns Transformed text for sidebar display
-     */
-    readonly textTransform?: (text: string, slug: string) => string;
-    /**
-     * Sort order for auto-discovered children.
-     * - `"alpha"` — alphabetical by derived text (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;
-    /**
-     * Iconify icon identifier (e.g. `"pixelarticons:speed-fast"`).
-     * Used on home page feature cards when auto-generated from sections.
-     */
-    readonly icon?: string;
-    /**
-     * Card display metadata for the parent section's auto-generated landing page.
-     *
-     * When present on child entries, the parent's landing page uses
-     * workspace-style cards instead of the default simple cards.
-     */
-    readonly card?: CardConfig;
-    /**
-     * 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.
-     *
-     * Requires `link` to be set.
-     * @default false
-     */
-    readonly isolated?: boolean;
-}
+export { Discovery }
 
-/**
- * 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.
- *
- * @example
- * ```ts
- * {
- *   text: 'Getting Started',
- *   description: 'Everything you need to set up and start building.',
- *   link: '/getting-started',
- *   icon: 'pixelarticons:speed-fast',
- * }
- * ```
- */
-export declare interface Feature {
-    /**
-     * Display title for the feature card.
-     */
-    readonly text: string;
-    /**
-     * Short description shown below the title.
-     */
-    readonly description: string;
-    /**
-     * Link target when the card is clicked.
-     */
-    readonly link?: string;
-    /**
-     * Iconify icon identifier (e.g. `"pixelarticons:speed-fast"`).
-     */
-    readonly icon?: string;
-}
+export { Entry }
 
-/**
- * Relative file path from repo root (e.g. `"docs/guides/add-api-route.md"`)
- */
-declare type FilePath = string;
+export { Feature }
 
-/**
- * Rspress frontmatter fields injectable at build time.
- */
-export declare interface Frontmatter {
-    readonly title?: string;
-    readonly titleTemplate?: string | boolean;
-    readonly description?: string;
-    readonly layout?: 'doc' | 'page' | 'home' | (string & {});
-    readonly sidebar?: boolean;
-    readonly aside?: boolean | 'left';
-    readonly outline?: false | number | [number, number] | 'deep';
-    readonly navbar?: boolean;
-    readonly editLink?: boolean;
-    readonly lastUpdated?: boolean;
-    readonly footer?: boolean;
-    readonly pageClass?: string;
-    readonly head?: readonly [string, Record<string, string>][];
-    /**
-     * Arbitrary extra fields merged into frontmatter.
-     */
-    readonly [key: string]: unknown;
-}
+export { FlatDiscoveryConfig }
+
+export { Frontmatter }
 
 /**
  * Generate banner, logo, and icon SVGs, writing them to the public directory.
@@ -393,27 +144,33 @@ export declare function generateIconSvg(config: AssetConfig): AssetResult<Genera
  */
 export declare function generateLogoSvg(config: AssetConfig): AssetResult<GeneratedAsset>;
 
-/**
- * Glob pattern (e.g. `"docs/guides/*.md"`)
- */
-declare type GlobPattern = string;
-
 /**
  * Returns true if the string contains glob metacharacters.
  */
 export declare function hasGlobChars(s: string): boolean;
 
+export { HeroConfig }
+
 /**
- * Load and validate zpress config at runtime via c12.
+ * Rotating color palette applied to auto-generated icons.
+ * Each section gets the next color in the cycle.
  *
- * Returns a `ConfigResult` tuple — the CLI boundary is responsible for
- * surfacing any error and exiting. Validation runs here (not in
- * `defineConfig`) so every consumer gets structured error feedback.
- *
- * @param dir - Repository root directory to search for `zpress.config.*`
- * @returns A `ConfigResult` tuple — `[null, config]` on success or `[ConfigError, null]` on failure
+ * This array defines the order in which colors are assigned to
+ * auto-generated section cards and feature icons.
  */
-export declare function loadConfig(dir: string): Promise<ConfigResult<ZpressConfig>>;
+export declare const ICON_COLORS: readonly IconColor[];
+
+export declare const ICON_PREFIXES: readonly IconPrefix[];
+
+export { IconColor }
+
+export { IconConfig }
+
+export declare type IconId = `${IconPrefix}:${string}`;
+
+export declare type IconPrefix = 'catppuccin' | 'devicon' | 'logos' | 'material-icon-theme' | 'mdi' | 'pixelarticons' | 'simple-icons' | 'skill-icons' | 'vscode-icons';
+
+export { loadConfig }
 
 /**
  * Load the previous sync manifest from disk.
@@ -463,31 +220,9 @@ export declare interface ManifestEntry {
     readonly outputPath: string;
 }
 
-export declare interface NavItem {
-    readonly text: string;
-    readonly link?: UrlPath;
-    readonly items?: readonly NavItem[];
-    readonly activeMatch?: string;
-}
+export { NavItem }
 
-/**
- * Configuration for OpenAPI spec integration.
- */
-export declare interface OpenAPIConfig {
-    /**
-     * Path to openapi.json relative to repo root.
-     */
-    spec: FilePath;
-    /**
-     * URL prefix for API operation pages (e.g., '/api').
-     */
-    prefix: UrlPath;
-    /**
-     * Sidebar group title.
-     * @default 'API Reference'
-     */
-    title?: string;
-}
+export { OpenAPIConfig }
 
 /**
  * Data for a single page to be written to the output directory.
@@ -523,19 +258,15 @@ export declare interface Paths {
     readonly cacheDir: string;
 }
 
-/**
- * Resolve the default color mode for a given theme name.
- *
- * @param theme - Built-in theme identifier
- * @returns The theme's natural color mode
- */
-export declare function resolveDefaultColorMode(theme: ThemeName): ColorMode;
+export { RecursiveDiscoveryConfig }
+
+export { resolveDefaultColorMode }
 
 /**
  * Internal resolved node — produced by the resolver, consumed by copy + sidebar/nav generators.
  */
 export declare interface ResolvedEntry {
-    readonly text: string;
+    readonly title: string;
     readonly link?: string;
     readonly collapsible?: boolean;
     readonly hidden?: boolean;
@@ -561,102 +292,58 @@ export declare interface ResolvedEntry {
 }
 
 /**
- * A fully resolved page after the sync engine processes the config.
+ * Normalized icon output — always has both `id` and `color`.
  */
-export declare interface ResolvedPage {
-    /**
-     * Display text.
-     */
-    readonly text: string;
-    /**
-     * Output URL path.
-     */
-    readonly link: UrlPath;
-    /**
-     * Source file path (undefined for virtual pages).
-     */
-    readonly source?: FilePath;
-    /**
-     * Merged frontmatter.
-     */
-    readonly frontmatter: Frontmatter;
+export declare interface ResolvedIcon {
+    readonly id: string;
+    readonly color: IconColor;
 }
 
-/**
- * A fully resolved section.
- */
-export declare interface ResolvedSection {
-    readonly text: string;
-    readonly link?: UrlPath;
-    readonly collapsible?: boolean;
-    readonly items: readonly (ResolvedPage | ResolvedSection)[];
-}
+export { ResolvedPage }
+
+export { ResolvedSection }
 
 /**
- * Walk the Entry tree and produce a ResolvedEntry tree.
+ * Walk the Section tree and produce a ResolvedEntry tree.
  *
  * Resolves globs, derives text, merges frontmatter, deduplicates.
  * Returns a `SyncOutcome` tuple — the caller is responsible for
  * surfacing errors and exiting.
  *
- * @param entries - Config entry tree to resolve
+ * @param sections - Config section tree to resolve
  * @param ctx - Sync context (provides repo root, config, quiet flag)
- * @param inheritedFrontmatter - Frontmatter inherited from parent entries
+ * @param inheritedFrontmatter - Frontmatter inherited from parent sections
  * @param depth - Current nesting depth (0 = top-level)
  * @returns Result tuple containing resolved entry tree or the first sync error
  */
-export declare function resolveEntries(entries: readonly Entry[], ctx: SyncContext, inheritedFrontmatter?: Frontmatter, depth?: number): Promise<readonly [SyncError, null] | readonly [null, ResolvedEntry[]]>;
+export declare function resolveEntries(sections: readonly Section[], ctx: SyncContext, inheritedFrontmatter?: Frontmatter, depth?: number): Promise<readonly [SyncError, null] | readonly [null, ResolvedEntry[]]>;
 
 /**
- * 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.
+ * Normalize an `IconConfig` value into a `ResolvedIcon`.
  *
- * @example
- * ```ts
- * import { defineConfig } from '@zpress/core'
+ * - String → `{ id: string, color: "purple" }` (default color)
+ * - Object → pass-through `{ id, color }`
  *
- * export default defineConfig({
- *   title: 'My Docs',
- *   sections: [
- *     {
- *       text: 'Introduction',
- *       items: [
- *         { text: 'Architecture', link: '/architecture', from: 'docs/architecture.md' },
- *         { text: 'Structure', link: '/structure', from: 'docs/structure.md' },
- *       ],
- *     },
- *     {
- *       text: 'Guides',
- *       prefix: '/guides',
- *       from: 'docs/guides/*.md',
- *     },
- *     {
- *       text: 'API Reference',
- *       items: [
- *         { text: 'Overview', link: '/api/overview', content: '# API\n...' },
- *         { text: 'Routes', link: '/api/routes', from: 'apps/api/docs/routes.md' },
- *       ],
- *     },
- *   ],
- * })
- * ```
+ * @param icon - Icon config value (string or object)
+ * @returns Normalized `{ id, color }` pair
  */
+export declare function resolveIcon(icon: IconConfig): ResolvedIcon;
+
 /**
- * Result type for error handling without exceptions.
+ * Normalize an optional `IconConfig` value into a `ResolvedIcon | undefined`.
  *
- * Success: `[null, value]`
- * Failure: `[error, null]`
+ * Returns `undefined` when `icon` is `undefined`.
  *
- * @example
- * ```ts
- * const [error, value] = loadConfig(path)
- * if (error) return [error, null]
- * ```
+ * @param icon - Optional icon config value
+ * @returns Normalized `{ id, color }` pair, or `undefined`
  */
-export declare type Result<T, E = Error> = readonly [E, null] | readonly [null, T];
+export declare function resolveOptionalIcon(icon: IconConfig | undefined): ResolvedIcon | undefined;
+
+export { Result }
+
+export { Section }
+
+export { SeoConfig }
 
 /**
  * Rspress sidebar item shape.
@@ -718,12 +405,6 @@ export declare interface SyncContext {
     readonly sourceMap?: SourceMap;
 }
 
-/**
- * Domain-specific error types for the sync engine.
- *
- * All sync operations return `Result<T, SyncError>` instead of throwing.
- * Config validation returns `Result<T, ConfigError>`.
- */
 /**
  * Error produced by the sync engine during entry resolution, page copy, or sidebar generation.
  */
@@ -768,77 +449,15 @@ export declare interface SyncResult {
     readonly elapsed: number;
 }
 
-/**
- * All valid theme names — used for validation.
- */
-export declare const THEME_NAMES: readonly ThemeName[];
+export { THEME_NAMES }
 
-/**
- * Optional color overrides keyed to CSS custom properties.
- *
- * Each key maps to one or more `--zp-c-*` / `--rp-c-*` variables.
- * Values must be valid CSS color strings (hex or rgba).
- */
-export declare interface ThemeColors {
-    readonly brand?: string;
-    readonly brandLight?: string;
-    readonly brandDark?: string;
-    readonly brandSoft?: string;
-    readonly bg?: string;
-    readonly bgAlt?: string;
-    readonly bgElv?: string;
-    readonly bgSoft?: string;
-    readonly text1?: string;
-    readonly text2?: string;
-    readonly text3?: string;
-    readonly divider?: string;
-    readonly border?: string;
-    readonly homeBg?: string;
-}
+export { ThemeColors }
 
-/**
- * Top-level theme configuration for `zpress.config.ts`.
- */
-export declare interface ThemeConfig {
-    /**
-     * Built-in theme to use.
-     * @default 'base'
-     */
-    readonly name?: ThemeName;
-    /**
-     * Color mode behavior. Defaults to the theme's natural mode.
-     */
-    readonly colorMode?: ColorMode;
-    /**
-     * Show the theme switcher dropdown in the nav bar.
-     * @default false
-     */
-    readonly switcher?: boolean;
-    /**
-     * Partial color overrides applied in light mode (or base mode).
-     */
-    readonly colors?: ThemeColors;
-    /**
-     * Partial color overrides applied only in dark mode.
-     */
-    readonly darkColors?: ThemeColors;
-}
+export { ThemeConfig }
 
-/**
- * Theme types and default resolution.
- *
- * Defines the built-in theme palette system: theme names, color modes,
- * per-theme color overrides, and the top-level ThemeConfig shape.
- */
-/**
- * Built-in theme identifiers.
- */
-export declare type ThemeName = 'base' | 'midnight' | 'arcade';
+export { ThemeName }
 
-/**
- * URL path (e.g. `"/guides/add-api-route"`)
- */
-declare type UrlPath = string;
+export { TitleConfig }
 
 /**
  * Validate the entire config, returning the first error found.
@@ -848,221 +467,14 @@ declare type UrlPath = string;
  */
 export declare function validateConfig(config: ZpressConfig): ConfigResult<ZpressConfig>;
 
-/**
- * A named group of workspace items for custom workspace categories.
- *
- * 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.
- *
- * @example
- * ```ts
- * {
- *   name: 'Integrations',
- *   description: 'Third-party service connectors',
- *   icon: 'pixelarticons:integration',
- *   items: [
- *     { text: 'Stripe', description: 'Payment processing', docsPrefix: '/integrations/stripe' },
- *   ],
- * }
- * ```
- */
-export declare interface WorkspaceGroup {
-    readonly name: string;
-    readonly description: string;
-    readonly icon: string;
-    readonly items: readonly WorkspaceItem[];
-    /**
-     * URL prefix override for the group's landing page.
-     * Defaults to `/${slugify(name)}` when omitted.
-     */
-    readonly link?: string;
-}
+export { Workspace }
 
-/**
- * A 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.
- *
- * @example
- * ```ts
- * {
- *   text: 'API',
- *   icon: 'devicon:hono',
- *   iconColor: 'api',
- *   description: 'Hono REST API serving all client applications with RPC-typed routes',
- *   tags: ['hono', 'react', 'vercel'],
- *   badge: { src: '/logos/vercel.svg', alt: 'Vercel' },
- *   docsPrefix: '/apps/api',
- * }
- * ```
- */
-export declare interface WorkspaceItem {
-    /**
-     * Display name (e.g. "API", "Console", "AI").
-     */
-    readonly text: string;
-    /**
-     * Main icon — Iconify identifier (e.g. "devicon:hono").
-     * Falls back to a default app or package icon when omitted.
-     */
-    readonly icon?: string;
-    /**
-     * CSS class suffix for icon color (maps to `.workspace-icon--{color}`).
-     */
-    readonly iconColor?: string;
-    /**
-     * Short description for cards and bullet lists.
-     */
-    readonly description: string;
-    /**
-     * Technology tags — kebab-case keys resolved by the UI TechTag component.
-     * Each tag maps to an Iconify icon and display label.
-     */
-    readonly tags?: readonly string[];
-    /**
-     * Deploy badge image for the card header.
-     */
-    readonly badge?: {
-        readonly src: string;
-        readonly alt: string;
-    };
-    /**
-     * Docs path prefix (e.g. "/apps/api"). Matches section entries and derives card links.
-     * Also used as the URL prefix for glob-discovered children.
-     */
-    readonly docsPrefix: string;
-    /**
-     * Content source — file path or glob, **relative to the workspace item's
-     * base path** (derived from `docsPrefix`).
-     *
-     * - `docsPrefix: "/apps/api"` + `from: "docs/*.md"` → resolves to `apps/api/docs/*.md`
-     * - **No wildcards** → single file (e.g. `"docs/overview.md"`)
-     * - **With wildcards** → auto-discover children (e.g. `"docs/*.md"`)
-     *
-     * @default "docs/*.md"
-     */
-    readonly from?: string;
-    /**
-     * Explicit child entries for this workspace item.
-     * Can be combined with `from` — explicit children override glob-discovered pages.
-     */
-    readonly items?: readonly Entry[];
-    /**
-     * Sort order for auto-discovered children.
-     * - `"alpha"` — alphabetical by derived text (default)
-     * - `"filename"` — alphabetical by filename
-     * - Custom comparator function
-     */
-    readonly sort?: Entry['sort'];
-    /**
-     * How to derive `text` 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
-     */
-    readonly textFrom?: Entry['textFrom'];
-    /**
-     * Transform function applied to auto-derived text (from `textFrom`).
-     */
-    readonly textTransform?: Entry['textTransform'];
-    /**
-     * Enable recursive directory-based nesting for glob patterns.
-     * Requires `from` with a recursive glob (e.g. `"apps/api/docs/**\/*.md"`).
-     * @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;
-    /**
-     * Exclude globs, scoped to this item's `from` glob.
-     */
-    readonly exclude?: readonly string[];
-    /**
-     * Make this item's section collapsible in the sidebar.
-     */
-    readonly collapsible?: boolean;
-    /**
-     * Frontmatter injected at build time for all pages under this workspace item.
-     */
-    readonly frontmatter?: Frontmatter;
-}
+export { WorkspaceCategory }
 
-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;
-    /**
-     * 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 WorkspaceItem[];
-    /**
-     * 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 WorkspaceItem[];
-    /**
-     * 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 WorkspaceGroup[];
-    /**
-     * 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 sections: readonly Entry[];
-    /**
-     * Top navigation bar.
-     * - `"auto"` — one nav item per top-level section
-     * - Array — explicit nav items
-     * @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 openapi?: OpenAPIConfig;
-}
+export { WorkspaceGroup }
+
+export { WorkspaceItem }
+
+export { ZpressConfig }
 
 export { }