@finesoft/front 0.1.39 → 0.1.41

package/dist/index.d.mts

@@ -0,0 +1,1276 @@
+import { Hono } from "hono";
+import * as node_fs0 from "node:fs";
+import { ViteDevServer } from "vite";
+
+//#region ../core/src/actions/types.d.ts
+/**
+ * Action 类型定义
+ *
+ * FlowAction — SPA 内部导航
+ * ExternalUrlAction — 打开外部链接
+ * CompoundAction — 组合多个 Action
+ */
+/** Action Kind 常量 */
+declare const ACTION_KINDS: {
+  FLOW: "flow";
+  EXTERNAL_URL: "externalUrl";
+  COMPOUND: "compound";
+};
+/** FlowAction — SPA 导航 */
+interface FlowAction {
+  kind: typeof ACTION_KINDS.FLOW;
+  url: string;
+  /** 展示方式: 默认 push，modal 弹窗 */
+  presentationContext?: "default" | "modal";
+}
+/** ExternalUrlAction — 外部链接 */
+interface ExternalUrlAction {
+  kind: typeof ACTION_KINDS.EXTERNAL_URL;
+  url: string;
+}
+/** CompoundAction — 组合 Action */
+interface CompoundAction {
+  kind: typeof ACTION_KINDS.COMPOUND;
+  actions: Action[];
+}
+/** 所有 Action 的联合类型 */
+type Action = FlowAction | ExternalUrlAction | CompoundAction;
+declare function isFlowAction(action: Action): action is FlowAction;
+declare function isExternalUrlAction(action: Action): action is ExternalUrlAction;
+declare function isCompoundAction(action: Action): action is CompoundAction;
+declare function makeFlowAction(url: string, presentationContext?: FlowAction["presentationContext"]): FlowAction;
+declare function makeExternalUrlAction(url: string): ExternalUrlAction;
+//#endregion
+//#region ../core/src/actions/dispatcher.d.ts
+/** Action 处理器函数类型 */
+type ActionHandler<A extends Action = Action> = (action: A) => Promise<void> | void;
+declare class ActionDispatcher {
+  private handlers;
+  private wiredActions;
+  /** 注册指定 kind 的 handler（防止重复注册） */
+  onAction<A extends Action>(kind: string, handler: ActionHandler<A>): void;
+  /** 执行一个 Action（CompoundAction 递归展开） */
+  perform(action: Action): Promise<void>;
+}
+//#endregion
+//#region ../core/src/dependencies/container.d.ts
+/**
+ * Container — 通用的依赖注入容器
+ */
+type Factory<T> = () => T;
+declare class Container {
+  private registrations;
+  /** 注册依赖（默认单例） */
+  register<T>(key: string, factory: Factory<T>, singleton?: boolean): this;
+  /** 解析依赖 */
+  resolve<T>(key: string): T;
+  /** 检查是否已注册 */
+  has(key: string): boolean;
+  /** 销毁容器，清除所有缓存 */
+  dispose(): void;
+}
+//#endregion
+//#region ../core/src/intents/types.d.ts
+/** Intent — 描述一个用户意图 */
+interface Intent<T = unknown> {
+  /** Intent 标识符（用于匹配 Controller） */
+  id: string;
+  /** 意图参数 */
+  params?: Record<string, string>;
+  /** 预期返回的数据（仅用于类型推断） */
+  _returnType?: T;
+}
+/** Intent Controller — 处理特定 intentId 的业务逻辑 */
+interface IntentController<T = unknown> {
+  /** Controller 对应的 Intent ID */
+  intentId: string;
+  /** 执行意图，返回页面数据 */
+  perform(intent: Intent<T>, container: Container): Promise<T> | T;
+}
+//#endregion
+//#region ../core/src/intents/dispatcher.d.ts
+declare class IntentDispatcher {
+  private controllers;
+  /** 注册一个 IntentController */
+  register(controller: IntentController): void;
+  /** 分发 Intent 到对应 Controller */
+  dispatch<T>(intent: Intent<T>, container: Container): Promise<T>;
+  /** 检查是否已注册某个 Intent */
+  has(intentId: string): boolean;
+}
+//#endregion
+//#region ../core/src/logger/types.d.ts
+/** 日志级别 */
+type Level = "debug" | "info" | "warn" | "error";
+/**
+ * Logger 接口
+ *
+ * 所有方法返回空字符串，允许在模板中内联使用而不渲染文本。
+ */
+interface Logger {
+  debug(...args: unknown[]): string;
+  info(...args: unknown[]): string;
+  warn(...args: unknown[]): string;
+  error(...args: unknown[]): string;
+}
+interface LoggerFactory {
+  loggerFor(category: string): Logger;
+}
+//#endregion
+//#region ../core/src/dependencies/make-dependencies.d.ts
+/** 网络请求层 */
+interface Net {
+  fetch(url: string, options?: RequestInit): Promise<Response>;
+}
+/** 多语言状态 */
+interface Locale {
+  language: string;
+  storefront: string;
+  setActiveLocale(language: string, storefront: string): void;
+}
+/** 存储接口 */
+interface Storage {
+  get(key: string): string | undefined;
+  set(key: string, value: string): void;
+  delete(key: string): void;
+}
+/** Feature Flags */
+interface FeatureFlags {
+  isEnabled(key: string): boolean;
+  getString(key: string): string | undefined;
+  getNumber(key: string): number | undefined;
+}
+/** Metrics 记录器 */
+interface MetricsRecorder {
+  recordPageView(page: string, fields?: Record<string, unknown>): void;
+  recordEvent(name: string, fields?: Record<string, unknown>): void;
+}
+declare const DEP_KEYS: {
+  readonly LOGGER: "logger";
+  readonly LOGGER_FACTORY: "loggerFactory";
+  readonly NET: "net";
+  readonly LOCALE: "locale";
+  readonly STORAGE: "storage";
+  readonly FEATURE_FLAGS: "featureFlags";
+  readonly METRICS: "metrics";
+  readonly FETCH: "fetch";
+};
+interface MakeDependenciesOptions {
+  fetch?: typeof globalThis.fetch;
+  language?: string;
+  storefront?: string;
+  featureFlags?: Record<string, boolean | string | number>;
+}
+declare function makeDependencies(container: Container, options?: MakeDependenciesOptions): void;
+//#endregion
+//#region ../core/src/models/page.d.ts
+/**
+ * BasePage — 所有页面共享的基础属性
+ *
+ * 具体页面类型由应用层定义并扩展此接口。
+ */
+interface BasePage {
+  id: string;
+  pageType: string;
+  title: string;
+  description?: string;
+  url?: string;
+}
+//#endregion
+//#region ../core/src/middleware/types.d.ts
+/** 导航上下文（beforeLoad 阶段可用） */
+interface NavigationContext {
+  /** 完整 URL（path + query） */
+  readonly url: string;
+  /** 仅路径部分 */
+  readonly path: string;
+  /** 路由参数 + 查询参数 */
+  readonly params: Record<string, string>;
+  /** 匹配的 Intent */
+  readonly intent: Intent;
+  /** 是否在服务端运行 */
+  readonly isServer: boolean;
+  /** DI 容器（可获取自定义服务） */
+  readonly container: Container;
+  /** 获取 Cookie 值（两端均可用） */
+  getCookie(name: string): string | undefined;
+  /** 获取请求头值（仅服务端有值，客户端始终返回 undefined） */
+  getHeader(name: string): string | undefined;
+}
+/** 后置上下文（afterLoad 阶段，包含页面数据） */
+interface PostLoadContext extends NavigationContext {
+  /** 控制器返回的页面数据 */
+  readonly page: BasePage;
+}
+/** 继续执行下一个中间件 */
+interface NextResult {
+  readonly kind: "next";
+}
+/** 重定向（服务端: HTTP 301/302，客户端: 触发新导航） */
+interface RedirectResult {
+  readonly kind: "redirect";
+  readonly url: string;
+  readonly status: number;
+}
+/** URL 重写（服务端: HTTP 301，客户端: replaceState 仅更新地址栏） */
+interface RewriteResult {
+  readonly kind: "rewrite";
+  readonly url: string;
+}
+/** 拒绝访问 */
+interface DenyResult {
+  readonly kind: "deny";
+  readonly status: number;
+  readonly message: string;
+}
+type MiddlewareResult = NextResult | RedirectResult | RewriteResult | DenyResult;
+/** 继续执行 */
+declare function next(): NextResult;
+/** 重定向到新 URL */
+declare function redirect(url: string, status?: 301 | 302): RedirectResult;
+/** URL 重写（不重新加载数据） */
+declare function rewrite(url: string): RewriteResult;
+/** 拒绝访问 */
+declare function deny(status?: number, message?: string): DenyResult;
+/** beforeLoad 守卫：路由匹配后、数据加载前 */
+type BeforeLoadGuard = (ctx: NavigationContext) => MiddlewareResult | Promise<MiddlewareResult>;
+/** afterLoad 守卫：数据加载后、渲染前 */
+type AfterLoadGuard = (ctx: PostLoadContext) => MiddlewareResult | Promise<MiddlewareResult>;
+//#endregion
+//#region ../core/src/router/router.d.ts
+/** 路由匹配结果 */
+interface RouteMatch {
+  intent: Intent;
+  action: FlowAction;
+  renderMode?: string;
+  /** 该路由绑定的 beforeLoad 守卫 */
+  beforeGuards?: BeforeLoadGuard[];
+  /** 该路由绑定的 afterLoad 守卫 */
+  afterGuards?: AfterLoadGuard[];
+}
+/** 路由添加选项 */
+interface RouteAddOptions {
+  renderMode?: string;
+  beforeGuards?: BeforeLoadGuard[];
+  afterGuards?: AfterLoadGuard[];
+}
+declare class Router {
+  private routes;
+  /** 添加路由规则 */
+  add(pattern: string, intentId: string, renderModeOrOptions?: string | RouteAddOptions): this;
+  /** 解析 URL → RouteMatch */
+  resolve(urlOrPath: string): RouteMatch | null;
+  /** 获取所有已注册的路由 */
+  getRoutes(): string[];
+  private extractPath;
+  private extractQueryParams;
+}
+//#endregion
+//#region ../core/src/logger/base.d.ts
+declare abstract class BaseLogger implements Logger {
+  protected category: string;
+  constructor(category: string);
+  abstract debug(...args: unknown[]): string;
+  abstract info(...args: unknown[]): string;
+  abstract warn(...args: unknown[]): string;
+  abstract error(...args: unknown[]): string;
+}
+//#endregion
+//#region ../core/src/logger/composite.d.ts
+declare class CompositeLoggerFactory implements LoggerFactory {
+  private readonly factories;
+  constructor(factories: LoggerFactory[]);
+  loggerFor(name: string): Logger;
+}
+declare class CompositeLogger implements Logger {
+  private readonly loggers;
+  constructor(loggers: Logger[]);
+  debug(...args: unknown[]): string;
+  info(...args: unknown[]): string;
+  warn(...args: unknown[]): string;
+  error(...args: unknown[]): string;
+  private callAll;
+}
+//#endregion
+//#region ../core/src/logger/console.d.ts
+declare class ConsoleLogger extends BaseLogger {
+  debug(...args: unknown[]): string;
+  info(...args: unknown[]): string;
+  warn(...args: unknown[]): string;
+  error(...args: unknown[]): string;
+}
+declare class ConsoleLoggerFactory implements LoggerFactory {
+  loggerFor(category: string): Logger;
+}
+//#endregion
+//#region ../core/src/logger/local-storage-filter.d.ts
+declare function shouldLog(name: string, level: Level): boolean;
+declare function resetFilterCache(): void;
+//#endregion
+//#region ../core/src/prefetched-intents/prefetched-intents.d.ts
+/** 预获取的 Intent-Data 对 */
+interface PrefetchedIntent {
+  intent: Intent;
+  data: unknown;
+}
+declare class PrefetchedIntents {
+  private intents;
+  private constructor();
+  /** 从 PrefetchedIntent 数组创建缓存实例 */
+  static fromArray(items: PrefetchedIntent[]): PrefetchedIntents;
+  /** 创建空缓存实例 */
+  static empty(): PrefetchedIntents;
+  /**
+   * 获取缓存的 Intent 结果（一次性使用）。
+   * 命中后从缓存中删除。
+   */
+  get<T>(intent: Intent<T>): T | undefined;
+  /** 检查缓存中是否有某个 Intent 的数据 */
+  has(intent: Intent): boolean;
+  /** 缓存中的条目数 */
+  get size(): number;
+}
+//#endregion
+//#region ../core/src/framework.d.ts
+/** Framework 初始化配置 */
+interface FrameworkConfig extends MakeDependenciesOptions {
+  setupRoutes?: (router: Router) => void;
+  prefetchedIntents?: PrefetchedIntents;
+}
+declare class Framework {
+  readonly container: Container;
+  readonly intentDispatcher: IntentDispatcher;
+  readonly actionDispatcher: ActionDispatcher;
+  readonly router: Router;
+  readonly prefetchedIntents: PrefetchedIntents;
+  private readonly beforeGuards;
+  private readonly afterGuards;
+  private constructor();
+  /** 创建并初始化 Framework 实例 */
+  static create(config?: FrameworkConfig): Framework;
+  /** 分发 Intent — 获取页面数据 */
+  dispatch<T>(intent: Intent<T>): Promise<T>;
+  /** 执行 Action — 处理用户交互 */
+  perform(action: Action): Promise<void>;
+  /** 路由 URL — 将 URL 解析为 Intent + Action */
+  routeUrl(url: string): RouteMatch | null;
+  /** 记录页面访问事件 */
+  didEnterPage(page: BasePage): void;
+  /** 注册 Action 处理器 */
+  onAction<A extends Action>(kind: string, handler: ActionHandler<A>): void;
+  /** 注册 Intent Controller */
+  registerIntent(controller: IntentController): void;
+  /** 注册 beforeLoad 守卫（路由匹配后、数据加载前） */
+  beforeLoad(guard: BeforeLoadGuard): void;
+  /** 注册 afterLoad 守卫（数据加载后、渲染前） */
+  afterLoad(guard: AfterLoadGuard): void;
+  /** 执行所有 beforeLoad 守卫（全局 → 路由级） */
+  runBeforeLoad(ctx: NavigationContext, routeGuards?: BeforeLoadGuard[]): Promise<MiddlewareResult>;
+  /** 执行所有 afterLoad 守卫（全局 → 路由级） */
+  runAfterLoad(ctx: PostLoadContext, routeGuards?: AfterLoadGuard[]): Promise<MiddlewareResult>;
+  /** 销毁 Framework 实例 */
+  dispose(): void;
+}
+//#endregion
+//#region ../core/src/models/shelf.d.ts
+interface BaseShelf {
+  id: string;
+  shelfType: string;
+  title?: string;
+  subtitle?: string;
+  seeAllAction?: Action;
+  isHorizontal?: boolean;
+}
+interface BaseItem {
+  id: string;
+  itemType: string;
+  clickAction?: Action;
+}
+//#endregion
+//#region ../core/src/prefetched-intents/stable-stringify.d.ts
+/**
+ * stableStringify — 确定性 JSON 序列化（keys 按字母排序）
+ *
+ * 用作缓存 key：相同内容的对象始终产生相同字符串。
+ */
+declare function stableStringify(obj: unknown, _seen?: Set<object>): string;
+//#endregion
+//#region ../core/src/http/client.d.ts
+/**
+ * HttpClient — 通用 HTTP 客户端基类
+ *
+ * 为 API Client 提供标准化的 HTTP 请求能力。
+ * 子类继承后只需关注业务端点定义，不需要重复实现 fetch / JSON 解析 / 错误处理。
+ */
+/** HTTP 请求错误 */
+declare class HttpError extends Error {
+  readonly status: number;
+  readonly statusText: string;
+  readonly body?: string | undefined;
+  constructor(status: number, statusText: string, body?: string | undefined);
+}
+/** HttpClient 构造配置 */
+interface HttpClientConfig {
+  /** API base URL（如 "/api" 或 "https://example.com/api"） */
+  baseUrl: string;
+  /** 默认请求头 */
+  defaultHeaders?: Record<string, string>;
+  /** 自定义 fetch 实现（便于测试或 SSR） */
+  fetch?: typeof globalThis.fetch;
+}
+/**
+ * 通用 HTTP 客户端基类
+ *
+ * 使用方式: 创建子类继承 HttpClient，定义业务方法调用 this.get() / this.post() 等。
+ *
+ * @example
+ * ```ts
+ * class MyApiClient extends HttpClient {
+ *   async getUser(id: string) {
+ *     return this.get<User>(`/users/${id}`);
+ *   }
+ * }
+ * ```
+ */
+declare abstract class HttpClient {
+  protected readonly baseUrl: string;
+  protected readonly defaultHeaders: Record<string, string>;
+  protected readonly fetchFn: typeof globalThis.fetch;
+  constructor(config: HttpClientConfig);
+  /** GET 请求，返回解析后的 JSON */
+  protected get<T>(path: string, params?: Record<string, string>): Promise<T>;
+  /** POST 请求，自动序列化 body 为 JSON */
+  protected post<T>(path: string, body?: unknown, params?: Record<string, string>): Promise<T>;
+  /** PUT 请求 */
+  protected put<T>(path: string, body?: unknown, params?: Record<string, string>): Promise<T>;
+  /** DELETE 请求 */
+  protected del<T>(path: string, params?: Record<string, string>): Promise<T>;
+  /**
+   * 底层请求方法 — 子类可覆写以自定义行为
+   *
+   * 自动处理:
+   * - URL 拼接 (baseUrl + path + params)
+   * - 默认 headers 合并
+   * - JSON body 序列化
+   * - 响应 JSON 解析
+   * - 非 2xx 状态码抛出 HttpError
+   */
+  protected request<T>(method: string, path: string, options?: {
+    params?: Record<string, string>;
+    body?: unknown;
+    headers?: Record<string, string>;
+  }): Promise<T>;
+  /** 构建完整 URL — 子类可覆写以自定义 URL 拼接逻辑 */
+  protected buildUrl(path: string, params?: Record<string, string>): string;
+}
+//#endregion
+//#region ../core/src/intents/base-controller.d.ts
+/**
+ * 抽象 Controller 基类
+ *
+ * 统一处理:
+ * - 类型安全的参数提取 (TParams)
+ * - 返回类型约束 (TResult)
+ * - try/catch 错误处理 + 可选 fallback
+ *
+ * @example
+ * ```ts
+ * class ProductController extends BaseController<{ productId: string }, ProductPage> {
+ *   readonly intentId = "product-page";
+ *
+ *   async execute(params: { productId: string }, container: Container) {
+ *     const api = container.resolve<ApiClient>("api");
+ *     return api.getProduct(params.productId);
+ *   }
+ *
+ *   fallback(params: { productId: string }, error: Error) {
+ *     return getMockProduct(params.productId);
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BaseController<TParams extends Record<string, string | undefined> = Record<string, string>, TResult = unknown> implements IntentController<TResult> {
+  /** Controller 对应的 Intent ID */
+  abstract readonly intentId: string;
+  /**
+   * 执行业务逻辑 — 子类必须实现
+   *
+   * @param params - Intent 参数（已类型化）
+   * @param container - DI 容器
+   * @returns 页面数据
+   */
+  abstract execute(params: TParams, container: Container): Promise<TResult> | TResult;
+  /**
+   * 错误回退 — 子类可选覆写
+   *
+   * 当 execute() 抛出异常时调用。
+   * 默认行为: 重新抛出原始错误。
+   *
+   * @param params - Intent 参数
+   * @param error - execute() 抛出的错误
+   * @returns 回退数据
+   */
+  fallback(params: TParams, error: Error): Promise<TResult> | TResult;
+  /**
+   * IntentController.perform() 实现
+   *
+   * 自动 try/catch → fallback 模式。
+   */
+  perform(intent: Intent<TResult>, container: Container): Promise<TResult>;
+}
+//#endregion
+//#region ../core/src/data/mapper.d.ts
+/**
+ * Mapper 类型工具 — 标准化数据转换管线
+ *
+ * 提供类型约定和组合函数，让 API 响应 → 页面模型 的转换有统一的签名模式。
+ */
+/** 同步映射函数 */
+type Mapper<TInput, TOutput> = (input: TInput) => TOutput;
+/** 异步映射函数 */
+type AsyncMapper<TInput, TOutput> = (input: TInput) => TOutput | Promise<TOutput>;
+/**
+ * 组合两个同步 Mapper: A → B → C
+ */
+declare function pipe<A, B, C>(m1: Mapper<A, B>, m2: Mapper<B, C>): Mapper<A, C>;
+/**
+ * 组合三个同步 Mapper: A → B → C → D
+ */
+declare function pipe<A, B, C, D>(m1: Mapper<A, B>, m2: Mapper<B, C>, m3: Mapper<C, D>): Mapper<A, D>;
+/**
+ * 组合四个同步 Mapper: A → B → C → D → E
+ */
+declare function pipe<A, B, C, D, E>(m1: Mapper<A, B>, m2: Mapper<B, C>, m3: Mapper<C, D>, m4: Mapper<D, E>): Mapper<A, E>;
+/**
+ * 组合任意数量的同步 Mapper
+ */
+declare function pipe(...mappers: Mapper<unknown, unknown>[]): Mapper<unknown, unknown>;
+/**
+ * 组合两个可能异步的 Mapper: A → B → C
+ */
+declare function pipeAsync<A, B, C>(m1: AsyncMapper<A, B>, m2: AsyncMapper<B, C>): AsyncMapper<A, C>;
+/**
+ * 组合三个可能异步的 Mapper
+ */
+declare function pipeAsync<A, B, C, D>(m1: AsyncMapper<A, B>, m2: AsyncMapper<B, C>, m3: AsyncMapper<C, D>): AsyncMapper<A, D>;
+/**
+ * 将一个 Mapper 应用到数组的每个元素
+ */
+declare function mapEach<TInput, TOutput>(mapper: Mapper<TInput, TOutput>): Mapper<TInput[], TOutput[]>;
+//#endregion
+//#region ../core/src/bootstrap/define-routes.d.ts
+/** 渲染模式 */
+type RenderMode = "ssr" | "csr" | "prerender";
+/** 单条路由定义 */
+interface RouteDefinition {
+  /** URL pattern (如 "/product/:productId") */
+  path: string;
+  /** Intent ID (如 "product-page") */
+  intentId: string;
+  /**
+   * Controller 实例（可选）。
+   * 同一个 intentId 的多条路由只需在第一条提供 controller。
+   */
+  controller?: IntentController;
+  /**
+   * 渲染模式（可选，默认 "ssr"）。
+   * - "ssr": 服务端渲染（默认）
+   * - "csr": 客户端渲染（返回空壳 HTML，由客户端 JS 渲染）
+   * - "prerender": 预渲染（构建时生成静态 HTML + ISR 缓存）
+   */
+  renderMode?: RenderMode;
+  /**
+   * 路由级 beforeLoad 守卫（可选）。
+   * 在全局守卫之后执行，仅对匹配此路由的请求生效。
+   */
+  beforeLoad?: BeforeLoadGuard[];
+  /**
+   * 路由级 afterLoad 守卫（可选）。
+   * 在全局守卫之后执行，仅对匹配此路由的请求生效。
+   */
+  afterLoad?: AfterLoadGuard[];
+}
+/**
+ * 声明式注册路由和 Controller
+ *
+ * - 自动去重: 同一 intentId 的 controller 只注册一次
+ * - 路由和 controller 在同一个配置数组中，方便检查一致性
+ *
+ * @example
+ * ```ts
+ * defineRoutes(framework, [
+ *   { path: "/",                intentId: "home",     controller: new HomeController() },
+ *   { path: "/product/:id",    intentId: "product",  controller: new ProductController() },
+ *   { path: "/search",         intentId: "search",   controller: new SearchController() },
+ *   { path: "/charts/:type",   intentId: "charts",   controller: new ChartsController() },
+ *   { path: "/charts",         intentId: "charts" },  // 同 intentId，不需要重复 controller
+ * ]);
+ * ```
+ */
+declare function defineRoutes(framework: Framework, definitions: RouteDefinition[]): void;
+//#endregion
+//#region ../core/src/utils/lru-map.d.ts
+/**
+ * LruMap — 固定容量的 LRU 缓存
+ */
+declare class LruMap<K, V> {
+  private map;
+  private readonly capacity;
+  constructor(capacity: number);
+  get(key: K): V | undefined;
+  set(key: K, value: V): void;
+  has(key: K): boolean;
+  delete(key: K): boolean;
+  get size(): number;
+  clear(): void;
+}
+//#endregion
+//#region ../core/src/utils/optional.d.ts
+/**
+ * Optional 类型工具
+ */
+type None = null | undefined;
+type Optional<T> = T | None;
+declare function isSome<T>(value: Optional<T>): value is T;
+declare function isNone<T>(value: Optional<T>): value is None;
+//#endregion
+//#region ../core/src/utils/url.d.ts
+/**
+ * URL 工具函数
+ */
+/** 移除 URL scheme (https://, http://) */
+declare function removeScheme(url: string): string;
+/** 移除 URL host 部分，保留路径 */
+declare function removeHost(url: string): string;
+/** 移除 query 参数 */
+declare function removeQueryParams(url: string): string;
+/** 获取 URL 的基础路径（无 query、hash） */
+declare function getBaseUrl(url: string): string;
+/** 构建 URL（路径 + query 参数） */
+declare function buildUrl(path: string, params?: Record<string, string | undefined>): string;
+//#endregion
+//#region ../core/src/utils/uuid.d.ts
+/**
+ * UUID v4 生成器
+ */
+declare function generateUuid(): string;
+//#endregion
+//#region ../core/src/middleware/context.d.ts
+interface ServerContextOptions {
+  url: string;
+  intent: Intent;
+  container: Container;
+  /** 原始 Request 对象（提取 cookie 和 header） */
+  request?: Request;
+}
+/** 从 Request 对象构建服务端上下文 */
+declare function createServerContext(options: ServerContextOptions): NavigationContext;
+interface BrowserContextOptions {
+  url: string;
+  intent: Intent;
+  container: Container;
+}
+/** 从 document.cookie 构建浏览器端上下文 */
+declare function createBrowserContext(options: BrowserContextOptions): NavigationContext;
+//#endregion
+//#region ../core/src/middleware/pipeline.d.ts
+/** 执行 beforeLoad 守卫链 */
+declare function runBeforeLoadGuards(guards: BeforeLoadGuard[], ctx: NavigationContext): Promise<MiddlewareResult>;
+/** 执行 afterLoad 守卫链 */
+declare function runAfterLoadGuards(guards: AfterLoadGuard[], ctx: PostLoadContext): Promise<MiddlewareResult>;
+//#endregion
+//#region ../browser/src/action-handlers/external-url-action.d.ts
+interface ExternalUrlDependencies {
+  framework: Framework;
+  log: Logger;
+}
+declare function registerExternalUrlHandler(deps: ExternalUrlDependencies): void;
+//#endregion
+//#region ../browser/src/action-handlers/flow-action.d.ts
+/** UI 框架回调 — 解耦 Svelte store 等依赖 */
+interface FlowActionCallbacks {
+  /** 导航后更新当前路径（替代 currentPath.set()） */
+  onNavigate(pathname: string): void;
+  /** 模态页面展示（替代 openModal()） */
+  onModal(page: BasePage): void;
+}
+/** 注册 FlowAction handler 所需的依赖 */
+interface FlowActionDependencies {
+  framework: Framework;
+  log: Logger;
+  callbacks: FlowActionCallbacks;
+  /** 更新应用 UI 的回调，page 可以是 Promise */
+  updateApp: (props: {
+    page: Promise<BasePage> | BasePage;
+    isFirstPage?: boolean;
+  }) => void;
+  /** 获取可滚动页面元素，用于滚动位置保存/恢复 */
+  getScrollablePageElement?: () => HTMLElement | null;
+}
+declare function registerFlowActionHandler(deps: FlowActionDependencies): void;
+//#endregion
+//#region ../browser/src/action-handlers/register.d.ts
+interface ActionHandlerDependencies {
+  framework: Framework;
+  log: Logger;
+  callbacks: FlowActionCallbacks;
+  updateApp: (props: {
+    page: Promise<BasePage> | BasePage;
+    isFirstPage?: boolean;
+  }) => void;
+  /** 获取可滚动页面元素，用于滚动位置保存/恢复 */
+  getScrollablePageElement?: () => HTMLElement | null;
+}
+declare function registerActionHandlers(deps: ActionHandlerDependencies): void;
+//#endregion
+//#region ../browser/src/start-app.d.ts
+interface BrowserAppConfig {
+  /** 注册 controllers 和路由的引导函数 */
+  bootstrap: (framework: Framework) => void;
+  /** 默认语言（回退值） */
+  defaultLocale?: string;
+  /** DOM 挂载点 ID（默认 "app"） */
+  mountId?: string;
+  /** 获取可滚动页面元素，用于滚动位置保存/恢复 */
+  getScrollablePageElement?: () => HTMLElement | null;
+  /**
+   * 挂载应用到 DOM
+   *
+   * 框架无关 — Svelte / React / Vue 均可通过此回调实现。
+   *
+   * @param target - DOM 挂载点
+   * @param context - Framework 实例 + 语言
+   * @returns 更新函数，用于后续页面切换
+   */
+  mount: (target: HTMLElement, context: {
+    framework: Framework;
+    locale: string;
+  }) => (props: {
+    page: Promise<BasePage> | BasePage;
+    isFirstPage?: boolean;
+  }) => void;
+  /** FlowAction / ExternalUrl 回调 */
+  callbacks: FlowActionCallbacks;
+}
+/**
+ * 启动客户端应用
+ *
+ * 自动执行 hydration 全流程。
+ */
+declare function startBrowserApp(config: BrowserAppConfig): Promise<void>;
+//#endregion
+//#region ../browser/src/utils/history.d.ts
+interface HistoryOptions {
+  getScrollablePageElement: () => HTMLElement | null;
+}
+declare class History<State> {
+  private readonly entries;
+  private readonly log;
+  private readonly getScrollablePageElement;
+  private currentStateId;
+  constructor(log: Logger, options: HistoryOptions, sizeLimit?: number);
+  replaceState(state: State, url: string): void;
+  pushState(state: State, url: string): void;
+  beforeTransition(): void;
+  onPopState(listener: (url: string, state?: State) => void | Promise<void>): void;
+  /** 仅推入 URL，不缓存页面状态（用于页面加载失败场景） */
+  pushUrl(url: string): void;
+  /** 仅替换 URL，不缓存页面状态（用于页面加载失败场景） */
+  replaceUrl(url: string): void;
+  updateState(update: (current?: State) => State): void;
+  private get scrollTop();
+  private set scrollTop(value);
+}
+//#endregion
+//#region ../browser/src/utils/try-scroll.d.ts
+declare function tryScroll(log: Logger, getScrollableElement: () => HTMLElement | null, scrollY: number): void;
+//#endregion
+//#region ../browser/src/server-data.d.ts
+/**
+ * 从 DOM 反序列化服务端嵌入的数据。
+ * 读取 `<script id="serialized-server-data">` 的内容并移除标签。
+ */
+declare function deserializeServerData(): PrefetchedIntent[] | undefined;
+/**
+ * 从 DOM 提取 SSR 数据并构建 PrefetchedIntents 实例。
+ * 替代原来的 PrefetchedIntents.fromDom()。
+ */
+declare function createPrefetchedIntentsFromDom(): PrefetchedIntents;
+//#endregion
+//#region ../ssr/src/render.d.ts
+interface SSRRenderOptions {
+  /** 请求 URL */
+  url: string;
+  /** Framework 配置（含路由注册等） */
+  frameworkConfig: FrameworkConfig;
+  /** 注册 controllers 和路由的引导函数 */
+  bootstrap: (framework: Framework) => void;
+  /** 获取错误页面 */
+  getErrorPage: (status: number, message: string) => BasePage;
+  /** 应用层渲染函数（如 Svelte SSR render） */
+  renderApp: (page: BasePage, framework: Framework) => SSRAppResult;
+  /** 可选的 SSR 请求上下文（如自定义 fetch） */
+  ssrContext?: SSRContext;
+}
+/** SSR 请求级上下文 */
+interface SSRContext {
+  /** 自定义 fetch（如 Hono 内部路由回环） */
+  fetch?: typeof globalThis.fetch;
+  /** 原始 Request 对象（用于中间件读取 cookie/header） */
+  request?: Request;
+}
+interface SSRAppResult {
+  html: string;
+  head: string;
+  css: string;
+}
+interface SSRRenderResult {
+  html: string;
+  head: string;
+  css: string;
+  serverData: PrefetchedIntent[];
+  /** 该路由的渲染模式（由 Router 返回） */
+  renderMode?: string;
+  /** 中间件要求的重定向（服务端应返回 HTTP 301/302） */
+  redirect?: {
+    url: string;
+    status: number;
+  };
+}
+declare function ssrRender(options: SSRRenderOptions): Promise<SSRRenderResult>;
+//#endregion
+//#region ../ssr/src/create-render.d.ts
+interface SSRRenderConfig {
+  /** 注册 controllers 和路由的引导函数 */
+  bootstrap: (framework: Framework) => void;
+  /** 获取错误页面 */
+  getErrorPage: (status: number, message: string) => BasePage;
+  /**
+   * 应用层渲染函数
+   *
+   * @param page - 当前页面数据
+   * @param locale - 当前语言
+   * @returns SSR 渲染结果 { html, head, css }
+   */
+  renderApp: (page: BasePage, locale: string) => SSRAppResult;
+  /** Framework 构造配置（可选） */
+  frameworkConfig?: FrameworkConfig;
+}
+/**
+ * 创建 render 函数
+ *
+ * @returns `render(url, locale, ssrContext?)` — 供 @finesoft/server SSRModule 使用
+ */
+declare function createSSRRender(config: SSRRenderConfig): (url: string, locale: string, ssrContext?: SSRContext) => Promise<SSRRenderResult>;
+//#endregion
+//#region ../ssr/src/inject.d.ts
+/**
+ * injectSSRContent — 将 SSR 渲染结果注入 HTML 模板
+ */
+/** SSR HTML 模板占位符常量 */
+declare const SSR_PLACEHOLDERS: {
+  readonly LANG: "<!--ssr-lang-->";
+  readonly HEAD: "<!--ssr-head-->";
+  readonly BODY: "<!--ssr-body-->";
+  readonly DATA: "<!--ssr-data-->";
+};
+interface InjectSSROptions {
+  template: string;
+  locale: string;
+  head: string;
+  css: string;
+  html: string;
+  serializedData: string;
+}
+declare function injectSSRContent(options: InjectSSROptions): string;
+/**
+ * CSR 空壳注入 — 只替换 lang，清空 body/head/data 占位符
+ * 用于 renderMode === "csr" 的路由
+ */
+declare function injectCSRShell(template: string, locale: string): string;
+//#endregion
+//#region ../ssr/src/server-data.d.ts
+declare function serializeServerData(data: PrefetchedIntent[]): string;
+//#endregion
+//#region ../server/src/proxy.d.ts
+/** 代理路由认证配置 */
+interface ProxyAuthConfig {
+  /** 认证类型 */
+  type: "bearer" | "basic";
+  /** 环境变量名称（运行时从 process.env 读取） */
+  envKey: string;
+}
+/** 声明式代理路由配置 */
+interface ProxyRouteConfig {
+  /** URL 前缀，如 "/api/apple"（必须以 "/" 开头） */
+  prefix: string;
+  /** 代理目标地址（必须以 "https://" 开头） */
+  target: string;
+  /** HTTP 方法（默认 ["all"]） */
+  methods?: ("all" | "get" | "post" | "put" | "delete" | "patch")[];
+  /** 附加到代理请求的头部 */
+  headers?: Record<string, string>;
+  /** 认证配置 */
+  auth?: ProxyAuthConfig;
+  /** Cache-Control 响应头 */
+  cache?: string;
+  /** 是否跟随重定向（默认 false） */
+  followRedirects?: boolean;
+}
+/**
+ * 注册声明式代理路由到 Hono app（运行时使用：dev / preview / createServer）
+ */
+declare function registerProxyRoutes(app: Hono, configs: ProxyRouteConfig[]): void;
+/**
+ * 生成代理路由的内联代码（用于 serverless/edge 入口，避免运行时依赖）
+ */
+declare function generateProxyCode(configs: ProxyRouteConfig[]): string;
+//#endregion
+//#region ../server/src/adapters/types.d.ts
+/** 适配器上下文 — 由 vite-plugin 的 closeBundle 构造后传入 adapter.build() */
+interface AdapterContext {
+  /** 项目根路径 */
+  root: string;
+  /** SSR 入口文件相对路径（如 "src/ssr.ts"） */
+  ssrEntry: string;
+  /** setup 文件相对路径（如 "src/proxies.ts"），仅当 options.setup 为 string 时有值 */
+  setupPath?: string;
+  /** 路由定义入口文件（用于预渲染时加载路由），如 "src/lib/bootstrap.ts" */
+  bootstrapEntry?: string;
+  /** 支持的语言列表 */
+  locales: string[];
+  /** 默认语言 */
+  defaultLocale: string;
+  /** dist/client/index.html 的内容 */
+  templateHtml: string;
+  /** Vite 的 resolve 配置 */
+  resolvedResolve: unknown;
+  /** Vite 的 css 配置 */
+  resolvedCss: unknown;
+  /**
+   * 按路由覆盖的渲染模式。
+   * key: 精确路径或 glob 模式，value: "ssr" | "csr" | "prerender"
+   */
+  renderModes?: Record<string, string>;
+  /** 声明式代理路由配置 */
+  proxies?: ProxyRouteConfig[];
+  vite: any;
+  fs: typeof node_fs0;
+  path: {
+    resolve: (...args: string[]) => string;
+    join: (...args: string[]) => string;
+  };
+  /** 生成 serverless/edge function 入口源码 */
+  generateSSREntry(opts: GenerateSSREntryOptions): string;
+  /** 用 Vite SSR 模式构建 bundle */
+  buildBundle(opts: BuildBundleOptions): Promise<void>;
+  /** 复制 dist/client 静态资源到目标目录 */
+  copyStaticAssets(destDir: string, opts?: CopyStaticAssetsOptions): void;
+}
+interface GenerateSSREntryOptions {
+  /** 平台特定的导入语句（如 `import { handle } from "hono/vercel";`） */
+  platformImport: string;
+  /** 平台特定的导出语句（如 `export default handle(app);`） */
+  platformExport: string;
+  /**
+   * 平台特定的 ISR 缓存实现代码（可选）。
+   * 需提供 `async function platformCacheGet(url)` 返回 string|null，
+   * 和 `async function platformCacheSet(url, html)` 的函数定义。
+   * 不提供时使用内置的内存 Map 缓存。
+   */
+  platformCache?: string;
+  /**
+   * 平台特定的响应后处理代码（可选）。
+   * 在 prerender 路由返回前执行，可用于设置 CDN 缓存头等。
+   * 代码中可使用变量 `c`（Hono Context）。
+   */
+  platformPrerenderResponseHook?: string;
+  /**
+   * 平台特定的中间件代码（可选）。
+   * 插入在 catch-all GET 路由之前，可用于添加静态文件服务等。
+   * 代码中可使用变量 `app`（Hono 实例）。
+   */
+  platformMiddleware?: string;
+}
+interface BuildBundleOptions {
+  /** 临时入口文件路径 */
+  entry: string;
+  /** 输出目录 */
+  outDir: string;
+  /** 构建 target（默认 "node18"） */
+  target?: string;
+  /** 输出文件名（默认 "index.mjs"） */
+  fileName?: string;
+  /** 排除的模块（默认 ["vite", "esbuild", "rollup", "fsevents", "lightningcss"]） */
+  external?: string[];
+  /** 是否打包所有依赖（默认 true） */
+  noExternal?: boolean;
+}
+interface CopyStaticAssetsOptions {
+  /** 是否排除 index.html（默认 true） */
+  excludeHtml?: boolean;
+}
+/** 适配器接口 */
+interface Adapter {
+  /** 适配器名称（用于日志） */
+  name: string;
+  /** 生成目标平台部署产物 */
+  build(ctx: AdapterContext): Promise<void>;
+}
+//#endregion
+//#region ../server/src/adapters/auto.d.ts
+declare function autoAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/cloudflare.d.ts
+declare function cloudflareAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/netlify.d.ts
+declare function netlifyAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/node.d.ts
+declare function nodeAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/resolve.d.ts
+declare function resolveAdapter(value: string | Adapter): Adapter;
+//#endregion
+//#region ../server/src/adapters/static.d.ts
+interface StaticAdapterOptions {
+  /**
+   * 导出 routes 数组的文件路径（相对于项目根目录）。
+   * 默认 "src/lib/bootstrap.ts"。
+   * 文件需 export 一个 RouteDefinition[] 类型的 routes 变量。
+   */
+  routesExport?: string;
+  /**
+   * 额外的动态路由 URL（带具体参数值），如：
+   * ["/product/123", "/list/games"]
+   */
+  dynamicRoutes?: string[];
+}
+declare function staticAdapter(opts?: StaticAdapterOptions): Adapter;
+//#endregion
+//#region ../server/src/adapters/vercel.d.ts
+declare function vercelAdapter(): Adapter;
+//#endregion
+//#region ../server/src/app.d.ts
+interface SSRModule {
+  render: (url: string, locale: string, ssrContext?: {
+    fetch?: typeof globalThis.fetch;
+    request?: Request;
+  }) => Promise<{
+    html: string;
+    head: string;
+    css: string;
+    serverData: unknown;
+    renderMode?: string;
+    redirect?: {
+      url: string;
+      status: number;
+    };
+  }>;
+  serializeServerData: (data: unknown) => string;
+}
+interface SSRAppOptions {
+  /** 项目根路径 */
+  root: string;
+  /** Vite dev server（仅开发模式） */
+  vite?: ViteDevServer;
+  /** 是否生产环境 */
+  isProduction: boolean;
+  /** SSR 入口文件路径（开发用，如 "/src/ssr.ts"） */
+  ssrEntryPath?: string;
+  /** 生产环境 SSR 模块路径（如 "../dist/server/ssr.js"） */
+  ssrProductionModule?: string;
+  /** 支持的语言列表 */
+  supportedLocales?: string[];
+  /** 默认语言 */
+  defaultLocale?: string;
+  /**
+   * 父级 Hono app 的 fetch 函数，用于 SSR 内部路由回环。
+   * SSR 渲染时，控制器的 fetch 请求（如 /api/apple/*）会通过此函数
+   * 直接在进程内路由到代理 handler，避免网络自请求死锁。
+   */
+  parentFetch?: (request: Request) => Response | Promise<Response>;
+  /**
+   * 按路由覆盖渲染模式（精确路径或 glob 模式）。
+   * 优先级高于路由级 renderMode。
+   */
+  renderModes?: Record<string, string>;
+}
+declare function createSSRApp(options: SSRAppOptions): Hono;
+//#endregion
+//#region ../server/src/runtime.d.ts
+/**
+ * runtime — 运行时检测 + 项目根路径推导
+ */
+interface RuntimeInfo {
+  isDeno: boolean;
+  isBun: boolean;
+  isVercel: boolean;
+  isProduction: boolean;
+}
+/** 检测当前运行时环境 */
+declare function detectRuntime(): RuntimeInfo;
+/**
+ * 从 `import.meta.url` 推导项目根路径
+ *
+ * @param importMetaUrl - 调用方的 `import.meta.url`
+ * @param levelsUp - 向上移动多少级（默认 0，即调用方所在目录就是项目根）
+ */
+declare function resolveRoot(importMetaUrl: string, levelsUp?: number): Promise<string>;
+//#endregion
+//#region ../server/src/create-server.d.ts
+interface ServerConfig {
+  /** 项目根路径（默认 process.cwd()） */
+  root?: string;
+  /** 支持的语言列表 */
+  locales?: string[];
+  /** 默认语言 */
+  defaultLocale?: string;
+  /** 端口号（默认 3000） */
+  port?: number;
+  /** 注册自定义路由（在 SSR catch-all 之前调用，但在声明式代理之后） */
+  setup?: (app: Hono) => void | Promise<void>;
+  /** 声明式代理路由配置 */
+  proxies?: ProxyRouteConfig[];
+  /** SSR 相关选项（透传给 createSSRApp） */
+  ssr?: Pick<SSRAppOptions, "ssrEntryPath" | "ssrProductionModule">;
+}
+interface ServerInstance {
+  app: Hono;
+  vite?: ViteDevServer;
+  runtime: RuntimeInfo;
+}
+/**
+ * 创建并启动 SSR 服务器
+ *
+ * @example
+ * ```ts
+ * const { app } = await createServer({
+ *   locales: ["zh", "en"],
+ *   setup: (app) => registerProxies(app),
+ * });
+ * export { app };
+ * ```
+ */
+declare function createServer(config?: ServerConfig): Promise<ServerInstance>;
+//#endregion
+//#region ../server/src/locale.d.ts
+/**
+ * Accept-Language 解析
+ */
+declare function parseAcceptLanguage(header: string | undefined, supported?: string[], fallback?: string): string;
+//#endregion
+//#region ../server/src/start.d.ts
+interface StartServerOptions {
+  /** 最终的 Hono app（已包含 SSR + 自定义路由） */
+  app: Hono;
+  /** 项目根路径 */
+  root: string;
+  /** 端口号 */
+  port?: number;
+  /** 是否生产环境 */
+  isProduction: boolean;
+  /** Vite dev server（仅开发模式传入） */
+  vite?: ViteDevServer;
+  /** 运行时信息（可选，不传时自动检测） */
+  runtime?: RuntimeInfo;
+  /** 已注册的路由列表（用于启动日志） */
+  routes?: string[];
+  /** 支持的语言列表（用于启动日志） */
+  locales?: string[];
+  /** SSR 入口路径（用于启动日志） */
+  ssrEntryPath?: string;
+}
+declare function startServer(options: StartServerOptions): Promise<{
+  vite?: ViteDevServer;
+}>;
+//#endregion
+//#region ../server/src/vite-plugin.d.ts
+interface FinesoftFrontViteOptions {
+  /** 支持的语言列表 */
+  locales?: string[];
+  /** 默认语言 */
+  defaultLocale?: string;
+  /** SSR 配置 */
+  ssr?: {
+    /** SSR 入口文件路径（默认 "src/ssr.ts"） */entry?: string;
+  };
+  /**
+   * 声明式代理路由配置。
+   * 框架统一执行路径校验（SSRF 防护）、Host 限制、错误处理、响应头控制。
+   * 代理路由在 setup 之前注册，优先级高于自定义路由。
+   */
+  proxies?: ProxyRouteConfig[];
+  /**
+   * 注册自定义路由（非代理类）。
+   * - 传入 Function：仅 dev/preview 时可用。
+   * - 传入 string（文件路径）：dev/preview/adapter 均可用，
+   *   文件需 export default 一个 (app: Hono) => void 函数。
+   * 注意：代理路由请使用 proxies 选项，不要在 setup 中手写代理。
+   */
+  setup?: ((app: Hono) => void | Promise<void>) | string;
+  /**
+   * 部署适配器。
+   * - 字符串快捷方式："vercel" | "cloudflare" | "netlify" | "node" | "static" | "auto"
+   * - 自定义 Adapter 对象：{ name, build(ctx) }
+   * - 不设置则不生成部署产物
+   */
+  adapter?: string | Adapter;
+  /**
+   * 按路由覆盖渲染模式（优先级高于 RouteDefinition.renderMode）。
+   * key: 精确路径或 glob 模式，如 "/search" 或 "/blog/*"
+   * value: "ssr" | "csr" | "prerender"
+   *
+   * @example
+   * ```ts
+   * renderModes: {
+   *   "/search": "csr",
+   *   "/blog/*": "prerender",
+   * }
+   * ```
+   */
+  renderModes?: Record<string, "ssr" | "csr" | "prerender">;
+  /**
+   * 路由定义入口文件（用于预渲染时加载路由），默认 "src/lib/bootstrap.ts"。
+   * 如果项目不使用声明式路由定义，可以不设置。
+   */
+  bootstrapEntry?: string;
+}
+declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
+  name: string;
+  config(userConfig: Record<string, any>, env: {
+    command: string;
+  }): Record<string, any>;
+  configResolved(config: Record<string, any>): void;
+  /**
+   * Dev 模式 CSS 内联 — 消除 SSR 首屏布局抖动
+   *
+   * Vite dev 模式下，global.scss 等非组件 CSS 通过 JS 模块系统异步加载，
+   * 导致 SSR HTML 初次渲染缺少布局关键样式（box-sizing、flex 布局、padding-top 等）。
+   *
+   * 此 hook 在 HTML 模板变换阶段（SSR 渲染之前）：
+   * 1. 找到浏览器入口脚本（排除 /@vite/client 等内部脚本）
+   * 2. 编译入口脚本，填充 Vite 模块图
+   * 3. 遍历模块图收集所有 CSS 依赖（排除 .svelte 组件 CSS，由 SSR 渲染自行处理）
+   * 4. 通过 ssrLoadModule 获取编译后 CSS（SCSS→CSS）
+   * 5. 注入 <style data-vite-dev-id> 标签到 <head>
+   *
+   * data-vite-dev-id 确保 Vite HMR 客户端复用已有标签，避免重复注入。
+   */
+  transformIndexHtml: {
+    order: "pre";
+    handler(html: string, ctx: any): Promise<{
+      tag: string;
+      attrs: Record<string, string>;
+      children: string;
+      injectTo: "head";
+    }[] | undefined>;
+  };
+  configureServer(server: any): () => Promise<void>;
+  configurePreviewServer(server: any): () => Promise<void>;
+  closeBundle(): Promise<void>;
+};
+//#endregion
+export { ACTION_KINDS, Action, ActionDispatcher, ActionHandler, type ActionHandlerDependencies, type Adapter, type AdapterContext, AfterLoadGuard, AsyncMapper, BaseController, BaseItem, BaseLogger, BasePage, BaseShelf, BeforeLoadGuard, type BrowserAppConfig, BrowserContextOptions, CompositeLogger, CompositeLoggerFactory, CompoundAction, ConsoleLogger, ConsoleLoggerFactory, Container, DEP_KEYS, DenyResult, ExternalUrlAction, type ExternalUrlDependencies, FeatureFlags, type FinesoftFrontViteOptions, FlowAction, type FlowActionCallbacks, type FlowActionDependencies, Framework, FrameworkConfig, History, HttpClient, HttpClientConfig, HttpError, type InjectSSROptions, Intent, IntentController, IntentDispatcher, Locale, type Logger, Logger as LoggerInterface, type LoggerFactory, LruMap, Mapper, MetricsRecorder, MiddlewareResult, NavigationContext, Net, NextResult, None, Optional, PostLoadContext, PrefetchedIntent, PrefetchedIntents, type ProxyAuthConfig, type ProxyRouteConfig, RedirectResult, RenderMode, RewriteResult, RouteAddOptions, RouteDefinition, RouteMatch, Router, type RuntimeInfo, type SSRAppOptions, type SSRContext, type SSRModule, type SSRRenderConfig, type SSRRenderOptions, type SSRRenderResult, SSR_PLACEHOLDERS, type ServerConfig, ServerContextOptions, type ServerInstance, type StartServerOptions, Storage, autoAdapter, buildUrl, cloudflareAdapter, createBrowserContext, createPrefetchedIntentsFromDom, createSSRApp, createSSRRender, createServer, createServerContext, defineRoutes, deny, deserializeServerData, detectRuntime, finesoftFrontViteConfig, generateProxyCode, generateUuid, getBaseUrl, injectCSRShell, injectSSRContent, isCompoundAction, isExternalUrlAction, isFlowAction, isNone, isSome, makeDependencies, makeExternalUrlAction, makeFlowAction, mapEach, netlifyAdapter, next, nodeAdapter, parseAcceptLanguage, pipe, pipeAsync, redirect, registerActionHandlers, registerExternalUrlHandler, registerFlowActionHandler, registerProxyRoutes, removeHost, removeQueryParams, removeScheme, resetFilterCache, resolveAdapter, resolveRoot, rewrite, runAfterLoadGuards, runBeforeLoadGuards, serializeServerData, shouldLog, ssrRender, stableStringify, startBrowserApp, startServer, staticAdapter, tryScroll, vercelAdapter };
+//# sourceMappingURL=index.d.mts.map