import type { BaseApp } from "./base-app.js";
import { ConfigError } from "./errors.js";
declare const HOST_CONFIG_KEYS: readonly ["port", "path", "database", "public_static_dir", "env", "keys", "proxy", "subdomainOffset", "proxyIpHeader", "maxIpsCount"];
export type HostConfigKey = (typeof HOST_CONFIG_KEYS)[number];
/** 应用层可复用的“配置已保存但需要重启”结构化错误。 */
export declare class ConfigRestartRequiredError extends ConfigError {
    readonly changed: readonly string[];
    constructor(changed: readonly string[], message?: string);
}
/** 表示配置已验证且可保存，但必须重启进程才能完整应用。 */
export declare class HostConfigRestartRequiredError extends ConfigRestartRequiredError {
    readonly changed: readonly HostConfigKey[];
    constructor(changed: readonly HostConfigKey[]);
}
/**
 * 热重载只替换账号、协议与运行时凭据；宿主网络、数据库及中间件配置必须重启。
 * 显式拒绝无法完整生效的配置，避免 Web 显示已应用而进程仍运行旧状态。
 */
export declare function assertHostConfigReloadable(current: Required<BaseApp.Config>, next: Required<BaseApp.Config>): void;
/** 将环境变量端口显式解析为 TCP 端口，避免 Node 将数字字符串当作管道路径。 */
export declare function resolveListenPort(configured: number, environment?: string): number;
export {};