import Koa from 'koa';
import Router from 'koa-router';
import type { RouteConfig } from '../types/index.js';
/**
 * 创建 Koa 应用实例
 */
export declare function createApp(): Koa;
/**
 * 注册 API 路由
 * @param app Koa 应用实例
 * @param routes 路由配置数组
 * @param existingRouter 已存在的路由实例（用于热更新）
 * @returns Router 实例
 */
export declare function registerApiRoutes(app: Koa, routes: RouteConfig[], existingRouter?: Router): Router;
export declare function initStaticMiddleware(staticDir: string, options?: Record<string, unknown>): Promise<Koa.Middleware | null>;
export declare function serveStatic(app: Koa, middleware: Koa.Middleware | null): void;
/**
 * 注册 SPA 回退路由（非 API 请求返回 index.html）
 */
export declare function registerSpaFallback(app: Koa, indexPath: string): void;
//# sourceMappingURL=app.d.ts.map